This statement is used to list in a report the contents of volumes which were previously created with HSMS.
If node files are saved or archived on the volumes, the directory of a node archive can be updated or restored with the aid of the listed information.
All users – whether privileged or not – can only list the contents of volumes of which they are the owners.
Nonprivileged users receive only information about data of which they are the owners or co-owners.
The statement has the same format for HSMS administrators and nonprivileged users.
Format
LIST-VOLUMES | Alias: LIV | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
INPUT-VOLUME = list-poss(100): <vsn 1..6>
List of volumes to be read. All volumes must have the same device type, although they do not have to belong to the same save file. You do not need to specify the volumes in the order in which they were written.
DEVICE-TYPE = *STD / <device>
Device type of the input volumes; it must be from the “TAPE” class. Only device types known in the system are accepted. In interactive mode, DEVICE-TYPE=? calls up a list of the available device types.
*STD corresponds to the value which is set in the global HSMS parameters for S2-DEVICE-TYPE (see MODIFY-HSMS-PARAMETERS).
OUTPUT-DIRECTORY = *NONE / <filename 1..54 without-gen-vers>
For volumes that contain saved or archived node files only:
Name of the directory file to be updated or restored. If the directory file does not exist, it will be created.
If you specify the name of a repository, only the volumes produced by the HSMS statement BACKUP-NODE-FILES or ARCHIVE-NODE-FILES will be considered for updating the repository.
No check is made as to whether the volumes used for the restore belong to the specified directory file.
If the software product MAREN is in use, MAREN checks whether or not a volume only belongs to one directory file: The volume must be reserved for the caller of the LIST-VOLUMES statement; it must not be assigned to a directory file in the MAREN catalog. (If the volume is assigned to a directory file in the MAREN catalog, the corresponding archive must not contain the archive in its pool.)
OPERATION-CONTROL =
Allows you to define parameters for the execution of this run.
OPERATION-CONTROL = *STD
The default values of the operands described below apply.
OPERATION-CONTROL = *PARAMETERS(...)
You can modify the following operands that control the run:
OUTPUT =
Specifies where the report is to be output.
OUTPUT = *STD
The output destination of the report is determined by the default value that is defined by the global HSMS parameter OUTPUT.
OUTPUT = *PRINTER
The report is to be printed.
OUTPUT = *NONE
No report is output.
OUTPUT = *MAIL
The report is sent as an email attachment to the address which is entered in the caller’s user entry. If it is not possible to send the report by email, it is printed out.
OUTPUT = *LIBRARY-ELEMENT(...)
The report is edited and output to the specified PLAM library element (type P). If this is not possible, the report is printed out.
LIBRARY = <filename 1..54 without-gen-vers>
Name of the PLAM library.
ELEMENT = <composed-name 1..64 with-under>
Name of the element. A type P element is created with a version which contains the user ID plus the date and time.
OUTPUT = <filename 1..54 without-gen-vers>
The report for this run is to be prepared for printing and written to the specified file.If the file already exists, the following applies:
if it is a non-empty SAM file, it is continued
if not, the report is printed.
For nonprivileged callers the report files must be under the user’s own user ID. If not, co-ownership is a prerequisite.
TAPE-CONTROL =
The parameters relevant for saving to tape can be defined as follows.
TAPE-CONTROL = *STD
The relevant preset values which have been made for tape processing apply.
TAPE-CONTROL = *PARAMETERS(...)
The following operand relevant for saving to tape can be modified:
UNLOAD-TAPE = *STD / *YES / *NO
Specifies whether or not tapes are to be unloaded after processing.
The preset value which has been made for tape processing applies by default.