Ean Distributed Message System

The following are keywords and the topics which they address. You can get information about any of the topics by typing "help" followed by the appropriate keyword.

address
message addressing
commands
available commands
directory
the directory service
errors
Ean error messages
headers
header fields
introduction
introduction to the Ean mail system
message-selector
selection of messages
newuser
information regarding initial registration
notation
command notation
profile
your Ean profile file
profile/options
options in your profile
time
syntax for specifying time
time/delivery
timed delivery of message

If you need more help than is provided by the HELP command and the User's Manual, direct your query to your local Ean administrator.

newuser

Registering with the Ean Distributed Message System

You will be prompted for a name... After entering your name, you are asked to register with the directory service.

If you do register, you are asked a few additional questions, and Ean sends a registration request to the directory service. Your answers will be entered into the directory. These answers can be displayed or altered with the SET and SHOW commands. However, if you alter any of them, use the INSTALL command to re-register yourself in the directory.

You will now be able to send and receive mail.

Ean prompts you with an ">".

You will notice that Ean has created several files under your account or user identification. These files are used by Ean and, except for the profile, these should not be changed or deleted other than through Ean. Two of the files created by Ean are the "inbox" folder and the "profile" file. The "inbox" folder is where all incoming mail is placed. Whenever you invoke Ean, this folder is opened automatically.

The profile contains information used by Ean in executing the commands you enter. This information can be displayed or changed at any time with the SET and SHOW commands, but for now the information already placed there by Ean should suffice.

Once you have completed your Ean session, simply type

> quit

to end the session.

The Ean Distributed Message System - Commands

The following is a list of commands available to you. Minimum abbreviations are capitalized.

Accept
accept delivery of messages that have been sent to you
CLose
close a previously opened folder
COmpose
compose a draft message
DElete
mark as deleted the specified messages
DROP
remove all directory information
EDit
invoke the system editor
EXChange
replace a field value
EXIt
terminate session
FILe
file a copy of the draft message
FINd
query the directory service.
FOLders
list names of folders
FORward
forward the specified message
Get
copy the specified message to the draft message
Help
obtain information on the specified topic
Install
install modified directory information
List
print summary lines for the specified messages
Move
move specified messages to the specified folder
Open
open the message folder If the folder does not exist, create the folder (on your instructions).
Print
print the specified messages
PROBE
send a probe envelope to a UA
Quit
terminate session
REGister
register initially with the directory service
REMove
remove an existing folder
REPly
reply to the specified message
SELect
set the `message-selector `selected' to the specified messages
SEnd
send the draft message
SET
set options in the profile
SHow
display the profile options and values
SIze
display the size of selected messages
STop
terminate session
TIDY
clean deleted messages out of the current folder
Undelete
mark as not deleted the specified messages
Where
give the name of the current folder and number of the current message.
Xchange
replace a field value
!command
execute system command
?
obtain information on the specified topic

For information about a specific command, type the name of the command, e.g., "send".

Information is also available about other topics. For a list of these, type "topics".

Addressing a Message

To send mail, you need to know the Network User Addresses of your correspondents. The syntax of an NUA can vary with the message domain of the recipient. The general form of an address is

domain-specific-description.domain

Here, "domain" specifies the message domain. Examples of message domains are UUCP, NET, EDU, and CA. The syntax of the "domain-specific-description" depends on the domain.

Subtopics: comment local syntax

Addressing a Message - Comment & NUA

Often the NUA has little resemblance to the actual name of the user. For instance, "Mary Jones" might have a mailbox "n2b3@instr.ee.uoft.ca". To make the NUA easier to understand, Ean allows you to describe the NUA with comments. The syntax of an NUA when a comment is included is where comment is a sequence of characters. Using this notation, we can type

To: Mary Jones <n2b3@instr.ee.uoft.ca>

When summary lines for incoming messages are listed with the LIST command, if there is a comment in the "From" field of the message, then Ean uses the comment (instead of the NUA) in the summary line. On an outgoing message, Ean uses your name (from your profile) as a comment in the "From" field.

See Also: local syntax

Local Message Addressing

Recipients on the same host as the sender may be addressed by using their userid. For example, to send to a recipient on your host whose userid is "fred":

To: fred

Subdomain and private domain information will be filled in by the mail program.

See Also: comment syntax

Syntax of a Message Address

Ean system message domain addresses are of the form

mailbox@subdomain.domain

Between "mailbox" and "domain" is a list of one or more subdomains. There must be at least one subdomain. It is normally the name of the host computer on which the mailbox exists. If more than one subdomain is specified, the subdomains are separated by a period. An example of an NUA for the Ean system is "billy@yukon.ca". The mailbox is the user identification "billy", the subdomain is the host name "yukon", and the message domain is "ca". In the address "dwick@berkeley.cs.net", there are two subdomains: berkeley and cs. The message domain here is net. Here is an example of three recipients in different domains:

To: pete@decvax.uucp, son@stanford.cs.edu, draft@mit.net

See Also: comment local

Ean Commands - Notation

Commands may be entered with upper-case or lower-case letters. Minimum abbreviations for command words are capitalized. Items which appear enclosed in "{}" are optional. The "{}" should not be typed as part of the command. The symbol "|" indicates a choice. Words preceded by an apostrophe should be replaced by the item indicated (e.g., file-name, message-selector, profile-option).

Ean Distributed Message System - Introduction

Ean is a distributed message system for the exchange of interpersonal mail. Users of Ean can invoke it on their local computer, compose mail, and request transmission of the message to a user on a different computer. Normally, users at each computer use Ean to exchange mail over X.400 mail networks. Gateways permit interchange with mail systems such as those on the BITNET network, the CSNET network, and the ARPAInternet network.

Ean uses the public data networks to transmit and receive mail. The format of the mail and its supporting protocols follow the international CCITT X.400 recommendations for Message Handling Services (MHS). As a result, Ean can be easily connected with future public and private message systems that also adopt these CCITT recommendations.

The Ean message system provides you with facilities for composing, editing, filing, sending, and receiving interpersonal messages. You can create new messages, edit them, and save them for further amending. When you are satisfied with the message, you can send the message either to a single recipient or a list of recipients. These recipients take delivery of the message and can forward the message to other recipients, reply to the message, or file it in a folder.

ACCEPT Command

