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  Character    4  *                   Reserved and available for IBM
                                                 use.
     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_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 V4R4.0.

    Last updated on 22 Jul 2003 at 15:04:23.

    Copyright IBM Corporation, 1990, 2003