What is the Send('Message') function?

Document ID : KB000055931
Last Modified Date : 14/02/2018
Show Technical Document Details

The Send('Message') function sends an email message, with the option of attaching files or displaying the mail system dialogs for soliciting user log-in, profile selection, and user input of the message contents. The function returns no result if it succeeds; a run-time error if it fails.

Syntax:
Send('Message', recipient_name [,copy_name, blind_copy_name, subject, body_text, attachment_file, attachment_name, login_dialog])

ParameterRequiredDescription
Recipient_nameYThe name or address of one or more recipients to whom the message is to be sent. (For multiple recipients, separate each one with the list separators supported by the email system involved.) If the entry appears as a name in the mail system's address book or if there is no address book, the entry is treated as an address. The address must be in the format required by the mail system.
Copy_nameNThe name or address of one or more carbon-copy recipients to whom the message is to be sent. The format is the same as for recipient_name.
Blind_copy_nameNThe address of one or more blind-copy recipients to whom the message is to be sent. The format is the same as for the recipient_name.
SubjectNThe description of the message content.
BodyNThe message itself. The maximum length of the message is determined by the mail system. You can specify a list of items for the body text using the construction #('line1', 'line2', ...), and the function will insert a carriage return between each line.
Attachment_fileNThe location of one or more files to be sent, identified by a DOS, UNC, or URL file specification.
Attachment_nameNThe name of the attachment as seen by the recipient: that is, a file alias to be used in place of the file name. If there is more than one attachment_file and attachment_name, the aliases are assigned to file in the order listed. If there are more files than aliases, the remaining files will have no aliases. If there are more aliases than files, the remaining aliases will not be used.
Login_dialogNFalse (default) indicates that the message will be sent using your current mail profile and log-in, prompting you only if you have no mail session open. True indicates that the mail system's dialogs should be displayed, including the profile-section dialog, a log-in dialog if the mail system requires it, and a message dialog whose fields are filled with any values that may have been specified in the other parameters.

NOTE:

  • The first time users send email in the current F&T session (the period between starting and closing F&T), they are prompted to select a mail profile and log in if the email system requires it. If users subsequently send email from F&T in the same session via this function, they are prompted for a profile selection only if login_dialog parameter is set to true.
  • As an alternative, you can use the menu function to programmatically select the F&T menu option Tools -> Send: Mail: Menu('SendMessage').
  • Use Send('View') to email specified views from the current view file.