COBOL compiler options

Important

Enterprise COBOL for z/OS 6.2, 6.3, 6.4 is the latest compatible compiler version.


The following is a list of the COBOL compiler options that must be used with the COBOL language processor.

Enterprise COBOL for z/OS 6.1, 6.2, 6.3 and 6.4

  • LIST

Tip

We recommend that you use the LIST option, instead of OFFSET to support the Abend-AID Perform Flow feature. The OFFSET parameter might cause unpredictable results when using BMC AMI DevX Code Debug for TSO or BMC AMI DevX Code Debug for CICS to debug optimized code. For more information, see $AOFF Parameter.

  • MAP
  • NONUMBER (BMC AMI DevX Code Debug for TSO and BMC AMI DevX Code Debug for CICS)
  • OPTIMIZE(0)

Tip

While we recommend you use OPT(0) , you can also use the OPT(1/2) compiler option. For more information about when to specify OPT(1/2), see Working-with-the-compiler-optimizer-and-Code-Debug.

Also, please note that documentation compiler optimization causes significant challenges in debugging and determining the cause of optimized program failures. For a detailed understanding of COBOL V5/6 optimization implementation, read our blog about compiler optimization.

  • SOURCE

Important

You can use SOURCE(DEC) or SOURCE(HEX) for Enterprise COBOL for z/OS 6.3 and later.

  • XREF or XREF(SHORT) or XREF(FULL)

Enterprise COBOL for z/OS Z/OS 5.1 and 5.2

  • LIST

Tip

We recommend that you use the LIST option, instead of OFFSET to support the Abend-AID Perform Flow feature. The OFFSET parameter might cause unpredictable results when using BMC AMI DevX Code Debug for TSO or BMC AMI DevX Code Debug for CICS to debug optimized code. For more information, see $AOFF Parameter.

  • MAP
  • NONUMBER (BMC AMI DevX Code Debug for TSO and BMC AMI DevX Code Debug for CICS)
  • OPTIMIZE(0)
  • SOURCE
  • XREF or XREF(SHORT) or XREF(FULL)

Enterprise COBOL for z/OS 4.1 and 4.2

  • LIST

Tip

We recommend that you use the LIST option, instead of OFFSET to support the Abend-AID Perform Flow feature. The OFFSET parameter might cause unpredictable results when using BMC AMI DevX Code Debug for TSO or BMC AMI DevX Code Debug for CICS to debug optimized code. For more information, see $AOFF Parameter.

  • MAP
  • NONUMBER (BMC AMI DevX Code Debug for TSO and BMC AMI DevX Code Debug for CICS)
  • SOURCE
  • XREF or XREF(SHORT) or XREF(FULL)

Enterprise COBOL for z/OS and OS/390 3.1 and 3.2

Enterprise COBOL for z/OS 3.3 and 3.4

  • LIST

Tip

We recommend that you use the LIST option, instead of OFFSET to support the Abend-AID Perform Flow feature. The OFFSET parameter might cause unpredictable results when using BMC AMI DevX Code Debug for TSO or BMC AMI DevX Code Debug for CICS to debug optimized code. For more information, see $AOFF Parameter.

  • MAP
  • NONUMBER (BMC AMI DevX Code Debug for TSO and BMC AMI DevX Code Debug for CICS)
  • SOURCE
  • XREF or XREF(SHORT) or XREF(FULL)

COBOL for OS/390 & VM 2.1,  2.1.1 (MLE Support) and 2.2

  • LIST

Tip

We recommend that you use the LIST option, instead of OFFSET to support the Abend-AID Perform Flow feature. The OFFSET parameter might cause unpredictable results when using BMC AMI DevX Code Debug for TSO or BMC AMI DevX Code Debug for CICS to debug optimized code. For more information, see $AOFF Parameter.

  • MAP
  • NONUMBER (BMC AMI DevX Code Debug for TSO and BMC AMI DevX Code Debug for CICS)
  • SOURCE
  • XREF or XREF(SHORT) or XREF(FULL)

