Types of Variables

There are two types of variables:


Predefined Variables

Predefined variables are created when ZfS starts. They are used in software packages and are recognized by policy packages.

Predefined variables are not case-sensitive, although they are displayed in all uppercase on the server console and in this documentation.

Syntax:

%predefined_variable_name%

where predefined_variable_name is the name defined by ZfS. For example:

%WORKING_PATH%

To make a predefined variable useful, its value must be set in the Server Software Package component.

The Java* environment can use predefined variables, such as SERVER_DN being used in a Java process call in an .NCF file.

An example of how a policy package can use a predefined variable is for the Broadcast Message text in the Server Down Process policy. The text can include a variable for the server name (%SERVER_DN%) so that the broadcast message will display the name of the server.

The following ZfS predefined variables are available:

Variable Description

BASE_PATH

Location of the Policy Manager (for example, SYS:\ZENWORKS\PDS\SMANAGER).

IP_ADDRESS

IP address of a server.

LOAD_DIR

(NetWare® only) Directory where the server was loaded from.

PLUGINS_PATH

Path where the ZfS plug-ins were installed.

POLICY_PATH

Path where the policy files (.POL) are stored.

PROP_PATH

Path where Novell eDirectoryTM object properties are stored.

SERVER_DN

Distinguished server name in eDirectory.

SERVER_NAME

Name given the server when NetWare was installed.

TED_PATH

Path to the TED directory.

TREE_NAME

Name of the eDirectory tree where ZfS servers reside.

WORKING_PATH

Working directory for the Server Policies and Server Software Packages components.


User-Defined Variables

User-defined variables are created in the Server Software Package component, Subscriber objects, and the Tiered Electronic Distribution policy. Policy packages do not recognize user-defined variables.

User-defined variables are not case-sensitive.

Syntax:

%variable_name%

where variable_name is the name you give the variable when you define it. Spaces cannot be used in variable names. Use hyphens (-) or underscores (_) to separate words.

Variables defined in the Subscriber object are simple text substitutions. Text entered for the value of the variable will be substituted for the variable name.