The reformatting process is a standalone process, which functions independent of the validation process. The reformatting is performed on the original JCL statements, depending on the user's preferences. The reformatting process can be performed on procedures. The rules can reformat the following parts of JCL statements:
statement type - by specifying the column where the type begins
positional parameters - by specifying the columns where the first parameter begins and the last parameter ends, and the maximum number of parameters in the JCL record
keywords - by specifying the columns where the first keyword begins and the last keyword ends, the maximum number of parameters in the JCL record, and the order that the keywords appear in the JCL record
comments - by specifying the column where the comment begins
continuations - by specifying the column where the continuation begins
The rules do not reformat JCL records that are
added by Control-M
part of in-stream data
added by procedures and includes
The reformatting is performed after
Control-M resolution for JCL (AutoEdit variables are not resolved)
validation of JCL syntax
the enforcement process (if the enforcement also required at the same run - relevant only for batch execution)
The RFBRKEY parameter in CTJPARM controls reformatting when the rightmost column specified in a rule is reached while processing keyword positional subparameters.
Example:
Before formatting:
DISP=(NEW,CATLG,DELETE)
When RFBRKY=Y (default)
Remaining subparameters are moved to a new line, in accordance with the reformat rule.
After reformatting:
DISP=(NEW,
CATALG,..
When RFBRKEY=N
The reformat rule for positional parameters (if any) is ignored, and subparameters are not moved to a new line, except when column 71 is reached.
After reformatting:
DISP=(NEW,CATLG,DELETE)
The reformatting rules have a selection criteria through which the users can choose on which member, job name, and library the rule will be invoked.
The reformatting rules are saved in the rule library, OLPREFJ.REFRULES. The list for the reformatting rules, CTJRREF, is located in the OLPREFJ.PARM library.
Rule samples are provided for JOB, EXEC, and DD statements.