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 Dbl-Word     8 SGPSSTRT       Beginning address of segment
                                            Space
    0008    8 Dbl-Word     8 SGPSEND        Ending address of segment Space
    0010   16 Address      4 SGPMSEG        Member segment SNTBK address
    0014   20 Address      4 SGPSEGSP       Segment Space SNTBK address
    0018   24 Address      4 SGPSDFPT       SDFBK Address
    001C   28 Address      4 SGPSHRBK       SHRBK address
    0020   32 Address      4 SGPSPNAM       Address of Space name to be
                                            loaded - obtained from DIAG 64
                                            issuer
    0024   36 Address      4 SGPSPSNT       Address of the SNTBK on the
                                            SPTape Queue that will used to
                                            defer Loads and IPLs.
    0028   40 Signed       4 SGPREGS (13)   Register save area
    005C   92 Character   24 SGPNSABK       NSABK Area
    0074  116 Signed       4 SGPRETCD       Error return code
    0078  120 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
    007C  124 Address      4 SGPRSNTA       Address of SNTBK for ESM
    0080  128 Address      4 SGPRSEGN       Address of Space name for ESM
    0084  132 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
                                            ***************--------
    0085  133 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
                                            ***************--------
    0086  134 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
                                            ***************--------
    0087  135 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
                                            ***************--------
    0088  136 Bitstring    1 SGPNPARM       Input Parameter for HCPNSLSL and
                                            HCPNSJSL
    0089  137 Bitstring    1 * (3)          Reserved for IBM use
              0000008C       SGPSIZEB       (*-SGPBK) Length in Bytes
              00000012       SGPSIZE        (*-SGPBK+7)/8 Length in
                                            doublewords

#### SGPBK Storage Layout

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

#### SGPBK Cross Reference

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

This information is based on z/VM V6R1.0. Last updated on 18 Feb 2010 at 09:04:24 EDT.
Copyright IBM Corporation, 1990, 2008