XCHECK command


Use the XCHECK command to invoke the Cross Check utility.

Operands

This section describes the operands that the XCHECK command can contain.

TYPE =

The TYPE= operand specifies the type of cross checking that you want to perform. 

If the INDD= operand is specified, then it must refer to an ACB library. If the INDD= operand is specified, then it must refer to an ACB library.

image2019-1-7_10-38-58.png

Required or Optional

Required

Synonyms

None

Values

Valid values are listed in the TYPE= values table.

Default value

None

TYPE= values

TYPE value

Description

ACB

When you specify TYPE=ACB, the utility checks the DMB and PSB members of the ACB library against the corresponding members of the DBD and PSB libraries.

Required JCL statements include:

  • ACBLIB DD
  • DBDLIB DD
  • PSBLIB DD

If you specify TYPE=ACB, the MBR= and MBRLIST= operands are ignored.

DBD

When you specify TYPE=DBD, the utility checks each DBD load module that it finds in a DBD library to make sure that any DBD that it references is also in that same DBD library.

Required JCL statements include:

  • DBDLIB DD
  • SYSOUT DD

PSB

When you specify TYPE=PSB, the utility checks each PSB load module that it finds in a PSB library to make sure that any DBD that it references is also in a DBD library.

Required JCL statements include:

  • DBDLIB DD
  • PSBLIB DD
  • SYSOUT DD

RECON

When you specify TYPE=RECON, the utility checks each DBD definition that it finds in a RECON data set to make sure that a corresponding DBD is also in a DBD library.

Required JCL statements include:

  • DBDLIB DD
  • RECON1 DD

INDD=

The INDD= operand can be used to override the default value of the input DD statement.

image2019-1-7_10-46-47.png

Required or Optional

Optional

Synonyms

None

Values

Any valid DDname which identifies an appropriate input library or data set.

Default Value

The default input DDname is dependent on the TYPE= operand value. The TYPE= value table identifies the default DDname unless overriden by the INDD= operand.

TYPE= value

TYPE= value

Default INDD= value

ACB

ACBLIB

DBD

DBDLIB

PSB

PSBLIB

RECON

RECON1

ACBINDD=

Whenever an ACB library is needed, you must provide a DD JCL statement which points at the library. The default DDname is assumed to be ACBLIB. However, you may override the default by specifying the DDname in the ACBINDD= operand.

image2019-1-7_10-55-46.png

Required or Optional  

Optional

Synonyms 

None

Values

Any valid DDname which identifies an appropriate input library or data set.

Default value 

ACBLIB

DBDINDD=

Whenever a DBD library is needed, you must provide a DD JCL statement which points at the library. The default DDname is assumed to be DBDLIB. However, you may override the default by specifying the DDname in the DBDINDD= operand.

image2019-1-7_11-11-17.png

Required or Optional

Optional

Synonyms 

None

Values

Any valid DDname which identifies an appropriate input library or data set.

Default value

DBDLIB

REPORTS=

Use the REPORTS= operand to control the generation of several optional reports. Each REPORTS= suboperand refers to a specific report.

image2019-1-7_11-22-6.png

Required or Optional

Optional

Synonyms

None

Values

The valid values for each suboperand are YES or NO. The default suboperand value is YES.

When you specify ALL=, it refers to sub operands that apply to the value you specified for the TYPE= operand. For example, when you specify TYPE=PSB, REPORTS=ALL refers to the XREFDBD and XREFPCB suboperands.

The Applicable REPORTS= Suboperand values table indicates which suboperands are applicable depending upon the TYPE= operand value.

Default value

None

Applicable REPORTS= Suboperand values

Applicable Suboperand
Values

When TYPE=

ACB

DBD

PSB

RECON 

XREFDBD


x

x

x

XREFPCB



x


XREFDMB

x




XREFPSB

x




ACBSIZE

x




GENHIST

x




GENDATCK

x




ALL

x

x

x

x

MBR=

The MBR= operand specifies the name of the library members to be cross checked.

The MBR= and MBRLIST= operands are mutually exclusive. If neither the MBR= nor the MBRLIST= operands is specified, then all the members in the input library are selected.

If you specify TYPE=ACB, the MBR= operand is ignored.

image2019-1-7_12-17-45.png

Required or Optional

Optional

Synonyms

None

Values

mbrname. You can specify a wildcard name.

Default value

None


PSBINDD=

Whenever a PSB library is needed, you must provide a DD JCL statement which points at the library. 

image2019-1-7_11-15-21.png

Required or Optional

Optional

Synonyms

None

Values

Any valid DDname which identifies an appropriate input library or data set.

Default value

PSBLIB

You can override the default by specifying the DDname in the PSBINDD= operand.

MBRLIST=

The MBRLIST= operand specifies a list of DBD library member names to be cross checked. The list may contain up to 10 names. The list must be enclosed in a set of parentheses and the names must be separated with a comma.

The product processes the members by type, in alphabetical order. For example, a MBRLIST with ACBLIB will process the DMBs in alphabetical order followed by the PSBs in alphabetical order.

The MBR= and MBRLIST= operands are mutually exclusive. If neither the MBR= nor the MBRLIST= operands is specified, then all the members in the input library are selected.

If you specify TYPE=ACB, the MBRLIST= operand is ignored.

image2019-1-7_12-12-11.png

Required or Optional

Optional

Synonyms

None

Values

One to ten member names separated by commas. Wildcard names are not allowed.

Default value

None. You must specify at least one name.

Example XCHECK control statements

The following figure shows an example XCHECK control statement:

* SAMPLE "XCHECK" CROSS CHECK COMMANDS
 XCHECK TYPE=ACB
 XCHECK TYPE=DBD
 XCHECK TYPE=PSB
 XCHECK TYPE=RECON
 XCHECK TYPE=ACB,REPORTS=(GENHIST=NO,ACBSIZE=NO)
*

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*