mqsilist (list resources) command

Supported platforms

Purpose

On Windows platforms, Linux, and UNIX systems, use the mqsilist command to list all the components installed on the system, all the execution groups defined to a specific broker, or all the message flows contained in a named execution group on a specific broker.

On Windows platforms, Linux, and UNIX systems, the output is directed to stdout.

From a z/OS console, use the list command to list all the execution groups defined to a specific broker, or all the message flows contained in a named execution group on a specific broker.

Syntax

Windows platforms, Linux, and UNIX systems

If you do not specify any parameters when you issue this command, a list of components and queue manager names is displayed for each component created on this system, in the form:
BIP8099I: Broker: brokername - queuemanagername
BIP8099I: ConfigMgr: configmgrname - queuemanagername
BIP8099I: UserNameServer: UserNameServer - queuemanagername
BIP8071I: Successful command completion

z/OS

Synonym: l

If you do not specify any parameters when you issue this command, a list of the execution groups is displayed.

You issue the list command only against a broker task name. For example:
F MQP1BRK,list
The output is the list of execution groups and process IDs in the form:
BIP8130I: Execution Group: <name> -<process ID> 
BIP8071I: Successful command completion
If you specify an execution group, for example:
F MQP1BRK, list e='exgrp1'		
the output is a list of message flows in the form:
BIP8131I: Messageflow: <MessageFlowName> 
BIP8071I: Successful command completion

Parameters

Windows platforms, Linux, and UNIX systems

-a
(Optional) List all the components installed on the system.
If you use this option on brokers from a previous release of the product, you obtain the following message:
BIP8221I: <Component>: <ComponentName> (<Version>) - <Queue Manager>  
brokername
(Optional) The name of the broker for which you want to list resources. This must be a deployed broker. A list of execution groups configured on this broker and the process ID (pid) of each is displayed.

All platforms

-e egroup
(Optional) Selects an execution group within a broker. Specify the label of the execution group for which you want to list message flows. The command returns a list of message flows assigned to the specified execution group within the broker.

The broker specified must be active for any message flow information to be returned.

Authorization

On Linux and UNIX systems, the user ID must be a member of the mqbrkrs group.

On Windows platforms, if you have specified a broker name and the -e flag, the user ID used to invoke this command must have mqbrkrs group membership.

Responses

  • BIP8013 Component does not exist
  • BIP8020 Unable to access database
  • BIP8029 Broker not configured
  • BIP8038 Unsupported command option
  • BIP8039 Execution group not available
  • BIP8040 Unable to connect to database
  • BIP8158 Invalid format for command (z/OS only)
  • BIP8159 Unknown parameter "..." (z/OS only)

Examples

Windows platforms, Linux, and UNIX systems:
mqsilist WBRK_BROKER -e DefaultEG
mqsilist DatabaseInstanceMgr
z/OS
F MQP1BRK,list e='exgrp1'
Related tasks
Verifying components