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

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

This information is based on z/VM V3R1.0.
Last updated on 30 Mar 2001 at 09:21:04 EDT.
Copyright IBM Corporation, 1990, 2001