# 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`.

## See Also

`tibemsSSLParams_System_SetKeyRingFile`

`tibemsSSLParams_System_SetApplicationId`

Copyright © Cloud Software Group, Inc. All rights reserved.