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' 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 V5R2.0. Last updated on 12 Apr 2006 at 17:43:17 EDT.
Copyright IBM Corporation, 1990, 2005