About cookies on this site Our websites require some cookies to function properly (required). In addition, other cookies may be used with your consent to analyze site usage, improve the user experience and for advertising. For more information, please review your options. By visiting our website, you agree to our processing of information as described in IBM’sprivacy statement. To provide a smooth navigation, your cookie preferences will be shared across the IBM web domains listed here.
| MBHBK | Back to Index page |
|
Prolog Control Block Contents MBHBK DSECT MBHBF DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
|
| MBHBK Prolog | Top of page |
NAME : HCPMBHBK
DESCRIPTION: ISFC Message Buffer Header Block
DSECT : MBHBK
FUNCTION :
This structure defines the ISFC message for
socket function calls. The message buffer for a
single send or receive function may be defined as
one or more discontiguous fragments. A message
header (MBHBK) is a contiguous parameter list
formed by a single MBHDR followed by an array
of MBHBF structures.
LOCATED BY :
Various structures off of the SCKBK or through individual service
usage
CREATED BY :
HCPKCDCB or HCPKCDCX
DELETED BY :
HCPKCDDB
SERIALIZED :
There is no formal serialization for an MBHBK. It is
initialized by an SSI service, which gives up ownership of
the MBHBK when the HCPSOCK macro is invoked. The MBHBK,
including the buffers pointed to by the Buffer Fragment
Entries (MBHBF) are owned by ISFC until HCPSOCK returns.
Ownership of an MBHBK passes between the ISFC socket layer
and the ISFC link layer. Once the socket layer calls
HCPKCWTX to pass the MBHBK or its clone into the link layer
the MBHBK is owned by the link layer and CANNOT be
returned to the caller. The MBHBK is eligible to be
returned to the service when the MBHMP_RETURNOK flag is ON.
Reference to the MBHMP_RETURNOK flag is controlled by the
owning socket's SCKLKWRD.
RELOCATION CONSIDERATIONS : None
NOTES :
This structure describes an ISFC message. The
structure includes the following sections:
o Local processing fields.
o Message header (MBHDR for MBHDRLN bytes).
o Buffer Fragment List (MBHBUFCT copies of MBHBF).
The message header (MBHDR) includes the following
fields for every message:
MBHPROT (halfword) protocol
MBHFUNC (halfword) function code
MBHPARM (fullword) optional information
When MBHBFCT ==0 the message is contained entirely
within the MBHDR area (MBHFUNC and MBHPARM).
There is no associated buffer storage.
When MBHBFCT >0 the MBHBF array contains an entry
for each buffer fragment (MBHBUFCT indicates the
number of buffer fragments).
When the MBHBK is created, MBHBUFMX contains the
maximum number of buffer fragments defined in the
current structure. The MBHBK owner must set
MBHBUFCT to indicate the number of fragments active
at the moment.
|
| MBHBK Control Block Content | Top of page |
|
| MBHBK Storage Layout | Top of page |
*** MBHBK - ISFC Message Buffer Header Block
*
* +---------------------------+---------------------------+
* 0 | MBHFPNT | MBHBPNT |
* +------+------+-------------+---------------------------+
* 8 |MBHMGT|MBHMP | MBHBUFMX | MBHERRNO |
* +------+------+-------------+---------------------------+
* 10 | MBHTOD0 |
* +---------------------------+---------------------------+
* 18 | MBHPRMBK | MBHCLCNT |
* +---------------------------+---------------------------+
* 20 | MBHSNTCT | MBHREFCT |
* +---------------------------+---------------------------+
* 28 | MBHSCKBK | MBHMDEBK |
* +---------------------------+---------------------------+
* 30 | MBHCRTAD | MBHFREAD |
* +-------------+-------------+---------------------------+
* 38 | MBHTOCTR |/////////////| MBHMBBK |
* +-------------+-------------+---------------------------+
* 40 | MBHLINST |
* +------+------+-------------+---------------------------+
* 48 |:HDRLN|MBHFMT| MBHBUFCT | MBHMSGLN |
* +------+------+-------------+---------------------------+
* 50 |:CLASS|:OPTNS| MBHSEQNO | MBHMSGID |
* +------+------+-------------+---------------------------+
* 58 | MBHDNODE |
* +-------------------------------------------------------+
* 60 | MBHDPORT |
* +-------------------------------------------------------+
* 68 | MBHSNODE |
* +-------------------------------------------------------+
* 70 | MBHSPORT |
* +---------------------------+---------------------------+
* 78 | MBHDMASK | MBHSMASK |
* +-------------+-------------+---------------------------+
* 80 | MBHPROT | MBHFUNC | MBHPARM |
* +-------------+-------------+---------------------------+
* 88 |///////////////////////////////////////////////////////|
* |///////////////////////////+------+------+-------------+
* 90 |///////////////////////////|:PRIOR|//////|/////////////|
* +---------------------------+------+------+-------------+
*
*** MBHBK - ISFC Message Buffer Header Block
*** Overlay for MBHPARM in MBHBK
*
* +-------------+-------------+
* 80 ... 84 | MBHSEGNO | MBHSEGCT |
* +-------------+-------------+
* 88
*
*** Overlay for MBHPARM in MBHBK
*** MBHBF - ISFC Message Buffer Header Block
*
* +------+------+---------------------------+-------------+
* 0 |:BFFLG|:BFSTG|///////////////////////////| MBHBFLEN |
* +------+------+-------------+-------------+-------------+
* 8 | MBHBFPTH | MBHBFPTL |
* +---------------------------+---------------------------+
* 10
*
*** MBHBF - ISFC Message Buffer Header Block
|
| MBHBK Cross Reference | Top of page |
Symbol Dspl Value -------------- ---- ----- MBH_BFMAX 0086 00000080 MBH_BKMAX 0086 00000898 MBH_BREAK4KB 000C 00000008 MBH_CMP 0080 00000002 MBH_INVCLASS 000C 00000001 MBH_NOLINK 000C 00000002 MBH_NOPROT 0080 00000000 MBH_NOSOCK 000C 00000003 MBH_SOCK 0080 00000004 MBH_TIMEDOUT 000C 00000007 MBH_TOOLATE 000C 00000009 MBH_UNEXPECTED 000C 00000006 MBHBF$ 000C 00000010 MBHBFBAD 0000 80 MBHBFCFS 0001 00000003 MBHBFDNR 0000 40 MBHBFFLG 0000 MBHBFHAS 0001 00000002 MBHBFHLS 0001 00000001 MBHBFLEN 0006 MBHBFLN 000C 00000010 MBHBFPAG 0000 10 MBHBFPTH 0008 MBHBFPTL 000C MBHBFPTR 0008 MBHBFSTG 0001 MBHBFSZ 000C 00000002 MBHBFUSR 0000 20 MBHBK$ 0098 00000098 MBHBKLN 0098 00000098 MBHBKSZ 0098 00000013 MBHBPNT 0004 MBHBRD 0050 00000001 MBHBUFCT 004A MBHBUFMX 000A MBHCLASS 0050 MBHCLCNT 001C MBHCLONE 0008 40 MBHCMP_MAILBOX 0082 00000002 MBHCMP_SEND 0082 00000001 MBHCRTAD 0030 MBHDINFO 0058 MBHDMASK 0078 MBHDNODE 0058 MBHDPORT 0060 MBHDR 0048 MBHDR$ 0096 00000098 MBHDRLN 0096 00000050 MBHERRNO 000C MBHFMT 0049 MBHFMT01 0049 00000001 MBHFPNT 0000 MBHFREAD 0034 MBHFUNC 0082 MBHHDRLN 0048 MBHIMMED 0051 80 MBHLINST 0040 MBHLIST 0098 MBHMBBK 003C MBHMBX 0008 10 MBHMDEBK 002C MBHMGT 0008 MBHMP 0009 MBHMP_COMPLETE 0009 10 MBHMP_ERROR 0009 20 MBHMP_INBOUND 0009 80 MBHMP_INCCW 0009 08 MBHMP_KCWTO 0009 04 MBHMP_OUTBOUND 0009 40 MBHMP_RETURNOK 0009 02 MBHMSGID 0054 MBHMSGLN 004C MBHOPTNS 0051 MBHPARM 0084 MBHPASST 0008 20 MBHPCFN 0080 MBHPLX 0050 00000002 MBHPRIHI 0094 00000007 MBHPRILO 0094 00000000 MBHPRIMD 0094 00000007 MBHPRIML 0094 00000001 MBHPRIOR 0094 MBHPRMBK 0018 MBHPROT 0080 MBHREFCT 0024 MBHREPLY 0051 10 MBHSCKBK 0028 MBHSEGCT 0086 MBHSEGNO 0084 MBHSEQNO 0052 MBHSINFO 0068 MBHSMASK 007C MBHSNODE 0068 MBHSNTCT 0020 MBHSOCK_CLOSE 0082 00000003 MBHSOCK_CNACPT 0082 00000002 MBHSOCK_CNREQ 0082 00000001 MBHSOCK_LATE 0082 0000000A MBHSOCK_LINK 0082 00000009 MBHSOCK_NO 0082 00000005 MBHSOCK_NODESY 0082 00000006 MBHSOCK_TIMESY 0082 00000007 MBHSOCK_YES 0082 00000004 MBHSPORT 0070 MBHSTGMT 0008 80 MBHTOCTR 0038 MBHTOD0 0010 MBHUNI 0050 00000000 MBHWTREP 0051 20 |
Copyright IBM Corporation, 1990, 2020