Coupling Facilities

The Coupling Facilities screen displays data from the defined coupling facilities.


  Jobname: [JOBNAME]            Coupling Facilities             Date: MM/DD/YY  
  SYSID  : [SYSTEMID]                                           Time: HH:MM:SS  
  COMMAND:                                                      CYCLE: MMSS     
     SRM STATS:  CPU=  7.06  UIC=65535  TPR=   0  SIO= 371.6           _HIST    
  Start: YYYY/MM/DD-HH:MM:SS   Duration:    11.56   Type: Delta                 
  Systems:  2 of  4   Mode: Sysplex     System: SYS4                            
  LINES: 1 TO 2 OF 2             FA=Y   SORT COL: 01 SEQ: A               >  1  
                           SubCh    SubCh    SubCh         Avail   Avail        
  CF          Pct   Str  Request  Request  Delayed   Str     Stg     Stg        
  Name       Busy Exec%    Count     Rate      Pct    Ct  Size M     Pct        
  *        *      *     *        *        *        *     *       *              
  CF03       0.99  1.70   14,990 1,296.71     0.00   187   1,010   13.78        
  CF04       0.50  0.86    5,996   518.67     0.00   109   3,229   44.07        
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
   Help Information = PF1                            PF Key Assignments = PA1   

See GRF Screens for information on data filtering and sorting capabilities of this screen.

Note: This screen displays real-time data (if you accessed it through the Activity Monitor Menu (=1) or Quick Access Menus (=Q)) or history data (if you accessed it through the Collection Analysis menu (=4)). The Type field indicates which type of data (CUM or DELTA for real-time or History for history) is being displayed.

The screens displayed for both real-time and history data are identical in look and navigational flow. However, if history data is being displayed, History is displayed as a subtitle along with the start date and time of the current time interval found in the LFS file.

You can cursor-select several fields to display additional information about a coupling facility.

Use the LEFT and RIGHT commands or cursor-select the left and right scroll arrows (< and >) to access all the information displayed on this screen.

Accessing this Screen

To access this screen, complete one of these actions:

Primary Commands

Product-specific commands.
Enter these commands on the command line:

Command

Description

HISTORY

Switch to History mode. Displays the Coupling Facilities History screen. Data will be displayed for the most recent data collection interval stored on the TMON for z/OS LFS files. When you are done viewing the history data, either enter the END command or press PF3 to return to delta or cumulative mode.

Note: You can access the history data only when viewing data from a local system. History data is not displayed when viewing data from a remote system.

You also can cursor-select the HIST field or enter H in the Type field to perform this function.

GRF commands.

Enter GRFCMDS on the command line for a list of the GRF Commands that you can issue on this screen.

For syntax and descriptions of all commands, see TMON Commands.

Fields

The < > n, (filter area), FA=, LINES: nnnnn TO nnnnn OF nnnnn, SEQ, and SORT COL fields are GRF fields and are described in GRF Screens.

Field

Description

Aug Stg Pct

Displays the percentage of coupling facility space used as augmented space.

Aug Stg Size M

Displays the amount of coupling facility space used as augmented space, in megabytes.

Avail Stg Pct

Displays the percentage of free space available in the coupling facility.

Avail Stg Size M

Displays the amount of free space available in the coupling facility, in megabytes.

CF Lvl

Displays the function level of the coupling facility.

CF Name

Displays the name of the coupling facility.

Cursor-select this field to display the Coupling Facility Detail screen.

Control Stg Alloc %

Displays the percentage of coupling facility control space in use.

Control Stg Size M

Displays the amount of coupling facility control space, in megabytes.

Data Stg Alloc %

Displays the percentage of coupling facility data space in use.

Data Stg Size M

Displays the amount of coupling facility data space, in megabytes.

Dump In Use Pct

Displays the percentage of dump storage space in use.

Dump Max % Req

Displays the percentage of the maximum dump storage space requested in a single dump request.

Dump Stg Pct

