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.
gsk_attribute_set_numeric_value()—Set numeric information for a<br />
secure session or an SSL environment<br />
Syntax<br />
#include <br />
int gsk_attribute_set_numeric_value(gsk_handle my_gsk_handle,<br />
GSK_NUM_ID numID,<br />
int numValue);<br />
Service Program Name: QSYS/QSOSSLSR<br />
Default Public Authority: *USE<br />
Threadsafe: Yes<br />
The gsk_attribute_set_numeric_value() function is used to set specific numeric information for a secure<br />
session or an SSL environment.<br />
Parameters<br />
my_gsk_handle (Input)<br />
One of the following handles:<br />
v The handle for the secure session. (my_session_handle)<br />
v The handle for the SSL environment. (my_env_handle)<br />
numID (Input)<br />
One of the following operations:<br />
v GSK_FD (300) - numValue is a socket descriptor to be used for this secure session.<br />
v GSK_V2_SESSION_TIMEOUT (301) - numValue is the SSL Version 2 session time-out for the<br />
SSL environment. numValue must be in the range 0-100 seconds.<br />
v GSK_V3_SESSION_TIMEOUT (302) - numValue is the SSL Version 3 and TLS Version 1<br />
session time-out for the SSL environment. numValue must be in the range 0-86400 seconds (24<br />
hours).<br />
v GSK_OS400_READ_TIMEOUT (6993) - numValue is the receive time-out for the secure session<br />
or the SSL environment. numValue must be in milliseconds. A numValue of 0 is the default<br />
which means to wait forever.<br />
v GSK_HANDSHAKE_TIMEOUT (6998) - numValue is the SSL handshake time-out for the<br />
secure session or the SSL environment. numValue must be in seconds. A numValue of 0 is the<br />
default which means to wait forever.<br />
numValue (Input)<br />
An integer value to be updated for the specified numID.<br />
Authorities<br />
No authorization is required.<br />
Return Value<br />
gsk_attribute_set_numeric_value() returns an integer. Possible values are:<br />
[GSK_OK]<br />
gsk_attribute_set_numeric_value() was successful.<br />
[GSK_INVALID_STATE]<br />
28 <strong>System</strong> i: <strong>Programming</strong> <strong>Secure</strong> <strong>Sockets</strong> <strong>APIs</strong>