Table Of Contents
API/IFS Internal Trace Entries
Table 3-1 API-type API internal trace entries
Subtype User
Fields/Modules DescriptionTBEG
UDW1: ASID
UDW2: TCB
UDW3: QSTR
UDW4: TUCXAn address space has issued an AOPEN macro to the API. The ASID, TCB, and TUCX are logged. QSTR is valid only for the transport provider.
TEND
UDW1: TUCB TPCB
UDW2: TCEP SVCID
UDW4:EPCBAn address space has issued an ACLOSE macro to the API. The TUCB is logged. If an endpoint is OPEN, its TCEP and EPCB are logged. If a transport provider has ended, its TPCB and service ID are logged.
TOPN
UDW1: SRE
UDW2: EPCB
UDW3: ISRBA TOPEN macro has been issued. The SRE and EPCB are logged. The ISRB is dispatched to process the OPEN.
TCLO
UDW1: EPCB
UDW2: TUCB
UDW3: ARCB
UDW4: TPCBA TCLOSE macro has been issued. The endpoint EPCB and the associated TUCB and ARCB are logged.
FSRE
UDW1: SRE
UDW2: SREFLAG,
TPLFLAG, RC
UDW3: EPCB
UDW4: TUCXThis entry is the first half of a type 00 or type 04 FSRE entry. An SRE is being completed. Its flags, the TPL flags, and the return code for APICTFRE is logged. The returned EPCB and TUCX is logged. (Read "Flags and Return Codes" on page -4 for more information.)
UDW1: TCB
UDW2: TUCB
UDW3: ECB
UDW4: TPLThis entry is the second half of a type 00 or type 04 FSRE entry. An SRE is being completed. A TCB may require further processing, and ECB may require posting. The user's TPL address is logged.
UDW1: SRE
UDW2: SREFLAG,
TPLFLAG, RC
UDW3: EPCB
UDW4: TUCXThis entry is the first half of a type 8 FSRE entry. An SRE has been queued for exit processing later by an IRB. The EPCB and TUCX are logged.
UDW1: TCB
UDW2: TUCBThis entry is the second half of a type 8 FSRE entry. If an IRB needs to be scheduled, the TCB address is logged. The TUCB is also logged.
FSRE
(continued)UDW1: SRE
UDW2: SREFLAG,
TPLFLAG, RC
UDW3: EPCB
UDW4: TUCXThis entry is the first half of a type 0Cor 10 FSRE entry. An IRB exit is being driven. Its SRE and flags are logged, along with the APICTFRE return code, the EPCB and the TUCX. (Read "Flags and Return Codes" on page -4 for more information.)
UDW1: TXPTYPE
UDW2: TCEP
UDW3: EXIT
UDW4: TXPPARMThis entry is the second half of a type 0C or 10 FSRE entry. An IRB exit is being driven. The exit parameters are logged.
FUNC
UDW1: EPCB
UDW2: SRE
UDW3: TPL
UDW4: FUNCTION CDA TPL-based function has been issued. The SRE and EPCB are logged. The user's TPL address and function code are logged.
SCMP
UDW1: TUCB
Work for a user has been completed at the logged TUCB.
SSRB
UDW1: SRB
UDW2: ASCB
UDW3: ARCBAn SRB is being scheduled for a user address space. The ASCB and ARCB are logged. The SRB address is given.
SOPN
UDW1: TPCB
UDW2: EPCB
UDW3: TIBAn OPEN request is being processed. The selected service is given by the TPCB and TIB.
SCLO
UDW1: FUNCTION
UDW2: ARCB/TUCBAn ACLOSE is being processed. These are the function codes:
0 - Normal ACLOSE
4 - Abortive ACLOSE at end of memory
8 - Abortive ACLOSE at end of task
The ARCB or TUCB is given.
TEOJ
UDW1: ASID
UDW2: TCB
UDW3: ARCB/TUCBAn end of task or end of memory (end of address space) event has taken place for a task using the API.
TPEN
UDW1: SRE
UDW2: EPCB
UDW3: TPCB
UDW4: REASONA TPEND exit is being driven. The endpoint EPCB is given. The reason codes are from the TXP.
Table 3-16 POST-type IFS internal trace entries
Subtype User Fields/Modules DescriptionUDW1-UDW5: Not used
Modules: IFSSTDRVTask driver posted.
API/IFS Internal Trace Entries
This chapter contains internal API and IFS trace entries. It includes these sections:
This section describes API internal trace entries.
Provides additional information about the SRE flags, TPL flags, and APICTFRE return codes
Describes IFS internal trace entries.
API Internal Trace Entries
This section describes API internal trace entries, listed alphabetically by type.
API
Table 3-1 API-type API internal trace entries
Subtype User
Fields/Modules DescriptionTBEG
UDW1: ASID
UDW2: TCB
UDW3: QSTR
UDW4: TUCXAn address space has issued an AOPEN macro to the API. The ASID, TCB, and TUCX are logged. QSTR is valid only for the transport provider.
TEND
UDW1: TUCB TPCB
UDW2: TCEP SVCID
UDW4:EPCBAn address space has issued an ACLOSE macro to the API. The TUCB is logged. If an endpoint is OPEN, its TCEP and EPCB are logged. If a transport provider has ended, its TPCB and service ID are logged.
TOPN
UDW1: SRE
UDW2: EPCB
UDW3: ISRBA TOPEN macro has been issued. The SRE and EPCB are logged. The ISRB is dispatched to process the OPEN.
TCLO
UDW1: EPCB
UDW2: TUCB
UDW3: ARCB
UDW4: TPCBA TCLOSE macro has been issued. The endpoint EPCB and the associated TUCB and ARCB are logged.
FSRE
UDW1: SRE
UDW2: SREFLAG,
TPLFLAG, RC
UDW3: EPCB
UDW4: TUCXThis entry is the first half of a type 00 or type 04 FSRE entry. An SRE is being completed. Its flags, the TPL flags, and the return code for APICTFRE is logged. The returned EPCB and TUCX is logged. (Read "Flags and Return Codes" on page -4 for more information.)
UDW1: TCB
UDW2: TUCB
UDW3: ECB
UDW4: TPLThis entry is the second half of a type 00 or type 04 FSRE entry. An SRE is being completed. A TCB may require further processing, and ECB may require posting. The user's TPL address is logged.
UDW1: SRE
UDW2: SREFLAG,
TPLFLAG, RC
UDW3: EPCB
UDW4: TUCXThis entry is the first half of a type 8 FSRE entry. An SRE has been queued for exit processing later by an IRB. The EPCB and TUCX are logged.
UDW1: TCB
UDW2: TUCBThis entry is the second half of a type 8 FSRE entry. If an IRB needs to be scheduled, the TCB address is logged. The TUCB is also logged.
FSRE
(continued)UDW1: SRE
UDW2: SREFLAG,
TPLFLAG, RC
UDW3: EPCB
UDW4: TUCXThis entry is the first half of a type 0Cor 10 FSRE entry. An IRB exit is being driven. Its SRE and flags are logged, along with the APICTFRE return code, the EPCB and the TUCX. (Read "Flags and Return Codes" on page -4 for more information.)
UDW1: TXPTYPE
UDW2: TCEP
UDW3: EXIT
UDW4: TXPPARMThis entry is the second half of a type 0C or 10 FSRE entry. An IRB exit is being driven. The exit parameters are logged.
FUNC
UDW1: EPCB
UDW2: SRE
UDW3: TPL
UDW4: FUNCTION CDA TPL-based function has been issued. The SRE and EPCB are logged. The user's TPL address and function code are logged.
SCMP
UDW1: TUCB
Work for a user has been completed at the logged TUCB.
SSRB
UDW1: SRB
UDW2: ASCB
UDW3: ARCBAn SRB is being scheduled for a user address space. The ASCB and ARCB are logged. The SRB address is given.
SOPN
UDW1: TPCB
UDW2: EPCB
UDW3: TIBAn OPEN request is being processed. The selected service is given by the TPCB and TIB.
SCLO
UDW1: FUNCTION
UDW2: ARCB/TUCBAn ACLOSE is being processed. These are the function codes:
0 - Normal ACLOSE
4 - Abortive ACLOSE at end of memory
8 - Abortive ACLOSE at end of task
The ARCB or TUCB is given.
TEOJ
UDW1: ASID
UDW2: TCB
UDW3: ARCB/TUCBAn end of task or end of memory (end of address space) event has taken place for a task using the API.
TPEN
UDW1: SRE
UDW2: EPCB
UDW3: TPCB
UDW4: REASONA TPEND exit is being driven. The endpoint EPCB is given. The reason codes are from the TXP.
ENPT
PROV
Table 3-3 PROV-type API internal trace entries
Flags and Return Codes
This section provides additional information on the SRE flags, TPL flags, and APICTFRE return codes.
SRE Flags
Table 3-4 SRE flags
TPL Flags
Table 3-5 IPL flags
Flag Descriptionx'80'
Completed.
x'40'
Completed with error.
x'20'
External ECB.
x'10'
Completion exit routine.
x'08'
AMODE 31.
x'04'
Accepting connect.
APICTFRE Return Codes
Table 3-6 APICTFRE return codes
Flag Description0
Normal completion.
4
Completion exit.
8
Flushing SREs.
12
Protocol event exit.
16
Failed, no XWAs.
20
Abortive close.
IFS Internal Trace Entries
This section describes IFS internal trace entries, listed alphabetically by type.
ABND
Table 3-7 ABND-type IFS internal trace entries
CALL
DISP
Table 3-9 DISP-type IFS internal trace entries
IUCV
![]()
Note
The maximum internal trace table size is now 1024 pages.
TRGCLS Table
Table 3-11 TRGCLS function call values (for use in interpreting Internal Traces)
LOCK
MSG
PAGE
PMGR
Table 3-15 PMGR-type IFS internal trace entries
POST
Table 3-16 POST-type IFS internal trace entries
Subtype User Fields/Modules DescriptionUDW1-UDW5: Not used
Modules: IFSSTDRVTask driver posted.
SCHD
Table 3-17 SCHD-type IFS internal trace entries
SSOB
Table 3-18 SSOB-type IFS internal trace entries
TSO
Table 3-19 ISO-type IFS internal trace entries
VTAM
WAIT
Table 3-21 WAIT-type IFS internal trace entries
Subtype User Fields/Modules DescriptionUDW1-UDW5: Not used
Modules: IFSSTDRVTask driver entering wait state.