Displays the percentage of coupling facility space available for dump space.

Dump Stg Size M

Displays the amount of coupling facility space available for dump space, in megabytes.

Duration

Displays the duration of the measurement interval, in MM:SS.hh format.

Dyn Disp

Indicates dynamic CF dispatching status for the coupling facility. Valid values are Yes, No, and CTI. CTI indicates that the coupling thin interrupts are enabled for the coupling facility.

HIST

Cursor-select this field to display the Coupling Facilities History screen, which shows historical coupling facility information. Data will be displayed for the most recent data collection interval stored on the TMON for z/OS LFS files. When you are done viewing the history data, either enter the END command or press PF3 to return to delta or cumulative mode.
Note: You can access the history data only when viewing data from a local system. History data is not displayed when viewing data from a remote system.

You also can use the HISTORY command or enter H in the Type field to perform this function.

LP Def

Displays the number of processors defined for the coupling facility.

LP Eff

Displays the effective number of processors in the coupling facility.

LP Shr

Displays the number of shared processors in the coupling facility.

LP Wgt

Displays the average processor weight.

Mode

Displays the execution mode for the Sysplex XCF Monitor.

  • Local indicates local mode.
  • Sysplex indicates sysplex mode.

Pct Busy

Displays the total processor utilization rate.

Cursor-select this field to display the Coupling Facility Detail screen.

Proc Mdl

Displays the coupling facility model.

Proc Type

Displays the coupling facility node type.

SCM In Use Pct

Displays the percentage of storage-class memory (SCM) that is in use by all structures in the coupling facility.

SCM Stg Size M

Displays the total amount of storage-class memory (SCM), in megabytes. This value is the amount of SCM that can be used for structure extensions.

Start

Displays the start date and time of the measurement interval, in YYYY/MM/DD-HH:MM:SS format.

If you are viewing history data, you can overtype this value to view data from a different measurement interval.

Str Ct

Shows the number of structures in the coupling facility.

Cursor-select this field to display the CF Structure Activity screen.

Str Exec%

Displays the percentage of total processor time used by structures.

Str Stg Pct

Displays the percentage of coupling facility space used by structures.

Str Stg Size M

Displays the amount of coupling facility space used by structures, in megabytes.

SubCh Delayed Pct

Displays the percentage of total requests that were delayed.

Cursor-select this field to display the CF System Subchannel Activity screen.

SubCh Request Count

Displays the total number of subchannel requests.

Cursor-select this field to display the CF System Subchannel Activity screen.

SubCh Request Rate

Displays the rate of total subchannel requests.

System

Displays the system ID where the Sysplex XCF Monitor server is executing when the Sysplex XCF monitor is executing in sysplex mode.

Displays the ID of the system from which the data originated when the Sysplex XCF Monitor is executing in local mode. You can overtype the ID to view a remote system in the same XCFGROUP.

Systems

Displays the total number of systems with TMON for z/OS active (x) out of the total number of active systems in the sysplex (y), in x of y format.

Cursor-select this field to display the XCFM Systems Display screen.

Total Max SCM M

Displays the sum of the storage-class memory (SCM) maximum values defined for all structures in the coupling facility, in megabytes.

Total Stg Size M

Displays the total amount of coupling facility space, in megabytes. This value is the sum of free space, dump space, and structure space.

Type

Indicates the type of data displayed on the screen:

  • CUM—indicates real-time data in cumulative mode. The interval duration increases each time the screen is refreshed.

    If you are in cumulative mode, you can enter either D in this field to change to delta mode or H to change to history mode.

  • DELTA—indicates real-time data in delta mode. A new interval is started each time the screen is refreshed.

    If you are in delta mode, you can enter either C in this field to change to cumulative mode or H to change to history mode.

  • History—indicates history data. History mode can only be entered when viewing data from the local system. History mode is not supported when viewing data from a remote system.

    If you switched from delta or cumulative mode to history mode, either enter the END command or press PF3 to return to delta or cumulative mode.