Privilege ADA, DA, administrator without domains
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.
Since MAREN V12.6 version, it will be implementation a new operand VOLUME-STATE which selects tapes from MAREN catalog on the basis of their status.
Lists with information from the MAREN catalog are created by the PRINT-VOLUME-ATTRIBUTES statement, see "PRINT-VOLUME-ATTRIBUTES Create lists with information from the MAREN catalog".
DAs can only execute the statement in their own domain. The DOMAIN operand is thus meaningless for them.
Format
| SHOW-VOLUME-ATTRIBUTES Alias: SH / SHVA | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1The 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 VSNs is to be processed.
USER-IDENTIFICATION = *ALL / <filename 1..8 with-wild>
All catalog entries assigned to this user ID are displayed. The wildcard “*” 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.
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 to be output. This tape is not owned by the local data center. It is imported to the MAREN catalog by a user via the administrator with the purpose of being processed in the local data center for a limited period of time.
VOLUME-STATE = *RESERVED
Only reserved tapes are to be output. If these are assigned to a foreign user ID, only the tape which are shareable are displayed.
VOLUME-STATE = *EXPORTED
Only exported tapes are to be output.
USER-IDENTIFICATION = *ALL
No selection is made regarding the user ID.
DOMAIN =
Defines the domain on whose tapes information is to be output.
DOMAIN = *ANY
Selects all domains.
DOMAIN = *OWN
The user’s own domain is selected. The user’s own domain is the domain of the system on which the ADA is currently working or the domain in which he/she has taken over the DA role.
DOMAIN = *STD-DOMAIN
The standard domain is selected.
DOMAIN = <alphanum-name 1..8>
The specified domain is selected. 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.
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>(...)
An asterisk (*) 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 archive number 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 can be used to select a specific version (or status) of the specified file for which the associated tapes are to be output. It is not evaluated if a single archive number is specified in VOLUME or the wildcard “*” is specified in the USER-ID operand.
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>
User ID in USER-IDENTIFICATION with wildcard “*”.
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>
User ID in USER-IDENTIFICATION with wildcard “*”.
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 tape sequence numbers occur more than once for a tape set, all 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> (...)
Only tapes from this directory are selected. The selection may already have been limited using the VOLUME operand. The tapes are output in ascending order of their SUB-SAVE-NUMBER and SUB-SEQUENCE-NUMBER (not their archive numbers).
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 this directory are to be displayed.
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.
FREE-POOL =
Selects the catalog entries to be made available on the basis of the free tape pool.
FREE-POOL = *ALL
No selection is made regarding a specific 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.
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. “*” can be entered as the last character. In this case all catalog entries in all free tape pools will be listed, which begin with the specified character string. The sort criteria will apply only within the individual free tape pools.
HOME-LOCATION =
Location name or symbolic location name. All catalog entries with the specified permanent location are processed.
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 = *ALL-TAPES
The catalog entries of all tapes are listed.
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].
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, such as
MARENADM STATEMENT SHOW-VOLUME-ATTRIBUTES, FILENAME: <filename>
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.
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 the catalog entries for all volume groups which begin with the specified string are listed.
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.
If a number range is specified with the operand FILE-NAME=*ALL (default value), only the catalog entry with the first FSEQ is displayed. If a value other than *ALL is specified for FILE-NAME, all relevant FSEQs are output. Specifying FILE-NAME=* and USER-ID=*ALL in turn causes merely the output of the first FSEQ of a tape.
If an individual archive number is specified and this is not found in the MAREN catalog, or a number range is specified an no catalog entry is found within this range, the spin off is triggered.
The contents of the catalog entry field PASSWORD appear in plain text only under the user ID TSOS. Otherwise, only YES or NONE is displayed.
Users should bear in mind that the use of wildcards may result in long wait times, especially if only a few catalog entries fulfill the specified selection criteria.
If an individual archive number is specified, all catalog entry fields are displayed. 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 causes the output to appear line by line in interactive mode. This improves the readability of catalog entries in SYSOUT logs.
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 is also specified, another display layout may be preferred internally in MAREN.
Examples
Example 1: Output of a single MAREN catalog entry
|
Output with the most important information.
|
Output with all information.
Example 2: Output of a tape number range
|
Meaning of the output fields:
| VOLUME | VSN | |
| FSEQ | File sequence number Temporarily locked tapes are output with FSEQ='*001'. | |
| DEV-TYPE | Device type | |
| USER-ID | User ID | |
| ACCOUNT | Account number | |
| RES-DATE | Reservation date | |
| FREE-DATE | Expiration date | |
| HOME-LOC | Permanent location | |
| ACC# | Access counter Values from 10,000 through 999,999 are represented as 10K through 999K, greater values as 1M through 99M | |
| E | Flag for exported tapes (E = EXPORTED) | |
F | Tape status, the following values may be displayed: | |
R, F, P | Reserved, free, foreign | |
Example 3: Output of all tapes whose file name begins with a specific character string
-----------------------------------------------------------------------------VOLUME FSEQ CR-DATE CR-TIME CR-JOB 1STVSN VSEQ USER-ID FILE-NAME(SHORT.)-----------------------------------------------------------------------------GRA001 0001 <date> <time> MAREN001 GRA001 0001 MAREN001 SAMPLE.TAPESET.1GRA002 0001 <date> <time> MAREN001 GRA002 0001 MAREN001 SAMPLE.TAPESET.1 GRA003 0001 <date> <time> MAREN001 GRA003 0001 MAREN001 SAMPLE.TAPESET.1GRA004 0001 <date> <time> MAREN001 GRA003 0002 MAREN001 SAMPLE.TAPESET.1GRA005 0001 <date> <time> MAREN001 GRA003 0003 MAREN001 SAMPLE.TAPESET.1 GRA006 0001 <date> <time> MAREN001 GRA006 0001 MAREN001 SAMPLE.TAPESET.1GRA007 0001 <date> <time> MAREN001 GRA006 0002 MAREN001 SAMPLE.TAPESET.1GRA008 0001 <date> <time> MAREN001 GRA006 0003 MAREN001 SAMPLE.TAPESET.1 GRA009 0001 <date> <time> MAREN001 GRA009 0001 MAREN001 SAMPLE.TAPESET.1GRA010 0001 <date> <time> MAREN001 GRA003 0001 MAREN001 SAMPLE.TAPESET.1GRA001 0002 <date> <time> MAREN001 GRA001 0001 MAREN001 SAMPLE.TAPESET.2 GRA002 0002 <date> <time> MAREN001 GRA002 0001 MAREN001 SAMPLE.TAPESET.2GRA001 0003 <date> <time> MAREN001 GRA001 0001 MAREN001 SAMPLE.TAPESET.3GRA002 0003 <date> <time> MAREN001 GRA002 0001 MAREN001 SAMPLE.TAPESET.3% MARM120 TOTAL OF 14 MAREN CATALOG ENTRIES PROCESSED |
Meaning of the output fields:
| VOLUME | VSN |
| FSEQ | File sequence number, Temporarily locked tapes are output with FSEQ='*001' |
| CR-DATE | Creation date |
| CR-TIME | Creation time |
| CR-JOB | Creation job name |
| 1STVSN | First archive number of the MF/MV set |
| VSEQ | File section number |
| USER-ID | User ID |
| FILE-NAME | File name (abbreviated if necessary) |
Example 4: Output of all MAREN catalog entries to a tape file
All tapes in the MAREN catalog to which the file SAMPLE.TAPESET.1 has been written or at least whose MAREN catalog entry contains this file name are to be output:
//show-volume-attributes volume=*all,user-id=*all,file-name=sample.tapeset.1(version=*all,type-of-vol=*any)
|
Five versions of the SAMPLE.TAPESET.1 tape file exist on the following tapes:
Version 0 (*LATEST) on GRA009.
Version -1 on GRA006, GRA007 and GRA008 (multivolume file).
Version -2 on GRA003, GRA010, GRA004 and GRA005 (multivolume file); GRA003 is obsolete since it was replaced by the tape GRA010 created subsequently (see tape sequence: VSEQ=1 for both tapes).
Version -3 on GRA002.
Version -4 on GRA001.
Example 5: Output of all MAREN catalog entries for a file version
From the tapes listed in example 4, only those used to create file version -1 are to be selected:
//show-volume-attributes volume=*all,user-id=*all,file-name=sample.tape.set.1(version=-1,type-of-vol=*any)
|
Example 6: Output of all MAREN catalog entries for obsolete tapes
From the tapes listed in example 4, only those which have been replaced by new tapes are to be selected. Afterwards these tapes will be released:
//show-volume-attributes volume=*all,user-id=*all,file-name=sample.tape.set.1(version=-1,type-of-vol=*obs)
|
Example 7: 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)
|
The information concerning all of the tapes contained in the last, i.e. in the most recent save file is output.
Example 8: Output of all tapes which belong to a volume group.
//show-volume-attributes vol=*int(sh,sh9),vol-group=EPSWOS3*
|
The name of the volume group is output because the volume group was selected by specifying a wildcard. The tape ANCA01 belongs to the volume group EPSWOS3-GER and the tape CLM020 to the volume group EPSWOS3-CLM.
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].
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 |
| Comment field for internal information | var(*LIST).ADM-FIELD | S | <c-string 1..8> | 1 |
| Comment field for internal information | var(*LIST).ADM-FIELD-2 | S | <c-string 1..16> | 1 |
| Audit flag | var(*LIST).AUDIT | S | *YES *NO | 1 |
| Check digit | var(*LIST).CHECK-COUNT | S | <integer 00..99> | 1 |
| Close flag 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 | var(*LIST).CRE-CAT-ID | S | <cat-id> | 1 |
| Creation date | var(*LIST).CRE-DATE | S | yyyy-mm-dd | 1,2 |
| Creation job 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 name | var(*LIST).DEV-NAME | S | <c-string 1..4> | 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 |
| Administration area | var(*LIST).DOMAIN | S | <c-string 1..8> | 1 |
| File expiration date | var(*LIST).EXPIR-DATE | S | yyyy-mm-dd | 1 |
| Mailing address The EXPORT-VOLUME statement can be used here to enter an export address, a short message, a mailbox no., etc. | 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 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 |
| Number of the last MAREN function which accessed the tape | var(*LIST).LAST-ACC-FUNC-FLAG | S | <integer 1..99> | 1 |
| Name of the last MAREN function which accessed the tape | var(*LIST).LAST-ACC-FUNC-NAME | S | <alphanum-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 001..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 |
| Registration date of the tape | var(*LIST).REG-DATE | S | yyyy-mm-dd | 1 |
| Remark field | var(*LIST).REMARK | S | <c-string 1..24> | 1,2 |
| User field which can be freely set | var(*LIST).REMARK-2 | S | <c-string 1..10> | 1 |
| User field which can be freely set | var(*LIST).REMARK-3 | S | <c-string 1..12> | 1 |
| Reservation counter (4-digit) Incremented with each new reservation of the tape | var(*LIST).RESERV-COUNT | S | <integer 0..9999> | 1,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 owner | var(*LIST).USER-ID | S | <name 1..8> | 1,2 |
| Tape VSN | 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 |