MAREN V12.6 (en)

&pagelevel(4)&pagelevel

This statement outputs information from a MAREN catalog file to SYSOUT. If an individual archive number is entered, its complete catalog entry is shown. If a number range is entered or *ALL is specified, selected important catalog entry fields are output. If an output file is specified, the complete catalog entries of the specified tapes are output. The file can also be created in CSV format to permit spreadsheet processing. It can also be specified that the file is sent by email after it has been created.

As of MAREN V12.6, the new VOLUME-STATE operand is provided, which selects tapes from the MAREN catalog based on their status.

Lists with information from the MAREN catalog are created by the PRINT-VOLUME-ATTRIBUTES statement, see "PRINT-VOLUME-ATTRIBUTES Create list with information from the MAREN catalog".

Format

SHOW-VOLUME-ATTRIBUTES Alias: SH / SHVA

VOLUME = ALL / INTERVAL(...) / <vsn>(...)
	*INTERVAL(...)
		\|	FROM = *FIRST / <vsn>
		\|	,TO = *LAST / <vsn>
		\|	,FROM-FSEQ = 1 / <integer 1..9999>
	<vsn>(...)
		\|	FILE-SEQUENCE = 1 / <integer 1..9999>
,VOLUME-*STATE = ALL / FOREIGN* / PRIVATE / RESERVED / *EXPORTED
,USER-IDENTIFICATION = *OWN / <name 1..8>
,FILE-NAME = ALL / NONE / <filename 1..41 without-cat-user-gen-vers with-wild>(...) /
					<filename 1..41 without-cat-user-gen-vers>(...)
	<filename 1..41 without-cat-user-gen-vers with-wild>(...)
		\|	VOLUME = ANY / NEXT(...)
		\|		*NEXT(...)
		\|			\|	FROM = *FIRST / <vsn>
		\|			\|	,FROM-FSEQ = <integer 1..9999>
	<filename 1..41 without-cat-user-gen-vers>(...)
		\|	VERSION = ALL / LATEST / <integer -9999..0> / *NOT-CREATED
		\|	,TYPE-OF-VOLUMES = ANY / VALID(...) / *OBSOLETE
		\|		*VALID(...)
		\|			\|	CLOSE-CHECK = NO / YES
,DIRECTORY-NAME = ALL (...) / NONE / <filename 1..54 without-gen-vers>(...)
	*ALL (...)
		\|	DIRECTORY-ON-VOLUME = ANY / YES
	<filename 1..54 without-gen-vers>(...)
		\|	VOLUME-STATUS = RESERVED(...) / FREE
		\|		*RESERVED(...)
		\|			\|	SAVE-FILE-ID = ALL / LATEST / <integer -32767..0> / <composed-name_15..15>
		\|			\|	,DIRECTORY-ON-VOLUME = ANY / YES
,VOLUME-GROUP = ANY / NONE / <text 1..32 without-sep>
,HOME-LOCATION = *ALL / <alphanum-name 1..8>
,DEVICE-TYPE = ALL / STD / <structured-name 1..8>
,OUTPUT = SYSOUT / NONE / <filename 1..54> / <filename 1..54 without-gen-vers>(...)
	<filename 1..54 without-gen-vers>(...)
		\|	FORMAT = MAREN-STRUCTURE / CSV(...)
		\|		*CSV(...)
		\|			\|	SEPARATOR = SEMICOLON / COMMA
		\|			\|	,HEADER-LINE = YES / NO
		\|	,SEND-BY-MAIL = NO / YES(...)
		\|		*YES(...)
		\|			\|	TO = *USER (...)
		\|			\|		*USER (...)
		\|			\|			\|	USER-IDENTIFICATION = *OWN / <name 1...8>
		\|			\|	,SUBJECT = *STD /<c-string 1...256>
		\|			\|	,DELETE-FILE = NO / YES / *DESTROY
,STRUCTURE-OUTPUT = *NONE / <composed-name 1..255> (...)
		\|		<composed-name 1..255> (...)
		\|			\|	WRITE-MODE = REPLACE / EXTEND
