Programming Interface Information: This information is NOT intended to be
used as Programming Interfaces of z/VM.

ACTBK

Prolog
Control Block Contents
ACTBK DSECT
Storage Layout
Cross Reference

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

This information is based on z/VM V3R1.0.
Last updated on 29 Mar 2001 at 15:14:27 EDT.
Copyright IBM Corporation, 1990, 2001