The DISPLAY statement outputs the information requested in the operands to SYSOUT. In interactive mode, the information is displayed on the terminal.
Format
DISPLAY / D |
SPACE , { PUBLIC [,CATID = { cat-id / vsn[,type } ] / PRIVATE[,vsn[,type]] / EAM [, { TSN = { tsn / (ALL) } / USER = userid / CATID = cat-id } ] / CATALOG [, { CATID = cat-id [, { VSID = vsid / SEL = { ALL / FILE / PRIV / MIG / JV } } ] / vsn[,typ] / VSID = vsid CATALOG ,ENTRY = filename / (filename,JV) [,CATID = catid] [,HEX = NO / YES] VTOC ,VSN[,type],ENTRY = filename [,HEX = NO / YES] |
Operands
DISPLAY SPACE
This operand is reserved for system administration.
PUBLIC
Outputs the total amount of free and occupied memory space on all public imported volumes of the home pubset. SM pubsets are not supported. /SHOW-PUBSET-SPACE-ALLOCATION provides on the storage space allocation of SM pubsets (see the “Commands” manual [1 (Related publications)].
In addition to the VSN and the device type, the number of free pages and the number of file on the specified disk are also output. If the information on more than one disk is to be supplied, SPCCNTRL lists the values for the individual disks and then outputs the total. If neither CATID nor a VSN are specified, the function is executed for all disks on the home pubset.
vsn
Specifies one specific public disk, for which information on the space allocation is requested.
type
Specifies the disk type
CATID = catid
Specifies the catalog ID of an imported SF pubset. Information is output about the space allocation of disks that are entered in a specific catalog. If this operand is not specified, the home catalog is always assumed. In the case of a non-homogeneous network, information are only output for the MASTER.
PRIVATE
Outputs the total amount of free and occupied space on all private disks (including labels).
vsn
Identifies one specific private disk, on which information is requested.
type
Specifies the disk type (e.g. D3435). This entry is required if the private disk is not online.
EAM
Outputs information on the system file SYSEAM. If no entry is made for “tsn” or ALL, an overview of the overall allocation for SYSEAM is output. If “tsn” is specified, the information is restricted to the allocation on the specified TSN.
TSN = tsn / (ALL)
The information on the system file SYSEAM is to refer solely to the specified TSN (“tsn”) or to all TSNs (ALL).
USER = userid
The information on the system file SYSEAM is to refer to the specified user ID.
CATID = catid
This is the catalog ID of the requested catalog. The home catalog is assumed by default if the operand is omitted.
CATALOG
Provides information on the overall allocation of one or more (for SM pubsets) catalog file(s).
The number of user IDs, the size of the catalog file, the number of pages occupied (according to the counter and BITMAP) and an error indicator are output. The information provided is internal management data of the Catalog Management System (CMS).
Both imported and non-imported catalogs are supported.
DMS0576 is output.CATID = catid
Specifies
the TSOSCAT of an imported SF pubset.
the entire catalog of an SM pubset.If no additional parameter is specified, the information is output for all subcatalogs of the SM pubset.
VSID = vsid
Specifying a VSID restricts the output to the file catalog of the selected volume set (permissible only for SM pubsets).
SEL = ALL / FILE / PRIV / MIG / JV
Additional selection (only for SM pubsets). In the case of special catalogs, all catalog files are processed.
SEL = ALL
Processes all subcatalogs of the selected SM pubset (analogous to no additional parameter).
SEL = FILE
Selects all file catalogs of the SM pubset.
SEL = PRIV
Processes the special catalog for private disk and tape file entries. Only the first file of the special catalog (TSOSCAT.#P00) is processed.
SEL = MIG
Selects the special catalog for migrated files or files that have not been assigned space. Only the first file of the special catalog (TSOSCAT.#M00) is processed.
SEL = JV
Permits the output of information about the special catalog for a job variable. Only the first file of the special catalog (TSOSCAT.#J00) is processed.
vsn
Specifies a disk that contains either the file catalog of a volume set or the TSOSCAT of an SF pubset.
type
Specifies the device type of the disk defined by <vsn>.
VSID = vsid
Specifies the file catalog of a volume set. This parameter is permissible only when processing an SM pubset.
DISPLAY CATALOG
This operand is available to all users.
It outputs the information not supplied by /SHOW-FILE-ATTRIBUTES from the catalog entry of a file or a job variable to SYSOUT.
The output information includes the size of the file or job variable, the size of the catalog entry, CFID or JVID, primary block number, any locks and the number of extents.
The primary block number when the statement is entered: TRACE CATALOG, block (primary block number), byte. The name of the corresponding catalog/subcatalog is also displayed.
Non-privileged users can only address files or job variable under their own user ID. DISPLAY CATALOG supports only files of imported catalogs.
ENTRY = filename
Requests output of the catalog entry for the file specified by “filename”. “filename” can also be specified as a coded file ID in the form X'hhhhhhhh'.
ENTRY = (filename,JV)
Requests output of the catalog for the job variable specified by “filename”. “filename” can also be specified as JV ID or as a coded file ID in the form X'hhhhhhhh'.
CATID = catid
Specifies the catalog ID of the requested catalog (SF pubset or SM pubset). The default value is the default catid of the caller’s user ID.
HEX = NO / YES
Specifies whether the entire catalog entry is to be output in hexadecimal form. NO is the default value.
DISPLAY VTOC
This operand is available to all users.
It outputs information contained in the F1 label on a private volume. The same information is supplied as for DISPLAY CATALOG, with the difference that the VTOC area of the private disk serves as the source.
vsn[,type]
Specifies the volume from whose VTOC area information is requested. If the disk is not online, the disk type (“type”) must also be specified.
ENTRY = filename
Specifies the file entry in the F1 label on which information is to be output. “filename” can also be specified as a coded file ID in the form X'hhhhhhhh'.
HEX = NO / YES
Specifies whether the entire entry is to be output in hexadecimal form. NO is the default value.
Examples
Output of DISPLAY SPACE,PUBLIC
DISPLAY S,PUBLIC VOLUME I DEVICE I PAGES FREE I PAGES USED I FILES -------I--------I------------I------------I-------- 2SBZ.0 I D3435 I 157758 I 450948 I 1660 2SBZ.1 I D3435 I 152823 I 455886 I 1655 2SBZ.2 I D3435 I 3408 I 328266 I 1656 --------------------------------------------------- TOTAL I 313989 I 1235100 I 4971
Output of DISPLAY SPACE,EAM
D S,EAM SUMMARY FOR :K:$TSOS.SYSEAM: SYSEAM SPACE ASSIGNED: 348 PAGES SYSEAM SPACE ALLOCATED: 38712 PAGES SYSEAM CATALOG ENTRY SIZE: 468 BYTES
Output of DISPLAY SPACE,EAM,TSN=(ALL)
D S,EAM,TSN=(ALL) CATID I TSN I USER I TYPE I FILES I PAGES USED I ALLOCATED ------I------I----------I------I-------I------------I---------- K I 5015 I TSOS I 3 I 2 I 6 I 6 K I 5060 I A2A3A4A5 I 3 I 5 I 6 I 6 K I 5068 I RZDATEX I 3 I 1 I 32 I 33 K I 5158 I TERM I 3 I 1 I 0 I 0 K I 5167 I DATA I 3 I 40 I 1 I 3 K I 5208 I BASIS I 3 I 3 I 3 I 6 K I 5232 I ARCHIV I 3 I 3 I 0 I 0 K I 5233 I CONS I 3 I 2 I 62 I 63 K I 5239 I DELTA I 3 I 6 I 23 I 24 K I 5328 I F1F2F3F4 I 3 I 1 I 5 I 6 K I 5346 I BERGER I 3 I 17 I 4 I 6 K I 5352 I FIFO I 3 I 5 I 45 I 45
Output of DISPLAY SPACE,CATALOG
D S,C TSOSCAT/HOME -------------------------------------------------------------------------- USERID' S IN JOINFILE 69 EFFECTIVE FILE SIZE 2049 PAGES USED (4K) (COUNTER) 279 PAGES USED (4K) (BIT TABLE) 279 PREASSIGNED (ERROR IF NOT 0) 0
Output of DISPLAY CATALOG, ENTRY=TEMP.12
D C,ENTRY=$TSOS.TEMP.12 PUBLIC DISK FILE: :2BV:$TSOS.TEMP.12 -------------------------------------------------------------------------- TOTAL SPACE ALLOCATED: 3 PAGES CODED FILE IDENTIFICATION: 8D32C3B4 * FLT LOCK ENTRY: 00000000 00000000 00000001 00000000 * 00000000 00000000 00000000 00000000 * 00000000 00000000 00000000 00000000 * 00000000 00000000 00000000 00000000 * 00000000 00000000 00000000 00000000 * 00000000 00000000 00000000 00000000 PRIMARY BLOCK NUMBER (BLK=4KB): 16 CURRENT BLOCK NUMBER: 16 CATALOG ENTRY AT BYTE: 3665 CATALOG ENTRY SIZE: 121 BYTES # OF EXTENT ENTRIES: 1 EXTENT I VOLUME I LOW I HIGH I PAGES ALLOCATED -------I----------I-----------------I----------------I------------------- 1 I 2BV.01 I 6679 I 6681 I 3
*Meaning of the output fields for FLT LOCK ENTRY:
linewise from left to right, value specified in hexadecimal format
Number of openers with OPEN=INPUT,SHARUPD=WEAK
Number of openers with OPEN=INPUT,SHARUPD=NO
Number of openers with OPEN=INPUT,SHARUPD=YES
Number of openers with DIV, MODE=*INPUT,SHARUPD=YESNumber of openers with DIV, MODE=*INPUT,SHARUPD=WEAK
Number of input reservation blocks for file transfer
Number of input reservation blocks for SPOOL (print locks)
Number of openers with OPEN=OUTPUT,SHARUPD=YESNumber of openers with DIV, MODE=*OUTPUT,SHARUPD=YES
Number of openers with DIV, MODE=*OUTPUT,SHARUPD=WEAK
Number of openers with OPEN=OUTPUT,SHARUPD=NO
Number of write exclusive reservationsNumber of openers with OPEN=OUTPUT,SHARUPD=WEAK
Number of secure locks
Number of output reservation locks for file transfer
Number of HSMS secure locksNumber of concurrent copy locks
Number of concurrent copy locks for the setup of the concurrent copy session
Number of exclusive path locks for files on private disks
Number of 0 locksReserved for internal use
Reserved for internal use
Number of host environment locksNumber of XCS environment locksFile locks can also be displayed using
/SHOW-FILE-LOCKS.Output of DISPLAY VTOC, RZWORK, ENTRY=SPC.TEST.PR
D V,RZWORK,ENTRY=SPC.TEST.PR PRIVATE DISK FILE: :HOME:$TSOS.SPC.TEST.PR TOTAL SPACE ALLOCATED: 3 PAGES CODED FILE IDENTIFICATION: 92032342 FLT LOCK ENTRY: NONE PAM LOCK ENTRY: NONE VTOC LOCK ENTRY: NONE VTOC SHARER ENTRIES: NONE PRIMARY BLOCK NUMBER: 2 CURRENT BLOCK NUMBER: 2426 CATALOG ENTRY AT BYTE: VTOC/F1 ENTRY ON VOLUME: RZWORK ON-LINE VTOC/F1 BLOCK POINTER: 10 VTOC/F1 ENTRY IN BLOCK: 10 CATALOG ENTRY AT BYTE: 1874 CATALOG ENTRY SIZE: 125 BYTES # OF EXTENT ENTRIES: 1 EXTENT I VOLUME I LOW I HIGH I PAGES ALLOCATED -------I----------I-----------------I----------------I------------------- 1 I RZWORK I 2878 I 2880 I 3