Previous Topic: Data Management Control Block OptionsNext Topic: Troubleshooting


Options Listing

The following table displays the CA SymDump Batch options:

Note: 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

Reporting

Execution time

AMB ON|OFF

Prints access method blocks for open VSAM files in Abend or Snap Reports.

Synonym:

Component:

When used:

None

Reporting

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

Reporting

Execution time

ASMINST ON|OFF

Displays the abending assembler instruction and associated operands on the Abend page.

Synonym:

Component:

When used:

None

CAIPRINT Formatter

Execution time, view 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

CAIPRINT Formatter

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

Reporting

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

Reporting

Execution time

DB2ACTIV ON|OFF

Indicates whether to display 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, summary information is displayed for all of the packages and DBRMs defined to the DB2 plan.

Synonym:

Component:

When used:

None

Reporting

Execution time

DCB ON|OFF

Prints data control blocks for all open files in an Abend or Snap report.

Synonym:

Component:

When used:

None

Reporting

Execution time

DEB ON|OFF

Prints data extent blocks for all open files in an Abend or Snap report.

Synonym:

Component:

When used:

None

Reporting

Execution time

DUMP ON|OFF

Specifies whether to force or suppress a system dump after it has completed its processing.

Synonym:

Component:

When used:

None

Reporting

Execution time

FILES ON|OFF

Specifies whether to display all open files not already shown in the File Section display of an Abend or Snap report.

Synonym:

Component:

When used:

None

CAIPRINT Formatter

Execution time, view time

FIRST128 ON|OFF

Controls whether to print 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

CAIPRINT Formatter

Execution time, view time

GRPADDR ON|OFF

Controls whether to display 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

CAIPRINT Formatter

Execution time, view time

IOB ON|OFF

Prints input/output blocks for all open files in an Abend or Snap report.

Synonym:

Component:

When used:

None

Reporting

Execution time

LINECOUNT 60|nnn

Specifies the number of lines on each page of output at execution time or view time. where nnn can be any integer from 10 to 255, inclusive.

Synonym:

Component:

When used:

LINECNT

CAIPRINT Formatter

Execution time, view time

LINKAGE ALL|NONE

Specifies whether to display (ALL) or suppress (NONE) the program's Linkage Section in an Abend or Snap report.

Synonym:

Component:

When used:

None

CAIPRINT Formatter

Execution time, view time

LISTLINE=0|nn

Specifies the number of additional listing lines to be merged into a report before and after the source statement at abend, snap, or transfer.

Synonym:

Component:

When used:

None

CAIPRINT Formatter

Execution time, view 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

CAIPRINT Formatter

Execution time, view time

LOGROS ON|OFF

Specifies whether to send a message describing the abend to the CA Roscoe user who submitted the job. You must establish a list of CA Roscoe job names in the CA SymDump BatchCA SymDump Batch defaults using the ROSCOE parameter.

Synonym:

Component:

When used:

None

Reporting

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

Reporting

Execution time

LOGUNI ON|OFF

Indicates whether to send a message describing the abend to the CA Unicenter NSM console.

Synonym:

Component:

When used:

None

Reporting

Execution 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

CAIPRINT Formatter

Execution time, view time

MERGEDB ON|OFF

Indicates whether to symbolically map 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

CAIPRINT Formatter

Execution time, view time

MRGAUTO ON|OFF

Indicates whether to symbolically map 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

CAIPRINT Formatter

Execution time, view time

MRGBASED ON|OFF

Indicates whether to symbolically map 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

CAIPRINT Formatter

Execution time, view time

MRGCNTLD ON|OFF

Indicates whether to symbolically map 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

CAIPRINT Formatter

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

CAIPRINT Formatter

Execution time

MRGDSECT ON|OFF

Indicates whether to symbolically map 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

CAIPRINT Formatter

Execution time, view time

MRGFILES ON|OFF

