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 7.3.0 Last updated on 22 Jun 2022 at 15:49:52 EDT.
Copyright IBM Corporation, 1990, 2022