Function Code X'0003' - Designated Guest Information

Function code X'0003' returns guest CPU resource information useful to an authorized application performing CPU performance monitoring and management.

Use of this function code is authorized in the user directory by OPTION STHYI-GUEST.

When function code X'0003' is specified, general register R2 contains the guest logical address of a 4 KB response buffer, which must be on a 4 KB boundary or a specification exception is recognized.

This function code provides information for the Guest specified in the 8-byte buffer located at the guest logical address in R1+1. If the buffer is not aligned on a doubleword boundary a specification exception is recognized.

When the instruction completes with condition code 3, the response buffer located by the guest logical address in R2 is unchanged. When the instruction completes with condition code 0, guest information will be stored into the buffer at the guest logical address specified by register R2.

The possible nonzero return codes for this function code are:
CC=3 RC=4
Unsupported function code. Buffer is unchanged.
CC=3 RC=8
Not authorized for the function code. Buffer is unchanged.
CC=3 RC=12
Missing or invalid guest name. Buffer is unchanged.
CC=3 RC=16
Named guest is not logged on. Buffer is unchanged.

Function Code X'0003' Response Buffer Format (INF3BK)

INF3BK DSECT in HCPINFBK COPY of HCPGPI MACLIB describes the response buffer format and might include information regarding usage of the fields in the DSECT.

The common header section (INFCHDR DSECT) is placed at the beginning of the response buffer and identifies the length of the response.

The list designation fields in the common header are stored as zeroes.

The guest information follows the common header at INF3GSTI and is mapped by INF3GST DSECT.

The high-frequency counters starting at field INF3GIWSC report data collected when Monitor high-frequency sampling is active. The values are reset to zero when Monitor commands are issued that deactivate high-frequency sampling, and remain zero while it is inactive. MONITOR SAMPLE RATE is used to set the frequency of the guest state sampling which should be more frequent than the sampling interval. The high-frequency sampling is activated using MONITOR SAMPLE ENABLE USER for the users of interest.

The version number (INF3VRSN) in the function code X'0003' response header can be used to clearly identify whether the function code is at the required service level and can be used by applications to show actual and required version in messages when required support is missing.

Function Code X'0003' Response Header (INF3BK DSECT)

 
     +-------------------------------------------------------+
   0 |                                                       |
     =                       INF3CHDR                        =
     |                                                       |
     +-------------------------------------------------------+
  40 |                                                       |
     =                       INF3GSTI                        =
     |                                                       |
     +-------------------------------------------------------+
 180
 
 
Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      INF3BK         Mappings for STHYI
        Function code x'0003': Designated Guest Information
        This function code returns the description of the
        specified guest.
        Use of this function code is authorized in the User
        Directory by OPTION STHYI-GUEST.
        Error responses:
         - CC=3 RC=4  - Unsupported function code
                      - The response buffer is not modified.
         - CC=3 RC=8  - Not authorized for function code
                      - The response buffer is not modified.
         - CC=3 RC=12 - Missing or invalid guest name.
                      - The response buffer is not modified.
         - CC=3 RC=16 - Named guest is not logged on.
                      - The response buffer is not modified.
        Update Log - see equates under INF3VRSN.
        Function code X'0003' Response Buffer
0000    0 Bitstring   64 INF3CHDR       Common section of header mapped
                                        by INFCHDR DSECT.
0000    0 Unsigned     2 INF3VRSN       Response buffer version.
          00000001       INF3V00001     X'0001' INF3V00001 Initial
                                        version. APAR VM66105.
0040   64 Bitstring  320 INF3GSTI       Guest Information section mapped
                                        by INF3GST DSECT.
          00000180       INF3BSB1       *-INF3BK Version 1 length in
                                        bytes of the Guest Information
                                        response.
          00000030       INF3BSD1       (*-INF3BK+7)/8 Version 1 length
                                        in doublewords of the Guest
                                        Information response.
          00000180       INF3BSZB       *-INF3BK Length in bytes for
                                        newest version of the Guest
                                        Information response.
          00000030       INF3BSZD       (*-INF3BK+7)/8 Length in
                                        doublewords for newest version of
                                        the Guest Information response.

