OPTIONS parameter

APPC trace request options are hierarchical. Figure 1 shows the hierarchy of SYSAPPC trace options. Each option traces its own events, plus all the events of the options below it. For example, if you specify the SCHEDULE trace option, the system also traces ENQWORK, DEQWORK, and ASMANAGE events.

Figure 1. Hierarchy of SYSAPPC Component Trace Options. Hierarchy of SYSAPPC Component Trace Options

                            ┌────────────────────────┬──────────────┐
                            │                        │              │
                        ┌───┴──┐                  ┌──┴────┐      ┌──┴───┐
                        │GLOBAL│                  │USERID │      │NODUMP│
                        └───┬──┘                  └───────┘      └──────┘
                            │
                      ┌─────┴────────────────┐
                      │                      │
                  ┌───┴────┐                 │
                  │GLOBALQK│                 │
                  └────────┘                 │
                                             │
           ┌────────────────────────┬────────┴───────────┬─────────┬───────────┬──────────┐
           │                        │                    │         │           │          │
       ┌───┴───┐                ┌───┴────┐            ┌──┴──┐  ┌───┴────┐  ┌───┴───┐  ┌───┴──┐
       │INBOUND│                │SCHEDULE│            │VERBS│  │CONVCLUP│  │TRANSCH│  │SERVER│
       └───┬───┘                └───┬────┘            └──┬──┘  └────────┘  └───────┘  └──────┘
           │                        │                    │
      ┌────┴────┐         ┌─────────┼─────────┐          │
      │         │         │         │         │          │
  ┌───┴───┐ ┌───┴──┐  ┌───┴───┐ ┌───┴───┐ ┌───┴────┐  ┌──┴──┐
  │ FMH5  │ │ FMH7 │  │ENQWORK│ │DEQWORK│ │ASMANAGE│  │ PBI │
  └───┬───┘ └──────┘  └───────┘ └───────┘ └────────┘  └─────┘
      │
  ┌───┴───┐
  │BADFMH5│
  └───────┘

SYSAPPC tracing always includes all exception (error) events. If no trace options are specified, the trace output includes only the exception events.

If you do not know where the errors are occurring, use the GLOBAL trace option to catch the full range of APPC/MVS events. GLOBAL can slow performance, but you will catch the error in one re-create.

The values for the OPTIONS parameter for the CTnAPPxx parmlib member and reply for a TRACE command, in alphabetical order, are:

ASMANAGE: Traces events related to the creation and deletion of the APPC/MVS transaction scheduler's subordinate address space. ASMANAGE is a subset of SCHEDULE events.
BADFMH5: Traces events related to incorrect FMH-5s. BADFMH5 is a subset of FMH-5 events.
CONVCLUP: Traces events related to conversation cleanup. CONVCLUP is a subset of GLOBAL events.
DEQWORK: Traces the process of removing work requests from an APPC/MVS scheduler queue. DEQWORK is a subset of SCHEDULE events.
ENQWORK: Traces the process of adding work requests to an APPC/MVS scheduler queue. ENQWORK is a subset of SCHEDULE events.
FMH5: Traces FMH-5 events. FMH5 is a subset of INBOUND events.
FMH7: Traces FMH-7 events. FMH7 is a subset of INBOUND events.
GLOBAL: Traces the full range of APPC/MVS events.
GLOBALQK: Traces a subset of important GLOBAL trace events.
INBOUND: Traces inbound transaction processor (TP) requests. INBOUND is a subset of GLOBAL events.
NODUMP: Specifies no dumping when the operator stops the SYSAPPC component trace. Otherwise, component trace requests an SVC dump with the trace data when the operator stops tracing with a TRACE CT,OFF command.
IBM® does not recommend the NODUMP option because the option makes obtaining the trace buffers difficult. The operator would have to identify the data space containing the buffers and specify it in a SLIP command or the reply for a DUMP command.
PBI: Traces events related to protocol boundary. PBI is a subset of VERBS events.
RR: Traces events related to the participation of APPC/MVS in resource recovery for protected conversations. RR is a subset of VERBS events.
SERVER: Traces events related to the APPC/MVS servers. SERVER is a subset of GLOBAL events.
SCHEDULE: Traces events related to the APPC/MVS transaction scheduler. SCHEDULE is a subset of GLOBAL events.
TRANSCH: Traces events related to APPC/MVS transaction scheduler interface support. TRANSCH is a subset of GLOBAL events.
USERID=(userid,userid): Traces events for only the specified userid or userids. Specify the TSO/E userid of the person reporting a problem with an APPC/MVS application. Specify from 1 through 9 userids.
VERBS: Traces events related to outbound TPs or LU services. VERBS is a subset of GLOBAL events.