Previous Topic: 5.3.22.3 VMXSCX Usage Considerations

Next Topic: 5.4 LNX Information Area Files

5.3.22.4 VMXSCX Data Retrieval Examples


List a history of SET SRM changes for all systems in the
unit.

  PROC PRINT DATA=&VMXX..VMXSCX01 SPLIT = '*';
    BY SYSID;
    VAR ENDTS SCXTSLIC SCXTSHOT SCXBIASI SCXBIASD SCXLDGCP
        SCXP1LDG SCXP2LDG SCXP3LDG SCXP1WSS SCXP2WSS SCXP3WSS
        ;
    LABEL ENDTS = '*       Time*-------------------'
          SCXTSLIC = '   Minor*Time Slice*----------'
          SCXTSHOT  = '  Hotshot*Time Slice*----------'
          SCXBIASI = ' IABIAS*Intensity*---------'
          SCXBIASD = ' IABIAS*Duration*--------'
          SCXLDGCP = ' Loading*Capacity*--------'
          SCXP1LDG = ' LDUBUF* Q1-Q3*--------'
          SCXP2LDG = ' LDUBUF* Q2-Q3*--------'
          SCXP3LDG = ' LDUBUF*   Q3*--------'
          SCXP1WSS = 'STORBUF* E1-E3*--------'
          SCXP2WSS = 'STORBUF* E2-E3*--------'
          SCXP3WSS = 'STORBUF*   E3*--------';
    TITLE "History of SET SRM Changes";
  RUN;


MICS--FI--5.3.23 VMX Channel Path Measurement File (VMXCPM)


 The VM Channel Path Measurement (VMXCPM) file quantifies
 utilization data and measurement characteristic data for all
 valid channel paths in the channel subsystem. 

 This file is created from z/VM Monitor Data, domain 0, record
 18 or record 20 when the Channel-Path Measurement Facility
 (CPMF) with extended measurements is installed.
 
The following sections describe the file's organization, list
the data elements maintained, and provide usage hints.

   1 - File Organization
   2 - Data Elements List
   3 - Usage Considerations
   4 - Retrieval Examples

MICS--FI--5.3.23.1 VMXCPM File Organization


The table below identifies data elements by which the file is
sequenced and summarized in each timespan.  N/A indicates
that the file is not supported in a timespan.  At the DETAIL
level, data is sequenced but not summarized.
 
NOTE:  The timespans in which a file is supported are
defined by each installation when CA MICS is installed.
Therefore, this table has been generated as part of the
installation process to accurately reflect the CA MICS system
at your installation.

  
 +---------+-------------------------------------------------+
 |Timespan | Level of Data Granularity                       |
 +---------+-------------------------------------------------+
 |         |                                                 |
 |  DETAIL |SYSID     CHANNEL   VMXCSSID  YEAR      MONTH    |
 |         |DAY       HOUR      ENDTS                        |
 |         |                                                 |
 |  DAYS   |SYSID     CHANNEL   VMXCSSID  YEAR      MONTH    |
 |         |DAY       HOUR                                   |
 |         |                                                 |
 |  WEEKS  |  N/A                                            |
 |         |                                                 |
 |  MONTHS |SYSID     CHANNEL   VMXCSSID  YEAR      MONTH    |
 |         |ZONE                                             |
 |         |                                                 |
 |  YEARS  |  N/A                                            |
 |         |                                                 |
 +---------+-------------------------------------------------+
 |  TABLES |  N/A                                            |
 +---------+-------------------------------------------------+
                         Generation Date:  Mon, Feb 28, 2011
  
  
 NOTE:  This file was generated with ESSENTIAL=ALL
        option in effect.  All data elements defined in
        the file are generated.
 NOTE:  This file was generated with DERIVED=DEFault
        option in effect.  Whether data elements are
        kept on the file on auxiliary storage or not
        is controlled by the complex definition of the
        DERIVED option.


 Figure 5-42.  VMXCPM Sort Sequence and Data Granularity

MICS--FI--5.3.23.2 VMXCPM Elements List


