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

#### MRSYTSYG

Prolog
Control Block Contents
Cross Reference

#### MRSYTSYG Prolog

####

####

     DSECT NAME - SYTSYG
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRSYTSYG
     DESCRIPTIVE NAME -  Monitor Sample Record
                         Domain 0 - System Domain
                         Record 19- System Data (Global)
     DESCRIPTION - System wide utilization data.
     NOTE: Data in the STSI fields is produced when the necessary
           architecture is present for the STSI instruction.
           When this is not present the field values will be 0's.

    MRSYTSYG Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure  112  SYTSYG                 Start of monitor record
      0   0  Character    0  SYTSYG_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    8  SYTSYG_XCTMSACT        Accumulated elapsed time in
                                                    microseconds that routines that
                                                    comprise user exits were active
     28  1C  Unsigned     4  SYTSYG_FTRDONE         Number of times fast CCW
                                                    translation processing
                                                    completed successfully for a
                                                    DASD device.
     32  20  Unsigned     4  SYTSYG_FTRABORT        Number of times fast CCW
                                                    translation processing was
                                                    aborted for a DASD device.
     36  24  Unsigned     4  SYTSYG_FTRNOTEL        Number of times a presented
                                                    CCW for a DASD device was not
                                                    eligible for fast CCW
                                                    translation. There are cases
                                                    where ineligibility may have
                                                    been determined before the CCW
                                                    is presented to the fast path
                                                    simulator. Those cases are not
                                                    counted here.
     40  28  Unsigned     4  SYTSYG_FTRWRITE        Number of times a write
                                                    channel program for a DASD
                                                    device was presented for fast
                                                    CCW translation.
     44  2C  Unsigned     4  SYTSYG_CTNDONE         Number of times fast CCW
                                                    translation processing
                                                    completed successfully for a
                                                    network device.
     48  30  Unsigned     4  SYTSYG_CTNABORT        Number of times fast CCW
                                                    translation processing was
                                                    aborted for a network device.
     52  34  Unsigned     4  SYTSYG_CTNNOTEL        Number of times a presented
                                                    CCW for a network device was
                                                    not eligible for fast CCW
                                                    translation. There are cases
                                                    where ineligibility may have
                                                    been determined before the CCW
                                                    is presented to the fast path
                                                    simulator. Those cases are not
                                                    counted here.
                                                    ***********************
    STSI 1.2.2 fields

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

     56  38  Unsigned     4  SYTSYG_SCPCAPAB        The capability of a secondary
                                                    CPU in the configuration
     60  3C  Unsigned     4  SYTSYG_CPUCAPAB        Specifies the capability of
                                                    one of the CPUs in the current
                                                    configuration. Used as an
                                                    indication of the capability of
                                                    the CPU relative to the
                                                    capability of other CPU models.
                                                    This value applies to each of
                                                    the CPUs in this configuration.
     64  40  Unsigned     2  SYTSYG_CPUCOUNT        The Total number of CPUs in
                                                    the configuration. Includes all
                                                    CPUs in the configured,
                                                    standby, andthe reserved state.
     66  42  Unsigned     2  SYTSYG_CPUCFGCT        Specifies the number of CPUs
                                                    in the configured state. A CPU
                                                    is in the configured state when
                                                    it is in the configuration and
                                                    available to be used to execute
                                                    programs.
     68  44  Unsigned     2  SYTSYG_CPUSTNBY        Specifies the number of CPUs
                                                    in the standby state. A CPU is
                                                    in the standby state when it is
                                                    in the configuration, is not
                                                    available to be used to execute
                                                    programs, and can be made
                                                    available by issuing
                                                    instructions to place it in the
                                                    configured state.
     70  46  Unsigned     2  SYTSYG_CPURESVD        Specifies the number of CPUs
                                                    in the reserved state. A CPU is
                                                    in the reserved state when it
                                                    is in the configuration, is not
                                                    available to be used to execute
                                                    programs, and cannot be made
                                                    available by issuing
                                                    instructions to place it in the
                                                    configured state.
                                                    ***********************
    STSI 3.2.2 fields This information is level-3 from a VMDBK if available.

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

     72  48  Unsigned     1  SYTSYG_VL3DBCT         Specifies the number of VM
                                                    levels running between the
                                                    level at which this data was
                                                    collected and the hardware. For
                                                    example, data collected from a
                                                    VM system running second level
                                                    would show a value of 1. A
                                                    third level system would show a
                                                    value of 2.
     73  49  Character    1  *                      Reserved and available for
                                                    IBM use.
     74  4A  Unsigned     2  SYTSYG_VL3COUNT        The Total number of Logical
                                                    CPUs that are provided for this
                                                    level-3 configuration. Includes
                                                    all of the logical CPUs that
                                                    are in the configured, standby,
                                                    and the reserved state.
     76  4C  Unsigned     2  SYTSYG_VL3CFGCT        Specifies the number of
                                                    logical CPUs for this level-3
                                                    configuration that are in the
                                                    configured state. A logical CPU
                                                    is in the configured state when
                                                    it is in the level-3
                                                    configuration and available to
                                                    be used to execute programs.
     78  4E  Unsigned     2  SYTSYG_VL3STNBY        Specifies the number of
                                                    logical CPUs for this level-3
                                                    configuration that are in the
                                                    standby state. A logical CPU is
                                                    in the standby state when it is
                                                    in the level-3 configuration,
                                                    is not available to be used to
                                                    execute programs, and can be
                                                    made available by issuing
                                                    instructions to place it in the
                                                    configured state.
     80  50  Unsigned     2  SYTSYG_VL3RESVD        Specifies the number of
                                                    logical CPUs for this level-3
                                                    configuration that are in the
                                                    reserved state. A logical CPU
                                                    is in the reserved state when
                                                    it is in the level-3
                                                    configuration, is not available
                                                    to be used to execute programs,
                                                    and cannot be made available by
                                                    issuing instructions to place
                                                    it in the configured state.
     82  52  Character    2  *                      Reserved and available for
                                                    IBM use.
     84  54  Character    8  SYTSYG_VL3MNAME        Specifies the name of this
                                                    level-3 configuration.
     92  5C  Unsigned     4  SYTSYG_VL3CAF          The Capabiltiy Adjustment
                                                    Factor specifies the amount of
                                                    the underlying level-1, level-2
                                                    or level-3 configuration
                                                    capability that is allowed to
                                                    be used for this level-3
                                                    configuration by the virtual
                                                    machine control program. The
                                                    maximum value is 1000, and the
                                                    fraction of level-3
                                                    configuration capability is
                                                    determined by dividing the CAF
                                                    value by 1000.
     96  60  Character   16  SYTSYG_VL3CPNAM        Identifies the virtual
                                                    machine control program that
                                                    provides this level-3
                                                    configuration. This may include
                                                    qualifiers such as version
                                                    number and release level.
    112  70  Character    0  SYTSYG_END

    MRSYTSYG 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
    SYTSYG                     0    112
    SYTSYG_CPUCAPAB           3C      4
    SYTSYG_CPUCFGCT           42      2
    SYTSYG_CPUCOUNT           40      2
    SYTSYG_CPURESVD           46      2
    SYTSYG_CPUSTNBY           44      2
    SYTSYG_CTNABORT           30      4
    SYTSYG_CTNDONE            2C      4
    SYTSYG_CTNNOTEL           34      4
    SYTSYG_END                70      0
    SYTSYG_FTRABORT           20      4
    SYTSYG_FTRDONE            1C      4
    SYTSYG_FTRNOTEL           24      4
    SYTSYG_FTRWRITE           28      4
    SYTSYG_MRHDR               0      0
    SYTSYG_SCPCAPAB           38      4
    SYTSYG_VL3CAF             5C      4
    SYTSYG_VL3CFGCT           4C      2
    SYTSYG_VL3COUNT           4A      2
    SYTSYG_VL3CPNAM           60     16
    SYTSYG_VL3DBCT            48      1
    SYTSYG_VL3MNAME           54      8
    SYTSYG_VL3RESVD           50      2
    SYTSYG_VL3STNBY           4E      2
    SYTSYG_XCTMSACT           14      8

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

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

    Copyright IBM Corporation, 1990, 2005