The Connection Management tool is used to manage both Admin and JMX connections to a Server. To open the Connection Management dialog box, click Window > Open Perspective > Other and select Connection Management.

The dialog box displayed consists of three views – the Server Connections view, the Properties view and the Explorer view, as shown in Figure 1.

Figure 1: Connection management perspective

• Server Connections: Displays the connection nodes through which connections (Admin/JMX) are made to the Server.

Each Server Node displays the Shutdown and Restart options by right-clicking over the menu.

• Actions on the View Toolbar:
  • New Fiorano JMX Connection: This option is used to create a new JMX connection Login node.
  • New Fiorano Server Connection: This option is used to create a new Admin Connection Login Node.
• Explorer: The Explorer provides a collective view of multiple similar elements. The view provides a birds-eye view of all the children of a selected element and their properties. For example, if the user logs in to an Admin Connection to an Enterprise Server, clicking the Connection Factories node under FES node will show a list of all the connection factories and their properties in the Explorer view. (Refer figure below)

Figure 2: Explorer View

The view also has Up, Back and Forward actions to facilitate easy navigation through the nodes in the tree.

• Properties: All the properties for each administered object from the Server connections view is displayed in this view.
• Actions on the View Toolbar:
  • Show Advanced Properties: This options is used to show/hide advanced properties if available for any selected node.

The ' ' icon is displayed beside the value of the property to indicate that there has been a change from in the value of the property from its default value.

Admin Connection Management

Administrative Connection to a Fiorano Server (FMQ/FES /FPS) enables performing tasks such as tracking clients connected to the Server, managing destinations and connection factories, snooping messages on a queue or topic, viewing logs and so on.

• To login into a server, select the server node and in the properties view to specify the required connection properties, right-click on the node and select Login.
• After Login if both the Admin and the JMX connections are successful, then six child nodes are displayed under the Server node.
  • If only the Admin connection is successful five nodes, excluding the logger node, will be displayed under the Server node.
  • If the JMX Connection is successful, only the Loggers node is displayed as a child of the Server node.

Given below is the description and usage of each node under the Server node (including FES/FPS/FMQ).

Clients

All the clients connected to the Server are displayed under this node.

Option Available:

• Refresh: This option refreshes client connections. Client connections made or lost after login are reflected in the tree diagram only when the Clients node is refreshed.
• Purge: This option is used to purge or clear messages on a Topic subscribed to by the client for messages, as shown in Figure 2. This action is useful for the durable subscriber when it is in an inactive state.

Figure 3: Purge Messages

Connection Factories

The default connection factories provided by the Server are initially displayed under this node. [Semantic check please]

New Connection Factories can be added by selecting the Add Connection factory option by right-clicking this node, as shown in Figure 3.

Figure 4: Create connection factory dialog

Right-click on the Connection Factory menu to delete the Connection Factory.

Destinations

The destinations created in the Server are displayed under this node under Queues or Topics categories.

New Queues/Topics can be added by selecting Add ? Queue /Topic and right-clicking the Destinations node or by selecting Add Queue/Add Topic on the Queues and Topics nodes, as shown in Figure 4.

Figure 5: Create Queue dialog

Actions Associated with Queues andTopics

EditACL: This option is used to add Users to the Access Control List (ACL) where Permissions may be edited.

For adding a new ACL Entry, click Add in the EditACL dialog box, as shown in Figure 5.

Figure 6: Edit ACL dialog

To edit a new ACL Entry, select the ACL to edit and click on Edit. The Edit Permissions dialog box displayed, as shown in Figure 6.

Figure 7: Editing permissions

Subscribe/Receive: This option is used to subscribe or receive messages on a destination. A dialog box is displayed, as shown in Figure 7, containing subscribed or received messages.

Figure 8: Subscribe messages dialog

Browse Messages: This option is used to view messages on a Queue.

Produce Text Message: This option is used to send/produce messages on a Queue or a Topic.

Delete: This option is used to delete a Queue or a Topic.

Loggers

Users that are logged in are allowed to view and manage Server logs. For example, the node Fiorano, which is a child node, contains all the Fmq and Esb related events to which an Appender or a Console Appender may be added. The same functions may be added to the Monitoring and the WebManagement nodes.

• To add an appender right-click on the logger and select Add ->File or Console Appender. A dialog box is displayed where New File Appender/Console Appender properties may be added .Enter the Values and click on OK to create the Appender.
• To View/Clear Logs of an Appender right-click and select View Logs /Clear Logs.
• To delete an Appender, right-click on the appender and select Delete.

Security

Groups and Users created for access control are added under this node.

• To add a new Group, right-click on Groups and select Add Group.
• To edit the members in a Group, right-click on a Group and select Members. A dialog box is displayed, as shown in Figure 8, where new Users or Groups may be added.

Figure 9: Add members dialog

• To add a new User, right-click on Users and select the Add Users option.
• To change the password of a User, right-click on User and select Change Password. A dialog box is displayed, as Shown in Figure 9, where the password can be changed.

Figure 10: Change password dialog

Snooper

The Snooper function enables the replication of messages under a Queue/Topic to another Queue/Topic.

The Queue/Topic on which snooping is desired can be added by right-clicking on Snooper/Queues/Topics nodes and selecting Add/Remove Destinations option. A dialog box is displayed, as shown in Figure 10, where the destination list is displayed. Destinations may be added or removed from this list.

Figure 11: Add/Remove destinations

JMX Connection Management

The JMX Connection Management lets the User connect to a JMX complaint Server such as FMQ-JMX/FES-JMX/FPS-JMX and perform tasks such as browsing Server mbeans, monitoring data, and changing Server properties runtime.