Accept { 'folder-name }

The ACCEPT command receives all user and status report messages awaiting delivery. This command is entered automatically for you when you invoke Ean. If you do not want Ean to accept messages at the beginning of a particular session, invoke Ean with

ean -a

If you want to accept mail during an Ean session, you need to enter the ACCEPT command yourself.

Messages received with the ACCEPT command are not autoforwarded.

See Also: move

Subtopics: filing examples

ACCEPT Command - filing

Accept { 'folder-name }

After taking delivery of all waiting messages, Ean always prints a summary line for each newly arrived message. If an accepted message was generated by a REPLY command or is a status report message, Ean attempts to link it with the earlier message (rather than file it according to your Folder profile option). If the earlier message is found, the new message is placed "beside" the earlier message. The earlier message can be in any folder, not just "inbox".

If you do not give a folder-name on the command, incoming messages are filed in your inbox folder or in other folders as specified by your Folder profile option. If you give the name of a folder that does not exist, Ean automatically creates the folder. When you give a folder-name, the messages are stored in that folder. Even if the messages are reply or status report messages, they are not linked with the earlier message; the Folder options in your profile are ignored for that ACCEPT command only.

See Also: examples

ACCEPT Command - Examples

Accept { 'folder-name }

    > accept
    Accepting messages: ..
    inbox:
       5  NU     Bill Jones       17 12:43  IFIP Meeting
       6  NU     Sam Fong         17 12:43  course marks
    >

Here two new messages were accepted. The state characters "NU" show that the messages are New and Unread.

To accept mail in a folder other than we can give a foldername.

    > accept tempfolder
    Accepting messages: .
    tempfolder:
      1  NU     Janet Briton      9 18:23  Backdoor

See Also: filing

CLOSE Command

This command closes the current folder. If more than one folder was open, the most recently opened folder becomes the current one.

See Also: open quit where

Subtopics: example

CLOSE Command - Example

If the current folder is "bug-reports" and you had previously opened "inbox" ("inbox" is opened automatically when you invoke Ean), then

    > close

closes the folder "bug-reports" and makes "inbox" the current folder again.

COMPOSE Command

COmpose { 'NUA-list } { 'header-list }

The COMPOSE command creates a draft message. You will be prompted to fill in the message fields. After you complete the message by entering a line consisting of a period (.) only, you will be prompted with "Send options?" to which you may reply with send options (see the SEND command) or with a simple affirmative ("send") or negative ("wait"). If you enter a null line or a blank line to Ean's query "Send options?", Ean assumes that you mean an affirmative response.

See Also: edit file send

Subtopics: example features

COMPOSE Command - Features

COmpose { 'NUA-list } { 'header-list }

An 'NUA-list may consist of a single NUA, or a single alias, or a series of NUAs and aliases separated by commas. If you give an NUA-list with the COMPOSE command, it is used as the value for the "To" field; otherwise, Ean prompts you for the "To" field. If you do not give a 'header-list, the message fields are taken from your Compose profile option. Ean prompts you with the fields in the 'header-list in addition to those specified in the Compose profile option. More than one line may be entered when you are prompted with a header field. This is done by typing the continuation character, (\), at the end of a line before continuing on a new line for the same header field.

You can use the "#include" request to include in your message the contents of a file or a message in your Ean folder system. The syntax of the include requests are

   #include {TEXt} 'file-name
   #include BINary 'file-name
   #include OLDBINary 'file-name
   #include MESsage 'message-selector
   #include G3fax 'file-name
   #include FAX 'file-name

"#" must be the first character on the line. Ean responds to these request by informing you of the number of lines or bytes that are included from the 'file-name or the number of messages included. The 'file-names are allowed to begin with ~ or ~username.

The keywords occurring before the 'file-name or 'message-selector result in the following bodypart types being produced:

TEXt
- a continuation of the current IA5 text bodypart or a new one if the last bodypart was not IA5 text.
BINary
- a binary bodypart type, as agreed upon in the implementors agreements.
OLDBINary
- a EAN style bodypart for backward compatibility.
MESsage
- a bodypart of type Forwarded message.
G3fax
- a Group 3 fax bodypart.
FAX
- synonymous with G3fax.

See Also: example

COMPOSE Command - Example

COmpose { 'NUA-list } { 'header-list }

    > compose cc
    To: Bobby
    Cc: Marg
    Subject: Building plans

Here is the design I was telling you about: #include g3fax design 25032 bytes included from file.

Is there any way to alter the staircase design now? . Send options? >

This example uses an additional header field not normally prompted for: "Cc". The line "#include g3fax design" includes the contents of the file "design". The line "#include" will not appear in the message received by "Bobby" and "Marg".

See Also: features

DELETE Command

DElete { 'message-selector }

If you give a message-selector on the DELETE command, Ean marks the specified messages as deleted. If you do not specify a message selector, Ean deletes the current message.

Until the folder is tidied using the TIDY command, messages that have been deleted may be recovered with the UNDELETE command. But once the folder has been tidied, deleted messages cannot be recovered. One exception to this rule is the draft message. If you delete the draft message, it cannot be undeleted. Once the folder has been tidied, deleted messages cannot be recovered.

See Also: undelete tidy

Subtopics: example

DELETE Command - Examples

DElete { 'message-selector }

The command

        > delete 5/3,15,19,35:40

marks messages 5, 6, 7, 15, 19 and 35 through 40 inclusive as deleted. If you are not sure which messages you have deleted, use the LIST command.

        > list deleted

displays, in summary form, all messages marked as deleted in the folder. The "D" in the summary line means that the message has been marked as deleted.

To delete the draft message, enter

    > delete draft

DROP Command

Use the DROP command when you no longer wish to be registered with the directory service. Ean prepares a mail message to this effect and sends it to the directory service. After your request is processed, you will receive a reply message.

See Also: install

Subtopics: example

DROP Command - Example

    > drop
    Request sent.
    >

EDIT Command

EDit { 'header-field | BOdy | DRAFT | PROFILE }

Use this command to invoke the system editor on the draft message or profile.

If you type just

    > edit

Ean assumes that you want to edit the entire draft.

See Also: exchange set show

Subtopics: example features

EDIT Command - Features

EDit { 'header-field | BOdy | DRAFT | PROFILE }

The 'header-field is the name of the message header file that you wish to edit. After you edit a field and leave the system editor, Ean updates the draft message. More than one line may be entered when you are prompted with a header field. This is done by typing the continuation character, \, at the end of a line before continuing on a new line for the same header field.

If you type the word "body" after "edit", only the body part of the draft message is made available to you for editing.

If you type the word "draft" after the word "edit", the entire draft message (header and body) is made available to you for editing. That is, "edit" and "edit draft" achieve the same thing. You can use the EDIT command to edit the profile directly. (You could also access the profile by using the SET and SHOW commands.)

See Also: example

EDIT Command - Example

EDit { 'header-field | BOdy | DRAFT | PROFILE }

The command

    > edit subject

invokes the system editor on the "Subject" field.

See Also: features

EXCHANGE Command

EXChange 'header-field | BOdy {=} { 'value }

Use this command to replace the value of the body or a specified field in the draft. If you do not specify a value, you are prompted for one. The old value of the field is entirely replaced by the new value. Even if the header field or body had no value before the EXCHANGE command, it nonetheless receives the value that you specify. This command can therefore be used to add new fields to the draft. It can also be used to remove a header field from the draft.

EXCHANGE and XCHANGE are synonyms: they both replace a field value.

See Also: compose edit forward reply

Subtopics: example

EXCHANGE Command - Examples

EXChange 'header-field | BOdy {=} { 'value }

    > exchange cc=jimbo

replaces the previous contents of the cc field -- if there were any -- with the value "jimbo".

    > exc subject
    Subject: This is the old subject line.
    Subject: This is the new subject line.
    >

Since the value for the subject field was not given in the EXCHANGE command, Ean displays the old value for Subject and prompts you for the new one.

    > exchange sensitivity=
    Sensitivity: confidential
    Sensitivity:
    >

removes the sensitivity field from the draft. A similar example is

    > exch sensitivity
    Sensitivity: confidential
    Sensitivity:
    >

In both cases, Ean displays the old value and prompts you for the new value. If you enter nothing, the field is removed.

EXIT Command

EXIt { Tidy | Notidy }

The EXIT command ends an Ean session. If there is an unsent and unfiled draft message, the session will not end immediately after you type "exit". Ean will respond with "There is an unsent or unfiled draft message. Do you really want to quit?". If you answer "yes", Ean will delete the unfiled or unsent draft message and then EXIT. If you answer or respond with a null line or a blank line, Ean will continue as though you had never attempted to end the session. If you do wish to leave, you can give instructions to send the draft, file it for future reference, or delete it.

If you specify "tidy", then all opened folders are tidied -not just the current one. If you specify "notidy", then TIDYing is not done even if specified in the profile.

See Also: quit set/options stop tidy

FILE Command

FILe { 'folder-name }

The FILE command files a copy of the draft message in the specified folder. If you gave no 'folder-name, Ean files the draft message in the current folder.

After Ean files the message, it displays the summary line of the message. The "->" means an outgoing message.

See Also: get list

Subtopics: example

FILE Command - Example

FILe { 'folder-name }

    > file
    15   -> Andrew White        Sep 17 83       Final Grades
    >

After Ean files the message, it displays the summary line of the message. The "->" means an outgoing message.

FIND Command

FINd 'NUN {('keyword-list)} {ALL} {MAXimum 'integer}

The FIND command sends your query to the directory service by Ean mail. You will receive a reply containing the result of your query by Ean mail.

See Also: drop install register

Subtopics: NUN keyword features example

FIND Command - NUN

FINd 'NUN {('keyword-list)} {ALL} {MAXimum 'integer}

Only the Network User Name (NUN) must be included. The syntax of a NUN is

    'user-name : 'organization

For example, "Mary Smith : UBC" is a NUN. If you do not use a colon in the NUN, Ean assumes that you have given it a 'username.

The search through the directory service ignores blank char- acters in the NUN, and upper--case and lower--case letters are considered equivalent. If the full name or organization name cannot be matched, Ean attempts a phonetic match and sends you all matches. The characters "*" and "?" have special meaning. "*" matches zero or more characters, while "?" matches any single character. If either of these characters appears in the NUN, no phonetic match is attempted.

See Also: keyword features example

FIND Command - Keyword-list

FINd 'NUN {('keyword-list)} {ALL} {MAXimum 'integer}

A 'keyword-list is one or more sequences of characters separated by commas. For example, "find Mary * :UBC (mail,network)" searches for all users at "UBC" who have names or alternate names beginning with "Mary " and who have either the word "mail" or "network" in the description of their directory entry. The special characters "?" and "*" may be used in the keyword-list also.

See Also: NUN features example

FIND Command - All and Maximum

FINd 'NUN {('keyword-list)} {ALL} {MAXimum 'integer}

The "all" requests all the information about the user including address, telephone, and description. Otherwise, only the NUA and NUN for each match are given.

If you give a "maximum" integer, then at most integer number of matches will be returned. If you do not specify a maximum, Ean uses a maximum of 200 for regular queries and 10 when you use the word "all".

See Also: NUN keyword example

FIND Command - Examples

FINd 'NUN {('keyword-list)} {ALL} {MAXimum 'integer}

   > find *Reid : manitoba (computer, mum)

searches for a full name ending with "Reid" at organization "manitoba" and the words "computer" or "mum" in the description of the directory entry.

   > find :*

This NUN has no full name part. Here, the names of at most 200 organizations known to the directory service are returned.

You can use the FIND command to learn about available distribution lists. The command

    >find *:lists

will query the directory service for a list of available distribution lists. The command "find 'list-name : lists all" will query the directory service for detailed information about the distribution list specified by 'list-name.

See Also: NUN keyword features

FOLDERS Command

The FOLDERS command displays the names of all the folders (not just the opened ones) and the number of messages in each folder. The folder names are displayed in alphabetical order.

See Also: close open where

Subtopics: example

FOLDERS Command - Example

    > folders
    bugs  --  31 messages.
    inbox --  14 messages (5 new).
    x.25  --  59 messages.
    >

In the "inbox" folder are fourteen messages, five of which are "new" (that is, five new messages were accepted during this Ean session).

FORWARD Command

FORward { 'message-selector } { 'NUA-list }

The FORWARD command forwards the specified messages. You are prompted for comments on the forwarded message.

The "F" state character is added to all forwarded messages.

See Also: list

Subtopics: features example

FORWARD Command - Features

FORward { 'message-selector } { 'NUA-list }

If you do not specify a 'message-selector, Ean forwards the current message. After you complete the message (filling in the header fields and comment part of the body), you will be prompted for send options.

If you give an 'NUA-list on the FORWARD command, Ean forwards the selected messages to the specified recipients. If you do not give an 'NUA-list, Ean prompts you with the "To" field. More than one line may be entered when you are prompted with a header field. This is done by typing the continuation character, (\), at the end of a line before continuing on a new line for the same header field.

See Also: example

FORWARD Command - Examples

FORward { 'message-selector } { 'NUA-list }

    > forward first
    To: Andrew
    This seems like an odd request, can you handle it?
    .
    Send options? confirm

> forward unread To: co-worker I have not had time to reply to these messages before holidays. Can you deal with them? Thanks. . Send options? send >

In the second example, all messages in the folder marked as unread will be forwarded.

See Also: features

GET Command

Get { 'message-selector } { 'get-options }

The GET command copies the specified message into the draft message. Only one message may be selected with the GET command. If no 'message-selector is specified, Ean assumes that you mean the current message.

The GET command does not alter the state of the message in the folder. If you want to delete the message from the folder after copying it to the draft, you must do so explicitly.

You can, after you GET a message, (for example) EDIT it, EXCHANGE any of its fields, PRINT all or part of it, or SEND it.

See Also: file list

Subtopics: example options

GET Command - Example

Get { 'message-selector } { 'get-options }

The command

    > get last

copies the last message in the current folder to the draft. The previous contents of the draft message are destroyed.

See Also: options

GET Command - Example

Get { 'message-selector } { 'get-options }

The 'get-options are (minimum abbreviations are capitalized)

BODYPart
- Specify a particular bodypart to GET.
BP
- A synonym for BODYPart.

A bodypart of type Forwarded Message may be specified as an option to the Get command. This allows you to retrieve particular information from a message (for example, binary data or G3 faxes) or reply to a message that was forwarded by someone else.

See Also: example

HELP Command

Help { 'topic }

The HELP command provides information on the specified topic. If you do not specify a topic, Ean provides a summary of topics for which help is available. Usually, the information presented is similar to that given in the User's Manual.

To find out on what topics you can get help, type

    > help

If you need more help than is provided by the HELP command and the User's Manual, direct your question to your local Ean administrator.

HELP and ? are synonyms: they both provide information on a topic.

Subtopics: example features

HELP Command - Features

Help { 'topic }

The Help Facility is organized in a tree-like structure. This structure is shown by the prompt given by the Help Facility and it indicates the current topic level. For example,

    > help print

gives information on the PRINT command. After the above command is given, you are left at the topic "print" in the Help Facility shown by the prompt

    HELP print>

The "print" topic has various subtopics, such as "examples", "file", and "options". available. Typing

    HELP print> options

will give you information on the subtopic "options" and moves you down a further topic level in the tree to "print/options". A subtopic here of "features" is available. By typing

    HELP print/options> features

you are given information on the subtopic "features". There are no further subtopics at this point in the tree so you are left at the current topic level "print/options".

This same point can be reached by specifying the complete path "help print/options/features".

You move back up a topic level by typing a "return" when the Help Facility prompt is displayed.

    HELP print/options> (return)
    HELP print> (return)
    HELP> (return)
    >

The Help Facility is exiting by typing successive "return"s until the Ean prompt is displayed again.

The current topic may be redisplayed by typing a period, (.), when the Help Facility prompt is displayed.

    > h profile

gives information about the profile.

    HELP profile> .

will redisplay information about the profile.

The 'topic may be abbreviated. The command

    HELP> p

gives information on all topics at this level that begin with "p". However, the command

    HELP> pri

gives information on all topics at this level that begin with which happens to be the unique topic "print". The topic names can be abbreviated at every level.

The keyword "all" may be used to signify that all the topics at that level are to be displayed.

    HELP> p/all/fe

will display all the topics beginning with "p" that also have a subtopic that begins with "fe".

See Also: example

HELP Command - Example

Help { 'topic }

    > help topics

provides a summary of topics for which help is available.

    > help print

gives information on the PRINT command.

    > help help

gives information about the HELP command.

    HELP> p

gives information on all topics at this level that begin with "p".

See Also: features

INSTALL Command

With the INSTALL command, the modified contents of your profile are sent to the directory service by Ean mail. When the request has been processed, you will receive a reply message.

You can use the SET or EDIT commands to modify the profile before you install it permanently. The profile options used by the directory service are Name, Alternate, Password, Mailbox, Address, Phone, and Description. It is only necessary to do an INSTALL if you alter the profile options that pertain to the directory service.

If you are altering your Name or Mailbox profile options, you must first issue a DROP command before you SET and IN- STALL. The Name and Mailbox identify you to the directory service. Modifying either of these options causes the directory service to associate the INSTALL to this new iden- tity, rather than the old one.

You should not consider installation complete until you have received the reply message.

See Also: drop find register

Subtopics: example

INSTALL Command - Example

    > set alternate=J. J. B. Higgins
    > install
    Request sent.
    >

In this example, the user has modified the alternate and then requested installation.

LIST Command

List { 'message-selector } { ON {APPEND} 'file-name }

The LIST command prints the following information about the specified messages:

    1.  the message  state
    2.  the   originator  if  the  message  is  incoming  or  the
        recipient if the  message  is outgoing.  If you  sent the
        message, the recipient's address is preceded by "->".
    3.  the date of  the message.  The day of  the month and  the
        time the message was  sent or received  is shown for mes-
        sages that have been sent or received  during the current
        month.   For other months, the date  indicates the month,
        day and year that the message was either sent or accepted.
    4.  the subject of the message, truncated if too long.

See Also: print

Subtopics: states features example

LIST Command - Message States

List { 'message-selector } { ON {APPEND} 'file-name }

The message state is encoded using a series of characters selected from

  "N" - means that the message is  new  (received during the
        current session).
  "R" - means that  unread  status  reports  exist  for  the
        message.
  "D" - means that the message has been deleted  (but may be
        undeleted).
  "U" - means  that the  message is  unread if  incoming  or
	unsent if outgoing.
  "F" - means that the message has been forwarded

See Also: features example

LIST Command - Features

List { 'message-selector } { ON {APPEND} 'file-name }

If you do not specify a 'message-selector, Ean uses the 'message selector specified in the List option of your profile. If you specify a 'file-name, Ean either overwrites the file with the list of summary or appends it to the file, depending on whether "on" or "on append" was used to direct output to the file. If the specified file does not exist, Ean creates an ordinary text file (not an Ean folder).

See Also: states example

LIST Command - Example

List { 'message-selector } { ON {APPEND} 'file-name }

    > list new
    inbox:
       5  U   Bill Marco   Oct 10 86    IFIP meeting
       6  U   Sam Fong      17 12:43    course marks
    >

See Also: states features

MOVE Command

Move { 'message-selector } TO { 'folder-name } { 'message-number }

The MOVE command copies selected messages to the specified folder. When messages are MOVEd, the status of the messages in the original folder changes to deleted (D).

The MOVE command does not make another physical copy of the message; only one copy - with links to it - exists. Therefore, messages may exist in more than one folder without incurring a storage penalty. This command is frequently used to copy messages from the inbox folder to other folders.

See Also: list

Subtopics: features example

MOVE Command - Message Selection & Destination

Move { 'message-selector } TO { 'folder-name } { 'message-number }

If you do not specify a 'message-selector, Ean copies the current message.

If you do not specify a 'folder-name, Ean copies to the current folder. If the folder you specify as the destination of the message does not already exist, Ean will ask whether the folder should be created. Responding with a "yes" will cause Ean to create the folder and copy the selected messages to the new folder.

If you do not give a 'message-number, Ean inserts the selected messages after the messages already in the folder. If you do give a 'message-number, Ean inserts the messages, beginning at that number. The numbers of the messages which were already in the file will be adjusted appropriately.

See Also: example

MOVE Command - Examples

Move { 'message-selector } TO { 'folder-name } { 'message-number }

    > move subject=x25 to x25_folder

copies all messages with the sequence of characters "x25" in the subject field to the folder "x25_folder".

    > move (from=smith,to=smith,cc=smith) & subject=marks to grades

copies all messages sent or received with the sequence of characters "smith" in the NUA and with the sequence of characters "marks" in the subject field to the folder "grades".

Note: if the 'message-selector is complex (as in the previous example), you may want to use the LIST command to preview the messages you have selected.

See Also: features

OPEN Command

Open 'folder-name

The OPEN command opens the message folder named in the command. When a folder is opened, it becomes the current folder. If the folder you specified does not exist, Ean asks you whether you would like it to be created. If you then instruct Ean not to create that folder, the current folder remains unchanged.

Opening a folder does not close any previously opened folder; all opened folders remain open. To make an already open folder the current folder once again, use the OPEN command.

See Also: close print remove where

Subtopics: example

OPEN Command - Example

Open 'folder-name

    > open bug-reports

opens the message folder "bug-reports". If this folder does not exist, Ean prompts you with

    Ok to create folder bug-reports?

to which you can respond "yes" or "no".

PRINT Command

{Print} { 'message-selector } { 'print-options } { ON {APPEND} 'file-name }

The PRINT command prints the message number, message state, and contents of selected messages. A side effect of the command is that the state of an Unread message changes to Read.

Since the PRINT command is used frequently, it is the one command in which the command name is optional. You may invoke printing merely by specifying the 'message-selector. However, if you wish to omit "print" or "p", be careful not to abbreviate the message selector so shortly that the abbreviation appears to stand for an Ean command.

The profile option "auto-display" affects which bodypart types Ean automatically tries to display. If the bodypart type is not found in the "auto-display" profile option, Ean will inform you that the data was not displayed.

If you do not specify a 'message-selector, Ean prints the current message.

See Also: list

Subtopics: options file examples

PRINT Command - Print options

{Print} { 'message-selector } { 'print-options } { ON {APPEND} 'file-name }

The 'print-options are (minimum abbreviations are capitalized)

ALL
- all information
BOdy
- body
ENVelope
- envelope information
FULL
- all information
HEADer
- all header fields
'header-list
- specified header fields. eg. Subject,Cc
REPorts
- status reports
STAtus
- status of current message
BODYPart
- a specific bodypart
BP
- a synonym for BODYPart

If you give 'print-options, then Ean prints the specified parts of the selected messages; otherwise, the entire message is printed. If you specify a 'header-list, only those header fields are printed. The "envelope" information consists of sending and delivery dates, the originator of the message, size of the message, the different types of body parts, recipient information contained in the envelope and assorted other flags. The 'bodypart is specified by the bodypart number, rather than the type.

See Also: file examples

Subtopics: features

PRINT Command Options - Features

{Print} { 'message-selector } { 'print-options } { ON {APPEND} 'file-name }

    > p full

All the information on the current message is printed.

    > print From

The "From" field of the current message is printed.

    > p bodypart=3

Print the third bodypart of the message. If the bodypart is nontextual, Ean will attempt to find an appropriate program using the mailcap information.

PRINT Command - PRINTing into a File

{Print} { 'message-selector } { 'print-options } { ON {APPEND} 'file-name }

You can specify the name of an ordinary text file in the command. If you specify a 'file-name, the print command output will sent to the specified file. If the keyword "on" is used, the file will be overwritten if it exists. If the keywords "on append" are used, the output will be appended to the file if it exists. If the file that you specified does not exist, Ean will create an ordinary text file (not an Ean folder). Only textual data will be written to the file if 'bodypart is not specified. If a 'bodypart is included, the data from that bodypart will be written to the file. If the 'file-name is "printer" the output will be sent to the printer (see the "printer" profile option) or to the default printer. The treatment of a specific 'bodypart (or lack of 'bodypart) setting is the same as for printing to files. This means that you could be sending binary data to your printer.

See Also: options examples

PRINT Command - Examples

{Print} { 'message-selector } { 'print-options } { ON {APPEND} 'file-name }

    > next                     prints the next message.
    > +1                       like "next", prints  the  next  message.
    > print deleted on save    prints the contents of all deleted
                               messages into the file "save".
    > p last-5:last            prints the last six messages.
    > p current/3              prints the next three messages.
    > p 1 bp=2                 prints the second bodypart of message 1.

See Also: options file

PROBE Command

PROBE { 'message-selector } {'NUA_list }

PROBE { 'probe-options } 'NUA_list

The PROBE command send a Probe Envelope to the recipients specified by the 'NUA_list or the recipients of the message specified. A delivery report or a nondelivery report will be returned, indicating whether or not a message with the same body types and length could be received by the specified recipient.

Subtopics: options examples

PROBE Command - Options

PROBE { 'message-selector } {'NUA_list }

PROBE { 'probe-options } 'NUA_list

The PROBE command can be issued with an existing message specified as the place from which to get the required information. If no recipients are specified, the PROBE command will recover them from the To:, Cc: and Bcc: headers of the message.

The PROBE command also allows you to send a Probe Envelope without having created a message with the appropriate body types and length. The following are the 'probe-options and their values:

BODYtype
These are the bodytypes which your proposed message would contain. They are the same as the values for the auto-display profile option with the following exceptions: Forwardedmsg, national, encrypted, eanbinary, and binary are not valid bodytypes. If any of these are present, they will be converted to indicate an undefined bodytype. The default is IA5text only.
EIT
Same as BODYtype.
CONVersion-prohibited
Indicates that conversion between bodytypes is [dis]allowed. If set to true, conversion will NOT be allowed. The default is False (ie. conversion is allowed).
ALTernate-recipients
Indicates that the message could be sent to an alternate recipient if one is specified by the receiving UA. If set to true, this will be allowed. The default is True.
LENgth
The length of the encoded message, in octets ("bytes").

See Also: examples

PROBE Command - Examples

PROBE { 'message-selector } {'NUA_list }

PROBE { 'probe-options } 'NUA_list

> probe inbox 31
Send a probe to the recipients specified in the message inbox:31 with indications of the bodytypes found there. The length will be set to the length of that message and conversion-prohibited and alternate-recipients will be the defaults.

> probe inbox 31 sanders@cs.ubc.ca
Send a probe to sanders@cs.ubc.ca, with the other values as specified above.

> probe eit=ia5,g3fax conv=true alt=false len=100000 sanders@cs.ubc.ca
Send a probe to sanders@cs.ubc.ca, with bodytypes indicating IA5 text and group 3 fax, a length of one hundred thousand octets, conversion-prohibited set to true and alternate-recipients to false.

See Also: options

QUIT Command

Quit { Tidy | Notidy }

The QUIT command ends an Ean session. If there is an unsent and unfiled draft message, the session will not end immediately after you type "quit". Ean will respond with "There is an unsent or unfiled draft message. Do you really want to quit?". If you answer "yes", Ean will delete the unfiled or unsent draft message and then QUIT. If you answer or respond with a null line or a blank line, Ean will continue as though you had never attempted to end the session. If you do wish to leave, you can give instructions to send the draft, file it for future reference, or delete it.

If you specify "tidy", then all opened folders are tidied -not just the current one. If you specify "notidy", then TIDYing is not done even if specified in the profile.

See Also: exit set/options stop tidy

REGISTER Command

This command builds a registration request from your profile and sends the request by Ean mail to the directory service. The Name, Alternate, Mailbox, Address, Phone, and Description profile options are used to build the request.

If your profile does not contain values for these profile options, Ean will prompt you for them.

You will receive a reply by Ean mail when the directory service has processed your request. You should not consider registration complete until you have received a reply from the directory service.

See Also: drop find install

Subtopics: example

REGISTER Command - Example

    > register
    There is no value for "Address".
    address: University of British Columbia
    address: Department of Computer Science
    address: Vancouver, B.C. CANADA
    address:
    Request sent.
    >

The Address and Description profile options may consist of more than one line. A line consisting of nothing or only a period tells Ean that you have finished entering the new value for the profile option.

REMOVE Command

REMove 'folder-name

This command removes an existing folder. All messages in the folder are destroyed, and all space previously occupied by the messages becomes available for storing new messages.

When a message has been filed in more than one folder and one of those folders is REMOVEd, the copy of the message in the REMOVEd folder is destroyed, but copies of the message remain in the other folder(s).

If the folder to be removed is the current folder, the inbox folder becomes the current folder.

Be sure to remove from your profile any "folder" option that refers to the folder you wish to remove. If such an auto-filing expression remains in the profile, the folder may automatically be created again when you accept new messages and automatic filing is done.

See Also: open move set/options

Subtopics: example

REMOVE Command - Example

REMove 'folder-name

    >  set folder steering-commit
    folder     steering-commit     from=chuck
    folder steering-commit:
    >

and

    > remove steering-commit
    OK to remove folder steering-commit? yes
    >

both remove the "steering-commit" folder option. All messages in the folder "steering-commit" and the folder itself are removed.

REPLY Command

REPly { 'message-selector } { ALL } { BOdy }

This command is a convenient way to reply to the sender of the specified message.

The reply message will have the same subject field as the original message. Also, Ean generates for your reply message an "In-Reply-To" field containing the original message-id. When you complete the message, Ean prompts you for send options.

If the sender of the original message filled in the "Reply-To" field, Ean sends your reply message to the recipients given in the "Reply-To" field. Otherwise, the reply is directed to the user specified in the "From" field of the original message.

See Also: compose forward

Subtopics: features example

REPLY Command - Message Selection & all

REPly { 'message-selector } { ALL } { BOdy }

Only a single message may be selected. If you do not give a current message.

If you specify the word "all" after the word "reply", all the recipients named in the "To" and "Cc" fields of the original message will be named in the "Cc" field of your reply message and will receive your message.

The option "body", when specified, includes the body of the message that you are replying to into the body of your reply. The prompt for your message text follows the included portion.

See Also: example

REPLY Command - Example

REPly { 'message-selector } { ALL } { BOdy }

    > reply last-3
    To:  R. Bonhoeffer <bonhoeffer@cs.ubc.cdn>
    In-Reply-To: inbox:47
    Subject:   back door
    Ok,  thanks  for  the information. I  hope to  act on  it
    shortly.
    .
    Send options? private
    >

See Also: features

SELECT Command

SELect { 'message-selector }

This command provides a convenient way to manipulate a set of messages. The messages specified by the 'message-selector can be accessed again by using the 'message-selector `selected'.

If no 'message-selector is specified, the current message becomes the `selected' value.

Subtopics: example

SELECT Command - Example

SELect { 'message-selector }

   > select from=sanders & subject="new feature"
   > list selected
   inbox:
     10  Michael Sanderson  Jun 11 92 New features in ean
   > move selected to ean

SEND Command

SENd {NOFile | FILE} {HIgh | NOrmal | LOw}

SENd {PErsonal | PRivate | COnfidential}

SENd {Confirm | NONreceipt | REPort | NOReport | RETurn | DELIvery}

SENd {{AFTER} 'date} { BEFORE 'date}

SENd {EDit | Wait | DELEte | HELP | ?}

There are two possible formats for the SEND command as shown above. The first format of the SEND command sends the draft message to its destination. All the options that are permitted in the SEND command may be used when Ean prompts you with "Send options?" after you enter the COMPOSE, REPLY, or FORWARD commands. Send options are optional parts of the SEND command. They are shown above enclosed in "{}". The send options are shown on several lines because all the choices are too long to fit onto a single line, but you should enter all send options on a single line.

See the subtopics for a description of each set of options.

The message will not be immediately sent if the second format of the SEND command is used. See the subtopic "delay" for a description of the options.

See Also: file get

Subtopics: file priority sensitivity report timing delay mail

SEND Command - Filing

SENd {NOFile | FILE} {HIgh | NOrmal | LOw}

SENd {PErsonal | PRivate | COnfidential}

SENd {Confirm | NONreceipt | REPort | NOReport | RETurn | DELIvery}

SENd {{AFTER} 'date} { BEFORE 'date}

Various options may be specified when you want to send the draft message. If you specify "nofile" in the command, Ean does not file the draft in the current folder. If you specify "file", Ean will file the draft even if the File profile option has been SET to "false". Otherwise, the File profile option determines whether the draft is filed automatically when the message is sent.

See Also: priority sensitivity report timing delay mail

SEND Command - Priority

SENd {NOFile | FILE} {HIgh | NOrmal | LOw}

SENd {PErsonal | PRivate | COnfidential}

SENd {Confirm | NONreceipt | REPort | NOReport | RETurn | DELIvery}

SENd {{AFTER} 'date} { BEFORE 'date}

You may select the priority of the message with the keywords "high", "normal", or "low". If you do not specify a priority, the message is transmitted at normal priority. If you specify either "high" or "low", this is shown on the message in the message header field "Importance", which Ean automatically adds. High priority messages are delivered before normal or low priority messages. Hence, if you have several normal priority messages awaiting delivery, and a high priority message arrives, the high priority message is delivered first. Low priority messages are not necessarily transmitted immediately. Delivery of messages according to priority is possible only if the des- tination mail system provides priority delivery also.

See Also: file sensitivity report timing delay mail

SEND Command - Sensitivity

SENd {NOFile | FILE} {HIgh | NOrmal | LOw}

SENd {PErsonal | PRivate | COnfidential}

SENd {Confirm | NONreceipt | REPort | NOReport | RETurn | DELIvery}

SENd {{AFTER} 'date} { BEFORE 'date}

You may specify the sensitivity of your message with the words "personal", "private", or "confidential"; otherwise, Ean assumes that the message is of normal sensitivity. If you do specify the sensitivity, this is shown on the message in the message header field "Sensitivity", which Ean automatically adds. Messages of other than normal sensi- tivity will not be forwarded -- either by the Auto-forward profile option or the FORWARD command -- to other users. Any other significance attached to the sensitivity values is up to you. To forward a message that has a sensitivity header field, you must first remove the field. You can do this with the EXCHANGE command.

See Also: file priority report timing delay mail

SEND Command - Reports

SENd {NOFile | FILE} {HIgh | NOrmal | LOw}

SENd {PErsonal | PRivate | COnfidential}

SENd {Confirm | NONreceipt | REPort | NOReport | RETurn | DELIvery}

SENd {{AFTER} 'date} { BEFORE 'date}

You may specify whether you wish to receive a status report, and under what circumstances, with the keywords

confirm
- requests receipt, nonreceipt, and nondelivery reports
delivery
- requests delivery reports
nonreceipt
- request nonreceipt and nondelivery reports
report
- request nondelivery reports
noreport
- suppresses all status reports
return
- requests return of message contents with a nondelivery report

If you do not specify one of these keywords, Ean provides you with a nondelivery report if the message system is unable to deliver a message to its destination mailbox. The "return" status report is automatically provided by Ean if you specify the "nofile" option when the message is sent.

See Also: file priority sensitivity timing delay mail

SEND Command - Timing

SENd {NOFile | FILE} {HIgh | NOrmal | LOw}

SENd {PErsonal | PRivate | COnfidential}

SENd {Confirm | NONreceipt | REPort | NOReport | RETurn}

SENd {{AFTER} 'date} { BEFORE 'date}

You may specify a date after which the message is to be delivered. The message is transmitted to the destination where it will be held for delivery until the specified date.

Ean accepts almost anything as a time and date with spaces separating the time, day, date, and year. The exception is a form of date that has numbers separated by slashes, dashes, or spaces.

Timed delivery is possible only if the mail system at the destination of the message provides timed delivery also.

See Also: file priority sensitivity report delay mail

SEND Command - Delay

SENd {EDit | Wait | DELEte | HELP | ?}

The message will not be immediately sent if the above format of SEND command is used. After the prompt, you may type any one of the following

edit
- The editor specified in your profile is invoked on the draft message. On exiting the editor, the prompt "Send options?" is displayed.
wait
- The message is not sent.
delete
- The draft is deleted and not sent.
help | ?
- Obtain information. The "Send options?" prompt is displayed on exiting the Help Facility.

See Also: file priority sensitivity report timing mail

SEND Command - and Other Mail Systems

Some of the send options are available only when the mail system at the destination of the message provides the same service.

Confirmation of delivery, timed delivery, and priority delivery of messages are possible only if the destination mail system provides these services.

Also, if the message passes through a gateway to another mail system, the reliability of notification of nondelivery depends on the destination mail system.

See Also: file priority sensitivity report timing delay

SET Command

SET { TEMPorary } 'profile-option {=} { 'value }

This command sets an option in the profile. If you give only the 'profile-option name, Ean displays the current value of the option. Then Ean prompts you for the new value, which may consist of one or more lines of information. To tell Ean that you have finished entering the new value, enter a line consisting of nothing or only a period (.). If you type the equal sign (=) with no value following it, Ean deletes that option from your profile.

If you specify the keyword "temp", the profile option is temporarily changed for the current session. No changes are made to the profile file when "temp" is specified.

See Also: show

Subtopics: options example

SET Command - Options

SET { TEMPorary } 'profile-option {=} { 'value }

The profile options are listed below (minimum abbreviations are underlined) with descriptions and the default values.

ADDress
- your postal address. No default.
ADDRESS-Type
- the style of addresses you want to see. The default is the MTA type. The values are x400 and rfc822.
ALias 'name
- an alias defined by you. No default.
ALTernate
- alternates for your Name profile option. No default.
AUTO-Display
- body types to automatically display. Default is determined by the Global profile. The values are from ia5text, tlx, voice, g3fax, tif0, ttx, videotex, national, encrypted, forwardedmsg, sfd, tif1, binary, eanbinary, and all.
AUTO-Edit
- automatic editing for the COMPOSE command. Default is false.
AUTO-Forward
- automatic forwarding of all personal incoming mail. The default is off.
AUTO-Reply
- automatic reply to all personal incoming mail. The default is off.
BOdyheaders
- displays a line indicating the bodypart number and type when set to true. Default is false.
COMPose
- the list of message fields for the COMPOSE command. The defaults are To: and Subject:.
DESCription
- miscellaneous information about you. No default.
EDItor
- preferred editor for message editing. System dependent default.
EXPiry
- deletion of expired messages without notification. The default is false.
FILe
- automatic filing on the SEND command. Default is true.
FOLder 'folder-name
- automatic filing on the ACCEPT com mand. Default is the "inbox" folder.
FORward
- the list of message fields for the FORWARD command. The defaults are the To and Subject header fields.
INDentstr
- the string with which to indent original text when doing 'reply body'. Default is "".
LIst
- message selector for LIST command if you do not specify one. Default is ~deleted.
MAILbox
- the local portion of your Network User Address. Defaults to your login account.
MAILCap
- indicates whether or not to try to read mailcap information for displaying non textual data. Default is true.
NAme
- your full name. No default.
PAGer
- automatic display of material one screen at a time. The default is on.
PHone
- your telephone numbers. No default.
PRint
- the list of message fields for the PRINT command. The defaults are from, authorizing-users, to, cc, bcc, reply-to, reply-by, in-reply-to, importance, sensitivity, subject, obsoletes, references, body, and status. The envelope headers that you want displayed should be set here as well. The values allows are send-date, delivery-date, p3-originator, infor mation-types, length, content-type, original-information-types, priority, delivery-flags, other-recipients, this-recipient and intended-recipients.
PRINTER
- indicates default printer. System dependent default.
PROmpt
- the sequence of characters used to prompt you for a command. The default prompt is >.
REPly
- the list of message fields for the REPLY command. No default.
RE-Subject
- include "Re: " at the start of Subject: lines when replying. Default is false.
SIGfile
- if set, this file is included at the end of a message, after the "." line is entered. Default is null. Could be set to ~/.signature or something like that.
TIdy
- automatic TIDYing when you enter the QUIT command. Default is true.

See Also: example

SET Command - Examples

SET { TEMPorary } 'profile-option {=} { 'value }

    > set alias jimbo=Jim Blackwood <jblack@cs.uvic.ca>
    > set address
    address: University of Victoria
    address: Victoria, B.C. CANADA
    address: .
    >

See Also: options

SHOW Command

SHow { 'profile-option } { ON {APPEND} 'file-name }

This command displays the values of the 'profile-option you specify. If you type

    > show

your entire profile is displayed.

See Also: edit profile set

Subtopics: example features

SHOW Command - Features

SHow { 'profile-option } { ON {APPEND} 'file-name }

You can specify the name of an ordinary text file in the command. If you specify a 'file-name, the show command output will sent to the specified file. If the keyword "on" is used, the file will be overwritten if it exists. If the keywords "on append" are used, the output will be appended to the file if it exists. If the file that you specified does not exist, Ean will create an ordinary text file (not an Ean folder). If the 'file-name is "printer" the output will be sent to the printer (see the "printer" profile option) or to the default printer.

See Also: example

SHOW Command - Examples

SHow { 'profile-option }

    > show print
    print   from,to,cc,subject,body
    >

displays the value for the Print profile option.

    > show alias bill
    alias bill William Smith <bsmith@aied.ucl.uk>

displays the value for the alias "bill".

See Also: features

SIZE Command

SIze { 'message-selector } { ON {APPEND} 'file-name }

The SIZE command prints information about the size of the specified messages. The information is presented in tabular form with columns for the size of the envelope, the content, the reports and total size of the message, as well as the subject of the message, truncated if too long. All size information is given in bytes.

See Also: list

Subtopics: features example

SIZE Command - Features

SIze { 'message-selector } { ON {APPEND} 'file-name }

If you do not specify a 'message-selector, Ean uses the 'message selector specified in the List option of your profile. If you specify a file-name, Ean either overwrites the file with the size information or appends it to the file, depending on whether "on" or "on append" was used to direct output to the file. If the specified file does not exist, Ean creates an ordinary text file (not an Ean folder). If the 'file-name is "printer" the output will be sent to the printer (see the "printer" profile option) or to the default printer.

See Also: example

SIZE Command - Example

SIze { 'message-selector } { ON {APPEND} 'file-name }

    > size new
    inbox:

Envelope Contents Reports Total Subject

5 166 364 0 530 IFIP meeting 6 213 505 0 718 course marks

Number of messages = 2 Total size = 1248 >

See Also: features

STOP Command

STop { Tidy | Notidy }

The STOP command ends an Ean session. If there is an unsent and unfiled draft message, the session will not end immediately after you type "stop". Ean will respond with "There is an unsent or unfiled draft message. Do you really want to quit?". If you answer "yes", Ean will delete the unfiled or unsent draft message and then STOP. If you answer or respond with a null line or a blank line, Ean will continue as though you had never attempted to end the session. If you do wish to leave, you can give instructions to send the draft, file it for future reference, or delete it.

If you specify "tidy", then all opened folders are tidied -not just the current one. If you specify "notidy", then TIDYing is not done even if specified in the profile.

See Also: exit quit set/options tidy

TIDY Command

The TIDY command destroys deleted messages in the current folder. The remaining messages are renumbered. Remember that once the folder has been tidied, the deleted messages cannot be recovered using the UNDELETE command.

After the current folder is tidied, the first message in the folder becomes the current message.

See the QUIT command for information about tidying when ending an Ean session.

See Also: delete quit set/options undelete

Subtopics: example

TIDY Command - Example

    > tidy
    Folder inbox contains 7 messages.
    >

UNDELETE Command

Undelete { 'message-selector }

This command removes the deleted mark from a message.

Remember that once you have deleted the draft message, it cannot be undeleted.

Undeleting a message that is not marked deleted has no effect.

See Also: delete list

Subtopics: example

UNDELETE Command - Example

Undelete { 'message-selector }

    > undelete deleted

removes the deleted mark from all messages in the folder.

WHERE Command

This command displays all opened folders and the number of the current message within each folder. The "->" points to the current folder.

See Also: close folders open

Subtopics: example

WHERE Command - Example

    > where
    -> Folder: bug-reports     Current message: 23
       Folder: inbox           Current message: 11
    >

XCHANGE Command

Xchange 'header-field | BOdy {=} { 'value }

Use this command to replace the value of the body or a specified field in the draft. If you do not specify a value, you are prompted for one. The old value of the field is entirely replaced by the new value. Even if the header field or body had no value before the XCHANGE command, it nonetheless receives the value that you specify. This command can therefore be used to add new fields to the draft. It can also be used to remove a header field from the draft.

EXCHANGE and XCHANGE are synonyms: they both replace a field value.

See Also: compose edit forward reply

Subtopics: example

XCHANGE Command - Examples

Xchange 'header-field | BOdy {=} { 'value }

    > xchange cc=jimbo

replaces the previous contents of the cc field -- if there were any -- with the value "jimbo".

    > xchange subject
    Subject: This is the old subject line.
    Subject: This is the new subject line.
    >

Since the value for the subject field was not given in the XCHANGE command, Ean displays the old value for Subject and prompts you for the new one.

    > x sensitivity=
    Sensitivity: confidential
    Sensitivity:
    >

removes the sensitivity field from the draft. A similar example is

    > xchange sensitivity
    Sensitivity: confidential
    Sensitivity:
    >

In both cases, Ean displays the old value and prompts you for the new value. If you enter nothing, the field is removed.

! Command

! 'command

The specified system command, 'command, is executed.

Subtopics: example

! Command - Example

! 'command

    > !date
    Fri May 1 13:29:27 PDT 1987
    >

Profile

You have a personal profile file. The first time you invoke Ean, this file is created and given initial settings for some of the commands. These settings (which you may change) are used by Ean when you issue those commands without giving specific details on how the command should be performed. The profile also contains your directory information and alias names for NUAs. Ean reads your profile whenever you invoke Ean. Lines in the profile have the following format:

The command "edit profile" will invoke the system editor and permit you to edit your profile. Or, you could use the SET and SHOW commands to modify and display each profile-option and its value.

See Also: set

Subtopics: example options

Message Header Fields

A message is composed of a header and a body. The body of the message consists of the text of the message. All the other fields constitute the header of the message. Ean provides the following 'header-fields:

To:
A list of one or more primary recipients of the message.

Cc:
A list of one or more secondary recipients.

Bcc:
A list of one or more "blind copy" recipients. The recipients listed here are not made known to the primary or secondary recipients or to each other.

When you send a message to more than one recipient, you may restrict how much information each recipient receives about the other recipients of the message. This can be done by using the "To", "Cc", and the "Bcc" fields. The recipients in the "To" and "Cc" fields will know of other recipients specified in the "To" and "Cc" field, but not those specified in the "Bcc" field. A recipient who is specified in the "Bcc" field will receive a copy of the message showing the recipients specified in the "To" and "Cc" fields, but only his own name will be in the "Bcc" field.

From:
Who sent the message. This is automatically filled by Ean with your name and NUA. If you change the "From" field so that it no longer con tains the Name and NUA associated with your user account, Ean will overwrite your alteration with the correct "From" field. The "From" field is not a field that you can change.

This field is used to indicate a list of one or more Names and NUAs that are authorizing this mes sage.

In-Reply-To:
When you use the REPLY command, Ean fills in this field with the message-id of the message to which you are replying.

Reply-By:
The latest time by which the recipient should re ply. Ean takes no action when this time occurs.

Reply-To:
A list of recipients who should receive the reply. This permits the sender of the message to specify where replies should be sent. If the sender of a message fills in the field, and the recipient uses the REPLY command to respond, Ean automatically sends the reply message to the recipients given in the "Reply-To" field.

Subject:
A brief note, showing the content of or the reason for the message. The first few characters of the subject are displayed on the summary line.

Message-Id:
A unique identifier for the message. It is au tomatically added by Ean. This is not a field that you can change directly.

Obsoletes:
A list of message-ids that are made obsolete by this message. Ean takes no action on the messages that are made obsolete.

References:
A list of message-ids to which this message refers.

Importance:
The importance of the message. This field is filled in by Ean when you specify "high", "normal", or "low" priority on the SEND command or prompt.

Sensitivity:
Filled in by Ean when you specify "personal", "private", or "confidential" on the SEND command or "Send options?" prompt.

Expiry-Date:
The date on which the message expires. On re ceiving a message after the expiry date, Ean deletes it without notifying you if you have set the Expiry option in your profile to "true". Ean initially sets this profile option to "false".

Auto-forward:
Filled in by Ean when a message has been for warded automatically. Its value is "true" or "false". This is not a field that you can change directly.

Selecting Messages

Message selectors are used to refer to messages by number, message header field values, message state, and folder. A message selector can also be used to select the union or intersection of message sets.

For information about a particular type of message selector, type the appropriate keyword.

single
single message
group
group of messages (by keyword)
range
message range
sequence
message sequence
field
header field value
chain
message chain
logical
intersection and union
not
negation
by-folder
folder

Subtopics: by-folder chain field group logical not range sequence single

Message Selector - Single Messages

You may specify a single message with

1. a message number (E.g., "5" selects the fifth message in the current folder.)

2. a keyword (minimum abbreviations are capitalized):

CURrent
the current message
Next
the message after the current message
PREVious
the message preceding the current message
FIRst
the first message
LAst
the last message
DRaft
the draft message

3. a sum or difference (E.g., "last-5" selects the message that is fifth from the last message in the current folder.)

See Also: by-folder chain field group logical not range sequence

Message Selector - Message Group

You may specify a group of messages with a keyword (minimum abbreviations are capitalized):

ALL
all of the messages in the current folder
NEW
all new messages
UNRead
all unread messages
COmposed
all messages that you composed
DELeted
all deleted messages
SENT
all messages that you have sent
UNSent
all messages that you composed but have not sent
READ
all read messages
SELected
the messages marked with the Select command

See Also: by-folder chain field logical not range sequence single

Message Selector - Message Range

You may select a range of messages by specifying a single message followed by a colon (:) followed by another single message. This selects the range of messages between the single messages. (E.g., "last-2:last" selects the last three messages in the current folder.)

See Also: by-folder chain field group logical not sequence single

Message Selector - Sequence

You may select a sequence of messages by specifying a single message followed by a slash (/) followed by a number. This selects the specified message and the specified number of messages following it. (E.g., "10/5" selects messages 10 through 14. "next/10" selects the next ten messages.)

See Also: by-folder chain field group logical not range single

Message Selector - Field Designator

You may select a group of messages with a field designator, which has the syntax 'All messages that have "value" in "headerfield" are selected'. If "value" contains a blank, use double quotes to enclose the value. (E.g., to = "mary jones" selects all messages with the sequence of characters "mary jones" in the "To" field.)

Ean treats upper-case and lower-case letters equally. For example, "to=Mary", "to=mary", "To=mary" and "To=Mary" all select the same messages. The characters "*" and "?" have special meaning. The character "*" matches zero or more characters, while the character "?" matches any single character.

See Also: by-folder chain group logical not range sequence single

Message Selector - Message Chain

You may specify a message chain. A message chain is a list of one or more messages that have in their "In-Reply-To" or "References" header-fields the message-id of the specified message. Messages in a chain need not all be in a single folder. The syntax of a message chain is
        ['single-message {/'depth}]
The symbols "[ ]" must be typed. "depth" is the number of messages that should be selected. If you do not specify the number of messages that Ean should select, Ean selects all the messages in the chain. (E.g., "[20]" selects all messages that have the same message-id in their "In-Reply-To" and "References" header-fields as the twentieth message in the current folder. "[current+4/10]" selects the ten most recent messages in the message chain.)

See Also: by-folder field group logical not range sequence single

Message Selector - Logical Op.

You may specify the intersection and union of message sets, combining groups of messages and single messages, by using commas (, representing or), vertical bars (| also representing or), and ampersands (& representing and).

Complex message selectors can be constructed using the "," "|", and "&" operators. Ean evaluates such message selectors from left to right, giving these operators equal priority. You can control the order in which Ean evaluates the message selector, and therefore its meaning, by using parentheses. What is enclosed in parentheses is evaluated first.

See Also: by-folder chain field group not range sequence single

Subtopics: intersection union

Message Selector - Union

Commas and vertical bars both select the union of the two message sets they separate. (E.g., "10/5,50:60,58/5" selects messages 10 through 14 and 50 through 62. "from=mike, [last]" selects messages from "mike" and messages that have the same message-id in the "In-Reply-To" or "References" fields as the last message. "draft, unsent" selects the draft message and unsent messages.)

See Also: intersection

Intersection

The ampersand selects the intersection of the two message sets that it separates. (E.g., "deleted & unread" selects messages that have been marked as deleted and that have not been read. "[23/10] & from=george & cc= "ean people"" selects from the 10 most recent messages in the message chain the messages that are from "george" and that have "ean people" in the Cc field.)

See Also: union

Message Selector - By Folder

You may specify from which folder the messages are to be selected by including the folder name in the message selector. If you do not specify which folder, Ean selects messages from the current folder. (E.g., "x.25 unread" selects all unread messages from the x.25 folder. If you next specify message selectors without a folder name, messages will be selected from the current folder.) Complex expressions that select from more than one folder are possible. (E.g., "foo unsent & deleted, bar all" selects all messages unsent and not deleted in folder foo and all messages in folder bar.)

You can use the keyword "every" to select messages from every one of your folders. (E.g., "every new" selects all new messages in all your folders.)

See Also: chain field group logical not range sequence single

Message Selector - Negation

You may select messages by specifying what they are not. Do this by using the tilde "~". (E.g., "~composed" selects messages that you did not compose. "~deleted" selects undeleted messages. When you enter the LIST command, and you do not specify what you want LISTed, Ean automatically LISTs messages that are "~deleted". " ~(composed | deleted) & from = jim" selects, from the messages that you did not compose and that you have not deleted, the messages from "jim".) As you can see from this example, the tilde may also be used with parentheses.

See Also: by-folder chain field group logical range sequence single

Syntax for Specifying Time

The syntax of a delivery time is flexible; Ean accepts almost anything recognizable as a time and a date with spaces separating time, day, date, and year. The exception is the form of date that has numbers separated by slashes, dashes, or spaces, because there is no standard, accepted form. Examples of valid delivery times are

Monday
October 13, 1987 at 3:05 a.m. PDT
Tuesday at 12:00
Friday 12:00 pm
13 Nov 86 15:05:09 EST
1987 June 1
thursday, january 22 at 14:56 pdt

If you do not give a time, then the earliest time for the date is assumed. Also, if you do not give a date, then the earliest date is assumed. For instance, the date "July 1" implies the time 00:00 a.m. If the current date is "Sept 29 1987" and the time "12:00 a.m." is given before 12:00 am, then "Sept 29" is assumed; otherwise, "Sept 30" is used.

Subtopics: delivery

Timed Delivery

Timed delivery allows you to specify a date and time for delivery of an outgoing message. This is useful for sending reminders - including reminders to yourself. You can request timed delivery on the SEND command, or when you are prompted with "Send options?" after the COMPOSE, FORWARD and REPLY commands.

The message is delivered as soon as possible after the specified date and time. If the message is addressed to a remote host, then the message is sent immediately to that host. The message is then delayed at the destination host until the given date and time. For example, "send Monday" and "send after Monday" send the draft message but delay delivery until the following Monday. For information about specifying the delivery time, type "help time".

Note: delayed delivery is possible only when the destination mail system provides timed delivery.

Directory Service

The directory service, analogous to a telephone directory service, is a facility for finding Network User Addresses. To find an NUA, ask the directory and you will be informed on the success or failure of your query. An important feature of this service is that the information about the users is maintained by the users themselves. Commands are available for a user to initially register in the directory, modify any information about himself, and query the directory.

Subtopics: information modify query register

Directory Service - Registration

All users are encouraged to register in the directory. When you first invoke Ean, you are asked whether you wish to be registered in the directory. If so, you are prompted to enter information for the directory entry. The data are then sent by Ean mail to the directory service.

Since the registration request is sent by Ean mail, you are not immediately registered. When the directory service has validated the information and inserted it into the directory, a reply message is sent to you -- again by Ean mail.

You can use the DROP command to remove yourself from the directory.

See Also: information modify query

Directory Service - Modifying Information

You may modify the directory information at any time. You must first issue a DROP command if you are going to modify your Name or your Mailbox. It is not necessary to issue a DROP command if you are altering information other than your Name profile option or Milbox profile option.

To modify the information, use the SET or EDIT commands to alter any of the options in your profile that relate to the directory service (Name, Alternate, Mailbox, Address, Phone, Description).

Once you are satisfied with the information, use the INSTALL command to send a request by Ean mail to the directory service to update the directory. A reply reporting success or failure will be sent to you by Ean mail.

The SET or EDIT commands do not alter the directory. They simply update your profile. It is not until you use the INSTALL command that the directory information is altered.

See Also: information query register

Directory Service - Querying

You can query the directory service at any time, even before registering. When querying the directory, you should specify as much information as you know about the subject of your query.

Use the FIND command to formulate the query that is sent by Ean mail to the directory service. The FIND command locates information in the directory service for you by searching the Network User Names and Descriptions. Once the request has been processed, the results are sent to you as a message by Ean mail.

See Also: information modify register

Directory Service - Information

The directory service maintains the following information about you. This information is obtained for your profile and from the system administrator.

Network User Name
The NUN consists of two parts: your full name and your organization. Your full name is obtained from your profile options

Name and Alternate.
The organization name is determined by the system administrator and cannot be set by you.

Mailbox
This is the Network User Address, NUA, to which mail should be sent. Its value is constructed from your profile.

Address
This is your postal address. It is optional.

Phone
This is your office or home telephone number. It is optional.

Description
This is a simple description of you. It can include such things as job title, nicknames, project names, misspellings of names, or any other information that would be helpful in locating you. It is optional.

Each of these values, except for "organization", is contained in your profile; you can use the SET and SHOW commands to modify or display them.

See Also: modify query register

Ean Error Messages

A. If any of the messages in the following list are displayed, please contact your Ean administrator describing the commands you were entering and Ean's responses when the message was displayed.

Already exists.
Bad data element in message.
Bad field in message.
Bad message data.
Busy.
End!
Error! (see your Ean administrator)
Error accessing folder system.
Error backing up folder system.
Error copying message . . . : . . .
Error creating new folder system.
Error in message transfer process.
Error opening old folder system.
File system error. (see your local Ean administrator)
Gateway error.
Long integer overflow.
Message ... not delivered to ... : gateway error.
Message ... not delivered to ... : message conversion error.
Message ... not delivered to ... : message transfer error.
Message ... not delivered to ... : system error.
Message conversion error.
Message reception error.
Message transfer error.
No session with the MTA has been established.
Not found.
Overflow.
Page file error.
Protocol error.
System command execution error.
System error. (See your Ean administrator)
Unable to change password.
Unable to determine local MTA info.
...: undefined heading.
Unknown error! (must be a bug)
Wrong use.

B. Below are listed some of the messages displayed by Ean. Possible reasons for the message and suggested remedies are given. If these suggestions do not help, please contact your Ean administrator describing the commands you were entering and Ean's responses when the message was displayed.

Accepted and printed by . . .
This message is a receipt report for a message you sent and specified "confirm" as a send option.

Autoforwarded at address . . .
This message is returned to you if the recipient has the auto-forward profile option set to another mailbox.

. . . : bad file name.
Check that you have correctly typed the file name. You may have tried to "#include" a file which does not exist.

Bad message specification.
Please check the syntax of your message selector by consulting the section "Message-Selector".

Bad user profile.
Your profile file has been damaged. Edit your profile to repair the damage.

File . . . already exists.
You can LIST, PRINT, or SIZE on a file. This message tells you if the specified file already exists. You may choose to overwrite the file.

File system error.
Ean has not been able to open or read a file that it expected to be able to read. Consult your system manager for assistance.

Folder . . . does not exist.
Unlike files, folders are not automatically created when you refer to them. You must use the OPEN command to create a folder before you can use it.

Folder system locked. Should I run anyway?
You are already running Ean. The safest answer to the question is "No". If you do respond "Yes", you should not ACCEPT, FILE, or DELETE any messages until you are running Ean only once.

-- help index file...out of date - see your Ean administrator.
The specified index file is not synchronized with the help text file. The Ean administrator should execute the helpcomp program.

Invalid address.
Check that you have correctly typed the address. Check the address with the Directory Service by using the FIND command.

Invalid arguments: . . .
You may have omitted a symbol which is part of the command. For example, to select the history of a message, you need to enclose a single-message message selector in "[ | ]". And if you are LISTing or PRINTing items into a file, you need to precede the filename with "on" or "append". Check the syntax of the command.

Invalid date.
Ean does not accept any form of date that consists of numbers separated by slashes, dashes, or spaces, because there is no standard, accepted form. Please specify the date in some other way.

Invalid folder name: . . .
Folder names must conform to the rules of your operating system for naming files. Check the rules of your operating system for naming files.

Invalid heading name.
Check the header field name.

Invalid heading value.
Check for acceptable values for the header field.

Invalid user name in profile.
The name in your profile file has been damaged. Edit the file to repair it.

Missing argument.
You have omitted some item that must be specified as part of the command. The following table lists commands and their mandatory items:

    Command         Mandatory Item
    -------     --------------
    EXCHANGE    'header-field or body
    FIND        'NUN
    OPEN        'folder-name
    REMOVE      'folder-name
    SET         'profile-name
    XCHANGE     'header-field or body

Check the syntax of the command by referring to the appropriate command.

No help available for . . .
If you need more help than is provided by this Manual and the HELP command, see your Ean administrator.

No output file specified.
You must specify the name of the file into which items are to be LISTed, PRINTed, or SIZEd.

Not delivered to ... ( ... )
This message is a nondelivery report on a message you sent. If you no longer have a message with the number specified in the heading which appears before this message, it is likely that you deleted the message after you sent it. Various explanations may appear inside the parentheses of this nondelivery report:

    The address you gave is unknown to the MTA.
    Check that you have correctly typed the address.
    Check the address with the Directory Service by using the FIND
    command.

Message transfer error - expired. The message was not delived and it expired. The expiry period is one built into the MTA.

MTA congestion. Try sending the message again.

Number out of range.
This message is displayed when your message selector refers to messages by their numbers and there are no messages within that number range. This message is also displayed when you use the words "previous" or "next", and there are no messages before or after the current message, respectively.

Syntax error.
Please check the syntax of the command.

The folder is empty.
You do not have any messages in the currently open folder.

The message lacks a 'From' field.
The draft message that you are COMPOSing of SENDing does not have a "From" field. Use the EDIT or EXCHANGE commands to insert one.

The message lacks a 'To' field.
The draft message that you are COMPOSing, REPLYing, or SENDing does not specify a recipient. Use the EDIT or EXCHANGE commands to insert one.

There is already a draft message.
You have tried to COMPOSE or GET another message without using your current draft message. You can DELETE the draft message to continue.

There is an unsent or unfiled draft message.
You have tried to EXIT Ean and there is a draft message that has not been sent or filed. The draft message is destroyed if you EXIT Ean at this point. You may DELETE, FILE, or SEND it before EXITing.

There is no draft message.
You have tried to SEND a message and there is no draft. You can COMPOSE, GET, or REPLY to make a draft message.

User address or password rejected.
Consult your Ean administrator for assistance.

Unable to open folder file.
Consult your Ean administrator for assistance.

Unable to register.
The Directory Service already has an entry for your Name and Mailbox. Use the FIND command to retrieve information on who is registered. There either is someone else at your organization with the same registered Name or you are already registered. You may have to register under another name as duplicate names within an organization are not allowed. If you are already registered, issue a DROP command to remove yourself from the directory service. Then use the REGISTER command.

Undefined field.
Check that you are using the correct field name.

. . . : undefined heading.
Check the you are using an allowable message header.

-- unknown option in profile: . . .
You specified a profile option that is not recognized. See the Profile section and the SET command for more information on profile options.

Unmatched parenthesis.
Your message selector contains an unmatched parenthesis.

Unrecognized command -- type 'help' for help.
You specified a command that Ean does not recognize.

. . . : unrecognized keyword.
Please check the syntax of the command by referring to the appropriate command.

Warning: . . . is set.
This message is displayed if you have set the auto-forward or auto-reply profile options "on".

You are not allowed to remove your inbox.
You tried to REMOVE your inbox folder.

You cannot forward a message with non-normal sensitivity.
A message received with non-normal sensitivity can not be forwarded to another mailbox.

You can't forward a draft message.
Only ACCEPTed messages can be FORWARDed.

You can't reply to a draft message.
You can only REPLY to ACCEPTed messages.

You can't reply to a message that you sent.
You can only REPLY to ACCEPTed messages.

You did not specify a folder.
A 'folder-name must be specified when using the OPEN or REMOVE commands.

You did not specify any recipients.
A message that you are COMPOSing, FORWARDing, or SENDing must specify recipients. Use the EDIT or EXCHANGE commands.

You may not move the draft message.
The draft message can not be moved to a folder.

You must specify a value for this option.
A profile option that you are SETting must be given a value. See the Profile section or the SET command for information on the profile options.