List of MQIPT MQC messages

MQCAE001 Unknown host: {0}

Explanation

The MQIPT host cannot be found.

User response

Check the host name was specified correctly. Try to PING the host name or use its IP address.

MQCAE002 The following error was reported by the system: {0}

Explanation

An error has occurred while communicating with an MQIPT.

User response

Review the text of the error message and take the appropriate action.

MQCAE005 No valid destination address has been defined

Explanation

When adding a route, the destination field has been left blank.

User response

Enter a valid destination address.

MQCAE006 No valid destination port has been defined

Explanation

When adding a route, the destination port address field has been left blank.

User response

Enter a valid destination port address.

MQCAE007 No valid listener port has been defined

Explanation

When adding a route, the listener port address field has been left blank.

User response

Enter a valid listener port address, between 1 - 65535.

MQCAE008 No valid network address has been defined

Explanation

When adding an MQIPT, the network address field has been left blank.

User response

Enter a valid network address.

MQCAE009 No valid command port has been defined

Explanation

When adding an MQIPT, an invalid command port address has been used.

User response

Enter a valid command port address, between 1 - 65535.

MQCAE010 Could not show online help

Explanation

The file for online help was available but could not be displayed.

User response

Make sure that Netscape is installed and available in the system PATH environment variable.

MQCAE011 Could not parse parameter

Explanation

There has been an internal error that caused an attempt to be made to update a nonexistent parameter in the table.

User response

If the condition persists contact IBM® Software Support.

MQCAE012 Could not find online help file {0}

Explanation

File "passtfrm.htm" could not be found.

User response

Make sure this file is accessible in the doc language subdirectory.

MQCAE013 Interrupted while trying to show online help

Explanation

A system error occurred while displaying the online help.

User response

Try again. Contact IBM Software Support if the condition persists.

MQCAE015 The password we have just entered has not been recognized

Explanation

The MQIPT expects a valid password, and the one used in the last command was incorrect. It must match that defined in the configuration file.

User response

Change the password using the menu MQIPT->Connection panel and retry the last command again.

MQCAE016 Node mismatch

Explanation

There is an internal inconsistency between the node selected on the tree and the data held in memory.

User response

Close the Administration Client and retry the command again. Contact IBM Software Support if the condition persists.

MQCAE017 Could not create NLS text for message {0}

Explanation

No NLS text has been found for the defined message number.

User response

The guiadmin.properties file may have become corrupted and the specified message number could not be found. Check the following:

look in the Readme file for a possible new message
guiadmin.properties file is in the guiadmin.jar file
the message number is in the guiadmin.properties file

MQCAE019 You have failed to repeat your proposed new password

Explanation

When changing the password, it has not been entered twice, for verification.

User response

Enter the new password again in the appropriate field.

MQCAE020 Failed to change MQIPT access parameters

Explanation

An internal error has been detected while trying to change MQIPT access parameters.

User response

Close the Administration Client and try the command again. If the condition persists contact IBM Software Support.

MQCAE021 Internal failure to identify MQIPT

Explanation

An internal error has been detected while trying to save a configuration file on an MQIPT.

User response

Close the Administration Client and try the command again. If the condition persists contact IBM Software Support.

MQCAE022 Internal failure to save MQIPT configuration

Explanation

An internal error has been detected while trying to save a configuration file on an MQIPT.

User response

Close the Administration Client and try the command again. If the condition persists contact IBM Software Support.

MQCAE023 MQIPT {0} did not recognize your password

Explanation

The MQIPT expects a valid password, and the one used in the last command was incorrect. It must match that defined in the configuration file.

User response

Change the password using the menu MQIPT->Connection panel and retry the last command again.

MQCAE024 MQIPT {0} has not recognized the command

Explanation

The Administration Client has sent a command to the MQIPT which it has not recognized.

User response

Make sure the version of code used by the Administration Client is the same as the MQIPT.

MQCAE025 MQIPT {0} has failed to send configuration file

Explanation

The MQIPT attempted to send the configuration file, but failed.

User response

Close the Administration Client and retry the command. If this still fails, stop and restart the MQIPT.

MQCAE026 Remote shutdown is disabled on MQIPT {0}

Explanation

An attempt to shut down the MQIPT remotely has failed because remote shutdown was not enabled in the configuration file.

User response

To enable remote shutdown of MQIPT, edit the configuration file and set the RemotShutDown property to true.

MQCAE027 Look and feel {0} is not supported

Explanation

The recommended look and feel for the platform you are using is not available.

User response

Processing continues with the system default look and feel.

MQCAE028 Look and feel class {0} cannot be found

Explanation

The recommended look and feel for the platform you are using is not available.

User response

Processing continues with the system default look and feel.

MQCAE029 Must be non-negative and no bigger than Maximum Connection Threads

Explanation

The Minimum Connection Threads value must be less than or equal to the Maximum Connection Threads value.

User response

Change the value accordingly.

MQCAE030 Must be greater than zero and at least as big as Minimum Connection Threads

Explanation

The Maximum Connection Threads value must be greater than the Minimum Connection Threads value.

User response

Change the value accordingly.

MQCAE031 Port numbers must be in the range 0 to 65535

Explanation

You are attempting to set a value that does not meet the specification.

User response

Change the value accordingly.

MQCAE032 Trace must be in the range 0 to 5

Explanation

Trace must be in the range 0 to 5

User response

Change the value accordingly.

MQCAE033 Maximum Log Size must be in the range 5 to 50

Explanation

Max Log file size must be in the range 5 to 50

User response

Change the value accordingly.

MQCAE049 No route has been selected on any MQIPT

Explanation

An attempt has been made to delete a route without first selecting the route to be deleted.

User response

Select a route and retry the command again.

MQCAE050 Could not connect to MQIPT {0}

Explanation

The Administration Client could not connect to the specified MQIPT.

User response

This can be caused by any of the following :

MQIPT is not running
MQIPT is not listening on its CommandPort
Only one Administration Client is using the MQIPT CommandPort
The request has timed out.

MQCAE051 Could not read reply from MQIPT {0}

Explanation

A reply was received from the MQIPT that did not conform to the expected protocol.

User response

Make sure the version of code used by the Administration Client is the same as the MQIPT.

MQCAE052 Configuration has not been saved

Explanation

A valid reply was received from the MQIPT but it subsequently failed to save the configuration file.

