Address, a Pegasus Mail Utility

Address is a utility to build and maintain files used with Mercury and Pegasus Mail in a Novell bindery environment. (Updated August 29, 2000)

Contents

What's new?

What is the purpose of the program?

How is Address typically used?

Requirements

Program Features

File name and login screen

Extended Information Screen

Addressbook Information Screen

Synonym and Alias Information Screen

Common Screen Elements

Command Line Options

Menu Options


What does the program do?
What is the purpose of the program?

Address can edit bindery mode "Extended Rights" for an individual user, selected users, an entire server, or a group of servers.

Address can directly build Address book files for Pegasus Mail using the "Full Name" field in the Novell bindery, while maintaining personal user information from previous addressbooks.  The program will also set user configurable options, such as sort by key, paste address, or resolve alias.

Address can directly create the Mercury "Synonym" and "Alias" files during addressbook generation.  These files are created for each user who has their "Internet Synonym" set in Extended Options.  In addition, the program will import a standard alias source file, and include them with the generated aliases.

Address can run tasks automatically from the command line.


How is Address typically used?

In an environment with multiple Novell servers and hundreds of users, a central addressbook is very helpful to find user addresses.  If Mercury is used, alias and synonym files based on the same users are needed.

Address will help by performing these tasks:

Editing or clearing a single user's Extended Rights

Editing or clearing a selected user's Extended Rights

Setting Extended Rights for an entire server.

Setting Extended Rights for multiple servers.

Building an addressbook from "Full Name" data in the bindery for multiple servers.

Automatically setting Pegasus options on generated addressbooks.

Building a Mercury synonym file based on "Full Name" and extended options settings during addressbook generation.

Building a Mercury alias file based on "Full Name" and extended options settings, along with extra aliases from an alias source text file during addressbook generation


Requirements
Program Requirements

The operating system must be Windows 95 or higher.

The program requires less than one meg of disk space.

Any hardware capable of running Windows 95 is sufficient to run Address.

The Pegasus and Mercury environment must be Novell bindery-mode.  The program will not be much help with other environments.


The Pegasus and Mercury environment is Novell© bindery-mode with multiple servers. Program Overview
Program Overview

Address has two main functions: Setting extended options and building Mercury/Pegasus files.  These functions can be launched from the command line.

Extended Options features:

Edit or clear a single user's Extended Rights.

Set Extended Rights for an entire server.

Set Extended Rights for multiple servers.

Specify users to skip on servers.

Automatically generate Internet addresses from "Full Name" in the bindery.

Addressbook Features:

Automatically build an addressbook from "Full Name" data in the bindery for multiple servers.

Automatically set addressbook options on generated addressbooks.

Build a Mercury synonym file based on "Full Name" and extended options settings during address generation.

Building a Mercury alias file based on "Full Name" and extended options settings during addressbook generation.

Include additional aliases from an alias source text file while creating alias file.

Copy individual personal information from prior addressbooks to the new addressbook.

Copy generated addressbooks to multiple servers.

Specify users to skip on servers.


File name and login screen

This "Filenames & Logins" screen set the destination for generated files, and accepts the Novell login and password.

Field Descriptions.

Filename for Program Settings

This field is set after a "File, Open Settings" or a "File, Save Settings" and shows the filename of the current program settings file.  Most program options are saved with a File, Save command.  The option setting file is a text file stored in "INI" format.

Addressbook Name

This field is used to name the new addressbook.  ".PMR" is automatically appended to this filename.  Setting this field will automatically set the synonym and alias file name, if they are blank.

Alias Name

This is the file name of the new alias file.  Don't include the path; that's set later in the "Mercury Directory" field.  Setting this field will automatically set the synonym and addressbook file name, if they are blank.

Synonym Name

This is the file name of the synonym file.  As with the alias file name, use only the file name, not the full path name.  Setting this field will automatically set the addressbook and alias file name, if they are blank.

Addressbook Destination

