How to monitor your EntireX Mainframe Broker using Command Central
Tags: entirex, webmethods
Published: 2019-08-23 12:54:35

---
title: How to monitor your EntireX Mainframe Broker using Command Central
published: true
tags: entirex, webmethods
canonical_url: http://techcommunity.softwareag.com/techniques-blog/-/blogs/how-to-monitor-your-entirex-mainframe-broker-using-command-central
---

# webMethods EntireX

**Imagine you are running EntireX Broker on a mainframe platform like z/OS®, Z/VSE® or BS2000. How can you check whether it is running? What servers are available? How many clients, servers and conversations are active? Use Software AG Command Central to monitor all this for you!**

_By Juergen Lind, Director Product Management, Adabas & Natural, Bernhard Fricke, Sr. Software Specialist, EntireX Development and Peter Hofer, Sr. Lead Software Engineer, Software AG_

## Getting to know Command Central

Let’s step back and explain Software AG Command Central. You use it to perform administrative tasks remotely from a single location. Command Central assists with configuration, management and monitoring tasks. As an operator, you can monitor server status and health. You can start and stop servers, and you can configure alerts to be sent in case of unplanned outages.

How does EntireX fit into Command Central? You can:

- Administer your EntireX Broker: start, stop and configure it, monitor status, KPIs and alerts; create or delete instances (since EntireX 9.9 / October 2015)
- Administer relevant RPC Servers: start, stop, configure and monitor them; create or delete instances (since EntireX 10.1 / October 2017)
- Use template-based provisioning: install EntireX and, at the same time, add instances such as EntireX Broker and multiple RPC servers on local and even remote hosts (since EntireX 10.1 / October 2017)

All of these features cover EntireX components running on Linux®, UNIX® and Windows® installed via Software AG’s installer or via Command Central.

So, what about the mainframe components? With EntireX 10.3 (released in October 2018) you can now also monitor EntireX mainframe brokers running on z/OS, z/VSE or BS2000.

## EntireX Mainframe Broker Monitoring

**Create an instance for EntireX Mainframe Broker Monitoring**

Let’s take a scenario with EntireX Broker running on a mainframe. To monitor it with Command Central, you define an instance for it within Command Central. This instance holds connection information to the remote broker.

