SGPBK - 64-bit CP - V4R4.0

Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### SGPBK

Prolog

Control Block Contents
SGPBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### SGPBK Prolog

     NAME       : HCPSGPBK
     DESCRIPTION: Segment Space/Saved System Parameter
                  Control Block.
     DSECT      : SGPBK
     FUNCTION   : The HCPSGPBK is a parameter area used for
                  Diagnose X'64' calls and calls to HCPNSJ.
     LOCATED BY : None
     CREATED BY : HCPNSI, HCPNSL, HCPNSJ
     DELETED BY : HCPNSI, HCPNSL, HCPNSJ

#### SGPBK Control Block Content

#### SGPBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      SGPBK          Segment Space/Saved System
                                            Parameter
    0000    0 Signed       4 SGPSSTRT       Beginning address of segment
                                            Space
    0004    4 Signed       4 SGPSEND        Ending address of segment Space
    0008    8 Address      4 SGPMSEG        Member segment SNTBK address
    000C   12 Address      4 SGPSEGSP       Segment Space SNTBK address
    0010   16 Address      4 SGPSDFPT       SDFBK Address
    0014   20 Address      4 SGPSHRBK       SHRBK address
    0018   24 Address      4 SGPSPNAM       Address of Space name to be
                                            loaded - obtained from DIAG 64
                                            issuer
    001C   28 Address      4 SGPSPSNT       Address of the SNTBK on the
                                            SPTape Queue that will used to
                                            defer Loads and IPLs.
    0020   32 Signed       4 SGPREGS (13)   Register save area
    0054   84 Character   24 SGPNSABK       NSABK Area
    006C  108 Signed       4 SGPRETCD       Error return code
    0070  112 Address      4 SGPXSHRQ       Excess SHRBK Queue
         Error return code EQUATES for SGPRETCD
              00000000       SGPRC0         0 User is authorized
              00000004       SGPRC4         4 User not authorized
              00000008       SGPRC8         8 Insufficient Guest virtual
                                            storage to load/IPL the Saved
                                            Segment/NSS
              0000000C       SGPRC12        12 Named Space not found
              00000010       SGPRC16        16 Paging error
              00000014       SGPRC20        20 Configuration error
              00000018       SGPRC24        24 Unable to continue
              0000001C       SGPRC28        28 Two contiguous pages of
                                            storage are not available for
                                            segment table
              0000001E       SGPRC30        30 Invalid CP Segment load
              00000024       SGPRC36        36 Overlay condition occurred
              00000028       SGPRC40        40 NAMESAVE statement not found
                                            in the CP directory during
                                            authorization checking.
              0000002C       SGPRC44        44 I/O error reading directory
              00000030       SGPRC48        48 370 guest attempted to load a
                                            Segment Space above the 16Meg
                                            line.
              00000034       SGPRC52        52 Attempting to load non shared
                                            when already loaded shared.
              00000038       SGPRC56        56 Attempting to load >= start
                                            address of define storage
                                            config's 2nd extent. -------- End
                                            of EQUATES for SGPRETCD
                                            ***************--------
         ESM parameter area
    0074  116 Address      4 SGPRSNTA       Address of SNTBK for ESM
    0078  120 Address      4 SGPRSEGN       Address of Space name for ESM
    007C  124 Bitstring    1 SGPESMFN       Type of ESM request
         Equates for SGPESMFN flag
              1... ....      SGPAUDIT       X'80' Audit-only flag
              .1.. ....      SGPRSTDC       X'40' Restricted segment
              ..1. ....      SGPSKIPA       X'20' Skip UDR and ESM call
                                            indicator -------- End of EQUATES
                                            for SGPESMFN
                                            ***************--------
    007D  125 Bitstring    1 SGPESMST       Indicates whether the ESM has
                                            been called
         Equates for SGPESMST flag
              1... ....      SGPESMD        X'80' Indicates the ESM has been
                                            called -------- End of EQUATES
                                            for SGPESMST
                                            ***************--------
    007E  126 Bitstring    1 SGPDTYPE       Type of load requested
         Equates for SGPDTYPE flag
              1... ....      SGPNSJSL       X'80' HCPNSJ was called for
                                            system load.
              .1.. ....      SGPNSJSY       X'40' HCPNSJ was called for Guest
                                            IPL.
              ...1 ....      SGPNSLNO       X'10' HCPNSL was called load no
                                            overlay
              .... .1..      SGPNSLNS       X'04' HCPNSL was called load
                                            non-shared
              .... ..1.      SGPNSLSL       X'02' HCPNSL was called for a
                                            system load
              .... ....      SGPNSLSH       X'00' HCPNSL was called load
                                            shared -------- End of EQUATES
                                            for SGPDTYPE
                                            ***************--------
    007F  127 Bitstring    1 SGPLOCKS       Lock flag
         Equates for SGPLOCKS flag
              1... ....      SGPSSEGS       X'80' Saved Segment SNTBK Queue
                                            Lock held shared (NSUSGQLK)
              .1.. ....      SGPSSEGE       X'40' Saved Segment SNTBK Queue
                                            Lock held exclusive(NSUSGQLK)
              ..1. ....      SGPSSYSS       X'20' NSS SNTBK Queue Lock held
                                            shared (NSUSYQLK)
              ...1 ....      SGPSSYSE       X'10' NSS SNTBK Queue Lock held
                                            exclusively. (NSUSYQLK)
              .... 1...      SGPSDFQE       X'08' *NSS SDF Queue lock held
                                            exclusively (NSUSDFLK)
              .... .1..      SGPSDFQS       X'04' *NSS SDF Queue lock held
                                            shared (NSUSDFLK)
              .... ..1.      SGPVMDSH       X'02' VMDBK/SHRBK Queue lock held
                                            exclusively (VMDSHRLK)
              .... ...1      SGPSNTSH       X'01' SNTBK/SHRBK Queue lock held
                                            exclusively (SNTSHRLK) --------
                                            End of EQUATES for SGPLOCKS
                                            ***************--------
    0080  128 Bitstring    1 SGPNPARM       Input Parameter for HCPNSLSL and
                                            HCPNSJSL
    0081  129 Bitstring    1 * (3)          Reserved for IBM use
              00000084       SGPSIZEB       (*-SGPBK) Length in Bytes
              00000011       SGPSIZE        (*-SGPBK+7)/8 Length in
                                            doublewords

