You can specify the OPTION operand in the TRACE start option or in the MODIFY TRACE command. Deactivate the VIT before you attempt to change an option; otherwise, the options that are currently in effect will remain in effect. See Deactivating the VIT for more information about deactivating the VIT.
Table 1 describes the options that you can specify on the OPTION operand. Select one or more of these options to indicate the VTAM® functions you want to trace.
| Option | Description |
|---|---|
| API option (for application programming interfaces) | This option helps you determine whether an application program is causing a problem. API entries are written for RPL macros, RPL exit routines, user exit routines, and user posts. Trace data for this option is always automatically recorded in the internal table. |
| APIOPTS option | This option is a collection of multiple VIT options that includes all the individual VIT options required to diagnose potential application program problems. Specifying the APIOPTS option is equivalent to specifying all the following VIT options: API, MSG, NRM, PIU, PSS, SMS, and SSCP. |
| APPC | This option helps you determine whether an LU 6.2 application is causing a problem. LU 6.2 entries are written for APPCCMD macro invocations, user posts, and exit scheduling by LU 6.2 code, calls to a security manager for security processing, and message unit transmissions between LU 6.2 components. |
| APPCOPTS option | This option is a collection of multiple VIT options that includes all the individual VIT options required to diagnose potential LU 6.2 application program problems. Specifying the APPCOPTS option is equivalent to specifying all the following VIT options: API, APPC, MSG, NRM, PIU, PSS, SMS, and SSCP. |
| CFS option (for coupling facility interfaces) | This option helps you determine problems with the VTAM interface with the MVS™ coupling facility. CFS entries are written when VTAM issues MVS macros to request services related to the coupling facility. |
| CIA option (for channel input and output auxiliary) | This option helps you isolate problems related to channel I/O CIA entries. This option presents the remaining trace records from the CIO option. |
| CIO option (for channel input and output) | This option helps you isolate problems related to channel I/O. CIO entries are written for attentions, error recovery, interruptions, HALT I/O SVC, and START I/O SVC. |
| CMIP option (for Common Management Information Protocol Services) | Setting the CMIP option enables the following
traces:
You can use the CMIP option to help you determine whether there is a problem in VTAM or in a CMIP application program. |
| CPCPOPTS option | This option is a collection of multiple VIT options that includes all the individual VIT options required to diagnose potential CP-CP session problems. Specifying the CPCPOPTS option is equivalent to specifying all the following VIT options: API, APPC, MSG, NRM, PIU, PSS, SMS, and SSCP. |
| CSM option (for communications storage manager events) | This option traces the parameter list information that flows across the CSM interface and key internal events (such as pool expansion and contraction) for functions that manipulate buffer states. You can trace and analyze the usage history of a buffer. You can also use the CSM trace when VTAM is not operational. An external trace is generated using the VTAM GTF event ID to write trace records directly to GTF in the same format as those recorded using VIT. |
| CSMOPTS option | This option is a collection of multiple VIT options that includes all the individual VIT options required to diagnose potential communications storage manager (CSM) problems. Specifying the CSMOPTS option is equivalent to specifying all the following VIT options: API, APPC, CIO, CSM, MSG, NRM, PIU, PSS, SMS, SSCP, and XBUF. |
| DLUROPTS option | This option is a collection of multiple VIT options that includes all the individual VIT options required to diagnose dependent LU requester (DLUR) problems. Specifying the DLUROPTS option is equivalent to specifying all the following VIT options: API, APPC, HPR, MSG, NRM, PIU, PSS, SMS, and SSCP. |
| EEOPTS option | This option is a collection of multiple VIT options that includes all the individual VIT options required to diagnose Enterprise Extender (EE) problems. Specifying the EEOPTS option is equivalent to specifying all the following VIT options: CIA, CIO, HPR, MSG, NRM, PIU, PSS, SMS, SSCP, and TCP. |
| ESC option (for execution sequence control) | This option helps you track, in detail, the flow of requests for a given process. |
| HPDTOPTS option | This option is a collection of multiple VIT options that includes all the individual VIT options required to diagnose high-performance data transfer (HPDT) problems. Specifying the HPDTOPTS option is equivalent to specifying all the following VIT options: CIA, CIO, HPR, MSG, PIU, PSS, SMS, and SSCP. |
| HPR option (for High-Performance Routing) | This option helps you isolate problems related to High-Performance Routing. |
| HPROPTS option | This option is a collection of multiple VIT options that includes all the individual VIT options required to diagnose High-Performance Routing (HPR) problems. Specifying the HPROPTS option is equivalent to specifying all the following VIT options: API, APPC, CIA, CIO, HPR, MSG, NRM, PIU, PSS, SMS, and SSCP. |
| LCS option (for local area network (LAN) channel stations) | This option helps you isolate problems that occur when an IBM® 3172 Interconnect Nways Controller is activating, deactivating, or transferring data. The LCS option enables tracing of data that VTAM receives from an IBM 3172 Interconnect Nways Controller at four levels: LCSX (channel), LCSP (port or adapter), LCSS (SAP), and LCSL (line). |
| LCSOPTS options | This option is a collection of multiple VIT options that includes all of the individual VIT options required to diagnose LAN channel station (LCS) problems. Specifying the LCSOPTS option is equivalent to specifying all the following VIT options: CIO, LCS, MSG, NRM, PIU, PSS, SMS, and SSCP. |
| LOCK option (for locking and unlocking) | This option helps you determine when VTAM modules obtain and release locks. |
| MSG option (for messages) | Specify this option to accomplish the following
tasks:
Trace data for this option is always automatically recorded in the internal table. |
| NRM option (for network resource management) | This option helps you follow the services of the network resource management component. These services include the assignment of, references to, and the deletion of certain VTAM resources such as node names, network addresses, and control blocks. NRM entries are written for SRT macros issued by VTAM modules. Trace data for this option is always automatically recorded in the internal table. CIDCTL FIND macro invocations used during the process of sending or receiving data are not traced with CDHF or CDNF trace entries unless they result in a nonzero return code. |
| PIU option (for path information unit flows) | This option, like the I/O and buffer contents traces, helps you isolate problems to hardware, to the NCP, or to VTAM. Unlike I/O and buffer contents traces, this option causes PIU entries to be written for all PIUs that flow internal and external to VTAM. Trace data for this option is always automatically recorded in the internal table. |
| PSS option (for process scheduling services) | This option helps you track the flow of requests through VTAM. PSS entries are written for the VTAM macros that invoke and control PSS, scheduling, and dispatching VTAM routines. |
| QDIOOPTS options | This option is a collection of multiple VIT options that includes all of the individual VIT options required to diagnose queued direct I/O (QDIO) problems. Specifying the QDIOOPTS option is equivalent to specifying all the following VIT options: CIA, CIO, HPR, MSG, NRM, PIU, PSS, SMS, and SSCP. |
| SMS option (for storage management services) | This option helps you isolate problems caused by storage shortages. When you specify this option with the SSCP or PSS trace option, it can also help you isolate internal VTAM problems. SMS entries are written when SMS macros are used to request or free fixed-length or variable-length buffers. SMS entries are also written when VTAM expands or attempts to expand a buffer pool. |
| SSCP option (for system services control point request scheduling and response posting) | This option helps you isolate a VTAM problem to a specific VTAM component or module. SSCP entries are written for the request/response units (RUs) sent between VTAM components. This option also records information for the APPN CP. Trace data for this option is always automatically recorded in the internal table. |
| STDOPTS option | This option is a collection of multiple VIT options that includes all of the individual VIT options required to diagnose problems related to high CPU, session services, storage, Open/Close ACB, and DLCs such as multipath channel (MPC) and channel-to-channel (CTC). Specifying the STDOPTS option is equivalent to specifying all the following VIT options: API, CIO, MSG, NRM, PIU, PSS, SMS, and SSCP. |
| TCP option (for use with Enterprise Extender) | This option is used for recording activity related to Enterprise Extender. The trace options record IP address management and timer activity. |
| TCPOPTS option | This option is a collection of multiple VIT options that includes all of the individual VIT options required to diagnose problems related to TCP/IP. Specifying the TCPOPTS option is equivalent to specifying all the following VIT options: CIA, CIO, MSG, NRM, PIU, PSS, SMS, SSCP, and TCP. |
| VCNS option (for VCNS application programming interfaces) | This option helps you determine whether a VCNS application is causing a problem. VCNS entries are written for VCNSCMD macro invocations, user posts, exit scheduling by VCNS code, and work element transmissions between VCNS components. |
| XBUF option (for applications that use the extended buffer list for sending and receiving data) | This option traces the contents of the extended buffer list (XBUFLST). Records are produced to trace these contents from the application-supplied extended buffer list and the internal buffer list that VTAM uses to carry the extended buffer list information. These records store relevant information contained with the extended buffer list, particularly information about CSM usage by VTAM. |
| XCF option (for VTAM use of the cross-system coupling facility) | Specify this option to track VTAM use of the XCF (cross-system coupling facility) MVS macro interface. Each VTAM use of an XCF macro has a VIT entry. |
| XCFOPTS option | This option is a collection of multiple VIT options that includes all of the individual VIT options required to diagnose cross-system coupling facility (XCF) problems. Specifying the XCFOPTS option is equivalent to specifying all the following VIT options: CIA, CIO, HPR, MSG, NRM, PIU, PSS, SMS, SSCP, and XCF. |
The VIT always traces the exception conditions listed in Table 2 and all the default VIT options listed under Activating the VIT.
| Option | Exception conditions traced |
|---|---|
| APPC |
|
| CFS | Entries with nonzero return codes |
| CIO | INOP entry |
| CMIP option | The following entries, when they have nonzero return codes:
|
| LCS | LCSL, LCSP, LCSS, and LCSX entries with nonzero reason codes |
| NRM | CDHF or CDNF entries with nonzero return codes |
| SMS | Entries with nonzero return codes and EXPN entries if a buffer pool expansion fails |
| SSCP | CPI, CPO, and CP2 |
| (No option) | All SNAP entries and some exception entries1. |
| Note:
|
|
Table 3 and Table 4 list the VIT options and the records that they create. For more information, see the list of notes after Table 4.
| VIT options | API | APPC | CFS | CIA | CIO | CMIP | CSM | ESC | HPR | LCS | LOCK |
|---|---|---|---|---|---|---|---|---|---|---|---|
| VIT records | AIx |
ACAx |
CFAx |
|
ADE |
MCO1 |
ASNx |
ESC | ARB |
LCSx | LKEX |
CCR
| VIT options | MSG | NRM | PIU | PSS | SMS | SSCP | TCP | VCNS | XBUF | XCF |
|---|---|---|---|---|---|---|---|---|---|---|
| VIT records | MSGx |
BSPx |
DCOx |
ATSK |
AREL |
AFSM |
IPAD |
CNA |
XBAx |
XCC2 |
- The **** (FFST and PFFST), ABND, BUFF, COPY, CMER, CME2, INOP, LOST, MMG, and MM2 trace records are not activated by specific VIT options. They are activated as a result of exception conditions.
- For CIO record types ATT, ERP, HIO, INT, SIO, with suffix I, X, or T, and INOP, the events are also captured in the NCB (pointed to by NCBCIOMV). The NCB trace table is mapped by NCBCIOAR.
- For CIA record types INOP, RCPx, RPLx and RPST, the events are also captured in the RUNCB (pointed to by NCBCIOMV).
- For CIA record type PCIR, the events are also captured in the SRNCB (pointed to by NCBCIOMV).
- OON and OOX can be generated when the module trace is running.
- For the IRBx and the SRBx records to be recorded, both the PSS trace option and the PSSTRACE start options must be specified.
- For APPC record types REMQ and ACSN, the events are also captured in the ISTRAB.
- Some trace records are generated only when a subtrace is active. These trace records are the HPR option record types ARBB, ARBR, the CIA option record types QAPL, QDIP, QSRx, RSLK, and the SSCP option record types HLSx, TGVx, TRMx, and TRRx. For more information about subtraces, see z/OS Communications Server: SNA Operation.
Table 5 lists the VIT group options and the individual VIT options that are equivalent for each group option.
| VIT group option | Equivalent to this set of individual VIT options |
|---|---|
| APIOPTS | API, MSG, NRM, PIU, PSS, SMS, SSCP |
| APPCOPTS | API, APPC, MSG, NRM, PIU, PSS, SMS, SSCP |
| CPCPOPTS | API, APPC, MSG, NRM, PIU, PSS, SMS, SSCP |
| CSMOPTS | API, APPC, CIO, CSM, MSG, NRM, PIU, PSS, SMS, SSCP, XBUF |
| DLUROPTS | API, APPC, HPR, MSG, NRM, PIU, PSS, SMS, SSCP |
| EEOPTS | CIA, CIO, HPR, MSG, NRM, PIU, PSS, SMS, SSCP, TCP |
| HPDTOPTS | CIA, CIO, HPR, MSG, PIU, PSS, SMS, SSCP |
| HPROPTS | API, APPC, CIA, CIO, HPR, MSG, NRM, PIU, PSS, SMS, SSCP |
| LCSOPTS | CIO, LCS, MSG, NRM, PIU, PSS, SMS, SSCP |
| QDIOOPTS | CIA, CIO, HPR, MSG, NRM, PIU, PSS, SMS, SSCP |
| STDOPTS | API, CIO, MSG, NRM, PIU, PSS, SMS, SSCP |
| TCPOPTS | CIA, CIO, MSG, NRM, PIU, PSS, SMS, SSCP, TCP |
| XCFOPTS | CIA, CIO, HPR, MSG, NRM, PIU, PSS, SMS, SSCP, XCF |