Programming Interface Information:
This page documents intended Programming Interfaces that
allow the customer to write programs to obtain the services of z/VM.

VMCPARM

Prolog  

Control Block Contents  
   VMCPARM DSECT

Storage Layout  

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' VMCPAUTS AUTHORIZE SPECIFIC
                                        REQUEST
          .1.. ....      VMCPPRTY       X'40' VMCPPRTY PRIORITY MESSAGE
          ..1. ....      VMCPSMSG       X'20' VMCPSMSG RECEIVING SPECIAL
                                        MESSAGES
0001    1 Bitstring    1 *              RESERVED FOR FUTURE IBM USE
0002    2 Bitstring    2 VMCPFUNC       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 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

This information is based on z/VM V6R1.0. Last updated on 18 Feb 2010 at 09:28:10 EDT.
Copyright IBM Corporation, 1990, 2008