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

DGRPM

Prolog  

Control Block Contents  
   DGRPM DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


DGRPM Prolog

 NAME       : HCPDGRPM
 DESCRIPTION: Directory POSIX group member block
 DSECT      : DGRPM
 FUNCTION   : The directory POSIX group member block contains
              a list of group members derived from POSIXGLIST
              and POSIXINFO directory statements.
 LOCATED BY : DGRPNDAD/DGRPNDSP fields of HCPDGRPM
              DNXGIDAD/DNXGIDSP fields of HCPDNXBK
 CREATED BY : HCPDIR
              HCPUDPRD
 DELETED BY : HCPLGBFR
              HCPPXIQD
              HCPUDPQG
              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.

 

DGRPM Control Block Content


DGRPM DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      DGRPM          Directory POSIX group member block
0000    0 Signed       4 DGRPMLEN       DGRPM block size in bytes
0004    4 Character    3 DGRPLABL       Label to validate this block
0007    7 Bitstring    1 DGRPVERS       Version code for this block
          .... ....      DGRPVER0       X'00' DGRPVER0 Initial version
0008    8 Bitstring    6 DGRPNEXT (0)   Address of next DGRPM on the
                                        chain
0008    8 Signed       4 DGRPNDAD       DASD address of the next DGRPM
                                        CCPV for CKD DASD addresses PPPV
                                        for CKD DASD addresses DGRPNDAD
                                        is also used for the storage
                                        address of the next DGRPM in an
                                        in-storage chain.
000C   12 Signed       2 DGRPNDSP       Offset to the next DGRPM
000E   14 Signed       2 *              Reserved for IBM use
          00000010       DGRPHDBS       (*-DGRPM) Size of fixed-length
                                        portion of the DGRPM, in bytes
0010   16 Character    8 DGRPMNAM (0)   Start of variable length data It
                                        will contain group member names
                                        (VM userids)
     **** THE VALUE OF FSMAXB FOR DATAMAP IS 4072
          000001FB       DGRPMXGM       (FSMAXB-DGRPHDBS)/L'DGRPMNAM
                                        Maximum number of group members
                                        in a single DGRPM
          00000FD8       DGRPMXLN       (DGRPMXGM*L'DGRPMNAM) Maximum
                                        length of DGRPMNAM array
          00000FE8       DGRPMXBS       (DGRPHDBS+DGRPMXLN) Maximum DGRPM
                                        block size, in bytes
          000001FD       DGRPMXDS       (DGRPMXBS+7)/8 Maximum DGRPM
                                        block size, in doublewords

 

DGRPM Storage Layout

          
*** DGRPM - Directory POSIX group member block
*
*     +---------------------------+--------------------+------+
*   0 |         DGRPMLEN          |     DGRPLABL       |:PVERS|
*     +---------------------------+-------------+------+------+
*   8 |         DGRPNDAD          |  DGRPNDSP   |/////////////|
*     +---------------------------+-------------+-------------+
*
*** DGRPM - Directory POSIX group member block

 

DGRPM Cross Reference

Symbol         Dspl Value
-------------- ---- -----
DGRPHDBS       000E 00000010
DGRPLABL       0004
DGRPMLEN       0000
DGRPMNAM       0010
DGRPMXBS       0010 00000FE8
DGRPMXDS       0010 000001FD
DGRPMXGM       0010 000001FB
DGRPMXLN       0010 00000FD8
DGRPNDAD       0008
DGRPNDSP       000C
DGRPNEXT       0008
DGRPVERS       0007
DGRPVER0       0007 00

This information is based on z/VM V6R2.0. Last updated on 21 Nov 2011 at 10:59:06 EDT.
Copyright IBM Corporation, 1990, 2011