Cross-System Coupling Facility Report

The Cross-System Coupling Facility Report shows the activity of the Cross-System Coupling Facility (XCF). The information can be presented in a summarized format for the system and individually by the member.

The Cross-System Coupling Facility Report is produced by using the XCF Analyzer control statement. The data for this report is obtained by using the XCFDATA Extractor control statement.

There are three sections to this report:

  • System Summary
  • Path Utilization Section
  • Detail Report

Related topics

XCFDATA
XCF
Analyzer-reports

The following figure shows an example of the Cross-System Coupling Facility Report (BMC.AMIOPS.SPE2110):

PRODUCED BY CMF ANALYZER (v.r.mm  RSL yymm )                CROSS-SYSTEM COUPLING FACILITY REPORT                  RPTSEQ     3 PAGE      5
BMC SOFTWARE, INC.                                            XYZ COMPANY                              REPORT DATE: DD MMM YY 17.41
 ACTL 10 JUN YY 09.00.00  10 JUN YY 12.30.00             WORLDWIDE HEADQUARTERS                         SYSTEM ID: SJSD     Z v.rr.n

 BASED ON REC TYPE/# RECS/# SAMPLES/REC HOURS:  74-2/31/57/0.46

 --------------------------------------------------------- SYSTEM SUMMARY -----------------------------------------------------------

                                                           -- BUFFER EFFICIENCY PERCENTAGES --     MESSAGES
  FROM      TO        TRANSPORT     BUFFER    REQUESTS                MSG GT   MSG LT   MSG =     MIGRATED TO    MESSAGES
 SYSTEM   SYSTEM        CLASS       LENGTH   SATISFIED     DEGRADED   BUFFER   BUFFER   BUFFER     ALT PATH      REJECTED

 SJSB     SJSD        <inbound>   <inbound>          0         0.00    0.000     0.00     0.00             0            0
 SJSC     SJSD        <inbound>   <inbound>          0         0.00    0.000     0.00     0.00             0            0
 SJSD     SJSB        DEFAULT        8,124           2         0.00    0.000     0.00   100.00             0            0
 SJSD     SJSB        DEFLARGE      20,412         181       100.00  100.000     0.00     0.00             0            0
 SJSD     SJSB        DEFMED         4,028          15         0.00    0.000     0.00   100.00             0            0
 SJSD     SJSB        DEFSMALL         956         852         0.00    0.000     0.00   100.00             0            0
 SJSD     SJSC        DEFAULT        8,124      18,413         0.00    0.000     0.00   100.00             0            0
 SJSD     SJSC        DEFLARGE      20,412       1,774        95.06   13.698    86.30     0.00             0            0
 SJSD     SJSC        DEFMED         4,028      13,180         0.00    0.000     0.00   100.00             0            0
 SJSD     SJSC        DEFSMALL         956      74,847         0.00    0.000     0.00   100.00             0            0
 SJSD     SJSD        DEFAULT        8,124           0         0.00    0.000     0.00     0.00             0            0
 SJSD     SJSD        DEFLARGE      20,412           0         0.00    0.000     0.00     0.00             0            0
 SJSD     SJSD       *DEFMED         4,028          20         0.00    0.000     0.00   100.00             0            0
 SJSD     SJSD        DEFSMALL         956       1,444         0.00    0.000     0.00   100.00             0            0
 SJSD     SJSE        DEFAULT        8,124       4,085         0.00    0.000     0.00   100.00             0            0
 SJSD     SJSE        DEFLARGE      20,412         227        95.59  100.000     0.00     0.00             0            0
 SJSD     SJSE        DEFMED         4,028         153         0.00    0.000     0.00   100.00             0            0
 SJSD     SJSE        DEFSMALL         956      32,816         0.00    0.000     0.00   100.00             0            0
 SJSD     SJSG        DEFAULT        8,124       5,350         0.00    0.000     0.00   100.00             0            0
 SJSD     SJSG        DEFLARGE      20,412         177       100.00  100.000     0.00     0.00             0            0
 SJSD     SJSG        DEFMED         4,028          14         0.00    0.000     0.00   100.00             0            0
 SJSD     SJSG        DEFSMALL         956       3,468         0.00    0.000     0.00   100.00             0            0
 SJSD     SJSH        DEFAULT        8,124           0         0.00    0.000     0.00     0.00             0            0
 SJSD     SJSH        DEFLARGE      20,412         177       100.00  100.000     0.00     0.00             0            0
 SJSD     SJSH        DEFMED         4,028          13         0.00    0.000     0.00   100.00             0            0
 SJSD     SJSH        DEFSMALL         956         712         0.00    0.000     0.00   100.00             0            0
 SJSE     SJSD        <inbound>   <inbound>          0         0.00    0.000     0.00     0.00             0            0
 SJSG     SJSD        <inbound>   <inbound>          0         0.00    0.000     0.00     0.00             0            0
 SJSH     SJSD        <inbound>   <inbound>          0         0.00    0.000     0.00     0.00             0            0