,OVERFLOW-CONTROL = BY-PROGRAM / BY-SYSTEM
,INFORMATION = STD / NORMAL / MAXIMUM / V8.1-AND-LOWER ¹

¹The operand value *V8.1-AND-LOWER is obsolete. It can still be specified for compatibility reasons.

Operands

VOLUME =
Archive numbers of tapes about which information is required.

VOLUME = *ALL
All tapes are processed.

VOLUME = *INTERVAL (...)
All tapes whose archive number lies within the range specified below are processed.

FROM = *FIRST
All tapes are processed, starting with the lowest available archive number.

FROM = <vsn>
Archive number. All tapes whose archive number is greater than or equal to the specified archive number are processed.

TO = *LAST
All tapes are processed up to the highest existing archive number.

TO = <vsn>
Archive number. All tapes whose archive number is less than or equal to the specified archive number are processed.

FROM-FSEQ = 1 / <integer 1..9999>
File sequence number of the FROM operand. Specifies the precise file sequence number at which processing is to begin. This operand is relevant only if the statement is issued via the MAREN program interface.

VOLUME = <vsn>(...)
Archive number of the desired tape.

FILE-SEQUENCE = 1 / <integer 1..9999>
Specifies which file sequence number of the specified archive numbers is to be processed.

VOLUME-STATE =
Selects tapes from the Maren catalog on the basis of their status.

VOLUME-STATE = *ALL
Tapes are selected regardless of their status.

VOLUME-STATE = *FOREIGN / *PRIVATE
Only private tapes are output. This tape is not owned by the local data center, which is why *FOREIGN is used synonymously for *PRIVATE. A user initiates the import into the MAREN catalog via the administrator in order to be processed in the local data center for a limited period of time.

VOLUME-STATE = *RESERVED
Only reserved tapes are output. If these are assigned to a foreign user ID, only the tapes which are shareable are displayed.

VOLUME-STATE = *EXPORTED
Only exported tapes are output.

USER-IDENTIFICATION = *OWN / <name 1..8>
All catalog entries of tapes assigned to this user ID are displayed. In the case of a foreign user ID, only the shareable tapes are displayed.

USER-IDENTIFICATION = *OWN
Only volumes of the user’s own ID are selected.

FILE-NAME =
This allows you to limit output to catalog entries with a specific file name.

FILE-NAME = *ALL
All catalog entries which contain a file name are output. The default value *ALL is taken into account only if *ALL or *NONE is specified in the DIRECTORY-NAME operand.

FILE-NAME = *NONE
Catalog entries which contain a file name are not output.

FILE-NAME = <filename 1..41 without-cat-user-gen-vers with-wild>(...)
A wildcard (*) can be specified as the last character of the file name (e.g. PROG*). In this case, all catalog entries for all file names which begin with the character string specified (“PROG”) are selected. The VOLUME operand can be used to define the tape with which output is to begin.

VOLUME = *ANY / *NEXT(...)
Tape with which output is to begin. This operand must be specified for the MAREN program interface. It ensures that all catalog entries can be read. In interactive mode, it is possible to specify the tape with which output is to begin. The default value is *ANY, i.e. all catalog entries relating to files that match the specified string are output.

VOLUME = *NEXT(...)
All catalog entries after the specified catalog entry whose file names match the specified string are output. Thus all entries can be listed for the MAREN program interface. The last catalog entry read must be specified in the FROM and FROM-FSEQ operands.

FROM = <vsn>
Archive number of the tape with which output is to begin.

FROM-FSEQ = <integer 1..9999>
File sequence number which matches the archive number.

FILE-NAME = <filename 1..41 without-cat-user-gen-vers>(...)
Only catalog entries with this file name are output.

VERSION =
This operand is evaluated only if VOLUME=*ALL or *INTERVAL. This operand can be used to select a specific version (or status) of the specified file for which the associated tapes are to be output.

VERSION = *ALL
Selects all versions which exist for the specified file name.

VERSION = *LATEST
Selects the latest version of the file (i.e. the last one created).

