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 SSL 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 an SSL 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