HP OpenVMS Systems Documentation

Provides information about the queue manager(s) on the system or OpenVMS Cluster.

Format

SHOW QUEUE/MANAGERS [queue-manager-name]

Parameter

queue-manager-name

Specifies the name of the queue manager for which you want information displayed. The asterisk (*) and the percent sign (%) wildcard characters are allowed. The default value for the queue-manager-name parameter is the asterisk (*) wildcard character. If no queue manager name is specified, information on all queue managers is displayed.

Description

The SHOW QUEUE/MANAGERS command displays information about the queue manager(s) on the system or OpenVMS Cluster. The command assumes the /BRIEF qualifier as the default, and displays a one-line description that includes each queue manager's name, status, and process node name. The /FULL qualifier displays the following information:

• Full file specification of the queue database master file (disk, directory, and file name of the shared master file)
• Name of queue manager
• Status of queue manager
• The node name on which the queue manager process is running (if the queue manager process is currently running)
• Prioritized list of nodes on which the queue manager process can run
• Disk and directory containing the queue database files specific to the particular queue manager

If a queue manager process is not running, the current location node name will not be displayed for that queue manager.

The queue manager status can be one of the following:

State	Description
Start pending	The queue manager process is attempting to start up, however, it is waiting for a node on which it can run to enter the cluster.
Starting	The queue manager is in the process of starting up as a result of a START /QUEUE /MANAGER command or failing over from another node in the cluster.
Running	The queue manager is running.
Failing over	The queue manager is in the process of failing over to another node in the cluster.
Stopping	The queue manager is in the process of stopping.
Stopped	The queue manager is stopped and will not start until a START /QUEUE /MANAGER command is executed.

Qualifiers

/BRIEF

Displays a one-line description of queue manager(s) on the system or cluster. The information displayed includes the name and status of the queue manager and the node on which its process is running. The /BRIEF qualifier is present by default.

/FULL

Displays complete information about queue manager(s) on the system or cluster. The /FULL qualifier overrides the /BRIEF qualifier.

Examples

$ SHOW QUEUE/MANAGERS/FULL
Master file:  SYS$COMMON:[SYSEXE]QMAN$MASTER.DAT; 
 
Queue manager BATCHQ_MANAGER, running, on BBBBBB:: 
  /ON=(BBBBBB, AAAAAA, CCCCCC, EEEEEE, *) 
  Database location:  DISK1:[QUEUES] 
 
Queue manager PRINTQ_MANAGER, starting, on AAAAAA:: 
  /ON=(AAAAAA, BBBBBB, CCCCCC, EEEEEE, *) 
  Database location:  DISK2:[QUEUES] 
 
Queue manager SYS$QUEUE_MANAGER, running, on FFFFFF:: 
  /ON=(FFFFFF, EEEEEE, CCCCCC, BBBBBB, AAAAAA, *) 
  Database location:  DISK1:[QUEUES] 
 
Queue manager TRANSFER_MANAGER, stopped 
  /ON=(AAAAAA, BBBBBB, EEEEEE) 
  Database location:  DISK1:[TRANSFER] 
 
      

The SHOW QUEUE/MANAGERS/FULL command displays complete information about a queue manager on a system or cluster.

$ SHOW QUEUE/MANAGERS
Queue manager BATCHQ_MANAGER, running, on BBBBBB:: 
 
Queue manager PRINTQ_MANAGER, starting, on AAAAAA:: 
 
Queue manager SYS$QUEUE_MANAGER, running, on FFFFFF:: 
 
Queue manager TRANSFER_MANAGER, stopped 
 
      

The SHOW QUEUE/MANAGERS command in this example shows information about the queue manager in brief format. The /BRIEF qualifier is the default and does not need to be specified.

$ SHOW QUEUE/MANAGERS/FULL SYS$QUEUE_MANAGER
Master file:  SYS$COMMON:[SYSEXE]QMAN$MASTER.DAT; 
 
Queue manager SYS$QUEUE_MANAGER, running, on FFFFFF:: 
  /ON=(FFFFFF, EEEEEE, CCCCCC, BBBBBB, AAAAAA, *) 
  Database location:  DISK1:[QUEUES]
 
      

The command, SHOW QUEUE/MANAGERS/FULL SYS$QUEUE_MANAGER, in this example shows a request for a specific queue manager by name.