PMDF User's Guide
OpenVMS Edition


Previous Contents Index


SEND- Send a mail message

Sends a mail message using PMDF.

restrictions

None.

Syntax

PMDF SEND message-file-spec[,...] recipient-address[,...]

Qualifiers Defaults
/ABORT See text
/COMMENTS=comment None
/DELIVERY_RECEIPT_TO None
/ERRORS_TO=address None
/EXPAND_LIMIT=limit None
/EXTRA=header_line None
/FAX See text
/FROM=address See text
/HEADERS /NOHEADERS
/IGNORE See text
/IMPORTANCE=importance None
/KEYWORDS=keywords None
/LOG=log-list /NOLOG
/MULTIPART None
/ORGANIZATION=organization None
/PRIORITY=priority None
/READ_RECEIPT_TO None
/REFERENCES=references None
/REPLY_TO=address None
/RETURN_ADDRESS=address See text
/RFROM=address None
/RREPLY_TO=address None
/SENSITIVITY=sensitivity None
/SUBADDRESS=subaddress None
/SUBJECT=subject None
/USER=username See text
/WARNINGS_TO=address None
/X_PS_QUALIFIERS=qualifiers None
Positional Qualifiers Defaults
/BCC /TO
/CC /TO
/ENCODING=encoding See text
/FILENAME=name /NOFILENAME
/MODE=mode /MODE=TEXT
/TO /TO

prompts

Message file: message-file-spec[,...]
Address: recipient-address

Parameters

message-file-spec[,...]

One or more files to comprise the message; wildcards are not allowed. Each file is included in the mail message as a separate part.

recipient-address

The recipients who are to receive copies of the message. Standard RFC 822 format addresses must be used. Quoting might be needed to preserve case and special characters. This parameter is optional when the /FAX qualifier is used.

Description

The SEND utility provides a simple easy-to-use interface to PMDF for sending messages.


Qualifiers

/ABORT

By default, if an error occurs while processing an input message file or recipient address, PMDF SEND will ask the user whether or not to send the message anyhow. If the /ABORT qualifier is specified, then PMDF SEND will merely exit (with an error) when a problem occurs during file or address processing. The /ABORT and /IGNORE qualifiers are mutually exclusive --- only one or the other can be used.

/BCC

Positional parameter which can be used to specify that the given recipient address, and subsequent recipient addresses, should be treated as Bcc: addresses. By default, recipient addresses are interpreted as To: addresses.

/CC

Positional parameter which can be used to specify that the given recipient address, and subsequent recipient addresses, should be treated as Cc: addresses. By default, recipient addresses are interpreted as To: addresses.

/COMMENTS=comments

This qualifier can be used to specify the contents of the Comments: header line. If this qualifier is not used, any existing Comments: header line is used; if none exists no Comments: header line will appear in the outgoing message unless the PMDF_COMMENTS logical is defined.

/DELIVERY_RECEIPT_TO=address

This qualifier can be used to specify the contents of the Delivery-receipt-to: header line. If this qualifier is not used, any existing Delivery-receipt-to: header line is used; if none exists, no Delivery-receipt-to: header line will appear in the outgoing message.

/ENCODING=encoding

Specify the encoding method to use to encode an input message file. Normally, no encoding is used; however, this depends upon the file type as determined by the file extension. The available encoding methods are BASE32, BASE64, CBASE64 (compressed base64), BASE85, BINHEX, BTOA HEXADECIMAL, PATHWORKS, QUOTED_PRINTABLE, UUENCODE, and CUUENCODE (compressed UUENCODE). No encoding can be specified for a file containing header information (/HEADERS).

/ERRORS_TO=address

This qualifier can be used to specify the contents of the Errors-to: header line. If this qualifier is not used, any existing Errors-to: header line is used; if none exists no Errors-to: header line will appear in the outgoing message unless the PMDF_ERRORS_TO logical is defined.

/EXPAND_LIMIT=limit

