Dynamically Managing Kernel Clients and Adabas Contexts

Direct clients are clients that process Adabas calls on the current Kernel. Relay clients are clients that relay to other Kernels to process Adabas calls on those Kernels. Using Entire Net-Work you can dynamically manage the direct and relay clients of a Kernel. You can also view statistical information about clients and contexts.

Adabas contexts are memory tokens that associate clients and Adabas databases and are used for Adabas session identification and statistics purposes.

This document covers the following topics:


Listing Kernel Clients and Adabas Contexts

Start of instruction setTo dynamically list the clients and Adabas contexts of a Kernel:

Make sure you have accessed the System Management Hub and that the Kernel is started. For complete information about starting Kernels, read Starting a Kernel.

  1. Select the name of the managed host on which Entire Net-Work Server is installed.

  2. Expand the tree-view frame for the managed host by clicking on the plus sign (+) to the left of its name.

  3. Select "Entire Net-Work Server" in the tree-view under the managed host.

    The Entire Net-Work Server administration area of the System Management Hub becomes available to you.

  4. Expand Kernels in tree-view, by clicking on the plus sign (+) to the left of its label.

    The list of started Kernels appears.

    Note:
    If the Kernel you need is not listed, it is not started. You must start the Kernel before you can proceed with these instructions. Read Starting a Kernel for more information.

  5. Expand Clients in tree-view, by clicking on the plus sign (+) to the left of its label.

    The client and Adabas context definitions for the Kernel are listed in categories in tree-view. Three categories are listed: Direct Clients, Adabas Contexts, and Relay Clients.

  6. Expand the appropriate category (Direct Clients, Adabas Contexts, or Relay Clients) in tree-view, by clicking on the plus sign (+) to the left of its label.

    The client or Adabas context definitions for the category you selected are listed in tree-view.

Viewing Kernel Client and Adabas Context Statistics

To activate this feature, set the STATISTICS_DETAILS parameter to "YES" on the Kernel Advanced Parameters screen.

Start of instruction setTo dynamically view statistics for a Kernel client or Adabas context:

Make sure you have accessed the System Management Hub and that the Kernel is started. For complete information about starting Kernels, read Starting a Kernel.

  1. Select the name of the managed host on which Entire Net-Work Server is installed.

  2. Expand the tree-view frame for the managed host by clicking on the plus sign (+) to the left of its name.

  3. Select "Entire Net-Work Server" in the tree-view under the managed host.

    The Entire Net-Work Server administration area of the System Management Hub becomes available to you.

  4. Expand Kernels in tree-view, by clicking on the plus sign (+) to the left of its label.

    The list of started Kernels appears.

    Note:
    If the Kernel you need is not listed, it is not started. You must start the Kernel before you can proceed with these instructions. Read Starting a Kernel for more information.

  5. Expand Clients in tree-view, by clicking on the plus sign (+) to the left of its label.

    The client and Adabas context definitions for the Kernel are listed in categories in tree-view. Three categories are listed: Direct Clients, Adabas Contexts, and Relay Clients.

    • Direct Clients: Direct clients are clients directly connected to this node. These clients are included in Entire Net-Work counts for currently active clients and are the clients covered by the license agreement (so they are counted against the maximum number of clients that can be used by this Kernel).

    • Adabas Contexts: Adabas contexts are memory tokens that associate clients and Adabas databases and are used for Adabas session identification and statistics purposes.

    • Relay Clients: Relay clients are clients connected through another node. These clients are included in Entire Net-Work counts for currently active clients, but are not counted against the maximum number of clients that can be used by this Kernel.

  6. Expand the appropriate category (Direct Clients, Adabas Contexts, or Relay Clients) in tree-view, by clicking on the plus sign (+) to the left of its label.

    The client or Adabas context definitions for the category you selected are listed in tree-view.

  7. Click on the client or Adabas context name whose statistics you wish to view.

    A panel appears in detail-view listing statistics about the client or Adabas context.

Dynamically Disconnecting Kernel Clients

Start of instruction setTo dynamically disconnect a direct or relay client of a Kernel:

Make sure you have accessed the System Management Hub and that the Kernel is started. For complete information about starting Kernels, read Starting a Kernel.

  1. Select the name of the managed host on which Entire Net-Work Server is installed.

  2. Expand the tree-view frame for the managed host by clicking on the plus sign (+) to the left of its name.

  3. Select "Entire Net-Work Server" in the tree-view under the managed host.

    The Entire Net-Work Server administration area of the System Management Hub becomes available to you.

  4. Expand Kernels in tree-view, by clicking on the plus sign (+) to the left of its label.

    The list of started Kernels appears.

    Note:
    If the Kernel you need is not listed, it is not started. You must start the Kernel before you can proceed with these instructions. Read Starting a Kernel for more information.

  5. Expand Clients in tree-view, by clicking on the plus sign (+) to the left of its label.

    The client and Adabas context definitions for the Kernel are listed in categories in tree-view. Three categories are listed: Direct Clients, Adabas Contexts, and Relay Clients.

  6. Expand either the Direct Clients or Relay Clients category in tree-view, by clicking on the plus sign (+) to the left of its label.

    The client definitions for the category you selected are listed in tree-view.

  7. Right-click on the name of the client you wish to disconnect and select Disconnect from the resulting drop-down menu.

    A panel appears in detail-view requesting confirmation of the disconnect request.

  8. Click OK to disconnect the selected client.

    The client is disconnected.

Dynamically Deleting Adabas Contexts

Start of instruction setTo dynamically delete an Adabas context of a Kernel:

Make sure you have accessed the System Management Hub and that the Kernel is started. For complete information about starting Kernels, read Starting a Kernel.

  1. Select the name of the managed host on which Entire Net-Work Server is installed.

  2. Expand the tree-view frame for the managed host by clicking on the plus sign (+) to the left of its name.

  3. Select "Entire Net-Work Server" in the tree-view under the managed host.

    The Entire Net-Work Server administration area of the System Management Hub becomes available to you.

  4. Expand Kernels in tree-view, by clicking on the plus sign (+) to the left of its label.

    The list of started Kernels appears.

    Note:
    If the Kernel you need is not listed, it is not started. You must start the Kernel before you can proceed with these instructions. Read Starting a Kernel for more information.

  5. Expand Clients in tree-view, by clicking on the plus sign (+) to the left of its label.

    The client and Adabas context definitions for the Kernel are listed in categories in tree-view. Three categories are listed: Direct Clients, Adabas Contexts, and Relay Clients.

  6. Expand Adabas Contexts category in tree-view, by clicking on the plus sign (+) to the left of its label.

    The Adabas context definitions for the Kernel are listed in tree-view.

  7. Right-click on the name of the Adabas context you wish to delete and select Delete from the resulting drop-down menu.

    A panel appears in detail-view requesting confirmation of the deletion request.

  8. Click OK to delete the selected Adabas context.

    The Adabas context is deleted.