tibemsSSLParams_System_SetApplicationId
Function
Purpose
Set the application ID to be used by this application.
C Declaration
tibems_status tibemsSSLParams_System_SetApplicationId( tibemsSSLParams params, const char* application_id );
COBOL Call
CALL "tibemsSSLParams_System_SetApplicationId" USING BY VALUE params, BY REFERENCE application-id, RETURNING tibems-status END-CALL.
application-id
has usage pointer.
IBM z/OS
This function is not supported on IBM z/OS systems.
Parameters
Parameter | Description |
---|---|
params
|
Set the value in this TLS parameter object. |
application_id
|
The application ID for the application definition. |
Remarks
The IBM i Digital Certificate Manager may be used to create a client application definition and assign it a certificate to be used during a TLS handshake. Part of the application definition is the application ID, which uniquely identifies the application definition. More information about application definitions may be found in the IBM i Information Center, Security, Digital Certificate Manager.
This is a global parameter. As a result, the first connection made by the application establishes the application ID to be used by all other connections within this address space. Any attempt to specify a different application ID for subsequent connections will be ignored.
Because a connection requires either an application ID
or a certificate store and label—but not both—setting this parameter causes any parameters set with
tibemsSSLParams_System_SetKeyRingFile
and
tibemsSSLParams_System_SetLabel
to be ignored.
Returns
TIBEMS_OK
if it succeeds, otherwise
TIBEMS_SSL_ERRO
R.