Function Code X'0003' Response Guest Information (INF3GST DSECT)

 
     +-------------------------------------------------------+
   0 |                       INF3GUID                        |
     +-------------------------------------------------------+
   8 |                       INF3GACN                        |
     +------+------+------+------+---------------------------+
  10 |:3GFLG|:3GVAL|:CMOD |:PRTP |         INF3GTOD          |
     +------+------+------+------+---------------------------+
  18 |                       INF3GPNA                        |
     +---------------------------+---------------------------+
  20 |        INF3GIWSC          |        INF3GCFSC          |
     +---------------------------+---------------------------+
  28 |        INF3GSMSC          |        INF3GPWSC          |
     +---------------------------+---------------------------+
  30 |         INF3GLSC          |         INF3GDSC          |
     +---------------------------+---------------------------+
  38 |         INF3GCSC          |        INF3GESSC          |
     +---------------------------+---------------------------+
  40 |        INF3GLDSC          |        INF3GDLSC          |
     +---------------------------+---------------------------+
  48 |        INF3GDSSC          |        INF3GIASC          |
     +---------------------------+---------------------------+
  50 |        INF3GTISC          |        INF3GTSSC          |
     +---------------------------+---------------------------+
  58 |        INF3GPASC          |         INF3GOSC          |
     +---------------------------+---------------------------+
  60 |         INF3GTSC          |        INF3GIWSI          |
     +---------------------------+---------------------------+
  68 |        INF3GCFSI          |        INF3GSMSI          |
     +---------------------------+---------------------------+
  70 |        INF3GPWSI          |         INF3GLSI          |
     +---------------------------+---------------------------+
  78 |         INF3GDSI          |         INF3GCSI          |
     +---------------------------+---------------------------+
  80 |        INF3GESSI          |        INF3GLDSI          |
     +---------------------------+---------------------------+
  88 |        INF3GDLSI          |        INF3GDSSI          |
     +---------------------------+---------------------------+
  90 |        INF3GIASI          |        INF3GTISI          |
     +---------------------------+---------------------------+
  98 |        INF3GTSSI          |        INF3GPASI          |
     +---------------------------+---------------------------+
  A0 |         INF3GOSI          |         INF3GTSI          |
     +------+------+-------------+---------------------------+
  A8 |:3CFLG|:AFFN | INF3CMCPU   |///////////////////////////|
     +------+------+-------------+---------------------------+
  B0 |                      INF3CTCPP                        |
     +-------------------------------------------------------+
  B8 |                      INF3CTCPS                        |
     +-------------------------------------------------------+
  C0 |                      INF3CTCRP                        |
     +-------------------------------------------------------+
  C8 |                      INF3CTCRS                        |
     +-------------+-------------+-------------+-------------+
  D0 |  INF3CSCP   |  INF3CDCP   |  INF3CRCP   |/////////////|
     +------+------+------+------+-------------+-------------+
  D8 |:3CCDT|:CSCF |:ISCF |//////|        INF3CCNSC          |
     +------+------+------+------+---------------------------+
  E0 |        INF3CCASC          |        INF3CCMSC          |
     +---------------------------+---------------------------+
  E8 |        INF3CINSC          |        INF3CIASC          |
     +---------------------------+---------------------------+
  F0 |        INF3CIMSC          |///////////////////////////|
     +---------------------------+---------------------------+
  F8 |                      INF3CTIPP                        |
     +-------------------------------------------------------+
 100 |                      INF3CTIPS                        |
     +-------------------------------------------------------+
 108 |                      INF3CTIRP                        |
     +-------------------------------------------------------+
 110 |                      INF3CTIRS                        |
     +-------------+-------------+-------------+-------------+
 118 |  INF3CSIF   |  INF3CDIF   |  INF3CRIF   |/////////////|
     +------+------+------+------+-------------+-------------+
 120 |:3CIDT|:CSIF |:ISIF |//////|        INF3CCNSI          |
     +------+------+------+------+---------------------------+
 128 |        INF3CCASI          |        INF3CCMSI          |
     +---------------------------+---------------------------+
 130 |        INF3CINSI          |        INF3CIASI          |
     +---------------------------+---------------------------+
 138 |        INF3CIMSI          |///////////////////////////|
     +---------------------------+---------------------------+
 140
 
 
Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      INF3GST        Mappings for STHYI
        Function code X'0003' Response Buffer
        Guest Description section
        This DSECT is also used for the guest section of the
        function code 1 response buffer.
