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

#### DE4PL

Prolog

Control Block Contents
DE4PL DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### DE4PL Prolog

     NAME       : HCPDE4PL
     DESCRIPTION: DIAGNOSE X'E4' Parameter List
     DSECT      : DE4PL
     FUNCTION   : DE4PL maps the parameter list for DIAGNOSE
                  X'E4' requests
     LOCATED BY : DIAGNOSE-specified user register "RX"
     CREATED BY : a virtual machine
     DELETED BY : the creating virtual machine

#### DE4PL Control Block Content

#### DE4PL DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      DE4PL          DIAGNOSE X'E4' Parameter List
            DEVINFO layout for Diagnose X'E4' subcodes 00 and 01
                         Offset X'00'
    0000    0 Dbl-Word     8 DE4INPUT (0)   input fields begin here
    0000    0 Bitstring    4 DE4PLID        DIAGNOSE parameter list ID
    0004    4 Bitstring    2 DE4VDEV        virtual device number
    0006    6 Bitstring    2 *              (reserved)
                         Offset X'08'
    0008    8 Character    8 DE4USER        userid owning specified virtual
                                            device
    0010   16 Bitstring    1 DE4INX (0)     end of input
                         Offset X'10'
    0010   16 Signed       2 DE4OUTPT (0)   output fields begin here
    0010   16 Character    6 DE4VOLID       DASD volume label
    0016   22 Bitstring    2 DE4RDEV        real device number
                         Offset X'18'
    0018   24 Signed       4 DE4SCYL        starting minidisk cylinder/block
                                            #
    001C   28 Signed       4 DE4NCYL        number of minidisk
                                            cylinders/block
                         Offset X'20'
    0020   32 Bitstring    1 DE4INFO        DEVICE INFORMATION FLAG
              00000080       DE4INDED       X'80' THE REAL DEVICE ASSOCIATED
                                            WITH the virtual device is
                                            dedicated
              00000040       DE4INFPM       X'40' VIRTUAL DEVICE IS A
                                            FULL-PACK minidisk
              00000020       DE4INNOF       X'20' VIRTUAL DEVICE IS A
                                            NON-FULL PACK minidisk
              00000010       DE4INDVN       X'10' Devno defined full-pack
                                            minidisk
              00000008       DE4INPRM       X'08' Primary device of duplex
                                            pair
              00000004       DE4INSEC       X'04' Secondary device of duplex
                                            pair
    0021   33 Bitstring    1 *              (reserved)
    0022   34 Bitstring    2 DE4OVDEV       owning user's vdevno
    0024   36 Signed       4 *              (reserved)
                         Offset X'28'
    0028   40 Character    8 DE4OUSER       owning user's userid
    0030   48 Signed       2 DE4ENDBK (0)   end of block
              00000030       DE4SIZE        *-DE4PL size of DE4PL in bytes
            Redefinition for Diagnose X'E4' parameter list ID field
                         Offset X'00'
    0000    0 Bitstring    2 DE4CODE        DIAGNOSE code number
              000000E4       DE4DIAGC       X'00E4' DIAGNOSE X'E4' code
    0002    2 Bitstring    1 DE4FCTN        DIAGNOSE X'E4' subfunction code
              00000000       DE4UMLOG       X'00' DIAGNOSE X'E4': obtain
                                            minidisk real device information
                                            for logged-on user
              00000001       DE4UMDIR       X'01' DIAGNOSE X'E4': obtain real
                                            device information about a
                                            directory defined minidisk
              00000002       DE4FPOUV       X'02' DIAGNOSE X'E4': define a
                                            full pack overlay, given virtual
                                            address and USERID
              00000003       DE4FPORA       X'03' DIAGNOSE X'E4': define a
                                            full pack overlay, given rdevno &
                                            cyl/blk
    0003    3 Bitstring    1 DE4LENTH       size, in bytes, of this parmlist
            Redefinition for Diagnose X'E4' subcode 02 and 03
                         Offset X'04'
    0004    4 Bitstring    2 DE4UDEV        target users virtual device
                                            number
    0006    6 Bitstring    2 DE4NEWD        new FPO virtual device number
                         Offset X'08'
    0008    8 Character    8 DE4OWNR        userid owning target device
                         Offset X'10'
    0010   16 Bitstring    2 DE4MODE        access mode for link
    0012   18 Bitstring    1 DE4FPINX (0)   end of input
    0012   18 Bitstring    6 *              (reserved)
                         Offset X'18'
    0018   24 Signed       2 DE4FPOUT (0)   output fields begin here
    0018   24 Character    8 DE4ULINK       userid having link to minidisk
    0020   32 Signed       2 DE4FPEND (0)   end of FPO block
              00000020       DE4FPSIZ       *-DE4PL size of FPO block in
                                            bytes
            Redefinition for Diagnose X'E4' subcode 03
                         Offset X'04'
    0004    4 Bitstring    2 DE4DEVR        TARGET REAL DEVICE NUMBER
    0006    6 Bitstring    2 DE4NEWR        new FPO virtual device number
                         Offset X'08'
    0008    8 Bitstring    4 DE4EXTN        cylinder/block of real device
    000C   12 Bitstring    4 *              reserved

