Forward a message.

Syntax

FORWARD [file-spec[,...]]

Qualifiers	Defaults
/ABORT	See text
/ALL	/NOALL
/BCC	/NOBCC_PROMPT
/BCC_LIST=address	None
/BCC_PROMPT	/NOBCC_PROMPT
/CC	See text
/CC_LIST=address	None
/CC_PROMPT	See text
/COMMENTS	See text
/CONFIRM	/NOCONFIRM
/DELAY_WARNING	/DELAY_WARNING
/DELIVERY_RECEIPT	See text
/DIGEST=number	None
/EDIT	/NOEDIT
/ENCAPSULATE	/ENCAPSULATE
/ENTIRE	/MESSAGE
/FAX_ROUTING=routing	None
/FROM=address	/NOFROM
/INSERT	See text
/IGNORE	See text
/LAST	/NOLAST
/MARKED	None
/MESSAGE	/MESSAGE
/MULTIPLE	/SINGLE
/PART	/MESSAGE
/PERSONAL_NAME=name	See text
/PRIORITY=priority	See text
/READ	None
/READ_RECEIPT	See text
/REMOVE	/NOREMOVE
/REPLIED	None
/REPLY_TO=address	See text
/RETURN_CONTENT	/RETURN_CONTENT
/SELF	See text
/SENSITIVITY=sensitivity	See text
/SIGNATURE=text	See text
/SUBADDRESS	None
/SUBJECT=subject	See text
/TO	/TO_PROMPT
/TO_LIST=address	None
/TO_PROMPT	/TO_PROMPT
/TRIM_HEADER	/NOTRIM_HEADER
/USER=username	None

Positional Qualifiers	Defaults
/BLOCK	/TEXT
/EIGHTBIT=option	/EIGHTBIT=LEAVE
/ENCODING=encoding	None
/FILENAME=name	/NOFILENAME
/RECORD	/TEXT
/TEXT	/TEXT

Parameters

file-spec[,...]

Optional list of one or more files to include with the forwarded message.

Description

Either the FORWARD or REDISTRIBUTE command can be used to forward a message to other individuals. However, unlike the REDISTRIBUTE command, the FORWARD command allows you to modify and annotate the message prior to forwarding it.

The forwarded message will be a MIME message with a content type of MESSAGE/RFC822. It will appear as a message which contains a message. The "contained" message is the original message which you forwarded.

Qualifiers

/ALL

/NOALL

Forward all currently selected messages. The messages will be forwarded as a message digest.

/ABORT

/IGNORE

The /ABORT qualifier causes the message forward to fail if any of the To:, Cc:, or Bcc: addresses prove to be illegal. The /IGNORE qualifier permits the message to be forwarded provided that at least one of the addresses is legal. The illegal addresses are ignored and will not appear in the message's header. The default behavior, if neither /ABORT or /IGNORE are specified, is to prompt you when any of the addresses are illegal. You will be given the choice of whether to cancel the forwarding or to go ahead and forward the message to only the legal addresses.

/BCC

/BCC_LIST=address[,...]

/BCC_PROMPT

/NOBCC_PROMPT

By default, you are prompted for Bcc: (blind carbon copy) addresses only when you specify either the /BCC or /BCC_PROMPT qualifier. If you specify /BCC_PROMPT, you will be presented with a Bcc: prompt to which you can specify zero or more Bcc: addresses. Specifying /NOBCC_PROMPT inhibits Bcc: prompting. You can use the /BCC_LIST qualifier to specify one or more Bcc: addresses on the FORWARD command line itself. The /BCC qualifier is an abbreviation for /BCC_PROMPT.

/CC

/CC_LIST=address[,...]

/CC_PROMPT

/NOCC_PROMPT

By default, you are prompted for Cc: (carbon copy) addresses only when you have previously used the SET CC_PROMPT command. The /CC_LIST, /CC_PROMPT, and /NOCC_PROMPT qualifiers override this behavior. If you specify the /CC_PROMPT qualifier, you will be presented with a Cc: prompt to which you can specify zero or more Cc: addresses. Specifying /NOCC_PROMPT inhibits Cc: prompting. You can use the /CC_LIST qualifier to specify one or more Cc: addresses on the FORWARD command line itself. The /CC qualifier is an abbreviation for /CC_PROMPT.

/COMMENTS=comment

/NOCOMMENTS

Normally, a Comments: header line is generated only when you have defined the PMDF_COMMENTS logical. If you specify /NOCOMMENTS, then that logical will not be used and no Comments: line will be added to the header of the forwarded message. If, instead, you specify a comment with the /COMMENTS qualifier, then that comment will be placed on a Comments: header line and PMDF_COMMENTS, if defined, will be ignored.

