Formatting dump data using the IPCS subcommand - COUPLE

Format the SVC or stand-alone dump with the IPCS COUPLE subcommand to produce diagnostic reports about XCF and its related subcomponents. z/OS MVS IPCS Commands gives the syntax of the COUPLE subcommand and z/OS MVS IPCS User's Guide explains how to use the COUPLE option of the IPCS dialog.

The dump might also contain component trace data for XCF. For information about how to format this trace data, see component trace in z/OS MVS Diagnosis: Tools and Service Aids .

COUPLE divides the information about XCF into several reports. Each report corresponds to the COUPLE keywords listed in Table 1.

Table 1. COUPLE keywords and corresponding reports
Keyword	Report Displays	See topic
ARM	Information about elements and restart groups registered with the automatic restart manager.	COUPLE ARM DETAIL report
CFRM	Information about coupling facility resource management.	COUPLE CFRM SUMMARY report
GROUP	Information about the XCF groups and members defined to the sysplex, events pending delivery to group exits, and group or member requests queued for processing.	COUPLE GROUP DETAIL report
SERIAL	Information about serialization on shared resources in the sysplex.	COUPLE SERIAL DETAIL report
SIGNAL	Information about the XCF signalling services, signalling paths defined in the sysplex, and active signalling requests.	COUPLE SIGNAL DETAIL report
STORAGE	Information about XCF dataspace usage and storage allocation.	None
SYSPLEX	Information about status and monitoring for systems and members in the sysplex.	COUPLE SYSPLEX DETAIL report
XCFSTACK	Information about cross-system coupling facility services. This report contains diagnostic information for IBM® service personnel.	None

All IPCS COUPLE reports begin by presenting data that is potentially applicable to all the keywords specified. The following output shows an example of the common information in the header.

  * * *  COUPLE (CROSS-SYSTEM COUPLING FACILITY) REPORT * * *

               Report(s):           ARM

               Level(s) of detail:  DETAIL

               Filter(s) in use:    NONE

 Address space ID: X'0006'

 Data spaces owned: IXCDSMEM, IXCDSCBD, IXCDSCBE, IXCARDCB,
                    IXCARDIO, IXCDSTKA, IXCDSTKB, IXCDSTKC,
                    IXCDSTKD, IXCDSTKE, IXCDSTKF, IXCDSSGA,
                    IXCDSMUS, IXCDSLK1, IXCDSLO1, IXCAP1DS,
                    IXLCTCAD, IXLCBCAD, IXCDSMEX

 Sysplex name: UTCPLXJ8

 System name: JB0


  CTN ID:  zpet-stp-01  Clock Status: Active   Timing Mode: ETR

 Optional function status:
   Function Name                   Status      Default
   DUPLEXCF16                      ENABLED     DISABLED
   SYSSTATDETECT                   ENABLED     ENABLED
   USERINTERVAL                    ENABLED     DISABLED
   CRITICALPAGING                  DISABLED    DISABLED
   DUPLEXCFDIAG                    ENABLED     DISABLED
   CFLCRMGMT                       DISABLED    DISABLED
   COUPLINGTHININT                 ENABLED     ENABLED
   CFSTRQMON                       ENABLED     DISABLED
   
      COUPLE DATA SET INFORMATION
      ----------------------------

 Type:  SYSPLEX (IXCLKMD)

     Primary Data Set:  SYS1.CDS00
        Volume Serial:  CDSCDP
               DDName:  SYS00001
        Device Number:  3D30
          Format Time:  09/26/2007 15:22:23.722341
                        (C141BB4650F65081)

      Additional Information
      ----------------------
      ALL TYPES OF COUPLE DATA SETS ARE SUPPORTED
      GRS STAR MODE IS SUPPORTED

 XCF currently has no active I/O for this data set.
 Permanent error processing is inactive for this data set.
 The data set is fully functional.

   Alternate Data Set:  SYS1.CDS01
        Volume Serial:  CDSCDA
               DDName:  SYS00008
        Device Number:  5C38
          Format Time:  09/26/2007 15:25:05.394441
                        (C141BBE07FB09F01)

      Additional Information
      ----------------------
      ALL TYPES OF COUPLE DATA SETS ARE SUPPORTED
      GRS STAR MODE IS SUPPORTED

 XCF currently has no active I/O for this data set.
 Permanent error processing is inactive for this data set.
 The data set is fully functional.

 Type:  CFRM (IXCLOFD)

 . . . (remaining couple data sets)


 Maximum number of systems allowed in the sysplex:          16

 Maximum number of groups allowed in the sysplex:          200

 Maximum number of members for each group:               2,047