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)
 RELOCATION CONSIDERATIONS : None

 

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 V6R2.0. Last updated on 21 Nov 2011 at 11:36:56 EDT.
Copyright IBM Corporation, 1990, 2011