Application language interface trace points

This table lists the application language interface trace points, including the trace ID, the module name, the trace level, the trace type, and the data returned by the trace point. The application language interface trace points range from AP 1900 to AP 1969.

Table 1. Language interface trace points
Point ID Module Lvl Type Data
AP 1900 DFHAPRT 1 Entry
1
Parameter list
AP 1901 DFHAPRT 1 Exit
1
Parameter list
AP 1902 DFHAPRT Exc Invalid Function
1
Parameter list
AP 1903 DFHAPRT Exc Invalid Format
1
Parameter list
AP 1904 DFHAPRT Exc Recovery entered
1
Parameter list
2
Kernel Error data
AP 1940 DFHAPLI 1 Entry See Table 2
AP 1941 DFHAPLI 1 Exit See Table 2
AP 1942 DFHAPLI Exc Recovery Current parameter list (see note)
AP 1943 DFHAPLI Exc Invalid format
1
DFHAPLI parameter list
AP 1944 DFHAPLI Exc Invalid function
1
DFHAPLI parameter list
AP 1945 DFHAPLI Exc Missing parameter
1
DFHAPLI parameter list
AP 1948 DFHAPLI 1 Language Environment call See Table 3
AP 1949 DFHAPLI 1 Language Environment return See Table 3
AP 194C DFHAPLI 1 C call See Table 4
AP 194D DFHAPLI 1 C return See Table 4
AP 194E DFHAPLI Exc Determine working storage failed
1
DFHAPLI parameter list
AP 1950 DFHAPLI Exc Language Environment error Language Environment reason code
AP 1957 DFHAPLI Exc Dispatcher change mode failed
1
DFHAPLI parameter list
AP 1960 DFHAPLJ 1 Entry
1
DFHAPLI parameter list
AP 1961 DFHAPLJ 1 Exit
1
DFHAPLI parameter list
AP 1962 DFHAPLJ Exc Recovery
1
DFHAPLI parameter list
AP 1963 DFHAPLJ Exc Invalid format
1
DFHAPLI parameter list
AP 1964 DFHAPLJ Exc Invalid function
1
DFHAPLI parameter list
AP 1965 DFHAPLJ Exc Error occurred within JVM
1
DFHAPLI parameter list
AP 1968 DFHAPLJ Exc JVM system exit issued
1
DFHAPLI parameter list
AP 1969 DFHAPLJ Exc Dispatcher change mode failed
1
DFHAPLI parameter list
AP 196A DFHAPLJ 1 Enclave entry
1
sj_kernel_pthread
AP 196B DFHAPLJ 1 Enclave exit
1
sj_kernel_pthread
AP 196C DFHAPLJ Exc Recovery routine entry
1
SJTH parameter list
AP 196D DFHAPLJ Exc Recovery
1
SJTH parameter list
Note: The current parameter list relates to the function being performed at the time of failure, and is as shown for AP 1940 in Table 2. For an application problem, the function is usually Start Program.
Table 2. DFHAPLI entry/exit trace data fields
Function Data fields for trace point AP 1940 Data fields for trace point AP 1941
Initialize languages    
Terminate languages    
Establish language
  1. Program name
  2. Program load point
  3. Program entry point
  4. Program length
  5. Execution key
  6. Data location (more than or less than 16 MB)
  7. User-defined language
  8. Old language block
  1. Language established by CICS®
  2. New language block
  3. Abend code
Start program
  1. Program name
  2. CEDF status
  3. Execution set (full API or DPL subset)
  4. Environment type
  5. SYNCONRETURN
  6. Language block
  7. Parameter-list address
  8. COMMAREA address and length
  9. Link level
  1. Abend code
  2. Program name
Find program attributes
  1. RSA address
  1. Program entry point
  2. Name at entry point
  3. Working storage address
  4. Static storage address
Goto
  1. RSA address
  1. Parameter list
  2. RSA address
  3. Language Environment entry point
Table 3. Language Environment call/return trace data fields
Function Data fields for trace point AP 1948 Data fields for trace point AP 1949
Partition initialization
  1. Function
  2. Parameter list
  3. System use
  1. Function
  2. Reason code
  3. Language Environment partition token
  4. Language Environment Interface level
  5. Language Environment thread workarea length
  6. Language availability bits
Partition termination
  1. Function
  2. Parameter list
  1. Function
  2. Reason code
Thread initialization
  1. Function
  2. Parameter list
  3. Program name
  4. PGMINFO1 (see Table 5)
  1. Function
  2. Reason code
  3. Program name
  4. Language Environment Thread token
Thread termination
  1. Function
  2. Parameter list
  1. Function
  2. Reason code
Run-Unit Initialization
  1. Function
  2. Parameter list
  3. Program name
  4. PGMINFO1 (see Table 5)
  5. RSA address
  6. Storage tuning area (Only if Language Environment dynamic storage tuning is supported)
  1. Function
  2. Reason code
  3. Program name
  4. Language Environment run-unit token
  5. RSA address
Run-Unit Initialization and begin invocation
  1. Function
  2. Parameter list
  3. Program name
  4. PGMINFO1 (see Table 5)
  5. RSA address
  6. and-begin
  7. Storage tuning area (Only if Language Environment dynamic storage tuning is supported)
  1. Function
  2. Reason code
  3. Program name
  4. Language Environment run-unit token
  5. RSA address
  6. and-begin
