Name: Telegraf/2 Network Messaging

File: TG2nnn.ZIP 

This version is: 2.2 as at 2nd June, 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	This file
README.TXT	Brief help 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
		** Registered version only **
	m) Drag a message to Desktop to save, or select Message... Save As
		i.   Drag&Drop to Desktop/folder:
			1. If operation=Move (hold Shift), delete from container.
			2. Delete temporary file (so if operation=Link ie Ctrl+Shift, removes shadow)
		ii.  Drag to printer illegal
		iii. Drag to shredder deletes message(s)
	n) Subject line (see below)
	o) Mini window - simply click to show the main window, or use the popup menu to send a new message, close Telegraf/2, hide the miniwindow, or toggle the miniwindow's title bar (if on, you can move the window easily, but it doesn't look good).

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 (except events; but that's advanced stuff), but you get some extra information as a byproduct when you register.

Using the Subject line
~~~~~~~~~~~~~~~~~~~~~~
If the first line of the message begins Subject: (case insensitive), the 'First Line' column in the main window has the first non-blank line after that, and the Subject line has the subject.

When you reply, the subject is preserved - reply to message of subject Bug report will have subject Bug report.

Compatible with IBM's Network Messaging - NetMess will merely show Subject: <subject> as the first line.

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 and title bar of the main window
7. Enable the events
8. Get free support
9. Free upgrades up to the next major version (register v2.9, but not 3.0, with the same code as v2.0)

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
	- all charges will be made in $A
	- Upgrade from previous version (eg 1.5 to 2.1, but not 1.3 to 1.5 - that's free) costs:
		- for home use - $A15
		- for corporate use - $A10 per machine

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
Never released to public

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

Version 2.0
Multiple send
Save As... menu item (eg for import into another application)
Subject line support
Tab can be inserted into message send window (can't tab to buttons which all have accelerators anyway)
Configurable font/color in message send window
Never released to public - beta version

Version 2.1
Mini window added
On-line documentation - press F1 for help on any object
Drag message(s) to shredder to delete
About... dialog added
Special broadcast options - to specified domain, to users of your resources
Added Minimize button to confirm on close dialog for easy minimizing of Telegraf (instead of closing)

Version 2.2
DDE support
Configurable font/color in every window with MLE (not only message send)

Version 2.3
On-line documentation converted to genuine IPF help - as in other OS/2 programs

Known bugs
~~~~~~~~~~
None as yet - new release, no reports.

Bug reports etc
~~~~~~~~~~~~~~~
Bug reports, requested features, questions etc all welcome.
When you find a bug,
	1) Check that it is not already in the Known Bugs section above.
	2) If you have an old version, download the newest version and check the Known Bugs section (in case it has been reported but not fixed) and Version History (if it is fixed in a later version).
	3) Note how you found it - if I know how to duplicate it, I'm half way to removing it.
	4) Email talldad@pobox.com.au with:
		a. Description of bug
		b. How you found it
		c. Anything you tried, successfully or otherwise, to fix it yourself
		d. Your contact details so I can email a reply when the bug is gone
		e. Your Telegraf/2 version number, and registered/unregistered status
		f. Other information eg version of OS/2, mixed OS/2 and Windows LAN or pure OS/2 LAN, size of LAN etc
		g. Put 'Telegraf' in the Subject line - this email address is used for the business as well, so there is a lot of mail.
If you have any question regarding Telegraf/2, or can think of a feature that you'd like to see in Telegraf/2, email us at talldad@pobox.com.au with 'Telegraf' in the subject line.
