JCLNeat Options › Description of JCLNeat Options › FORMAT

FORMAT

The FORMAT option specifies if the JCL is formatted before generating the output file.

This option has the following format:

FORMAT=Y|N|B

Y

Turns on formatting. This option is the default.

N

Turns off formatting (REXXMEM cannot be used with N).

B

Turns on Basic formatting. Basic formatting allows REXXMEM to be used while minimizing the changes to the original format JCL.

Usage notes:

• If you are using FORMAT=N without global string replacement, JCLNeat effectively performs a COPY operation.
• JCLNeat is designed to perform formatting. Therefore, you cannot specify FORMAT=N as a system installation default. Additionally, this option is not available under the ISPF environment.
• When FORMAT=B is specified, JCLNeat overrides several options to adjust them as needed based on the input JCL. Any values that are specified for these options are not used. These options include:

  CSC, ICSC, BCI, BNS, CDEL, CEC, JOBF, OPSC, PACK, AND RSYM.

• When using FORMAT=B, changes that REXX makes to the $CA.OPTRESET and $CA.OPTS variables are ignored. Changing JCLNeat Options from REXX is not supported when using Basic formatting.
• FORMAT=B minimizes changes to the original formatting, with the following exceptions:
  1. The output JCL includes changes that the REXXMEM user REXX routine makes. These changes could modify the lengths of parameters, add additional parameters, or add and delete entire statements. These changes affect the resulting JCL.
  2. Parameters that contain multiple subparameters, such as DCB=, COND=, VOL=, LABEL=, and PARM=, could possibly not format as entered. This format change occurs when they are split across multiple lines in the original JCL. Generally, if the parameter can fit on a single line then the multiple lines are consolidated on a single line. If the parameter requires multiple lines, the split of the parameter is done without regards for the original format. Comments that are contained within a parameter that was split across lines are moved to separate comment lines.