CTL - Analysis Control user exit parameter list

Table 1. CTL data area

This table has 6 columns and 2 header rows. In the first header row, the "Offsets" heading spans columns 1 and 2. The "Offsets" heading has 2 subheadings in the second header row: "Dec" in column 1 and "Hex" in column 2.
Offsets Type Access Len Name and description
Dec Hex
0 (0) CHAR R/O 4 VERSION

Parameter list version (currently 0002).

4 (4) CHAR R/W 1 EXCLUDE

Exclude from analysis (Y/N). If this field is set to 'Y', no analysis of the current fault is performed, and no updates are made to the history file.

Only applicable to real-time processing and dump registration.

5 (5) CHAR R/W 1 DETAIL_OPT

Detail option (S/M/L). Refer to Detail for information about this option.

Not applicable to interactive reanalysis.

6 (6) CHAR R/W 1 DEFERREDREPORT_OPT

DeferredReport option (Y/N). Refer to DeferredReport for information about this option.

Only applicable to real-time processing.

7 (7) CHAR R/W 4 DETAIL_OPT_EXTRA_SOURCE

Number of extra source code lines or statements to be included in the real-time or batch reanalysis report ahead of, and after, the source line or statement that matches the CSECT offset (nnnn). The extra source lines or statements are included in the report detail section only.

The default is 0005.

Not applicable to interactive reanalysis.

