MRQBK - 32-bit CP - V4R4.0

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
    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
    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
    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
    -------------- ---- -----
    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 V4R4.0.
    Last updated on 29 Jul 2003 at 15:52:16 EDT.

    Copyright IBM Corporation, 1990, 2003