Indicates whether to symbolically map 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

CAIPRINT Formatter

Execution time, view time

MRGLINK ON|OFF

Indicates whether to symbolically map 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

CAIPRINT Formatter

Execution time, view 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

CAIPRINT Formatter

Execution time, view time

MRGPARMS ON|OFF

Indicates whether to symbolically map 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

CAIPRINT Formatter

Execution time, view time

MRGSTAT ON|OFF

Indicates whether to symbolically map 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

CAIPRINT Formatter

Execution time, view time

MRGWORK ON|OFF

Indicates whether to symbolically map 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

CAIPRINT Formatter

Execution time, view time

NDVRASM=OFF|ON

Indicates whether the symbolic file should always be dynamically populated for assembler programs which are not LE enabled. This option will only take affect when dynamic symbolic support (NDVRDSS) is active for CA Endevor SCM.

Synonym:

Component:

When used:

None

CAIPRINT Formatter

Execution time, view time

NDVRDSN=dsname

Specifies the name of the symbolic file which will be dynamically populated when dynamic symbolic support (NDVRVSS) is active for CA Endevor SCM. The data set specified must be a PROTSYM file. When specified, it will automatically be included in the symbolic file search list.

Synonym:

Component:

When used:

None

CAIPRINT Formatter

Execution time, view time

NDVRDSS=OFF|ON

Indicates whether dynamic symbolic support is active for CA Endevor SCM. This option will not take effect at view time, unless it was also specified at execution time.

Synonym:

Component:


When used:

None

Reporting, CAIPRINT Formatter

Execution time, view time

OCCURS 1|nnnnnnnn|MAX

Specifies whether to symbolically map the maximum number of table occurrences 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

CAIPRINT Formatter

Execution time, view time

PLH ON|OFF

Prints place holders for open VSAM files in an Abend or Snap report.

Synonym:

Component:

When used:

None

Reporting

Execution 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

Reporting

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

Reporting

Execution time

READLL=ON|OFF

Indicates whether CA SymDump Batch will attempt to read LINKLIST libraries to obtain module information for Abend and Snap reports. If READLL is OFF, CA SymDump Batch may not be able to report on those programs in the application that were loaded from LINKLIST.

Synonym:

Component:

When used:

None

Reporting

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-32767. yyy represents the number of bytes after and must be within the range 0-4096.

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

Reporting

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

Reporting

Execution time

RPTSZ80 ON|OFF

Indicates whether to force all data in dump format to appear in an 80-column format.

Synonym:

Component:

When used:

None

CAIPRINT Formatter

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

CAIPRINT Formatter

Execution time, view time

SAVEHEAP ON|OFF

Indicates whether to save the LE heap storage when a report is created. SAVEHEAP ON is required at execution time to use SHOWHEAP ON for LE enabled COBOL or Assembler programs.

Synonym:

Component:

When used:

None

Reporting

Execution time

SHOWHEAP ON|OFF

Indicates whether to display 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

CAIPRINT Formatter

Execution time, view time

SHOWUNMRG ALL|NONE|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

CAIPRINT Formatter

Execution time, view time

SNAP 0|nnnnn|ON|OFF

Indicates whether to generate 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! 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

Reporting

Execution 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

Reporting

Execution time

UCB ON|OFF

Prints unit control blocks for all open files in an Abend or Snap report.

Synonym:

Component:

When used:

None

Reporting

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.

Synonym:

Component:

When used:

None

Reporting

Execution time

VSAMCAT=OFF|ON

Indicates whether to format the VSAM catalog information for each open VSAM file.

Synonym:

Component:

When used:

None

Reporting

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

Reporting

Execution time

WORKSTOR ALL|NONE

Indicates whether to display (ALL) or suppresses (NONE) the program's Working-Storage Section display.

Synonym:

Component:

When used:

None

CAIPRINT Formatter

Execution time, view 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

Reporting

Execution time