Name: Telegraf/2 Network Messaging

File: TG2nnn.ZIP 

This version is: 1.4 as at 3rd May, 1999

What is it? A shareware, compiled VX-REXX drop-in replacement for OS/2 Network Messaging. 

Recommended for small NETBIOS peer networks on Warp up to approximately 10 stations eg SOHO and home LANs (mainly so that you don't have to worry about User address books)

Files in this archive:
TELGRAF2.EXE	Executable
TELGRAF2.TXT	Help file
README.TXT	This file
FILE_ID.DIZ	Brief description for BBS and sys admins

Tested with Warp 4; should also run under all flavors of Warp 3 but not tested.

Why "Telegraf/2"?
1. The telegraph was a significant technological advance over 2 cans and a piece of string.
2. Telegraph has 9 letters :(.
3. We can't copyright the word "Telegraph".
4. This is exclusively an OS/2 program so "/2" was a natural. (When you're on a good thing, stick to it!)
5. We checked on the Internet and couldn't find anyone else using "Telegraf/2" for anything.
6. Boring names like "REXX Network Messaging" or "Replacement for IBM Network Messaging" we can leave to the bureaucrats of IBM.

To install
~~~~~~~~~~
1. Prerequisites:
	Classic REXX (default with OS/2); should also run with Object REXX but not tested.
	VROBJ.DLL version 2.1d (widely available)
	RXEXTRAS.DLL (also widely available)
	Warp 4 or Warp Connect with NETBIOS networking installed

2. Create a home directory for Telegraf/2.

3. Unzip this archive into the home directory

4. No reboot required - just run the executable!

5. Create your own program reference object and install or shadow in your Startup folder.

6. Use the /MIN parameter for a minimized startup on boot.

To uninstall
~~~~~~~~~~~~
1. Close Telegraf/2

2. Delete the Telegraf/2 home directory

3. You're done. Restart with IBM Network Messaging

4 :-( We'll be sad, but it's your choice!


Operation
~~~~~~~~~
1. Apart from the message log file (by default <bootdrive>:\IBMLAN\LOGS\MESSAGES.LOG), the program does not change or create any file outside its home directory.

2. Telegraf/2 is a drop in replacement for IBM's Network Messaging and emulates the screens and popup boxes of the original. This means minimal relearning and maximum productivity.

3. New functions added to the original:
	a) Quick Reply button on popup window - you don't have to open the main window to reply.
	b) Remembers window position and size, split bar position - "set and forget" windows.
	c) Fast type-in of destination to send
	d) Default Reply To is the original Sender
	e) Message management:
		i.   Delete original after reply
		ii.  Delete message while viewing
		iii. Multiple selection for bulk deletion
		iv.  Up/Down movement buttons in message reading window
		v.   Mark any message as unread
		vi.  Distinct icons for read/unread
	f) Confirmation on close - user configurable
	g) Message statistics in title bar and OS/2 window list ** Registered version only **
	h) Starts requester service if necessary
	i) NO POPUP OVER A DOS OR OS/2 FULL SCREEN SESSION - only a beep, and a PM popup waiting for you when YOU choose to read it.
	j) Configurable Message Log file: defaults to <bootdrive>:\IBMLAN\LOGS\MESSAGES.LOG but you can have separate file/s if you wish
	k) Advance warning of message arrival: does not take focus immediately - popup waits up to 2 seconds
	l) Hook events - run a program when:
		i.   Telegraf/2 opens
		ii.  Telegraf/2 closes
		iii. A message is about to be broadcast
		iv.  A message is about to be sent (to a single user)
		v.   A message has just been sent
		vi.  The message file has changed - message arrived, logged message deleted etc

	Notes:
		iii and iv are passed 1 parameter - file name of file being sent.
		v is passed 1 if message sent OK, 0 if not
		vi is passed 1 if message arrived (in which case new message is last in the list) or 0 if not

4. Startup steps (so you don't get worried by the little windows and such):
	a) The VX-REXX Console appears briefly in the window list
	b) Telegraf/2 loads all necessary REXX functions and reports any errors
	c) If necessary the network is started
	d) Telegraf/2 then obtains message log file information. 
Steps c and d generate a window list entry such as '@NET LOG >TEMP1234.LOG'.
	e) The message log is loaded and the window list entry displays the total number of messages and the number unread (Registered version only).
	f) Without the /MIN option, the main window then opens.

5. What you won't see: Nag screens or crippleware. Everything that the program DOES, you can see in the unregistered version, but you get some extra information as a byproduct when you register.

Benefits of registering
~~~~~~~~~~~~~~~~~~~~~~~
1. Keep shareware alive!
2. Feel good about doing the right thing
3. Get the latest version
4. Help us to continue development
5. Programmers have to eat, too!
6. Get the message stats in the OS/2 Window List

How to register
~~~~~~~~~~~~~~~
1. Licence Cost: 
	- for home use (up to 4 machines) - $A25 (equal to approx $US16 or Euro15 as at late Apr 1999)
	- for corporate use (5 machines and above) - $A15 per machine to a maximum fee of $A300
	- all charges will be made in $A

2. Email to talldad@pobox.com.au with the following information:
	a) Your name
	b) Your email address
	c) Number of machines
	d) Payment details - Visa, MasterCard or Australian/New Zealand Bankcard 
		(if you prefer not to send details across the 'net, ask us for our fax number)
	e) Your registration name - please be precise! May be a corporate name for corporate use.

3. We will email you with a registration code (usually within 24-48 hours) plus the latest version.

4. Enter your selected name and the code into Telegraf/2:
	a) Open Telegraf/2 if necessary
	b) Select Options... Register from the menu bar
	c) Enter your registration name and the code we supplied
	d) Press OK. If the code does not match, check carefully and re-enter.

5. If you have any problems, which we consider unlikely (of course<g>), email us again.

6. Enjoy!

Who Are We?
~~~~~~~~~~~
Authors:
Specified by John Angelico (I'm the Dad) talldad@pobox.com.au 
Co-ordinator OS/2 SIG, Melbourne PC User Group Inc., Melbourne VIC Australia
OS/2 devotee from Ferengi days of OS/2 v2.1, now up to Warp 4 on 2 desktops and a ThinkPad 760EL 
Programmed by Christopher Angelico (no. 2 son age 15)
Developed using: VX-REXX 2.1 (thanks to Watcom, but we're sorry that they didn't survive)
Named by Michael Angelico (no 1 son age 17)
Occasionally watched by Stephen (no 5 son age 2)

(c) April 26, 1999 Melbourne VIC Australia 

Disclaimer
~~~~~~~~~~
This program will probably help you send messages more easily, reply more efficiently, and make you and your co-workers happier, but DON'T BLAME US IF THAT DOESN'T SOLVE ALL YOUR PROBLEMS. :)

As far as we know, this program won't do anything nasty to your system, but you use it at your own risk.

Version history
~~~~~~~~~~~~~~~
Version 1.3
Initial release to public

Version 1.4
Run a program on certain events
Icon changed to telegraph pole with envelope

Version 1.5
Save message as... menu item
Drag&Drop save message
