The LIST statement is used to list files, job variables and catalog entries saved on one or more volumes of one save run.
You must specify the files and/or job variables to be processed with FILES and/or JOBVAR statements before you enter the LIST statement.
L[IST] |
DIR[ECTORY] = NONE / filename ,FR[OM] = svid / [svid,](vsn,...),... ,CONSISTENCY-CHECK / CONS-CHK = NO / YES ,NOW = YES / NO[,TIME = sec] |
DIRECTORY =
This defines whether a directory file is used for the ARCHIVE run.
DIRECTORY = NONE
Unless otherwise specified, LIST runs are performed without a directory file.
DIRECTORY = filename
The name of the directory file used for the SAVE or EXPORT run is specified here.
FROM =
This specifies the input volumes or save version from which the files or job variables are to be read.
FROM = svid
Every file or job variable requested by a FILES or JOBVAR statement and belonging to this save version (svid) is listed. The specification of a directory file is mandatory.
FROM = (vsn,...),...vsn is the volume serial number of the volume from which the files in the FILES statement and job variables in the JOBVAR statement are to be listed. This operand is not permitted when saving to disk.
The VSNs must be grouped according to the parallel runs, i.e. the VSNs specified (in the right order) in parentheses must belong to the same subsave run.
FROM = svid,(vsn,...),...
As above.
In addition, if a directory file is specified, ARCHIVE checks whether the volumes specified belong to this save version. If not, the run is aborted.
DEVICE = device type
This operand specifies the device type. This must be the same type as was specified for the save run.
The DEVICE operand defines the device type for all the VSNs, including those specified only indirectly, e.g. in FROM=svid.
The default value is TAPE-C4 with DIRECTORY=NONE; otherwise the device type is taken from the directory.
DRIVES = 1 / integer
This specifies the number of parallel runs (up to 16).
CONSISTENCY-CHECK / CONS-CHK =
This determines whether a consistency check of the save data is carried out.
CONSISTENCY-CHECK = NO
No consistency check is carried out.
CONSISTENCY-CHECK = YES
Before transferring save data, the check bytes are calculated and a comparison is made with the check bytes stored with the save data during EXPORT. If an error occurs, the message ARC0413 is output.
This operand value is ignored if the EXPORT or SAVE operations were carried out with the CONSISTENCY-CHECK=NO operand.
NOW =
This operand specifies when the LIST statement is to be executed.
NOW = YES
The LIST statement is executed immediately.
NOW = NO
The LIST statement is checked for correct syntax and then written to the queue file ARCHIVE.LATER. This process is given the ARCHIVE identifier L.yymmdd.hhmmss.
The identifier is only allocated if no LATER job exists in the same task at the time. If this is not the case, then the process is stored under the existing identifier.
The LATER job can be started by means of a PROCESS statement or deleted by means of a DELETE statement.
NOW = NO,TIME=sec
The number of CPU seconds that are available to this process when it is started. This entry corresponds to the operand CPU-LIMIT in /START-(EXECUTABLE-)PROGRAM.
PASSWORD = password / (password,...)
If you specify the operand NOW=NO, you must enter passwords here for
the directory file, if it is protected by a write password and is not under TSOS.
the save version, if it has been protected by a password with SVPASS.
magnetic tapes and MT cartridges that are protected by a password (up to 4 characters) under MAREN.
In all other cases, you should enter the passwords with the /ADD-PASSWORD command before ARCHIVE is called. Only in this case are the passwords also valid for the subsequent ARCHIVE runs of the same user job.
The system support must specify the password for the directory file if the file is assigned under another user ID.
LIST =
This defines the output medium for the report of this ARCHIVE run
LIST = SYSLST
The report is output to SYSLST.
LIST = SYSOUT
In interactive mode, the report is output to the terminal.
LIST = BOTH
The report is output to both SYSLST and SYSOUT.
LIST = ...,ALL
All the file names on the volume read in are listed. If a save version (svid) has been specified in the FROM operand at the same time, all the files in this save version are listed (not only those specified in the FILES or JOBVAR statement).