ACTBK - 32-bit CP - V4R4.0

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 (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

This information is based on z/VM V4R4.0. Last updated on 29 Jul 2003 at 15:11:42 EDT.
Copyright IBM Corporation, 1990, 2003