Administer MQIPT by using the command line
If you choose not to use the IPT Administration Client, we can use the command line to administer and configure MQIPT.
Use an editor of choice, change the configuration file, mqipt.conf, to meet your requirements. See Configuration reference information for a list of the properties we can change.
If the [global] section of mqipt.conf specifies a value for CommandPort, MQIPT listens on this port for commands from the mqiptAdmin script:
mqiptAdmin -refresh {hostname {port} } sends the refresh command
mqiptAdmin -stop {hostname {port} } sends the stop command
The mqiptAdmin script is in the bin subdirectory.
If we do not provided values for hostname and port, hostname defaults to localhost and port defaults to 1881.
- refresh
-
MQIPT rereads mqipt.conf and takes the following actions:
- If any of the routes currently active are marked as inactive (or are no longer specified), MQIPT closes those routes and stops listening for incoming connections on them.
- Any routes marked active in the configuration file that it does not currently have running, it starts them up.
- if the configuration parameters of a currently running route have changed, MQIPT applies the changed values to those routes. Where possible (for example, a change to the setting of trace) it does this without disruption to running connections. For some parameter changes (for example, a change to a destination), MQIPT has to close all connections before effecting the change and restarting the route.
- stop
-
MQIPT closes all connections, stops listening for incoming connections, and then exits.
This command is ignored unless the mqipt.conf file specifies RemoteShutDown=true.
Use the MQIPT Stop menu option of the IPT Administration Client has the same effect.
Note: On Windows systems, these administrative functions are also available from the Start > Programs menu.