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

MRQBK

Prolog  

Control Block Contents  
   MRQBK DSECT
   MRQFCNLK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


MRQBK Prolog

 NAME       : HCPMRQBK
 DESCRIPTION: Diagnose 98 Multiple Request Block
 DSECT      : MRQBK
 FUNCTION   :
              Used by a virtual machine when invoking a CP Diagnose
              98 (Subfunction x'10') Multiple Block Request.
              The Diagnose 98 Multiple Request Block is used by the
              program to specify multiple occurrences of a single
              Diagnose 98 Subfunction to CP for execution.  The
              Diagnose 98 Multiple Request Block is a self defining
              control block, which is divided into two sections.
              The first section called the Diagnose 98 Multiple
              Request Block Fixed Header is used to define the
              control block, provide parameters, and a response
              area, which is global to the entire request.  The fix
              header section is common for all Block Diagnose 98
              Requests.
              The second section of the Diagnose 98 Multiple Request
              Block is a variable size area, which contains an array
              of Diagnose 98 Subfunction requests.  The actual
              number of requests within the array is determined by
              CP from the LENGTH and FCN fields specified in the
              Fixed Header of the Diagnose 98 Multiple Request
              Block.  The data within an array entry is determined
              by the FCN code specified.
 CREATED BY : A virtual machine which invokes Diagnose 98.
 DELETED BY : The creating virtual machine.

 

MRQBK Control Block Content


MRQBK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      MRQBK          Diagnose 98 Multiple Request
                                        Block
0000    0 Bitstring   16 MRQFH (0)      MRQ Fixed Header
0000    0 Signed       2 MRQID          ID Field of the Control Block
          00000098       MRQ98ID        X'0098' Diagnose 98 ID
          00000000       *
0002    2 Bitstring    1 MRQFCN         FCN Field (Function Code)
          00000000       MRQLCK         X'00' Lock Subfunction
          00000004       MRQULCK        X'04' UnLock Subfunction
          00000004       MRQLFCN        MRQULCK Last Valid Subfunction
          00000000       *
0003    3 Bitstring    1 *              Reserved for Future IBM Use
0004    4 Signed       2 *              Reserved for Future IBM Use
0006    6 Signed       2 MRQLEN         LENGTH Field (size of block)
          ..1. 1...      MRQLOWLN       X'28' Low bounds for Length
          00MRQLEN       MRQHILEN       X'1000' High bounds for Length
0008    8 Dbl-Word     8 *              Reserved for Future IBM Use
          00000010       MRQSREQ        * Start of Variable Request Area
0010   16 Bitstring    1 MRQ$END (0)    The end of the fixed header
     Notes : The following assembler equates are defined and can be used but
     do not appear in the control block expansion because they are in the
     PLX section and PRINT OFF, NOGEN is in effect.
     -------------- Start of Lock/Unlock Request ***************-

MRQFCNLK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      MRQFCNLK       Diagnose 98 Multiple Request
                                        Block
0000    0 Bitstring   24 MRQREQ04 (0)   MRQ Lock/Unlock Request
0000    0 Dbl-Word     8 MRQGABS (0)    Guest Absolute Address
0000    0 Signed       4 *
0004    4 Address      4 MRQGAB31       Guest Absolute Address AMODE31
0008    8 Dbl-Word     8 MRQHABS (0)    Host Absolute Address
0008    8 Signed       4 *
000C   12 Address      4 MRQHAB31       Host Absolute Address AMODE31
0010   16 Signed       4 *              Reserved for Future IBM Use
0014   20 Bitstring    1 * (2)          Reserved for Future IBM Use
0016   22 Signed       2 MRQRC          Request Return Code
          00000000       MRQROK         X'0000' Request Completed OK
          00000001       MRQR1          X'0001' Reserved for Future IBM
                                        Use
          00000002       MRQRINVA       X'0002' Invalid Guest ABS Address
          00000003       MRQRLOCK       X'0003' Page already Locked or
                                        Unlocked by a previous DIAG 98
          00000004       MRQR4          X'0004' Reserved for Future IBM
                                        Use
          00000005       MRQR5          X'0005' Reserved for Future IBM
                                        Use
          00000006       MRQR6          X'0006' Reserved for Future IBM
                                        Use
          00000007       MRQR7          X'0007' Reserved for Future IBM
                                        Use
          00000008       MRQRPERR       X'0008' Paging Error
          00000000       *
0018   24 Bitstring    1 MRQ$EN2 (0)    The end of Lock/Unlock Request
     Notes : The following assembler equates are defined and can be used but
     do not appear in the control block expansion because they are in the
     PLX section and PRINT OFF, NOGEN is in effect.
     Global Return Code Equates
          .... ....      MRQGOK         X'0000' All Requests Completed OK
          .... ...1      MRQGWNG        X'0001' Some Requests Failed
          .... ..1.      MRQGNREQ       X'0002' Subfuntion Not Required
          .... ..11      MRQGAM24       X'0003' VM is in AMODE 24
          .... .1..      MRQG370        X'0004' VM is in 370 Mode
          .... .1.1      MRQGIID        X'0005' Invalid ID Field Value
          .... .11.      MRQGIFCN       X'0006' Invalid FCN Field Value
          .... .111      MRQGILEN       X'0007' Invalid LENGTH Field
                                        Value

 

MRQBK Storage Layout

          
*** MRQBK - Diagnose 98 Multiple Request Block
*
*     +-------------+------+------+-------------+-------------+
*   0 |   MRQID     |MRQFCN|//////|/////////////|   MRQLEN    |
*     +-------------+------+------+-------------+-------------+
*   8 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*
*** MRQBK - Diagnose 98 Multiple Request Block
          
*** MRQFCNLK - Diagnose 98 Multiple Request Block
*
*     +---------------------------+---------------------------+
*   0 |///////////////////////////|         MRQGAB31          |
*     +---------------------------+---------------------------+
*   8 |///////////////////////////|         MRQHAB31          |
*     +---------------------------+-------------+-------------+
*  10 |///////////////////////////|/////////////|   MRQRC     |
*     +---------------------------+-------------+-------------+
*
*** MRQFCNLK - Diagnose 98 Multiple Request Block

 

MRQBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
*              0000 00000000
*              0002 00000000
*              0016 00000000
MRQ$END        0010
MRQ$EN2        0018
MRQFCN         0002
MRQFH          0000
MRQGABS        0000
MRQGAB31       0004
MRQGAM24       0018 03
MRQGIFCN       0018 06
MRQGIID        0018 05
MRQGILEN       0018 07
MRQGNREQ       0018 02
MRQGOK         0018 00
MRQGWNG        0018 01
MRQG370        0018 04
MRQHABS        0008
MRQHAB31       000C
MRQHILEN       0006 00MRQLEN
MRQID          0000
MRQLCK         0002 00000000
MRQLEN         0006
MRQLFCN        0002 00000004
MRQLOWLN       0006 28
MRQRC          0016
MRQREQ04       0000
MRQRINVA       0016 00000002
MRQRLOCK       0016 00000003
MRQROK         0016 00000000
MRQRPERR       0016 00000008
MRQR1          0016 00000001
MRQR4          0016 00000004
MRQR5          0016 00000005
MRQR6          0016 00000006
MRQR7          0016 00000007
MRQSREQ        0008 00000010
MRQULCK        0002 00000004
MRQ98ID        0000 00000098

This information is based on z/VM V4R1.0.
Last updated on 5 Jun 2001 at 14:27:23 EDT.
Copyright IBM Corporation, 1990, 2001