The archive directory that was brought up to date upon archival can also be written onto the archival volume at the end of archival. The archival volume then contains in addition to the saved data a directory of the data contained on it.
Saving of the archive directory is initiated by specifying SAVE-DIRECTORY=*YES. It is not saved by default.
The HSMS administrator is permitted to save the archive directory, as is also the archive owner and the co-owner of the archive directory.
The following applies to saving the archive directory:
If no data was saved with the request, the directory is not saved either.
Only a full backup of the archive directory is carried out, even if incremental backups are implemented.
The archive directory is not distributed to different volumes. Saving of the archive directory and the volume used for this are displayed in the report.
When the archive directory has been saved it can be restored from the volume in the event of an emergency (if it no longer exists or is not readable on S0). To do this you use the IMPORT-FILES statement with FILE-NAMES=*DIRECTORY specified and the volume noted in the report on the backup.
Furthermore the attributes of an archive are also stored in the archive directory. If the archive definition has been lost the archive can be restored from the archive directory using the CREATE-ARCHIVE statement:
//CREATE-ARCHIVE ARCHIVE-NAME=..., DIRECTORY-NAME=<directory>(NEW-DIRECTORY=*NO(RECONSTRUCT-ARCHIVE=*YES))
To permit individual elements to be restored from the long-term backup of large PLAM libraries (with RESTORE-LIBRARY-ELEMENTS) the SAVE-PLAM-INFO=*YES option must be used when saving. This is the case when the long-term archive has the attribute SAVE-PLAM-INFO=*YES when it is saved (see CREATE-ARCHIVE or MODIFY-ARCHIVE-ATTRIBUTES).
Special aspects of SAM node files
There are two possible ways to access a SAM node file from BS2000:
one is to maintain the SAM structures in the BS2000 application by adding them with Net-Client during the write process when the files are migrated from the Net-Server or
without conversion, i.e. without adding SAM structures to the data blocks and without code conversion to EBCDIC (this is called RAW mode).
The access type is controlled via the SAVE-SAM-STRUCTURE=*NO operand of the SAVE-OPTIONS option. Please also see section “Special aspects of SAM node files” in chapter "Save options".