User response

This can be caused by any of the following :

MQIPT does not have write access to the configuration file
The configuration file has been opened by another process
The disk is full

MQCAE053 MQIPT has not confirmed saving of configuration

Explanation

The configuration file has been sent to the MQIPT but the MQIPT failed to acknowledge it.

User response

This can be caused by any of the following :

MQIPT is not running
MQIPT is not listening on its CommandPort
Only one Administration Client is using the MQIPT CommandPort
The request has timed out

MQCAE054 MQIPT data has not been refreshed

Explanation

Contact has been made with the MQIPT but the Administration Client was unable to read the configuration file.

User response

This can be caused by any of the following :

MQIPT has failed
The request has timed out

MQCAE055 No MQIPT or route on an MQIPT has been selected

Explanation

Your chosen menu option cannot be performed because no MQIPT or route has been selected.

User response

Select an MQIPT or route and try again.

MQCAE056 Duplicate listener port has been rejected

Explanation

The specified listener port has been rejected because it is already being used by another route.

User response

Choose another listener port address.

MQCAI002 The MQIPT has been removed from display

Explanation

The MQIPT whose node you selected on the tree has been removed from the client's memory.

MQCAI003 New route added to the display

Explanation

The new route that we have just specified has been added to the current MQIPT.

MQCAI004 Route has been removed from the display

Explanation

The route that you selected on the tree has been removed from the client's memory.

MQCAI005 Selected MQIPT is being displayed

Explanation

The global parameters of the MQIPT that you selected on the tree are being shown in the table.

MQCAI006 Selected route is being displayed

Explanation

The parameters of the route that you selected on the tree are being shown in the table.

MQCAI007 Client configuration has been saved

Explanation

The access parameters for all the MQIPTs on the tree have been saved.

MQCAI008 Display of online help succeeded

Explanation

The online help has been displayed as requested.

MQCAI009 Table has been updated

Explanation

The value we have just entered on the table has been used to update the model in memory.

MQCAI010 No MQIPT or route has been selected

Explanation

No action has been taken because there is insufficient information on which to act.

MQCAI011 User action has been cancelled

Explanation

You have cancelled out of an action, involving a popup window, that you had previously initiated.

MQCAI014 Configuration has been saved on MQIPT

Explanation

A new configuration file has been saved on the MQIPT that is currently selected on the tree, and it has been used to restart the MQIPT.

MQCAI015 Online help has terminated

Explanation

The online help has been displayed as requested and subsequently terminated.

MQCAI017 Select File/Add MQIPT to add an MQIPT to the tree

Explanation

This message appears when there are no MQIPTs on the tree; it tells you how to add one.

MQCAI018 New MQIPT added to display

Explanation

A new MQIPT has been added to the tree as instructed.

MQCAI019 MQIPT access parameters have been changed

Explanation

The access parameters of the MQIPT that is currently selected on the tree have been changed.

MQCAI021 Select an MQIPT or route on the tree to display its contents

Explanation

This message appears when no information is being shown on the table; it tells you how to see some.

MQCAI022 The command port has changed

Explanation

The MQIPT whose command port was instructed to change has now changed.

MQCAI023 The password has changed

Explanation

Any future communication with the MQIPT which you have just changed will use the new password.

MQCAI025 MQIPT {0} has been refreshed

Explanation

The information you hold on the MQIPT has been updated by reading its configuration file.

MQCAI026 MQIPT {0} has received shutdown request

Explanation

The MQIPT has acknowledged receipt of a shutdown request and will now shut down.

MQCAI027 Client configuration has been refreshed

Explanation

The information displayed in the Administration Client has been refreshed from the local file client.conf.

MQCAI028 MQIPT {0} is active

Explanation

The MQIPT has responded successfully to a ping request.

MQCAI029 MQIPT {0} is not active

Explanation

The MQIPT has not responded to a ping request within a specified time.

User response

This can be caused by any of the following:

MQIPT is not running
MQIPT is not listening on its CommandPort
The request has timed out. The timeout can be increased by changing the timeout property on the connection information for the MQIPT.

MQCAI030 Route {0} is active

Explanation

The MQIPT route has responded successfully to a ping request.

MQCAI031 Route {0} is not active

Explanation

The MQIPT route has not responded to a ping request within a specified time.

User response

This can be caused by any of the following :

MQIPT is not running
MQIPT route is not active
The request has timed out. The timeout can be increased by changing the timeout property on the connection information for the MQIPT.

MQCAI100 This script is used to start the Administration Client for {0}. Specifying a SOCKS proxy will allow the Administrator Client to talk to an MQIPT through a firewall.

Explanation

Online help information for mqiptGui script.

MQCAI101 Format of command is :

Explanation

Online help information for mqiptGui script.

MQCAI102 mqiptGui {socks_host {socks_port}}

Explanation

Online help information for mqiptGui script.

MQCAI103 socks_host - host name of SOCKS proxy (optional)

Explanation

Online help information for mqiptGui script.

MQCAI104 socks_port - SOCKS proxy port address (optional - default 1080)

Explanation

Online help information for mqiptGui script.

MQCPA100 This script is used to stop or refresh {0}.

Explanation

Online help information for the mqiptAdmin script.

MQCPA101 (-stop | -refresh | -status) {hostname {port}}

Explanation

Online help information for the mqiptAdmin script.

MQCPA102 hostname - host name running MQIPT (default localhost)

Explanation

Online help information for the mqiptAdmin script.

MQCPA103 port - port address MQIPT is listening on for commands (default 1881)

Explanation

Online help information for the mqiptAdmin script.

MQCPA104 Command complete from MQIPT server at {0}

Explanation

Command sent from IPTAdmin has been accepted and run by IPTController

MQCPE001 Directory does not exist or is not a directory

Explanation

At MQIPT initialization, a required directory could not be found. This message refers to a directory specified either in the MQIPT configuration file mqipt.conf or in the MQIPT command line startup options on the default directory.

User response

Specify the correct directory and retry the command.

MQCPE004 Route startup failed on port {0}

Explanation

It was not possible to start the route with the specified ListenerPort number.

User response

An I/O error occurred during route startup. Check for other adjacent error messages and log records to provide further explanation of the problem.

MQCPE005 The configuration file {0} could not be found

Explanation

