# 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.

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_ERRO`R.

## See Also

`tibemsSSLParams_System_SetKeyRingFile`

`tibemsSSLParams_System_SetLabel`

Copyright © Cloud Software Group, Inc. All rights reserved.