Retrieve one or more files from the server.
Syntax
SEND file-spec extension
Qualifiers Defaults
/ENCODING=encoding None
/MODE=mode /MODE=TEXT
1 – Parameters
name
Required parameter specifying the file or files to send. This
parameter can include a directory specification, but must include
a file name. OpenVMS wild cards are allowed in both the directory
and file specification.
extension
Optional parameter which can be used to specify the extension of
the file to be sent.
2 – Description
The SEND command sends the requested files back to you via
electronic mail. Wild cards can be used in the file-spec
parameter to specify multiple files. Each file is sent as a
separate message.
The optional extension parameter is supplied for compatibility
with BITNET's LISTSERV file servers. When supplied, a period
followed by the value of this parameter will be appended to the
value of the file-spec parameter to form the actual file name to
use. For instance, the command
SEND NEWTAGS DESCRIPT
is interpreted as a request for the file NEWTAGS.DESCRIPT and is
equivalent to the command
SEND NEWTAGS.DESCRIPT
Large files can automatically be split into multiple smaller
files prior to transmission; see the description of the MAXIMUM
command for specific details. When the MAXIMUM command is used,
it must be specified prior to the SEND command; e.g.,
MAXIMUM BYTES 10000
MAXIMUM LINES 1000
SEND [BOOK]CHAPTER*.TXT
Files can be read in a variety of ways; this can be controlled
with the MODE command or the /MODE qualifier. Files containing
non-text information must be encoded in some way; the ENCODING
command or the /ENCODING qualifier control the encoding used.
When using the MODE and ENCODING commands, be sure to specify
them before the SEND command requiring their use.
Use the DIRECTORY and INDEX commands to obtain information on
available files which can be obtained with the SEND command.
3 – Qualifiers
3.1 /ENCODING
/ENCODING=encoding
The /ENCODING qualifier specifies the encoding to use for this
particular file. It does not establish any default for future
SEND commands, but it overrides any default set with the ENCODING
command for this particular SEND command. The value is required
and must be one of the values the ENCODING command accepts.
3.2 /MODE
/MODE=mode
The /MODE qualifier specifies the mode to use for this particular
file. It does not establish any sort of default for future SEND
commands, but it overrides any default set with the MODE command
for this particular SEND command. The value is required and must
be one of the values the MODE command accepts.
4 – Examples
1.$ MAIL
MAIL> SEND
To: in%"mailserv@example.com"
Subj:
Enter your message below. Press CTRL/Z when complete, or CTRL/C to quit:
SEND [FONTS]README.TXT
<CTRL/Z>
MAIL> EXIT
$
In this example, a simple request with a single command is sent
to the mail server mailserv@example.com. This single command
requests that the file [FONTS]README.TXT be sent.
2.$ MAIL
MAIL> SEND
To: in%"mailserv@example.com"
Subj:
Enter your message below. Press CTRL/Z when complete, or CTRL/C to quit:
MAXIMUM BYTES 10240
SEND/MODE=BLOCK/ENCODING=BASE64 [FONTS]ADOBE35.PFB-Z
<CTRL/Z>
MAIL> EXIT
$
In this example, a large binary file is being requested. The
/MODE and /ENCODING qualifiers are used to request that the
file be interpreted as raw binary data and sent in an encoded
format. The MAXIMUM command is used to fragment the encoded
file into several small messages, each no larger than 10K
(10,240 bytes).
5 – Error messages
%MAILSERV-W-FLK, file currently locked by another user
One or more of the requested files is not currently accessible.
Try again later.
%MAILSERV-W-INSFPRM, missing command parameters
You failed to supply the name of the files to send. You must
supply a file specification. Resend the command with a file
specification.
%MAILSERV-W-IVKEYW, unrecognized keyword - check validity and spelling
You specified an unknown encoding or reading mode. Resend
the command using a legal encoding or reading mode with the
/ENCODING or /MODE qualifier.
%MAILSERV-W-NOFILES, no files found
Supplied file specification does not match any available files.
Use the DIRECTORY command to obtain a listing of the available
files.
%MAILSERV-F-NOFILESERV, file service is not enabled
The mail server is not configured to operate as a file server.
%MAILSERV-W-PRV, insufficient privilege or file protection violation
You are not allowed access to one or more of the requested
files.
%MAILSERV-W-VALREQ, missing qualifier or keyword value
You failed to supply a value with the /ENCODING or /MODE
qualifier. Resend the command with a value specification.
Return a list of the current subscribers to a particular mailing
list.
Syntax
SEND/LIST list-name
Qualifiers Defaults
/COMMENTS See text
5.1 – Parameters
list-name
Required parameter specifying the name of the list whose
subscribers are to be returned. Wild cards are not allowed.
5.2 – Description
The SEND/LIST command responds with a message containing a list
of the current subscribers to a given mailing list.
5.3 – Qualifiers
5.3.1 /COMMENTS
/COMMENTS
/NOCOMMENTS
When /COMMENTS is specified, comment fields associated with each
subscribed address will also be returned. Specify /NOCOMMENTS
to have these fields stripped from the listing sent to you.
The default behavior can vary from list to list. Generally the
default behavior is to include the comments.
Note that in RFC 822 addresses, comments are completely
superfluous and it should be possible to strip any or all
comments from an address without breaking the address. However,
there are known to be mailers which stupidly put critical
information into comment fields with the expectation that the
comments will not be stripped or altered. Addresses for such
mailers can be rendered unreplyable by removing the comment
fields from them.
5.4 – Error messages
%MAILSERV-W-INSFPRM, missing command parameters
You failed to specify the mailing list name. Resend the command
specifying the name of the mailing list whose membership list
you want to obtain.
%MAILSERV-W-LNF, list not found
The mailing list you specified does not exist. Resend the
command specifying the name of a valid mailing list. You can
use the DIRECTORY/LIST command to obtain a listing of the valid
mailing list names.
%MAILSERV-F-NOMAILLIST, mailing lists are not enabled
The mail server is not configured to operate as a list server.
%MAILSERV-W-PRV, insufficient privilege or file protection violation
You are not allowed to retrieve the list of subscribers to this
mailing list. The MAILSERV_ACCESS mapping can be used to change
the default behavior of the MAILSERV SEND/LIST command. Please
refer to the Mail and list server section in the PMDF System
Manager's manual.
%MAILSERV-W-WRITEERR, file writing error
An error occurred while the mail server was writing the message
to you. Try resending this command at a later time.