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

#### VMCBLOK

Prolog

Control Block Contents
VMCBLOK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### VMCBLOK Prolog

     NAME       : VMCBLOK
     DESCRIPTION: VMCF COMMUNICATIONS BLOCK
     DSECT      : VMCBLOK
     FUNCTION   : VMCBLOK CONTAINS DATA TRANSFER AND STATUS INFORMATION
                  USED BY THE VIRTUAL MACHINE CONFIGURATION FACILITY (VMCF).
     LOCATED BY : VMCFPNT   FIELD OF VMCBLOK (POINTER TO NEXT VMCBLOK)
                  VMDVMCB   FIELD OF HCPVMDBK
     CREATED BY : HCPVMC (TO HANDLE VMCF FUNCTIONS)
     DELETED BY : HCPVMC (VMCF PROCESSING)

#### VMCBLOK Control Block Content

#### VMCBLOK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      VMCBLOK        VMCF COMMUNICATIONS BLOCK
    0000    0 Bitstring    1 VMCSTAT        VMCBLOK USER STATUS
              1... ....      VMCRESP        X'80' VMCRESP FINAL RESPONSE
                                            INTERRUPT
              .1.. ....      VMCPRTY        X'40' VMCPRTY PRIORITY MESSAGE
              .... .1..      VMCVMCF        X'04' VMCVMCF VMCF RECORD (CP USE
                                            ONLY)
              .... ..1.      VMCHADR        X'02' VMCHADR VMCF LOOP SWITCH
                                            (CP USE ONLY)
              .... ...1      VMCRJCT        X'01' VMCRJCT MESSAGE REJECTED
    0001    1 Bitstring    1 VMCEFLG        DATA TRANSFER RETURN CODE
              00000001       VMC01          1 VMC01 INVALID VIRTUAL ADDRESS
              00000002       VMC02          2 VMC02 INVALID SUB-FUNCTION CODE
              00000003       VMC03          3 VMC03 PROTOCOL VIOLATION
              00000004       VMC04          4 VMC04 USER NOT AUTHORIZED
                                            (SOURCE)
              00000005       VMC05          5 VMC05 USER NOT AVAILABLE
              00000006       VMC06          6 VMC06 PROTECTION VIOLATION
              00000007       VMC07          7 VMC07 SENDX DATA TOO LARGE
              00000008       VMC08          8 VMC08 DUPLICATE MESSAGE
              00000009       VMC09          9 VMC09 TARGET VM QUIESCING
              0000000A       VMC10          10 VMC10 MESSAGE LIMIT EXCEEDED
              0000000B       VMC11          11 VMC11 CANCEL - REPLY CANCELLED
              0000000C       VMC12          12 VMC12 MESSAGE NOT FOUND
              0000000D       VMC13          13 VMC13 SYNCHRONIZATION ERROR
              0000000E       VMC14          14 VMC14 CANCEL - TOO LATE
              0000000F       VMC15          15 VMC15 PAGING I/O ERROR
              00000010       VMC16          16 VMC16 INCORRECT LENGTH
              00000011       VMC17          17 VMC17 DESTRUCTIVE OVERLAP
              00000012       VMC18          18 VMC18 USER NOT AUTHORIZED
                                            PRIORITY
              00000013       VMC19          19 VMC19 DATA TRANSFER ERROR
              00000014       VMC20          20 VMC20 CANCEL - BUSY
    0002    2 Bitstring    2 VMCFUNC        SUB - FUNCTION CODE
              00000000       VMCPAUTH       00 VMCPAUTH AUTHORIZE
              00000001       VMCPUAUT       01 VMCPUAUT UN-AUTHORIZE
              00000002       VMCPSEND       02 VMCPSEND SEND
              00000003       VMCPSENR       03 VMCPSENR SEND/RECV
              00000004       VMCPSENX       04 VMCPSENX SENDX
              00000005       VMCPRECV       05 VMCPRECV RECEIVE
              00000006       VMCPCANC       06 VMCPCANC CANCEL
              00000007       VMCPREPL       07 VMCPREPL REPLY
              00000008       VMCPQUIE       08 VMCPQUIE QUIESCE
              00000009       VMCPRESM       09 VMCPRESM RESUME
              0000000A       VMCPIDEN       10 VMCPIDEN IDENTIFY
              0000000B       VMCPRJCT       11 VMCPRJCT REJECT
              0000000C       VMCPSETL       12 VMCPSETL SETLIMIT
    0004    4 Signed       4 VMCMID         MESSAGE IDENTIFIER
    0008    8 Dbl-Word     8 VMCUSER        SOURCE / SINK USERID (VMUSER)
    0010   16 Signed       4 VMCVADA        VADDR OF MESSAGE BUFFER
    0014   20 Signed       4 VMCLENA        LENGTH OF MESSAGE
    0018   24 Signed       4 VMCVADB        VADDR OF REPLY BUFFER (SEND /
                                            RECV ONLY)
    001C   28 Signed       4 VMCLENB        LENGTH OF REPLY BUFFER (SEND /
                                            RECV ONLY)
    0020   32 Dbl-Word     8 VMCUSE         USER SUPPLIED DOUBLE-WORD
    0028   40 Signed       4 VMCFPNT        ADDRESS OF NEXT VMCBLOK
    002C   44 Bitstring    1 VMCKEY         USER PSW KEY
    002D   45 Bitstring    1 VMCCSTAT       VMCBLOK CONTROL STATUS
              1... ....      VMCCXINT       X'80' VMCCXINT EXTERNAL INTERRUPT
                                            VMCBLOK
              .1.. ....      VMCCRECP       X'40' VMCCRECP TRANSACTION
                                            PROCESSED
              ..1. ....      VMCCBUSY       X'20' VMCCBUSY VMCBLOK BUSY
    002E   46 Bitstring    1 VMCASTAT       VMCBLOK AUTHORIZATION STATUS
              1... ....      VMCAAUTS       X'80' VMCAAUTS AUTHORIZED
                                            SPECIFIC
              .1.. ....      VMCAPRTY       X'40' VMCAPRTY AUTHORIZED
                                            PRIORITY
              ..1. ....      VMCAQIES       X'20' VMCAQIES USER QUIESCING
              ...1 ....      VMCASPEC       X'10' VMCASPEC Blocks queued to
                                            non specific id
    002F   47 Bitstring    1 VMCSVMWT       Service Virtual Machine (SVM)
              1... ....      VMCEND         X'80' VMCEND transaction end flag
    0030   48 Dbl-Word     8 VMCTOD         Time of Day clock value - AUTH
              00000007       VMCBSIZE       (*-VMCBLOK)/8 SIZE OF VMCBLOK
                                            (DOUBLEWORDS)
    0002    2 Signed       2 VMCACNT        ACTIVE MESSAGE COUNT
    0004    4 Signed       4 VMCTRGCT       SINK MESSAGE COUNT
    001C   28 Signed       2 VMCPCNT        Number of processors in virtual
                                            MP complex (i.e., in local cyclic
                                            list) that are VMCF authorized
    001E   30 Signed       2 VMCMSGLM       Header (Master/Slave) VMCBLOK
                                            MESSAGE LIMIT
                Miscellaneous Equates
              00004001       VMCFINTC       X'4001' VM -> VM VMCF
                                            INTERRUPT CODE

