Some of the content described in this article is available in meshIQ Manage versions 12.1 and later.
For a quick overview of what's new or changed, visit the meshIQ Highlights page for a version-by-version breakdown.
Jump to Section:
Version 12.x and Later
Version 11.3 and Earlier
Version 12.x and Later
A workgroup server consists of nodes which are access points for queue managers, EMS brokers, and other managers.
Viewing Nodes
You can view a workgroup server and its connected nodes in the Workspace window. Each Workgroup Server widget displays the nodes connected to that workgroup server within the widget.
You can create a new schema and add, remove, or rearrange the displayed columns, see Schemas.
Nodes with a check mark in a green circle signify that the node is active. A node with an exclamation point in a red circle
means that the node is stopped or its state is unknown.
Node Actions
To perform actions on a node, select its checkbox. The Selected menu becomes available, displaying all available actions. Please note that your options may differ according to your user permissions, which are managed by an admin.
See the below table for an explanation of all node actions.
| Menu option | Description |
| Show Object Attributes | Displays node details. |
| Show Topology | Displays a topology of the node's objects. |
| Events | Displays the node's events. |
| Manage |
Signifies if a node is managed (displays with a check mark). Managed nodes can be discovered. Select the Manage option to activate an inactive node. Deselect this option to make a node inactive. When deselected, the Delete and Properties options become available in the node menu.
Note: An active node may need to be reactivated by deselecting and re-selecting the Manage option.
|
| Commands |
The Commands submenu includes options for starting or stopping WMQ objects, and for shutting down the node. See Starting and stopping WMQ Objects (Nodes) for more information. |
| Discover Now > |
Incremental: The workgroup server maintains the last discovery time for each queue manager and sends this time with each discovery command. Incremental discovery logic will work only if initial discovery is completed and queue managers are fully discovered. Full: When the workgroup server starts up, it sends a query on every object to the agent. The workgroup server re-connects to each agent and sends an EXCMD_MQ_DISCOVER command. Since the agent thread or process for a given queue manager has just started, while servicing the discover command, the agent allows every inquire object reply from the IBM WMQ command server to be sent to the WGS. Note: The Discover Now feature also applies to Queue Managers and works the same way as for Nodes. |
| Manage Connections | Displays the remote manager connection available within the selected node, where you can manage connections such as add, import, export, delete, modify, copy, and verify connection. |
| Delete | Displays in the menu when the node is not active (unmanaged). Deletes the selected node. |
| Properties | Opens the Properties dialog where you can view and/or edit the node’s configurations. This option is available in the menu when the node is inactive (unmanaged). See Node Properties for more details. |
Creating Nodes
See Create a node for information on how to create a node.
Adding a Node Widget
Node widgets can be added to any dashboard. See Creating Widgets in the dashboard for more information.
________________________________________________________________________________________________________________
Version 11.3 and Earlier
A workgroup server consists of nodes which are access points for queue managers, EMS brokers, and other managers.
Viewing Nodes
A workgroup server's nodes can be viewed on the WorkSpace dashboard. There will be a node viewlet for each workgroup server. You can create a new schema to add, remove, or rearrange displayed columns as you see fit. See Schemas for instructions.
Nodes with a check mark in a green circle signify that the node is active. A node with an exclamation point in a red circle
means that the node is stopped or its state is unknown.
Node Actions
To perform actions on a node, select its checkbox. The action menu (Selected menu in 11.2) becomes available, displaying all available actions. Please note that your options may differ according to your user permissions, which are managed by an admin.
See the below table for an explanation of all node actions.
| Menu option | Description |
| Show Object Attributes | Displays node details. |
| Show Topology | Displays a topology of the node's objects. |
| Create Queue Manager | Create a queue manager within the node. See Create Queue Manager for more information. |
| Events | Displays the node's events. |
| Manage |
Signifies if a node is managed (displays with a check mark). Managed nodes can be discovered. Select the Manage option to activate an inactive node. Deselect this option to make a node inactive. When deselected, the Delete and Properties options become available in the node menu.
Note: An active node may need to be reactivated by deselecting and re-selecting the Manage option.
|
| Commands |
The Commands submenu includes options for starting or stopping WMQ objects, and for shutting down the node. See Starting and stopping WMQ Objects (Nodes) for more information. |
| Discover Now > |
Incremental: The workgroup server maintains the last discovery time for each queue manager and sends this time with each discovery command. Incremental discovery logic will work only if initial discovery is completed and queue managers are fully discovered. Full: When the workgroup server starts up, it sends a query on every object to the agent. The workgroup server re-connects to each agent and sends an EXCMD_MQ_DISCOVER command. Since the agent thread or process for a given queue manager has just started, while servicing the discover command, the agent allows every inquire object reply from the IBM WMQ command server to be sent to the WGS. Note: The Discover Now feature also applies to Queue Managers and works the same way as for Nodes. |
| Delete | Displays in the menu when the node is not active (unmanaged). Deletes the selected node. |
| Properties | Opens the Properties dialog where you can view and/or edit the node’s configurations. This option is available in the menu when the node is inactive (unmanaged). See Node Properties for more details. |
Creating Nodes
See Create a node for information on how to create a node.
Adding a Node Viewlet
Node viewlets can be added to any dashboard. See Adding a viewlet to your dashboard for more information.