ACTBK

Prolog  

Control Block Contents  
   ACTBK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  

ACTBK Prolog

 NAME       : HCPACTBK
 DESCRIPTION: ISFC CP Application activation control block
 COPYRIGHT -
              THIS MODULE IS "RESTRICTED MATERIALS OF IBM"
              5654-A17 (C) COPYRIGHT IBM CORP. - 1995, 2001
              LICENSED MATERIALS - PROPERTY OF IBM
 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