Previous Topic: Using the Applini File


Using the Applini File in NonStop

Starting with CA Gen Release 7.6, the runtime utilizes a file named applini. This file holds application-specific environment variables in a token=value pairing. This initialization file is delivered with the C runtime in the CA Gen installation directory. When a C application is built using the Setup Tool or the Build Tool, this file is copied (only once) into the model's executable subvolume/directory. You can customize this copy of the applini file without overriding the copy in the Implementation Toolset location.

When a C application is executed (including distributed processing servers and Block Mode servers), the applini file that resides in the model's executable subvolume/directory is opened and read by the C Runtime. Any uncommented environment variables are then set and used within the application.

Environment Variables in the Applini File

The applini file contains a set of commented environment variables. To use any of these environment variables, you must remove the comment from the variable (";") and modify the value as necessary.

The applini contains the following environment variables:

Environment Variable

Description

Default

TRACE_ENABLE

Enables communications with the Diagram Trace Utility.

1

TRACE_HOST

Defines the Windows system that will run the Diagram Trace Utility.

<none>

TRACE_PORT

Defines the port that the Diagram Trace Utility will listen to.

4567

Note: The Diagram Trace Utility is accessible only if the C application has been generated with Trace Enabled.