VERSION = <integer -9999..0>
Specifying 0 is equivalent to specifying *LATEST, specifying -1 indicates the penultimate file status, etc.

VERSION = *NOT-CREATED
Selects only those tapes which have been reserved with the specified file name but which have not been used (the CREATION-DATE and CREATION-TIME catalog entry fields have not been set). The TYPE-OF-VOLUMES setting is of no consequence in this case and is therefore not interpreted.

TYPE-OF-VOLUMES =
This operand selects the volume sequences (catalog entry field VOLUME-SEQUENCE) within a tape set. These numbers are usually unique. Some numbers may be duplicated following a restart.

If the following are specified, the TYPE-OF-VOLUMES operand is ignored:

VERSION = *NOT-CREATED;
VOLUME = <vsn>.

TYPE-OF-VOLUMES = *ANY
The volume sequences for a tape set are not checked to establish whether they occur more than once.

TYPE-OF-VOLUMES = *VALID(...)
If a volume sequence occurs more than once in a tape set, the one created most recently is selected.

CLOSE-CHECK =
This operand allows you to select whether the catalog entry fields CLOSE-INDICATOR should be evaluated.

If the following are specified, the CLOSE-CHECK operand is ignored:

VERSION = *NOT-CREATED;
VOLUME = <vsn>.

CLOSE-CHECK = *NO
The CLOSE-INDICATOR catalog entry field is not evaluated.

CLOSE-CHECK = *YES
If the CLOSE-INDICATOR catalog entry field is not set to CLOSED for one of the tapes in the tape set, the statement is aborted.

TYPE-OF-VOLUMES = *OBSOLETE
If a volume sequence occurs more than once in a tape set, all VSNs are selected except the one most recently created.

DIRECTORY-NAME =
Only tapes which are assigned to 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 user ID and standard catalog ID can be omitted.

DIRECTORY-NAME = *ALL(...)
All catalog entries which contain the name of a directory are output. The default value *ALL is taken into account only if *ALL or *NONE is specified in the FILE-NAME operand.

DIRECTORY-ON-VOLUME = *ANY / *YES
Specifies whether the output should be restricted to tapes which contain a directory at the end of the tape. The default *ANY causes tapes to be displayed irrespective of whether they contain a directory.

DIRECTORY-NAME = *NONE
Catalog entries containing the name of a directory are not output.

DIRECTORY-NAME = <filename 1..54 without-gen-vers>(...)
Name of the directory.

VOLUME-STATUS =
Selects tapes in the specified directory on the basis of their status.

VOLUME-STATUS = *RESERVED(...)
Only reserved tapes are to be output. If these are assigned to a foreign user ID, only the tapes which are shareable are displayed.

SAVE-FILE-ID =
The tapes that are to be exported are selected using the save file of the directory specified above.

SAVE-FILE-ID = *ALL
All tapes from the specified directory are exported.

SAVE-FILE-ID = *LATEST
All tapes listed in the last, i.e. most recent save file are selected.

SAVE-FILE-ID = <integer -32767..0>
All tapes listed in the nth save file are selected (the older the save file, the larger the number n). 0 equals *LATEST. Example: if -5 is specified, the tapes are selected from the last save file but five.

SAVE-FILE-ID = <composed-name 15..15>
All tapes in the save file with the specified SAVE-FILE-ID are selected. The SAVE-FILE-ID has the following format: S.yymmdd.hhmmss.

DIRECTORY-ON-VOLUME = *ANY / *YES
Specifies whether the output should be restricted to tapes which contain a directory at the end of the tape. The default *ANY causes tapes to be displayed irrespective of whether they contain a directory.

VOLUME-STATUS = *FREE
Only tapes which are still in MAREN's HSMS/ARCHIVE free tape pool for the specified directory are to be output, i.e. those volumes which are available for future HSMS/ARCHIVE backups using this directory. The USER-IDENTIFICATION operand is not evaluated.

