|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
CPRB0001
Control Block Contents
CPRB0001 DSECT
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 - Control Block in CPRB0001
*
* +------+------+-------------+---------------------------+
* 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 - Control Block in CPRB0001
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
Last updated on 28 Jul 2003 at 08:13:26 EDT.
Copyright IBM Corporation, 1990, 2003