Formatting the LU manager trace
The general format of an LU manager trace record is shown. Each record is 8 words long. Word 0 holds standard information for each record.
LU manager trace record format
WORD 0 | WORD 1 | WORD 2 | WORD 3 | WORD 4 | WORD 5 | WORD 6 | WORD 7 | ||
---|---|---|---|---|---|---|---|---|---|
ID | SEQ NUM |
- where
- represents
- ID
- Two-byte trace ID.
- SEQ NUM
- Two-byte trace sequence number assigned by the IMS trace component.
Words 1 thru 7 contain data specific to each trace entry, as described below:
TRACE ID = X'7B01' LUM
module entry
- Word 1
- byte 0:Module number bytes 1-3: Reserved
- Word 2
- A(ECB)
- Word 3
- Register 1
- Words 4-5
- Optional user data
- Words 6-7
- Time stamp (STCK)
TRACE ID = X'7B02' LUM module
exit
- Word 1
- byte 0:Module number bytes 1-3: Reserved
- Word 2
- A(ECB)
- Word 3
- Return code
- Words 4-5
- Optional user data
- Words 6-7
- Time stamp (STCK)
TRACE
ID = X'7B03' IMS internal
LUM error
- Word 1
- byte 0:Module number bytes 1-3: 0
- Word 2
- Error code
- Word 3
- TIB address
- Word 4
- TIB prefix address
- Word 5
- 0
- Words 6-7
- Time stamp (STCK)
TRACE ID = X'7B04' IMS APPC Status Change
- Word 1
-
- byte 0: Module number
- byte 1: AWE function requested code
- X'01': Initialization request
- X'02': Dependent region connected
- X'03': Start APPC
- X'04': Stop APPC
- X'05': Purge APPC
- X'06': Cancel APPC
- X'07': Terminate APPC
- X'08': Attach request
- X'09': APPC initialized
- X'0A': APPC stopped
- X'0B': LU activated
- X'0C': LU deactivated
- X'0D': XRF takeover
- X'0E': Clear TIBs
- X'0F': Build LU6.2 descriptors
- byte 2: Current APPC
status
- X'C1':Starting
- X'C3':Cancelled
- X'C4':Disabled
- X'C5':Enabled
- X'C6':Failed
- X'D6':Outbound
- X'D7':Purging
- X'E2':Stopped
- byte 3: Desired/requested APPC status
- X'C1':Starting
- X'C3':Cancelled
- X'C4':Disabled
- X'C5':Enabled
- X'C6':Failed
- X'D6':Outbound
- X'D7':Purging
- X'E2':Stopped
- Word 2
- A(ECB)
- Word 3
-
- byte 0: Last APPC status
- X'C1':Starting
- X'C3':Cancelled
- X'C4':Disabled
- X'C5':Enabled
- X'C6':Failed
- X'D6':Outbound
- X'D7':Purging
- X'E2':Stopped
- byte 1: Last Desired/requested APPC status
- X'C1':Starting
- X'C3':Cancelled
- X'C4':Disabled
- X'C5':Enabled
- X'C6':Failed
- X'D6':Outbound
- X'D7':Purging
- X'E2':Stopped
- bytes 2-3: 0
- byte 0: Last APPC status
- Word 4
- 0
- Word 5
- 0
- Words 6-7
- Time stamp (STCK)
TRACE ID = X'7B05' LUM
module IWAIT
- Word 1
- byte 0:Module number bytes 1-3: Reserved
- Word 2
- A(ECB)
- Word 3
- TIB_SYNC_PTR
- Words 4
- A(TIB)
- Words 5
- 0
- Words 6–7
- Time stamp (STCK)
TRACE ID = X'7B06' LUM
module IPOST
- Word 1
- byte 0:Module number bytes 1-3: 0
- Word 2
- A(ECB)
- Word 3
- TIB_SYNC_PTR
- Words 4
- A(TIB)
- Words 5
- 0
- Words 6–7
- Time stamp (STCK)
TRACE ID = X'7B07' z/OS® cross-system coupling facility sendmsg
- Word 1
-
- Byte 0: Module number - see Table 1
- Bytes 2-3: Function Return Code
- Word 2
- A(TIB)
- Words 3-6
- TIB MSG PREFIX URTOKEN
- Word 7
- Time stamp (STCK)
TRACE ID = X'7B08' AWE server
TIB POST
- Word 1
-
- Byte 0: Module number - see Table 1
- Bytes 2-3: Return code
- Word 2
- A(ECB)
- Word 3
- AOS POST CODE
- Word 4
- A(TIB)
TRACE ID = X'7B09' Request sent
to z/OS Resource Recovery Services AWE
server
- Word 1
-
- Byte 0: Module number - see Table 1
- Bytes 2-3: AWRRFUNC
- Word 2
- A(ECB)
- Word 3
- AOS POST CODE
- Words 4–7
- MSG PREFIX URTOKEN
TRACE ID = X'7C01' Normal return from APPC/MVS
- Word 1
-
- byte 0: Module number - See Table 1.
- byte 1: ATB call number - See Table 1.
- byte 2: ATB flags
- bit 0: Verb issued for asynchronous processing
- bit 1: Return code is from asynchronous processing
- bit 2: CID given and all zeros
- bit 3: TPID field has user data
- bit 4: CID field has user data
- byte 3: Optional user data
- Words 2-3
- TPID or user data
- Words 4-5
- CID or user data
- Word 6
- Return code
- Word 7
- A(ECB)
TRACE ID = X'7C02' Unexpected return code from APPC/MVS
- Word 1
-
- byte 0: Module number
- byte 1: ATB call number
- byte 2: ATB flags
- bit 0: Verb issued for asynchronous processing
- bit 1: Return code is from asynchronous processing
- bit 2: CID given and all zeros
- bit 3: TPID field has user data
- bit 4: CID field has user data
- byte 3: Optional user data
- Words 2-3
- TPID or user data
- Words 4-5
- CID or user data
- Word 6
- Return code
- Word 7
- A(ECB)
TRACE ID = X'7C03' APPC/MVS asynchronous verb entry
- Word 1
-
- byte 0: Module number
- byte 1: ATB call number
- byte 2: ATB flags
- bit 0: Verb issued for asynchronous processing
- bit 1: Return code is from asynchronous processing
- bit 2: CID given and all zeros
- bit 3: TPID field has user data
- bit 4: CID field has user data
- byte 3: Optional user data
- Words 2-3
- TPID or user data
- Words 4-5
- CID or user data
- Word 6
- Reserved (FFFFFFFF)
- Word 7
- A(ECB)
TRACE ID = X'7F01' APPC Attach from APPC/MVS
- Word 1
- Reserved
- Word 2
- XCF message type
- Words 3-4
- TPID for XCF message
- Words 5-6
- Local LU to which ATTACH request was directed
- Word 7
- Time stamp (STCK)
TRACE ID = X'7F02' IMS LU activating or deactivating
- Word 1
- Reserved
- Word 2
- XCF message type
- Word 3
- XCF message LU flags bit 0: LU is base LU
- Words 4-5
- LU name
- Word 6
- 0
- Word 7
- Time stamp (STCK)
TRACE ID = X'7F03' APPC/MVS starting or stopping
- Word 1
- Reserved
- Word 2
- XCF message type
- Words 3-6
- 0
- Word 7
- Time stamp (STCK)
TRACE ID = X'7F04' CPOOL
storage shortage
- Word 1
- Reserved
- Word 2
- XCF message type
- Word 3
- XCF message length
- Words 4-5
- TPID from XCF message
- Word 6
- 0
- Word 7
- Time stamp (STCK)
TRACE ID = X'7F05' CPOOL
block too small for XCF message
- Word 1
- Reserved
- Word 2
- XCF message type
- Word 3
- XCF message length
- Word 4
- Cell size
- Words 4-5
- TPID from XCF message
- Word 6
- 0
- Word 7
- Time stamp (STCK)
TRACE ID = X'7F06' Invalid
request from XCF
- Word 1
- Reserved
- Word 2
- XCF message type
- Word 3
- 0
- Words 4-5
- MEPLSRCE map
- Word 6
- 0
- Word 7
- Time stamp (STCK)
TRACE ID = X'7F07' APPC/MVS not enabled for Attach
- Word 1
- Reserved
- Word 2
- XCF message type
- Word 3
-
- byte 0: LSCD status (disabled, failed, stopped)
- byte 1: LSCD IN flags (LSCD - APPC/IMS global control block)
- byte 2: LSCD OUT flags
- byte 3: LSCD flags
- Word 4
- 0
- Words 5-6
- TPID from XCF message
- Word 7
- Time stamp (STCK)
TRACE ID = X'7F09' TP
deallocate failed
- Word 1
- Reserved
- Word 2
- XCF message type
- Word 3
- Return code
- Words 4-6
- 0
- Word 7
- Time stamp (STCK)