mqsilist (list resources) command

Supported platforms

  • Windows 2000, Windows XP
  • UNIX platforms
  • z/OS

Purpose

On Windows platforms and UNIX platforms, 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 and UNIX platforms, 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 and UNIX platforms

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: brokername - queuemanagername
BIP8099I: ConfigMgr - queuemanagername
BIP8099I: 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 and UNIX platforms

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 UNIX platforms, 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 and UNIX platforms:
mqsilist WBRK_BROKER -e DefaultEG
z/OS
F MQP1BRK,list e='exgrp1'
Related tasks
Verifying components
Related reference
Syntax preference