Use FileMail to send the text of a file as a message to another user.
FileMail may also be entered as MailFile or Mail.
FileMail is supported for BIM and workstation files only. It is not supported for PDS or VSE files.
Required Operands
USER is the user to send the message to. (The UserLibrary command will produce a listing of all users.)
Optional Operands
FILE is the BIM or workstation file containing the message to be sent. FILE can also be $Stack to send the contents of the clipboard or / to send the current session.
Default: last referenced file.
TITLE is a brief comment about or description of the message. TITLE can be up to 40 characters in length. If TITLE is not specified, the first 40 characters of the first line of text are used. The message title is shown on the display created by the MailLibrary command.
FileMail queues a message for the USER. The message text is copied from FILE. FILE is immediately available for reuse or deletion. The USER is informed of the queued message by a highlighted indicator in the information line. The USER can then issue the MailList command to view the message.
The message is assigned a unique four digit number. This number is shown as part of the information line when the message is displayed. It is also shown on the MailLibrary display. MailLibrary will list all messages you sent, that have not been displayed by the USER. These messages are listed in the OUTGOING section of the display. You can display any such message by issuing the MailList command followed by the message number or by using the ContextList command while a MailLibrary session is current.
The message can be purged by issuing the SessionDiscard command while viewing the message. You can also purge such a message by issuing the MailDelete command followed by the message number or by using the ContextDelete command while a MailLibrary session is current. If a message is purged before the USER displays the message, the USER receives no indication that a message was ever sent.
FileMail logs the message text to $Mail. $Mail can be displayed at any time by invoking the $MailList command.
FileMail sets the last referenced file.
When Valid
For Host files, the user must have LIST access level for the FILE directory.
Return Codes
OK Successful.
NF One of the following:
File not found.
User not found.
SC Inadequate access level.
Procedure Notes
FileMail sets the TXM variables to the attributes of FILE.
Examples
Send the message in workstation file MEMO to user SJK:
=> mail sjk,memo
Send the message in BIM file file NOTE with a title to user GOP:
=> mail gop,note,'trip itinerary'