/CONFIRM

/NOCONFIRM (default)

When you specify /CONFIRM, you must approve the inclusion of each selected message in the message digest. That is, for each message to be forwarded, you will be prompted. If you reply to the prompt in the affirmative, then the message will be included in the forwarded message digest; otherwise, it will be skipped.

/DELAY_WARNING (default)

/NODELAY_WARNING

The qualifier controls whether or not PMDF requests that delay notifications be sent in case this message is not delivered immediately. The default is that PMDF requests delay notifications. However, note that some remote mailers cannot support sender specification of whether delay notifications be sent and can unconditionally do one or the other regardless of whatever you request.

/DELIVERY_RECEIPT[=keyword]

/NODELIVERY_RECEIPT

Normally, a Delivery-receipt-to: header line is generated only when you have defined the PMDF_DELIVERY_RECEIPT logical. If you specify /NODELIVERY_RECEIPT, then no Delivery-receipt-to: line will be generated. If, instead, you specify the /DELIVERY_RECEIPT qualifier, then a delivery receipt will be requested of all recipients of the forwarded message, and the PMDF_DELIVERY_RECEIPT logical, if defined, will be ignored. One of the keywords HEADER, NOTARY, or BOTH can optionally be specified to control what style of delivery receipt to construct (header style, NOTARY envelope style, or both, respectively).

/DIGEST=number[,...]

/NODIGEST (default)

Forward the specified messages. The messages will be encapsulated into a single MIME message digest. One or more messages can be specified via their message numbers. Ranges are permitted: /DIGEST=(1,3,6-9,15-20) specifies messages 1, 3, 6 through 9, and 15 through 20. The /ALL qualifier has no effect when used in conjunction with /DIGEST. The /MARKED, /READ, and /REPLIED qualifiers further limit the messages forwarded. See the description of those qualifiers for further details

/EDIT[=option]

/NOEDIT (default)

To edit the message before forwarding it, specify the /EDIT qualifier. The /NOEDIT qualifier prevents an editor from being invoked. By default, an editor is only invoked if, when you ran PMDF MAIL, you specified the qualifier /EDIT=(FORWARD). By default the message's RFC 822 header will also appear in the editor. To suppress the presentation of the RFC 822 header, specify /EDIT=NOHEADER. To request that the header appear in the editor, specify /EDIT=HEADER.

/ENCAPSULATE (default)

/NOENCAPSULATE

Specify whether or not to treat any input files specified with the optional file-spec parameter as separate attachments each encapsulated as a separate message body part.

/ENTIRE

/MESSAGE (default)

/PART

By default, when you forward a multipart or nested message, only the current message part is forwarded. This behavior is explicitly requested with the /MESSAGE qualifier. To forward to the entire message, specify /ENTIRE; to only forward the current part, use /PART. When forwarding a single-part message which is not nested, the /ENTIRE, /PART, and /MESSAGE qualifiers are identical and have no effect.

/FAX_ROUTING=routing

When previewing a received FAX message, you can reroute it to its final destination with this command. See the section "Manual routing of inbound FAXes" in the PMDF-FAX chapter of the PMDF System Manager's Guide for information on the use of this qualifier. It is not intended for use by casual users and requires postmaster privileges to use. No other qualifiers can be specified in conjunction with the /FAX_ROUTING qualifier.

/FROM=address

/NOFROM

When you specify /NOFROM, the PMDF_FROM logical is ignored and a standard From: header line containing your address is generated. When you use /FROM, the specified address is used to construct the From: header line, and your real (authenticated) address is placed in a Sender: header line.

/INSERT

/NOINSERT

The /INSERT qualifier instructs PMDF MAIL to prompt you for additional message text and insert it as an attachment to the message. The additional text, which is composed by hand either through an editor or in response to the "Enter your message below" prompt, appears at the top of the message, with the forwarded message and any attached files appended afterwards.

/LAST

/NOLAST (default)

The /LAST qualifier causes the last message which you sent to be forwarded. /NOLAST selects the default behavior in which the last message read is forwarded.

/MARKED

/NOMARKED

Forward all currently selected messages which are marked. The messages will be forwarded as a message digest. /NOMARKED forwards only those messages which are not marked. When used in conjunction with /DIGEST, only those selected messages which are marked, or not marked, will be forwarded.

/MULTIPLE

/SINGLE (default)

By default, you are prompted only once for each type of recipient address, To:, Cc:, and Bcc:. If you specify /MULTIPLE, then you will be prompted repeatedly for each of these address types. For each type, the prompt will repeat until you enter a blank line. /SINGLE selects the default behavior.

