Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be
used for diagnosis only.
|
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 (contains links to field and bit definitions)
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 VM/ESA 2.4.0.
Last updated on 12 Aug 1999 at 13:04:49 EDT.
Copyright IBM Corporation, 1990, 1999
|