VOLUME-GROUP = *ANY / *NONE / <text 1..32 without-sep>
Only those tapes are output which are assigned to the specified volume group. When *ANY is specified, the volume group to which the tape belongs is irrelevant. When *NONE is specified, the tape may not be 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.

HOME-LOCATION =
Location name or symbolic location name.

HOME-LOCATION = *ALL
All permanent locations are processed.

HOME-LOCATION = <alphanum-name 1..8>
All catalog entries with the specified permanent location are processed.

DEVICE-TYPE =
Device type.

DEVICE-TYPE = *ALL
The catalog entries of all device types are output.

DEVICE-TYPE = *STD
All tapes of the default device type defined by the MAREN administrator 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].

OUTPUT =
Determines the output medium.

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).

OUTPUT = <filename 1..54>
Only for specifying a file generation.
Output is directed to the specified file generation in MAREN format. Passwords are overwritten with C'$$$$'. Only the number of records written is displayed on SYSOUT.

OUTPUT = <filename 1..54 without-gen-vers>(...)
Name of the SAM output file to which all selected catalog entries are to be written. Passwords are overwritten with C'$$$$'. Only the number of records written is displayed on SYSOUT. The output format and transfer by email can also be specified.

FORMAT =
Determines the format of the output file.

FORMAT = *MAREN-STRUCTURE
Output takes place in MAREN format.

FORMAT = *CSV(...)
Output takes place in CSV (comma separated value) format. Files in CSV format can be read in so that the columns are retained, and they can be processed further with a spreadsheet program (e.g. EXCEL).

SEPARATOR = *SEMICOLON / *COMMA
Determines the separator which is to be set between the various output values. The default separator is a semicolon (;). Optionally a comma (,) can be used as the separator.

HEADER-LINE = *YES / *NO
Specifies whether a header line should be output to name the output columns. The default is *YES, i.e. the header line is output. The header line contains the names of the catalog entry fields.

SEND-BY-MAIL = *NO / *YES(...)
Specifies whether the output file should be sent by email. The default is *NO, i.e. it is not sent by email. Transfer by email takes place only if the file to be sent contains at least one entry.

SEND-BY-MAIL = *YES(...)
The output file should be sent as an email attachment. The recipient is addressed by means of his/her user ID, i.e. the email address is taken from the user entry concerned.

TO = *USER(...)
Details of transfer by email:

USER-IDENTIFICATION = *OWN / <name 1...8>
Specifies the user ID. The recipient’s email address is taken over from this user entry. If the user entry contains more than one email address, all the addresses are taken over as recipients. The default is *OWN, i.e. the caller’s user ID.

SUBJECT = *STD /<c-string 1...256>
Determines the content of the email’s “Subject” field. The default is *STD, i.e. MAREN uses a standard text.

DELETE-FILE = *NO / *YES / *DESTROY
Specifies whether the file should be automatically deleted after it has been sent. The default is *NO, i.e. the file is not deleted. *YES causes the file to be deleted after it has been sent. *DESTROY also causes it to be deleted, and the memory space is overwritten with binary zeros.

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.

OVERFLOW-CONTROL =
Type of screen overflow control in interactive mode.

OVERFLOW-CONTROL = *BY-PROGRAM
Control by the program: After eighteen catalog entries have been processed, a message is displayed inquiring whether the current operation is to be continued or aborted.

OVERFLOW-CONTROL = *BY-SYSTEM
Control by BS2000: Screen overflow control is based entirely on the system parameter TCHOFLO or the value set in the MODIFY-TERMINAL-OPTIONS command.

INFORMATION =
If a single tape is specified, this operand determines the output format for output to SYSOUT.

INFORMATION = *STD
The output format is determined on the basis of the MAREN parameters if no previous entry (SHOW-INFORMATION=NORMAL, MAXIMUM) modified the standard format for this particular program run.

INFORMATION = *NORMAL
Output will contain all essential information. Output is not guaranteed and may be changed again in future software versions. If *NORMAL is specified, this will remain the new standard until the program is loaded the next time.