COBOL for MVS & VM 1.2.1 and 1.2.2 (MLE Support)

  • LIST

Tip

We recommend that you use the LIST option, instead of OFFSET to support the Abend-AID Perform Flow feature. The OFFSET parameter might cause unpredictable results when using BMC AMI DevX Code Debug for TSO or BMC AMI DevX Code Debug for CICS to debug optimized code. For more information, see $AOFF Parameter.

  • MAP
  • NONUMBER (BMC AMI DevX Code Debug for TSO and BMC AMI DevX Code Debug for CICS)
  • SOURCE
  • XREF or XREF(SHORT) or XREF(FULL)

COBOL/370 1.1

  • MAP
  • NONUMBER (BMC AMI DevX Code Debug for TSO and BMC AMI DevX Code Debug for CICS)
  • OFFSET or LIST

Tip

We recommend that you use the LIST option, instead of OFFSET when using OPTIMIZE with COBOL/370 or VS/COBOL II. The PROCESSOR($AOFF) parameter is available for post-processing the listing with the OFFSET compiler option. The OFFSET parameter might cause unpredictable results when using BMC AMI DevX Code Debug for TSO or BMC AMI DevX Code Debug for CICS to debug optimized code. For more information, see $AOFF Parameter.

  • SOURCE
  • XREF or XREF(SHORT) or XREF(FULL)

Important

  • All the options required by COBOL compiler is also required by CA-OPTIMIZER.
  • These options are not forced by the language preprocessor during the preliminary compile phase. For more information, see PROCESSOR (PROC).

VS/COBOL II (all releases)

  • ALOWCBL
  • MAP
  • NOFDUMP (BMC AMI DevX Code Debug for TSO)
  • NONUMBER (BMC AMI DevX Code Debug for TSO and BMC AMI DevX Code Debug for CICS)
  • OFFSET or LIST

Tip

We recommend that you use the LIST option, instead of OFFSET when using OPTIMIZE with COBOL/370 or VS/COBOL II. The PROCESSOR($AOFF) parameter is available for post-processing the listing with the OFFSET compiler option. The OFFSET parameter might cause unpredictable results when using BMC AMI DevX Code Debug for TSO or BMC AMI DevX Code Debug for CICS to debug optimized code. For more information, see $AOFF Parameter.

  • SOURCE
  • XREF or XREF(SHORT) or XREF(FULL) 

Important

When you use the TEST compile option, IBM will add extra statements to the assembler section of the listing. These statements are not added to the CLIST section that is generated when the OFFSET option is specified. We recommend that you use the LIST compile option instead of the OFFSET compile option.

OS/VS COBOL

  • CLIST or PMAP
  • DMAP
  • NOBATCH
  • NOCDECK
  • NOFDECK
  • NOFLOW (BMC AMI DevX Code Debug for TSO)
  • NOLST
  • NOSTATE (BMC AMI DevX Code Debug for TSO only)
  • NOSYMDMP
  • SOURCE
  • VERB
  • XREF or SXREF

CA-OPTIMIZER II 

  • LIST or OFFSET or MOFFSET or CLIST or PMAP or MLIST
  • MAP or DMAP or MMAP or MDMAP
  • NOCXREF
  • NOXMDMAP
  • XREF or MXREF

Important

This is a COBOL installation option that cannot be overridden by the EXEC parameter. 

CA-OPTIMIZER III 

  • CLIST or PMAP or MLIST (BMC AMI DevX Code Debug for TSO requires PMAP)
  • DMAP or MDMAP
  • NOCSL (BMC AMI DevX Code Debug for TSO only) 
  • NOCSXREF
  • NOCXREF
  • NOXCOUNT (BMC AMI DevX Code Debug for TSO only)
  • NOXMDMAP

Important

  • All the options required by COBOL compiler is also required by CA-OPTIMIZER.
  • These options are not forced by the language preprocessor during the preliminary compile phase. For more information, see PROCESSOR (PROC).
  • This option is required for CSS releases earlier than 7.8.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*