Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### DSGR

Prolog

Control Block Contents
DSGR DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### DSGR Prolog

     Name       : HCPDSGR
     Description: Directory supplementary group IDs block
     DSECT      : DSGR
     Function   : The supplementary group ID block defines
                  supplementary group IDs that a user may have.
     Located by : On DASD - DVMDSDAD/DVMDSDSP fields of HCPDVMD
                  In storage - DVMDSDAD field of HCPDVMD
     Created by : HCPDIR
                  HCPUDPRD
     Deleted by : HCPLGBFR
                  HCPLGNUS
                  HCPPXIQD
                  HCPUDPRD
     Comments   : This DSECT references fields in
                  HCPEQUAT, so any module using this DSECT must
                  also COPY HCPEQUAT.
                  An "in-storage" copy of this block may contain
                  data from the online directory or an ESM.
                  The DSGR block always contains the user's primary
                  GID. The primary GID can also be found in the
                  DVMDGID field.

#### DSGR Control Block Content

#### DSGR DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      DSGR           Directory supplementary group IDs block
    0000    0 Signed       4 DSGRLEN        DSGR block size in bytes
    0004    4 Character    3 DSGRLABL       Label to validate this block
    0007    7 Bitstring    1 DSGRVERS       Version code for this block
              00000000       DSGRVER0       X'00' DSGRVER0 Initial version
              00000008       DSGRHDBS       (*-DSGR) Size of fixed-length
                                            portion of the DSGR, in bytes
    0008    8 Signed       4 DSGRGID (0)    Start of a variable length data.
                                            It will contain 2 to NGROUPS_MAX
                                            supplementary GIDs (SGIDs)
         **** THE VALUE OF NGMAXDEF FOR DATAMAP IS 32
              00000080       DSGRDFLN       (NGMAXDEF*L'DSGRGID) Maximum
                                            length of DSGRGID array in CP
                                            directory
              00000088       DSGRDFBS       (DSGRHDBS+DSGRDFLN) Maximum DSGR
                                            block size in CP directory, in
                                            bytes **** THE VALUE OF NGMAXMAX
                                            FOR DATAMAP IS 125
              000001F4       DSGRMXLN       (NGMAXMAX*L'DSGRGID) Maximum
                                            length of DSGRGID array
              000001FC       DSGRMXBS       (DSGRHDBS+DSGRMXLN) Maximum DSGR
                                            block size, in bytes
              00000040       DSGRMXDS       (DSGRMXBS+7)/8 Maximum DSGR block
                                            size, in doublewords

#### DSGR Storage Layout

    *** DSGR - Directory supplementary group IDs block
    *
    *     +---------------------------+--------------------+------+
    *   0 |         DSGRLEN           |     DSGRLABL       |:RVERS|
    *     +---------------------------+--------------------+------+
    *
    *** DSGR - Directory supplementary group IDs block

#### DSGR Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    DSGRDFBS       0008 00000088
    DSGRDFLN       0008 00000080
    DSGRGID        0008
    DSGRHDBS       0007 00000008
    DSGRLABL       0004
    DSGRLEN        0000
    DSGRMXBS       0008 000001FC
    DSGRMXDS       0008 00000040
    DSGRMXLN       0008 000001F4
    DSGRVERS       0007
    DSGRVER0       0007 00000000

This information is based on z/VM V6R1.0. Last updated on 18 Feb 2010 at 08:36:10 EDT.
Copyright IBM Corporation, 1990, 2008