Appendix F: Options, Macros, Classes, Headers, Mailers and Rules

Previous Page Next Page

F.3 Defining Macros

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 single-valued macros. Refer to section 6.4 Defining Macro Classes for information on how to define class macros.

Modifying the macro 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:

Undisplayed Graphic

Figure F.6: 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:

Undisplayed Graphic

Figure F.7: UCMCON's Configuration menu.

Select the "Macros" menu option and press <Enter>. You will then be presented with a list of the currently defined macros, similar to the following:

Undisplayed Graphic

Figure F.8: UCMCON's currently-defined macros.

Use the <Up>, <Dn>, <PgUp> and <PgDn> keys to scroll through the list of currently-defined macros. If the macro you wish to modify is not listed, press <Ins> to display a list of the undefined macros. You will be presented with a screen similar to the following:

Undisplayed Graphic

Figure F.9: UCMCON's undefined macros.

If the macro you wish to modify was not available in the list of currently-defined macros, then select it from the list of undefined macros and press <Enter>. You will be allowed to modify the macros immediately. Press <Esc> to end the editing session. The macro will then be displayed in the list of currently-defined macros as shown in Figure F.8.

To remove a macro from the list of defined macros, select it and press <Del>.

Macro 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 macros within their definitions. The data you enter will be determined by the macro being defined.

There are two groups of macros: those reserved by the system, and those for use by the administrator. Lower-case macros are always reserved, and are fairly standard among the various versions of SENDMAIL. Upper-case macros have common uses, but are not reserved by the system. You can modify them, although it is highly recommended that you not do so.

Macros can be "tested" using conditionals, thereby allowing you to build a macro that contains other macros only if they contain data. Macros can be tested using "$?" for "if", "$|" for "else", and "$." for "end if".

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.

Previous Page Next Page

Copyright 1997 Unoverica Corporation, All Rights Reserved page
Send comments to docs@unoverica.com