Programming Interface Information: The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM.

#### MRSYTCPC

Prolog
Control Block Contents
Cross Reference

#### MRSYTCPC Prolog

####

####

     DSECT NAME - SYTCPC
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSYTCPC
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 0 - System Domain
                        Record 9 - Physical Channel Path Contention Data
     DESCRIPTION - Channel Path Contention data, based entirely
                   on high frequency sampling, shows the number of
                   times that each channel path was busy.
     NOTES:
       - This data is high-frequency sampling data collected by
         issuing the STORE CHANNEL PATH STATUS instruction which
         tests the status (busy or not busy) of all possible channel
         paths. The rate of high-frequency sampling is determined
         (or defaulted) by the MONITOR SAMPLE RATE command.
       - When VM is running in an LPAR in Multiple Image Facility
         mode, physical channel paths may be shared with other
         partitions. This record reflects total usage of the physical
         channel paths by all partitions. Logical channel path
         utilization data for this VM partition is provided in
         MRSYTCPM (domain 0, record 18) or MRSYTEPM (domain 0, record 20)
       - The STORE CHANNEL PATH STATUS instruction is not useful
         for providing channel path utilization data for FICON
         channels. Therefore, if you are looking for information
         on channel path utilization for FICON channels, the
         information is provided in MRSYTCPM (domain 0, record 18)
         or MRSYTEPM (domain 0, record 20).
       - Starting with the z990 processor, the STORE CHANNEL PATH
         STATUS instruction used to create this monitor record
         will no longer return valid information. Please refer
         to MRSYTEPM (domain 0, record 20) for valid channel
         path utilization data.

    MRSYTCPC Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure  252  SYTCPC                 start of monitor record
      0   0  Character    0  SYTCPC_MRHDR           Record header. See MRRECHDR
                                                    for details.
      0   0  Character   20  MRHDR
      0   0  Unsigned     2  MRHDRLEN               record length in bytes
      2   2  Unsigned     2  MRHDRZER               field of zeros
      4   4  Unsigned     1  MRHDRDM                domain identifier
      5   5  Unsigned     1  *
      6   6  Unsigned     2  MRHDRRC                record identifier
      8   8  Character    8  MRHDRTOD               Time at which this record was
                                                    built. In time-of-day (TOD)
                                                    clock format. See IBM System
                                                    370 XA Principle of Operation
                                                    for explanation of format.
     16  10  Character    4  *
     20  14  Character    0  MRHDR_END              End of header
     20  14  Character  232  SYTCPC_HFSAMPLE
     20  14  Unsigned     4  SYTCPC_HFCOUNT         Number of samples taken
     24  18  Unsigned     4  SYTCPC_HFCHBUSY(0:255) Number of times the
                                                    corresponding channel path was
                                                    busy. Each index number of this
                                                    array corresponds to its
                                                    channel path number, 0 to 255.
                                                    Example: HFCHBUSY(51) = the
                                                    number of times that channel
                                                    path no. 51 was busy.
    048 418  Unsigned     4  SYTCPC_HFCHSIM(0:50)   Number of times the
                                                    corresponding number of channel
                                                    paths were simultaneously busy.
                                                    Each index number from 0 to 49
                                                    corresponds to the total number
                                                    of channel paths that were
                                                    busy. Example: HFCHSIM(23) =
                                                    the number of times that 23
                                                    channel paths were active at
                                                    one time. For index number 50,
                                                    this is the number of times
                                                    that 50 or more channel paths
                                                    were simultaneously busy.
    252 4E4  Character    0  SYTCPC_END

    MRSYTCPC Cross Reference

                          Hex           Hex
    Name                 Offset Length Value

    MRHDR                      0     20
    MRHDR_END                 14      0
    MRHDRDM                    4      1
    MRHDRLEN                   0      2
    MRHDRRC                    6      2
    MRHDRTOD                   8      8
    MRHDRZER                   2      2
    SYTCPC                     0   1252
    SYTCPC_END               4E4      0
    SYTCPC_HFCHBUSY           18   1024
    SYTCPC_HFCHSIM           418    204
    SYTCPC_HFCOUNT            14      4
    SYTCPC_HFSAMPLE           14   1232
    SYTCPC_MRHDR               0      0

    This information is
    based on z/VM V5R2.0.

    Last updated on 11 Dec 2005 at 18:48:12.

    Copyright IBM Corporation, 1990, 2005