DDTSAPPEND(1)

     NAME
          ddtsappend - append the given file to a defect

     SYNOPSIS
           ddtsappend bugid from title contents

     OPTIONS

           bugid     The defect to which the message needs to be
                     attached.

           from      The sender of the message (email address).

           title     The title of the intended enclosure.

           contents  The path to the file containing the message.

     DESCRIPTION
           ddtsappend is called by mail.in(1) to append a mail  message 
           to an enclosure in a defect.

           The script needs to append the file to the  enclosure of the
           given defect and to remove the file when  it has  completed.
           Locking must be taken care of by this script.

           If mail.in(1) is unable to find  ddtsappend, then mail.in(1)
           treats the  message like any other  confusing mail  message,
           and informs the Administrator.

     EXAMPLES
           A mail message sent to ddts (in  the  mailbox  that  mail.in
           reads), is checked  for the mail message  being in a special
           format and  containing  special  fields.  When  the  message
           doesn't meet these criteria, mail.in(1) checks the "Subject"
           field for a reference to a defect id on the local site.

         Subject: RE: BUGno05600 - We need to fix it. enclosure=ANALYSIS

           This example subject would work if the DDTS site had defect
           'BUGno05600' in the allbugs/00 directory.

           When the defect  id has  been found  on  the  current  site,
           mail.in   searches   the  subject   line  for   the   string
           "enclosure=", and sets the title to  the following word.  If
           there is a problem finding the title, then the default title
           will be set to "mail_log".

     CAVEATS
           ddtsappend will not  be  invoked  if the  sender is  'root',
           'postmaster', 'mailer-daemon', 'daemon', 'mail', or starts
           with 'ddts'.  This precaution is to ensure that notification
           mail sent by DDTS (see bugmail(1)) does not get  appended to
           those defects.

           ddtsappend is forked off by mail.in and there  is no way for
           mail.in to regain  control of  the message  after ddtsappend
           has been called.

     SEE ALSO
          mail.in(1)