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

#### D29000

Prolog

Control Block Contents
D29000 DSECT
D29004 DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### D29000 Prolog

     NAME       : HCPD290P
     DESCRIPTION: Diagnose x'290' parameter block
     DSECT      : D29000
     FUNCTION   : The DSECTs in this copy file are the definitions of
                  the parameter blocks used as the interface to each
                  of the subcodes of Diagnose x'290'
     LOCATED BY : The "Rx" register contains the logical address of
                  the parameter block in guest storage at the time
                  Diagnose x'290' is issued.
     CREATED BY : The program issuing the Diagnose x'290'
     DELETED BY : The program issuing the Diagnose x'290'
     REFERENCES : None
     SERIALIZED : N/A
     NOTES      : Each DSECT in this
                  file has a version number field that should
                  be incremented if the DSECT changes in such
                  a way as to make migration an issue.
     NOTES      : The input parameter blocks described by these DSECTs
                  are fetched from the virtual machine's storage at
                  Diagnose x'290' initialization.

#### D29000 Control Block Content

#### D29000 DSECT

####

####

####

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      D29000         Diagnose x'290' parameter block
    0000    0 Bitstring    1 D29000VN       Version Number
    0001    1 Bitstring    1 D29000Q        Target file's spool queue
              .1.. ....      D29000PU       X'40' D29000PU File on punch
                                            queue
              ..1. ....      D29000PR       X'20' D29000PR File on printer
                                            queue
    0002    2 Signed       2 D29000ID       Target spool file ID
    0004    4 Signed       4 D29000PN       Relative page number of the data
                                            page the application expects is
                                            the active page in the open spool
                                            file; that is, the page where
                                            records are currently being
                                            written during creation of the
                                            file. The first data page in the
                                            file is page number 0. If the
                                            page number of the currently
                                            active page does not match this
                                            value, a non-zero return code is
                                            given. This mismatch can occur
                                            since new records may be written
                                            by the owner between the time the
                                            application determines the page
                                            number and when this diagnose
                                            executes.
    0008    8 Character    8 D29000UI       Owner of target spool file
    0010   16 Signed       8 D29000BA       64-bit guest real address of the
                                            output buffer where the data page
                                            contents should be stored. This
                                            buffer is in the same address
                                            space that contains the input
                                            parameter block and must start on
                                            a page boundary.
    0018   24 Signed       4 D29000BL       Output buffer length in bytes
    001C   28 Signed       4 D29000R1       Reserved for future IBM use
              00000004       D29000DW       (*-D29000+7)/8 Size of D29000 in
                                            double words
              00000020       D29000SZ       D29000DW*8 Size of D29000 in
                                            bytes
           Symbolic names for possible subcode x'0000' return codes
              00000004       D29000UIDNTLG  4 Target userid not logged on
              00000008       D29000SFDNTEX  8 Target spool file does not
                                            exist
              0000000C       D29000SFNTOPN  12 Target spool file not open
              00000010       D29000RBNTCUR  16 Requested block not current
                                            page
              00000014       D29000BFLNTVAL 20 Buffer length is not valid
              00000018       D29000BFADNT4K 24 Buffer address not on 4K
                                            boundary
              0000001C       D29000CPIOERR  28 CP paging or I/O error
                                            occurred
              00000020       D29000QNTVAL   32 Specified spool queue not
                                            valid
              00000024       D29000ESMFAIL  36 Authorization request failed

    D29004 DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      D29004         Diagnose x'290' parameter block
    0000    0 Bitstring    1 D29004VN       Version Number
    0001    1 Bitstring    1 D29004R1       Reserved for future IBM use
    0002    2 Signed       2 D29004DN       Target virtual device address
    0004    4 Bitstring    4 D29004R2       Reserved for future IBM use
    0008    8 Character    8 D29004UI       Owner of target virtual device
    0010   16 Signed       8 D29004BA       64-bit guest real address of the
                                            output buffer where the data page
                                            contents should be stored. This
                                            buffer is in the same address
                                            space that contains the input
                                            parameter block and must start on
                                            a page boundary.
    0018   24 Signed       4 D29004BL       Output buffer length in bytes
    001C   28 Signed       4 D29004R3       Reserved for future IBM use
              00000004       D29004DW       (*-D29004+7)/8 Size of D29004 in
                                            double words
              00000020       D29004SZ       D29004DW*8 Size of D29004 in
                                            bytes
           Symbolic names for possible subcode x'0004' return codes
              00000004       D29004UIDNTLG  4 Target userid not logged on
              00000008       D29004DEVNTEX  8 Target virt device does not
                                            exist
              0000000C       D29004DEVNTPRT 12 Target virt dev is not a
                                            printer
              00000010       D29004DEVNOXAB 16 Target virt dev has no XAB
                                            data
              00000014       D29004BFLNTVAL 20 Buffer length is not valid
              00000018       D29004BFADNT4K 24 Buffer address not on 4K
                                            boundary
              0000001C       D29004CPIOERR  28 CP paging or I/O error
                                            occurred
              00000024       D29004ESMFAIL  36 Authorization request failed

    D29000 Storage Layout

    *** D29000 - Diagnose x'290' parameter block
    *
    *     +------+------+-------------+---------------------------+
    *   0 |:000VN|:000Q |  D29000ID   |         D29000PN          |
    *     +------+------+-------------+---------------------------+
    *   8 |                       D29000UI                        |
    *     +-------------------------------------------------------+
    *  10 |                       D29000BA                        |
    *     +---------------------------+---------------------------+
    *  18 |         D29000BL          |         D29000R1          |
    *     +---------------------------+---------------------------+
    *  20
    *
    *** D29000 - Diagnose x'290' parameter block

    *** D29004 - Diagnose x'290' parameter block
    *
    *     +------+------+-------------+---------------------------+
    *   0 |:004VN|:004R1|  D29004DN   |         D29004R2          |
    *     +------+------+-------------+---------------------------+
    *   8 |                       D29004UI                        |
    *     +-------------------------------------------------------+
    *  10 |                       D29004BA                        |
    *     +---------------------------+---------------------------+
    *  18 |         D29004BL          |         D29004R3          |
    *     +---------------------------+---------------------------+
    *  20
    *
    *** D29004 - Diagnose x'290' parameter block

    D29000 Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    D29000BA       0010
    D29000BFADNT4K
                   001C 00000018
    D29000BFLNTVAL
                   001C 00000014
    D29000BL       0018
    D29000CPIOERR  001C 0000001C
    D29000DW       001C 00000004
    D29000ESMFAIL  001C 00000024
    D29000ID       0002
    D29000PN       0004
    D29000PR       0001 20
    D29000PU       0001 40
    D29000Q        0001
    D29000QNTVAL   001C 00000020
    D29000RBNTCUR  001C 00000010
    D29000R1       001C
    D29000SFDNTEX  001C 00000008
    D29000SFNTOPN  001C 0000000C
    D29000SZ       001C 00000020
    D29000UI       0008
    D29000UIDNTLG  001C 00000004
    D29000VN       0000
    D29004BA       0010
    D29004BFADNT4K
                   001C 00000018
    D29004BFLNTVAL
                   001C 00000014
    D29004BL       0018
    D29004CPIOERR  001C 0000001C
    D29004DEVNOXAB
                   001C 00000010
    D29004DEVNTEX  001C 00000008
    D29004DEVNTPRT
                   001C 0000000C
    D29004DN       0002
    D29004DW       001C 00000004
    D29004ESMFAIL  001C 00000024
    D29004R1       0001
    D29004R2       0004
    D29004R3       001C
    D29004SZ       001C 00000020
    D29004UI       0008
    D29004UIDNTLG  001C 00000004
    D29004VN       0000

    This information is
    based on z/VM V6R1.0.
    Last updated on 18 Feb 2010 at 08:37:03 EDT.

    Copyright IBM Corporation, 1990, 2008