LST - Compiler Listing Read user exit parameter list

Table 1. LST 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 0001).

4 (4) CHAR R/O 8 MODULE_NAME

Module name.

This name is the name of the load module containing the CSECT identified in LST.CSECT_NAME.

12 (C) CHAR R/O 8 CSECT_NAME

CSECT name.

This name is the name of the CSECT containing the program identified in LST.PROGRAM_NAME.

20 (14) CHAR R/O 256 EP_NAME

Entry point name (truncated to 256 chars).

276 (114) CHAR R/O 10 COMPILE_DATE

Compile date in the format YYYY/MM/DD.

286 (11E) CHAR R/O 8 COMPILE_TIME

Compile time in the format HH:MM:SS.

294 (126) CHAR R/O 1 LISTING_TYPE

Compiler listing or assembler SYSADATA file (L), or side file (S).

295 (127) CHAR R/O 12 LANGUAGE_TYPE
Language type:
  • Assembler
  • C/C++
  • COBOL
  • OS/VS COBOL
  • PL/I
  • Entprs PL/I
307 (133) CHAR R/O 4 RECFM

Record format.

311 (137) CHAR R/O 5 LRECL

Logical record length (nnnnn).

316 (13C) CHAR R/W 5 DATA_LENGTH

Data length of variable length record (nnnnn). This field specifies the length of the record placed in DATA_BUFFER.

321 (141) CHAR R/W 1 DISREGARD_EXIT_LISTING

Ignore compiler listing or side-file supplied by the exit (Y/N). This field is always initialized to 'N' by Z Abend Investigator. If 'Y' is returned, Z Abend Investigator disregards any data that might have been provided and continues the search for the listing or side-file through the normal search path.

322 (142) CHAR R/O 8 PROGRAM_NAME

Program name. If the program name length exceeds 8 characters, then this field will only contain the first 8 characters of the name. In this case, use the LONG_PROGRAM_NAME field instead.

330 (14A) CHAR R/O 10 PROGRAM_LENGTH

Program length in bytes (decimal). If the program name length exceeds 8 characters, then this field will only contain the first 8 characters of the name. In this case, use the LONG_PROGRAM_NAME field instead.

340 (154) CHAR R/W 1 DATA_BUFFER_DSN

Data buffer contains data set name (Y/N)

341 (155) CHAR R/O 44 LOAD_MODULE_DSN

Load module data set name.

This name is the name of the data set from which the load module identified in LST.MODULE_NAME was loaded.

385 (181) CHAR R/O 5 (Reserved)
390 (186) CHAR R/W 8188 DATA_BUFFER

Data buffer.

No upper case translation is performed on the contents of this field. Truncation by null character (X'00') of this field is not permitted. For variable-length records, the length must be provided in the DATA_LENGTH field. For fixed-length records, the length is expected to match the LRECL.

If DATA_BUFFER_DSN is set to Y, then it is expected that this field contains the name of a data set (with member name following in parenthesis if partitioned) that contains the compiler listing or side file as appropriate for LISTING_TYPE. Refer to Compiler Listing Read user exit for extra data set name requirements.

8578 (2182) CHAR R/O 32 LONG_PROGRAM_NAME

Long (up to 32 characters) program name.

This field is only initialized if the program name length exceeds 8 characters. Otherwise, use the PROGRAM_NAME field instead.