NAME       : HCPQPXBK
 DESCRIPTION: Interface for POSIX ID query requests
 DSECT      : QPXBK
 FUNCTION   : Contain POSIX ID query specifications and
              responses, for Diagnose X'2A0'.
 LOCATED BY : none
 CREATED BY : HCPPXI (copied from/to guest storage)
 DELETED BY : HCPPXI
 SERIALIZED : CP's copy of the QPXBK is fetched by
              HCPVINOP into (VMDVOBUF).  This area
              is governed by instruction-stream
              serialization.
 RELOCATION CONSIDERATIONS : None

 QPXBK DSECT
Top of page

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      QPXBK          Interface for POSIX ID query requests
             Input fields common to all functions
0000    0 Dbl-Word     8 QPXHDR (0)     Beginning of the header section
0000    0 Signed       2 QPXDIAGC       Diagnose code eyecatcher
          QPXDIAGC       QPXDIAGV       X'02A0' QPXDIAGV Required value
                                        for QPXDIAGC
0002    2 Signed       2 QPXFCODE       Diagnose function code:
          00000000       QPXFPROC       0 QPXFPROC 0 = Query IDs for
                                        process
          00000001       QPXFUSER       1 QPXFUSER 1 = Query user
                                        database by UID or user name
          00000002       QPXFGRP        2 QPXFGRP 2 = Query group
                                        database by GID or group name
          00000003       QPXFSGID       3 QPXFSGID 3 = Query
                                        supplementary groups for self or
                                        by user name
          00000004       QPXFCONF       4 QPXFCONF 4 = Query
                                        configuration environment
0004    4 Signed       2 QPXDWLEN       Size of block in doublewords
0006    6 Bitstring    1 QPXFLAGS       Option flags:
          1... ....      QPXIDIN        X'80' QPXIDIN Input argument is
                                        an ID (PID, UID, or GID). Report
                                        on that id.
          .1.. ....      QPXNAMIN       X'40' QPXNAMIN Input argument is
                                        a name (UNAME or GNAME). Report
                                        the database info on that name.
                                        Meanings and legal combinations
                                        of above flags: - For function
                                        FPROC, QPXNAMIN must be zero. The
                                        report is on the current
                                        attributes of the requesting
                                        process if QPXIDIN=0, or of the
                                        process with process id QPXPID if
                                        QPXIDIN=1. - For functions
                                        FUSER/FGRP, exactly one of
                                        QPXNAMIN and QPXIDIN must be on.
                                        The report is on the database
                                        info for the designated id
                                        (QPXUID/GID) or name
                                        (QPXUNAME/GNAME). - For function
                                        FSGID, QPXIDIN must be zero. The
                                        report is on the current
                                        attributes of the requesting
                                        process if QPXNAMIN=0, or the
                                        database info on QPXUNAME if
                                        QPXNAMIN=1. "Database info" means
                                        the current contents of the
                                        on-line VM directory or ESM
                                        repository. (This may or may not
                                        match the attributes of a
                                        currently logged-on user.)
0007    7 Bitstring    1 QPXRSVD1       Reserved for IBM use
          00000008       QPXHDRL        *-QPXHDR Length of the header
                                        section
             QPXFCN's length will vary depend on the
             function code that was specified.
             (Notes      :  "I:", "O:", "IO:" designate fields used
             for input, output, or either, respectively.)
0008    8 Dbl-Word     8 QPXFCN (0)     Redefinition of the function
                                        unique data
             QPXFCN fields used for function QPXFPROC:
             ORG   QPXFCN         For function QPXFPROC:
0008    8 Signed       4 QPXPID         I: Process ID (PID) of target
                                        process, if QPXIDIN=1. Ignored if
                                        QPXIDIN=0.
000C   12 Signed       4 * (3)          Reserved for IBM use
0018   24 Signed       4 QPXRUID        O: Real UID of target process
001C   28 Signed       4 QPXRGID        O: Real GID of target process
0020   32 Signed       4 QPXEUID        O: Effective UID of target
                                        process
0024   36 Signed       4 QPXEGID        O: Effective GID of target
                                        process
0028   40 Signed       4 QPXSSUID       O: Saved set-UID of target
                                        process
