tibemsSSLParams_System_SetLabel
Function
Purpose
Set the certificate to be used to make the connection.
C Declaration
tibems_status tibemsSSLParams_System_SetLabel( tibemsSSLParams params, const char* keyring_label)
COBOL Call
CALL "tibemsSSLParams_System_SetLabel" USING BY VALUE SSLParams, BY REFERENCE keyring_label, RETURNING tibems-status END-CALL.
Note:
SSLParams
and
keyring_label
have usage pointer.
Parameters
Parameter | Description |
---|---|
params
|
The TLS parameter object. |
keyring_label
|
The name of the certificate label on the chosen SAF key ring or certificate store to use when creating the connection. |
Remarks
This is a connection-specific parameter and can be separately specified for each connection. The label parameter is optional. If it is not specified, the system uses the default certificate on the key ring. If there is no default certificate, the connection fails.
On IBM i, this parameter setting is ignored of the application ID parameter has been set.
Returns
TIBEMS_OK
if it succeeds, otherwise
TIBEMS_SSL_ERROR
.