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 |
- Program name
- Program load point
- Program entry point
- Program length
- Execution key
- Data location (more than or less than 16 MB)
- User-defined language
- Old language block
|
- Language established by CICS®
- New language block
- Abend code
|
Start program |
- Program name
- CEDF status
- Execution set (full API or DPL subset)
- Environment type
- SYNCONRETURN
- Language block
- Parameter-list address
- COMMAREA address and length
- Link level
|
- Abend code
- Program name
|
Find program attributes |
- RSA address
|
- Program entry point
- Name at entry point
- Working storage address
- Static storage address
|
Goto |
- RSA address
|
- Parameter list
- RSA address
- Language Environment entry point
|
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 |
- Function
- Parameter list
|
- Function
- Reason code
- C partition token
- C Interface level
|
Partition termination |
- Function
- Parameter list
|
- Function
- Reason code
|
Thread initialization |
- Function
- Parameter list
- Program name
|
- Function
- Reason code
- Program name
- C Thread token
|
Thread termination |
- Function
- Parameter list
|
- Function
- Reason code
|
Run-Unit Initialization |
- Function
- Parameter list
- Program name
|
- Function
- Reason code
- Program name
- C run-unit token
|
Run-unit termination |
- Function
- Parameter list
- Program name
- Celinfo
- Registers at abend
|
- Function
- Reason code
- Program name
- Contcode
|
Determine program type |
- Function
- Parameter list
- Program name
|
- Function
- Reason code
- Program name
- Program flags
|
Working storage locate |
- Function
- Parameter list
- Program name
|
- Function
- Reason code
- Program name
- W/S address
- 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:
- Assembler
- C
- COBOL
- PL/I
- RPG (not supported by CICS)
- 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:
- The program can run under Language Environment.
- Language Environment knows the language of the program (Language
Environment only).
- More than one language is used in the program (Language Environment
only).
- 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).
- The program is executable under Language Environment.
- The program language is Assembler.
- The program language is C.
- The program language is Enterprise COBOL or VS COBOL II.
- The program language is OS/VS COBOL. (OS/VS COBOL programs cannot
run under this CICS version.)
- 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 |