002C   44 Signed       4 QPXSSGID       O: Saved set-GID of target
                                        process
          00000028       QPXF0DL        *-QPXFCN Length of function 0
                                        data
          00000030       QPXF0LEN       QPXF0DL+QPXHDRL Length of
                                        function 0 and header
          00000006       QPXF0SIZ       (QPXF0LEN+7)/8 Size of function 0
                                        QPXBK in DWs
             QPXFCN fields used for function QPXFUSER:
0008    8 Signed       4 QPXUID         IO: POSIX user ID (UID)
000C   12 Signed       4 QPXGID         O: POSIX group ID (GID)
0010   16 Character    8 QPXUNAME       IO: POSIX user name (VM userid)
0018   24 Character    8 QPXGNAME       O: POSIX group name
0020   32 Dbl-Word     8 QPXUDBPT (0)   I: Pointer to user DB info area
0020   32 Signed       4 QPXUDBAL       I: ALET for user DB info area
                                        (used only in XC AR mode)
0024   36 Address      4 QPXUDBAD       I: Addr of user DB info area
0028   40 Signed       4 QPXUDBSZ       I: Size of user database area
002C   44 Signed       4 *              Reserved for IBM use User
                                        database info area contains these
                                        outputs: - Initial working
                                        directory: four-byte string
                                        length (0-1023) followed by
                                        string - Initial user program
                                        name: four-byte string length
                                        (0-1023) followed by string -
                                        File-system root: four-byte
                                        string length (0-1023) followed
                                        by string - End-of-data indicator
                                        (X'FFFFFFFF'). String values not
                                        specified in the user's database
                                        entry are returned as null
                                        strings (length zero).
          00000028       QPXF1DL        *-QPXFCN Length of function 1
                                        data
          00000030       QPXF1LEN       QPXF1DL+QPXHDRL Length of
                                        function 1 and header
          00000006       QPXF1SIZ       (QPXF1LEN+7)/8 Size of function 1
                                        QPXBK in DWs
             QPXFCN fields used for function QPXFGRP:
0008    8 Signed       4 *              Reserved for IBM use
000C   12 Signed       4 *              (QPXGID) IO: POSIX group ID (GID)
0010   16 Character    8 *              Reserved for IBM use
0018   24 Character    8 *              (QPXGNAME) IO: POSIX group name
0020   32 Dbl-Word     8 QPXUNMPT (0)   I: Pointer to member name area:
0020   32 Signed       4 QPXUNMAL       I: ALET for member name area
                                        (used only in XC AR mode)
0024   36 Address      4 QPXUNMAD       I: Addr of member name area
          .... 1...      QPXUNMEL       8 QPXUNMEL Byte-length of one
                                        element in member-name list
          .... ..11      QPXUNMSH       3 QPXUNMSH Shift offset for
                                        QPXUNMEL
0028   40 Signed       4 QPXUNMSZ       I: Size of member name area in
                                        units of QPXUNMEL bytes
002C   44 Signed       4 QPXUNMCT       O: Actual number of members in
                                        group QPXUNMPT is used only if
                                        QPXUNMSZ^=0. When used, member
                                        name area contains as output an
                                        array of 8-character user names
                                        (VM userids) belonging to the
                                        designated group. The names are
                                        left-justified and padded with
                                        blanks.
          00000028       QPXF2DL        *-QPXFCN Length of function 2
                                        data
          00000030       QPXF2LEN       QPXF2DL+QPXHDRL Length of
                                        function 2 and header
          00000006       QPXF2SIZ       (QPXF2LEN+7)/8 Size of function 2
                                        QPXBK in DWs
             QPXFCN fields used for function QPXFSGID:
0008    8 Signed       4 * (2)          Reserved for IBM use
0010   16 Character    8 *              (QPXUNAME) I: POSIX user name (VM
                                        userid)
0018   24 Dbl-Word     8 *              Reserved for IBM use
0020   32 Dbl-Word     8 QPXGIDPT (0)   I: Pointer to SGID-list area:
0020   32 Signed       4 QPXGIDAL       I: ALET for SGID-list area (used
                                        only in XC AR mode)
0024   36 Address      4 QPXGIDAD       I: Address of SGID-list area
          .... .1..      QPXGIDEL       4 QPXGIDEL Byte-length of one
                                        element in SGID list
          .... ..1.      QPXGIDSH       2 QPXGIDSH Shift offset for
                                        QPXGIDEL
