Unoverica Message Transport uses special variables that are used throughout the mail system. These variables define elements such as the hostname of the local system, the address to use when returning undeliverable mail, etcetera.
There are two types of variables used by Unoverica Message Transport. "Macros" define single-valued variables that only contain a single piece of information. "Class Macros" define multi-valued variables that can contain many pieces of information. This section only discusses the multi-valued class macros. Refer to section 6.3 Defining Macros for information on how to define the single-valued macros.
Modifying the class variables is achieved through the use of Unoverica Message Transport’s UCMCON.NLM management tool. UCMCON.NLM is a NetWare Loadable Module that runs on the NetWare server. To load UCMCON, type the following command at the NetWare console prompt:
:LOAD UCMCON <Enter>
You will be presented with a screen similar to the following:
Figure F.12: UCMCON's main menu.
Select the "Configuration" menu item and press <Enter>. You will then be presented with a set of configuration menu choices similar to the following:
Figure F.13: UCMCON's Configuration menu.
Select the "Classes" menu option and press <Enter>. You will then be presented with a list of the currently defined classes, similar to the following:
Figure F.14: UCMCON's currently-defined classes.
Use the <Up>, <Dn>, <PgUp> and <PgDn> keys to scroll through the list of currently-defined classes. If the class you wish to modify is not listed, press <Ins>. You will be presented with a menu option to either create a new class, or to add a new value to the current class, similar to the following:
Figure F.15: UCMCON's new class menu.
If you wish to add a new value to the currently-selected class, select the "Add to Current Class" menu option and press <Enter>. You will then be presented with a form for modifying the new class value. Pressing <Esc> will return you to the list of defined classes, and your new value will be displayed.
If you wish to add a new class, select the "Add to New Class" menu option and press <Enter>. Select the class you wish to modify from the list of undefined classes and press <Enter>. You will be allowed to modify the macros immediately. Press <Esc> to end the editing session. The class will then be displayed in the list of currently-defined options as shown in Figure F.14.
To remove a class or a value from the list of defined classes, select it and press <Del>.
Class values can have a variety of different data types, depending on the function they serve. They can accept ASCII strings (useful for entering file and directory names), numbers, mixed strings of text and numbers, or they can contain other classes or macros within their definitions. The data you enter will be determined by the class being defined.
Unlike macros, where several variables are pre-defined by the system automatically, there is only one pre-defined class: $w. The $w class contains all of the hostnames that the local system can go by. The $w class array typically includes "localhost", the hostname alone, and the fully-qualified hostname (which contains the hostname and the domain name together). Although you cannot remove any of these pre-defined values, you can add to them, providing additional hostnames and domain names to the $w class array.
In addition to the system-defined class $w, you can also incorporate many user-defined classes for your own use. These class macros can then be used by other class macros in the system for whatever purpose you choose.
Some of the user-defined classes are used by other parts of the Unoverica Message Transport mail system already, and should not be modified without understanding their impact. Figure F.16 below lists the user-defined classes that are already used by Unoverica Message Transport.
|
Class |
Description |
|
$. |
the class containing only a dot |
|
$O |
characters which indicate non-local mail recipient |
|
$P |
names of top-level networks |
|
$w |
all hostnames for the local system |
Figure F.16: User-Defined Class Macros Reserved by Unoverica Message Transport
WARNING: Making changes to the Unoverica Message Transport system may cause the mail system to function improperly, resulting in lost or corrupted mail messages. Unoverica Corporation will not be liable for any problems resulting from the unauthorized use of these advanced configuration options.
Copyright 1997 Unoverica Corporation, All Rights Reserved page
Send comments to docs@unoverica.com