Sends a mail message using PMDF.
1 – 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
2 – Prompts
Message file: message-file-spec[,...]
Address: recipient-address[,...]
3 – 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.
4 – Description
The SEND utility provides a simple easy-to-use interface to PMDF
for sending messages.
5 – Qualifiers
5.1 /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.
5.2 /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.
5.3 /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.
5.4 /COMMENTS
/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.
5.5 /DELIVERY_RECEIPT_TO
/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.
5.6 /ENCODING
/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).
5.7 /ERRORS_TO
/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.
5.8 /EXPAND_LIMIT
/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.
5.9 /EXTRA
/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,...).
5.10 /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.
5.11 /FILENAME
/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.
5.12 /FROM
/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.
5.13 /HEADERS
/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.
5.14 /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.
5.15 /IMPORTANCE
/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.
5.16 /KEYWORDS
/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.
5.17 /LOG
/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.
5.18 /MODE
/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.
5.19 /MULTIPART
This qualifier may be used to tell PMDF SEND to always format the
messages it sends as multipart MIME messages.
5.20 /ORGANIZATION
/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.
5.21 /PRIORITY
/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.
5.22 /READ_RECEIPT_TO
/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.
5.23 /REFERENCES
/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.
5.24 /REPLY_TO
/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.
5.25 /RETURN_ADDRESS
/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.
5.26 /RFROM
/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.
5.27 /RREPLY_TO
/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.
5.28 /SENSITIVITY
/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.
5.29 /SUBADDRESS
/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.
5.30 /SUBJECT
/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.
5.31 /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.
5.32 /USER
/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.
5.33 /WARNINGS_TO
/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.
5.34 /X_PS_QUALIFIERS
/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.
6 – 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.