Error messages

Error messages provide information about problems that occur while running the probe. You can use the information that they contain to resolve such problems.

The following table describes the error messages specific to this probe. For information about generic Netcool/OMNIbus error messages, see the IBM Tivoli Netcool/OMNIbus Probe and Gateway Guide.

Table 1. Error messages
Error message	Description	Action
`Authentication failure - Bad username/password`	The specified user name or password is not valid, or plaintext passwords have not been enabled on the mail server.	Specify a valid username and password and enable the use of plaintext passwords on the mail server.
`Invalid AuthType: authType`	The authentication method specified for the AuthType property is not valid.	Verify that the value specified for the AuthType property is either apop or userpass.
`Login Password is incorrect length (ensure it has been encrypted using nco_g_crypt)`	The password for the email account specified by the Password property is not the expected length.	Encrypt the password using the nco_g_crypt utility and use the encrypted password as the value of the Password property.
`Password to Client Certificate is incorrect length (ensure it has been encrypted using nco_g_crypt)`	The password for the keystore file specified by the KeyStorePassword property is not the expected length.	Encrypt the password using the nco_g_crypt utility and use the encrypted password as the value of the KeyStorePassword property.
`Password to Truststore is incorrect length (ensure it has been encrypted using nco_g_crypt)`	The password for the truststore file specified by the TrustStorePassword property is not the expected length.	Encrypt the password using the nco_g_crypt utility and use the encrypted password as the value of the TrustStorePassword property.
`Failed to connect to server`	The connection to the mail server was lost.	Verify that the mail server is running correctly. Check the network connection to the mail server.
`Failed to connect to mail server. Can't get lock. Mailbox in use.`	The probe cannot connect to the mail server. The most likely cause for this is that someone else was accessing the mailbox when the probe was also trying to access it. Note: The POP3 protocol does not allow multiple users to access the same mailbox simultaneously.	Set the Retry property to true. This allows the probe to retry the connection with the mail server after the other user has stopped accessing the mailbox.
`Failed to close connection: exception`	The probe encountered a problem while trying to close the connection to the email server.	No immediate action is required because the connection is closed even when the exception occurs.
`Failed to parse message`	The probe was unable to parse messages into tokens.	Verify that the rules file contains all the required information to generate the `$Header` and `$Body` elements.
`Failed to retrieve store object`	The attempt to instantiate a message store and its access protocol failed.	Verify that the mail server is running correctly. Check the network connection to the mail server.
`Failed to get messages: exception`	The probe was unable to retrieve messages.	Verify that the mail server is running correctly. Verify that the FilterField and Filter properties have been specified correctly.
`Unsupported content type`	The probe found an unsupported email element.	Contact IBM Software Support for assistance.
`Java Exceptions`	Unable to run the probe due to an error related to Java™ files.	Verify that the correct version of Java is installed while running the probe.