System i: Programming Secure Sockets APIs - IBM
System i: Programming Secure Sockets APIs - IBM
System i: Programming Secure Sockets APIs - IBM
You also want an ePaper? Increase the reach of your titles
YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.
unsigned int protocol (input)<br />
The protocol(s) that are acceptable as the handshake protocol for this job. The following values<br />
may be specified for protocol and are defined in .<br />
SSL_VERSION_CURRENT 0 (TLS with SSL Version 3.0 and SSL<br />
Version 2.0 compatibility)<br />
SSL_VERSION_2 2 (SSL Version 2.0 only)<br />
SSL_VERSION_3 3 (SSL Version 3.0 only)<br />
TLS_VERSION_1 4 (TLS Version 1 only)<br />
TLSV1_SSLV3 5 (TLS Version 1 with SSL<br />
Version 3.0 compatibility)<br />
unsigned int timeout (input)<br />
The time period (in seconds) for which TLS Version 1.0 and SSL Version 3.0 session parameters<br />
are cached for use with abbreviated SSL handshakes. The valid range for timeout is from 1 to<br />
86,400 seconds (24 hours). Not specifying a value (0) will default to the maximum timeout, and<br />
specifying a value of 0xffffffff will disable caching. The following values are defined in<br />
.<br />
SSL_TIMEOUT_DEFAULT 0 (Use default timeout, 24 hours)<br />
SSL_TIMEOUT_MAX 86400 (Use maximum timeout, 24 hours)<br />
SSL_TIMEOUT_DISABLE 0xffffffff (Disable caching of session parameters<br />
for abbreviated handshakes)<br />
char reserved[12] (input)<br />
This reserved field must be set to NULL (0s).<br />
Authorities<br />
Authorization of *R (allow access to the object) to the key database file and its associated files is required.<br />
The certificate is stored in a key database file.<br />
Return Value<br />
The SSL_Init_Application() API returns an integer. Possible values are:<br />
[0]<br />
Successful return<br />
[SSL_ERROR_BAD_CIPHER_SUITE]<br />
A cipher suite that is not valid was specified.<br />
[SSL_ERROR_CERT_EXPIRED]<br />
The validity time period of the certificate is expired.<br />
[SSL_ERROR_KEYPASSWORD_EXPIRED]<br />
The specified key ring password has expired.<br />
[SSL_ERROR_NO_KEYRING]<br />
No key ring file was found.<br />
[SSL_ERROR_NOT_REGISTERED]<br />
The application identifier is not registered with the certificate registry facility.<br />
[SSL_ERROR_NOT_TRUSTED_ROOT]<br />
The certificate is not signed by a trusted certificate authority.<br />
[SSL_ERROR_NO_CERTIFICATE]<br />
No certificate is available for SSL processing.<br />
[SSL_ERROR_IO]<br />
<strong>Secure</strong> <strong>Sockets</strong> <strong>APIs</strong> 87