PRODUCED BY CMF ANALYZER (v.r.mm  RSL yymm )                CROSS-SYSTEM COUPLING FACILITY REPORT                   RPTSEQ     3 PAGE      6
 BMC SOFTWARE, INC.                                            XYZ COMPANY                               REPORT DATE: DD MMM YY 17.41
 ACTL 10 JUN YY 09.00.00  10 JUN YY 12.30.00             WORLDWIDE HEADQUARTERS                          SYSTEM ID: SJSD     Z v.rr.n


 BASED ON REC TYPE/# RECS/# SAMPLES/REC HOURS:  74-2/31/57/0.46

 ---------------------------------------------------- PATH UTILIZATION SECTION ------------------------------------------------------


 FROM      TO     TRANSPORT  FROM-TO DEVICE/  REQUEST     Q    XFR  -- PERFORMANCE % --  - NO BUFFER   ------- UTILIZATION --------
SYSTEM   SYSTEM     CLASS    STRUCTURE          COUNT  LNTH   TIME  REFUSE APPEND IMMED    TIME COUNT    %     TIME   COUNT REQ CNT
-------- -------- ---------  ---------------- -------  ----  -----  ------ ------ -----  ------ -----  --- -------- ------- -------
ADDM     SJSC     <INBOUND>  IXCLIST1          66,600   ---  0.178       0    ---   ---       0     0   25 1640.606  37,731  51,997
                                                                                                        50   92.178   2,786   6,224
                                                                                                        75   54.666   1,632   5,307
                                                                                                       100   41.894     627   3,072
ADDM     SJSC     <INBOUND>  IXCLIST1FOOY      66,600   ---  0.178       0    ---   ---      0      0   25 1640.606  37,731   51,997  
                                                                                                        50   92.178   2,786    6,224  
                                                                                                        75   54.666   1,632    5,307  
                                                                                                       100   41.894     627    3,072  
ADDM     SJSC     <INBOUND>  IXCLIST1FAKE      66,600   ---  0.178       0    ---   ---      0      0   25 1640.606  37,731   51,997  
                                                                                                        50   92.178   2,786    6,224  
                                                                                                        75   54.666   1,632    5,307  
                                                                                                       100   41.894     627    3,072  
ADDM     SJSC     <INBOUND>  IXCLIST1REAL      66,600   ---  0.178       0    ---   ---      0      0   25 1640.606  37,731   51,997  
                                                                                                        50   92.178   2,786    6,224  
                                                                                                        75   54.666   1,632    5,307  
                                                                                                       100   41.894     627    3,072




PRODUCED BY CMF ANALYZER (v.r.mm  RSL yymm )                CROSS-SYSTEM COUPLING FACILITY REPORT                  RPTSEQ     3 PAGE      7
 BMC SOFTWARE, INC.                                             XYZ COMPANY                              REPORT DATE: DD MMM YY 17.41
 ACTL 10 JUN YY 09.00.00  10 JUN YY 12.30.00             WORLDWIDE HEADQUARTERS                          SYSTEM ID: SJSD     Z v.rr.n


 BASED ON REC TYPE/# RECS/# SAMPLES/REC HOURS:  74-2/31/57/0.46
