COBOL LP Command Descriptions and Syntax

This section describes the COBOL language processor commands and their parameters and values.

CICSTEST (CIC)

The CICSTEST command instructs the COBOL language processor to print either a warning or severe message regarding the status of the COBOL compile options for running a program in CICS.

The CICSTEST command does not flag illegal use of CICS verbs. Specifying the COBOL compiler option WORD (CICS) will flag illegal verb usage, but may cause compile failure with a RC=12. If this occurs, the CSS language processor will not be invoked and CICSTEST command will fail to execute.

NOOPTIONS (NOO):

(Default) Does not print either a warning or severe error message, even if the program was compiled with invalid options for CICS.

OPTIONS (O):

Specifies the options for controlling the CICS test error messages. Select from the following parameter values:

SEVERE (S): 

Prints a warning and a severe message if the program was compiled with invalid CICS options.

WARNING (W): 

Prints a warning message if the program was compiled with invalid CICS options.

NO (N): 

Does not print a message.

COBOL (COB)

The COBOL command controls the compiler listing destination. The parameter for the COBOL command is OUTPUT.

The following diagram illustrates the syntax for the COBOL command OUTPUT parameter.

OUTPUT (OU):

Specifies whether the compiler listing will be printed or written to a DDIO file. COBOL(OUTPUT(DDIO)) and PROCESSOR(OUTPUT(DDIO)) are mutually exclusive. The language processor uses the last-supplied parameter. Select from the following values:

NOPRINT (NOPR): 

(Default) Does not print the compiler listing.

PRINT (PR): 

Prints the compiler listing.

NODDIO (NODD): 

(Default) Does not write the compiler listing to a DDIO file.

DDIO (DD): 

Writes the compiler listing to a DDIO file.

BOTH (BO): 

Has the same effect as specifying COBOL(OUTPUT(PRINT,DDIO)).

NONE (NON):

Does not print the compiler listing and does not write it to a DDIO file.

CONDDDIO (CONDD)

The CONDDDIO command specifies that the source listing will be written to the source listing file unless the compiler return code exceeds x. The default is 4. Permissible values are 0-8.

The CONDDDIO command can only be used with the preprocessor.

The following diagram illustrates the syntax for the CONDDDIO command.

CONDERRL (CONDE)

The CONDERRL command, valid only for OS/VS COBOL and CA-OPTIMIZER, indicates that the hard copy listing will contain only error messages and lines in error if the compiler condition code is greater than x. If the compiler condition code does not exceed x, then all requested portions of the listing will be printed. If x is omitted, the value defaults to 4 for OS/VS COBOL and 6 for CA-OPTIMIZER.

The CONDERRL command can be used only with the preprocessor.

The following diagram illustrates the syntax for the CONDERRL command for OS/VS COBOL.

 The following diagram illustrates the syntax for the CONDERRL command for CA-OPTIMIZER.

CONDSTEP (CONDS)

The CONDSTEP command controls the condition code set by the postprocessor when it is invoked by the preprocessor. The CONDSTEP parameter is ignored when the postprocessor is invoked as a separate job step after the compile; the postprocessor return code is always used.

The CONDSTEP command can be used only with the preprocessor.

The following diagram illustrates the syntax for the CONDSTEP command.

 HIGHEST (HI):

(Default) The condition code will be set to the value of the COBOL language processor return code or the compiler return code, whichever is higher.

COMPILER (CO):

The condition code is always set to the compiler return code. This option is typically used to allow a subsequent linkedit step to execute when the compile executes normally but the postprocessor is unable to execute successfully.

DDIO (DD)

The DDIO command identifies the sections of the COBOL compiler listing that are written to the source listing file. The parameter for the DDIO command is OUTPUT.

The following diagram illustrates the syntax for the DDIO command OUTPUT parameter.

OUTPUT (OU):

Specifies the options for a source listing that is written to the source listing file.

NOFIND (NOFI): 

(Default) Does not generate records for enhanced FIND.

FIND (FI): 

Generates records needed for the enhanced FIND feature.

NOCOMPRESS (NOCO): 

(Default) Does not compress the compiler listing. The size of the LP source members is not reduced.

COMPRESS (CO): 

Enables compression. Depending on the size of your program and the options you set, the size of LP source members may be reduced.

XREF (XR): 

(Default) Writes the XREF sections of the listing.

NOXREF (NOXR): 

Does not write the XREF sections of the listing.

PMAP (PM): 

