mqsicreateexecutiongroup command

Supported platforms

Purpose

Use the mqsicreateexecutiongroup command to add a new execution group to a broker.

You must start the Configuration Manager, using mqsistart on Windows platforms, Linux, and UNIX systems, or startcomponent on z/OS, (see mqsistart command) before you can issue this command.

The broker must be defined in the Configuration Manager before this command can be used.

Syntax

Parameters

-b BrokerName
(Required) The name of the broker on which to create the execution group.
-e ExecutionGroupName
(Required) The name of the new execution group.
-l
(Optional) Create a 64 bit execution group.
-n cfgParameterFileName
(Optional) The name of a .configmgr file that describes the connection parameters to the Configuration Manager.
The file is in XML, using the .configmgr format saved by the workbench. For example:
<?xml version="1.0" encoding="UTF-8"?>
<configmgr host="localhost" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
If you are using this file on z/OS you must remove the statement encoding="UTF-8" from the first line, to leave the statement as:
<?xml version="1.0"?>
and remove the value for the host attribute, to leave the statement as:
<configmgr host="" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
Note: If you do not supply this parameter, you must supply the -i, -p, and -q parameters.
-i ipAddress
(Optional) The host name or IP address of the Configuration Manager.

If you are using this file on z/OS and want to connect to the local host you must set the value to "".

-p Port
(Optional) The port number of the Configuration Manager.
-q qMgr
(Optional) The name of the WebSphere MQ queue manager that the Configuration Manager is using.

If you do not supply the -i, -p, and -q parameters, you must specify the -connection parameter.

-w timeoutValue
(Optional) The time in seconds to wait before the execution group is created; the default value is 60.
-v TraceFileName
(Optional) Sends the verbose internal trace to the specified file.

Authorization

You need to be a member of the 'mqm' group and the command only succeeds if the user Id running the command has the correct authority defined in the Configuration Manager’s access control list.

In order to create an execution group, full control authority is required over the broker object; see ACL permissions for a list of permissions that can be defined in the Configuration Manager.

Responses

This command returns the following responses:
0
(Success) States that the request completed successfully and the execution group has been created successfully in the Configuration Manager's repository. The next time the broker is deployed, the new execution group list is initialized on the broker.
2
(Failure) States that the execution group could not be created for any reason.
98
States that the Configuration Manager cannot be reached.
99
States that the supplied arguments to the utility are not valid.

Examples

On the domain controlled by theConfiguration Manager whose queue manager is called QMGR and is listening on fred.abc.com:1414, create an execution group called ‘EG1’ on broker 'BROKER’.

   mqsicreateexecutiongroup -i fred.abc.com -p 1414 -q QMGR -b BROKER –e EG1

On the domain specified by the file domain1.configmgr, create an execution group called ‘EG2’ on broker 'BROKER’.

   mqsicreateexecutiongroup –n domain1.configmgr –b BROKER –e EG2 

On the domain specified by the file domain2.configmgr, create an execution group ‘EG3’ on broker ‘FRED’. Wait five minutes for the Configuration Manager to respond and send output to trace.txt.

  mqsicreateexecutiongroup –n domain2.configmgr –b FRED –e EG3 –w 300 –v trace.txt