The TRACE statement enables blocks and entries in the system catalog and the VTOC area of a private disk to be identified and output to SYSOUT or SYSLST. In addition, any block of a public or private disk can also be displayed.
In order to save write operations, the default values for the keyword operands remain valid until they are modified by a subsequent entry.
This statement is reserved for the TSOS user ID.
Format
TRACE |
CATALOG, block[,byte] [, { CATID = cat-id [,{ VSID = vsid / SEL = { PRIV / MIG / JV} } ] / vsn[,type] / VSID = vsid } ] [,USER = userid ] [,JV = NO / YES ] [,OUTPUT = (BLOCK[,{ SYSOUT / SYSLST } ]) / (OWNER[,SYSOUT]) / SYSOUT / SYSLST ] VTOC ,{ block / (block,PHP) } [,byte],vsn[,type] [,OUTPUT = (BLOCK[,{ SYSOUT / SYSLST } ]) / SYSOUT / SYSLST ] SPACE,block[,byte],vsn[,type] [,OUTPUT = (BLOCK[,{ SYSOUT / SYSLST } ]) / SYSOUT / SYSLST ] |
Operands
CATALOG
Supplies information from the system catalog. Any block, including the control blocks with the bit tables, can be displayed even if it is not assigned to a user.
Both imported and non-imported catalogs are supported.
block
Specifies the number of the block to be output. This entry can also be made in hexadecimal form (X'hhhh'). If a user ID is specified under USER=userid, the block specification is relative to the user’s catalog chain; otherwise “block” is interpreted as an absolute block number.
Together with OUTPUT=(BLOCK,SYSLST), “block” can be omitted.
In this case the complete catalog is output. In the case of catalogs with an odd number of pages, the last (half) page is not output. This is not used and is therefore empty.
byte
Specifies the byte number within the block from which output is to start. Here, too, the entry can be made in hexadecimal form (X'hhhh').
CATID = catid
Specifies
the TSOSCAT of an imported SF pubset.
the entire catalog of an SM pubset. In this case, further information must be specified in the VSID or SEL operand.
VSID = vsid
Specifying a VSID restricts the output to the file catalog of the selected volume set (permissible only for SM pubsets; see also note below).
SEL = PRIV / MIG / JV
Specifies a special catalog (only for SM pubsets):
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 Pubres 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.
USER = userid
Specifies the user ID of the user from whose catalog entry blocks are to be output. If a user ID is specified for SM pubsets, it is possible only to process a subcatalog. This subcatalog must be defined by specifying a <vsid> or the parameter SEL.
JV = NO / YES
This parameter is permissible only for processing an SF pubset. It is ignored for SM pubsets.
JV = NO
Ignores job variables (default). A block from the user’s file name chain is output.
JV = YES
Displays blocks from a job variable chain. This entry is practical only in conjunction with USER=userid, in all other cases it is ignored.
OUTPUT = (BLOCK,SYSOUT)
Directs output to SYSOUT (default).
OUTPUT = (BLOCK,SYSLST)
Output is to be to SYSLST.
OUTPUT = (OWNER,SYSOUT)
utputs the owner (user ID) of the desired block rather than its contents to SYSOUT.
OUTPUT = SYOUT / SYSLST
This is the same as (BLOCK,SYSOUT) or (BLOCK,SYSLST).
VTOC
Outputs information from the VTOC area of a private disk.
block
Specifies the number of the block to be output. This entry can also be made in hexadecimal form (X'hhhh').
Together with OUTPUT=(BLOCK,SYSLST), “block” can be omitted. In this case the entire VTOC area is output.
PHP
Specifies a physical block number, i.e. the block number is not relative to the beginning of the VTOC area.
byte
Specifies the byte number within the block from which output is to start. This entry can also be made in hexadecimal form (X'hhhh').
vsn[,type]
Specifies the volume serial number of the private disk whose VTOC area is to be output. If the disk is not available (online), the disk type “type” must also be specified.
OUTPUT = (BLOCK,SYSOUT)
Directs output to SYSOUT (default).
OUTPUT = (BLOCK,SYSLST)
Output is to be to SYSLST.
OUTPUT = SYOUT / SYSLST
This is the same as (BLOCK,SYSOUT) or (BLOCK,SYSLST).
SPACE
Outputs a freely selectable item of information from the specified disk.
block
Specifies the number of the block to be output. This entry can also be made in hexadecimal form (X'hhhh'). Together with OUTPUT=SYSLST, the “block” specification can be omitted. In this case the entire SVL together with the F5 label is output.
byte
Specifies the byte number within the block from which output is to start. This entry can also be made in hexadecimal form (X'hhhh').
vsn[,type]
Specifies the volume serial number of the public or private disk on which information is to be output. If the disk is not available (online), the disk type “type” must also be specified.
OUTPUT = (BLOCK,SYSOUT)
Directs output to SYSOUT (default).
OUTPUT = (BLOCK,SYSLST)
Output is to be to SYSLST.
OUTPUT = SYOUT / SYSLST
This is the same as (BLOCK,SYSOUT) or (BLOCK,SYSLST).
Example
(IN) TRACE CATALOG,1,10,CATID=2SBZ (OUT) :2SBZ:TSOSCAT LBN: 1 (0001) PHP: 28 ON VOLUME 2SBZ.0 (NL) ---------------------------------------------------------------------------- (NL) (NL) 0009 (000): FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF ~~~~~~~~~~~~~~~~ (NL) 0019 (010): FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF ~~~~~~~~~~~~~~~~ (NL) 0029 (020): FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF ~~~~~~~~~~~~~~~~ (NL) 0039 (030): FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF ~~~~~~~~~~~~~~~~ (NL) 0049 (040): FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF ~~~~~~~~~~~~~~~~ (NL) 0059 (050): FFFFFFFF 00000000 00000000 00000000 ~~~~............ (NL) 0069 (060): 00000000 00000000 00000000 00000000 ................ (NL) 0079 (070): 00000000 00000000 00000000 00000000 ................ (NL) 0089 (080): 00000000 00000000 00000000 00000000 ................ (NL) 0099 (090): 00000000 00000000 00000000 00000000 ................ (NL) 00A9 (0A0): 00000000 00000000 00000000 00000000 ................ (NL) 00B9 (0B0): 00000000 00000000 00000000 00000000 ................ (NL) 00C9 (0C0): 00000000 00000000 00000000 00000000 ................ (NL) 00D9 (0D0): 00000000 00000000 00000000 00000000 ................ (NL) 00E9 (0E0): 00000000 00000000 00000000 00000000 ................ (NL) 00F9 (0F0): 00000000 00000000 00000000 00000000 ................ (NL) 0109 (100): 00000000 00000000 00000000 00000000 ................ (NL) 0119 (110): 00000000 00000000 00000000 00000000 ................ (NL) 0129 (120): 00000000 00000000 00000000 00000000 ................ (OUT) % SPC0020 SCREEN OVERFLOW, CONTINUE (Y/N)?