OPTIONS parameter

The values for the OPTIONS parameter for the CTnGRSxx parmlib member and reply for a TRACE command are listed below. The sub-options on the CONTROL, REQUEST, MONITOR, SIGNAL and FLOW, allow you to refine the set of events traced for the major option. When you select the major option, all events pertaining to that option are traced. However, you can select one or more of the sub-options instead of the major option and thus limit the trace to only those events included in the sub-options specified. A major option, such as MONITOR, and all of its sub-options (in this case MONITOR0, MONITOR1, and MONITOR2 through MONITORF) is referred to as an option group. In alphabetical order the values for the OPTIONS parameter are:
CONTROL
Traces unusual events and events related to the establishment, modification, or termination of the control structure needed for processing such as:
  • Dynamic RNL changes
  • Error events
  • XCF services used when setting up for processing
When you specify CONTROL, all of the following sub-options are traced.
CONTROL0
Traces dynamic RNL changes only.
CONTROL1
Traces events related to the establishment of or termination of membership in the global resource serialization group connection to the global resource serialization coupling facility structures.
CONTROL2
Traces global resource serialization recovery processing only.
CONTROL3
Traces global resource serialization resource manager events for abnormal task and ASID termination only.
CONTROL4-CONTROLE
Reserved for IBM® use.
CONTROLF
Traces all other unusual events not included in sub-options CONTROL0 through CONTROL3.
FLOW
Traces the flow of control from one entry point to another.
FLOW0
Traces GRS Star system server processing only.
FLOW1
Traces GQSCAN processing only.
FLOW2
Traces cross-system communications processing only.
FLOW3
Traces command processing only.
FLOW4
Traces storage manager services only.
FLOW5
Traces coupling facility processing only.
FLOW6
Traces initialization processing only.
FLOW7
Traces contention monitor processing only.
FLOW8
Traces general ENQ/DEQ processing only.
FLOW9
Traces entry to GQSCAN/ISGQUERY only.
FLOWA
Traces GRS Latch Manager processing only.
FLOWB-FLOWD
Reserved for IBM use.
FLOWE
Activates extended tracing for the GRS Storage Manager. Do not turn on this option without direction from IBM Service.
FLOWF
Reserved for IBM use.
Monitor
Traces events for selected global resource serialization invocations of monitoring and communication services provided by other components.
MONITOR0
Traces use of XES services.
MONITOR1
Traces use of XCF services.
MONITOR2-MONITORF
Reserved for IBM use.
REQUEST
Traces events for global ENQ, DEQ, GQSCAN, and RESERVE macro requests, and GRS command processing.
REQUEST0
Traces ENQ/RESERVE requests only.
REQUEST1
Traces DEQ requests only.
REQUEST2
Traces GQSCAN only.
REQUEST3
Traces IXLLOCK only.
REQUEST4
Traces command processing only.
REQUEST5
Traces lock structure (ISGLOCK) rebuild processing only.
REQUEST6-REQUESTF
Reserved for IBM use.
RSA
Traces events for RSA control information.
SIGNAL
Traces events for selected global resource serialization invocations of cross-system coupling facility (XCF) signalling service processing.
SIGNAL0
Traces migration signals only.
SIGNAL1
Traces GQSCAN signals only.
SIGNAL2
Traces ENQ/DEQ signals, including RNL change signals only.
SIGNAL3
Traces contention monitor signals only.
SIGNAL4-SIGNALF
Reserved for IBM use.