Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### CPRB0001

Prolog

Control Block Contents
CPRB0001 DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### CPRB0001 Prolog

NAME : CPRB DESCRIPTION: Connectivity Programming Request Block DSECT : CPRBxxxx FUNCTION : OBTAIN AND PARTIALLY INITIALIZE CPRB, OR CREATE DSECT INVOCATION : LABEL CPRB DSECT=YES/NO (LABEL) IS AN OPTIONAL LABEL (DSECT) SPECIFIES WHETHER TO GENERATE A DSECT (YES) OR OBTAIN A CPRB (NO)-- YES IS DEFAULT Operation : IF SPECIFIED WITH DSECT=NO, CPRB ATTEMPTS TO OBTAIN STORAGE FOR A CPRB AND, IF SUCCESSFUL, FILLS IN THE CONSTANT FIELDS OF IT. REG 1 IS SET TO THE ADDRESS OF THE RESULTING CPRB. IF DSECT=YES IS SPECIFIED OR DEFAULTS, A DSECT IS GENERATED DEFINING THE FIELDS OF THE CPRB. The Connectivity Programming Request Block contains information passed by a requester to the SRPI on entry to a server and information passed back from the server to the requester. The server can set some of the fields of the CPRB, and the system uses other fields, a path, and device or both. A buffer may be specified for the OPEN or QUERY functions, and the information will be stored in this buffer by the console function. CPRB is called by the CPRB macro.

#### CPRB0001 Control Block Content

#### CPRB0001 DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      CPRB0001       Connectivity Programming Request
                                            Block
    0000    0 Character  112 CPRB (0)       DEFINE TOTAL CPRB SPACE
    0000    0 Character    8 CRBHDR (0)     CPRB HEADER SECTION
    0000    0 Character    1 CRBF1          CPRB VERSION IDENTIFIER
    0001    1 Character    1 CRBFLAGS       RESERVED
              1... ....      CRBSINV        X'80' USED BY SYSTEM
    0002    2 Character    2 *              RESERVED
    0004    4 Character    4 CRBCPRB        CPRB SELF-IDENTIFIER FIELD
    0008    8 Character    8 CRBRTN (0)     CPRB RETURN CODE SECTION
    0008    8 Signed       4 CRBSRTNC       SERVER RETURN CODE
    000C   12 Signed       4 CRBCRTNC (0)   ECF RETURN CODE
    000C   12 Signed       2 CRBCRSNC       REASON CODE FIELD
    000E   14 Signed       2 CRBCRSPC       REPLY CODE FIELD
    0010   16 Character   24 CRBDESC (0)    CPRB DESCRIPTIVE SECTION
    0010   16 Character    8 CRBSNAME       SERVER NAME
    0018   24 Character    2 *              RESERVED
    001A   26 Signed       2 CRBFID         SERVER FUNCTION NUMBER
    001C   28 Character   12 *              RESERVED
    0028   40 Character   32 CRBPARMS (0)   CPRB PARAMETER SECTION
    0028   40 Signed       4 CRBRQDLN       REQUEST DATA AREA LENGTH
    002C   44 Address      4 CRBRQDAT       REQUEST DATA AREA ADDRESS
    0030   48 Signed       4 CRBRPDLN       REPLY DATA AREA LENGTH
    0034   52 Address      4 CRBRPDAT       REPLY DATA AREA ADDRESS
    0038   56 Signed       4 CRBRQPLN       REQUEST PARAMETER AREA LENGTH
    003C   60 Address      4 CRBRQPRM       REQUEST PARAMETER AREA ADDRESS
    0040   64 Signed       4 CRBRPPLN       REPLY PARAMETER AREA LENGTH
    0044   68 Address      4 CRBRPPRM       REPLY PARAMETER AREA ADDRESS
    0048   72 Character   40 CRBSYSTM (0)   CPRB SYSTEM SECTION
    0048   72 Character   16 CRBXPLST (0)   EXTENDED PLIST
    0048   72 Address      4 CRBXPNAM       POINTER TO SERVER NAME
    004C   76 Address      4 CRBXPBEG       BEGINNING OF ARGUMENTS
    0050   80 Address      4 CRBXPEND       END OF ARGUMENTS
    0054   84 Address      4 CRBXPCRB       POINTER TO CPRB
    0058   88 Signed       4 CRBMRDLN       MAXIMUM DATA AREA REPLY LENGTH
    005C   92 Signed       4 CRBMRPLN       MAXIMUM PARAMETER REPLY LENGTH
    0060   96 Character   16 CRBTPLST (0)   TOKENIZED PLIST
    0060   96 Character    8 CRBTPNAM       SERVER NAME
    0068  104 Character    8 CRBTPFNC       PLIST FENCE - ALL X'FF'
              00000070       CRBLEN         *-CPRB LENGTH OF CPRB
          END OF CPRB DUMMY SECTION - USER CODE MUST RE-ESTABLISH SECTION NAME

