|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
VMCBLOK
Control Block Contents
VMCBLOK DSECT
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
Copyright IBM Corporation, 1990, 2011