Add an alias to an alias database.

Syntax

ALIAS MODIFY 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 modify. Alias name may not contain wild cards.

alias-value

New translation value for the alias. This parameter may only be omitted when /EDIT or /LIST is specified.

Description

The ALIAS MODIFY command changes the translation value of an existing alias in the currently open alias database. If no database is open, then your personal alias database will be opened and the alias added to it.

When /LIST is specified and the alias specifies to a mailing list distribution file, the editor will be invoked to modify the distribution file.

When /EDIT is specified, the editor will be invoked to edit the alias translation 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 edit 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 edit a mailing list distribution file.

/LOG

/NOLOG (default)

Display a status message reporting the modification the 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 this alias. If this 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.