ACTBK Back to Index page
 
Prolog 
Control Block Contents 
   ACTBK DSECT
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.


  ACTBK Prolog Top of page
 
 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).
 RELOCATION CONSIDERATIONS : None
 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 Top of page
 

 ACTBK DSECT Top of page
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 Deliver routine address 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' ACTDEACT Application has been deactivated End of ACTLKWRD-serialized section. 00000009 ACTSIZE (*-ACTBK+7)/8 Size, in doublewords, of ACTBK
 
 
  ACTBK Storage Layout Top of page
 
          
*** 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 Top of page
 
 
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
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:47:04 EDT.
Copyright IBM Corporation, 1990, 2022