The MQIPT configuration file mqipt.conf could not be found in the specified directory

User response

Specify the correct directory and retry the command.

MQCPE006 The number of routes has exceeded {0}. MQIPT will start but this configuration is unsupported

Explanation

Your configuration has exceeded the maximum supported number of routes for one instance of MQIPT. Operation will not be halted but the system might become unstable or overloaded as a result. Configurations that exceed the stated maximum number of routes will not be supported.

User response

Consider starting additional instances of MQIPT with fewer routes per instance.

MQCPE007 Route not restarted on listener port {0}

Explanation

On a REFRESH operation, the route that was operating on the specified ListenerPort was not restarted with the new configuration.

User response

Check for other adjacent error messages for further explanation of the problem.

MQCPE008 Duplicate route defined for listener port {0}

Explanation

More than one route has been defined with the same ListenerPort value.

User response

Remove the duplicate route from the configuration file and retry the command.

MQCPE009 Log directory {0} is not valid

Explanation

The log path shown in the text either does not exist or is not accessible at the time.

User response

Check the directory exists and is accessible by MQIPT.

MQCPE010 Listener or command port number {0} is not valid

Explanation

The port address supplied for the command port or listener port parameter is invalid.

User response

Specify a valid port address that is free for use. For guidance on use of port addresses in your network, consult your network administrator.

MQCPE012 The value {0} is not valid for the property {1}

Explanation

An invalid property value has been specified.

User response

Refer to this User Guide for full details of the valid values for each property.

MQCPE013 ListenerPort property was not found in route {0}

Explanation

MQIPT has detected a route in the configuration file that does not contain a ListenerPort property. The ListenerPort property is the primary and unique identifier for each route, and is therefore mandatory.

User response

Specify a valid ListenerPort property for the given route.

MQCPE014 ListenerPort property value {0} is not valid

Explanation

An invalid port address has been specified for the ListenerPort property of a route.

User response

A port address must be in the range 1024-65535. Check each ListenerPort in the configuration file.

MQCPE015 No text was found for message number {0}

Explanation

An internal error has been encountered for which no description is available.

User response

The mqipt.properties file may have become corrupted and the specified message number could not be found. Check the following:

if you are using the MQIPT_PATH environment variable, ensure it is set correctly
look in the Readme file for a possible new message
the mqipt.properties file is in the com.ibm.mq.ipt.jar file
the message number is in the mqipt.properties file

MQCPE016 The maximum number of connection threads is {0} but this is less than the minimum number of connection threads, which is {1}

Explanation

Your configuration file has specified the minimum number of connection threads with a value greater than the maximum number of connection threads.

User response

This could be an error in a single route, a conflict between a global property and a route property, or a route property overriding the system default values. Refer to the earlier chapters of this User Guide for full details of the valid values and applicable defaults.

MQCPE017 The exception {0} was thrown causing MQIPT to shut down

Explanation

MQIPT has abnormally terminated and has been shut down. This may have occurred because of system environmental conditions or constraints, such as memory overflow.

User response

If the condition persists, contact IBM Software Support.

MQCPE018 The ListenerPort property is blank - the route will not start

Explanation

The ListenerPort number has been omitted in a route.

User response

Edit the configuration file and add a valid ListenerPort.

MQCPE019 The stanza {0} was not found before the following : {1}

Explanation

A sequence error has occurred in the configuration file.

User response

Edit the configuration file and make sure all [route] entries are after the [global] entry.

MQCPE020 The new value for MaxConnectionThreads is {0}. This must be greater than the current value {1}

Explanation

After the route has started, the MaxConnectionThread property can only be increased.

User response

Edit the configuration file and change the MaxConnectionThread property.

MQCPE021 The Destination property was not supplied for route {0}

Explanation

The Destination property is mandatory for a route, but was omitted in the route specified.

User response

Edit the configuration file and add a Destination property for the given route.

MQCPE022 The CommandPort value {0} is outside the valid range 1 - 65535

Explanation

The CommandPort property was outside the range 1-65535.

User response

Edit the configuration file and change the CommandPort property to a valid port address.

MQCPE023 Request for shutdown from Administration Client {0} is ignored because it is disabled

Explanation

An attempt to shut down the MQIPT remotely has failed because remote shutdown was not enabled in the configuration file.

User response

To enable remote shutdown of MQIPT, edit the configuration file and set the RemoteShutDown property to true.

MQCPE024 The command received by the MQIPT controller has not been recognized

Explanation

The MQIPT has received a command through its command port which it does not recognize.

User response

Check the mqipt.log file for the identity of the command.

MQCPE025 Failed to connect to server on host {0}, port {1}

Explanation

The line mode (non-GUI) Administration Client has failed to communicate with the MQIPT.

User response

Make sure the CommandPort property has been specified as {1} in the configuration file and MQIPT is running on host {0}.

MQCPE026 No reply received from server on host {0}, port {1}

Explanation

The line mode (non-GUI) Administration Client has connected with the MQIPT but has not received a reply.

User response

This indicates that either the request has timed-out or there is a problem with the MQIPT.

MQCPE027 Reply from MQIPT not recognized

Explanation

The line mode (non-GUI) Administration Client has received a reply from the MQIPT, which it does not recognize.

User response

Check the mqiptAdmin script is using the same version of the MQipt.jar file as MQIPT.

MQCPE028 Invalid stanza detected : {0}

Explanation

The stated unrecognized stanza has been found in the configuration file.

User response

Only [global] and [route] stanzas are valid in the configuration file.

MQCPE029 Was not able to flush log output

Explanation

Some messages might not have been written to the log because the communication buffer could not be flushed.

User response

Check there is MQIPT home directory disk has not become full and MQIPT still has access to the logs subdirectory.

MQCPE030 {0} not found in CLASSPATH

Explanation

The specified jar file was not found in the system environment CLASSPATH variable.

User response

Add the specified file to the system CLASSPATH.

MQCPE031 {0} class not found

Explanation

This message is generated when displaying the version number of MQIPT. The specified class could not be found in the MQIPT jar file or the system environment CLASSPATH variable has been corrupted.

User response

Check the specified class file is in the MQipt.jar file and the MQipt.jar file is in the system CLASSPATH.

MQCPE033 Failed to send configuration file to Administration Client at {0}

Explanation

An error occurred sending the configuration file to the Administration Client.