0000    0 EBCDIC       8 INF3GUID       Guest's userid, in EBCDIC format.
0008    8 EBCDIC       8 INF3GACN       User accounting number in EBCDIC
                                        format.
0010   16 Bitstring    1 INF3GFLG       Guest Flag Byte
          1... ....      INF3GMOB       X'80' INF3GMOB Guest mobility is
                                        enabled.
          .... 1...      INF3GLINI      X'08' INF3GLINI Guest identified
                                        itself as running Linux using a
                                        control program identification
                                        interface.
          .... .1..      INF3GLINH      X'04' INF3GLINH Guest may be
                                        running Linux based on
                                        heuristics. Set only if INF3GLINI
                                        is not set.
0011   17 Bitstring    1 INF3GVAL       Reserved for IBM use
0012   18 Unsigned     1 INF3GCMOD      Virtual Configuration Mode
          00000080       INF3GCMGN      X'80' INF3GCMGN General (ESA390)
                                        virtual configuration mode
          00000040       INF3GCMLI      X'40' INF3GCMLI Linux virtual
                                        configuration mode
          00000020       INF3GCMVM      X'20' INF3GCMVM VM virtual
                                        configuration mode
          00000010       INF3GCMCF      X'10' INF3GCMCF CF virtual
                                        configuration mode
0013   19 Bitstring    1 INF3GPRTP      Guest primary virtual CPU type.
          00000000       INF3PUCCP      X'00' INF3PUCCP General Purpose
                                        (CP)
          00000003       INF3PUCIFL     X'03' INF3PUCIFL Integrated Fac
                                        for Linux (IFL).
0014   20 Unsigned     4 INF3GTOD       Bits 0-31 of host TOD at guest
                                        logon.
0018   24 EBCDIC       8 INF3GPNA       Resource pool name. Blanks if not
                                        in a Resource Pool.
      High frequency sampler counts 
        These counts are the number of times that CP and IFL CPUs of the
        guest are observed in each state.  These counts are reset to zero
        when Monitor commands are issued that disable high-frequency
        sampling.  Otherwise they are monotonically increasing values.
        INF1YMONH provides the high-frequency sampling interval for the
        state testing.  For each virtual CPU type, the order of the count
        fields is the order that the states are tested so that if a vCPU
        is in multiple states, it is counted with the first state that
        matches so that it is counted in one and only one state.  The one
        exception is that when a guest is on the dormant list and SVM wait
        they are counted in both INF3GDLSC and INF3GDSSC for virtual CPs
        and for IFLs, both INF3GDLSI and INF3GDSSI.  The values are
        aggregate values for all guest virtual CPUs of that type.  See
        Monitor record MRUSEINT D4 R4 for additional information.
0020   32 Unsigned     4 INF3GIWSC      I/O Wait Samples for CPs. Times
                                        vCPU found in I/O wait for
                                        asynchronous I/O.
0024   36 Unsigned     4 INF3GCFSC      Console Function Wait samples
                                        for CPs. Times vCPU found in
                                        console function wait.
0028   40 Unsigned     4 INF3GSMSC      Simulation Wait samples for CPs.
                                        Times vCPU found using CPU.
002C   44 Unsigned     4 INF3GPWSC      Page Wait Samples for CPs. Times
                                        vCPU found in page wait.
0030   48 Unsigned     4 INF3GLSC       Limit list Samples for CPs. Times
                                        vCPU found on limit list.
0034   52 Unsigned     4 INF3GDSC       CPU Delay Samples for CPs. Times
                                        vCPU found waiting for CPU.
0038   56 Unsigned     4 INF3GCSC       CPU Using Samples for CPs. Times
                                        vCPU found using CPU.
003C   60 Unsigned     4 INF3GESSC      E-list SVM Wait Samples for CPs.
                                        Times vCPU found on the eligible
                                        list and in SVM wait.
0040   64 Unsigned     4 INF3GLDSC      Loading User Samples for CPs.
                                        Times vCPU considered to be a
                                        loading user and not on the
                                        dormant list.