0028   40 Signed       4 QPXGIDSZ       I: Size of SGID-list area in
                                        units of QPXGIDEL bytes
002C   44 Signed       4 QPXGIDCT       O: Actual number of SGIDs stored
                                        The SGID list contains as output
                                        an array of 4-byte unsigned
                                        integers representing the
                                        supplementary groups belonging to
                                        the current process (when
                                        QPXNAMIN=0) or to the specified
                                        user (when QPXNAMIN=1).
          00000028       QPXF3DL        *-QPXFCN Length of function 3
                                        data
          00000030       QPXF3LEN       QPXF3DL+QPXHDRL Length of
                                        function 3 and header
          00000006       QPXF3SIZ       (QPXF3LEN+7)/8 Size of function 3
                                        QPXBK in DWs
             QPXFCN fields used for function QPXFCONF:
0008    8 Signed       4 QPXNGMAX       O: POSIX NGROUPS_MAX value
000C   12 Signed       4 QPXRSVD2       Reserved for IBM use
0010   16 Character    8 *              (QPXUNAME) O: POSIX user name
                                        (login name)
          00000010       QPXF4DL        *-QPXFCN Length of function 4
                                        data
          00000018       QPXF4LEN       QPXF4DL+QPXHDRL Length of
                                        function 4 and header
          00000003       QPXF4SIZ       (QPXF4LEN+7)/8 Size of function 4
                                        QPXBK in DWs
             The following equates define return codes from
             diagnose X'2A0'.  These values are passed back
             in register Ry.  These return codes apply to all
             functions unless a parenthesized list of applicable
             function names precedes the description.
          00000000       QPXEOK         0 Function succeeded
          00000001       QPXECODE       1 Incorrect value in QPXDIAGC
          00000002       QPXEFUNC       2 Invalid function code in
                                        QPXFCODE
          00000003       QPXELEN        3 Length in QPXDWLEN below
                                        minimum allowed
          00000004       QPXEFLAG       4 Invalid option flags in
                                        QPXFLAGS
          00000005       QPXEAUTH       5 Requestor not authorized to
                                        obtain information about other
                                        user or process
          00000006       QPXENFND       6 Search operand (ID or name) not
                                        found
          00000007       QPXEOLEN       7 (FUSER,FGRP,FSGID) Output
                                        buffer too small for response.
                                        Length required has been placed
                                        in Ry+1, QPXUNMCT, or QPXGIDCT,
                                        respectively
          00000008       QPXEOADR       8 (FUSER,FGRP,FSGID) Output
                                        buffer ALET or address is
                                        invalid, or designated storage
                                        area is protected
          00000009       QPXEDBAS       9 (FUSER,FGRP,FSGID) User or
                                        group database is invalid or
                                        inacces- sible (applies to FSGID
                                        only when QPXNAMIN=1)
          0000000A       QPXEPXCA       10 (FPROC,FUSER,FGRP,FSGID) POSIX
                                        communication area has not been
                                        defined
          0000000B       QPXEAPID       11 (FPROC,FUSER,FGRP,FSGID)
                                        Active PID in POSIX communication
                                        area is not a PID allocated to
                                        the requesting virtural
                                        configuration

          
*** QPXBK - Interface for POSIX ID query requests
*
*     +-------------+-------------+-------------+------+------+
*   0 |  QPXDIAGC   |  QPXFCODE   |  QPXDWLEN   |:FLAGS|:RSVD1|
*     +-------------+-------------+-------------+------+------+
*   8 |          QPXPID           |///////////////////////////|
*     +---------------------------+///////////////////////////|
*     |///////////////////////////////////////////////////////|
*     +---------------------------+---------------------------+
*  18 |         QPXRUID           |         QPXRGID           |
*     +---------------------------+---------------------------+
*  20 |         QPXEUID           |         QPXEGID           |
*     +---------------------------+---------------------------+
*  28 |         QPXSSUID          |         QPXSSGID          |
*     +---------------------------+---------------------------+
*  30
*
*** QPXBK - Interface for POSIX ID query requests
          
