System i: Programming Secure Sockets APIs - IBM

command. A cipher suite removed from the SSL cipher specification list will also be removed from the
default cipher suite list shown here. The order of the cipher suites in QSSLCSL will be used to order
the cipher suites in the default list.
4. The Display System Value (DSPSYSVAL) command or the Retrieve System Values (QWCRSVAL) API
can be used to determine the current setting of the supported ciphers (QSSLCSL) for system SSL.
unsigned int cipherSuiteListLen (input)
The number of cipher suite entries specified in the list pointed to by the cipherSuiteList
parameter.
Authorities
Authorization of *R (allow access to the object) to the key ring file and its associated files is required.
Return Value
The QlgSSL_Init() API returns an integer. Possible values are:
[0]
Successful return
[SSL_ERROR_BAD_CIPHER_SUITE]
A cipher suite that is not valid was specified.
[SSL_ERROR_IO]
An error occurred in SSL processing; check the errno value.
[SSL_ERROR_KEYPASSWORD_EXPIRED]
The specified key ring password has expired.
[SSL_ERROR_NO_KEYRING]
No key ring file was specified.
[SSL_ERROR_SSL_NOT_AVAILABLE]
SSL is not available for use.
[SSL_ERROR_UNSUPPORTED]
Operation is not supported by SSL.
None of the specified protocol or cipher values are supported by System SSL.
[SSL_ERROR_UNKNOWN]
An unknown or unexpected error occurred during SSL processing.
Error Conditions
When the QlgSSL_Init() API fails with return code [SSL_ERROR_IO], errno can be set to:
[EINVAL]
Parameter not valid.
This error code indicates that the Qlg_Path_Name_T structure was not valid:
v The path type was less than 0 or greater than 3.
v A reserved field was not initialized to zeros.
[ECONVERT]
Conversion error.
This error code indicates one of the following:
Secure Sockets APIs 67