XCF DISPLAY Command: View XCF Attributes

Commands › XCF DISPLAY Command: View XCF Attributes

XCF DISPLAY Command: View XCF Attributes

To view the system attributes of your XCF group, use the XCF DISPLAY command.

Type: XCF command

Entering Commands

You can issue all XCF commands using the following methods:

Line mode
z/OS MODIFY command

This command has the following format:

XCF {DISPLAY|D} {ACTIVE|A}
                {GROUP|G}
                {SERVICE|S}
                {SYSTEM|SYS}
                {TRACE|TR}
                {MC|M}

ACTIVE: Displays the active XCF service listener on the master and the connection.
GROUP: Displays the status of your XCF group and its members.
SERVICE: Displays the status of the XCF services in the group.
SYSTEM: Displays all systems in the sysplex.
TRACE: Displays the status of the trace log.
MC: Displays two additional fields, MC (must-complete count) and HMK (must-complete high mark), in the response for the XCF connections.

Example: Issue the DISPLAY ACTIVE Command

The following example shows the results of the DISPLAY ACTIVE command when entered from a master. The example uses the short form of the DISPLAY ACTIVE command.

XCF D A

Group=QS10, Member=QS10M
Partner          Service  Status  Connection
Listener         DSTRIG   Active
Listener         ROUTING  Active
Listener         TRACKING Active
QS10S            DSTRIG   Active  1,49
QS10S            ROUTING  Active  3,50
QS10S            TRACKING Active  7,52
QS10S2           DSTRIG   Active  2,48
QS10S2           ROUTING  Active  4,49
QS10S2           TRACKING Active  8,51

The following example shows the results of the DISPLAY ACTIVE command when entered from a proxy. The example uses the short form of the DISPLAY ACTIVE command.

XCF D A

Group=QS10, Member=QS10S
Partner          Service  Status  Connection
QS10M3           DSTRIG   Active  49,1
QS10M3           ROUTING  Active  50,3
QS10M3           TRACKING Active  52,7

Example: Issue the DISPLAY GROUP Command

The following example shows the results of the DISPLAY GROUP command when entered from a master. The example uses the short form of the DISPLAY GROUP command.

XCF D G

Group=QS10 Member=QS10M3 Interval=60 TermOpt=Quiesce
Group Member System ASID Jobname  SSID ESP    Status
QS10  QS10M1  SYSC  0056 QS10     QS10 Master  Active
QS10  QS10M3  SYSA  009B QS10SHAD QS10 Shadow  Active
QS10  QS10M5  SYSC  0041 QS10SMC  QS10 Shadow  Active
QS10  QS10S   SYSA  009F QS10S    QS1S Proxy   Active
QS10  QS10S2  SYSC  0046 QS10S2   QS12 Proxy   Active

The following example shows the results of the DISPLAY GROUP command when entered from a proxy. The example uses the short form of the DISPLAY GROUP command.

XCF D G

Group=QS10 Member=QS10S Interval=45 TermOpt=Quiesce
Group Member System ASID Jobname  SSID ESP    Status
QS10  QS10M1  SYSC  0056 QS10     QS10 Master  Active
QS10  QS10M3  SYSA  009B QS10SHAD QS10 Shadow  Active
QS10  QS10M5  SYSC  0041 QS10SMC  QS10 Shadow  Active
QS10  QS10S   SYSA  009F QS10S    QS1S Proxy   Active
QS10  QS10S2  SYSC  0046 QS10S2   QS12 Proxy   Active

Example: Issue the DISPLAY SERVICE Command

The following example shows the results of the DISPLAY SERVICE command when entered from a master. The example uses the short form of the DISPLAY SERVICE command.

XCF D S

Service   Status   Group    Member     Susp
DSTRIG    Active   QS10     QS10M      120
ROUTING   Active   QS10     QS10M      120
TRACKING  Active   QS10     QS10M      120

The following example shows the results of the DISPLAY SERVICE command when entered from a proxy. The example uses the short form of the DISPLAY SERVICE command.

XCF D S

Service   Status   Group    Member   Susp
DSTRIG    Active   QS10     QS10S     120
ROUTING   Active   QS10     QS10S     100
TRACKING  Active   QS10     QS10S     100

Example: Issue the DISPLAY SYSTEM Command

The following example shows the results of the DISPLAY SYSTEM command. The example uses the short form of the DISPLAY SYSTEM command.

XCF D SYS

Sysplex=SYSAPLEX, System=SYSA
System   Status      Interval
SYSA     Active           85
SYSC     Active           85

Example: Issue the DISPLAY TRACE Command

The following example shows how to issue the short form of the DISPLAY TRACE command.

XCF D TR

Example: Display the Must-Complete Count

The following example shows the must-complete count (MC) column and the must-complete high mark (HMK) column in the response for the XCF connections.

 XCF D A M

 Group=ESP, Member=ESPMCAxx
 Partner          Service  Status  Connection  MC HMK
 Listener         DSTRIG   Active  1
 Listener         ROUTING  Active  2
 Listener         TRACKING Active  4
 ESPPCAxx         DSTRIG   Active  5,1          0   0
 ESPPCAxx         ROUTING  Active  6,2          0   0
 ESPPCAxx         TRACKING Active  8,4          0   1