#### SGPBK Storage Layout

    *** SGPBK - Segment Space/Saved System Parameter
    *
    *     +---------------------------+---------------------------+
    *   0 |         SGPSSTRT          |         SGPSEND           |
    *     +---------------------------+---------------------------+
    *   8 |         SGPMSEG           |         SGPSEGSP          |
    *     +---------------------------+---------------------------+
    *  10 |         SGPSDFPT          |         SGPSHRBK          |
    *     +---------------------------+---------------------------+
    *  18 |         SGPSPNAM          |         SGPSPSNT          |
    *     +---------------------------+---------------------------+
    *  20 |                                                       |
    *     =                       SGPREGS                         =
    *     |                           +---------------------------+
    *     |                           |                           |
    *     +---------------------------+                           |
    *  58 |                                                       |
    *     =                       SGPNSABK                        =
    *     |                           +---------------------------+
    *  68 |                           |         SGPRETCD          |
    *     +---------------------------+---------------------------+
    *  70 |         SGPXSHRQ          |         SGPRSNTA          |
    *     +---------------------------+------+------+------+------+
    *  78 |         SGPRSEGN          |:ESMFN|:ESMST|:DTYPE|:LOCKS|
    *     +------+--------------------+------+------+------+------+
    *  80 |:NPARM|////////////////////| 84
    *     +------+--------------------+
    *
    *** SGPBK - Segment Space/Saved System Parameter

#### SGPBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    SGPAUDIT       007C 80
    SGPDTYPE       007E
    SGPESMD        007D 80
    SGPESMFN       007C
    SGPESMST       007D
    SGPLOCKS       007F
    SGPMSEG        0008
    SGPNPARM       0080
    SGPNSABK       0054
    SGPNSJSL       007E 80
    SGPNSJSY       007E 40
    SGPNSLNO       007E 10
    SGPNSLNS       007E 04
    SGPNSLSH       007E 00
    SGPNSLSL       007E 02
    SGPRC0         0070 00000000
    SGPRC12        0070 0000000C
    SGPRC16        0070 00000010
    SGPRC20        0070 00000014
    SGPRC24        0070 00000018
    SGPRC28        0070 0000001C
    SGPRC30        0070 0000001E
    SGPRC36        0070 00000024
    SGPRC4         0070 00000004
    SGPRC40        0070 00000028
    SGPRC44        0070 0000002C
    SGPRC48        0070 00000030
    SGPRC52        0070 00000034
    SGPRC56        0070 00000038
    SGPRC8         0070 00000008
    SGPREGS        0020
    SGPRETCD       006C
    SGPRSEGN       0078
    SGPRSNTA       0074
    SGPRSTDC       007C 40
    SGPSDFPT       0010
    SGPSDFQE       007F 08
    SGPSDFQS       007F 04
    SGPSEGSP       000C
    SGPSEND        0004
    SGPSHRBK       0014
    SGPSIZE        0081 00000011
    SGPSIZEB       0081 00000084
    SGPSKIPA       007C 20
    SGPSNTSH       007F 01
    SGPSPNAM       0018
    SGPSPSNT       001C
    SGPSSEGE       007F 40
    SGPSSEGS       007F 80
    SGPSSTRT       0000
    SGPSSYSE       007F 10
    SGPSSYSS       007F 20
    SGPVMDSH       007F 02
    SGPXSHRQ       0070

This information is based on z/VM V4R4.0. Last updated on 30 Jul 2003 at 13:12:42 EDT.
Copyright IBM Corporation, 1990, 2003