DSGR Back to Index page
 
Prolog 
Control Block Contents 
   DSGR 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.


  DSGR Prolog Top of page
  
 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
 RELOCATION CONSIDERATIONS : None
 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 Top of page
  




 DSGR DSECT
Top of page


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 Top of page
  
          
*** DSGR - Directory supplementary group IDs block
*
*     +---------------------------+--------------------+------+
*   0 |         DSGRLEN           |     DSGRLABL       |:RVERS|
*     +---------------------------+--------------------+------+
*
*** DSGR - Directory supplementary group IDs block
 
 
  DSGR Cross Reference Top of page
  
 
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 6.3.0 Last updated on 22 May 2013 at 13:54:21 EDT.
Copyright IBM Corporation, 1990, 2013