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
 RELOCATION CONSIDERATIONS : None

 

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 HCPNSL and
                                        HCPNSJ
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 V6R2.0. Last updated on 21 Nov 2011 at 11:20:41 EDT.
Copyright IBM Corporation, 1990, 2011