|
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 - 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
Last updated on 10 Sep 2004 at 08:05:35 EDT.
Copyright IBM Corporation, 1990, 2004