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 V4R3.0.
Last updated on 1 May 2002 at 14:12:04 EDT.
Copyright IBM Corporation, 1990, 2002