Global properties

The mqipt.conf configuration file can contain a number of global properties.

The following properties can appear only in the [global] section of mqipt.conf. All the route properties except ListenerPort, Destination, DestinationPort, Name, and OutgoingPort can also appear in the [global] section. If a property appears in both route and [global] sections, the value of the property in the [route] section overrides the global value, but only for the route in question. In this way, the [global] section can be used to establish the default values to be used for those properties not set in the individual [route] sections.

AccessPW

The password used when an IPT Administration Client sends commands to the MQIPT. If this property is not present or is set to blank, no checking takes place.

CommandPort

The TCP/IP port on which MQIPT listens for configuration commands from the mqiptAdmin utility or the IPT Administration Client. We can change the command port from the IPT Administration Client in the same way as any other property. Note that we do not change the connection properties. When you apply the new setup to MQIPT, the IPT Administration Client changes the connection properties automatically.

If the CommandPort property is not present, MQIPT does not listen for configuration commands. To use the default port number, 1881, used by default by both the IPT Administration Client and by the mqiptAdmin script from the command line, set CommandPort to 1881. This value is set for you if we use the mqiptSample.conf configuration file.

ConnectionLog

Either true or false. When true, MQIPT logs all connection attempts (successful or otherwise) in the logs subdirectory and disconnection events to the file mqiptYYYYMMDDHHmmSS.log (where YYYYMMDDHHmmSS are characters representing the current date and time). The default value of ConnectionLog is true. When this property is changed from true to false, MQIPT closes the existing connection log and creates a new one. The new log is used when the property is reset to true.

MaxLogFileSize

The maximum size (specified in KB) of the connection log file. When the file size increases above this maximum a backup copy (mqipt001.log) is made, and a new file is started. Only two backup files are kept (mqipt001.log and mqipt002.log); each time the main log file fills up, any earlier backups are erased. The default value of MaxLogFileSize is 50; the minimum allowed value is 5.

RemoteShutDown

Either true or false. When true (and when there is a command port) MQIPT shuts down whenever a stop command is received on the command port. The default value is false.

SecurityManager

Set this property to true to enable the Java Security Manager for this instance of MQIPT. You must ensure that the correct permissions are granted. See Java Security Manager for more information. The default value for this property is false.

SecurityManagerPolicy

The fully-qualified file name of a policy file. If this property is not set then only the default system and user policy files are used. If the Java Security Manager is already enabled, then changes to this property have no effect until the Java Security Manager has been disabled and reenabled.

Trace

The level of trace for global MQIPT threads that are not associated with a route, and for routes that have no Trace property set. For example, the main MQIPT control thread and the command port listener thread are not associated with a route and are only traced if trace is enabled in the [global] section. The value of the Trace property in a [route] section overrides the global Trace property, for that route. For information about tracing threads associated with a route, see Trace in the [route] section.

This property should be an integer in the range 0 - 5, where 0 indicates that trace is disabled, and any other value indicates that trace is enabled. The default value is 0.