DCE Application Programming Guide

Building, Running, and Debugging NonStop DCE

Applications

HP NonStop DCE Application Programming Guide—429551-003

4-4

Using NonStop DCE Environment Variables

NonStop DCE supports environment variables for controlling program execution. The

NonStop DCE environment variables useful to application programmers include:

•

Message catalogs

DCE message catalogs contain the text of the messages used by the DCE

product. The message catalog feature is controlled by two environment variables:

NLSPATH

The NLSPATH variable specifies the location of the message catalogs. The

default location is:

export NLSPATH=/usr/lib/nls/msg/%L/%N

LANG

The LANG variable specifies the locale used for displaying the messages. The

variable should be set to indicate the desired local language and character set

(such as en_US.ISO8859-1). For example:

export LANG=en_US.ISO8859-1

•

Default RPC name service entry

A default RPC name service entry name and the syntax of the name can be

specified using the RPC_DEFAULT_ENTRY environment variable. These values

are used for name service interface (NSI) import operations to specify null values

for the name server entry and entry syntax.

The RPC_DEFAULT_ENTRY environment variable can contain the name of a

server, group, or profile entry.

If an application is a child of a process that ran the dce_config utility, the following

actions might be available through inherited environment variables:

•

Cell directory services (CDS) information

The behavior of the CDS advertiser can be checked with the

CDS_ADVERTISEMENTS environment variable, which can have these values:

The default value for this environment variable is y.

The number of CDS clerks for the host can be checked with the

TOTAL_CLERKS environment variable. On NonStop DCE systems, CDS clerks

are shared among users (unlike some other DCE systems, which use one DCS

clerk for each user ID).

The default value is 1.

y indicates that the CDS advertiser sends and receives advertisements.

n indicates that the CDS advertiser was started with the -s switch,

meaning that the server does not send or receive advertisements.