Objects and actions

The operations and control panels offer you many different types of object and a number of actions that we can perform on them. The actions are listed on the initial panel and enable you to manipulate the objects and display information about them. These objects include all the WebSphere MQ objects, together with some extra ones. The objects fall into the following categories.

 

Queues, processes, authentication information objects, namelists, storage classes and CF structures

These are the basic WebSphere MQ objects. There can be many of each type. They can be listed, listed with filter, defined, and deleted, and have attributes that can be displayed and altered, using the LIST or DISPLAY, LIST with FILTER, DEFINE LIKE, MANAGE, and ALTER actions. (Objects are deleted using the MANAGE action.)

This category consists of the following objects:

QLOCAL Local queue
QREMOTE Remote queue
QALIAS Alias queue for indirect reference to a queue
QMODEL Model queue for defining queues dynamically
QUEUE Any type of queue
QSTATUS Status of a local queue
PROCESS Information about an application to be started when a trigger event occurs
AUTHINFO Authentication information: definitions required to perform Certificate Revocation List (CRL) checking using LDAP servers
NAMELIST List of names, such as queues or clusters
STGCLASS Storage class
CFSTRUCT Coupling Facility (CF) structure
CFSTATUS Status of a CF structure

 

Channels

Channels are used for distributed queuing. There can be many of each type, and they can be listed, listed with filter, defined, deleted, displayed, and altered. They also have other functions available using the START, STOP and PERFORM actions. PERFORM provides reset, ping, and resolve channel functions.

This category consists of the following objects:

CHANNEL Any type of channel
SENDER Sender channel
SERVER Server channel
RECEIVER Receiver channel
REQUESTER Requester channel
CLUSRCVR Cluster-receiver channel
CLUSSDR Cluster-sender channel
SVRCONN Server-connection channel
CLNTCONN Client-connection channel
CHSTATUS Status of a channel connection

 

Cluster objects

Cluster objects are created automatically for queues and channels that belong to a cluster. The base queue and channel definitions can be on another queue manager. There can be many of each type, and names can be duplicated. They can be listed, listed with filter, and displayed. PERFORM, START, and STOP are also available through the LIST actions.

This category consists of the following objects:

CLUSQ Cluster queue, created for a queue that belongs to a cluster
CLUSCHL Cluster channel, created for a channel that belongs to a cluster
CLUSQMGR Cluster queue manager, the same as a cluster channel but identified by its queue manager name

Cluster channels and cluster queue managers do have the PERFORM, START and STOP actions, but only indirectly through the DISPLAY action.

 

Queue manager and security

Queue manager and security objects have a single instance. They can be listed, and have attributes that can be displayed and altered (using the LIST or DISPLAY, and ALTER actions), and have other functions available using the PERFORM action.

This category consists of the following objects:

MANAGER Queue manager - the PERFORM action provides suspend and resume cluster functions
SECURITY Security functions - the PERFORM action provides refresh and reverify functions

 

Connection

Connections can be listed, listed with filter and displayed.

This category consists only of the connection object, CONNECT.

 

System

A collection of other functions. This category consists of the following objects:

SYSTEM System functions
CONTROL Synonym for SYSTEM

The functions available are:

LIST or DISPLAY Display queue-sharing group, distributed queuing, page set, or data set usage information.
PERFORM Refresh or reset clustering
START Start the channel initiator or listeners
STOP Stop the channel initiator or listeners

 

Actions

The actions that we can perform for each type of object are shown in the following table:

Table 2. Valid operations and control panel actions for WebSphere MQ objects
Object Alter Define like Manage (1) List or Display List with Filter Perform Start Stop
AUTHINFO X X X X X
CFSTATUS X
CFSTRUCT X X X X X
CHANNEL X X X X X X X X
CHSTATUS X X
CLNTCONN X X X X X
CLUSCHL X X X(2) X(2) X(2)
CLUSQ X X
CLUSQMGR X X X(2) X(2) X(2)
CLUSRCVR X X X X X X X X
CLUSSDR X X X X X X X X
CONNECT X X
CONTROL X X X X
MANAGER X X X
NAMELIST X X X X X
PROCESS X X X X X
QALIAS X X X X X
QLOCAL X X X X X
QMODEL X X X X X
QREMOTE X X X X X
QSTATUS X X
QUEUE X X X X X
RECEIVER X X X X X X X X
REQUESTER X X X X X X X X
SECURITY X X X
SENDER X X X X X X X X
SERVER X X X X X X X X
SVRCONN X X X X X X X
STGCLASS X X X X X
SYSTEM X X X X
Note:

  1. Provides Delete and other functions

  2. Using the List or Display action