scan

PURPOSE

     Produces a one line per message scan listing.

SYNOPSIS
     scan [+folder][msgs][-clear][-noclear][-form formatfile]
          [-format string][-header][-noheader][-width columns]
          [-help]


DESCRIPTION

     The scan command is used to display information about the
     messages in a  specified folder.  scan is part  of the MH
     (Message Handling) package and can  be used with other MH
     and AIX commands.

     The  scan command  displays a  line of  information about
     each  specified message  in the  specified folder.   Each
     line gives the message number,  the date, the sender, the
     subject, and as much of the message body as possible.  If
     a +  symbol is  displayed after  the message  number, the
     message is  the current message  for the folder.  If  a -
     symbol is displayed, you have replied to the message.  If
     a * symbol  is displayed after the date,  the Date: field
     was not present  and the displayed date is  the last date
     the message was changed.

FLAGS

     -clear          Clears the display  after sending output.
                     scan  uses the  values of  the $TERM  and
                     $TERMCAP environment  variables to deter-
                     mine  how  to   clear  the  display.   If
                     standard  output is  not a  display, scan
                     sends a formfeed  character after sending
                     the output.

     +folder msgs    Displays information about each specified
                     message in the specified folder.  You can
                     use the following message references when
                     specifying msgs:

                     num                    first                   prev
                     cur                    .                       next
                     last                   all                     sequence

                     The default folder is the current folder.
                     If a folder is  specified, it becomes the
                     current folder.  The  default for msgs is
                     all.
     -form file      Displays the  scan command output  in the
                     alternate format described by file.
     -format string  Displays the  scan command output  in the
                     alternate format described by string.
     -header         Displays a heading  that lists the folder
                     name and the current date and time.
     -help           Displays   help   information   for   the
                     command.
     -noclear        Does not clear the terminal after sending
                     output.  This is the default.
     -noheader       Does not display a  heading.  This 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.
     Current-Folder:        Sets your default current folder.
     Path:                  Specifies your user_mh_directory.

FILES

     $HOME/.mh_profile    The MH user profile.

RELATED INFORMATION

     Other MH commands:  "inc," "pick,"  "show."

     The  mh-format  and  mh-profile files  in  AIX  Operating
     System Technical Reference.

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