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' FINAL RESPONSE INTERRUPT
              .1.. ....      VMCPRTY        X'40' PRIORITY MESSAGE
              .... .1..      VMCVMCF        X'04' VMCF RECORD (CP USE ONLY)
              .... ..1.      VMCHADR        X'02' VMCF LOOP SWITCH (CP USE
                                            ONLY)
              .... ...1      VMCRJCT        X'01' MESSAGE R ED
    0001    1 Bitstring    1 VMCEFLG        DATA TRANSFER RETURN CODE
              00000001       VMC01          1 INVALID VIRTUAL ADDRESS
              00000002       VMC02          2 INVALID SUB-FUNCTION CODE
              00000003       VMC03          3 PROTOCOL VIOLATION
              00000004       VMC04          4 USER NOT AUTHORIZED (SOURCE)
              00000005       VMC05          5 USER NOT AVAILABLE
              00000006       VMC06          6 PROTECTION VIOLATION
              00000007       VMC07          7 SENDX DATA TOO LARGE
              00000008       VMC08          8 DUPLICATE MESSAGE
              00000009       VMC09          9 TARGET VM QUIESCING
              0000000A       VMC10          10 MESSAGE LIMIT EXCEEDED
              0000000B       VMC11          11 CANCEL - REPLY CANCELLED
              0000000C       VMC12          12 MESSAGE NOT FOUND
              0000000D       VMC13          13 SYNCHRONIZATION ERROR
              0000000E       VMC14          14 CANCEL - TOO LATE
              0000000F       VMC15          15 PAGING I/O ERROR
              00000010       VMC16          16 INCORRECT LENGTH
              00000011       VMC17          17 DESTRUCTIVE OVERLAP
              00000012       VMC18          18 USER NOT AUTHORIZED PRIORITY
              00000013       VMC19          19 DATA TRANSFER ERROR
              00000014       VMC20          20 CANCEL - BUSY
    0002    2 Bitstring    2 VMCFUNC        SUB - FUNCTION CODE
              00000000       VMCPAUTH       00 AUTHORIZE
              00000001       VMCPUAUT       01 UN-AUTHORIZE
              00000002       VMCPSEND       02 SEND
              00000003       VMCPSENR       03 SEND/RECV
              00000004       VMCPSENX       04 SENDX
              00000005       VMCPRECV       05 RECEIVE
              00000006       VMCPCANC       06 CANCEL
              00000007       VMCPREPL       07 REPLY
              00000008       VMCPQUIE       08 QUIESCE
              00000009       VMCPRESM       09 RESUME
              0000000A       VMCPIDEN       10 IDENTIFY
              0000000B       VMCPRJCT       11 R
              0000000C       VMCPSETL       12 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' EXTERNAL INTERRUPT VMCBLOK
              .1.. ....      VMCCRECP       X'40' TRANSACTION PROCESSED
              ..1. ....      VMCCBUSY       X'20' VMCBLOK BUSY
    002E   46 Bitstring    1 VMCASTAT       VMCBLOK AUTHORIZATION STATUS
              1... ....      VMCAAUTS       X'80' AUTHORIZED SPECIFIC
              .1.. ....      VMCAPRTY       X'40' AUTHORIZED PRIORITY
              ..1. ....      VMCAQIES       X'20' USER QUIESCING
              ...1 ....      VMCASPEC       X'10' Blocks queued to non
                                            specific id
    002F   47 Bitstring    1 VMCSVMWT       Service Virtual Machine (SVM)
              1... ....      VMCEND         X'80' 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 V4R3.0. Last updated on 30 Apr 2002 at 18:38:10 EDT.
Copyright IBM Corporation, 1990, 2002