|
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. |
ACTBK
Cross Reference (Contains links to field and bit definitions)
ACTBK Prolog
NAME : HCPACTBK
DESCRIPTION: ISFC CP Application activation control block
STATUS : VM/ESA Version 2, Release 3.0
DSECT : ACTBK
FUNCTION : Hold information associated with the activation of
a specific CP application.
LOCATED BY : Activation table, PTHBK, CARBK.
CREATED BY : Activate function.
DELETED BY : Deactivate function marks it, mailbox releases it.
SERIALIZED : There are 3 distinct sections to the ACTBK,
and each of these sections is serialized differently:
1) The fields containing the application name, the
REGBK address, and the deliver address are static
for the life of the control block. These fields may be
read if no loss of control has occurred since a valid
pointer to the ACTBK was retrieved.
- Pointers to the ACTBK may be obtained
in three ways:
o By using HCPVERFY to verify an ACTBK handle.
o From the PTHACTBK pointer for a path associated
with this CP application.
o From a CARBK which is being dequeued from the
CP application input queue (HCPAAKIQ). This is
safe because deactivation processing will queue
the deactivate CARBK behind any transmit CARBKs
on this queue.
NOTE: This is dependent on a share of the ACTBK
lock being obtained after using HCPVERFY
to validate the ACTBK handle *WITHOUT AN
INTERVENING LOSS OF CONTROL*. This share
of the ACTBK lock must be held until after
the CARBK has been enqueued.
2) ACTCHILD contains pointers for the binary ACTBK
tree that are serialized by the activation table lock
(i.e., the lock defined in the BLEHD for the activation
table in HCPBDAAC).
3) The fields following the ACTLKWRD lockword are
serialized by that lockword (which we call the
ACTBK lock).
NOTES :
Reserved fields intentionally not defined.
Due to the various serialization sections in this
control block, reserved spaces have not been defined.
New fields must be defined in the proper section
of this control block based on the serialization on
that field.
In a pathless environment, path information for a CP
application is pointed to by the ACTBK. The ACTBK contains
lockwords and pointers to a chain of TRGBKs.
ACTBK
+---------------+
| |
| lockwords |
| |
| A(REGBK) |
| |
| A(TRGBK.1) ---------------------+
| | |
| | |
| | |
+---------------+ |
|
V
+------------+
| TRGBK.1 |
| |
| A(TRGBK.2)---->
+------------+ |
|
|
|
+------------+ |
| TRGBK.2 | <--
| |
| A(TRGBK.n)-->
+------------+ |
V
.
.
.
ACTBK Control Block Content
ACTBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure ACTBK ISFC CP Application activation control block Static for the life of the control block. NOTES : The fields in the static section are not locked and must not be changed once they have been initialized. 0000 0 Character 8 ACTAPPL Application name 0008 8 Address 4 ACTREGBK REGBK address 000C 12 Address 4 ACTDELIV Address of entry point End of static section. Controlled by the BLEHD table lock NOTES : These fields are serialized in the utilities that perform the BLEBK binary tree functions. 0010 16 Dbl-Word 8 ACTCHILD Binary tree pointers to children End of BLEHD-serialized section. Lock controls. NOTES : The following fields are serialized by ACTLKWRD. 0018 24 Dbl-Word 8 ACTLKWRD (3) Lockword for fields that follow 0030 48 Bitstring 8 ACTLKTRC Table lock trace values 0038 56 Bitstring 8 ACTTRGQ TRGBK queue 0040 64 Bitstring 1 ACTFLAG Flags 1... .... ACTDEACT X'80' Application has been deactivated End of ACTLKWRD-serialized section. 00000009 ACTSIZE (*-ACTBK+7)/8 Size, in doublewords, of ACTBK
ACTBK Storage Layout
*** ACTBK - ISFC CP Application activation control block * * +-------------------------------------------------------+ * 0 | ACTAPPL | * +---------------------------+---------------------------+ * 8 | ACTREGBK | ACTDELIV | * +---------------------------+---------------------------+ * 10 | ACTCHILD | * +-------------------------------------------------------+ * 18 | | * = ACTLKWRD = * | | * +-------------------------------------------------------+ * 30 | ACTLKTRC | * +-------------------------------------------------------+ * 38 | ACTTRGQ | * +------+------------------------------------------------+ * 40 |:FLAG | 41 * +------+ * *** ACTBK - ISFC CP Application activation control block
ACTBK Cross Reference
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----ACTAPPL 0000
ACTCHILD 0010
ACTDEACT 0040 80
ACTDELIV 000C
ACTFLAG 0040
ACTLKTRC 0030
ACTLKWRD 0018
ACTREGBK 0008
ACTSIZE 0040 00000009
ACTTRGQ 0038
Last updated on 3 Aug 1999 at 11:38:34 EDT.
Copyright IBM Corporation, 1990, 1999