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.
Error Messages<br />
Message ID Error Message Text<br />
CPE3418 E Possible APAR condition or hardware failure.<br />
CPF9872 E Program or service program &1 in library &2 ended. Reason code &3.<br />
CPFA081 E Unable to set return value or error code.<br />
Related Information<br />
v “gsk_secure_soc_close()—Close a secure session” on page 37—Close a secure session<br />
v “gsk_secure_soc_init()—Negotiate a secure session” on page 38—Negotiate a secure session<br />
v “gsk_secure_soc_open()—Get a handle for a secure session”—Get a handle for a secure session<br />
v “gsk_strerror()—Retrieve GSKit runtime error message” on page 62—Retrieve GSK runtime error<br />
message<br />
API introduced: V5R1<br />
Top | UNIX-Type <strong>APIs</strong> | <strong>APIs</strong> by category<br />
gsk_secure_soc_open()—Get a handle for a secure session<br />
Syntax<br />
#include <br />
int gsk_secure_soc_open(gsk_handle my_env_handle,<br />
gsk_handle *my_session_handle);<br />
Service Program Name: QSYS/QSOSSLSR<br />
Default Public Authority: *USE<br />
Threadsafe: Yes<br />
The gsk_secure_soc_open() function is used to get storage for a secure session, set default values for<br />
attributes, and return a handle that must be saved and used on secure session-related function calls.<br />
Parameters<br />
my_env_handle (Input)<br />
The handle for the SSL environment obtained from gsk_environment_open().<br />
my_session_handle (Output)<br />
Pointer to the secure session handle.<br />
Authorities<br />
No authorization is required.<br />
Return Value<br />
gsk_secure_soc_open() returns an integer. Possible values are:<br />
[GSK_OK]<br />
gsk_secure_soc_open() was successful.<br />
[GSK_INVALID_HANDLE]<br />
The environment handle specified was not valid.<br />
44 <strong>System</strong> i: <strong>Programming</strong> <strong>Secure</strong> <strong>Sockets</strong> <strong>APIs</strong>