IBM Integration Bus, Version 9.0.0.8 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

mqsireloadsecurity command - Windows, Linux, and UNIX systems

Use the mqsireloadsecurity command on Windows, Linux, and UNIX to force the immediate expiry of some or all of the entries in the security cache.

Syntax


>>-mqsireloadsecurity--| brokerSpec |--+------------------+----->
                                       '- -u --useridList-'   

>--+-------------------+---------------------------------------><
   '- -w --timeoutSecs-'   

brokerSpec

|--+- brokerName ----------------+------------------------------|
   +- -n --brokerFileName--------+   
   | .-------------------------. |   
   | V                         | |   
   '-----+- -i --ipAddress-+---+-'   
         +- -p --port------+         
         '- -q --qMgr------'

Parameters

brokerSpec

(Required) You must specify at least one parameter to identify the target broker for this command, in one of the following forms:

brokerName

This parameter identifies the name of a locally defined broker. You cannot use this option if the broker is on a remote computer.

-n brokerFileName

This parameter identifies the name of a file that contains the connection details for a local or remote broker.

Use this option if multiple users want to connect to the same broker, or if you are using advanced connection parameters such as SSL.

To create this file, right-click the broker in the IBM® Integration Explorer and select Export *.broker file. When prompted, navigate to the location in which you want to save the file and enter the file name; the extension .broker is appended automatically when you click Save. Include the location (path) and file name when you specify this parameter. You must ensure that the location is accessible when you run this command.

If you want to run a command that uses SSL to administer a remote broker over a secured channel, you must specify the keystore and truststore password for the connection using the IBM_JAVA_OPTIONS environment variable. See Resolving problems when running commands for further information.

-i ipAddress, -p port, -q qMgr

These parameters identify the connection details for the broker.

Use this option for connections to remote brokers that do not require advanced connection parameters.

If you choose this option, you must specify at least one of these three parameters; the order in which you specify them is insignificant. You cannot specify each parameter more than once.

Parameters that you omit assume default values:

-i ipAddress: The host name or the IP address of the computer on which the broker is running. If you do not specify this parameter, a value that represents the local computer is used.
-p port: The TCP port on which the broker's queue manager is listening. If you do not specify this parameter, the value 1414 is used.
-q qMgr: The name of the broker's queue manager. If you do not specify this parameter, a value that represents the default queue manager on the local computer is used.

-u useridList

(Optional) This parameter reloads all entries in the security cache for the specified list of users (separated by colons). If you do not specify this parameter, all entries in the security cache are reloaded. For cached certificates, this value is the common name element value.

-w timeoutSecs

(Optional) This parameter specifies the time in seconds that the utility waits to ensure that the command completed; the default value is 60.

Examples

Reload the cache for all users on the specified broker. :

mqsireloadsecurity BROKER1

Reload the cache for a single user on the specified broker. The connection parameters for the broker are defined in the file BROKER1.broker.

mqsireloadsecurity -n BROKER1.broker -u user1

Reload the cache for a list of users, and wait for 600 seconds before returning. The wait time is based on a broker that is configured with a lower wait time, so that the broker does not finish processing before the -w parameter value. For more information, see Setting configuration timeout values.

mqsireloadsecurity My_Broker -u user1:user2:user3 -w 600

an28610_.htm |

Last updated Friday, 21 July 2017