Introduction

This document covers the following topics:


Scope

EntireX provides a set of command-line scripts as a solution to the following scenarios:

  • "I want a quick overview of my standard broker and a list of active external services that are running." graphics/toc_closed.png More info

  • "I want to monitor an EntireX component (broker, service, client) over time." graphics/toc_closed.png More info

  • "I want to monitor my environment and check that all components (broker, RPC servers) are up and running." graphics/toc_closed.png More info

You can select the scripts from the EntireX Command-line Scripts Menu or call the individual scripts from the command-line.

Note:
You can use these scripts with local or remote brokers. The scripts were introduced with version 9.7, but can be used with brokers of any supported version.

EntireX Command-line Script Menu

Start of instruction setTo call the command-line script menu

  • Choose Start > Software AG > Administration > EntireX Command-line Scripts.

    Or:
    Enter command Menu_Of_EntireX_Command_Line_Scripts.bat in the EntireX bin directory.

    The following screen appears:

    List of EntireX Command-line Scripts
    
    
    Current Broker:  localhost:1971
    
    1 : Show Broker and registered Services
    
    The following scripts write to CSV file:
    2 : Monitor Broker 
    3 : Monitor Services 
    4 : Monitor Clients 
    
    5 : Change current Broker (this session only)
    6 : Edit Broker and other defaults (persistent)
    
    7 : Define your Environment
    8 : Monitor your Environment
    
    9 : Open new command window (in script directory)
    
    0 : Exit
    
    Enter the number to be executed or ? for help
    
    

The screen shows the current broker to which the administration tasks apply. You can change this for the duration of the session or persistently in the defaults. See Using the Broker ID in Applications in the ACI Programming documentation for possible formats.

Enter a number to perform the respective task. The options are described in the table below, together with the corresponding script if you prefer to call the script directly.

Script Menu Options

Option Description Corresponding Script Note
1 Show Broker and registered Services. Displays information on the current broker and its registered services. graphics/toc_closed.png More info entirex_overview.bat  
2 Monitor Broker. Monitors the current broker. graphics/toc_closed.png More info monitor_broker_to_csv.bat Output for these three monitoring scripts is written to a CSV file (comma-separated values), which you can view, for example, with a spreadsheet tool.
3 Monitor Services. Monitors services registered to the current broker. graphics/toc_closed.png More info monitor_service_to_csv.bat
4 Monitor Clients. Monitors clients registered to the current broker. graphics/toc_closed.png More info monitor_client_to_csv.bat
5 Change Current Broker. Changes the broker used in the various scripts for this session only.     When the session is restarted, this value reverts to the default.
6 Edit Broker and other Defaults. You can modify defaults for Broker ID, timeout values and output files. graphics/toc_closed.png More info edit_user_specific_monitor_defaults.bat  
7 Define your Environment. You can define the environment (list of broker and registered services) you want to monitor. graphics/toc_closed.png More info edit_user_specific_environment_definition.bat  
8 Monitor your Environment (defined with option 7). graphics/toc_closed.png More info monitor_environment.bat  
9 Open New Command Window (in command-line script directory).     This enables you to start the scripts with your parameters.
0 Exit.     Exits the menu. If you changed the current broker with Option 5, this will revert to the default value. Monitoring scripts that write to CSV files running in a separate command window continue to run.

Changing the Current Broker

Start of instruction setTo change the current broker for your current session

  • Choose option 5 from the EntireX Command-line Script Menu, "Change current Broker (this session only)". This changes the current broker ID used for executing the command-line scripts in this session.

    If you restart the script, the broker ID will be (re)set to the default value.

Start of instruction setTo change the current broker permanently