Use the mqsichangebroker command on Windows, Linux, and UNIX to modify your broker.
Before you start:
You
must have completed the following task for the appropriate platform:
To modify a broker on Windows, Linux, and UNIX:
- Stop the broker by using the mqsistop command.
- Enter the mqsichangebroker command, specifying
the broker name and one or more parameters that you want to change.
mqsichangebroker brokername
<<-i ServiceUserID> -a ServicePassword>
<-t | -n> <-l UserLilPath>
<-g ConfigurationTimeout> <-k ConfigurationDelayTimeout>
<-v StatisticsMajorInterval> <-P httpListenerPort> <-y ldapPrincipal>
<-z ldapCredentials> <-c ICUconverterpath> <-x userExitPath>
<-e activeUserExits> <-o operationMode> <-f functionlevel>
where:
- brokername
- Is the broker name.
- -i
- Is the service user ID that is used to run the broker (applicable on Windows only).
- -a
- Is the password for the service user ID (applicable
on Windows only).
- -t
- Indicates that the broker runs as a WebSphere MQ trusted application.
- -n
- Indicates that the broker must cease to run as a WebSphere MQ trusted application.
- -l
- Indicates from where LIL (loadable implementation libraries) files
are loaded.
- -g
- Is the maximum time (in seconds) to allow a broker to process
a deployed message.
- -k
- Is the maximum time (in seconds) to allow a broker to process
a minimum size deployed message.
- -v
- Is the time (in minutes) for the duration of the interval for
collecting statistics archive records.
- -P
- Is the port that the broker HTTP listener will use.
The
broker starts this listener when a message flow that includes HTTP
nodes or Web Services support is started
- -y
- Is the user principal for access to an LDAP directory.
- -z
- Is the user password for access to LDAP.
- -c
- Is a delimited set of directories to search for additional code
page converters.
- -x
- Is the path that contains the location of all
user exits to be loaded for execution groups in this broker.
- -e
- Is the list of active user exits.
- -o
- Is the operation
mode that the broker
will use.
- -f
- Indicates the maximum function level of your broker that you want
to enable.
- -s
- Indicates whether broker administration security is enabled.
For example:- To change the user ID that is used to run the broker on Windows,
enter the following command:
mqsichangebroker MB8BROKER -i wbrkuid -a wbrkpw
- To change the configuration timeout, enter the following command:
mqsichangebroker MB8BROKER -g 500
- To activate broker administration security,
enter the following command:
mqsichangebroker MB8BROKER -s active
For further information about these parameters,
and more examples, see mqsichangebroker command - Linux and UNIX systems and mqsichangebroker command - Windows systems.
- Restart the broker by using the mqsistart command. The broker
restarts with the new properties.
You cannot change
all the parameters with which you created a broker. If you cannot
change a property by using the mqsichangebroker command, delete
the broker and create another broker with the new properties.