/PERSONAL_NAME=name

/NOPERSONAL_NAME

The /PERSONAL_NAME and /NOPERSONAL_NAME qualifiers override the setting of the SET PERSONAL_NAME command. When you use the /PERSONAL_NAME qualifier, the specified name will be used in the personal name field of your return address. Specifying /NOPERSONAL_NAME prevents any personal name from appearing in your return address.

/PRIORITY=priority

/NOPRIORITY

Normally, a Priority: header line is generated only when you have defined the PMDF_PRIORITY logical. If you specify /NOPRIORITY, then no Priority: line will be generated. If, instead, you specify the /PRIORITY qualifier, then the supplied priority will be included in a Priority: header line. The legal priorities are: NO-PRIORITY, THIRD-CLASS, SECOND-CLASS, NON-URGENT, NORMAL, and URGENT. NO-PRIORITY is equivalent to /NOPRIORITY.

/READ

/NOREAD

Forward all currently selected messages which have been read. The messages will be forwarded as a message digest. /NOREAD forwards only those messages which have not yet been read. When used in conjunction with /DIGEST, only those selected messages which have been read, or not read, will be forwarded.

/READ_RECEIPT

/NOREAD_RECEIPT

Normally, a Read-receipt-to: header line is generated only when you have defined the PMDF_READ_RECEIPT logical. If you specify /NOREAD_RECEIPT, then no Read-receipt-to: line will be generated. If, instead, you specify the /READ_RECEIPT qualifier, then a read receipt will be requested of all recipients of the forwarded message, and any address specified by the PMDF_READ_RECEIPT logical will be ignored.

/REMOVE

/NOREMOVE (default)

When /REMOVE is specified, your address will be removed from the list of recipients even if you explicitly specified your address as a To:, Cc:, or Bcc: address list or have /COPY_SELF enabled for forwarding. Your address will appear in the Cc: list if you specify /SELF.

/REPLIED

/NOREPLIED

Forward all currently selected messages which have been replied to (answered). The messages will be forwarded as a message digest. /NOREPLIED forwards only those messages which have not yet been replied to. When used in conjunction with /DIGEST, only those selected messages which have been replied to, or not, will be forwarded.

/REPLY_TO=address

/NOREPLY_TO

Normally, a Reply-to: header line is generated only when you have defined the PMDF_REPLY_TO logical. If you specify /NOREPLY_TO, then no Reply-to: line will be generated. If, instead, you specify the /REPLY_TO qualifier, then the supplied address will be placed in a Reply-to: header line, and any PMDF_REPLY_TO logical ignored.

/RETURN_CONTENT (default)

/NORETURN_CONTENT

These qualifiers control whether return-of-content is requested for non-delivery reports.

/SELF

/NOSELF

The /SELF and /NOSELF qualifiers override the behavior of the SET COPY_SELF command. /SELF causes a copy of the forwarded message to be sent to yourself; your address will appear in the Cc: header line. When /NOSELF is specified, you will not receive a copy of the message unless you explicitly include your address in the To:, Cc:, or Bcc: address lists.

/SENSITIVITY=sensitivity

/NOSENSITIVITY

Normally, a Sensitivity: header line is generated only when you have defined the PMDF_SENSITIVITY logical. If you specify /NOSENSITIVITY, then no Sensitivity: line will be generated. If, instead, you specify the /SENSITIVITY qualifier, then the supplied sensitivity will be included in a Sensitivity: header line. The legal sensitivities are: NOT-SENSITIVE, PERSONAL, PRIVATE, and COMPANY-CONFIDENTIAL. NOT-SENSITIVE is equivalent to /NOSENSITIVITY.

/SIGNATURE=signature-spec

/NOSIGNATURE

Normally, signature lines are appended to the end of your message only if the PMDF_SIGNATURE logical is defined. When you specify /NOSIGNATURE, no signature lines are included in the forwarded message. When, however, you specify the /SIGNATURE qualifier, then the specified signature is included in the forwarded message. If signature-spec begins with an at-sign, @, then the signature lines are copied from the file name following the at-sign; otherwise, signature-spec itself is appended to the end of the reply.

/SUBADDRESS=subaddress

Attaches a subaddress to your return address.

/SUBJECT=subject

/NOSUBJECT

By default, you will be prompted to supply a Subject: line. /NOSUBJECT suppresses this prompt; no Subject: line will appear in the outer header of the forwarded message. To specify a subject on the FORWARD command line, use the /SUBJECT qualifier.

/TO

/TO_LIST=address[,...]

/TO_PROMPT (default)

/NOTO_PROMPT