User response

Check the configuration file is in the MQIPT home directory and is not being shared by another process.

MQCPE034 Administration Client at {0} did not supply the correct password

Explanation

The AccessPW property in the configuration file did not match that provided by the Administration Client.

User response

Either change the AccessPW property in the configuration file or the saved password in the Administration Client.

MQCPE035 Failed to start command listener on port {0}

Explanation

An I/O error occurred starting the CommandPort listener on the specified port address.

User response

Check the port address used for the CommandPort property in the configuration file.

MQCPE038 MQIPT has not started as expected

Explanation

This message is generated by the mqipt fork process, which starts MQIPT as a system service.

User response

Check the error logs for more information. We can try increasing the sleep time IPTFork uses before it checks if MQIPT is running. Edit mqiptFork script and increase the parameter passed to IPTFork.

MQCPE039 I/O error occurred running mqipt script

Explanation

An error has occurred launching MQIPT from the fork process

User response

Check the system PATH environment variable contains the location of the JDK and the mqipt script has execute authority.

MQCPE040 Interruption occurred running mqipt script

Explanation

An error has occurred after launching MQIPT from the fork process.

User response

Check the error logs for more information. If the condition persists contact IBM Software Support.

MQCPE042 There is a conflict with the following properties on route {0} :

Explanation

Some properties can not be used with others. This message precedes the list of properties in conflict.

User response

Check the following error messages and take the appropriate action.

MQCPE043 ....{0} and {1}

Explanation

The following properties cannot both be set at the same time on the same route.

User response

Edit the configuration file and disable one of the specified properties on the given route.

MQCPE044 {0} is only valid on the {1} operating system

Explanation

Some features of MQIPT are only valid on certain platforms.

User response

Edit the configuration file and disable the specified property.

MQCPE045 ....HTTP proxy or server name is missing

Explanation

The HTTPProxy or HTTPServer property must be set if the HTTP property has been set to true.

User response

Edit the configuration file and define an HTTPProxy or HTTPServer for the given route.

MQCPE048 Route startup failed on port {0}, exception was : {1}

Explanation

It was not possible to start the route with the specified ListenerPort number.

User response

Check for other adjacent error messages and log records to provide further explanation of the problem.

MQCPE049 Error starting or stopping the Java Security Manager \n{0}

Explanation

An exception was thrown while trying to start or stop the Java Security Manager.

User response

The Java Security Manager has previously been enabled, but runtime permissions have not been enabled. Add a RuntimePermission for setSecurityManager to your local policy file. MQIPT must be restarted for the changes to take effect.

MQCPE050 Security exception on port {0} from the Administration Client

Explanation

A security exception was thrown while accepting a connection from the Administration Client.

User response

The Java Security Manager has previously been enabled, but permissions have not been granted for the host identified in the error message. To allow the host to connect to MQIPT, add a SocketPermission to accept/resolve connections on the port address of the CommandPort. The Java Security Manager must be restarted for any changes to take effect.

MQCPE051 Security exception accepting a connection on route {0}

Explanation

A security exception was thrown while accepting a connection on the specified route.

User response

The Java Security Manager has previously been enabled, but permissions have not been granted for the host identified in the error message. To allow the host to connect on this route, add a SocketPermission to accept/resolve connections for the ListenerPort. The Java Security Manager must be restarted for any changes to take effect.

MQCPE052 Connection request on route {0} failed : {1}

Explanation

This message is issued in the connection log to record a security exception for a connection request.

User response

The Java Security Manager has previously been enabled, but permissions have not been granted for the host identified in the error message. To allow the host to connect on this route, add a SocketPermission to accept/resolve connections for the ListenerPort. The Java Security Manager must be restarted for any changes to take effect.

MQCPE053 Security exception making a connection to {0}({1})

Explanation

A security exception was thrown while making a connection on the specified route.

User response

The Java Security Manager has previously been enabled, but permissions have not been granted for the target identified in the error message. To allow MQIPT to connect to the target on this route, add a SocketPermission to connect/resolve connections for the ListenerPort. The Java Security Manager must be restarted for any changes to take effect.

MQCPE054 Connection request to {0}({1}) failed : {2}

Explanation

This message is issued in the connection log to record a security exception for a connection request to a target host.

User response

The Java Security Manager has previously been enabled, but permissions have not been granted to make a connection to the target host identified in the error message. To allow MQIPT to connect to the target host, add a SocketPermission to connect/resolve connections for the ListenerPort. The Java Security Manager must be restarted for any changes to take effect.

MQCPE055 ....Socks proxy name is missing

Explanation

The SocksProxy property must be set if the SocksClient property has been set to true.

User response

Edit the configuration file and define a SocksProxy for the given route.

MQCPE056 Conflict with route properties

Explanation

Some properties cannot be used with others.

User response

Check the console messages for details of the error and take the appropriate action.

MQCPE057 SSL protocol ({0}) was not recognized

Explanation

The route has been put into SSL proxy mode and the initial data flow is not recognized.

User response

Make sure only SSL connections are being made to this route.

MQCPE058 CONNECT request to {2}({3}) through {0}({1}) failed

Explanation

An HTTP CONNECT request was sent to the HTTP proxy to create an SSL tunnel to the HTTP server. The HTTP proxy did not send back a "200 OK" response to this request.

User response

This can be caused by various problems. Enable tracing on the route and retry the connection. The trace file will show the real error.

MQCPE059 There are no defined key ring files

Explanation

An SSL client or server has been defined without specifying at least one key ring file.

User response

Use the SSLClientKeyRing and SSLClientCAKeyRing properties on the client side or SSLServerKeyRing and SSLServerCAKeyRing on the server side to define a key ring file and then restart the route.

MQCPE060 Runtime error setting SSL client connect timeout to {0} seconds

Explanation

An SSL runtime error has occurred on the client side setting the timeout value.

User response

Check the value specified in the SSLClientConnectTimeout property is valid. Running a trace on the given route will show further error information.

MQCPE061 There are no enabled cipher suites

Explanation

An SSL client or server connection has been started but MQIPT is unable to determine a valid cipher suite.

User response

Check there are valid certificates in the defined key ring file(s). The private and public keys used to generate the certificates and the encryption algorithms used must comply with the list of supported cipher suites, which can be found in the MQIPT book.

MQCPE062 Runtime error setting SSL cipher suite {0}

