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 V5R1.0. Last updated on 8 Sep 2004 at 14:29:07 EDT.
Copyright IBM Corporation, 1990, 2004