tibemsConnectionFactory_SetPkPassword

Function

Purpose

Set the SSL 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 SSL password for this connection factory.
pk_password Connections created by the connection factory decode their SSL private key using this password when establishing SSL 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 SSL private key encryption password is distinct from the server authentication password, and from the proxy authentication password.