tibemsSSLParams_System_SetApplicationId

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.

Note: 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_ERROR.

Contents

Index

Search Results