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 SSL 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.