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 V4R2.0. Last updated on 17 Oct 2001 at 15:02:46 EDT.
Copyright IBM Corporation, 1990, 2001