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.
//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.
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 |