Monitoring EntireX Mainframe Broker using the Command Central GUI

This document applies to EntireX Brokers under z/OS, BS2000 and z/VSE. It covers the following topics:

See also Introduction and Monitoring EntireX Mainframe Broker using the Command Central Command Line.

Logging in to Command Central

Start of instruction setTo log in to Command Central

  1. Open an Internet browser and specify the URL of the Command Central Server: "http://<Command_Central_host>:<Command_Central_port>".

    This takes you to the Command Central Login page.

    On Windows you can also get to the Login page from the Command Central Start Menu entry.

  2. In the Login page, provide your user credentials and click Log In.

    This takes you to the page Home > Instances:

    graphics/cc-mf-gui_login.png

Creating an EntireX Mainframe Broker Connection

Start of instruction setTo create an EntireX Mainframe Broker connection

  1. Navigate to Home > Instances > ALL > EntireX Mainframe Administration and click the Configuration tab.

    graphics/cc-mf-gui_create-1.png

  2. Click the graphics/gui_plus.png button in the upper right corner to add a mainframe broker connection.

    graphics/cc-mf-gui_create-2.png

    Parameter Description
    Broker
    Instance name Required. Provide unique instance name. Permitted characters: letters, numbers, hyphen (-), underscore (_) and dot (.).
    Transport Transport over TCP or SSL. Default is TCP.
    Broker host Required. EntireX Broker host name or IP address.
    Broker port Required. Port number in range from 1025 to 65535.
    SSL trust store Optional. Specifies the location of SSL trust store.
    SSL verify server Optional. The RPC server as SSL client checks the identity of the broker as SSL server.
    Credentials
    User Optional. The user ID for secured access to the broker.
    Password Optional. The password for secured access to the broker.

  3. Click Edit to configure the broker connection.

  4. Click Test to check the correctness of your input, or Save to apply your changes.

    graphics/cc-mf-gui_create-3.png

    If the instance is not valid, click the Logs tab of the instance for more information in the console.log file.

Viewing the Runtime Status

Start of instruction setTo view the runtime status of the EntireX Mainframe Broker

  • Navigate to Home > Instances > ALL > EntireX Mainframe Broker <instance name> and click the Overview tab.

    graphics/cc-mf-gui_runtimeStatus.png

    Status Description
    Unresponsive The EntireX Mainframe Broker has not answered yet; the status is shown as unresponsive. This is the default status after creating an EntireX Mainframe Broker connection. For more information click the Logs tab to see the connection.log file.
    Stopped The EntireX Mainframe Broker is down after successful communication.
    Error If the EntireX Mainframe Broker communication returns an error, the status is shown as error. For more information click the Logs tab to see the connection.log file.
    Online The EntireX Mainframe Broker is running.

Configuring an EntireX Mainframe Broker Connection

Start of instruction setTo configure EntireX Mainframe Broker

  1. Navigate to Home > Instances > ALL > EntireX Mainframe Broker <instance name> and click the Configuration tab.

    graphics/cc-mf-gui_config-connection.png

    Parameter Description
    Broker
    Transport Transport over TCP or SSL. Default is TCP.
    Broker host Required. EntireX Broker host name or IP address.
    Broker port Required. Port number in range from 1025 to 65535.
    SSL trust store Optional. Specifies the location of SSL trust store.
    SSL verify server Optional. The RPC server as SSL client checks the identity of the broker as SSL server.
    Credentials
    User Optional. The user ID for secured access to the broker.
    Password Optional. The password for secured access to the broker.

  2. Click Edit to configure the broker connection.

  3. Click Test to test the correctness of your input, or Save to apply your changes.

Configuring the Monitoring KPIs

Start of instruction setTo configure Monitoring KPIs of an EntireX Mainframe Broker

  1. Navigate to Home > Instances > ALL > EntireX Mainframe Broker <instance name>, click the Configuration tab and choose Monitoring KPIs.

    graphics/cc-mf-gui_config-kpi.png

    Parameter Description
    Clients
    Maximum Maximum number of clients in the overview graph.
    Marginal Marginal barrier for numbers of clients in the overview graph.
    Critical Critical barrier for numbers of clients in the overview graph.
    Servers
    Maximum Maximum number of servers in the overview graph.
    Marginal Marginal barrier for numbers of servers in the overview graph.
    Critical Critical barrier for numbers of servers in graph.
    Conversations
    Maximum Maximum number of conversations in the overview graph.
    Marginal Marginal barrier for numbers of conversations in the overview graph.
    Critical Critical barrier for numbers of conversations in the overview graph.

  2. Click Edit to adjust the scaling of the EntireX Mainframe Broker KPIs.

  3. Click Test to test the correctness of your input, or Apply.

Inspecting the Log Files

Start of instruction setTo inspect the log file of the broker connection

  1. Navigate to Home > Instances > ALL > EntireX Mainframe Broker <instance name> and click the Logs tab.

    graphics/cc-mf-gui_log-1.png

  2. In the Alias column you can select a log file to inspect.

    graphics/cc-mf-gui_log-2.png

Viewing Services and Servers

Start of instruction setTo view services registered to an EntireX Mainframe Broker

  1. Navigate to Home > Instances > ALL > EntireX Mainframe Broker <instance name> and click the Administration tab.

    graphics/cc-mf-gui_services-1.png

  2. In the Class/Server/Service column, click on a service to display the servers providing this service.

    graphics/cc-mf-gui_services-2.png

    The Start Time is displayed in the local time where the SPM is running.

Deleting an EntireX Mainframe Broker Connection

Start of instruction setTo delete an EntireX Mainframe Broker connection

  1. Navigate to Home > Instances > ALL > EntireX Mainframe Administration and click the Configuration tab.

    graphics/cc-mf-gui_delete.png

  2. Select the broker connection you want to delete and press the graphics/gui_minus.png button in the upper right corner.
  3. Click OK to confirm deletion of this broker connection.