|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
CMPBK
Control Block Contents
CMPBK DSECT
Cross Reference (Contains links to field and bit definitions)
CMPBK Prolog
NAME : HCPCMPBK
DESCRIPTION: Component Id Block
COPYRIGHT -
THIS MODULE IS "RESTRICTED MATERIALS OF IBM"
5654-030 (C) COPYRIGHT IBM CORP. - 1995
LICENSED MATERIALS - PROPERTY OF IBM
SEE COPYRIGHT INSTRUCTIONS, G120-2083
DSECT : CMPBK
FUNCTION : The Component Id Block is used by customers and
vendors as an anchor for whatever they want.
LOCATED BY : XCTBK.XCTCMPAD
CMPBK.CMPFWD
CREATED BY : HCPZXCAC, called by HCPXSERV ALLOCATE
DELETED BY : HCPZXCDC, called by HCPXSERV DEALLOCATE
REFERENCES : None
SERIALIZED : Changes to the chain of CMPBKs are typically done
by HCPZXU under the exclusive lock XCTCMPLK.
Searches of the chain of CMPBKs are typically done
by HCPZXU under the shared lock XCTCMPLK.
Changes to the contents of CMPBKs are typically done
under the control of user code. The CMPBKLK is
provided for serialization to the contents of the CMPBK.
Control over the CMPBKLK should be by means of the
HCPXSERV macro operands LOCKEXCL, LOCKSHR, etc.
CMPBK Control Block Content
CMPBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure CMPBK Component Id Block
The IBM fields should remain at the front of the block
0000 0 Dbl-Word 8 CMPBKLK (3) Lock word to serialize access to
this CMPBK
0018 24 Address 4 CMPFWD Address of the next CMPBK
001C 28 Signed 1 CMPEXTNQ Size of extension at CMPEXTND in
Number of Quad-words. The maximum
allowed value for CMPEXTNQ is
240, which gives a maximum size
for a CMPBK of
x'60' + 240*16 = 3936 bytes
which allows for a little growth up to 4072 bytes.
001D 29 Character 3 CMPID The component Id
0020 32 Character 8 * Reserved for IBM use
0028 40 Character 8 * Reserved for IBM use
0030 48 Character 8 * Reserved for IBM use
0038 56 Character 8 * Reserved for IBM use
The user fields should remain at the end of the block
0040 64 Dbl-Word 8 CMPUSRD1 Reserved for non-IBM use
0048 72 Dbl-Word 8 CMPUSRD2 Reserved for non-IBM use
0050 80 Signed 4 CMPUSRF1 Reserved for non-IBM use
0054 84 Signed 4 CMPUSRF2 Reserved for non-IBM use
0058 88 Signed 2 CMPUSRH1 Reserved for non-IBM use
005A 90 Signed 2 CMPUSRH2 Reserved for non-IBM use
005C 92 Bitstring 1 CMPUSRX1 Reserved for non-IBM use
005D 93 Bitstring 1 CMPUSRX2 Reserved for non-IBM use
005E 94 Bitstring 1 CMPUSRX3 Reserved for non-IBM use
005F 95 Bitstring 1 CMPUSRX4 Reserved for non-IBM use
0060 96 Dbl-Word 8 CMPEXTND (0) Start of variable length data The
CMPBK may be extended at
allocation time in units of
quad-words (16 bytes)
00000060 CMPBSIZE *-CMPBK Size of CMPBK in bytes
0000000C CMPSIZE (*-CMPBK+7)/8 Size in double
words
CMPBK Storage Layout
*** CMPBK - Component Id Block
*
* +-------------------------------------------------------+
* 0 | |
* = CMPBKLK =
* | |
* +---------------------------+------+--------------------+
* 18 | CMPFWD |:EXTNQ| CMPID |
* +---------------------------+------+--------------------+
* 20 |///////////////////////////////////////////////////////|
* +-------------------------------------------------------+
* 28 |///////////////////////////////////////////////////////|
* +-------------------------------------------------------+
* 30 |///////////////////////////////////////////////////////|
* +-------------------------------------------------------+
* 38 |///////////////////////////////////////////////////////|
* +-------------------------------------------------------+
* 40 | CMPUSRD1 |
* +-------------------------------------------------------+
* 48 | CMPUSRD2 |
* +---------------------------+---------------------------+
* 50 | CMPUSRF1 | CMPUSRF2 |
* +-------------+-------------+------+------+------+------+
* 58 | CMPUSRH1 | CMPUSRH2 |:USRX1|:USRX2|:USRX3|:USRX4|
* +-------------+-------------+------+------+------+------+
*
*** CMPBK - Component Id Block
CMPBK Cross Reference
Symbol Dspl Value -------------- ---- ----- CMPBKLK 0000 CMPBSIZE 0060 00000060 CMPEXTND 0060 CMPEXTNQ 001C CMPFWD 0018 CMPID 001D CMPSIZE 0060 0000000C CMPUSRD1 0040 CMPUSRD2 0048 CMPUSRF1 0050 CMPUSRF2 0054 CMPUSRH1 0058 CMPUSRH2 005A CMPUSRX1 005C CMPUSRX2 005D CMPUSRX3 005E CMPUSRX4 005F
Copyright IBM Corporation, 1990, 2002