Explanation

An unsupported SSL cipher suite has been defined on the client or server side.

User response

Check the value specified in the SSLClientCipherSuites or SSLServerCipherSuites is valid and supported on this connection. Running a trace on the given route will show the list of enabled cipher suites. The MQIPT book contains a list of supported cipher suites.

MQCPE063 File {0} already exists - use the replace option

Explanation

The file name parameter specified for the mqiptPW script already exists.

User response

Either choose another file name or use the replace option.

MQCPE064 Runtime error generating decryption keys :\n {0}

Explanation

An error has occurred while generating cipher keys to decrypt the password used to open a key ring file.

User response

The runtime error listed in the message should be rectified and the command run again.

MQCPE065 ....LDAP server name is missing

Explanation

The LDAPServer1 or LDAPServer2 property must be set if the LDAP property has been set to true.

User response

Edit the configuration file and define an LDAPServer* for the given route.

MQCPE066 ....LDAP password is missing for the LDAPServer{0}Password property

Explanation

An LDAP userid has been specified without a password, for either the main or backup LDAP server.

User response

Edit the configuration file and define an LDAP password for the given route. The LDAPServer1Password property is for the main server and LDAPServer2Password property is for the backup server.

MQCPE067 ....SSLClient or SSLServer missing for LDAP server

Explanation

The SSLClient or SSLServer property must be set if the LDAP property has been set to true.

User response

Edit the configuration file and define an SSLClient or SSLServer for the given route.

MQCPE068 ....Security exit name is missing

Explanation

The SecurityExitName property must be set if the SecurityExit property has been set to true.

User response

Edit the configuration file and define a SecurityExitName for the given route.

MQCPE071 Error writing to {0}

Explanation

An error occurred while creating or updating the file containing the encryted password. The error message also contains the exception thrown.

User response

This error is generated from the the mqiptPW script. The error listed in the exception should be rectified and the command run again.

MQCPE072 An unknown error occurred in security exit {0}

Explanation

An error occurred in a user-defined security exit while validating a connection request.

User response

Enable tracing in the security exit and try the connection request again. The error will be recorded in the security exit trace file.

MQCPE073 Security exit {0} timed out

Explanation

A user-defined security exit timed out while validating a connection request.

User response

Increase the timeout period for the security exit and try the connection request again.

MQCPE074 ....Certificate exit name is missing

Explanation

The SSLExitName property must be set if the SSLClientExit or SSLServerExit property has been set to true.

User response

Edit the configuration file and define a SSLExitName for the given route.

MQCPE075 ....SSLPlainConnections needs SSLServer or SSLProxyMode enabled

Explanation

The SSLExitName property must be set if the SSLClientExit or SSLServerExit property has been set to true.

User response

Edit the configuration file and define a SSLExitName for the given route.

MQCPE076 Route {0} property {1} contains unsupported CipherSuites. The following CipherSuites are unsupported: {2}

Explanation

At least one unsupported CipherSuite was included in the SSLClientCipherSuites or SSLServerCipherSuites

User response

Edit the configuration file and remove the unsupported CipherSuite from the route configuration.

MQCPE077 Route {0} property {1} specifies file location {2} which does not exist.

Explanation

A route property refers to a file or directory which does not exist.

User response

Edit the configuration file and specify the correct location for the file or directory.

MQCPE078 Route {0} property {1} specifies file location {2} which cannot be read.

Explanation

A route property refers to a file cannot be read.

User response

Ensure that the file permissions allow MQIPT to read it.

MQCPE079 Route {0} site certificate label {1} was not found in keyring file {2}.

Explanation

A site certificate label was specified but it was not found in the keyring file.

User response

Ensure that correct site certificate label is specified and that the certificate exists in the appropriate keyring.

MQCPE080 Unable to determine MQIPT installation directory. Set the MQIPT_PATH environment variable to the absolute path of the top-level MQIPT directory.

Explanation

The MQIPT command was unable to determine the installation directory.

User response

Set the MQIPT_PATH environment variable to the absolute path of the top-level MQIPT directory.

MQCPE081 Invalid MQIPT_PATH {0}. The directory does not exist or does not contain a valid MQIPT installation.

Explanation

The MQIPT_PATH environment variable is set incorrectly. Either the directory does not exist or the directory is not an MQIPT installation.

User response

Check the MQIPT_PATH environment variable is set correctly and re-run the command.

MQCPE082 Unable to install the MQIPT service because a service is already installed. Only one MQIPT service may be installed at a time.

Explanation

The user attempted to install the MQIPT service, but an MQIPT service is already installed. Only one MQIPT service may be installed on the system at a time.

User response

Merge the required routes into the existing MQIPT service configuration, or remove the existing service and install the new service in its place.

MQCPE083 Unable to remove the MQIPT service because the installed service was not installed by the current MQIPT installation. Run mqiptService from the MQIPT installation that installed the service.

Explanation

The MQIPT service may only be removed using the MQIPT installation that originally installed it. This error occurs when we have multiple MQIPT installations on the system and you attempt to remove the MQIPT service using a different installation from the one that originally installed it.

User response

Run mqiptService -remove from the correct MQIPT installation.

MQCPE084 The MQIPT service is not installed.

Explanation

The user attempted to remove the MQIPT service but there is no MQIPT service installed.

MQCPE085 Error refreshing the Java Security Manager policy\n{0}

Explanation

An exception was thrown while trying to refresh the Java Security Manager policy.

User response

Investigate the cause of the error and ensure that the updated policy file has the correct syntax.

MQCPE086 Security exit {0} for route {1} failed to initialize due to error {2}.

Explanation

The security exit initialization method returned an unexpected error, which prevented the route from starting.

User response

Investigate the cause of the error and restart the route.

MQCPE087 Security exit {0} for route {1} failed to load due to error {2}.

Explanation

The security exit could not be loaded, which prevented the route from starting.

User response

Investigate the cause of the exit load error and restart the route.

MQCPE088 Certificate exit {0} for route {1} failed to initialize due to error {2}.

Explanation

The certificate exit initialization method returned an unexpected error, which prevented the route from starting.

User response

Investigate the cause of the error and restart the route.

MQCPE089 Certificate exit {0} for route {1} failed to load due to error {2}.

Explanation

The certificate exit could not be loaded, which prevented the route from starting.

