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.