PSGBK Back to Index page
Control Block Contents 
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

  PSGBK Prolog Top of page
 DESCRIPTION: POSIX supplementary GIDs Block
 FUNCTION   : This DSECT is used to map the supplementary
              GID list associated with a PXIBK
 CREATED BY : Routines that create the associated PXIBK
 DELETED BY : Routines that create the associated PXIBK
 SERIALIZED : Share of any PXIBK lock in a PXIBK that
              points to the PSGBK.  See HCPPXIBK for additional
 RELOCATION CONSIDERATIONS : This control block is relocated as part of a live
              guest relocation (LGR).  The bits and fields that
              need to be relocated are defined in the
              corresponding LGRPSGBK COPY file.  Whenever changes
              are made to this control block, consideration must
              be given to any effects these changes will have on
              a relocation.  If any new fields or bits are
              defined, they may need to be relocated.  If
              existing bits or fields are changed, corresponding
              modifications may be required in the LGR version of
              this control block.  Consider also the effects of
              these changes on a relocation involving a back-level
              release of CP.
 COMMENTS   : PSGBKs are sometimes imbedded in a
              PXIBK and are sometimes alone in their own free
              storage block.  A PSGBK can be pointed to by zero
              or more PXIBKs.
  PSGBK Control Block Content Top of page

 PSGBK DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure PSGBK POSIX supplementary GIDs Block 0000 0 Signed 4 PSGCOUNT Count of supplementary GIDs (has to be at least one because the user's primary GID will always be included here) 0004 4 Signed 4 PSGPXICT Count of PXIBKs whose PXIPSGBK field points to this PSGBK 0008 8 Bitstring 1 PSGFLAG Flag byte 1... .... PSGINPXI X'80' PSGINPXI This PSGBK is actually contained in a PXIBK 0009 9 Bitstring 3 * Reserved for IBM use 0000000C PSGHDRLN (*-PSGBK) Size of fixed-length portion of the PSGBK, in bytes 000C 12 Signed 4 PSGSGIDS (0) Beginning of supplementary GIDs. PSGCOUNT indicates how many SGIDs are here.
  PSGBK Storage Layout Top of page
*** PSGBK - POSIX supplementary GIDs Block
*     +---------------------------+---------------------------+
*   0 |         PSGCOUNT          |         PSGPXICT          |
*     +------+--------------------+---------------------------+
*   8 |:FLAG |////////////////////|
*     +------+--------------------+
*** PSGBK - POSIX supplementary GIDs Block
  PSGBK Cross Reference Top of page
Symbol         Dspl Value
-------------- ---- -----
PSGCOUNT       0000
PSGFLAG        0008
PSGHDRLN       0009 0000000C
PSGINPXI       0008 80
PSGPXICT       0004
PSGSGIDS       000C
This information is based on z/VM 6.3.0 Last updated on 22 May 2013 at 13:55:22 EDT.
Copyright IBM Corporation, 1990, 2013