D29000 Back to Index page
 
Prolog 
Control Block Contents 
   D29000 DSECT
   D29004 DSECT
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.


  D29000 Prolog Top of page
 
 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 Control Block Content Top of page
 

 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 Storage Layout Top of page
 
          
*** 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 Top of page
 
 
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 7.3.0 Last updated on 22 Jun 2022 at 15:50:08 EDT.
Copyright IBM Corporation, 1990, 2022