home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / packet / rli120.ark / NOTES.TNC < prev    next >
Text File  |  1987-05-11  |  36KB  |  928 lines
  1.  
  2.      W0RLI MailBox and GateWay   Version 12.0 - 5/11/87   Page  1
  3.  
  4.      Created for packet community by:
  5.  
  6.           Hank Oredson, W0RLI
  7.           134 Ponderosa Drive
  8.           Santa Cruz, CA 95060
  9.  
  10.      Distributed by:
  11.  
  12.           Wes Morris, k7pyk
  13.           7422 E. McKinley St.
  14.           Scottsdale, AZ 85257
  15.  
  16. Many people contibuted to this project, in many ways.
  17. In particular I would like to thank K1BC, KE1G, WB2MNF, W3IWI, WB7DCH
  18. K3RLI, KE3Z, K7PYK for their help and encouragment.
  19.  
  20.  
  21. These notes are rough, more release notes and tech notes than
  22. anything else. A SYSOPS Manual (Very nice, 40+ pages) is also
  23. available from Wes. It was written by Jon Pearce, WB2MNF.
  24.  
  25. A very nice log file analyzer was written by:
  26.  
  27.             Tom Hogan, WB7DCH
  28.             26911 S E 456 St.
  29.             Enumclaw, WA 98022
  30.  
  31. I have included it on the release disk as LFA.COM.
  32.  
  33. I have also included my own log file analyzer, called PRTLOG.
  34.  
  35.         PRTLOG -L LOG.TNC
  36.  
  37.      Will display LOG.TNC at the console.
  38.  
  39.         PRTLOG -L LOG.TNC > LST:
  40.  
  41.      Will put it on the printer.
  42.  
  43.         PRTLOG -L LOG.TNC > LOG.PRT
  44.  
  45.      Will put the output in file LOG.PRT.
  46.  
  47.  
  48.      If you leave out the -L field, only the summary is printed.
  49.  
  50.      W0RLI MailBox and GateWay   Version 12.0 - 5/11/87   Page  2
  51.  
  52.  
  53. Release notes, Version 12.0 :
  54.  
  55. Despite the rollover from version 11.x to 12.x, this is not a major
  56. revision to the software.  There are basically two new features
  57. from 11.9 to 12.0, both to support the NTS folks. They are the ET
  58. command and wild-cards in the forwarding file.  See CHANGES.TNC
  59.  
  60. -------------
  61.  
  62. To change the serial port baud rate to 1200 (for Kantronics tnc)
  63. you must change the port setup values in CBIOS. These are located
  64. at: 152H for COMM port, 155H for PRINTER port (in CBIOS.COM).
  65. Change to 7 for 1200 baud.
  66.  
  67. Note new files HELP.TNC and INFO.TNC contain the text for
  68. the H and I commands.
  69.  
  70. Software change log is now in file CHANGES.TNC.
  71.  
  72. Note: NEW CBIOS.COM in version 10.4. This is a change of
  73. flow control due to inconsistancies between tnc1 and tnc2.
  74. Check TNC1.SET and TNC2.SET for the proper tnc setup parameters. 
  75. There is no longer GBIOS and TBIOS, only CBIOS.
  76.  
  77. Do not be alarmed if the program appears to load slowly the
  78. first time it is run. If there are is any change to the
  79. user or mail file format, the program updates your existing
  80. files the first time it is run.
  81.  
  82. Forwarding now maintains the correct FROM and TITLE on
  83. forwarded messages. This only works with other MailBoxes running
  84. version 10.0 and later. The "F" item in the FWD.TNC file should
  85. be changed to a "G" item (just change the F to G) for each MailBox
  86. you forward to that is running 10.0 to make use of this new feature.
  87.  
  88. The proper setup parameters for the tnc are in .SET files,
  89. TNC1.SET for a tnc1, TNC2.SET for a tnc2.
  90.  
  91. The file CONFIG.TNC is a text file that contains all site-specific
  92. parameters. Edit it to have the proper parameters for your site.
  93.  
  94. If you have a previous version of CONFIG.TNC, note that there are
  95. many changes in this version. You should personalize a new one,
  96. use the release version as a starting point.
  97.  
  98. The boot disk in drive A must contain CP/M (or equivalent) system
  99. and the files TNC.COM, CONFIG.TNC and CBIOS.COM. The file FWD.TNC is
  100. optional; it is required only for automatic forwarding.
  101.  
  102. I suggest you specify some drive other than A: for certain files:
  103. MAIL.BAK and USER.BAK should go on a different disk than the
  104. corresponding .DAT files. LOG.TNC can grow fairly rapidly,
  105. put it on a drive with extra space if possible. In the release
  106. version all drives are specified as A: to allow for a system
  107. with only a single drive.
  108.  
  109. The BIOS on this disk is specialized for the Xerox 820, if you
  110. need to make any changes, see the source code: CBIOS.MAC.
  111.  
  112.      W0RLI MailBox and GateWay   Version 12.0 - 5/11/87   Page  6
  113.  
  114.  
  115. The MailBox will make use of any drive that is logged in at
  116. the time it begins execution.
  117.  
  118. The first (or only) TNC connects to the Xerox COMM port.
  119. The cable should have pins 1-7 and 20 connected.
  120.  
  121. The second TNC (if used) connects to the Xerox PRINTER port.
  122. Note that you must connect this TNC with a "null modem" cable:
  123.  
  124.                   TNC1    TNC2    COMM   PRINTER
  125.  
  126. Data from Xerox     2       2       2       3
  127. Data from TNC       3       3       3       2
  128. Flow ctl Xerox      5       5       5       4
  129. Flow ctl TNC        4      20       4       5
  130. Xerox alive        20      NC       6       6
  131. TNC alive           6       6       8      20
  132. Frame GND           1       1       1       1
  133. Signal GND          7       7       7       7
  134.  
  135. Configure the TNCs as shown in the appropriate .SET file,
  136. TNC1.SET for a tnc1, TNC2.SET for a tnc2. Note that several of
  137. the parameters differ depending on which type of tnc you have
  138. on the port. You can send the parameters to the tnc using
  139. the BA or BB commands, for example BA TNC2.SET.
  140.  
  141.      W0RLI MailBox and GateWay   Version 12.0 - 5/11/87   Page  7
  142.  
  143. The Xerox PRINTER port may be used in one of three different ways:
  144.  
  145. 1) To support a second TNC. In this case the MailBox will be available
  146.    from either TNC.  4800 baud, 8 bits, no parity.
  147.    To make use of the TNC, change the first word of the "two TNC"
  148.    line in the config file to YES.
  149.  
  150. 2) To support a remote console. This console is effectivly "in parallel"
  151.    with the local console. 9600 baud, 8 bits, no parity.
  152.  
  153. 3) To support a printer. The printer is configured as CP/M LIST device.
  154.    RTS/CTS handshaking is used. 9600 baud, 7 bits, even parity.
  155.  
  156. The MailBox is distributed with a version 1 BIOS installed.
  157. You can change to one of the other flavors by editing CBIOS.MAC
  158. and then assembling and linking to get CBIOS.COM. The submit
  159. file CBIOS.SUB is provided for this purpose.
  160.  
  161. The BIOS assumes version 2 PROMS are in the Xerox. If in doubt,
  162. check U-63 and U-64, they should be 63-2 and 64-2.
  163.  
  164. The BIOS is set up for a standard ASCII keyboard. Other options
  165. are available. See CBIOS.MAC for details.
  166.  
  167. Disk drive step time set to 4 MS. May have to change this in
  168. the BIOS if you have slow drives.
  169.  
  170. To put a system on a new disk...
  171. MAKESYS B:
  172. B: - do it to the disk in drive B
  173.  
  174.      W0RLI MailBox and GateWay   Version 12.0 - 5/11/87   Page  8
  175.  
  176. The following commands are on the local menu only. The local menu
  177. also has the same set of message commands as the remote menu.
  178. Remote user commands are described in the file DOC.TNC.
  179.  
  180. The following local commands are availble to the remote sysop:
  181. A,B,C,D,E,F,G,N,P,M,V,W,Y,Z,@
  182.  
  183.        @ - Switch remote user between the standard remote menu
  184.            and the remote sysop commands. Must have S privilege.
  185.  
  186.        AS <file> - Toggle between $sys and $dir.
  187.        AN <file> - Toggle "new" attribute.
  188.  
  189.        B - Send a file to the TNC.
  190.              Qualifier: TNC to send file to (A or B).
  191.              Argument:  Name of file to send.
  192.  
  193.        C - Set the clock, C <call> - Connect to user.
  194.  
  195.        D - Display a file at the console.
  196.              Qualifier: P - Page mode.
  197.                         U - List all users.
  198.                         E - List excluded users.
  199.                         S - List sysop users.
  200.                         L - List local users.
  201.              Argument: File name.
  202.  
  203.        E - Edit a message header, user record, or file.
  204.              Qualifier: U - Edit a user record.
  205.                         F - Edit a file.
  206.              Argument: Message number, user call, or file name.
  207.  
  208.           Edit file (EF) commands are:
  209.  
  210.            A - Up one page.
  211.            S - Up one line.
  212.            D - Down one line.
  213.            F - Down one page.
  214.            K - Kill current line.
  215.            I - Insert the text following the I above the current line.
  216.            Q - Quit (Changes not saved).
  217.            E - Exit (Changes saved).
  218.  
  219.        F - Make a file from a message.
  220.              Qualifier: A - Append to existing file.
  221.              Arguments - <message number> <file name>
  222.  
  223.        FB - File BBS users.
  224.        FL - File Local users.
  225.              Argument - <file name>
  226.  
  227.        G - Untangle the mail/user files. (Grunch them...)
  228.              Qualifier: R - Renumber the messages from 1.
  229.                         M - Mail file only.
  230.                         U - User file only.
  231.             Z - Like GU but Zero the last-read msg # for all.
  232.  
  233.        G - Enable / Disable GateWay.
  234.              Qualifier: Y - Enable, N - Disable.
  235.  
  236.  
  237.        H - Toggle short / long local menu.
  238.  
  239.        M - Make a message from a file.
  240.              See 'S' command.
  241.              Arguments: <call> <file name> [@ call] [< call]
  242.  
  243.      W0RLI MailBox and GateWay   Version 12.0 - 5/11/87   Page  9
  244.  
  245.  
  246.        N <old filename> <new filename> - Rename file.
  247.  
  248.        O - Open a save file, go to terminal mode.
  249.              Qualifier selects TNC (A or B).
  250.              Argument: File name.
  251.  
  252.        P - Change a parameter.
  253.              Qualifier: Which parameter.
  254.               1 - # allowed digipeaters on COMM TNC.
  255.               2 - # allowed digipeaters on PRINTER TNC.
  256.               3 - Yes/No/Busy/Quiet allow only bbs on COMM port.
  257.               4 - Yes/No/Busy/Quiet allow only bbs on PRINTER port.
  258.               5 - Yes/No kill message after forward.
  259.               6 - Yes/No/Busy/Quiet allow only bbs via LINKED to connects.
  260.              Argument: New value.
  261.  
  262.        Q - Quit (return to CP/M).
  263.  
  264.        T - Go to terminal mode.
  265.              Qualifier selects TNC (A or B).
  266.  
  267.        U - Upload a file from the console.
  268.              Qualifier: A - Append to existing file.
  269.  
  270.        V <from file name> <to file name> - Copy a file.
  271.  
  272.        W <filespec> - List directory.
  273.            Qualifier: A - all files, N - new only, S - sys only.
  274.  
  275.        X - Trigger an auto-forward.
  276.              Qualifier: I - Ignore times in FWD.TNC
  277.              Argument: If present, call of station to forward to.
  278.                        Other entries in FWD.TNC ignored.
  279.  
  280.        Y - Set file name.
  281.              Qualifier: C - CALLS.TNC, F - FWD.TNC, L - LOG.TNC
  282.              Argument: <file name>
  283.  
  284.            Allows switch of forwarding or logging files.
  285.  
  286.        Z - Delete a file.
  287.              Argument: <file name>
  288.  
  289.  
  290.         Message directory item:
  291.        # characters    contents
  292.              5       Message number
  293.              1       Message type
  294.              1       Message status
  295.              6       To
  296.              6       From
  297.              6       @ BBS
  298.              6       Date
  299.              6       Time
  300.             80       Title (Maximum of 80, variable length).
  301.  
  302.      W0RLI MailBox and GateWay   Version 12.0 - 5/11/87   Page 10
  303.  
  304.  
  305.    User file (USER.DAT) structure, version 4.
  306.  
  307.  
  308.      USHDR:     File header record.
  309.  
  310.        USCNT     2 - # of user records in file.
  311.        USVER     1 - Version # of file format.
  312.        USLDT     6 - Date of last compress.
  313.        USLTM     4 - Time of last compress.
  314.        USLMNR    2 - Next message number at last compress.
  315.        USDEL     1 - True if any user record has been deleted.
  316.        Free    112 - Must be zero.
  317.  
  318.      USREC:     User record.
  319.  
  320.        USCALL    6 - Users call.
  321.        USDATE    6 - Date user last logged out.
  322.        USTIME    4 - Time user last logged out.
  323.        USMNR     2 - Next message number at last user loggout.
  324.        USSSID    1 - SSID on last connect.
  325.        USNAME   12 - Users name.
  326.        USOPT     1 - User options:
  327.                      Deleted record.
  328.                      Expert user.
  329.                      User is a bbs.
  330.                      User can be remote sysop.
  331.                      User excluded on port A (COMM port).
  332.                      User excluded on port B (PRINTER port).
  333.                      Local user of system.
  334.        USPORT    1 - A or B which tnc last connect, L if linked.
  335.        USBBS     6 - User's "home bbs".
  336.        USPATH   81 - Path of last connect by user.
  337.  
  338.  
  339.      W0RLI MailBox and GateWay   Version 12.0 - 5/11/87   Page 11
  340.  
  341.  
  342.      Mail file (MAIL.DAT) structure, version 2.
  343.  
  344.      MFHS:   File Header Record.
  345.  
  346.        MNEXT     2 - Next available record (1 past eof)
  347.        MFHD      2 - Record number of first message header.
  348.        MLHD      2 - Record number of last  message header.
  349.        MFFREE    2 - First record in chain of free records.
  350.        MLFREE    2 - Last  record in chain of free records.
  351.        MNR       2 - Number to use for next message.
  352.        MVERS     1 - File version number.
  353.        MFREE     2 - # of records in free chain.
  354.        MCNT      2 - # of messages in file.
  355.        MUDT      6 - Date of last untangle.
  356.        MUTM      4 - Time of last untangle.
  357.        MUMNR     2 - Last message number at last untangle.
  358.        Unused   99 - Not used, must be zero.
  359.  
  360.      MMHS:   Message Header Record.
  361.  
  362.        MHFMSG    2 - Record of first text record for this message.
  363.        MHLMSG    2 - Record of last  text record for this message.
  364.        MHNEXT    2 - Record number of next message header.
  365.        MHNR      2 - Number of this message.
  366.        MHSIZE    2 - Byte count of message.
  367.        MHTYPE    1 - Type of message:
  368.                      ' ' - General  message.
  369.                      'P' - Private message.
  370.                      'A' - ARRL bulletin.
  371.                      'B' - Bulletin.
  372.                      'T' - NTS traffic.
  373.        MHSTAT    1 - Status of the message:
  374.                      'N' not yet  read by addressee.
  375.                      'Y' has been read by addressee.
  376.                      'F' has been automatically forwarded.
  377.  
  378.        MHTO      6 - Call of addressee.
  379.        MHFROM    6 - Call of sender.
  380.        MHDATE    6 - Date entered into system.
  381.        MHTIME    4 - Time entered into system.
  382.        MHEXT     2 - Must be zero. Pointer to extension of header in
  383.                      the C version of the MailBox code.
  384.        MHREAD    2 - Number of times read.
  385.        MHPREV    2 - Record number of previous header.
  386.        MHBBS     6 - Call of destination MailBox.
  387.        Unused    2 - Not used, must be zero.
  388.        MHTIT    80 - Title. Terminated by CR.
  389.  
  390.      MMTS:   Message Text Record.
  391.  
  392.        MTNEXT    2 - Record number of next record of message text.
  393.        MTTEXT  126 - Message text. Terminated by ^Z.
  394.  
  395.      MFFS:   Free Record.
  396.  
  397.        MTNEXT    2 - Record number of next free record.
  398.        Unused  126 - Contents ignored.
  399.  
  400.      W0RLI MailBox and GateWay   Version 12.0 - 5/11/87   Page 12
  401.  
  402.            The Configuration File.
  403.  
  404. The file CONFIG.TNC is a text file that contains all site-specific
  405. parameters. Edit it to have the proper parameters for your site.
  406.  
  407. The form $x is a variable text field. The "$x" is replaced by
  408. the current value for that text.
  409.  
  410. $A - @ BBS of the current message.
  411. $B - Bell - insert an ASCII BEL (CTL-G).
  412. $C - Next available message number.
  413. $D - The current date.
  414. $E - Display the calls of stations with unread msgs.
  415. $F - Insert a form feed.
  416. $G - TO of the current message.
  417. $H - Hang at end of line (suppress carriage return).
  418.      Use at end of line only. DO NOT USE on lines that go to tnc.
  419. $I - Users name, from user file.
  420. $J - Date from current msg header
  421. $K - Time from current msg header.
  422. $L - Number of the last message.
  423. $M - Message number from current msg header.
  424. $N - Number of active messages.
  425. $O - Call of system owner.
  426. $P - FROM from current msg header.
  427. $Q - Used internally by the program.
  428. $R - Call in a "connect request:" from either TNC.
  429. $S - Call of the end node station connected via the slave TNC.
  430.      Seen initially in "*** CONNECTED to:" when the adjacent node
  431.      connects, may be seen in "*** LINKED to:" from the adjacent node.
  432. $T - The current time.
  433. $U - Call of the end node station connected via the master TNC.
  434.      Seen initially in "*** CONNECTED to:" when the adjacent node
  435.      connects, may be seen in "*** LINKED to:" from the adjacent node.
  436. $V - Display the changable parameters (P1 ...).
  437. $W - Wait to send - adds a SYN before CR so packet not sent.
  438.      Use at end of line only.
  439. $X - Date user last logged in.
  440. $Y - Time user last logged in.
  441. $Z - Last message number when user last logged in.
  442.  
  443.      W0RLI MailBox and GateWay   Version 12.0 - 5/11/87   Page 13
  444.  
  445. The first section (to the first *** EOF) is the login message.
  446. The next section (to the next *** EOF) is the info text.
  447. The next section is the "connected bbs" menu. Keep it SHORT!
  448. The next section is the remote sysop menu. Keep it SHORT!
  449. The next section (to the next *** EOF) is the short MailBox menu.
  450. The next section (to the next *** EOF) is the long MailBox menu.
  451. The next section (to the next *** EOF) is the short GateWay menu.
  452. The next section (to the next *** EOF) is the long GateWay menu.
  453. The next section (to the next *** EOF) is the short local menu.
  454. The next section (to the next *** EOF) is the long local menu.
  455. The next section (to the next *** EOF) is the message message sent when
  456.  someone connects for whom USER.DAT has no home bbs listed. This message
  457.  can be null - i.e., just the *** EOF, if desired.
  458. The next section (to the next *** EOF) is the message message sent when
  459.  someone reads a message (except B or T type) to someone (with a real
  460.  call) other than themselves. This message can be null - i.e., just
  461.  the *** EOF, if desired.
  462. The next section (to the next *** EOF) is the message message sent when
  463.  someone sends a message here after coming in by a *** LINKED to connection.
  464.  This message can be null - i.e., just the *** EOF, if desired.
  465. The next line is your call.
  466.  
  467. The next line is the file name to use for the list of all calls heard.
  468. The next line is the file name to use for the auto-forwarding file.
  469. The next line is the file name to use for the log file.
  470. The next line is the file name to use for the "J" list save file.
  471. The next line is the file name to use for the msg temp file.
  472. The next line is the file name to use for the mail file.
  473. The next line is the file name to use for the mail backup file.
  474. The next line is the file name to use for the user file.
  475. The next line is the file name to use for the user backup file.
  476.  
  477. The next line is YES to allow download of "new" files.
  478. The next line is YES to exclude users with illegal calls.
  479. The next line is YES to exclude connect thru digi with illegal call.
  480. The next line is YES to exclude all but BBS on COMM port. (Can be YES,
  481.  NO,BUSY or QUIET, for excluding during all/no/busy/quiet hours.)
  482. The next line is YES to exclude all but BBS on PRINTER port. (Y/N/B/Q)
  483. The next line is YES to exclude all but BBS via LINKED connects. (Y/N/B/Q)
  484. The next line is 24 zeros and ones, for the hours of the day, 00-23. Each
  485.  "1" defines a busy hour and each "0" defines a quiet hour.
  486. The next line is max # digipeats user can use on COMM port.
  487. The next line is max # digipeats user can use on PRINTER port.
  488. The next line is the "no activity" timeout in minutes.
  489. The next line is the timeout in GateWay monitor mode in minutes.
  490. The next line is the maximum number of lines to show in monitor mode.
  491. The next line is the "waiting for disconnect" timeout in seconds.
  492. The next line is the USER routine calling period.
  493.  
  494. The next line is the maximum number of calls allowed in the
  495. monitor mode calls heard list (CALLS.TNC).
  496. The next line is the maximum number of users in the user file.
  497. The next line is the number of calls on the "recently heard" lists.
  498. The next line is YES to look at beacons, NO to ignore them.
  499.  
  500. The next line is "YES" if both ports have TNC's, "NO" if only
  501. the COMM port has a TNC.
  502. The next line is "YES" to activate the GateWay code,
  503. "NO" to inactivate it; "QUIET" to allow it only during quiet hours;
  504. "BUSY" to allow it only during busy hours (unlikely).
  505. The next line is "YES" to allow GateWay monitoring,
  506. "NO" to disallow it. "QUIET" to allow it only during quiet hours;
  507. "BUSY" to allow it only during busy hours (unlikely).
  508.  
  509. The next five lines control logging. (what goes into LOG.TNC).
  510. YES to turn on logging. Connects/disconnects logged.
  511. YES to turn on GateWay event logging.
  512. YES to turn on file transfer logging.
  513. YES to turn on message event logging.
  514. YES to turn on logging of local commands.
  515. Message for number of calls in call list, $Q is #.
  516.  
  517. The next line is the "bye bye" message.
  518. The next line is the header for the list of calls recently heard.
  519.  
  520.  
  521.      W0RLI MailBox and GateWay   Version 12.0 - 5/11/87   Page 14
  522.  
  523.  
  524. The next lines appear locally only:
  525. The control character to use to kick user off system.
  526. The control character to use to return from talk.
  527. The control character to use to interrupt and go to talk.
  528. The control character to use to take the MailBox off-line.
  529. Message to send to console on entry to terminal mode.
  530. Prompt if save file exists. Erase and start new, or not.
  531. Prompt before continue at end of page of output.
  532. Prompt when enter terminal mode and user is connected.
  533. Message when going into auto answer mode.
  534. Message to send user when get *** LINKED to
  535. Prompt to enter year.
  536. Prompt to enter month.
  537. Prompt to enter day.
  538. Prompt to enter hour.
  539. Prompt to enter minute.
  540.  
  541. The next group of lines (to *** EOF) is what to send the tnc to
  542. put it in "idle" mode (COMM port).
  543. The next group of lines (to *** EOF) is what to send the tnc to
  544. put it in "idle" mode (PRINTER port).
  545. The next group of lines (to *** EOF) is what to send the tnc to
  546. put it in "user" mode (COMM port).
  547. The next group of lines (to *** EOF) is what to send the tnc to
  548. put it in "user" mode (PRINTER port).
  549. The next group of lines (to *** EOF) is what to send the tnc to
  550. put it in "remote sysop" mode (COMM port).
  551. The next group of lines (to *** EOF) is what to send the tnc to
  552. put it in "remote sysop" mode (PRINTER port).
  553. The next group of lines (to *** EOF) are the commands that will be
  554. sent to the COMM port TNC at startup.
  555. The next group of lines (to *** EOF) are the commands that will be
  556. sent to the PRINTER port TNC at startup.
  557.  
  558. The next line is sent to the console each time a menu is sent
  559. to the user.
  560. The next line is sent to the user when a connect request occurs.
  561.  
  562. The next line is the message to send when
  563. you break into a MailBox session to talk to the user.
  564. The next line is the response to the user when he wants to talk to you.
  565. The next line is the message to send when
  566. you are not available to talk to the user.
  567. The next line is the message to the console when the user wants
  568. to talk to you.
  569.  
  570.      W0RLI MailBox and GateWay   Version 12.0 - 5/11/87   Page 15
  571.  
  572. The next section, one line per message, is the GateWay messages:
  573. Message when GateWay not available.
  574. Message going into unproto mode.
  575. Message when user does not specify call for connect.
  576. Message when attempting a connect.
  577. Message when connect fails.
  578. Message to master tnc when connect succeeds.
  579. Message when connect attempt aborted by user.
  580. Message to send to slave tnc on connect.
  581. Message to send to master tnc on connect.
  582. Message to send to local console while link in progress.
  583. (Displayed about every 10 lines)
  584. Message to send to master when entering monitor mode.
  585. Message to send to master when monitor disallowed.
  586. Message to send to master when connects via "*** LINKED to" are disallowed.
  587.  
  588. The next section, one line per message, is the message and file prompts.
  589. Prompt for call of addressee.
  590. Prompt for title of message.
  591. Prompt for message text.
  592. Prompt for message number.
  593. Message to send at login if user has new mail.
  594. Message list header. Observe columns if change.
  595. Line to pre-pend to a forwarded message.
  596. Prompt to edit TO.
  597. Prompt to edit FROM.
  598. Prompt to edit AT BBS.
  599. Prompt to edit TITLE.
  600. Prompt to edit message status.
  601. Prompt to edit TYPE.
  602. Message to send to console when untangle and file empty.
  603. Message to send to console when starting an untangle.
  604. Message to send as each msg deleted with KM.
  605. Minute of the hour to attempt forwarding.
  606. Max # of calls in "unread mail" list.
  607. YES to enable auto-kill of messages auto-forwarded (NO leaves
  608. the message with status set to 'F').
  609. YES to allow "F" type messages to avoid auto-kill on auto-forward.
  610. YES to generate a service message on KT.
  611. YES to enable ET command for non-sysops
  612. Prompt for new TO    in ET command.
  613. Prompt for new AT    in ET command.
  614. Prompt for new TYPE  in ET command.
  615. Prompt for new TITLE in ET command.
  616. Error message for attempting ET on a non-NTS message.
  617.  
  618. Prompt for file text.
  619.  
  620. Default user name.
  621. Message for number of users in file, $Q is #.
  622. Message when compress user file.
  623. Header for list of user records.
  624. Prompt to delete user record.
  625. Prompt to change user call in user record.
  626. Prompt to change user SSID.
  627. Prompt to change user privilege level.
  628. Prompt to change user name in user record.
  629. Prompt to specify users tnc port (A or B).
  630. Prompt to change user path.
  631. Prompt to change "local user" flag.
  632. Prompt to change "expert user" flag.
  633. Prompt to change "is a bbs" flag.
  634.  
  635. Message to send with P command. End with $H
  636. Message to send with P command, and connect is direct.
  637. Message to send with P command, and user was linked. End with $H
  638.  
  639. The next section, one line per message, is the error/status messages:
  640. Message for error in file name.
  641. Message for I/O error.
  642. Message for "can't find it".
  643. Message for protection violation (tried to read private msg etc.).
  644. Message for "file exists, and you can't erase it".
  645. Message for timout.
  646. Message for "I didn't understand the command you gave".
  647. Message for done (command completed).
  648.  
  649. The next 8 lines are messages about untangling.
  650. .DAT does not exist.
  651. Failed on rename
  652. Failed on open of .BAK
  653. "Serious problem"
  654. Deleting old .BAK
  655. Renaming .DAT to .BAK
  656. Copying .DAT to .BAK
  657. Making new .DAT
  658.  
  659.      W0RLI MailBox and GateWay   Version 12.0 - 5/11/87   Page 16
  660.  
  661.      Automatic forwarding of messages to other MailBox systems.
  662.  
  663.      The file FWD.TNC contains information that drives the
  664. automatic forwarding of messages. If the file does not exist,
  665. no forwarding is done. The file contains several kinds of information:
  666.  
  667. "F" or "G" lists are lists of stations for whom you should forward mail.
  668. They are grouped by the call of the MailBox to which their mail 
  669. should be forwarded. The header of each list looks like:
  670.  
  671. Columns     Data
  672.   1         "F" or "G"
  673.   2         TNC identifier. "A" = TNC on COMM port, "B" = PRINTER port.
  674.   3-4       Hour to activate forwarding to this station.
  675.   5-6       Hour to de-activate forwading to this station.
  676.   7-end     The text to send to the TNC to do the connet.
  677.  
  678. After the header, each line up to the next *** EOF is a destination
  679. address.  Mail to each such address will be forwarded to the
  680. destination in the header.  A destination can be any up-to-6-character
  681. string, such as "K1BC" or "NTS".  It can also be wild-carded, using
  682. the CP/M rules for wildcards: A "*" means "this and following
  683. characters can be anything".  A "?" means "this single character
  684. can be anything".   For example: "NTS7*" means any message to
  685. a destination whose first four characters are "NTS7" will be sent
  686. to this forwarding station.  It is intended to support routing to
  687. NTS701 through NTS799 (for zip codes 70100 through 79999). But there
  688. are probably other uses for this feature.
  689.  
  690. A "G" list is the same as an "F" list, except the MailBox will 
  691. add "< FROM" when it sends the message. This is only compatible with
  692. target MailBoxes running version 10.0 and above.
  693. Forwarding will occur at the minute given in CONFIG.TNC, on those
  694. hours given in FWD.TNC.
  695.  
  696. An "H" item is a single line preceeding an "F" or "G" list.
  697. Immediately following the "H" is the data to send to a GATOR 2 PAD
  698. if the station you will forward to is reached through such a pad.
  699. In this case, the "F" or "G" item contains the call of the PAD.
  700.  
  701. "P" lists are commands to be sent to the TNC. The character after
  702. the P is which TNC (PA or PB). The list is terminated with
  703. "*** EOF". One of these lists might preceed each "F" list to
  704. set the TNC parameters to be used for the forward attempt.
  705. There should be a "P" list at the end of the FWD.TNC file to
  706. reset TNC parameters back to default.
  707.  
  708.      W0RLI MailBox and GateWay   Version 12.0 - 5/11/87   Page 17
  709.  
  710. The following is an example of FWD.TNC for W0RLI:
  711.  
  712. (Forward to K1BC every hour)
  713. FA0023C K1BC VIA KD2S-1 <Function, TNC ID, Time, MailBox and path>
  714. W1XR             <Call of station whose mail should be forwarded>
  715. N1AWX
  716. K1BC
  717. NTS*             <Send him all my NTS traffic>
  718. *** EOF          <Marks the end of list>
  719. PB               <Set TNC params for K7PYK connection>
  720. FRACK 6
  721. MAXFRAME 2
  722. *** EOF
  723. (Forward to K7PYK only from 1200 to 0259 GMT)
  724. GB1202C K7PYK     <The next MailBox to forward to>
  725. K7PYK
  726. W7KB
  727. *** EOF
  728. (Forward to N2WX-1 through the GATOR 2 PAD at 305MLB)
  729. HN2WX-1                 <The call to send to the PAD>
  730. GA0023C 305MLB v STU    <How to connect to the PAD>
  731. K4NTA
  732. N2WX
  733. *** EOF
  734. PB                      <Set TNC params back to normal>
  735. FRACK 4
  736. MAXFRAME 4
  737. *** EOF
  738.  
  739.  
  740.      There is no limit to the number of lists or the number of
  741. calls in each list. Your MailBox will do the connect and send the 
  742. messge onward. It will either delete it or mark it with 'F' status
  743. depending on the setting of the YES/NO (Kill on forward) flag in
  744. CONFIG.TNC. Auto forwarding is attempted each hour at the minute
  745. specified in CONFIG.TNC, or when you use the "X" menu item.
  746.  
  747.      The special call "*" (a single *) can be used to force the
  748. forwarding of all mail not addressed to the system owner. This
  749. could be used by someone who would like to run this software, but
  750. would not like to maintain an active MailBox. They would get all
  751. their own mail locally, but any mail deposited onto their system
  752. would be automatically forwarded.
  753.  
  754.      The forwarding of messages counts on the remote MailBox
  755. behaving correctly. It must have a menu with '>' at the end
  756. of the last line. The command for sending messages must have the
  757. form "Sx call". It must prompt for message title, and then prompt
  758. for message text. Message text is terminated by ^Z.
  759.  
  760.      W0RLI MailBox and GateWay   Version 12.0 - 5/11/87   Page 18
  761.  
  762.      Busy and Quiet times.
  763.  
  764. There are some parameters which can be set to change automatically
  765. to different values during "busy" hours versus "quiet" hours.
  766. This is to allow you to restrict heavy demand activity when the
  767. channel is the busiest.
  768.  
  769. Busy and Quiet hours are defined by a line in the configuration file.
  770.  
  771. The parameters which may be set this way take "YES", "NO", "BUSY"
  772. and "QUIET" for their arguments.  The following are in this category:
  773.  
  774. - Allow only BBSes to connect on the COMM port (port A).
  775. - Allow only BBSes to connect on the PRINTER port (port B).
  776. - Allow only BBSes to connect via "*** LINKED to W0xxx" (port L).
  777. - Gateway enabled.
  778. - Gateway monitoring enabled.
  779.  
  780. For example, in New England, there is a 220 MHz backbone for
  781. inter-BBS forwarding.  A BBS on that backbone might set port B and
  782. port L to "BUSY" so non-BBS users can't clutter the backbone
  783. during busy hours.  They might also set "Gateway enabled" to "QUIET",
  784. to allow their station to be used as a gateway only during quiet hours.
  785.  
  786.  
  787.      W0RLI MailBox and GateWay   Version 12.0 - 5/11/87   Page 19
  788.  
  789.      Files used by the MailBox.
  790.  
  791. - The MailBox and GateWay
  792.  
  793.    TNC.MAC     - Main program.
  794.    CHARIO.MAC  - Character I/O routines.
  795.    FILEIO.MAC  - File I/O routines.
  796.    EDFIL.MAC   - File Editor.
  797.    EDMSG.MAC   - Message header editing.
  798.    EXTDIR.MAC  - Disk directory display.
  799.    FWD.MAC     - Auto-forwarding.
  800.    GATE.MAC    - GateWay.
  801.    HDW.MAC     - Code for scan resume.
  802.    INIT.MAC    - Initialize, read the configuration file.
  803.    ISCALL.MAC  - Legal callsign check.
  804.    LOG.MAC     - Logging routines.
  805.    LOGIN.MAC   - User login stuff.
  806.    MAIL.MAC    - MailBox.
  807.    MBFILE.MAC  - Mail file stuff.
  808.    MISC.MAC    - Misc subroutines.
  809.    MONITOR.MAC - Idle time channel monitor.
  810.    PARAM.MAC   - Set parameter command.
  811.    PARSE.MAC   - Command line parser.
  812.    USER.MAC    - Periodically called user written function.
  813.    USR.MAC     - Code to deal with the user file.
  814.    UNT.MAC     - Clean the mail file.
  815.  
  816. - Macro librareis.
  817.  
  818.    TNC.LIB
  819.  
  820. - Documentation
  821.  
  822.    CHANGES.TNC - Software change log.
  823.    DOC.TNC   - Description of how to use the MailBox
  824.    NOTES.TNC - Release notes, tech notes, installation notes, etc.
  825.  
  826. - Data files
  827.  
  828. CONFIG.TNC- Text file. Configuration data, message of the day,
  829.             help command text, error message text, etc.
  830.  
  831. FWD.TNC - The routing tables for forwarding messages.
  832.  
  833. LOG.TNC - The station log.
  834.  
  835. MON.TNC - The saved "J" lists.
  836.  
  837.      W0RLI MailBox and GateWay   Version 12.0 - 5/11/87   Page 20
  838.  
  839. - Xerox 820 BIOS and boot loader
  840.  
  841. The files BIOS????.INC are various parts of the BIOS code.
  842. TNC.LIB   - Macro library.
  843. BOOT.MAC  - The boot loader source code.
  844. BOOT.COM  - The boot loader object code.
  845. SBIOS.MAC - The bootstrap BIOS source code.
  846. SBIOS.COM - The bootstrap BIOS object code.
  847. CBIOS.MAC - The real BIOS source code.
  848. CBIOS.COM - The real BIOS object code.
  849.  
  850. - Files used to create system disks.
  851.  
  852. MAKESYS.COM - Put system onto disk.
  853. XCPM.COM    - CCP+BDOS, 60K CP/M.
  854. BOOT.COM    - Boot loader object file.
  855. SBIOS.COM   - Bootstrap BIOS object file.
  856. CBIOS.COM   - Real BIOS object code.
  857.  
  858. XCPM.COM is a copy of YOUR 60k CP/M system, you may create it in any
  859. convenient manner. For example, use DU to bring the image into
  860. memory, DDT to move it to 100 hex, and SAVE to write it to disk.
  861.  
  862.     Another example:
  863.  
  864. MOVCPM 60 *
  865. SAVE 34 CPM.COM
  866. DDT CPM.COM
  867. m 980,1f7f,100
  868. G0
  869. SAVE 22 XCPM.COM
  870.  
  871.  
  872. - The disk that is running the MailBox requires only:
  873.  
  874. A CP/M (or equivalent) system.
  875. CBIOS.COM  - The BIOS object code, placed on the disk by MAKESYS.
  876. TNC.COM    - The MailBox.
  877. CONFIG.TNC - Configuration data used by TNC.COM
  878. FWD.TNC    - Routing tables, required ONLY if automatic forwarding
  879.              is to be used.
  880.  
  881.      W0RLI MailBox and GateWay   Version 12.0 - 5/11/87   Page 21
  882.  
  883. The following files are created and used by the MailBox:
  884.  
  885. MAIL.DAT  - The mail messages.
  886. USER.DAT  - The user database.
  887. CALLS.TNC - Text file. List of all calls seen in monitor mode.
  888. MON.TNC   - The saved "J" lists.
  889. LOG.TNC   - The log file. A text file that contains the user log.
  890.             Which events are to be logged is specified in CONFIG.TNC.
  891.  
  892.    Each line in the log file contains an event code, the date and time,
  893.    followed by further information about the event.
  894.  
  895.    'C' - User connected to system.
  896.       'A' - User connected on TNC on COMM port.
  897.       'B' - User connected on TNC on PRINTER port.
  898.       'E' - Owner took MailBox off line.
  899.       'I' - Owner initial login.
  900.       'L' - User was linked via the station that just connected.
  901.  
  902.    'G' - GateWay event.
  903.       'A' - Connection attempted and failed. Path shown.
  904.       'C' - Connection attempted and obtained. Path shown.
  905.       'E' - End of GateWay event, or use.
  906.       'M' - Start of monitoring.
  907.       'S' - Start of GateWay use.
  908.       'U' - Entry to unprotocol mode.
  909.  
  910.    'X' - Exit.
  911.       'A' - Owner put MailBox on line.
  912.       'B' - User said good bye.
  913.       'D' - User disconnected.
  914.       'E' - Excluded user attempted connect.
  915.       'F' - User forced off by system owner.
  916.       'Q' - Owner exited from program.
  917.       'T' - Timeout, forced disconnect.
  918.  
  919.    'F' - File event. Command line shown as user entered it.
  920.  
  921.    'M' - Message event. Message number always shown.
  922.       'F' - Message has been forwarded. Connect path shown.
  923.       'K' - Message has been killed.
  924.       'L' - Message headers listed.
  925.       'R' - Message has been read.
  926.       'S' - Message has been sent.
  927. 
  928.