Viewing Node Status

About this task

The Node Status screen enables you to check the status of all DTF nodes eligible for access by the CICS® Interface, and you can selectively activate, deactivate, and view pending work for all DTF nodes. The CICS user interface provides the ability to log on to any IBM® Connect:Direct® DTF in your network and perform IBM Connect:Direct operations using that node as your Process primary node. DTFs to be accessed must be identified in DTF Node Records in the configuration file along with the configuration parameters to be used when communicating with that node.

To scroll backward and forward, through the list of DTF nodes connected to the IBM Connect:Direct for z/OS® session, press PF7 and PF8, respectively.

Procedure

  1. To access the CONNECT:DIRECT ADMINISTRATION NODE STATUS screen, select option N from the ADMINISTRATION PRIMARY MENU and press Enter.

    Following is an example of the Node Status screen.

                       CONNECT:DIRECT ADMINISTRATION                   10:30:37
                             NODE STATUS
    
                     CICS    ADMIN    SESS  SESSION DATE/TIME      MAX  CURR   CURR
      DTF NODE NAME  STATUS  REQUEST  TYPE  OR SESSION MSGID     TASKS  TASKS  WORK
      -------------  ------  -------  ----  -----------------    -----  -----  ----
    _ NODE1          INACT            NONE                         3      0     0
    _ NODE2          ACTIVE           PRIM  06/19/1998 09:57:18    2      1     0
    
    Line commands:  A  Activate (start first task)  I  Shut immediate
                    W  Work queue display           S  Shut normal
    
    PF keys:   3 Exit   ENTER Refresh/Line cmd

    The following table describes the fields on the NODE STATUS screen:

    Field Description
    DTF NODE NAME (16-character field) contains the DTF node name as typed in the DTF Node Record.
    CICS STATUS (6-character field) contains the status of the node, such as ACTIVE and INACT.

    ACTIVE - The node is activated, either by the CICS Interface initialization or manually.

    INACT - The node is not active.

    ADMIN REQUEST This 8-character field contains the type of administrative request affecting the status of the node, such as ACTIVATE, SHUTIMM, or SHUTNORM.

    ACTIVATE - The node is activated.

    SHUTNORM - A normal shutdown of the node is requested, and the node is quiescing.

    SHUTIMM - An immediate shutdown of the node is requested, and the link with that DTF is being terminated.

    SESS TYPE This 4-character field contains the type of session held with this DTF node, as follows:

    NONE - No session currently exists with this DTF node.

    PRIM - The CICS Interface is currently in session with the DTF node.

    ESF - The DTF is not active, but supports the Extended Submit Facility. The CICS Interface is accepting requests allowed in ESF mode.

    SESSION DATE/TIME This 17-character field contains either the date and time that the connection to this DTF is activated, or the MSGID of the last message issued for this DTF node during activation or deactivation.
    MAX TASKS This 5-character field contains the maximum number of subtasks that are attached to Process requests directed at this node.
    CURR TASKS This 5-character field contains the current number of subtasks attached to Process requests directed at this node.
    CURR WORK This 5-character field contains the number of subtasks currently processing requests directed at this node.
  2. Take one of the following actions in the line command column to the left of the DTF node name:
    • To activate the node, type A and press Enter.
    • To access the WORK QUEUE screen for a node where work is being processed, type W and press Enter.
    • To perform an immediate (hard) shutdown of the node to force all Processes to stop, regardless of status, type I and press Enter.
    • To perform a normal (soft) shutdown of the node to allow all Processes to complete execution, type S and press Enter.