CHECK - Perform allocation checks

The following operations can be performed by means of the CHECK statement:

• check the allocation of a public disk

• check for errored entries in the system catalog

• check the contents of the VTOC area (F1 label) of a private disk for errored entries

A message is output for each error found, stating the errored page, the user ID and the file name. Then the check is continued.

This statement is reserved for system administration.

Both imported and non-imported catalogs are supported.

Format

CHECK / C                                                                                                                                                     

ALLOCATION,vsn

CATALOG

[, { CATID = { cat-id [, { VSID = vsid / SEL= { ALL / FILE / PRIV / MIG / JV } }] /

vsn[,type] /

VSID = vsid } ]

[,ENTRY = filename / (filename,JV)]

VTOC,vsn[,type] [,ENTRY = filename]

Operands

A[LLOCATION]
Subjects the allocation of a public volume to a general check, i.e. as to whether there are any “dead” areas or “doublers”.

An overview of the disk allocation is output. The check is aborted if cases of double allocation are detected.
Such cases can be localized by means of LIST ALLOCATION.
Specification of a catalog ID is not mandatory.

vsn
Specifies the public disk that is to be checked.

C[ATALOG]
Checks the system catalog for errored entries. Error codes are assigned; these can be queried by means of HELP.

CATID = catid
Specifies

1. the TSOSCAT of an imported SF pubset.

2. 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.

ENTRY = filename
Specifies a fully qualified file name limiting the check to a single catalog entry.

ENTRY = (filename,JV)
The check is to be restricted to the job variable identified by “filename”. The “filename” entry can also be made in the form of a coded file ID.

V[TOC]
Checks the contents of the F1 label of a private disk for errored entries. This function corresponds to the CHECK CATALOG function.

vsn[,type]
Specifies the private disk whose VTOC area is to be checked. If the disk is not available (online), the disk type “type” must also be specified.

ENTRY = filename
Restricts the check to a specific file entry with the file name “filename”. A coded file ID can also be specified.

 

Examples

1. Output of information to public disk with the following statement:

   *check allocation,1SBZ.0
    ASSIGNMENT SUMMARY FOR VOLUME 1SBZ.0
    ---------------------------------------
    NUMBER OF FILE ENTRIES:             902
    NUMBER OF EXTENTS:                 1369
   
    PAM PAGES ASSIGNED TO FILES:     216486
    PAM PAGES NOT ASSIGNED:          115185
    PAM PAGES FREE:                       0
   * 
   

2. Output of information on catalog ID:

   *CHECK CATALOG,CATID=1SBZ
   %  SPC0060 NO ERROR IN THE CATALOG FILE 1SBZ:$TSOS.TSOSCAT
   * 
   

   or

   *CHECK CATALOG,CATID=A
   ERROR SUMMARY FOR CATALOG :A:$TSOSCAT
   
   ERROR    |    BLOCK  |  BYTE |   USER   | FILENAME
   ---------------------------------------------------
   SPC1506  |     1635  |   584 | TEXACO   | DATOUT
   SPC1503  |     1800  |   403 | ULTIMO   | PROC03 

   /HELP-MSG-INFORMATION SPC1506 provides information on the cause of the error:

   % SPC1506 VSN IN VOLUME TABLE ENTRY NOT PRINTABLE