TTLSKeyringParms statement

Use the TTLSKeyringParms statement to define a set of key ring parameters for an AT-TLS environment action. A TTLSKeyringParms statement can be specified inline in a TTLSEnvironmentAction statement or referenced by a TTLSEnvironmentAction statement.

Syntax


>>-TTLSKeyringParms--+------+--| Put Braces and Parameters on Separate Lines |-><
                     '-name-'                                                    

Put Braces and Parameters on Separate Lines

|--+-{-------------------------------+--------------------------|
   +-| TTLSKeyringParms Parameters |-+   
   '-}-------------------------------'   

TTLSKeyringParms Parameters

|--Keyring value--+-----------------+--+------------------------+--|
                  '-KeyringPw value-'  '-KeyringStashFile value-'

Parameters

name: A string 1 - 32 characters in length specifying the name of this TTLSKeyringParms statement.
Rule: If this TTLSKeyringParms statement is not specified inline within another statement, a name value must be provided. If a name is not specified for an inline TTLSKeyringParms statement, a nonpersistent system name is created.
Keyring: Specifies the path and file name of the key database z/OS® UNIX file, the ring name of the SAF key ring, or the name of the z/OS PKCS #11 token. For System SSL, a key database is assumed if KeyringPw or KeyringStashFile is also specified. For System SSL, a z/OS PKCS #11 token name is specified as *TOKEN*/token-name. *TOKEN* indicates that the specified key ring is actually a token name. Otherwise, a SAF key ring is used. For System SSL, the GSK_KEYRING_FILE value is set to the value specified. Valid values are 1 - 1 023 characters in length.
KeyringPw: Specifies the password for the key database. For System SSL, GSK_KEYRING_PW is set to this value. Valid values are in the range 1 - 128 characters in length.
KeyringStashFile: Specifies the path and file name of the key database password stash file. For System SSL, the KeyringPw value is used instead of the KeyringStashFile value, if that value is also specified. For System SSL, GSK_KEYRING_STASH_FILE is set to this value. Valid values are in the range 1 - 1 023 characters in length.