Control statements for the validate function

Use the following information to prepare control statements for the validate function of the Catalog Manager utility.

Subsections:

Syntax rules
Control statement example
Statements, keywords, and parameters
Tips for using wildcard characters

Syntax rules

The control statements for the Catalog Manager utility must adhere to the following syntax rules:

Control statements can be coded on any columns in the range of 2 - 80.
A statement with an asterisk (*) in column 1 is treated as a comment.
Each statement consists of a statement type, a keyword, and a parameter as follows:
```
statement-type keyword=parameter
```

Control statement example

The following figure shows an example of the FABXCIN control statements to validate DBD and PSBs.

Figure 1. Control statement example (validate function) Start of change

//FABXCIN    DD  *
     PROC   FUNC=CHECK_GENTIME
     REPORT TIMESTAMP=FORMAT1
*
     DBD NAME=HDAMDB1
     PSB NAME=* 
     END
/*

Statements, keywords, and parameters

PROC statement

Required statement. This statement must be coded on the first line.

To invoke the validate function, specify: FUNC=CHECK_GENTIME

The utility validates DBD and PSB members by comparing the ACBGEN time stamp of each DBD and PSB member in the ACB libraries to the time stamp of the corresponding DBD and PSB resource in the IMS™ catalog or the IMS directory.

REPORT statement

Optional statement. Use this statement to specify the format of the time stamps printed in the Catalog Validation report.

TIMESTAMP=

Specify either of the following values:

FORMAT1: Time stamps are reported in the following format: yyyy/mm/dd hh:mm:ss.th. This is the default value.

FORMAT2: Time stamps are reported in the following format: yydddhhmmssth.

DBD statement

Optional statement. Use this statement to select specific DBDs. Specify this statement with the following keyword and parameter:

NAME=resource_name: Specify a DBD name. You can use wildcard characters to create a pattern-matching expression that specifies more than one DBD.

PSB statement

Optional statement. Use this statement to select specific PSBs. Specify this statement with the following keywords and parameters:

NAME=resource_name: Specify a PSB name. You can use wildcard characters to create a pattern-matching expression that specifies more than one PSB.

END statement

Optional statement. Use this statement to indicate the end of the control statements.

Tips for using wildcard characters

To specify multiple DBDs or PSBs, specify a wildcard in any position of a character string. The asterisk (*) and the percent sign (%) are supported as wildcard characters. An asterisk represents 0 - 8 characters, and a percent sign represents a single character. If two or more asterisks are specified sequentially, only the first asterisk is recognized.

For example, you can specify the wildcard characters in the following ways:

Purpose	Coding example
Validate all DBD members in the ACB libraries	`DBD NAME=*`
Validate DBDs that have a name that begins with the letter H	`DBD NAME=H*`
Validate PSBs that have a name that begins with the letters ABC, have any letter as the fourth character, and contain 001 as the fifth to seventh characters	`PSB NAME=ABC%001`