ROBAR informs MAREN when a tape is placed in the import/export unit of an archive system. The entry is only modified if it already exists. The tape is not implicitly added to the MAREN catalog.
Explicit import of tapes
Adding free tapes
If the tape to be imported is to be added to the MAREN catalog as a free tape, it must be cataloged beforehand using the MARENADM statement below:
//ADD-FREE-VOLUMES VOLUME=...,FREE-LOCATION=<location-name>
<location-name> is the storage location name of the archive system. In contrast to manual operation, MARENADM sets the temporary storage location to “CENTRAL”. This way, the tape cannot be reserved before it is actually present in the archive system. The MAREN catalog entry for the current location is automatically updated when the tape is inserted in the import/export unit.
Adding reserved tapes
If the tape to be imported is to be added to the MAREN catalog as a reserved tape, it must be cataloged beforehand using the MARENADM statement below:
//ADD-RESERVED-VOLUME VOLUME=..., USER-ID=<userid>,LOCATION=PARAMETERS(HOME-LOCATION=<location-name>)<userid> is the user ID for the tape. <location-name> is the name of the default storage location of the tape in the archive system. When the tape is then inserted in the archive system’s import/export unit, the MAREN catalog entry for the temporary storage location will be updated. The tape can now be requested.
Adding foreign tapes
During archiving, the tapes which are not currently in the MAREN catalog, will be archived as foreign tapes.
If these tapes are to display attributes in the MAREN catalog which differ from those used for the implicit new addition, they must also be added in advance using the MARENADM statement IMPORT-FOREIGN-VOLUME and then modified with MODIFY-VOLUME-ATTRIBUTES.
Example
If the tape TAPE01 is to be allocated to the user ID ROBUSER, and not to SYSMAREN, the following MARENADM statement must be issued before the tape is placed in the import/export unit of the archive system with the location name “ROBAR”:
//IMPORT-FOREIGN-VOLUME VOLUME=TAPE01,USER-ID=ROBUSER,LOCATION=ROBAR
When the tape is then inserted in the archive system’s import/export unit, the MAREN catalog entry for the temporary storage location will be updated. The tape can now be requested.
If there is already a tape with the same archive number as the private tape, this tape can be temporarily locked. But archive system tape must first be exported.