DGRPM - 64-bit CP - V4R4.0

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
     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' 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 V4R4.0. Last updated on 30 Jul 2003 at 12:40:26 EDT.
Copyright IBM Corporation, 1990, 2003