Run-unit termination
  1. Function
  2. Parameter list
  3. Program name
  4. RSA address
  1. Function
  2. Reason code
  3. Program name
  4. RSA address
  5. PGMINFO2 (see (Only if Language Environment dynamic storage tuning is supported)
  6. Storage tuning area (Only if Language Environment dynamic storage tuning is supported)
Run-unit begin invocation
  1. Function
  2. Parameter list
  3. Program name
  4. RSA address
  1. Function
  2. Reason code
  3. Program name
Run-unit end invocation
  1. Function
  2. Parameter list
  3. Program name
  4. System use
  5. RSA address
  1. Function
  2. Reason code
  3. Program name
  4. Contcode
  5. RSA address
Establish ownership type
  1. Function
  2. Parameter list
  3. Program name
  4. PGMINFO1 (see Table 5)
  1. Function
  2. Reason code
  3. Program name
  4. PGMINFO2 (see Table 6)
  5. Storage tuning area (Only if Language Environment dynamic storage tuning is supported)
Determine working storage
  1. Function
  2. Parameter list
  3. Program name
  1. Function
  2. Reason code
  3. Program name
  4. Working storage address
  5. Working storage length
  6. Static storage address
  7. Static storage length
Perform Goto
  1. Function
  2. Parameter list
  3. Program name
  1. Function
  2. Reason code
  3. Program name
  4. Out-of-block flag
Program check recovery
  1. Function
  2. Parameter list
  3. Program name
  4. Celinfo
  1. Function
  2. Return code
  3. Program name
  4. Reason code
  5. Contcode
Note: Language Environment parameter lists are described in Language Environment parameter lists
Table 4. C call/return trace data fields
Function Data fields for trace point AP 194C Data fields for trace point AP 194D
Partition initialization
  1. Function
  2. Parameter list
  1. Function
  2. Reason code
  3. C partition token
  4. C Interface level
Partition termination
  1. Function
  2. Parameter list
  1. Function
  2. Reason code
Thread initialization
  1. Function
  2. Parameter list
  3. Program name
  1. Function
  2. Reason code
  3. Program name
  4. C Thread token
Thread termination
  1. Function
  2. Parameter list
  1. Function
  2. Reason code
Run-Unit Initialization
  1. Function
  2. Parameter list
  3. Program name
  1. Function
  2. Reason code
  3. Program name
  4. C run-unit token
Run-unit termination
  1. Function
  2. Parameter list
  3. Program name
  4. Celinfo
  5. Registers at abend
  1. Function
  2. Reason code
  3. Program name
  4. Contcode
Determine program type
  1. Function
  2. Parameter list
  3. Program name
  1. Function
  2. Reason code
  3. Program name
  4. Program flags
Working storage locate
  1. Function
  2. Parameter list
  3. Program name
  1. Function
  2. Reason code
  3. Program name
  4. W/S address
  5. W/S length
Table 5. PGMINFO1 structure. This structure, used for communication between CICS and Language Environment, is referred to in figures Table 2 and Table 3. The structure consists of 11 fullwords.
Displacement (hex) Fullword contents
00 Length of the structure
04 The language of the run unit (main program) as known to CICS. One of the first 6 bits is set on with the following meaning:
  1. Assembler
  2. C
  3. COBOL
  4. PL/I
  5. RPG (not supported by CICS)
  6. Not known or Language Environment
08 Address of the run unit program
0C Length of the run unit program
10 Entry point address of the run unit; bit zero of this field is set on in the case of programs running in 31-bit addressing mode.
14 Modified entry address
18 Address of the run unit work area preallocated, more than 16 megabytes
1A Address of the run unit work area preallocated, less than 16 megabytes
20 Address of the application program argument list, which is a 2-fullword structure containing the addresses of the user EIB and COMMAREA
24 Address of the run time options string passed by CICS to Language Environment.
28 Length of the run time options string
Table 6. PGMINFO2 structure. This structure, used for communication between CICS and Language Environment, is referred to in Table 3. Some fields are used when the language is not Language Environment. The structure consists of 7 fullwords.
Displacement (hex) Fullword contents
00 Length of the structure
04 Size of the work area required to run the program. This is used by Language Environment for storage more than the 16-megabyte line, and by C for all storage. For C only, the first bit of this fullword is set on to indicate storage more than the 16-megabyte line.
08 Size of the work area, less than the 16-megabyte line, that is required to run the program (Language Environment only).
0C The first ten bits are binary flags. The meaning of an on setting for each bit is as follows:
  1. The program can run under Language Environment.
  2. Language Environment knows the language of the program (Language Environment only).
  3. More than one language is used in the program (Language Environment only).
  4. The program can run under Language Environment, but is not compiled by an Language Environment compiler. Language Environment must run the program in compatibility mode (Language Environment only).
  5. The program is executable under Language Environment.
  6. The program language is Assembler.
  7. The program language is C.
  8. The program language is Enterprise COBOL or VS COBOL II.
  9. The program language is OS/VS COBOL. (OS/VS COBOL programs cannot run under this CICS version.)
  10. The program language is PL/I.
10 Language ID number of the first executable CSECT in the program (Language Environment only)
14 Address of CEECOPT (Global Language Environment runtime options)
18 Address of CEEVOPT (Specific Language Environment runtime options)
1C Address of dynamic storage tuning area