elm(1)                              CLIX                              elm(1)



  NAME

    elm - Runs an interactive mail system

  SYNOPSIS

    elm [-chmwz?] [-f alternate-folder] [-d debug-level] [-a] [alias ... ] [-t
    mail_type]

    elm [-s subject] recipient ...

  FLAGS

    -a     (Arrow).  Indicates the current message with the arrow cursor
           instead of the inverse bar.

    -c alias ...
           (Checkalias).  Expands the following aliases and exits.

    -d debug-level
           (Debug).  Sets the specified debugging level.  Sends output to the
           file $HOME/ELM:debug.info.  The debugging levels range from 1 to 9,
           where 1 has the least number of debugging messages and 9 having the
           most verbose output of internal message processing.

    -f alternative-folder
           (Folder).  Reads the specified folder rather than the incoming
           mailbox.

    -h
    -?     (Help).  Lists the starting options.

    -m     (Menu off).  Turns off the menu which appears at the bottom of the
           screen.

    -s subject
           (Subject).  Specifies the subject for the message to mail.  Note:
           sometimes the user must enclose a subject with multiple words with
           quotes to be interpreted correctly.  (This problem may occur due to
           the particular shell being used.)

    -t mail_type
           Specifies the nontext mail type.  The only types currently
           supported are text (0) and fax (1).  Either the mail type or the
           number may be used to specify the mail type.  For example, entering
           elm -t fax is the same as entering elm -t 1.

    -w     (Warnings.)  Turns off the warning messages.

    -z     (Zero).  Does not run elm if no mail is in the incoming mailbox.




  2/94 - Intergraph Corporation                                              1

  elm(1)                              CLIX                              elm(1)



  DESCRIPTION

    The elm command runs the Elm Mail System, which is an interactive,
    screen-oriented mailer.

    There are three main ways to use elm.  In the first way, no subject,
    address, or redirected file is specified on the command line, and elm runs
    in the standard, full-featured mode.

    The second way, used most commonly when transmitting files, is to redirect
    a file, specifying the subject and recipients of the message using the
    command line.

    The third way is to specify a list of addresses or aliases on the command
    line when the mailer is invoked.  This method, commonly referred to as the
    ``send only mode,'' allows a single message to be sent to the specified
    recipients.

  EXAMPLES

    1.  The following command runs elm in the standard, full-featured mode.

        elm

        It is then possible to read any messages in the incoming mailbox or a
        folder, reply to messages, and mail messages.

    2.  The following command initiates the sending of a message to the alias
        joe with the subject testing, and runs the default editor for the text
        of the message.  (The editor is specified in the .elm/elmrc file, or
        is set with the $EDITOR environment variable.  If an editor is not
        specified with either of these ways, the default editor is vi.)  If
        the subject is not specified using the -s flag, it will be prompted
        for within elm.

        elm -s testing joe


    3.  This example initiates the sending of a message which has a subject
        with four words, and is enclosed in quotes to prevent
        misinterpretation by the particular shell being used.

        elm -s "this is a test"


    4.  The following command mails a copy of the file test.c to alias joe,
        with the subject testing.

        elm -s testing joe < test.c





  2                                              Intergraph Corporation - 2/94

  elm(1)                              CLIX                              elm(1)



    5.  In this example, the user has defined jane as an alias for the address
        abcd!jane (The alias definition is in the .elm/aliases.text file.).
        This command expands the alias to show the full address.

        elm -c jane

        This output appears on the screen:

        Initializing internal tables...Expands to: abcd!jane (Jane Doe)


    6.  This example reads mail from the folder programs instead of the
        default incoming mailbox.

        elm -f programs


  FILES

    /usr/lib/elm/elm-help.*   Help files.

    /usr/lib/elm/aliases.text System alias source.

    /usr/lib/elm/aliases.hash System alias hash table.

    /usr/lib/elm/aliases.data System alias data table.

    $HOME/.elm/aliases.text   User alias source.

    $HOME/.elm/aliases.hash   User alias hash table.

    $HOME/.elm/aliases.data   User alias data table.

    $HOME/.elm/elmrc          Customized mailer parameters.

    $HOME/.elm/elmheaders     Customized message headers.

    $TMPDIR/snd.$$            Outgoing mail edit buffer.

    $TMPDIR/mbox.logname      Temporary mailbox.

    $HOME/ELM:debug.info      Debug output if turned on.

  DIAGNOSTICS

    The error messages are designed to be self-explanatory.

  EXIT VALUES

    The command exits with a value of 0 if successful.  If unsuccessful, the
    command exits with a value of 1.



  2/94 - Intergraph Corporation                                              3

  elm(1)                              CLIX                              elm(1)



  RELATED INFORMATION

    Commands:  newalias(1), checkalias(1), frm(1), printmail(1)

    The Elm User's and Reference Guides

















































  4                                              Intergraph Corporation - 2/94