CATCHECK

Read syntax diagramSkip visual syntax diagram CATCHECK IJSYSUCIJSYSCTcatname/password

Authorization

General User

Purpose

Use the CATCHECK command to invoke the VSE/VSAM Catalog Check Service Aid to verify a complete catalog structure. This produces a print file containing the catalog analysis. A CMS VSAM user (with or without DOS set ON), can use the CATCHECK command.

Operands

catname
is the catalog name of the catalog to be checked. The name can be a maximum of 44 characters and must follow the VSE/VSAM catalog naming conventions. If you do not specify a catalog name with CATCHECK, it uses the default catalog specified with the DLBL command.
password
is the password for the catalog catname as specified when the catalog was defined. The maximum length is 8 characters. If you specify the password, you must put a slash between the catalog name and the password.

Usage Notes

  1. If a catalog name is not specified on the command line, the default catalog is used. The default catalog is the job catalog identified by a ddname of IJSYSUC on the DLBL command. If a job catalog was not specified, the default catalog name will be the master catalog identified by the ddname of IJSYSCT on the DLBL command.
  2. When a catalog name is specified, a DLBL need not be issued for the catalog if it is not the master catalog. A DLBL for the master catalog must always be in effect when running VSAM.
  3. The output must always go to the virtual printer.
  4. CATCHECK uses the extended plist for processing the catname/password parameter. If you are calling CATCHECK from an assembler language program and using catname or catname/password, you should supply an extended plist. For more information on how an assembler language program can supply an extended plist, see z/VM®: CMS Macros and Functions Reference.

Examples

If you have only issued a DLBL command for the master catalog, specifying: 
catcheck private.cat1
produces a print file containing the catalog analysis for PRIVATE.CAT1 catalog.

Messages and Return Codes

  • DMS109S Virtual storage capacity exceeded [RC=104]
  • DMS803E Invalid parameter specification [RC=4]
  • DMS804S Error establishing CMS/DOS environment [RC=8]
  • DMS805S Error assigning output to printer [RC=12]
  • DMS806S VSE/VSAM phase IKQVCHK not found [RC=16]
  • DMS807S Error encountered issuing ASSGN for catalog [RC=20]