NOTIFIER(1)

NAME
notifier - Reformatter for Code Manager mail notifications

SYNOPSIS
notifier

DESCRIPTION
The notifier command is a filter for the mail messages sent by Teamware when users have modified a workspace with the putback, bringover, or workspace commands. Instead of receiving a normal Teamware message with the subject:

    Code Manager notification

the notifier produces a message with a subject line containing useful information, such as:

    CodeMgr:putback-to:comet: Fix mail notification alias.

The format of the subject line is split into four fields:

    The string CodeMgr.

    The action taken (e.g. putback-to, bringover-to, rename)

    The workspace name (short form)

    The first 60 characters of the first line of the comment entered by the person performing the action.

The actual text of the mail message is unchanged by notifier, only the subject line is modified. This allows for effective use of e-mail filtering programs, and creation of useful hypertext archives of the notification mail, both of which are greatly impeded by all messages having the same subject line.

In order to use notifier, perform the following steps:

    Install the script somewhere on a server's filesystem, e.g. /opt/teamware/notifier

    Create a file called notify in the base directory of a workspace. The file should contain a comma-separated list of mail addresses to which the notification mail is sent.

    Create a mail alias entry in /etc/aliases on that server which runs the notifier script, e.g.

notifier: |/opt/teamware/notifier

    Run the newaliases command on the server to install the new notifier alias.

    Modify the workspace's Teamware notification file, Codemgr_wsdata/notification to point to the notifier alias, e.g.

notifier@server bringover-to putback-to undo

All further notification mail for this workspace will then be routed through the notifier which will re-format and forward it. For each additional workspace, you need only create the notify and edit the Codemgr_wsdata/notification files, assuming that the notification server can access the workspace through either a local or network file system.

FILES
Codemgr_wsdata/notification
notify
/etc/aliases

SEE ALSO
CodeManager User's Guide

bringover(1), putback(1), ws_undo(1), workspace(1), notification(5)

LEGAL DISCLAIMER
THIS SAMPLE PROGRAM IS BEING PROVIDED "AS IS" AND ONLY AS A COURTESY TO THE RECIPIENT. SUN MAKES NO WARRANTY OR REPRESENTATION, EITHER EXPRESS OR IMPLIED WITH RESPECT TO THIS SAMPLE PROGRAM INCLUDING QUALITY, PERFORMANCE, FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON- INFRINGEMENT. IN NO EVENT WILL SUN BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THIS SAMPLE PROGRAM.