Channel <insert_3> to host <insert_5> ended normally.
Response
None.
AMQ9002I
Channel <insert_3> is starting.
Severity
0 : Informational
Explanation
Channel <insert_3> is starting.
Response
None.
AMQ9003I (IBM i)
Channel <insert_3> last message sequence number is <insert_1>.
Severity
0 : Informational
Explanation
Channel <insert_3> last message sequence number is <insert_1>.
Response
None.
AMQ9004I (IBM i)
Channel <insert_3> status information.
Severity
0 : Informational
Explanation
Channel <insert_3> status information: Number of Messages in Doubt - <insert_1> In Doubt Sequence Number - <insert_2> In Doubt Logic Unit of Work ID - <insert_4>
Response
None.
AMQ9005E
The IBM MQ security policy interceptor failed to access the Public-Key Cryptography Standards (PKCS) #11 hardware token.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor failed in an attempt to open a Public-Key Cryptography Standards (PKCS) #11 token. Check GSKit ACME GSS minor reason <insert_1> for <insert_3>.
Response
Make sure that the PKCS #11 token is present and configured correctly, and retry the operation. Verify that the token label, PIN, and library name are configured correctly.
AMQ9006E
The IBM MQ security policy interceptor did not attempt to open a PKCS #11 token because it did not have all required configuration information.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor did not attempt to open a Public-Key Cryptography Standards (PKCS) #11 token because one or more of the token label, PIN, or shared library name were not configured.
Response
To use a PKCS #11 token, make sure that the token label, PIN, and library name are configured correctly.
AMQ9007E
The IBM MQ security policy interceptor failed to convert a Public-Key Cryptography Standards (PKCS) #11 key certificate label.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor failed to convert a Public-Key Cryptography Standards (PKCS) #11 key certificate label needed to identify a key certificate item stored in a PKCS #11 token. Check GSKit ACME GSS minor reason <insert_1>.
Response
Make sure that the PKCS #11 key certificate label is defined correctly.
AMQ9008E
Cannot acquire the certificate for the label: <insert_3> in the keystore file <insert_4>. GSKit ACME GSS minor reason is <insert_1>.
Severity
20 : Error
Explanation
IBM MQ security policy interceptor was unable to read the certificate for the given label from keystore.
Response
Make sure the label is correctly set as the cms.certificate entry of the configuration file. Check if the keystore contains the certificate for the given label.
AMQ9009E
Cannot acquire credentials. GSKit ACME GSS minor reason is <insert_1>.
Severity
20 : Error
Explanation
IBM MQ security policy interceptor was unable to acquire credentials.
Response
Review the configuration to make sure the keystore database and stash files are not broken.
AMQ9010E
IBM MQ security policy internal error: message could not be protected because specified encryption algorithm is not valid <insert_1>.
Severity
20 : Error
Explanation
The value identifier is specified to unexpected value.
Response
This is an internal error. Contact the IBM service representative.
AMQ9011E
The IBM MQ security policy interceptor failed to turn on the Public-Key Cryptography Standards (PKCS) #11 hardware RSA private key algorithm for this ACME environment. Check GSKit ACME GSS minor reason <insert_1>.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor failed to register the Public-Key Cryptography Standards (PKCS) #11 cryptographic algorithm with the ACME environment.
Response
Make sure that the PKCS #11 token is functioning properly and retry the operation. If the problem persists, contact the IBM service representative.
AMQ9012E
The IBM MQ security policy interceptor could not acquire the public key credential.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor could not perform a public key infrastructure (PKI) login.
Response
Check the error messages related to acquiring public key credentials to determine the cause of the failure. Check whether user has the permission to read the kdb and stash files and verify whether the kdb file contains a certificate with the label specified. Finally, check whether the certificate has not expired.
AMQ9013E
IBM MQ security policy internal error: the Independent Data Unit Protection (IDUP) environment could not be terminated. GSKit reason code <insert_1>.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor could not release the GSKit IDUP environment because an internal error occurred.
Response
Consult the GSKit appendix in the Information Center for the explanation of the GSKit reason code and take corrective action. If the problem persists, contact the IBM service representative.
AMQ9014E
The IBM MQ security policy interceptor failed to close a Public-Key Cryptography Standards (PKCS) #11 token. Check GSKit ACME GSS minor reason <insert_1>.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor failed to close a Public-Key Cryptography Standards (PKCS) #11 token.
Response
Make sure that the PKCS #11 token is functioning properly and retry the operation. If the problem persists, contact the IBM service representative.
AMQ9015E
IBM MQ security policy internal warning: GSKit could not release <insert_3>. GSKit reason code <insert_1>.
Severity
20 : Error
Explanation
The IBM MQ security policy GSKit call with the indicated reason code failed because it could not release resources back to the system.
Response
No action is required. If the problem persists, contact the IBM service representative.
AMQ9016E
IBM MQ security policy internal error: GSKit could not allocate <insert_3>. GSKit reason code <insert_1>.
Severity
20 : Error
Explanation
The IBM MQ security policy GSKit call with the indicated reason code failed because the system could not allocate resources.
Response
Make sure the system meets hardware and software requirements necessary to execute the application, then restart the application.
AMQ9017E
IBM MQ security policy internal error: message could not be unprotected: GSKit error code <insert_1>, reason <insert_2>.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor could not verify or decrypt a message because the indicated GSKit error occurred. This can happen for several reasons, all of which are internal failures: (1) the message is not a valid PKCS#7 message; (2) the sender's certificate does not have the required key usage bit to be able to encrypt the message; (3) the sender's certificate was not recognized as a trusted certificate; (4) receiver is not among the recipients of the message; (5) PKCS#7 encryption key size is unacceptable, for example 40-bit RC2.
Response
Consult the GSKit information in the Information Center for the explanation of the GSKit reason code and take corrective action. If the problem persists, contact the IBM service representative.
AMQ9018E
The specified SHA-2 algorithm <insert_3> is not supported on this platform.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor failed to apply a policy as this platform lacks support for SHA-2 signing algorithm.
Response
Check that all platforms that open a queue with a policy that specifies a SHA-2 signing algorithm have the required cryptographic library support.
AMQ9019E
IBM MQ security policy internal error: message could not be protected because specified signature algorithm is not valid <insert_1>
Severity
20 : Error
Explanation
The value identifier is specified to unexpected value.
Response
This is an internal error. Contact the IBM service representative.
AMQ9020E
IBM MQ security policy internal error: message could not be protected because no recipients' DN is specified.
Severity
20 : Error
Explanation
The policy is set to privacy but does not contain any recipient DN.
Response
This is an internal error. Contact the IBM service representative.
AMQ9021E
An error occured during the certificate import for the following DN: <insert_3>, result: <insert_1>
Severity
20 : Error
Explanation
The distinguished name is not present in the keystore or invalid.
Response
Consult the GSKit appendix in the Information Center for the explanation of the GSKit reason code and take corrective action. If the problem persists, contact the IBM service representative.
AMQ9022E
An error occured during the certificate import for the following DN: <insert_3>, result: <insert_1>, reason: <insert_2>.
Severity
20 : Error
Explanation
The distinguished name is not present in the keystore or invalid.
Response
Consult the GSKit appendix in the Information Center for the explanation of the GSKit reason code and take corrective action. If the problem persists, contact the IBM service representative.
AMQ9023E
The name of the keystore file <insert_3> was incorrectly provided with the file extension <insert_4>
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor was unable to find the keystore file. It seems the value of the keystore configuration entry incorrectly contains the file extension.
Response
Ensure the keystore file name specified in the configuration file does not contain a file extension.
AMQ9024E
The keystore file <insert_3> does not exist and the keystore configuration entry incorrectly ends with <insert_4>. Make sure the value of the keystore configuration does not contain the file extension and it points to an existing file.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor was unable to find the keystore file. The value of the keystore configuration entry incorrectly contains the file extension of <insert_4> and the resultant filename of <insert_3> does not exist.
Response
Make sure the value of the keystore configuration does not contain the file extension and it points to an existing file.
AMQ9025E
The keystore file <insert_3><insert_4> does not exist. Make sure the value of the keystore configuration entry points to an existing file.
Severity
20 : Error
Explanation
IBM MQ security policy interceptor was unable to find the keystore database file.
Response
Make sure the value of the keystore configuration entry points to an existing file.
AMQ9026E
Cannot read the keystore file <insert_3><insert_4>. Check the file permissions.
Severity
20 : Error
Explanation
IBM MQ security policy interceptor was unable to read the keystore database file.
Response
Set the proper permissions for the keystore database file.
AMQ9027E
Cannot access the keystore file <insert_3><insert_4>. Error code <insert_1>.
Severity
20 : Error
Explanation
IBM MQ security policy interceptor was unable to open the keystore database file.
Response
Ensure the application accessing the keystore file has appropriate permissions to access the keystore file.
AMQ9028E
The keystore stash file <insert_3><insert_4> does not exist.
Severity
20 : Error
Explanation
IBM MQ security policy interceptor was unable to find the keystore stash file.
Response
Ensure the application accessing the keystore stash file has appropriate permissions to access the file.
AMQ9029E
Cannot read the keystore stash file <insert_3><insert_4>.
Severity
20 : Error
Explanation
IBM MQ security policy interceptor was unable to read the keystore stash file.
Response
Check the permissions for the keystore stash file.
AMQ9030E
IBM MQ security policy internal error: queue information could not be resolved from the current queue object handle (<insert_1>).
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor could not resolve queue information from the current queue object handle because the object handle is invalid or unrecognised.
Response
Make sure that the queue has not already been opened by another IBM MQ application and that it has not been previously closed. If the problem persists, contact the IBM service representative.
AMQ9031E
IBM MQ security policy interceptor has detected an error prior to callback exit execution. IBM MQ compcode <insert_1> : reason <insert_2>.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor received an IBM MQ completion code indicating an error prior to interceptor execution.
Response
Consult the Information Center for the completion code and reason code, take corrective action. If the problem persists, contact the IBM service representative.
AMQ9032E
IBM MQ security policy interceptor could not find queue manager CodedCharSetId (<insert_1>). Make sure you have permission to inquire about queue manager properties.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor could not find the local queue manager's CodedCharSetId because an internal error occurred.
Response
Make sure that the application has inquire permission to the queue manager. If the problem persists, contact the IBM service representative.
AMQ9033E
IBM MQ security policy internal error: could not find local queue manager CodedCharSetId (<insert_1>).
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor could not find the local queue manager's CodedCharSetId because an internal error occurred.
Response
If the problem persists, contact the IBM service representative.
AMQ9034E
Message does not have a valid protection type.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor detected an invalid protection type in a message header. This usually occurs because the IBM MQ message header is not valid.
Response
Retry the operation. If the problem persists, contact the IBM service representative.
AMQ9035E
Message signer is not in the list of authorised signers.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor detected that the message is signed by an unauthorised party.
Response
Establish whether the identity associated with the sender of the message is authorized to send messages to this application. Ensure the sender is named in the list of allowed signers on the security policy for the queue.
AMQ9036E
MQOPEN() call failed: reason code (<insert_1>).
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor call to the IBM MQ MQOPEN() call failed with the indicated error.
Response
Consult the Information Center for an explanation of the error code and suggested corrective action. Ensure that the queue manager is operational and the queue exists.
AMQ9037E
The IBM MQ security policy interceptor failed to process a message on queue <insert_3> with CompCode <insert_1> Reason code <insert_2>
Severity
20 : Error
Explanation
An unexpected error was encountered whilst applying a security policy to queue <insert_3>.
Response
This is an internal error. Contact the IBM service representative.
AMQ9038E
The IBM MQ security policy interceptor failed to convert the <insert_3> field of the IBM MQ header from CCSID <insert_1> to CCSID <insert_2>. Verify that default data conversion has been enabled in IBM MQ.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor internal error: data conversion failed. This is usually a problem with incompatible character sets.
Response
Enable default data conversion in IBM MQ. If the problem persists, contact the IBM service representative.
AMQ9039I
<insert_3> - message was signed by <insert_4> using <insert_5>.
Severity
0 : Informational
Explanation
This is an informational message used to indicate that a message was signed, and to display the signer's name, message timestamp and signature algorithm used.
Response
None.
AMQ9040I
<insert_3> - message was signed and encrypted by <insert_4> using <insert_5>.
Severity
0 : Informational
Explanation
This is an informational message used to indicate that a message was signed and encrypted, and to display the signer's name and encryption algorithm name.
Response
None.
AMQ9041I
Message was not protected.
Severity
0 : Informational
Explanation
This is an informational message used to indicate that a message was neither signed nor encrypted.
Response
None.
AMQ9042E
IBM MQ security policy internal error: unprotected message size <insert_1> bytes does not match the original message size <insert_2> bytes.
Severity
20 : Error
Explanation
After unprotecting, the message size does not match the original message size. The message header might have been corrupted or tampered with.
Response
Check the message which has been put on the SYSTEM.PROTECTION.ERROR.QUEUE queue to find the cause of the error and the origin of the message. If the problem persists, contact the IBM service representative.
AMQ9043E
Message protection algorithm <insert_3> is different than the required <insert_4>.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor detected that a message did not meet the encryption strength required by the queue. This usually occurs when encryption strength for a queue is changed while there were still messages in the queue.
Response
Make sure that the same encryption strength is used for the message MQPUT and MQGET. When the queue encryption strength is changed, remove all messages in the queue before resuming normal operation.
AMQ9044E
The IBM MQ security policy interceptor has put a defective message on error handling queue <insert_3>.
Severity
20 : Error
Explanation
This is an informational message that indicates the IBM MQ security policy put a message it could not interpret onto the specified error handling queue, or returned the message to the original queue if the MQGET of the message was part of a Unit of Work.
Response
Make sure only valid messages are put onto queues protected by IBM MQ security policies.
AMQ9045E
The IBM MQ security policy interceptor failed to put a defective message on error handling queue. IBM MQ reason code (<insert_1>)
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor was unable to put a message it could not interpret on the error handling queue because the indicated IBM MQ error occurred.
Response
Consult the Information Center for more information about the reason code. If the problem persists, contact the IBM service representative.
AMQ9046E
The 'PDMQ' format header from the current message is invalid.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor did not find a valid IBM MQ security policy header in the the current message.
Response
If the QoP setting for the queue is not set to 'none', make sure that no unprotected messages are routed to this queue.
AMQ9047I
IBM MQ security policy found a valid 'PDMQ' format header in the current message.
Severity
0 : Informational
Explanation
IBM MQ security policy interceptor found a valid IBM MQ security policy header in the current message.
Response
None.
AMQ9048E
Message quality of protection (<insert_1>) does not match the quality of protection (<insert_2>) set for the queue <insert_3>.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor detected a quality of protection (QoP) mismatch between the queue and a message in the queue. QoP mismatches usually occur because the queue QoP is changed between the message put and get.
Response
Make sure that the same queue quality of protection is used for the message put and get. When the queue QoP is changed, clean up all messages in the queue before resuming normal operation.
AMQ9049I
Message with quality of protection (<insert_1>) higher than (<insert_2>) set for the queue <insert_3> has been accepted.
Severity
0 : Informational
Explanation
The IBM MQ security policy interceptor detected a quality of protection (QoP) mismatch between the queue and a message in the queue. QoP mismatch usually occurs when the QoP of the queue is changed between the message put and get.
Response
Make sure that the same queue quality of protection is used for the message put and get. When the QoP of the queue is changed, remove all messages from the queue before resuming any operation.
AMQ9050E
IBM MQ security policy could not access the security policy definitions. Major code <insert_1> : Minor code <insert_2>
Severity
20 : Error
Explanation
The security policy definitions cannot be accessed.
Response
The security policy definitions must be accessible to this application. Check the object authority manager access control for this application to access the SYSTEM.PROTECTION.POLICY.QUEUE.
AMQ9051E
IBM MQ could not find the security policy definition. Compcode <insert_1> : reason <insert_2>
Severity
20 : Error
Explanation
The security policy definition is not defined.
Response
Security policy definition must be defined before this action.
AMQ9052I
Message with no protection has been put into the queue <insert_3>.
Severity
0 : Informational
Explanation
The IBM MQ security policy interceptor has successfully put a message with a QoP of 'none' onto the selected queue.
Response
None.
AMQ9053I
Message with integrity protection has been put into the queue <insert_3>.
Severity
0 : Informational
Explanation
The IBM MQ security policy interceptor has successfully put a message with a QoP of 'integrity' onto the selected queue.
Response
None.
AMQ9054I
Message with privacy protection has been put into the queue <insert_3>.
Severity
0 : Informational
Explanation
The IBM MQ security policy interceptor has successfully put a message with a QoP of 'privacy' onto the selected queue.
Response
None.
AMQ9055E
Quality of protection (QoP) <insert_1> for queue <insert_3> is invalid
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor detected that the quality of protection specified in the security policy for the queue is invalid.
Response
Ensure that the encryption and signature algorithms specified for the queue in the IBM MQ security policy definition have valid values.
AMQ9056E
IBM MQ security policy internal error: message could not be protected because the specified signature algorithm <insert_1> is not valid.
Severity
20 : Error
Explanation
An unexpected signature algorithm has been specified.
Response
This is an internal error. Contact the IBM service representative.
AMQ9057E
IBM MQ security policy internal error: message could not be processed because the specified encryption algorithm <insert_1> is not valid.
Severity
20 : Error
Explanation
An unexpected encryption algorithm has been specified.
Response
This is an internal error. Contact the IBM service representative.
AMQ9058E
The IBM MQ security policy interceptor cannot inquire the attributes for queue manager <insert_3>.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor failed to inquire queue manager attributes, compcode <insert_1>, reason code <insert_2>.
Response
Make sure that the application has appropriate access control permissions to inquire the queue manager object.
AMQ9059E
The IBM MQ security policy interceptor failed to generate a configuration event for queue manager <insert_3>.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor failed to generate a configuration event, comp code <insert_1>, reason code <insert_2>.
Response
Ensure that the SYSTEM.ADMIN.CONFIG.EVENT queue is available for output from this process.
AMQ9060E
The IBM MQ security policy keystore configuration file contains a duplicate key.
Severity
20 : Error
Explanation
The IBM MQ security policy keystore configuration file <insert_3> contains duplicate key: <insert_4>.
Response
Make sure the keystore configuration file contains all required keys and does not contain duplicate keys.
AMQ9061E
The IBM MQ security policy keystore configuration file is missing a required key.
Severity
20 : Error
Explanation
The IBM MQ security policy keystore configuration file <insert_3> does not contain key <insert_4>.
Response
Make sure the keystore configuration file contains all required keys and does not contain duplicate keys.
AMQ9062E
The IBM MQ security policy interceptor could not read the keystore configuration file: <insert_3>.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor could not read the keystore configuration file: <insert_3>.
Response
Make sure that the user who executes the IBM MQ application has permissions to read the configuration file. Check if the configuration file is not corrupted or empty. If the problem persists, contact your local IBM service representative.
AMQ9063E
The IBM MQ security policy interceptor could not parse the keystore configuration file.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor could not parse the <insert_4> attribute key in the keystore configuration file <insert_3>.
Response
Make sure the keystore configuration file contains all required attributes and does not contain any duplicate attribute keys.
AMQ9064E
The IBM MQ security policy interceptor failed to enable OCSP checking.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor encountered an error while configuring OCSP checking.
Response
Check the OCSP configuration, making sure that all parameters are specified correctly.
AMQ9065E
The IBM MQ security policy interceptor failed to process the OCSP configuration.
Severity
20 : Error
Explanation
The OCSP configuration for IBM MQ is incorrect.
Response
Check the OCSP configuration, making sure that all mandatory parameters are specified.
AMQ9066E
The IBM MQ security policy interceptor failed to enable CRL checking.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor encountered an error while configuring CRL checking.
Response
Check the CRL configuration, making sure that all parameters are correctly specified.
AMQ9067E
The IBM MQ security policy interceptor failed to process the CRL configuration.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor failedto process the CRL configuration information.
Response
Check the CRL configuration, making sure that all mandatory parameters are specified.
AMQ9068E
The IBM MQ security policy interceptor could not enable revocation checking.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor could not enable OCSP or CRL because the required functionality is not supported by the version of GSKit that is currently being used.
Response
The currently enabled version of GSKit does not meet the minimum requirements for IBM MQ security policy revocation checking. Install a newer version of GSKit that does meet the minimum requirements.
AMQ9069E
The IBM MQ security policy interceptor failed to validate a certificate.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor could not validate a certificate when attempting to protect or unprotect a message. The cryptographic provider failed to verify the certificate with a distinguished name of <insert_3>. The validation may have failed for this certificate, or another certificate in the validation chain. The return code from the cryptographic provider was <insert_1>.
Response
Ensure that all certificates required to validate the identify of valid message signers are available.
AMQ9070E
The IBM MQ security policy interceptor failed to validate a certificate.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor could not validate a certificate when attempting to unprotect a message. If the message was subject to a browse operation it will remain on its queue, otherwise it will be moved to the SYSTEM.PROTECTION.ERROR.QUEUE. The return code from the cryptographic provider was <insert_1>.
Response
Ensure that all certificates required to validate the identify of valid message signers are available.
AMQ9071E
IBM MQ security policy interceptor internal error: could not read GSKit attribute <insert_3>, GSKit reason code: <insert_1>.
Severity
20 : Error
Explanation
The GSKit gskacme_cred_get function failed.
Response
Make sure we are using the correct version of GSKit for this installation of IBM MQ.
AMQ9072E
The certificate revocation status is UNKNOWN, GSKit log: <insert_3>.
Severity
20 : Error
Explanation
The IBM MQ security policy interceptor failed to determine the certificate revocation status.
Response
Read the GSKit log to find out the certificate DN and serial number.
AMQ9073W
The certificate revocation status is UNKNOWN, GSKit log: <insert_3>.
Severity
10 : Warning
Explanation
The IBM MQ security policy interceptor failed to determine the certificate revocation status.
Response
Read the GSKit log to find out the certificate DN and serial number.
AMQ9074E
The Trial Period license for this copy of IBM MQ AMS has expired.
Severity
20 : Error
Explanation
This copy of IBM MQ AMS was licensed to be used in trial mode for a limited period only. This period has expired.
Response
Install a Production license for this copy of IBM MQ AMS.
AMQ9075E
The Beta license for this copy of IBM MQ AMS has expired.
Severity
20 : Error
Explanation
This copy of IBM MQ AMS was licensed to be used for Beta testing for a limited period only. This period has expired.
Response
Install a Production license for this copy of IBM MQ AMS.
AMQ9076I
There are <insert_1> days left in the trial period for this copy of IBM MQ AMS.
Severity
0 : Informational
Explanation
This copy of IBM MQ AMS is licensed for a limited period only.
Response
None.
AMQ9077W
This is the final day of the trial period for this copy of IBM MQ AMS.
Severity
10 : Warning
Explanation
This copy of IBM MQ AMS is licensed for a limited period only.
Response
Install a Production license for this copy of IBM MQ AMS.
AMQ9078I
There is one day left in the trial period for this copy of IBM MQ AMS.
Severity
0 : Informational
Explanation
This copy of IBM MQ AMS is licensed for a limited period only.
Response
None.
AMQ9079I
There are <insert_1> days left in the beta test period for this copy of IBM MQ AMS.
Severity
0 : Informational
Explanation
This copy of IBM MQ AMS is licensed for a limited period only.
Response
None.
AMQ9080I
There is one day left in the Beta test period for this copy of IBM MQ AMS.
Severity
0 : Informational
Explanation
This copy of IBM MQ AMS is licensed for a limited period only.
Response
None.
AMQ9081W
This is the final day of the Beta test period for this copy of IBM MQ AMS.
Severity
10 : Warning
Explanation
This copy of IBM MQ AMS is licensed for a limited period only.
Response
Install a Production license for this copy of IBM MQ AMS.
AMQ9082I
No policies found.
Severity
0 : Informational
Explanation
There are no policies defined.
Response
None.
AMQ9083E (UNIX and Linux)
Missing environment variables are required by IBM MQ AMS to locate %3.
Severity
20 : Error
Explanation
IBM MQ AMS needs to access configuration information to initialize, however the location of the %3 file cannot be determined as environment variables are incorrectly configured for this process.
Response
Unless explicitly overridden by the presence of the MQS_KEYSTORE_CONF environment variable IBM MQ AMS requires the HOME environment variable to be set. Set either MQS_KEYSTORE_CONF or HOME environment variables to identify the location of the %3 file.
AMQ9083E (Windows)
Missing environment variables are required by IBM MQ AMS to locate %3.
Severity
20 : Error
Explanation
IBM MQ AMS needs to access configuration information to initialize, however the location of the %3 file cannot be determined as environment variables are incorrectly configured for this process.
Response
Unless explicitly overridden by the presence of the MQS_KEYSTORE_CONF environment variable IBM MQ AMS requires either HOMEDRIVE and HOMEPATH environment variables to be set. Set either MQS_KEYSTORE_CONF or HOMEDRIVE and HOMEPATH environment variables to identify the location of the %3 file.
AMQ9084I
IBM MQ AMS policy set.
Severity
0 : Informational
Explanation
The IBM MQ AMS policy was set.
Response
None.
AMQ9085I
IBM MQ AMS policy deleted.
Severity
0 : Informational
Explanation
The IBM MQ AMS policy was deleted.
Response
None.
AMQ9086I
Display IBM MQ AMS policy details.
Severity
0 : Informational
AMQ9088I
Key reuse count:
Severity
0 : Informational
AMQ9089E
Invalid value specified for the key reuse argument.
Severity
20 : Error
Explanation
An invalid value has been provided for the key reuse argument.
Response
Specify either 0 (key reuse disabled), 1-9999999 (maximum number of times a key can be used) or * (unlimited key reuse allowed).
AMQ9090E
Client application lacks one or more required IBM MQ AMS capabilities.
Severity
20 : Error
Explanation
IBM MQ AMS detected that an MQ client application connected via channel <insert_3> lacks the required capabilities needed to implement security for policy protected queue <insert_4>. For example the client may be lacking the ability to implement confidentiality policies or symmetric key reuse. The host name is <insert_5>; in some cases the host name cannot be determined and so is shown as '????'. Attempts made by the client application to open, put or get messages may fail with MQRC_SECURITY_ERROR (2063).
Response
Either migrate to a newer version of MQ client libraries that do support the security mandated by the policy on the queue. If it is impossible to migrate the client to a suitable level, consider IBM MQ AMS MCA interception to move the protection and unprotection of messages to the server.
AMQ9091E
Key reuse is not valid for policy.
Severity
20 : Error
Explanation
A non-zero value has been provided as the parameter for the key reuse argument.
Response
Specify either 0 (key reuse disabled) or change the policy to use a quality of protection that allows symmetric key reuse, for example confidentiality.
AMQ9092I
Message with confidentiality protection has been put into the queue <insert_3>.
Severity
0 : Informational
Explanation
The IBM MQ security policy interceptor has successfully put a message with a QoP of 'confidentiality' onto the selected queue.
Response
None.
AMQ9093I
<insert_3> - message was encrypted using <insert_5>.
Severity
0 : Informational
Explanation
This is an informational message used to indicate that a message was encrypted, and to display the encryption algorithm name.
Response
None.
AMQ9094E
AMS security policy internal error: message could not be protected: <insert_5> error code <insert_3> (<insert_1>) in <insert_4>.
Severity
20 : Error
Explanation
The IBM MQ AMS security policy interceptor could not encrypt a message because the indicated <insert_5> error occurred. This can happen for several reasons, all of which are internal failures: (1) the message is not a valid PKCS#7 message; (2) the sender's certificate does not have the required key usage bit to be able to encrypt the message; (3) the sender's certificate was not recognized as a trusted certificate; (4) receiver is not among the recipients of the message.
Response
Consult the IBM MQ AMS information in the Knowledge Center for the explanation of the reason code and take corrective action. If the problem persists, contact the IBM service representative.
AMQ9095E
AMS security policy internal error: message could not be unprotected: <insert_5> error code <insert_3> (<insert_1>) in <insert_4>.
Severity
20 : Error
Explanation
The IBM MQ AMS security policy interceptor could not verify or decrypt a message because the indicated <insert_5> error occurred. This can happen for several reasons, all of which are internal failures: (1) the message is not a valid PKCS#7 message; (2) the sender's certificate does not have the required key usage bit to be able to encrypt the message; (3) the sender's certificate was not recognized as a trusted certificate; (4) receiver is not among the recipients of the message.
Response
Consult the IBM MQ AMS information in the Knowledge Center for the explanation of the reason code and take corrective action. If the problem persists, contact the IBM service representative.
The IBM MQ AMS interceptor could not protect messages for a distribution list because not all of the destinations have compatible policies defined. The <insert_3> destination was found to have an incompatible policy definition when compared to the <insert_4> destination. The policies associated with each queue in the distribution list must match signature and encryption algorithms used, all intended recipients and toleration flags.
Response
Compare the policies defined for <insert_3> and <insert_4> and correct the AMS policies to match. If the problem persists, contact the IBM service representative.
AMQ9097W
AMS policy operation was successful, however the queue is not empty.
Severity
10 : Warning
Explanation
The policy operation was successful, however queue <insert_3> contains at least one message that was put prior to the policy change being effective. If the protection required by the policy has become more restrictive, this could lead to application security errors when browsing or removing the existing messages, alternatively if protection has been removed it could lead to applications retrieving an unusable message payload.
Response
Consider redefining the policy with toleration enabled to handle the existing messages.
AMQ9098E
FIPS mode is not available to AMS.
Severity
30 : Error
Explanation
The IBM MQ AMS interceptor attempted to, but could not enable a FIPS mode of operation. The cryptographic provider used by AMS may have already been initialized for the application process previously without enabling FIPS mode, or the cryptographic provider may not support a FIPS mode of operation.
Response
Check that the AMS cryptographic provider supports FIPS mode and that it has been configured correctly. If the problem persists, contact the IBM service representative.
AMQ9181E
The response set by the exit is not valid.
Severity
30 : Error
Explanation
The user exit <insert_3> returned a response code <insert_1> that is not valid in the ExitResponse field of the channel exit parameters (MQCXP). Message AMQ9190 is issued giving more details, and the channel stops.
Response
Investigate why the user exit program set a response code that is not valid.
AMQ9182E
The secondary response set by the exit is not valid.
Severity
30 : Error
Explanation
The user exit <insert_3> returned a secondary response code <insert_1> in the ExitResponse2 field of the channel exit parameters (MQCXP) that is not valid. Message AMQ9190 is issued giving more details, and the channel stops.
Response
Investigate why the user exit program set a secondary response code that is not valid.
AMQ9183E
The program has ended because the IBM MQ JRE is required, but could not be found.
Severity
20 : Error
Explanation
The program requires the IBM MQ supplied Java Runtime Environment (JRE) in order to run, however the JRE could not be found.
Response
Install the IBM MQ JRE component and retry the command. Or consider using the runmqakm command which does not require a JRE in order to run.
AMQ9184E
The exit buffer address set by the exit is not valid.
Severity
30 : Error
Explanation
The user exit <insert_3> returned an address <insert_1> for the exit buffer that is not valid, when the secondary response code in the ExitResponse2 field of the channel exit parameters (MQCXP) is set to MQXR2_USE_EXIT_BUFFER. Message AMQ9190 is issued giving more details, and the channel stops.
Response
Investigate why the user exit program set an exit buffer address that is not valid. The most likely cause is the failure to set a value, so that the value is 0.
AMQ9185E
The exit space set by the exit is not valid.
Severity
30 : Error
Explanation
The user exit <insert_3> returned an exit space value <insert_1> that is not valid in the ExitSpace field of the channel exit parameters (MQCXP). Message AMQ9190 is issued giving more details, and the channel stops.
Response
Investigate why the user exit program set an exit space value that is not valid. Correct the error.
AMQ9186E
Too much exit space reserved by send exits.
Severity
30 : Error
Explanation
At exit initialization the send exits in the send exit chain for channel <insert_3> returned values in the ExitSpace field of the channel exit parameters (MQCXP). The total of these ExitSpace values is <insert_1>. The maximum number of bytes that can be sent in a single transmission is <insert_2>. Room must be left for at least 1024 bytes of message data in each transmission. So too much exit space has been reserved by the send exits. The channel stops.
Response
Investigate why the send exit programs set exit space values that are too large. Correct the error.
AMQ9187E
The header compression value set by the exit is not valid.
Severity
30 : Error
Explanation
The user exit <insert_3> returned a header compression value <insert_1> in the CurHdrCompression field of the channel exit parameters (MQCXP) that was not one of the negotiated supported values specified in the HdrCompList field of the channel description (MQCD). Message AMQ9190 is issued giving more details, and the channel stops.
Response
Investigate why the user exit program specified a header compression value that was not one of the negotiated supported values.
AMQ9188E
The message compression value set by the exit is not valid.
Severity
30 : Error
Explanation
The user exit <insert_3> returned a message compression value <insert_1> in the CurMsgCompression field of the channel exit parameters (MQCXP) that was not one of the negotiated supported values specified in the MsgCompList field of the channel description (MQCD). Message AMQ9190 is issued giving more details, and the channel stops.
Response
Investigate why the user exit program specified a message compression value that was not one of the negotiated supported values.
AMQ9189E
The data length set by the exit is not valid.
Severity
30 : Error
Explanation
The user exit <insert_3> returned a data length value <insert_1> that was not greater than zero. Message AMQ9190 is issued giving more details, and the channel stops.
Response
Investigate why the user exit program set a data length that is not valid.
AMQ9190E
Channel stopping because of an error in the exit.
Severity
30 : Error
Explanation
The user exit <insert_3>, invoked for channel <insert_4> with id <insert_1> and reason <insert_2>, returned values that are not valid, as reported in the preceding messages. The channel stops.
Response
Investigate why the user exit program set values that are not valid.
AMQ9195E
Data length larger than maximum segment length.
Severity
30 : Error
Explanation
The data length <insert_1> set by send exit <insert_3> is larger than the maximum segment length (<insert_2>). The maximum segment length is the maximum number of bytes that can be sent in a single transmission minus the user exit space required by all the send exits subsequent to the current one in the send exit chain. Message AMQ9190 is issued giving more details, and the channel stops.
Response
Investigate why the user exit program set a data length that is not valid. Correct the error.
AMQ9196E
Data length is larger than the agent buffer length.
Severity
30 : Error
Explanation
The data length <insert_1> set by exit <insert_3> is larger than the agent buffer length. The user exit returned data in the supplied agent buffer, but the length specified is greater than the length of the buffer. Message AMQ9190 is issued giving more details, and the channel stops.
Response
Investigate why the user exit program set a data length that is not valid. Correct the error.
AMQ9197E
Data length is larger than the exit buffer length.
Severity
30 : Error
Explanation
The data length <insert_1> set by exit <insert_3> is larger than the exit buffer length. The user exit returned data in the supplied exit buffer, but the length specified is greater than the length of the buffer. Message AMQ9190 is issued giving more details, and the channel stops.
Response
Investigate why the user exit program set a data length that is not valid.
AMQ9201E
Allocate failed to host <insert_3>.
Severity
30 : Error
Explanation
The attempt to allocate a conversation using <insert_4> to host <insert_3> was not successful.
Response
The error may be due to an incorrect entry in the <insert_4> parameters contained in the channel definition to host <insert_3>. Correct the error and try again. If the error persists, record the error values and contact the systems administrator. The return code from the <insert_4><insert_5> call was <insert_1> (X<insert_2>). It may be possible that the listening program at host <insert_3> is not running. If this is the case, perform the relevant operations to start the listening program for protocol <insert_4> and try again.
AMQ9202E
Remote host not available, retry later.
Severity
30 : Error
Explanation
The attempt to allocate a conversation using <insert_4> to host <insert_3> for channel <insert_5> was not successful. However the error may be a transitory one and it may be possible to successfully allocate a <insert_4> conversation later.
In some cases the remote host cannot be determined and so is shown as '????'.
Response
Try the connection again later. If the failure persists, record the error values and contact the systems administrator. The return code from <insert_4> is <insert_1> (X<insert_2>). The reason for the failure may be that this host cannot reach the destination host. It may also be possible that the listening program at host <insert_3> was not running. If this is the case, perform the relevant operations to start the <insert_4> listening program, and try again.
AMQ9203E
A configuration error for <insert_4> occurred.
Severity
30 : Error
Explanation
Error in configuration for communications to host <insert_3>. Allocation of a <insert_4> conversation to host <insert_3> was not possible.
Response
This error can be reported by channels using a communications protocol of TCP/IP, defined by TRPTYPE(TCP), or by channels using a communications protocol of LU6.2, defined by TRPTYPE(LU62).
For a channel using a communications protocol of TCP/IP. the configuration error may be one of the following:
1.It may be that the host name specified is incorrect. Correct the error and try again.
2.It may be that the host name specified cannot be resolved to a network address. The host name may not be in the nameserver.
For a channel using a communications protocol of LU6.2. the configuration error may be one of the following:
3.It may be that one of the transmission parameters (Mode, or TP Name) is incorrect. Correct the error and try again. The mode name should be the same as the mode defined on host <insert_3>. The TP name on <insert_3> should be defined.
4.It may be that an LU 6.2 session has not been established. Contact the systems administrator.
The return code from the <insert_4><insert_5> call was <insert_1> (X<insert_2>).
Record the error values and tell the system administrator.
AMQ9204E
Connection to host <insert_3> rejected.
Severity
30 : Error
Explanation
Connection to host <insert_3> over <insert_4> was rejected.
Response
The remote system may not be configured to allow connections from this host. Check the <insert_4> listener program has been started on host <insert_3>.
If the conversation uses LU 6.2, it is possible that either the User ID or Password supplied to the remote host is incorrect.
If the conversation uses TCP/IP, it is possible that the remote host does not recognize the local host as a valid host.
The return code from the <insert_4><insert_5> call was <insert_1> X(<insert_2>).
Record the error values and tell the systems administrator.
AMQ9205E
The host name supplied is not valid.
Severity
30 : Error
Explanation
The supplied <insert_4> host name <insert_3> could not be resolved into a network address. Either the name server does not contain the host, or the name server was not available.
Response
Check the <insert_4> configuration on your host.
AMQ9206E
Error sending data to host <insert_3>.
Severity
30 : Error
Explanation
An error occurred sending data over <insert_4> to <insert_3>. This may be due to a communications failure.
Response
The return code from the <insert_4><insert_5> call was <insert_1> X(<insert_2>). Record these values and tell the systems administrator.
AMQ9207E
The data received from host <insert_3> on channel <insert_5> is not valid.
Severity
30 : Error
Explanation
Incorrect data format received from host <insert_3> over <insert_4>. It may be that an unknown host is attempting to send data.
An FFST file might be generated containing the invalid data received. It will not be generated if this is the beginning of a conversation with the remote side, and the format is a simple known format (example: a GET request from an HTTP web browser). To override this, to cause FFST files to be written for any bad data, including simple known formats, then set the environment variable AMQ_BAD_COMMS_DATA_FDCS=TRUE and restart the queue manager.
The channel name is <insert_5>; in some cases it cannot be determined and so is shown as '????'.
Response
Tell the systems administrator.
AMQ9208E
Error on receive from host <insert_3>.
Severity
30 : Error
Explanation
An error occurred receiving data from <insert_3> over <insert_4>. This may be due to a communications failure.
Response
The return code from the <insert_4><insert_5> call was <insert_1> (X<insert_2>). Record these values and tell the systems administrator.
AMQ9209E
Connection to host <insert_3> for channel <insert_5> closed.
Severity
30 : Error
Explanation
An error occurred receiving data from <insert_3> over <insert_4>. The connection to the remote host has unexpectedly terminated.
The channel name is <insert_5>; in some cases it cannot be determined and so is shown as '????'.
Response
Tell the systems administrator.
AMQ9210E
Remote attachment failed.
Severity
30 : Error
Explanation
There was an incoming attachment from a remote host, but the local host could not complete the bind.
Response
The return code from the <insert_4><insert_5> call was <insert_1> (X<insert_2>). Record these values and tell the systems administrator who should check the <insert_4> configuration.
AMQ9211E
Error allocating storage.
Severity
30 : Error
Explanation
The program was unable to obtain enough storage.
Response
Stop some programs which are using storage and retry the operation. If the problem persists contact the systems administrator.
AMQ9212E
A TCP/IP socket could not be allocated.
Severity
30 : Error
Explanation
A TCP/IP socket could not be created, possibly because of a storage problem.
Response
The return code from the <insert_4><insert_5> call was <insert_1> (X<insert_2>). Try the program again. If the failure persists, record the error values and tell the systems administrator.
AMQ9213E
A communications error for <insert_4> occurred.
Severity
30 : Error
Explanation
An unexpected error occurred in communications.
Response
The return code from the <insert_4><insert_5> call was <insert_1> (X<insert_2>). Record these values and tell the systems administrator.
AMQ9214E
Attempt to use an unsupported communications protocol.
Severity
30 : Error
Explanation
An attempt was made to use an unsupported communications protocol type <insert_2>.
Response
Check the channel definition file. It may be that the communications protocol entered is not a currently supported one.
AMQ9215E
Communications subsystem unavailable.
Severity
30 : Error
Explanation
An attempt was made to use the communications subsystem, but it has not been started.
Response
Start the communications subsystem, and rerun the program.
AMQ9216E
Usage: <insert_3> [-m QMgrName] [-n TPName]
Severity
20 : Error
Explanation
Values passed to the responder channel program are not valid. The parameters that are not valid are as follows :-
<insert_4>
The responder channel program exits.
Response
Correct the parameters passed to the channel program and retry the operation.
AMQ9216E (AIX)
Usage: <insert_3> [-m QMgrName]
Severity
20 : Error
Explanation
Values passed to the responder channel program are not valid. The parameters that are not valid are as follows :-
<insert_4>
The responder channel program exits.
Response
Correct the parameters passed to the channel program and retry the operation.
AMQ9217E
The TCP/IP listener program could not be started.
Severity
30 : Error
Explanation
An attempt was made to start a new instance of the listener program, but the program was rejected.
Response
The failure could be because either the subsystem has not been started (in this case we should start the subsystem), or there are too many programs waiting (in this case we should try to start the listener program later).
AMQ9218E
The <insert_4> listener program could not bind to port number <insert_1>.
Severity
30 : Error
Explanation
An attempt to bind the <insert_4> socket to the listener port was unsuccessful.
Response
The failure could be due to another program, including other MQ listeners, using the same port number. The return code from the <insert_3> call for port <insert_5><insert_1> was <insert_2>. Record these values and tell the systems administrator.
AMQ9219E
The TCP/IP listener program could not create a new connection for the incoming conversation.
Severity
30 : Error
Explanation
An attempt was made to create a new socket because an attach request was received, but an error occurred.
Response
The failure may be transitory, try again later. If the problem persists, record the return code <insert_1> and tell the systems administrator. It may be necessary to free some jobs, or restart the communications system.
AMQ9220E
The <insert_4> communications program could not be loaded.
Severity
30 : Error
Explanation
The attempt to load the <insert_4> library or procedure <insert_3> failed with error code <insert_1>.
Response
Either the library must be installed on the system or the environment changed to allow the program to locate it.
AMQ9221E
Unsupported protocol was specified.
Severity
30 : Error
Explanation
The specified value of <insert_3> was not recognized as one of the protocols supported.
Response
Correct the parameter and retry the operation.
AMQ9222W
Cannot find the configuration file.
Severity
10 : Warning
Explanation
The configuration file <insert_3> cannot be found. This file contains default definitions for communication parameters. Default values will be used.
Response
None.
AMQ9223E
Enter a protocol type.
Severity
30 : Error
Explanation
The operation we are performing requires that you enter the type of protocol.
Response
Add the protocol parameter and retry the operation.
AMQ9224E
Unexpected contents in .ini file entry <insert_3> in stanza <insert_4> on line <insert_1> in file <insert_5>.
Severity
30 : Error
Explanation
The entry with name <insert_3> in stanza <insert_4> on line <insert_1> in .ini file <insert_5> is either not a valid keyword or has an invalid value.
Response
Correct the .ini file and retry the operation.
AMQ9225E
File syntax error.
Severity
30 : Error
Explanation
A syntax error was detected on line <insert_1> while processing the INI file.
Response
Correct the problem and retry the operation.
AMQ9225E (Windows)
File syntax error.
Severity
30 : Error
Explanation
A syntax error was detected while processing the configuration data.
Correct the parameters passed to the listener program and retry the operation.
AMQ9227E
<insert_3> local host name not provided.
Severity
30 : Error
Explanation
A name is required for the <insert_3> process to register with the network.
Response
Add a local name to the configuration file and retry the operation.
AMQ9228E
The <insert_4> responder program could not be started.
Severity
30 : Error
Explanation
An attempt was made to start an instance of the responder program, but the program was rejected.
Response
The failure could be because either the subsystem has not been started (in this case we should start the subsystem), or there are too many programs waiting (in this case we should try to start the responder program later). The <insert_5> reason code was <insert_1>.
AMQ9229E
The application has been ended.
Severity
30 : Error
Explanation
We have issued a request to end the application.
Response
None.
AMQ9230E
An unexpected <insert_4> event occurred.
Severity
30 : Error
Explanation
During the processing of network events, an unexpected event <insert_1> occurred.
Response
None.
AMQ9231E
The supplied parameter is not valid.
Severity
30 : Error
Explanation
The value of the <insert_4> <insert_5> parameter has the value <insert_3>. This value has either not been specified or has been specified incorrectly.
Response
Check value of the <insert_5> parameter and correct it if necessary. If the fault persists, record the return code (<insert_1>,<insert_2>) and <insert_4> and tell the systems administrator.
AMQ9232E
No <insert_3> specified
Severity
30 : Error
Explanation
The operation requires the specification of the <insert_3> field.
Response
Specify the <insert_3> and retry the operation.
AMQ9233E
Error creating <insert_3> thread.
Severity
30 : Error
Explanation
The process attempted to create a new thread. The most likely cause of this problem is a shortage of an operating system resource (for example: memory). Use any previous FFSTs to determine the reason for the failure. The IBM MQ internal return code describing the reason for the failure is <insert_1>.
The supplied local communications address cannot be resolved.
Severity
30 : Error
Explanation
The local communications address (LOCLADDR) value <insert_3> cannot be resolved into an IP address.
Response
Enter a local communications address value which can be resolved into an IP address, and try again.
AMQ9236E
The supplied Partner LU was invalid.
Severity
30 : Error
Explanation
The <insert_4> Partner LU name <insert_3> was invalid.
Response
Either the Partner LU name was entered incorrectly or it was not in the <insert_4> communications configuration. Correct the error and try again.
AMQ9237E
A configuration error for <insert_4> occurred.
Severity
30 : Error
Explanation
Allocation of a <insert_4> conversation to host <insert_3> was not possible. The configuration error may be one of the following:
1. It may be that one of the transmission parameters (Mode, or TP Name) was incorrect. Correct the error and try again. The mode name should be the same as the mode defined on host <insert_3>. The TP name on <insert_3> should be defined.
2. It may be that an LU 6.2 session has not been established. Contact the systems administrator.
The return code from <insert_4> is <insert_1> with associated <insert_5> <insert_2>.
Response
Record the error values and tell the system administrator.
AMQ9238E
A communications error for <insert_4> occurred.
Severity
30 : Error
Explanation
An unexpected error occurred in communications.
Response
The return code from the <insert_4><insert_3> call was <insert_1> with associated <insert_5> <insert_2>.
Values passed to the listener program were invalid. The parameter string passed to this program is as follows, default values being used for parameters not supplied: [-m QMgrName] -n TpName -g Gateway-name
Response
Correct the parameters passed to the listener program and retry the operation.
AMQ9240E
An SPX socket was already in use.
Severity
30 : Error
Explanation
The listener received return code <insert_1> when attempting to open socket <insert_2>.
Response
The specified socket is already in use by another process. To use another socket, specify another socket on the command line to runmqlsr or update the default in the qm.ini file.
AMQ9240E (IBM i)
An SPX socket was already in use.
Severity
30 : Error
Explanation
The listener received return code <insert_1> when attempting to open socket <insert_2>.
Response
The specified socket is already in use by another process. To use another socket specify another socket on the command line to STRMQMLSR or update the default in the qm.ini file.
AMQ9240E (Windows)
An SPX socket was already in use.
Severity
30 : Error
Explanation
The listener received return code <insert_1> when attempting to open socket <insert_2>.
Response
The specified socket is already in use by another process. To use another socket, specify a different socket on the command line to the runmqlsr command, or update the default in the configuration data.
AMQ9241E
SPX is not available.
Severity
30 : Error
Explanation
IBM MQ received return code <insert_1> when attempting to start SPX communications.
Response
Ensure that IPX/SPX support is installed on the machine and that it is started before trying to start a IBM MQ SPX channel.
AMQ9242E
SPX resource problem.
Severity
30 : Error
Explanation
IBM MQ received return code <insert_1> when attempting to start SPX communications, indicating a resource problem.
Response
Ensure that sufficient IPX/SPX resources are available before commencing communications over IPX/SPX.
AMQ9243E
The queue manager <insert_3> does not exist.
Severity
30 : Error
Explanation
You tried to perform an action against a queue manager that does not exist. You may have specified the wrong queue manager name.
Response
If you specified the wrong name, correct the name and submit the command again. If the queue manager does not exist, create the queue manager and submit the command again.
Unable to obtain account details for channel MCA user ID.
Severity
10 : Warning
Explanation
IBM MQ was unable to obtain the account details for MCA user ID <insert_3>. This user ID was the MCA user ID for channel <insert_4> on queue manager <insert_5> and may have been defined in the channel definition, or supplied either by a channel exit or by a client.
Response
Ensure that the user ID is correct and that it is defined on the Windows local system, the local domain or on a trusted domain. For a domain user ID, ensure that all necessary domain controllers are available.
AMQ9246E
The TCP/IP listener on port <insert_1> could not start a new channel.
Severity
30 : Error
Explanation
An attempt has been made to connect to the queue manager by starting a new channel within the TCP/IP listener which is listening on port <insert_1>. The maximum socket number which can be used by a channel running on this listener is <insert_2>. A socket number beyond this maximum was allocated for the new channel. This connection attempt has been rejected, but the listener continues to listen for further connection requests. The socket number allocated for a new listener channel is related to the number of channels currently running within that listener process. The problem has arisen because too many channels are directed at the port on which this listener is listening.
Response
An extra listener process should be started to listen on a different port. Some of the channels to the queue manager should be redirected from the port on which the existing listener is listening to the new port.
AMQ9247E
SSPI Security: bad return from SSPI call.
Severity
30 : Error
Explanation
Channel <insert_3> has been closed because the SSPI channel exit received a bad return code from SSPI.
Response
Consult the appropriate SSPI manuals to find out the meaning of status <insert_4> on call <insert_5>, and correct the error.
AMQ9248E
The program could not bind to a <insert_3> socket.
Severity
30 : Error
Explanation
The attempt to bind to socket <insert_4> failed with return code <insert_1>. The failing <insert_3> call was <insert_5>. The most likely cause of this problem is incorrect configuration of the <insert_3> local address or incorrect start and end port parameters.
The request to start the IBM MQ listener failed because there is already a listener running against the specified network resources.
Response
None.
AMQ9259E
Connection timed out from host <insert_3>.
Severity
30 : Error
Explanation
A connection from host <insert_3> over <insert_4> timed out.
Response
The <insert_5> call timed out. Check to see why data was not received in the expected time. Correct the problem. Reconnect the channel, or wait for a retrying channel to reconnect itself.
AMQ9264W
Usage: <insert_3> -m QMgrName -c ChannelName [-n | -q]
-c Generic channel name.
-m Queue manager name.
-n Do not move messages to the new transmission queue.
-q Query the current configuration.
Severity
10 : Warning
Explanation
Values passed to the <insert_3> program are not valid. The parameters that are not valid are as follows :-
<insert_4>
The <insert_3> program exits.
Response
Correct the parameters passed to the <insert_3> program and retry the operation.
AMQ9265I
Switching transmission queues for channel <insert_3> is not required.
Severity
0 : Informational
Explanation
Transmission queue configuration is up-to-date for cluster sender channel <insert_3>. No switching is currently required.
Response
None.
AMQ9266W
Cluster sender channel <insert_3> is currently switching the transmission queues.
Severity
10 : Warning
Explanation
Transmission queue switching from queue <insert_4> to queue <insert_5> for cluster sender channel <insert_3> is currently in progress.
Response
None.
AMQ9267W
Switch to transmission queue <insert_5> is pending for channel <insert_3>. The current transsmission queue <insert_4> has <insert_1> messages queued for the channel.
Severity
10 : Warning
Explanation
There are remaining transmission queue configuration changes from queue <insert_4> to <insert_5> for cluster sender channel <insert_3>.
Response
Start the specified cluster sender channel or repeat the command without the query option to to complete the switching process.
AMQ9268I
Cluster sender channel <insert_3> successfully switched to use XMITQ <insert_5>.
Severity
0 : Informational
Explanation
The XMITQ for cluster sender channel <insert_3> was successfully switched from <insert_4> to <insert_5>.
Response
None.
AMQ9269E
The switch of XMITQ for the cluster sender channel <insert_3> has failed to complete due to reason code <insert_1>. Review the Queue Manager error logs for further details of the failure.
Severity
20 : Error
Explanation
The switch of XMITQ for cluster sender channel <insert_3> from queue <insert_4> to queue <insert_5> has failed to complete with reason code <insert_1>.
Response
None.
AMQ9270E
Sharing conversation could not start.
Severity
30 : Error
Explanation
The attempt to start sharing conversation <insert_1> on socket <insert_2> (channel <insert_3>) was rejected at the server-connection end of the channel.
Response
Examine diagnostic information at the server-connection end of channel <insert_3> to see why the conversation did not start. If possible, correct the error causing the failure and retry.
AMQ9271E
Channel <insert_3> timed out.
Severity
30 : Error
Explanation
A timeout occurred while waiting to receive from the other end of channel <insert_3>. The address of the remote end of the connection was <insert_4>.
Response
The return code from the <insert_5> call was <insert_1> (X<insert_2>). Record these values and tell the systems administrator.
AMQ9272E
Thread mutex semaphore error.
Severity
30 : Error
Explanation
The process attempted an operation on a thread mutex semaphore. The most likely cause of this problem is a shortage of an operating system resource (for example: memory). Use any previous FFSTs to determine the reason for the failure. The IBM MQ function involded was <insert_3> and the internal return code describing the reason for the failure is <insert_1>.
The process attempted an operation on a thread event. The most likely cause of this problem is a shortage of an operating system resource (for example: memory). Use any previous FFSTs to determine the reason for the failure. The IBM MQ function involved was <insert_3> and the internal return code describing the reason for the failure is <insert_1>.
TCP/IP channel <insert_3> suppressed as it does not use a secure communications protocol.
Severity
30 : Error
Explanation
An outbound TCP/IP channel startup for <insert_3> was suppressed as it is not configured to use a secure communications protocol. The queue manager has been configured to only allow TCP/IP channels that use a supported secure communications protocol, for example TLS 1.2.
Response
Configure channel <insert_3> to use a secure protocol by setting a valid CipherSpec value on the channel definition.
Refer to the IBM MQ Security documentation for more information on SSL/TLS configuration.
AMQ9279E
TCP/IP connection request from <insert_4> suppressed as it does not use a secure communications protocol.
Severity
30 : Error
Explanation
An incoming TCP/IP communications request from host <insert_4> was suppressed as it did not propose the use of a secure communications protocol. The queue manager has been configured to only accept TCP/IP communications proposals that use a supported secure communications protocol, for example TLS 1.2.
Response
Configure the peer to use a secure protocol by setting a valid CipherSpec value on the channel definition.
Refer to the IBM MQ Security documentation for more information on SSL/TLS configuration.
AMQ9280E
Parameter requesting Suite B contains an invalid value.
Severity
30 : Error
Explanation
An SSL or TLS channel running on an MQ client has failed to start. This is because the MQSUITEB environment variable, or the MQSCO EncryptionPolicySuiteB field, contains an invalid value. The values specified were <insert_3>.
The channel is <insert_4>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Set the MQSUITEB environment variable, or the MQSCO EncryptionPolicySuiteB field, to a valid value. Restart the channel.
Refer to the IBM MQ Security documentation for more information on Suite B configuration.
AMQ9281E
Parameter requesting Suite B contains an invalid combination of values.
Severity
30 : Error
Explanation
An SSL or TLS channel running on an MQ client has failed to start. This is because the MQSUITEB environment variable, or the MQSCO EncryptionPolicySuiteB field, contains mutually exclusive values. All of the values are valid, but some of them cannot be used together. The values specified were <insert_3>.
The channel is <insert_4>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Set the MQSUITEB environment variable, or the MQSCO EncryptionPolicySuiteB field, to a valid combination of values. Restart the channel.
Refer to the IBM MQ Security documentation for more information on Suite B configuration.
AMQ9282E
Invalid CipherSpec for the configured Suite B security level.
Severity
30 : Error
Explanation
The user is attempting to start a channel on a queue manager or MQ client which has been configured to run in Suite B mode. The user has specified a CipherSpec which does not meet the configured Suite B security level.
The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
The remote host is <insert_4>.
Response
Redefine the channel to run with a Suite B compliant CipherSpec which satisfies the configured Suite B security level. Alternatively, the channel may be defined with the correct CipherSpec and the queue manager or MQ client should not be running in Suite B mode; if this is the case, ensure that Suite B mode is not configured. Once the error is corrected, restart the channel.
Refer to the IBM MQ Security documentation for more information on Suite B security levels and CipherSpecs.
This message might occur after applying IBM MQ maintenance because the FIPS and Suite B standards are updated periodically. When such changes occur, IBM MQ is also updated to implement the latest standard. As a result, you might see changes in behavior after applying maintenance. For more information about the versions of FIPS and Suite B standards enforced by IBM MQ, refer to the readme: http://www-01.ibm.com/support/docview.wss?rs=171&uid=swg27006097
AMQ9285E
The proposed CipherSpec is incompatible with a certificate.
Severity
30 : Error
Explanation
The SSL or TLS handshake failed because the proposed CipherSpec is incompatible with one of the certificates.
It is necessary for both the local and remote systems to use a certificate which is suitable for use with the channel CipherSpec. Common causes of this error include:
(a) An RSA-based CipherSpec was specified when using a certificate which contains a non-RSA public key.
(b) An Elliptic Curve-based CipherSpec was specified when using a certificate which contains a non-EC public key.
The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
The remote host is <insert_4>.
Response
Specify a different CipherSpec which is suitable for use with the digital certificates used on both the local and remote systems. Restart the channel.
Refer to the IBM MQ Security documentation for more information on CipherSpecs.
AMQ9286W
The revocation status of a certificate chain supplied by an SSL or TLS client could not be checked.
Severity
10 : Warning
Explanation
At least one certificate in a certificate chain supplied by the remote end of the channel does not contain an Authority Information Access extension with an OCSP URL and no other certificate revocation checking method is enabled. IBM MQ was unable to check the revocation status of the certificate chain.
The channel name is <insert_5>. In some cases the channel name cannot be determined and so is shown as '????'.
The details of the certificate chain are: <insert_3>
The OCSPAuthentication configuration option for unknown revocation status is currently set to: <insert_4>
The SSL or TLS handshake will be stopped if the OCSPAuthentication option is set to 'Required' or will continue if it is set to 'AllowNoCheck' or 'Warn'.
Response
To enable revocation checking for certificates without an Authority Information Access extension that contains an OCSP URL, an alternative revocation checking method should be configured.
AMQ9287E
Invalid certificate validation policy.
Severity
30 : Error
Explanation
An SSL or TLS channel running on an MQ client has failed to start. This is because the MQCERTVPOL environment variable, or the MQSCO CertificateValPolicy field, contains an invalid value. The value specified was <insert_3>.
The channel is <insert_4>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Set the MQCERTVPOL environment variable, or the MQSCO CertificateValPolicy field, to a valid value. Restart the channel.
Refer to the IBM MQ Security documentation for more information on certificate validation policy configuration.
AMQ9288E
Secure data transfer limit for channel <insert_3> exceeded.
Severity
30 : Error
Explanation
CipherSpec <insert_4> has reached a data transfer limit of <insert_2> (the transfer limit is expressed in terms of TLS records for GCM ciphers, or MB for all other ciphers). Session keys using this CipherSpec must be used only to encrypt a limited quantity of data to reduce the risk of key compromise.
The channel <insert_3> terminated because it exceeded the allowed data transfer limit for its CipherSpec.
Response
This error can be avoided in one of the following ways:
(a) Use secret key reset to ensure that the session key is reset before the data transfer limit is exceeded.
(b) Use a stronger CipherSpec which is not subject to a data transfer limit.
AMQ9289I
Message move complete - no messages moved.
Severity
0 : Informational
Explanation
No messages were moved whilst switching the XMITQ for cluster sender channel <insert_3>. The message move operation is complete.
Response
None.
AMQ9290I
Message move in progress - <insert_1> messages moved.
Severity
0 : Informational
Explanation
<insert_1> messages were moved whilst switching the XMITQ for cluster sender channel <insert_3>. The message move operation is in progress.
<insert_1> messages were moved whilst switching the XMITQ for cluster sender channel <insert_3>. The message move operation is complete.
Response
None.
AMQ9292E
Switch to transmission queue <insert_5> is pending for channel <insert_3> but the current transmission queue <insert_4> could not be accessed due to error code <insert_1>.
Severity
20 : Error
Explanation
The current transmission queue for the channel could not be accessed for the given reason code. In order to switch the transmission queue for a channel it must be possible to access the original transmission queue or we must elect to switch transmission queue without moving messages.
Response
Restore access to the original transmission queue or issue the command using the '-n' parameter.
AMQ9296E
Password protection negotiation failed.
Severity
30 : Error
Explanation
The channel <insert_3> could not be established because it failed to agree a password protection algorithm with the remote machine <insert_5>.
The channel did not start.
Response
Check whether the PasswordProtection attribute in the Channels stanza of <insert_4> prevents interoperability with the remote machine. Consider changing the PasswordProtection attribute.
Alternatively, consider using SSL or TLS to protect passwords instead. We must use a non-null CipherSpec to protect passwords.
AMQ9297W
Password protection negotiation failed for client channel <insert_3>.
Severity
10 : Warning
Explanation
The channel <insert_3> failed to agree a password protection algorithm with the remote machine <insert_5>, any passwords sent by the application will use cleartext. The PasswordProtection attribute in the Channels stanza of <insert_4> is set to WARN and so the channel is permitted to start.
Response
Configure the channel used by the application to use TLS with a non-null CipherSpec to protect data sent over the connection.
AMQ9299I
Channel <insert_3> has started.
Severity
0 : Informational
Explanation
The channel <insert_3> has finished starting.
Response
No action required.
AMQ9401I
Channel <insert_3> autodefined.
Severity
0 : Informational
Explanation
Channel <insert_3> which did not previously exist has been autodefined.
Response
None.
AMQ9402E
Autodefinition exit for channel <insert_3> failed to load.
Severity
30 : Error
Explanation
Autodefinition of channel <insert_3> failed because <insert_4> would not load.
Response
Ensure that the user exit is specified correctly in the queue manager definition, and that the user exit program is correct and available.
AMQ9403E
Autodefinition of channel <insert_3> suppressed by user exit.
Severity
30 : Error
Explanation
Autodefinition exit <insert_4> for channel <insert_3> returned a failure code.
Phase one of REFRESH CLUSTER REPOS(YES) has completed. The Refresh Cluster(<insert_4>) command caused <insert_1> objects to be refreshed and republished to <insert_2> queue managers. Applications attempting to access cluster resources may see failures to resolve cluster resources until phase two of REFRESH CLUSTER is complete. Phase two is complete once all new information has been received from other members of the cluster. Monitor your SYSTEM.CLUSTER.COMMAND.QUEUE to determine when it has reached a consistently empty state to indicate that the refresh process has completed.
The repository queue manager successfully processed a RESET ACTION(FORCEREMOVE) command with the QUEUES(YES) option for the indicated cluster and target queue manager.
Response
None.
AMQ9406E
REFRESH CLUSTER REPOS(YES) command failed, this queue manager is a full repository for cluster <insert_4>.
Severity
30 : Error
Explanation
The repository queue manager could not process a REFRESH CLUSTER command with the REPOS(YES) option for the indicated cluster, because the local queue manager provides full repository management services for the cluster. The command is ignored.
Response
Either
1) Reissue the command without REPOS(YES), or
2) Issue the command on a queue manager which is not a full repository, or
3) Change this queue manager definition so that it is not a full repository.
AMQ9407W
Cluster queue <insert_3> is defined inconsistently.
Severity
10 : Warning
Explanation
The definition of cluster queue <insert_3> on the queue manager with UUID <insert_4> has different DEFPRTY, DEFPSIST, DEFBIND and DEFPRESP values from the definition of the same cluster queue on the queue manager with UUID <insert_5>. Both definitions now exist in the local repository. All definitions of the same cluster queue should be identical. In particular, problems arise if the applications rely on a queue default value which is defined inconsistently to determine messaging behavior. This applies, for example, if the applications open a cluster queue with option MQOO_BIND_AS_Q_DEF. If different instances of the queue have different DEFBIND values the behavior of the message transfer differs depending on which instance of the queue is selected when it is opened. In general the instance selected varies across opens.
Response
For each inconsistency decide which of the values is the correct one. Alter the definitions of cluster queue <insert_3> so that all definitions have correct DEFPRTY, DEFPSIST, DEFBIND and DEFPRESP values.
The remote CLUSRCVR for channel <insert_3> was deleted while undelivered BIND_ON_OPEN messages associated with that channel existed on the local SYSTEM.CLUSTER.TRANSMIT.QUEUE. These messages could not be allocated to another channel because they were put BIND_ON_OPEN, but were very unlikely to ever flow along the channel with which they were associated as this has now been deleted. An attempt has therefore been made to move them from the transmission queue to the local dead-letter queue. The MQDLH reason is MQFB_BIND_OPEN_CLUSRCVR_DEL. Note that any internal IBM MQ Clustering messages for the deleted channel will also have been removed from the SYSTEM.CLUSTER.TRANSMIT.QUEUE (these are discarded) so the current depth of the queue may have decreased by more than the number of user messages moved to the dead-letter queue.
Response
Examine the contents of the dead-letter queue. Each message is contained in an MQDLH structure that includes the reason why it was written and where it was originally addressed. Also look at previous error messages to see if the attempt to put messages to the dead-letter queue failed.
AMQ9409E
Repository manager ended abnormally.
Severity
30 : Error
Explanation
The repository manager process ended abnormally. Termination of this process will cause the queue manager to terminate unless the tuning parameter TolerateRepositoryFailure has been set to 'TRUE'. If the queue manager does not terminate, further cluster management activity will not occur, this will effect the availability of cluster resources accessed or hosted by this queue manager.
Response
Look at previous error messages for the repository manager in the queue manager and system error logs to determine the cause of the failure or contact the IBM support center. Restart the queue manager to restart the repository manager process.
AMQ9410I
Repository manager started.
Severity
0 : Informational
Explanation
The repository manager started successfully.
Response
None.
AMQ9411I
Repository manager ended normally.
Severity
0 : Informational
Explanation
The repository manager ended normally.
Response
None.
AMQ9412E
Repository command received for <insert_3>.
Severity
30 : Error
Explanation
The repository manager received a command intended for some other queue manager, whose identifier is <insert_3>. The command was sent by the queue manager with identifier <insert_4>.
Response
Check the channel and cluster definitions of the sending queue manager.
AMQ9413E
Repository command format error, command code <insert_1>
Manually defined CLUSSDR channels have been forcibly removed.
Severity
0 : Informational
Explanation
The administrator has asked for the queue manager <insert_3> to be deleted, or forcibly removed, but has not yet deleted the manually defined CLUSSDR channels to <insert_3>. The auto-defined channels to <insert_3> have been deleted, but <insert_3> continues to receive updates until the manually defined CLUSSDR channels have been deleted.
Response
Delete the manually defined CLUSSDR channels to <insert_3>.
AMQ9418I
Only one full repository for cluster <insert_3> has been defined.
Severity
0 : Informational
Explanation
The queue manager has received information about a cluster for which it is the only full repository. It is recommended for fault tolerance and availability reasons that every cluster has two queue managers defined as full repositories.
Response
Configure a second queue manager in the cluster to be a full repository and define a cluster sender channel from that queue manager to this queue manager and vice versa.
AMQ9419I
No cluster-receiver channels for cluster <insert_3>
Severity
0 : Informational
Explanation
The repository manager has received information about a cluster for which no cluster-receiver channels are known.
Response
Define cluster-receiver channels for the cluster on the local queue manager.
AMQ9420I
No repositories for cluster <insert_3>.
Severity
0 : Informational
Explanation
The queue manager has received information about a cluster for which no repositories are known.
Response
Alter the REPOS or REPOSNL attribute of the queue manager, that is to have a full repository for the cluster, to specify the cluster name.
AMQ9421E
Invalid cluster record action code detected
Severity
30 : Error
Explanation
An invalid record was read from the SYSTEM.CLUSTER.REPOSITORY.QUEUE. An FFST record has been generated containing the invalid record.
The repository manager tried to send a command to another queue manager using channel <insert_4>. The recipient queue manager, whose identifier is <insert_3>, could not be found. Command code <insert_1>.
Response
Check the channel and cluster definitions of the sending and receiving queue managers.
AMQ9427E
CLUSSDR channel does not point to a repository queue manager.
Severity
30 : Error
Explanation
A CLUSSDR channel must point to a queue manager that hosts repositories for all clusters of which the channel is a member. In addition, the CLUSRCVR for the channel must be a member of all the same clusters as the CLUSSDR channel. The queue manager pointed to by CLUSSDR channel <insert_3> does not meet these criteria for cluster <insert_4>. The remote queue manager has a QMID of <insert_5>.
Response
Check the definitions on the local and remote queue managers to ensure that the CLUSSDR channel points to a queue manager that hosts a repository for the cluster, and that the CLUSRCVR for the channel is a member of the cluster.
AMQ9428E
Unexpected publication of a cluster queue object received.
Severity
30 : Error
Explanation
The local queue manager has received a publication of a cluster queue object from a remote queue manager on cluster <insert_3>. The local queue manager discards the request because it does not host a repository for cluster <insert_3> and has not subscribed to the published object. The remote CLUSSDR channel used to access the local queue manager has a channel name of <insert_4> and the remote queue manager has a QMID of <insert_5>.
Response
Check the definitions on the local and remote queue managers to ensure that the CLUSSDR channel points to a repository queue manager for the cluster.
AMQ9429E
Unexpected publication of a cluster queue deletion received.
Severity
30 : Error
Explanation
The local queue manager has received a publication of a cluster queue deletion from a remote queue manager on cluster <insert_3>. The local queue manager discards the request because it does not host a repository for cluster <insert_3> and has not subscribed to the published object. The remote CLUSSDR channel used to access the local queue manager has a channel name of <insert_4> and the remote queue manager has a QMID of <insert_5>.
Response
Check the definitions on the local and remote queue managers to ensure that the CLUSSDR channel points to a repository queue manager for the cluster.
The local queue manager has received a cluster queue manager publication on cluster <insert_3>. The local queue manager should not have received the publication because it does not host a repository for cluster <insert_3>, it has not subscribed to information concerning the published object, and the published object does not match any of its CLUSSDRs. The queue manager that sent the publication to the local queue manager has QMID <insert_4> (note that this is not necessarily the queue manager which originated the publication). CLUSSDR channel <insert_5> was used to send the publication.
Response
Check the CLUSSDR definition on the sending queue manager to ensure that it points to a repository queue manager for the cluster.
AMQ9431I
Remote queue manager no longer hosts a repository for cluster
Severity
0 : Informational
Explanation
The local queue manager has received a message from remote queue manager QMID <insert_3> indicating that it no longer hosts a repository for cluster <insert_4>. CLUSSDR channel <insert_5> is altered so that it can no longer be used to access queue manager <insert_3> within cluster <insert_4>. If the local queue manager does not host a repository for cluster <insert_4> the relevant subscriptions and publications are remade if possible.
Response
None.
AMQ9432E
Query received by a non-repository queue manager
Severity
30 : Error
Explanation
The local queue manager has received a query from a remote queue manager on cluster <insert_3>. The local queue manager discards the query because it does not host a repository for cluster <insert_3>. The remote CLUSSDR channel used to access the local queue manager has a channel name of <insert_4> and the remote queue manager has a QMID of <insert_5>.
Response
Check the definitions on the local and remote queue managers to ensure that the CLUSSDR channel points to a repository queue manager for the cluster.
AMQ9433E
CLUSRCVR must be in the same cluster as its matching CLUSSDR.
Severity
30 : Error
Explanation
CLUSRCVR channel <insert_3> is not defined as a member of cluster <insert_4>. The local queue manager has received a command that indicates that CLUSSDR channel <insert_3> on the remote queue manager with QMID <insert_5> is defined as a member of cluster <insert_4>.
Response
Alter the CLUSRCVR or CLUSSDR definitions for channel <insert_3>, so that they are both members of the same cluster.
AMQ9434E
Unrecognized message on <insert_3>.
Severity
30 : Error
Explanation
The repository manager found a message on one of its queues having, either a format that could not be recognized, or that did not come from a queue manager or repository manager. The message was put on the dead-letter queue.
Response
Examine the message on the dead-letter queue to determine the originator of the message.
AMQ9435E
Unable to put repository manager message.
Severity
30 : Error
Explanation
The repository manager tried to send a message to the SYSTEM.CLUSTER.COMMAND.QUEUE on another queue manager whose identifier is <insert_3>, but the MQPUT call was unsuccessful. MQCC=<insert_1>, MQRC=<insert_2>. Processing continues, but the repository information may be out of date.
Response
Refer to the Application Programming Reference manual for information about MQCC <insert_1> and MQRC <insert_2>. Check the channel and cluster definitions on the local and target queue managers, and ensure that the channels between them are running. When the problem is corrected, the repository information will normally be updated automatically. The REFRESH CLUSTER command can be used to ensure that the repository information is up to date.
AMQ9436E
Unable to send repository manager message.
Severity
30 : Error
Explanation
The repository manager tried to send a message to the SYSTEM.CLUSTER.COMMAND.QUEUE on a queue manager that has the full repository for the specified cluster(<insert_3>), but the MQPUT call was unsuccessful. MQCC=<insert_1>, MQRC=<insert_2>. Processing continues, but repository information may be out of date.
Response
Refer to the Application Programming Reference manual for information about MQCC <insert_1> and MQRC <insert_2>. Check the channel and cluster definitions on the local and target queue managers, and ensure that the channels between them are running. When the problem is corrected, the repository information will normally be updated automatically. The REFRESH CLUSTER command can be used to ensure that the repository information is up to date.
AMQ9437E
Unable to commit repository manager changes.
Severity
20 : Error
Explanation
The repository manager tried to commit some internal operations but was unsuccessful. The reason code from the MQCMIT call was <insert_1>.
CONNAME could not be discovered for CLUSRCVR <insert_3>.
Severity
30 : Error
Explanation
TCP/IP CLUSRCVR <insert_3> was validly specified with a blank or absent CONNAME parameter. However when the repository process, amqrrmfa, attempted to obtain the CONNAME (IP address) for itself it was unable to. If there is an existing matching CLUSRCVR object in the cache its CONNAME is used. The CONNAME used was <insert_4>.
Response
Check the error log for a message arising from an associated TCP/IP call (gethostname, gethostbyname or inet_ntoa). Pass all the error information to the systems administrator.
AMQ9439E
Repository corruption: bad CLQMGR object for channel <insert_3>.
RESET CLUSTER(<insert_3>) QMNAME(<insert_4>) command failed. To issue this command, queue manager <insert_5> must be a repository for cluster <insert_3>. Alter the queue manager attributes REPOS, or REPOSNL, to include cluster <insert_3> and retry the command.
Response
None.
AMQ9441I
Reset command processed.
Severity
0 : Informational
Explanation
The reset Cluster(<insert_3>) Qmname(<insert_4>) command has processed on this repository and <insert_1> queue managers have been deleted from the cluster.
Phase one of REFRESH CLUSTER has completed. The Refresh Cluster(<insert_4>) command caused <insert_1> objects to be refreshed and republished to <insert_2> queue managers. Applications attempting to access cluster resources may see failures to resolve cluster resources until phase two of REFRESH CLUSTER is complete. Phase two is complete once all new information has been received from other members of the cluster. Monitor your SYSTEM.CLUSTER.COMMAND.QUEUE to determine when it has reached a consistently empty state to indicate that the refresh process has completed.
Response
None.
AMQ9443I
Suspend Qmgr Cluster command processed.
Severity
0 : Informational
Explanation
The Suspend Qmgr Cluster(<insert_4>) command completed. <insert_1> objects suspended. In the case of suspending a list of clusters, the cluster name shown is the first name in the list.
Response
None.
AMQ9444I
Resume Qmgr Cluster command processed.
Severity
0 : Informational
Explanation
The Resume Qmgr Cluster(<insert_4>) command completed. <insert_1> objects resumed. In the case of resuming a list of clusters, the cluster name shown is the first name in the list.
Response
None.
AMQ9445E
Error creating channel <insert_3>.
Severity
30 : Error
Explanation
Channel <insert_4> tried to replace itself by creating channel <insert_3>. The attempt to create the channel was unsuccessful for the following reason: "<insert_5>". A previous message may give further information.
Response
Rectify the problem which prevented successful creation of channel <insert_3>. Restart channel <insert_4>.
AMQ9446E
Error deleting channel <insert_3>.
Severity
30 : Error
Explanation
Channel <insert_3> tried to delete itself after creating channel <insert_4> to replace it. The attempt to delete the channel was unsuccessful for the following reason: "<insert_5>".
Response
If channel <insert_3> still exists rectify the problem which prevented its deletion and then manually delete the channel.
AMQ9447E
Unable to backout repository manager changes.
Severity
20 : Error
Explanation
The repository manager tried to back out some internal operations but was unsuccessful. The reason code from the MQBACK call was <insert_1>.
Repository manager failed. Retry in <insert_1> minutes, queue manager will terminate in <insert_2> minutes
Severity
30 : Error
Explanation
Repository manager encountered a severe problem. See the earlier messages in the queue manager or system error logs for details. The repository manager will retry the command in <insert_1> minutes. If the problem is not rectified in <insert_2> minutes the queue manager will terminate. Until this problem is rectified no further cluster management activity will occur, this will affect the availability of cluster resources accessed or hosted by this queue manager.
Response
If possible, rectify the identified problem, otherwise contact the IBM support center. To postpone the queue manager from terminating due to this problem set the SYSTEM.CLUSTER.COMMAND.QUEUE queue to be GET(DISABLED). Once the problem has been rectified, set the queue to be GET(ENABLED) and wait for the repository manager to retry the command or restart the queue manager.
AMQ9449I
The repository manager is restarting following an error.
Severity
0 : Informational
Explanation
The repository manager is restarting following an error, see earlier error messages for details of the failure.
Response
If the failure re-occurs contact the IBM support center and follow any instructions in the subsequent error messages.
Values passed to the channel table writer program were invalid.
The parameter string passed to this program is as follows:
[-m QMgrName] -f OutputFile [-v OutputFileVersion]
where OutputFileVersion can be either 2 or 5 (5 is the default)
Default values will be used for parameters not supplied.
Response
Correct the parameters passed to the channel table writer program and retry the operation.
AMQ9453I
FORCEREMOVE command failed, cluster <insert_3> target <insert_4> is not unique.
Severity
0 : Informational
Explanation
The repository queue manager could not process a RESET ACTION(FORCEREMOVE) command for the indicated cluster and target queue manager, because there is more than one queue manager with the specified name in the cluster. The command is ignored.
Response
Reissue the command specifying the identifier (QMID) of the queue manager to be removed, rather than its name.
AMQ9455I
FORCEREMOVE command failed, cluster <insert_3>, target <insert_4>, not found.
Severity
0 : Informational
Explanation
The repository queue manager could not process a RESET ACTION(FORCEREMOVE) command for the indicated cluster and target queue manager, because no information about that queue manager was found in the local repository. The command is ignored.
Response
Reissue the command, specifying the correct queue manager name or identifier.
AMQ9456I
Update not received for queue <insert_3>, queue manager <insert_4> from full repository for cluster <insert_5>.
Severity
0 : Informational
Explanation
The repository manager detected a cluster queue that had been used sometime in the last 30 days for which updated information should have been sent from a full repository. However, this has not occurred.
The repository manager will keep the information about this queue for a further 60 days from when the error first occurred.
Response
There are several possible responses:
1) There is a long-running problem with the local queue manager's CLUSRCVR in cluster <insert_5>. If this is true, then correct the problem urgently, to ensure that updates for the cluster are received.
2) There is a long-running problem on the remote queue manager's CLUSSDR in cluster <insert_5>. If this is true, then correct the problem urgently, to ensure that updates for the cluster are sent.
3) Check that the repository manager on the remote queue manager has not ended abnormally.
4) The remote queue manager is out of step with this queue manager, potentially due to a restore of the remote queue manager from a backup. The remote queue manager must issue REFRESH CLUSTER to synchronize with other queue managers in the cluster.
5) The remote queue manager is out of step with this queue manager, potentially due to a disaster recovery exercise in which a replacement queue manager with the same CLUSRCVR channel name was created, was run for a while, then ended. If this has happened, then the remote queue manager <insert_4> must now issue REFRESH CLUSTER to synchronize with other queue managers in the cluster.
6) If the above items have been checked, and this problem persists over several days (causing repeats of this error message in the local queue manager's error logs) then contact the IBM support center.
The repository queue manager received a command from another queue manager, whose identifier is <insert_3>, reporting that it is again a repository for cluster <insert_4>. The cluster-sender channel <insert_5> is changed so that it can be used to access the other queue manager in relation to the the cluster.
Response
None.
AMQ9458E
Unable to access the repository cache exclusively.
Severity
30 : Error
Explanation
A process remains registered as requiring access to the repository cache during an operation that must have exclusive access to the cache. The queue manager <insert_3> issues this message after waiting for the process to remove its registration, but the registration is still present. The process preventing exclusive access to the repository cache has <insert_2> outstanding registrations.
Response
The registered process identifier (PID) accessing the repository cache is <insert_1>. Determine if this process is still running or terminated. If the process is not running or if the problem persists collect the items listed in the 'Problem determination' section of the System Administration manual and contact the IBM support center.
AMQ9459W
Cluster topic <insert_3> from <insert_4> rejected due to PSCLUS(DISABLED)
Severity
10 : Warning
Explanation
Queue manager attribute PSCLUS has been set to DISABLED to indicate that Publish/Subscribe activity is not expected between queue managers in this cluster. However, information regarding cluster topic <insert_3> has been sent to this queue manager over a channel from <insert_4>. The cluster topic definition is ignored and will not be visible from this queue manager.
Response
If you wish to enable publish/subscribe clustering, alter the PSCLUS attribute on all queue managers in the cluster to ENABLED. You may also need to issue REFRESH CLUSTER and REFRESH QMGR commands as detailed in the PSCLUS documentation. If we are not using publish/subscribe clusters we should delete the clustered topic object, and ensure PSCLUS is DISABLED on all queue managers.
AMQ9461I
Internal record for cluster object name <insert_3> has been checked and found to have incorrect contents
Severity
0 : Informational
Explanation
Internal checks for data consistency have found a problem with object name <insert_3>. Please contact the IBM Support representative.
Response
Keep this error message and provide it to the IBM Support representative. An additional command amqrfdm -mQMNAME -b can also be run, and this will dump extra data into FFST records. Again, provide these to IBM Support.
The definition of cluster topic <insert_3> on the queue manager with UUID <insert_4> has a different <insert_5> attribute value than one or more cluster topics that already exist in the cluster cache. The existing topic objects are reported by message AMQ9466. All definitions of the same cluster topic should be identical, otherwise, problems may arise if the applications rely on one of these attributes to determine messaging behavior. For example, if an application opens a cluster topic and the different instances of the topic have different TOPICSTR values, the behavior of the message transfer depends on which instance of the topic happens to be selected when it is opened.
Response
Alter the definitions of the topic on the various queue managers so that they have identical values for all attributes.
AMQ9466W
Cluster topic definitions inconsistent.
Severity
10 : Warning
Explanation
The definition of cluster topic <insert_3> on the queue manager with UUID <insert_4> has a different <insert_5> attribute value than a cluster topic being added to the cluster cache. The topic object being added is reported by message AMQ9465. All definitions of the same cluster topic should be identical, otherwise, problems may arise if the applications rely on one of these attributes to determine messaging behavior. For example, if an application opens a cluster topic and the different instances of the topic have different TOPICSTR values, the behavior of the message transfer depends on which instance of the topic happens to be selected when it is opened.
Response
Alter the definitions of the topic on the various queue managers so that they have identical values for all attributes.
AMQ9467E
Repository error updating topic
Severity
20 : Error
Explanation
The cluster repository manager received an unexpected error code from the queue manager while updating topic <insert_3>. The Completion code was <insert_1>, reason code was <insert_2>.
Response
Refer to the IBM MQ product documentation about reason code <insert_2>. Collect the items listed in the Troubleshooting and support section of the IBM MQ product documentation, and use either the IBM MQ Support site, or the IBM Support Assistant (ISA), to see whether a solution is already available. If we are unable to find a match, contact the IBM support center.
AMQ9468I
Cluster receiver channel <insert_3> has been configured by multiple queue managers
Severity
0 : Informational
Explanation
Queue manager <insert_4> has joined a cluster using a cluster receiver channel with the same name as one that has already been defined by queue manager <insert_5>. All cluster receiver channels used within a cluster must be uniquely named. Only the last queue manager to join the cluster will use the named channel, Queue manager <insert_5> will not successfully participate in the cluster while the newer queue manager is a member.
Response
The use of a channel name currently associated with a different queue manager in the cluster may be intentional, for example the original queue manager may have been deleted and re-created as a new queue manager. However, accidental duplication of a channel name across multiple queue managers would also result in this behaviour. If this was not intended, further investigation into the configuration of the queue managers should be performed.
AMQ9469W
Update not received for CLUSRCVR channel <insert_3> hosted on queue manager <insert_4> in cluster <insert_5>.
Severity
10 : Warning
Explanation
The repository manager detected that the CLUSRCVR channel has not been re-published by its owning queue manager. This re-publish action should have happened automatically <insert_1> days ago, or in the time between then and now.
The repository manager will check for this condition approximately every hour, continuing for a period of approximately <insert_2> days from now. If an update for the CLUSRCVR channel is received during this period, these messages will stop. If no update is received, these messages will continue to be written. However, after this period has elapsed, if no update has been received, the local queue manager will discard its knowledge of this channel, and these messages will stop. We should be aware that Partial Repository queue managers in this cluster will cease to be able to use the channel at about that time.
Response
There are several possible responses:
1) If the channel had been removed intentionally, and is no longer required, we should consider removing it fully via the RESET CLUSTER command.
2) There is a long-running problem with the local queue manager's CLUSRCVR in cluster <insert_5>. If this is true, then correct the problem urgently, to ensure that updates for the cluster are received.
3) There is a long-running problem on the remote queue manager's CLUSSDR in cluster <insert_5>. If this is true, then correct the problem urgently, to ensure that updates for the cluster are sent.
4) Check that the repository manager on the remote queue manager has not ended abnormally.
5) The remote queue manager is out of step with this queue manager, potentially due to a restore of the remote queue manager from a backup. The remote queue manager must issue REFRESH CLUSTER to synchronize with other queue managers in the cluster.
6) The remote queue manager is out of step with this queue manager, potentially due to a disaster recovery exercise in which a replacement queue manager with the same CLUSRCVR channel name was created, was run for a while, then ended. If this has happened, then the remote queue manager <insert_4> must now issue REFRESH CLUSTER to synchronize with other queue managers in the cluster.
7) If the above items have been checked, and this problem persists over several days (causing repeats of this error message in the local queue manager's error logs) then contact the IBM support center.
AMQ9487E
Remote queue manager is a standby queue manager instance.
Severity
30 : Error
Explanation
Channel <insert_3> is closing because the remote queue manager at address <insert_5> is currently a standby queue manager instance.
Response
None.
AMQ9488E
Program cannot connect to a standby queue manager instance.
Severity
30 : Error
Explanation
The connection attempt to queue manager <insert_4> failed with reason code <insert_1> because it is a standby queue manager instance.
Response
Standby queue manager instances do not accept connections. Connect to the active queue manager instance instead.
AMQ9489E
The maximum number of instances, <insert_1>, of channel <insert_3> was reached.
Severity
30 : Error
Explanation
The server-connection channel <insert_3> is configured so that the maximum number of instances that can run at the same time is <insert_1>. This limit was reached.
Response
Try the operation again when a new instance can be started.
If the limit has been reached because there are too many connections from one or more of our client applications, consider changing the applications to make fewer connections.
If we are not making use of sharing conversations, consider switching to this mode of operation because several client connections can then share one channel instance.
AMQ9490E
The maximum number of instances, <insert_1>, of channel <insert_3> was reached for an individual client.
Severity
30 : Error
Explanation
The server-connection channel <insert_3> is configured so that the maximum number of instances that can run at the same time for any individual client is <insert_1>. This limit was reached for the client with remote network address <insert_4>.
Response
Try the operation again when a new instance can be started for this client.
If the limit has been reached because there are too many connections from the relevant client application, consider changing the application to make fewer connections.
If we are not making use of sharing conversations, consider switching to this mode of operation because several client connections can then share one channel instance.
AMQ9491E
Transmission queue <insert_3> set to NOSHARE.
Severity
20 : Error
Explanation
The channel <insert_4> on queue manager <insert_5> cannot start because this queue manager has a setting for PipeLineLength greater than 1, and so multiple threads will run in this channel's MCA. Only the first thread would be able to open the transmission queue <insert_3> because it is set to be non-shareable.
Response
Check the definition of the transmission queue <insert_3> on queue manager <insert_5> and set it to be SHARE instead of NOSHARE. Alternatively, we can set all channels on this queue manager to use only a single thread, by using the PipeLineLength parameter.
AMQ9492E
The <insert_3> responder program encountered an error.
Severity
30 : Error
Explanation
The responder program was started but detected an error.
The host name was <insert_5>; in some cases the host name cannot be determined and so is shown as '????'.
Response
Look at previous error messages in the error files to determine the error encountered by the responder program.
AMQ9494E
A protocol error was detected for channel <insert_3>.
Severity
30 : Error
Explanation
During communications with the remote queue manager, a TCP/IP read and receive call returned EINTR, indicating that it had been interrupted. Immediately after this the channel program detected a protocol error. The failure type was <insert_1> with associated data of <insert_2>.
Response
If we are running an AIX client we will avoid problems arising from EINTRs on TCP/IP reads, by writing the application so that system calls interrupted by signals are restarted. We must establish the signal handler with sigaction(2) and set the SA_RESTART flag in the sa_flags field of the new action structure. If we are running on a platform other than AIX, an AIX server, or an AIX client with an application that adheres to the restart guidelines provided above, contact the systems administrator who should examine the error logs to determine the cause of the failure.
AMQ9495E
The CLWL exit <insert_3> is inconsistent with a dynamic cache.
Severity
30 : Error
Explanation
When the CLWL exit <insert_3> was called for the ExitReason MQXR_INIT, the value <insert_1> was returned in the ExitResponse2 field. This indicates the CLWL exit is incompatible with the Queue Manager cache type which is dynamic. Either change the Queue Manager cache type to static (using the Tuning Parameter, ClusterCacheType=STATIC) or rewrite the CLWL exit to be compatible with a dynamic cache". The CLWL exit has been suppressed.
Response
None.
AMQ9496E
Channel ended by a remote exit.
Severity
30 : Error
Explanation
Channel program <insert_3> was ended because the channel exit at the remote host <insert_4> requested it.
Response
Examine the error logs at the remote end of the channel to see the reason why the remote exit ended the channel.
Correct the parameters passed to the channel program and retry the operation.
AMQ9502E
Type of channel not suitable for action requested.
Severity
30 : Error
Explanation
The operation requested cannot be performed on channel <insert_3>. Some operations are only valid for certain channel types. This channel is a <insert_4> channel type. For example, we can only ping or trigger a channel from the initiating end.
Response
Check whether the channel name is specified correctly. If it is check that the channel has been defined correctly.
AMQ9503E
Channel negotiation failed.
Severity
30 : Error
Explanation
Channel <insert_3> between this machine and the remote machine <insert_4> could not be established due to a negotiation failure. In some cases the channel name can not be determined and so is shown as '????'.
The last control data received was type <insert_1> with associated error code <insert_2>.
Response
Tell the systems administrator, who should attempt to identify the cause of the channel failure using problem determination techniques. For example, look for FFST files, and examine the error logs on the local and remote systems where there may be messages explaining the cause of failure. More information may be obtained by repeating the operation with tracing enabled.
AMQ9504E
A protocol error was detected for channel <insert_3>.
Severity
30 : Error
Explanation
During communications with the remote queue manager, the channel program detected a protocol error. The failure type was <insert_1> with associated data of <insert_2>.
Response
Contact the systems administrator who should examine the error logs to determine the cause of the failure.
AMQ9505E
Channel sequence number wrap values are different.
Severity
30 : Error
Explanation
The sequence number wrap value for channel <insert_3> is <insert_1>, but the value specified at the remote location is <insert_2>. The two values must be the same before the channel can be started.
Response
Change either the local or remote channel definitions so that the values specified for the message sequence number wrap values are the same.
AMQ9506E
Message receipt confirmation failed.
Severity
30 : Error
Explanation
Channel <insert_3> has ended because the remote queue manager on host <insert_4> did not accept the last batch of messages.
Response
The error log for the channel at the remote site will contain an explanation of the failure. Contact the remote Systems Administrator to resolve the problem.
AMQ9507E
Channel <insert_3> is currently in-doubt.
Severity
30 : Error
Explanation
The requested operation cannot complete because the channel is in-doubt with host <insert_4>.
Response
Examine the status of the channel, and either restart a channel to resolve the in-doubt state, or use the RESOLVE CHANNEL command to correct the problem manually.
AMQ9508E
Program cannot connect to the queue manager.
Severity
30 : Error
Explanation
The connection attempt to queue manager <insert_4> failed with reason code <insert_1>.
Response
Ensure that the queue manager is available and operational.
AMQ9509E
Program cannot open object <insert_4>
Severity
30 : Error
Explanation
The attempt to open either the queue or queue manager object <insert_4> on queue manager <insert_5> failed with reason code <insert_1>.
Response
Ensure that the queue is available and retry the operation.
AMQ9510E
Messages cannot be retrieved from a queue.
Severity
30 : Error
Explanation
The attempt to get messages from queue <insert_4> on queue manager <insert_5> failed with reason code <insert_1>.
Response
If the reason code indicates a conversion problem, for example MQRC_SOURCE_CCSID_ERROR, remove the message(s) from the queue. Otherwise, ensure that the required queue is available and operational.
AMQ9511E
Messages cannot be put to a queue.
Severity
30 : Error
Explanation
The attempt to put messages to queue <insert_4> on queue manager <insert_5> failed with reason code <insert_1>.
Response
Ensure that the required queue is available and operational.
AMQ9512E
Ping operation is not valid for channel <insert_3>.
Severity
30 : Error
Explanation
Ping may only be issued for SENDER, SERVER or CLUSSDR channel types.
The maximum number of channels that can be in use simultaneously has been reached. The current defined maximum number of channels is <insert_1>. The number of permitted channels is a configurable parameter in the queue manager configuration file.
Response
Wait for some of the operating channels to close. Retry the operation when some channels are available.
AMQ9514E
Channel <insert_3> is in use.
Severity
30 : Error
Explanation
The requested operation failed because channel <insert_3> is currently active.
Response
Either end the channel manually, or wait for it to close, and retry the operation.
AMQ9515W
Channel <insert_3> changed.
Severity
10 : Warning
Explanation
The statistics shown are for the channel requested, but it is a new instance of the channel. The previous channel instance has ended.
Response
None.
AMQ9516E
File error occurred for file <insert_3>.
Severity
30 : Error
Explanation
The filesystem returned error code <insert_1> for file <insert_3>.
Response
Record the name of the file and tell the systems administrator, who should ensure that file is correct and available, for example that the current user has appropriate access to the file for reading or writing.
AMQ9516E (IBM i)
File error occurred.
Severity
30 : Error
Explanation
The filesystem returned error code <insert_4> for file <insert_3>.
Response
Record the name of the file <insert_3> and tell the systems administrator, who should ensure that file <insert_3> is correct and available.
AMQ9517E
File damaged.
Severity
30 : Error
Explanation
The program has detected damage to the contents of file <insert_3>.
Response
Record the values and tell the systems administrator who must restore a saved version of file <insert_3>. The return code was <insert_1> and the record length returned was <insert_2>.
AMQ9518E
File <insert_3> not found.
Severity
30 : Error
Explanation
The program requires that the file <insert_3> is present and available.
Response
This error may be caused by the program specifying an incorrect file location programmatically via MQCNO value through CCDTUrlPtr or CCDTUrlOffset. If the program has not specified the file location, the environment variables MQCHLLIB, MQCHLTAB or MQCCDTURL may have been specified. If none of these environment variables are set, the location of the file may have been specified in the mqclient.ini through ChannelDefinitionDirectory and ChannelDefinitionFile attributes under the Channels stanza. If the location was not configured programmatically, by environment variable or by mqclient.ini values then <insert_3> represents a default location and filename for this installation. Ensure that file location is correctly configured and that the file is available to the program.
AMQ9519E
Channel <insert_3> not found.
Severity
30 : Error
Explanation
The requested operation failed because the program could not find a definition of channel <insert_3>.
Response
Check that the name is specified correctly and the channel definition is available.
AMQ9520E
Channel not defined remotely.
Severity
30 : Error
Explanation
There is no definition of channel <insert_3> at the remote location.
Response
Add an appropriate definition to the remote hosts list of defined channels and retry the operation. The remote host is <insert_4>.
AMQ9521E
Host is not supported by this channel.
Severity
30 : Error
Explanation
The connection across channel <insert_5> was refused because the remote host <insert_4> did not match the host <insert_3> specified in the channel definition.
Response
Update the channel definition, or remove the explicit mention of the remote machine connection name.
AMQ9522E
Error accessing the status table.
Severity
30 : Error
Explanation
The program could not access the channel status table.
Response
A value of <insert_1> was returned from the subsystem when an attempt was made to access the channel status table. Contact the systems administrator, who should examine the log files to determine why the program was unable to access the status table.
AMQ9523E
Remote host detected a protocol error.
Severity
30 : Error
Explanation
During communications through channel <insert_3>, the remote queue manager channel program detected a protocol error. The failure type was <insert_1> with associated data of <insert_2>.
Response
Tell the systems administrator, who should examine the error files to determine the cause of the failure.
AMQ9524E
Remote queue manager unavailable.
Severity
30 : Error
Explanation
Channel <insert_3> cannot start because the remote queue manager on host <insert_4> is not currently available.
Channel <insert_3> is closing because the remote queue manager on host <insert_4> is ending.
Response
None.
AMQ9526E
Message sequence number error for channel <insert_3>.
Severity
30 : Error
Explanation
The local and remote queue managers do not agree on the next message sequence number. A message with sequence number <insert_1> has been sent when sequence number <insert_2> was expected. The remote host is <insert_4>.
Response
Determine the cause of the inconsistency. It could be that the synchronization information has become damaged, or has been backed out to a previous version. If the situation cannot be resolved, the sequence number can be manually reset at the sending end of the channel using the RESET CHANNEL command.
AMQ9527E
Cannot send message(s) through channel <insert_3>.
Ensure that the queue name is specified correctly. If so, alter the queue usage parameter of the queue to that of a transmission queue.
AMQ9532E
Program cannot set queue attributes.
Severity
30 : Error
Explanation
The attempt to set the attributes of queue <insert_4> on queue manager <insert_5> failed with reason code <insert_1>.
Response
Ensure that the queue is available and retry the operation.
AMQ9533W
Channel <insert_3> is not currently active.
Severity
10 : Warning
Explanation
The channel was not stopped because it was not currently active. If attempting to stop a specific instance of a channel by connection name or by remote queue manager name this message indicates that the specified instance of the channel is not running.
Response
None.
AMQ9534E
Channel <insert_3> is currently not enabled.
Severity
30 : Error
Explanation
The channel program ended because the channel is currently not enabled.
Response
Issue the START CHANNEL command to re-enable the channel.
AMQ9535E
User exit not valid.
Severity
30 : Error
Explanation
Channel program <insert_3> ended because user exit <insert_4> is not valid.
Architecture of the exit library does not match the process's architecture which is <insert_5> bit.
Response
Ensure that the user exit is specified correctly in the channel definition, and that the user exit program is correct and available.
AMQ9535E (IBM i)
User exit not valid.
Severity
30 : Error
Explanation
Channel program <insert_3> ended because user exit <insert_4> is not valid.
Response
Ensure that the user exit is specified correctly in the channel definition, and that the user exit program is correct and available.
AMQ9536E
Channel ended by an exit.
Severity
30 : Error
Explanation
Channel program <insert_3> was ended by exit <insert_4>.
Correct the parameters passed to the program and retry the operation.
AMQ9538E
Commit control error.
Severity
30 : Error
Explanation
An error occurred when attempting to start commitment control. Either exception <insert_3> was received when querying commitment status, or commitment control could not be started.
Response
Refer to the error log for other messages pertaining to this problem.
AMQ9539E
No channels available.
Severity
30 : Error
Explanation
The channel initiator program received a trigger message to start an MCA program to process queue <insert_3>. The program could not find a defined, available channel to start.
Response
Ensure that there is a defined channel, which is enabled, to process the transmission queue.
AMQ9540E
Commit failed.
Severity
30 : Error
Explanation
The program ended because return code <insert_1> was received when an attempt was made to commit change to the resource managers. The commit ID was <insert_3>.
The program ended because, either the source CCSID <insert_1> or the target CCSID <insert_2> is not valid, or is not currently supported.
Response
Correct the CCSID that is not valid, or ensure that the requested CCSID can be supported.
AMQ9542W
Queue manager is ending.
Severity
10 : Warning
Explanation
The program will end because the queue manager is quiescing.
Response
None.
AMQ9543E
Status table damaged.
Severity
30 : Error
Explanation
The channel status table has been damaged.
Response
End all running channels and issue a DISPLAY CHSTATUS command to see the status of the channels. Use the standard facilities supplied with the system to record the problem identifier and to save any generated output files. Use either the MQ Support site: https://www.ibm.com/support/home/, or IBM Support Assistant (ISA): https://www.ibm.com/support/home/product/C100515X13178X21/other_software/ibm_support_assistant, to see whether a solution is already available. If we are unable to find a match, contact the IBM support center. Do not discard these files until the problem has been resolved.
Examine the contents of the remote dead-letter queue. Each message is contained in a structure that describes why the message was put to the queue, and to where it was originally addressed. Also look at previous error messages to see if the attempt to put messages to a local dead-letter queue failed.
AMQ9545I
Disconnect interval expired.
Severity
0 : Informational
Explanation
Channel <insert_3> closed because no messages arrived on the transmission queue within the disconnect interval period.
Response
None.
AMQ9546E
Error return code received.
Severity
30 : Error
Explanation
The program has ended because return code <insert_1> was returned from function <insert_3>
Response
Correct the cause of the failure and retry the operation.
AMQ9547E
Type of remote channel not suitable for action requested.
Severity
30 : Error
Explanation
The operation requested cannot be performed because channel <insert_3> on the remote machine is not of a suitable type. For example, if the local channel is defined as a sender the remote machine must define its channel as either a receiver or requester.
Response
Check that the channel name is specified correctly. If it is, check that the remote channel has been defined correctly.
AMQ9548W
Message put to the local 'dead-letter queue'.
Severity
10 : Warning
Explanation
A message could not be processed and has been moved to the dead-letter queue.
Response
Examine the contents of the dead-letter queue. Each message is contained in a structure that describes why the message was put to the queue, and to where it was originally addressed.
AMQ9549E
Transmission Queue <insert_3> inhibited for MQGET.
Channel program <insert_3> cannot be stopped at this time.
Severity
30 : Error
Explanation
The channel program can not be terminated immediately but should end shortly.
Response
If the channel does not end in a short time issue the STOP CHANNEL command again.
AMQ9551E
Protocol not supported by remote host.
Severity
30 : Error
Explanation
The operation we are performing over channel <insert_3> to the host at <insert_4> is not supported by the target host.
Response
Check that the connection name parameter is specified correctly and that the levels of the products in use are compatible.
AMQ9552E
Security flow not received.
Severity
30 : Error
Explanation
During communications through channel <insert_3> the local security exit requested security data from the remote machine. The security data has not been received so the channel has been closed.
Response
Tell the systems administrator who should ensure that the security exit on the remote machine is defined correctly.
AMQ9553E
The function is not supported.
Severity
30 : Error
Explanation
The <insert_3> function <insert_4> attempted is not currently supported on this platform.
Response
None.
AMQ9554E
User not authorized.
Severity
30 : Error
Explanation
You are not authorized to perform the channel operation.
Response
Tell the systems administrator who should ensure that the correct access permissions are available to you, and then retry the operation.
AMQ9555E
File format error.
Severity
30 : Error
Explanation
The file <insert_3> does not have the expected format.
Response
Ensure that the file name is specified correctly.
AMQ9556E
Channel synchronization file missing or damaged.
Severity
30 : Error
Explanation
The channel synchronization file <insert_3> is missing or does not correspond to the stored channel information for queue manager <insert_4>.
Response
Rebuild the synchronization file using the rcrmqobj command rcrmqobj -t syncfile (-m q-mgr-name)
AMQ9556E (IBM i)
Channel synchronization file missing or damaged.
Severity
30 : Error
Explanation
The channel synchronization file <insert_3> is missing or does not correspond to the stored channel information for queue manager <insert_4>.
Response
Rebuild the synchronization file using the RCRMQMOBJ command.
AMQ9557E
Queue Manager User ID initialization failed for <insert_3>.
Severity
30 : Error
Explanation
The call to initialize the User ID <insert_3> failed with CompCode <insert_1> and Reason <insert_2>. If an MQCSP block was used, the User ID in the MQCSP block was <insert_4>. If a userID flow was used, the User ID in the UID header was <insert_5> and any CHLAUTH rules applied prior to user adoption were evaluated case-sensitively against this value.
Response
Correct the error and try again.
AMQ9558E
The remote channel <insert_3> on host <insert_4> is not currently available.
Severity
30 : Error
Explanation
The channel program ended because an instance of channel <insert_3> could not be started on the remote system. This could be for one of the following reasons:
The channel is disabled.
The remote system does not have sufficient resources to run another instance of the channel.
In the case of a client-connection channel, the limit on the number of instances configured for the remote server-connection channel was reached.
Response
Check the remote system to ensure that the channel is able to run. Try the operation again.
AMQ9560I
Rebuild Synchronization File - program started
Severity
0 : Informational
Explanation
Rebuilding the Synchronization file for Queue Manager <insert_3> .
Response
None.
AMQ9561I
Rebuild Synchronization File - program completed normally
Severity
0 : Informational
Explanation
Rebuild Synchronization File program completed normally.
Response
None.
AMQ9562E
Synchronization file in use.
Severity
30 : Error
Explanation
The Synchronization file <insert_3> is in use and cannot be recreated.
Response
Stop any channel activity and retry the rcrmqobj command.
AMQ9562E (IBM i)
Synchronization file in use.
Severity
30 : Error
Explanation
The Synchronization file <insert_3> is in use and cannot be recreated.
Response
Stop any channel activity and retry the RCRMQMOBJ command.
AMQ9563E
Synchronization file cannot be deleted
Severity
30 : Error
Explanation
The filesystem returned error code <insert_1> for file <insert_3>.
Response
Tell the systems administrator who should ensure that file <insert_3> is available and not in use.
AMQ9564E
Synchronization File cannot be created
Severity
30 : Error
Explanation
The filesystem returned error code <insert_1> for file <insert_3>.
The queue manager <insert_4> does not have a defined dead-letter queue. A message cannot be transferred across channel <insert_5>. The reason code is <insert_1>. The destination queue is <insert_3>.
Response
Either correct the problem that caused the channel to try and write a message to the dead-letter queue or create a dead-letter queue for the queue manager.
The value of the MQSERVER environment variable was <insert_3>. The variable should be in the format 'ChannelName/Protocol/ConnectionName'.
Response
Correct the MQSERVER value and retry the operation.
AMQ9567E
Unable to convert the user identifier <insert_3> into bytes, using the queue manager requested CCSID <insert_2>.
Severity
30 : Error
Explanation
Unable to send the user identifier <insert_3> to the queue manager, as it cannot be encoded within the queue manager's CCSID character encoding scheme.
Response
Check that the queue manager CCSID supports the characters used within the user identifier, and consider changing the queue manager's CCSID if appropriate.
AMQ9568E
Unable to convert the user password into bytes, using the queue manager character encoding scheme of CCSID <insert_2>.
Severity
30 : Error
Explanation
Unable to send the user password to the queue manager, as it cannot be encoded into the queue manager's character encoding scheme of CCSID <insert_2>.
Response
Check that the queue manager CCSID supports the characters used within the user password, and consider changing the queue manager's CCSID if appropriate.
AMQ9572E
Message header is not valid.
Severity
30 : Error
Explanation
Channel <insert_3> is stopping because a message header is not valid. During the processing of the channel, a message was found that has a header that is not valid. The dead-letter queue has been defined as a transmission queue, so a loop would be created if the message had been put there.
Response
Correct the problem that caused the message to have a header that is not valid.
AMQ9573E
Maximum number of active channels reached.
Severity
30 : Error
Explanation
There are too many channels active to start another. The current defined maximum number of active channels is <insert_1>.
Response
Either wait for some of the operating channels to close or use the stop channel command to close some channels. Retry the operation when some channels are available. The maximum number of active channels is a configurable parameter in the queue manager configuration file.
AMQ9574E
Channel <insert_3> can now be started.
Severity
30 : Error
Explanation
Channel <insert_3> has been waiting to start, but there were no channels available because the maximum number of active channels was running. One, or more, of the active channels has now closed so this channel can start.
AMQ9575E
Negotiation failed for channel
Severity
30 : Error
Explanation
A channel between the local queue manager and the remote end could not be established due to a negotiation failure. The failure was such that the channel name could not be determined.
Response
Examine the remote queue manager error logs for messages explaining the cause of the negotiation failure.
AMQ9576E
DCE Security: an exit could not allocate memory.
Severity
30 : Error
Explanation
A DCE exit was unsuccessful in obtaining the memory it needed. The failure occurred in exit function <insert_4>. Channel <insert_3> is closed.
Response
Make more memory available to the IBM MQ system and restart the relevant channel.
Channel <insert_3> has not been opened because the DCE security exit which initiates the security context was not passed a valid partner name. When the DCE security exit is called to initiate the security context it is essential that the PartnerName field in the MQCXP structure contains a valid partner name. On this call it did not. This can arise as a result of a usage error, for instance only specifying the security exit on one end of the channel. The error was reported from security exit function savePartnerName.
Response
Check your usage of the DCE security exit for errors, such as only specifying the exit in one of the matching channel definitions. Correct any errors found and retry.
AMQ9578E
DCE Security: bad return from DCE call.
Severity
30 : Error
Explanation
Channel <insert_3> has been closed because one of the DCE channel exits received a bad return code from DCE.
Response
Consult the appropriate DCE manuals to find out the meaning of major_status <insert_1> and minor_status <insert_2> on call <insert_5>. Then rectify the error. The exit function name is <insert_4>.
AMQ9579E
DCE Security: partner name does not match target.
Severity
30 : Error
Explanation
The DCE Security exit was requested to perform a trusted channel check: target partner name <insert_4> was specified in the SCYDATA field of channel <insert_3>. The actual partner name associated with channel <insert_3> was <insert_5>, so the security exit suppressed the channel.
Response
Examine the channel definition of channel <insert_3> and alter it so that the relevant name on the partner system matches that specified in the SCYDATA field.
AMQ9580E
DCE Security: invalid message received.
Severity
30 : Error
Explanation
An IBM-supplied DCE exit on channel <insert_3> received a message that was not generated by a matching exit, or was not the expected type of message. The header.mechanism field had value <insert_1>. The header.msgtype field had value <insert_2>. The name of the exit function in which the error was discovered is <insert_4>.
Response
Make sure that the exits at both ends of the channel generate compatible flows.
AMQ9581E
DCE Security: wrong exit called.
Severity
30 : Error
Explanation
Exit <insert_4> on channel <insert_3> was called for use as a IBM MQ exit of the wrong type. DCE_SEC_SCY_CHANNELEXIT functions as a security exit; DCE_SEC_SRM_CHANNELEXIT functions as a send, receive or message exit. The ExitId parameter passed to the exit was <insert_1>.
Response
Alter the exit definitions to ensure that exit <insert_4> is called correctly.
AMQ9582E
DCE Security: invalid exit function requested.
Severity
30 : Error
Explanation
Exit <insert_4> on channel <insert_3> was called with an invalid ExitReason (value <insert_1>).
The DCE_SEC_SRM_CHANNELEXIT exit was called on channel <insert_3>; the value of pContext->mechanism (<insert_1>) passed was not valid.
Response
This is probably because the DCE_SEC_SRM_CHANNELEXIT exit has been called without first calling the DCE_SEC_SCY_CHANNELEXIT security exit. Alter the system so that either both or neither are run.
AMQ9584E
DCE Security: message too short.
Severity
30 : Error
Explanation
The DCE_SEC_SRM_CHANNELEXIT receive or message exit was called on channel <insert_3> to process an incoming message. The pDataLength parameter supplied to the exit indicated that the message received was too short to be a valid message for the relevant exit. The *pDataLength value was <insert_1>.
Response
Configure the system so that compatible send/receive/message exits are run at both ends of the channel.
AMQ9585E
Maximum number of channel initiators reached.
Severity
30 : Error
Explanation
The maximum number of channels initiators that can be in use simultaneously has been reached. The number of permitted channel initiators is a configurable parameter in the queue manager configuration file.
Response
Wait for one or more channel initiators to close and retry the operation or modify the configuration file to allow more initiators and restart the Queue Manager.
AMQ9586E
Program cannot create queue manager object.
Severity
30 : Error
Explanation
The attempt to create object <insert_4> on queue manager <insert_5> failed with reason code <insert_1>.
Usage: endmqlsr [-w] [-m QMgrName]
-m Queue manager name.
-w Wait for listeners to end.
Severity
10 : Warning
Explanation
This shows the correct usage.
Response
Correct the parameters passed to the endmqlsr program and retry the operation.
AMQ9596E
Queue Manager <insert_3> still running
Severity
30 : Error
Explanation
The requested operation can not complete because queue manager <insert_3> is still running.
Response
End the queue manager and retry the operation.
AMQ9597I
No IBM MQ listeners for queue manager <insert_3>.
Severity
0 : Informational
Explanation
No listener processes were found in the system for queue manager <insert_3>.
Response
None.
AMQ9598I
<insert_1> IBM MQ listeners will end shortly.
Severity
0 : Informational
Explanation
<insert_1> listeners detected in the system are scheduled for shutdown.
Response
None.
AMQ9599E
Program could not open a queue manager object.
Severity
30 : Error
Explanation
The attempt to open either the queue or queue manager object <insert_4> on queue manager <insert_5> by user <insert_3> failed with reason code <insert_1>.
Response
Ensure that the queue is available and retry the operation. If the message is from a remote queue manager, check the message channel agent user identifier has the correct authority.
AMQ9601E
Program could not inquire on queues on this queue manager.
Severity
30 : Error
Explanation
The IBM MQ clustering repository program was attempting to find out about the queues on queue manager <insert_3>. One of the calls failed with reason code <insert_1>. The repository command was backed out and the repository process went into a timed wait.
Response
Correct the error. When the repository process restarts it processes the backed out command again and continues.
AMQ9602E
Maximum number of channel processes reached.
Severity
30 : Error
Explanation
The channel can not start because the number of channel processes has already reached the maximum allowable value. The maximum number of channels processes is configured as <insert_1>. This value is a configurable parameter in the queue manager configuration file.
Response
Wait for some of the operating channels to close. Retry the operation when some channels are available.
AMQ9603E
Error accessing the process pool shared segment.
Severity
30 : Error
Explanation
The program could not access the process pool shared segment
Response
A value of <insert_1> was returned from the subsystem when an attempt was made to access the Channel process pool shared memory. Contact the systems administrator, who should examine the log files to determine why the program was unable to access the process pool shared segment.
AMQ9604E
Channel <insert_3> terminated unexpectedly
Severity
30 : Error
Explanation
The process or thread executing channel <insert_3> is no longer running. The check process system call returned <insert_1> for process <insert_2>.
Response
No immediate action is required because the channel entry has been removed from the list of running channels. Inform the system administrator who should examine the operating system procedures to determine why the channel process has terminated.
AMQ9605I
<insert_1> IBM MQ listeners have been ended.
Severity
0 : Informational
Explanation
<insert_1> listeners detected in the system have been ended.
One listener detected in the system has been ended.
Response
None.
AMQ9608E
Remote resources in recovery.
Severity
30 : Error
Explanation
Channel <insert_3> could not establish a successful connection with the remote queue manager because resources are being recovered.
Response
Restart the channel at a later time. If the problem persists then examine the error logs of the remote queue manager to see the full explanation of the cause of the problem.
AMQ9610I
AMQ<insert_1> messages suppressed
Severity
0 : Informational
Explanation
<insert_2> messages of type AMQ<insert_1> were suppressed
Response
Message suppression is controlled by MQ_CHANNEL_SUPPRESS_MSGS and MQ_CHANNEL_SUPPRESS_INTERVAL environment variables.
AMQ9611I
Rebuild Client Channel Table - program completed normally
Severity
0 : Informational
Explanation
Rebuild Client Channel Table program completed normally.
Response
None.
AMQ9612I
<insert_1> IBM MQ listeners could not be ended.
Severity
0 : Informational
Explanation
The request to the end the IBM MQ listeners for specified queue manager was completed however <insert_1> listeners could not be stopped. Reasons why listener may not be stopped are:
The listener process contains channels which are still active.
Response
Active channels may be stopped using the 'STOP CHANNEL' command or by ending the queue manager, and reissuing the request to end the listener.
AMQ9614I (HP NSS)
Certificate is not signed by a trusted Certificate Authority.
Severity
0 : Informational
Explanation
The attempt to start channel <insert_3> failed because the certificate used in the SSL handshake is not signed by a Certificate Authority (CA) listed in the certificate trust list for this queue manager. This error can occur when;
(a) The trust.pem store being used contains an incomplete set of certificates to validate the peer certificate.
(b) One or more certificates in the the peer certificate chain have failed verification.
Response
Check that all of the required signer certificates are present in the trust.pem, adding any missing certificates. Use the openssl verify command line utility to verify the certificate chains being used are suitable.
AMQ9614I (IBM i)
Certificate is not signed by a trusted Certificate Authority.
Severity
0 : Informational
Explanation
The attempt to start channel <insert_3> failed because the certificate used in the SSL handshake is not signed by a Certificate Authority (CA) listed in the certificate trust list for this queue manager. This error can occur when;
(a) The SSL key repository does not contain a copy of the Certificate Authority certificate.
(b) The SSL key repository for the queue manager is specified as '*SYSTEM' and the application definition in Digital Certificate Manager has been modified to specify a CA trust list, excluding this CA.
(c) The remote end of the channel is configured to send a certificate for which the CA certificate is not in the local key repository.
Response
Use Digital Certificate Manager to ensure the appropriate Certification Authority certificates are present, and if applicable, add the required Certificate Authority (CA) certificates to the queue managers CA trust list.
Check that the remote certificate label configuration is correct.
AMQ9615I (IBM i)
Queue manager or Client user profile is not registered with DCM.
Severity
0 : Informational
Explanation
The attempt to start channel <insert_3> failed because the queue manager or client user profile is not registered as a SSL server application with Digital Certificate Manager (DCM). This error occurs when the SSL key repository for the queue manager or for IBM MQ client product is specified as '*SYSTEM' but IBM MQ cannot register the queue manager or client user profile as an SSL server application with DCM. Alternatively this error could occur when the application definition for the queue manager has been manually removed from DCM.
Response
For IBM MQ Base product attempt to re-register the queue manager with Digital Certificate Manager by issuing CHGMQM SSLKEYR(*SYSTEM). For IBM MQ client product attempt to set MQSSLKEYR environment to *SYSTEM. If this is unsuccessful you may need to manually add the application definition through Digital Certificate Manager. See the IBM MQ information center for more details.
AMQ9616E
The CipherSpec <insert_4> proposed by remote host <insert_5> is not enabled.
Severity
30 : Error
Explanation
The SSL or TLS subsystem at the server end of a channel been configured in such a way that it has rejected the CipherSpec proposed by an SSL or TLS client.
This error most commonly occurs when the choice of acceptable CipherSpecs has been limited in one of the following ways:
(a) The server queue manager SSLFipsRequired attribute is set to YES and the channel is using a CipherSpec which is not FIPS-certified on the server.
(b) The server queue manager EncryptionPolicySuiteB attribute has been set to a value other than NONE and the channel is using a CipherSpec which does not meet the server's configured Suite B security level.
(c) The protocol used by the channel has been deprecated. Note that IBM may need to deprecate a protocol via product maintenance in response to a security vulnerability, for example SSLv3 and TLSv1 have been deprecated. Continued use of SSLv3 and/or TLSv1 protocols is not recommended but may be enabled by setting environment variable AMQ_SSL_V3_ENABLE=TRUE or AMQ_TLS_V1_ENABLE=TRUE as required.
(d) The requested CipherSpec has been deprecated or disallowed by TLS 1.3. Note that IBM may need to deprecate a CipherSpec via product maintenance in response to a security vulnerability, for example RC4_MD5_US has been deprecated. Continued use of deprecated CipherSpecs is not recommended but may be enabled by setting environment variable AMQ_SSL_WEAK_CIPHER_ENABLE=<CipherSpec>. For example, AMQ_SSL_WEAK_CIPHER_ENABLE=RC4_MD5_US
(e) The certificates in use are not acceptable in combination with the CipherSpec, for example the key signature algorithm (RSA or ECDSA) may not be supported by the negotiated CipherSpec, or the certificate's key size might be too short (some CipherSpecs mandate a minimum 2048-bit RSA key length).
(f) The CipherSpec is for TLS 1.3 and TLS 1.3 is not enabled. To enable TLS 1.3 set the INI variable AllowTLSV13=TRUE in the SSL stanza.
Response
Analyse why the proposed CipherSpec was not enabled on the server. Alter the client CipherSpec, or reconfigure the server to accept the proposed CipherSpec. Restart the channel.
AMQ9617E
Parameter requesting FIPS has an invalid value.
Severity
30 : Error
Explanation
An SSL channel running on an MQ client has failed to start. This is because the value specified for the MQSSLFIPS environment variable, or in the MQSCO FipsRequired field, is invalid. The value specified was "<insert_3>".
Response
Set the MQSSLFIPS environment variable, or the MQSCO FipsRequired field, to a valid value. Restart the channel.
AMQ9618E
SSLCRLNL attribute points to a namelist with no names.
Severity
30 : Error
Explanation
An SSL channel has failed to start because the SSLCRLNL queue manager attribute points to a namelist with an empty list of names.
Response
If OCSP or CRL checking is required, set up the namelist referenced by SSLCRLNL with a non-empty list of authentication information object names. If no OCSP or CRL checking is required, clear the SSLCRLNL queue manager attribute. Restart the failing channel.
AMQ9620E
Internal error on call to SSL function on channel <insert_3> to host <insert_5>.
Severity
30 : Error
Explanation
An error indicating a software problem was returned from a function which is used to provide SSL or TLS support. The error code returned was <insert_1>. The function call was <insert_4>.
The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
The remote host name is <insert_5>.
An unexpected SSL error was returned from function <insert_4> for channel <insert_3>. The error code returned was <insert_1>. GSKit error codes are documented in the MQ manuals and also in the GSKSSL member of the H file in library QSYSINC.
Error on call to SSL function ignored on channel <insert_3> to host <insert_5>.
Severity
10 : Warning
Explanation
An error indicating a software problem was returned from a function which is used to provide SSL support. The error code returned was <insert_1>. The function call was <insert_4>.
The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'.
The remote host is <insert_5>.
This error is not regarded as sufficiently serious to interrupt channel operation; channel operation was not affected.
Response
None.
AMQ9622E
AUTHINFO object <insert_3> does not exist.
Severity
30 : Error
Explanation
A channel or channel process has failed to start because the namelist of AUTHINFO objects includes the name <insert_3>, but no AUTHINFO object of that name exists.
Response
Ensure all the names in the namelist specified on the SSLCRLNL queue manager attribute correspond to AUTHINFO objects which are to be used on the SSL channels. Restart the failing channel or channel process.
AMQ9623E
Error inquiring on AUTHINFO object <insert_3>.
Severity
30 : Error
Explanation
A channel or channel process has failed to start because reason code <insert_1> was returned when an inquire was performed on AUTHINFO object <insert_3>.
Response
Look at the MQRC_ values in the IBM MQ Application Programming Reference to determine the meaning of reason code <insert_1>, correct the error, and restart the failing channel or channel process.
AMQ9624E
AUTHINFO object <insert_3> is not of type CRLLDAP or OCSP.
Severity
30 : Error
Explanation
A channel or channel process has failed to start because one of the AUTHINFO objects specified in the SSLCRLNL namelist does not have a valid AUTHTYPE. Instead the type value is <insert_1>.
Response
Include only AUTHINFO objects with AUTHTYPE CRLLDAP or AUTHTYPE OCSP in the namelist specified on the SSLCRLNL queue manager attribute. Restart the channel or channel process.
AMQ9625E
AUTHINFO object <insert_3> was specified with an invalid CONNAME.
Severity
30 : Error
Explanation
A channel or channel process has failed to start because one of the AUTHINFO objects specified in the SSLCRLNL namelist has an invalid CONNAME parameter. The invalid value is <insert_4>.
Response
Correct the invalid parameter. Restart the channel or channel process.
AMQ9626E
Channel hanging while initializing SSL.
Severity
30 : Error
Explanation
The current channel cannot start because another channel is hanging while initializing the SSL subsystem.
Response
Investigate the reason for the hang on the other channel. Once this is rectified, restart this channel.
AMQ9627E
The path and stem name for the SSL key repository have not been specified.
Severity
30 : Error
Explanation
The directory path and file stem name for the SSL key repository have not been specified. On a MQ client system there is no default location for this file. SSL connectivity is therefore impossible as this file cannot be accessed.
Response
Use the MQSSLKEYR environment variable or MQCONNX API call to specify the directory path and file stem name for the SSL key repository.
AMQ9628E
An LDAP server containing CRLs was specified with an invalid CONNAME.
Severity
30 : Error
Explanation
The IBM MQ client has failed to connect because an invalid CONNAME was found for one of the LDAP servers containing CRLs. The invalid value is <insert_3>.
Response
Correct the invalid parameter. If the LDAP details were defined on a queue manager system, regenerate the client definitions. Reconnect.
AMQ9629E
Bad SSL cryptographic hardware parameters.
Severity
30 : Error
Explanation
The following string was supplied to specify or control use of SSL cryptographic hardware: <insert_4>. This string does not conform to any of the MQ SSL cryptographic parameter formats. The channel is <insert_3>. The channel did not start.
Response
Correct your SSL cryptographic hardware parameters and restart the channel.
AMQ9631E
The CipherSpec negotiated during the SSL handshake does not match the required CipherSpec for channel <insert_3>.
Severity
30 : Error
Explanation
There is a mismatch between the CipherSpecs on the local and remote ends of channel <insert_3>. The channel will not run until this mismatch is resolved. The CipherSpec required in the local channel definition is <insert_4>. The name of the CipherSpec negotiated during the SSL handshake is <insert_5>. A code is displayed if the name of the negotiated CipherSpec cannot be determined.
Response
Change the channel definitions for <insert_3> so the two ends have matching CipherSpecs and restart the channel. When using the 'ANY' type CipherSpecs ensure that the Client CipherSpec value would meet the requirements for the <insert_4> CipherSpec set on the channel <insert_3>. If the client is set to use the 'ANY' type CipherSpecs then the TLS handshake may use a higher protocol than is allowed by the <insert_3> channel definition CipherSpec. If the certificate in use by one end of the channel is a Global Server Certificate, then the negotiated CipherSpec may not match that specified on either end of the channel. This is because the SSL protocol allows a Global Server Certificate to automatically negotiate a higher level of encryption. In these cases specify a CipherSpec which meets the requirements of the Global Server Certificate.
AMQ9631E (IBM i)
The CipherSpecs at the ends of channel <insert_3> do not match.
Severity
30 : Error
Explanation
There is a mismatch between the CipherSpecs on the local and remote ends of channel <insert_3>. The channel will not run until this mismatch is resolved. The local CipherSpec is <insert_4> and the remote CipherSpec is <insert_5>.
Response
Change the channel definition for <insert_3> so that both ends have matching CipherSpecs and restart the channel.
AMQ9633E
Bad SSL certificate for channel <insert_3>.
Severity
30 : Error
Explanation
A certificate encountered during SSL handshaking is regarded as bad for one of the following reasons:
(a) it was formatted incorrectly and could not be validated
(b) it was formatted correctly but failed validation against the Certification Authority (CA) root and other certificates held on the local system
(c) it was found in a Certification Revocation List (CRL) on an LDAP server
(d) a CRL was specified but the CRL could not be found on the LDAP server
(e) an OCSP responder has indicated that it is revoked
The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The remote host is <insert_5>. The channel did not start.
The details of the certificate which could not be validated are <insert_4>.
The certificate validation error was <insert_2>.
Response
Check which of the possible causes applies on the system. Correct the error, and restart the channel.
This error might indicate that the remote end of the channel is configured to send the wrong certificate. Check the certificate label configuration at the remote end of the channel and ensure that the local key repository contains all of the necessary CA certificates.
AMQ9633E (IBM i)
Bad SSL certificate for channel <insert_3>.
Severity
30 : Error
Explanation
A certificate encountered during SSL handshaking is regarded as bad for one of the following reasons:
(a) it was formatted incorrectly and could not be validated
(b) it was formatted correctly but failed validation against the Certification Authority (CA) root and other certificates held on the local system
(c) it was found in a Certification Revocation List (CRL) on an LDAP server
(d) a CRL was specified but the CRL could not be found on the LDAP server
(e) an OCSP responder has indicated that it is revoked
The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The remote host is <insert_5>. The channel did not start.
Response
Check which of the possible causes applies on the system. Correct the error, and restart the channel.
AMQ9635E
Channel <insert_3> did not specify a valid CipherSpec.
Severity
30 : Error
Explanation
Channel <insert_3> specifies a value of <insert_4> for CipherSpec which is not valid to start a secure connection.
Response
Check product documentation to confirm that the CipherSpec specified in the channel definition is valid. Note that IBM may need to deprecate the use of CipherSpecs via product maintenance in response to a security vulnerability.
A blank CipherSpec value specifies that the channel was expected to use a plaintext connection but the remote channel defintion expects to use a secure connection.
If the default list of enabled CipherSpecs has been provided by setting the AMQ_ALLOWED_CIPHERS environment variable, or provided by setting the 'AllowedCipherSpecs' attribute under the SSL stanza in the qm.ini file, the channel CipherSpec must be on this list.
All CipherSpecs that use NULL, SHA-1, MD5, DES, Triple DES, RC2 and RC4 algorithms have been deprecated. All other CipherSpecs that use the SSLv3 or TLSv1 protocol have been deprecated. Continued use of any of these CipherSpecs is not recommended but may be temporarily enabled by setting the AMQ_SSL_WEAK_CIPHER_ENABLE environment variable, or via the 'AllowWeakCipherSpec' attribute under the SSL stanza in the qm.ini file.
If the desired CipherSpec is a TLS 1.3 CipherSpec then we must enable TLS 1.3. To enable TLS 1.3 set the INI variable AllowTLSV13=TRUE in the SSL stanza of the mqclient.ini and qm.ini files.
Change channel <insert_3> to specify a valid CipherSpec.
AMQ9636E
SSL distinguished name does not match peer name, channel <insert_3>.
Severity
30 : Error
Explanation
The distinguished name, <insert_4>, contained in the SSL certificate for the remote end of the channel does not match the local SSL peer name for channel <insert_3>. The distinguished name at the remote host <insert_5> must match the peer name specified (which can be generic) before the channel can be started.
Response
If this remote system should be allowed to connect, either change the SSL peer name specification for the local channel so that it matches the distinguished name in the SSL certificate for the remote end of the channel, or obtain the correct certificate for the remote end of the channel.
This error might indicate that the remote end of the channel is configured to use the wrong certificate. Check the certificate label for the remote end of the channel.
Restart the channel.
AMQ9637E
During handshake, the remote partner sent no certificate.
Severity
30 : Error
Explanation
The conversation cannot begin because a certificate has not been supplied by the remote partner.
The channel name is <insert_3>.
The remote host is <insert_5>.
If this error message is written on the receiving side of the channel, then the channel attributes <insert_4> caused the check to be made.
Response
Look at the key repository on the remote side of this channel, and make sure the appropriate certificates are present, with correct labels.
AMQ9638E
SSL communications error for channel <insert_3>.
Severity
30 : Error
Explanation
An unexpected SSL communications error occurred for a channel, as reported in the preceding messages. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Investigate the problem reported in the preceding messages. Review the local and remote console logs for reports of network errors. Correct the errors and restart the channel.
AMQ9639E
Remote channel <insert_3> did not specify a CipherSpec.
Severity
30 : Error
Explanation
Remote channel <insert_3> did not specify a CipherSpec when the local channel expected one to be specified.
The remote host is <insert_4>.
The channel did not start.
Response
Change the remote channel <insert_3> on host <insert_4> to specify a CipherSpec so that both ends of the channel have matching CipherSpecs.
The SSL peer name for channel <insert_3> includes a distinguished name attribute key <insert_5> which is invalid or unsupported. The channel did not start.
Response
Correct the SSL peer name for the channel. Restart the channel.
AMQ9641E
Remote CipherSpec error for channel <insert_3> to host <insert_4>.
Severity
30 : Error
Explanation
The remote end of channel <insert_3> on host <insert_4> has indicated a CipherSpec error <insert_5>. The channel did not start.
Response
Check that the CipherSpec values specified on the <insert_3> channel definition on both the local and remote system match. If necessary, review the queue manager error logs on the remote system to discover more information about the CipherSpec error. When using the the 'ANY' type CipherSpecs, check that the Client CipherSpec value would meet the requirements of the <insert_3> channel definition CipherSpec requirements. If the client is set to use the 'ANY' type CipherSpecs then the TLS handshake may use a higher protocol than is allowed by the <insert_3> channel definition CipherSpec.
AMQ9642E
No SSL or TLS certificate for channel <insert_3>.
Severity
30 : Error
Explanation
The channel <insert_3> did not supply a certificate to use during SSL or TLS handshaking, but a certificate is required by the remote queue manager.
The remote host is <insert_4>.
The channel did not start.
Response
Ensure that the key repository of the local queue manager or MQ client contains a certificate which is associated with the queue manager or client. If we have configured a certificate label, check that the certificate exists.
Alternatively, if appropriate, change the remote channel definition so that its SSLCAUTH attribute is set to OPTIONAL and it has no SSLPEER value set.
AMQ9642I (IBM i)
No SSL certificate for channel <insert_3>.
Severity
0 : Informational
Explanation
The channel <insert_3> did not supply a certificate to use during SSL handshaking, but a certificate is required by the remote queue manager. The channel did not start.
Response
If the SSL key repository for the queue manager has been specified as '*SYSTEM' ensure that a certificate has been associated with the application description for the queue manager in Digital Certificate Manager. Alternatively, if appropriate, change the remote channel definition so that its SSLCAUTH attribute is set to OPTIONAL and it has no SSLPEER value set.
AMQ9643E
Remote SSL peer name error for channel <insert_3> on host <insert_4>.
Severity
30 : Error
Explanation
The remote end of channel <insert_3> on host <insert_4> has had an SSL peer name error. The channel did not start.
Response
Review the error logs on the remote system to discover the problem with the peer name.
AMQ9645E
Certificate label <insert_4> not found for channel <insert_3>.
Severity
30 : Error
Explanation
The local key database repository does not contain a certificate with label <insert_4>. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
In some cases this message will appear multiple times, once for each affected channel.
Response
Add a correctly labelled certificate to the local key database. Alternatively, change the certificate label configuration so that the channel uses a valid certificate.
Restart the channel.
AMQ9646E
Channel <insert_3> could not connect to any LDAP CRL servers.
Severity
30 : Error
Explanation
LDAP Certification Revocation List (CRL) servers were specified but a connection could not be established to any of them. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Check that the LDAP CRL server specifications are correct. If they are, check that the servers are running and that the networking to access them is working correctly. Fix any errors found and restart the channel.
AMQ9647E
I/O error on SSL key repository.
Severity
30 : Error
Explanation
An I/O error was encountered when attempting to read the SSL key repository. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Analyse why there is a I/O problem when reading the key repository. Fix the error if one is found, or it may be a temporary problem. Restart the channel.
AMQ9648E
The SSL key repository has an invalid internal format.
Severity
30 : Error
Explanation
The SSL key repository has an invalid internal format. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Recreate the SSL key repository and restart the channel.
AMQ9649E
The SSL key repository contains duplicate keys.
Severity
30 : Error
Explanation
The SSL key repository contains two or more entries with the same key. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Use your key management tool to remove the duplicate keys. Restart the channel.
AMQ9650E
The SSL key repository contains entries with duplicate labels.
Severity
30 : Error
Explanation
The SSL key repository contains two or more entries with the same label. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Use your key management tool to remove the duplicate entries. Restart the channel.
AMQ9651E
The SSL key repository is corrupt or has a bad password.
Severity
30 : Error
Explanation
The SSL key repository has become corrupted or its password id is incorrect. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Use your key management tool to recreate the key repository with a new password. Restart the channel.
AMQ9652E
The remote SSL certificate has expired.
Severity
30 : Error
Explanation
The SSL certificate used by MQ on the remote end of the channel has expired. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Use your key management tool to provide MQ with a current SSL certificate on the remote end of the channel. Restart the channel.
AMQ9653W
An SSL trace file could not be opened.
Severity
10 : Warning
Explanation
An SSL trace file could not be opened. The SSL trace files are created in directory <insert_4> and have names AMQ.SSL.TRC and AMQ.SSL.TRC.1. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. This error is not regarded as sufficiently serious to interrupt channel operation; channel operation was not affected.
Response
Check that we have a directory called <insert_4> and that the userid under which IBM MQ runs has permissions and space to create and open a file in that directory. Fix the problem and we will get SSL trace output.
AMQ9654E
Validation checks for the remote personal certificate failed. The channel did not start.
Severity
30 : Error
Explanation
An SSL certificate received from the remote system was not corrupt but failed validation checks on something other than its ASN.1 fields and date. It is possible that the certificate chain could not be built for for one of the following reasons: - The certificate Subject DN is more than 1024 characters long. - The DN contains unsupported duplicate attribute values. - The DN is missing.
The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'.
Response
Ensure that the remote system has a valid personal certificate and restart the channel.
AMQ9655E
Problem loading GSKit SSL support.
Severity
30 : Error
Explanation
MQ SSL support is provided on this platform using a component called GSKit which is installed as part of MQ. GSKit had an internal problem loading one if its dynamic link libraries. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Uninstall MQ and reinstall. Restart the channel.
AMQ9655E (HP NSS)
Problem loading OpenSSL support.
Severity
30 : Error
Explanation
MQ SSL support is provided on this platform using a component called OpenSSL which is installed as part of MQ. OpenSSL had an internal problem loading one if its dynamic link libraries. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Uninstall MQ and reinstall. Restart the channel.
AMQ9656E
An invalid SSL certificate was received from the remote system.
Severity
30 : Error
Explanation
An SSL certificate received from the remote system was not corrupt but failed validation checks on its ASN fields. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Ensure that the remote system has a valid SSL certificate. Restart the channel.
AMQ9657E
The key repository could not be opened (channel <insert_3>).
Severity
30 : Error
Explanation
The key repository could not be opened. The key repository either does not exist or has incorrect permissions associated with it. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Ensure that the key repository you specify exists and that its permissions are such that the MQ process involved can read from it. Restart the channel.
AMQ9658E
Certificate is not within validity period.
Severity
30 : Error
Explanation
A certificate has been encountered which failed checks on its validity period. The certificate has either expired, or is not yet valid for use. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Ensure that both the local and remote systems have valid, current certificates and that the system clock is accurate. Ensure that changes to certificate stores are effective by refreshing the security cache by issuing REFRESH SECURITY TYPE(SSL) and attempt to restart the channel.
AMQ9659E
A failure occurred during SSL handshaking.
Severity
30 : Error
Explanation
During SSL handshaking, or associated activities, a failure occurred. The failure is <insert_4> and has caused IBM MQ channel name <insert_3> to be closed. If the name is '????' then the name is unknown.
Response
Refer to prior message in the IBM MQ error log for information related to this problem.
AMQ9660E
SSL key repository: password stash file absent or unusable.
Severity
30 : Error
Explanation
The SSL key repository cannot be used because MQ cannot obtain a password to access it. Reasons giving rise to this error include:
(a) the key database file and password stash file are not present in the location configured for the key repository,
(b) the key database file exists in the correct place but that no password stash file has been created for it,
(c) the files are present in the correct place but the userid under which MQ is running does not have permission to read them,
(d) one or both of the files are corrupt.
The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Ensure that the key repository variable is set to where the key database file is. Ensure that a password stash file has been associated with the key database file in the same directory, and that the userid under which MQ is running has read access to both files. If both are already present and readable in the correct place, delete and recreate them. Restart the channel.
AMQ9661E
Bad SSL data from peer on channel <insert_3>.
Severity
30 : Error
Explanation
An SSL channel has stopped because bad SSL data was received from the remote end of the channel. More detail on the nature of the corruption can be found from the GSKit return value of <insert_1> (the GSKit return values are documented in the MQ manuals). The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'.
Response
Ensure we are connecting to a version of MQ which supports SSL at the remote end of the channel. Check your network between the two ends of the channel, and consider whether any possible causes of message corruption could be present. Fix any problems which may exist and restart the channel.
AMQ9661E (HP NSS)
Bad SSL data from peer on channel <insert_3>.
Severity
30 : Error
Explanation
An SSL channel has stopped because bad SSL data was received from the remote end of the channel. More detail on the nature of the corruption can be found from the OpenSSL return value of <insert_1> (the OpenSSL return values are documented in the MQ manuals). The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'.
Response
Ensure we are connecting to a version of MQ which supports SSL at the remote end of the channel. Check your network between the two ends of the channel, and consider whether any possible causes of message corruption could be present. Fix any problems which may exist and restart the channel.
AMQ9661I (IBM i)
Bad SSL data from peer on channel <insert_3>.
Severity
0 : Informational
Explanation
An SSL channel has stopped because bad SSL data was received from the remote end of the channel. More detail on the nature of the corruption can be found from the GSKit return value of <insert_1> (the GSKit return values are documented in the MQ manuals and also in the GSKSSL member of the H file in library QSYSINC). The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'.
Response
Ensure the remote queue manager and channel listener are running and that we are connecting to a version of MQ which supports SSL at the remote end of the channel. Check your network between the two ends of the channel, and consider whether any possible causes of message corruption could be present. Fix any problems which may exist and restart the channel.
AMQ9662E
SSL has encountered something it does not support.
Severity
30 : Error
Explanation
This error can arise for a number of reasons: 1) The platform does not support a given type of cryptographic hardware, e.g. nCipher nFast and Rainbow Cryptoswift are no longer supported. 2) The cryptographic hardware cryptography has returned an error. 3) Unsupported X509 General Name format when checking the remote certificate. The GSKit SSL provider incorporated in MQ only supports formats rfc822, DNSName, directoryname, uniformResourceID, and IPAddress. 4) System wide settings or environment variables have restricted support for a protocol or cipher, e.g. IBM i system values QSSLPCL and QSSLCSL. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Check that your cryptographic hardware is supported on the platform and test it to see that it is working correctly. Check that the remote certificates we are using conform to the X509 General Name formats listed. Fix the problem and restart the channel.
AMQ9662E (HP NSS)
SSL has encountered something it does not support.
Severity
30 : Error
Explanation
This error can arise for a number of reasons: 1) The platform does not support a given type of cryptographic hardware, e.g. nCipher nFast and Rainbow Cryptoswift are no longer supported. 2) The cryptographic hardware cryptography has returned an error. 3) Unsupported X509 General Name format when checking the remote certificate. The OpenSSL SSL provider incorporated in MQ only supports formats rfc822, DNSName, directoryname, uniformResourceID, and IPAddress. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Check that your cryptographic hardware is supported on the platform and test it to see that it is working correctly. Check that the remote certificates we are using conform to the X509 General Name formats listed. Fix the problem and restart the channel.
AMQ9663E
An invalid SSL certificate was received from the remote system.
Severity
30 : Error
Explanation
An SSL certificate received from the remote system failed validation checks on its signature. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Ensure that the remote system has a valid SSL certificate. Restart the channel.
AMQ9664E
Bad userid for CRL LDAP server; SSL channel <insert_3>.
Severity
30 : Error
Explanation
Certification Revocation List (CRL) checking on an LDAP server or servers has been configured on the local MQ system. The userid information configured for the LDAP server or servers is incorrect. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Check the userid information for the CRL LDAP server or servers you have configured locally. Correct any problems found and restart the channel.
AMQ9665E
SSL connection closed by remote end of channel <insert_3>.
Severity
30 : Error
Explanation
The SSL or TLS connection was closed by the remote host <insert_5> during the secure socket handshake. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Check the remote end of the channel for SSL and TLS errors. Fix them and restart the channel.
CRL checking on LDAP servers has been configured on the local MQ system. An error was found when trying to access the CRL LDAP servers when validating a certificate from the remote system. Possible causes are:
(a) cannot connect to any of the LDAP servers, or
(b) the certificate issuer's Distinguished Name (DN) is not defined in the DIT of an LDAP server.
The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Check access to the CRL LDAP server(s) you have configured locally. Put right any problems found and restart the channel.
AMQ9667E
Bad user name or password for CRL LDAP server; SSL channel <insert_3>.
Severity
30 : Error
Explanation
Certification Revocation List (CRL) checking on an LDAP server or servers has been configured on the local MQ system. The user name or password information configured for the LDAP server or servers is incorrect. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Check the user name and password information for the CRL LDAP server or servers you have configured locally. Correct any problems found and restart the channel.
AMQ9668E
The specified PKCS #11 shared library could not be loaded.
Severity
30 : Error
Explanation
A failed attempt was made to load the PKCS #11 shared library specified to MQ in the PKCS #11 driver path field of the GSK_PKCS11 SSL CryptoHardware parameter. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Ensure that the PKCS #11 shared library exists and is valid at the location specified. Restart the channel.
AMQ9669E
The PKCS #11 token could not be found.
Severity
30 : Error
Explanation
The PKCS #11 driver failed to find the token specified to MQ in the PKCS #11 token label field of the GSK_PKCS11 SSL CryptoHardware parameter. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Ensure that the PKCS #11 token exists with the label specified. Restart the channel.
AMQ9670E
PKCS #11 card not present.
Severity
30 : Error
Explanation
A PKCS #11 card is not present in the slot. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Ensure that the correct PKCS #11 card is present in the slot. Restart the channel.
AMQ9671E
The PKCS #11 token password specified is invalid.
Severity
30 : Error
Explanation
The password to access the PKCS #11 token is invalid. This is specified to MQ in the PKCS #11 token password field of the GSK_PKCS11 SSL CryptoHardware parameter. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Ensure that the PKCS #11 token password specified on GSK_PKCS11 allows access to the PKCS #11 token specified on GSK_PKCS11. Restart the channel.
AMQ9672E (IBM i)
A certificate label is not permitted when using the system key repository.
Severity
30 : Error
Explanation
The SSL or TLS channel <insert_3> was started using certificate label <insert_4> and the queue manager is using the IBM i system key repository. Configuring certificate labels in IBM MQ is not supported when using the IBM i system key repository.
The channel did not start.
Response
Assign a certificate using the IBM i Digital Certificate Manager instead. Alternatively, use a non-system key repository.
AMQ9673E
The channel <insert_3> did not send the correct certificate to the remote peer.
Severity
30 : Error
Explanation
The SSL or TLS channel <insert_3> is configured to use certificate label <insert_4>. However, the remote peer did not send the necessary information to allow the local channel to use the correct certificate. The remote host is <insert_5>.
This error occurs when the local channel definition has a certificate label and the remote peer does not support selection of certificates.
The channel did not start.
Response
Ensure that the remote peer supports certificate label configuration. Refer to the Security section of the IBM MQ Information Center for details of certificate label requirements. Alternatively, alter the local channel definition so that it does not specify a certificate label.
AMQ9674E
The channel <insert_3> specified a CipherSpec that is not permitted to be used.
Severity
30 : Error
Explanation
The SSL or TLS channel <insert_3> is configured to use CipherSpec <insert_4> which is not enabled.
This error occurs when the channel has requested to use a CipherSpec that is currently not enabled. CipherSpecs that utilize cryptographic algorithms or protocols that are considered to be weak or broken are disabled when using default configuration settings.
The channel did not start.
Response
Ensure that the channel is configured to use a CipherSpec that is permitted. If either the AMQ_ALLOWED_CIPHERS environment variable is defined, or the 'AllowedCipherSpecs' attribute is set under the SSL stanza in the qm.ini file, the channel must use one of the CipherSpecs from the list.
Alternatively, configure the queue manager to re-enable the weaker CipherSpec <insert_4> using the AMQ_SSL_WEAK_CIPHER_ENABLE environment variable, or via the 'AllowWeakCipherSpec' attribute under the SSL stanza in the qm.ini file.
If the desired CipherSpec is a TLS 1.3 CipherSpec then we must enable TLS 1.3. To enable TLS 1.3 set the INI variable AllowTLSV13=TRUE in the SSL stanza of the mqclient.ini and qm.ini files.
AMQ9694E
Program cannot connect because connection limit reached.
Severity
30 : Error
Explanation
The connection attempt to queue manager <insert_4> failed with reason code <insert_1> because the queue manager has been restricted to support a limited number of connections.
Response
Increase the connection limits for the queue manager, or reduce the number of concurrent connections to the queue manager.
AMQ9695E
JSON file format error for <insert_3>.
Severity
30 : Error
Explanation
Parsing of JSON file <insert_3> failed. The file was expected to contain an attribute named <insert_4> but this was not found or was defined with an unexpected type. The parser returned an error of <insert_5> which may be useful in determining any invalid formatting.
Response
Check that the contents of the file use the correct JSON schema.
AMQ9696E
JSON attribute <insert_4> has an invalid value or an unexpected type.
Severity
30 : Error
Explanation
Parsing of JSON file <insert_3> failed as attribute <insert_4> has an invalid value of <insert_5> or the value is not the correct type.
Response
Check that the contents of the file follows the appropriate JSON schema and that attribute values are correctly specified. Ensure string values use double quotes and ensure numeric and boolean values are unquoted.
AMQ9697E
CipherSpec list value <insert_3> could not be parsed.
Severity
30 : Error
Explanation
The SSL stanza ini attribute <insert_4>, or environment variable <insert_5> contained a CipherSpec list value that could not be recognised.
This error occurs when a list of one or more CipherSpecs has been provided to MQ to enable, but the value could not be recognised.
Response
Ensure that the ini file attribute, or environment variable are configured to use a valid list of CipherSpecs. Refer to the Knowledge Center for a list of CipherSpec values that are supported on this platform.
Correct the configuration of the ini attribute or environment variable and retry.
The values 'Yes' and 'No' for the 'AllowWeakCipherSpec' ini attribute, which had previously been permitted in IBM WebSphere MQ 7.5 are deprecated in this version of IBM MQ and are now considered invalid. If enablement of one or more weak CipherSpecs is required, consider changing the value of the 'AllowWeakCipherSpec' ini attribute from 'Yes' to specify a comma seperated list of the additional CipherSpecs. If weak CipherSpecs are no longer required, consider removing the 'AllowWeakCipherSpec' ini attribute.
AMQ9698E
Conflicting CipherSpec control to <insert_3> detected in configuration.
Severity
30 : Error
Explanation
The ini file attribute or environment variable <insert_3> conflicts with other ini attributes or environment variables that control CipherSpecs.
This error occurs when conflicting CipherSpec settings are detected. CipherSpec settings must not be duplicated and must not conflict.
We can provide a restrictive list of CipherSpecs by specifying ini file attribute 'AllowedCipherSpecs' in the SSL stanza, or the AMQ_ALLOWED_CIPHERS environment variable. Alternatively, we can provide a list of additional weak CipherSpecs to re-enable by specifiying ini file attribute 'AllowWeakCipherSpec' in the SSL stanza, or the AMQ_SSL_WEAK_CIPHER_ENABLE environment variable.
This error occurs when configuration of both restrictive and weak CipherSpec lists are detected.
Response
Refer to the Knowledge Center for detailed guidance on how to restrict, or allow, CipherSpecs values.
Correct the configuration of the ini attributes or environment variables and retry.
Updates to the JSON CCDT file <insert_3> are currently not supported.
Response
Make any required updates to the JSON CCDT using an appropriate editor.
AMQ9703W
Message sequence number mismatch detected for channel <insert_3>.
Severity
10 : Warning
Explanation
The local and remote queue managers do not agree on the next message sequence number. A message with sequence number <insert_1> has been sent when sequence number <insert_2> was expected. The remote host is <insert_4>. The channel will ignore the mismatch in sequence numbers and attempt to continue.
Response
Determine the cause of the inconsistency. It could be that a channel has been deleted and redefined, an MCA has previously ended abnormally whilst confirming a message batch, or the channel is being intentionally redirected to an equivalent queue manager (i.e. disaster recovery).
AMQ9704W
Channel exit suppressed for <insert_3>.
Severity
10 : Warning
Explanation
The autodefined CLUSSDR channel definition for <insert_3> contained one or more exits which have been suppressed. The channel will ignore the configured exits and attempt to continue startup.
Response
If the CLUSSDR channel fails to start and requires exits, remove the 'SuppressClusQmgrChlExits' tuning parameter from the 'Channels:' stanza of qm.ini.
AMQ9704W (IBM MQ Appliance)
Channel exit suppressed for <insert_3>.
Severity
10 : Warning
Explanation
The channel definition for <insert_3> contained one or more exits which have been suppressed as the appliance does not support this feature. The channel will ignore all configured exits and attempt to continue startup.
Response
None.
AMQ9705E
Remote user exit failed to load.
Severity
30 : Error
Explanation
Channel program <insert_3> ended because a user exit specified on the remote host <insert_4> could not be loaded.
Response
Check the error logs on the remote host and ensure that the user exit is specified correctly in the channel definition.
AMQ9707E
Unsupported <insert_3> version <insert_4>.
Severity
30 : Error
Explanation
IBM MQ SSL and TLS channel support is provided using a component called <insert_3>. IBM MQ has detected that <insert_3> version <insert_4> is loaded in the current process. However, the minimum <insert_3> version required by IBM MQ is <insert_5>.
The channel did not start because the <insert_3> version does not meet the minimum version requirements.
Response
Check which versions of <insert_3> are being used by IBM MQ and any other products in this process and ensure that all products are using version <insert_5> or later.
AMQ9708E
A problem with the client keystore or stash file was encountered.
Severity
30 : Error
Explanation
The SSL or TLS connection failed with MQRC_KEY_REPOSITORY_ERROR.
Response
Check the value of the MQSSLKEYR environment variable and ensure the client application has appropriate access to the keystore and stash file.
AMQ9709E
SSL/TLS initialization error.
Severity
30 : Error
Explanation
The SSL or TLS client connection failed with MQRC_SSL_INITIALIZATION_ERROR.
Response
Check the target queue manager error logs for SSL and TLS errors, correct and retry.
AMQ9710E
SSL security refresh failed.
Severity
30 : Error
Explanation
The request to refresh SSL security was unsuccessful.
Response
Look at previous error messages in the error files to determine the cause of the failure.
AMQ9711E
SSL security refresh succeeded but channel restarts failed.
Severity
30 : Error
Explanation
The SSL environments for this queue manager have been refreshed so current values and certificates are in use for all SSL channels. However, not all the outbound SSL channels which were running when the security refresh was initiated could be restarted after the refresh had completed.
Response
Look at previous error messages in the error files to determine which channels could not be restarted. Restart these if necessary.
AMQ9712E
SSL security refresh timed out waiting for channel <insert_3>.
Severity
30 : Error
Explanation
The system was performing a security refresh for SSL. This function requests all outbound and inbound SSL channels to stop. It then waits for these channels to actually stop. SSL channel <insert_3> did not stop within the timeout period.
Response
Investigate why channel <insert_3> is hung. Terminate the hung channel. Rerun the SSL security refresh.
AMQ9713I
Channel <insert_3> ended: SSL refresh in progress.
Severity
0 : Informational
Explanation
The SSL support on this queue manager is in the middle of a security refresh. An attempt was made to start outbound SSL channel <insert_3>. It cannot start while the SSL security refresh is in progress. The channel is restarted automatically once the SSL security refresh is complete.
Response
None.
AMQ9714E
SSL refresh on receiving queue manager: channel did not start.
Severity
30 : Error
Explanation
An SSL security refresh is in progress on the queue manager at the receiving end of this SSL channel. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Restart the channel once the SSL refresh is complete. The channel will restart automatically if it is configured to retry the connection.
AMQ9715E
Unexpected error detected in validating SSL session ID.
Severity
30 : Error
Explanation
This error can arise when the GSKit SSL provider is missing one or more pre-requisite PTFs on the OS/400 platform. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'.
Response
Ensure the GSKit SSL provider is at the latest level of maintenance and restart the channel.
AMQ9715E (HP NSS)
Unexpected error detected in validating SSL session ID.
Severity
30 : Error
Explanation
The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'.
Response
Ensure the SSL provider is at the latest level of maintenance and restart the channel.
AMQ9716E
Remote SSL certificate revocation status check failed for channel <insert_5>.
Severity
30 : Error
Explanation
IBM MQ failed to determine the revocation status of the remote SSL certificate for one of the following reasons:
(a) The channel was unable to contact any of the CRL servers or OCSP responders for the certificate.
(b) None of the OCSP responders contacted knows the revocation status of the certificate.
(c) An OCSP response was received, but the digital signature of the response could not be verified.
The details of the certificate in question are <insert_3>.
The channel name is <insert_5>. In some cases the channel name cannot be determined and so is shown as '????'. The channel did not start.
IBM MQ does not allow the channel to start unless the certificate revocation status can be determined.
Response
If the certificate contains an AuthorityInfoAccess extension, ensure that the OCSP server named in the certificate extension is available and is correctly configured.
If the certificate contains a CrlDistributionPoint extension, ensure that the CRL server named in the certificate extension is available and is correctly configured.
If we have specified any CRL or OCSP servers to IBM MQ, check that those servers are available and are correctly configured.
Ensure that the local key repository has the necessary SSL certificates to verify the digital signature of the response from the OCSP server.
AMQ9717W
Remote SSL certificate revocation status is unknown for channel <insert_5>.
Severity
10 : Warning
Explanation
IBM MQ was unable to determine the revocation status of the remote SSL certificate for one of the following reasons:
(a) The channel was unable to contact any of the CRL servers or OCSP responders for the certificate.
(b) None of the OCSP responders contacted knows the revocation status of the certificate.
(c) An OCSP response was received, but the digital signature of the response could not be verified.
The details of the certificate in question are <insert_3>.
The channel name is <insert_5>. In some cases the channel name cannot be determined and so is shown as '????'.
The channel was allowed to start, but the revocation status of the remote SSL certificate has not been checked.
Response
If the certificate contains an AuthorityInfoAccess extension, ensure that the OCSP server named in the certificate extension is available and is correctly configured.
If the certificate contains a CrlDistributionPoint extension, ensure that the CRL server named in the certificate extension is available and is correctly configured.
If we have specified any CRL or OCSP servers to IBM MQ, check that those servers are available and are correctly configured.
Ensure that the local key repository has the necessary SSL certificates to verify the digital signature of the response from the OCSP server.
If you require certificate revocation checks to be enforced, we should configure IBM MQ to require certificate revocation checking. Refer to the security section of the IBM MQ Information Center for more information on configuring certificate revocation checking.
AMQ9718E
Invalid OCSP URL <insert_3>.
Severity
30 : Error
Explanation
IBM MQ was unable to start an SSL channel because one of the AUTHINFO objects specified in the SSLCRLNL namelist has an invalid OCSPURL parameter.
The OCSP URL is <insert_3> and the channel name is <insert_4>. In some cases the channel name cannot be determined and so is shown as '????'.
Response
The OCSP URL cannot be blank and must be a valid HTTP URL. Correct the OCSP URL and restart the channel or channel process.
Refer to the security section of the IBM MQ Information Center for details of how to use OCSP URLs.
AMQ9719E
Invalid CipherSpec for FIPS mode.
Severity
30 : Error
Explanation
The user is attempting to start a channel on a queue manager or MQ client which has been configured to run in FIPS mode. The user has specified a CipherSpec which is not FIPS-compliant. The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'.
Response
Redefine the channel to run with a FIPS-compliant CipherSpec. Alternatively, the channel may be defined with the correct CipherSpec and the queue manager or MQ client should not be running in FIPS mode; if this is the case, ensure that FIPS mode is not configured. Once the error is corrected, restart the channel.
AMQ9720W
Not all OCSP responder URLs loaded from CCDT.
Severity
10 : Warning
Explanation
MQ supports a maximum of <insert_1> OCSP responder URLs, but <insert_2> OCSP responder URLs were present in the CCDT. Only the first <insert_1> OSCP responder URLs will be used.
Response
Try to limit the number of OCSP responder URLs entries in the CCDT by restricting the NAMELIST, referenced by the queue manager SSLCRLNL parameter, such that its NAMES parameter references no more than <insert_1> AUTHINFO records with AUTHTYPE of OCSP.
AMQ9721E
Failed to open file <insert_3>.
Severity
30 : Error
Explanation
The filesystem returned error code <insert_1> with explanation <insert_4> for file <insert_3>.
Response
Record the name of the file and tell the systems administrator, who should ensure that file is correct and available, for example that the current user has appropriate access to the file for reading or writing.
AMQ9741E
A problem occurred during a Windows operation.
Severity
30 : Error
Explanation
During operation <insert_3>, the Windows return code <insert_1> was generated.
Response
Consult the Windows reference manual to determine the meaning of return code <insert_1> for operation <insert_3>.
AMQ9767I
Usage: strmqikm [iKeymanWorkingDirectory]
Severity
0 : Informational
Response
None.
AMQ9768E
Directory <insert_3> not found.
Severity
30 : Error
Explanation
The directory specified as a command argument has not been found.
Response
Check that the directory exists and that it is specified as an absolute (rather than relative) directory path.
AMQ9769I
Usage: runmqckm
Object Action Description
------ ------ -----------
-keydb -changepw Change the password for a key database
-convert Convert the format of a key database
-create Create a key database
-delete Delete a key database
-expiry Display password expiry
-list Currently supported types of key database.
-stashpw Stash the password of a key database into a file
-cert -add Add a CA Certificate
-create Create a self-signed certificate
-delete Delete a certificate
-details Show the details of a specific certificate
-export Export a personal certificate and associated private key
into a PKCS12 file or a key database
-extract Extract a certificate from a key database
-getdefault Show the default personal certificate
-import Import a certificate from a key database or a PKCS12 file
-list List certificates in a key database
-listsigners List signer certificates delivered with iKeycmd
-modify Modify a certificate (NOTE: the only field that may be
modified is the trust field)
-populate Populate with included CA Certificates
-receive Receive a certificate
-rename Rename a certificate
-setdefault Set the default personal certificate
-sign Sign a certificate
-certreq -create Create a certificate request
-delete Delete a certificate request from a certificate request
database
-details Show the details of a specific certificate request
-extract Extract a certificate from a certificate request database
-list List all certificate requests in a certificate request
database
-recreate Recreate a certificate request
-seckey -create Create a secret key
-delete Delete a secret key
-details Show the details of a specific secret key
-export Export secret keys to a file
-import Import secret keys from a file
-list List all secret keys in a key database
-rename Rename a secret key
-version Display iKeycmd version information
-help Display this help text
Severity
0 : Informational
Response
None.
AMQ9770E
The SSL key repository password has expired.
Severity
30 : Error
Explanation
The SSL key repository cannot be used because the password has expired.
The channel is <insert_3>; in some cases its name cannot be determined and so is shown as '????'. The channel did not start.
Response
Use your key management tool to reset the password of the SSL key repository, ensuring that a new password stash file is generated.
AMQ9771E
SSL handshake failed.
Severity
30 : Error
Explanation
The SSL handshake with host <insert_3> failed. The SSL handshake was performed using the Java Secure Socket Extension (JSSE).
Response
The SSLSocketFactory used was <insert_5>, where 'default' indicates that the JVM's default SSLSocketFactory was used.
The exception thrown by the <insert_4> call was <insert_1>. Review the exception message for a description of the failure.
Also examine the error logs at the remote end of the channel. These may contain additional information on why the SSL handshake failed.
AMQ9772E
<insert_3> failed with MQRC=<insert_1>.
Severity
30 : Error
Explanation
The indicated IBM MQ API call failed for the specified reason code.
Response
Refer to the Application Programming Reference manual for information about Reason Code <insert_1>.
AMQ9773I
Usage: runmqakm
Object Action Description
------ ------ -----------
-locale Set the display language
-fips Set FIPS mode
-trace Set the trace file name
-keydb -changepw Change the password for a key database
-convert Convert the format of a key database
-create Create a key database
-delete Delete a key database
-expiry Display password expiry
-list Currently supported types of key database.
-stashpw Stash the password of a key database into a file
-cert -add Add a CA Certificate
-create Create a self-signed certificate
-delete Delete a certificate
-details Show the details of a specific certificate
-export Export a personal certificate and associated private key
into a PKCS12 file or a key database
-extract Extract a certificate from a key database
-getdefault Show the default personal certificate
-import Import a certificate from a key database or a PKCS12 file
-list List certificates in a key database
-modify Modify a certificate (NOTE: the only field that may be
modified is the trust field)
-receive Receive a certificate
-rename Rename a certificate
-setdefault Set the default personal certificate
-sign Sign a certificate
-validate Validate a certificate
-certreq -create Create a certificate request
-delete Delete a certificate request from a certificate request
database
-details Show the details of a specific certificate request
-extract Extract a certificate from a certificate request database
-list List all certificate requests in a certificate request
database
-recreate Recreate a certificate request
-random -create Create a random password
-version Display program version information
-help Display this help text
Severity
0 : Informational
Response
None.
AMQ9774E
Error accessing the Channel authentication table
Severity
30 : Error
Explanation
The program could not access the channel authentication table.
Response
A value of <insert_1> was returned from the subsystem when an attempt was made to access the channel authentication table. Contact the systems administrator, who should examine the log files to determine why the program was unable to access the authentication table.
AMQ9775E
Channel would have been blocked by userid
Severity
30 : Error
Explanation
The inbound channel <insert_3> would have been blocked from address <insert_4> because the active values of the channel were mapped to a userid which should be blocked. Access is allowed as the channel authentication rule is in warning mode. The active values of the channel were <insert_5>.
Response
Contact the systems administrator, who should examine the channel authentication records to ensure that the correct settings have been configured. If the channel authentication record was not in warning mode the channel would be blocked. The ALTER QMGR CHLAUTH switch is used to control whether channel authentication records are used. The command DISPLAY CHLAUTH can be used to query the channel authentication records.
AMQ9776E
Channel was blocked by userid
Severity
30 : Error
Explanation
The inbound channel <insert_3> was blocked from address <insert_4> because the active values of the channel were mapped to a userid which should be blocked. The active values of the channel were <insert_5>.
The inbound channel <insert_3> was blocked from address <insert_4> because the active values of the channel matched a record configured with USERSRC(NOACCESS). The active values of the channel were <insert_5>.
The address <insert_3> is invalid and the processing of the command has stopped.
Response
Reissue the command with the address parameter specified correctly. Note that the BLOCKADDR list may contain only IP addresses: host name addresses are not permitted.
See the Commands section of the IBM MQ Information Center for more information about the specification of the address parameter.
AMQ9779E
IP address range error.
Severity
30 : Error
Explanation
The IP address <insert_3> contains an invalid range. For example the first number is higher or equal to the second number in the range.
Response
The processing of the command is terminated. Reissue the command with the IP address parameter specified correctly. Refer to the commands section of the IBM MQ Information Center for more information on the specification of the IP address parameter.
AMQ9780E
Channel to remote machine <insert_4> is ending due to an error.
Severity
30 : Error
Explanation
Channel <insert_3> between this machine and the remote machine <insert_4> encountered an error and will now end. In some cases the channel name can not be determined and so is shown as '????'.
This message will be accompanied by other messages which explain the cause of the error.
Response
Tell the systems administrator, who should attempt to identify the cause of the channel failure using problem determination techniques. For example, look for FFST files, and examine the error logs on the local and remote systems where there may be messages explaining the cause of failure. More information may be obtained by repeating the operation with tracing enabled.
AMQ9781E
IP address overlaps with previous definition.
Severity
30 : Error
Explanation
The IP address <insert_3> overlaps an existing IP address <insert_4>. For example the addresses 1.2.3.4-7 and 1.2.3.6-8 overlap each other.
Response
The processing of the command is terminated. Reissue the command with an IP address parameter that does not overlap a previous definition or remove the existing record and then reissue the command. Refer to the commands section of the IBM MQ Information Center for more information on the specification of the IP address parameter.
AMQ9782E
Remote connection blocked.
Severity
30 : Error
Explanation
A connection from IP address <insert_3> was blocked because it matched the blocking address rule <insert_4>.
Response
Verify that the channel authentication blocking rules are correct. If necessary modify the rules to allow the inbound connection using the SET CHLAUTH command. The ALTER QMGR CHLAUTH switch is used to control whether channel authentication records are used. Refer to the commands section of the IBM MQ Information Center for more information on the specification of the IP address parameter.
AMQ9783I
Channel will run using MCAUSER(<insert_3>).
Severity
0 : Informational
Explanation
No matching channel authentication (CHLAUTH) records were found that match the given fields. Note:
1) The returned MCAUSER value does not take into account possible actions by a channel security exit.
2) Channel authentication rules that match the host name apply only if the queue manager REVDNS attribute is enabled and the DNS server returns a valid host name for the IP address.
Response
None.
AMQ9784E
Match runcheck found a generic value in <insert_3>.
Severity
30 : Error
Explanation
Match runcheck found a generic value in <insert_3>. When using MATCH(RUNCHECK) all input fields must not contain generic values.
Response
Reissue the command with all fields containing fully specified values.
A message cannot be transferred across channel <insert_5> from address <insert_4> and the channel is configured to not use the dead-letter queue. The reason code is <insert_1> and the destination queue is <insert_3>.
Response
Either correct the problem that caused the channel to try and write a message to the dead-letter queue or enable the channel to use the dead-letter queue.
AMQ9786E
Remote connection would have been blocked.
Severity
30 : Error
Explanation
A connection from IP address <insert_3> would have been blocked because it matched the blocking address rule <insert_4>. Access is allowed as the channel authentication rule is in warning mode.
Response
Verify that the channel authentication blocking rules are correct. If necessary modify the rules to allow the inbound connection using the SET CHLAUTH command. If the channel authentication record was not in warning mode the connection would be blocked. The ALTER QMGR CHLAUTH switch is used to control whether channel authentication records are used. Refer to the commands section of the IBM MQ Information Center for more information on the specification of the IP address parameter.
AMQ9787E
Channel would have been blocked
Severity
30 : Error
Explanation
The inbound channel <insert_3> would have been blocked from address <insert_4> because the active values of the channel matched a record configured with USERSRC(NOACCESS). Access is allowed as the channel authentication rule is in warning mode. The active values of the channel were <insert_5>.
Response
Contact the systems administrator, who should examine the channel authentication records to ensure that the correct settings have been configured. If the channel authentication record was not in warning mode the channel would be blocked. The ALTER QMGR CHLAUTH switch is used to control whether channel authentication records are used. The command DISPLAY CHLAUTH can be used to query the channel authentication records.
AMQ9788W
Slow DNS lookup for address <insert_3>.
Severity
10 : Warning
Explanation
An attempt to resolve address <insert_3> using the <insert_4> function call took <insert_1> seconds to complete. This might indicate a problem with the DNS configuration.
Response
Ensure that DNS is correctly configured on the local system.
If the address was an IP address then the slow operation was a reverse DNS lookup. Some DNS configurations are not capable of reverse DNS lookups and some IP addresses have no valid reverse DNS entries. If the problem persists, consider disabling reverse DNS lookups until the issue with the DNS can be resolved.
AMQ9789I
The failed authentication check was caused by a CHLAUTH record with CHCKCLNT(REQDADM).
Severity
0 : Informational
Explanation
The user ID <insert_3> and its password were checked because the user ID is privileged and the inbound connection matched a channel authentication record with CHCKCLNT(REQDADM).
The active values of the channel were <insert_5>. The MATCH(RUNCHECK) mode of the DISPLAY CHLAUTH MQSC command can be used to identify the relevant CHLAUTH record.
This message accompanies a previous error to clarify the reason for the user ID and password check.
Response
Refer to the previous error for more information.
Ensure that a password is specified by the client application and that the password is correct for the user ID. The authentication configuration of the queue manager connection determines the user ID repository. For example, the local operating system user database or an LDAP server.
To avoid the authentication check, we can either use an unprivileged user ID or change the authentication configuration of the queue manager to CHCKCLNT(NONE). We can amend the CHCKCLNT attribute in the CHLAUTH record.
AMQ9790I
The failed authentication check was caused by a CHLAUTH record with CHCKCLNT(<insert_4>).
Severity
0 : Informational
Explanation
The user ID <insert_3> and its password were checked because the inbound connection matched a channel authentication record with CHCKCLNT(<insert_4>).
The active values of the channel were <insert_5>. The MATCH(RUNCHECK) mode of the DISPLAY CHLAUTH MQSC command can be used to identify the relevant CHLAUTH record.
This message accompanies a previous error to clarify the reason for the user ID and password check.
Response
Refer to the previous error for more information.
Ensure that a password is specified by the client application and that the password is correct for the User ID. The queue manager's connection authentication configuration determines the User ID repository, for example the local operating system user database or an LDAP server.
Alternatively, to avoid the authentication check we can amend the CHLAUTH record CHCKCLNT attribute. However, allowing unauthenticated remote access is not recommended.
AMQ9791E
The client application did not supply a user ID and password.
Severity
30 : Error
Explanation
The client application <insert_3> running on host <insert_4> did not supply a user ID and password. The channel authentication (CHLAUTH) record for the connection requires a user ID and password, but none was supplied.
The active values of the channel were <insert_5>. The MATCH(RUNCHECK) mode of the DISPLAY CHLAUTH MQSC command can be used to identify the relevant CHLAUTH record.
Response
Ensure that the application provides a valid user ID and password, or change the queue manager connection authority (CONNAUTH) configuration to OPTIONAL to allow client applications to connect which have not supplied a user ID and password.
AMQ9792E
The client application did not supply a password for its privileged user ID.
Severity
30 : Error
Explanation
The client application <insert_3> running on host <insert_4> is using a privileged user ID but did not supply a password. The channel authentication (CHLAUTH) record for the connection has CHCKCLNT(REQDADM), so a password is required for the user ID.
The active values of the channel were <insert_5>. The MATCH(RUNCHECK) mode of the DISPLAY CHLAUTH MQSC command can be used to identify the relevant CHLAUTH record.
Response
Take one of the following actions:
a) Ensure that the application provides both the user ID and password.
b) Ensure that the application uses an unprivileged user ID.
c) Change the queue manager connection authority (CONNAUTH) configuration to OPTIONAL to allow client applications to connect which have not supplied both a user ID and password.
AMQ9793E
The client application user ID and password cannot be checked by the queue manager.
Severity
30 : Error
Explanation
The user ID and password for the client application <insert_3> running on host <insert_4> cannot be checked. The channel authentication (CHLAUTH) record for the connection requires an authentication check, but the queue manager is not configured to use connection authentication for clients.
The active values of the channel were <insert_5>. The MATCH(RUNCHECK) mode of the DISPLAY CHLAUTH MQSC command can be used to identify the relevant CHLAUTH record.
Response
Change the CHLAUTH configuration so that client authentication is not required, or alter the queue manager connection authority (CONNAUTH) configuration to enable client authentication checks.
AMQ9795E
The client channel definition could not be retrieved from its URL, error code (<insert_1>).
Severity
30 : Error
Explanation
The client channel definition location was specified as URL <insert_3>, however the file could not be retrieved from this location.
The error returned was (<insert_1>) <insert_4>. The protocol specific response code was (<insert_2>).
Response
Ensure that the URL is reachable and if necessary correct the details provided.
AMQ9796W
Slow URL retrieval for <insert_3>.
Severity
10 : Warning
Explanation
An attempt to retrieve <insert_3> took <insert_1> seconds to complete. For http and ftp protcols this could indicate a configuration problem with the network, or an abnormally high load on the servers.
Response
If the URL specifies a network protocol such as http or ftp, check that there are no connectivity issues in reaching the servers.
The queue manager requested the client to reconnect to another queue manager <insert_3> but the operation failed because either the queue manager is unknown, unavailable, or has an incompatible configuration. The reason code for the problem is: <insert_2>. Additional information, relating to the reason code: <insert_5> The client will attempt to reconnect back to the original queue manager.
Response
Look at the description for the reason code to understand the problem and perform any reconfiguration that is necessary to correct the problem (for example an update of the CCDT file to the latest version). Refer to the Administration section of the Knowledge Center for more information.
AMQ9816E (HP NSS)
Invalid process name <insert_3> provided for TMF/Gateway
Severity
20 : Error
Explanation
IBM MQ client for HP Integrity NonStop Server is unable to enlist with the TMF/Gateway for queue manager <insert_4> due to an invalid process name provided in the MQTMF_GATEWAY_NAME environment variable.
Response
Ensure the TMF/Gateway is running and the MQTMF_GATEWAY_NAME environment variable is correctly set to the Guardian process name of the TMF/Gateway.
AMQ9817E (HP NSS)
No PATHMON process name provided to allow enlisting with TMF/Gateway
Severity
20 : Error
Explanation
IBM MQ client for HP Integrity NonStop Server has detected the presence of a TMF transaction and is attempting to enlist with the TMF/Gateway to allow correct participation of the queue manager in the transaction. IBM MQ client for HP Integrity NonStop Server has been unable to find a process name for the PATHMON process hosting the TMF/Gateway server class for queue manager <insert_3> in an mqclient.ini file.
Response
Ensure an mqclient.ini file is available for use by the IBM MQ client for HP Integrity NonStop Server containing a TMF stanza providing the Guardian process name of a PATHMON that is hosting a TMF/Gateway server class for queue manager <insert_3>. The mqclient.ini file also requires a TMFGateway stanza providing the server class name to be used for queue manager <insert_3>. Refer to the IBM MQ information center for further information on using an mqclient.ini file with the IBM MQ client for HP Integrity NonStop Server.
AMQ9818E (HP NSS)
No server class provided to allow enlisting with TMF/Gateway for queue manager <insert_3>
Severity
20 : Error
Explanation
IBM MQ client for HP Integrity NonStop Server has detected the presence of a TMF transaction and is attempting to enlist with the TMF/Gateway to allow correct participation of the queue manager in the transaction. IBM MQ client for HP Integrity NonStop Server has been unable to find a server class name in an mqclient.ini file for queue manager <insert_3> hosted by PATHMON process <insert_4>.
Response
Ensure an mqclient.ini file is available for use by the IBM MQ client for HP Integrity NonStop Server which contains a TMFGateway stanza providing the server class name to be used for queue manager <insert_3>. Refer to the IBM MQ information center for further information on using an mqclient.ini file with the IBM MQ client for HP Integrity NonStop Server.
AMQ9819E (HP NSS)
Error encountered while enlisting with TMF/Gateway for queue manager <insert_5>
Severity
20 : Error
Explanation
IBM MQ client for HP Integrity NonStop Server has detected the presence of a TMF transaction and is attempting to enlist with the TMF/Gateway server class <insert_4> hosted by PATHMON process <insert_3> to allow correct participation of the queue manager in the transaction. IBM MQ client for HP Integrity NonStop Server has encountered an error while establishing contact with the TMF/Gateway. Pathsend error (<insert_1>), file system error (<insert_2>).
Response
These errors are typically the result of configuration problems with the PATHMON process <insert_3> or the server class <insert_4>. Refer to the HP NonStop TS/MP Pathsend and Server Programming Manual for the appropriate corrective action based on the pathsend error (<insert_1>) and file system error (<insert_2>).
AMQ9820E (HP NSS)
Participation in TMF transactions is not supported by queue manager <insert_3>
Severity
20 : Error
Explanation
IBM MQ client for HP Integrity NonStop Server has detected the presence of a TMF transaction but IBM MQ for z/OS queue manager <insert_3> does not support participation in TMF transactions.
Response
The version of z/OS queue manager that we are connecting to does not support the TMF Gateway, please upgrade to a supported release.
The configuration error might be one of the following:
1. The mqclient.ini TMF stanza contains an invalid process name.
2. The PATHMON process <insert_3> is not currently running.
AMQ9822E (HP NSS)
Unable to locate server class <insert_4>
Severity
20 : Error
Explanation
IBM MQ client for HP Integrity NonStop Server is unable to locate server class <insert_4> hosted by PATHMON process <insert_3>.
Response
The configuration error may be one of the following:
1. The mqclient.ini TMFGateway stanza contains an invalid server class name for queue manager <insert_5>.
2. The PATHMON process <insert_3> has not been configured with server class <insert_4>.
3. Server class <insert_4> has not been started or is currently frozen.
AMQ9823E (HP NSS)
Not authorized to use server class <insert_4> hosted by PATHMON process <insert_3>
Severity
20 : Error
Explanation
IBM MQ client for HP Integrity NonStop Server is not authorized to use server class <insert_4> hosted by PATHMON process <insert_3>.
Response
Check with the systems administrator to ensure you have the correct access permissions. When confirmed you have the correct access permissions, retry the operation.
AMQ9824E (HP NSS)
TMF/Gateway server class <insert_4> has not been configured appropriately
Severity
20 : Error
Explanation
The TMF/Gateway server class <insert_4> hosted by PATHMON process <insert_3> has not been configured appropriately.
Response
The configuration error may be one of the following:
1. The server class has not been configured with TMF enabled.
2. The server class has been configured with MAXLINKS set too low for the number of IBM MQ client for HP Integrity NonStop Server applications needing to concurrently enlist with the TMF/Gateway.
3. The server class has been configured with TIMEOUT set too low for the time taken by the TMF/Gateway to process a request. Ideally TIMEOUT should not be set, but if it is then it needs to account for the time taken for the TMF/Gateway's associated remote queue manager to respond.
AMQ9825I
Usage: runmqwkm
Action Description
------ -----------
createcert Creates a self-signed certificate
createcertrequest Creates a a certificate request
addcert Adds a CA certificate
deletecert Deletes a certificate
deletecertrequest Deletes a certificate request
detailcert Shows details of a specific certificate
detailcertrequest Shows details of a specific certificate request
receivecert Receives a certificate
recreatecertrequest Recreates a certificate request
listcert Lists certificates
listcertrequest Lists all certificate requests
keybackup Backs up key repository
keyrestore Restores key repository
Severity
0 : Informational
Response
None.
AMQ9826I
Usage: createcert -m QMgrName -dn DistinguishedName [-label Label]
[-expire Expiry] [-size KeySize]
[-sig_alg SignatureAlgorithm] [-format ascii|binary]
[-ku KeyUsageList] [-eku ExtendedKeyUsageList]
[-san_dnsname sanDNSName] [-san_ipaddr sanIPAddr]
-m The queue manager to create the self-signed certificate for.
-dn The X.500 distinguished name that uniquely identifies the
certificate.
-label The label attached to the certificate.
The default value is IBM MQ_cert_label<QMgrName in lower case>.
-size The size of the new key pair. The default value is 2048 for
all RSA signature algorithms. For elliptic curve signature
algorithms use 256, 384 or 512 to match the selected
algorithm.
-expire The expiration time of the certificate in days. The default
value is 365.
-ku and -eku The lists of valid uses for the certificate.
-sig_alg The signing algorithm that is used to create the signature
that is associated with the new self-signed certificate.
-format The format of output file. The default value is ascii.
-san_dnsname The Subject Alternative Name (SAN) DNS name(s) for the entry
that is created.
-san_ipaddr The Subject Alternative Name (SAN) IP address(es) for the
entry that is created.
Severity
0 : Informational
Response
None.
AMQ9827I
Usage: createcertrequest -m QMgrName -dn DistinguishedName [-label Label]
[-size KeySize] [-sig_alg SignatureAlgorithm]
[-ku KeyUsageList] [-eku ExtendedKeyUsageList]
[-san_dnsname sanDNSName] [-san_ipaddr sanIPAddr]
-m The queue manager to create the certificate request for.
-dn The X.500 distinguished name that uniquely identifies the
certificate.
-label The label attached to the certificate. The default value is
IBM MQ_cert_label<QMgrName in lower case>.
-size The size of the new key pair. The default value is 2048 for
all RSA signature algorithms. The elliptic curve signature
algorithms use 256, 384 or 512 to match the selected
algorithm.
-ku and -eku The lists of valid uses for the certificate.
-sig_alg The signing algorithm that is used to create the signature
that is associated with the new certificate.
-san_dnsname The Subject Alternative Name (SAN) DNS name(s) for the entry
that is created.
-san_ipaddr The Subject Alternative Name (SAN) IP address(es) for the
entry that is created.
Severity
0 : Informational
Response
None.
AMQ9828I
Usage: receivecert -m QMgrName -file FileName [-format ascii|binary]
-m The queue manager to receive the certificate.
-file The file that contains the certificate.
-format The format of the certificate. The default value is ascii.
Severity
0 : Informational
Response
None.
AMQ9829I
Usage: addcert -m QMgrName -label Label -file FileName
[-format ascii|binary]
-m The queue manager to add the certificate for.
-label The label for certificate.
-file The file that contains the certificate.
-format The format of the output file. The default value is ascii.
Severity
0 : Informational
Response
None.
AMQ9830I
Usage: deletecert -m QMgrName -label Label
-m The queue manager to delete the certificate from.
-label The label of the certificate to be deleted.
Severity
0 : Informational
Response
None.
AMQ9831I
Usage: deletecertrequest -m QMgrName -label Label
-m The queue manager to delete the certificate request from.
-label The label of the certificate request to be deleted.
Severity
0 : Informational
Response
None.
AMQ9833I
Usage: recreatecert -m QMgrName [-dn DistinguishedName] [-label Label]
[-expire Expiry] [-size KeySize]
[-sig_alg SignatureAlgorithm] [-format ascii|binary]
[-ku KeyUsageList] [-eku ExtendedKeyUsageList]
[-san_dnsname sanDNSName] [-san_ipaddr sanIPAddr]
-m The queue manager to recreate the self-signed certificate for.
-dn The X.500 distinguished name that uniquely identifies the
certificate.
-label The label of the certificate to be recreated. The default
value is IBM MQ_cert_label<QMgrName in lower case>.
-size The size of the new key pair. The default value is 2048 for
all RSA signature algorithms. The elliptic curve signature
algorithms use 256, 384 or 512 to match the selected
algorithm.
-expire The expiration time of the certificate in days. The default
value is 365.
-ku and -eku The lists of valid uses for the certificate.
-sig_alg The signing algorithm that is used to create the signature
that is associated with the new self-signed certificate.
-format The format of output file. The default value is ascii.
-san_dnsname The Subject Alternative Name (SAN) DNS name(s) for the entry
that is recreated.
-san_ipaddr The Subject Alternative Name (SAN) IP address(es) for the
entry that is recreated.
Severity
0 : Informational
Response
None.
AMQ9834I
Usage: recreatecertrequest -m QMgrName [-label Label]
[-sig_alg SignatureAlgorithm] [-ku KeyUsageList]
[-eku ExtendedKeyUsageList] [-san_dnsname sanDNSName]
[-san_ipaddr sanIPAddr]
-m The queue manager to recreate the certificate request for.
-label The label of the certificate request to recreate. The default
value is IBM MQ_cert_label<QMgrName in lower case>.
-ku and -eku The lists of valid uses for the certificate.
-sig_alg The signing algorithm that is used to create the signature that
is associated with the new certificate.
-san_dnsname The Subject Alternative Name (SAN) DNS name(s) for the entry
that is recreated.
-san_ipaddr The Subject Alternative Name (SAN) IP address(es) for the entry
that is recreated
Severity
0 : Informational
Response
None.
AMQ9835I
Usage: listcert -m QMgrName [-expiry [days]]
-m The queue manager to list all certificates for.
-expiry Display the valid-from and valid-to dates for certificates.
Severity
0 : Informational
Response
None.
AMQ9836I
Usage: listcertrequest -m QMgrName
-m The queue manager to list all certificates requests for.
Severity
0 : Informational
Response
None.
AMQ9837I
Usage: detailcert -m QMgrName [-label Label]
-m The queue manager to show certificate detail from.
-label The label of certificate to be shown. Default is
IBM MQ_cert_label<QMgrName in lower case>.
Severity
0 : Informational
Response
None.
AMQ9838I
Usage: detailcertrequest -m QMgrName [-label Label]
-m The queue manager to show certificate request detail from.
-label The label of the certificate request to be shown. Default is
IBM MQ_cert_label<QMgrName in lower case>.
Severity
0 : Informational
Response
None.
AMQ9839I
Usage: keybackup -m QMgrName [-force]
-m The queue manager to back up the key repository for.
-force Suppress security warnings.
Severity
0 : Informational
Response
None.
AMQ9840I
Usage: keyrestore -m QMgrName -file FileName -password Password [-defer]
-m The queue manager to restore the key repository for.
-file The file which the key repository is restored.
-password The password to use with the restored key repository.
-defer Do not refresh SSL security.
Severity
0 : Informational
Response
None.
AMQ9841I
Usage: runmqwkm keycreate -m QMgrName
-m The queue manager to create the key repository for.
Severity
0 : Informational
Response
None.
AMQ9842E
Command has used option <insert_4> with an invalid value <insert_3>
Severity
30 : Error
Explanation
The command <insert_5> was issued specifying an invalid option value. The <insert_3> value for option <insert_4> is either missing or of an incorrect format.
Response
None.
AMQ9843I
Certificate has been extracted to <insert_3>.
Severity
0 : Informational
AMQ9844I
Key repository has been backed up to <insert_3>.
Password for key repository is:
Severity
0 : Informational
AMQ9845E
Unable to access file <insert_3>
Severity
30 : Error
AMQ9846W
This operation will generate a copy of our queue manager key repository, which may include private keys. Although encrypted, we should take appropriate security precautions in handling this file. The password required if you ever need to modify or restore this file will be displayed after the copy has been created.
Do you wish to continue? [Y/N]
Severity
10 : Warning
AMQ9847E
Certificate label <insert_3> already in use for queue manager <insert_4>.
Severity
30 : Error
Explanation
The supplied certificate label <insert_3> is already in use for queue manager <insert_4>
Response
Provide an alternative certificate label.
AMQ9848E
No certificate present with label <insert_3> for queue manager <insert_4>.
Severity
30 : Error
Explanation
Key repository for queue manager <insert_4> does not contain a certificate with the supplied label <insert_3>.
Response
None.
AMQ9849E
The operation could not be completed because a key repository backup or restore is already in progress.
Severity
20 : Error
Explanation
The key repository could not be backed up or restored because another key repository operation is in progress.
Response
Wait for the active key repository backup or restore process to complete, then retry the operation.
AMQ9850E
Invalid or incorrect password provided.
Severity
30 : Error
Explanation
The command <insert_3> was issued specifying an invalid or incorrect password.
Response
None.
AMQ9851E
The specified key repository backup file is corrupted. Cannot restore from it.
Severity
30 : Error
Explanation
The command has failed since it found inconsistency in the specified backup file. The backup file could be modified/altered since it was created.
Response
Ensure an original copy of the backup file is used.
AMQ9871I
Cluster maintenance has been running for <insert_1> minutes. Phase <insert_3> has so far made <insert_2> checks
Severity
0 : Informational
Explanation
A queue manager will periodically perform a maintenance cycle to refresh and remove state associated with the clusters that it is a member of. This message gives an indication of the progress that is being made.
Response
For large clusters this maintenance process may take a significant period of time, in such situations this message will be periodically repeated until maintenance has completed. When the maintenance cycle has completed message AMQ9872 will be written to this log.
AMQ9872I
Cluster maintenance has completed after <insert_1> minutes, <insert_2> checks were made
Severity
0 : Informational
Explanation
A queue manager will periodically perform a maintenance cycle to refresh and remove state associated with the clusters that it is a member of. This message indicates that that cycle has now completed. This message corresponds with one or more instances of message AMQ9871 previously reported.
Response
This message is for informational purposes only, no user response is required.
AMQ9873E
An error occurred while restoring the cluster repository cache, reason=<insert_1>
Severity
30 : Error
Explanation
An error was detected while restoring the cluster cache. The cluster cache held by this queue manager is now incomplete which may result in inconsistencies in cluster resources visible to and owned by this queue manager. See messages in the queue manager and system error logs for details of the error encountered.
Response
Contact the IBM support center to resolve the problem.
AMQ9874E
Repository manager failed. Retry in <insert_1> minutes.
Severity
30 : Error
Explanation
Repository manager encountered a problem. See the earlier messages in the queue manager or system error logs for details. The repository manager will retry the command in <insert_1> minutes. If the problem is not rectified no further cluster management activity will occur. This will affect the availability of cluster resources accessed or hosted by this queue manager.
Response
If possible, rectify the identified problem, otherwise contact the IBM support center. Once the problem has been rectified, if the SYSTEM.CLUSTER.COMMAND.QUEUE queue has been set to GET(DISABLED) set the queue to be GET(ENABLED) and wait for the repository manager to retry the command. If the repository manager process has terminated, restart the queue manager.
AMQ9875I
REFRESH CLUSTER processing started for cluster.
Severity
0 : Informational
Explanation
Refresh cluster processing started for cluster(<insert_3>) A REFRESH CLUSTER command has been issued on this queue manager. In phase one this will discard all locally cached information for the cluster and request new information from other members of the cluster when necessary. Phase two processes the information received. For large cluster configurations this process can take a significant time, especially on full repository queue managers, and during this time applications attempting to access cluster resources may see failures to resolve cluster resources. In addition, cluster configuration changes made on this queue manager may not be processed until the refresh process has completed.
Response
Defer any cluster related work on this queue manager until both phases are complete. Message AMQ9442 or message AMQ9404 will be issued to this log at the end of phase one. Completion of phase two can be determined when SYSTEM.CLUSTER.COMMAND.QUEUE has reached a consistently empty state.
AMQ9876I
Cluster management is about to compress a large number of cache records.
Severity
0 : Informational
Explanation
Periodically cluster management will compress its local cache. Compression can take a significant period of time for certain operations, such as performing a CLUSTER REFRESH. During the compression task, cluster management commands will not be processed. Once the compression task has completed message AMQ9877 will be written to this log.
Response
None.
AMQ9877I
Cluster cache compression has completed.
Severity
0 : Informational
Explanation
A large cache compression has completed. This message corresponds to message AMQ9876 being previously reported.
Response
None.
AMQ9878I
Cluster repository command <insert_3> for <insert_5> encountered a problem
Severity
0 : Informational
Explanation
An internal cluster repository command failed to complete successfully, reporting error reason <insert_1>. Earlier messages in the log will contain details of the problem. The command originated from queue manager <insert_4>, relating to object <insert_5>. Failure to successfully process a command may leave the cluster in an inconsistent state.
Response
Investigate the problems reported. Use the information provided when contacting MQ support.
AMQ9879W
Conflicting clustered topic <insert_3>
Severity
10 : Warning
Explanation
When conflicting clustered topic definitions are detected one or more of the definitions will have a CLSTATE of INVALID and those will not be used by this queue manager. The clustered topic <insert_3> from queue manager <insert_4> has been marked as INVALID. Conflicting clustered topics are those that relate to the same topic string but have different settings for their topic name, cluster route or cluster name. Additionally, clustered topics that are above or below another clustered topic in the topic tree (based on their topic strings) may conflict.
Response
View the clustered topics visible to this queue manager and determine which are the required definitions. Delete or modify the others to remove any conflict. Following this, ensure all clustered topics have a CLSTATE of ACTIVE on all queue managers in the cluster.
AMQ9880W
Object <insert_3> in cluster <insert_4> inserted after blanking of description characters.
Severity
10 : Warning
Explanation
The repository manager received a command to insert object <insert_3> in cluster <insert_4> from the queue manager with QMID <insert_5>. The description characters could not be converted from their source CCSID <insert_1> to the local CCSID <insert_2>. The repository manager has inserted the record in the local cache with a blank description.
Response
We can choose to do nothing. The object is successfully inserted to the local cluster cache, and is usable.
We can choose to go to the queue manager that hosts this object, and change its description to something that includes only a limited set of characters that will convert successfully on the local queue manager.
AMQ9881W
Cluster <insert_3> unknown.
Severity
10 : Warning
Explanation
This queue manager has been identified as a member of uniform cluster <insert_3>, but no matching CLUSRCVR channels can be found.
Response
Check that the correct cluster name has been provided, and that MQ cluster objects have been correctly configured for this cluster.
AMQ9882E
Invalid cluster name.
Severity
20 : Error
Explanation
This queue manager has been identified as a member of a uniform cluster but the provided value is not a valid MQ cluster name.
Response
Check that the correct cluster name has been provided.
This queue manager has been identified as a member of a uniform cluster but the queue manager PSMODE or PSCLUS settings do not support this.
Response
To make use of a uniform cluster ensure that the PSMODE and PSCLUS attributes for this queue manager are both configured to ENABLED.
AMQ9885W
Cluster object name <insert_3> located at QMID <insert_4> is resolved using old cached information.
Severity
10 : Warning
Explanation
The local queue manager has allowed an application to use the object named <insert_3> located at the queue manager with QMID <insert_4> from the local cached cluster information, without being certain that it is currently up to date. This warning is being written because the object has not been used for a long time, but now an application needs to use it. The local queue manager has sent new queries to full repository queue managers in all clusters, but responses have not been received from all within a reasonable time.
It is possible this is a temporary condition due to slowness in processing in one of: the local queue manager, the remote full repository queue manager, or the channels between them. Therefore this condition might only last a few seconds, and so it might clear before you see this message.
The object type is <insert_1>. If this object is a queue, the number is 1. If this object is a channel (a route to a queue manager) then the number is 2, and the queue manager name is <insert_5>.
If this object is not renewed by information from the full repositories for a long time, then it will eventually be removed automatically from the local cache.
The object is due to be removed automatically from the local cache in <insert_2> days.
Response
Check the queue manager error logs for errors on the cluster channels to and from the full repository queue managers. Correct the reason for any errors.
We should note the number of days left before this object will be removed from the local cache, and ensure any problem is corrected before that time, because one or more applications is still trying to use this object.
AMQ9886E
Cannot become a full repository for cluster <insert_4>.
Severity
20 : Error
Explanation
This queue manager has been identified as needing to automatically become a full repository for cluster <insert_4>, however it can not be made one. Support for automatically making queue managers full repositories for clusters has a limitation that the queue manager must not already be a repository for another cluster.
Response
Verify that this queue managers REPOS and REPOSNL attributes are empty and restart the queue manager.
AMQ9887W
This queue manager will no longer be a repository for cluster <insert_3>.
Severity
10 : Warning
Explanation
Automatic cluster configuration is replacing the currently defined REPOS definition of <insert_3> with <insert_4>.
Response
None.
AMQ9913E
The specified local address <insert_3> cannot be resolved to an IP address. The return code is <insert_1>.
Severity
30 : Error
Explanation
An attempt to resolve the local address hostname to an IP address has failed.
Response
Check that the local address hostname is correct and has an entry in the DNS database.
AMQ9914E
The type of local address specified is incompatible with the IP protocol (<insert_3>) used.
Severity
30 : Error
Explanation
An attempt to use a local address that is incompatible with the IP protocol used.
Response
Make sure that the local address specified is of the same type (IPv4 or IPv6) as the IP Protocol.
AMQ9915E
The IP protocol <insert_3> is not present on the system.
Severity
30 : Error
Explanation
An attempt to use an IP protocol that is not present on the system has been made.
Response
Install the required IP protocol or use an IP protocol that is available on the system. This error can also occur if the system is short of memory or other system resources.
AMQ9920E
A SOAP Exception has been thrown.
Severity
30 : Error
Explanation
A SOAP method encountered a problem and has thrown an exception. Details of the exception are:
<insert_3>
Response
Investigate why the SOAP method threw the exception.
An error was encountered when an attempt was made to write a message to dead-letter queue <insert_3>. The message was <insert_4>.
Response
Ensure that dead-letter queue <insert_3> exists and is put enabled. Ensure that the queue manager attribute DEADQ is set up correctly. Resend the SOAP message.
AMQ9922E
Maximum wait time exceeded on queue <insert_3>.
Severity
30 : Error
Explanation
The maximum time waiting for a message to arrive on queue <insert_3> has been exceeded.
Response
Ensure that the queue is not put inhibited. Ensure that messages are being written to the queue.
AMQ9923E
Insufficient parameters on command.
Severity
30 : Error
Explanation
The SOAP command has been issued with insufficient paramaters.
Response
Supply the correct number of parameters and reissue the command.
AMQ9925E
Cannot connect to queue manager <insert_3>.
Severity
30 : Error
Explanation
A SOAP application or the SOAP listener cannot connect to the queue manager <insert_3> using <insert_4> bindings.
Response
Ensure the bindings are set to the correct value and that the queue manager exists. Check any error messages from the Java MQQueueManager class.
AMQ9926E
Null SOAP action specified in a received SOAP message.
Severity
30 : Error
Explanation
A NULL soap action has been specified in the SOAP message <insert_3>. The message will not be processed.
Response
Include the appropriate SOAP action in the SOAP message.
AMQ9927E
MQ queue backout threshold exceeded.
Severity
30 : Error
Explanation
The IBM MQ backout threshold value has been exceeded for queue <insert_3>, processing message <insert_4>.
Response
Correct the backout threshold value for queue <insert_3> and resend the SOAP message.
AMQ9928E
Target service or URI is missing from a SOAP message.
Severity
30 : Error
Explanation
The target service or the target URI is missing from SOAP message <insert_3>.
Response
Supply a target service or the target URI in the SOAP message.
AMQ9929E
Message backout for message (<insert_3>) failed.
Severity
30 : Error
Explanation
Backout for a message has failed.
Response
Investigate the reason for the backout failure.
AMQ9930E
Required Option <insert_3> missing from command.
Severity
30 : Error
Explanation
The SOAP command was issued with manadatory option <insert_3> missing.
Response
Reissue the SOAP command supplying the missing option.
AMQ9931E
Invalid value <insert_3> specified for option <insert_4>.
Severity
30 : Error
Explanation
THE SOAP command was issued with an invalid value for an option.
Response
Reissue the SOAP command supplying the correct option value.
AMQ9932E
Application host class not found
Severity
30 : Error
Explanation
Application host class <insert_3> has not been found.
Response
Specify the correct application host class in the SOAP message.
AMQ9933E
Options <insert_3> and <insert_4> are mutually exclusive
Severity
30 : Error
Explanation
The SOAP command was issued with incompatible options <insert_3> and <insert_4>.
Response
Reissue the SOAP command supplying compatible options.
AMQ9934E
Could not parse URL <insert_3>. MQCC_FAILED(2) MQRC_SOAP_URL_ERROR(2212).
Severity
30 : Error
Explanation
Could not parse URL <insert_3>. MQCC_FAILED(2) MQRC_SOAP_URL_ERROR(2212).
Unexpected message type received. MQCC_FAILED(2) MQRC_UNEXPECTED_MSG_TYPE.(2215).
Severity
30 : Error
Explanation
.A message of the wrong type was received; for instance, a report message was received when one had not been requested.
Response
If we are running MQ SOAP using the IBM supplied SOAP/MQ sender, please contact IBM. If we are running MQ SOAP using a bespoke sender, please check that the SOAP/MQ request message has the correct options.
AMQ9953E
Either the ContentType or the TransportVersion in the RFH2 header have the wrong value. MQCC_FAILED(2) MQRC_RFH_HEADER_FIELD_ERROR(2228)
Severity
30 : Error
Explanation
.Either the ContentType or the TransportVersion in the RFH2 header have the wrong value. MQCC_FAILED(2) MQRC_RFH_HEADER_FIELD_ERROR(2228)
Response
Correct the message format and retry.
AMQ9954E
ViaTran.Redirect called out of transaction MQCC_FAILED(2) MQRC_SOAP_DOTNET_ERROR(2410)
Severity
30 : Error
Explanation
.ViaTran.Redirect called out of transaction MQCC_FAILED(2) MQRC_SOAP_DOTNET_ERROR(2410)
Response
Make sure ViaTran.Redirect is only called in a transaction.
AMQ9990S (IBM i)
Keyword <insert_3> not valid for this command or the command is incomplete.
Severity
40 : Severe
Explanation
The command is incomplete, or an invalid keyword was specified, or the parameter value of the keyword was not specified.
Response
Complete the command, or correct the keyword, or add the parameter value, and then try the command again.
AMQ9991S (IBM i)
The value specified is not allowed by the command.
Severity
40 : Severe
Explanation
<insert_3> not valid for parameter <insert_4>.
Response
Enter one of the values that is defined for the parameter, and try the command again. More information on parameters and commands can be found in the CL reference manual or the appropriate licensed program manual.
AMQ9992S (IBM i)
A matching parenthesis not found.
Severity
40 : Severe
Explanation
A matching left or right parenthesis is missing.
Response
Add the missing parenthesis or remove the extra parenthesis.
AMQ9999E
Channel <insert_3> to host <insert_5> ended abnormally.
Severity
30 : Error
Explanation
The channel program running under process ID <insert_4> for channel <insert_3> ended abnormally. The host name is <insert_5>; in some cases the host name cannot be determined and so is shown as '????'.
Response
Look at previous error messages for the channel program in the error logs to determine the cause of the failure. Note that this message can be excluded completely or suppressed by tuning the "ExcludeMessage" or "SuppressMessage" attributes under the "QMErrorLog" stanza in qm.ini. Further information can be found in the System Administration Guide.