Version 9.6
 —  EntireX MSP  —

Message Service Administration using System Management Hub

EntireX MSP can be administered using Software AG's System Management Hub. The System Management Hub is Software AG's cross-product and cross-platform product management framework. This document assumes that you are familiar with the System Management Hub software. The basic concepts of this product, its installation and System Management Hub features common to all Software AG products are described in the separate System Management Hub documentation.

Note:
This was the most recent System Management Hub documentation when this version of EntireX was released. As System Management Hub release cycles are independent of EntireX, a more recent version of System Management Hub may be available.

This document covers the following topics:


Introduction

JMS-based Message Services are administered from the EntireX Message Service SMH node, which is located below the EntireX node in the System Management Hub tree view. Instances of Queue Connection Factories, Queues, Topic Connection Factories and Topics can be created, modified and deleted from the System Management Hub.

The JNDI properties are listed in the detail view of the Message Service root. These properties are configured in the file jndi.properties in the subfolder config of the installation folder.

Top of page

Queue Connection Factory

Start of instruction setTo define a queue connection factory instance to System Management Hub

  1. Select the Queue Connection Factory node below the Message Service node.

  2. Choose Add.

  3. In the field Queue Connection Factory, enter the queue connection factory name.

  4. In the field Broker ID, enter a Broker identifier.

  5. Choose SAVE.

Start of instruction setTo modify a queue connection factory instance

  1. Select the queue connection factory instance node below the Queue Connection Factory node.

  2. Choose Modify.

  3. The queue connection factory instance name can be modified in the field Queue Connection Factory.

  4. The broker identifier can be modified in the field Broker ID.

  5. Choose SAVE.

Start of instruction setTo delete a queue connection factory instance

  1. Select the queue connection factory instance node below the Queue Connection Factory node.

  2. Choose Delete.

Top of page

Queue

Start of instruction setTo define a queue instance to System Management Hub

  1. Select the Queue node below the Message Service node.

  2. Choose Add.

  3. Enter the queue name in the field Queue.

  4. Enter a service name in the field Service.

  5. In the (optional) Formatter field, you can either enter a custom name in the space provided, or choose one of the other options.

  6. Choose SAVE.

Start of instruction setTo modify a queue instance

  1. Select the queue instance node below the Queue node.

  2. Choose Modify.

  3. The queue instance name can be modified in the field Queue.

  4. The service name can be modified in the field Service.

  5. The formatter name can be modified in the field Formatter.

  6. Choose SAVE.

Start of instruction setTo delete a queue connection factory instance

  1. Select the queue instance node below the Queue Connection Factory node.

  2. Choose Delete.

Top of page

Topic Connection Factory

Start of instruction setTo define a topic connection factory instance to System Management Hub

  1. Select the Topic Connection Factory node below the Message Service node.

  2. Choose Add.

  3. Enter the topic connection factory name in the field Topic Connection Factory.

  4. Enter a broker identifier in the field Broker ID.

  5. Choose SAVE.

Start of instruction setTo modify a topic connection factory instance

  1. Select the topic connection factory instance node below the Topic Connection Factory node.

  2. Choose Modify.

  3. The topic connection factory instance name can be modified in the field Topic Connection Factory.

  4. The broker identifier can be modified in the field Broker ID.

  5. Choose SAVE.

Start of instruction setTo delete a topic connection factory instance

  1. Select the Topic Connection Factory Instance node below the Topic Connection Factory node.

  2. Choose Delete.

Top of page

Topic

Start of instruction setTo define a topic instance to System Management Hub

  1. Select the Topic node below the Message Service node.

  2. Choose Add.

  3. Enter the topic name in the field Topic.

  4. Enter a service name in the field Service.

  5. In the (optional) Formatter field, you can either enter a custom name in the space provided, or choose one of the other options.

  6. Choose SAVE.

Start of instruction setTo modify a topic instance

  1. Select the Topic Instance node below the Topic node.

  2. Choose Modify.

  3. The topic instance name can be modified in the field Topic.

  4. The service name can be modified in the field Service.

  5. The formatter name can be modified in the field Formatter.

  6. Choose SAVE.

Start of instruction setTo delete a topic instance

  1. Select the Topic Instance node below the Topic node.

  2. Choose Delete.

Top of page

Batch Interface

The EntireX Message Service agent supports the System Management Hub's batch interface. The table below contains the corresponding batch commands.

Description Batch Command
Show information about the Message Service properties. show jmsproperties
List the Message Service Queue Connection Factories. show jmsqueueconnectionfactory
List the Message Service Queues show jmsqueue
List the Message Service Topic Connection Factories show jmstopicconnectionfactory
List the Message Service Topics show jmstopic

Example:

Enter the argbatch command with the following parameters to execute the batch command.

argbatch show jmsqueue user=[userid] password=[passwd]
     target=[managed host name] "product=webMethods EntireX 8.2" "name=RPC Server1"

Note:
argbatch is part of the System Management Hub software. It is located in the bin directory of the System Management Hub installation.

See System Management Hub Batch Interface (under User Interfaces) in the separate System Management Hub documentation.

Top of page