User response

Investigate the cause of the exit load error and restart the route.

MQCPE090 The security exit rejected the connection with return code {0} and error {1}.

Explanation

The security exit rejected a connection to the route listener port.

User response

Investigate the error returned by the exit.

MQCPE091 The SSLClient certificate exit rejected the connection with return code {0} and error {1}.

Explanation

The SSLClient certificate exit rejected the remote server certificate.

User response

Investigate the error returned by the exit.

MQCPE092 The SSLServer certificate exit rejected the connection with return code {0} and error {1}.

Explanation

The SSLServer certificate exit rejected the remote client certificate.

User response

Investigate the error returned by the exit.

MQCPE093 Global property {0} specifies file location {1} which does not exist.

Explanation

A global property refers to a file or directory which does not exist.

User response

Edit the configuration file and specify the correct location for the file or directory.

MQCPE094 Global property {0} specifies file location {1} which cannot be read.

Explanation

A global property refers to a file cannot be read.

User response

Ensure that the file permissions allow MQIPT to read it.

MQCPE095 The MQIPT installation directory {0} must not contain a space on this platform.

Explanation

The MQIPT installation directory contains a space character, which is not supported on the AIX , HP-UX, Linux or Solaris platforms.

User response

Rename the installation directory so that it does not contain a space.

MQCPE096 Error enabling TCP keep alive

Explanation

The TCP keep alive route property is set, but MQIPT was unable to enable TCP keep alive.

User response

Investigate the cause of the failure or disable TCP keep alive.

MQCPI001 {0} starting

Explanation

This MQIPT instance is beginning execution. Further initialization messages will follow.

MQCPI002 {0} shutting down

Explanation

MQIPT is going to shut down. This can result from a STOP command, or automatically if a configuration error prevents a successful startup or REFRESH action.

MQCPI003 {0} shutdown complete

Explanation

The shutdown process has completed. All MQIPT processes are now ended.

MQCPI004 Reading configuration information from {0}

Explanation

The MQIPT configuration file mqipt.conf is being read from the directory described in this message.

MQCPI005 Listener port specified as not active - {0} -> {1}({2})

Explanation

The route referred to in the message has been marked as inactive. No communication requests will be accepted on this route.

MQCPI006 Route {0} is starting and will forward messages to :

Explanation

A route has been started on the listener port shown in this message. This message is followed by other messages listing any properties associated with this route. Message MQCPI078 will be issued when the route is ready to accept connections.

MQCPI007 Route {0} has been stopped

Explanation

The route that was operating on the specified ListenerPort is being shut down. This action normally occurs when a REFRESH command is issued to MQIPT and the route configuration has been changed.

MQCPI008 Listening for control commands on port {0}

Explanation

This MQIPT instance is listening for control commands on the specified port.

MQCPI009 Control command received: {0}

Explanation

This message indicates that a control command has been received at the command port. Where applicable, details are included in the message.

MQCPI010 Stopping command port on {0}

Explanation

On a REFRESH operation, the command port is no longer in use in the new configuration. Commands will no longer be accepted at the specified port.

MQCPI011 The path {0} will be used to store the log files

Explanation

Logging output will be directed to the location described in this message, under the current configuration.

User response

This may change if the configuration is amended and a REFRESH operation is requested.

MQCPI012 Changing the value of MinConnectionThreads has no effect after the route is started

Explanation

The minimum number of connection threads is assigned at route startup and cannot be changed until MQIPT is restarted.

MQCPI013 Connection from {0} to host {1} closed

Explanation

This message is issued in the connection log to record connection activity.

MQCPI014 Eyecatcher protocol ({0}) not recognized

Explanation

This message is issued in the connection log to record connection activity.

MQCPI015 Client access has been disabled on this route

Explanation

This message is issued in the connection log to record connection activity.

MQCPI016 Queue Manager access has been disabled on this route

Explanation

This message is issued in the connection log to record connection activity.

MQCPI017 A queue manager on {0} was connected to host {1}

Explanation

This message is issued in the connection log to record connection activity.

MQCPI018 A client on {0} was connected to host {1}

Explanation

This message is issued in the connection log to record connection activity.

MQCPI019 {0} routes have been created - this exceeds the maximum number of supported routes, which is {1}

Explanation

The maximum number of supported routes has been exceeded.

User response

MQIPT will continue to operate, but you might want to create a second MQIPT instance and split the routes between the two.

MQCPI020 The configuration file has been sent to Administration Client {0}

Explanation

As a result of a request from the Administration Client, the configuration file has been sent.

MQCPI021 Password checking has been enabled on the command port

Explanation

This message shows that a password is required to access the command port.

MQCPI022 Password checking has been disabled on the command port

Explanation

This message shows that a password is not required to access the command port.

MQCPI024 ....and HTTP proxy at {0}({1})

Explanation

This message indicates that the outgoing connection for this route will be made using this HTTP proxy.

MQCPI025 The refresh requested by Administration Client {0} has finished

Explanation

As a result of receiving a REFRESH command, the MQIPT has reread its configuration file and restarted.

MQCPI026 Administration Client {0} has requested shutdown

Explanation

As a result of receiving a STOP command, the MQIPT is shutting down.

MQCPI027 {0} sent to {1} on port {2}

Explanation

This displays on the system console the command sent by the line mode (non-GUI) Administration Client to the designated MQIPT.

MQCPI031 ......cipher suites {0}

Explanation

This message lists the cipher suites in use for this route.

MQCPI032 ......keyring file {0}

Explanation

This message gives the file name of the key ring for this route.

MQCPI033 ......client authentication set to {0}

Explanation

This message defines whether an SSL server is requesting client authentication for this route.

MQCPI034 ....{0}({1})

Explanation

This message shows the destination and destination port address for this route.

MQCPI035 ....using {0}

Explanation

This message shows the protocol being used to the destination. It will either be IBM MQ protocol, HTTP tunneling or HTTP chunking.

MQCPI036 ....SSL Client side enabled with properties :

Explanation

This message shows that the route will be using SSL to send data to the destination host.

MQCPI037 ....SSL Server side enabled with properties :

Explanation

This message shows that the route will be using SSL to receive data from the sending host.

MQCPI038 ......peer certificate uses {0}

Explanation

This message lists the distinguished names used to control authentication of peer certificates.