(Default) Writes the PMAP section of the listing.

NOPMAP (NOPM):

Does not write the PMAP section of the listing.

DMAP (DM): 

(Default) Writes the DMAP section of the listing.

NODMAP (NODM): 

Does not write the DMAP section of the listing.

LIST (LI): 

(Default) Writes the Assembler section of the listing.

NOLIST (NOLI): 

Does not write the Assembler section of the listing.

CLIST (CL): 

(Default) Writes the CLIST section of the listing.

NOCLIST (NOCL): 

Does not write the CLIST section of the listing.

OFFSET (OF): 

(Default) Writes the OFFSET section of the listing.

NOOFFSET (NOOF): 

Does not write the OFFSET section of the listing.

ESS

The ESS, Embedded Source Support, command controls whether the source listing is embedded in the program object or not. ESS has two options (YES and NO). For more information, see Embedded-Source-Support-listing.

NO:
NO is the default. NO specifies the source listing to not be embedded in the program object. Always specify for the following:

– IBM Enterprise COBOL lower than version  z/OS V5.0.

– IBM Enterprise PL/I for z/OS lower than version V4.5.

YES:
YES specifies the source listing to be embedded in the program object.

Available for:

– IBM Enterprise COBOL for z/OS V5.x or higher.

– IBM Enterprise PL/I for z/OS V4.5 and higher.

File-Overrides commands

The File-overrides commands are used to override the default file definitions. The following overrides are available:

• WRK0 - WRK4
• PRTI
• PRTO
• ERRM
• LOAD
• DECK

 The File-overrides commands can be used only with the postprocessor.

WRK0-WRK4 File-Overrides Commands

Specifies the work files. 

PRTI File-Overrides Command

Specifies the compiler listing input. 

 If you omit DD(ddname), the assumed ddname will be CWPPRTI.

PRTO File-Overrides Command

Specifies COBOL language processor output. 

 If you omit DD(ddname), the assumed ddname will be CWPPRTO.

ERRM File-Overrides Command

Prints the COBOL language processor error messages. 

 If you omit DD(ddname), the assumed ddname will be CWPERRM.

LOAD File-Overrides Command

Specifies the object library (indicated by the LOAD option of the compiler). 

If you omit DD(ddname), the assumed ddname will be CWPLOAD.

DECK File-Overrides Command

Specifies the object library (indicated by the DECK option of the compiler). 

 If you omit DD(ddname), the assumed ddname will be CWPDECK.

Optional Override Values

The keywords here cause the language processor to override its default values:

DDNAME (DD):

Specify a ddname instead of accepting the default ddname.

BLKSIZE (BLK):

Specify a decimal blocksize instead of accepting the default blocksize.

BUFFERS (BUF):

Specify a decimal number as the number of buffers instead of accepting the default number of buffers, which is 2. Only the first two buffers are used for buffering input/output. Extra buffers are used as in-core work space for the file. Therefore, records placed in the work space will never be written to the work files. If the storage is available, use the BUFFERS parameter with the BLKSIZE parameter to increase the language processor speed.

If the language processor is running in the MVS/XA or MVS/ESA environments, and is above the 16 MB line, a value of zero specifies that as much storage as is available will be used. Using zero places a greater amount of overhead on startup and should not be used for small programs.

LRECL (LR):

Specify a decimal number as the logical record length instead of accepting the default logical record size.

RECFM (RE):

Specify a record format instead of accepting the default record format. Valid formats include:

Use the INCLUDE command to include a library or sequential file member that contains another set of language processor options to be processed.

An included set of options can, in turn, include another set of options. If a recursive chain of INCLUDEs is encountered, the language processor will stop with an error message.

Duplicate or conflicting parameters are resolved as follows:

• Options are processed left to right.
• When an INCLUDE is encountered, the included member is processed immediately. Options following the INCLUDE will be processed after the included member is processed.
• The last option processed takes precedence.
• The sources of options are, in order of descending priority:
  • forced options in the COBOL language compiler installation default module
  • CBL options in the source file (or equivalent for other compilers)
  • PARM options on the EXEC card
  • options specified in the CWPPRMO data set
  • default options in the COBOL language compiler installation default module.

 The INCLUDE command can be used only with the preprocessor.

The following diagram illustrates the syntax for the INCLUDE command.

 ddname:

Specifies the DDNAME of the JCL statement that specifies the data set name. If a member is not specified, then the ddname must point to a sequential file or library member.

member:

