Use the mqsichangebroker command on Windows systems to modify your broker.
>>-mqsichangebroker-- BrokerName -------------------------------> >--+---------------------------------------------------+--------> '- -a --servicePassword --+-----------------------+-' '- -i -- serviceUserId -' >--+------+--+-------------------+------------------------------> +- -t -+ '- -l --userLilPath-' '- -n -' >--+----------------------------------+-------------------------> '- -g --configurationChangeTimeout-' >--+------------------------------------+-----------------------> '- -k --internalConfigurationTimeout-' >--+------------------------+-----------------------------------> '- -P --httpListenerPort-' >--+-------------------------------+----------------------------> '- -v --statisticsMajorInterval-' >--+------------------------------------------+-----------------> '- -y--ldapPrincipal-- -z--ldapCredentials-' >--+--------------------------+--+--------------------+---------> '- -c --ICU converter path-' '- -x --userExitPath-' >--+-----------------------+--+----------------------+----------> '- -e --activeUserExits-' '- -f --function level-' >--+--------------------+--+---------------------+--------------> '- -s --+-active---+-' '- -d --+-defined---+-' '-inactive-' '-undefined-' >--+-------------------+--+----------------------+--------------> '- -b --cachePolicy-' '- -r --cachePortRange-' >--+-----------------------------------+----------------------->< '- -4 --integrationRegistryHostname-'
(Required) This parameter must be the first parameter. Specify the name of the broker to modify.
You can specify the serviceUserId in any valid user name syntax:
username
.\username
username@domain
domain\username
\\server\username
If you use the unqualified form for this user ID (username), the operating system searches for the user ID throughout its domain, starting with the local system. This search might take some time to complete.
The serviceUserId that you specify must be a direct or indirect member of the mqbrkrs local group. The serviceUserId must also be authorized to access the home directory (where IBM® Integration Bus has been installed), and the working directory (if specified by the -w parameter).
If you specify that the broker is to run as a WebSphere® MQ trusted application (-t parameter), you must also add the service user ID to the mqm group.
The security requirements for the serviceUserId are described in Security requirements for Windows systems.
For more details about using WebSphere MQ trusted applications, see the Intercommunication section of the WebSphere MQ Version 7 product documentation online.
(Optional) The broker ceases to run as a WebSphere MQ trusted application.
Create your own directory for storing your .lil or .jar files. Do not save them in the IBM Integration Bus installation directory.
If you specify more than one additional directory, each directory must be separated by the default platform-specific path separator.
A message flow cannot respond to a configuration change while it is processing an application message. An integration server returns a negative response to the deployed configuration message if any one of its message flows does not finish processing an application message and apply the configuration change within this timeout.
Specify the value in seconds, in the range 10 - 3600. The default is 300.
For information about how to set the value for this timeout, see Setting configuration timeout values.
The response time of each integration server differs according to system load and the load of its own processes. The value must reflect the longest response time that any integration server takes to respond. If the value is too low, the broker returns a negative response, and might issue error messages to the local error log.
Specify the value in seconds, in the range 10 - 3600. The default is 60.
For information about how to set the value for this timeout, see Setting configuration timeout values.
The broker starts this listener when a message flow that includes HTTP nodes or Web services support is started; the default is 7080.
Ensure that the port that you specify has not been specified for any other purpose.
mqsichangebroker <brokername> ""
This command does not disable all new features, and it is not possible to use this flag to run the broker at a different major version.
This option is an alternative to starting a multi-instance broker in standby mode using the mqsistart command.
If you specify -d defined, the WebSphere MQ service is defined to the queue manager and the broker starts and stops when the queue manager starts and stops.
If you specify -d undefined, the WebSphere MQ service is not defined to the queue manager and the broker does not start and stop when the queue manager starts and stops. This is the default setting.
To change other broker properties, first delete and re-create the broker, and then use the IBM Integration Toolkit to redeploy the broker configuration. If you want to update the user ID credentials that the broker uses to access one or more databases from deployed message flows, use the mqsisetdbparms command. For more information, see Accessing databases from message flows.
mqsichangebroker IB9NODE -x /opt/3rdparty/wmbexit
mqsichangebroker IB9NODE -f 9.0.0.3
mqsichangebroker IB9NODE -s active
mqsichangebroker IB9NODE -d defined
mqsichangebroker IB9NODE -d undefined