This radio box will set the where the addressbook is sent.  Selecting "Send new addressbook to target directories on all selected servers" will direct Address to copy the new addressbook to every server in the "Selected File Servers" list.

Selecting "Send single copy of new addressbook to the synonym directory" will place a single copy of the addressbook in the Mercury destination directory. This setting will allow you to test the addressbook before sending it to every server.

Pegasus Directories on Servers for Addressbooks

If you choose to send the addressbook to multiple servers, this is the directory where the addressbook will be copied on each server.  This directory should already exist.

Mercury Directory for Alias and Synonym Files

If Mercury files will be built along with the addressbook, this is where they will be written.  The addressbook files will go here, if "Send single copy of new addressbook to the synonym directory" is selected.

Read-Write Account and Password

This is the Novell account used to write addressbook files back to each server in the "Selected File Servers" list.  This account should have full write access directory specified in "Pegasus Directories on Servers for Addressbooks".

Read-only Account and Password

This is the Novell account that will be used to gather information for the addressbook.  This account needs a minimal level of access - only enough rights to login to every server.  The account used in PCONFIG.EXE for Inter-Server communication would be an excellent choice to use here.

A Read-only account is used for information gathering is because some servers may not allow you to have full rights on every directory, but do allow Pegasus inter-server communication.

Common Screen Elements


Extended Information Screen

This "Extended Rights" screen allows editing of the bindery-based extended rights settings.  It is intended to be convenient alternative to PMGRANT, especially when you have many users to update.

Extended Option fields

Local Auto-Forwarding Address

This extended option forwards mail sent from local address.  You can forward local mail to any address WINPMAIL.EXE can understand including NetWare groups and distribution lists.

This field is called "Forward local mail to:" in Pegasus.  This field is called "Autoforward:" in PMGRANT.

Internet Auto-Forwarding Address

This extended option forwards mail sent from a Mercury gateway.  You can forward Internet mail to simple local addresses or to Internet addresses.  You can NOT use this setting to forward to NetWare groups and distribution lists.

This field is called "Forward SMTP (Internet) mail to:" in Pegasus.  This field is called "Charon autoforward:" in PMGRANT.

Internet Synonym

This field directly sets the extended option for the Internet address.  It is used by ADDRESS to build the Mercury Synonym file and Mercury Alias file.

The Alias file allows multiple incoming Internet mail addresses to go to the same user account.  A synonym is Mercury alias that completely replaces the "From:" address of a user in both incoming and outgoing messages.

This field is called "Address Synonym" in PMGRANT.  It can not be changed from within Pegasus.

Extended Option checkboxes

User can modify Extended Rights

When this is checked, users can modify their extended rights settings through PMGRANT or Pegasus.

This field is called "User can modify" in PMGRANT.  It can not be changed from within Pegasus.

Deliver and forward

This checkbox will cause Pegasus to leave a copy of auto-forwarded messages with the local user.

This is called "Deliver mail even if auto-forwarding" in Pegasus.

Will confirm reading

Pegasus will honour mail confirmation requests when box is checked.

This is called "Allow 'confirmation of reading' requests" within Pegasus.

Mail Disabled

Mail will not be accepted for this user when checked.

This is called "Disable mail delivery to this address" within Pegasus.

New Mail Broadcasts

When checked, Pegasus will send a Novell NetWare broadcast message advising the user when new mail has been received.

This is called "Advise of new mail via broadcasts" in Pegasus.

Automatic Synonyms

Automatically Generate Internet Synonym

When checked, this will cause ADDRESS to automatically generate an Internet address and place it in the Internet synonym field when setting extended options for a user.

The generated address will consist of the account's Novell "Full Name" field appended to the domain set in the next field.  The "Full Name" will be set to lower case and spaces will be replaced with periods.

Domain for use in Generated Synonym

This field supplies the domain name to use when automatically generating Internet synonyms for a user's extended options.

User and Server selection

Current Server

This contains the name of the server to be displayed.  The name may be typed directly, or dragged from the "Selected Servers" or "Available Servers" list box.

The "Users" list box will be updated when this field changes.

