Privilege ADA, DA, administrator without domains
Using this statement it is possible to display the names of all existing volume groups.
Volume group is logically related tapes, which are combined by the MAREN user to form a volume group. The volume group is an additional catalog entry field in the volume catalog, not a separate administrative unit. Related tapes can be combined to form a volume group. All files, which are located on the tape, belong to the same volume group. When a volume group is defined for a file on a tape, MAREN automatically updates all the file specific catalog entries of this tape. Only reserved tapes can be assigned to a volume group. When the tape is released, the volume group assignment of MAREN is canceled again.
Format
SHOW-VOLUME-GROUP Alias: SHVG | |||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
GROUP = *ALL
Output the names of all existing volume group names.
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.
Examples
Example 1: Output names of all existing volume group
--------------------------------------------------------------------- |
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].
The following S variables are created:
| 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 |