INFORMATION = *MAXIMUM
The output contains all information. Output is not guaranteed and may be changed again in future software versions. If *MAXIMUM is specified, this will remain the new standard until the program is loaded the next time.

Notes

Only one of the operands FILE-NAME and DIRECTORY-NAME may ever have an operand value other than the default *ALL.
Using the operand VOLUME-STATUS = *FREE, it is possible to check prior to the start of a HSMS/ARCHIVE backup run whether there are still enough tapes for backup runs using this directory. This operand should only be used if the MAREN administrator has actually set up an HSMS/ARCHIVE free tape pool for this directory. A step normally only undertaken in response to an explicit user request.
If an individual archive number is specified and this is not found in the MAREN catalog, or a number range is specified and no catalog entry is found within this range, the statement is aborted with an error message and the spin off is triggered.
If an individual VSN is specified, only YES or NONE is output for PASSWORD, and foreign user IDs and their account numbers are replaced by “$”. By default, information is entered in a single screen in interactive mode, whereas in batch mode it is entered line by line. Setting task switch 5 selects line-by-line input in interactive mode too. This improves the readability of catalog entries in SYSOUT logs.
If the FSEQ number *001 appears in a specification based on number ranges, a temporarily locked tape is involved.
Specification of a single archive number will be rejected if made together with the parameter FILE-NAME=<filename>(...) and if non-default values are used for its VERSION and TYPE-OF-VOLUMES operands.
When a list of tapes is displayed, the VOLUME GROUP column appears only when the VOLUME-GROUP operand contains a wildcard. If another selection operand was also specified, another display layout may be preferred. If the name of the volume group is longer than 28 characters, it is truncated by an asterisk at position 28.

Examples

Example 1: Output of a single MAREN catalog entry


              //show-volume-attributes volume=qe0044,information=*maximum
              

              VOLUME    = QE0044       FILE-SEQ      = 0001          DEV-TYPE    =  TAPE-C4

              USER-ID   = TSOS         HOME-LOCATION = HSMSLOC       RESERV-DATE =  <date>

              ACCOUNT   = ADMINSTR     FREE-LOCATION = HSMSLOC       FREE-DATE   =  <date>

              USER-ACC  = OWNER-ONLY   TEMP-LOCATION = CENTRAL       EXPIR-DATE  =  <date>

              PASSWORD  = NONE

              EXPORT-AD = C'XCXXX                                             '  /

              REMARK /1 = C'                        ' /2 = C'          ' /3 = C'          '

              USER-FIELD= C'                                                      '

              DIR-NAME  = :POPP:$TSOS.MAREN.V90B.DIR

              SAVE-FILE = S.020716.142715 SUBSAVE/SEQ = 00/001 CR-JOB/REQUEST-NA = SFID#003

              FREE-POOL = *TSOS                                CR-CAT-ID          = SXV7

              VOL-GROUP =                                      CR-USER-ID         = TSOS

              VOL-SEQ   = 0001       CR-DATE      = <date>     LAST-ACC-DATE      = <date>

              FIRST-VOL = QE0044     CR-TIME      = <time>     LAST-ACC-TIME      = <time>

              CLOSE-IND = CLOSED     LAST-CL-DATE = <date>     LAST-ACC-USER-ID   = TSOS

              VOL-STATUS= RESERVED   LAST-CL-TIME = <time>     LAST-ACC-ACCOUNT   =ADMINSTR

              INIT      = YES        DIR-ON-VOL   =            LAST-ACC-JOB-NAME  =SFID#003

                                                               LAST-ACC-TSN       =

                                                               LAST-ACC-HOSTNAME  = POPPEA2

                                                               LAST-WRITE-BLK-CNT = 7423

              OPEN-MODE = OUTIN      ACCESS-COUNT = 00000030   LAST-ACC-SNO       = 089

Information output with all information.

