Key ring name not recognized

During configuration, the incorrect use of the backslash (\) character as a parameter delimiter prevents the key ring file being recognized.

Symptom

The SSL protocol handler fails to start because the keyring file cannot be found.

Probable cause

Java interprets the backslash (\) character as a parameter delimiter; a backslash (\) character has been incorrectly used as a directory separator in the path name of the key ring file during configuration, and Java does not recognize the name.

Action

Check the SSL protocol configuration values in the CICS Transaction Gateway configuration file (ctg.ini). Ensure that either forward slash (⁄) character, or double backslash (\\) characters are used as separators in the path names on all operating systems. For example:

On UNIX and Linux®:

/mykeys/jsse/keystore.jks
\\mykeys\\jsse\\keystore.jks

On Windows:

c:/mykeys/jsse/keystore.jks
c:\\mykeys\\jsse\\keystore.jks