MQCPI039 ....and Socks proxy at {0}({1})

Explanation

This message shows that the outgoing connection for this route will be made using this Socks proxy, which is defined when MQIPT is started from the command line.

MQCPI040 Command port has been accessed by Administration Client {0}

Explanation

This message is written to the system console and the MQIPT log file (if logging is enabled). The MQIPT has received a connection from the Administration Client.

MQCPI041 ....will reply to Network Dispatcher advisor requests in {0} mode

Explanation

This message is written to the system console when a route is started. Used to show which mode MQIPT will use to reply to the Network Dispatcher advisor. Valid options are "Normal" and "Replace" mode.

MQCPI042 Maximum connections reached on route {0} - further requests will be blocked

Explanation

This message is written to the system console when the maximum number of connections has been reached for the given route. Further requests will be blocked until a connection becomes free or the MaxConnectionThreads value is increased.

MQCPI043 Connections on route {0} now unblocked

Explanation

This message is written to the system console when the given route is unblocked for connection requests.

MQCPI044 MQIPT has been launched from system startup

Explanation

MQIPT has been started as a system service.

MQCPI045 Launching MQIPT from system startup

Explanation

MQIPT is going to be started as a system service.

MQCPI046 Sleeping for {0} seconds while MQIPT is launched from system startup

Explanation

MQCPI047 ......CA keyring file {0}

Explanation

This message gives the file name of the CA key ring for this route.

MQCPI048 The ping by Administration Client {0} has finished

Explanation

Response message from the IPTController to Administration Client.

MQCPI050 Adding entry to inittab to automatically start MQIPT at system startup

Explanation

User has run the mqiptService script to start MQIPT as a system service.

MQCPI051 Removing entry from inittab that automatically starts MQIPT at system startup

Explanation

User has run the mqiptService script to remove MQIPT from starting as a system service.

MQCPI052 ....Socks server side enabled

Explanation

This route will act as a SOCKS server (proxy) and will accept connections from a socksified application.

MQCPI053 Starting the Java Security Manager

Explanation

The default Java Security Manager will be started as the SecurityManager property has been set to true.

MQCPI054 Stopping the Java Security Manager

Explanation

The default Java Security Manager will be stopped as the SecurityManager property has been set to false.

MQCPI055 Setting the java.security.policy to {0}

Explanation

The default Java Security Manager is about to be started and will use the supplied policy file.

MQCPI057 ....trace level {0} enabled

Explanation

This message is written to the system console when a route is started. Used to show the level of tracing enabled on this route.

MQCPI058 ....and a URI name of {0}

Explanation

This message is written to the system console when a route is started. Used to show the Uniform Resource Identifier name on this route.

MQCPI059 ....servlet client enabled

Explanation

This message is written to the system console when a route is started. This route will connect to the MQIPT servlet.

MQCPI060 Installing files to automatically start MQIPT at system startup

Explanation

User has run the mqiptService script to start MQIPT as a system service.

MQCPI061 Removing files that automatically starts MQIPT at system startup

Explanation

User has run the mqiptService script to remove MQIPT from starting as a system service.

MQCPI064 ......no SSL authentication on this route

Explanation

This message is written to the system console when a route is started and shows there is no SSL authentication is in use for this route, as an anonymous cipher suite has been specified.

MQCPI066 ....and HTTP server at {0}({1})

Explanation

This message indicates that the outgoing connection for this route will be made using this HTTP server.

MQCPI069 ....binding to local address {0} when making new connections

Explanation

This message shows the local IP address each new connection is bound to the destination address. This should only be used on a multihomed system.

MQCPI070 ....using local port address range {0}-{1} when making new connections

Explanation

This message shows the local port addresses that will be used for new connections. This will allow firewall administrators to restrict connections from MQIPT.

MQCPI071 ......site certificate uses {0}

Explanation

This message lists the distinguished names used to control selection of a site certificate.

MQCPI072 ......and certificate label {0}

Explanation

This message lists the label name used to control selection of a site certificate.

MQCPI073 Updated file {0}

Explanation

The file name specified for the mqiptPW script has been updated.

MQCPI074 Created file {0}

Explanation

The file name specified for the mqiptPW script has been created.

MQCPI075 ....LDAP main server at {0}({1})

Explanation

This message lists the name of the main LDAP server used for CRL support.

MQCPI076 ....LDAP backup server at {0}({1})

Explanation

This message lists the name of the backup LDAP server used for CRL support.

MQCPI077 ....LDAP errors will be ignored

Explanation

This message means that any errors received from LDAP will be ignored.

MQCPI078 Route {0} ready for connection requests

Explanation

This message is displayed when a route is ready to accept connection requests.

MQCPI079 ....using security exit {0}

Explanation

This message is written to the system console when a route is started. Used to show the fully qualified name of the security exit.

MQCPI080 ......and timeout of {0} second(s)

Explanation

This message is written to the system console when a route is started. Used to show the timeout value of the security or certificate exit.

MQCPI081 Start message for IBM MQ Internet Pass-Thru

Explanation

Start message for IBM MQ Internet Pass-Thru as a service

MQCPI082 Stop message for IBM MQ Internet Pass-Thru

Explanation

Stop message for IBM MQ Internet Pass-Thru as a service

MQCPI083 ....refresh commands will not restart the route

Explanation

This message indicates that when a refresh command has been issued the route will not be restarted.

MQCPI084 ......CRL cache expiry timeout is {0} hour(s)

Explanation

This console message displays how long a CRL (or ARL) will remain in the MQIPT cache.

MQCPI085 ....CRLs will be saved in the key ring file(s)

Explanation

This console message means that any CRLs (or ARLs) retrieved from an LDAP server will be saved in the key ring file, attached to the associated CA certificate.

MQCPI086 ......timeout of {0} second(s)

Explanation

This message is written to the system console when a route is started. Used to show the timeout value for connecting to the LDAP server.

MQCPI087 ......userid is {0}

Explanation

This message is written to the system console when a route is started. Used to show the userid name to connect to the LDAP server.

MQCPI088 ....buffer size {0}

Explanation

This message is written to the system console when a route is started. Used to show the size of buffers being used, but only if not the value of 65535. This value will only be used if greater than the default 65535.

MQCPI089 ....use cookies {0}

Explanation

