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