Control statements for the DBD/PSB/ACB Mapper utility

The input to the DBD/PSB/ACB Mapper utility consists of control statements in the SYSIN data set. These control statements contain keywords that indicate the functions and the names of the DBDs, PSBs, or ACBs for which reports and maps are created.

This data set usually resides in the input data stream. However, it can be defined as a sequential data set or a member of a partitioned data set. It must contain one 80-byte fixed-length record for each DBD, PSB, and ACB processed. The block size, if coded, must be a multiple of 80.

The order in which the reports and maps are written to the data set is DBD, PSB, PSB-type ACB, and DBD-type ACB. The members in each group are ordered alphabetically.

Subsections:

Control statement example

The SYSIN data set can be coded as shown in the following figure.
Figure 1. Examples of control statements for DBD/PSB/ACB Mapper
   //SYSIN DD *
       DBD=member
       DBD=member,X
       PSB=member
       PSB=member,X
       ACB=member
       ACB=member,X
       ACBDBD=member
       ACBDBD=member,X
   /*

Syntax rules

The control statements for DBD/PSB/ACB Mapper must adhere to the following syntax rules:

  • Control statements can be coded anywhere between columns 2 - 80.
  • In the control statement field, keyword, equal sign, member name, comma, and X must not be separated by blanks. Because a blank serves as the delimiter, only a comment can be written after a blank.
  • A statement with an asterisk (*) in column 1 is treated as a comment.
  • The control statements can be specified in any order. For example, in the following order:
          ACB=XXXXXXXX
      PSB=XXXXXXXX
      PSB=XXXXXXXX
      ACB=XXXXXXXX
      DBD=XXXXXXXX
      ACBDBD=XXXXXXXX

Control statement keywords

The control statement formats are as follows:
DBD=member
This control statement shows the format used for obtaining both the DBD map and the DBD report.
DBD=member,X
This control statement is used for obtaining only a DBD map. The member is followed by a comma and a non-blank character.
PSB=member
This control statement is used for obtaining the PSB Summary report, PSB Maps, and PSB reports of all DBDs relating to this PSB.
PSB=member,X
This control statement is used for obtaining the PSB Summary report and the PSB maps of all associated DBDs. The member is followed by a comma and a non-blank character.
ACB=member
This control statement is used to obtain the ACB (PSB) Summary report, ACB (PSB) Maps, and ACB (PSB) reports of all associated ACBs.
ACB=member,X
This control statement is used to obtain the ACB (PSB) Summary report and the ACB (PSB) Maps of all associated DBDs. The member is followed by a comma and a non-blank character.
Note: The ACB library member member following the ACB= keyword must be a PSB-type. Otherwise, an error message is issued and the processing of this member is skipped.
ACBDBD=member
This control statement is used to obtain the ACB (DBD) Maps and the ACB (DBD) report.
ACBDBD=member,X

This control statement is used to obtain only ACB (DBD) Maps. The member is followed by a comma and a non-blank character.

Note: The ACB library member member following the ACBDBD= keyword must be a DBD-type. Otherwise, an error message is issued and the processing of this member is skipped.
Note: You can specify a wildcard at any position in 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.

Quick reference for control statements and DD statements

The following table lists the DBD/PSB/ACB Mapper functions, control statements, and DD statements.

Table 1. DBD/PSB/ACB Mapper functions, control statements, and DD statements
Function Control keyword Required DD statements
SYSPRINT DD SYSOUT DD DBDLIB DD PSBLIB DD ACBLIB DD SYSIN DD
DBD map DBD= Required Required Required Required
PSB map PSB= Required Required Required Required Required
ACB map ACB=
ACBDBD= 		Required Required Required Required
Parent topic: DBD/PSB/ACB Mapper utility