Control statements for the MDA Reversal utility

The input for the MDA Reversal utility consists of control statements in the FABXMIN data set.

Control statement example

The following figure shows an example of the control statements for the MDA Reversal utility.

Figure 1. Control statement example for MDA Reversal
//FABXMIN DD *
  PROC FUNC=DECODE
  OPTION MDA_LIST=YES,
         FPDEDB_LIB=ACBLIB,
         RECON_ALT_DD=(RCN1,RCN2,
                       RCN3)
*
  MDA NAME=HDAMDB1 
  MDA NAME=D* 
  END
/*

Syntax rules

The control statements must adhere to the following syntax rules:

  • Control statements can start anywhere after the second column.
  • A statement with an asterisk (*) in column 1 is treated as a comment.
  • Option keywords in a statement must be separated by commas and must end with a blank. If a comma is used instead of a blank, the processing is continued to the next line.
  • Option values in brackets must be separated by commas and must end with a closing parenthesis. If a comma is used instead of a closing parenthesis, the processing is continued to the next line.

Statements and keywords

PROC statement
Required statement. This statement must be coded on the first line with the following keyword and parameter:
FUNC=DECODE
Converts DFSMDA members back into DFSMDA macros.
FUNC=MDA_LIST
Creates the Library Contents report without converting DFSMDA members to DFSMDA macros.
OPTION statement
Optional statement. Specify this statement with one or more of the following keywords:
FPDEDB_LIB=ACBLIB
This keyword is for DEDBs.

Prints FPDEDB for the DFSMDA TYPE parameter and the name of DEDB database in the output.

To specify this keyword, the following conditions must be met:
  • The ACBLIB DD statement is specified in the JCL.
  • The ACB library is consistent with the DFSMDA members.
When this keyword is specified, the utility obtains DEDB database names and DEDB area names from the ACB library. If the utility finds DEDB area names that match the names of DFSMDA members, it prints the following information:
  • TYPE=FPDEDB in the DFSMDA macro statement.
  • The name of the DEDB database (DBNAME=dbname) in the DFSMDA macro statement.
  • The name of the DEDB database in the DBD column of the Library Contents report (if a Library Contents report is requested.)
RECON_ALT_DD=ddname | (ddname1,ddname2,...)
Specifies alternate DD names for the RECON data sets. This keyword is applicable only when the utility converts DFSMDA members to DFSMDA macros.

The utility identifies the DFSMDA member with the specified name and prints TYPE=RECON on the DFSMDA macro statement. You can specify up to nine DD names using brackets. You can also use wildcard characters to create a pattern-matching expression that specifies more than one DD names.

MDA_LIST=
Specifies whether to generate the Library Contents report. This keyword is applicable only when the utility converts DFSMDA members to DFSMDA macros.
YES
The utility generates the Library Contents report. This is the default value.
NO
The utility does not generate the Library Contents report.
MDA statement
Required statement. Use this statement to select specific DFSMDA members. You can specify multiple MDA statements. Specify this statement with the following keyword:
NAME=resource_name

Specify the name of a DFSMDA member. You can use wildcard characters to create a pattern-matching expression that specifies more than one DFSMDA members.

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

Tips for using wildcard characters

To specify multiple names, 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
Select all DFSMDA members in the specified library MDA NAME=*
Select DFSMDA members that have a name that begins with the letter D MDA NAME=D*
Select DFSMDA members that begin with letters ABC, have any letter as the forth character, and contain 001 as the fifth to seventh characters MDA NAME=ABC%001