System i: Programming Secure Sockets APIs - IBM

Authorities
No authorization is required.
Return Value
The SSL_Strerror() API returns a pointer to the string. The null-terminated string is stored in the CCSID of
the job. If the serrmsgp is provided, the SSLErrorMsg struct will be updated to reflect the message
information corresponding to the string returned.
Error Conditions
If the sslreturnvalue is unrecognized, then an Unknown error message will be stored at the location
pointed to by the return value. Other error conditions will be handled as described under Error
Messages.
Error Messages
This API calls the Retrieve Message (QMHRTVM) API in order to perform its task. It inherits all error
conditions from this function. If errors are encountered while using the Retrieve Message API, they will
be reflected in the SSLErrorMsg fields (if provided) and any associated message replacement text will be
stored at the location pointed to by the return value.
Related Information
v “SSL_Perror()—Print SSL Error Message” on page 89—Print SSL Error Message
v “SSL_Create()—Enable SSL Support for the Specified Socket Descriptor” on page 69—Enable SSL
Support for the Specified Socket Descriptor
v “SSL_Destroy()—End SSL Support for the Specified SSL Session” on page 71—End SSL Support for the
Specified SSL Session
v “SSL_Handshake()—Initiate the SSL Handshake Protocol” on page 74—Initiate the SSL Handshake
Protocol
v “SSL_Init()—Initialize the Current Job for SSL” on page 80—Initialize the Current Job for SSL
v “SSL_Init_Application()—Initialize the Current Job for SSL Processing Based on the Application
Identifier” on page 84—Initialize the Current Job for SSL Processing Based on the Application Identifier
v “SSL_Read()—Receive Data from an SSL-Enabled Socket Descriptor” on page 91)—Receive Data from
an SSL-Enabled Socket Descriptor
v “SSL_Write()—Write Data to an SSL-Enabled Socket Descriptor” on page 97—Write Data to an
SSL-Enabled Socket Descriptor
Example
The following example shows how SSL_Strerror() is used.
Note: By using the code examples, you agree to the terms of the “Code license and disclaimer
information” on page 111.
#include
#include
#include
#include
#include
#include
#include
/* bufferLen is 250 bytes */
#define bufferLen 250
void main()
{
96 System i: Programming Secure Sockets APIs