|
Programming Interface Information:
This page documents intended Programming
Interfaces that allow the customer to write programs to obtain the services of z/VM. |
VMCPARM
Control Block Contents
VMCPARM DSECT
Cross Reference (Contains links to field and bit definitions)
VMCPARM Prolog
NAME : VMCPARM
DESCRIPTION: VMCF COMMUNICATIONS PARAMETER LIST
DSECT : VMCPARM
FUNCTION : VMCPARM CONTAINS THE USER-SUPPLIED PARAMETERS WHEN A
VMCF SUBFUNCTION IS EXECUTED.
LOCATED BY : RECVMCPA FIELD IN MODULE HCPREC
XMCPARM FIELD IN MODULE HCPRET
RX REGISTER OF A DIAGNOSE X'68' INSTRUCTION
CREATED BY : HCPREC FOR VMCF
A VIRTUAL MACHINE (FOR VMCF)
DELETED BY : A VIRTUAL MACHINE (FOR VMCF)
VMCPARM Control Block Content
VMCPARM DSECT
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure VMCPARM VMCF COMMUNICATIONS PARAMETER
LIST
0000 0 Bitstring 1 VMCPFLG1 VMCPARM FLAG BYTE
1... .... VMCPAUTS X'80' AUTHORIZE SPECIFIC REQUEST
.1.. .... VMCPPRTY X'40' PRIORITY MESSAGE
..1. .... VMCPSMSG X'20' RECEIVING SPECIAL MESSAGES
0001 1 Bitstring 1 * RESERVED FOR FUTURE IBM USE
0002 2 Bitstring 2 VMCPFUNC 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 VMCPMID MESSAGE IDENTIFIER
0008 8 Dbl-Word 8 VMCPUSER TARGET USERID
0010 16 Signed 4 VMCPVADA VADDR OF MESSAGE BUFFER
0014 20 Signed 4 VMCPLENA LENGTH OF MESSAGE
0018 24 Signed 4 VMCPVADB VADDR OF REPLY BUFFER (SEND/RECV
ONLY)
001C 28 Signed 4 VMCPLENB LENGTH OF REPLY BUFFER (SEND/RECV
ONLY)
0020 32 Dbl-Word 8 VMCPUSE USER SUPPLIED DOUBLE-WORD
00000028 VMCPLEN (*-VMCPARM) LENGTH OF VMCPARM
(BYTES)
0004 4 Character 4 VMCPITYP RETRIEVE ACCOUNTING OR EREP RECDS
(IDENTIFY ONLY)
VMCPARM Storage Layout
*** VMCPARM - VMCF COMMUNICATIONS PARAMETER LIST
*
* +------+------+-------------+---------------------------+
* 0 |:PFLG1|//////| VMCPFUNC | VMCPMID |
* +------+------+-------------+---------------------------+
* 8 | VMCPUSER |
* +---------------------------+---------------------------+
* 10 | VMCPVADA | VMCPLENA |
* +---------------------------+---------------------------+
* 18 | VMCPVADB | VMCPLENB |
* +---------------------------+---------------------------+
* 20 | VMCPUSE |
* +-------------------------------------------------------+
* 28
*
*** VMCPARM - VMCF COMMUNICATIONS PARAMETER LIST
*** Overlay for VMCPMID in VMCPARM
*
* +---------------------------+
* 0 ... 4 | VMCPITYP |
* +---------------------------+
* 8
*
*** Overlay for VMCPMID in VMCPARM
VMCPARM Cross Reference
Symbol Dspl Value -------------- ---- ----- VMCPAUTH 0002 00000000 VMCPAUTS 0000 80 VMCPCANC 0002 00000006 VMCPFLG1 0000 VMCPFUNC 0002 VMCPIDEN 0002 0000000A VMCPITYP 0004 VMCPLEN 0020 00000028 VMCPLENA 0014 VMCPLENB 001C VMCPMID 0004 VMCPPRTY 0000 40 VMCPQUIE 0002 00000008 VMCPRECV 0002 00000005 VMCPREPL 0002 00000007 VMCPRESM 0002 00000009 VMCPRJCT 0002 0000000B VMCPSEND 0002 00000002 VMCPSENR 0002 00000003 VMCPSENX 0002 00000004 VMCPSETL 0002 0000000C VMCPSMSG 0000 20 VMCPUAUT 0002 00000001 VMCPUSE 0020 VMCPUSER 0008 VMCPVADA 0010 VMCPVADB 0018
Last updated on 5 Jun 2001 at 17:26:49 EDT.
Copyright IBM Corporation, 1990, 2001