The table below identifies data elements contained in this
file.  The entries for each data element are:
 
TIMESPAN:  Defines the timespans in which the data element
           is supported.  The timespans are indicated by
           the letters "XDWMYT" as follows:
 
                  X - DETAIL
                  D - DAYS
                  W - WEEKS
                  M - MONTHS
                  Y - YEARS
                  T - TABLES AREA
                  . - File is not supported
 
 The timespan field also indicates Essential Elements with
 the letter E, if applicable.
 
 DATA ELEMENT:  The data element name.
 
 DATA ELEMENT DESCRIPTION:  The data element's long name.
 
 The timespans in which a data element is supported are
 defined by each installation when CA MICS is installed.
 Therefore, this table has been generated as part of the
 installation process to accurately reflect the CA MICS
 system at your installation.

 Note:  Essential data elements are identified by an "E"
        under the Timespan asterisk (*) column.
  
   Time-    Data      Data Element
   Span *  Element    Description (LABEL)
  -------  --------   ----------------------------------------
  
  
 Sequence/Summary Data Elements
  
  XD.M..E  CHANNEL  - Physical Channel Address
  XD....E  DAY      - Day of Month
  XD....E  HOUR     - Hour of Day
  XD.M..E  MONTH    - Month of Year
  XD.M..E  SYSID    - System Identifier
  XD.M..E  VMXCSSID - Logical Channel Subsystem Identifier
  XD....E  WEEK     - Week of Year
  XD.M..E  YEAR     - Year of Century
  XD.M..E  ZONE     - Time Zone
  
 Common Data Elements
  
  XD....E  DAYNAME  - Name of Day of Week
  XD.M..E  DURATION - Recording Interval Time
  XD.M..E  ENDTS    - End Time Stamp
  XD.M..E  INTERVLS - Number of Recording Intervals
  XD.M..E  STARTTS  - Start Time Stamp
  X.....E  VMCINTTS - VM Interval Time Stamp
  XD.M..E  VMCINTVL - VM Monitor Interval Length
  XD.M..E  VMLEVEL  - VM System Release Level
  
 Retained Data Elements
  
  XD.M..E  CPMCMG   - VM Channel Measurement Group
  XD.M..E  CPMCMMQ  - VM Channel Model Group Qualifier
  X.....E  CPMCVMSK - VM Channel Measurements Chars Validity M
  XD.M..E  CPMDUS   - VM FICON Data Unit Size
  XD.M..E  CPMHPDUS - VM HiperSockets Data Unit Size - LPAR
  XD.M..E  CPMHPMUS - VM HiperSockets Message Unit Size - LPAR
  XD.M..E  CPMHTDUS - VM HiperSockets Data Unit Size - CPC
  XD.M..E  CPMHTMUS - VM HiperSockets Message Unit Size - CPC
  XD.M..E  CPMTYPE  - VM Channel Path Type
  X.....E  CPMUVMSK - VN Channel Utilization Validity Mask
  
 Accumulated Data Elements
  
  XD.M..E  CPMCBCCT - VM Total Bus Cycles Count
  XD.M..E  CPMCBSTM - VM Channel Path Busy Time
  XD.M..E  CPMCPINT - VM Channel Path Interval Time
  XD.M..E  CPMCPMF  - VM Channel Data Enabled
  XD.M..E  CPMCWUL  - VM FICON Channel Work Unit Count - LPAR
  XD.M..E  CPMCWUT  - VM FICON Channel Work Unit Count - CPC
  XD.M..E  CPMECPMF - VM Ext Channel Data Supported
  XD.M..E  CPMHDUSL - VM HiperSockets Data Units Sent - LPAR
  XD.M..E  CPMHDUST - VM HiperSockets Data Units Sent - CPC
  XD.M..E  CPMLBTTM - VM Channel Path Busy Time - LPAR
  XD.M..E  CPMLDUR  - VM FICON Read Data Unit Count - LPAR
  XD.M..E  CPMLDUW  - VM FICON Write Data Unit Count - LPAR
  XD.M..E  CPMMSGFL - VM HiperSockets Message Failures - LPAR
  XD.M..E  CPMMSNTL - VM HiperSockets Messages Sent - LPAR
  XD.M..E  CPMMSNTT - VM HiperSockets Messages Sent - CPC
  XD.M..E  CPMRECFL - VM HiperSockets Receive Failures - LPAR
  XD.M..E  CPMRECFT - VM HiperSockets Receive Failures - CPC
  XD.M..E  CPMSHRCT - VM Channel Path Shared
  XD.M..E  CPMTBTTM - VM Channel Path Busy Time - CPC
  XD.M..E  CPMTDUR  - VM FICON Read Data Unit Count - CPC
  XD.M..E  CPMTDUW  - VM FICON Write Data Unit Count - CPC
  
 Maximum Data Elements
  
  XD.M..E  CPMMXIBC - VM Max FICON Internal Bus Cycles Per Sec
  XD.M..E  CPMMXUNP - VM Max FICON Channel Work Units Per Seco
  XD.M..E  CPMMXUNR - VM Max FICON Read Data Units Per Second
  XD.M..E  CPMMXUNW - VM Max FICON Write Data Units Per Second
  
 Derived Data Elements
  
  XD.M..E  CPMHPMSZ - VM HiperSockets Avg Message Size - LPAR
  XD.M..E  CPMHTMSZ - VM HiperSockets Avg Message Size - CPC
  XD.M..E  CPMPCBSY - VM Percent Channel Busy - CPC
  XD.M..E  CPMPCBUS - VM Percent Bus Busy
  XD.M..E  CPMPCPBY - VM Percent Channel Busy - LPAR
  XD.M..E  CPMPSHPW - VM Hipersockets Write MB/Sec - LPAR
  XD.M..E  CPMPSHTW - VM Hipersockets Write MB/Sec - CPC
  XD.M..E  CPMPSPMS - VM HiperSockets Message Sent Rate - LPAR
  XD.M..E  CPMPSPR  - VM FICON Read MB/Sec - LPAR
  XD.M..E  CPMPSPUB - VM HiperSockets Receive Failed Rate - LP
  XD.M..E  CPMPSPUS - VM HiperSockets Message Failed Rate - LP
  XD.M..E  CPMPSPW  - VM FICON Write MB/Sec - LPAR
  XD.M..E  CPMPSTMS - VM HiperSockets Message Sent Rate - CPC
  XD.M..E  CPMPSTR  - VM FICON Read MB/Sec - CPC
  XD.M..E  CPMPSTUB - VM HiperSockets Receive Failed Rate - CP
  XD.M..E  CPMPSTW  - VM FICON Write MB/Sec - CPC

