Use the mqsimode command to configure and retrieve operation mode information.
Use the mqsimode command to change the operation mode of an integration node, or to retrieve information about the mode in which the integration node is currently working.
>>-mqsimode--| integrationNodeSpec |--+---------------------+---> '- -o --operationMode-' >--+-------------------+--+---------------------+---------------> '- -w --timeoutSecs-' '- -v --traceFileName-' >--+----------------------+------------------------------------>< '- -x --modeExtensions-' integrationNodeSpec |--+- integrationNodeName ---------+----------------------------| +- -n --integrationNodeFileName-+ +- -i --ipAddress-- -p --port---+ '-+- -i --ipAddress-+-----------' '- -p --port------'
Use this option if multiple users want to connect to the same integration node, or if you are using advanced connection parameters such as SSL. To learn more about creating and using a .broker file, see Connecting to an integration node by creating a .broker file.
If you want to run a command that uses SSL to administer a remote integration node over a secured channel, you must specify the keystore and truststore password for the connection that is using the IBM_JAVA_OPTIONS environment variable. For more information, see Resolving problems when running commands.
Use this option for connections to remote integration nodes that do not require advanced connection parameters.
If you are connecting to a remote integration node, you can additionally prefix integrationNodeName to explicitly set which integration node to connect to. You cannot use -n integrationNodeFileName in the same command.
Parameters that you omit assume default values:
If you want to connect to a secured integration server as a specific user, provide the security credentials as a URI in the following format: tcp://user:password@hostname. If your password contains URI Reserved characters, you must convert these characters to the percent-encoded format. For more information, see A correct URL and password returns error BIP1939 when you attempt to connect to a remote host name in Resolving problems when running commands.
If you have purchased a license for the Standard Edition, you are entitled to run your integration nodes in either standard or scale mode.
If the mode extension is DecisionServices, you do not need to specify the integration node name. If you do specify an integration node name, it is ignored.
In previous versions of IBM Integration Bus, you might have used the -q parameter for this command to define a connection to a queue manager. A queue manager connection is no longer used to connect to an integration node. The -q parameter is now deprecated, and is ignored if used. If you use the -q parameter, a BIP1922 warning is displayed.
Running the mqsimode command specifying the -o parameter
When you run the mqsimode command for integration node INODE1, and specify the -o parameter, the mode is updated, and you receive a report about all errors. For example, if you run the following mqsimode command to change your integration node to the Remote Adapter Deployment mode, and your integration node is in the following state:mqsimode INODE1 -o adapter
You receive
the following messages:BIP1045: Connecting to the integration node...
BIP1805: The mode for integration node 'integrationNodeName' has been changed to 'adapter'.
BIP1823: WARNING: Integration node 'integrationNodeName' has a message flow called 'Message_Flow'
in integration server 'Integration_Server', which contains one or more nodes that are not
valid in this mode: Node_Type.
BIP8229: The command completed with the following number of warnings: 1.
Running the mqsimode command without the -o parameter
When you run the mqsimode command without the -o parameter, you receive a report about the mode being used by your integration node, a report about all mode violations, and a report for any mode extensions that are required and not set. For example, if you run the following mqsimode command, and your integration node is in the following state:mqsimode integrationNodeName
You
receive the following messages:BIP1807: Discovering mode information from integration node 'integrationNodeName'...
BIP1802: Integration node 'integrationNodeName' is in 'standard' mode.
BIP8071: Successful command completion.
Switching off all mode extensions
To switch off all mode extensions, run the mqsimode command with the -x parameter:mqsimode integrationNodeName -x
where
integrationNodeName is
the name of your integration node.