|
Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only. |
VMCBLOK
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 EQU X'20' SPECIAL MESSAGES FLAG - RESERVED .... .1.. VMCVMCF X'04' VMCF RECORD (CP USE ONLY) .... ..1. VMCHADR X'02' VMCF LOOP SWITCH (CP USE ONLY) .... ...1 VMCRJCT X'01' MESSAGE REJECTED 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 REJECT 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
(contains links to field and bit definitions)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
Last updated on 3 Aug 1999 at 13:52:36 EDT.
Copyright IBM Corporation, 1990, 1999