#### CPRB0001 Storage Layout

    *** CPRB0001 - Connectivity Programming Request Block
    *
    *     +------+------+-------------+---------------------------+
    *   0 |CRBF1 |:FLAGS|/////////////|         CRBCPRB           |
    *     +------+------+-------------+-------------+-------------+
    *   8 |         CRBSRTNC          |  CRBCRSNC   |  CRBCRSPC   |
    *     +---------------------------+-------------+-------------+
    *  10 |                       CRBSNAME                        |
    *     +-------------+-------------+---------------------------+
    *  18 |/////////////|   CRBFID    |///////////////////////////|
    *     +-------------+-------------+///////////////////////////|
    *     |///////////////////////////////////////////////////////|
    *     +---------------------------+---------------------------+
    *  28 |         CRBRQDLN          |         CRBRQDAT          |
    *     +---------------------------+---------------------------+
    *  30 |         CRBRPDLN          |         CRBRPDAT          |
    *     +---------------------------+---------------------------+
    *  38 |         CRBRQPLN          |         CRBRQPRM          |
    *     +---------------------------+---------------------------+
    *  40 |         CRBRPPLN          |         CRBRPPRM          |
    *     +---------------------------+---------------------------+
    *  48 |         CRBXPNAM          |         CRBXPBEG          |
    *     +---------------------------+---------------------------+
    *  50 |         CRBXPEND          |         CRBXPCRB          |
    *     +---------------------------+---------------------------+
    *  58 |         CRBMRDLN          |         CRBMRPLN          |
    *     +---------------------------+---------------------------+
    *  60 |                       CRBTPNAM                        |
    *     +-------------------------------------------------------+
    *  68 |                       CRBTPFNC                        |
    *     +-------------------------------------------------------+
    *  70
    *
    *** CPRB0001 - Connectivity Programming Request Block

#### CPRB0001 Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    CPRB           0000
    CRBCPRB        0004
    CRBCRSNC       000C
    CRBCRSPC       000E
    CRBCRTNC       000C
    CRBDESC        0010
    CRBFID         001A
    CRBFLAGS       0001
    CRBF1          0000
    CRBHDR         0000
    CRBLEN         0068 00000070
    CRBMRDLN       0058
    CRBMRPLN       005C
    CRBPARMS       0028
    CRBRPDAT       0034
    CRBRPDLN       0030
    CRBRPPLN       0040
    CRBRPPRM       0044
    CRBRQDAT       002C
    CRBRQDLN       0028
    CRBRQPLN       0038
    CRBRQPRM       003C
    CRBRTN         0008
    CRBSINV        0001 80
    CRBSNAME       0010
    CRBSRTNC       0008
    CRBSYSTM       0048
    CRBTPFNC       0068
    CRBTPLST       0060
    CRBTPNAM       0060
    CRBXPBEG       004C
    CRBXPCRB       0054
    CRBXPEND       0050
    CRBXPLST       0048
    CRBXPNAM       0048

This information is based on z/VM V5R2.0.
Last updated on 6 Dec 2005 at 15:36:36 EDT.
Copyright IBM Corporation, 1990, 2005