If, during the process of expanding the message's recipient addresses, the count of recipients exceeds the specified limit then the address expansion will be deferred. PMDF SEND will expand the addresses "off-line" so that the user need not wait.

/EXTRA=header_line

Additional header lines can be specified with the /EXTRA qualifier. Specify the entire text of the header line; e.g., /EXTRA="X-Sign: Aquarius". Multiple header lines should be specified using the format /EXTRA=(hdr1,hdr2,...).

/FAX

When the /FAX qualifier is specified, the pop-up FAX addressing form is invoked. The message being sent will be sent to the addresses specified via pop-up form as well as any additional addresses specified with the recipient address parameter.

/FILENAME=name

/NOFILENAME (default)

This positional qualifier, when specified, causes the name of the input file to be included as a parameter to the associated MIME Content-type: header line. You can specify the name to be included in the header line, or if you do not specify a name, by default the name of the input file will be used.

/FROM=address

This qualifier can be used to specify the contents of the From: header line. If this qualifier is not used, any existing From: header line is used; if none exists and the PMDF_FROM logical is not defined, then a From: header line will be constructed from the username of the user invoking SEND and from the local host name. Note that even if a From: address is provided your address will appear in a Sender: header line.

/HEADERS

/NOHEADERS (default)

The input message is assumed to have no header attached to it by default. The /HEADERS qualifier tells SEND that a header is already attached to the message; it is modified and used to form the header for the message that is actually sent.

/IGNORE

By default, if an error occurs while processing an input message file or recipient address, PMDF SEND will ask the user whether or not to send the message anyhow. If the /IGNORE qualifier is specified, then PMDF SEND will not ask the user whether or not to send the message --- it will send the good input files to the good recipient addresses. The /ABORT and /IGNORE qualifiers are mutually exclusive --- only one or the other can be used.

/IMPORTANCE=importance

This qualifier can be used to specify the contents of the Importance: header line. If this qualifier is not used, any existing Importance: header line is used; if none exists no Importance: header line will appear in the outgoing message unless the PMDF_IMPORTANCE logical is defined.

/KEYWORDS=keywords

This qualifier can be used to specify the contents of the Keywords: header line. If this qualifier is not used, any existing Keywords: header line is used; if none exists no Keywords: header line will appear in the outgoing message unless the PMDF_KEYWORDS logical is defined.

/LOG=log-list

Specify what sort of informational message PMDF SEND should issue. The log-list is a list of zero or more of the following: NONE, ADDRESSES, FILES, MESSAGES, IDS, or ALL. NONE indicates no logging, is equivalent to /NOLOG, and is the default. ADDRESSES causes one informational message to be output for each specified recipient address. FILES causes one information message to be output for each input file. MESSAGES produces a summary message that indicates how many addresses and files were processed successfully. IDS produces an informational message showing the contents of the Message-Id: header of the resulting message. ALL activates all forms of logging; it cannot be specified simultaneously with NONE. /LOG=MESSAGES is the default if /LOG is specified without an explicit log-list.

/MODE=mode

Specify the file access mode to use when reading an input message file. By default, input files are read in text mode. The access modes are TEXT, RECORD, CRATTRIBUTE, LFATTRIBUTE, CRLFATTRIBUTE, and BLOCK. A file containing header information must be accessed using TEXT mode.

/MULTIPART

This qualifier may be used to tell pmdf send to always format the messages it sends as multipart MIME messages.

/ORGANIZATION=organization

This qualifier can be used to specify the contents of the Organization: header line. This qualifier is ignored if an Organization: header line is already present. If this qualifier is not specified or negated no Organization: header line is added unless the PMDF_ORGANIZATION logical is defined.

/PRIORITY=priority

This qualifier can be used to specify the contents of the Priority: header line. If this qualifier is not used, any existing Priority: header line is used; if none exists no Priority: header line will appear in the outgoing message.

/READ_RECEIPT_TO=address

This qualifier can be used to specify the contents of the Read-receipt-to: header line. If this qualifier is not used, any existing Read-receipt-to: header line is used; if none exists, no Read-receipt-to: header line will appear in the outgoing message.

