refile

PURPOSE

     Files messages in other folders.

DESCRIPTION

     The refile command  is used to copy and  move messages to
     other  files.   The refile  command  is  part of  the  MH
     (Message Handling)  package and can  be used with  MH and
     AIX commands.

     The refile command copies messages or moves messages from
     one folder  to another  folder.  If a  destination folder
     does  not exist,  refile  asks if  it  should create  the
     folder.

FLAGS

     -draft             Copies the current  draft message from
                        your mail directory.
     -file file         Copies the  specified file.   The file
                        must be in valid message format.  (Use
                        the  inc  command to  incorporate  new
                        messages  and  to   format  them  cor-
                        rectly.)

     +folder            Copies the  messages to  the specified
                        folder.  Any number  of folders can be
                        specified.
     -help              Displays  help   information  for  the
                        command.
     -link              Leaves  the  messages  in  the  source
                        folder or file after they are copied.
     -nolink            Removes the  messages from  the source
                        folder or file  after they are copied.
                        This flag is the default.
     -nopreserve        Renumbers   the   messages  that   are
                        copied.   Renumbering begins  with the
                        number  that is  one  higher than  the
                        last   message   in  the   destination
                        folder.  This is the default.
     -preserve          Preserves the  message numbers  of the
                        messages that are copied.  If messages
                        with  those   numbers  already  exist,
                        refile  issues  an error  message  and
                        does  not alter  the  contents of  the
                        folders.
     -src +folder msgs  Specifies the  messages to  be copied.
                        You can use the following message ref-
                        erences when specifying msgs:

                        num                    first                   prev
                        cur                    .                       next
                        last                   all                     sequence

                        The  default  message is  the  current
                        message in  the current folder.   If a
                        folder  is specified,  it becomes  the
                        current folder.  If the -link flag and
                        all are used, the current message does
                        not change.   Otherwise, if  a message
                        is specified, that message becomes the
                        current message.

PROFILE ENTRIES

     Current-Folder:    Sets your default current folder.
     Folder-Protect:    Sets the protection level for your new
                        folder directories.
     Path:              Specifies your user_mh_directory.
     rmmproc:           Specifies the  program used  to remove
                        messages from a folder.

FILES

     $HOME/.mh_profile    The MH user profile.

RELATED INFORMATION

     Other MH commands:  "folder,"  "folders."

     The  mh-profile file  in AIX  Operating System  Technical
     Reference.

     The "Overview  of the  Message Handling Package"  in Man-
     aging the AIX Operating System.