System i: Programming Secure Sockets APIs - IBM

active secure sessions will continue to work and the environment close will effectively be
delayed. The resources for the SSL environment will not be freed up until after the last secure
session closes. No new secure sessions will be allowed to start using the closed SSL
environment. enumValue must specify one of the following:
– GSK_DELAYED_ENVIRONMENT_CLOSE (536) - Enable the environment close callback
routine support.
– GSK_NORMAL_ENVIRONMENT_CLOSE (537) - Field is ignored.
enumValue (Input)
An enumerated type appropiate to the enumID.
Authorities
No authorization is required.
Return Value
gsk_attribute_set_enum() returns an integer. Possible values are:
[GSK_OK]
gsk_attribute_set_enum() was successful.
[GSK_ATTRIBUTE_INVALID_ENUMERATION]
The enumeration specified for the enumValue was not valid.
[GSK_ATTRIBUTE_INVALID_ID]
The enumID specified was not valid.
[GSK_CONFLICTING_VALIDATION_SETTING]
The value for GSK_SERVER_AUTH_TYPE or GSK_CLIENT_AUTH_TYPE conflicts with the
setting for the validationCallBack.validateRequired field for GSK_CERT_VALIDATION_CALLBACK
set by gsk_attribute_set_callback().
[GSK_INVALID_STATE]
One of the following occurred:
v The enumID cannot be set after a gsk_environment_init() has been issued.
v The enumID cannot be set after a gsk_secure_soc_init() has been issued.
[GSK_INVALID_HANDLE]
The handle specified was not valid.
[GSK_ERROR_UNSUPPORTED]
The enumID is currently not supported.
[GSK_ERROR_IO]
An error occurred in SSL processing, check the errno value.
Error Conditions
When the gsk_attribute_set_enum() API fails with return code [GSK_ERROR_IO], errno can be set to:
[EINTR]
Interrupted function call.
[EDEADLK]
Resource deadlock avoided.
[ETERM]
Operation terminated.
If an errno is returned that is not in this list, look in “Errno Values for UNIX-Type Functions” on page 103
for a description of the errno.
26 System i: Programming Secure Sockets APIs