 |
HP OpenVMS DCL Dictionary
SHOW QUEUE/MANAGERS
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
| #1 |
$ 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.
| #2 |
$ 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.
| #3 |
$ 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.
|