/REFERENCES=references

This qualifier can be used to specify the contents of the References: header line. If this qualifier is not used, any existing References: header line is used; if none exists no References: header line will appear in the outgoing message unless the PMDF_REFERENCES logical is defined.

/REPLY_TO=address

This qualifier can be used to specify the contents of the Reply-to: header line. If this qualifier is not used, any existing Reply-to: header line is used; if none exists no Reply-to: header line will appear in the outgoing message unless the PMDF_REPLY_TO logical is defined.

/RETURN_ADDRESS=address

Specify the address to be used as the envelope originator address. If the message is returned as undeliverable by the mail system transport the nondelivery notice is normally sent to this address.

/RFROM=address

This qualifier can be used to specify the contents of the Resent-From: header line. If this qualifier is not used, any existing Resent-From: header line is used; if no such header line exists no Resent-From: header line will be attached to the outgoing message.

/RREPLY_TO=address

This qualifier can be used to specify the contents of the Resent-Reply-to: header line. If this qualifier is not used, any existing Resent-Reply-to: header line is used; if no such header line exists no Resent-Reply-to: header line will be attached to the outgoing message.

/SENSITIVITY=sensitivity

This qualifier can be used to specify the contents of the Sensitivity: header line. If this qualifier is not used, any existing Sensitivity: header line is used; if none exists no Sensitivity: header line will appear in the outgoing message unless the PMDF_SENSITIVITY logical is defined.

/SUBADDRESS=subaddress

Specify a subaddress to attach to the envelope From: address; e.g., if the envelope From: address is rex@example.com then specifying /SUBADDRESS="Postmaster" would result in the envelope From: address rex+Postmaster@example.com.

/SUBJECT=subject

This qualifier can be used to specify the contents of the Subject: header line. If this qualifier is not used, any existing Subject: header line is used; if none exists no Subject: header line will appear in the outgoing message.

/TO

Positional parameter which can be used to specify that a given recipient address should be treated as a To: address, which is the default interpretation.

/USER=username

Specify the local username to use in the message sender's address; (this will be the From: address if no other From: address is given and the Sender: address otherwise). You must either have WORLD privilege or hold the PMDF_WORLD or PMDF_WORLD_username rightslist identifier in order to use this qualifier and specify a username other than your own. The special case of a blank string will not insert any Sender: information.

/WARNINGS_TO=address

This qualifier can be used to specify the contents of the Warnings-to: header line. If this qualifier is not used, any existing Warnings-to: header line is used; if none exists no Warnings-to: header line will appear in the outgoing message unless the PMDF_WARNINGS_TO logical is defined.

/X_PS_QUALIFIERS=qualifiers

This qualifier can be used to specify the contents of the X-ps-qualifiers: header line. If this qualifier is not used, any existing X-ps-qualifiers: header line is used; if none exists no X-ps-qualifiers: header line will appear in the outgoing message unless the PMDF_X_PS_QUALIFIERS logical is defined.

EXAMPLES

#1

$ PMDF SEND/SUBJECT="Test message" MSG.TXT "BOB@EXAMPLE.COM"
      

This command will send as a mail message the contents of the file MSG.TXT to the address BOB@EXAMPLE.COM. The Subject: line of the message will read "Subject: Test message".

#2

$ PMDF SEND/SUBJECT="Test message" -
_$         /EXTRA=("X-Favorite-Drink: Hot chocolate",-
_$         "X-IQ: 20/20") MSG.TXT "BOB@EXAMPLE.COM"
      

Send a message to BOB@EXAMPLE.COM with the header lines


Subject: Test message 
X-Favorite-Drink: Hot chocolate 
X-IQ: 20/20 
(Of course, these will not be the only header lines present.)

#3

$ PMDF SEND/HEADERS MSG.TXT "BOB@EXAMPLE.COM"
      

Send a message to BOB@EXAMPLE.COM. By using the /HEADERS qualifier, MSG.TXT is assumed to already contain the headers for the message as well as the body.


Previous Next Contents Index