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

#### DAPPC

Prolog

Control Block Contents
DAPPC DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### DAPPC Prolog

     NAME       : HCPDAPPC
     DESCRIPTION: Directory APPCPASS Security Parameter Block
     DSECT      : DAPPC
     FUNCTION   : To preserve information from the "APPCPASS"
                  directory control statement.  There will be
                  one DAPPC block created for each "APPCPASS"
                  statement in the source directory.
                  OR - To request security parameters (userid and its
                  password) from the "APPCPASS" statement in the
                  source directory by providing the locally_known_
                  LU name.
                  OR - To request security parameter (user's password)
                  from the "APPCPASS" statement in the source
                  directory by providing the locally_known_LU name
                  and the userid.
     LOCATED BY : Fields DVMDADAS and DVMDADSP in DVMD
                  Fields DAPPDASD and DAPPDISP in DAPPC
                  GPR2 in HCPIUPCO
                  GPR2 in HCPUDRAP
     CREATED BY : HCPDIR, HCPIUPCO
     DELETED BY : HCPDIR, HCPIUPCO
     SERIALIZED : 1. The directory lock (SYSDRLOK) is acquired
                  in exclusive mode for DIRECTXA processing.
                  2. The directory lock (SYSDRLOK) is acquired
                  in shared mode by HCPUDRAP to copy the
                  DAPPUSER and DAPPPASS fields.
     NOTES      : 1. DAPPLPWD is the actual length of the variable length
                  password (1-8 bytes) in DAPPPASS.
                  2. DAPPPASS is an encrypted version of the password
                  with the same length.

#### DAPPC Control Block Content

#### DAPPC DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      DAPPC          Directory APPCPASS Security
                                            Parameter Block
    0000    0 Signed       4 DAPPDASD       DASD address of next DAPPC CCPV
                                            for CKD DASD addresses PPPV for
                                            FBA DASD addresses
    0004    4 Signed       2 DAPPDISP       Displacement of next DAPPC
    0006    6 Bitstring    1 DAPPLPWD       Actual length of the password
    0007    7 Bitstring    1 *              Reserved for future IBM use
    0008    8 Character   16 DAPPLKLU (0)   Locally_known_LU name
    0008    8 Character    8 DAPPGLU        Gateway_LU name
    0010   16 Character    8 DAPPGKLU       Gateway_known_LU name
    0018   24 Character    8 DAPPUSER       Target userid
    0020   32 Character    8 DAPPPASS       Target password (encrypted)
              00000005       DAPPSIZE       (*-DAPPC+7)/8 DAPPC size in DW's
              00000028       DAPPLEN        (*-DAPPC) DAPPC size in bytes

#### DAPPC Storage Layout

    *** DAPPC - Directory APPCPASS Security Parameter Block
    *
    *     +---------------------------+-------------+------+------+
    *   0 |         DAPPDASD          |  DAPPDISP   |:PLPWD|//////|
    *     +---------------------------+-------------+------+------+
    *   8 |                       DAPPGLU                         |
    *     +-------------------------------------------------------+
    *  10 |                       DAPPGKLU                        |
    *     +-------------------------------------------------------+
    *  18 |                       DAPPUSER                        |
    *     +-------------------------------------------------------+
    *  20 |                       DAPPPASS                        |
    *     +-------------------------------------------------------+
    *  28
    *
    *** DAPPC - Directory APPCPASS Security Parameter Block

#### DAPPC Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    DAPPDASD       0000
    DAPPDISP       0004
    DAPPGKLU       0010
    DAPPGLU        0008
    DAPPLEN        0020 00000028
    DAPPLKLU       0008
    DAPPLPWD       0006
    DAPPPASS       0020
    DAPPSIZE       0020 00000005
    DAPPUSER       0018

This information is based on z/VM V5R2.0. Last updated on 12 Apr 2006 at 16:47:20 EDT.
Copyright IBM Corporation, 1990, 2005