Privilege ADA, DA, administrator without domains
This statement displays information on the archive numbers of reserved or free tapes. Information on reserved tapes can be output on the basis of user IDs, volume groups or directories. Information on free tapes can be selected on the basis of a particular device type or its allocation to free tape pools. In addition, the selection of the tapes can be made via their assignment to a domain.
DAs can only execute the statement in their own domain. The DOMAIN operand is thus meaningless for them.
Format
| SHOW-VSNS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
SELECT =
Determines the selection criteria for the VSNs to be output and thus at the same time defines the criteria according to which the output is to be sorted.
SELECT = *USER-IDENTIFICATION(...)
The output is to be sorted according to user IDs. The output can be limited to certain user IDs.
USER-IDENTIFICATION = *ALL / <filename 1..8 with-wild>
Only the archive numbers of all tapes reserved for this user ID are output. An asterisk can also be specified as the last character of the user ID (e.g. TEST*). In this case, all archive numbers from all user IDs which begin with the character string specified (TEST) are selected. Wildcards other than “*” are not permitted.
USER-IDENTIFICATION = *ALL
The IDs are not evaluated during selection.
SELECT = *FILE-NAME(...)
The output is to be sorted according to file names. The output can be limited to certain file names
FILE-NAME = *ALL / <filename 1..41 with-wild-without-cat-user>
The archive numbers of all reserved tapes whose catalog entry contains the specified file name are listed. An asterisk can be specified as the last character of the file name (e.g. PROG*). In this case, the archive numbers for all file names which begin with the character string specified (PROG) are selected. Wildcards other than “*” are not permitted.
FILE-NAME = *ALL
VSNs are not selected on the basis of specific file names. Tape s whose catalog entry contains no file name or an ARCHIVE directory name constitute an exception.
SELECT = *DIRECTORY-NAME(...)
The output is to be sorted according to the names of directories. The output can be limited to a certain directory.
DIRECTORY-NAME = *ALL / <filename 1..54 without-gen-vers>
Only reserved tapes which are assigned to the pool of the specified directory are selected. If this directory is located under a remote user ID, both the user ID and the catalog ID must be entered. The user's own ID and standard catalog ID can be omitted.
DIRECTORY-NAME = *ALL
The archive numbers of all reserved tapes assigned to the pools of directories are listed.
SELECT = *FREE-VOLUMES(...)
Specifies that only the archive numbers of free tapes are to be listed.
DEVICE-TYPE =
Device type. If a directory name is specified for FREE-POOL, the DEVICE-TYPE entry is ignored.
DEVICE-TYPE = *STD
All tapes of the default device type (DEFAULT-DEVICE-TYPE) whose value was specified in the MODIFY-MAREN-PARAMETERS statement are listed.
DEVICE-TYPE = <structured-name 1..8>
Device type. For a list of possible entries (depending on the BS2000 version), see manual “System Installation” [6].
FREE-POOL =
Selects the archive entries to be made available on the basis of the free tape pool.
FREE-POOL = *NO
Only free tapes assigned to the *NO free tape pool are selected.
FREE-POOL = *GLOBAL
Only free tapes assigned to the *GLOBAL free tape pool are selected.
FREE-POOL = *TSOS
Only free tapes assigned to the *TSOS free tape pool are selected.
If aliases are specified for the *NO, *GLOBAL or *TSOS values, then these operand values will be expanded to their full length for compatibility reasons (e.g. *GL is expanded to *GLOBAL).
FREE-POOL = <filename 1..54 without-gen-vers>
Only free tapes assigned to the free tape pool for HSMS/ARCHIVE applications using the specified directory are selected. If this directory is located under a remote user ID, both the user ID and the catalog ID must be entered. The user's own ID and standard catalog ID can be omitted.
FREE-POOL = <text 2..32 without-sep>
Specifies the name of a free tape pool. The name of the free tape pool must begin with “*” followed by at least one character from A-Z or 0-9. The characters “.”, “-” and “_” are permitted, but not at the end and not next to each other.
SELECT = *VOLUME-GROUP(...)
The output is to be sorted according to the names of volume groups.
VOLUME-GROUP = *ALL / <text 1..32 without-sep>
The archive numbers of all reserved tapes are listed which contain the specified volume groups in the archive entry. When *ALL is specified, all reserved tapes are output which are explicitly assigned to a volume group. “*” can be entered as the last character. In this case all volume groups which begin with the specified string are selected.
OUTPUT =
Determines the output medium. Output to SYSOUT is the default.
OUTPUT = *SYSOUT
Output is directed to SYSOUT.
OUTPUT = *NONE
No output takes place. This specification only makes sense for structured output in an S variable (see the STRUCTURE-OUTPUT operand).
STRUCTURE-OUTPUT =
Controls the structured output in S variables.
STRUCTURE-OUTPUT = *NONE
No structured output takes place.
STRUCTURE-OUTPUT = <composed-name 1..255>(...)
Name of the S variable to be used for the structured output.
WRITE-MODE =
Determines whether the output should replace or extend the current content of the S variables.
WRITE-MODE = *REPLACE
The current content of the S variable is replaced by the new output.
WRITE-MODE = *EXTEND
The new output extends the current content of the S variable.
DOMAIN =
Only the archive numbers of tapes from the specified domain are to be output.
DOMAIN = *ANY
The archive numbers of tapes from all domains are output.
DOMAIN = *OWN
The archive numbers of tapes from the user’s own domain are output. The user’s own domain is the domain of the system on which the ADA is currently working.
DOMAIN = *STD-DOMAIN
The archive numbers of tapes from the standard domain are output.
DOMAIN = <alphanum-name 1..8>
The archive numbers of tapes from the selected domain are output.
If domains are used, the DA is shown free tapes either from the standard domain or from his/her own domain. This is dependent on which value the domain-specific FREE-VOLUMES operand has. The ADA is shown free tapes of the domain which is specified with the DOMAIN operand.
INFORMATION =
Defines the scope of the information to be displayed.
INFORMATION = *VOLUMES
Specifies that both archive numbers and the corresponding total number of archive numbers per user ID, file name, etc. are to be listed.
INFORMATION = *SUMMARY
Only the total number of archive numbers per user ID, file name, etc. are to be listed.
Notes
If there are two or more catalog entries with different file sequence numbers for a given archive number , this archive number is only specified once in connection with the corresponding user ID.
In the case of selection by file name, the archive number is also displayed in the case of a catalog entry with a file sequence number > 1.
Examples
Example 1: SYSOUT output for tapes of user IDs beginning with “SYS”:
//show-vsns user-id=sys*
|
Example 2: SYSOUT output for tapes sorted according to volume groups (by specifying SELECT=*VOLUME-GROUP(...)):
//show-vsns select=*volume-group(volume-group=epswos3*),information=*volumes
|
The INFORMATION=*VOLUMES operand enables the archive numbers of all reserved tapes to be output which contain a volume group name beginning with EPSWOS in the catalog entry. In addition, the total number of tapes which satisfy the specified selection criterion is output.
//show-vsns select=*volume-group(volume-group=epswos3*),information=*summary
|
INFORMATION=*SUMMARY outputs only the total number of tapes which contain the volume group EPSWOS3* in the catalog entry.
Output in S variables
This statement supports the structured output in S variables (controlled by the STRUCTURE-OUTPUT operand).
Further information on S variables is provided in the “Commands” manual [5].
| Output information | Name of the S variable | T | Contents |
| Access counter (8-digit) It is incremented each time the tape is accessed | var(*LIST).ACCESS-COUNT | S | <integer 0..99999999> |
| Creation date | var(*LIST).CRE-DATE | S | yyyy-mm-dd |
| Creation job name For HSMS request name | var(*LIST).CRE-JOB-NAME | S | ’’ <name 1..8> |
| Creation time | var(*LIST).CRE-TIME | S | hh:mm:ss |
| Device type | var(*LIST).DEV-TYPE | S | <structured-name 1..8> |
| Name of a directory (with catalog ID and user ID) which contains the tape | var(*LIST).DIR-NAME | S | <filename 1..54 > |
| Displays whether the tape contains the directory which was also saved | var(*LIST).DIR-ON-VOL | S | *NO *YES |
| Status (exported or not) | var(*LIST).EXPORTED | S | *NO *YES |
| First archive number of the MF/MV set | var(*LIST).FIRST-VOL | S | <vsn> |
| File name of a tape file (without catalog ID and user ID) | var(*LIST).F-NAME | S | <filename 1..41> |
| Expiration date of the tape Specifies when the reservation of the tape for the user ID is terminated | var(*LIST).FREE-DATE | S | yyyy-mm-dd |
| Release location A tape is moved to this location during the clear-up run | var(*LIST).FREE-LOCATION | S | <alphanum-name 1..8> |
| Name of the free tape pool in which this tape is located, or in which it should be located when it is shared | var(*LIST).FREE-POOL | S | <filename 1..54> *NO *GLOBAL *TSOS |
| File sequence number (4-digit) | var(*LIST).F-SEQ | S | <integer 1..9999> |
| Standard location | var(*LIST).HOME-LOCATION | S | <alphanum-name 1..8> |
| Name of the system with last access | var(*LIST).LAST-ACCESS- HOSTNAM | S | <alphanum-name 1..8> |
| Date of the last access | var(*LIST).LAST-ACCESS-DATE | S | yyyy-mm-dd |
| User ID of the last access | var(*LIST).LAST-ACCESS-USER-ID | S | <name 1..8> |
| Password for access | var(*LIST).PASS | S | *NONE *YES |
| Comment field which should be filled with a meaningful text | var(*LIST).REMARK | S | <c-string 1..24> |
| Reservation counter This counter is incremented with each new reservation of the tape | var(*LIST).RESERV-COUNT | S | <integer 0..9999> |
| Reservation date Date on which a tape is reserved | var(*LIST).RESERV-DATE | S | yyyy-mm-dd |
| SAVE-FILE-ID (HSMS) or SAVE-VERSION (ARCHIVE) | var(*LIST).SFID | S | <c-string 1..15> |
| Number of subtask for parallel save run in HSMS | var(*LIST).SUBSAVE | S | <integer 0..15> |
| Number of subsequent tape within a parallel save run in HSMS | var(*LIST).SUBSEQ | S | <integer 0..999> |
| Shareability of the tape | var(*LIST).USER-ACCESS | S | OWNER-ONLY FOREIGN-READ ALL-USERS |
| Account number | var(*LIST).USER-ACCOUNT | S | <alphanum-name 1..8> |
| User field Data such as name and department or data relevant for operations scheduling can be entered here | var(*LIST).USER-FIELD | S | <c-string 1..54> |
| User ID of the owner | var(*LIST).USER-ID | S | <name 1..8> |
| Tape VSN | var(*LIST).VOL | S | <vsn> |
| Volume group Only has a valid value with reserved tapes, otherwise it is undefined | var(*LIST).VOL-GROUP | S | <text 1..32> |
| Volume sequence number (4-digit) | var(*LIST).VOL-SEQ | S | <integer 1..255> |
| Tape status F = FREE P = PRIVATE R = RESERVED D = DEFECT | var(*LIST).VOL-STA-1 | S | F/P/R/D |