*** Overlay for QPXFCN in QPXBK
*
*     +---------------------------+---------------------------+
*   8 |          QPXUID           |          QPXGID           |
*     +---------------------------+---------------------------+
*  10 |                       QPXUNAME                        |
*     +-------------------------------------------------------+
*  18 |                       QPXGNAME                        |
*     +---------------------------+---------------------------+
*  20 |         QPXUDBAL          |         QPXUDBAD          |
*     +---------------------------+---------------------------+
*  28 |         QPXUDBSZ          |///////////////////////////|
*     +---------------------------+---------------------------+
*  30
*
*** Overlay for QPXFCN in QPXBK
          
*** Overlay for QPXFCN in QPXBK
*
*     +---------------------------+---------------------------+
*   8 |///////////////////////////|///////////////////////////|
*     +---------------------------+---------------------------+
*  10 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  18 |///////////////////////////////////////////////////////|
*     +---------------------------+---------------------------+
*  20 |         QPXUNMAL          |         QPXUNMAD          |
*     +---------------------------+---------------------------+
*  28 |         QPXUNMSZ          |         QPXUNMCT          |
*     +---------------------------+---------------------------+
*  30
*
*** Overlay for QPXFCN in QPXBK
          
*** Overlay for QPXFCN in QPXBK
*
*     +-------------------------------------------------------+
*   8 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  10 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  18 |///////////////////////////////////////////////////////|
*     +---------------------------+---------------------------+
*  20 |         QPXGIDAL          |         QPXGIDAD          |
*     +---------------------------+---------------------------+
*  28 |         QPXGIDSZ          |         QPXGIDCT          |
*     +---------------------------+---------------------------+
*  30
*
*** Overlay for QPXFCN in QPXBK
          
*** Overlay for QPXFCN in QPXBK
*
*     +---------------------------+---------------------------+
*   8 |         QPXNGMAX          |         QPXRSVD2          |
*     +---------------------------+---------------------------+
*  10 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  18
*
*** Overlay for QPXFCN in QPXBK

 
Symbol         Dspl Value
-------------- ---- -----
QPXDIAGC       0000
QPXDIAGV       0000 QPXDIAGC
QPXDWLEN       0004
QPXEAPID       0010 0000000B
QPXEAUTH       0010 00000005
QPXECODE       0010 00000001
QPXEDBAS       0010 00000009
QPXEFLAG       0010 00000004
QPXEFUNC       0010 00000002
QPXEGID        0024
QPXELEN        0010 00000003
QPXENFND       0010 00000006
QPXEOADR       0010 00000008
QPXEOK         0010 00000000
QPXEOLEN       0010 00000007
QPXEPXCA       0010 0000000A
QPXEUID        0020
QPXFCN         0008
QPXFCODE       0002
QPXFCONF       0002 00000004
QPXFGRP        0002 00000002
QPXFLAGS       0006
QPXFPROC       0002 00000000
QPXFSGID       0002 00000003
QPXFUSER       0002 00000001
QPXF0DL        002C 00000028
QPXF0LEN       002C 00000030
QPXF0SIZ       002C 00000006
QPXF1DL        002C 00000028
QPXF1LEN       002C 00000030
QPXF1SIZ       002C 00000006
QPXF2DL        002C 00000028
QPXF2LEN       002C 00000030
QPXF2SIZ       002C 00000006
QPXF3DL        002C 00000028
QPXF3LEN       002C 00000030
QPXF3SIZ       002C 00000006
QPXF4DL        0010 00000010
QPXF4LEN       0010 00000018
QPXF4SIZ       0010 00000003
QPXGID         000C
QPXGIDAD       0024
QPXGIDAL       0020
QPXGIDCT       002C
QPXGIDEL       0024 04
QPXGIDPT       0020
QPXGIDSH       0024 02
QPXGIDSZ       0028
QPXGNAME       0018
QPXHDR         0000
QPXHDRL        0007 00000008
QPXIDIN        0006 80
QPXNAMIN       0006 40
QPXNGMAX       0008
QPXPID         0008
QPXRGID        001C
QPXRSVD1       0007
QPXRSVD2       000C
QPXRUID        0018
QPXSSGID       002C
QPXSSUID       0028
QPXUDBAD       0024
QPXUDBAL       0020
QPXUDBPT       0020
QPXUDBSZ       0028
QPXUID         0008
QPXUNAME       0010
QPXUNMAD       0024
QPXUNMAL       0020
QPXUNMCT       002C
QPXUNMEL       0024 08
QPXUNMPT       0020
QPXUNMSH       0024 03
QPXUNMSZ       0028