Specifies the library member name. If the ddname is not specified, then the default CWPPRMO will be used and a comma must precede the member name.

LANGPARM (LANGP)

The LANGPARM command specifies parameters to be passed to the compiler invoked by the language processor. If the language processor is run as a separate job step, this option is ignored.

If you use the CWPPRMO data set to specify your compiler options, use the LANGPARM command so that the preprocessor can distinguish between compiler options and language processor options with the same name. The LANGPARM command allows the preprocessor to identify compiler options that conflict with language processor names, thus preventing unpredictable results. If you use the PARM statement to specify your compiler options, you can also use the LANGPARM command.

The LANGPARM command can be used only with the preprocessor.

The following diagram illustrates the syntax for the LANGPARM command.

Specifies a parameter to be passed.

LANGUAGE (LANG)

The LANGUAGE command specifies the type of compiler to be executed for the COBOL language preprocessor.

The LANGUAGE command is no longer required for the postprocessor.

The following diagram illustrates the syntax for the LANGUAGE command.

 The parameters you may select from are:

VSCOBOLII:

(Default) The language processor assumes a VS COBOL II listing if another compiler name cannot be determined.

VSCOBOL:

The language processor assumes an OS/VS COBOL I listing if the compiler cannot be determined.

VSCOBOLIIREL3:

The language processor assumes a VS COBOL II Release 3 listing if the compiler cannot be determined.

VSCOBOLIIREL4:

The language processor assumes a VS COBOL II Release 4 listing if the compiler cannot be determined.

COBOL/MVS:

The language processor assumes a COBOL for MVS and VM listing if the compiler cannot be determined.

COBOL/370:

The language processor assumes a COBOL/370 listing if the compiler cannot be determined.

COBOL/390:

The language processor assumes a COBOL for OS/390 listing if the compiler cannot be determined.

COBOLZ/OS

The language processor assumes an Enterprise COBOL for Z/OS listing if the compiler cannot be determined.

CA-OPTIMIZER:

The language processor will use the CA-OPTIMIZER tables for the version of COBOL that processed the listing. CA-OPTIMIZER can be specified with VSCOBOL or VSCOBOLII. If CA-OPTIMIZER is specified with VSCOBOL, then CA-OPTIMIZER III is invoked. If CA-OPTIMIZER is specified with VSCOBOLII, then CA-OPTIMIZER II is invoked.

PRINT (PR)

 The PRINT command identifies the sections of the listing that will be printed. The parameter for the PRINT command is OUTPUT.

The following diagram illustrates the syntax for the PRINT command OUTPUT parameter.

OUTPUT (OU):

Specifies the options for the listing that will be printed.

LIST (LI): 

(Default) Prints the Pseudo-Assembler section of the listing.

NOLIST (NOLI): 

Does not print the Pseudo-Assembler section of the listing.

CLIST (CL): 

(Default) Writes the CLIST section of the listing.

NOCLIST (NOCL): 

Does not write the CLIST section of the listing.

OFFSET (OF): 

(Default) Prints the Offset section of the listing.

NOOFFSET (NOOF): 

Does not print the Offset section of the listing.

XREF (XR): 

(Default) Prints the XREF sections of the listing.

NOXREF (NOXR): 

Does not print the XREF sections of the listing.

DMAP (DM): 

(Default) Prints the DMAP section of the listing for VS COBOL.

NODMAP (NODM): 

Does not print the DMAP section of the listing for VS COBOL.

PMAP (PM): 

(Default) Writes the PMAP section of the listing.

NOPMAP (NOPM): 

Does not write the PMAP section of the listing.

MAP (MA): 

(Default) Prints the MAP section of the listing for VS COBOL II.

NOMAP (NOMA): 

Does not print the MAP section of the listing for VS COBOL II.

SOURCE (SO): 

(Default) Prints the Source section of the listing.

NOSOURCE (NOSO): 

Does not print the Source section of the listing.

PROCESSOR (PROC)

The PROCESSOR command specifies the output parameters of the COBOL language processor. The PROCESSOR command parameters are:

• $AOFF
• $ASUP
• $BATCH
• $NG
• $NIDR
• $NO
• $NOWB
• BYPASS
• ERRORS
• IDENTYES or IDENTNO
• OFFSET
• OUTPUT
• POSITION and OFFSET (mutually exclusive)
• SCALELINE
• STATISTICS
• TEXT
• WARNINGS

$AOFF Parameter

