COUPLE subcommand — analyze cross-system coupling data

Use the COUPLE subcommand to generate reports about the cross-system coupling facility (XCF). This subcommand provides information about the following:

Groups and members in the sysplex
Sysplex couple datasets
XCF signaling service
XCF storage use
Status of systems in the sysplex
XCF internal diagnostic information
Coupling Facility Resource Management (CFRM)
Automatic restart management

The COUPLE subcommand does not process active storage.

The reports generated by the COUPLE subcommand contain information for IBM® diagnostic use. IBM might ask you to report this information for use in problem determination.

See the XCF component in z/OS MVS Diagnosis: Reference for COUPLE output.

Syntax

  COUPLE

--------- Report Type Parameters ---------------------------

             [ GROUP ]
             [ SERIAL ]
             [ SIGNAL ]
             [ STORAGE ]
             [ SYSPLEX ]
             [ XCFSTACK ]
             [ CFRM ]
             [ ARM ]

--------- Data Selection Parameters ------------------------

             [ DETAIL ]
             [ EXCEPTION ]
             [ SUMMARY ]

--------- Address Space Selection Parameters ---------------

             [ ASID(asidlist)  ]
             [ JOBNAME(joblist) ]

--------- Additional Filter Parameters ---------------------

             [ CFNAME(cfname) ]
             [ STRNAME(strname) ]
             [ SYSNAME(sysname) ]
             [ GRPNAME(grpname) ]
             [ DEVICE(device) ]
             [ TYPE(type) ]
             [ ELEMENT(element) ]
             [ RSTGROUP(rstgroup) ]

-------- SETDEF-Defined Parameters -------------------------
Note: You can override the following SETDEF parameters.
See SETDEF subcommand — set defaults.

              [ ACTIVE | MAIN | STORAGE          ]
              [ DSNAME(dsname) | DATASET(dsname) ]
              [ FILE(ddname) | DDNAME(ddname)    ]
              [ PATH(path-name)     ]
              [ FLAG(severity) ]
              [ PRINT | NOPRINT ]
              [ TERMINAL | NOTERMINAL ]
              [ TEST | NOTEST ]

Report type parameters
Use these parameters to select the type of report. You may specify more than one; COUPLE produces a report for each specified parameter. If you omit these parameters, the default is to present a report for all parameters listed below.
GROUP

Requests information about the groups in the sysplex and the status of members within each group.

SERIAL

Requests information about the XCF couple data sets.

SIGNAL

Requests information about XCF signaling services. This report includes information about signaling paths, transport classes, message buffers, list structures, and devices in use.

STORAGE

Requests information about XCF storage use.

SYSPLEX

Requests information about the status of each system in the sysplex. This includes sysplex failure management (SFM) information.

XCFSTACK

Requests internal diagnostic information. This information may be requested by the IBM Support Center.

CFRM

Requests information about coupling facility resource management.

ARM

Requests information about elements and restart groups for the system where the dump was taken.
Data selection parameters
Data selection parameters limit the scope of the data in the report. The default is to present a summary report.
SUMMARY

Requests summary information for each of the requested topics.

EXCEPTION

Requests a list of exceptional or unusual conditions for each topic. The list of exceptions contains information for IBM diagnostic use.

DETAIL

Requests a report showing detailed information for each of the selected topics.
Address Space Selection Parameters
Use these parameters to obtain data from particular address spaces, which you specify by their address space identifiers (ASIDs).
ASID(asidlist)

Specifies the ASID for the address space to be included in the report. The asidlist can be a single ASID, a range of ASIDs, or a list of noncontiguous ASIDs. When you specify a range, separate the first and last ASIDs in the range with a colon. When you specify a list, separate the list members with commas. The ASID can be 1 through 65535. An ASID can be expressed in the notation X'nnn' or decimal, nnn.

JOBNAME(joblist)

Specifies a list of job names whose associated address spaces are to be included in the report. Use commands to separate the job names in the list; do not enclose job names in apostrophes; and do not specify a range of job names. You may use an asterisk (*) at the end of a job name as a generic character. That will result in a match for any value that begins with the characters preceding the asterisk.
Additional filter parameters
Use these parameters to select the information for the report.
CFNAME(cfname)

Requests that only information about the specified coupling facility be included in the report. cfname may also be a list of coupling facilities. You may use an asterisk (*) at the end of cfname as a generic character. That will result in a match for any value that begins with the characters preceding the asterisk.

STRNAME(strname)

Requests that only information about the specified coupling facility structure be included in the report. strname may also be a list of coupling facility structures. You may use an asterisk (*) at the end of strname as a generic character. That will result in a match for any value that begins with the characters preceding the asterisk.

SYSNAME(sysname)

Requests that only information about the specified system be included in the report. sysname may also be a list of systems. You may use an asterisk (*) at the end of sysname as a generic character. That will result in a match for any value that begins with the characters preceding the asterisk.

GRPNAME(grpname)

Requests that only information about the specified group be included in the report. grpname may also be a list of groups. You may use an asterisk (*) at the end of grpname as a generic character. That will result in a match for any value that begins with the characters preceding the asterisk.

DEVICE(device)

Requests that only information about the specified device be included in the report. device may be a list or range of devices. You must specify hexadecimal values.

TYPE(type)

Requests that only information about the specified couple data set be included in the report. type may also be a list of couple data sets.

ELEMENT(element)

Requests that only information about the specified element be included in the report. element may also be a list of elements.

RSTGROUP(rstgroup)

Requests that only information about the specified restart group be included in the report. rstgroup may also be a list of restart groups.
Return codes
See Standard subcommand return codes for a description of the return codes produced by the COUPLE subcommand.