Users

This list box contain the list users on current server who can use Pegasus.  The users must be in Novell group "EVERYONE".  A user will be skipped if they are in the Novell group "NOMAIL" or if a regular expression in the "Users to Skip" list matches their login.

Multiple users can be selected from this list box, for use with the "Clear User Option" and "Set User Option" buttons.

Every account in this list will be used when the "Set Current Server" and "Set Selected Servers" buttons are used.  (Assuming their server is on the appropriate list box)

Common Screen Elements

Action Buttons

Clear User Options

This clears the extended options for the account.  It is the equivalent of the "PMGRANT -d" command.

Select multiple accounts in the "User" list to clear them all at one time.

Set User Options

Click this to set extended options for the selected accounts.  Any existing settings will be replaced.

Checking the "Automatically Generate Internet Synonym" check box will override the value set in the "Internet Synonym" field.

Select multiple accounts in the "User" list to set them all at one time.

Set Current Server

Click this to set extended options for all of the accounts on the current server.

A user will be set if the user is in the Novell group EVERYONE.  A user will be skipped if they are in the Novell group NOMAIL or if a regular expression in the "Users to Skip" list matches their login.

The Internet Synonym will only be set if the user is in Novell group "GW_USERS".

Set Selected Server

Click this to set extended options for all of the accounts on all of the selected servers.


Addressbook Information
Addressbook Information Screen

Address Book Options

Address Book Description

This field will be the internal description for the new address book.

Sort Option

This sets the default sort order of the address book to "Name" or "Key".

Paste Option

This sets whether address or name will be pasted when the address book is used inside of Pegasus.

Alias Option

This option sets whether Pegasus will use this address book to convert to names to email addresses.

Put Generated Internet Address in Address Book Notes

This option puts the Internet address (taken from the Internet synonym in extended options) in the "notes" field of the address book.

This allows users to easily see their Internet address.

Directory of Reference Address Book

This is the directory that contains a prior address book.  ADDRESS will read the old address book, and transfer personal information to the new address book.

Common Screen Elements

Action Buttons

Build Address Book

This button will start the address book generation process.  The program will scan the bindery for each selected server and include users who meet the selection criteria.

A user will be selected for inclusion in the address book if the user is in the Novell group EVERYONE.  A user will be skipped if they are in the Novell group NOMAIL or if a regular expression in the "Users to Skip" list matches their login.

If "Build Mercury Alias & Synonym Files while building Addressbook?" is checked on the Synonym & Aliases tab, the alias file and synonym file will be also be built at this time.  A user must be in the Novell group "GW_USERS" to be included in the alias and synonym files.

The status line will display the current server and user being processed.  A period will be displayed on the status bar when a user is skipped.


Synonym and Alias Information Screen

Create Additional Aliases by subsistuting delimiters

Creates additional aliases by varying the delimiters uses in names.  For instance, for the user john.doe@mail.com, these additional aliases would be created: john-doe@mail.com, john_doe@mail.com, and johndoe@mail.com.

Build Mercury Synonym and Alias Files building Address Book

Checking this box will cause ADDRESS to create the Synonym file and Alias file while creating the address book.

Additional Aliases Source File Name

This contains the filename of Alias Source File.

Edit Additional Aliases Source File

This field allows you to add additional Aliases beyond those automatically generated.

The Alias Source File follows the same format as the alias files used by Mercury's MALIAS.EXE.

Action Buttons

Read Aliases

This starts a dialog box to open the Alias Source File.

Save Aliases

This dialog box will save the Alias Source File.


Command Line Options

-O filename

Read in a "options settings" file.  This is the same as clicking File, Open Settings.

-A

Build an addressbook.  This is the same as clicking the "Build Address Book" button.  This must be used with the "-O" option to operate.

-E

Set extended options.  This is the same as clicking the "Set Selected Servers" button.  This must be used with the "-O" option to operate.


Menu Options

File Options

Open Settings

Open an option settings file, and restore the previous options.

Save Settings