Allows postprocessing of a listing with the OFFSET compiler option when using OPTIMIZE. If the $AOFF parameter is specified, you will receive a warning message indicating that the OFFSET option was used instead of LIST. $AOFF may cause unexpected results when using BMC AMI DevX Code Debug for TSO or BMC AMI DevX Code Debug for CICS to debug optimized code.

The following diagram illustrates the syntax for the $AOFF parameter.

$ASUP Parameter

If $ASUP is specified, the postprocessor will allow suppressed statements to be present in the listing. For more information on $ASUP, see Handling Suppressed Statements.

The following diagram illustrates the syntax for the $ASUP parameter.

 $NG Parameter

Specifies that the preprocessor’s support of COPY SUPPRESS will be bypassed. The following diagram illustrates the syntax for the $NG parameter.

 The $NG option should not be specified if the WORD option is used for alternative reserved words.

 $NIDR Parameter

Specifies that placement of the date and time stamp on the object module will be bypassed. The following diagram illustrates the syntax for the $NIDR parameter.

 $NO Parameter

Specifies that the preliminary compilation performed by the preprocessor will be bypassed. The preliminary compilation is normally used to determine the compiler options currently in effect. However, if you know that your options satisfy the requirements of the language processor, you can bypass the preliminary compilation to reduce the preprocessor’s execution time.

The following diagram illustrates the syntax for the $NO parameter.

Notes:

$NOWB Parameter

By default, the language processor will generate information to assist the BMC AMI DevX Workbench for Eclipse in navigation through the compiler listing. This results in the presence of a CWPWBNV DD statement in the job output after the language processor has completed execution. If the CWPWBNV DD output is not desired or if your installation is not using the Workbench, this additional output can be suppressed by specifying the $NOWB parameter.

BYPASS (BY) Parameter

Specifies whether to run the preprocessor and compiler without running the postprocessor. The following diagram illustrates the syntax for the BYPASS parameter.

NOBYPASS (NOBY):

(Default) Runs the postprocessor.

BYPASS (BY):

Does not run the postprocessor.

ERRORS (ER) Parameter

Specifies how the language processor error messages will be printed. The following diagram illustrates the syntax for the ERRORS parameter.

UPPER-CASE (UP):

(Default) Errors will print in uppercase letters.

MIXED-CASE (MI):

Errors will print in uppercase and lowercase letters.

IDENTYES or IDENTNO

By default, BMC AMI language processors attempt to add information to the object deck produced by a compiler (DD SYSLIN). This information assists BMC AMI products in locating the correct member in a BMC AMI Listing File. The Language Processors will, by default, add an IDENTIFY record to the object deck.

This IDENTIFY record is processed by the Linkage Editor or Binder when the object deck is transformed into a load module or program object. The data added to the load module or program object is non-executable, not loaded into memory when the module executes. It identifies the BMC AMI Listing File where the language processor stored its output for that program.

If you want to suppress this IDENTIFY card for a particular run of a Language Processor, you may supply the input PROCESSOR(IDENTNO) in the CWPPRMO input.

The default value is PROCESSOR(IDENTYES). You may alter this default by using the Customer Modification Facility (see Using-the-Customer-Modification-facility). If you alter the default to IDENTNO, you may then wish to supply the input PROCESSOR(IDENTYES) in CWPPRMO, for an individual execution of the Language Processor.

OFFSET (OFF) Parameter

Specifies whether offset data will be used in the From-Through data of the enhanced listing Data Division section. The POSITION and OFFSET parameters are mutually exclusive.

The following diagram illustrates the syntax for the OFFSET parameter.

 OFFSET (OFF):

(Default) Offset data will be used.

NOOFFSET (NOOFF):

Positional data will be used.

OUTPUT (OU) Parameter

Defines options for printing the enhanced listing or writing it to a source listing file. The COBOL(OUTPUT(DDIO)) and PROCESSOR(OUTPUT(DDIO)) are mutually exclusive. The language processor uses the last-supplied parameter.

The following diagram illustrates the syntax for the OUTPUT parameter.

 PRINT (PR):

(Default) Prints the enhanced listing.

NOPRINT (NOPR):

Does not print the enhanced listing.

NODDIO (NODD):

(Default) Does not write the enhanced listing to a source listing file.

DDIO (DD):

Writes the enhanced listing to a source listing file.

BOTH (BO):

Has the same effect as specifying PROCESSOR(OUTPUT(PRINT,DDIO)).

NONE (NON):

Does not print the enhanced listing and does not write it to a source listing file.

