System i: Programming Secure Sockets APIs - IBM

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” 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_environment_init()—Initialize an SSL environment
Syntax
#include
int gsk_environment_init(gsk_handle my_env_handle);
Service Program Name: QSYS/QSOSSLSR
Default Public Authority: *USE
Threadsafe: Yes
The gsk_environment_init() function is used to initialize the SSL environment after any required
attributes are set. The certificate store file is opened and other operations such as accessing information in
the registration facility are performed to set up this environment. After this function call is issued, SSL is
ready to process secure session requests.
Parameters
my_env_handle (Input)
The handle identifying the SSL environment that will be initialized.
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_environment_init() returns an integer. Possible values are:
[GSK_OK]
gsk_environment_init() was successful.
[GSK_INVALID_HANDLE]
The handle specified was not valid.
[GSK_INVALID_STATE]
A gsk_environment_init() has already been issued with this handle.
[GSK_KEYRING_OPEN_ERROR]
Certificate store file could not be opened.
[GSK_AS400_ERROR_NO_ACCESS]
No permission to access the certificate store file.
32 System i: Programming Secure Sockets APIs