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
 COMPATIBILITY AND MIGRATION CONCERNS : 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.
 RELOCATION CONSIDERATIONS : None
 NOTES      : The input parameter blocks described by these DSECTs
              are fetched from the virtual machine's storage at
              Diagnose x'290' initialization.

 D29000 DSECT
Top of page

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
Top of page

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 - 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

 
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