IMPORT-FOREIGN-VOLUME Add free tapes to the MAREN catalog

Privilege                 ADA, DA, administrator without domains

In the MAREN catalog, this statement generates a catalog entry for foreign tapes which have been exported from a remote data center and were previously not known in the local data center. It also allows you to add multifile catalog entries with an FSEQ > 1.

DAs can only execute the statement in their own domain. The DOMAIN operand is thus meaningless for them. Furthermore, the DA can only add a foreign tape if no tape with the same archive number exists in the MAREN catalog or an existing tape with this archive number belongs to the DA’s own domain.

Format

IMPORT-FOREIGN-VOLUME                                                   Alias: IMFV

VOLUME = list-poss(10): <vsn>

,FILE-SEQUENCE = 1 / <integer 1..9999>

,USER-IDENTIFICATION = <name 1..8>

,ACCOUNT = *NONE / <alphanum-name 1..8>

,DEVICE-TYPE = *STD / <structured-name 1..8>

,DIRECTORY-NAME = *NONE / <filename 1..54 without-gen-vers>

,DOMAIN = *STD-DOMAIN / *OWN / <alphanum-name 1..8>

,LOCATION = CENTRAL / <alphanum-name 1..8>

Operands

VOLUME = list-poss(10): <vsn>
Archive numbers of the foreign tapes.

FILE-SEQUENCE = 1 / <integer 1..9999>
File sequence number of a file within a file set (multifile/multivolume set).

USER-IDENTIFICATION = <name 1..8>
User ID to which the tape is to be assigned.

ACCOUNT = *NONE / <alphanum-name 1..8>
Account number of the specified user ID.

DEVICE-TYPE =
Device type.

DEVICE-TYPE = *STD
The tapes are of the default device type (DEFAULT-DEVICE-TYPE) whose value was specified with the MODIFY-MAREN-PARAMETERS statement.

DEVICE-TYPE = <structured-name 1..8>
Device type. For a list of possible entries (depending on the BS2000 version), see manual “System Installation” [6].

DIRECTORY-NAME =
Determines whether the tape is assigned to a directory.

DIRECTORY-NAME = *NONE
The tape is not assigned to a directory.

DIRECTORY-NAME = <filename 1..54 without-gen-vers>
Name of a directory to which the tape is assigned. If this directory is located under a remote user ID, both the user ID and the catalog ID must be entered. The user's own user ID and standard catalog ID can be omitted.

DOMAIN =
Specifies the domain to which a foreign tape is to be added. If an existing volume belongs to a foreign domain the statement can only be issued by the ADA. The required domain must then be specified.

DOMAIN = *STD-DOMAIN
The foreign tape is added to the standard domain.

DOMAIN = *OWN
The foreign tape is added to the user’s own domain. The user’s own domain is the domain of the system on which the ADA is currently working or the domain in which he/she has taken over the DA role.

DOMAIN = <alphanum-name 1..8>
The foreign tape is added to the specified domain.

LOCATION = CENTRAL / <alphanum-name 1..8>
Specifies the location of the foreign tape. If a location is assigned which is accessed by a archive system, the TEMP-LOCATION catalog entry fields with CENTRAL and HOME-LOCATION are set to the specified location. In the case of manually controlled locations, all of a tape’s locations are set uniformly to the specified value.

Notes

• The generated catalog entries has the catalog entry fields VOLUME-STATUS = PRIVATE and USER-ACCESS = OWNER-ONLY. Catalog entries for free tapes and user’s own tapes can only be created by means of the statements ADD-FREE-VOLUMES and ADD-RESERVED-VOLUME.

• If the MAREN checks have also been activated for foreign tapes (MAREN parameter FOREIGN-TAPE-CHECK = YES) or domains are being used, each foreign tape must be made known in MAREN by means of the IMPORT-FOREIGN-VOLUME statement before initial processing takes place.

• After the catalog entry has been created, the user can, if necessary, modify catalog entry fields using the MAREN statement MODIFY-VOLUME-ATTRIBUTES.

• If a foreign tape is to be archived with an archive number which already exists in the MAREN catalog, MARENADM responds as follows:

  • It is asked whether the old tape is to be locked on a temporary basis so that the foreign tape can be added. If the response is affirmative, the FSEQ is set to '*001' for the current tape. This means that the current tape can no longer be requested, although it continues to be displayed by the SHOW-VOLUME-ATTRIBUTES statement. The new tape is added to the MAREN catalog with the valid FSEQ '0001'. Another tape with the same archive number cannot be archived.
  • If MARENADM is executed in batch mode, the statement is rejected.
  • When using the program interface (see section “MARENADM as a subroutine”), on the other hand, an attempt is made in both interactive mode and batch mode to temporarily lock the existing tape.
  • If a list of tapes is entered in the VOLUME operand, of which one is already contained in the MAREN catalog and should not be locked temporarily, the statement is aborted with an error message.

• The date on which the foreign tape was entered in the MAREN catalog for the first time is stored in the catalog entry field REGISTRATION-DATE. The MARENADM statement MODIFY-VOLUME-ATTRIBUTES enables the administrator to update the date. The date is output using the SHOW-/PRINT-VOLUME-ATTRIBUTES statement.

Example

//import-foreign-vol vol=mbkx07,user-id=user1,dev-type=tape-c4
%	MARM108 MAREN CATALOG ENTRY 'MBKX07'/'0001' ADDED A foreign tape with the archive number MBKX07 is archived in the MAREN catalog for the user ID USER1.