inc

PURPOSE

     Incorporates new mail.

SYNOPSIS
     inc [+folder][-audit audit-file][-noaudit][-changecur]
         [-nochangecur][-form formatfile][-format string]
         [-file name][-silent][-nosilent][-truncate]
         [-notruncate][-width columns][-help]


DESCRIPTION

     The  inc command  is used  to incorporate  incoming mail.
     inc is part of the  MH (Message Handling) package and can
     be used with other MH and AIX commands.

     The inc command  takes all of the new  messages from your
     mail drop  and places them  in the specified  folder.  If
     the specified folder  does not exist, inc asks  you if it
     should be created.  inc  assigns the new messages consec-
     utive  message numbers  starting  with  the next  highest
     number in the  folder.  inc assigns the  new messages the
     protection code  specified in  the Msg-Protect:  entry in
     your .mh_profile.  If there is no Msg-Protect: entry, inc
     assigns  the messages  the protection  code of  644.  inc
     calls the  scan command to display  information about the
     new  messages.   If  the Unseen-Sequence:  profile  entry
     specifies  any sequences,  inc adds  the new  messages to
     each sequence.

FLAGS

     -audit file     Copies the current  date to the specified
                     file and appends the output from the scan
                     command to the file.
     -changecur      Sets the first new message as the current
                     message for  the specified  folder.  This
                     flag is the default.
     -file file      Incorporates messages  from the specified
                     file instead of the user's maildrop.
     +folder         Incorporates  the new  messages into  the
                     specified folder.  +inbox  is the default
                     folder.

     -form file      Displays the  scan command output  in the
                     alternate format described in file.
     -format string  Displays the  scan command output  in the
                     alternate format described by string.
     -help           Displays   help   information   for   the
                     command.
     -noaudit        Does not record  information about incor-
                     porating the new messages (see the -audit
                     flag).  This flag is the default.
     -nochangecur    Does  not  alter   the  setting  for  the
                     current message in the specified folder.
     -nosilent       Prompts the user for any necessary infor-
                     mation.  This flag is the default.
     -notruncate     Does not  clear the mailbox or  file from
                     which  inc is  taking  new messages.   If
                     -file  is specified,  -notruncate is  the
                     default.
     -silent         Does not prompt  you for any information.
                     This flag  is useful  for running  inc in
                     the background.
     -truncate       Clears the mailbox or file from which inc
                     is taking new messages.   If -file is not
                     specified, -truncate is the default.
     -width num      Sets the  number of  columns in  the scan
                     command output.  The default is the width
                     of the display.

PROFILE ENTRIES

     Alternate-Mailboxes:    Specifies your mailboxes.
     Folder-Protect:         Sets  the  protection  level  for
                             your new folder directories.
     Msg-Protect:            Sets  the  protection  level  for
                             your new message files.
     Path:                   Specifies your user_mh_directory.
     Unseen-Sequence:        Specifies  the sequences  used to
                             keep  track of  your unseen  mes-
                             sages.

FILES

     $HOME/.mh_profile        The MH user profile.
     /usr/lib/mh/mtstailor    The MH tailor file.
     /usr/mail/$USER          The location of the mail drop.

RELATED INFORMATION

     Other MH commands:  "mhmail," "post,"  "scan."

     The mh-format, mh-mail, and mh-profile files in AIX Oper-
     ating System Technical Reference.

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