Add an alias to an alias database.

Syntax

ALIAS ADD alias-name [alias-value]

Qualifiers	Defaults
/BLOCK_RECEIPTS	/BLOCK_RECEIPTS
/EDIT	None
/EXPAND	/NOEXPAND
/FAX_ADDRESS	/NOFAX_ADDRESS
/LIST	None
/LOG	/NOLOG
/MAIL_ADDRESS	/MAIL_ADDRESS
/NOWILD	None
/PASS_RECEIPTS	/BLOCK_RECEIPTS
/PRIVATE	/PRIVATE
/PUBLIC	/PRIVATE

Parameters

alias-name

Name of the alias to add. Alias name may not contain wild cards.

alias-value

Translation value of the alias. This parameter may only be omitted when /EDIT or /LIST is specified.

Description

The ALIAS ADD command will add an alias with the specified name and translation value to the currently open alias database. If no database is open, then your personal alias database will be opened and the alias added to it.

If an alias with the same name already exists, then an error will be signalled and no change made to the database. Use the ALIAS MODIFY command to change the translation value of an existing alias; the ALIAS DELETE command may be used to remove existing aliases from the database.

When /LIST is specified and a mailing list reference is given for alias-value, the editor will be invoked to compose or modify the mailing list file. If the alias-value parameter is omitted, then the mailing list file name will be derived from the alias name:

device:[directory]alias-name.DIS

where device and directory are your login device and directory.

When /EDIT is specified, the editor will be invoked to compose the alias translation value, alias-value.

Qualifiers

/BLOCK_RECEIPTS (default)

/NOBLOCK_RECEIPTS

/BLOCK_RECEIPTS disables the passage of requests for delivery and read receipts through to recipients as the alias is expanded. Requests for such receipts are honored at the time the alias expands; in effect the alias is treated as the message destination. The /BLOCK_RECEIPTS and /NOPASS_RECEIPTS qualifiers are synonyms; likewise for the /NOBLOCK_RECEIPTS and /PASS_RECEIPTS qualifiers.

/EDIT

Invoke the editor to compose the alias translation value.

/EXPAND

/NOEXPAND (default)

/NOEXPAND inhibits the expansion of the alias into its component addresses; /EXPAND permits the alias to be replaced with its translation value in the message header. See the description of the /PUBLIC and /PRIVATE attributes for details on the possible appearance of the alias in the message header.

/FAX_ADDRESS

/NOFAX_ADDRESS (default)

Mark the alias translation value as being a PMDF-FAX address.

/LIST

Invoke the editor to compose a mailing list distribution file.

/LOG

/NOLOG (default)

Display a status message reporting the addition of the new alias.

/MAIL_ADDRESS (default)

/NOMAIL_ADDRESS

Mark the alias translation value as being an e-mail address.

/PASS_RECEIPTS

/NOPASS_RECEIPTS (default)

/PASS_RECEIPTS enables the passage of requests for delivery and read receipts through to all recipients as the alias is expanded. Note that allowing the passage of such a request to a large distribution list may result in a lot of return mail. Consequently, receipts should never be allowed to pass through to distribution lists. The /PASS_RECEIPTS and /NOBLOCK_RECEIPTS qualifiers are synonyms; likewise for the /NOPASS_RECEIPTS and /BLOCK_RECEIPTS qualifiers.

/PRIVATE (default)

/NOPRIVATE

Mark the alias as being private. Other users will not be able to use the alias. If the alias appears in outgoing mail (and is not expanded into its component addresses) it will appear as an unexpanded RFC 822 group address: alias: ;. When the alias is marked /EXPAND, the /PRIVATE and /NOPRIVATE qualifiers have no effect. The /PRIVATE and /NOPUBLIC qualifiers are synonyms; likewise for the /NOPRIVATE and /PUBLIC qualifiers.

/PUBLIC

/NOPUBLIC (default)

Mark the alias as being publicly accessible. Other users may reference the alias by sending mail to an address of the form user+alias@local-host. When the alias is used in outgoing mail and is not expanded into component addresses (/NOEXPAND), it will appear in the message in the form user+alias@local-host. When the alias is marked /EXPAND, the /PUBLIC and /NOPUBLIC qualifiers have no effect. The /PUBLIC and /NOPRIVATE qualifiers are synonyms; likewise for the /NOPUBLIC and /PRIVATE qualifiers.

/NOWILD

Treat the wild card characters * and % as being literal asterisks and percent signs. If the alias name contains either of these two characters and /NOWILD is not specified, then an error will be signalled and no entry in the database made.

Examples

In the following example the alias "mro" is created for the address mrochek@example.com. After establishing this alias, mail addressed to mro will be sent to mrochek@example.com.

EMAIL> ALIAS ADD MRO MROCHEK@EXAMPLE.COM %EMAIL-E-NODBOPEN, no database file open %EMAIL-S-CREATED, D1:[BECKETT]ALIASES.DAT;1 created EMAIL> ALIAS SHOW Alias Value -------------------------------- ------------------------------------ mro mrochek@example.com EMAIL> SEND To: MRO Subject: You're in the dog house now! Enter your message below. Press CTRL/Z when complete, or CTRL/C to quit: Mrochek, ... CTRL/Z EMAIL>

In the above example, note that although the alias name and value were entered in uppercase characters, they were stored in lowercase. If the case of the translation value, here mrochek@example.com, is important then quote the translation value when entering it:

EMAIL> ALIAS ADD SUE "Sue@VAXA.Eng.Example.CT.US" EMAIL> ALIAS SHOW Alias Value -------------------------------- ------------------------------------ mro mrochek@example.com sue Sue@VAXA.Eng.Example.CT.US EMAIL>