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 196D.
| Point ID | Module | Lvl | Type | Data |
|---|---|---|---|---|
| AP 1900 | DFHAPRT | 1 | Entry |
|
| AP 1901 | DFHAPRT | 1 | Exit |
|
| AP 1902 | DFHAPRT | Exc | Invalid Function |
|
| AP 1903 | DFHAPRT | Exc | Invalid Format |
|
| AP 1904 | DFHAPRT | Exc | Recovery entered |
|
| 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 |
|
| AP 1944 | DFHAPLI | Exc | Invalid function |
|
| AP 1945 | DFHAPLI | Exc | Missing parameter |
|
| 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 |
|
| AP 1950 | DFHAPLI | Exc | Language Environment error | Language Environment reason code |
| AP 1957 | DFHAPLI | Exc | Dispatcher change mode failed |
|
| AP 1960 | DFHAPLJ | 1 | Entry |
|
| AP 1961 | DFHAPLJ | 1 | Exit |
|
| AP 1962 | DFHAPLJ | Exc | Recovery |
|
| AP 1963 | DFHAPLJ | Exc | Invalid format |
|
| AP 1964 | DFHAPLJ | Exc | Invalid function |
|
| AP 1965 | DFHAPLJ | Exc | Error occurred within JVM |
|
| AP 1968 | DFHAPLJ | Exc | JVM system exit issued |
|
| AP 1969 | DFHAPLJ | Exc | Dispatcher change mode failed |
|
| AP 196A | DFHAPLJ | 1 | Enclave entry |
|
| AP 196B | DFHAPLJ | 1 | Enclave exit |
|
| AP 196C | DFHAPLJ | Exc | Recovery routine entry |
|
| AP 196D | DFHAPLJ | Exc | Recovery |
|
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.
| Function | Data fields for trace point AP 1940 | Data fields for trace point AP 1941 |
|---|---|---|
| Initialize languages | ||
| Terminate languages | ||
| Establish language |
|
|
| Start program |
|
|
| Find program attributes |
|
|
| Goto |
|
|
| Function | Data fields for trace point AP 1948 | Data fields for trace point AP 1949 |
|---|---|---|
| Partition initialization |
|
|
| Partition termination |
|
|
| Thread initialization |
|
|
| Thread termination |
|
|
| Run-Unit Initialization |
|
|
| Run-Unit Initialization and begin invocation |
|
|
| Run-unit termination |
|
|
| Run-unit begin invocation |
|
|
| Run-unit end invocation |
|
|
| Establish ownership type |
|
|
| Determine working storage |
|
|
| Perform Goto |
|
|
| Program check recovery |
|
|
Note: Language Environment parameter lists are described
in Language Environment parameter lists
| Function | Data fields for trace point AP 194C | Data fields for trace point AP 194D |
|---|---|---|
| Partition initialization |
|
|
| Partition termination |
|
|
| Thread initialization |
|
|
| Thread termination |
|
|
| Run-Unit Initialization |
|
|
| Run-unit termination |
|
|
| Determine program type |
|
|
| Working storage locate |
|
|
| 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:
|
| 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 |
| 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:
|
| 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 |