Most program options are saved with a File, Save command.  The option setting file is a text file stored in "INI" format.

Exit

Shut down the program.  If you have modified any fields without saving, ADDRESS will prompt you to save the files.


Common Screen Elements

Users to Skip

This is the list of accounts that should not be processed.  The entries in this list are regular expressions.

For instance, adding the user "Backup" to this list will preclude processing the "Backup" account on every server, as the accounts that contain "backup" embedded within, such as "MrBackup".  Adding the "DP/Backup" will only skip the account on the "DP" server.  Using "./backup" will skip it on every server.

User names may be dragged here from the "User" list box on the "Extended Options" tab.

Selected File Servers

This list box selects the servers to be processed when building addressbooks or setting extended options on selected servers.

Servers are added and removed from this list box by dragging them to and from the "Available File Servers" list box.

Available File Servers

This list box shows the available servers on your network.

Servers on this list can be dragged to and from the "Selected File Servers" list box.

Attached File Servers

This shows the servers attached to this workstation when the program was started.  ADDRESS will use these existing connections for these servers.

Make sure you have sufficient rights on these file servers.

Due to limitations in the Novell requestor, you may have problems if eight or more servers are in this list.


Extended Rights

Extended Rights are a set of options used by Mercury and Pegasus Mail.  For bindery based Pegasus users, Extended Options are stored in the Novell bindery with login account information.


Address Books

Pegasus Address Books serve two uses: They provide a quick method to look up e-mail addresses and they create alternate names to use in place of e-mail addresses.

Address Books are stored in two files, a data file (.PMR) and an index file (.PM!).

Address Books stored in the same central network location as WINPMAIL.EXE become "system-wide".  Everyone who runs WINPMAIL.EXE from the central location can use the system-wide address book.

Address Books in a user's mail directory are called local.  Local and system-wide address books may have the same name, but the options set for the system-wide address book will take precedence.


Alias Files for Mercury

The Alias file translates incoming Internet mail addresses to another Internet mail address.  You must be using Mercury to use Alias files.

These are typically used to link a generic e-mail address to a specific user.  For instance, an alias of " helpdesk@my.domain == heywood.yabuzzoff@my.domain " would redirect mail sent to helpdesk to Mr. Yabuzzoff.

At my site (a multi-server, Novell bindery based environment), Mercury requires alias files, along with Synonym files, to deliver mail to local users.  Address will generate the alias and synonym files automatically, if requested.


Synonym Files for Mercury

The Synonym file is used by Mercury to replace the "From:" address of a user in an outgoing Internet message.

The value found in that Extended Rights field "Internet Synonym" is used to build the Synonym file.

Address will generate the synonym file automatically, if requested.


Full Name

This is the name seen in Novell login scripts that greet you with "Good Morning" or "Good Afternoon".  Address reads this field from the Novell bindery and uses it when building addressbooks, alias files, and synonym files.


Regular Expressions

Regular Expressions are used for pattern matching.  Here are the meta-characters to use with regular expressions:

.	Match anything

[]	Encloses a character set, such as [aeiou], [0-9], or [~0-9]

^	Beginning of a line

$	End of a line

\	Quote char, to allow searching for meta-characters

*	Repeat 0 or more times

+	Repeat 1 or more times

Here are some examples:

.	Matches everything

.a.	Matches "cat" and "hat" but not "ape".

c[au]p	matches "cap" and "cup", but nothing else.


What's new?

August 29, 2000

Generate additional Aliases

Address can now generate additional aliases.  For instance, if the user is john.doe@mail.com, then john-doe@mail.com, john_doe@mail.com, and johndoe@mail.com would be created as additional aliases.

May 4, 1999

Checks for GW_USER membership

The program now checks for membership in the Novell group "GW_USERS" before setting the Internet Synonym in extended features or including users in alias or synonym files.

Status line changes when skipping users

When skipping a user during processing, the program will append a period to the previous user name on the status line.  This will allow you see some sign of activity when processing a server with a large group of users excluded from Internet mail.