home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / t / term93 / Term93 / !Term93 / !Manual / Manual < prev    next >
Encoding:
Text File  |  1994-12-08  |  37.8 KB  |  1,027 lines

  1. !Term93 v2.66b onward
  2.  
  3. Please report any bugs with details of how to reproduce them if possible.
  4.  
  5.  
  6.                    *** Use RISC OS 3 or greater ONLY ***
  7.                    -------------------------------------
  8.  
  9.                         What you need to get going.
  10.                         ---------------------------
  11.  
  12. An Acorn 32 bit machine etc. TNC and suitable radio etc.
  13.  
  14.  
  15.                   MAKE A BACKUP               >>>> NOW <<<<
  16.                   -------------               -----===-----
  17.  
  18.  
  19. NOTE ! This program was written to run on and requires RISC OS 3.1 
  20. (or >3.1 ?)
  21.  
  22.  
  23.  
  24.  
  25.                         Wiring the TNC to Archimedes lead. 
  26.                         ----------------------------------
  27.  
  28. Some of the older Archimedes badged machines had real problems with the
  29. serial port then Acorn introduced the field change order mentioned below to
  30. correct this problem. If this change has not been carried out and you have
  31. problems then it may pay you to visit your dealer.
  32.  
  33. If the serial chip field order has been carried out on the
  34. A300 series - the Acorn reference is FCO-2003, (replacement of C65SC51
  35. serial chip) - then the connections below should work.
  36.  
  37.  ARC 9-WAY D CONNECTOR         TNC 25-WAY D CONNECTOR        TNC 9-WAY CONN.
  38.      
  39.  No connection                 1 Cable screen (optional)     No connection
  40.  3 TXD                         2 TX data                     3 TX data
  41.  2 RXD                         3 RX data                     2 RX data
  42.  7 RTS }                    {* 4 RTS                         7 RTS
  43.        }                    { 20 DTR
  44.  8 CTS                         5 CTS                         8 CTS
  45.  5 Signal gnd                  7 Signal gnd                  5 Signal gnd
  46.  1 DCD}
  47.  4 DTR} All linked together    No connection                 No connection
  48.  6 DSR}
  49.  9 Ring indicator            # 8 Connect status (optional)   ** No connection
  50.  
  51. * Some TNCs like the PK use pin 4 (RTS) for the handshake input, whereas
  52.   others like the BSX2 use pin 20 (DTR) instead. So, if you make up a cable
  53.   with RTS from the Micro connected to both 4 and 20 on the TNC, then it
  54.   should be suitable for any TNC you are likely to use.
  55.  
  56. # This connection is not actually required all programs, but you may wish
  57.   to use it to preserve compatibility with all software. It is used by !Term93.
  58.  
  59. ** On any TNC where the "Connect status" is not reflected by a pin on its rs
  60.    port it should be noted that some facilities in the program will not work
  61.    fully, the main effect is that commands to the tnc cannot be sent while
  62.    connected.
  63.  
  64. On my elderly A310 I use the following connections.
  65.  
  66. Archimedes                              TNC 25-WAY D CONNECTOR
  67.                                         Pin 1 Cable screen (optional)
  68. Pin 1+4+8 connected together.           NONE TO TNC !
  69. Pin 2                                   Pin 3
  70. Pin 3                                   Pin 2
  71. Pin 6                                   Pin 5
  72. Pin 5                                   Pin 7
  73. Pin 7                                   Pin 4
  74. Pin 9 (ring indicator)                  Pin 8 (connect status on most tnc's).
  75.  
  76.  
  77.  
  78.                         Communication with the computer.
  79.                         --------------------------------
  80.  
  81. To change the baud rate etc. Click on the entry "Set serial" in the icon bar
  82. menu, reading the section "Setting the serial port" may prove usefull.
  83.  
  84.  
  85.  
  86.                         DESKTOP (ICON BAR) MENU INSTRUCTIONS.
  87.                         -------------------------------------
  88.  
  89. Info            : Click on here for the usual info box.  
  90.  
  91. Quit            : Click on here to remove !Term93 from the icon bar ***. 
  92.  
  93. To run !Term93 click on the icon-bar icon with 'select' i.e. the left hand
  94. mouse button (assuming its tail is pointing away you !).
  95.  
  96. Tnc cmd:   ⇨    : See 'Tnc menu' section.
  97.  
  98. Connect to ⇨    : See 'connect to' section.
  99.  
  100. Misc.      ⇨    : See 'Misc menu' section.
  101.  
  102. Review          : Opens the review window only.
  103.  
  104. TX window       : Opens the transmit window only.
  105.  
  106. RX window       : Opens the receive window only.
  107.  
  108. Log window      : Opens up the log window (see later section on the log).
  109.  
  110. Set Serial      : Set up the serial port parameters.
  111.  
  112. Search          : See the 'Search' window section and also using the tx window.
  113.  
  114. TX misc         : See the 'Using the TX misc' window section.
  115.  
  116. TNC cmd         : See the Using the 'TX misc' window section.
  117.  
  118. Cmd line        : See the Using the 'Cmd line' window section.
  119.  
  120. Password        : This allows the user to log on to a BBS and send/verify
  121.                   his or her password. (Not working yet).
  122.  
  123. Close all       : Close ALL wondows.
  124.  
  125. *** Objections will appear if you have a file open, are transmitting a file,
  126. have not saved the receive buffer or are connected, the latter depends on
  127. the rs port ring indicator being wired up.
  128.  
  129.  
  130.  
  131.                                                    
  132.  
  133.  
  134.                         'MISC. MENU' section.
  135.                         ---------------------
  136.  
  137. Abort tx        : Abandon a file transmit.
  138.  
  139. TX File         : Any file may be dragged from a directory viewer to a !Term93 window or to the 
  140.  
  141.                   Files dragged directly from !Edit are temporarily stored
  142.                   in the directory "!Term93.Temp" as a file called "Temp",
  143.                   this file is deleted after sending or on a transmit abort
  144.                   command. The only thing to remember here is that you MUST
  145.                   have enough room on the disc containing !Term93 to store
  146.                   the "temp" file.
  147.  
  148. Review          : Open the review the buffer window.
  149.  
  150. RX Buffer       : Toggle the receive buffer. The number of lines left is
  151.                   shown in the tx window.
  152.  
  153. Empty buffer    : Obvious really. Confirmation is required.
  154.  
  155. Buff ­> Edit    :Transfers the text (if any) in the rx buffer to !Edit
  156.                  running !Edit if necessary.
  157.  
  158. Save/Spool      : Open the save and spool to disc control window.
  159.                   Dragging the buffer save icon saves the contents of the
  160.                   buffer immediatly but dragging the spool to disc icon ONLY
  161.                   sets up the filename and path. The spool file is ONLY
  162.                   opened or closed by clicking on the "Spool ON/OFF" icon or
  163.                   by using the hot-key combination ^F.
  164.                   
  165.                   If the filename already exists the new text is appended
  166.                   with a new line inserted which reads
  167.                   "**** Appended file *** on "+ the current date/time string.
  168.  
  169.                   The length in bytes of the spool file is shown in the tx
  170.                   window along with the size of the file. 
  171.  
  172.                   To explain, say you have opened a spool file using a unique
  173.                   name then both figures will be the same. Now should you open
  174.                   a file with the same name as an existing file and the new
  175.                   text is being appended to that file then the first figure
  176.                   shows the amount of new text, the second figure shows the
  177.                   overall size of the file.
  178.  
  179.                   A 'true' save i.e. to disc will result in the rx buffer being
  180.                   emptied but the memory is not recaimed unless you 'zero' the 
  181.                   buffer with the buffer closed.
  182.  
  183.                   'Save matched only' A save to disc or drag to !Edit will
  184.                   consist only of lines containing the text in the writeable
  185.                   icon in the 'search' window. It should be noted that the
  186.                   'search text' looked for is ONLY that which is (or was if
  187.                   you have changed it) present in the writeable icon in the
  188.                   'search' window when a count was last done. What this
  189.                   means is that you should do a 'count' from the 'search'
  190.                   window before doing a 'matched' save.
  191.  
  192.                   To put it another way. To do a save consisting of lines
  193.                   that contain the search text only and be confident it is
  194.                   up to date then proceed as follows.
  195.  
  196.                   Open the 'search' window.
  197.                   Click on 'count'.
  198.                   Click on 'Open save box'
  199.                   Click on 'Save matched only'.
  200.                   Save as required.
  201.  
  202. Notify          Notify the operator of a connect status
  203.  
  204. Active          Enable (if ticked) or disable receive. This does allow another terminal
  205.                 program to operate alongside !Term93.
  206.  
  207. Filter high     Filter out all characters of a value over 127(i.e. ~) except delete.
  208.  
  209. Filter low      Filter out all characters of a value under 32(i.e. space) except newline.
  210.  
  211.                 When filter high or low are set characters filtered out are NOT included
  212.                 in the receive buffer but ARE INCLUDED in a "spool to disc" file. This
  213.                 means that to save 7Plus and other files which include certain characters
  214.                 you MUST spool to disc or you will loose them !
  215.  
  216. Set Misc.       Open a window to set/save filter,if tnc is an all mode unit, notify,
  217.                 auto-logging (Logging) and buffer defaults.
  218.                 Note that the buffer toggle icon does not set the rx buffer on, the
  219.                 settings must be saved before becoming the defaults.
  220.  
  221. Amtor call      Sends the file "!Term93.All_Mode.AM_call" to the tnc. This is for use with
  222.                 an All Mode unit, note that the file "AM_call" MUST EXIST and MUST NOT 
  223.                 be renamed if it is to be used. This selection is 'greyed out' if allmode
  224.                 is off in the above selection.
  225.  
  226. Help            Click on the "Click to read user guide icon".
  227.  
  228. Set time        Set the tnc time, an error will appear if this command is issued while 
  229.                 connected.
  230.  
  231. Logging         Toggles auto-logging on/off (see later section on the log).
  232.  
  233. Send *          Send an asterisk to the tnc, for use when the tnc is on autobaud.
  234.  
  235. Save windows    Clicking on here saves the position of all the regularly used windows.
  236.                 The saved positions are then the default. 
  237.                 The windows whos positions are saved are:
  238.  
  239.                         Receive
  240.                         Transmit
  241.                         Connected
  242.                         Savebox
  243.                         Filter
  244.                         Log
  245.                         Search
  246.                         Command
  247.                         Misc.
  248.                         Password
  249.                         Cmd line
  250.                         Review
  251.                         
  252.  
  253.  
  254.  
  255.  
  256.  
  257.                         'Connect to' Menu section.
  258.                         --------------------------
  259. See note ###
  260.  
  261. This menu is constructed from entries found in the file "!Term93.User_1.Calls"
  262. this file MUST NOT BE RENAMED and MUST EXIST WITH AT LEAST ONE ENTRY.
  263. Lines should be no longer than 12 characters and contain at least one space.
  264.  
  265. Example file.
  266.  
  267. | All callsign lines including the 'C' or 'XC' must not be greater than 
  268. | 12 characters in length. Note that this includes spaces.
  269. C G6IBO
  270. C G0BMS
  271. C G0BMS-8
  272. XC GB7OPC
  273. C 1 G0SOQ
  274. C G6AKC
  275. C G4RQN-3
  276.  
  277. Note ### : Commands to the tnc selected from this menu may be sent while
  278. connected but will not work properly if the rs port 'ring indicator' is not
  279. wired up.
  280.  
  281.  
  282.  
  283.  
  284.  
  285.                         'TNC cmd:' menu section.
  286.                         ------------------------
  287.  
  288. See note ###
  289.  
  290. For info on the entry 'User files' see 'User files' section.
  291.  
  292.  
  293. This menu is constructed from entries found in the files 
  294. "!Term93.User_1.Commands" and "!Term93.User_1.Monitor" these files MUST NOT
  295. BE RENAMED and MUST EXIST WITH AT LEAST ONE ENTRY. Lines should be no longer
  296. than 12 characters and contain at least one space.
  297.  
  298. Example file.
  299.  
  300. | All command lines must be 12 characters or less in length.
  301. | Note that this includes spaces.
  302. MH L
  303. NDH L
  304. Status
  305. Display
  306. CMSG ON
  307. CMSG PBBS
  308.  
  309. Example file.
  310.  
  311. | The following lines are the actual commands sent to your tnc
  312. | to switch the monitor levels. The first line of each pair
  313. | switches that level ON and the second switches it OFF.
  314. | Edit as required.
  315. Mon off/on
  316. Mon off/off
  317. MCON off/on
  318. MCON off/off
  319. MCOM off/on
  320. MCOM off/off
  321.  
  322. Note ### : Commands to the tnc selected from this menu may be sent while
  323. connected but will not work properly if the rs port 'ring indicator' is not
  324. wired up.
  325.  
  326.  
  327.  
  328.  
  329.  
  330.                        'Setting the serial port'
  331.                         -----------------------
  332.  
  333. In this window all the normal serial port parameters can be set up.
  334.  
  335. The baud rate.  Baud rates from 300 to 19200 are supported.
  336. Control.        CTS/RTS (hardwired and recommended) or Xon/Xoff can be selected.
  337. Bits.           The word length may be 7 or 8 bits. Note that an 8 bit
  338.                 (AWLEN 8) word length is required for 7+.
  339. Parity.         Parity can be none, even or odd.
  340.  
  341. Most likely you will want to use 9600 baud, 8 bits, 1 stop bit and no
  342. parity, commonly known in the IBM world as 8N1.
  343.  
  344. Some of you may find problems with TNC's such as th PK88 where the 'connect
  345. status' although shown at the TNCs' pin 8 is inverted when compared with the
  346. Kam units such as I use here. You should invert the 'connect sense' if when
  347. you have 'notify' enabled it fails to work and commands from the TNC
  348. commands menu sent when connected are transmitted. The automatic logging
  349. facility will also fail to work under such circumstances.
  350.  
  351. !Term93 (b versions) use the block drivers system by Hugo Fiennes which
  352. allows for the selection of different driver software to suit the situation
  353. and equipment. !Term93 can use the following drivers.
  354.  
  355. !Term93.Modules.Econet
  356. !Term93.Modules.II_Dual
  357. !Term93.Modules.Internal
  358. !Term93.Modules.Internal2
  359. !Term93.Modules.InternalPC
  360. !Term93.Modules.PipeA
  361. !Term93.Modules.PipeB
  362. !Term93.Modules.SP_Dual
  363. !Term93.Modules.SP_DualPC
  364. !Term93.Modules.Telnet
  365. !Term93.Modules.Term93
  366.  
  367. Multi-port users can set the port number (0 to 15) by clicking on the arrow
  368. beside the "Use driver port", this information is saved along with the other
  369. parameters.
  370.  
  371. Should you be need further information then feel free to read the file 
  372. "!Term93.Modules.BlockSpec".
  373.  
  374. For example you can run one copy of !Term93, click on 'set serial' in the
  375. main menu and in the serial setup window click on the up arrow across from
  376. the word "driver" until the word "PipeA" appears in the centre icon.
  377. Click on 'Accept and use' or on 'save as defaults' if you wish it to be the
  378. permanent default.
  379.  
  380. Now repeat the above with a secoond copy of !Term93 but this time choose "PipeB".
  381.  
  382. Now memory permitting run a third copy but this time choose the Term93
  383. driver. You should find that the first two copies of term93 will talk to
  384. each other whilst the third one communicates with the TNC !
  385. Perhaps this is not too usefull but it does demonstrate the system.
  386.  
  387.  
  388.                 ************************  WARNING ************************
  389.  
  390.                 The selection of the various block drivers should perform
  391.                 without error but be warned that a few of the block-
  392.                 drivers have NOT BEEN TESTED with !Term93. Any errors or
  393.                 problems will be of interest to me especially how well 
  394.                 !Term93 performs when used with a dual serial port card as
  395.                 I do not have access to one even for testing. PLEASE get
  396.                 the network sysop's permission before attempting to use the
  397.                 Econet block driver (assuming you are on a network).
  398.  
  399.                 ************************  WARNING ************************
  400.  
  401.  
  402.  
  403.                         'User files' section.
  404.                         ---------------------
  405.  
  406. This submenu is constructed from the filenames found in the directory
  407. "!Term93.User_2"
  408.  
  409. The files in this directory should be 'text' (&FFF) type written using !Edit
  410. and should only contain lines that can be sent to your modem or tnc without
  411. any modification by the program. You are free to use any 'legal' filename
  412. you wish.
  413.  
  414. Selecting any one of these entries from the menu results in the file being
  415. sent to your tnc line by line.
  416.  
  417. If you do not wish to use this function and want to free the disc space then
  418. leave at least one file (which may be of zero length) in this directory.
  419.  
  420.  
  421. One of these files MUST EXIST !
  422.  
  423. There is a file in "User_1" that is called "footer" this file MUST NOT be
  424. renamed and MUST contain the name of the file in "User_2" that contains your
  425. footer text, let us call that file "footer" and write the word "footer" as
  426. that first line in the file "User_1.footer". Confused ? then read on.
  427.  
  428. Note that the file "User_2.footer" will not appear in the menu with the
  429. other files in "User_2" as it was never designed to be sent directly. 
  430. "User_2.footer" is sent by the character Ú (ALT218), see below.
  431.  
  432. The lines of text in 'footer'are automatically centred at transmit time, if
  433. you want an option to this then please let me know and I will see if I can
  434. include it.
  435.                    ---------------------------------------
  436.  
  437. The file "footer" MUST NOT CONTAIN BLANK LINES (use a space if necessary) as
  438. this causes a "STREAMSWITCH" error on my Kam All Mode.
  439. This may not apply to other tnc's.
  440.  
  441. The file footer is sent if the character Ú is seen as the ONLY character in
  442. a transmit line (i.e. in the tx window) or as the ONLY character in a line in a
  443. file to be transmitted. When this character is seen the file "footer" is
  444. transmitted.
  445.  
  446. In the directory "!Term93.user_1" is a file also named footer, DO NOT change
  447. this files name but the contents can be changed and they should be the name
  448. of the footer file in the directory "!Term93.user_2".
  449.  
  450. One suggested use is as follows :
  451.         
  452. A number of messages are prepared for sending using !Edit and could take the
  453. following format
  454.  
  455. SP G4RQN @ GB7OPC
  456. Message 1
  457. Text of message.
  458. Ú
  459. SP G4RQN @ GB7OPC
  460. Message 2
  461. Text of message.
  462. Ú
  463. SP G4RQN @ GB7OPC
  464. Message 3
  465. Text of message.
  466. Ú
  467.  
  468. Each time the Ú character is seen the file "footer" will be inserted.
  469. The last Ú should be followed by pressing the <Return> key.
  470.  
  471. The character Ú is aquired by holding down either <Alt> key and pressing in
  472. turn the keys 2 1 and 8 on THE NUMERIC KEYBOARD, then release the <Alt> key.
  473.  
  474. If at the right hand end of a line of text in the file "footer" the text
  475. "{TIME}" is included (at the right hand end only) the currect time/date text
  476. will be inserted.
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.         On starting !Term93 two windows open, they are 'receive' and 'transmit'.
  485.         ------------------------------------------------------------------------
  486.  
  487.  
  488.  
  489.  
  490.                                 Using the tx window.
  491.                                 --------------------
  492.  
  493.  
  494.  
  495.                 If the tx window has the caret (yellow surround) then any
  496.                 character with a value lower than 32 (i.e. < a space) will
  497.                 immediatly be transmitted to the tnc. This allows the user
  498.                 to send characters such as ControlC (^C) ControlZ (^Z) etc.
  499.                 Pressing the <Escape> key sends the character value 27.
  500.                 These characters are NOT followed by a return character
  501.                 you have to do that if required. However a few have been
  502.                 taken for use as hot-keys and they are:
  503.                 2       ^B          
  504.                 5       ^E
  505.                 6       ^F
  506.                 15      ^O
  507.                 18      ^R
  508.                 23      ^W
  509.                 (^ means either <Ctrl> key)
  510.  
  511.  
  512. In the tx window there are 6 lines for the input of text to transmit, they
  513. react as follows.
  514.  
  515. At the first space after the 65th character a carriage line is inserted to
  516. allow continous typing while you look for the keys ! After the 79th
  517. character on continous lines.
  518.  
  519. The caret may be moved up and down with the cursor keys and will go to the
  520. end of any line with less than 79 characters in it, on lines with 79+
  521. characters the caret will move to the start of the line, moving it to the
  522. end of full lines will cause that line to be transmitted.
  523.  
  524. All lines react in the usual way to delete, copy, control+left or right
  525. cursor keys and clear with control+U.
  526.  
  527. When the tx window has the caret the following keys are active.
  528. (^B Means to hold down a control key and whilst doing so pressing
  529. one other key, in this case the letter "B")
  530.  
  531.         f1      Brings up the help window.                      
  532.         f2      Toggles the receive buffer.                     
  533.         f3      Opens the 'save as' window.
  534.         f4      Will attempt to save as much from the receive screen as 
  535.                 there is room in the receive buffer.
  536.         f5      Will copy the contents of the receive buffer into an !Edit
  537.                 window, running !Edit if necessary. Subsequent saves will
  538.                 open a further !Edit window if one is already open.
  539.         f6      Transmit a previously dragged file.
  540.         f7      Toggles whether transmit text is sent to the rx buffer.
  541.         f8      Opens the 'Search' window if there is anything in the
  542.                 rx buffer.
  543.         f9      Sends a file WHICH MUST BE CALLED "!Term93.User_2.On_Line"
  544.                 to your TNC.
  545.         f10     Sends a file WHICH MUST BE CALLED "!Term93.User_2.Off_Line"
  546.                 to your TNC.
  547.         ^f6     (<Ctrl>+f6) Will abandon a current file transmit.
  548.         f11     Toggles rx buffer.
  549.         ^B      Toggles the receive buffer.                     (CHR$2)
  550.         ^E      Empties the receive buffer.                     (CHR$5)
  551.         ^F      Toggles the 'spool to disc' option, where a duplicate file
  552.                 exists the new text is appended with a warning. (CHR$6)
  553.         ^O      Opens up the user directories for editing.
  554.         ^R      Opens the review (rx buffer) window.            (CHR$18)
  555.         ^W      Opens the 'Search' window if there is anything in the
  556.                 rx buffer.
  557.  
  558. Clicking on the "number of lines free" icon (thats the one with the numbers
  559. in it) will toggle the rx buffer.
  560.  
  561.  
  562.  
  563.  
  564.  
  565.                                 Using the rx window.
  566.                                 --------------------
  567.  
  568. Pressing the right hand ('adjust') mouse button in this window will clear
  569. the window, confirmation is required.
  570.  
  571. Read messages.
  572.  
  573. Pressing the left hand ('select') mouse button while holding down either
  574. <Alt> key while the pointer is also over a line of text in either the
  575. receive window or the review window will copy the left hand word (up to the
  576. first space) into any line in the tx window that has the caret. This is
  577. meant to be used to copy over message numbers from a "L" list sent by a BBS.
  578. The first time the message number is preceeded by "R ".
  579.  
  580. Kill messages.
  581.  
  582. Pressing the left hand ('select') mouse button while holding down either
  583. <Shift> key while the pointer is also over a line of text in either the
  584. receive window or the review window will copy the left hand word (up to the
  585. first space) into any line in the tx window that has the caret. This is
  586. meant to be used to copy over message numbers from a "L" list sent by a BBS.
  587. The first time the message number is preceeded by "K ".
  588.  
  589.  
  590. Pressing down either <Ctrl> key will result in the whole line being copied down.
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.                               Using the 'TX misc' window
  598.                               --------------------------
  599.  
  600.  
  601. The icons in this window are made up using the first ten filenames (see
  602. note below) found in the directory "!Term93.user_2". When the required filename
  603. is clicked on that file is sent to the tnc. Note that NO check is done as to
  604. whether you are connectd or not.
  605.  
  606. Note     : There is no real need to have ten files in "!Term93.user_2" as
  607.            the window is sized as required for up to 10.
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.                               Using the 'Cmd line' window
  615.                               ---------------------------
  616.  
  617. Any text that you wish to send to your tnc or transmit can be included in
  618. this window, control characters are produced by using 2 character
  619. combinations.
  620.  
  621. Click with 'select' in the writeable icon and type in the required text, use
  622. the mouse on the up/down arrows or use the cursor keys to move up/down, 32
  623. entries are allowed.
  624.  
  625. Click with 'select' on 'Save' to save your edited lines.
  626.  
  627. Click with 'select' on 'OK' to send the entry showing in the writeable icon.
  628.  
  629. Press <return> with the caret in the writeable icon to send that entry.
  630.  
  631. Certain control characters can be included in the text (it is NOT necessary
  632. to put 'Control M' i.e. return at the end of a line) and can be entered in
  633. upper or lower case as the following examples show.
  634.  
  635. For Control+C enter |C or ^c
  636. For Control+M enter ^M or |m
  637.  
  638. The | character or the ^ character may be used.
  639.  
  640. The following control characters are catered for :
  641.  
  642.         |C      Control C       Character 3
  643.         |M      Control M       Carriage return
  644.         |N      Control N
  645.         |O      Control O
  646.         |V      Control V       Preceeds |M in multi-line CTEXT messages.
  647.         |Z      Control Z
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.                               Using the 'Tnc cmd' window
  655.                               --------------------------
  656.  
  657.  
  658.  
  659.  
  660. The icons in this window are made up using the first six (See note below)
  661. commands found in the file "!Term93.user_1.monitor" and if there are less
  662. than six then lines are used from the file "!Term93.user_1.commands". The
  663. commands shown are sent to the tnc and a check for the connect status is
  664. done, therefore they MAY BE USED WHILE CONNECTED. See note ###.
  665.  
  666. Note ### : Commands to the tnc selected from this menu may be sent while
  667. connected but will not work properly if the rs port 'ring indicator' is not
  668. wired up.
  669.  
  670. Note     : Less than six entries total in "!Term93.user_1.monitor" and
  671. "!Term93.user_1.commands" will result in the window being sized as required.
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.                               Using the Search window.
  679.                               ------------------------
  680.  
  681. This window can be opened by selecting 'Search' from the main menu or by
  682. pressing <Ctrl>W or function key 8 (f8) while the tx window has the caret
  683. and there is text in the receive buffer.
  684.  
  685. You may then enter the text to look for (up to 80 characters) and press
  686. <Return> or click on the 'OK' button to commence the search.
  687. Should the text be found then the review window will open with the text
  688. hi-lighted and you may then continue to search for the next occurence or the
  689. previous one, the lower icon reports on the success or otherwise.
  690.  
  691. Clicking on "Count" will count the number of lines in which the 
  692. 'searched for' text appears.
  693.  
  694. PLEASE NOTE THAT AT PRESENT THESE FUNCTIONS ARE 'CASE SENSITIVE' i.e. that
  695. means that a search for G4RQN will NOT locate g4rqn or G4rqn etc. This I
  696. hope to change when time permits.
  697.  
  698.  
  699. Clicking on 'Open save box' does just that.
  700.  
  701. The default text appearing in the writeable icon is user definable in the
  702. file "!Term93.cosmetic.HiLites" (see below).
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.                               Using the Password window.
  711.                               --------------------------
  712.  
  713.  
  714. It is a sad fact that many people are having to use a password entry to
  715. their local BBS simply to stop messages sometimes of a crude nature from
  716. being uploaded in their name by someone pirating their callsign.
  717.  
  718. On 'NNA' BBS's a password system is used where the user gets from his or her
  719. sysop a matrix of characters, on calling up the bbs the user must then send
  720. a certain character, wait for a reply and in turn reply with certain
  721. characters read from the matrix. So why not let the program do it for you.
  722.  
  723. Step 1 Contact you sysop and assuming it is an 'NNA' type BBS then get the
  724.         sysop to send you a password matrix.
  725.  
  726. Step 2  Click on 'Clear'.
  727.         Type the characters in the matrix into the corresponding writeable
  728.         icons in the password window. Also write in the BBS prompt EXACTLY
  729.         as it appears to you in the lower writeable icon.
  730.  
  731. Step 3 Enter your local BBS callsign in the top writeable icon.
  732.  
  733. Step 4 Click on save.
  734.  
  735. Step 5 Click on the icon containing the figure '1'. the '1' will change to a
  736.         '2' and you may then repeat steps 2 to 5 for another BBS.
  737.         Two entries are allowed for.
  738.  
  739. You may now either click on the 'GO' button beside the BBS callsign to log
  740. on and exchange password info or if you are already connected click on 'GO'
  741. next to "Send password only".
  742.  
  743. * DO NOT SEND ANYTHING ELSE TO THE BBS UNTIL YOU ARE SURE THE PASSWORD *
  744. *                       EXCHANGE IS OVER.                              *
  745.  
  746.  
  747.  
  748.  
  749.                                    Screen Colours
  750.                                    --------------
  751.  
  752. The file is !Term93.cosmetic.colours ***** DO NOT RENAME *****
  753.  
  754. Drag the file into !Edit and simply change the colour numbers as required.
  755.  
  756. Here is a copy of the file :
  757.  
  758.  
  759. The colours of the receive and review windows are user definable but as the
  760. colours used (in my humble opinion) are unlikely to be frequently changed
  761. they are defined in a file as follows.
  762.  
  763. 6    (This is line 1)
  764. 2
  765. 1
  766. 2
  767. 6
  768. 15
  769. 6
  770. 2
  771. 1
  772. 3
  773. 7
  774. 10
  775. 2
  776. 1
  777. 3
  778. 7
  779. 11
  780. EOF  DO NOT DELETE OR ADD LINES ABOVE THIS ONE.
  781.  
  782. Line 1  is the colour of the receive window work foreground (text)
  783. Line 2  is the colour of the receive window work background
  784. Line 3  is the colour of the receive window scroll bar inner
  785. Line 4  is the colour of the receive window scroll bar background
  786. Line 5  is the colour of the receive window title foreground
  787. Line 6  is the colour of the receive window title background
  788.     
  789. Line 7  is the colour of the review window work foreground (text)
  790. Line 8  is the colour of the review window work background
  791. Line 9  is the colour of the review window scroll bar inner
  792. Line 10 is the colour of the review window scroll bar background
  793. Line 11 is the colour of the review window title foreground
  794. Line 12 is the colour of the review window title background
  795.     
  796. Line 13 is the colour of the transmit window work background
  797. Line 14 is the colour of the transmit window scroll bar inner
  798. Line 15 is the colour of the transmit window scroll bar background
  799. Line 16 is the colour of the transmit window title foreground
  800. Line 17 is the colour of the transmit window title background
  801.      
  802.      ***** DO NOT RENAME *****
  803.  
  804. The transmit window text colour (that you type) is not definable.
  805.  
  806. Version 1.5 (on) includes the facility to hi-light certain lines in the
  807. review window. To edit this facility drag the file
  808. "!Term93.cosmetic.HiLites" into !Edit. The file contains three lines which
  809. you may edit, they are:
  810.  
  811. Line 1  The colour used for the hi-light (use colour numbers from the
  812. palette window).
  813.  
  814. Line 2  First text iem to be looked for.
  815.  
  816. Line 3  Second text item to be looked for.
  817.  
  818. Example file.
  819.  
  820. !Term93.cosmetic.HiLites              **** DO NOT RENAME ****
  821. 11
  822. RISCOS
  823. ARCHIM
  824. GB7OPC
  825. EOF  DO NOT DELETE OR ADD LINES ABOVE THIS ONE.
  826. !Term93.cosmetic.HiLites              **** DO NOT RENAME ****
  827.  
  828. The first line is the colour (desktop) number for the high-lite.
  829. The next two lines contain text to be looked for, note this is
  830. case sensitive.
  831. The fourth line is used as a default in the 'search' window.
  832.  
  833. The program also hi-lights any line containing your call as entered into the
  834. writeable icon in the bottom of the log window.
  835.  
  836.  
  837.  
  838.  
  839.                                         Messages.
  840.                                         ---------
  841.  
  842. This version includes a file "messages" which MUST NOT be renamed.
  843.  
  844. This file may be translated as required but please if you pass on a copy
  845. then pass on the original "messages" file to the new user. Any modified 
  846. strings MUST NOT be over 200 characters in length and the text up to AND
  847. INCLUDING the colon (e.g. "txt1:") MUST REMAIN UNCHANGED.
  848.  
  849. I would appreciate copies of any non english translations.
  850.  
  851. To create a multi line CTEXT message
  852.  
  853. In a !Edit window type the following line or at least a version of it noting
  854. the @# characters.
  855.  
  856. CTEXT Hello from Neil in King's Lynn@#If i do not respond then try a message in G4RQN-3 >>
  857.  
  858. Move the caret back to before the @# characters.
  859. Press f4 to bring up the !Edit 'Find text' dialogue box.
  860. Click on 'Magic characters'.
  861. Type in the top line @#
  862. Type in the next line \X16\X0D (NOTE the backslash).
  863.  
  864. The !Edit 'Find text' dialogue box writeable icons should now contain the following
  865. @#
  866. \X16\X0D
  867.  
  868. Click on "GO".
  869. Click on "End of file replace".
  870.  
  871. Save the resulting file in the directory "!Term93.user_2" using a sensible
  872. filename from where it can be sent to the tnc.
  873.  
  874.  
  875.  
  876.                                         The log.
  877.                                         --------
  878.  
  879. !Term93 includes a single entry automatic log facility which when enabled
  880. will log single connects (i.e. one entry at a time), it can also be used as
  881. a manual log once again only one entry at a time.
  882.  
  883. To use as an automatic log simply click on the "Misc." menu entry "Logging"
  884. if it is not already the default. On a connect the start time and callsign
  885. are noted and the callsign shown at the top of the rx window. On a
  886. disconnect the entry is closed and written to the log file which is in
  887. !LogBook which you should also receive.
  888.  
  889. Automatic entries may be edited in the log window PRESS THE
  890. RETURN OR ENTER KEY when the caret is in the callsign icon to edit an
  891. automatic entry or open a manual entry.
  892.  
  893. You may close an entry at any time by clicking on the "Close entry" in the
  894. log window.
  895.  
  896. To make a "Close down" entry click on the "Close log" icon.
  897.  
  898. Manual entries. A manual entry can be made whenever there is not already a
  899. manual or automatic entry open but note that manually opened entries MUST be
  900. closed manually.
  901.  
  902. To have your most used data already in the log window as a default simply
  903. enter them into the "Freq", "Mode" and "Power" writeable icons ands click
  904. the "Save" icon.
  905.  
  906. If an entry is still open when you quit !Term93 then it is saved, a  warning
  907. box appears to remind you.
  908.  
  909. If !Term93 has been installed on the icon bar and the application 
  910. !LogBook HAS NOT BEEN SEEN then the log window and auto-logging will be
  911. unavailable, to re-enable the log facility simply open a directory which
  912. contains !LogBook.  Although it is easiest ot have !LogBook in the root
  913. directory of your  packet or hard disc my understanding of the regulations
  914. is that the log MUST BE KEPT ON A DISC USED SOLELY FOR THAT PURPOSE (it's up
  915. to you).
  916.  
  917.                     ********** IMPORTANT **********
  918.  
  919. YOU SHOULD ENTER YOUR OWN CALLSIGN IN UPPER CASE INTO THE LOWER CENTRAL
  920. WRITEABLE ICON AS THIS IS USED TO PREVENT THE AUTO-LOGGING FACILITY
  921. FROM LOGGING CALLS TO YOUR OWN PBBS. Then click on "Save".
  922.  
  923. The program may reset some tnc parameters should it think that the user is
  924. still G4RQN
  925.  
  926.  
  927.  
  928.  
  929. NOTES
  930. =====
  931.            Files to be transmitted should be dragged to the icon or a window
  932. ONLY after any tnc set up files have been sent (those selected from the user
  933. sub menu) otherwise the dragged file will be forgotten.
  934.  
  935. Files dragged directly from !Edit are temporarily stored in the directory
  936. "!Term93.Temp" as a file called "Temp", this file is deleted after sending
  937. or on a transmit abort command. The only thing to remember here is that you
  938. MUST have enough room on the disc containing !Term93 to store the "temp"
  939. file.
  940.  
  941.  
  942.  
  943. A 'drag save' from such as !Edit is now operational but I have to admit to
  944. having fudged it somewhat. What happens is that !Edit is told to save to a
  945. file called "!Term93.temp.temp" and that file is then ready to transmit.
  946.  
  947. As soon as the file is transmitted or the transmit aborted the file
  948. "!Term93.temp.temp" is deleted.
  949.  
  950. One of the results of this is that a 'spool to disc' can be started by
  951. dragging the lower icon in the save box to a !Term93 window, a file opened
  952. by selecting "Start" or by pressing <Ctrl>+F. The resulting file can then be
  953. immediatly transmitted, a second attempt at this without aborting the
  954. transmit will append the second file to the existing "temp" file.
  955.  
  956. Another effect is that the buffer can be 'saved' back into !Term93 and again
  957. transmitted, the rules about dragging the buffer repeatedly again apply.
  958.  
  959. On running !Term93 any file called "!Term93.temp.temp" is deleted.
  960.  
  961.  
  962.  
  963.                                         Credits
  964.                                         -------
  965.  
  966. Many people have unknowingly helped with this program when i have found out
  967. how to do things by looking at programs they have sent and/or written, to
  968. all of them a great big thank you !
  969.  
  970.  
  971.  
  972.  
  973.  
  974.                                 NOT MY FAULT DEPARTMENT
  975.                                 -----------------------                                
  976.  
  977.  
  978. All this software is provided "as is"; G4RQN makes no warranty, express or
  979. implied, of the merchantability of this software or its fitness for any 
  980. particular purpose.  In no circumstances shall G4RQN be liable for any 
  981. damage, loss of profits, or any indirect or consequential loss arising  out
  982. of the use of this software or inability to use this software, even if 
  983. G4RQN has been advised of the possibility of such loss. "Software" describes
  984. the complete package and includes any circuits or connection hints included.
  985.  
  986.  
  987.  
  988.  ££££££££££££££££££££££££££££££££££££££££££££££££££££££££££££££££££££££££££
  989.  £                                                                        £
  990.  £                                                                        £
  991.  £  You have received this program without charge but should you wish to  £
  992.  £         make some payment then a donation to the following             £
  993.  £                    would be most suitable.                             £
  994.  £                                                                        £
  995.  £                        THE SPECIAL CARE BABY UNIT                      £
  996.  £                        QUEEN ELIZABETH HOSPITAL                        £
  997.  £                        GAYTON ROAD                                     £
  998.  £                        KING'S LYNN                                     £
  999.  £                        NORFOLK                                         £
  1000.  £                                                                        £
  1001.  £   Cheques should be made payable to 'The Special Care baby Unit'       £
  1002.  £              at the QUEEN ELIZABETH HOSPITAL, Kings Lynn.              £
  1003.  £                                                                        £
  1004.  ££££££££££££££££££££££££££££££££££££££££££££££££££££££££££££££££££££££££££
  1005.  
  1006.  
  1007.  
  1008.  
  1009. Copies of the software may be passed on unmodified as long as i know where
  1010. it's going, this helps me if i get queries and with updates. Should you be a
  1011. brill programmer and update/upgrade the program then ok but i get the first
  1012. copy.
  1013.  
  1014.  
  1015.  
  1016.                                 73s de Neil G4RQN.
  1017.  
  1018.                                 W. N. Rodger
  1019.                                 4 Burn's Nurseries
  1020.                                 Off Wootton Road
  1021.                                 King's Lynn
  1022.                                 Norfolk PE30 3BG
  1023.  
  1024.  
  1025.         0553 675676 after 8pm, no reply try 0553 671118 ask for Neil.
  1026.  
  1027.