8 (8) CHAR R/O 7 (Reserved)
18 (12 CHAR R/W 10 RETAINDUMP_OPT

RetainDump option. Refer to RetainDump for information about this option. (The format provided in this field is identical to that of the normal RetainDump option syntax, that is, "AUTO" or "ALL").

Only applicable to real-time processing.

28 (1C) CHAR R/O 44 (Reserved)
72 (48) CHAR R/O 120 INCLUDE_CRITERION

Include criterion. The last matching Include option criterion processed.

Z Abend Investigator permits a buffered data format that is used if the length of the criterion exceeds the maximum size that can be contained in this field. For details, see Non-REXX user exit buffered data format. The format of this field is transparent to users of REXX exits.

Only applicable to real-time processing.

192 (C0) CHAR R/O 120 EXCLUDE_CRITERION

Exclude criterion. The last matching Exclude option criterion processed.

Z Abend Investigator permits a buffered data format that is used if the length of the criterion exceeds the maximum size that can be contained in this field. For details, see Non-REXX user exit buffered data format. The format of this field is transparent to users of REXX exits.

Only applicable to real-time processing.

312 (138) CHAR R/O 5 (Reserved)
317 (13D) CHAR R/W 1 SOURCE_OPT

Source option (Y/N). Refer to Source for information about this option.

Only applicable to real-time processing.

318 (13E) CHAR R/O 6 (Reserved)
324 (144) CHAR R/W 1 PRINTINACTIVECOBOL_OPT

PrintInactiveCOBOL option (Y/N). Refer to PrintInactiveCOBOL for information about this option.

Not applicable to interactive reanalysis.

325 (145) CHAR R/O 51 (Reserved)

Field format and usage:

  • The following information is applicable to all HFZ*_PRE, HFZ*_JOB, and HFZ*_CFG fields in this data area, with the exception of HFZJAVA_* fields:

    In each field, the data set names are provided left justified and blank padded on a 45-character boundary. Any unused space is set to all blanks.

    Z Abend Investigator permits a buffered data format that can be used if the number of data sets exceed the maximum number that can be contained in this field. The buffer, when allocated by Z Abend Investigator, is allocated large enough to hold an extra 25 data set names. For details, see Non-REXX user exit buffered data format. The format of this field is transparent to users of REXX exits.

  • The following information is applicable to all HFZ*_PRE fields in this data area:

    An Analysis Control user exit can choose to unallocate any of these data sets, or allocate extra ones. These fields contain the preallocated data set names, and are provided for information only. Changes to the data set names in this field are not acted upon by Z Abend Investigator. Instead, Z Abend Investigator redetermines the preallocated data sets using standard operating system interfaces.

  • The following information is applicable to all HFZ*_JOB or HFZ*_CFG fields in this data area:

    An Analysis Control user exit can add to, delete, or alter any or all of these data set names. Upon return from the exit, data set names must be separated by one or more blanks or commas, and can be aligned on any boundary. For these data set names, Z Abend Investigator uses the returned list of names.

376 178 CHAR R/O 5400 HFZADATA_PRE

HFZADATA preallocated data sets. This field is initialized by Z Abend Investigator to contain all data sets preallocated to the HFZADATA DDname.

5776 (1690) CHAR R/W 5400 HFZADATA_JOB

HFZADATA data sets specified in the user options file (HFZOPTS). This field is initialized by Z Abend Investigator to contain all HFZADATA data sets specified via DataSets options in the user options file.

Refer to Field format and usage for more information.

11176 (2BA8) CHAR R/W 5400 HFZADATA_CFG

HFZADATA data sets specified in HFZCNF00 config member. This field is initialized by Z Abend Investigator to contain all HFZADATA data sets specified via DataSets options in the HFZCNF00 config member.

Refer to Field format and usage for more information.

16576 (40C0) CHAR R/O 5400 HFZLC_PRE

HFZLC preallocated data sets. This field is initialized by Z Abend Investigator to contain all data sets preallocated to the HFZLC DDname.

Refer to Field format and usage for more information.

21976 (55D8) CHAR R/W 5400 HFZLC_JOB

HFZLC data sets specified in the user options file (HFZOPTS). This field is initialized by Z Abend Investigator to contain all HFZLC data sets specified via DataSets options in the user options file.

Refer to Field format and usage for more information.

27376 (6AF0) CHAR R/W 5400 HFZLC_CFG

HFZLC data sets specified in HFZCNF00 config member. This field is initialized by Z Abend Investigator to contain all HFZLC data sets specified via DataSets options in the HFZCNF00 config member.

Refer to Field format and usage for more information.

32776 (8008) CHAR R/O 5400 HFZLCOB_PRE

HFZLCOB preallocated data sets. This field is initialized by Z Abend Investigator to contain all data sets preallocated to the HFZLCOB DDname.

Refer to Field format and usage for more information.

38176 (9520) CHAR R/W 5400 HFZLCOB_JOB

HFZLCOB data sets specified in the user options file (HFZOPTS). This field is initialized by Z Abend Investigator to contain all HFZLCOB data sets specified via DataSets options in the user options file.

Refer to Field format and usage for more information.

43576 (AA38) CHAR R/W 5400 HFZLCOB_CFG

HFZLCOB data sets specified in HFZCNF00 config member. This field is initialized by Z Abend Investigator to contain all HFZLCOB data sets specified via DataSets options in the HFZCNF00 config member.

Refer to Field format and usage for more information.

48976 (BF50) CHAR R/O 5400 HFZLCOBO_PRE

HFZLCOBO preallocated data sets. This field is initialized by Z Abend Investigator to contain all data sets preallocated to the HFZLCOBO DDname.

Refer to Field format and usage for more information.

54376 (D468) CHAR R/W 5400 HFZLCOBO_JOB

HFZLCOBO data sets specified in the user options file (HFZOPTS). This field is initialized by Z Abend Investigator to contain all HFZLCOBO data sets specified via DataSets options in the user options file.

Refer to Field format and usage for more information.

59776 (E980) CHAR R/W 5400 HFZLCOBO_CFG

HFZLCOBO data sets specified in HFZCNF00 config member. This field is initialized by Z Abend Investigator to contain all HFZLCOBO data sets specified via DataSets options in the HFZCNF00 config member.

Refer to Field format and usage for more information.

65176 (FE98) CHAR R/O 5400 HFZLANGX_PRE

HFZLANGX preallocated data sets. This field is initialized by Z Abend Investigator to contain all data sets preallocated to the HFZLANGX DDname.

Refer to Field format and usage for more information.

70576 (113B0) CHAR R/W 5400 HFZLANGX_JOB

HFZLANGX data sets specified in the user options file (HFZOPTS). This field is initialized by Z Abend Investigator to contain all HFZLANGX data sets specified via DataSets options in the user options file.

Refer to Field format and usage for more information.

75976 (128C8) CHAR R/W 5400 HFZLANGX_CFG

HFZLANGX data sets specified in HFZCNF00 config member. This field is initialized by Z Abend Investigator to contain all HFZLANGX data sets specified via DataSets options in the HFZCNF00 config member.

Refer to Field format and usage for more information.

81376 (13DE0) CHAR R/O 5400 HFZLPLI_PRE

HFZLPLI preallocated data sets. This field is initialized by Z Abend Investigator to contain all data sets preallocated to the HFZLPLI DDname.

Refer to Field format and usage for more information.

86776 (152F8) CHAR R/W 5400 HFZLPLI_JOB

HFZLPLI data sets specified in the user options file (HFZOPTS). This field is initialized by Z Abend Investigator to contain all HFZLPLI data sets specified via DataSets options in the user options file.

Refer to Field format and usage for more information.

92176 (16810) CHAR R/W 5400 HFZLPLI_CFG

HFZLPLI data sets specified in HFZCNF00 config member. This field is initialized by Z Abend Investigator to contain all HFZLPLI data sets specified via DataSets options in the HFZCNF00 config member.

Refer to Field format and usage for more information.

97576 (17D28) CHAR R/O 1024 (Reserved)
98600 (18128) CHAR R/O 5400 HFZLPLIE_PRE

HFZLPLIE preallocated data sets. This field is initialized by Z Abend Investigator to contain all data sets preallocated to the HFZLPLIE DDname.

Refer to Field format and usage for more information.

104000 (19640) CHAR R/W 5400 HFZLPLIE_JOB

HFZLPLIE data sets specified in the user options file (HFZOPTS). This field is initialized by Z Abend Investigator to contain all HFZLPLIE data sets specified via DataSets options in the user options file.

Refer to Field format and usage for more information.

109400 (1AB58) CHAR R/W 5400 HFZLPLIE_CFG

HFZLPLIE data sets specified in HFZCNF00 config member. This field is initialized by Z Abend Investigator to contain all HFZLPLIE data sets specified via DataSets options in the HFZCNF00 config member.

Refer to Field format and usage for more information.

114800 (1C070) CHAR R/W 256 LOCALE

Locale option locale name. Refer to Locale for information about this option.

115056 (1C170) CHAR R/W 1 FADATE

Locale option FADATE suboption (Y/N). Refer to Locale for information about this suboption.

115057 (1C171) CHAR R/O 5400 HFZSYSDB_PRE

HFZSYSDB preallocated data sets. This field is initialized by Z Abend Investigator to contain all data sets preallocated to the HFZSYSDB DDname.

Refer to Field format and usage for more information.

120457 (1D689) CHAR R/W 5400 HFZSYSDB_JOB

HFZSYSDB data sets specified in the user options file (HFZOPTS). This field is initialized by Z Abend Investigator to contain all HFZSYSDB data sets specified via DataSets options in the user options file.

Refer to Field format and usage for more information.

125857 (1EBA1) CHAR R/W 5400 HFZSYSDB_CFG

HFZSYSDB data sets specified in HFZCNF00 config member. This field is initialized by Z Abend Investigator to contain all HFZSYSDB data sets specified via DataSets options in the HFZCNF00 config member.

Refer to Field format and usage for more information.

131257 (200B9) CHAR R/W 56 HFZTRACE
Use to start or stop HFZTRACE tracing dynamically:
ONx
Start tracing to SYSOUT class x. If x is not specified, its default is '*'.
<dsn>
Start tracing to the specified data set name. The data set name must be fully qualified but not surrounded by single quotation marks. If the data set is a PDS or PDSE, a member name must be specified in parentheses.
OFF
Stop tracing.
131313 (200F1) CHAR R/O 5400 HFZJAVA_PRE

HFZJAVA preallocated path names.

This field is initialized by Z Abend Investigator to contain all path names preallocated to the HFZJAVA DDname.

The path names are provided as a blank-delimited list. If a path name contains single quotation marks, commas, or blanks, the name will be surrounded by single quotation marks. Any single quotation marks within the path name will be doubled up.

Z Abend Investigator permits the use of a buffered data format if the list of path names exceeds the maximum size that can be contained in this field. For details, see Non-REXX user exit buffered data format. The format of this field is transparent to users of REXX exits.

An Analysis Control user exit can choose to deallocate any of these path names, or allocate extra ones. Changes to the path names in this field are not acted upon by Z Abend Investigatorr. Instead, Z Abend Investigator redetermines the preallocated path names using standard operating system interfaces.

136713 (21609) CHAR R/W 5400 HFZJAVA_JOB

HFZJAVA path names specified in the user options file (HFZOPTS).

This field is initialized by Z Abend Investigator to contain all HFZJAVA path names specified through DataSets options in the user options file.

The path names are provided as a blank-delimited list. If a path name contains single quotation marks, commas, or blanks, the name will be surrounded by single quotation marks. Any single quotation marks within the path name will be doubled up. If an exit is providing a path name containing single quotes, commas, or blanks, then the exit must provide the path name surrounded by single quotation marks and with all single quotation marks within the path name doubled up.

Z Abend Investigator permits the use of a buffered data format if the list of path names exceeds the maximum size that can be contained in this field. For details, see Non-REXX user exit buffered data format. The format of this field is transparent to users of REXX exits.

An Analysis Control user exit can add to, delete, or alter any or all of these path names. Path names must be separated by one or more blanks or commas, and must protect single quotation marks as described above.

For these path names, Z Abend Investigator uses the returned list of names.

142113 (22B21) CHAR R/W 5400 HFZJAVA_CFG

HFZJAVA path names specified in HFZCNF00 config member.

This field is initialized by Z Abend Investigator to contain all HFZJAVA path names specified through DataSets options in the HFZCNF00 config member.

The path names are provided as a blank-delimited list. If a path name contains single quotation marks, commas, or blanks, the name will be surrounded by single quotation marks. Any single quotation marks within the path name will be doubled up. If an exit is providing a path name containing single quotes, commas, or blanks, then the exit must provide the path name surrounded by single quotation marks and with all single quotation marks within the path name doubled up.

Z Abend Investigator permits the use of a buffered data format if the list of path names exceeds the maximum size that can be contained in this field. For details, see Non-REXX user exit buffered data format. The format of this field is transparent to users of REXX exits.

An Analysis Control user exit can add to, delete, or alter any or all of these path names. Path names must be separated by one or more blanks or commas, and must protect single quotation marks as described above.

For these path names, Z Abend Investigator uses the returned list of names.

147513 (24039) CHAR R/O 5400 STEPLIB

STEPLIB data set concatenation (or JOBLIB data set concatenation, if STEPLIB is not defined).

This is the concatenation as at the time of the abend, except for batch reanalysis, where it is the STEPLIB data sets for the reanalysis job.

The data set names are provided as a blank-delimited list.

Z Abend Investigator permits the use of a buffered data format if the list of path names exceeds the maximum size that can be contained in this field. For details, see Non-REXX user exit buffered data format. The format of this field is transparent to users of REXX exits.