This chapter summarizes CA Optimizer/II component option usage and alphabetically lists all the CA Optimizer/II options.
Whenever an option has both a compile-time and an execution-time usage, the compile-time usage is presented first. The term option refers to the control of functions at compile-time, execution-time, report-time, and view- time.
This section provides information on the following:
Optimizer options, like COBOL II options, can be specified in three ways:
nPARM='opt1,opt2,opt3,...' on your EXEC statement, or
You can freely combine your Optimizer options with COBOL II options on the EXEC and CBL statements. The processing of Optimizer options takes place on three separate levels. The order of precedence for specified options is the same as for the COBOL II compiler:
Any conflicting options are processed on each level individually. The levels are then processed together for conflicts. See Order of Precedence in Establishing Option Values later in this chapter for more information.
For example, if you specify PARM='LIST,OFFSET' on your EXEC statement, OFFSET is turned on. However, if you also specify CBL NOOFFSET in your source, OFFSET is turned off because the CBL statement takes precedence over the PARM statement.
Note: Any options not specified on the EXEC or CBL statement are determined by their values in the installation defaults. Any options that have been fixed in the installation defaults cannot be changed on any other level.
CA Optimizer/II allows you to abbreviate all compile-time options to the first three characters of their name. For example:
|
Compile-time Option |
Abbreviation |
|---|---|
|
MOFFSET |
MOF |
|
NOMOFFSET |
NOMOF |
You can override the default values at compile/optimize time by specifying options in one of the following:
Note: You can override defaults only if the option has not been fixed by your systems programmer at installation. The product is shipped with all defaults unfixed.
At compile-time, once all options have been scanned, their processing takes place in the following order of precedence:
|
Order |
Scanned Compile-time Options |
Force |
|---|---|---|
|
1 |
FDCHECK |
DTECT* |
|
2 |
ICICS |
CICS |
|
3 |
CICS |
NODTECT NODBGSLEEP |
|
4 |
NODTECT |
NOPFLOW and NOPARMCHK |
|
5 |
XCOUNT or XTIME |
SYM and MOFFSET |
|
6 |
MOFFSET |
NOOFFSET |
|
7 |
OFFSET |
NOLIST |
|
8 |
LIST |
NOSELECT |
|
9 |
CXREF |
NOXREF |
|
10 |
NOCOMPILE |
COBCC=0 |
|
11 |
MMAP |
NOMAP |
If the EDS option is set to EDS=YES at installation (in source member CAOUDFOX), the DTECT option will not be forced by WSINIT, FDCHECK, or SUBRNGCK.
**These options are no longer supported, but, if specified, they will force the TPMON option.
The following options, if specified on the PROCESS (CBL) statement, produce COBOL II warning message(s) (RC=4) but are processed by CA Optimizer/II:
Any options that are specified on the PROCESS(CBL) statement and are recognized only by CA Optimizer/II produce a compiler error message (RC=8).
The ICICS option will only take effect when it is specified on the JCL parameter list. If it is specified on the PROCESS(CBL) statement, it will produce a compiler error message (RC=8) and will not enable the integrated CICS translator of Enterprise COBOL for z/OS.
When compiling with Enterprise COBOL for z/OS, if the CICS option is specified on the PROCESS(CBL) statement, it will be processed as both the CICS option of the compiler (that is, it will enable the integrated CICS translator) and CICS option of CA Optimizer/II.
The following discussions on coding options and overriding defaults do not apply to the EOS runtime options. The EOS runtime options apply globally to all transactions containing EOS COBOL programs and cannot be overridden at the transaction level. The EOS runtime options are discussed in detail in the Installation Guide.
The general rules for coding keywords and their options at execution and report-time are:
You can specify:
You can also:
You can override option default values by specifying options in the card-image data set defined by the CAIOPTS DD statement. You can specify this DD statement at execution-time and report-time. If the Analyzer Reporter is to be automatically invoked at execution-time, the report-time options for Analyzer can be mixed freely with the execution-time options for both Detector and Analyzer.
You can override any option as long as it has not been fixed by your systems programmer at product installation time. The product is shipped with all defaults unfixed.
At view-time, you can override options through the Report Options panel of the CAIPRINT Repository Viewer. See the chapter "Using the CAIPRINT Repository Viewer" for more information.
The following table lists the options available at compile/optimize time:
|
Compile-time Options |
||||
|---|---|---|---|---|
|
To invoke Optimizer: |
COPT |
IDMSDC |
TPMON |
ICICS |
|
Environmental options: |
CICS |
MMAP |
PRTCOPY |
XMMAP |
|
Output producing options: |
CXREF |
XTIME |
|
|
|
Analyzer features: |
XCOUNT |
|
|
|
|
Detector features: |
DBGSLEEP |
PFLOW |
|
|
|
Other options: |
COBCC |
LINECOUNT |
SPM |
|
Specifies the percent full the PRTLIB dataset must reach to trigger a health check exception condition. If this percentage is reached the health check program will go into exception state and issue consol messages every 15 minutes until the problem is corrected.
The following table lists all Detector options available at compile-time, execution-time, and view-time:
|
Detector Options |
||
|---|---|---|
|
Compile-time |
Execution-time |
View-time |
|
DBGSLEEP |
Standard Options ACTONLY PGM Formatting Options ASMINST MRGDATA Data Management Control Blocks BLOCKS IOB VSAM Control Blocks ACB PLH |
ASMINST |
Some Detector features have both a compile-time and execution-time options. Also, the formatting options can be specified either at execution-time or at view-time.
You can specify the Detector compile-time options in one of the following ways:
You can freely combine Detector compile-time options with COBOL compiler options and other CA Optimizer/II options. The following is a list of Detector compile-time options. Their execution-time applications are discussed in detail in the chapter "Using Detector."
Detector execution-time options are provided to the Execution Monitor by the CAIOPTS data set. The view-time options are specified through the Report Options panel in the CAIPRINT Repository Viewer.
For more information on overriding Detector options, see the chapter "Using Detector."
The following table lists all Extended Detector options available at compile-time, execution-time, and view-time:
|
Extended Detector Options |
||
|---|---|---|
|
Execution-time |
|
View-time |
|
Standard Options BLLMAX REGMAX Formatting Options ASMINST MRGDATA
|
Data Management Control Blocks BLOCKS IOB
VSAM Control Blocks ACB PLH Log and Notify Options LOGROS LOGUNI
|
ASMINST |
You can specify the Extended Detector compile-time options in one of the following ways:
You can freely combine Extended Detector compile-time options with COBOL compiler options and other CA Optimizer/II options. The following is a list of Extended Detector compile-time options:
Note: The EDS option must be specified in the compile-time default CSECT, CAOUDFOX, to prevent these options from forcing DTECT.
Extended Detector execution-time options are provided to the Execution Monitor by the CAIOPTS data set. The view-time options are specified on the Report Options panel in the CAIPRINT Repository Viewer.
For more information on overriding Extended Detector options, see the chapter "Using Extended Detector."
Analyzer consists of two facilities: Counts and Timings. The two facilities can be used independently or together. Pictorially:
Analyzer
____________________________________
| |
(XCOUNT) (XTIME)
Executed (and Unexecuted) CPU time analysis by
Paragraph and Source Application, Load Module,
Statement Counts Program, Paragraph, and
Source Statement
You control Analyzer at compile-time, execution-time, and report-time. The following table lists the Analyzer Control options whose use is discussed in the chapter "Using Analyzer."
|
Analyzer Options |
||
|---|---|---|
|
Compile-time |
Execution-time |
Report-time |
|
XCOUNT XTIME |
BINDER STIMERM XCOUNT XREPORT XTIME |
CNTXREF SOURCEMAP INSTRMAP USERID PROCDIV |
You can specify the Analyzer compile-time options in one of the following ways:
You can freely combine Analyzer compile-time options with COBOL compiler options and with other CA Optimizer/II options.
The following is a list of Analyzer compile-time options. Their execution-time applications are discussed in detail in the chapter "Using Analyzer."
Analyzer execution-time options are provided to the Execution Monitor by the CAIOPTS data set. You can freely combine Analyzer execution-time options with Detector execution-time options.
The following is a list of Analyzer execution-time options. Their applications are discussed in the chapter "Using Analyzer."
Analyzer report-time options are provided to Analyzer Reporter using the CAIOPTS data set at report-time. If the Analyzer Reporter is to be automatically invoked at execution-time using XREPORT, you may freely combine Analyzer report-time options with both Detector and Analyzer execution-time options in the execution-time CAIOPTS data set.
The following is a list of the Analyzer report-time options. Their applications are discussed in detail in the chapter "Using Analyzer."
Generally, you can supply options in any order, but sometimes the order in which keywords appear can be significant. For example, if the same program-ID appears on both the SOURCEMAP and PROCDIV options, the last keyword processed is the controlling option.
The defaults for the keyword options cover all programs. Any overriding specification, such as SOURCEMAP PGMA, overrides the default, SOURCEMAP ALL in this instance. Of all the programs in the reporting step, only the one specified, in this case PGMA, will produce full source listing reports. Once you override an options' default, you must specify each parameter you want for the given option.
To reverse the option request, prefix each keyword option with NO. Do not insert a space between NO and the keyword. The following are some examples showing how to reverse the option request:
SOURCEMAP ALL NOSOURCEMAP PGMA
CNTXREF ALL NOCNTXREF PGMA
This feature is very useful when you are running several programs.
It is important to be aware of the possible differences between options using program-ID and those using CSECT to identify programs.
For those reports relating to the COBOL source listing (SOURCEMAP, CNTXREF, and PROCDIV), the name specified following the keyword must be identical to the name specified on the first program-ID statement of the COBOL program.
The CSECT name is the control section name actually assigned by the linkage editor. It is used mainly for reporting time measurement data for non-COBOL programs (INSTRMAP).
CSECT names are not necessarily associated with load module names. For COBOL programs, the first program-ID in the source program is the CSECT name. There are exceptions, however, where the load module name can be changed during link-edit. For this reason, the three source options SOURCEMAP, PROCDIV, and CNTXREF must use the COBOL program-ID for "name," and the INSTRMAP option must use the CSECT name for "CSECT."
This section lists the CA Optimizer/II options. The underlined options indicate the default values.
|
Option |
|
|
|---|---|---|
|
ACB ON|OFF Prints access method control blocks for open VSAM files in an Abend or Snap report. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
ACTONLY ON|OFF Used primarily for initial debugging in a multi-module environment. During Abend reporting, it indicates to print reports only for the program in the calling sequence which was most recently executed and is still active (when it has not yet executed its GOBACK). |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
AMB ON|OFF Prints access method blocks for open VSAM files in Abend or Snap Reports. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
AMBL ON|OFF Prints an access method block list for open VSAM files in an Abend or Snap report. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
ASMINST ON|OFF Displays the abending assembler instruction and associated operands on an Abend or Snap report. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
BINDER ON|OFF Specifies whether user load modules are accessed through the binder API function calls or the standard I/O macros. This option must set to ON for programs that reside in PDSE libraries. |
Synonym: Component:
When used: |
None Analyzer, Detector, Extended Detector Execution-time |
|
BINFRMT DEC|HEX Specifies whether to display binary data values in decimal display or hexadecimal format on the merged Data Division displays of an Abend or Snap report. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
BLLMAX 512|nnnn Because the length of an 01-item in the linkage section cannot always be determined, this option specifies the maximum number of bytes which are formatted for a BLL cell whose range is unknown. The maximum value is 4096. |
Synonym: Component: When used: |
None Extended Detector Execution-time |
|
BLOCKS ON|OFF A data management control block option which sets all control block options, including all VSAM control block options, either ON or OFF for an Abend or Snap report. This option overrides any previous control block options. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
CEEDUMP ON|OFF Specifies whether Detector forces the Language Environment (LE) option TERMTHDACT(MSG) after writing a Detector report for an application executing under LE. If TERMTHDACT(QUIET) or TERMTHDACT(MSG) are already in effect, this option is ignored. |
Synonym: Component: When used: |
None Detector Execution-time |
|
CICS|NOCICS Determines if the program is optimized for a CICS environment. CICS suppresses DBGSLEEP, DTECT, PARMCHK, PFLOW, XCOUNT, and XTIME. When compiling with Enterprise COBOL for z/OS, specifying the CICS option on the PROCESS(CBL) statement is not recommended, as it will be processed as both the CICS option of the compiler (that is, it will enable the integrated CICS translator) and CICS option of CA Optimizer/II. To enable the integrated CICS translator of Enterprise COBOL for z/OS under CA Optimizer, use the ICICS option. |
Synonym: Component: When used: |
CIC Optimizer Compile-time |
|
name CNTXREF|NOCNTXREF (name1,name2,…) ALL Indicates by program-ID the programs for which the Execution Count Cross-Reference report prints. You can produce this report only for those programs in which you are also obtaining a SOURCEMAP. |
Synonym: Component: When used: |
None Analyzer Report-time |
|
COBCC=8|nnnn This option is normally set at installation. It specifies the highest return code from the compiler that is acceptable to Optimizer. Optimizer must ordinarily work only with executable modules (no severe or terminating diagnostics). For this reason, you should not change this option except under special conditions. |
Synonym: Component: When used: |
None Optimizer Compile-time |
|
COPT|NOCOPT Instructs the Run Executive to invoke Optimizer after the compile. If you specify NOCOPT, only the compiler is invoked. |
Synonym: Component: When used: |
COP Optimizer Compile-time |
|
CXREF|NOCXREF Specifies that Optimizer produces a condensed cross-reference of referenced data items. CXREF is exclusive of XREF and produces the procedure name XREF with all procedure names listed. CXREF will be turned off if it is specified on the PROCESS(CBL) statement and XREF was not produced by the COBOL compiler. |
Synonym: Component: When used: |
CXR Optimizer Compile-time |
|
name DBGAWAKE ( name1,name2,…) ALL Activates debugging facilities at execution-time for one or more programs that were compiled using the DBGSLEEP compile-time option and any or all of the following compile-time options: XCOUNT, PFLOW, and SUBRNGCK. where name is the name of a COBOL CSECT (program-ID) which was compiled with DBGSLEEP. ALL may be specified in lieu of a list. ALL results in the activation of the debugging facilities in all programs optimized with the DBGSLEEP feature. See Production-time Enabling of Debugging Facilities (DBGSLEEP/DBGAWAKE) in the chapter "Using Detector" for a detailed discussion of DBGSLEEP/DBGAWAKE. |
Synonym: Component: When used: |
None Detector Execution-time |
|
DBGSLEEP|NODBGSLEEP Controls the masking of Detector facilities and is intended for a program's final compilation prior to being placed in production-status. DBGSLEEP causes PFLOW, DTECT, and XCOUNT (or any subset of these facilities) to be disabled in such a way that, should they ever be needed at a later time, they are available without requiring recompilation. When used with its companion execution-time option, DBGAWAKE, you can enable debugging facilities in otherwise production status programs without performing a recompile/relink of the program. |
Synonym: Component: When used: |
DBG Detector Compile-time |
|
DB2ACTIV ON|OFF Indicates whether Detector or Extended Detector displays summary information for only those packages and DBRMs that are active at the time of an Abend or Snap. If the option is set to OFF, Detector displays summary information for all of the packages and DBRMs defined to the DB2 plan. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
DCB ON|OFF Prints data control blocks for all open files in an Abend or Snap report. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
DCRDISP|NODCRDISP Indicates whether Optimizer produces a relative decimal byte displacement on the data map or merged data map listing instead of the hexadecimal relative byte displacement produced by the compiler. |
Synonym: Component: When used: |
DCR Optimizer Compile-time |
|
DEB ON|OFF Prints data extent blocks for all open files in an Abend or Snap report. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
DECK|NODECK Determines whether Optimizer produces the optimized object module on SYSPUNCH. |
Synonym: Component: When used: |
D or DEC Optimizer Compile-time |
|
DTECT|NODTECT Specifies to invoke the CA Optimizer/II Detector feature at execution-time. If you select DTECT, Detector automatically generates the CSL option so that the source is available for the Abend, Snap, and Intercepts reports. Unless NOCSL is specified, DTECT forces on CSL, MOFFSET, and MMAP. NODTECT suppresses PARMCHK and PFLOW. If CICS, IDMSDC, or TPMON is specified, DTECT is suppressed. |
Synonym: Component: When used: |
DTE Detector Compile-time |
|
DUMP ON|OFF Specifies whether Detector or Extended Detector forces or suppresses a system dump after it has completed its processing. If DUMP ON is in effect and a SYSUDUMP DD statement was not specified in the JCL, Detector dynamically allocates it. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
FDCHECK|NOFDCHECK Specifies whether Optimizer causes a user 1128 Abend at execution-time if a program attempts to move data to or from if a record of a file which is not OPEN or, for an input file, is at end-of-file. This option forces the DTECT option except when CICS, IDMSDC, or TPMON is specified at compile-time, or EDS=YES is specified in the defaults. For more details, see Detection of Invalid Record Area References in the chapter "Using Detector." |
Synonym: Component: When used: |
FDC Detector, Extended Detector Compile-time |
|
FILES ON|OFF Specifies whether Detector or Extended Detector displays all open files not already shown in the File Section display of an Abend or Snap report. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
FIRST128 ON|OFF Controls whether Detector or Extended Detector prints only the first 128 bytes of the current record of each open file or the entire record. This option affects both the File Section display and Open Files report of an Abend or Snap report. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
GRPADDR ON|OFF Controls whether Detector or Extended Detector displays the base locator, displacement and address of a group item on the merged Data Division displays of an Abend or Snap report. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
ICICS | ICICS('translator options') | NOICICS CA Optimizer/II synonym for the CICS option of Enterprise COBOL for z/OS. This option will enable the compiler's integrated CICS translator. Option overrides for the CICS translator may be passed as a suboption string, delimited by either quotes or apostrophes. ICICS should only be used with the Enterprise COBOL for z/OS compiler, to compile programs that contain EXEC CICS statements and that have not been processed by a separate CICS translator. ICICS may only be specified on the JCL parameter list and will not be recognized if specified on the PROCESS(CBL) statement. ICICS forces the CA Optimizer/II CICS option. For more information on using the integrated CICS translator of Enterprise COBOL for z/OS, see IBM's Enterprise COBOL for z/OS Programming Guide. |
Synonym: Component: When used: |
None Optimizer Compile-time |
|
IDMSDC|NOIDMSDC Indicates whether to optimize the program for an IDMSDC environment. IDMSDC suppresses XCOUNT, DTECT, PFLOW, XTIME, DBGSLEEP, and PARMCHK. |
Synonym: Component: When used: |
IDM Optimizer Compile-time |
|
CSECT INSTRMAP|NOINSTRMAP (CSECT1,CSECT2,…) ALL Indicates the programs by CSECT name for which the Instruction Detail report prints. |
Synonym: Component: When used |
None Analyzer Report-time |
|
INTERCEPTS 0|nnnnn Specifies whether Detector intercepts program interrupt processing when data exceptions (0C7s) or decimal divide-by-zero exceptions (0CBs) occur. Detector prints the Intercepts report and continues processing. You must set nnnnn to the total number of INTERCEPTS in the run that you will permit. The maximum number allowed is 32,767. If the number of exceptions goes beyond the limit you have specified, a Detector Abend report generates and the run terminates. To use INTERCEPTS, the DTECT, FDCHECK, PFLOW, SUBRNGCK, and/or WSINIT options must be specified at compile-time. You can use the INTERCEPTS feature in the same run with the SNAP feature. |
Synonym: Component: When used: |
None Detector Execution-time |
|
INTERTST Specifies whether to optimize the program for use with CA InterTest. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
IOB ON|OFF Prints input/output blocks for all open files in an Abend or Snap report. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
LINECOUNT (60)|(nnn) Indicates the number of lines on each page of output at compile-time. where nnn can be any integer from 10 to 255, inclusive. |
Synonym: Component: When used: |
LC Optimizer Compile-time |
|
LINECOUNT 60|nnn Specifies the number of lines on each page of output at execution-time. where nmn can be any integer from 10 to 255, inclusive. |
Synonym: Component: When used: |
LINECNT Execution Monitor Execution-time, report-time, view-time |
|
LINKAGE ALL|NONE Specifies whether to display (ALL) or suppresses (NONE) the program's Linkage Section in an Abend or Snap report. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
LIST|NOLIST Indicates whether Optimizer produces an object code listing. LIST and OFFSET options are mutually exclusive; LIST and MOFFSET are not. If both LIST and OFFSET are specified, OFFSET takes precedence. |
Synonym: Component: When used: |
PMAP Optimizer Compile-time |
|
LOCALSTOR ALL|NONE Specifies whether to display (ALL) or suppress (NONE) the program's Local-Storage Section in an Abend or Snap report. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
LOGROS ON|OFF Specifies whether to send a message describing the abend to the Advantage CA‑Roscoe user who submitted the job. You must establish a list of Advantage CA‑Roscoe job names in the Extended Detector defaults using the ROSCOE parameter. |
Synonym: Component: When used: |
None Extended Detector Execution-time |
|
LOGTSO ON|OFF Indicates whether to send a message describing the abend to the TSO user who submitted the job. |
Synonym: Component: When used: |
None Extended Detector Execution-time |
|
LOGUNI ON|OFF Indicates whether to send a message describing the abend to the Unicenter Network and Systems Management console. |
Synonym: Component: When used: |
None Extended Detector Execution-time |
|
LOWER|NOLOWER Specify LOWER only under the direction of CA Technical Support. LOWER may cause a decrease in optimization results. It is necessary only under certain conditions which are identifiable by CA Technical Support. |
Synonym: Component: When used: |
LOW Optimizer Compile-time |
|
MAP|NOMAP Indicates whether Optimizer produces a compiler data map. The MAP option is mutually exclusive of the MMAP option. If both are specified, the MMAP option takes precedence. |
Synonym: Component: When used: |
DMAP Optimizer Compile-time |
|
MMAP|NOMMAP Indicates whether to merge the compiler data map with the source listing. MMAP is mutually exclusive of the MAP option, with MMAP taking precedence. MMAP may be forced on by Detector or Analyzer options. For details, see Order of Precedence in Establishing Option Values earlier in this chapter. |
Synonym: Component: When used: |
MMA, MDMAP, or MDM Optimizer Compile-time |
|
MEMMAP ON|OFF Produces a display of the memory map (TGT, PGT, and DSA) in an Abend or Snap report. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
MERGEDB ON|OFF Indicates whether Detector or Extended Detector symbolically maps DB2, IDMS, and IMS data. If the option is set to ON, data item information such as the name, picture clause, and usage type is merged with the dump output for those areas. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
MOFFSET|NOMOFFSET Indicates whether to merge the Optimized condensed object listing onto the source listing. MOFFSET is exclusive of OFFSET, with MOFFSET taking precedence. You can use MOFFSET in addition to LIST or SELECT. MOFFSET is forced on by Analyzer options. For details, see Order of Precedence in Establishing Option Values earlier in this chapter. |
Synonym: Component: When used: |
MOF, MLIST or MLI Optimizer Compile-time |
|
MRGAUTO ON|OFF Indicates whether Detector or Extended Detector symbolically maps the data for PL/I automatic storage. If this option is ON, data item information such as name and definition is merged with the data. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
MRGBASED ON|OFF Indicates whether Detector or Extended Detector symbolically maps the data for PL/I based variables. If this option is ON, data item information such as name and definition is merged with the data. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
MRGCNTLD ON|OFF Indicates whether Detector or Extended Detector symbolically maps the data for PL/I controlled variables. If this option is ON, data item information such as name and definition is merged with the data. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
MRGDATA ON|OFF Indicates whether to set all data merging options either ON or OFF for an Abend or Snap report. This option overrides any previous merging options. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
MRGDSECT ON|OFF Indicates whether Detector or Extended Detector symbolically maps the data for Assembler storage areas when a USING is active. If this option is ON, data item information such as name and definition is merged with the data. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
MRGFILES ON|OFF Indicates whether Detector or Extended Detector symbolically maps the data in the File Section display of an Abend or Snap report. If the option is set to ON, data item information such as the name, picture clause, and usage type is merged with the data for the current logical record. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
MRGLINK ON|OFF Indicates whether Detector or Extended Detector symbolically maps the data in the Linkage Section display of an Abend or Snap report. If the option is set to ON, data item information such as the name, picture clause, and usage type is merged with the data. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
MRGLOCAL ON|OFF Indicates whether to symbolically map the data in the Local-Storage Section display of an Abend or Snap Report. If this option is ON, data item information such as the name, picture clause, and usage type is merged with the data. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
MRGPARMS ON|OFF Indicates whether Detector or Extended Detector symbolically maps the data for PL/I parameter storage. If this option is ON, data item information such as name and definition is merged with the data. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
MRGSTAT ON|OFF Indicates whether Detector or Extended Detector symbolically maps the data for PL/I static storage. If this option is ON, data item information such as name and definition is merged with the data. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
MRGWORK ON|OFF Indicates whether Detector or Extended Detector symbolically maps the data in the Working-Storage Section of an Abend or Snap report. If the option is set to ON, data item information such as the name, picture clause, and usage type is merged with the data. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
MXREF|NOMXREF Allows you to obtain a merged cross-reference on your source listing for both Data and Procedure Divisions. MXREF is turned off if it is specified on the PROCESS(CBL) statement and XREF was not produced by the compiler |
Synonym: Component: When used: |
MXR Optimizer Compile-time |
|
OBJECT|NOOBJECT Specifies whether to write an optimized object module to SYSLIN. Specify NOOBJECT when you want only the results of the Optimizer's source and object code analysis, but do not want to link and execute the program. |
Synonym: Component: When used: |
OBJ Optimizer Compile-time |
|
OFFSET|NOOFFSET Indicates whether Optimizer produces a condensed procedure map listing. OFFSET is mutually exclusive of MOFFSET and LIST. You can, however, use OFFSET and SELECT together, and Optimizer integrates the two outputs. |
Synonym: Component: When used: |
OFF, CLIST, or CLI Optimizer Compile-time |
|
OCCURS 1|nnnnnnnn|MAX Specifies to Detector the maximum number of table occurrences to symbolically map when using the merging options. If the option is set to a value lower than the number of occurrences in the table, the remainder of the table occurrences are dumped in hexadecimal format. If OCCURS MAX is specified, the option is set to its maximum value of 16777215. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
OPTRC= 0|nn This parameter is normally set at installation. It specifies the return code that Optimizer returns if any statements have been flagged unexecutable (UNEXEC) or unconditional (UNCOND). You can specify any integer from 0 to 99 inclusive. |
Synonym: Component: When used: |
None Optimizer Compile-time |
|
PARMCHK|NOPARMCHK Indicates whether Detector validity-checks the option list on entry to the COBOL program. A message is produced and execution is resumed if an invalid option list is found. Validity checking of the option list is not performed on calls to nested programs. PARMCHK forces the DTECT option. If NODTECT, CICS, TPMON, or IDMSDC is specified, PARMCHK is suppressed. |
Synonym: Component: When used: |
PAR Detector Compile-time |
|
PARMCHK ON|OFF Specifies whether option list validity checking is ON at execution-time. It is ON by default, which means that PARMCHK processing occurs for any program compiled using COBOL II or above with the PARMCHK option, or for any program compiled using OS/VS COBOL with the DTECT option. Specifying PARMCHK OFF at execution-time turns off the option for all programs compiled with PARMCHK. |
Synonym: Component: When used: |
None Detector Execution-time |
|
PFLOW|NOPFLOW Requests a Detector Paragraph Flow report of the last 64 paragraphs executed. It follows the Detector Abend or Snap report. You can override it by specifying the PFLOW OFF option at execution-time. PFLOW turns on DTECT. If NODTECT, CICS, IDMSDC, or TPMON is specified, PFLOW is suppressed. |
Synonym: Component: When used: |
PFL Detector Compile-time |
|
PFLOW ON|OFF|64|nnnn|mmk Turns PFLOW on or off at execution-time and optionally changes the size of the PFLOW table for each program optimized with PFLOW. The default (ON) results in up to 64 paragraph names being reported in a wraparound table for each program. You can specify ON or OFF, or you can specify a number in the format nnnnn or mmK. Specifying a number other than 0 or 0K turns PFLOW on at execution-time and changes the number of entries in the wraparound PFLOW table for each program. Specifying 0 or 0K turns PFLOW off at execution-time. If a number in the format nnnnn or mmk is specified, the number is rounded up to the nearest power of 2, not exceeding 32768. For example, specifying "PFLOW 1000" yields a PFLOW table for each program with 1024 entries; specifying "PFLOW 3K" yields a PFLOW table for each program with 4096 entries. In all cases, PFLOW must have been specified at compile-time. |
Synonym: Component: When used |
None Detector Execution-time |
|
PGM xxxxxxxx Specifies the job step program name of the application to be executed under the Execution Monitor. The Execution Monitor is part of the runtime system which sets up the execution environment for applications using any of the Detector or Analyzer features. This option is only used in special circumstances. It is only specified when the Execution Monitor (CAOCEM00) is the program being executed as the job step program. It identifies the load module name of the program you ordinarily specify as the job step program. For more information, see the chapter "Using Analyzer" and the Installation Guide. |
Synonym: Component: When used: |
None Detector Execution-time |
|
PLH ON|OFF Prints place holders for open VSAM files in an Abend or Snap report. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
name PROCDIV|NOPROCDIV (name1,name2,…) ALL Indicates by program-ID the program for which only the Procedure Division prints. All measurement data for all programs specified with this option prints next to the Procedure Division; the other divisions are omitted. This option allows you to make several Analyzer runs for the same program without having to produce the full program source listing each time. |
Synonym: Component: When used: |
None Analyzer Report-time |
|
PRTCOPY|NOPRTCOPY This Optimizer option prints (PRTCOPY) or suppresses (NOPRTCOPY) the printing of copy books (COPY statements encountered in the processing of programs) in the source listing. PRTCOPY does not override a COPY SUPPRESS statement in the source. Therefore, the PRTCOPY option only works for standard COPY statements (no SUPPRESS). |
Synonym: Component: When used: |
PRT Optimizer Compile-time |
|
PRTLIB repository_library_name Defines the data set name of the CAIPRINT repository library. When used, this option must name a repository library that has already been created and cataloged. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
PRTREPT BOTH|REPOS|PRTDD Indicates whether to write the CAIPRINT report to the central VSAM repository (REPOS), the CAIPRINT DD (PRTDD), or both. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
REGMAX (xxx,yyy)|(128,256) Indicates how many bytes of addressable storage to display before and after the address in each register for an Assembler program. xxx represents the number of bytes before, and must be within the range 0-4096. yyy represents the number of bytes after and must be within the range 0-32767. The REGMAX values must be enclosed in parentheses, and if both xxx and yyy are specified, they must be separated by a comma. If only xxx is specified, yyy is assumed to have the same value. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
RPL ON|OFF Prints a Request Parameter List for open VSAM files in an Abend or Snap report. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
RPTSZ80 ON|OFF Indicates whether Extended Detector forces all data in dump format to appear in an 80-column format. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
SAVEAREA ON|OFF Produces the Save Area Trace on an Abend report. The Save Area Trace displays the chained register save areas starting at the abending module. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
SAVEHEAP ON|OFF Indicates whether Detector or Extended Detector saves the LE heap storage when a report is created. SAVEHEAP ON is required at execution-time in order to use SHOWHEAP ON for LE enabled COBOL or Assembler programs. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
SELECT=(stmnt1,stmnt2-stmnt6,stmnt9,...) Specifies that a procedure map (PMAP or LIST) prints for only certain (selected) statements. When you indicate the statement number, Optimizer formats, in procedure map form, the entire Optimizer block of code that contains that statement number. It is possible to format multiple blocks. If PMAP is specified, SELECT is suppressed. Notes: You cannot specify more than 10 statement numbers in the option, but you can specify a range of statements by indicating the starting and ending statement numbers. For example, 600-650 is counted as two statement numbers but provides PMAP information for 51 lines. The statement numbers must appear in ascending order. If you specify only one statement or one group statement, omit the parenthesis. The statement numbers are the compiler-generated statement numbers, unless you have specified the compiler NUM option, in which case they are the user source statement numbers. Optimizer ignores the SELECT option if you have also specified PMAP or LIST. You can use SELECT with CLIST or MLIST, and Optimizer integrates the two outputs. |
Synonym: Component: When used: |
None Optimizer Compile-time |
|
SHOWHEAP ON|OFF Indicates whether Detector or Extended Detector displays the LE or PL/I heap storage when a report is displayed. SAVEHEAP ON is required at execution-time in order to use SHOWHEAP ON for LE enabled COBOL or Assembler programs. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
SHOWUNMRG ON|OFF|TBLS Indicates whether to display storage for unmerged data when symbolic merging has been requested for the section. If the section is being displayed in the standard dump format, SHOWUNMRG has no effect. Specify ALL to always display unmerged data, NONE to never display unmerged data, or TBLS to display unmerged data only for table elements after the OCCURS limit has been reached for each table. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
SNAP 0|nnnnn|ON|OFF Indicates whether Detector or Extended Detector generates a Snap report. You must specify the number of SNAPs to allow using nnnnn. The maximum number allowed is 32,767. To use SNAP, you must include a call to CAODSNAP in your source code wherever you want a snapshot to be taken. You may use the SNAP feature in the same run with the INTERCEPTS feature. If your program contains SNAP calls and you want to run it without them, you do not need to recompile; simply do not specify the SNAP option at all. WARNING! When using SNAP with Extended Detector, each call to CAODSNAP generates a separate SNAP report in your central VSAM repository. If your program contains multiple SNAP calls (or a SNAP call within a loop), you can write the output to the CAIPRINT DD alone, to avoid flooding the repository. See the PRTREPT option. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
SOURCE|NOSOURCE Specifies whether Optimizer produces a source listing on the standard SYSPRINT data set. NOSOURCE suppresses the source listing. However, the options, diagnostic messages, compiler statistics, and Optimizer statistics pages still appear. |
Synonym: Component: When used: |
S or SOU Optimizer Compile-time |
|
name SOURCEMAP|NOSOURCEMAP ( name1,name2,…) ALL Specifies the programs by program-ID for which the full Analyzer source listing prints. |
Synonym: Component: When used: |
None Analyzer Report-time |
|
SPM|NOSPM Specifies whether Optimizer generates the compiler generated code for restoring the program mask, on return from external subroutine calls. SPM causes Optimizer to generate the code. The SPM option's default value is ordinarily set at installation time and need not be specified thereafter. |
Synonym: Component: When used: |
None Optimizer Compile-time |
|
STATS|NOSTATS This Optimizer option is normally set at installation. It indicates whether the Optimizer component updates the statistics data set with the optimization results. |
Synonym: Component: When used: |
STA Optimizer Compile-time |
|
STIMERM ON|OFF Specifies whether Analyzer uses STIMERM instead of STIMER for time sampling. If XTIME OFF is specified, this option is ignored. |
Synonym: Component: When used: |
None Analyzer Execution-time |
|
SUBRNGCK|NOSUBRNGCK Specifies whether Optimizer generates code which tests each subscript or index value before it is used to ensure that it lies within the range defined for the subscripted data item. A subscript or index range violation results in a User 1125 abend from Detector or Extended Detector, or a S0C1 if neither Detector nor Extended Detector is in effect at execution-time. Consult the section on subscript range checking in the chapter "Using Detector" for details on usage. This option also forces the DTECT option except when CICS, IDMSDC, or TPMON is specified at compile-time or EDS=YES is specified in the defaults. |
Synonym: Component: When used: |
SUB, SSRANGE, or SSR Detector Compile-time |
|
SYM|NOSYM Indicates whether Optimizer writes symbolic information for the program to the PROTSYM file. If SYM is specified, a valid initialized PROTSYM file must be allocated to the PROTSYM DD. Analyzer options XCOUNT and XTIME force the SYM option. |
Synonym: Component: When used: |
CSL Optimizer Compile-time |
|
SYMDSN dsname Specifies to dynamically allocate the data set name of a symbolic file for retrieving symbolic information. The data set can be a PROTSYM file or a CSL library. The DDNAME used for dynamic allocation is determined by the value of SYMDD in the installation defaults module CAOUDFRX. SYMDSN is ignored when that DDNAME is already allocated. Using SYMDSN does not prevent the searching of other symbolic files defined in your installation defaults. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
TITLE[=xxxxxxxx]|NOTITLE Specifies to produce a title banner page using the COBOL program ID or a title name that you specify. The valid value is eight alphanumeric characters. |
Synonym: Component: When used: |
None Optimizer Compile-time |
|
TPMON|NOTPMON Specifies to optimize the program for a teleprocessing environment other than CICS or IDMSDC. This includes DCI, HOGAN, and SHADOW. TPMON need not be specified for programs to run in an IBM environment. This option is designed for programs to be run in user-written teleprocessing environments or in other teleprocessing monitors such as INTERCOM. TPMON suppresses XCOUNT, DTECT, PFLOW, XTIME, DBGSLEEP, and PARMCHK. |
Synonym: Component: When used: |
TPM Optimizer Compile-time |
|
UCB ON|OFF Prints unit control blocks for all open files in an Abend or Snap report. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
USERID 'your text'| 'CA' Indicates a user identification statement (1-60 bytes). You can change the default title during product installation. It is included in all report headings except for SOURCEMAP and PROCDIV, if a STATS file is not available. |
Synonym: Component: When used: |
None Analyzer, Detector Report-time, Execution-time |
|
VSAMIDX ON|OFF Prints the VSAM indexed control blocks for the index portion of an open VSAM file along with the control blocks for the data portion in an Abend or Snap report. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time |
|
WORKSTOR ALL|NONE Indicates whether Detector or Extended Detector displays (ALL) or suppresses (NONE) the program's Working-Storage Section display. |
Synonym: Component: When used: |
None Detector, Extended Detector Execution-time, view-time |
|
WSINIT|NOWSINIT Initializes all Working-Storage items which are not initialized by a VALUE clause to X'50'. This option also forces the DTECT option, except when CICS, IDMSDC, or TPMON are specified at compile-time, or EDS=YES is specified in the defaults. For details on usage, see Detection of Uninitialized Working-Storage (WSINIT) in the chapter "Using Detector." |
Synonym: Component: When used: |
WSI Detector, Extended Detector Compile-time |
|
WTO ON|OFF Indicates whether to send a message describing the abend to the job log (using WTO with ROUTCDE=11). |
Synonym: Component: When used: |
None Extended Detector Execution-time |
|
XCOUNT|NOXCOUNT Indicates whether to invoke Analyzer's Count feature at execution-time. If you specify XCOUNT, then MOFFSET and CSL are forced. If you specify CICS, IDMSDC, or TPMON then XCOUNT is suppressed. |
Synonym: Component: When used: |
XCO Analyzer Compile-time |
|
XCOUNT ON|OFF Specifies whether to collect count measurement data. If you specify XCOUNT at compile-time, you can specify XCOUNT either ON or OFF at execution-time. |
Synonym: Component: When used: |
None Analyzer Execution-time |
|
XDATA(your-text) Specifies default text to insert into the user stamp at compile-time. When used without user exit CAOPUX01, this text is inserted into the user stamp in the optimized object module. When used in conjunction with user exit CAOPUX01, this text is passed to the user exit in the text buffer pointed to by R1, and its length is passed in R0. |
Synonym: Component: When used: |
None Optimizer Compile-time |
|
XMMAP|NOXMMAP Specifies whether Optimizer suppresses data map information which cannot be merged with the source listing. An example of data map information which cannot be merged is COPY...SUPPRESS statements. XMMAP can only be used when MMAP is specified. |
Synonym: Component: When used: |
XMM, XMDMAP, or XMD Optimizer Compile-time |
|
XREF|NOXREF Specifies whether Optimizer produces a standard compiler cross-reference of all data items and procedure-names. XREF is mutually exclusive of CXREF with CXREF taking precedence |
Synonym: Component: When used: |
X or XRE Optimizer Compile-time |
|
XREPORT ON|OFF If this option is specified at execution-time and Counts and/or Timings were taken, the Analyzer Reporter is automatically invoked upon termination of the application. This occurs for normal terminations, as well as abending applications. Note: You can still execute Analyzer Reporter as a separate job step if you want by supplying a CAITIMSV DD statement and specifying XREPORT OFF. See the chapter "Using Analyzer" for more information. |
Synonym: Component: When used: |
None Analyzer Execution-time |
|
XTIME|NOXTIME Indicates whether to invoke the Analyzer's Timings feature at execution-time. If you specify XTIME, then MOFFSET and CSL are forced. If you specify CICS, IDMSDC, or TPMON, then XTIME is suppressed. |
Synonym: Component: When used: |
XTI Analyzer Compile-time |
|
XTIME ON|FIRST|OFF Using this option at execution-time takes timings during the execution of the application program. You can specify XTIME at execution-time in one of the following ways: ON (the default) initiates timings at the start of the first COBOL program which has been optimized with XTIME. FIRST starts timings at the first call to the Execution Monitor from any program in the application. The Execution Monitor is automatically invoked during execution from any program compiled with DTECT, FDCHECK, PFLOW, SUBRNGCK, WSINIT, XCOUNT, or XTIME. OFF indicates that no timings are to be taken. |
Synonym: Component: When used: |
None Analyzer Execution-time |
| Copyright © 2010 CA. All rights reserved. | Email CA about this topic |