DSGR - 32-bit CP - V4R4.0
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' 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 V4R4.0. Last updated on 29 Jul 2003 at 15:28:27 EDT.
Copyright IBM Corporation, 1990, 2003