This statement is used to list in a report the contents of disk save files previously created with HSMS.
All users – whether privileged or not – can only list the contents of save files of which they are the owners.
Non-privileged users only receive information about the data of which they are the owner or co-owner.
The statement has the same format for HSMS administrators and non-privileged users.
Format
LIST-SAVE-FILE | Alias: LSF | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SAVE-FILE =
Defines the save file to be read. Processing will also be executed for save files that have several parts (due to several parallel runs or/and it is spread over several volume sets).
SAVE-FILE = *BY-PUBLIC-DISK(...)
The save file is selected by the pubset on which it resides.
SAVE-FILE-ID = <composed -name 15..15>
The files are listed only from the specified save file. The save file ID must be specified as follows: S.yymmdd.hhmmss
PUBSET-ID = <cat-id 1..4>
Specifies the catalog ID of the pubset where the save file is located.
If the save file is located on Net-Storage and has been created in HSMS V10.0A functionality and above (SAVE-FILE-PROC = *HSMS-V10-COMPATIBLE) this is the pubset to which the Net-Storage volume is assigned.
SAVE-FILE = *BY-DISK-VOLUME(...)
The save file from which the files are to be listed is defined by the disk volume on which it resides.
SAVE-FILE-ID = <composed-name 15..15>
The files are listed only from the specified save file. The save file ID must be specified as follows: S.yymmdd.hhmmss
VOLUMES = list-poss(150): <vsn 1..6>
Volume serial number of the private disk or Net-Storage volume is containing the save file with the files to be listed.
If the save file is located on Net-Storage and has been created up to HSMS V9.0A (SAVE-FILE-PROC = *HSMS-V9-COMPATIBLE) this is the Net-Storage volume of required save file.
More than one private disk or Net-Storage volume can also be specified in a list. Up to 150 entries can be specified for private disk and up to 16 for Net-Storage. The specified volumes must be accessible.
DEVICE-TYPE = STDDISK / <device>
Device type of the requested volumes. The default setting STDDISK specifies that the default device type is to be used. Only device types known in the system are accepted. In interactive mode, DEVICE-TYPE=? calls up a list of the available device types. For Net-Storage volumes the NETSTOR type is used.
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 = *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.