0044   68 Unsigned     4 INF3GDLSC      Dormant User Samples for CPs.
                                        Times vCPU was found to be on the
                                        dormant list.
0048   72 Unsigned     4 INF3GDSSC      SVM Wait Samples for CPs. Times
                                        vCPU found in the dormant list
                                        and in SVM wait. Also counted in
                                        INF3GDLSC.
004C   76 Unsigned     4 INF3GIASC      I/O Active Samples for CPs. Times
                                        vCPU found with asynchronous I/O
                                        outstanding, causing it to be
                                        left in the Dispatch List.
0050   80 Unsigned     4 INF3GTISC      Test Idle Samples for CPs. Times
                                        vCPU found in test idle and not
                                        in SVM wait.
0054   84 Unsigned     4 INF3GTSSC      Test Idle & SVM Wait Samples for
                                        CPs. Times vCPU found in test
                                        idle and SVM wait.
0058   88 Unsigned     4 INF3GPASC      Page Fault Active Samples for
                                        CPs. Times vCPU had active page
                                        fault requests active but was not
                                        in page wait.
005C   92 Unsigned     4 INF3GOSC       Other Samples for CPs. Times vCPU
                                        found in other state.
0060   96 Unsigned     4 INF3GTSC       Total Samples for CPs. Times vCPU
                                        state sampled.
0064  100 Unsigned     4 INF3GIWSI      I/O Wait Samples for IFLs. Times
                                        vCPU found in I/O wait for
                                        asynchronous I/O.
0068  104 Unsigned     4 INF3GCFSI      Console Function Wait samples
                                        for IFLs. Times vCPU found in
                                        console function wait.
006C  108 Unsigned     4 INF3GSMSI      Simulation Wait samples for IFLs.
                                        Times vCPU found using CPU.
0070  112 Unsigned     4 INF3GPWSI      Page Wait Samples for IFLs. Times
                                        vCPU found in page wait.
0074  116 Unsigned     4 INF3GLSI       Limit list Samples for IFLs.
                                        Times vCPU found on limit list.
0078  120 Unsigned     4 INF3GDSI       CPU Delay Samples for IFLs. Times
                                        vCPU found waiting for CPU.
007C  124 Unsigned     4 INF3GCSI       CPU Using Samples for IFLs. Times
                                        vCPU found using CPU.
0080  128 Unsigned     4 INF3GESSI      E-list SVM Wait Samples for IFLs.
                                        Times vCPU found on the eligible
                                        list and in SVM wait.
0084  132 Unsigned     4 INF3GLDSI      Loading User Samples for IFLs.
                                        Times vCPU considered to  be a
                                        loading user and not on the
                                        dormant list.
0088  136 Unsigned     4 INF3GDLSI      Dormant User Samples for IFLs.
                                        Times vCPU was found to be on the
                                        dormant list.
008C  140 Unsigned     4 INF3GDSSI      SVM Wait Samples for IFLs. Times
                                        vCPU found in the dormant list
                                        and in SVM wait. Also counted in
                                        INF3GDLSC.
0090  144 Unsigned     4 INF3GIASI      I/O Active Samples for IFLs.
                                        Times vCPU found with
                                        asynchronous I/O outstanding,
                                        causing it to be left in the
                                        Dispatch List.
0094  148 Unsigned     4 INF3GTISI      Test Idle Samples for IFLs. Times
                                        vCPU found in test idle and not
                                        in SVM wait.
0098  152 Unsigned     4 INF3GTSSI      Test Idle & SVM Wait Samples for
                                        IFLs. Times vCPU found in test
                                        idle and SVM wait.
009C  156 Unsigned     4 INF3GPASI      Page Fault Active Samples for
                                        IFLs. Times vCPU had active page
                                        fault requests active but was not
                                        in page wait.
00A0  160 Unsigned     4 INF3GOSI       Other Samples for IFLs. Times
                                        vCPU found in other state.
00A4  164 Unsigned     4 INF3GTSI       Total Samples for IFLs. Times
                                        vCPU state sampled.
      CPU resources information
00A8  168 Bitstring    1 INF3CFLG       Guest CPU Flag Byte
          .1.. ....      INF3CMCT       X'40' INF3CMCT Guest has multiple
                                        CPU types
          ..1. ....      INF3CVCT       X'20' INF3CVCT Virtual CPs are
                                        thread dispatched
          ...1 ....      INF3CVIT       X'10' INF3CVIT Virtual IFLs are
                                        thread dispatched
