Handling and converting PAM keys

ARCHIVE supports both K disks (with a PAM key) and NK disks (with no PAM key). ARCHIVE saves and restores files with all PAM key formats

(BLOCK-CONTROL-INFO=NO/WITHIN-DATA-BLOCK/PAMKEY)

During restoration, files are automatically restored in the format in which they were saved, provided that the format of the volume on which they are restored allows this. The permissible combinations of file attributes and disk types can be found in the table on "NK4 disks".

Partial saving is not possible for PAM files without a PAM key (BLOCK-CONTROL-INFO=NO), except in the case of PLAM libraries.

Conversion

ARCHIVE offers the possibility of conversion for cases where the output volume does not permit the writing of PAM keys but the files involved have PAM keys. File conversion can be controlled with the CONVERSION operand of the RESTORE and IMPORT statements. This operand is ignored for job variables.

By default, files are not converted. If the default value is used, files with PAM keys are not restored to an NK disk in a restoration run; a warning is issued for any files which were not restored.

If files are to be converted, the PAMINT subsystem must be available in the file $TSOS.SYSLNK.PAMINT. There are two possible conversion methods:

• CONVERSION=STD
  In a restoration run to an NK disk, files with PAM keys are converted via PAMINT according to the following rules:

  • K-ISAM files to NK-ISAM files

    (BLOCK-CONTROL-INFO=WITHIN-DATA-BLOCK)

  • K-SAM files to NK-SAM files

    (BLOCK-CONTROL-INFO=WITHIN-DATA-BLOCK)

  • K-UPAM files to NK-UPAM files

    (BLOCK-CONTROL-INFO=NO)

    PAM files whose structure is known (load modules, libraries) are converted accordingly; in the case of PAM files whose structure is not known, the PAM key information is lost. If the PAM key contained information, an appropriate message is displayed.

• CONVERSION=CONV
  In a RESTORE run to an NK disk, files with PAM keys are converted to “CONV format” by means of PAMINT. The restored file contains all the PAM keys at the end of the file in separate blocks.

  In the case of partially saved files, only CONVERSATION=CONV can be specified.

  If a file to be restored has to be converted, the SPACE operand is ignored.

An SM pubset can contain several volume sets with different format and allocation. When restoring an SM pubset, ARCHIVE searches initially for a “matching” volume set for each file, which does not require conversion. If no such volume set exists, then if possible a volume set will be selected from the SM pubset that allows conversion.