0
 ---------------------------------------------------------- DETAIL REPORT -----------------------------------------------------------

                                             MESSAGES RECEIVED        MESSAGES SENT
                                            -------------------    -------------------

                                                       PERCENT                PERCENT
 SYSTEM     GROUP      MEMBER                   COUNT  OF TOTAL        COUNT  OF TOTAL       MEMBER STATUS

 SJSB       ARCPLEX0   HOST#B                       0      0.00            0      0.00       ACTIVE
 SJSB       BBCMF560   SJSB#AFA000                  0      0.00            0      0.00       ACTIVE
 SJSB       BBPLEX01   SJSB                        16      1.52           51      2.57       ACTIVE
 SJSB       BBSYSB     BBSYSB$SJSB                  0      0.00            0      0.00       ACTIVE
 SJSB       BMCAB      M77816                      54      5.14           54      2.73       ACTIVE
 SJSB       BMCAB      M77817                      49      4.67           49      2.47       ACTIVE
 SJSB       BMCAB      M77818                       6      0.57            6      0.30       ACTIVE
 SJSB       COFVLFNO   SJSB                       314     29.90        1,022     51.59       ACTIVE
 SJSB       ControlO   SJSB                         0      0.00            0      0.00       ACTIVE
 SJSB       EZBTCPCS   SJSBDC$TCPIP                 0      0.00            0      0.00       ACTIVE
 SJSB       IDAVQUI0   IDAVQUI0SJSB                 0      0.00            0      0.00       ACTIVE
 SJSB       IGWXSGIS   N200812322330481             0      0.00            0      0.00       ACTIVE
 SJSB       ISTCFS01   VTAMB$$$USBMCN01             0      0.00            0      0.00       ACTIVE
 SJSB       ISTXCF     VTAMB$$$USBMCN01             0      0.00            0      0.00       ACTIVE
 SJSB       IXCLO069   M1848                        0      0.00            0      0.00       ACTIVE
 SJSB       IXCLO17F   M102                        18      1.71           14      0.71       ACTIVE
 SJSB       SYSATB01   M3496                        0      0.00            0      0.00       ACTIVE
 SJSB       SYSATB01   M3497                        0      0.00            0      0.00       ACTIVE
 SJSB       SYSDAE     SJSB                         0      0.00            0      0.00       ACTIVE
 SJSB       SYSENF     SJSB                         0      0.00            0      0.00       ACTIVE
 SJSB       SYSGRS     SJSB                         0      0.00            0      0.00       ACTIVE
 SJSB       SYSIEFTS   SJSB                         0      0.00            0      0.00       ACTIVE
 SJSB       SYSIGW00   IGWCLM01SJSB                 4      0.38            3      0.15       ACTIVE
 SJSB       SYSIGW01   IGWCLM01SJSB                 0      0.00            0      0.00       ACTIVE
 SJSB       SYSIGW02   SMLS1SJSB                    4      0.38            4      0.20       ACTIVE
 SJSB       SYSIGW03   IGWSHC00SJSB                 0      0.00            0      0.00       ACTIVE
 SJSB       SYSIKJBC   SJSB                         0      0.00            0      0.00       ACTIVE
 SJSB       SYSIOS01   SJSB                         0      0.00            0      0.00       ACTIVE
 SJSB       SYSJES     SJSB                         0      0.00            0      0.00       ACTIVE
 SJSB       SYSMCS     SJSB                       180     17.14          373     18.83       ACTIVE
 SJSB       SYSMCS2    SJSB                         0      0.00            0      0.00       ACTIVE
 SJSB       SYSTTRC    SJSB                         0      0.00            0      0.00       ACTIVE
 SJSB       SYSWLM     SJSB                       405     38.57          405     20.44       ACTIVE

  SYSTEM TOTAL                                  1,050      0.33        1,981      0.63


 SJSC       AAGROUP    CJSLC                        0      0.00            0      0.00       ACTIVE
 SJSC       AAGROUP    SJSC                         0      0.00            0      0.00       ACTIVE

System Summary section field descriptions

The table below describes each field in the System Summary section of the Cross-System Coupling Facility Report.

Field

Description

FROM SYSTEM

System from which the message originated (for internal messages this is the same as the TO SYSTEM)

TO SYSTEM

System to which the message is sent (for internal messages this is the same as the FROM SYSTEM)

TRANSPORT CLASS

Transport class name as defined to XCF