#### VMCBLOK Storage Layout

    *** VMCBLOK - VMCF COMMUNICATIONS BLOCK
    *
    *     +------+------+-------------+---------------------------+
    *   0 |:STAT |:EFLG |  VMCFUNC    |          VMCMID           |
    *     +------+------+-------------+---------------------------+
    *   8 |                       VMCUSER                         |
    *     +---------------------------+---------------------------+
    *  10 |         VMCVADA           |         VMCLENA           |
    *     +---------------------------+---------------------------+
    *  18 |         VMCVADB           |         VMCLENB           |
    *     +---------------------------+---------------------------+
    *  20 |                        VMCUSE                         |
    *     +---------------------------+------+------+------+------+
    *  28 |         VMCFPNT           |VMCKEY|:CSTAT|:ASTAT|:SVMWT|
    *     +---------------------------+------+------+------+------+
    *  30 |                        VMCTOD                         |
    *     +-------------------------------------------------------+
    *  38
    *
    *** VMCBLOK - VMCF COMMUNICATIONS BLOCK

    *** Overlay for VMCFUNC in VMCBLOK
    *
    *                   +-------------+
    *   0 ...         2 |  VMCACNT    | 4
    *                   +-------------+
    *
    *** Overlay for VMCFUNC in VMCBLOK

    *** Overlay for VMCMID in VMCBLOK
    *
    *                                 +---------------------------+
    *   0 ...                       4 |         VMCTRGCT          |
    *                                 +---------------------------+
    *   8
    *
    *** Overlay for VMCMID in VMCBLOK

    *** Overlay for VMCLENB in VMCBLOK
    *
    *                                 +-------------+-------------+
    *  18 ...                      1C |  VMCPCNT    |  VMCMSGLM   |
    *                                 +-------------+-------------+
    *  20
    *
    *** Overlay for VMCLENB in VMCBLOK