Example 2: Output of all tapes under the own user ID


              //show-volume-attributes volume=*all,user-id=*own
              

              VOLUME FSEQ DEV-TYPE CR-DATE    L-A-DATE   FREE-DATE  UA E REMARK (SHORTENED)

              -----------------------------------------------------------------------------

              C0725K 0001 TAPE-C4  <date>     <date>     <date>     AL   SF-EVALUATION

              G5110K 0001 TAPE-C4             <date>     <date>     AL

              G6013K 0001 TAPE-C4             <date>     <date>     AL

              M4696K 0001 TAPE-C4  <date>     <date>     <date>     FR

              M5632K 0001 TAPE-C4                        <date>     AL

              M5633K 0001 TAPE-C4                        <date>     AL

              M5634K 0001 TAPE-C4                        <date>     AL

              M5635K 0001 TAPE-C4  <date>     <date>     <date>     AL    PROGRAM 1

              M5636K 0001 TAPE-C4                        <date>     AL

              M5637K 0001 TAPE-C4  <date>     <date>     <date>     AL    SAVE PROJECT1

              M5637K 0002 TAPE-C4  <date>     <date>     <date>     AL

              M5637K 0003 TAPE-C4  <date>     <date>     <date>     AL

              %  MARM120 TOTAL OF 12 MAREN CATALOG ENTRIES PROCESSED

Meaning of the catalog entry fields:

VOLUME

FSEQ

DEV-TYPE

CR-DATE

L-A-DATE

FREE-DATE

UA

E

REMARK

Archive number

File sequence number

Device type

Creation date

Last access

Tape expiration date; If no date is entered, the tape is a foreign tape.

USER-ACCESS - the following values may be displayed:

AL for ALL-USERS
FR for FOREIGN-READ-ONLY
OW for OWNER-ONLY

Export flag

An exported tape is flagged with “E” (EXPORTED).

Remark field (first 20 characters only)

Example 3: Output of all tapes for a specific file name


              //show-volume-attributes file-name=tape*
              

              -----------------------------------------------------------------------------

              VOLUME FSEQ CR-DATE    CR-TIME  CR-JOB   1STVSN VSEQ FILE/DIR-NAME(SHORTENED)

              -----------------------------------------------------------------------------

              M5634K 0001                     ULF             0001 TAPE.FILE.1

              M5635K 0001 <date>     <time>   ULF      M5635K 0001 TAPE.FILE.1

              M5638K 0001                     ULF2            0001 TAPE.FILE.2

              M5639K 0001                     ULF2            0001 TAPE.FILE.2

              M5640K 0001                     ULF2            0001 TAPE.FILE.2

              M5637K 0001 <date>     <time>   ULF2     M5637K 0001 TAPE.FILE.2(1)

              M5637K 0002 <date>     <time>   ULF2     M5637K 0001 TAPE.FILE.2(2)

              M5637K 0003 <date>     <time>   ULF2     M5637K 0001 TAPE.FILE.2(4)

              M5655K 0001                                     0001 TAPE.FILE.3

              %  MARM120 TOTAL OF 9 MAREN CATALOG ENTRIES PROCESSED

Meaning of the catalog entry fields:

VOLUME

FSEQ

CR-DATE

CR-TIME

CR-JOB

1STVSN

VSEQ

FILE/DIR-NAME

Archive number

File sequence number

Creation date

Creation time

Creation job name

First archive number of the MF/MV set

File section number

File or directory name (first 26 characters only)

Example 4: Output of all MAREN catalog entries for a directory with a specific SAVE-FILE-ID


              //show-volume-attributes directory-name=maren.v90b.dir(save-file-id=-0)
              

              %  MARM195 NO DIRECT ACCESS TO MAREN CATALOG POSSIBLE

               ----------------------------------------------------------------------------

               VOLUME USER-ID  REQ-NAME DIRECTORY-NAME (SHORTENED)  SAVE-FILE-ID SUB-SV/SEQ

               ----------------------------------------------------------------------------

               QE0020 TSOS     SFID#001 :POPP:$TSOS.MAREN.V90B.DIR   S.020716.135432 00 001

               QE0021 TSOS     SFID#001 :POPP:$TSOS.MAREN.V90B.DIR   S.020716.135432 01 001

               QE0023 TSOS     SFID#001 :POPP:$TSOS.MAREN.V90B.DIR   S.020716.135432 02 001

               QE0022 TSOS     SFID#001 :POPP:$TSOS.MAREN.V90B.DIR   S.020716.135432 03 001

               QE0024 TSOS     SFID#001 :POPP:$TSOS.MAREN.V90B.DIR   S.020716.135432 03 002

              %  MARM120 TOTAL OF 5 MAREN CATALOG ENTRIES PROCESSED