By default, you prompted for the To: addresses to which to forward the message. The /NOTO_PROMPT qualifier suppresses this prompting. You can use the /TO_LIST qualifier to specify one or more To: addresses in the FORWARD command line itself. The /TO qualifier is an abbreviation for /TO_PROMPT.

/TRIM

/NOTRIM_HEADER

Controls whether or not headers are trimmed in forwarded messages.

/USER=username

Forward the message as though you are the specified user; that is, the From: address in the forwarded message will be that of the specified user. No Sender: header line is added. Use of this qualifier requires either WORLD privilege or the PMDF_WORLD or PMDF_WORLD_username rightslist identifier.

Positional Qualifiers

/BLOCK

/RECORD

/TEXT

The /BLOCK, /RECORD, and /TEXT positional qualifiers can only be used in conjunction with an input file specification. These qualifiers allow you to override the default file reading (access) mode which PMDF would otherwise use to read the input file. Typically, PMDF uses /TEXT.

/EIGHTBIT=option

/NOEIGHTBIT

Specify how to handle eight bit characters found in an input file (i.e., characters for which the eighth bit is set). The available options are

HEXIFY	Replace each eight bit character with =XX where "XX" is the character's ordinal value expressed in hexadecimal.
LEAVE	Leave eight bit characters untouched. This is the default behavior.
REMOVE	Remove eight bit characters from the message; removed characters are not replaced with anything to indicate their removal or former presence.
REPLACE	Replace each eight bit character with a question mark, "?".
STRIP	Clear the eighth bit in each character of the message; i.e., "strip" the eighth bit from eight bit characters.

The default behavior is /EIGHTBIT=LEAVE. Use /NOEIGHTBIT or /EIGHTBIT=REMOVE to remove all eight bit characters from input files.

/ENCODING=encoding

The /ENCODING positional qualifier can only be used in conjunction with an input file specification. The /ENCODING qualifier allows you to override the default file encoding method which PMDF would otherwise use to encode the input file. The legal encoding types are: NONE, 8BIT, 7BIT, BASE32, BASE64, BASE85, BINHEX, BTOA, HEXADECIMAL, OLD-BASE64 (for use with PMDF V4.0), PATHWORKS, QUOTED-PRINTABLE, UUENCODE, COMPRESSED-BASE64, and COMPRESSED-UUENCODE.

/FILENAME=name

/NOFILENAME (default)

The /FILENAME and /NOFILENAME positional can may only be used in conjunction with an input file specification. When an input file is attached as a separate message body part to the forwarded message, that part's Content-type: header line will, by default, omit the optional file name parameter. This default behavior is explicitly selected with the /NOFILENAME qualifier. When /FILENAME is specified, the name of the input file will be included in the Content-type: header line. If no value is specified on the /FILENAME qualifier, then the name of the input file is used.

Examples

In the following example, the user fresnel@example.com has received a message from rex@example.com. Fresnel then forwards this message, copying herself on the forward, to misha@example.com and beckett@example.com. Compare this example with that shown for the REDISTRIBUTE command.

EMAIL> READ 2 Message MAIL 2 18-FEB-2012 08:27:45.18 Date: Thu, 18 Feb 2012 08:27:45 PDT (1) From: rex@example.com Subject: Mrochek To: fresnel@example.com Have any of you seen Mrochek recently? EMAIL> FORWARD/SELF (2) To: misha@example.com, beckett@example.com (3) EMAIL> New mail on node EXAMPLE from IN%"fresnel@example.com" (4) EMAIL> READ/NEW Message NEWMAIL 1 18-FEB-2012 12:30:10.20 Date: Thu, 18 Feb 2012 12:30:10 PDT (5) From: fresnel@example.com (6) To: misha@example.com, beckett@example.com (7) Cc: fresnel@example.com (6) Message contains multiple parts. Press return to read the next part... EMAIL> [return] (8) Date: Thu, 18 Feb 2012 08:27:45 PDT (9) From: rex@example.com Subject: Mrochek To: fresnel@example.com Have any of you seen Mrochek recently? EMAIL>

The following items of note are called out in the example above:

1. The header of the original message from rex@example.com.
2. The FORWARD/SELF command is issued.
3. The message is forwarded to misha@example.com and beckett@example.com.
4. Fresnel receives her copy of the forwarded message. This copy was requested by the /SELF qualifier in .
5. The date and time at which the message was forwarded.
6. The address of the individual, Fresnel, who forwarded the message.
7. The recipients of the forwarded message. Since Fresnel was copied on the redistribution (/SELF), Fresnel's address also appears in the Cc: header line.
8. The message has an additional part (the forwarded message itself). Fresnel presses the return key to read this additional part.
9. The original message which was forwarded.