VMCMHDR Back to Index page
 
Prolog 
Control Block Contents 
   VMCMHDR DSECT
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This page documents intended Programming Interfaces that
allow the customer to write programs to obtain the services of z/VM.


  VMCMHDR Prolog Top of page
 
 NAME       : VMCMHDR
 DESCRIPTION: VMCF COMMUNICATION MESSAGE HEADER
 DSECT      : VMCMHDR
 FUNCTION   : VMCMHDR PROVIDES INFORMATION TO IDENTIFY THE SPECIAL
              VMCF EXTERNAL INTERRUPTS.
 LOCATED BY : XMCMHDR   FIELD IN MODULE HCPRET
              RECVMCHA  FIELD IN MODULE HCPREC
              VMCVADA   FIELD IN VMCBLOCK
              VMCPVADA  FIELD IN VMCPARM
 CREATED BY : HCPREC (FOR CP VMCF COMMUNICATION)
              A VIRTUAL MACHINE INVOKING VMCF
 DELETED BY : A VIRTUAL MACHINE
 RELOCATION CONSIDERATIONS : None
 
 
  VMCMHDR Control Block Content Top of page
 

 VMCMHDR DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure VMCMHDR VMCF COMMUNICATION MESSAGE HEADER 0000 0 Bitstring 1 VMCMSTAT MESSAGE STATUS BYTE 1... .... VMCMRESP X'80' VMCMRESP FINAL RESPONSE INTERRUPT .1.. .... VMCMRJCT X'40' VMCMRJCT MESSAGE REJECTED ..1. .... VMCMPRTY X'20' VMCMPRTY PRIORITY MESSAGE 0001 1 Bitstring 1 VMCMEFLG 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 VMCMFUNC SUB-FUNCTION CODE (ORIGINAL REQ) 00000002 VMCMSEND 2 VMCMSEND SEND 00000003 VMCMSENR 3 VMCMSENR SEND/RECV 00000004 VMCMSENX 4 VMCMSENX SENDX 0000000A VMCMIDEN 10 VMCMIDEN IDENTIFY 0004 4 Signed 4 VMCMMID MESSAGE IDENTIFIER 0008 8 Dbl-Word 8 VMCMUSER SOURCE / SINK USERID (VMUSER) 0010 16 Signed 4 VMCMVADA VIRTUAL BUFFER ADDRESS 0014 20 Signed 4 VMCMLENA MESSAGE LENGTH 0018 24 Signed 4 VMCMVADB VIRTUAL REPLY BUFFER ADDRESS 001C 28 Signed 4 VMCMLENB REPLY BUFFER LENGTH 0020 32 Dbl-Word 8 VMCMUSE (0) USER SUPPLIED DOUBLE-WORD 0020 32 Signed 2 VMCMUSPC USER SUPPLIED PROTOCOL 0022 34 Bitstring 6 * REST OF USER SUPPLIED DOUBLE-WORD THE FOLLOWING FIELD IS OPTIONAL AND EXISTS ONLY IN THE CASE OF SENDX PROTOCOL. 0028 40 Character 1 VMCMBUF (0) START OF VARIABLE LENGTH DATA 00000028 VMCMLEN (*-VMCMHDR) LENGTH OF VMCMHDR (BYTES) GENERAL VM COMMUNICATION EQUATES 00000032 VMCSMAX 50 MAXIMUM ACTIVE MESSAGE LIMIT 00004001 VMCXCODE X'4001' VMCF EXTERNAL INTERRUPT CODE .... ...1 VMCXMASK X'0001' VMCF CR0 EXTERNAL INTERRUPT MASK
 
 
  VMCMHDR Storage Layout Top of page
 
 
*** VMCMHDR - VMCF COMMUNICATION MESSAGE HEADER
*
*     +------+------+-------------+---------------------------+
*   0 |:MSTAT|:MEFLG|  VMCMFUNC   |         VMCMMID           |
*     +------+------+-------------+---------------------------+
*   8 |                       VMCMUSER                        |
*     +---------------------------+---------------------------+
*  10 |         VMCMVADA          |         VMCMLENA          |
*     +---------------------------+---------------------------+
*  18 |         VMCMVADB          |         VMCMLENB          |
*     +-------------+-------------+---------------------------+
*  20 |  VMCMUSPC   |/////////////////////////////////////////|
*     +-------------+-----------------------------------------+
*
*** VMCMHDR - VMCF COMMUNICATION MESSAGE HEADER
 
 
  VMCMHDR Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
VMCMBUF        0028
VMCMEFLG       0001
VMCMFUNC       0002
VMCMIDEN       0002 0000000A
VMCMLEN        0028 00000028
VMCMLENA       0014
VMCMLENB       001C
VMCMMID        0004
VMCMPRTY       0000 20
VMCMRESP       0000 80
VMCMRJCT       0000 40
VMCMSEND       0002 00000002
VMCMSENR       0002 00000003
VMCMSENX       0002 00000004
VMCMSTAT       0000
VMCMUSE        0020
VMCMUSER       0008
VMCMUSPC       0020
VMCMVADA       0010
VMCMVADB       0018
VMCSMAX        0028 00000032
VMCXCODE       0028 00004001
VMCXMASK       0028 01
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 6.4.0 Last updated on 24 Aug 2016 at 09:46:32 EDT.
Copyright IBM Corporation, 1990, 2016