The information concerning all of the tapes contained in the last, i.e. in the most recent save file is output.

Example 5: Output of all tapes for a specific volume group


              //show-volume-attributes *interval(sh,sh9),vol-group=EPSWOS3*
              

              -----------------------------------------------------------------------------

              VOLUME FSEQ VOLUME-GROUP                 1STVSN VSEQ FILE/DIR-NAME(SHORTENED)

              -----------------------------------------------------------------------------

              SH0024 0001 EPSWOS3-GER                  SH0024 0001 TAPE.FILE

              SG0025 0001 EPSWOS3-CLM-AAAAAAAAAAAAAAA* SH0025 0001 :2OS6:$SYSHSMS.DIR.12345

The tapes which belong to the volume groups EPSWOS3* are output for a range of archive numbers. If the name of the volume group is longer than 28 characters, it is truncated by an asterisk at position 28.

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].

Depending on the VOLUME operand, the following S variables are created:

Entry in the VOLUME operand

Abbreviated notation in table, Condition column

VOLUME=<vsn> (one tape)

VOLUME=*ALL/*INTERVAL (multiple tapes)

1

2

Output information	Name of the S variable	T	Contents	Condition
Access counter (8-digit) It is incremented each time the tape is accessed.	var(*LIST).ACCESS-COUNT	S	<integer 0..99999999>	1,2
CLOSE indicator Provides information on whether creation of a tape file has been terminated correctly.	var(*LIST).CLOSE-INDICATOR	S	OPENED CLOSED	1
Catalog ID from the file name at the time of file creation. It is only supplied if F-NAME exists	var(*LIST).CRE-CAT-ID	S	<cat-id>	1
Creation date	var(*LIST).CRE-DATE	S	yyyy-mm-dd	1,2
Creation job name For HSMS request name.	var(*LIST).CRE-JOB-NAME	S	’’ <name 1..8>	1,2
Creation time	var(*LIST).CRE-TIME	S	hh:mm:ss	1,2
User ID from the file name at the time of file creation. It is only supplied if F-NAME exists.	var(*LIST).CRE-USER-ID	S	’’ <name 1..8>	1
Device type	var(*LIST).DEV-TYPE	S	<structured-name 1..8>	1,2
Name of a directory (with catalog ID and user ID) which contains the tape.	var(*LIST).DIR-NAME	S	<filename 1..54>	1,2
Displays whether the tape contains the directory which was also saved	var(*LIST).DIR-ON-VOL	S	NO YES	1,2
File expiration date	var(*LIST).EXPIR-DATE	S	yyyy-mm-dd	1
Mailing address In the case of the EXPORT-VOLUME statement, the mailing address can, for instance, be entered here.	var(*LIST).EXPORT-ADDR	S	<c-string 1..50>	1
Export date For tapes which are not exported this catalog entry field contains a blank.	var(*LIST).EXPORT-DATE	S	yyyy-mm-dd	1
Status (exported or not)	var(*LIST).EXPORTED	S	NO YES	1,2
File name of a tape file Without catalog ID and user ID Provided the file is not contained in a directory.	var(*LIST).F-NAME	S	<filename 1..41>	1,2
File sequence number (4-digit)	var(*LIST).F-SEQ	S	<integer 1..9999>	1,2
First archive number of the MF/MV set	var(*LIST).FIRST-VOL	S	<vsn>	1,2
Expiration date of the tape Specifies when the reservation of the tape for a user ID can be terminated.	var(*LIST).FREE-DATE	S	yyyy-mm-dd	1,2
Release location A tape is moved to this location during the clear-up run.	var(*LIST).FREE-LOCATION	S	<alphanum-name 1..8>	1,2
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	1,2
Standard location	var(*LIST).HOME-LOCATION	S	<alphanum-name 1..8>	1,2
initialization flag	var(*LIST).INIT	S	YES NO ERASE	1
Account number of the last access	var(*LIST).LAST-ACCESS- ACCOUNT	S	<alphanum-name 1..8>	1
Date of the last access	var(*LIST).LAST-ACCESS-DATE	S	yyyy-mm-dd	1,2
Name of the system with last access	var(*LIST). LAST-ACCESS-HOSTNAM	S	<alphanum-name 1..8>	1,2
Job name of the last access	var(*LIST). LAST-ACCESS-JOB-NAM	S	<name 1..8>	1
Time of the last access	var(*LIST).LAST-ACCESS-TIME	S	hh:mm:ss	1
TSN of the last access Only as long as the tape is occupied.	var(*LIST).LAST-ACCESS-TSN	S	<alphanum-name 1..4>	1
User ID of the last access	var(*LIST).LAST-ACCESS-USER-ID	S	<name 1..8>	1,2
Session number during the last access.	var(*LIST).LAST-ACC-SESSION-NR	S	<integer 1..255>	1
CLOSE date	var(*LIST).LAST-CLOSE-DATE	S	yyyy-mm-dd	1
CLOSE time	var(*LIST).LAST-CLOSE-TIME	S	hh:mm:ss	1
Block counter for the tape	var(*LIST).LAST-WRT-BLOCK-CNT	S	<integer 0..9999999999>	1
OPEN type of last access	var(*LIST).OPEN-MODE	S	INPUT OUTPUT EXTEND INOUT OUTIN SINOUT REVERSE	1
Password for access	var(*LIST).PASS	S	NONE YES	1,2
Remark field	var(*LIST).REMARK	S	<c-string 1..24>	1,2
Remark field which can be freely set	var(*LIST).REMARK-2	S	<c-string 1..10>	1
Remark field which can be freely set	var(*LIST).REMARK-3	S	<c-string 1..12>	1
Reservation counter (4-digit) This counter is incremented with each new reservation of the tape.	var(*LIST).RESERV-COUNT	S	<integer 0..9999>	2
Reservation date Date on which a tape is reserved.	var(*LIST).RESERV-DATE	S	yyyy-mm-dd	1,2
SAVE-FILE-ID (HSMS) or SAVE-VERSION (ARCHIVE)	var(*LIST).SFID	S	<c-string 1..15>	1,2
Number of subtask for parallel save run in HSMS	var(*LIST).SUBSAVE	S	<integer 0..15>	1,2
Number of subsequent tape within a parallel save run in HSMS	var(*LIST).SUBSEQ	S	<integer 0..999>	1,2
Current location	var(*LIST).TEMP-LOCATION	S	’’ <name 1..8>	1
Shareability of the tape	var(*LIST).USER-ACCESS	S	OWNER-ONLY FOREIGN-READ ALL-USERS	1,2
Account number of the tape owner	var(*LIST).USER-ACCOUNT	S	<alphanum-name 1..8>	1,2
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>	1,2
User ID of the tape owner	var(*LIST).USER-ID	S	<name 1..8>	1,2
Tape archive number	var(*LIST).VOL	S	<vsn>	1,2
Volume group Only has a valid value with reserved tapes, otherwise it is undefined.	var(*LIST).VOL-GROUP	S	<text 1..32>	1,2
Volume sequence number (4-digit)	var(*LIST).VOL-SEQ	S	<integer 1..255>	1,2
Tape status	var(*LIST).VOL-STA	S	FREE PRIVATE RESERVED DEFECT	1
Tape status F = FREE P = PRIVATE R = RESERVED D = DEFECT	var(*LIST).VOL-STA-1	S	F/P/R/D	2

Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly

SHOW-VOLUME-ATTRIBUTES Output information from the MAREN catalog

Format

Operands

Notes

Examples

Output in S variables