00A9  169 Bitstring    1 INF3CAFFN      Guest CPUAFFINITY settings.
          1... ....      INF3CAFON      X'80' INF3CAFON CPUAFFINITY is
                                        ON, but may be suppressed. If
                                        off, then INF3CAFSUP will not be on.
          .1.. ....      INF3CAFSUP     X'40' INF3CAFSUP CPUAFFINTY is
                                        suppressed.
00AA  170 Unsigned     2 INF3CMCPU      Maximum number of guest CPUs
                                        based on user directory setting.
00AC  172 Unsigned     4 *              Reserved for IBM use.
00B0  176 Unsigned     8 INF3CTCPP      Total virtual and simulation time
                                        while running a virtual CP on a
                                        primary CPU, in prorated core
                                        time microseconds. Only provided
                                        when SMT is enabled
                                        (INF1YFL1.INF1YMTE).
                                        Monotonically increasing.
00B8  184 Unsigned     8 INF3CTCPS      Total virtual and simulation time
                                        while running a virtual CP on a
                                        2ndary CPU, in prorated core time
                                        microseconds. Only provided when
                                        SMT is enabled
                                        (INF1YFL1.INF1YMTE).
                                        Monotonically increasing.
00C0  192 Unsigned     8 INF3CTCRP      Total virtual and simulation time
                                        while running a virtual CP on a
                                        primary CPU, in raw core time
                                        microseconds. Monotonically
                                        increasing.
00C8  200 Unsigned     8 INF3CTCRS      Total virtual and simulation time
                                        while running a virtual CP on a
                                        secondary CPU, in raw core time
                                        microseconds. Monotonically
                                        increasing.
00D0  208 Unsigned     2 INF3CSCP       Number of guest shared CPs.
00D2  210 Unsigned     2 INF3CDCP       Number of guest dedicated CPs.
00D4  212 Unsigned     2 INF3CRCP       Number of non-stopped guest CPs.
00D6  214 Unsigned     2 *              Reserved for IBM use.
00D8  216 Unsigned     1 INF3CCDT       Dispatch type for guest CPs This
                                        field is valid if INF3SCPS,
                                        INF3CDCP or INF3CRCP is greater
                                        than zero. Always INF3PUCCP.
00D9  217 Bitstring    1 INF3CCSCF      Current share flags for CPs.
          .1.. ....      INF3CCLHC      X'40' INF3CCLHC Current max share
                                        for CP-dispatched vCPUs is
                                        LIMITHARD if on. Max share for
                                        type CP is LIMITSOFT if off.
          ..1. ....      INF3CCNAC      X'20' INF3CCNAC Current normal
                                        share for CP-dispatched vCPUs is
                                        ABSOLUTE if on. Normal share for
                                        type CP is RELATIVE if off.
          ...1 ....      INF3CCMAC      X'10' INF3CCMAC Current max share
                                        for CP-dispatched vCPUs is
                                        ABSOLUTE if on. Max share for
                                        type CP is RELATIVE if off.
00DA  218 Bitstring    1 INF3CISCF      Initial share flags for CPs.
          .1.. ....      INF3CILHC      X'40' INF3CILHC Initial max share
                                        for CP-dispatched vCPUs is
                                        LIMITHARD if on. Max share for
                                        type CP is LIMITSOFT if off. This
                                        is the setting at logon.
          ..1. ....      INF3CINAC      X'20' INF3CINAC Initial normal
                                        share for CP-dispatched vCPUs is
                                        ABSOLUTE if on. Normal share for
                                        type CP is RELATIVE if off. This
                                        is the setting at logon.
          ...1 ....      INF3CIMAC      X'10' INF3CIMAC Initial max share
                                        for CP-dispatched vCPUs is
                                        ABSOLUTE if on. Max share for
                                        type CP is RELATIVE if off. This
                                        is the setting at logon.
00DB  219 Bitstring    1 *              Reserved for IBM use
00DC  220 Unsigned     4 INF3CCNSC      Current normal relative share for
                                        CP-dispatched vCPUs. The value is
                                        zero when the user has an ABSOLUTE
                                        share value for CPs, or has a
                                        dedicated virtual CPU, or is in
                                        the process of being logged off.
