Show Broker and Registered Services

Scenario: "I want a quick overview of my standard broker and a list of active external services that are running."

With script entirex_overview.bat, EntireX offers a simple solution to show details of a specified or default broker and the active external services registered to it.


Calling the Script

Start of instruction setTo show a broker and its registered services

  • Choose option 1 from the EntireX Monitoring Scripts menu, "Show Broker and registered Services".

    Or:
    Enter one of the following commands:

    entirex_overview.bat
    entirex_overview.bat <BrokerId>
    entirex_overview.bat <BrokerId> <UserId>
    entirex_overview.bat <BrokerId> <UserId> FILE <EncryptedPasswordFile>
    where <BrokerId> is the ID of the broker to be monitored (default localhost:1971), and
      <UserId> is your user ID for broker calls if your broker is running with EntireX Security (no default)
      <EncryptedPasswordFile> is a file containing your encrypted password. See Using an Encrypted Password.

    The parameter FILE indicates that the encrypted password will be read from the specified file.

    Notes:

    1. The file containing the encrypted password must be located at %HOMEDRIVE%%HOMEPATH%\documents\Software AG\EntireX, or specify the complete file path. Enclose the file name in quotes (" ") if the file path or file name contains blanks.
    2. The cleartext <Password> option of earlier versions is deprecated but still supported in this version.

If no broker ID is specified, an overview of the default broker is provided. See Default Handling on how to change this.

See also Using the Broker ID in Applications in the ACI Programming documentation.

Example

Sample command:

entirex_overview.bat localhost:1971 myUserId FILE myEncryptedPasswordFile.txt

Sample output:

Overview of Broker localhost:1971

 Broker ID         : ETB001                            
 Running on        : pcusr1 
 Version           : 10.8.0.00         
 License expiration: UNLIMITED  
 Trace level       : 0 
 Platform          : PC       Windows 10 Enterprise           
 Client timeout    : 900 
 
 Transport Settings 
 NET           : NO 
 SSL           : NO 
 TCP           : YES 
 
 Dynamic Memory Management: YES 
 Dynamic Worker Management: YES 
 Re-read attribute file   : YES 
 
 Attribute file: C:\SoftwareAG\EntireX\config\etb\ETB001\ETB001.atr 
 Log file      : C:\SoftwareAG\EntireX\config\etb\ETB001\ETB001.log 
 License file  : C:\SoftwareAG\common\conf\exx108.xml 
 
 Workers       : Active: 1 
 Services      : Active: 9  
 
 High Watermarks 
 Servers       : 2  
 Clients       : 1  
 Conversations : 1  
 Memory        : 30153112  

List of Active (External) Services for Broker localhost:1971

 
 Class         : RPC                               
 Server        : XMLSERVER                         
 Service       : CALLNAT                          
  
 No. of times all server instances were busy: 0 
 Maximum of pending parallel conversations  : 0 
 Total No. of requests                      : 0 
 No. of active server instances             : 2 
 Conversation high watermarks               : 0  

End of overview