![](http://techcommunity.softwareag.com/documents/10157/10221817/entirex1.png/8c830843-887b-4211-81de-7bb193d02f55?t=1548160279646)  
_ **Figure 1:** Create an Instance for EntireX Mainframe Broker Monitoring_

It is very easy to create this instance: Log on to Command Central and navigate to _Home \> Instances \> ALL \> EntireX Mainframe Administration_. Click the _Configuration Tab_: add a name - _myBroker_ is used in Figure 1 - and connection information. That’s all. Now you will find the new proxy instance of your mainframe Broker in the list of instances.

**Monitor your EntireX Mainframe Broker**

In Command Central, navigate to Home \> Instances \> ALL: the instance _mybroker_, created in the previous step, is displayed as _EntireX Mainframe Broker myBroker_.  Click on this instance, select the _Overview Tab_ to watch its status (online or stopped), alerts and KPIs:  active clients, registered servers and ongoing conversations between them (Figure 2).

_**![](http://techcommunity.softwareag.com/documents/10157/10221817/entirex2.png/f51756f2-b91e-458e-97f4-34bff9e99012?t=1548160285535)  
Figure 2:** EntireX Mainframe Broker Monitoring: Status and KPIs_

Select _Monitoring KPIs_ in the drop-down box on the _Configuration Tab_ to adjust scaling and boundary values (maximal/marginal/critical) for the KPIs, clients, servers and conversations. If a defined boundary value is crossed, the color changes to direct your attention to the KPI: orange if a marginal line is crossed, red for a critical boundary value (Figure 2).

Also, if required, alter the connection parameters to your EntireX mainframe broker:  Select _Broker Connection_ in the drop-down box on the _Configuration Tab._

**View registered Services and Server**

Navigate to your instance _EntireX Mainframe Broker myBroker._ Use the _Administration Tab_ for an overview of services currently running (Figure 3).

_![](http://techcommunity.softwareag.com/documents/10157/10221817/entirex3.png/4c729d34-229f-414a-a8f8-a6ee3499a289?t=1548160289501)  
**Figure 3:** View Services and Server registered to an EntireX Mainframe Broker_

Watch the number of active _Server Instances_ (replicates), _Requests, Wait for Servers_ and _Conversations_ for a service. Of particular interest is the column _Wait for Servers._ This tells you the number and percentage of requests where clients had to wait because all running server instances were busy.  Consider starting more server instances if those values are high.

## How to get it

You can use the Software AG Installer to install the package for EntireX Mainframe Broker Monitoring. Alternatively, use Command Central; refer to section _Installing, Configuring and Upgrading Command Central_ within Command Central documentation.

**Mainframe Broker Monitoring Package**

In Software AG Installer: Choose _EntireX -\> Administration and Monitoring_ and explicitly mark _Mainframe Broker Monitoring_ (Figure 4).

_![](http://techcommunity.softwareag.com/documents/10157/10221817/entirex4.png/ecf2d4e5-26df-467e-8371-a15f30aa331a?t=1548160294026)  
**Figure 4:** Installation with Software AG Installer_

**Mainframe Broker on z/VSE and BS2000**

In addition to z/OS, you can also monitor all EntireX Mainframe Brokers running on z/VSE and BS2000 with Command Central.

## More monitoring options

In addition to the Command Central GUI, there are further options governing how you can monitor your EntireX Mainframe Brokers.

All possibilities are documented within the EntireX documentation (Figure 5):

- **Using Command Central Command Line:** Refer to _Administration and Monitoring_; choose _Administration using Command Central -\> [Monitoring EntireX Mainframe Broker using the Command Central Command Line](http://lagoon.hq.sag/snapshots/entirex/communicator/adminGeneral/cc-mf-cmd.htm)_
- **EntireX with Command line scripts:** Refer to _Administration and Monitoring;_ select _Monitoring EntireX with Command line scripts_
- **EntireX utility ETBINFO:** Refer to _Administration and Monitoring_; choose your platform _(z/OS | BS2000 | z/VSE);_ Follow the hyperlinks _Broker Add-ons -\> Broker Command line Utilities -\> ETBINFO_
- **Operator Commands:** Refer to _Administration and Monitoring_; select your platform _(z/OS | BS2000 | z/VSE)_; follow the hyperlinks _Broker Add-ons -\> Operator Commands_

_![](http://techcommunity.softwareag.com/documents/10157/10221817/entirex5.png/e3182dd8-7f32-482a-950f-b64656a150f7?t=1548160298294)  
**Figure 5:** EntireX Documentation_

## So in summary …

With the EntireX Mainframe Broker Monitoring, you can easily monitor your Brokers running on a mainframe platform like z/OS, z/VSE or BS2000. Directly recognize whether the Broker is online and the KPIs are in a range expected by your organization. Switch to the Administration page to list the registered services and server and check directly whether more server instances are needed.

EntireX Mainframe Broker Monitoring is available with EntireX version 10.3 (GA: 2018Oct). To learn more, read **Administration using Command Central** from the webMethods EntireX documentation.

 

| 
## **Glossary of terms**

**Command Central ** – Tool to manage your Software AG proucts remotely

**EntireX Broker** – Central EntireX communication hub

**ETBINFO**  – EntireX Command-line utility for querying status information from EntireX Broker 

**GUI ** – Graphical User Interface

**KPI ** – Key Performance Indicator

**SPM ** – Software AG Platform Manager; used by Command Central

**Template-based provisioning**  – Command Central feature for remote instance deployiment

 |

**Related articles**

- “[How to monitor your EntireX environment with command line scripts](http://techcommunity.softwareag.com/techniques-blog/-/blogs/how-to-monitor-your-entirex-environment-with-command-line-scripts),” TECHniques, April 2018 (Issue 2)
- “[How can you monitor EntireX using Command-line Scripts?](http://techcommunity.softwareag.com/techniques-blog/-/blogs/how-can-you-monitor-entirex-using-command-line-scripts-)” TECHniques, October 2017 (Issue 4)
- “[How to monitor your EntireX environment](http://techcommunity.softwareag.com/web/guest/techniques-blog/-/blogs/how-to-monitor-your-entirex-environment),” TECHniques, July 2017 (Issue 3).
- “EntireX documentation, version 10.3 (GA: 2018Oct),” see: [https://documentation.softwareag.com/webmethods/entirex/exx10-3/10-3\_EntireX/overview.htm](https://documentation.softwareag.com/webmethods/entirex/exx10-3/10-3_EntireX/overview.htm)
- “Software AG Command Central Help, version 10.3 (GA: 2018Oct),” on how to use Command Central to manage your Software AG products remotely from one location; see:  [https://documentation.softwareag.com/webmethods/command\_central/cce10-3/10-3\_Command\_Central\_webhelp/index.html](https://documentation.softwareag.com/webmethods/command_central/cce10-3/10-3_Command_Central_webhelp/index.html)
- “Using Software AG Installer, version 10.3 (GA: 2018Oct),“ see:  [https://documentation.softwareag.com/a\_installer\_and\_update\_manager/2018Oct\_Using\_SAG\_Installer.pdf](https://documentation.softwareag.com/a_installer_and_update_manager/2018Oct_Using_SAG_Installer.pdf)