MICS--FI--5.3.23.3 VMXCPM Usage Considerations

 The VMXCPM File contains from one observation per valid
 channel up to a maximum of 256 per interval.
 
 The data represented in the VMXCPM represents channel
 utilization that is attributable to the logical partition in
 which VM is running as well as data for the whole CPC.

MICS--FI--5.3.23.4 VMXCPM Retrieval Examples

 
 List of all active FICON channel paths during the monitor
 interval by system.
 
 DATA FICON ;
  SET &VMXX..VMXCPM01 ;
  IF CPMCMG='FICON' ;
   PROC PRINT ;
     BY SYSID;
      VAR ENDTS CPMTYPE CPMPCPBY  CPMPCBSY CPMPCBUS
          CPMPSPR CPMPSTR CPMPSPW CPMPSTW ;
 
    LABEL CHANNEL='ID'
          CPMTYPE='*Type'
          CPMPCPBY='Util*Part'
          CPMPCBSY='Util*Total'
          CPMPCBUS='Util*Bus'
          CPMPSPR='Read*MB/Sec*Part'
          CPMPSTR='Read*MB/Sec*Total'
          CPMPSPW='Write*MB/Sec*Part'
          CPMPSTW='Write*MB/Sec*Total';
     TITLE "FICON Activity by System" ;
   RUN;