tibemsConnectionFactory_SetPkPassword

Function

Purpose

Set the TLS private key password for the connection factory.

C Declaration

extern tibems_status tibemsConnectionFactory_SetPkPassword(
    tibemsConnectionFactory factory,
    const char* pk_password);

COBOL Call

CALL "tibemsConnectionFactory_SetPkPassword"
    USING BY VALUE factory,
           BY REFERENCE pk-password,
           RETURNING tibems-status
END-CALL.
Note: factory has usage pointer.

On IBM z/OS systems, the pk-password must always be a null value.

Parameters

Parameter Description
factory Set the TLS password for this connection factory.
pk_password Connections created by the connection factory decode their TLS private key using this password when establishing TLS communication.

Remarks

It is an error to call this function on a connection factory for which an tibemsSSLParams struct is not yet set.

Notice that this TLS private key encryption password is distinct from the server authentication password, and from the proxy authentication password.

See Also

tibemsSSLParams

tibemsConnectionFactory_SetSSLParams