The LIST statement enables information to be written to SYSLST. This makes it useful for redirecting information which is too extensive to be output on the terminal screen.
This statement is reserved for the TSOS user ID.
Format
LIST / L |
ALLOCATION,vsn[,type] [USER = userid] CATALOG [, { CATID = cat-id [,{ VSID = vsid / SEL = { ALL / FILE / PRIV / MIG / JV } } ] / vsn[,type] / VSID = vsid } ] [,USER = userid ] VTOC,vsn[,type] [,ENTRY = filename] |
Operands
ALLOCATION
Outputs general allocation information for a volume.
The list sorts the allocation information according to extent. The start of each extent being specified in the form “cchhr”.
Information can only be output on volumes that are identified by their volume serial number. When specifying operands it is not necessary to distinguish between public and private volumes.
The following comments may occur in the output list:
RESERVED | Space allocated without file names. It is possible to enter a file name if you wish. |
FREE SPACE | Free area on public disks. |
OVERLAY! | Space allocated twice. |
UL-SVL-F5-F1 | Space reserved by SVL, F5 and F1 (private disks). |
NO VTOC REF. | Free area on disks. |
F1 OTH. DISC | Area described by F1 of another private disk. |
NOT ASSIGNED | Area not assigned. |
NO REFERENCE | There may be outstanding allocator requirements, or an error has been indicated by CMS. |
SPACE PROBLEM | Bad area. |
vsn[,type]
Specifies the disk for which allocation information is to be listed. If a private disk is not online, the disk type “type” must also be specified. In the case of public disks, both free and “dead” space are listed.
“Dead” space is an area which the entry in the F5 label identifies as being allocated but for which there is no file in the system catalog.
USER = userid
Specifying a user ID limits the output. In this case, no information on free or dead space is output, even for public volumes.
CATALOG
Provides a list of allocated blocks in a catalog file.
Both imported and non-imported catalogs are supported.
For each catalog block, the user ID, the block counter, the primary block number (hexadecimal and decimal), the number of entries in the block and the number of unused bytes in the block are output. Then the statement has been executed properly, the message 'LIST PROCESSING COMPLETED' 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).
SEL = ALL
Processes all subcatalogs of the selected SM pubset (analogous to no additional
parameter). In the case of special catalogs, all catalog files are processed.
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 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
Specifying a “userid” limits the output of information to this user ID.
VTOC
Requests information from the F1 label of a private disk.
vsn[,type]
Specifies the volume serial number of the disk from whose VTOC area information is requested. If the volume is not online, the disk type “type” must also be specified.
ENTRY = filename
Limits output to the file entry “filename”. Fully qualified file names are not prohibited, but only the specification of partially qualified file names is practical.
Examples
1. Output of LIST ALLOCATION,PAGM.0
S P C C N T R L VERSION <version> DATE: <date> TIME: <time> PAGE 1
COMMAND IN EXECUTION: LIST ALLOCATION,PAGM.0
EXTENTS ON VOLUME PAGM.0
CCHHR (LOW) || LOW | HIGH || ASSIGNMENT | PAM PAGES || USERID | FILENAME
--------------||------------|------------||----------------|-----------||------------|----------------
---------- || 1 | 54 || RESERVED | 54 || |
---------- || 55 | 4152 || | 4098 || TSOS | TSOSCAT
---------- || 4153 | 4176 || | 24 || TSOS | SYSSRPM
---------- || 4177 | 4182 || | 6 || TSOS | SYSSRPM.BACKUP
---------- || 4183 | 4224 || | 42 || |
---------- || 4225 | 4272 || | 48 || TSOS | SYSCAT.GUARDS
---------- || 4273 | 4305 || | 33 || TSOS | SYSDAT.APUB...
---------- || 4306 | 4320 || | 15 || |
---------- || 4321 | 4368 || | 48 || TSOS | SYSCAT.GUARD...
---------- || 4369 | 4416 || | 48 || |
---------- || 4417 | 1028418 || | 1024002 || TSOS | SYS.PAGING.P...
---------- || 1028419 | 1966080 || | 937662 || |
...Notes on the ASSIGNMENT column
RESERVED | Space allocated without file names. It was not possible to enter a file name (column 7). |
FREE SPACE | Free area on public disks. |
OVERLAY! | Space allocated twice. |
UL-SVL-F5-F1 | Space reserved by SVL, F5 and F1 (private disks). |
NO VTOC REF. | Free area on disks. |
F1 OTH. DISC | Area described by F1 of another private disk. |
NOT ASSIGNED | Area not assigned. |
NO REFERENCE | There may be outstanding allocator requirements, or an error has been indicated by CMS. |
SPACE PROBLEM | Bad area. |
2. Output of LIST CATALOG
S P C C N T R L VERSION <version> DATE: <date> TIME: <time> PAGE 1
COMMAND IN EXECUTION: LIST CATALOG,CATID=2SBZ,USER=TSOS
SUMMARY OF CONTENTS IN :2SBZ:$TSOS.TSOSCAT
FOR USERID TSOS
|| FILE ENTRIES || JOB VARIABLE ENTRIES
USERID||BLK COUNT|LBN(DEC)|LBN(HEX)|# ENTRIES|UNUSED||BLK COUNT|LBN(DEC)|LBN(HEX)|# ENTRIES|UNUSED
------||---------|--------|--------|---------|------||---------|--------|--------|---------|-------
TSOS || 1 | 2 | 0002 | 1 | 3762 || 1 | 281 | 0119 | 16 | 96
|| 2 | 4 | 0004 | 12 | 188 || 2 | 311 | 0137 | 14 | 181
|| 3 | 17 | 0011 | 12 | 236 || 3 | 321 | 0141 | 17 | 24
|| 4 | 18 | 0012 | 12 | 212 || 4 | 329 | 0149 | 16 | 112
|| 5 | 19 | 0013 | 12 | 170 || 5 | 503 | 01F7 | 14 | 171
|| 6 | 20 | 0014 | 12 | 205 || 6 | 506 | 01FA | 15 | 75
|| 7 | 21 | 0015 | 12 | 110 || 7 | 510 | 01FE | 13 | 183
|| 8 | 22 | 0016 | 12 | 225 || 8 | 517 | 0205 | 14 | 47
|| 9 | 23 | 0017 | 12 | 237 || 9 | 518 | 0206 | 14 | 47
|| 10 | 24 | 0018 | 12 | 196 || 10 | 528 | 0210 | 16 | 0
|| 11 | 25 | 0019 | 12 | 268 || 11 | 562 | 0232 | 12 | 80
|| 12 | 26 | 001A | 12 | 259 || 12 | 629 | 0275 | 14 | 59
|| 13 | 27 | 001B | 12 | 244 || 13 | 591 | 024F | 17 | 165
|| 14 | 28 | 001C | 12 | 144 || 14 | 592 | 0250 | 15 | 98
|| 15 | 29 | 001D | 12 | 194 || 15 | 577 | 0241 | 13 | 14
|| 16 | 30 | 001E | 12 | 218 || 16 | 646 | 0286 | 13 | 13
|| 17 | 31 | 001F | 12 | 256 || 17 | 584 | 0248 | 14 | 27
|| 18 | 32 | 0020 | 12 | 256 || 18 | 645 | 0285 | 1 | 3722
|| 19 | 33 | 0021 | 12 | 205 || 19 | 648 | 0288 | 7 | 2172
|| 20 | 34 | 0022 | 12 | 183 || 20 | 654 | 028E | 1 | 3730
|| 21 | 35 | 0023 | 12 | 196 || | | | |
|| 22 | 36 | 0024 | 12 | 141 || | | | |
|| 23 | 37 | 0025 | 12 | 237 || | | | |
|| 24 | 38 | 0026 | 12 | 231 || | | | |
|| 25 | 39 | 0027 | 12 | 177 || | | | |
|| 26 | 40 | 0028 | 12 | 207 || | | | |
|| 27 | 41 | 0029 | 12 | 175 || | | | |
|| 28 | 42 | 002A | 12 | 139 || | | | |
|| 29 | 43 | 002B | 12 | 63 || | | | |
|| 30 | 44 | 002C | 12 | 115 || | | | |
|| 31 | 45 | 002D | 12 | 147 || | | | |
|| 32 | 46 | 002E | 12 | 131 || | | | |
|| 33 | 47 | 002F | 12 | 154 || | | | |
|| 34 | 48 | 0030 | 12 | 149 || | | | |
|| 35 | 49 | 0031 | 12 | 164 || | | | |
|| 36 | 50 | 0032 | 12 | 169 || | | | |
|| 37 | 51 | 0033 | 12 | 128 || | | | |
|| 38 | 52 | 0034 | 12 | 176 || | | | |
|| 39 | 53 | 0035 | 12 | 153 || | | | |
|| 40 | 54 | 0036 | 12 | 142 || | | | |
|| 41 | 55 | 0037 | 12 | 153 || | | | |
|| 42 | 56 | 0038 | 12 | 167 || | | | |
|| 43 | 57 | 0039 | 12 | 167 || | | | |
|| 44 | 58 | 003A | 12 | 167 || | | | |