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

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 V3R1.0.
Last updated on 30 Mar 2001 at 09:20:55 EDT.
Copyright IBM Corporation, 1990, 2001