POSITION (POS) Parameter

Specifies whether positional data will be used in the From-Through data of the enhanced listing Data Division section. The POSITION and OFFSET parameters are mutually exclusive.

The following diagram illustrates the syntax for the POSITION parameter.

 POSITION (POS):

(Default) Positional data will be used.

NOPOSITION (NOPOS):

Offset data will be used.

SCALELINE (SCA) Parameter

Specifies whether a scale line will be added to the enhanced listing. The following diagram illustrates the syntax for the SCALELINE parameter.

 SCALELINE (SCA):

(Default) A scale line will be added.

NOSCALELINE (NOSCA):

A scale line will not be added.

STATISTICS (ST) Parameter

Specifies whether to include statistics in the enhanced listing that compare the number of lines and pages the COBOL language processor printed to the number of lines and pages of the compiler listing. These statistics provide an effective means of showing the savings achieved by reformatting the compiler listing into the enhanced listing.

The following diagram illustrates the syntax for the STATISTICS parameter.

 STATISTICS (ST):

(Default) Prints all the statistics.

NOSTATISTICS (NOST):

Suppresses the printing of certain statistics.

To print all of the statistics, you must also use the TEXT parameter. If all statistics are requested without using the TEXT parameter, the net effect will be that of specifying NOSTATISTICS; that is, certain statistics will be omitted.

TEXT (TE) Parameter

Specifies when text is generated by the language processor. The TEXT parameter causes the COBOL language processor to enhance the object module by appending non-executable text code to it. The text code generated by the TEXT parameter is used only by BMC AMI DevX Abend-AID to provide Abend-AID/COBOL support.

The following diagram illustrates the syntax for the TEXT parameter.

 ALL (AL):

(Default) Generates text for the COBOL program. If you use the postprocessor when TEXT=ALL, you must specify either CWPLOAD or CWPDECK as input to the postprocessor step.

NONE (NON):

Does not generate any text.

 WARNINGS (WA) Parameter

Specifies where warning messages are placed in the enhanced listing. The following diagram illustrates the syntax for the WARNINGS parameter.

 BOTH (BO):

(Default) Prints and embeds warning messages.

NONE (NON):

Does not print or embed warning messages.

FRONT (FR):

Prints warnings in the front of the listing.

NOFRONT (NOFR):

Does not print warnings.

EMBED (EM):

Embeds warnings after the appropriate statement.

NOEMBED (NOEM):

Does not embed warnings.

PROGRAM-NAME (PRO)

The PROGRAM-NAME command specifies an override name for members in the source listing file.

The following diagram illustrates the syntax for the PROGRAM-NAME command.

name:

Specifies an alternative name for a source listing written to the source listing file.

SYSTEM (SYS)

The SYSTEM command performs miscellaneous functions. The following diagram illustrates the syntax for the SYSTEM command.

ESORT:

Specifies that an estimated sort count will be used instead of an actual sort count. The language processor keeps track of how many records should be fed into the sort phase. If a discrepancy exists, a sort error will occur and the language processor stops. This option allows the language processor to continue if a discrepancy exists.

TRACE (TR):

Specifies that the internal trace will be printed to CWPERRM.

TIME (TI):

Specifies that the internal time will be printed with the trace.

PTF:

Specifies that the PTF numbers currently installed on the CSS library will be printed. PTF is used by BMC Technical Support during problem diagnosis.

ZAP:

Specifies that the PTF numbers currently installed on the CSS library will be printed. ZAP is used by BMC Technical Support during problem diagnosis.

ZIIP  (ZIIP)

The ZIIP command controls the use of an available zIIP processor.  The command provides a mechanism to disable zIIP use by the language processor, and to control memory usage and dump options when zIIP processing is enabled.  The following diagram illustrates the syntax of the ZIIP command:

YES:

Indicates that zIIP processing is to be enabled. This is the default.

NO:

Indicates that zIIP processing is disabled and all language processing will execute on a general purpose processor. Alternately, zIIP processing can also be disabled by including a //CXZPIGNRDDDUMMY statement in the language processor JCL stream.

MEM64:

Indicates that 64-bit memory will be used during language processing.  This is the default.

MEM31:

Indicates that normal 31-bit memory will be used during language processing.

DUMP:

Indicates that a machine readable dump will be taken if the language processor abends while processing during zIIP execution.  This is the default.

NODUMP:

Indicates that a machine readable dump will be suppressed if the language processor abends while processing during zIIP execution.