00E0  224 Unsigned     4 INF3CCASC      Current ABSOLUTE share for                                         CP-dispatched vCPUs. Unit of                                         value is a hexadecimal factor                                         scaled 16 bits. For example,                                         X'00010000' = 1.00(100%),                                         X'0000C000' = 0.75(75%),                                         X'00008000' = 0.50(50%), etc.                                         Set to zero when the user has                                         a RELATIVE share value for CPs.
00E4  228 Unsigned     4 INF3CCMSC      Current Max share for CP-dispatched                                         vCPUs. This value is set to                                         zero if no Max share exists for                                         CPs. If the Max share is Absolute,                                         then the units of the value                                         are the same as for INFCCASC.                                         Otherwise as for INF3CCNSC.
00E8  232 Unsigned     4 INF3CINSC      Initial (logon) normal relative
                                        share for CP-dispatched vCPUs.
                                        This value will be zero when the
                                        initial (logon) share is ABSOLUTE
                                        for CPs, or the user has a
                                        dedicated virtual CPU, or is in
                                        the process of being logged off.
00EC  236 Unsigned     4 INF3CIASC      Initial (logon) ABSOLUTE share
                                        for CP-dispatched vCPUs. Unit of
                                        value is a hexadecimal factor
                                        scaled 16 bits. For example,
                                        X'00010000' = 1.00(100%),
                                        X'0000C000' = 0.75(75%),
                                        X'00008000' = 0.50(50%), etc.
                                        This value will be zero when the
                                        initial (logon) share for CPs
                                        is relative.
00F0  240 Unsigned     4 INF3CIMSC      Initial (logon) Max share for
                                        CP-dispatched vCPUs. This value
                                        will be zero if no initial 
                                        (logon) Max share exists for CPs.
                                        If the Max share is Absolute,
                                        then the units of the value
                                        are the same as for INF3CIASC.
                                        Otherwise as for INF3CINSC.
00F4  244 Unsigned     4 *              Reserved for IBM use.
00F8  248 Unsigned     8 INF3CTIPP      Total virtual and simulation time
                                        while running a virtual IFL on a
                                        primary CPU, in prorated core
                                        time microseconds. Only provided
                                        when SMT is enabled
                                        (INF1YFL1.INF1YMTE).
                                        Monotonically increasing.
0100  256 Unsigned     8 INF3CTIPS      Total virtual and simulation time
                                        while running a virtual IFL on a
                                        2ndary CPU, in prorated core time
                                        microseconds. Only provided when
                                        SMT is enabled
                                        (INF1YFL1.INF1YMTE).
                                        Monotonically increasing.
0108  264 Unsigned     8 INF3CTIRP      Total virtual and simulation time
                                        while running a virtual IFL on a
                                        primary CPU, in raw core time
                                        microseconds. Monotonically
                                        increasing.
0110  272 Unsigned     8 INF3CTIRS      Total virtual and simulation time
                                        while running a virtual IFL on a
                                        secondary CPU, in raw core time
                                        microseconds. Monotonically
                                        increasing.
0118  280 Unsigned     2 INF3CSIF       Number of guest shared IFLs.
011A  282 Unsigned     2 INF3CDIF       Number of guest dedicated IFLs.
011C  284 Unsigned     2 INF3CRIF       Number of non-stopped guest IFLs.
011E  286 Unsigned     2 *              Reserved for IBM use.
0120  288 Unsigned     1 INF3CIDT       Dispatch type for guest IFLs.
                                        This field is valid if INF3SCPS,
                                        INF3CDCP or INF3CRCP is greater
                                        than zero.
          00000000       INF3PUCCP      X'00' INF3PUCCP General Purpose
                                        (CP)
          00000003       INF3PUCIFL     X'03' INF3PUCIFL Integrated Fac
                                        for Linux (IFL).
