HSMS offers a conversion option for instances in which the output volume does not permit PAM keys to be written and the saved files have a PAM key.
Conversion can be necessary particularly when importing files which originated on other BS2000 systems or when restoring files from long-term archives.
File conversion can be controlled by the FILE-CONVERSION operand in the HSMS statements RESTORE-FILES and IMPORT-FILES. This operand is ignored for job variables.
By default, files are converted by HSMS when restoring and importing. When FILE-CONVERSION=*NO is specified files located in the save file which have a PAM key are not processed when restored or imported to an NK disk. SAM files with PAM key are also not processed if they are to be restored or imported to Net-Storage with the file type node file. HSMS outputs a warning in the report for each file not processed for this reason.
Files are converted using the PAMINT subsystem.
There are two conversion methods, as outlined below.
Default format
When loaded to an NK disk, files with a PAM key 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. If the structure of PAM files is unknown, the PAM key information is lost. An appropriate message is displayed if the PAM key contained information that was lost. LMR libraries are converted to PLAM format.
CONV format
When loaded to an NK disk, files with a PAM key are converted to “CONV format” via PAMINT. The restored or imported file contains all the PAM keys at the end of the file in separate blocks.
Only *CONV can be specified for partially backed up files. If a file to be restored must be converted, the RELEASED-UNUSED-SPACE operand is ignored.
Converting large files (>= 32 GB)
Conversion of larger files in HSMS works in the usual way, with PAMCONV. Note that large files can only be converted on pubsets with the attributes, LARGE-OBJECTS=*YES and LARGE-FILES-ALLOWED=*YES.
Exception
The space requirements for a file in K format may increase as a result of the conversion to NK, so that the corresponding initial size and structure of the K file exceeds the 32 GB limit. Conversion is only then possible if the target file is located on a pubset with the attributes LARGE-OBJECTS=*YES and LARGE-FILES-ALLOWED=*YES.