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' MRQ98ID Diagnose 98 ID
    0002    2 Bitstring    1 MRQFCN         FCN Field (Function Code)
              00000000       MRQLCK         X'00' MRQLCK Lock Subfunction
              00000004       MRQULCK        X'04' MRQULCK UnLock Subfunction
              00000020       MRQRELLK       X'20' MRQRELLK Release and Lock
                                            Subfunction
              00000004       MRQLFCN        MRQULCK MRQLFCN 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' MRQLOWLN Low bounds for
                                            Length
              00MRQLEN       MRQHILEN       X'1000' MRQHILEN 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 Signed       2 MRQMISC (0)    Alignment
    0014   20 Bitstring    1 *              Reserved for Future IBM Use
    0015   21 Bitstring    1 MRQPARM        Parameter Field
              00000001       MRQANY         X'01' MRQANY Lock anywhere
              00000002       MRQBELOW       X'02' MRQBELOW Lock below 2G
    0016   22 Signed       2 MRQRC          Request Return Code
              00000000       MRQROK         X'0000' MRQROK Request Completed
                                            OK
              00000001       MRQR1          X'0001' MRQR1 Reserved for Future
                                            IBM Use
              00000002       MRQRINVA       X'0002' MRQRINVA Invalid Guest
                                            ABS Address
              00000003       MRQRLOCK       X'0003' MRQRLOCK Page already
                                            Locked or Unlocked by a previous
                                            DIAG 98
              00000004       MRQRNOMV       X'0004' MRQRNOMV Page cannot be
                                            moved to lock
              00000005       MRQR5          X'0005' MRQR5 Reserved for Future
                                            IBM Use
              00000006       MRQR6          X'0006' MRQR6 Reserved for Future
                                            IBM Use
              00000007       MRQR7          X'0007' MRQR7 Reserved for Future
                                            IBM Use
              00000008       MRQRPERR       X'0008' MRQRPERR Paging Error
              00000009       MRQRNSHR       X'0009' MRQRNSHR Release of
                                            Shared Readable or or Exclusive
                                            Readable pages is not allowed
              0000000A       MRQRBDPM       X'000A' MRQRBDPM Invalid PARM
                                            value
              0000000B       MRQRNODS       X'000B' MRQRNODS Backing storage
                                            could not could not be
                                            disassociated
    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 |///////////////////////////|//////|:PARM |   MRQRC     |
    *     +---------------------------+------+------+-------------+
    *
    *** MRQFCNLK - Diagnose 98 Multiple Request Block

    MRQBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    MRQ$END        0010
    MRQ$EN2        0018
    MRQANY         0015 00000001
    MRQBELOW       0015 00000002
    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
    MRQMISC        0014
    MRQPARM        0015
    MRQRBDPM       0016 0000000A
    MRQRC          0016
    MRQRELLK       0002 00000020
    MRQREQ04       0000
    MRQRINVA       0016 00000002
    MRQRLOCK       0016 00000003
    MRQRNODS       0016 0000000B
    MRQRNOMV       0016 00000004
    MRQRNSHR       0016 00000009
    MRQROK         0016 00000000
    MRQRPERR       0016 00000008
    MRQR1          0016 00000001
    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 V6R1.0.
    Last updated on 18 Feb 2010 at 08:51:04 EDT.

    Copyright IBM Corporation, 1990, 2008