9.2 Types of Variables

There are two types of variables:

9.2.1 Predefined Variables

Predefined variables are created when ZENworks Server Management starts. They are used in Server Software Packages and Tiered Electronic Distribution, 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 Server Management, and the % symbols tell the software that a variable name exists between them. For example:

%WORKING_PATH%

To make a predefined variable useful, its value must be set in the Server Software Package component, or in a Tiered Electronic Distribution object.

The Java environment can use predefined variables, such as SERVER_DN being used in a Java process call in a .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 displays the name of the server.

The Server Management predefined variables listed in Table 9-1 are available:

Table 9-1 Predefined Variables

Variable

Description and Value

BASE_PATH

Location of the Policy Manager:

sys:\zenworks\pds\smanager\

CONF_PATH

Location of configuration files:

sys:\zenworks\pds\ted\

IP_ADDRESS

IP address of a server, such as:

192.68.1.255

LOAD_DIR

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

c:\nwserver

LOG_PATH

Location of log files:

sys:\zenworks\pds\smanager\

PLUGINS_PATH

Where the Server Management plug-ins were installed:

sys:\zenworks\pds\smanager\plugins\

POLICY_PATH

Where the policy files (.pol) are stored:

sys:\zenworks\pds\smanager\policy\

PROP_PATH

Where Novell eDirectory™ object properties are stored:

sys:\zenworks\pds\smanager\prop\

SERVER_DN

Distinguished server name in eDirectory, such as:

server01.servers.novell

SERVER_NAME

Name given the server when NetWare was installed, such as:

server01

TED_PATH

Path to the …\ted directory:

sys:\zenworks\pds\ted\

TREE_NAME

Name of the eDirectory tree where Server Management servers reside. This is established during installation.

VOL

Default volume:

sys:

WORKING_PATH

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

sys:\zenworks\pds\smanager\working\

ZWS_PATH

Where the ZENworks Web Server files are located:

sys:\zenworks\zws\

ZWS_PROP_FILE_PATH

Where the ZENworks Web Server property files are located:

sys:\zenworks\zws\

ZWS_SECURITY_PATH

Where the ZENworks Web Server security files are located:

sys:\zenworks\zws\security\

9.2.2 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 is substituted for the variable name.