XCF SET TRACE Command: Specify XCF Trace Parameters

The XCF SET TRACE command specifies the parameters for the XCF trace facility. XCF tracing is normally used at the request of CA Support to diagnose an XCF problem. XCF SET TRACE can be coded in the initialization parameter data set or entered on the fly when the trace data is required. We recommend you put XCF SET TRACE in your initialization parameter data set.

Type: XCF command

Note: You can issue all XCF commands using the following methods:

Line mode
z/OS MODIFY command

This command has the following format:

XCF {SET|T} {TRACE|TR} {SYSOUT|S}(class)
                       [{MEMBER|ME}(member)|{ALLMEMBERS|ALLM}]
                       [{SERVICE|SE}(service)|{ALLSERVICES|ALLS}]
                       [{REQUESTS|R}|{NOREQUESTS|NOR}]
                       [{MSGEVENTS|MS}|{NOMSGEVENTS|NOM}]
                       [{GRPEVENTS|G}|{NOGRPEVENTS|NOG}]
                       [{SYSEVENTS|SYSE}|{NOSYSEVENTS|NOS}]
                       [{DATA|D}|{NODATA|NOD}}]
                       [{MCTHRESHOLD|MC}(threshold)]

SYSOUT(class): Indicates an output class for sysout.
MEMBER(member): Requests tracing for the specified XCF group member only.
ALLMEMBERS: Requests tracing for all XCF group members.
SERVICE(service): Requests tracing for the specified XCF service only. The only valid XCF services are: TRACKING, DSTRIG, and ROUTING. The ROUTING service is only valid when the following are enabled: CA WA High Availability ESP Edition or CA WA Service Governor ESP Edition.
ALLSERVICES: Requests tracing for all XCF services.
REQUESTS: Requests tracing of all XCF API calls (IXCJOIN, IXCLEAVE, IXCMSGI, IXCMSGO, IXCQUERY, IXCSETUS etc.) when the XCF TRACE DATA option is active. Also requests tracing of all XCF API calls except for data transfers (IXCMSGO Send, IXCMSGO Send Response, and IXCMSGI) when the XCF TRACE DATA option is not active.
NOREQUESTS: Requests no XCF tracing of "IXCMSGO Send", "IXCMSGO Send Response", and "IXCMSGI" XCF API calls.
MSGEVENTS: Requests tracing of XCF message events, provided the XCF SET TRACE DATA options is active.
NOMSGEVENTS: Requests no tracing of XCF message events.
GRPEVENTS: Requests tracing of XCF group events.
NOGRPEVENTS: Requests no tracing of XCF group events.
SYSEVENTS: Requests tracing of XCF system events.
NOSYSEVENTS: Requests no tracing of XCF system events.
DATA: Requests tracing of "IXCMSGO Send", "IXCMSGO Send Response", and "IXCMSGI" XCF API calls, provided the XCF SET TRACE "REQUESTS" options is active. Also requests tracing of XCF message events, provided the XCF SET TRACE "MSGEVENTS" option is active.
NODATA: Requests no tracing of the following XCF API calls: "IXCMSGO Send", "IXCMSGO Send Response", and "IXCMSGI". Also requests no tracing of XCF message events.
MCTHRESHOLD(threshold): Requests XCF tracing of must-complete XCF Sends and XCF Receives that result in an XCF connection must-complete count being incremented to the specified threshold value or higher. Also requests XCF tracing of must-complete XCF Send responses and XCF Receive responses that result in the XCF connection must-complete count being decremented from the specified.

Example: Set trace data

The following example shows the short form of the SET TRACE command to set trace data to a sysout class of X:

XCF T TR S(X)

XCF START TRACE Command: Initialize/Activate Trace Files

The XCF START TRACE command initializes and activates the XCF trace file. You can code the XCF START TRACE initialization parameter after the XCF SET TRACE initialization parameter in the initialization parameter data set. Otherwise, the XCF START TRACE command is entered on the fly when you must capture data.

Type

XCF command

Entering commands

You can issue all XCF commands using the following methods:

Line mode
z/OS MODIFY command

This command has the following format:

XCF {START|S} {TRACE|TR}

TRACE: Indicates the XCF Trace facility.

Example: Short form of the START TRACE command

The following example shows the short form of the START TRACE command:

XCF S TR

XCF STOP TRACE Command: Stop Trace File

The XCF STOP TRACE command stops the trace file after data has been captured and spools the captured data to the preset sysout class specified by the XCF SET TRACE command.

Type

XCF command

Entering commands

You can issue all XCF commands using the following methods:

Line mode
z/OS MODIFY command

This command has the following format:

XCF {STOP|P} {TRACE|TR}

TRACE: Indicates the XCF Trace facility.

Example: Short form of the STOP TRACE command

The following example shows the short form of the XCF STOP TRACE command:

XCF P TR