This message is written to the system console when a route is started. Used to show which cookies will be passed to the MQIPT servlet, as returned in the previous HTTP response.

MQCPI090 ......search baseDN uses {0}

Explanation

This message is written to the system console when a route is started. Used to show the LDAP baseDN key names to retrieve CRLs (and ARLs).

MQCPI091 ....allow plain connections

Explanation

This message is written to the system console when a route is started. Used to show plain connections are allowed when acting as an SSL server or running in SSL proxy mode.

MQCPI092 ....socket timeout {0} ms

Explanation

This message shows the socket timeout value (in milliseconds)

MQCPI100 This script is used to start {0}

Explanation

Online help message from mqipt script.

MQCPI101 Format of command is :

Explanation

Online help message from MQIPT script.

MQCPI102 mqipt {dir_name}

Explanation

Online help message from mqipt script.

MQCPI103 dir_name - directory containing mqipt.conf

Explanation

Online help message from mqipt script.

MQCPI106 This script is used to display the current version number

Explanation

Online help message from mqiptVersion script.

MQCPI107 mqiptVersion {-v}

Explanation

Online help message from mqiptVersion script.

MQCPI108 where -v will also display the build timestamp

Explanation

Online help message from mqiptVersion script.

MQCPI109 This script is used to start {0}, from system startup, in another JVM and is only used in mqipt.ske. Use the mqipt script to start MQIPT from the command line.

Explanation

Online help message from mqiptFork script.

MQCPI110 This class is used to display a simple NLS message on the console.

Explanation

Online help message from IPTMessages class.

MQCPI111 java com.ibm.mq.ipt.IPTMessages (message_id1) {message_id2} {message_id...}

Explanation

Online help message from IPTMessages class.

MQCPI112 where message_id matches a key in the file mqipt.properties

Explanation

Online help message from IPTMessages class.

MQCPI113 This script is used to manage MQIPT as a system service.

Explanation

Online help message from mqiptService script.

MQCPI114 mqiptService (-install | -remove )

Explanation

Online help message from mqiptService script.

MQCPI115 -install will install files to start MQIPT automatically at system startup

Explanation

Online help message from mqiptService script.

MQCPI116 -remove will remove files that start MQIPT automatically at system startup

Explanation

Online help message from mqiptService script.

MQCPI121 Use this script to encrypt a password and store it in a file

Explanation

Online help message from mqiptPW script.

MQCPI122 mqiptPW password file_name { -replace }

Explanation

Online help message from mqiptPW script.

MQCPI123 password - password used to open a key ring file

Explanation

Online help message from mqiptPW script.

MQCPI124 file_name - encrypted password will be stored in this file

Explanation

Online help message from mqiptPW script.

MQCPI125 replace option must be used to update an existing file

Explanation

Online help message from mqiptPW script.

MQCPI126 mqipt (-start | -stop )

Explanation

Online help message from mqipt script.

MQCPI127 ....in full duplex mode

Explanation

This message shows the HTTP protocol being used to the destination is working in full duplex mode.

MQCPI128 ....in half duplex mode

Explanation

This message shows the HTTP protocol being used to the destination is working in half duplex mode.

MQCPI129 ......using certificate exit {0}

Explanation

This message is written to the system console when a route is started. Used to show the fully qualified name of the certificate exit.

MQCPI130 Connection to caller closed due to connection failure to destination

Explanation

This message is written to the connection log for the closed connection to the caller, when MQIPT failed to connect to the target destination.

User response

See previous connection failure for reason of closure.

MQCPI131 ......and certificate exit data ''{0}''

Explanation

This message is written to the system console when a route is started. Used to show the data for the certificate exit.

MQCPI132 ....listening on local address {0}

Explanation

This message shows the local IP address the route is listening on. This should only be used on a multihomed system.

MQCPI133 This script starts the iKeyman certificate management utility.

Explanation

This message introduces the usage statement for the mqiptKeyman command used to start the iKeyman certificate management utility.

MQCPI134 mqiptKeyman

Explanation

This message shows the usage statement for the mqiptKeyman command used to start the iKeyman certificate management utility.

MQCPI135 This script runs the iKeycmd certificate management utility.

Explanation

This message introduces the usage statement for the mqiptKeyman command used to start the iKeyman certificate management utility.

MQCPI136 mqiptKeycmd {object} [{action} ...]

Explanation

This message shows the usage statement for the mqiptKeyman command used to start the iKeyman certificate management utility.

MQCPI137 mqiptIcons {-install | -remove} InstallationName

Explanation

This message shows the usage statement for the mqiptIcons command used to install or remove MQIPT icons from the Windows Start menu.

MQCPI138 The Java Security Manager policy has been refreshed.

Explanation

The Java Security Manager is still enabled and the policy has been re-read. Any changes to the security policy will now take effect.

MQCPI139 ......secure socket protocols {0}

Explanation

This message lists the secure socket protocol versions enabled for this route.

MQCPI140 ....TCP keep alive enabled

Explanation

This message shows that TCP keep alive parameter has been enabled

MQCPW001 CRL expired for {0}

Explanation

This message is displayed when a CRL (or ARL) is retrieved from an LDAP server.

User response

Update the specified CRL in the LDAP server.

MQCPW003 ....Expired CRLs will be ignored

Explanation

This console message means that any expired CRLs (or ARLs) will be ignored and the connection request may be allowed.

MQCPW004 ......SSLServerAskClientAuth is disabled, certificate exit might not be called

Explanation

This console message is displayed at startup to show a conflict with the SSLServerExit and SSLServerAskClientAuth properties.

User response

With SSLServerAskClientAuth disabled, the SSL client is not required to send an SSL certificate, so the certificate exit might not be called.

MQCPW005 Route {0} {1} keyring file {2} certificate {3} serial number {4} is not yet valid. The certificate cannot be used before {5}.

Explanation

This console message is displayed at route startup if one of the keyring files contains a certificate which is not yet valid because its Not Before date is in the future.

User response

Check that the system clock is set correctly. If your organization operates its own CA, check the system clock on the CA system.

MQCPW006 Route {0} {1} keyring file {2} certificate {3} serial number {4} has expired. The certificate cannot be used after {5}.

Explanation

This console message is displayed at route startup if one of the keyring files contains a certificate which has expired.

User response

Check that the system clock is set correctly. If the clock is set correctly, obtain a replacement certificate.