Output file attributes from catalog
Component: | BS2000 |
Functional area: | File processing |
Domain: | FILE |
Privileges: | STD-PROCESSING |
Routing code: | @ (bei NBCONOPI=N) bzw. E (bei NBCONOPI=Y) |
Function
The SHOW-FILE-ATTRIBUTES command enables users to request information on the catalog entries which they are permitted to access, for files, file generations, and file generation groups. This information can be a simple listing of the names of files, etc., which satisfy the criteria specified in the SHOW-FILE-ATTRIBUTES command; or on the other hand, detailed information from the catalog entry can be requested. Users can request information on all files under their own user IDs and on files under user IDs for which they are co-owners (see "Privileged functions" in the CREATE-FILE command), as well all other users’ files that they are permitted to access (see USER-ACCESS, BASIC-ACL, GUARDS, and PROTECTION-ACTIVE). The request can cover all the information stored in the catalog (INFORMATION=*ALL-ATTRIBUTES) or the following information units:
Names and storage space allocations for the selected files (INFORMATION=*NAME-AND-SPACE; default)
The total number of PAM pages allocated to the selected files, split into storage space on public volumes, on Net-Storage and on private volumes (INFORMATION=*SPACE-SUMMARY)
The following blocks of information, individually or in any combination (INFORMATION=*PARAMETERS):
history block with historic data of the file: time of creation, time of last access, time the file was last changed, number of storage space extensions (secondary allocations).
security block with the protection attributes of the file
backup block with all the file attributes for backing up data
organization block with all the file attributes related to the file structure
allocation block with all the relevant information on storage space allocation
Brief information on the access method with which the file was created, the password protection, and the highest activated access control (INFORMATION=*MINIMUM)
Storage space allocation for all selected files and file generations, with totals for each type of volume (INFORMATION=*STATISTICS).
The FILE-NAME and SELECT operands are used to select the files for which the required information is to be output:
FILE-NAME: the selection criteria are the catalog ID, user ID, and file name (fully or partially qualified, wildcards are permitted in catalog number and file name). Default value: all permanent files under the user’s own user ID from the default catalog on the local computer (FILE-NAME=*ALL).
SELECT: restricts the selection of files within those with the specified FILE-NAME. File attributes are used as selection criteria. Only the files which have the specified file attributes will be selected from the file set defined by FILE-NAME. Default value: the complete file set defined by FILE-NAME (SELECT=*ALL).
Temporary files must be addressed using the tempfile prefix (# or @).
If wildcards are used in the catalog number, only files on locally imported pubsets are displayed.
The command supports structured output in S variables (see "Output in S variable").
Privileged functions
By default, systems support (TSOS privilege) can obtain information on the temporary or permanent files belonging to any user ID. However, if SECOS is used it is possible to restrict TSOS co-ownership of a user ID for permanent files.
Wildcards are supported within the user ID. Please note the following:
Files in nonlocal pubsets are not displayed, even if they can be accessed through an MSCF or RFA connection.
If no catalog ID is specified, information is supplied about files in the associated default pubsets of the selected user IDs.
In interactive mode, INFORMATION=*PAR(PASSWORDS=*YES) causes passwords to be displayed explicitly.
Overview of functions
Function / Meaning | Level 1 operands | Level 2/3 operands |
|---|---|---|
File name of the file whose catalog entries are to be output. |
| |
Scope of information to be output | ||
File name and reserved storage space | ||
Total occupied, reserved and free storage space for all selected files | ||
Total catalog entry | ||
Selection of individual data blocks of the catalog entry | ||
| ||
| ||
| ||
| ||
| ||
| ||
Statistical information on all selected files | ||
Brief information on access control and file structure | ||
Selection criteria for files whose catalog entries are to be output | ||
Date specification | ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
|
| |
|
| |
|
| |
| ||
| ||
| ||
| ||
| ||
| ||
Storage space | ||
| ||
| ||
| ||
| ||
| ||
| ||
File security/file protection | ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
| ||
|
| |
|
| |
| ||
| ||
| ||
| ||
| ||
| ||
Performance attributes
| ||
| ||
| ||
|
| |
|
| |
|
| |
|
| |
| ||
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
| ||
| ||
HSMS-related file attributes | ||
| ||
| ||
| ||
| ||
| ||
Control information output | ||
Suppress output | ||
Output to SYSOUT | ||
Output to SYSLST | ||
| FORM-NAME= | |
|
| |
|
| |
Output to printer | ||
| FORM-NAME= | |
|
| |
|
| |
Output to a file | ||
| FORM-NAME= | |
Output option | ||
| SORT-LIST= | |
|
| |
|
|
Format
SHOW-FILE-ATTRIBUTES | Alias: SH / SHFA | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
FILE-NAME = *ALL / <filename 1..54 with-wild(80)>
The name of the file(s) for which information is to be output. If the SHOW-FILE-ATTRIBUTES command is issued without selection operands or with the default values (FILE-NAME=*ALL, SELECT=*ALL), the output will show the storage space reservation and path name for all (permanent) files under the user’s own user ID, in alphabetical order. If a user ID for which the user is listed as co-owner is specified (see “Privileged functions” in the CREATE-FILE command), information can be requested for all permanent files. If a “foreign” user ID is specified, the only files for which information can be requested are those which the catalog entry shows the user is authorized to access (see USER-ACCESS, BASIC-ACL, GUARDS, and PROTECTION-ACTIVE).
If the FILE-NAME operand identifies a file generation group, only information about the group entry will be output and none about the individual generations. The latter information will only be output if the operand GENERATIONS=*YES is also specified (under SELECT=*BY-ATTRIBUTES). This also applies to FILE-NAME=*ALL.
With the special prefix characters (# or @) for temporary files, the user can request information on all the temporary files for the current job. The special prefix character is replaced in the SYSOUT or SYSLST log by the name component used internally by the system.
For files addressed by an alias or the defined ACS prefix, the actual name from the file catalog appears in the output (see the ACS functions described in the LOAD-ALIAS-CATALOG and SET-FILE-NAME-PREFIX commands).
FILE-NAME = *ALL
The storage space reservation and file name will be output, in alphabetical order, for all the files recorded in the default catalog on the local computer under the user’s own user ID.
FILE-NAME = <filename 1..54 with-wild(80)>
FILE-NAME specifies the files or file generation groups for which information is required. The user can obtain information on either permanent files or temporary files (by specifying the tempfile prefix), but not both.
INFORMATION = *NAME-AND-SPACE / *SPACE-SUMMARY / *ALL-ATTRIBUTES / *PARAMETERS(...) / *STATISTICS / *MINIMUM
The type of information to be shown on output to SYSOUT (see OUTPUT operand).
INFORMATION = *NAME-AND-SPACE
For the selected files, the number of PAM pages used will be output with the file name, in alphabetical order of file name.
INFORMATION = *SPACE-SUMMARY
Provides information on the storage space usage of the files and file generations identified in the current SHOW-FILE-ATTRIBUTES command, because GEN=*YES applies implicitly. The output shows separate details for public and private volumes.
INFORMATION = *ALL-ATTRIBUTES
For the selected files, outputs all the information held in the catalog (*NAME-AND-SPACE, *PARAMETERS). In the table“File attribute output fields for the SHOW-FILE-ATTRIBUTES command” the output fields are shown in alphabetical order, with further explanation of their possible values.
INFORMATION = *PARAMETERS(...)
Returns only the selected information for the files in question. The information from the catalog is logically arranged into information blocks. Only those information blocks which are explicitly selected by the user are output. Total lines with the overall storage space allocation for each selected file are shown at the end of the returned information (see INFORMATION=*SPACE-SUMMARY).
STANDARD = *NO / *YES
Specifies whether standard information is to be output.
INFORMATION=*PARAMETERS(ORGANIZATION=*YES,ALLOCATION=*YES).PROTECTION = *NO / *YES
Specifies whether information concerning the file protection and expiration date is to be output.
BACKUP=*YES).FILE = *NO / *YES
Output: storage space used in PAM pages, and file attributes.
INFORMATION=*PARAMETERS(ORGANIZATION=*YES,ALLOCATION=*YES).PASSWORDS = *NO / *YES
Specifies whether the information on passwords is to be output. A header line with the title “PASSWORDS” and a line with the information on file passwords (which corresponds to the first information line of the security block) are output.
PASSWORDS = *NO
No PASSWORD information is to be output.
PASSWORDS = *YES
The first line of the security block is output.
This line provides information on the types of password which protect a file or file generation group. The passwords themselves are not shown to the nonprivileged user. If a user forgets a file password, only the system administrator can help him (see "Privileged functions"). The following attributes are output:
Header line with the word “PASSWORDS” | |
EXEC-PASS | protection with execution password |
READ-PASS | protection with read password |
WRITE-PASS | protection with write password |
ALLOCATION = *NO / *YES
Outputs the allocation block for the selected files, i.e. all file attributes that affect the allocation of storage space. The allocation block contains the following attributes:
Header line with the word “ALLOCATION” | |
DEVICE-TYPE | device type for volume |
EXTENTS | total number of extents for the file |
HIGH-US-PA | highest used PAM page |
NUM-OF-EXT | Number of extents |
S-ALLOC | secondary allocation for file extension |
SUPPORT | type of volume |
VOLUME | volume serial number |
BACKUP = *NO / *YES
Outputs the backup block for the selected files, i.e. all file attributes that affect backups. The backup block contains the following attributes:
Header line with the word “BACKUP” | |
BACK-CLASS | backup level for ARCHIVE or HSMS |
#BACK-VERS | Maximal number of file versions in the version backup archive |
MAN-CLASS | HSMS storage management class |
MIGRATE | indicates whether the file may be migrated |
SAVED-PAG | indicates whether the file must always be fully saved |
STOR-LEVEL | indicates the storage level for migrated files |
VERSION | internal attribute for incremental saving with the ARCHIVE or HSMS utility routine |
HISTORY = *NO / *YES
Outputs the history block for the selected files, i.e. all file attributes related to the file history. The history block contains the following attributes:
Header line with the word “HISTORY” | |
ACC-COUNT | access counter |
ACC-DATE | date of last access |
ACC-TIME | time of last access |
CHANG-DATE | date the file was last changed (written to) |
CHANG-TIME | time the file was last changed (written to) |
CRE-DATE | creation date |
CRE-TIME | time of creation |
S-ALLO-NUM | number of secondary allocations |
ORGANIZATION = *NO / *YES
Outputs the organization block for the selected files, i.e. all file attributes related to the structure of the file. The organization block contains the following attributes:
ADM-INFO | systems support information |
AVAIL | availability |
BLK-CONTR | Block control information |
BLK-COUNT | block counter (tape files) |
BLK-OFFSET | block offset (tape files) |
BUF-LEN | block type (standard or nonstandard block) |
COD-CH-SET | coded character set (CCS) with XHCS support |
NET-COD-CH-SET | Only for node files: character set with which the file is created on Net-Storage |
CODE | code specification for tape files |
DISK-WRITE | suitability of file for processing in a volatile cache |
F-PREFORM | preferred file format |
FILE-SEQ | file sequence number (tape file) |
FILE-STRUC | access method when the file was created |
IO(PERF) | performance requirement for file processing |
IO(USAGE) | type of I/O operations for performance requirement |
KEY-LEN | Length of ISAM key |
KEY-POS | position of ISAM key |
LABEL | standard version of labels (tape file) |
LOG-FL-LEN | length of logical ISAM flag |
PROPA-VAL | propagation of ISAM flag |
REC-FORM | Record format |
REC-SIZE | Record length |
STOR-CLASS | Storage class |
S0-MIGR | specifies whether the file may be migrated on processing level |
USER-INFO | user information |
VAL-FL-LEN | length of ISAM value flag |
WORK-FILE | work file attribute |
The information block for file generation groups begins with the header line “GENERATION-INFO” and contains the following attributes:
BASE-NUM | base value for relative generation numbers |
DEVICE-TYPE | device type for volume |
EXTENTS | total number of extents for the file |
FIRST-GEN | oldest existing file generation |
LAST-GEN | most recent or last cataloged file generation |
MAXIMUM | maximum number of simultaneously cataloged generations |
OVERFL-OPT | overflow option when maximum number is reached |
VOLUME | volume serial number |
SECURITY = *NO / *YES
Outputs the security block for the selected files, i.e. all file attributes related to the file security. The security block contains the following attributes:
Header line with the word “SECURITY” | |
ACCESS | type of access (standard access control) |
ACL | file protection with ACL (only supported for reasons of compatibility) |
AUDIT | file monitoring |
DESTROY | data automatically destroyed on deletion |
ENCRYPTION | encryption method |
EXEC-PASS | protection with execution password |
EXPIR-DATE | date on which the file may be changed again |
EXPIR-TIME | time relative to EXPIR-DATE |
FREE-DEL-D | free-for-deletion date |
FREE-DEL-T | time relative to free-for-deletion date |
GUARD-READ | read protection using a guard |
GUARD-WRIT | write protection using a guard |
GUARD-EXEC | protection with execute guard |
GROUP | access rights of user class “group” (BASIC-ACL) |
OTHERS | access rights of user class “others” (BASIC-ACL) |
OWNER | access rights of file owner (BASIC-ACL) |
READ-PASS | protection with read password |
SP-REL-LOCK | protection against release of storage space |
USER-ACC | shareability attribute (standard access control) |
WRITE-PASS | protection with write password |
INFORMATION = *STATISTICS
Returns information on storage space allocation for all selected files. The storage space allocations for files and file generation groups are output separately and include additional information for each type of volume (public disks, private disks, and tapes). Files for which no entry has been made in the volume list are indicated in a separate line with “NO VSN”.
INFORMATION = *MINIMUM
Outputs a line of information with the most important file attributes in summarized form for each selected file. This line contains brief information on the FILE-STRUCTURE, passwords, highest activated access protection level, the number of reserved PAM pages, and the file name (there may be a line break if the file name is of maximum length). The brief information is indicated as follows:
the access method with which the file was created: indicated by the first letter in the value of FILE-STRUCTURE;
information for read, write, and execute passwords: shown in each case with “Y” or “N” to indicate whether the corresponding password was assigned;
information on the highest activated access control method: see the PROTECTION-ACTIVE operand. When standard access control is the highest protection:
USER-ACCESS with “Y” for ALL-USERS or SPECIAL; “N” for OWNER-ONLY
ACCESS with “W” for write access or “R” for read access only.
When basic access control list (BASIC-ACL) is the highest protection:the access rights assigned for each of the user groups OWNER, GROUP and OTHERS are shown (“RWX” or “-” for an access right that has not been set).
When access control via GUARDS is the highest protection: the value “GUARDS” and the protected access mode (“RWX” or “-” for an access mode not granted) are shown.
SELECT = *ALL / *BY-ATTRIBUTES(...)
The file selection criteria.
SELECT = *ALL
Returns information on all the files which the user is authorized to access.
SELECT = *BY-ATTRIBUTES(...)
Restricts the files selected from the set specified by FILE-NAME to those which satisfy the following specifications. The default values *ANY or ANY for an attribute mean that the file set is not to be restricted to particular values of that attribute.
CREATION-DATE = *ANY / *TODAY(...) / *YESTERDAY(...) / <integer -99999..991231>(...) / <date>(...) / *INTERVAL(...) / *NONE
Returns information on files and FGGs on the basis of their creation date (CREATION-DATE); range specifications are inclusive of the limit values. It is meaningless to specify a CREATION-DATE which lies in the future!
CREATION-DATE = *ANY
The creation date is not to be used as a selection criterion.
CREATION-DATE = *TODAY(...)
Returns information for files which have today’s date entered as the CREATION-DATE in their catalog entry.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified creation date.
TIME = *INTERVAL(...)
Returns information on files that were created on the specified day within the specified time interval which follows.
FROM = 00:00:00 / <time>
Selects files for which the time of creation >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the time of creation <= the specified time.
CREATION-DATE = *YESTERDAY(...)
Returns information for files which have yesterday’s date entered as the CREATION-DATE in their catalog entry.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified creation date.
TIME = *INTERVAL(...)
Returns information on files that were created on the specified day within the specified time interval which follows.
FROM = 00:00:00 / <time>
Selects files for which the time of creation >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the time of creation <= the specified time.
CREATION-DATE = <integer -99999..991231>(...)
Returns information on files which were created on the specified date. Here, the user can specify the creation date in either of two ways:
- as an absolute date value: (6 digits), a specific date in the form yymmdd (yy = year, mm = month, dd = day)
- as a relative date value: (6 digits, with preceding sign) the number of days from today’s date, in the form -n for dates in the past, and +n for dates in the future; (YESTERDAY corresponds to -1, TODAY corresponds to ±0)
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified creation date.
TIME = *INTERVAL(...)
Returns information on files that were created on the specified day within the specified time interval which follows.
FROM = 00:00:00 / <time>
Selects files for which the time of creation >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the time of creation <= the specified time.
CREATION-DATE = <date>(...)
Returns information on files which were created on the specified date.
The user can specify the creation date in the form [yy]yy-mm-dd.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified creation date.
TIME = *INTERVAL(...)
Returns information on files that were created on the specified day within the specified time interval which follows.
FROM = 00:00:00 / <time>
Selects files for which the time of creation >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the time of creation <= the specified time.
CREATION-DATE = *INTERVAL(...)
Returns information on files which were created within the specified time period. The upper and lower limits are both included in the range specified. See also the explanation of how dates are specified in the EXPIRATION-DATE=<integer ...> operand. It is also possible to specify limits using only the operand FROM (lower limit) or TO (upper limit). Whichever of the operands is not specified will be replaced by the default value for use as the limit of the range. The use of range limits for information output can only be meaningful if the chosen lower limit <= the upper limit.
FROM = 1950-01-01 / <integer -99999..991231>(...) / <date>(...) / *TODAY(...) / *YESTERDAY(...)
Returns information on files which were created after the specified date (i.e. CREATION-DATE >= specified date).
FROM = <integer -99999..991231>(...)
Returns information on files which were created after the specified date (i.e. CREATION-DATE >= specified date).
TIME = 00:00:00 / <time>
Time on the specified date. All files created at or after the specified time are selected.
FROM = <date>(...)
Returns information on files which were created after the specified date (i.e. CREATION-DATE >= specified date).
TIME = 00:00:00 / <time>
Time on the specified date. All files created at or after the specified time are selected.
FROM = *TODAY(...)
Returns information on files which were created after the specified date (i.e. CREATION-DATE >= current date).
TIME = 00:00:00 / <time>
Time on the specified date. All files created at or after the specified time are selected.
FROM = *YESTERDAY(...)
Returns information on files which were created after the specified date (i.e. CREATION-DATE >= date of preceding day).
TIME = 00:00:00 / <time>
Time on the specified date. All files created at or after the specified time are selected.
TO = *TODAY(...) / *YESTERDAY(...) / <integer -99999..991231>(...) / <date>(...)
Returns information on files which were created before the specified date (i.e. CREATION-DATE <= specified date).
TO = *TODAY(...)
Returns information on files which were created before the specified date (i.e. CREATION-DATE <= current date).
TIME = 23:59:59 / <time>
Time on the specified date. All files created at or before the specified time are selected.
TO = *YESTERDAY(...)
Returns information on files which were created before the specified date (i.e. CREATION-DATE <= date of preceding day).
TIME = 23:59:59 / <time>
Time on the specified date. All files created at or before the specified time are selected.
TO = <integer -99999..991231>(...)
Returns information on files which were created before the specified date (i.e. CREATION-DATE <= specified date).
TIME = 23:59:59 / <time>
Time on the specified date. All files created at or before the specified time are selected.
TO = <date>(...)
Returns information on files which were created before the specified date (i.e. CREATION-DATE <= specified date).
TIME = 23:59:59 / <time>
Time on the specified date. All files created at or before the specified time are selected.
CREATION-DATE = *NONE
Returns information on files for which no creation data is entered in the catalog entry.
EXPIRATION-DATE = *ANY / *TOMORROW(...) / *TODAY(...) / *YESTERDAY(...) /
<integer -99999..991231>(...) / <date>(...) / *INTERVAL(...) / *NONE
The EXPIRATION-DATE operand requests information on the file/FGG as a function of the “expiration date”, i.e. the date from which write accesses to the file are allowed. It is meaningful to specify a date in the future if retention periods are being queried.
EXPIRATION-DATE = *ANY
The expiration date (output field EXPIR-DATE) is not to be used as a selection criterion.
EXPIRATION-DATE = *TOMORROW(...)
Returns information on files which have tomorrow’s date entered as the EXPIRATION-DATE in their catalog entry.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified expiration date. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
TIME = *INTERVAL(...)
Returns information on files for which the expiration date lies within the specified interval that follows.
FROM = 00:00:00 / <time>
Selects files for which the time of expiration >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the time of expiration <= the specified time.
EXPIRATION-DATE = *TODAY(...)
Returns information on files which have today’s date entered as the EXPIRATION-DATE in their catalog entry.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified expiration date. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
TIME = *INTERVAL(...)
Returns information on files for which the expiration date lies within the specified interval that follows.
FROM = 00:00:00 / <time>
Selects files for which the time of expiration >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the time of expiration <= the specified time.
EXPIRATION-DATE = *YESTERDAY(...)
Returns information on files which have yesterday’s date entered as the EXPIRATION-DATE in their catalog entry.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified expiration date. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
TIME = *INTERVAL(...)
Returns information on files for which the expiration date lies within the specified interval that follows.
FROM = 00:00:00 / <time>
Selects files for which the time of expiration >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the time of expiration <= the specified time.
EXPIRATION-DATE = <integer -99999..991231>(...)
Here, the user can specify the expiration date in either of two ways:
- as an absolute date value: (6 digits), a specific date in the form yymmdd (yy = year, mm = month, dd = day)
- as a relative date value: (6 digits, with preceding sign) the number of days from today’s date, in the form -n for dates in the past, and +n for dates in the future; (YESTERDAY corresponds to -1, TODAY corresponds to ±0, TOMORROW corresponds to +1)
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified expiration date. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
TIME = *INTERVAL(...)
Returns information on files for which the expiration date lies within the specified interval that follows.
FROM = 00:00:00 / <time>
Selects files for which the time of expiration >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the time of expiration <= the specified time.
EXPIRATION-DATE = <date>(...)
Returns information on files for which exactly the specified date is entered as the EXPIRATION-DATE in the catalog entry. The user can specify the expiration date in the form [yy]yy-mm-dd.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified expiration date. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
TIME = *INTERVAL(...)
Returns information on files for which the expiration date lies within the specified interval that follows.
FROM = 00:00:00 / <time>
Selects files for which the time of expiration >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the time of expiration <= the specified time.
EXPIRATION-DATE = *INTERVAL(...)
Returns information on only the files whose expiration dates lie within the period specified as the operand value, i.e. files whose retention period expires during the specified period. The upper and lower limits are both included in the range specified. See also the explanation of how dates are specified in the EXPIRATION-DATE=<integer ...> operand. It is also possible to specify limits using only the operand FROM (lower limit) or TO (upper limit). Whichever of the operands is not specified will be replaced by the default value for use as the limit of the range. The use of range limits for information output can only be meaningful if the chosen lower limit <= the upper limit.
FROM = 1950-01-01 / <integer -99999..991231>(...) / <date>(...) / *TOMORROW(...) / *TODAY(...) / *YESTERDAY(...)
Returns information on files for which the EXPIRATION-DATE >= the specified date.
FROM = <integer -99999..991231>(...)
Returns information on files for which the EXPIRATION-DATE >= the specified date.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have an EXPIRATION-DATE after the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
FROM = <date>(...)
Returns information on files for which the EXPIRATION-DATE >= the specified date.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have an EXPIRATION-DATE after the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
FROM = TOMORROW(...)
Returns information on files for which the EXPIRATION-DATE >= date of the next day.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have an EXPIRATION-DATE after the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
FROM = *TODAY(...)
Returns information on files for which the EXPIRATION-DATE >= date of the current day.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have an EXPIRATION-DATE after the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
FROM = *YESTERDAY(...)
Returns information on files for which the EXPIRATION-DATE >= date of the preceding day.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have an EXPIRATION-DATE after the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
TO = *ANY / *TODAY(...) / *TOMORROW(...) / *YESTERDAY(...) / <integer -99999..991231>(...) / <date>(...)
Returns information on files for which the EXPIRATION-DATE <= the specified date.
TO = *ANY
Specifies an open interval that starts with the EXPIRATION-DATE but has no upper limit.
TO = *TODAY(...)
Returns information on files for which the EXPIRATION-DATE <= date of the current day.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have an EXPIRATION-DATE before the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
TO = *TOMORROW
Returns information on files for which the EXPIRATION-DATE <= date of the next day.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have an EXPIRATION-DATE before the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
TO = *YESTERDAY(...)
Returns information on files for which the EXPIRATION-DATE <= date of the preceding day.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have an EXPIRATION-DATE before the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
TO = <integer -99999..991231>(...)
Returns information on files for which the EXPIRATION-DATE <= the specified date.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have an EXPIRATION-DATE before the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
TO = <date>(...)
Returns information on files for which the EXPIRATION-DATE <= the specified date.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have an EXPIRATION-DATE before the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!
EXPIRATION-DATE = *NONE
Returns information on files for which no expiration data has been entered in the catalog entry.
LAST-ACCESS-DATE = *ANY / *TODAY(...) / *YESTERDAY(...) / <integer -99999..991231>(...) / <date>(...) / *INTERVAL(...) / *NONE
Returns information on files/file generations/FGGs as a function of the date of last access to the file. If the output fields CRE-DATE and ACC-DATE show the same date, the last access to the file was a write-access; if CRE-DATE < ACC-DATE, the last access to the file was to read it.
LAST-ACCESS-DATE = *ANY
The date of last access (output field ACC-DATE) is not to be used as a selection criterion.
LAST-ACCESS-DATE = *TODAY(...)
Returns information on files for which today’s date is entered as the LAST-ACCESS-DATE in the catalog entry.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified LAST-ACCESS-DATE.
TIME = *INTERVAL(...)
Returns information on files that were last accessed within the specified time interval which follows.
FROM = 00:00:00 / <time>
Selects files for which the LAST-ACCESS-DATE >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the LAST-ACCESS-DATE <= the specified time.
LAST-ACCESS-DATE = *YESTERDAY(...)
Returns information on files for which yesterday’s date is entered as the LAST-ACCESS-DATE in the catalog entry.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified LAST-ACCESS-DATE.
TIME = *INTERVAL(...)
Returns information on files that were last accessed within the specified time interval which follows.
FROM = 00:00:00 / <time>
Selects files for which the LAST-ACCESS-DATE >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the LAST-ACCESS-DATE <= the specified time.
LAST-ACCESS-DATE = <integer -99999..991231>(...)
Here, the user can specify the last access date in either of two ways:
- as an absolute date value: (6 digits), a specific date in the form yymmdd (yy = year, mm = month, dd = day)
- as a relative date value: (6 digits, with preceding sign) the number of days from today’s date, in the form -n for dates in the past, and +n for dates in the future; (YESTERDAY corresponds to -1, TODAY corresponds to ±0)
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified LAST-ACCESS-DATE.
TIME = *INTERVAL(...)
Returns information on files that were last accessed within the specified time interval which follows.
FROM = 00:00:00 / <time>
Selects files for which the LAST-ACCESS-DATE >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the LAST-ACCESS-DATE <= the specified time.
LAST-ACCESS-DATE = <date>(...)
Returns information on files for which the specified date has been entered as the LAST-ACCESS-DATE in the catalog entry. The user can specify the date in the form [yy]yymm-dd.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified LAST-ACCESS-DATE.
TIME = *INTERVAL(...)
Returns information on files that were last accessed within the specified time interval which follows.
FROM = 00:00:00 / <time>
Selects files for which the LAST-ACCESS-DATE >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the LAST-ACCESS-DATE <= the specified time.
LAST-ACCESS-DATE = *INTERVAL(...)
Returns information on only those files which were last accessed within the specified time period. The range of dates covered by the specification includes the two end dates (see also the explanation of how dates are specified for the LAST-ACCESS-DATE= <integer...> operand). It is also possible to specify limits using only the operand FROM (lower limit) or TO (upper limit). For whichever operand is not specified, the default value will be used as the limit for the range. The use of range limits for information output can only be meaningful if the chosen lower limit <= the upper limit.
FROM = 1950-01-01 / <integer -99999..991231>(...) / <date>(...) / *TODAY(...) / *YESTERDAY(...)
Returns information on only those files which were accessed on or after the specified date (LAST-ACCESS-DATE >= specified date).
FROM = <integer -99999..991231>(...)
Returns information on files for which the LAST-ACCESS-DATE >= the specified date.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a LAST-ACCESS-DATE after the specified time are selected.
FROM = <date>(...)
Returns information on files for which the LAST-ACCESS-DATE >= the specified date.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a LAST-ACCESS-DATE after the specified time are selected.
FROM = *TODAY(...)
Returns information on files for which the LAST-ACCESS-DATE >= date of the current day.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a LAST-ACCESS-DATE after the specified time are selected.
FROM = *YESTERDAY(...)
Returns information on files for which the LAST-ACCESS-DATE >= date of the preceding day.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a LAST-ACCESS-DATE after the specified time are selected.
TO = *TODAY(...) / *YESTERDAY(...) / <integer -99999..991231>(...) / <date>(...)
Returns information on only those files which were accessed on or before the specified date (LAST-ACCESS-DATE <= specified date).
TO = *TODAY(...)
Returns information on files for which the LAST-ACCESS-DATE <= date of the current day.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a LAST-ACCESS-DATE before the specified time are selected.
TO = *YESTERDAY(...)
Returns information on files for which the LAST-ACCESS-DATE <= date of the preceding day.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a LAST-ACCESS-DATE before the specified time are selected.
TO = <integer -99999..991231>(...)
Returns information on files for which the LAST-ACCESS-DATE <= the specified date.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a LAST-ACCESS-DATE before the specified time are selected.
TO = <date>(...)
Returns information on files for which the LAST-ACCESS-DATE <= the specified date.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a LAST-ACCESS-DATE before the specified time are selected.
LAST-ACCESS-DATE = *NONE
Returns information on files for which no LAST-ACCESS-DATE has been entered in the catalog entry. File generation groups are not selected.
LAST-CHANGE-DATE = *ANY / *NONE / *TODAY(...) / *YESTERDAY(...) / <integer -99999..0>(...) /
<date>(...) / *INTERVAL(...)
Returns information on files, file generations, and FGGs based on the date on which the file was last changed (accessed for writing).
LAST-CHANGE-DATE = *ANY
The date of the last write access (output field CHANG-DATE) is not to be used as a selection criterion.
LAST-CHANGE-DATE = *NONE
Returns information on files for which no LAST-CHANGE-DATE has been entered in the catalog entry.
LAST-CHANGE-DATE = *TODAY(...)
Returns information on files for which today’s date has been entered as the LAST-CHANGE-DATE in the catalog entry.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified LAST-CHANGE-DATE.
TIME = *INTERVAL(...)
Returns information on files that were changed within the specified time interval which follows.
FROM = 00:00:00 / <time>
Selects files for which the LAST-CHANGE-DATE >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the LAST-CHANGE-DATE <= the specified time.
LAST-CHANGE-DATE = *YESTERDAY(...)
Returns information on files for which yesterday’s date has been entered as the LAST-CHANGE-DATE in the catalog entry.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified LAST-CHANGE-DATE.
TIME = *INTERVAL(...)
Returns information on files that were changed within the specified time interval which follows.
FROM = 00:00:00 / <time>
Selects files for which the LAST-CHANGE-DATE >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the LAST-CHANGE-DATE <= the specified time.
LAST-CHANGE-DATE = <integer -99999..0>(...)
Here, the user can specify the date of the last write access relative to the current date (in the form -n).
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified LAST-CHANGE-DATE.
TIME = *INTERVAL(...)
Returns information on files that were changed within the specified time interval which follows.
FROM = 00:00:00 / <time>
Selects files for which the LAST-CHANGE-DATE >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the LAST-CHANGE-DATE <= the specified time.
LAST-CHANGE-DATE = <date>(...)
Returns information on only those files which have exactly the specified date entered as the LAST-CHANGE-DATE in their catalog entry. The user can specify the date in the form [yy]yy-mm-dd.
TIME = *ANY / *INTERVAL(...)
Restricts the selection of files to a time interval related to the specified LAST-CHANGE-DATE.
TIME = *INTERVAL(...)
Returns information on files that were changed within the specified time interval which follows.
FROM = 00:00:00 / <time>
Selects files for which the LAST-CHANGE-DATE >= the specified time.
TO = 23:59:59 / <time>
Selects files for which the LAST-CHANGE-DATE <= the specified time.
LAST-CHANGE-DATE = *INTERVAL(...)
Returns information on only those files which were last changed within the specified time period. The range of dates covered by the specification includes the two end dates (see also the explanation of how dates are specified for the LAST-CHANGE-DATE= <integer...> operand). It is also possible to specify limits using only the operand FROM (lower limit) or TO (upper limit). For whichever operand is not specified, the default value will be used as the limit for the range. The use of range limits for information output can only be meaningful if the chosen lower limit <= the upper limit.
FROM = 1950-01-01 / <integer -99999..0>(...) / <date>(...) / *TODAY(...) / *YESTERDAY(...)
Returns information on only those files which have been changed since the specified date (LAST-CHANGE-DATE >= specified date).
FROM = <integer -99999..0>(...)
Returns information on files for which the LAST-CHANGE-DATE >= the specified date.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a LAST-CHANGE-DATE after the specified time are selected.
FROM = <date>(...)
Returns information on files for which the LAST-CHANGE-DATE >= the specified date.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a LAST-CHANGE-DATE after the specified time are selected.
FROM = TODAY(...)
Returns information on files for which the LAST-CHANGE-DATE >= the current date.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a LAST-CHANGE-DATE after the specified time are selected.
FROM = YESTERDAY(...)
Returns information on files for which the LAST-CHANGE-DATE >= date of the preceding day.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a LAST-CHANGE-DATE after the specified time are selected.
TO = TODAY(...) / *YESTERDAY(...) / <integer -99999..0>(...) / <date>(...)
Returns information on files that have been changed on or before the specified date (LAST-CHANGE-DATE <= specified date).
TO = *TODAY(...)
Returns information on files for which the LAST-CHANGE-DATE <= the current date.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a LAST-CHANGE-DATE before the specified time are selected.
TO = YESTERDAY(...)
Returns information on files for which the LAST-CHANGE-DATE <= date of the preceding day.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a LAST-CHANGE-DATE before the specified time are selected.
TO = <integer -99999..0>(...)
Returns information on files for which the LAST-CHANGE-DATE <= the specified date.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a LAST-CHANGE-DATE before the specified time are selected.
TO = <date>(...)
Returns information on files for which the LAST-CHANGE-DATE <= the specified date.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a LAST-CHANGE-DATE before the specified time are selected.
SUPPORT = *ANY / list-poss(3): *PUBLIC-DISK / *PRIVATE-DISK / *TAPE
Returns information on files/ file generations/FGGs as a function of the type of volume on which they are stored. If the volume types are specified in the form of a list, the system will combine them by a logical OR.
SUPPORT = *ANY
The volume type is not to be used as a selection criterion.
SUPPORT = *PUBLIC-DISK
Returns information on files stored on public volumes and on Net-Storage.
SUPPORT = *PRIVATE-DISK
Returns information on files etc. stored on private volumes.
SUPPORT = *TAPE
Returns information on files stored on tape.
STORAGE-TYPE = *ANY / *PUBLIC-SPACE / *NET-STORAGE(...)
Returns information on files assigned the specified storage type.
STORAGE-TYPE = *ANY
The storage type is not a selection criterion.
STORAGE-TYPE = *PUBLIC-SPACE
Returns information only on files stored on public volumes.
STORAGE-TYPE = *NET-STORAGE(...)
Returns information only on files stored on Net-Storage volumes.
FILE-TYPE = *ANY / *BS2000 / *NODE-FILE
Returns information on files on Net-Storage volumes, depending on the file type with which they are created.
FILE-TYPE = *ANY
The file type is not a selection criterion.
FILE-TYPE = *BS2000
Returns information only on BS2000 files on Net-Storage volumes.
FILE-TYPE = *NODE-FILE
Returns information only on node files on Net-Storage volumes.
VOLUME = *ANY / <vsn 1..6>
Returns information on all files/FGGs which have an entry in their volume list for the volume with the specified VSN <vsn 1..6>.
SIZE = *ANY / FREESIZE / <integer 0..2147483647> / *INTERVAL(...)
Requests information on files/file generations depending on the size of storage space reserved for them.
SIZE = *ANY
The file size is not to be used as a selection criterion.
SIZE = *FREESIZE
Returns information on files for which none of the reserved PAM pages has yet been used.
SIZE = <integer 0..2147483647>
Returns information on files with the specified number of reserved PAM pages.
SIZE = *INTERVAL(...)
Returns information on files for which the number of reserved PAM pages lies within the specified range. The upper and lower limits are both included in the range specified. It is also possible to specify limits using only the operand FROM (lower limit) or TO (upper limit). For whichever operand is not specified, the default value will be used as the limit for the range. The use of range limits for information output can only be meaningful if the chosen lower limit <= the upper limit. Information will only be returned about files for which the number of PAM pages reserved is at least equal to the FROM value and at most equal to the TO value (FROM <= SIZE <= TO).
FROM = 0 / <integer 0..2147483647>
Returns information only about those files for which the number of PAM pages reserved is at least the specified number (SIZE >= specified value).
TO = STD / <integer 0..2147483647>
Returns information only about those files for which the number of PAM pages reserved is at most the specified number (SIZE <= specified value).
NUMBER-OF-EXTENTS = *ANY / *NOT-ZERO / <integer 0..65535> / *INTERVAL(...)
Returns information on disk files/FGGs depending on the number of their extents. An extent is a contiguous area on a disk, occupied by one file; the output field EXTENTS shows how many extents the file has.
NUMBER-OF-EXTENTS = *ANY
The number of extents is not to be used as a selection criterion.
NUMBER-OF-EXTENTS = *NOT-ZERO
Returns information only about those files whose number of extents is not zero.
NUMBER-OF-EXTENTS = <integer 0..65535>
Returns information on those files which have exactly the specified number of extents.
NUMBER-OF-EXTENTS = *INTERVAL(...)
Selects all the files whose number of extents lies within the specified range. The upper and lower limits are both included in the range specified. It is also possible to specify limits using only the operand FROM (lower limit) or TO (upper limit). For whichever operand is not specified, the default value will be used as the limit for the range. The use of range limits for information output can only be meaningful if the chosen lower limit <= the upper limit. Information will only be returned about the disk files for which the number of extents is at least equal to the FROM value and at most equal to the TO value (FROM <= NUMBER-OF-EXTENTS <= TO).
FROM = 0 / <integer 0..65535>
Returns information on only those files with at least the specified number of extents.
TO = 65535 / <integer 0..65535>
Returns information on only those files with at most the specified number of extents.
NUMBER-OF-FREE-PAGES = *ANY / *ALL-ALLOCATED / *NOT-ZERO / <integer 0..2147483647> / *INTERVAL(...)
Returns information on files/file generations depending on the size of their free (=reserved but unused) storage space.
NUMBER-OF-FREE-PAGES = *ANY
The size of the free storage space is not to be used as a selection criterion.
NUMBER-OF-FREE-PAGES = *ALL-ALLOCATED
Returns information on files whose number of free PAM pages is equal to their number of reserved PAM pages.
NUMBER-OF-FREE-PAGES = *NOT-ZERO
Returns information on files with at least one unused PAM page.
NUMBER-OF-FREE-PAGES = <integer 0..2147483647>
Returns information on files with exactly the specified number of reserved but unused PAM pages.
NUMBER-OF-FREE-PAGES = *INTERVAL(...)
Returns information on files whose number of free PAM pages lies within the specified range. The upper and lower limits are both included in the range specified.
It is also possible to specify limits using only the operand FROM (lower limit) or TO (upper limit). For whichever operand is not specified, the default value will be used as the limit for the range.
The use of range limits for information output can only be meaningful if the chosen lower limit <= the upper limit.
Information will only be returned about files for which the number of free PAM pages is at least equal to the FROM value and at most equal to the TO value (FROM <= NUMBER-OF-FREE-PAGES <= TO).
FROM = 0 / <integer 0..2147483647>
Returns information on only those files which have at least as many free PAM pages as specified (NUMBER-OF-FREE-PAGES >= specified value).
TO = 2147483647 / <integer 0..2147483647>
Returns information on only those files which have at most as many free PAM pages as specified (NUMBER-OF-FREE-PAGES <= specified value).
HIGHEST-USED-PAGE = *ANY / <integer 0..2147483647> / INTERVAL(...)
Selects all files for which the specified number of PAM pages have been written. (Last Page Pointer points to the specified page).
HIGHEST-USED-PAGE = *ANY
The number of PAM pages written (output field HIGH-US-PA) is not to be used as a selection criterion.
HIGHEST-USED-PAGE = <integer 0..2147483647>
Selects all files for which the specified number of PAM pages have been written. (Last Page Pointer points to the specified page).
HIGHEST-USED-PAGE = *INTERVAL(...)
Selects all files for which the number of pages written lies within the specified range.
FROM = 0 / <integer 0..2147483647>
Selects all files for which the number of pages written >= the specified number.
TO = 2147483647 / <integer 0..2147483647>
Selects all files for which the number of pages written <= the specified number.
BLOCK-COUNTER = *ANY / <integer 0..2147483647> / *INTERVAL(...)
Returns information on all tape files that occupy the specified number of tape blocks.
BLOCK-COUNTER = *ANY
The number of occupied tape blocks is not to be used as a selection criterion.
BLOCK-COUNTER = <integer 0..2147483647>
Returns information on all tape files which occupy exactly the specified number of tape blocks.
BLOCK-COUNTER = *INTERVAL(...)
Returns information on all tape files for which the occupied number of tape blocks falls within the specified interval which follows.
FROM = 0 / <integer 0..2147483647>
Returns information on all tape files for which the number of occupied tape blocks >= the specified number.
TO = 2147483647 / <integer 0..2147483647>
Returns information on all tape files for which the number of occupied tape blocks <= the specified number.
ACCESS = *ANY / *READ / *WRITE
Returns information on files/file generation depending on their access type.
ACCESS = *ANY
The ACCESS value is not to be used as a selection criterion.
ACCESS = *READ
Returns information on only those files to which writing is prohibited by
ACCESS=READ, i.e. to which only read access is permitted.
ACCESS = *WRITE
Returns information on only those files to which write access is permitted.
PASSWORD = *ANY / list-poss(4): *NONE / *READ-PASSWORD / *WRITE-PASSWORD /
*EXEC-PASSWORD
Returns information on files/file generation groups depending on the password protection defined. If several types of password are specified as a list, the system will link them by logical Or, and will return information on all the files which satisfy any one of the specified conditions.
PASSWORD = *ANY
Password protection is not to be used as a selection criterion.
PASSWORD = *NONE
Returns information on files which have no password protection.
PASSWORD = *READ-PASSWORD
Returns information on files which are protected by a read password; the actual passwords will not be output.
PASSWORD = *WRITE-PASSWORD
Returns information on files which are protected by a write password; the actual passwords will not be output.
PASSWORD = *EXEC-PASSWORD
Returns information on files which are protected by an execute password; the actual passwords will not be output.
USER-ACCESS = *ANY / *OWNER-ONLY / *ALL-USERS / *SPECIAL
Returns information on files/file generation groups depending on whether they are shareable. If a user ID other than the user’s own is specified, then implicitly USER-ACCESS=ALL-USERS.
USER-ACCESS = *ANY
The access authorization is not to be used as a selection criterion.
USER-ACCESS = *OWNER-ONLY
Returns information on files which only the file owner may access.
USER-ACCESS = *ALL-USERS
Returns information on files which may be also be accessed under other user IDs.
USER-ACCESS = *SPECIAL
Returns information on files which may also be accessed under all user IDs and the maintenance IDs (user IDs with HARDWARE-MAINTENANCE privilege).
BASIC-ACL = *ANY / *NONE / *YES / *PARAMETERS(...)
Selects all files whose BASIC-ACL entry matches the specified values.
BASIC-ACL = *NONE
Returns information on files that have no BASIC-ACL entry in the catalog.
BASIC-ACL = *YES
Returns information on files that have a BASIC-ACL entry in the catalog.
BASIC-ACL = *PARAMETERS(...)
Selects all files for which the specified access rights are defined in the BASIC-ACL entry. NO-ACCESS means that no access rights have been defined.
OWNER = *ANY / *NO-ACCESS / *PARAMETERS(...)
Specifies which access rights must already be defined for the owner.
OWNER = *PARAMETERS(...)
Access rights that must be present for the owner (logically ORed together):
READ = *ANY / *NO / *YES
Specifies whether read access authorization must be present.
WRITE = *ANY / *NO / *YES
Specifies whether write access authorization must be present.
EXEC = *ANY / *NO / *YES
Specifies whether execute access authorization must be present.
GROUP = *ANY / *NO-ACCESS / *PARAMETERS(...)
Specifies which access rights should already be defined for the owner’s user group.
GROUP = *PARAMETERS(...)
Access rights that must be present for the owner’s user group (logically ORed together):
READ = *ANY / *NO / *YES
Specifies whether read access authorization must be present.
WRITE = *ANY / *NO / *YES
Specifies whether write access authorization must be present.
EXEC = *ANY / *NO / *YES
Specifies whether execute access authorization must be present.
OTHERS = *ANY / *NO-ACCESS / *PARAMETERS(...)
Specifies which access rights should already be defined for all other users.
OTHERS = *PARAMETERS(...)
Access rights that must be present for all other users (logically ORed together):
READ = *ANY / *NO / *YES
Specifies whether read access authorization must be present.
WRITE = *ANY / *NO / *YES
Specifies whether write access authorization must be present.
EXEC = *ANY / *NO / *YES
Specifies whether execute access authorization must be present.
GUARDS = *ANY / *NO / *YES / *PARAMETERS(...)
Returns information on files for which access is controlled using GUARDS (see the CREATE-FILE or MODIFY-FILE-ATTRIBUTES command).
GUARDS = *ANY
Access control with GUARDS is not to be used as a selection criterion.
GUARDS = *NO
Returns information on files that are not protected by GUARDS against unauthorized access.
GUARDS = *YES
Returns information on files that are protected by GUARDS against unauthorized access, i.e. files for which access is controlled via the GUARDS subsystem.
GUARDS = *PARAMETERS(...)
Returns information on files which are protected by GUARDS against unauthorized access as specified, i.e. files for which access control is implemented using GUARDS: Access to the file is controlled by a guard, i.e. a special object which contains all the conditions under which a user is granted access authorization, e.g. date, time, user ID. The GUARDS function unit of the chargeable software product SECOS (see the “SECOS” manual [35]) must be installed in order to create and maintain a guard.
Each access mode can be controlled by a separate guard. If no guard (*NONE) is defined for a given access mode, no corresponding access is permitted. If a defined guard is not accessible, the mode of access protected by it is not permitted. If the GUARDS subsystem is not available at the time of accessing the job variable, no access of any kind is allowed for the job variable.
READ = *ANY / *NONE / <filename 1..18 without-cat-gen-vers>
Returns information on files which are protected against unauthorized read access by the specified “guard”. The default value *ANY means that the selection of files is not based on read protection with a guard. *NONE selects files for which no read guard was defined, i.e. files for which no read access is permitted.
WRITE = *ANY / *NONE / <filename 1..18 without-cat-gen-vers>
Returns information on files which are protected against unauthorized write access by the specified “guard”. The default value *ANY means that the selection of files is not based on a guard. *NONE selects files for which no guard was defined, i.e. files for which no write access is permitted.
EXEC = *ANY / *NONE / <filename 1..18 without-cat-gen-vers>
Returns information on files which are protected against unauthorized execution by the specified “guard”. The default value *ANY means that the selection of files is not based on execute protection with a guard. *NONE selects files for which no guard was defined, i.e. files which cannot be executed.
PROTECTION-ACTIVE = *ANY / list-poss(3): *LEVEL-0 / *LEVEL-1 / *LEVEL-2
Returns information on files for which the specified protection level is the highest activated access control.
When the file is accessed, the highest activated protection level applies. The following table shows the method used for access control, the protection attributes, and the job variable protection hierarchy (protection levels):
Access control | Protection attribute | Prot. level |
|---|---|---|
Standard access control | ACCESS and USER-ACCESS | 0 |
Basic access control list | BASIC-ACL | 1 |
Access control via guards | PASSWORD | 2 |
All other protection attributes of the file (e.g. passwords) are evaluated independently, without regard to the implemented protection level.
PROTECTION-ACTIVE = *ANY
The access control method is not to be used as a selection criterion.
PROTECTION-ACTIVE = *LEVEL-0
Returns information on files for which access is controlled via standard access control.
PROTECTION-ACTIVE = *LEVEL-1
Returns information on files for which access is controlled via a basic access control list (BASIC-ACL protection).
PROTECTION-ACTIVE = *LEVEL-2
Returns information on files for which access is controlled via an access control list (ACL) or by GUARDS.
STATUS = *ANY / *PARAMETERS(...)
Returns information on files/file generations based on the current file status.
STATUS = *ANY
The file status is not to be used as a selection criterion.
STATUS = *PARAMETERS(...)
Returns information on files which have the specified status. The following selection criteria are possible:
CLOSED-OUTPUT = *ANY / *YES / *NO
Specifies whether the “file closed” status is to be used as a selection criterion.
CLOSED-OUTPUT = *YES
Returns information on the output files which have already been closed.
CLOSED-OUTPUT = *NO
Returns information on output files which have been opened (OPEN OUTIN, INOUT or OUTPUT) in a program, and about files which were not closed in an earlier system run or because a job was aborted. GENERATIONS=*YES applies implicitly.
CACHED = *ANY / *YES / *NO
Specifies whether file processing via a cache is to be used as a selection criterion.
CACHED = *ANY
Returns information on files regardless of whether or not they are cached.
CACHED = *YES
Returns information on the files/file generations which are currently cached.
CACHED = *NO
Returns information on the files/file generations for which no data has been cached.
REPAIR-NEEDED = *ANY / *YES
Specifies whether files which were not closed in an earlier system run and not reconstructed with REPAIR-DISK-FILES are to be selected.
REPAIR-NEEDED = *ANY
Returns information on files regardless of whether or not they need to be repaired.
REPAIR-NEEDED = *YES
Returns information on only those files which were not closed in an earlier system run and which are not yet reconstructed.
OPEN-ALLOWED = *ANY / *YES / *NO
Specifies whether files which could not be opened due to data inconsistency are to be selected.
OPEN-ALLOWED = *ANY
Returns information on files regardless of whether or not they can be opened.
OPEN-ALLOWED = *YES
Returns information on the files that can be opened.
OPEN-ALLOWED = *NO
Returns information on files which cannot be opened due to data inconsistency.
DEFECT-REPORTED = *ANY / *YES
Specifies whether files which may contain defective disk blocks are to be used as a selection criterion.
DEFECT-REPORTED = *ANY
Returns information on files regardless of whether they may contain defective disk blocks.
DEFECT-REPORTED = *YES
Returns information on files which contain defective disk blocks.
CACHE-NOT-SAVED = *ANY / *YES
Specifies whether to select files for which updates have not been written out from the cache.
CACHE-NOT-SAVED = *ANY
Returns information on files regardless of whether there are updates which have not been written out from the cache.
CACHE-NOT-SAVED = *YES
Returns information on files for which updates have not been written out from the cache.
FILE-STRUCTURE = *ANY / list-poss(5): *PAM / *SAM / *ISAM / *BTAM / *NONE
Returns information on files which were created with the specified access method.
FILE-STRUCTURE = *ANY
The access method is not to be used as a selection criterion.
FILE-STRUCTURE = *PAM
Returns information on PAM files.
FILE-STRUCTURE = *SAM
Returns information on SAM files.
FILE-STRUCTURE = *ISAM
Returns information on ISAM files.
FILE-STRUCTURE = *BTAM
Returns information on BTAM files.
FILE-STRUCTURE = *NONE
Returns information on files which have been cataloged, but which contain no data i.e. files which have not yet been opened, or files for which storage space has been released (logically deleted) by using the OPTION=*DATA operand in a DELETE-FILE command.
BLOCK-CONTROL-INFO = *ANY / list-poss(9): *NONE / *NO / *WITHIN-DATA-BLOCK /
*WITHIN-DATA-2K-BLOCK / *WITHIN-DATA-4K-BLOCK / *PAMKEY / *NK / *NK2 / *NK4
Returns information on files, depending on the block format with which data was stored in the file (defined by the BLOCK-CONTROL-INFO operand in an ADD-FILE-LINK command).
BLOCK-CONTROL-INFO = *ANY
The BLOCK-CONTROL information is not to be used as a selection criterion.
BLOCK-CONTROL-INFO = *NONE
Returns information on files for which no BLOCK-CONTROL-INFORMATION value has yet been entered, i.e. which have not yet been opened.
BLOCK-CONTROL-INFO = *NO
Returns information on files which were created with BLOCK-CONTROL-INFO=*NO i.e. files created without a PAM key.
BLOCK-CONTROL-INFO = *WITHIN-DATA-BLOCK
Returns information on files which were created with BLOCK-CONTROL-INFO= *WITHIN-DATA-BLOCK, i.e. whose block control information is held in a block control field at the start of and within the data block.
BLOCK-CONTROL-INFO = *WITHIN-DATA-2K-BLOCK
Returns information on NK-ISAM files which were created with BLOCK-CONTROL-INFO=*WITHIN-DATA-2K-BLOCK, i.e. files for which block control information is located at the start of each 2K block.
BLOCK-CONTROL-INFO = *WITHIN-DATA-4K-BLOCK
Returns information on NK-ISAM files which were created with BLOCK-CONTROL-INFO=*WITHIN-DATA-4K-BLOCK, i.e. files for which block control information is located at the start of each 4K block.
BLOCK-CONTROL-INFO = *PAMKEY
Returns information on files which were created with BLOCK-CONTROL-INFO= *PAMKEY, i.e. whose block control information is contained in a separate PAM key outside the PAM block.
BLOCK-CONTROL-INFO = *NK
Returns information on NK files, i.e. files which can also be stored on volumes (NK2 and NK4).
BLOCK-CONTROL-INFO = *NK2
Returns information on files which can also be stored on NK2 volumes but not on NK4 volumes.
BLOCK-CONTROL-INFO = *NK4
Returns information on files which can also be stored on NK4 volumes.
LAST-BYTE-POINTER = *ANY / *NO / *YES / *ZERO / *NOT-ZERO
Returns information on files depending on the attribute of the last-byte pointer (LBP).
LAST-BYTE-POINTER = *ANY
The last-byte pointer is not to be used as a selection criterion.
LAST-BYTE-POINTER = *NO
Returns information on files which do not have a valid last-byte pointer.
LAST-BYTE-POINTER = *YES
Returns information on files which do have a valid last-byte pointer.
LAST-BYTE-POINTER = *ZERO
Returns information on files which have a valid last-byte pointer with the value zero.
LAST-BYTE-POINTER = *NOT-ZERO
Returns information on files which have a valid last-byte pointer with a value that is not zero.
BACKUP-CLASS = *ANY / list-poss(5): *A / *B / *C / *D / *E
Returns information on files/FGGs whose ARCHIVE or HSMS backup level is the same as the specified operand value. Several backup levels may be specified as a list. In this case, all the files/FGGs which satisfy one of the listed conditions will be selected (logical ORing).
BACKUP-CLASS = *ANY
The BACKUP-CLASS level is not to be used as a selection criterion.
BACKUP-CLASS = *A
Returns information on files/FGGs with the attribute BACK-CLASS = A.
BACKUP-CLASS = *B
Returns information on files/FGGs with the attribute BACK-CLASS = B.
BACKUP-CLASS = *C
Returns information on files/FGGs with the attribute BACK-CLASS = C.
BACKUP-CLASS = *D
Returns information on files/FGGs with the attribute BACK-CLASS = D.
BACKUP-CLASS = *E
Returns information on files/FGGs with the attribute BACK-CLASS = E.
MIGRATE = *ANY / list-poss(3): *ALLOWED / *INHIBITED / *FORBIDDEN
Returns information for all the files whose catalog entry contains the specified MIGRATE value. This entry is evaluated by the Hierarchical Storage Management System (HSMS) when files are being migrated (CREATE.../ MODIFY... command, MIGRATE operand). If multiple attributes are specified in the form of a list, all files that satisfy one of the conditions are selected.
MIGRATE = *ANY
The entry for MIGRATE is not to be used as a selection criterion.
MIGRATE = *ALLOWED
Returns information for only those files whose catalog entry shows MIGRATE = ALLOWED, i.e. files which may be migrated to storage level S1 or S2.
MIGRATE = *INHIBITED
Returns information for only those files for which MIGRATE = INHIBITED was defined in the catalog entry, i.e. files which may only be migrated for a brief period, e.g. for reorganization purposes (normal migration lock).
MIGRATE = *FORBIDDEN
Returns information for only those files for which MIGRATE = FORBIDDEN was defined in the catalog entry, i.e. files which must never be migrated (intensified migration lock).
VERSION-BACKUP = *ANY / list-poss(2): *ENABLED / *DISABLED
Returns information on files according to the value of the NUM-OF-BACKUP-VERS file attribute (output field #BACK-VERS). It is evaluated by the Hierarchical Storage Management System (HSMS) during the version backup and defines the maximal possible number of file versions kept in the version backup archive (CREATE-.../ MODIFY-..., Operand NUM-OF-BACKUP-VERS).
VERSION-BACKUP = *ANY
The value of NUM-OF-BACKUP-VERS is not used as a selection criterion.
VERSION-BACKUP = *ENABLED
Returns information only on files participating in version backup, i.e. files for which NUM-OF-BACKUP-VER > 0 was defined.
VERSION-BACKUP = *DISABLED
Returns information only on files ignored by version backup, i.e. files for which NUM-OF-BACKUP-VER = 0 was defined.
STORAGE-LEVEL = *ANY / list-poss(3): *S0 / *S1 / *S2
Returns information on files which are currently held at the specified hierarchical storage level (see the “HSMS” manual [18]). HSMS supports the following hierarchical storage levels: When HSMS (Hierarchical Storage Management System) is being used, files on public storage space may be held at any of three storage levels:
S0: | This comprises all pubsets which the user is authorized to access, according to his/her user entry. These are implemented as fast access disk storage (online processing). |
S1: | This comprises disks on which HSMS has stored files which have been migrated from the S0 level. When DMS requires to access them, they are fetched back to the processing level, S0. Implemented as high capacity disk storage (background level, available online). |
S2: | This is a tape archive in which HSMS stores files which have been migrated from S0 on a longer-term basis. When DMS requires to access them they are fetched back to the processing level, S0, in accordance with the HSMS operating parameters which have been set and the availability of tape devices. Implemented as a magnetic tape and tape cartridge archive (background level, available offline). |
Files which have been migrated are identified as follows when the catalog entry is output: The character “#” is interposed between the number of reserved PAM pages and the file name. The field SUPPORT contains PUB/S1 or PUB/S2. In addition, migrated files have a STOR-LEVEL field containing S1 or S2. If multiple attributes are specified in the form of a list, all files that satisfy one of the conditions are selected.
STORAGE-LEVEL = *ANY
Returns information on the specified files, irrespective of the hierarchical storage level at which they are held.
STORAGE-LEVEL = *S0
Returns information on only those files held at level S0.
STORAGE-LEVEL = *S1
Returns information on only those files held at level S1.
STORAGE-LEVEL = *S2
Returns information on only those files held at level S2.
GENERATIONS = *NO / *YES
File generation details. Specifies whether additional information is required about individual generations as well as that about the file generation group. Unless explicitly requested here, information on the individual file generations in any group will not be output.
GENERATIONS = *NO
If the FILE-NAME operand identifies a file generation group, then only the information on the group entry will be output, but none about the individual generations in the group.
GENERATIONS = *YES
Information will be output about the individual file generations in any file generation group.
GENERATIONS=*YES is ignored unless a file generation or file generation group has been specified in the FILE-NAME operand.
The interaction between the operand GENERATIONS = *NO or *YES and the operand TYPE-OF-FILES = *FILE-GROUP described below is summarized by the following table:
Operand combinations | Information provided about | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
TYPE-OF-FILES | GENERATIONS | FGG | File generations | Files | |||||||
= *YES | = *NO | ||||||||||
x | x | * | * | - | |||||||
x | x | * | - | - | |||||||
x | * | * | * | ||||||||
x | * | - | * | ||||||||
| |||||||||||
TYPE-OF-FILES = *ANY / list-poss(2): *FILE-GROUP / *PLAM-LIBRARY
Specifies whether information is to be listed on the basis of the file type. The returned information can be restricted to file generations or groups or to PLAM libraries.
TYPE-OF-FILES = *ANY
Returns information on files without taking their file type into account.
TYPE-OF-FILES = *FILE-GROUP
Restricts the returned information to file generation groups and file generations (see GENERATIONS=*YES). Only file generation groups will be selected from the file set identified by the specified FILE-NAME.
TYPE-OF-FILES = *PLAM-LIBRARY
Returns information on PLAM libraries only.
FROM-CATALOG = *STD / *PRIVATE(...) / *NET(...) / *LOCAL
The FROM-CATALOG operand defines the source to be used for the information output by SHOW-FILE-ATTRIBUTES.
FROM-CATALOG = *STD
If the file name (FILE-NAME operand) is specified without a catalog ID, the source of information for the SHOW-FILE-ATTRIBUTES command will be the file catalog (TSOSCAT) for the user ID’s default pubset, i.e. the catalog with the default catalog ID.
If a catalog ID is specified explicitly, the information is taken from the file catalog with that catalog ID. If wildcards are used in the catalog ID, the information is taken from the file catalogs of the selected available pubsets.
FROM-CATALOG = *PRIVATE(...)
The source of information for the SHOW-FILE-ATTRIBUTES command will be the directory of the private disk identified by the VOLUME operand which follows. The device type for the private disk must then be specified under DEVICE. The permissible specifications for DEVICE-TYPE can also be found in the device table in section“Device type table” (device type column).
No value may be specified for the operands SUPPORT=... and VOLUME=... above.
VOLUME = <vsn 1..6>
The VSN of the private disk.
DEVICE = <device>
Device type for the private disk. If DEVICE-TYPE=? is entered in interactive mode, SDF lists the device types current known on the system.
FROM-CATALOG = *NET(...)
The SHOW-FILE-ATTRIBUTES command obtains its information from the catalog of a Net-Storage volume. Only *ANY may have been specified for the SUPPORT=,STORAGE-TYPE= and VOLUME= operands.
VOLUME = <vsn 1..6>
Volume serial number of the Net-Storage volume.
FILE-TYPE = *ANY / *BS2000 / *NODE-FILE
Returns information on files on Net-Storage volumes, depending on the file type with which they are created.
FILE-TYPE = *ANY
The file type is not a selection criterion.
FILE-TYPE = *BS2000
Returns information only on BS2000 files on the Net-Storage volume.
FILE-TYPE = *NODE-FILE
Returns information only on node files on the Net-Storage volume.
FROM-CATALOG = *LOCAL
The source of information for the SHOW-FILE-ATTRIBUTES command will be the system catalogs of all the selected local pubsets.
IO-ATTRIBUTES = *ANY / *PARAMETERS(...)
Returns information on files that have the specified performance attributes in the catalog entry (see the IO-ATTRIBUTES operand in the CREATE-FILE/ MODIFY-FILE-ATTRIBUTES command).
IO-ATTRIBUTES = *ANY
The performance attributes are not to be used as a selection criterion.
IO-ATTRIBUTES = *PARAMETERS(...)
Returns information on files for which the specified performance attributes that follow have been entered in the catalog.
PERFORMANCE = *ANY / list-poss(3): *STD / *HIGH / *VERY-HIGH
Returns information on files with the specified performance attribute (output field IO(PERF)).
If multiple attributes are specified in the form of a list, all files that satisfy one of the conditions are selected.
PERFORMANCE = *ANY
The performance attribute is not a selection criterion.
PERFORMANCE = *STD
Returns information on files which can be processed without any special performance requirements.
PERFORMANCE = *HIGH
Returns information on files which should be processed via a cache (high performance priority).
PERFORMANCE = *VERY-HIGH
Returns information on files containing data which should be processed via a cache and which should be permanently maintained in the cache if possible (highest performance priority).
USAGE = *ANY / list-poss(3): *READ-WRITE / *WRITE / *READ
Returns information on the files which have a performance attribute that applies to the specified I/O operations (output field IO(USAGE)). If multiple attributes are specified in the form of a list, all files that satisfy one of the conditions are selected.
USAGE = *ANY
The type of I/O operations to which the performance attribute applies is not to be used as a selection criterion.
USAGE = *READ-WRITE
Returns information on files for which the performance attribute applies to read-write operations.
USAGE = *WRITE
Returns information on files for which the performance attribute applies to write operations only.
USAGE = *READ
Returns information on files for which the performance attribute applies to read operations only.
DISK-WRITE = *ANY / *IMMEDIATE / *BY-CLOSE
Returns information on files based on the time at which data consistency is required after a write operation (see the DISK-WRITE output field).
DISK-WRITE = *ANY
The point at which data consistency is required is not a selection criterion.
DISK-WRITE = *IMMEDIATE
Returns information on files for which data consistency is required immediately after write operations.
DISK-WRITE = *BY-CLOSE
Returns information on files for which data consistency is required only after CLOSE processing.
FREE-FOR-DELETION = *ANY / *NONE / *TOMORROW(...) / *TODAY(...) / *YESTERDAY(...) /
<integer -99999..99999>(...) / <date>(...) / *INTERVAL(...)
Returns information on files with the specified free-for-deletion date (date of release for deletion; FREE-DEL-D and FREE-DEL-T output fields). The selection for a specified date can be restricted to a specific period of time on the free-for-deletion date (see the TIME operands in the various structures).
FREE-FOR-DELETION = *ANY
The free-for-deletion date is not used as a selection criterion.
FREE-FOR-DELETION = *NONE
Returns information only on files for which no free-for-deletion date has yet been entered in the catalog.
FREE-FOR-DELETION = *TOMORROW(...)
Only returns information on files for which the next day is specified as the free-for-deletion date in the catalog entry.
TIME = *ANY / *INTERVAL(...)
Restricts the file selection to a period relative to the date of the next day.
TIME = *INTERVAL(...)
Returns information only on files with a free-for-deletion date which falls within the period specified next.
FROM = 00:00:00 / <time>
Selects files with a free-for-deletion date >= the specified time.
TO = 23:59:59 / <time>
Selects files with a free-for-deletion date <= the specified time.
FREE-FOR-DELETION = *TODAY(...)
Returns information only on files with today’s date recorded as free-for-deletion date in their catalog entry.
TIME = *ANY / *INTERVAL(...)
Restricts the selection to a period of time relative to today’s date.
TIME = *INTERVAL(...)
Returns information only on files with a free-for-deletion date which falls within the period specified next.
FROM = 00:00:00 / <time>
Selects files with a free-for-deletion date >= the specified time.
TO = 23:59:59 / <time>
Selects files with a free-for-deletion date <= the specified time.
FREE-FOR-DELETION = *YESTERDAY(...)
Returns information only on files with yesterday’s date recorded as free-for-deletion date in their catalog entry.
TIME = *ANY / *INTERVAL(...)
Restricts the selection to a period of time relative to yesterday’s date.
TIME = *INTERVAL(...)
Returns information only on files with a free-for-deletion date which falls within the period specified next.
FROM = 00:00:00 / <time>
Selects files with a free-for-deletion date >= the specified time.
TO = 23:59:59 / <time>
Selects files with a free-for-deletion date <= the specified time.
FREE-FOR-DELETION = <integer -99999..99999>(...)
Returns information only on files with the specified date recorded as free-for-deletion date in their catalog entry. The free-for-deletion date is specified relative to today’s date (in the form -n for the past or +n for the future).
TIME = *ANY / *INTERVAL(...)
Restricts the selection to a period of time relative to the specified date.
TIME = *INTERVAL(...)
Returns information only on files with a free-for-deletion date which falls within the period specified next.
FROM = 00:00:00 / <time>
Selects files with a free-for-deletion date >= the specified time.
TO = 23:59:59 / <time>
Selects files with a free-for-deletion date <= the specified time.
FREE-FOR-DELETION = <date>(...)
Returns information only on files with the specified date recorded as free-for-deletion date in their catalog entry. The date is specified in the form [yy]yy-mm-dd. 20 is automatically prefixed to two-digit year specifications < 60, 19 to two-digit year specifications >= 60.
TIME = *ANY / *INTERVAL(...)
Restricts the selection to a period of time relative to the specified date.
TIME = *INTERVAL(...)
Returns information only on files with a free-for-deletion date which falls within the period specified next.
FROM = 00:00:00 / <time>
Selects files with a free-for-deletion date >= the specified time.
TO = 23:59:59 / <time>
Selects files with a free-for-deletion date <= the specified time.
FREE-FOR-DELETION = *INTERVAL(...)
Returns information only on files with a free-for-deletion date which falls within the specified period. The range of dates covered by the specification includes the two end dates (see also the explanation of how dates are specified for the FREE-FOR-DELETION= <integer...> operand). It is also possible to specify only the FROM operand (lower limit) or the TO operand (upper limit). For whichever operand is not specified, the default value will be used as the limit for the range. The use of range limits for information output can only be meaningful if the chosen lower limit <= the upper limit.
FROM = 1900-01-01 / *TOMORROW(...) / *TODAY(...) / *YESTERDAY(...) / <integer -99999..99999>(...) / <date>(...)
Returns information only on files with a free-for-deletion date >= the specified date.
FROM = *TOMORROW(...)
Provides information on files whose free-for-deletion date >= the date of the next day.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a free-for-deletion date after the specified time are selected.
FROM = *TODAY(...)
Returns information only on files with a free-for-deletion date >= today’s date.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a free-for-deletion date after the specified time are selected.
FROM = *YESTERDAY(...)
Returns information only on files with a free-for-deletion date >= yesterday’s date.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a free-for-deletion date after the specified time are selected.
FROM = <integer -99999..99999>(...)
Returns information only on files with a free-for-deletion date >= the specified date (in the form -n for the past or +n for the future).
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a free-for-deletion date after the specified time are selected.
FROM = <date>(...)
Returns information only on files with a free-for-deletion date >= the specified date. The date is specified in the form [yy]yy-mm-dd. 20 is automatically prefixed to two digit year specifications < 60, 19 to two digit year specifications >= 60.
TIME = 00:00:00 / <time>
Time on the specified date. All files that have a free-for-deletion date after the specified time are selected.
TO = *ANY / *TODAY(...) / *TOMORROW(...) / *YESTERDAY(...) / <integer -99999..99999>(...) /
<date>(...)
Returns information only on files with a free-for-deletion date <= the specified date.
TO = *ANY
There is no upper limit on the selection range based on the free-for-deletion date.
TO = *TODAY(...)
Returns information only on files with a free-for-deletion date <= today’s date.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a free-for-deletion date before the specified time are selected.
TO = *TOMORROW(...)
Provides information on files whose free-for-deletion date <= the date of the next day.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a free-for-deletion date before the specified time are selected.
TO = *YESTERDAY(...)
Returns information only on files with a free-for-deletion date <= yesterday’s date.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a free-for-deletion date before the specified time are selected.
TO = <integer -99999..99999>(...)
Returns information only on files with a free-for-deletion date <= the specified date (in the form -n for the past or +n for the future).
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a free-for-deletion date before the specified time are selected.
TO = <date>(...)
Returns information only on files with a free-for-deletion date <= the specified date. The date is specified in the form [yy]yy-mm-dd. 20 is automatically prefixed to two digit year specifications < 60, 19 to two digit year specifications >= 60.
TIME = 23:59:59 / <time>
Time on the specified date. All files that have a free-for-deletion date before the specified time are selected.
STORAGE-CLASS = *ANY / *NONE / <composed-name 1..8>
Returns information on files assigned the specified storage class.
STORAGE-CLASS = *ANY
The storage class is not a selection criterion.
STORAGE-CLASS = *NONE
Returns information only on files with no storage class assigned to them.
STORAGE-CLASS = <composed-name 1..8>
Returns information on files assigned the specified storage class.
MANAGEMENT-CLASS = *ANY / *NONE / <composed-name 1..8>
Returns information on files assigned the specified HSMS management class.
MANAGEMENT-CLASS = *ANY
The HSMS management class is not a selection criterion.
MANAGEMENT-CLASS = *NONE
Returns information only on files with no HSMS management class assigned to them.
MANAGEMENT-CLASS = <composed-name 1..8>
Returns information on files assigned the specified HSMS management class.
ADM-INFORMATION = *ANY / *NONE / <c-string 1..8 with-low>
Returns information on files with the specified systems support information in their catalog.
ADM-INFORMATION = *ANY
The systems support information is not a selection criterion.
ADM-INFORMATION = *NONE
Returns information only on files with no systems support information in their catalog.
ADM-INFORMATION = <c-string 1..8 with-low>
Returns information only on files with the specified string as the systems support information in their catalog.
USER-INFORMATION = *ANY / *NONE / <c-string 1..8 with-low>
Returns information on files with the specified user information in their catalog.
USER-INFORMATION = *ANY
The user information is not a selection criterion.
USER-INFORMATION = *NONE
Returns information only on files with no user information in their catalog.
USER-INFORMATION = <c-string 1..8 with-low>
Returns information only on files with the specified string as the user information in their catalog.
VOLUME-SET = *ANY / <cat-id 1..4>
Returns information on files stored in the specified volume set.
VOLUME-SET = *ANY
The volume set is not a selection criterion.
VOLUME-SET = <cat-id 1..4>
Returns information only on files stored in the specified volume set.
AVAILABILITY = *ANY / list-poss(2): *STD / *HIGH
Returns information on files with the specified availability requirements.
AVAILABILITY = *ANY
Availability is not a selection criterion.
AVAILABILITY = *STD
Returns information only on files with no high availability requirements.
AVAILABILITY = *HIGH
Returns information only on files with high availability requirements. The files are typically on disks mirrored by DRV.
S0-MIGRATION = *ANY / list-poss(2): *ALLOWED / *FORBIDDEN
Returns information on files with the specified migration permission within the processing level (SO).
S0-MIGRATION = *ANY
Migration within the processing level is not a selection criterion.
S0-MIGRATION = *ALLOWED
Returns information only on files for which migration to other volume sets within the processing level is allowed.
S0-MIGRATION = *FORBIDDEN
Returns information only on files for which migration to other volume sets within the processing level is forbidden.
WORK-FILE = *ANY / *NO / *YES
Returns information on files with the specified work file attribute.
WORK-FILE = *ANY
The work file attribute is not a selection criterion.
WORK-FILE = *NO
Returns information only on files which are not flagged as work files.
WORK-FILE = *YES
Returns information only on files which are flagged as work files.
FILE-PREFORMAT = *ANY / list-poss(4): *NONE / *K / *NK2 / *NK4
Returns information only on files with the specified preferred file format.
FILE-PREFORMAT = *ANY
The preferred file format is not a selection criterion.
FILE-PREFORMAT = *NONE
Returns information only on files for which no preferred file format has been indicated.
FILE-PREFORMAT = *K
Returns information only on files which are intended to be K files.
FILE-PREFORMAT = *NK2
Returns information only on files which are intended to be NK files in 2K format.
FILE-PREFORMAT = *NK4
Returns information only on files which are intended to be NK files in 4K format.
ACCESS-COUNTER = *ANY / <integer 0..2147483647> / *INTERVAL(...)
Returns information on all files that were accessed the specified number of times (output field ACC-COUNT).
ACCESS-COUNTER = *ANY
The access counter is not to be used as a selection criterion.
ACCESS-COUNTER = <integer 0..2147483647>
Returns information on files for which the access counter exactly matches the specified value.
ACCESS-COUNTER = *INTERVAL(...)
Returns information on files for which the access counter lies in the specified value range which follows.
FROM = 0 / <integer 0..2147483647>
Returns information on files for which the access counter >= the specified value.
TO = 2147483647 / <integer 0..2147483647>
Returns information on files for which the access counter <= the specified value.
CODED-CHARACTER-SET = *ANY / *NONE / <name 1..8>
Returns information on all files for which the specified coded character set (CCS) is entered in the catalog entry (output field COD-CH-SET if a CCS is defined; see the CREATE-FILE or MODIFY-FILE-ATTRIBUTES command for an explanation).
CODED-CHARACTER-SET = *ANY
The defined character set is not to be used as a selection criterion.
CODED-CHARACTER-SET = *NONE
Returns information on files for which no coded character set was explicitly defined.
CODED-CHARACTER-SET = <name 1..8>
Returns information on files for which the specified coded character set was defined.
SPACE-RELEASE-LOCK = *ANY / *NO / *YES
Returns information on files selected on the basis of the lock to prevent the release of unused memory space (see the SP-REL-LOCK output field).
SPACE-RELEASE-LOCK = *ANY
The permission to release unused memory space is not used as a selection criterion.
SPACE-RELEASE-LOCK = *NO
Returns information on files for which unused memory space may be released.
SPACE-RELEASE-LOCK = *YES
Returns information on files for which the release of unused memory space is not permitted.
ENCRYPTION = *ANY / list-poss(3): *NONE / *AES / *DES
Returns information on all files in accordance with the encryption method.
ENCRYPTION = *ANY
The encryption method is not a selection criterion.
ENCRYPTION = *NONE
Returns information on unencrypted files.
ENCRYPTION = *AES
Returns information on files which were encrypted using the AES method.
ENCRYPTION = *DES
Returns information on files which were encrypted using the DES method.
OUTPUT = *SYSOUT / *NONE / *SYSLST(...) / *PRINTER(...) / <filename 1..54 without-gen-vers>(...)
The OUTPUT operand defines the output medium for the current SHOW-FILE-ATTRIBUTES command. The requested information will be output in tabular format.
OUTPUT = *SYSOUT
Default value. The SHOW-FILE-ATTRIBUTES output will be routed via the SYSOUT system file, i.e. in interactive mode to the data display terminal. This is the only case where the value of the INFORMATION operand affects the type of information which is output.
OUTPUT = *NONE
Suppresses the output of information. This specification is typically useful when only the command return code is to be evaluated in a procedure.
OUTPUT = *SYSLST(...)
The outputs will be sent in tabular format to SYSLST. SYSLST is automatically output at the end of the job.
The INFORMATION operand has no effect on the type of information which is to be output to SYSLST. The output from SHOW-FILE-ATTRIBUTES is via the system file SYSLST; the format of the output will be determined by the additional specification FORM-NAME=*STD/*FILE-NAME (see below). SYSLST may be assigned (beforehand) to a temporary or a permanent file by an ASSIGN-SYSLST command.
FORM-NAME = *STD / *FILE-NAME
Output format: tabular presentation or simply file names.
FORM-NAME = *STD
The SHOW-FILE-ATTRIBUTES command outputs an edited list containing the following information:
FILENAME | File/path name |
PAM PAGES | Reserved storage space |
FREE PAGES | Reserved but unused storage space |
SEC-ALLOC | Secondary allocation |
FCBTYPE | Access method used to create the file |
SHARE | Shareable: yes/no |
ACCESS | Permissible access type: read/write |
PASSWORDS | Passwords exist: yes/no |
BKL | Backup level |
#EXT | Total number of extents for the file |
VOLUME | Volume serial number of the volume |
FORM-NAME = *FILE-NAME
The SHOW-FILE-ATTRIBUTES command outputs an unedited list (the first byte of each output record contains X’40’) of the names of the selected files, file generations and FGGs.
OUTPUT = *PRINTER(...)
Requests output on a printer in tabular format (immediate SPOOL job, output with /PRINT-DOCUMENT and operand LINE-SPACING=*BY-EBCDIC-CONTROL).
The INFORMATION operand has no effect on the type of information which is to be sent to the printer. The output from SHOW-FILE-ATTRIBUTES is routed directly to the printer; the format of the output is determined by the supplementary operand FORM-NAME=*STD/*FILE-NAME (see below).
FORM-NAME = *STD / *FILE-NAME
Output format: tabular presentation or simply file names.
FORM-NAME = *STD
The SHOW-FILE-ATTRIBUTES command outputs an edited list containing the following information:
FILENAME | File/path name |
PAM PAGES | Reserved storage space |
FREE PAGES | Reserved but unused storage space |
SEC-ALLOC | Secondary allocation |
FCBTYPE | Access method used to create the file |
SHARE | Shareable: yes/no |
ACCESS | Permissible access type: read/write |
PASSWORDS | Passwords exist: yes/no |
BKL | Backup level |
#EXT | Total number of extents for the file |
VOLUME | Volume serial number of the volume |
FORM-NAME = *FILE-NAME
The SHOW-FILE-ATTRIBUTES command outputs an unedited list (the first byte of each output record contains X’40’) of the names of the selected files, file generations and FGGs.
OUTPUT = <filename 1..54 without-gen-vers>(...)
The output is written to the specified file OUTPUT=<filename ....>, and the format of the output is specified in the following operand.
The INFORMATION operand has no effect on the type of information which is to be output to a file. If the file name specified here is identical with the file name specified at the beginning of the SHOW-FILE-ATTRIBUTES command in the FILE-NAME operand, i.e. is the same as the name of the file about which information is being requested, this file (FILE-NAME=...) will be overwritten with the information output by the SHOW-FILE-ATTRIBUTES command.
FORM-NAME = *STD / *FILE-NAME
Output format: tabular presentation or simply file names.
FORM-NAME = *STD
The SHOW-FILE-ATTRIBUTES command outputs an edited list containing the following information:
FILENAME | File/path name |
PAM PAGES | Reserved storage space |
FREE PAGES | Reserved but unused storage space |
SEC-ALLOC | Secondary allocation |
FCBTYPE | Access method used to create the file |
SHARE | Shareable: yes/no |
ACCESS | Permissible access type: read/write |
PASSWORDS | Passwords exist: yes/no |
BKL | Backup level |
#EXT | Total number of extents for the file |
VOLUME | Volume serial number of the volume |
FORM-NAME = *FILE-NAME
The SHOW-FILE-ATTRIBUTES command outputs an unedited list (the first byte of each output record contains X’40’) of the names of the selected files, file generations and FGGs.
OUTPUT-OPTIONS = *PARAMETERS(...)
SORT-LIST = *BY-FILENAME / *NO
Determines how the catalog entries/path names are sorted in the display.
SORT-LIST = *BY-FILENAME
The catalog entries/path names are sorted alphabetically.
SORT-LIST = *NO
The catalog entries/path names are displayed in the order in which they are contained in the catalog.
Return codes
(SC2) | SC1 | Maincode | Meaning/Guaranteed messages |
|---|---|---|---|
0 | CMD0001 | Command executed | |
1 | 0 | CMD0001 | Interrupted by K2 key |
2 | 0 | DMS05B6 | Invalid time conversion from UTC to LT |
2 | 0 | DMS0616 | Volume set in SM pubset might not be available |
1 | CMD0202 | Syntax or semantic error in command | |
32 | CMD2009 | Internal error during S variable generation | |
32 | DMS0584 | A state that does not allow the function to continue was reported during processing | |
32 | DMS05C7 | Unexpected internal error in DMS | |
64 | CMD0216 | Privilege errors | |
64 | DMS0501 | Requested catalog not available | |
64 | DMS0512 | Requested catalog not found | |
64 | DMS051B | Requested user ID not in pubset | |
64 | DMS051C | User not authorized to access pubset | |
64 | DMS0533 | Requested file not cataloged in pubset | |
64 | DMS0535 | Specified file not shareable | |
64 | DMS0585 | Error detected when processing catalog or multiprocessor system | |
64 | DMS0586 | It is not possible to access or reserve a volume at present | |
64 | DMS05F8 | DMS error reported | |
64 | DMS05FC | Specified user ID not in HOME pubset | |
64 | DMS0609 | No access to system file | |
64 | DMS0616 | Volume set not accessible in SM pubset | |
64 | DMS06C4 | File generation group not yet cataloged | |
64 | DMS06CC | No file corresponding to specified operands | |
64 | DMS06FF | BCAM connection severed | |
64 | OPS0001 | Space problems when generating S variables | |
64 | OPS0002 | Interrupt (e.g. by K2 key) during S variable generation | |
130 | DMS0524 | System address space exhausted | |
130 | DMS0582 | File is currently locked or being used and cannot be processed | |
130 | DMS0585 | Error detected when processing catalog or multiprocessor system | |
130 | DMS0586 | It is not possible to access or reserve a volume at present | |
130 | DMS0594 | Not enough virtual memory available |
Meanings of the output fields
n: | numeric character |
a: | alphanumeric character |
Header line
Output field | Format | Meaning | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
File size | nnnnnnnnnn[x] | 10-digit number; specifies how many PAM pages were reserved for the file; leading zeros are not displayed.
| ||||||||
:aaaa: | Specifies the catalog identifier; i.e. the ID of the pubset in which the file is cataloged | |||||||||
$userid. | User ID (max. 8 characters) of the file | |||||||||
filename | Name of the permanent or temporary file, file generation or file generation group for which information is being output |
File attributes
Output field | Values | Description |
|---|---|---|
ACC-DATE | yyyy-mm-dd | yyyy = year; mm = month; dd = day; |
ACC-TIME | hh:mm:ss | hh = hours; mm = minutes; ss = seconds; |
NONE | The file has not yet been opened or has been deleted | |
ACC-COUNT | nnnnnnnnnn | 10-digit number which specifies how often the file was accessed. Set to 0 when the file is created, and increased by 1 each time it is opened; |
ACCESS | WRITE | Write access to the file is permitted |
READ | Only read access to the file is permitted, not write access | |
ADM-INFO | aaaaaaaa | Systems support information (output only if text has been defined) |
ACL | NO | ACL protection is provided only for reasons of compatibility: the default is NO |
AUDIT | NONE | No monitoring by system exit routines or SAT is defined for the file |
ALL | All DMS actions for the file are monitored | |
SUCC | All successful DMS actions are monitored | |
FAIL | All unsuccessful DMS actions are monitored | |
AVAIL | *STD | There are no high-availability requirements for the file |
*HIGH | The file is stored on high-availability volumes | |
BACK-CLASS | A | The file is saved in each backup run |
T | The file is saved in backup runs for files with the attribute BACK-CLASS= B/C/D | |
C | The file is saved in backup runs for files with the attribute BACK-CLASS= C/D | |
D | The file is only saved in backup runs for files with the attribute BACK-CLASS= D | |
E | This file is not automatically saved by ARCHIVE | |
#BACK-VERS | nn | Maximum number of file versions in the version backup archive (the 0 value means ignoring by version backup) |
BASE-NUM | nnnnn | Only for file generation groups; 5-digit number indicating which absolute generation number is currently used as the base for relative generation numbers |
BLK-CONTR BLK-COUNT | DATA | The block control information is in the data block |
DATA (2K) | For NK2-ISAM files only: data format without key; block control information at the start of each 2K block | |
DATA (4K) | For NK4-ISAM files only: data format without key; block control information at the start of each 4K block | |
NONE | The file has not yet been opened | |
NO | The file was created without any block control information | |
PAMKEY | Block control information is in the PAM key | |
nnnnnnn | For tape files: 7-digit number indicating the number of data blocks in the file | |
BLK-OFFSET | nn | For tape files: buffer offset |
BUF-LEN | STD(1) | Standard blocks: buffer size = 1 PAM block |
STD(n) | Specifies the blocking factor (n <= 16) which has been defined for the file. | |
nnnnn | Nonstandard blocks (tape files) 6-digit number; the size of the buffer, in bytes | |
CHANG-DATE | yyyy-mm-dd | yyyy = year; mm = month; dd = day; date on which the file was last changed |
NONE | The file has not yet been opened or has been deleted using OPTION=*DATA | |
CHANG-TIME | hh:mm:ss | hh = hours; mm = minutes; ss = seconds; |
NONE | The file has not yet been opened or has been deleted using OPTION=*DATA | |
COD-CH-SET | aaaaaaaa | CCS name of the code table (output only if a code table has been defined) |
CODE | EBCDIC/ISO7/ | For tape files: specifies the code table used in creating the file |
CRE-DATE | yyyy-mm-dd | yy = year; mm = month; dd = day; |
NONE | The file has not yet been opened or has been deleted | |
CRE-TIME | hh:mm:ss | hh = hours; mm = minutes; ss = seconds; |
NONE | The file has not yet been opened or has been deleted using OPTION=*DATA | |
DEF-STO-CL | storage-class | For file generation groups only; default storage class; output only for the group entry if a storage class has been defined |
DESTROY | NO | No automatic data destruction (overwriting with X'00') |
DEVICE-TYPE | aaaaa | Specifies the device type for the volume (see device table, device type column, in section “Devicetype table”). |
DISK-WRITE | IMMEDIATE | I/O operations are written back to disk immediately |
ENCRYPTION | *NONE | No file encryption |
EXEC-PASS | NONE | No execute password is defined for the file |
EXPIR-DATE | yyyy-mm-dd | yy = year; mm = month; dd = day; |
EXPIR-TIME | hh:mm:ss | hh = hours; mm = minutes ; ss = seconds; |
EXTENTS | nnn | The number of extents for the file on the volume designated by “VSN”. |
F-PREFORM | *NONE | No preferred file format has been specified for the file |
FILE-TYPE | BS2000 | File type of a file on a Net-Storage volume: The file was created as a BS2000 file; write access is only possible from a BS2000 system |
FILE-STRUC | NONE | There is only a catalog entry for the file; the file has never been opened; storage space may have been allocated for it (see CRE-DATE) |
FILE-SEQ | nnnnn | For tape files; 5-digit number indicating the position of the file in an MF set. |
FIRST-GEN | nnnnn | Only for file generation groups; 5-digit absolute generation number of the oldest generation cataloged for this file generation group |
FREE-DEL-D | yyyy-mm-dd | yyyy = year; mm = month; dd = day; date when the file is released for deletion |
FREE-DEL-T | hh:mm:ss | hh = hours; mm = minutes; ss = seconds; |
GUARD-EXEC | guardname | Name of a GUARD that controls execute access |
GUARD-READ | guardname | Name of a GUARD that controls read access |
GUARD-WRIT | guardname | Name of a GUARD that controls write access |
GROUP | R W X | The access authorizations specified for the “GROUP” class of users |
HIGH-US-PA | nnnnnnnnnn | 10-digit number indicating the number of PAM pages occupied by the file |
IO(PERF) | STD | No special performance requirements |
IO(USAGE) | READ-WRITE | The performance requirements given in IO(PERF) are for read and write operations |
KEY-LEN | nnn | Only for ISAM files; 3-digit number indicating the length of the ISAM key in the ISAM index (in bytes). |
KEY-POS | nnnnn | Only for ISAM files; 5-digit number indicating the position of the ISAM key in the record. |
LABEL | (STD,n) | For tape files with standard labels; the interchange level for DIN 66029, and thus the labels with which the file was created. |
LAST-GEN | nnnnn | Only for file generation groups; 5-digit absolute generation number of the youngest generation cataloged for the file generation group |
LOG-FL-LEN | nnn | Only in the case of ISAM files containing a logical flag in the ISAM index. 3-digit number which specifies the length of the logical flag in the ISAM index in bytes |
MAN-CLASS | hsms-class | Name of the HSMS management class (output only if a value has been defined) |
MAXIMUM | nnnnn | Only for file generation groups: 5-digit number indicating the maximum number of generations which may be cataloged simultaneously for this file generation group |
MIGRATE | ALLOWED | File may be migrated (HSMS) |
NET-CH-SET | aaaaaaaa | CCS name of the code table for node files on Net-Storage (output only for node files) |
OWNER | R W X | The access authorizations specified for the “OWNER” class of users (the file owner and system administrator). |
OTHERS | R W X | The access authorizations specified for the “OTHERS” class of users (other users). |
OVERFL-OPT | CYCLE-REPL | Only for file generation groups; when the MAXIMUM limit is reached, the oldest file and its catalog entry are deleted |
PROPA-VAL | MIN | Only for K-ISAM files which have a value flag in the ISAM index; the lowest value flag in each data or index block is placed in the related index entry in the next higher level |
READ-PASS | NONE | No read password exists for the file |
REC-FORM | Specifies: | |
REC-SIZE | nnnnn | 5-digit number which specifies the defined length in bytes of the records in this file (for REC-FORM=F) or the maximum permissible record length (for REC-FORM=V) |
S-ALLOC | nnnnn | 5-digit number indicating the value defined for secondary allocation |
S-ALLO-NUM | nnn | 3-digit number indicating how often extra storage space was requested to extend the file (number of secondary allocations) |
S0-MIGR | *ALLOWED | Migration within the processing level (S0) is allowed |
SAVED-PAG | COMPL-FILE | Save runs with ARCHIVE always save the entire file. |
SP-REL-LOCK | NO | Storage space can be released |
STOR-CLASS | storage-class | Name of the assigned storage class (output only if a storage class has been defined) |
STOR-LEVEL | S1 / S2 | Only for migrated files (HSMS): the file has been migrated to the specified storage level, S1 or S2 |
SUPPORT | PUB | The file is stored on public volumes (pubsets) or Net-Storage volumes |
USER-ACC | OWNER-ONLY | The file is not shareable |
USER-INFO | aaaaaaaa | User information (output only if an information text has been defined) |
VAL-FL-LEN | nnn | Only for ISAM files which have a value flag in the ISAM index; 3-digit number indicating the length of the value flag in the ISAM index (in bytes). |
VERSION | 3-digit internal version number of the file; can only be interpreted/modifies by the utility routines ARCHIVE and HSMS (e.g. for an incremental save). | |
VOLUME | aaaaaa | The volume serial number (VSN) for the volume on which storage space is reserved for the file. |
WORK-FILE | *YES | The file is a work file and may if necessary be deleted by systems support |
WRITE-PASS | NONE | There is no write password for the file. |
Totals lines
Output field | Values | Description |
|---|---|---|
:catid: | :a: | Catalog ID of the pubset on which the files are cataloged. |
FRE | nnnnnnnnnn | Number of reserved but unused PAM pages on the volume. |
NET | n FILES | Number of files stored on Net-Storage volumes |
NO VSN | n FILES | Number of files which are cataloged in the named pubset and for which no volume has been assigned (with INFORMATION=*STATISTICS). |
PRDISC | n FILES | Number of files cataloged in the specified pubset which are stored on private disks. |
PRIVATE | n FILES | Number of files cataloged in the specified pubset which are stored on private disks (with INFORMATION= *STATISTICS). |
PUBLIC | n FILES | Number of files cataloged in this pubset (processing level S0). |
PUB/S1 | n FILES | Number of files cataloged in this pubset which have been migrated to storage level S1 |
PUB/S2 | n FILES | Number of files cataloged in this pubset which have been migrated to storage level S2 |
REL | nnnnnnnnnn | Number of PAM pages on the volume that could be released. |
RES | nnnnnnnnnn | Number of PAM pages reserved on the volume. |
TAPE | n FILES | Number of cataloged files stored on tape (the RES, FRE and REL fields do not appear). |
Output in S variable
The INFORMATION operand identifies the S variables which are to be created. The following specifications are possible for INFORMATION:
Notation used in command | Abbreviated form used in table |
|---|---|
INFORMATION = *ALL-ATTRIBUTES | 1 |
INFORMATION = *MINIMUM | 2 |
INFORMATION = *NAME-AND-SPACE | 3 |
INFORMATION = *PAR(ALLOCATION=YES) | 4 |
INFORMATION = *PAR(BACKUP=YES) | 5 |
INFORMATION = *PAR(HISTORY=YES) | 6 |
INFORMATION = *PAR(ORGANIZATION=YES) | 7 |
INFORMATION = *PAR(PASSWORD=YES) | 8 |
INFORMATION = *PAR(SECURITY=YES) | 9 |
INFORMATION = *SPACE-SUMMARY | 10 |
INFORMATION = *STATISTICS | 11 |
Output information | Name of the S variable | T | Contents | Condition |
|---|---|---|---|---|
Access | var(*LIST).ACCESS | S | READ | 1,9 |
Number of accesses to the file | var(*LIST).ACCESS-COUNT | I | <integer> | 1,6 |
Only provided for reasons of compatibility: the default is NO | var(*LIST).ACL | S | NO | 1,9 |
Administrator metadata | var(*LIST).ADM-INFO | S | ’’ | 1,7 |
Audit monitoring | var(*LIST).AUDIT | S | ALL | 1,9 |
Availability of the files | var(*LIST).AVAIL | S | ’’ | 1,7 |
BASIC-ACL protection active | var(*LIST).B-ACL.ACTIVE | B | FALSE | 1,9 |
GROUP execute permission (BASIC-ACL) | var(*LIST).B-ACL.GROUP.EXEC | S | ’’ | 1,9 |
GROUP read permission (BASIC-ACL) | var(*LIST).B-ACL.GROUP.READ | S | ’’ | 1,9 |
GROUP write permission (BASIC-ACL) | var(*LIST).B-ACL.GROUP.WRITE | S | ’’ | 1,9 |
OTHERS execute permission (BASIC-ACL) | var(*LIST).B-ACL.OTHERS.EXEC | S | ’’ | 1,9 |
OTHERS read permission (BASIC-ACL) | var(*LIST).B-ACL.OTHERS.READ | S | ’’ | 1,9 |
OTHERS write permission (BASIC-ACL) | var(*LIST).B-ACL.OTHERS.WRITE | S | ’’ | 1,9 |
OWNER execute permission (BASIC-ACL) | var(*LIST).B-ACL.OWNER.EXEC | S | ’’ | 1,9 |
OWNER read permission (BASIC-ACL) | var(*LIST).B-ACL.OWNER.READ | S | ’’ | 1,9 |
OWNER write permission (BASIC-ACL) | var(*LIST).B-ACL.OWNER.WRITE | S | ’’ | 1,9 |
BACKUP-CLASS level (backup frequency of the file) | var(*LIST).BACK-CL | S | A | 1,5 |
Block control information | var(*LIST).BLOCK-CONTR-INFO | S | NO | 1,7 |
Number of data blocks (tape file) | var(*LIST).BLOCK-COUNT | I | <integer> | 1,4 |
block offset (tape file) | var(*LIST).BLOCK-OFF | I | <integer> | 1,7 |
Buffer size | var(*LIST).BUF-LEN | S | ’’ | 1,7 |
Pubset catalog ID | var(*LIST).CAT-ID | S | <cat-id> | 1-9 |
Code table | var(*LIST).CODE | S | ’’ | 1,7 |
Name of the code table | var(*LIST).CODED-CHAR-SET | S | ’’ | 1,7 |
File creation date | var(*LIST).CRE-DATE | S | <yyyy-mm-dd> | 1,6 |
File creation time | var(*LIST).CRE-TIME | S | <hh:mm:ss> | 1,6 |
File deletion date | var(*LIST).DEL-DATE | S | <yyyy-mm-dd> | 1,9 |
File deletion time | var(*LIST).DEL-TIME | S | <hh:mm:ss> | 1,9 |
Destroy data on deletion | var(*LIST).DESTROY | S | NO | 1,9 |
Time of data consistency of cached write data | var(*LIST).DISK-WRITE | S | ’’ | 1,7 |
Execute password | var(*LIST).EXEC-PASS | S | NONE | 1,8,9 |
Execute password in hexadecimal | var(*LIST).EXEC-PASS-HEX | S | ’’ | 8 |
Expiration date | var(*LIST).EXPIR-DATE | S | <yyyy-mm-dd> | 1,9 |
Expiration time | var(*LIST).EXPIR-TIME | S | <hh:mm:ss> | 1,9 |
Name of the volume on which the extents of the file are located | var(*LIST).EXT(*LIST).DEV | S | ’’ | 1,4 |
Number of extents | var(*LIST).EXT(*LIST).NUM-OF-EXT | I | <integer> | 1,4 |
VSN of the volume on which the extents of the file are located | var(*LIST).EXT(*LIST).VOL | S | ’’ | 1,4 |
Type of file encryption | var(*LIST).F-ENCRYPT | S | ’’ | 1,9 |
File path name | var(*LIST).F-NAME | S | <path-name> | 1-9 |
File format | var(*LIST).F-PREFORM | S | ’’ | 1,7 |
File size | var(*LIST).F-SIZE | I | <integer> | 1-9 |
File structure (access method used to create the file) | var(*LIST).F-STRUCT | S | ’’ | 1,7 |
Position of the file in an MF set (for tape files) | var(*LIST).FILE-SEQ | I | <integer> | 1,7 |
File type of a file on a Net-Storage volume: BS2000file or node file | var(*LIST).FILE-TYPE | S | ’’ | 1,7 |
Absolute generation number(for file generation groups) | var(*LIST).GEN-PAR.BASE-NUM | I | <integer> | 1,7 |
Absolute generation number of the oldest generation in a file generation group | var(*LIST).GEN-PAR.FIRST-GEN | I | <integer> | 1,7 |
Absolute generation number of the newest generation in a file generation group | var(*LIST).GEN-PAR.LAST-GEN | I | <integer> | 1,7 |
Maximum number of generations in a file generation group | var(*LIST).GEN-PAR.MAX | I | <integer> | 1,7 |
Behavior when the maximum number of generations in a file generation group is exceeded | var(*LIST).GEN-PAR.OV-OPT | S | ’’ | 1,7 |
GUARD protection active | var(*LIST).GUARD-ACTIVE | B | FALSE | 1,9 |
Name of the guard controlling execute access | var(*LIST).GUARDS.EXEC | S | ’’ | 1,9 |
Name of the guard controlling read access | var(*LIST).GUARDS.READ | S | ’’ | 1,9 |
Name of the guard controlling write access | var(*LIST).GUARDS.WRITE | S | ’’ | 1,9 |
Number of PAM pages occupied by the file | var(*LIST).HIGHEST-USED-PAGES | I | <integer> | 1,4 |
Performance requirements for I/O operations | var(*LIST).IO-ATTR.PERF | S | ’’ | 1,7 |
Operation(s) affected by the I/O performance requirements | var(*LIST).IO-ATTR.USAGE | S | ’’ | 1,7 |
Length of ISAM key | var(*LIST).KEY-LEN | I | <integer> | 1,7 |
Position of the ISAM key in the record | var(*LIST).KEY-POS | I | <integer> | 1,7 |
Type of labels used when creating tape files | var(*LIST).LABEL | S | ’’ | 1,7 |
Date of last file access | var(*LIST).LAST-ACCESS-DATE | S | <yyyy-mm-dd> | 1,6 |
Time of last file access | var(*LIST).LAST-ACCESS-TIME | S | <hh:mm:ss> | 1,6 |
Value of last-byte pointer (LBP) | var(*LIST).LAST-BYTE | I | <integer> | 1,4 |
Validity of last-byte pointer (LBP) | var(*LIST).LAST-BYTE-VALID | B | FALSE | 1,4 |
Date of last file modification | var(*LIST).LAST-CHA-DATE | S | <yyyy-mm-dd> | 1,6 |
Time of last file modification | var(*LIST).LAST-CHA-TIME | S | <hh:mm:ss> | 1,6 |
Length of the logical flag in the ISAM index | var(*LIST).LOGIC-FLAG | I | <integer> | 1,7 |
File management class | var(*LIST).MANAGE-CLASS | S | ’’ | 1,5 |
File migration | var(*LIST).MIGRATE | S | ’’ | 1,5 |
Migration to level S1, reserved but unused storage | var(*LIST).MIGRATE-S1.FREE | I | <integer> | 10 |
Migration to level 1, number of files | var(*LIST).MIGRATE-S1.NUM-OF-F | I | <integer> | 10 |
Migration to level 1, releasable storage | var(*LIST).MIGRATE-S1.REL | I | <integer> | 10 |
Migration to level 1, reserved storage | var(*LIST).MIGRATE-S1.RESERVED | I | <integer> | 10 |
Migration to level 1, reserved storage in units of 1000 PAM pages if MIGRATE-S1.RESERVED contains the maximum value 2147483647 | var(*LIST).MIGRATE-S1.RESERVED-T | I | <integer> | 10 |
Migration to level 2, reserved but unused storage | var(*LIST).MIGRATE-S2.FREE | I | <integer> | 10 |
Migration to level 2, number of files | var(*LIST).MIGRATE-S2.NUM-OF-F | I | <integer> | 10 |
Migration to level 2,releaseable storage | var(*LIST).MIGRATE-S2.REL | I | <integer> | 10 |
Migration to level 2, reserved storage | var(*LIST).MIGRATE-S2.RESERVED | I | <integer> | 10 |
Migration to level 2, reserved storage in units of 1000 PAM pages if MIGRATE-S2.RESERVED contains the maximum value 2147483647 | var(*LIST).MIGRATE-S2.RESERVED-T | I | <integer> | 10 |
Reserved but unused storage on Net-Storage | var(*LIST).NET.FREE | I | <integer> | 10 |
Number of files on Net-Storage | var(*LIST).NET.NUM-OF-F | I | <integer> | 10 |
Releasable storage on Net-Storage | var(*LIST).NET.REL | I | <integer> | 10 |
Reserved storage on Net-Storaget | var(*LIST).NET.RESERVED | I | <integer> | 10 |
Reserved but unused storage on Net-Storage in units of 1000 PAM pages if NET.RESERVED contains the maximum value 2147483647 | var(*LIST).NET.RESERVED-T | I | <integer> | 10 |
CCS name of the code table for node files on Net-Storage (NETCCS) | var(*LIST).NET-CODED-CHAR-SET | S | ’’ | 1,7 |
Number of files on the named pubset which have not yet been assigned a volume | var(*LIST).NO-VOL.NUM-OF-F | I | <integer> | 11 |
Maximum number of file versions in the version backup archive | var(*LIST).NUM-OF-BACKUP-VERS | I | <integer> | 1,5 |
Number of extents | var(*LIST).NUM-OF-EXT | I | <integer> | 1,4 |
Printer control characters for the file | var(*LIST).PRINT-CONTR | S | ’’ | 1,7 |
Number of file generation groups on private volumes | var(*LIST).PRIV.F-GEN-GROUP | I | <integer> | 11 |
Reserved but unused storage on private volumes | var(*LIST).PRIV.FREE | I | <integer> | 10,11 |
Number of files on private volumes | var(*LIST).PRIV.NUM-OF-F | I | <integer> | 10,11 |
Releasable storage on private volumes | var(*LIST).PRIV.REL | I | <integer> | 10,11 |
Reserved storage on private volumes | var(*LIST).PRIV.RESERVED | I | <integer> | 10,11 |
Treatment of the value flag within a data or index block (for K-ISAM files) | var(*LIST).PROPA-VAL | S | ’’ | 1,7 |
Pubset catalog ID | var(*LIST).PUBSET-ID | S | <pvs-id> | 10,11 |
Number of file generation groups on the specified pubset | var(*LIST).PUBSET.F-GEN-GROUP | I | <integer> | 11 |
Reserved but unused storage on the specified pubset | var(*LIST).PUBSET.FREE | I | <integer> | 10,11 |
Number of files on the specified pubset | var(*LIST).PUBSET.NUM-OF-F | I | <integer> | 10,11 |
Releasable storage on the specified pubset | var(*LIST).PUBSET.REL | I | <integer> | 10,11 |
Reserved but unused storage on the specified pubset | var(*LIST).PUBSET.RESERVED | I | <integer> | 10,11 |
Reserved but unused storage on the specified pubset in units of 1000 PAM oages if PUBSET.RESERVED contains the maximum value 2147483647 | var(*LIST).PUBSET.RESERVED-T | I | <integer> | 10, 11 |
Read password | var(*LIST).READ-PASS | S | NONE | 1,8,9 |
Read password in hexadecimal | var(*LIST).READ-PASS-HEX | S | ’’ | 8 |
File record format | var(*LIST).REC-FORM | S | '' | 1,7 |
File record length | var(*LIST).REC-SIZE | I | <integer> | 1,7 |
Scope of backup in ARCHIVE run | var(*LIST).SAVED-PAGES | S | COMPL-FILE | 1,5 |
Secondary allocation for file extensions | var(*LIST).SEC-ALLOC | I | <integer> | 1,4 |
Number of secondary allocation requests | var(*LIST).SECONDARY-ALLOC-NUM | I | <integer> | 1,6 |
File name (excluding catalog and user ID) | var(*LIST).SHORT-F-NAME | S | <filename> | 1-9 |
S0 migration | var(*LIST).S0-MIGR | S | ’’ | 1,7 |
Release storage space | var(*LIST).SPACE-RELE-LOCK | S | ’’ | 1,9 |
File storage class | var(*LIST).STOR-CLASS | S | ’’ | 1,7 |
Hierarchical storage level | var(*LIST).STOR-LEV | S | ’’ | 1,5 |
File storage medium | var(*LIST).SUP | S | *NONE | 1,4 |
Number of files on tape | var(*LIST).TAPE.NUM-OF-F | I | <integer> | 10,11 |
File type | var(*LIST).TYPE | S | ’’ | 1,7 |
File shareability | var(*LIST).USER-ACCESS | S | ALL-USERS | 1,9 |
user ID | var(*LIST).USER-ID | S | <userid> | 1-9 |
Metadata for the file owner | var(*LIST).USER-INFO | S | ’’ | 1,7 |
Length of the value flag in the ISAM index | var(*LIST).VAL-FLAG-LEN | I | <integer> | 1,7 |
Internal version number of the file | var(*LIST).VERSION | I | <integer> | 1,5 |
Work file | var(*LIST).WORK-F | S | ’’ | 1,7 |
Write password | var(*LIST).WRITE-PASS | S | NONE | 1,8,9 |
Write password in hexadecimal | var(*LIST).WRITE-PASS-HEX | S | ’’ | 8 |
Examples
/show-file-attr
% 30 :2OS2:$USER1.AH.LIB % 3 :2OS2:$USER1.C.PROC1 % 3 :2OS2:$USER1.C.PROC2 % 6 :2OS2:$USER1.LST.ADDCMD % 3 :2OS2:$USER1.LST.BSP.2 % 333 :2OS2:$USER1.LST.DOMAIN.D % 333 :2OS2:$USER1.LST.DOMAIN.E % 24 :2OS2:$USER1.LST.HELP % 24 :2OS2:$USER1.LST.RFA.416 % 66 :2OS2:$USER1.LST.SDF.D.1 % 30 :2OS2:$USER1.LST.SDF.E % 3 :2OS2:$USER1.MAX.FILE.1 % 9 :2OS2:$USER1.MAX.FILE.10 % 12 :2OS2:$USER1.MAX.FILE.10.SORT-1 % 12 :2OS2:$USER1.MAX.FILE.10.SORT-2 % 3 :2OS2:$USER1.MAX.FILE.2 % 3 :2OS2:$USER1.MAX.FILE.3 % 9 :2OS2:$USER1.MAX.FILE.4 % 3 :2OS2:$USER1.MAX.FILE.6 % 3 :2OS2:$USER1.MAX.FILE.7 % 3 :2OS2:$USER1.MAX.FILE.9 % 0 :2OS2:$USER1.MAX.GROUP.2 (FGG) % 0 :2OS2:$USER1.MAX.GROUP.3 (FGG) % 0*:2OS2:$USER1.MAX.GROUP.4 (FGG) % :2OS2:$USER1.MAX.TAPE-FILE.1 % :2OS2:$USER1.MAX.TAPE-FILE.2 % 9 :2OS2:$USER1.PAUL.FILE.1 % 9 :2OS2:$USER1.PAUL.FILE.2 % 9 :2OS2:$USER1.PAUL.FILE.3 % 384 :2OS2:$USER1.SF.NEU % 48 :2OS2:$USER1.SF.ROBAR % 123 :2OS2:$USER1.SF.TEST.DEV.1 % 84 :2OS2:$USER1.TEST.BEISPIEL.1 % 33 :2OS2:$USER1.TEST.BEISPIEL.2 % 48 :2OS2:$USER1.TEST.BEISPIEL.3 % 3 :2OS2:$USER1.TEST.BEISPIEL.4 %:2OS2: PUBLIC: 33 FILES RES= 1665 FRE= 94 REL= 45 PAGES %:2OS2: PRDISC: 1 FILE RES= 0 FRE= 0 REL= 0 PAGES %:2OS2: TAPE : 2 FILES
The SHOW-FILE-ATTRIBUTES command without other operands lists in alphabetical order all files for the user ID USER1. The number of reserved PAM pages and the complete path name (:catid:$userid.file) is output for each file. PAM pages cannot be reserved for tape files (see MAX.TAPE-FILE.1 and MAX.TAPE-FILE.2). Files on private disk (see MAX.GROUP.4) are marked with an asterisk before the catalog ID. For all files displayed, statistics are output on the number of files and their storage space utilization per volume type.
RES shows the total of reserved PAM pages, FRE shows the total of unallocated PAM pages, REL shows the maximum number of unallocated PAM pages that can be released. The final total lines are output for each file catalog affected, i.e. per specified catalog ID (here for the default pubset of the USER1 user ID, i.e. the catalog ID 2OS2).
Example 2: Operand SORT-LIST=*NO
/show-file-attr output-opt=(sort-list=*no)
% 30 :2OS2:$USER1.AH.LIB % 24 :2OS2:$USER1.LST.HELP % 3 :2OS2:$USER1.C.PROC1 % 3 :2OS2:$USER1.C.PROC2 % 48 :2OS2:$USER1.SF.ROBAR % 384 :2OS2:$USER1.SF.NEU % 3 :2OS2:$USER1.MAX.FILE.1 % 6 :2OS2:$USER1.LST.ADDCMD % 24 :2OS2:$USER1.LST.RFA.416 % 123 :2OS2:$USER1.SF.TEST.DEV.1 % 84 :2OS2:$USER1.TEST.BEISPIEL.1 % 33 :2OS2:$USER1.TEST.BEISPIEL.2 % 48 :2OS2:$USER1.TEST.BEISPIEL.3 % 3 :2OS2:$USER1.TEST.BEISPIEL.4 % 66 :2OS2:$USER1.LST.SDF.D.1 % 30 :2OS2:$USER1.LST.SDF.E % 333 :2OS2:$USER1.LST.DOMAIN.D % 333 :2OS2:$USER1.LST.DOMAIN.E % :2OS2:$USER1.MAX.TAPE-FILE.1 % 3 :2OS2:$USER1.MAX.FILE.3 % 0 :2OS2:$USER1.MAX.GROUP.2 (FGG) % 0 :2OS2:$USER1.MAX.GROUP.3 (FGG) % 3 :2OS2:$USER1.MAX.FILE.6 % 3 :2OS2:$USER1.MAX.FILE.2 % 0*:2OS2:$USER1.MAX.GROUP.4 (FGG) % 3 :2OS2:$USER1.LST.BSP.2 % 9 :2OS2:$USER1.MAX.FILE.4 % 3 :2OS2:$USER1.MAX.FILE.7 % 3 :2OS2:$USER1.MAX.FILE.9 % 9 :2OS2:$USER1.MAX.FILE.10 % 12 :2OS2:$USER1.MAX.FILE.10.SORT-1 % 12 :2OS2:$USER1.MAX.FILE.10.SORT-2 % :2OS2:$USER1.MAX.TAPE-FILE.2 % 9 :2OS2:$USER1.PAUL.FILE.1 % 9 :2OS2:$USER1.PAUL.FILE.2 % 9 :2OS2:$USER1.PAUL.FILE.3 %:2OS2: PUBLIC: 33 FILES RES= 1665 FRE= 94 REL= 45 PAGES %:2OS2: PRDISC: 1 FILE RES= 0 FRE= 0 REL= 0 PAGES %:2OS2: TAPE : 2 FILES
The files of user ID USER1 are displayed in the sequence in which they occur in the file catalog.
Example 3: Wildcards in the file name
/show-file-attr *file.*
% 3 :2OS2:$USER1.MAX.FILE.1 % 9 :2OS2:$USER1.MAX.FILE.10 % 12 :2OS2:$USER1.MAX.FILE.10.SORT-1 % 12 :2OS2:$USER1.MAX.FILE.10.SORT-2 % 3 :2OS2:$USER1.MAX.FILE.2 % 3 :2OS2:$USER1.MAX.FILE.3 % 9 :2OS2:$USER1.MAX.FILE.4 % 3 :2OS2:$USER1.MAX.FILE.6 % 3 :2OS2:$USER1.MAX.FILE.7 % 3 :2OS2:$USER1.MAX.FILE.9 % :2OS2:$USER1.MAX.TAPE-FILE.1 % :2OS2:$USER1.MAX.TAPE-FILE.2 % 9 :2OS2:$USER1.PAUL.FILE.1 % 9 :2OS2:$USER1.PAUL.FILE.2 % 9 :2OS2:$USER1.PAUL.FILE.3 %:2OS2: PUBLIC: 13 FILES RES= 87 FRE= 41 REL= 27 PAGES %:2OS2: TAPE : 2 FILES
The symbol * replaces any character string before and after the character string FILE., i.e. all files are listed whose file name includes the character sequence FILE.’. Any character string can occur before FILE. (even an empty string) and there is at least one character after FILE. (an empty character string is not possible because the file name cannot end with a period).
Note
The wildcard * at the start of a wildcard character string must be doubled if at least one other character follows and no other wildcard is used. Example: all names ending in ABC are searched for with **ABC.
/show-file-attr max*
% 3 :2OS2:$USER1.MAX.FILE.1 % 9 :2OS2:$USER1.MAX.FILE.10 % 12 :2OS2:$USER1.MAX.FILE.10.SORT-1 % 12 :2OS2:$USER1.MAX.FILE.10.SORT-2 % 3 :2OS2:$USER1.MAX.FILE.2 % 3 :2OS2:$USER1.MAX.FILE.3 % 9 :2OS2:$USER1.MAX.FILE.4 % 3 :2OS2:$USER1.MAX.FILE.6 % 3 :2OS2:$USER1.MAX.FILE.7 % 3 :2OS2:$USER1.MAX.FILE.9 % 0 :2OS2:$USER1.MAX.GROUP.2 (FGG) % 0 :2OS2:$USER1.MAX.GROUP.3 (FGG) % 0*:2OS2:$USER1.MAX.GROUP.4 (FGG) % :2OS2:$USER1.MAX.TAPE-FILE.1 % :2OS2:$USER1.MAX.TAPE-FILE.2 %:2OS2: PUBLIC: 12 FILES RES= 60 FRE= 33 REL= 24 PAGES %:2OS2: PRDISC: 1 FILE RES= 0 FRE= 0 REL= 0 PAGES %:2OS2: TAPE : 2 FILES
All files whose name starts in MAX and ends in any character string (including an empty string) are listed.
/show-file-attr max.file.
% 3 :2OS2:$USER1.MAX.FILE.1 % 9 :2OS2:$USER1.MAX.FILE.10 % 12 :2OS2:$USER1.MAX.FILE.10.SORT-1 % 12 :2OS2:$USER1.MAX.FILE.10.SORT-2 % 3 :2OS2:$USER1.MAX.FILE.2 % 3 :2OS2:$USER1.MAX.FILE.3 % 9 :2OS2:$USER1.MAX.FILE.4 % 3 :2OS2:$USER1.MAX.FILE.6 % 3 :2OS2:$USER1.MAX.FILE.7 % 3 :2OS2:$USER1.MAX.FILE.9 %:2OS2: PUBLIC: 10 FILES RES= 60 FRE= 33 REL= 24 PAGES
All files which can be accessed on a partially qualified basis with the first name section MAX.FILE., i.e. whose name starts with MAX.FILE. and contains at least one character after this.
/show-file-attr file-name=//.
% 30 :2OS2:$USER1.AH.LIB % 384 :2OS2:$USER1.SF.NEU % 48 :2OS2:$USER1.SF.ROBAR % 123 :2OS2:$USER1.SF.TEST.DEV.1 %:2OS2: PUBLIC: 4 FILES RES= 585 FRE= 30 REL= 9 PAGES
The character / stands for any individual character. All the user’s files are listed whose name starts with a character string of any two characters and a period (partially qualified).
/show-file-attr m*1
% 3 :2OS2:$USER1.MAX.FILE.1 % 12 :2OS2:$USER1.MAX.FILE.10.SORT-1 % :2OS2:$USER1.MAX.TAPE-FILE.1 %:2OS2: PUBLIC: 2 FILES RES= 15 FRE= 10 REL= 9 PAGES %:2OS2: TAPE : 1 FILE
All the user’s files are listed whose name starts in M and ends with 1. Any character string (including an empty string) can occur in between.
/show-file-attr file-name=//////
% 30 :2OS2:$USER1.AH.LIB % 384 :2OS2:$USER1.SF.NEU %:2OS2: PUBLIC: 2 FILES RES= 414 FRE= 13 REL= 6 PAGES
All the user’s files are listed whose name starts with any six particular characters.
/show-file-attr file-name=*
% 30 :2OS2:$USER1.AH.LIB % 3 :2OS2:$USER1.C.PROC1 % 3 :2OS2:$USER1.C.PROC2 % 6 :2OS2:$USER1.LST.ADDCMD % 3 :2OS2:$USER1.LST.BSP.2 % 333 :2OS2:$USER1.LST.DOMAIN.D % 333 :2OS2:$USER1.LST.DOMAIN.E % 24 :2OS2:$USER1.LST.HELP % 24 :2OS2:$USER1.LST.RFA.416 % 66 :2OS2:$USER1.LST.SDF.D.1 % 30 :2OS2:$USER1.LST.SDF.E % 3 :2OS2:$USER1.MAX.FILE.1 % 9 :2OS2:$USER1.MAX.FILE.10 % 12 :2OS2:$USER1.MAX.FILE.10.SORT-1 % 12 :2OS2:$USER1.MAX.FILE.10.SORT-2 % 3 :2OS2:$USER1.MAX.FILE.2 % 3 :2OS2:$USER1.MAX.FILE.3 % 9 :2OS2:$USER1.MAX.FILE.4 % 3 :2OS2:$USER1.MAX.FILE.6 % 3 :2OS2:$USER1.MAX.FILE.7 % 3 :2OS2:$USER1.MAX.FILE.9 % 0 :2OS2:$USER1.MAX.GROUP.2 (FGG) % 0 :2OS2:$USER1.MAX.GROUP.3 (FGG) % 0*:2OS2:$USER1.MAX.GROUP.4 (FGG) % :2OS2:$USER1.MAX.TAPE-FILE.1 % :2OS2:$USER1.MAX.TAPE-FILE.2 % 9 :2OS2:$USER1.PAUL.FILE.1 % 9 :2OS2:$USER1.PAUL.FILE.2 % 9 :2OS2:$USER1.PAUL.FILE.3 % 384 :2OS2:$USER1.SF.NEU % 48 :2OS2:$USER1.SF.ROBAR % 123 :2OS2:$USER1.SF.TEST.DEV.1 % 84 :2OS2:$USER1.TEST.BEISPIEL.1 % 33 :2OS2:$USER1.TEST.BEISPIEL.2 % 48 :2OS2:$USER1.TEST.BEISPIEL.3 % 3 :2OS2:$USER1.TEST.BEISPIEL.4 %:2OS2: PUBLIC: 33 FILES RES= 1665 FRE= 94 REL= 45 PAGES %:2OS2: PRDISC: 1 FILE RES= 0 FRE= 0 REL= 0 PAGES %:2OS2: TAPE : 2 FILES
All the user’s files are listed. The character * stands for ant character string. Output corresponds to the default output with the presetting FILE-NAME=*ALL.
Example 4: Partial qualification
/show-file-attr file-name=paul.
% 9 :2OS2:$USER1.PAUL.FILE.1 % 9 :2OS2:$USER1.PAUL.FILE.2 % 9 :2OS2:$USER1.PAUL.FILE.3 %:2OS2: PUBLIC: 3 FILES RES= 27 FRE= 8 REL= 3 PAGES
All the user’s files are listed which can be accessed with the partial qualification PAUL.
Example 5: Catalog entry of a temporary file
/show-file-attr file-name=# ———————————————————————————————————————
% DMS0533 REQUESTED FILE NOT CATALOGED IN PUBSET '2OS2'. COMMAND TERMINATED
/cre-file #hugo.1 —————————————————————————————————————————————————
/copy-file from-file=lst.addcmd,to-file=#hugo.lst.addcmd —————————
/show-file-attr # —————————————————————————————————————————————————
% 6 :2OS2:$USER1.S.152.2B4Z.HUGO.LST.ADDCMD % 3 :2OS2:$USER1.S.152.2B4Z.HUGO.1 %:2OS2: PUBLIC: 2 FILES RES= 9 FRE= 4 REL= 3 PAGES
/show-file-attr #*cmd,inf=all —————————————————————————————————————
%0000000006 :2OS2:$USER1.S.152.2B4Z.HUGO.LST.ADDCMD % ------------------------------- HISTORY ------------------------------- % CRE-DATE = 2014-07-02 ACC-DATE = 2014-07-02 CHANG-DATE = 2014-07-02 % CRE-TIME = 17:52:52 ACC-TIME = 17:52:59 CHANG-TIME = 17:52:52 % ACC-COUNT = 1 S-ALLO-NUM = 0 % ------------------------------- SECURITY ------------------------------- % READ-PASS = NONE WRITE-PASS = NONE EXEC-PASS = NONE % USER-ACC = OWNER-ONLY ACCESS = WRITE ACL = NO % AUDIT = NONE FREE-DEL-D = *NONE EXPIR-DATE = 2014-07-02 % DESTROY = NO FREE-DEL-T = *NONE EXPIR-TIME = 00:00:00 % SP-REL-LOCK= NO ENCRYPTION = *NONE % ------------------------------- BACKUP ------------------------------- % BACK-CLASS = E SAVED-PAG = COMPL-FILE VERSION = 1 % MIGRATE = INHIBITED % #BACK-VERS = 0 % ------------------------------- ORGANIZATION ------------------------------- % FILE-STRUC = SAM BUF-LEN = STD(1) BLK-CONTR = PAMKEY % IO(USAGE) = READ-WRITE IO(PERF) = STD DISK-WRITE = BY-CLOSE % REC-FORM = (V,M) REC-SIZE = 0 % AVAIL = *STD % ------------------------------- ALLOCATION ------------------------------- % SUPPORT = PUB S-ALLOC = 24 HIGH-US-PA = 5 % EXTENTS VOLUME DEVICE-TYPE EXTENTS VOLUME DEVICE-TYPE % 1 2OS2.6 D3435 % NUM-OF-EXT = 1 %:2OS2: PUBLIC: 1 FILE RES= 6 FRE= 1 REL= 0 PAGES
(1) | All temporary files will be listed (tempfile prefix is set with #). Message DMS0533 shows that no temporary files exist for the task. |
(2) | CREATE-FILE creates the catalog entry for the temporary file #HUGO.1. |
(3) | COPY-FILE copies the file LST.ADDCMD into temporary file #HUGO.LST.ADDCMD, which is thereby created. |
(4) | SHOW-FILE-ATTRIBUTES for all temporary files of the task (FILE-NAME=#) shows the names of the temporary files created. Instead of the tempfile character, with which the user can access the files, the internal name section created by the system is output (here S.152.2B4Z.). |
(5) | Outputs the full catalog entry for all temporary files whose name ends with the character string CMD. |
Example 6a: Output with INFORMATION=*SPACE-SUMMARY
/show-file-attr file-name=max.,inf=*space-summary
%:2OS2: PUBLIC: 22 FILES RES= 180 FRE= 153 REL= 144 PAGES %:2OS2: PRDISC: 5 FILES RES= 12 FRE= 12 REL= 0 PAGES %:2OS2: TAPE : 2 FILES
Information is output for all the user’s files whose name starts with MAX.
Example 6b: Output with INFORMATION=*PAR(PASSWORDS=*YES)
/sh-f-attr file-name=<ah,sf>.,inf=(passwords=*yes)
%0000000030 :2OS2:$USER1.AH.LIB % ------------------------------- PASSWORDS ------------------------------- % READ-PASS = YES WRITE-PASS = NONE EXEC-PASS = NONE %0000000384 :2OS2:$USER1.SF.NEU % ------------------------------- PASSWORDS ------------------------------- % READ-PASS = NONE WRITE-PASS = NONE EXEC-PASS = NONE %0000000048 :2OS2:$USER1.SF.ROBAR % ------------------------------- PASSWORDS ------------------------------- % READ-PASS = NONE WRITE-PASS = NONE EXEC-PASS = NONE %0000000123 :2OS2:$USER1.SF.TEST.DEV.1 % ------------------------------- PASSWORDS ------------------------------- % READ-PASS = NONE WRITE-PASS = NONE EXEC-PASS = NONE %:2OS2: PUBLIC: 4 FILES RES= 585 FRE= 30 REL= 9 PAGES
Output is for all the user’s files whose name starts with one of the character strings AH or SF and a period.
Example 6c: Output with INFORMATION=*MINIMUM
/show-file-attr inf=*minimum
%P YNN NW 30 :2OS2:$USER1.AH.LIB %S NNN NW 3 :2OS2:$USER1.C.PROC1 %S NNN NW 3 :2OS2:$USER1.C.PROC2 %S NNN NW 6 :2OS2:$USER1.LST.ADDCMD %S NNN NW 3 :2OS2:$USER1.LST.BSP.2 %S NNN NW 333 :2OS2:$USER1.LST.DOMAIN.D %S NNN NW 333 :2OS2:$USER1.LST.DOMAIN.E %S NNN NW 24 :2OS2:$USER1.LST.HELP %S NNN NW 24 :2OS2:$USER1.LST.RFA.416 %S NNN NW 66 :2OS2:$USER1.LST.SDF.D.1 %S NNN NW 30 :2OS2:$USER1.LST.SDF.E %N NNN NW 3 :2OS2:$USER1.MAX.FILE.1 %S NNN NW 9 :2OS2:$USER1.MAX.FILE.10 %S NNN NW 12 :2OS2:$USER1.MAX.FILE.10.SORT-1 %S NNN NW 12 :2OS2:$USER1.MAX.FILE.10.SORT-2 %S NNN NW 3 :2OS2:$USER1.MAX.FILE.2 %N NNN GUARDS 3 :2OS2:$USER1.MAX.FILE.3 %I NNN NW 9 :2OS2:$USER1.MAX.FILE.4 %N NNN NW 3 :2OS2:$USER1.MAX.FILE.6 %I NNN NW 3 :2OS2:$USER1.MAX.FILE.7 %I NNN NW 3 :2OS2:$USER1.MAX.FILE.9 %N YNN NW 0 :2OS2:$USER1.MAX.GROUP.2 (FGG) %N NNN NW 0 :2OS2:$USER1.MAX.GROUP.3 (FGG) %N NNN NW 0*:2OS2:$USER1.MAX.GROUP.4 (FGG) %S NNN YW :2OS2:$USER1.MAX.TAPE-FILE.1 %S NNN YW :2OS2:$USER1.MAX.TAPE-FILE.2 %I NNN NW 9 :2OS2:$USER1.PAUL.FILE.1 %I NNN GUARDS 9 :2OS2:$USER1.PAUL.FILE.2 %S NNN NW 9 :2OS2:$USER1.PAUL.FILE.3 %I NNN NW 384 :2OS2:$USER1.SF.NEU %I NNN NW 48 :2OS2:$USER1.SF.ROBAR %I NNN NW 123 :2OS2:$USER1.SF.TEST.DEV.1 %I NNN NW 84 :2OS2:$USER1.TEST.BEISPIEL.1 %I NNN NW 33 :2OS2:$USER1.TEST.BEISPIEL.2 %S NNN NW 48 :2OS2:$USER1.TEST.BEISPIEL.3 %S NNN NW 3 :2OS2:$USER1.TEST.BEISPIEL.4
Information is output for all the user’s files.
Example 6d: Output with INFORMATION=*STATISTICS
/show-file-attr inf=*statistics
% FILES %:2OS2: PUBLIC: 31 FILES RES= 1665 FRE= 94 REL= 45 PAGES %:2OS2: TAPE : 2 FILES % FILE GENERATIONGROUPS %:2OS2: PUBLIC: 2 FILES %:2OS2: PRIVAT: 1 FILE
Information is output for all the user’s files.
Example 6e: Output with INFORMATION=*PAR(SECURITY=*YES)
/show-file-attr max.file.<1:3>,inf=(security=*yes)
%0000000003 :2OS2:$USER1.MAX.FILE.1 % ------------------------------- SECURITY ------------------------------- % READ-PASS = NONE WRITE-PASS = NONE EXEC-PASS = NONE % USER-ACC = OWNER-ONLY ACCESS = WRITE ACL = NO % AUDIT = NONE FREE-DEL-D = *NONE EXPIR-DATE = NONE % DESTROY = NO FREE-DEL-T = *NONE EXPIR-TIME = NONE % SP-REL-LOCK= NO ENCRYPTION = *NONE %0000000003 :2OS2:$USER1.MAX.FILE.2 % ------------------------------- SECURITY ------------------------------- % READ-PASS = NONE WRITE-PASS = NONE EXEC-PASS = NONE % USER-ACC = OWNER-ONLY ACCESS = WRITE ACL = NO % AUDIT = NONE DESTROY = NO EXPIR-DATE = 2014-02-02 % SP-REL-LOCK= NO EXPIR-TIME = 00:00:00 % AUDIT = NONE FREE-DEL-D = *NONE EXPIR-DATE = 2014-02-02 % DESTROY = NO FREE-DEL-T = *NONE EXPIR-TIME = 00:00:00 % SP-REL-LOCK= NO ENCRYPTION = *NONE %0000000003 :2OS2:$USER1.MAX.FILE.3 % ------------------------------- SECURITY ------------------------------- % READ-PASS = NONE WRITE-PASS = NONE EXEC-PASS = NONE % USER-ACC = OWNER-ONLY ACCESS = WRITE ACL = NO % OWNER = R W X GROUP = - - - OTHERS = - - - % AUDIT = NONE FREE-DEL-D = *NONE EXPIR-DATE = NONE % DESTROY = NO FREE-DEL-T = *NONE EXPIR-TIME = NONE % SP-REL-LOCK= NO ENCRYPTION = *NONE % GUARD-READ = $USER1.PROT-A01 % GUARD-WRIT = $USER1.PROT-A01 % GUARD-EXEC = NONE %:2OS2: PUBLIC: 3 FILES RES= 9 FRE= 8 REL= 6 PAGES
Information is output for all the user’s files whose name starts with the character string MAX.FILE. and ends with one of the subsequent characters 1, 2 or 3.
Example 6f: Output with INFORMATION=*PAR(HISTORY=*YES)
/show-file-attr sf.,inf=(history=*yes)
%0000000384 :2OS2:$USER1.SF.NEU % ------------------------------- HISTORY ------------------------------- % CRE-DATE = 2014-07-22 ACC-DATE = 2014-07-30 CHANG-DATE = 2014-07-24 % CRE-TIME = 18:59:58 ACC-TIME = 13:37:48 CHANG-TIME = 10:17:48 % ACC-COUNT = 4 S-ALLO-NUM = 0 %0000000048 :2OS2:$USER1.SF.ROBAR % ------------------------------- HISTORY ------------------------------- % CRE-DATE = 2014-05-20 ACC-DATE = 2014-05-20 CHANG-DATE = NONE % CRE-TIME = 01:00:00 ACC-TIME = 01:00:00 CHANG-TIME = NONE % ACC-COUNT = 1 S-ALLO-NUM = 0 %0000000123 :2OS2:$USER1.SF.TEST.DEV.1 % ------------------------------- HISTORY ------------------------------- % CRE-DATE = 2014-06-30 ACC-DATE = 2014-06-30 CHANG-DATE = 2014-06-30 % CRE-TIME = 17:42:51 ACC-TIME = 18:06:20 CHANG-TIME = 17:42:54 % ACC-COUNT = 3 S-ALLO-NUM = 0 %:2OS2: PUBLIC: 3 FILES RES= 555 FRE= 24 REL= 3 PAGES
Information is output for all the user’s files whose name begins with the character string SF.
Example 6g: Output with INFORMATION=*PAR(ALLOCATION=*YES)
/show-file-attr file-name=**.4,inf=(allocation=*yes)
%0000000009 :2OS2:$USER1.MAX.FILE.4 % ------------------------------- ALLOCATION ------------------------------- % SUPPORT = PUB S-ALLOC = 9 HIGH-US-PA = 7 % EXTENTS VOLUME DEVICE-TYPE EXTENTS VOLUME DEVICE-TYPE % 1 2OS2.A D3435 % NUM-OF-EXT = 1 %0000000000*:2OS2:$USER1.MAX.GROUP.4 (FGG) %0000000003 :2OS2:$USER1.TEST.BEISPIEL.4 % ------------------------------- ALLOCATION ------------------------------- % SUPPORT = PUB S-ALLOC = 18 HIGH-US-PA = 3 % EXTENTS VOLUME DEVICE-TYPE EXTENTS VOLUME DEVICE-TYPE % 1 2OS2.H D3435 % NUM-OF-EXT = 1 %:2OS2: PUBLIC: 2 FILES RES= 12 FRE= 2 REL= 0 PAGES %:2OS2: PRDISC: 1 FILE RES= 0 FRE= 0 REL= 0 PAGES
Information is output for all the user’s files whose name starts with a particular character string (including an empty one) and ends with the character string .4.
Example 6h: Output with INFORMATION=*PAR(BACKUP=*YES)
/show-file-attr file-name=*.10.*,inf=(backup=*yes)
%0000000012 :2OS2:$USER1.MAX.FILE.10.SORT-1 % ------------------------------- BACKUP ------------------------------- % BACK-CLASS = A SAVED-PAG = COMPL-FILE VERSION = 1 % MIGRATE = ALLOWED % #BACK-VERS = 2 %0000000012 :2OS2:$USER1.MAX.FILE.10.SORT-2 % ------------------------------- BACKUP ------------------------------- % BACK-CLASS = A SAVED-PAG = COMPL-FILE VERSION = 1 % MIGRATE = ALLOWED % #BACK-VERS = 2 %0000000006 :2OS2:$USER1.SYSTEMPASS.VTSU-B.10.1A.19941119 % ------------------------------- BACKUP ------------------------------- % BACK-CLASS = A SAVED-PAG = COMPL-FILE VERSION = 1 % MIGRATE = ALLOWED % #BACK-VERS = 2 %:2OS2: PUBLIC: 3 FILES RES= 30 FRE= 17 REL= 15 PAGES
Information is output for all the user’s files whose name contains the character string “.10.”. and at least one character must precede or follow this.
Example 6i: Output with INFORMATION=*PAR(ORGANIZATION=*YES)
/show-file-attr file-name=max.*file.2,inf=(organization=*yes)
%0000000003 :2OS2:$USER1.MAX.FILE.2 % ------------------------------- ORGANIZATION ------------------------------- % FILE-STRUC = SAM BUF-LEN = STD(1) BLK-CONTR = PAMKEY % IO(USAGE) = READ-WRITE IO(PERF) = STD DISK-WRITE = IMMEDIATE % REC-FORM = (V,N) REC-SIZE = 0 % AVAIL = *STD % :2OS2:$USER1.MAX.TAPE-FILE.2 % ------------------------------- ORGANIZATION ------------------------------- % FILE-STRUC = SAM BUF-LEN = STD(1) BLK-CONTR = PAMKEY % REC-FORM = (V,M) REC-SIZE = 2044 % CODE = EBCDIC LABEL = (STD,1) FILE-SEQ = 2 % BLK-OFFSET = 4 %:2OS2: PUBLIC: 1 FILE RES= 3 FRE= 2 REL= 0 PAGES %:2OS2: TAPE : 1 FILE
Information is output for all the user’s files whose name starts with the character string MAX. and ends with FILE.2.
Example 7: Selection of files for which particular attributes apply
/show-file-attr select=(password=*read-pass)
% 30 :2OS2:$USER1.AH.LIB % 0 :2OS2:$USER1.MAX.GROUP.2 (FGG) %:2OS2: PUBLIC: 2 FILES RES= 30 FRE= 6 REL= 6 PAGES
All the user’s files are listed whose name is protected with a read password.
/show-file-attr select=(status=(closed-output=*no))
% 3 :2OS2:$USER1.LST.BSP.2 %:2OS2: PUBLIC: 1 FILE RES= 3 FRE= 2 REL= 0 PAGES
All the user’s files are listed which are open for writing at the time the command is issued.
/show-file-attr select=(support=(*priv,*tape))
% 0*:2OS2:$USER1.MAX.GROUP.4 (FGG) % :2OS2:$USER1.MAX.TAPE-FILE.1 % :2OS2:$USER1.MAX.TAPE-FILE.2 %:2OS2: PRDISC: 1 FILE RES= 0 FRE= 0 REL= 0 PAGES %:2OS2: TAPE : 2 FILES
All the user’s files are listed which are stored on private disks or on tapes.
/show-file-attr select=(support=*priv,generation=*yes)
% 3*:2OS2:$USER1.MAX.GROUP.1(*0004) % 0*:2OS2:$USER1.MAX.GROUP.4 (FGG) % 3*:2OS2:$USER1.MAX.GROUP.4(*0002) % 3*:2OS2:$USER1.MAX.GROUP.4(*0003) % 3*:2OS2:$USER1.MAX.GROUP.4(*0004) %:2OS2: PRDISC: 5 FILES RES= 12 FRE= 12 REL= 0 PAGES
All the user’s files are listed which are stored on private disks. For file generation groups, the generations will also be output.
/show-file-attr select=(size=*int(100,400))
% 333 :2OS2:$USER1.LST.DOMAIN.D % 333 :2OS2:$USER1.LST.DOMAIN.E % 384 :2OS2:$USER1.SF.NEU % 123 :2OS2:$USER1.SF.TEST.DEV.1 %:2OS2: PUBLIC: 4 FILES RES= 1173 FRE= 19 REL= 3 PAGES
All the user’s files are listed which occupy between 100 and 400 PAM pages.
/show-file-attr select=(num-of-free=10)
% 24 :2OS2:$USER1.LST.HELP % 123 :2OS2:$USER1.SF.TEST.DEV.1 %:2OS2: PUBLIC: 2 FILES RES= 147 FRE= 20 REL= 12 PAGES
All the user’s files are listed where exactly ten of the reserved PAM pages are not occupied.
/show-file-attr select=(acc-count=2)
% 24 :2OS2:$USER1.LST.HELP % 66 :2OS2:$USER1.LST.SDF.D.1 % 30 :2OS2:$USER1.LST.SDF.E % 3 :2OS2:$USER1.MAX.FILE.7 %:2OS2: PUBLIC: 4 FILES RES= 123 FRE= 12 REL= 9 PAGES
All the user’s files are listed which have been accessed exactly twice since the catalog entry was created.
/show-file-attr select=(last-acc-date=*today(time=(8:00,10:00)))
% 3 :2OS2:$USER1.LST.BSP.2 %:2OS2: PUBLIC: 1 FILE RES= 3 FRE= 2 REL= 0 PAGES
All the user’s files are listed which were last accessed between 8 and 10 a.m. on the day the command was issued.
/show-file-attr select=(prot-active=*level-2)
% 3 :2OS2:$USER1.MAX.FILE.3 % 9 :2OS2:$USER1.PAUL.FILE.2 %:2OS2: PUBLIC: 2 FILES RES= 12 FRE= 5 REL= 3 PAGES
All the user’s files are listed where access control is with GUARDS.
/show-file-attr select=(prot-active=*level-1)
% DMS06CC NO FILE CORRESPONDING TO SPECIFIED OPERANDS
All the user’s files are listed where access control is with BASIC-ACL. The files MAX.FILE.3 and PAUL.FILE.2 have a BASIC-ACL entry but access control is via GUARDS (see the following output).
/show-file-attr select=(basic-acl=*yes)
% 3 :2OS2:$USER1.MAX.FILE.3 % 9 :2OS2:$USER1.PAUL.FILE.2 %:2OS2: PUBLIC: 2 FILES RES= 12 FRE= 5 REL= 3 PAGES
All the user’s files which have a BASIC-ACL entry are listed.
/show-file-attr select=(type=(*plam,*file-group))
% 30 :2OS2:$USER1.AH.LIB % 0 :2OS2:$USER1.MAX.GROUP.2 (FGG) % 0 :2OS2:$USER1.MAX.GROUP.3 (FGG) % 0*:2OS2:$USER1.MAX.GROUP.4 (FGG) %:2OS2: PUBLIC: 3 FILES RES= 30 FRE= 6 REL= 6 PAGES %:2OS2: PRDISC: 1 FILE RES= 0 FRE= 0 REL= 0 PAGES
All the user’s file generation groups and PLAM libraries are listed.
/show-file-attr select=(support=*priv,type=*file-group,generation=*yes)
% 3*:2OS2:$USER1.MAX.GROUP.1(*0004) % 0*:2OS2:$USER1.MAX.GROUP.4 (FGG) % 3*:2OS2:$USER1.MAX.GROUP.4(*0002) % 3*:2OS2:$USER1.MAX.GROUP.4(*0003) % 3*:2OS2:$USER1.MAX.GROUP.4(*0004) %:2OS2: PRDISC: 5 FILES RES= 12 FRE= 12 REL= 0 PAGES
All the user’s file generation groups with generations are listed that are stored on private disks.
Example 8: File generation groups/file generations
Example 8a: List of all cataloged file generation groups with generations
/show-file-attr select=(type=*file-group)
% 0 :2OS2:$USER1.MAX.GROUP.2 (FGG) % 0 :2OS2:$USER1.MAX.GROUP.3 (FGG) % 0*:2OS2:$USER1.MAX.GROUP.4 (FGG) %:2OS2: PUBLIC: 2 FILES RES= 0 FRE= 0 REL= 0 PAGES %:2OS2: PRDISC: 1 FILE RES= 0 FRE= 0 REL= 0 PAGES
All the user’s file generation groups are listed.
Example 8b: List of all cataloged file generation groups with generations
/show-file-attr select=(type=*file-group,gen=*yes)
% 3*:2OS2:$USER1.MAX.GROUP.1(*0004) % 0 :2OS2:$USER1.MAX.GROUP.2 (FGG) % 3 :2OS2:$USER1.MAX.GROUP.2(*0011) % 93 :2OS2:$USER1.MAX.GROUP.2(*0012) % 3 :2OS2:$USER1.MAX.GROUP.2(*0013) % 0 :2OS2:$USER1.MAX.GROUP.3 (FGG) % 3 :2OS2:$USER1.MAX.GROUP.3(*0001) % 3 :2OS2:$USER1.MAX.GROUP.3(*0002) % 3 :2OS2:$USER1.MAX.GROUP.3(*0003) % 3 :2OS2:$USER1.MAX.GROUP.3(*0004) % 3 :2OS2:$USER1.MAX.GROUP.3(*0005) % 3 :2OS2:$USER1.MAX.GROUP.3(*0006) % 3 :2OS2:$USER1.MAX.GROUP.3(*0007) % 0*:2OS2:$USER1.MAX.GROUP.4 (FGG) % 3*:2OS2:$USER1.MAX.GROUP.4(*0002) % 3*:2OS2:$USER1.MAX.GROUP.4(*0003) % 3*:2OS2:$USER1.MAX.GROUP.4(*0004) %:2OS2: PUBLIC: 12 FILES RES= 120 FRE= 120 REL= 120 PAGES %:2OS2: PRDISC: 5 FILES RES= 12 FRE= 12 REL= 0 PAGES
All the user’s file generation groups with generations are listed.
Example 8c: Complete catalog entries of a public FGG
/show-file-attr max.group.2,inf=*all,select=(gen=*yes)
%0000000000 :2OSG:$USERXY01.MAX.GROUP.2 (FGG) % ------------------------------- HISTORY ------------------------------- % CRE-DATE = 2014-11-21 ACC-DATE = NONE CHANG-DATE = NONE % CRE-TIME = 17:31:03 ACC-TIME = NONE CHANG-TIME = NONE % ACC-COUNT = 0 S-ALLO-NUM = 0 % ------------------------------- SECURITY ------------------------------- % READ-PASS = YES WRITE-PASS = NONE EXEC-PASS = NONE % USER-ACC = OWNER-ONLY ACCESS = WRITE ACL = NO % AUDIT = NONE FREE-DEL-D = *NONE EXPIR-DATE = 2014-11-21 % DESTROY = NO FREE-DEL-T = *NONE EXPIR-TIME = 00:00:00 % SP-REL-LOCK= NO ENCRYPTION = *NONE % ------------------------------- BACKUP ------------------------------- % BACK-CLASS = A SAVED-PAG = COMPL-FILE VERSION = 0 % MIGRATE = ALLOWED % #BACK-VERS = 0 % ------------------------------- GENERATION-INFO ---------------------------- % MAXIMUM = 3 BASE-NUM = 11 OVERFL-OPT = CYCL-REPL % FIRST-GEN = 11 LAST-GEN = 13 %0000000009 :2OSG:$USERXY01.MAX.GROUP.2(*0011) % ------------------------------- HISTORY ------------------------------- % CRE-DATE = NONE ACC-DATE = NONE CHANG-DATE = NONE % CRE-TIME = NONE ACC-TIME = NONE CHANG-TIME = NONE % ACC-COUNT = 0 S-ALLO-NUM = 0 % ------------------------------- SECURITY ------------------------------- % READ-PASS = YES WRITE-PASS = NONE EXEC-PASS = NONE % USER-ACC = OWNER-ONLY ACCESS = WRITE ACL = NO % AUDIT = NONE FREE-DEL-D = *NONE EXPIR-DATE = NONE % DESTROY = NO FREE-DEL-T = *NONE EXPIR-TIME = NONE % SP-REL-LOCK= NO ENCRYPTION = *NONE % ------------------------------- BACKUP ------------------------------- % BACK-CLASS = A SAVED-PAG = COMPL-FILE VERSION = 0 % MIGRATE = ALLOWED % #BACK-VERS = 0 % ------------------------------- ORGANIZATION ------------------------------- % FILE-STRUC = NONE BUF-LEN = NONE BLK-CONTR = NONE % IO(USAGE) = READ-WRITE IO(PERF) = STD DISK-WRITE = IMMEDIATE % REC-FORM = NONE REC-SIZE = 0 % AVAIL = *STD % ------------------------------- ALLOCATION ------------------------------- % SUPPORT = PUB S-ALLOC = 9 HIGH-US-PA = 0 % EXTENTS VOLUME DEVICE-TYPE EXTENTS VOLUME DEVICE-TYPE % 1 2OSG.5 D3435 % NUM-OF-EXT = 1 %0000000009 :2OSG:$USERXY01.MAX.GROUP.2(*0012) % ------------------------------- HISTORY ------------------------------- % CRE-DATE = NONE ACC-DATE = NONE CHANG-DATE = NONE % CRE-TIME = NONE ACC-TIME = NONE CHANG-TIME = NONE % ACC-COUNT = 0 S-ALLO-NUM = 0 % ------------------------------- SECURITY ------------------------------- % READ-PASS = YES WRITE-PASS = NONE EXEC-PASS = NONE % USER-ACC = OWNER-ONLY ACCESS = WRITE ACL = NO % AUDIT = NONE FREE-DEL-D = *NONE EXPIR-DATE = NONE % DESTROY = NO FREE-DEL-T = *NONE EXPIR-TIME = NONE % SP-REL-LOCK= NO ENCRYPTION = *NONE % ------------------------------- BACKUP ------------------------------- % BACK-CLASS = A SAVED-PAG = COMPL-FILE VERSION = 0 % MIGRATE = ALLOWED % #BACK-VERS = 0 % ------------------------------- ORGANIZATION ------------------------------- % FILE-STRUC = NONE BUF-LEN = NONE BLK-CONTR = NONE % IO(USAGE) = READ-WRITE IO(PERF) = STD DISK-WRITE = IMMEDIATE % REC-FORM = NONE REC-SIZE = 0 % AVAIL = *STD % ------------------------------- ALLOCATION ------------------------------- % SUPPORT = PUB S-ALLOC = 9 HIGH-US-PA = 0 % EXTENTS VOLUME DEVICE-TYPE EXTENTS VOLUME DEVICE-TYPE % 1 2OSG.5 D3435 % NUM-OF-EXT = 1 %0000000009 :2OSG:$USERXY01.MAX.GROUP.2(*0013) % ------------------------------- HISTORY ------------------------------- % CRE-DATE = NONE ACC-DATE = NONE CHANG-DATE = NONE % CRE-TIME = NONE ACC-TIME = NONE CHANG-TIME = NONE % ACC-COUNT = 0 S-ALLO-NUM = 0 % ------------------------------- SECURITY ------------------------------- % READ-PASS = YES WRITE-PASS = NONE EXEC-PASS = NONE % USER-ACC = OWNER-ONLY ACCESS = WRITE ACL = NO % AUDIT = NONE FREE-DEL-D = *NONE EXPIR-DATE = NONE % DESTROY = NO FREE-DEL-T = *NONE EXPIR-TIME = NONE % SP-REL-LOCK= NO ENCRYPTION = *NONE % ------------------------------- BACKUP ------------------------------- % BACK-CLASS = A SAVED-PAG = COMPL-FILE VERSION = 0 % MIGRATE = ALLOWED % #BACK-VERS = 0 % ------------------------------- ORGANIZATION ------------------------------- % FILE-STRUC = NONE BUF-LEN = NONE BLK-CONTR = NONE % IO(USAGE) = READ-WRITE IO(PERF) = STD DISK-WRITE = IMMEDIATE % REC-FORM = NONE REC-SIZE = 0 % AVAIL = *STD % ------------------------------- ALLOCATION ------------------------------- % SUPPORT = PUB S-ALLOC = 9 HIGH-US-PA = 0 % EXTENTS VOLUME DEVICE-TYPE EXTENTS VOLUME DEVICE-TYPE % 1 2OSG.4 D3435 % NUM-OF-EXT = 1 %:2OSG: PUBLIC: 4 FILES RES= 27 FRE= 27 REL= 27 PAGES
The complete catalog entries for the file generation group MAX.GROUP.2 (group entry) and for all associated generations are listed.
Example 8d: Complete catalog entries for a private disk FGG
/show-file-attr max.group.4,inf=*all,select=(gen=*yes)
%0000000000*:2OSG:$USERXY01.MAX.GROUP.4 (FGG) % ------------------------------- HISTORY ------------------------------- % CRE-DATE = 2014-07-02 ACC-DATE = NONE CHANG-DATE = 2014-07-02 % CRE-TIME = 00:00:00 ACC-TIME = NONE CHANG-TIME = 00:00:00 % ACC-COUNT = 0 S-ALLO-NUM = 0 % ------------------------------- SECURITY ------------------------------- % READ-PASS = NONE WRITE-PASS = NONE EXEC-PASS = NONE % USER-ACC = OWNER-ONLY ACCESS = WRITE ACL = NO % AUDIT = NONE FREE-DEL-D = *NONE EXPIR-DATE = 2014-07-02 % DESTROY = NO FREE-DEL-T = *NONE EXPIR-TIME = 00:00:00 % SP-REL-LOCK= NO ENCRYPTION = *NONE % ------------------------------- BACKUP ------------------------------- % BACK-CLASS = A SAVED-PAG = COMPL-FILE VERSION = 0 % MIGRATE = ALLOWED % #BACK-VERS = 0 % ------------------------------- GENERATION-INFO ---------------------------- % MAXIMUM = 3 BASE-NUM = 0 OVERFL-OPT = CYCL-REPL % FIRST-GEN = 1 LAST-GEN = 3 % EXTENTS VOLUME DEVICE-TYPE % WORK01 D3435 %0000000003*:2OSG:$USERXY01.MAX.GROUP.4(*0001) % ------------------------------- HISTORY ------------------------------- % CRE-DATE = NONE ACC-DATE = NONE CHANG-DATE = NONE % CRE-TIME = NONE ACC-TIME = NONE CHANG-TIME = NONE % ACC-COUNT = 0 S-ALLO-NUM = 0 % ------------------------------- SECURITY ------------------------------- % READ-PASS = NONE WRITE-PASS = NONE EXEC-PASS = NONE % USER-ACC = OWNER-ONLY ACCESS = WRITE ACL = NO % AUDIT = NONE FREE-DEL-D = *NONE EXPIR-DATE = NONE % DESTROY = NO FREE-DEL-T = *NONE EXPIR-TIME = NONE % SP-REL-LOCK= NO ENCRYPTION = *NONE % ------------------------------- BACKUP ------------------------------- % BACK-CLASS = A SAVED-PAG = COMPL-FILE VERSION = 0 % MIGRATE = ALLOWED % #BACK-VERS = 0 % ------------------------------- ORGANIZATION ------------------------------- % FILE-STRUC = NONE BUF-LEN = NONE BLK-CONTR = NONE % IO(USAGE) = READ-WRITE IO(PERF) = STD DISK-WRITE = IMMEDIATE % REC-FORM = NONE REC-SIZE = 0 % AVAIL = *STD % ------------------------------- ALLOCATION ------------------------------- % SUPPORT = PVT S-ALLOC = 9 HIGH-US-PA = 0 % EXTENTS VOLUME DEVICE-TYPE EXTENTS VOLUME DEVICE-TYPE % 1 WORK01 D3435 % NUM-OF-EXT = 1 %0000000003*:2OSG:$USERXY01.MAX.GROUP.4(*0002) % ------------------------------- HISTORY ------------------------------- % CRE-DATE = NONE ACC-DATE = NONE CHANG-DATE = NONE % CRE-TIME = NONE ACC-TIME = NONE CHANG-TIME = NONE % ACC-COUNT = 0 S-ALLO-NUM = 0 % ------------------------------- SECURITY ------------------------------- % READ-PASS = NONE WRITE-PASS = NONE EXEC-PASS = NONE % USER-ACC = OWNER-ONLY ACCESS = WRITE ACL = NO % AUDIT = NONE FREE-DEL-D = *NONE EXPIR-DATE = NONE % DESTROY = NO FREE-DEL-T = *NONE EXPIR-TIME = NONE % SP-REL-LOCK= NO ENCRYPTION = *NONE % ------------------------------- BACKUP ------------------------------- % BACK-CLASS = A SAVED-PAG = COMPL-FILE VERSION = 0 % MIGRATE = ALLOWED % #BACK-VERS = 0 % ------------------------------- ORGANIZATION ------------------------------- % FILE-STRUC = NONE BUF-LEN = NONE BLK-CONTR = NONE % IO(USAGE) = READ-WRITE IO(PERF) = STD DISK-WRITE = IMMEDIATE % REC-FORM = NONE REC-SIZE = 0 % AVAIL = *STD % ------------------------------- ALLOCATION ------------------------------- % SUPPORT = PVT S-ALLOC = 9 HIGH-US-PA = 0 % EXTENTS VOLUME DEVICE-TYPE EXTENTS VOLUME DEVICE-TYPE % 1 WORK01 D3435 % NUM-OF-EXT = 1 %0000000003*:2OSG:$USERXY01.MAX.GROUP.4(*0003) % ------------------------------- HISTORY ------------------------------- % CRE-DATE = NONE ACC-DATE = NONE CHANG-DATE = NONE % CRE-TIME = NONE ACC-TIME = NONE CHANG-TIME = NONE % ACC-COUNT = 0 S-ALLO-NUM = 0 % ------------------------------- SECURITY ------------------------------- % READ-PASS = NONE WRITE-PASS = NONE EXEC-PASS = NONE % USER-ACC = OWNER-ONLY ACCESS = WRITE ACL = NO % AUDIT = NONE FREE-DEL-D = *NONE EXPIR-DATE = NONE % DESTROY = NO FREE-DEL-T = *NONE EXPIR-TIME = NONE % SP-REL-LOCK= NO ENCRYPTION = *NONE % ------------------------------- BACKUP ------------------------------- % BACK-CLASS = A SAVED-PAG = COMPL-FILE VERSION = 0 % MIGRATE = ALLOWED % #BACK-VERS = 0 % ------------------------------- ORGANIZATION ------------------------------- % FILE-STRUC = NONE BUF-LEN = NONE BLK-CONTR = NONE % IO(USAGE) = READ-WRITE IO(PERF) = STD DISK-WRITE = IMMEDIATE % REC-FORM = NONE REC-SIZE = 0 % AVAIL = *STD % ------------------------------- ALLOCATION ------------------------------- % SUPPORT = PVT S-ALLOC = 9 HIGH-US-PA = 0 % EXTENTS VOLUME DEVICE-TYPE EXTENTS VOLUME DEVICE-TYPE % 1 WORK01 D3435 % NUM-OF-EXT = 1 %:2OSG: PRDISC: 4 FILES RES= 9 FRE= 9 REL= 0 PAGES
The complete catalog entries for the file generation group MAX.GROUP.4 (group entry) and for all associated generations are listed. The file generation and its generations are stored on the private disk WORK01.
Example 9: Complete catalog entry of a tape file
/show-file-attr max.tape-file.2,inf=*all
% :2OS2:$USER1.MAX.TAPE-FILE.2 % ------------------------------- HISTORY ------------------------------- % CRE-DATE = 2014-07-01 ACC-DATE = 2014-07-01 CHANG-DATE = 2014-07-01 % CRE-TIME = 13:22:17 ACC-TIME = 13:22:27 CHANG-TIME = 13:22:27 % ACC-COUNT = 1 S-ALLO-NUM = 0 % ------------------------------- SECURITY ------------------------------- % READ-PASS = NONE WRITE-PASS = NONE EXEC-PASS = NONE % USER-ACC = ALL-USERS ACCESS = WRITE ACL = NO % AUDIT = NONE DESTROY = NO EXPIR-DATE = 2014-07-01 % EXPIR-TIME = 00:00:00 % ------------------------------- BACKUP ------------------------------- % BACK-CLASS = A SAVED-PAG = COMPL-FILE VERSION = 1 % #BACK-VERS = 0 % ------------------------------- ORGANIZATION ------------------------------- % FILE-STRUC = SAM BUF-LEN = STD(1) BLK-CONTR = PAMKEY % REC-FORM = (V,M) REC-SIZE = 2044 % CODE = EBCDIC LABEL = (STD,1) FILE-SEQ = 2 % BLK-OFFSET = 4 % ------------------------------- ALLOCATION ------------------------------- % SUPPORT = PVT BLK-COUNT = 5 % EXTENTS VOLUME DEVICE-TYPE EXTENTS VOLUME DEVICE-TYPE % M5658K TAPE-C4 %:2OS2: TAPE : 1 FILE
The complete catalog entry of the tape file MAX.TAPE-FILE.2 is output. The file is the second file (FILE-SEQ=2) on a magnetic tape cartridge of volume type TAPE-C4 with the volume serial number D2326K.
Example 10: Output to printer
/show-file-attr file-name=max.file.,output=*printer
%:2OS2: PUBLIC: 10 FILES RES= 60 FRE= 33 REL= 24 PAGES
A print-edited list of all files starting with MAX.FILE. is produced and printed out1 with the spoolout name FSTATPRT. The user receives the following listing:
17:11:24 15-03-13 PAGE 1 |------------------------------------------------------------------------------------------| | | | | | | | | | | | | | FILENAME |PAM- |FREE-|SEC- |FCB-|SHARE|ACCESS|PASS-|BKL|#EXT|VOLUME| | |PAGES|PAGES|ALLOC|TYPE| | |WORDS| | | | | | | | | | | | | | | | |------------------------------------------------------------------------------------------| | | | | | | | | | | | | | :2OS2:$USER1.MAX.FILE.1 | 3 | 3 | 9 |NONE| NO | WRITE| | A | 1 |2OS2.0| | :2OS2:$USER1.MAX.FILE.10 | 9 | 4 | 9 |SAM | NO | WRITE| | A | 1 |2OS2.D| | :2OS2:$USER1.MAX.FILE.10.SORT-1| 12 | 7 | 9 |SAM | NO | WRITE| | A | 2 |2OS2.F| | :2OS2:$USER1.MAX.FILE.10.SORT-2| 12 | 7 | 9 |SAM | NO | WRITE| | A | 3 |2OS2.5| | :2OS2:$USER1.MAX.FILE.2 | 3 | 2 | 9 |SAM | NO | WRITE| | A | 1 |2OS2.0| | | | | | | | | | | | | | :2OS2:$USER1.MAX.FILE.3 | 3 | 3 | 9 |NONE| NO | WRITE| | A | 1 |2OS2.C| | :2OS2:$USER1.MAX.FILE.4 | 9 | 2 | 9 |ISAM| NO | WRITE| | A | 1 |2OS2.A| | :2OS2:$USER1.MAX.FILE.6 | 3 | 3 | 9 |NONE| NO | WRITE| | A | 1 |2OS2.E| | :2OS2:$USER1.MAX.FILE.7 | 3 | 1 | 9 |ISAM| NO | WRITE| | A | 1 |2OS2.G| | :2OS2:$USER1.MAX.FILE.9 | 3 | 1 | 9 |ISAM| NO | WRITE| | A | 1 |2OS2.H| | | | | | | | | | | | | |------------------------------------------------------------------------------------------| | PUBLIC SPACE: 10 FILES 60 | |------------------------------------------------------------------------------------------|
1 | If the print-edited list is output to a file, the first data byte in each case contains a print control character which is evaluated by the printer at the time of print output with PRINT-DOCUMENT and LINE-SPACING=*BY-EBCDIC-CONTROL. |