#### VMCBLOK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    VMCAAUTS       002E 80
    VMCACNT        0002
    VMCAPRTY       002E 40
    VMCAQIES       002E 20
    VMCASPEC       002E 10
    VMCASTAT       002E
    VMCBSIZE       0030 00000007
    VMCCBUSY       002D 20
    VMCCRECP       002D 40
    VMCCSTAT       002D
    VMCCXINT       002D 80
    VMCEFLG        0001
    VMCEND         002F 80
    VMCFINTC       001E 00004001
    VMCFPNT        0028
    VMCFUNC        0002
    VMCHADR        0000 02
    VMCKEY         002C
    VMCLENA        0014
    VMCLENB        001C
    VMCMID         0004
    VMCMSGLM       001E
    VMCPAUTH       0002 00000000
    VMCPCANC       0002 00000006
    VMCPCNT        001C
    VMCPIDEN       0002 0000000A
    VMCPQUIE       0002 00000008
    VMCPRECV       0002 00000005
    VMCPREPL       0002 00000007
    VMCPRESM       0002 00000009
    VMCPRJCT       0002 0000000B
    VMCPRTY        0000 40
    VMCPSEND       0002 00000002
    VMCPSENR       0002 00000003
    VMCPSENX       0002 00000004
    VMCPSETL       0002 0000000C
    VMCPUAUT       0002 00000001
    VMCRESP        0000 80
    VMCRJCT        0000 01
    VMCSTAT        0000
    VMCSVMWT       002F
    VMCTOD         0030
    VMCTRGCT       0004
    VMCUSE         0020
    VMCUSER        0008
    VMCVADA        0010
    VMCVADB        0018
    VMCVMCF        0000 04
    VMC01          0001 00000001
    VMC02          0001 00000002
    VMC03          0001 00000003
    VMC04          0001 00000004
    VMC05          0001 00000005
    VMC06          0001 00000006
    VMC07          0001 00000007
    VMC08          0001 00000008
    VMC09          0001 00000009
    VMC10          0001 0000000A
    VMC11          0001 0000000B
    VMC12          0001 0000000C
    VMC13          0001 0000000D
    VMC14          0001 0000000E
    VMC15          0001 0000000F
    VMC16          0001 00000010
    VMC17          0001 00000011
    VMC18          0001 00000012
    VMC19          0001 00000013
    VMC20          0001 00000014

This information is based on z/VM V6R1.0. Last updated on 18 Feb 2010 at 09:28:06 EDT.
Copyright IBM Corporation, 1990, 2008