Control statements for the MFS Reversal utility

Control statements for the MFS Reversal utility specify the functions to be performed; they must be placed in the SYSIN data set.

Subsections:

Syntax rules

The control statements for the MFS Reversal utility consist of keywords and operands arranged in a simple fixed format.

  • Control statements can start anywhere after the second column.
  • Statements with an asterisk (*) in column 1 are treated as comments.
  • The comment statement is allowable between continuous statements.

Control statement keywords

The following control statement keywords can be used for the MFS Reversal utility:
DVCTBL
The optional DVCTBL statement specifies the suffix x to build the device table called DFSUDT0x. This table contains the device characteristics of symbolically referenced devices 3270-An. The default suffix is the character A. You can specify only one DVCTBL statement for each execution of the MFS Reversal program.

The operand for the DVCTBL statement is a single character.

The following example illustrates the specification of the DVCTBL statement.
   DVCTBL L
OPTION
The optional OPTION statement specifies whether to create or suppress the optional MFS Reversal utility outputs. The following outputs are controlled by the OPTION statements:
  • MFS utility program output statements
  • Cross-reference report
  • Copies of MFS control blocks and their associated control blocks
The OPTION statement supports three parameters. You can specify only one parameter for each OPTION statement. To specify multiple parameters, code multiple OPTION statements.
NORVRS
This option suppresses the creation of the MFS utility program output statements. However, a report of all formats used by the MIDs and MODs that are specified on the SELECT statement is produced.
NOXRPT
This option suppresses the creation and printing of the cross-reference report.
COPY=YES | NO
This option specifies whether the MFS Reversal utility copies the selected MFS control blocks and their associated control blocks from the IMS™ format library to the user-specified partitioned data set.
YES
Specifies the use of the copy function. The MFS Reversal utility copies the control blocks to the user-specified partitioned data set that is specified in the COPYFMT DD. When YES is specified, you can specify the REPLACE option.
REPLACE=YES | NO
This option specifies whether the copy function replaces the existing MFS control blocks in the user-specified partitioned data set that is specified in the COPYFMT DD. Specify this option after the COPY=YES option, on the same line, separated by a comma (,). Blank characters are not permitted between the options.
YES
Specifies that the copy function replaces the existing MFS control blocks.
Tip: When the partitioned data set contains many members to be replaced, specifying REPLACE=YES might degrade the performance and might also cause a shortage of data set space. If performance degradation or space shortage is a concern, remove the existing members and redefine the data set before you rerun the job.
NO
Specifies that the copy function does not replace the existing MFS control blocks. When a member with the same name is found, the copy function skips copying that member and processes the next member. REPLACE=NO is the default.
NO
Specifies that the copy function is not used. COPY=NO is the default.
The following examples illustrate the specification of the OPTION statement.
Example 1:
To suppress the creation of the MFS utility program output statements: 
   OPTION NORVRS
Example 2:
To suppress the creation and printing of the cross-reference report:
   OPTION NOXRPT
Example 3:
To enable the copy function and replace the existing MFS control blocks:
   OPTION COPY=YES,REPLACE=YES
Example 4:
To specify all the options:
   OPTION NORVRS
   OPTION NOXRPT
   OPTION COPY=YES,REPLACE=YES
SELECT
The SELECT statement is a required statement that specifies that the MFS Reversal program re-create the control statements for the MFS utility from the control blocks named as operands on the SELECT statement.

When the copy function is enabled by the OPTION statement, the MFS control blocks that are named as operands on the SELECT statement and their associated MFS control blocks are copied to a partitioned data set that is specified in the COPYFMT DD. The copy function copies the following control blocks:

  • MIDs and MODs that are referenced by the MIDs and MODs that are specified on the SELECT statement
  • DIFs and DOFs that are associated with the MIDs and MODs that are specified on the SELECT statement
  • MIDs and MODs that reference the DIFs and DOFs that are to be copied

You can specify only one SELECT statement for each execution of the MFS Reversal program.

Either of the following operands can be specified:
member_name
Specify the member names of the MID and MOD from which the source is to be generated. Only the names of the MID and MOD can be specified. The names of the DIF and DOF are not included in the list of names, as the MFS Reversal program gets these names from the corresponding MID and MOD control blocks.
At least one member must be selected. To specify multiple member names, the names must be separated by commas and must end with a blank. The list of names can be continued on the next line by placing a comma after the last name on the current line and continuing with names on the next line. If a comma is the last character on a line, it is assumed that the selection continues on the next line. A name must be contained on a single line.
ALL
This option specifies all MIDs and MODs.
The following examples illustrate the specifications of the SELECT statement.
Example 1:
   SELECT MID1,MID2,MOD1,MOD2
Example 2:
   SELECT MID1,
       MID2,
       MOD1
Example 3:
   SELECT ALL
EXCLUDE
The EXCLUDE statement works oppositely compared to the SELECT statement. The EXCLUDE statement specifies that the MFS Reversal program does not re-create the control statements for the MFS utility from the control blocks that are named as operands on the EXCLUDE statement. The MFS Reversal utility skips processing for each member of a MID, MOD, DIF, and DOF that is specified on the EXCLUDE statements.

If a name is specified on the SELECT statement as well as on the EXCLUDE statement, the EXCLUDE statement has precedence.

When MIDs or MODs are specified on the EXCLUDE statement and OPTION NOXRPT is not specified, the NXT= columns for the MIDs or MODs are blank and the MIDs or MODs are not displayed in the REFERENCED BY columns in the MID/MOD XREF report. Similarly, these columns are blank for the MIDs and MODs that refer to the DIFs and DOFs that are specified by the EXCLUDE statement.

Any specification made to the EXCLUDE statement does not affect the behavior of the copy function.

Up to 511 EXCLUDE statements can be specified for each execution of the MFS Reversal program.

The operand for the EXCLUDE statement is a name of an MID, MOD, DIF, or DOF from which the source is not to be generated. The name must be 1 - 8 characters and must be specified after the EXCLUDE keyword with one blank between. Only one name is allowed per EXCLUDE statement. DIF and DOF names start with two non-alphabetical characters and can include lower case characters. To refer to a DIF/DOF, use the third to eighth character of the name, in uppercase only, and prefix the name with **.

The following example illustrates the specification of the EXCLUDE statement. 
SELECT ALL  
EXCLUDE ABCD          MID or MOD name  
EXCLUDE **FBCUL       DIF or DOF name
Parent topic: MFS Reversal utility