Content of the trace records
You can evaluate DC trace records while debugging errors, building keywords, or evaluating APAR descriptions.
You can evaluate DC trace records during any of the following tasks:
- Debugging user errors in exit routines or user modifications relating to communications
- Debugging errors in other entities in the communication network (such as programmable terminals or other host processors)
- Building a keyword string to search for known problems
- Evaluating existing APAR descriptions to isolate problems that are most like the one you are experiencing
The first line of each trace record shows the ID:
ID= xxx SEGNO= mm RECNO= nnnnnnnn TIME HH.MM.SS.TT DATE YY.DDD
xxx can be any of the following trace record identifiers (IDs):1
- ID
- Description
- A xx
- Communication analyzer activity (DFSICIO0)
- AERx
- Access method error
- C xx
- Communication analyzer activity (DFSCIOC0 in DFSICIO0)
- CI04
- TM shared queues re-read error detected
- CIO2
- Device-dependent module (DDM) SDC read for output
- CIO3
- Device-dependent module (DDM) conditional SDC wash output
- CMEA
- Before calling Message Control/Error exit DFSCMUX0
- CMEB
- After calling Message Control/Error exit DFSCMUX0
- CMEI
- Message Control/Error exit interface processing
- COFC
- Entry to the output format control, MFS-supported devices (DFSCOFC0)
- CRTU
- Output User Creation user exit routine failure
- CTTR
- ISC TCPIP Trace ABORT.
- CVCT
- VTAM® trace. This log record is written even though DC trace is not active on the terminal/link.
- CVCV
- XRF class 2 takeover trace. This log record is written for XRF class 2 terminals during takeover, even though DC trace is not active on the terminal.
- D xx
- Device-dependent module (DDM) activity
- DDxx
- Output processing by DFSCOFC0
- DSIM
- SIMLOGON attempt of a dynamic terminal
- ESIM
- SIMLOGON error for a dynamic terminal
- FERR
- MFS-block fetch error
- FESx
- Front-end switch user exit routine activity
- FEXT
- Before field edit exit routine
- FMTx
- Message Format Service activity (MFS)
- HCSW
- XRF class 1 takeover trace. This log record is written for XRF class 1 terminals during takeover, even though DC trace is not active on the terminal.
- ICLR
- Message router activity
- INIT
- Device-dependent module (DDM) for ISC TCP/IP that sends session initiation requests.
- IRxx
- Device-dependent module (DDM) for ISC TCP/IP that reads input messages that use the IBM® CICS® Transaction Server for z/OS® IPIC protocol.
- IWxx
- Device-dependent module (DDM) for ISC TCP/IP that builds output messages that use the CICS IPIC protocol.
- MFSP
- MFS activity to detect change in the content of a protected field that is in the input from a 3270 or SLU2 device. Set MFSPFV=Y in the DFSDCxxx member of the IMS PROCLIB data set to configure this option. This log record is written even though DC trace is not active on the terminal.
- MSGS
- Device-dependent module (DDM) for ISC TCP/IP that sends messages that use the CICS IPIC protocol.
- MTRP
- Block verification error
- RESP
- Device-dependent module (DDM) for ISC TCP/IP that sends ACK/NAK messages that use the CICS IPIC protocol.
- SDC1
- Device-dependent module (DDM) SDC output read error
- SDC2
- Device-dependent module (DDM) SDC message reread error
- SEXT
- Before segment edit exit routine
- SGNX
- Signon user exit routine failure
- SPCL
- Close spool data set
- SPOP
- Open spool data set
- SPRE
- Read spool data set
- SPWR
- Write spool data set
- TERM
- Device-dependent module (DDM) for ISC TCP/IP that sends session termination requests.
- TRCE
- Non-SNA 3270 error
- VTPO
- Non-posting of ECB trace (DFSVTPO0)
Exception: MSC has its own analyzer module and entry types.
The table below shows the types of data communication (DC) trace records and what each trace record contains. Some of the acronyms used in the table are:
- SEG
- Segment (DECAREA buffer)
- MFS
- MFS input work/MFS output work/MFS protect work
- QBUF
- Queue buffer
- IOPUF
- TP buffer
- S25
- Save area 2-5
- SALL
- Save area all
| Trace ID | Function | Traced by | When traced or /TRACE option | What is traced |
|---|---|---|---|---|
| A01 | Process input. 1 | DFSICIO0 9 | ALL, DDM | CTB, CLB, CXB, CRB, CIB, CCB, QBUF, IOBUF, INPCNTS, OUTCNTS, EMHB 2 |
| A02 | Do read. 1 | DFSICIO0 9 | ALL, DDM | CTB, CLB, CXB, CRB, IOBUF, EMHB 2 |
| A03 | What is next. | DFSICIO0 9 | ALL, DDM | CTB, CLB, CRB, CTT |
| A04 | Get Next segment. | DFSICIO0 9 | ALL, DDM | CTB, CLB, CNT |
| A05 | Do write. 1 | DFSICIO0 9 | ALL, DDM | CTB, CLB, CXB, CRB, CCB, IOBUF, EMHB 2 |
| A06 | After good write. | DFSICIO0 9 | ALL, DDM | IOB, CTB, CLB, CXB, CRB, CCB |
| A07 | After bad write. 1 | DFSICIO0 9 | ALL, DDM | IOB, CTB, CLB, CRB, CCB, IOBUF, EMHB 2 |
| A08 | Cancel message, do not DEQ. | DFSICIO0 9 | ALL, DDM | CTB, CLB, CRB |
| A09 | Generate system message. 1 | DFSICIO0 9 | ALL, DDM | CTB, CLB, CRB, MFS |
| A10 | Quiesce without stopping. | DFSICIO0 9 | ALL, DDM | CTB, CLB, CRB, CCB |
| A11 | Retrieve last DEQD message. | DFSICIO0 9 | ALL, DDM | CTB, CLB, CNT, CRB |
| A12 | Wait for ASYNC I/O or output ENQ. | DFSICIO0 9 | ALL, DDM | CTB, CLB, CRB, CCB, IOBUF, EMHB 2 |
| AER1 | Access method error. | DFSICIO0 9 | Always | CTB, CLB, CNT, QBUF, SALL, CTT, PCB |
| AER2 | Access method error. 3, 1 | DFSICIO0 9 | Always | IOB, CTB, CLB, CNT, CXB, CRB, CIB, CCB, QBUF, IOBUF, SALL, CTT, PCB, EMHB 2 |
| C00 | Get queue buffer. | DFSICIO0 9 | ALL, MFS | CTB, CNT, CIB, SALL |
| C01 | Reposition queue buffer. | DFSICIO0 9 | ALL, MFS | CTB, CNT, CIB, SALL |
| C02 | Get Next. | DFSICIO0 9 | ALL, MFS | CTB, CNT, CIB, SALL |
| C03 | DEQ output. | DFSICIO0 9 | ALL, MFS | CTB, CNT, CIB, SALL |
| C04 | Place output back in queue. | DFSICIO0 9 | ALL, MFS | CTB, CNT, CIB, SALL |
| C05 | Find output. | DFSICIO0 9 | ALL, MFS | CTB, CNT, CIB, SALL |
| C06 | Get new output message or QMGR call. | DFSICIO0 9 | ALL, MFS | CTB, CNT, CIB, SALL |
| C07 | Free input buffer. | DFSICIO0 9 | ALL, MFS | CTB, CNT, CIB, SALL |
| C08 | Get output buffer. | DFSICIO0 9 | ALL, MFS | CTB, CNT, CIB, SALL |
| C09 | User output edit. | DFSICIO0 9 | ALL, MFS | CTB, CNT, CIB, SALL |
| C10 | Call queue MGR. | DFSICIO0 9 | ALL, MFS | CTB, CNT, CIB, SALL |
| C11 | Get device-dependent module (DDM) work buffer. | DFSICIO0 9 | ALL, MFS | CTB, CNT, CIB, SALL |
| C12 | Free device-dependent module (DDM) work buffer. | DFSICIO0 9 | ALL, MFS | CTB, CNT, CIB, SALL |
| C13 | Free receive-any buffer. | DFSICIO0 9 | ALL, MFS | CTB, CNT, CIB, SALL |
| CIO2 | Device-dependent module (DDM) SDC read output | DFSCIO20 | ALL DDM | copy ctl blk list from CVCT entry |
| CIO3 | Device-dependent module (DDM) SDC wash output | DFSCIO30 | ALL DDM | copy ctl blk list from CVCT entry |
| CMEA | Before call MSG CTRL Error exit. | DFSCMEI0 | Before call DFSCMUX0 | If ITASK is a CLB or LLB: CTB, CLB, CRB, QBUF, IOBUF, INP/OUTP CNTS, DDM, MSNB |
| CMEB | After call MSG CTRL Error exit. | DFSCMEI0 | After call DFSCMUX0 | If ITASK is a CLB or LLB: CTB, CLB, CRB, QBUF, IOBUF, INP/OUTP CNTS, DDM, MSNB If ITASK is a PST: PST, MSGPRFX, SMB, MSNB |
| CMEI | Error procedure in DFSCMEI0. | DFSCMEI0 | On some errors | If ITASK is a CLB or LLB: CTB, CLB, CRB, QBUF, IOBUF, INP/OUTP CNTS, DDM, MSNB If ITASK is a PST: PST, MSGPRFX, SMB, MSNB |
| COFC | Let MFS edit output. | DFSICIO0 9 | ALL, DDM | CTB, CLB, CNT, CRB, CIB, IOBUF, EMHB 2 |
| CRTU | Output User Creation exit routine failure. | DFSCRTU0 | Always | See notes10 |
| CTTR | ISC TCP/IP Trace ABORT | DFSCTTR0 | All, DDM | CTB,CLB,CRB,SPQB, SPQBEXT,INP_CNTS, CTT, IOBUF, LU6WA, TCPWORK, CTBWORK |
| CVCT | VTAM TRACE/ABORT. 1 | DFSCVCT0 | ALL, DDM | CTB, CLB, CNT, CRB, IOBUF, CTT, INPCNTS, EMHB 2 |
| CVCV | XRF class 2 takeover. 1 | DFSCVCV0 | Always | CLB, CTB, CTT, LLB, LTB, LXB, LU6WA, CNT, CRB, SPQB, CTC, MSNB, EMHB, IOBUF, DDM |
| D01 | Write setup. | DFSICIO0 9 | ALL, DDM | CTB, CLB, CNT, CRB, CIB, QBUF, S25 |
| D02 | Write interrupt. 1 | DFSICIO0 9 | ALL, DDM | IOB, CTB, CLB, CRB, IOBUF, S25, EMHB 2 |
| D03 | Read setup. | DFSICIO0 9 | ALL, DDM | CTB, CLB, CNT, CRB |
| D04 | Read interrupt. 1 | DFSICIO0 9 | ALL, DDM | IOB, CTB, CLB, CRB, IOBUF, S25, EMHB 2 |
| D05 | Cleanup. | DFSICIO0 9 | ALL, DDM | IOB, CTB, CLB, CNT, CXB, CRB, CIB, CCB, MFS, QBUF, IOBUF, SALL, EMHB 2 |
| D07 | LOGON. 1 | DFSICIO0 9 | ALL, DDM | CTB, CLB, CNT, CRB |
| DD6M | Output build (MFS). | DFSCOFC0 | ALL, DDM | CTB, CLB, CNT, CRB, CIB, SEG, MFS, IOBUF, S25, EMHB 2 |
| DD6S | Output build (Non-MFS). | DFSCOFC0 | ALL, DDM | CTB, CLB, CNT, CRB, CIB, IOBUF, S25, EMHB 2 |
| DD8 | Prepare for output. | DFSCOFC0 | ALL, DDM | CTB, CLB, CNT, CRB, CIB, IOBUF, S25, EMHB 2 |
| DDM1 | Write set up through COFC. | DFSCOFC0 | ALL, DDM | CTB, CLB, CNT, CRB, CIB, MFS, IOBUF, S25, EMHB 2 |
| FERR | MFS block fetch error. 3 | DFSCFEO0 | Always | CIB, CTT, MFSBPCA, MFSTRACE 4 |
| FES1 | Entry to front end switch user exit. | DFSICIO0 9 | CTB, CLB, CNT, QBUF, S25 | |
| FES2 | Exit from front end switch user exit. | DFSICIO0 9 | CTB, CLB, CNT, QBUF, S25 | |
| FEXT 5 | Before field edit exit. | DFSCFEI0 | MFS | CTB, CIB |
| FMT1 | Return from DFSFEIO or unformatted input. | DFSICIO0 9 | ALL, MFS | CTB, CLB, CIB, IOBUF, EMHB 2 |
| FMT2 | MFS go to DFSFEIO formatted input. | DFSICIO0 9 | ALL, MFS | CTB, CLB, CIB, IOBUF, EMHB 2 |
| FMT3 | MFS complete process MSG segment. | DFSICIO0 9 | ALL, MFS | CTB, CLB, CIB, MFS, QBUF |
| FMT4 | Get next input. | DFSICIO0 9 | ALL, MFS | CTB, CLB, CIB |
| FMT6 | Clean up resources. | DFSICIO0 9 | ALL, MFS | CTB, CLB, CIB |
| HCSW | XRF class 1 takeover. 1 | DFSHCSW0 | Always | IOBUF, CNT, CRB, CTT, CTB, CLB |
| ICLR | Message router. | DFSICLR0 | Always | CTB, CLB, CTT, PCB |
| INIT | Device-dependent module (DDM) for ISC TCP/IP that sends session initiation requests. | DFSCT7E0 | All, DDM | CTB,CLB,CRB,SPQB, SPQBEXT,INP_CNTS, CTT, IOBUF, LU6WA, TCPWORK, CTBWORK |
| IR4B | Device-dependent module (DDM) for ISC TCP/IP that reads input messages that use the CICS IPIC protocol. | DFSCT4B0 | All, DDM | CTB,CLB,CRB,SPQB, SPQBEXT,INP_CNTS, CTT, IOBUF, LU6WA, TCPWORK, CTBWORK |
| IR7A | Device-dependent module (DDM) for ISC TCP/IP that reads input messages that use the CICS IPIC protocol. | DFSCT7A0 | All, DDM | CTB,CLB,CRB,SPQB, SPQBEXT,INP_CNTS, CTT, IOBUF, LU6WA, TCPWORK, CTBWORK |
| IR8B | Device-dependent module (DDM) for ISC TCP/IP that reads input messages that use the CICS IPIC protocol. | DFSCT8B0 | All, DDM | CTB,CLB,CRB,SPQB, SPQBEXT,INP_CNTS, CTT, IOBUF, LU6WA, TCPWORK, CTBWORK |
| IW1B | Device-dependent module (DDM) for ISC TCP/IP that builds output messages that use the CICS IPIC protocol.. | DFSCT1B0 | All, DDM | CTB,CLB,CRB,SPQB, SPQBEXT,INP_CNTS, CTT, IOBUF, LU6WA, TCPWORK, CTBWORK |
| IW3B | Device-dependent module (DDM) for ISC TCP/IP that builds output messages that use the CICS IPIC protocol. | DFSCT3B0 | All, DDM | CTB,CLB,CRB,SPQB, SPQBEXT,INP_CNTS, CTT, IOBUF, LU6WA, TCPWORK, CTBWORK |
| IW6A | Device-dependent module (DDM) for ISC TCP/IP that builds output messages that use the CICS IPIC protocol. | DFSCT6A0 | All, DDM | CTB,CLB,CRB,SPQB, SPQBEXT,INP_CNTS, CTT, IOBUF, LU6WA, TCPWORK, CTBWORK |
| IW7A | Device-dependent module (DDM) for ISC TCP/IP that builds output messages that use the CICS IPIC protocol. | DFSCT7A0 | All, DDM | CTB,CLB,CRB,SPQB, SPQBEXT,INP_CNTS, CTT, IOBUF, LU6WA, TCPWORK, CTBWORK |
| IW8A | Device-dependent module (DDM) for ISC TCP/IP that builds output messages that use the CICS IPIC protocol. | DFSCT8A0 | All, DDM | CTB,CLB,CRB,SPQB, SPQBEXT,INP_CNTS, CTT, IOBUF, LU6WA, TCPWORK, CTBWORK |
| MFSP | MFS detected that protected data that is in the input is altered. | DFSCFEI0 | Always | CTB, CLB, CIB, MFS, IOBUF |
| MSGS | Device-dependent module (DDM) for ISC TCP/IP that sends messages that use the CICS IPIC protocol. | DFSCT7E0 | All, DDM | CTB,CLB,CRB,SPQB, SPQBEXT,INP_CNTS, CTT, IOBUF, LU6WA, TCPWORK, CTBWORK |
| MTRP 8 | Block verification error. | DFSCFEO0 | CLB, CIB, MFS, CTT | |
| MTRP 7 | Block verification error. | DFSCFEI0 | CLB, CIB, MFS, CTT | |
| RESP | Device-dependent module (DDM) for ISC TCP/IP that sends ACK/NAK messages that use the CICS IPIC protocol. | DFSCT7E0 | All, DDM | CTB,CLB,CRB,SPQB, SPQBEXT,INP_CNTS, CTT, IOBUF, LU6WA, TCPWORK, CTBWORK |
| SDC1 | Device-dependent module (DDM) SDC read error | DFSCIO20 | ALL DDM | copy ctl blk list from CVCT entry |
| SDC2 | Device-dependent module (DDM) SDC reread error | DFSICIO4 | ALL DDM | copy ctl blk list from CVCT entry |
| SEXT 6 | Before segment edit exit. | DFSCFEI0 | MFS | CTB, CIB |
| TERM | Device-dependent module (DDM) for ISC TCP/IP that sends session termination requests. | DFSCT7E0 | All, DDM | CTB,CLB,CRB,SPQB, SPQBEXT,INP_CNTS, CTT, IOBUF, LU6WA, TCPWORK, CTBWORK |
| TRCE | Non-SNA 3270 error. | DFSDN130, DFSDN140, DFSDS060 | Always | IOB, CTB, CLB, S25, CTT |
| VTPO | Rejected posting of ECB. | DFSVTPO0 | ALL, DDM | See notes11 |
Notes:
- See Diagnosing line and terminal problems for more information on this trace code.
- Fast Path EMHB buff traces (if present) with I/O buffers
- Module return code saved in CLBTEMP4
- Return codes from DFSFFRH0 (block fetch), MFSTRACE (when in MFSTEST) or MFSBPCA
(when not in MFSTEST); MFSTRACE=MFSTEST trace parameters, MFSBPCA=MFS Buffer Pool Control Area:
- Offset in hex
- 0
- Current pool space in use
- 4
- Maximum space used
- 5
- Status flag
X'80' I/O active for a task
X'40' Task(s) queued for I/O
X'20' A task dequeued and posted - 9
- Error status
X'BB' BLDL error
X'FF' READ error - A
- Block name for BLDL error
- 10
- BLDL return code on error
- 12
- Sense from read error
- 14
- CSW status from read error
- 16
- Block name for read error
- 20
- List for BLDL macro
- Besides CIB and CTB:
- PARMLIST
- Parameter list to be passed to EXIT
- FIELD
- Field data before exit
- Besides CIB and CTB:
- PARMLIST
- Parameter list to be passed to EXIT
- SEGMENT
- Segment data before exit
- SEXT is logged if TRAP 1 is set by /TRACE and a buffer overwrite occurs.
- MTRP is logged if TRAP 1 is set by /TRACE and a buffer overwrite occurs. In addition to the blocks, the DIF/DOF, MID/MOD, MFBP, and FRE are traced. If in output, R9 is also traced.
- The MSNB control block content is traced by DFSICIO0 if the /DEQ LTERM, /DEQ NODE, or the /DEQ MSNAME command is entered with the PURGE or PURGE1 keywords.
- The CRTU trace entry is mapped in Format of 6701 log record with CRTU identifier.
- The VTPO trace entry is mapped in Format of the 6701 log record with VTPO identifier.
1 An asterisk (*) in this list is a wildcard character,
meaning that any character can replace the asterisk.