Retrieve one or more files from the server.

Syntax

SEND file-spec extension

Qualifiers	Defaults
/ENCODING=encoding	None
/MODE=mode	/MODE=TEXT

Parameters

name

Required parameter specifying the file or files to send. This parameter can include a directory specification, but must include a file name. The usual shell wildcard characters, * and ?, are supported.

extension

Optional parameter which can be used to specify the extension of the file to be sent.

Description

The SEND command sends the requested files back to you via electronic mail. Wildcards may 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 may 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 may 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 may be obtained with the SEND command.

Qualifiers

/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.

/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.

Examples

% mail mailserv@example.com
SEND fonts/README.TXT
[CTRL/D]
%
      

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.

% mail mailserv@example.com
MAXIMUM BYTES 10240
SEND/MODE=BLOCK/ENCODING=BASE64 fonts/adobe35.pfb.Z
[CTRL/D]
%
      

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).

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.