You can use the SHOW-DEFAULT statement to display the current default values of the ARCHIVE parameters, i.e. the values stored in the ARCHIVE parameter file when ARCHIVE was started.
SH[OW]-DEF[AULT] |
[ L[IST] = SYSOUT / SYSLST / BOTH ] |
LIST =
specifies where the output is to be sent.
LIST = SYSOUT
The report is output on the data display terminal in interactive mode.This is the default for runs in interactive mode.
LIST = SYSLST
The report is output on SYSLST.
This is the default for runs in batch mode.
LIST = BOTH
The report is output on SYSLST and SYSOUT.
Table of ARCHIVE parameters in the ARCHIVE parameter file
The following table contains all ARCHIVE parameters in alphabetical order and
the statements in which the ARCHIVE parameters are present
the permissible values for each ARCHIVE parameter
the presetting in the ARCHIVE parameter file (see section "Parameter file for ARCHIVE")
Parameter | Statement | Permissible values/syntax | Presetting |
| AUTO-DIR-REORG | ––– | NO / YES | NO |
BACKUP | SAVE | A / B / C / D | D |
BLOCK-SIZE-DISK | SAVE, EXPORT | STD / MAX / <integer 1..35> | MAX |
BLOCK-SIZE-T-C | SAVE, EXPORT | STD / MAX / BIG / | BIG |
BLOCK-SIZE-TAPE | SAVE, EXPORT | STD / MAX / <integer 1..15> | MAX |
CATID | PARAM | NO / YES | NO |
CHANGED | SAVE | NO / YES / YES,LARGE / | YES |
CHECK-PUB-SPACE | ––– | NO / YES | NO |
CNS | PARAM | NO / YES | YES |
COMPRESS | SAVE, EXPORT | NO / YES | NO |
CONSISTENCY-CHECK | SAVE etc. | NO / YES | NO |
DESTROY | PARAM | NO / YES | NO |
DEVICE-TAPE-T-C | SAVE etc. | <device type> | TAPE-C4 |
DIR-E-I-L | EXPORT, | NONE / <filename 1..41> | NONE |
DIR-R-Q | RESTORE, | NONE / <filename 1..47> | $TSOS.ARCHIVE. |
DIR-S-PO-PU | SAVE, POOL, | NONE / <filename 1..41> | ARCHIVE.DIR |
DIRSAVE | SAVE, EXPORT | NO / YES | NO |
DUPLICATE | SAVE, EXPORT | NO / YES | YES |
ERLIST | ––– | NO / YES | NO |
FGERASE | ––– | NO / YES | NO |
LIST-INQUIRE | INQUIRE, | BOTH / SYSLST / SYSOUT / | TASK-TYPE-DEPENDING |
LIST-OTHERS | SAVE etc. | NONE / BOTH / SYSLST / | SYSLST |
MEMORY-POOL-SIZE | ––– | 64 / 128 / 256 / 512 | 64 |
NOW | SAVE etc. | NO / YES | YES |
OLS | PARAM | NO / YES | NO |
OPERATOR | PARAM | NO / YES | NO |
PRIMARY | SAVE, EXPORT | <integer 1..50331645> | 500 |
RESTART | PARAM | NO / YES | YES |
RETPD | SAVE, EXPORT | <integer 0..32767> | 0 |
SAVE-ACL | SAVE | NO / YES | YES |
SECONDARY | SAVE, EXPORT | <integer 0..32767> | 100 |
SHARE-EXPORT | EXPORT | NO / YES | YES |
SHARE-SAVE | SAVE, EXPORT | NO / YES | NO |
SHUPDW | ––– | <integer 1..9999> | 600 |
SNR | PARAM | NO / YES | YES |
SPACE | RESTORE, | KEEP / REORG | REORG |
| STORAGE-TYPE | ––– | ANY / PUBLIC-SPACE | ANY |
STREAM | PARAM | NO / YES | YES |
TARGET-ARCHIVE- | EXPORT | FROM-V26B / BEFORE-V26B | FROM-V26B |
TIME | SAVE etc. | <integer 1..32767> | 0 |
TYPE | STATUS | ACTIVE / LATER | LATER |
UNLOAD | PARAM | NO / YES | NO |
UNUSED | SAVE, EXPORT | <integer 0..36159> | 0 |
VOLUME | SAVE, EXPORT | POOL / OPERATOR | POOL |
WRCHK | PARAM | NO / YES | NO |
The ARCHIVE parameter file also contains the following internal parameters, which are reserved for special customer solutions and service personnel. This parameters may only be changed after prior arrangement with the service department.
Internal parameter | Possible values/syntax | Presetting | Note for service |
DEADLOCK-WAIT-TIME | 0 / <integer 180..32767> | 0 | see A0475858 |
PVS-CATID | *NONE / <catid> | *NONE | see A0475856 |
| CES-TARGET-CATID | *NONE / <catid> alias MIGRATION-CATID | *NONE | This catid is used for an HSMS statement COPY-EXPORT-SAVE-FILE (CES) without input directory to an archival directory and the input save file has been written with PARAM CATID=NO. The catid of all files in the save file is set to CES-TARGET-CATID. For CES-TARGET-CATID = *NONE this kind of CES is rejected with an error. |
HSMS-SEC-WAIT-TIME | <integer 0..99999> | 0 | see A0475855 |
CUST-PRIO-POSIX | <integer 0..2552 | 0 | see A0449431 and A0335173 |
CUST-PRIO-CC | <integer 0..255> | 0 | see A0449445 |
CUST-PRIO-BS2000 | <integer 0..255> | 0 | see A0409760 |
Meaning of ARCHIVE parameters
AUTO-DIR-REORG
This parameter allows you to activate/deactivate automatic reorganization of HSMS directories during HSMS backup runs so that the information about files and JVs occupies fewer records in the directory file.
BACKUP
This parameter allows you to specify the files to be saved, on the basis of the BACKUP entry in the file catalog, if the operand of the same name was not specified in the SAVE statement. Only files whose BACKUP entry is less than or equal to the BACKUP parameter value will be saved; thus A < B < C < D. Files with the BACKUP value E cannot be saved with SAVE. The parameter is ignored for job variables.
BLOCK-SIZE-DISK
When saving, this parameter specifies the maximum number of PAM pages per save block for a disk save file if the BLOCK-SIZE operand was not specified in the SAVE or EXPORT statements.
If the save file is to be transferred from one pubset to another, the specified block size must have the same value as the smallest “maximum I/O length -1” of the relevant pubsets.
STD (which corresponds to the value 31) is compatible for all disks.
BLOCK-SIZE-T-C
When saving, this parameter specifies the maximum number of PAM pages per save block for a save file on an MT cartridge if the BLOCK-SIZE operand was not specified in the SAVE or EXPORT statements.
By default BLOCK-SIZE-T-C=BIG, i.e. the maximum block size of 256 kB (for BS2000/OSD V6.0 or higher and TAPE-C3), is used.
For devices which do not support this block size (long tape, TAPE-C1/-C2) ARCHIVE automatically uses the compatible block size of 32 kB, which corresponds to BLOCK-SIZE=15.
For devices which were introduced in BS2000/OSD V6.0 or higher, ARCHIVE has always used a block size of 256 kB.
With continuation of a save file, a selected maximum block size is reduced to the actual block size of the save file. If the selected block size is smaller than the actual block size of the save file to be continued, then the request will be rejected.
In the case of alternating save operations or exchange of volumes between BS2000/OSD V6.0 or higher and earlier versions, only block sizes up to 32 kB can be used. For this purpose BLOCK-SIZE-T-C=STD should be set in the ARCHIVE parameter file.
BLOCK-SIZE-TAPE
When saving, this parameter specifies the maximum number of PAM pages per save block for a save file on magnetic tape if the BLOCK-SIZE operand was not specified in the SAVE or EXPORT statements. BLOCK-SIZE-TAPE=STD uses the compatible block size of 32 kB, which corresponds to BLOCK-SIZE=15.
CATID
This parameter determines whether ARCHIVE should also save the catalog ID for saved files and job variables (see also the section "Supporting pubsets").
CHANGED
This parameter specifies which files are to be fully, partially or not saved if the operand of the same name was not specified in the SAVE statement.
CHECK-PUBSET-SPACE
This parameter specifies whether ARCHIVE should check the pubspace limit for SAVE/EXPORT operations to disk and for RESTORE statements and if necessary cancel the operation. It checks whether the assigned storage space has been exceeded for a nonprivileged user and whether level 4 of the storage space saturation has been reached.
CNS
This parameter (Cataloged Not Saved) specifies whether all files cataloged in the directory file are output in the report, even if they have not been saved because they contain no changes.
COMPRESS
This parameter determines whether files are to be written to the save file using software compression if the operand of the same name was not specified in the SAVE or EXPORT statements.
CONSISTENCY-CHECK
This parameter determines whether check bytes are calculated and stored for every save block in SAVE/EXPORT statements and whether the check bytes should then be checked in the IMPORT/RESTORE and LIST statements if the operand of the same name has not been specified in these statements.
DESTROY
This parameter specifies whether the storage space occupied by a disk save file should be overwritten with binary zeros when the file is deleted.
DEVICE-TAPE-T-C
This parameter specifies the device type for the VSNs of the statement (MT cartridge or magnetic tape) if the DEVICE operand was not specified in the respective statement (SAVE, etc).
DIR-E-I-L
This parameter specifies the use of the directory file if the DIRECTORY operand was not specified in the EXPORT, IMPORT, or LIST statements.
DIR-R-Q
This parameter specifies the use of the directory file if the DIRECTORY operand was not specified in the RESTORE or INQUIRE statements.
DIR-S-PO-PU
This parameter specifies the use of the directory file if the DIRECTORY operand was not specified in the SAVE, POOL or PURGE operands.
DIRSAVE
This parameter specifies whether the current directory file should be saved to the volume in the current save if the operand of the same name was not specified in the SAVE or EXPORT operands.
DUPLICATE
This parameter defines whether a file or job variable that has been specified for saving several times should actually be saved several times if the operand of the same name was not specified in the SAVE or EXPORT statements.
ERLIST
This parameter determines whether affected files should be listed in the event of an error even if the LIST=NONE operand was specified in the statement.
FGERASE
This parameter defines the behavior of an incremental save of file generations. The operand FGERASE=YES saves only the changed generations of a file generation group in a partial save (CHANGED=YES). If a RESTORE run of a specified save version is later performed with the REPLACE=ALLP operand, all unsaved file generations are lost.
The operand FGERASE=NO saves all generations in a file generation group if at least one generation needs to be saved, alternatively, no generations are saved.
If a RESTORE run is later performed with the REPLACE=ALLP operand, all generations are recovered without loss.
LIST-INQUIRE
This parameter determines the output medium for the report of the ARCHIVE run if the LIST operand was not specified in the INQUIRE or SHOW-DEFAULTS statements. The presetting TASK-TYPE-DEPENDING reflects the different default values of the statement in interactive and batch mode.
LIST-OTHERS
This parameter specifies the output medium for the report of the ARCHIVE run if the LIST operand was not specified in the statements (with the exception of the INQUIRE and SHOW-DEFAULTS statements).
NOW
This parameter determines when a statement is carried out if the operand of the same name was not specified in the respective statement (SAVE etc.).
OLS
This parameter controls whether an online save of UDS databases (with open status) should be permitted.
OPERATOR
This parameter determines whether ARCHIVE processes ARCHIVE messages requiring an operator response using standard processing settings, without outputting the message to the operator terminal or whether ARCHIVE outputs these messages and awaits an operator response.
PRIMARY
This parameter specifies the primary allocation of the save file if the operand of the same name was not specified in the SAVE or EXPORT statements.
RESTART
This parameter determines whether check points that permit an interrupted run to be continued with the PROCESS statement are written in the checkpoint file.
RETPD
This parameter defines a retention period in days for a save version if the operand of the same name was not specified in the SAVE or EXPORT statement.
SAVE-ACL
This parameter determines whether the ACL entries (SECOS up to V3.0) are stored with the saved files if the operand of the same name was not specified in the SAVE statement.
SECONDARY
When saving to hard disk, this parameter specifies the secondary allocation of save files if the operand of the same name was not specified in the SAVE or EXPORT statement.
SHARE-EXPORT
This parameter determines whether the new volumes or save files are cataloged as “shareable” if the operand of the same name was not specified in the EXPORT statement.
SHARE-SAVE
This parameter determines whether the new volumes or save files are cataloged as “shareable” if the SHARE operand was not specified in the SAVE statement.
SHUPDW
This parameter defines the wait time in seconds in the event of a share update conflict on the directory file.
SNR
This parameter (Saved-Not-Restored) determines whether files and job variables that are not written back because they already existed are output in the ARCHIVE report when recovering with the IMPORT/RESTORE statements with the REPLACE=NO operand.
SPACE
This parameter specifies whether or not files to be replaced by files with the same names from the save run are to be deleted before restoration if the operand of the same name was not specified in the IMPORT or RESTORE statements.
STORAGE-TYPE
This parameter specifies whether Net-Storage is to be excluded from backup or restore
STREAM
This parameter determines whether the input and output operations on tape devices are performed in streaming mode.
TARGET-ARCHIVE-VERSION
This parameter determines whether the catalog entry for exported files is converted into a format that can be read by older ARCHIVE versions (< V2.6B) if the operand of the same name was not specified in the EXPORT statement.
TIME
This determines the number of CPU seconds available to this process once it is started if the NOW=NO operand was specified (either explicitly or as an ARCHIVE parameter) in the respective statements (e.g. SAVE etc) without a time specification.
TYPE
This parameter determines which ARCHIVE processes are listed if the operand of the same name was not specified in the STATUS statement.
UNLOAD
This parameter determines whether magnetic tapes are unloaded after being processed. The mount parameters defined at system level can also affect the actual behavior.
UNUSED
This parameter defines a selection of files to be saved, on the basis of the date of the last read or write access if the operand of the same name is not specified in the SAVE or EXPORT statements.
VOLUME
This parameter determines the VSNs of the output volumes if the operand of the same name was not specified in the SAVE or EXPORT statements.
WRCHK
This determines whether a read-after-write check (reading the file every time new content is added) is conducted when writing to hard disk, both when recovering files and when saving save files to disk.