System i: Programming Secure Sockets APIs - IBM

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