Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
ACTBK
Control Block Contents
ACTBK DSECT
Cross Reference (Contains links to field and bit definitions)
ACTBK Prolog
NAME : HCPACTBK DESCRIPTION: ISFC CP Application activation control block 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
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
Copyright IBM Corporation, 1990, 2001