NAME       : HCPPSGBK
 DESCRIPTION: POSIX supplementary GIDs Block
 DSECT      : PSGBK
 FUNCTION   : This DSECT is used to map the supplementary
              GID list associated with a PXIBK
 LOCATED BY : PXIPSGBK
 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
              information.
 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 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 - POSIX supplementary GIDs Block
*
*     +---------------------------+---------------------------+
*   0 |         PSGCOUNT          |         PSGPXICT          |
*     +------+--------------------+---------------------------+
*   8 |:FLAG |////////////////////|
*     +------+--------------------+
*
*** PSGBK - POSIX supplementary GIDs Block

 
Symbol         Dspl Value
-------------- ---- -----
PSGCOUNT       0000
PSGFLAG        0008
PSGHDRLN       0009 0000000C
PSGINPXI       0008 80
PSGPXICT       0004
PSGSGIDS       000C