An asterisk is printed to the left of the Transport Class value if, at any time during the reporting interval, the transport class was inactive or its counts were reset by the XCF.

Important

Information not available for an inbound path is marked with <INBOUND>.

BUFFER LENGTH

Size of the message buffer

REQUESTS SATISFIED

Number of messages successfully sent where a TRANSPORT CLASS received a TO SYSTEM message that originated from its own FROM SYSTEM

BUFFER EFFICIENCY PERCENTAGES

Information under this section head is related to buffer efficiency:

  • DEGRADED—percentage of MSG GT BUFFER that suffered degradation due to overhead incurred by XCF in finding a suitably large buffer
  • MSG GT BUFFER—percentage of the messages satisfied that required a larger buffer length than defined for the Transport Class
  • MSG LT BUFFER—percentage of the messages satisfied that required less buffer length than defined for the Transport Class
  • MSG = BUFFER—percentage of the messages satisfied that required the same buffer length as defined for the Transport Class

MESSAGES MIGRATED TO ALT PATH

Number of messages migrated to an alternate path because the designated primary path was not available

MESSAGES REJECTED

Number of messages rejected due to an XCF failure to obtain sufficient buffer space

Path Utilization Section field descriptions

The table below describes each field in the Path Utilization Section of the Cross-System Coupling Facility Report (BMC.AMIOPS.SPE2110):

Field

Description

FROM SYSTEM

System from which the message originated (for internal messages this is the same as the TO SYSTEM)

TO SYSTEM

System to which the message is sent (for internal messages this is the same as the FROM SYSTEM)

TRANSPORT CLASS

Transport class name as defined to XCF

Information not available for an inbound path is marked with <INBOUND> in that column for all inbound paths.

FROM-TO DEVICE/STRUCTURE

Address of the CTC devices from which and to which messages are sent along this path, or the name of the coupling facility structure used to send messages

REQUEST COUNT

Number of messages successfully sent on this path

Q LNTH

Average number of messages that had to wait to be sent along this path for outbound paths

XFR TIME

Average I/O time, in milliseconds, for the most recently received signals (within the last 35 minutes) on inbound paths

PERFORMANCE %

Information under this section is related to XCF message sending performance:

  • REFUSE—percentage of all message requests that were refused because the maximum message limit had been reached (inbound only)
  • APPEND—percentage of all message requests that were appended to a message or messages already in the process of being sent over the path (outbound only)
  • IMMED—percentage of all message requests that were sent over a path that was suspended (not busy) at the inception of the path request (outbound only)

NO BUFFER

No-buffer condition for an inbound path that impeded a signal transfer:

  • TIME—total time in milliseconds the path had the no-buffer condition
  • COUNT—number of times the path had the no-buffer condition

Important

These fields are available for SMF records produced on Version 2.4 z/OS systems or later. If the records were produced on an earlier version of the z/OS system, no data is displayed.

UTILIZATION

Path utilization

Inbound signals are read in buckets of up-to four signals. If 1/2/3/4 signals are read, the path is considered at 25/50/75/100% utilization.

  • %—utilization percentage
  • TIME—total time in milliseconds of all time windows that the path was at this utilization %
  • COUNT—number of time windows the path was found at this utilization %
  • REQ CNT—count of signals received at this utilization

Important

These fields are available for SMF records produced on Version 2.4 z/OS systems or later. If the records were produced on an earlier version of the z/OS system, no data is displayed.

Detail Report section field descriptions

The table below describes each field in the Detail Report section of the Cross-System Coupling Facility Report.

Field

Description

SYSTEM

System on which this path, group, and member is defined

GROUP

Group to which the member is assigned

MEMBER

Member name

MESSAGES RECEIVED

Information under this section header is related to the number of XCF messages that were received by members:

  • COUNT—number of messages received for this member
  • PERCENT OF TOTAL—percentage of all messages received that were for this member

MESSAGES SENT

Information under this section header is related to the number of XCF messages that were sent for members:

  • COUNT—number of messages sent for this member
  • PERCENT OF TOTAL—percentage of all messages sent that were for this member

MEMBER STATUS

Status of the member during the recording interval

Members can be Active, Partially Activated, Re-activated, or De-activated.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*