Using this command 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 assignment to the volume group is canceled again by MAREN.
Format
SHOW-VOLUME-GROUP Alias: SHVG | ||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
GROUP = *ALL
Select the names of all existing volume groups.
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 groups
---------------------------------------------------------------------
--------------------------------------------------------------------- |
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 [3].
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 |