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.
Usage Notes
1. You must do a gsk_secure_soc_close() if a prior gsk_secure_soc_open() was successful.
Related Information
v “gsk_secure_soc_init()—Negotiate a secure session”—Negotiate a secure session
v “gsk_secure_soc_misc()—Perform miscellaneous functions for a secure session” on page 41—Perform
miscellaneous functions for a secure session
v “gsk_secure_soc_open()—Get a handle for a secure session” on page 44—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_init()—Negotiate a secure session
Syntax
#include
int gsk_secure_soc_init(gsk_handle my_session_handle);
Service Program Name: QSYS/QSOSSLSR
Default Public Authority: *USE
Threadsafe: Yes
The gsk_secure_soc_init() function is used to negotiate a secure session, using the attributes set for the
SSL environment and the secure session. This API does the SSL handshake to the remote peer; upon
successful completion, you have a secure session established.
Parameters
my_session_handle (Input)
The handle for this secure session that was obtained through the gsk_secure_soc_open() API call.
Authorities
Authorization of *R (allow access to the object) to the certificate store file and its associated files is
required. Authorization of *X (allow use of the object) to each directory of the path name of the certificate
store file and its associated files is required.
Return Value
gsk_secure_soc_init() returns an integer. Possible values are:
38 System i: Programming Secure Sockets APIs