home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / tg2360.zip / Telgraf2.INF (.txt) < prev    next >
OS/2 Help File  |  2000-02-19  |  43KB  |  858 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Quick start ΓòÉΓòÉΓòÉ
  3.  
  4. There's no way to install but the quick way! See the Installation instructions 
  5. panel for details. 
  6.  
  7.  
  8. ΓòÉΓòÉΓòÉ 2. General information ΓòÉΓòÉΓòÉ
  9.  
  10. Telegraf/2 is a drop-in replacement for IBM's Network Messaging. 
  11.  
  12. See also: 
  13.  
  14.      Why "Telegraf/2"? 
  15.  
  16.      To install 
  17.  
  18.      To uninstall 
  19.  
  20.      Operation 
  21.  
  22.      Using the subject line 
  23.  
  24.      Compatibility with other messaging programs 
  25.  
  26.      Starting Telegraf/2 
  27.  
  28.      Who are we? 
  29.  
  30.      Disclaimer 
  31.  
  32.      The Popup Window 
  33.  
  34.      Version history 
  35.  
  36.  
  37. ΓòÉΓòÉΓòÉ 2.1. Why "Telegraf/2"? ΓòÉΓòÉΓòÉ
  38.  
  39.    1. The telegraph was a significant technological advance over 2 cans and a 
  40.       piece of string. 
  41.  
  42.    2. Telegraph has 9 letters :(. 
  43.  
  44.    3. We can't copyright the word "Telegraph". 
  45.  
  46.    4. This is exclusively an OS/2 program so "/2" was a natural. (When you're 
  47.       on a good thing, stick to it!) 
  48.  
  49.    5. We checked on the Internet and couldn't find anyone else using 
  50.       "Telegraf/2" for anything. 
  51.  
  52.    6. Boring names like "REXX Network Messaging" or "Replacement for IBM 
  53.       Network Messaging" we can leave to the bureaucrats of IBM. 
  54.  
  55.  
  56. ΓòÉΓòÉΓòÉ 2.2. To install ΓòÉΓòÉΓòÉ
  57.  
  58.    1. Prerequisites: 
  59.  
  60.           Classic REXX (default with OS/2); should also run with Object REXX 
  61.            but not tested. 
  62.  
  63.           VROBJ.DLL version 2.1d (widely available) 
  64.  
  65.           RXEXTRAS.DLL (also widely available) 
  66.  
  67.           Warp 4 or Warp Connect English version (NLS support coming) with 
  68.            NETBIOS networking installed 
  69.  
  70.    2. Create a home directory for Telegraf/2. 
  71.  
  72.    3. Unzip this archive into the home directory 
  73.  
  74.    4. No reboot required - just run the executable! 
  75.  
  76.    5. Create your own program reference object and install or shadow in your 
  77.       Startup folder. 
  78.  
  79.  
  80. ΓòÉΓòÉΓòÉ 2.3. To uninstall ΓòÉΓòÉΓòÉ
  81.  
  82.    1. Close Telegraf/2 
  83.  
  84.    2. Delete the Telegraf/2 home directory 
  85.  
  86.    3. You're done. Restart with IBM Network Messaging 
  87.  
  88.    4. :-( We'll be sad, but it's your choice! 
  89.  
  90.  
  91. ΓòÉΓòÉΓòÉ 2.4. Operation ΓòÉΓòÉΓòÉ
  92.  
  93.    1. Apart from the message log file (by default 
  94.       <bootdrive>:\IBMLAN\LOGS\MESSAGES.LOG), the program does not change or 
  95.       create any file outside its home directory. 
  96.  
  97.    2. Telegraf/2 is a drop in replacement for IBM's Network Messaging and 
  98.       emulates the screens and popup boxes of the original. This means minimal 
  99.       relearning and maximum productivity. 
  100.  
  101.    3. New functions added to the original: 
  102.  
  103.         a. Quick Reply button on popup window - you don't have to open the main 
  104.            window to reply. 
  105.  
  106.         b. Remembers window position and size, split bar position - "set and 
  107.            forget" windows. 
  108.  
  109.         c. Fast type-in of destination to send 
  110.  
  111.         d. Default Reply To is the original Sender 
  112.  
  113.         e. Message management: 
  114.  
  115.              1. Delete original after reply 
  116.  
  117.              2. Delete message while viewing 
  118.  
  119.              3. Multiple selection for bulk deletion 
  120.  
  121.              4. Up/Down movement buttons in message reading window 
  122.  
  123.              5. Mark any message as unread 
  124.  
  125.              6. Distinct icons for read/unread 
  126.  
  127.         f. Confirmation on close - user configurable 
  128.  
  129.         g. Message statistics in title bar and OS/2 window list ** Registered 
  130.            version only ** 
  131.  
  132.         h. Starts requester service if necessary 
  133.  
  134.         i. NO POPUP OVER A DOS OR OS/2 FULL SCREEN SESSION - only a beep, and a 
  135.            PM popup waiting for you when YOU choose to read it. 
  136.  
  137.         j. Configurable Message Log file: defaults to 
  138.            <bootdrive>:\IBMLAN\LOGS\MESSAGES.LOG but you can have separate 
  139.            file/s if you wish 
  140.  
  141.         k. Advance warning of message arrival: does not take focus immediately 
  142.            - popup waits up to 2 seconds 
  143.  
  144.         l. If multiple popup windows on screen, newest at back 
  145.  
  146.         m. Hook events - run a program when certain events happen ** Registered 
  147.            version only ** 
  148.  
  149.         n. Drag a message to Desktop to save, or select Message... Save As 
  150.  
  151.              1. Drag&Drop to Desktop/folder: 
  152.  
  153.                   a. If operation=Move (hold Shift), delete from container. 
  154.  
  155.                   b. Delete temporary file (so if operation=Link ie Ctrl+Shift, 
  156.                      removes shadow) 
  157.  
  158.              2. Drag to printer illegal 
  159.  
  160.              3. Drag to shredder deletes message(s) 
  161.  
  162.         o. Subject line 
  163.  
  164.         p. Mini window - simply click to show the main window, or use the popup 
  165.            menu to send a new message, close Telegraf/2, hide the miniwindow, 
  166.            or toggle the miniwindow's title bar (if on, you can move the window 
  167.            easily, but it doesn't look good). 
  168.  
  169.    4. Startup steps (so you don't get worried by the little windows and such): 
  170.  
  171.         a. The VX-REXX Console appears briefly in the window list 
  172.  
  173.         b. Telegraf/2 loads all necessary REXX functions and reports any errors 
  174.  
  175.         c. If necessary the network is started 
  176.  
  177.         d. Telegraf/2 then obtains message log file information. 
  178.            Steps c and d generate a window list entry such as '@NET LOG 
  179.            >TEMP1234.LOG'. 
  180.  
  181.         e. The message log is loaded and the window list entry displays the 
  182.            total number of messages and the number unread (Registered version 
  183.            only). 
  184.  
  185.         f. Without the /MIN option, the main window then opens. 
  186.  
  187.    5. What you won't see: Nag screens or crippleware. Everything that the 
  188.       program DOES, you can see in the unregistered version (except events; but 
  189.       that's advanced stuff), but you get some extra information as a byproduct 
  190.       when you register. 
  191.  
  192.  
  193. ΓòÉΓòÉΓòÉ 2.4.1. Using the Subject line ΓòÉΓòÉΓòÉ
  194.  
  195. If the first line of the message begins Subject: (case insensitive), the 'First 
  196. Line' column in the main window has the first non-blank line after that, and 
  197. the Subject line has the subject. 
  198.  
  199. When you reply, the subject is preserved - reply to message of subject Bug 
  200. report will have subject Bug report. 
  201.  
  202. Compatible with IBM's Network Messaging - NetMess will merely show Subject: 
  203. <subject> as the first line. 
  204.  
  205.  
  206. ΓòÉΓòÉΓòÉ 2.5. Compatibility with other messaging programs ΓòÉΓòÉΓòÉ
  207.  
  208. Telegraf/2 will run when IBM's Network Messaging is running on the same 
  209. machine, but you may experience some corruption of data such as date/time sent, 
  210. from name etc but it has never been found to corrupt the message text itself. 
  211.  
  212. Telegraf/2 will send messages to and receive messages from IBM's Network 
  213. Messaging (when running on separate machines) with no problems except that 
  214. Network Messaging does not recognize the Subject line (will show Subject: 
  215. <subject> as the first line). 
  216.  
  217. Compatibility with WinPopup not yet tested. 
  218.  
  219.  
  220. ΓòÉΓòÉΓòÉ 2.6. Starting Telegraf/2 ΓòÉΓòÉΓòÉ
  221.  
  222. The following parameters are valid when starting Telegraf/2 (put these in the 
  223. Parameters box for the program object if you wish): 
  224.  
  225.      /MIN for minimized startup on boot 
  226.  
  227.      /NOMINIFMSG cancels the effect of /MIN if there are messages 
  228.  
  229.       /NOMINIFMSG is useful if you don't have Telegraf/2 in the Startup folder 
  230.       and forget to start it. If a message arrives when Telegraf/2 is not open, 
  231.       you will hear a beep and nothing else. If you then start Telegraf/2 with 
  232.       both /MIN and /NOMINIFMSG, it will not minimize. However if there are no 
  233.       messages, /NOMINIFMSG is ignored. 
  234.  
  235.  All parameters are case insensitive, order insensitive and optional. 
  236.  
  237.  
  238. ΓòÉΓòÉΓòÉ 2.7. Who Are We? ΓòÉΓòÉΓòÉ
  239.  
  240. Authors: 
  241.  
  242.      Specified by John Angelico (I'm the Dad) talldad@pobox.com.au 
  243.  
  244.      Co-ordinator OS/2 SIG, Melbourne PC User Group Inc., Melbourne VIC 
  245.       Australia 
  246.  
  247.      OS/2 devotee from Ferengi days of OS/2 v2.1, now up to Warp 4 on 2 
  248.       desktops and a ThinkPad 760EL 
  249.  
  250.      Programmed by Christopher Angelico (no. 2 son age 15) 
  251.  
  252.      Developed using: VX-REXX 2.1 (thanks to Watcom, but we're sorry that they 
  253.       didn't survive) 
  254.  
  255.      Named by Michael Angelico (no 1 son age 17) 
  256.  
  257.      Occasionally watched by Stephen (no 5 son age 2) 
  258.  
  259.  (c) 1999-2000 Melbourne VIC Australia 
  260.  
  261.  
  262. ΓòÉΓòÉΓòÉ 2.8. Disclaimer ΓòÉΓòÉΓòÉ
  263.  
  264. This program will probably help you send messages more easily, reply more 
  265. efficiently, and make you and your co-workers happier, but DON'T BLAME US IF 
  266. THAT DOESN'T SOLVE ALL YOUR PROBLEMS. :) 
  267.  
  268. As far as we know, this program won't do anything nasty to your system, but you 
  269. use it at your own risk. 
  270.  
  271.  
  272. ΓòÉΓòÉΓòÉ 2.9. The Popup Window ΓòÉΓòÉΓòÉ
  273.  
  274. When a message comes in (and the popup on message arrival feature is active), a 
  275. window pops up on screen (where it was when you last closed it). For normal 
  276. messages, it shows the beginning of the message, but for replies it shows 3 
  277. lines of the reply, and then the new text (handy for replies to replies to 
  278. replies, where each time several lines were typed). 
  279.  
  280. Closing the window from the system menu leaves the message marked unread, but 
  281. clicking the Close button marks it read. 
  282.  
  283. The Reply button takes you immediately to the Send Message window to type a 
  284. reply. 
  285.  
  286. The Delete button deletes the message without requiring you to open the main 
  287. window. 
  288.  
  289. If there's already one or more popup windows on screen, the new one is placed 
  290. underneath the others. This means that (for example) if three messages arrive 
  291. before you notice them (eg if you're away from the computer), the oldest 
  292. message will be on top. 
  293.  
  294.  
  295. ΓòÉΓòÉΓòÉ 2.10. Version history ΓòÉΓòÉΓòÉ
  296.  
  297. So far, the versions of Telegraf/2 are: 
  298.  
  299.      Version 1.3 
  300.       (initial release; designed for small LANs) 
  301.  
  302.      Version 1.4 
  303.       (not released to public; laid groundwork for large LAN support) 
  304.  
  305.      Version 2.0 
  306.       (improved to support large LANs better; not released to public) 
  307.  
  308.      Version 2.1 
  309.       (greatly improved; first large LAN version released to public) 
  310.  
  311.      Version 2.11 
  312.       (on-line documentation added) 
  313.  
  314.      Version 2.2 
  315.       (on-line documentation improved greatly and converted to IPF format) 
  316.  
  317.      Version 3.0 
  318.       (made programmable) 
  319.  
  320.      Version 3.1 
  321.       (bugs removed, groundwork laid for some version 3.2 features) 
  322.  
  323.      Version 3.2 
  324.       (many features for the events) 
  325.  
  326.      Version 3.3 
  327.       (minor improvements and bug fixes) 
  328.  
  329.      Version 3.4 
  330.       (bug fixes and minor improvements to menu layout) 
  331.  
  332.      Version 3.5 
  333.       (popup window behind other popup windows) 
  334.  
  335.      Version 3.6 
  336.       (Read Message window bug removed; better debugging) 
  337.  
  338.  
  339. ΓòÉΓòÉΓòÉ 2.10.1. Version 1.3 ΓòÉΓòÉΓòÉ
  340.  
  341. Initial release to public 
  342.  
  343.  
  344. ΓòÉΓòÉΓòÉ 2.10.2. Version 1.4 ΓòÉΓòÉΓòÉ
  345.  
  346. Run a program on certain events 
  347.  
  348. Icon changed to telegraph pole with envelope 
  349.  
  350. Never released to public 
  351.  
  352.  
  353. ΓòÉΓòÉΓòÉ 2.10.3. Version 1.5 ΓòÉΓòÉΓòÉ
  354.  
  355. Save message as... menu item 
  356.  
  357. Drag-and-Drop save message 
  358.  
  359.  
  360. ΓòÉΓòÉΓòÉ 2.10.4. Version 2.0 ΓòÉΓòÉΓòÉ
  361.  
  362. Multiple send 
  363.  
  364. Save As... menu item (eg for import into another application) 
  365.  
  366. Subject line support 
  367.  
  368. Tab can be inserted into message send window (can't tab to buttons which all 
  369. have accelerators anyway) 
  370.  
  371. Configurable font/color in message send window 
  372.  
  373. Never released to public - beta version 
  374.  
  375.  
  376. ΓòÉΓòÉΓòÉ 2.10.5. Version 2.1 ΓòÉΓòÉΓòÉ
  377.  
  378. Mini window added 
  379.  
  380. Drag message(s) to shredder to delete 
  381.  
  382. About... dialog added 
  383.  
  384. Special broadcast options - to specified domain, to users of your resources 
  385.  
  386. Added Minimize button to confirm on close dialog for easy minimizing of 
  387. Telegraf (instead of closing) 
  388.  
  389.  
  390. ΓòÉΓòÉΓòÉ 2.10.6. Version 2.11 ΓòÉΓòÉΓòÉ
  391.  
  392. On-line documentation - press F1 for help on any object 
  393.  
  394. Not released 
  395.  
  396.  
  397. ΓòÉΓòÉΓòÉ 2.10.7. Version 2.2 ΓòÉΓòÉΓòÉ
  398.  
  399. Configurable font/color in every window with MLE (not only message send) 
  400.  
  401. On-line documentation converted to genuine IPF help - as in other OS/2 programs 
  402.  
  403. Modified Popup window to show 3 lines of original text in replies (see Popup 
  404. window for details) 
  405.  
  406.  
  407. ΓòÉΓòÉΓòÉ 2.10.8. Version 3.0 ΓòÉΓòÉΓòÉ
  408.  
  409. Made programmable with the User Defined Commands 
  410.  
  411. Tagline insertion added to Send Message window 
  412.  
  413. Configurable reply header 
  414.  
  415. Canned Reply feature 
  416.  
  417. Undelete message 
  418.  
  419. Signature insertion in message send 
  420.  
  421.  
  422. ΓòÉΓòÉΓòÉ 2.10.9. Version 3.1 ΓòÉΓòÉΓòÉ
  423.  
  424. Bugs removed 
  425.  
  426. Groundwork laid for highly complex events (added in v3.2) 
  427.  
  428.  
  429. ΓòÉΓòÉΓòÉ 2.10.10. Version 3.2 ΓòÉΓòÉΓòÉ
  430.  
  431. More events 
  432.  
  433. Multi-line event code 
  434.  
  435. More example events 
  436.  
  437.  
  438. ΓòÉΓòÉΓòÉ 2.10.11. Version 3.3 ΓòÉΓòÉΓòÉ
  439.  
  440. Bugs eliminated 
  441.  
  442. Stable release 
  443.  
  444.  
  445. ΓòÉΓòÉΓòÉ 2.10.12. Version 3.4 ΓòÉΓòÉΓòÉ
  446.  
  447. Bugs removed eg messages not marked as Read when using Up/Down in Read Message 
  448.  
  449. Menu layout fixed - new 'Settings' menu with some items from 'Options'; 
  450. 'Message'/popup menu hides invalid/illogical menu choices depending on 
  451. context/circumstances (eg no Delete Message if no message selected) 
  452.  
  453.  
  454. ΓòÉΓòÉΓòÉ 2.10.13. Version 3.5 ΓòÉΓòÉΓòÉ
  455.  
  456. When a message arrives, the popup window is placed behind any other message 
  457. popup windows. This means that if three messages arrive before you notice, the 
  458. oldest message is at the top and the newest at the bottom. 
  459.  
  460. Removed bug: If several messages arrived, Delete buttons on all popup windows 
  461. would delete newest message instead of current message. 
  462.  
  463.  
  464. ΓòÉΓòÉΓòÉ 2.10.14. Version 3.6 ΓòÉΓòÉΓòÉ
  465.  
  466. With the Read Message window, using Up, Down or Delete would disrupt the 
  467. program's record of the current message. Corrected. 
  468.  
  469. Debugging improved; see Things to Try if you've got a bug. 
  470.  
  471. Circular Up/Down in Read Message - if at top, Up goes to bottom, and if at 
  472. bottom, Down goes to top 
  473.  
  474.  
  475. ΓòÉΓòÉΓòÉ 2.11. Future enhancements ΓòÉΓòÉΓòÉ
  476.  
  477. More events - but you have to tell me what you want! 
  478.  
  479. NLS support - currently works only in English, as NET.EXE output is assumed to 
  480. be in English. 
  481.  
  482. Bug fixes if you inform me of bugs! 
  483.  
  484.  
  485. ΓòÉΓòÉΓòÉ 3. Known bugs ΓòÉΓòÉΓòÉ
  486.  
  487. Works only with the English version of OS/2. If run under non-English versions, 
  488. strange errors or incorrect operation will result. (For you programmers: the 
  489. NET commands are assumed to produce output in English. German, Danish, etc 
  490. appear different to the program and are not recognised.) NLS support is coming 
  491. in a future version. 
  492.  
  493. If two messages are received from the same computer at precisely the same date 
  494. and time, the program may be confused. Also, avoid having a back quote (`) in a 
  495. computer name (I think it's an invalid character, but I'm not sure). For you 
  496. who like the technical details, messages are given unique IDs of from`date`time 
  497. where from, date, and time are the sender, date sent, and time sent 
  498. respectively. 
  499.  
  500.  
  501. ΓòÉΓòÉΓòÉ 4. Bug reports etc ΓòÉΓòÉΓòÉ
  502.  
  503. Bug reports, requested features, questions etc all welcome. 
  504.  
  505. When you find a bug, 
  506.  
  507.    1. Check that it is not already in the Known Bugs section above. 
  508.  
  509.    2. If you have an old version, download the newest version and check the 
  510.       Known Bugs section (in case it has been reported but not fixed) and 
  511.       Version History (if it is fixed in a later version). 
  512.  
  513.    3. Note how you found it - if I know how to duplicate it, I'm half way to 
  514.       removing it. 
  515.  
  516.    4. Email talldad@pobox.com.au with: 
  517.  
  518.         a. Description of bug 
  519.  
  520.         b. How you found it 
  521.  
  522.         c. Anything you tried, successfully or otherwise, to fix it yourself. 
  523.            See Things to Try for ideas. 
  524.  
  525.         d. If possible, a variable dump. 
  526.  
  527.         e. Your reply-to details 
  528.  
  529.         f. Your Telegraf/2 version number, and registered/unregistered status 
  530.  
  531.         g. Other information eg version of OS/2, mixed OS/2 and Windows LAN or 
  532.            pure OS/2 LAN, size of LAN etc 
  533.  
  534.         h. Please put 'Telegraf' in the Subject line - this email address is 
  535.            used for the business as well, so there is a lot of mail. 
  536.  
  537.  If you have any question regarding Telegraf/2, or can think of a feature that 
  538.  you'd like to see in Telegraf/2, email us at talldad@pobox.com.au with 
  539.  'Telegraf' in the subject line. 
  540.  
  541.  
  542. ΓòÉΓòÉΓòÉ 5. Things to Try when you've got a bug ΓòÉΓòÉΓòÉ
  543.  
  544. If, when a message arrives, you hear a beep but get no popup (as if Telegraf/2 
  545. is not open), the Monitor thread may have closed for some reason. To see if 
  546. this is the case, try this: 
  547.  
  548.    1. From the Telegraf/2 Main Window, select the Debugging menu. 
  549.  
  550.    2. Select Threads from the Debugging menu. 
  551.  
  552.  You should get a message box with the title "Threads" and the text of the 
  553.  message all numbers. If the number 2 is there, everything's normal. If 2 is 
  554.  not there, the Monitor thread has gone. (Click here for sample message boxes 
  555.  that you will see.) 
  556.  
  557.  If you find this to be true, here are some things to try: 
  558.  
  559.      When a message arrives (you will always hear the beep), use Message... 
  560.       Reread message file and do yourself what the Monitor thread should do. 
  561.  
  562.      You can select Debugging... Restart Monitor thread. However, if you get a 
  563.       message box when you do that, it failed. 
  564.  
  565.      You can close and restart Telegraf/2. This should fix the problem, unless 
  566.       there's a REALLY bad problem. Check the Threads display again; if you've 
  567.       got 1 and 2, it's fixed; if you've only got 1, or you got a message box 
  568.       on startup, it's not. Either way, please email me as stated in Bug 
  569.       Reports. 
  570.  
  571.  If a white box appears in the corner of the screen, with a title starting with 
  572.  "VX-REXX Console", try this: 
  573.  
  574.      First, maximize the box by double-clicking the title bar. This will give 
  575.       you more room in the box. 
  576.  
  577.      If the beginning of the text is something like this: 
  578.  
  579.       Error! Please email the logfile (TELEGRAF.ERR) to the author. The 
  580.       information is duplicated here. 
  581.  
  582.       then you've got a REXX Syntax error inside Telegraf/2. See Handling 
  583.       Syntax Errors. 
  584.  
  585.      If it's not, please duplicate the information in an email (you should be 
  586.       able to use the OS/2 cursor movement and clipboard keys) so that I can 
  587.       help you solve the problem. See Bug reports above. 
  588.  
  589.  
  590. ΓòÉΓòÉΓòÉ 5.1. Handling Syntax Errors ΓòÉΓòÉΓòÉ
  591.  
  592. When Telegraf/2 detects a syntax error, it will create a white box in the upper 
  593. left corner of the screen (called the Console). This will display debugging 
  594. output from the program. 
  595.  
  596. There are several possible ways that an error may be reported by Telegraf/2. 
  597. Match output with these samples and take appropriate action. 
  598.  
  599.    1. Error! Please email the logfile (TELEGRAF.ERR) to the author. The 
  600.       information is duplicated here. 
  601.       Error code: 43 Routine not found 
  602.       Line: 53 
  603.  
  604.       (the numbers 43 and 53, and the message Routine not found may be 
  605.       different) 
  606.  
  607.       This means that Telegraf/2 could not read the REXX code out of its own 
  608.       .EXE file. You will also get a message box saying "Program is unreadable" 
  609.       - just click OK. 
  610.  
  611.       For this type of error, please email me (talldad@pobox.com.au) and 
  612.       include the two numbers (43 and 53 in this example). 
  613.  
  614.    2. Error! Please email the logfile (TELEGRAF.ERR) to the author. The 
  615.       information is duplicated here. 
  616.       Error code: 43 Routine not found 
  617.       Line: 53     interpret _VREEvent 
  618.       Now in DEBUG mode. Press ENTER to end debug mode. 
  619.         104 *-*  Nop; 
  620.           +++  Interactive trace. "Trace Off" to end debug, ENTER to Continue. 
  621.  
  622.       (again, the numbers and messages may differ) 
  623.  
  624.       This means that Telegraf/2 could read its own code. This type of report 
  625.       is far more helpful. If you live in Australia, and especially if you live 
  626.       in Melbourne (so the telephone call is cheap), the easiest solution might 
  627.       be to telephone me, and I'll do a direct analysis. Otherwise, here are 
  628.       some things that would help: 
  629.  
  630.         a. Record, as above, the two numbers. 
  631.  
  632.         b. Type (into the console) call dumpvars 
  633.  
  634.            This should produce output such as "Dumping variables to 
  635.            TG2VAR01.DAT..." (the number 01 may differ) 
  636.  
  637.         c. Record the filename. 
  638.  
  639.         d. Press Enter to exit debugging mode. 
  640.  
  641.         e. Send an email to talldad@pobox.com.au with the information suggested 
  642.            in Bug reports, plus the two numbers you recorded, and the contents 
  643.            of the TG2VARnn.DAT file. 
  644.  
  645.  
  646. ΓòÉΓòÉΓòÉ 6. Using Events ΓòÉΓòÉΓòÉ
  647.  
  648. Telegraf/2 allows you to run a REXX program on certain events. Put simply, this 
  649. means that when (for example) a message arrives, a REXX program will be run. 
  650. You can do a custom popup, play a .WAV file (if you have multimedia support, 
  651. this is easy from REXX), or anything else you like. 
  652.  
  653. Events available in Telegraf/2 as at time of writing are, by category: 
  654.  
  655.      General 
  656.  
  657.         -  Telegraf/2 Opening - run just before the main window opens when 
  658.            opened 
  659.  
  660.         -  Telegraf/2 Closing - after the Confirm on Close (if active), if the 
  661.            user REALLY wants to close, it does this first 
  662.  
  663.         -  Message file changed - if a message arrives, or is deleted, marked 
  664.            read/unread, or anything that changes the message file, this is 
  665.            called. One parameter - 1 if it really is a new message, 0 if not. 
  666.  
  667.      Message sending 
  668.  
  669.         -  Broadcast message - before a message is broadcast.
  670.  
  671.            One parameter (the name of a file holding the text to be sent; you 
  672.            can change this file). 
  673.  
  674.         -  Before send message - before a message is sent (with Send or Send 
  675.            Multiple, but not with Broadcast).
  676.  
  677.            Similar to Broadcast above. 
  678.  
  679.         -  After send message - after a message is sent.
  680.  
  681.            One parameter - Boolean value for success/failure. Executed once for 
  682.            each target on Send Multiple. 
  683.  
  684.         -  Double-click - when the text window (Multi-Line Entryfield, or MLE) 
  685.            is double-clicked. 
  686.  
  687.      Read Message 
  688.  
  689.         -  Double-click - when the MLE is double-clicked. 
  690.  
  691.      New Message popup 
  692.  
  693.         -  Double-click - when the MLE is double-clicked. 
  694.  
  695.  Events are enabled only when you register Telegraf/2. For further details, see 
  696.  How to Register. 
  697.  
  698.  
  699. ΓòÉΓòÉΓòÉ 7. How to Register ΓòÉΓòÉΓòÉ
  700.  
  701. To find out why you want to register, see Benefits of Registering. 
  702.  
  703.    1. Licence Cost: 
  704.  
  705.           for home use (up to 4 machines) - $A25 (equal to approx $US16 or 
  706.            Euro15 as at late Apr 1999) 
  707.  
  708.           for corporate use (5 machines and above) - $A15 per machine 
  709.  
  710.           all charges will be made in $A 
  711.  
  712.           Upgrade from previous version (eg 1.5 to 2.1, but not 1.3 to 1.5 - 
  713.            that's free) costs: 
  714.  
  715.              -  for home use - $A15 
  716.  
  717.              -  for corporate use - $A10 per machine 
  718.  
  719.    2. Email to talldad@pobox.com.au with the following information: 
  720.  
  721.         a. Your name 
  722.  
  723.         b. Your email address 
  724.  
  725.         c. Number of machines 
  726.  
  727.         d. Payment details - Visa, MasterCard or Australian/New Zealand 
  728.            Bankcard 
  729.  
  730.            (if you prefer not to send details across the 'net, ask us for our 
  731.            fax number) 
  732.  
  733.         e. Your registration name - please be precise! May be a corporate name 
  734.            for corporate use. 
  735.  
  736.    3. We will email you with a registration code (usually within 24-48 hours) 
  737.       plus the latest version. 
  738.  
  739.    4. Enter your selected name and the code into Telegraf/2: 
  740.  
  741.         a. Open Telegraf/2 if necessary 
  742.  
  743.         b. Select Options... Register from the menu bar 
  744.  
  745.         c. Enter your registration name and the code we supplied 
  746.  
  747.         d. Press OK. If the code does not match, check carefully and re-enter. 
  748.  
  749.    5. If you have any problems, which we consider unlikely (of course<g>), 
  750.       email us again. 
  751.  
  752.    6. Enjoy! 
  753.  
  754.  
  755. ΓòÉΓòÉΓòÉ 8. Benefits of Registering ΓòÉΓòÉΓòÉ
  756.  
  757.    1. Keep shareware alive! 
  758.  
  759.    2. Feel good about doing the right thing 
  760.  
  761.    3. Get the latest version 
  762.  
  763.    4. Help us to continue development 
  764.  
  765.    5. Programmers have to eat, too! 
  766.  
  767.    6. Get the message stats in the OS/2 Window List and title bar of the main 
  768.       window 
  769.  
  770.    7. Enable the events 
  771.  
  772.    8. Get free support 
  773.  
  774.    9. Free upgrades up to the next major version (register v2.9, but not 3.0, 
  775.       with the same code as v2.0) 
  776.  
  777.  Now, you just need to see How to Register (you do want all that, don't you?). 
  778.  
  779.  
  780. ΓòÉΓòÉΓòÉ 9. Tips and Tricks ΓòÉΓòÉΓòÉ
  781.  
  782. For those who don't believe in Murphy's Law, here are some tips and tricks: 
  783.  
  784.      To restore messages deleted with Delete All messages: 
  785.  
  786.       This works only in the registered version of Telegraf/2. 
  787.  
  788.       From the Telegraf/2 Main Window, select User Commands... Configure. 
  789.  
  790.       In the Caption field, type anything at all, meaningful or otherwise, but 
  791.       just don't leave it blank (and if you have two the same, you might be 
  792.       confused). 
  793.  
  794.       In the Code field, type 'REXX MESSAGES.0=3' (without the quotes), 
  795.       replacing 3 with the number of messages that you want to restore. 
  796.  
  797.       Click Add. 
  798.  
  799.       Click Save to save what you did, and Close to close the configuration 
  800.       window. 
  801.  
  802.       Select the User Commands menu, and from that menu the item you just 
  803.       created. The first 3 (or however many you chose to restore) messages 
  804.       should be restored. 
  805.  
  806.       Don't try this if you used Delete or Delete those Read to delete the 
  807.       messages. Use the Undelete command for those. 
  808.  
  809.       And remember, the author is not responsible for anything you do with his 
  810.       program. 
  811.  
  812.  
  813. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  814.  
  815. To make a variable dump (a very useful debugging tool): 
  816.  
  817.    1. Go to the Telegraf/2 main window. 
  818.  
  819.    2. Open the Debugging menu 
  820.  
  821.    3. Select Variable Dump 
  822.  
  823.    4. A file dialog will come up. Select a file to dump the variables into (it 
  824.       will be overwritten). 
  825.  
  826.    5. Attach this file to the bug report email. 
  827.  
  828.  
  829. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  830.  
  831. Ordinary: 
  832.  
  833. While sending: 
  834.  
  835. If Monitor thread gone: 
  836.  
  837.  
  838. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  839.  
  840. Murphy was an optimist. 
  841.  
  842. Murphy's Law states that "Anything that can go wrong, will go wrong." 
  843.  
  844. For example: 
  845.  
  846. The other queue will always move faster. 
  847.  
  848. Any failed appliance, when demonstrated for the repairman, will work perfectly. 
  849.  
  850. The probability that a piece of buttered bread will fall buttered side down is 
  851. proportional to the cost of the carpet. 
  852.  
  853. A $1000 TV set will protect a 5c fuse by blowing first. 
  854.  
  855. And many more. 
  856.  
  857. Silverman's law says that "If Murphy's Law can go wrong, it will." but that's a 
  858. different story!