ZAWAY(1)						      General Commands Manual							  ZAWAY(1)

NAME

       zaway - tell other people via Zephyr that you aren't around

SYNOPSIS

       zaway [ OPTIONS ] [ FILE ]

DESCRIPTION

       zaway  provides a way for you to automatically send replies when other people contact you using zwrite(1). zaway subscribes itself to class
       "MESSAGE", instance "*", so that it can monitor your incoming messages.	It does not affect the operation of  any  other  client  receiving
       messages.  zaway is typically run when you are leaving your terminal or display temporarily.  zaway usually never exits; when you return to
       your terminal you should type the interrupt character (usually ^C) in order to make zaway exit.

   OPTIONS
       -m STRING
	      Use STRING as the body of the auto-reply message.  Any message file (specified on the command line or the default) is ignored.

       -w     Watch the invoking user's location status.  If the user is locatable anywhere, no auto-replies will be sent.

       -h     Displays a short usage message and exits.

       zaway uses a message file (which defaults to $HOME/.away) to describe what reponses should be sent to which senders.  The general format of
       this file is:

	    >name
	    >name
	    message
	    >name
	    message

       Any  number of user names may be specified preceding the message to send to those senders.  If a user name appears more than once, the mes-
       sage will be a concatenation of each of the appropriate messages.  There are two special names: "*" indicates that  the	following  message
       should be sent to all senders and "%" indicates that the following message should only be sent if the user name has not matched yet.

       If no file is specified, and no default file can be found, the following message is returned:

	    I'm sorry, but I am currently away from the terminal and am not able to receive your message.

       If  a  user name does not match any of those listed in the file, and no "*" or "%" field is specified, no return message is sent.  All mes-
       sages are preceded by a signature "Automated reply:".  To avoid loops, messages are not sent in response  to  messages  beginning  with	an
       "Automated reply:" signature or sent by the same Kerberos principal as the user running zaway.

SAMPLE FILE

       >eichin
       >tony
       Hi there guys!  I'm in the other room right now.
       I'll be back in 5 minutes or so.
       >jruser
       Sorry, but I'm gone for the day...
       >%
       Hello...I'm not sure who you are.  I'll be back soon,
       though.
       >*
       This message comes to you compliments of zaway!

       The final "compliments" message will be included in all messages, whereas the "I'm not sure" message will only be included in messages that
       are not from "eichin", "tony", or "jruser".

FILES

       $HOME/.away

SEE ALSO

       zephyr(1), zwgc(1), zwrite(1), zhm(8), zephyrd(8)
       Project Athena Technical Plan Section E.4.1, `Zephyr Notification Service'

AUTHOR

       Robert S. French (MIT-Project Athena)

RESTRICTIONS

       Copyright (c) 1987,1988 by the Massachusetts Institute of Technology.  All Rights Reserved.
       zephyr(1) specifies the terms and conditions for redistribution.

MIT Project Athena						   July 1, 1988 							  ZAWAY(1)