mqsicreateexecutiongroup command

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

Supported platforms

Purpose

You must start the Configuration Manager before you can issue the mqsicreateexecutiongroup command.

Start of changeYou can use the mqsicreateexecutiongroup command to add a new broker to the Configuration Manager.End of change

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.
Start of change-sEnd of change
Start of change(Optional) Create a 32 bit execution group.End of change
-l
(Optional) Create a 64 bit execution group.
-n CfgParameterFileName
(Optional) This parameter specifies the name of a .configmgr file that describes the connection parameters to the Configuration Manager.
The file is in XML, using the .configmgr format that is saved by the workbench; for example:
<?xml version="1.0" encoding="UTF-8"?>
<configmgr crlNameList="" domainName="" host="winmvsd0" listenerPort="2206" 
queueManager="mq06" securityExit="" securityExitJar="" sslCipherSuite="NONE" 
sslDistinguishedNames="" sslKeyStore="" sslTrustStore="" svrconn="SYSTEM.BKR.CONFIG"/>
If you are using this file on z/OS you must remove the statement encoding="UTF-8" from the first line, and remove the value for the host attribute, to leave the statement as:
<?xml version="1.0"?>
<configmgr crlNameList="" domainName="" host="" listenerPort="2206" 
queueManager="mq06" securityExit="" securityExitJar="" sslCipherSuite="NONE" 
sslDistinguishedNames="" sslKeyStore="" sslTrustStore="" svrconn="SYSTEM.BKR.CONFIG"/>
Note: If you do not supply this parameter, you must supply the -i, -p, and -q parameters.
-i IpAddress
(Optional) This parameter specifies the host name or IP address of the Configuration Manager.

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

-p Port
(Optional) This parameter is the port number of the Configuration Manager.
-q QMgr
(Optional) This parameter specifies 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 -n parameter.

-w TimeoutValue
(Optional) This parameter is the time in seconds that the utility waits to ensure that the command completed; the default value is 60.
-v TraceFileName
(Optional) This parameter sends internal debug trace information to the specified file.

Authorization

On Windows, Linux, and UNIX systems, the user ID used to run this command must be a member of the group mqm.

The command succeeds only if this user ID has the correct authority defined in the access control list for the Configuration Manager. 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

The mqsicreateexecutiongroup 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 the Configuration Manager with an associated queue manager called QMGR, which 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
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Last updated : 2009-01-07 15:22:38

an26000_