2381 (094D) (RC2381): MQRC_KEY_REPOSITORY_ERROR

Explanation

On an MQCONN or MQCONNX call, the location of the key repository is either not specified, not valid, or results in an error when used to access the key repository.

The location of the key repository is specified by one of the following:

The value of the SSLKeyRepository property in the SSL stanza of the client configuration file (MQCONN or MQCONNX call), or
The value of the MQSSLKEYR environment variable (MQCONN or MQCONNX call), or
The value of the KeyRepository field in the MQSCO structure (MQCONNX call only).

For the MQCONNX call, if both MQSSLKEYR and KeyRepository are specified, the latter is used.

[MQ 9.3.0 Jun 2022] This reason code can also occur if the passphrase to access the key repository is not supplied, incorrect, or cannot be decrypted. See Supplying the key repository password for an IBM® MQ MQI clienton AIX®, Linux®, and Windows for more information.

Completion code

MQCC_FAILED

Programmer response

Ensure that a valid location is specified for the key repository.

Check the client error log for a message that indicates the cause of the error.

[MQ 9.3.0 Jun 2022] If the error log indicates that the key repository passphrase is incorrect, check that the correct key repository passphrase is specified, or that the key repository stash file exists and is readable by the user ID that the application is running under.

[MQ 9.3.0 Jun 2022] If the key repository passphrase is encrypted, and an initial key was specified to the runmqicred utility when the passphrase was encrypted, ensure that the initial key used to encrypt the passphrase is specified by the application.