The PARAM statement is used to set parameters for the entire ARCHIVE run. The values of these operands are valid up to the END statement unless they are modified by another PARAM statement using the same operands. The values of operands for which no specification is made remain unchanged.
At least one operand must be specified.
The PARAM statement must be entered before the FILES statement. It cannot be continued; if necessary, a further PARAM statement must be issued.
The syntax of the PARAM statement does not conform to the described in the section "Metasyntax". The underscored values indicate the ARCHIVE default values after invocation. If a parameter was already modified in an earlier PARAM statement, this value does not revert to the default value in a subsequent PARAM statement in which this parameter is not specified.
PARAM |
CNS = YES / NO |
CNS =
This determines whether all files cataloged in the directory file are output in the report.
CNS = YES
All files from the FILES statement that are cataloged in the directory file are listed in the report. This also applies to any files not saved by ARCHIVE because they had not been modified.
CNS = NO
Files which are cataloged but not saved (because they had not been updated) are not to be included in the report.
If the INQUIRE statement is being executed and PARAM CNS=NO has been set, only the save versions in which each file was actually saved are output. Output with the qualifier “CNS” is suppressed.
RESTART =
This determines whether checkpoints are written in the checkpoint file.
RESTART = YES
Checkpoints are to be written to the CHKPT file. In the event of the ARCHIVE run being aborted, e.g. due to a system crash, the user can continue the run later on with the aid of a PROCESS statement.
Restrictions on the use of RESTART without a directory file are described in the section "Restarting ARCHIVE processes".
RESTART = NO
Checkpoints are not written to the CHKPT file and the user cannot resume the interrupted run.
UNLOAD =
This determines whether magnetic tapes or MT cartridges are unloaded after they have been processed.
UNLOAD = NO
The tapes or MT cartridges are not unloaded at the end of the ARCHIVE run.
UNLOAD = YES
The tapes or MT cartridges are unloaded after they have been processed. During a restoration run, every FILES or JOBVAR statement is processed individually. After each processing step the volume is rewound and unloaded. Then the volume is read from the beginning.
During a save run the volume is not unloaded until all FILES or JOBVAR statements have been executed.
OPERATOR =
This controls the ARCHIVE messages that require a response from the operator.
OPERATOR = NO
Messages requiring a response from the operator are not output on the console. ARCHIVE initiates a standard error handling routine.
OPERATOR = YES
Messages requiring a response from the operator are output at the operator console. The operator can initiate standard or special processing in the response (see section "Error handling").
WRCHK =
This determines whether a read-after-write check is conducted when writing to hard disk.The read-after-write check is not performed by ARCHIVE but by DMS (see the /ADD-FILE-LINK command in the “DMS” manual [2]).
WRCHK = NO
No read-after-write check is performed by DMS.
WRCHK = YES
After each write operation the results are read, thus enabling any errors to be detected immediately, albeit at the cost of increased runtime.
SNR =
This controls the scope of the ARCHIVE report if REPLACE=NO.
SNR = Saved Not Restored; files that have been saved but not restored.
SNR = YES
Files which were not written back because they already existed are listed in the ARCHIVE report.
SNR = NO
In restoration runs with REPLACE=NO, files which were not written back (because they already existed) are not listed in the ARCHIVE report.
DESTROY =
This specifies what happens to the storage space when a save file is deleted.
DESTROY = NO
The storage space for the save file is returned unchanged to the system on deletion.
DESTROY = YES
If a disk save file created in this run with SAVE or EXPORT is deleted with /DELETE-FILE or with the ARCHIVE statement PURGE, the storage space is overwritten with binary zeros (cf. “Commands” [4] manual /CREATE-FILE).
CATID =
This determines whether or not the catalog ID should be used (see section "Supporting pubsets").
CATID = NO
The files or job variables are accessed according to the standard system conventions.
CATID = YES
This specifies that the catalog ID of the files or the job variables is taken into account. The catalog ID is specified in the file name/job variable name.
OLS =
Controls online saving in UDS databases.
OLS = NO
UDS databases are not saved online.
OLS = YES
UDS databases are saved online, i.e. in an open state. An after-image file must have been created for the database.