#### DE4PL Storage Layout

    *** DE4PL - DIAGNOSE X'E4' Parameter List
    *
    *     +---------------------------+-------------+-------------+
    *   0 |         DE4PLID           |  DE4VDEV    |/////////////|
    *     +---------------------------+-------------+-------------+
    *   8 |                       DE4USER                         |
    *     +-----------------------------------------+-------------+
    *  10 |                DE4VOLID                 |  DE4RDEV    |
    *     +---------------------------+-------------+-------------+
    *  18 |         DE4SCYL           |         DE4NCYL           |
    *     +------+------+-------------+---------------------------+
    *  20 |:INFO |//////|  DE4OVDEV   |///////////////////////////|
    *     +------+------+-------------+---------------------------+
    *  28 |                       DE4OUSER                        |
    *     +-------------------------------------------------------+
    *
    *** DE4PL - DIAGNOSE X'E4' Parameter List

    *** Overlay for DE4PLID in DE4PL
    *
    *     +-------------+------+------+
    *   0 |  DE4CODE    |:FCTN |:LENTH| 4
    *     +-------------+------+------+
    *
    *** Overlay for DE4PLID in DE4PL

    *** Overlay for DE4VDEV in DE4PL
    *
    *                                 +-------------+-------------+
    *   0 ...                       4 |  DE4UDEV    |  DE4NEWD    |
    *     +---------------------------+-------------+-------------+
    *   8 |                       DE4OWNR                         |
    *     +-------------+-----------------------------------------+
    *  10 |  DE4MODE    |/////////////////////////////////////////|
    *     +-------------+-----------------------------------------+
    *  18 |                       DE4ULINK                        |
    *     +-------------------------------------------------------+
    *
    *** Overlay for DE4VDEV in DE4PL

    *** Overlay for DE4VDEV in DE4PL
    *
    *                                 +-------------+-------------+
    *   0 ...                       4 |  DE4DEVR    |  DE4NEWR    |
    *     +---------------------------+-------------+-------------+
    *   8 |         DE4EXTN           |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  10
    *
    *** Overlay for DE4VDEV in DE4PL

#### DE4PL Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    DE4CODE        0000
    DE4DEVR        0004
    DE4DIAGC       0000 000000E4
    DE4ENDBK       0030
    DE4EXTN        0008
    DE4FCTN        0002
    DE4FPEND       0020
    DE4FPINX       0012
    DE4FPORA       0002 00000003
    DE4FPOUT       0018
    DE4FPOUV       0002 00000002
    DE4FPSIZ       0020 00000020
    DE4INDED       0020 00000080
    DE4INDVN       0020 00000010
    DE4INFO        0020
    DE4INFPM       0020 00000040
    DE4INNOF       0020 00000020
    DE4INPRM       0020 00000008
    DE4INPUT       0000
    DE4INSEC       0020 00000004
    DE4INX         0010
    DE4LENTH       0003
    DE4MODE        0010
    DE4NCYL        001C
    DE4NEWD        0006
    DE4NEWR        0006
    DE4OUSER       0028
    DE4OUTPT       0010
    DE4OVDEV       0022
    DE4OWNR        0008
    DE4PLID        0000
    DE4RDEV        0016
    DE4SCYL        0018
    DE4SIZE        0030 00000030
    DE4UDEV        0004
    DE4ULINK       0018
    DE4UMDIR       0002 00000001
    DE4UMLOG       0002 00000000
    DE4USER        0008
    DE4VDEV        0004
    DE4VOLID       0010

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