PSGBK | Back to Index page

| Prolog Control Block Contents PSGBK DSECT 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

     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 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 7.2.0 Last updated on 24 Jun 2020 at 09:29:53 EDT.
Copyright IBM Corporation, 1990, 2020