0121  289 Bitstring    1 INF3CCSIF      Current share flags for IFLs.
          .1.. ....      INF3CCLHI      X'40' INF3CCLHI Current max share
                                        for IFL-dispatched vCPUs is
                                        LIMITHARD if on. Max share for
                                        type IFL is LIMITSOFT if off.
          ..1. ....      INF3CCNAI      X'20' INF3CCNAI Current normal
                                        share for IFL-dispatched vCPUs is
                                        ABSOLUTE if on. Normal share for
                                        type IFL is RELATIVE if off.
          ...1 ....      INF3CCMAI      X'10' INF3CCMAI Current max share
                                        for IFL-dispatched vCPUs is
                                        ABSOLUTE if on. Max share for
                                        type IFL is RELATIVE if off.
0122  290 Bitstring    1 INF3CISIF      Initial share flags for IFLs.
          .1.. ....      INF3CILHI      X'40' INF3CILHI Initial max share
                                        for IFL-dispatched vCPUs is
                                        LIMITHARD if on. Max share for
                                        type IFL is LIMITSOFT if off.
                                        This is the setting at logon.
          ..1. ....      INF3CINAI      X'20' INF3CINAI Initial normal
                                        share for IFL-dispatched vCPUs is
                                        ABSOLUTE if on. Normal share for
                                        type IFL is RELATIVE if off. This
                                        is the setting at logon.
          ...1 ....      INF3CIMAI      X'10' INF3CIMAI Initial max share
                                        for IFL-dispatched vCPUs is
                                        ABSOLUTE if on. Max share for
                                        type IFL is RELATIVE if off. This
                                        is the setting at logon.
0123  291 Bitstring    1 *              Reserved for IBM use
0124  292 Unsigned     4 INF3CCNSI      Current normal relative share for                                         IFL-dispatched vCPUs. The value is                                         zero when the user has an ABSOLUTE                                         share value for IFLs, or has a                                         dedicated virtual CPU, or is in                                         the process of being logged off.
0128  296 Unsigned     4 INF3CCASI      Current ABSOLUTE share for                                         IFL-dispatched vCPUs. Unit of                                         value is a hexadecimal factor                                         scaled 16 bits. For example,                                         X'00010000' = 1.00(100%),                                         X'0000C000' = 0.75(75%),                                         X'00008000' = 0.50(50%), etc.                                         The value is zero when the user                                         has a RELATIVE share value for IFLs.
012C  300 Unsigned     4 INF3CCMSI      Current Max share for IFL-dispatched                                         vCPUs. This value will be zero                                         if no Max share exists for IFLs.                                         If the Max share is Absolute,                                         then the units of the value                                         are the same as for INF3CCASI.                                         Otherwise as for INF3CCNSI.
0130  304 Unsigned     4 INF3CINSI      Initial (logon) normal relative
                                        share for IFL-dispatched vCPUs.
                                        This value will be zero when the
                                        initial (logon) share is ABSOLUTE
                                        for IFLs, or the user has a 
                                        dedicated virtual CPU, or is in
                                        the process of being logged off.
0134  308 Unsigned     4 INF3CIASI      Initial (logon) ABSOLUTE share
                                        for IFL-dispatched vCPUs. Unit of
                                        value is a hexadecimal factor
                                        scaled 16 bits. For example,
                                        X'00010000' = 1.00(100%),
                                        X'0000C000' = 0.75(75%),
                                        X'00008000' = 0.50(50%), etc.
                                        This value will be zero when the
                                        initial (logon) share is relative
                                        for IFLs.
0138  312 Unsigned     4 INF3CIMSI      Initial (logon) Max share for
                                        IFL-dispatched vCPUs. This value
                                        will be zero if no initial
                                        (logon) Max share exists for IFLs.
                                        If the Max share is Absolute,
                                        then the units of the value
                                        are the same as for INF3CIASI.
                                        Otherwise as for INF3CINSI.
013C  316 Unsigned     4 *              Reserved for IBM use.
          00000140       INF3GSB1       *-INF3GST Version 1 length in
                                        bytes of the Guest Description.
          00000028       INF3GSD1       (*-INF3GST+7)/8 Version 1 length
                                        in doublewords of the Guest
                                        Description.
          00000140       INF3GSZB       *-INF3GST Length in bytes for
                                        newest version of the Guest
                                        Description.
          00000028       INF3GSZD       (*-INF3GST+7)/8 Length in
                                        doublewords for newest version of
                                        the Guest Description.