home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1997 / WOHR97_AmSoft_(1997-02-01).iso / packet / pak_27 / amsoft.iii next >
Text File  |  1997-02-01  |  96KB  |  2,090 lines
  1.  
  2.  
  3.  
  4.                     ╒══════════════════════════════╕
  5.                     │ PHS - PK-232 Hostmode Server │
  6.                     ╘══════════════════════════════╛
  7.  
  8.                 HB9CVV
  9.                              October 1989
  10.  
  11.                              Version 3.00
  12.  
  13.  
  14. PHS is a Packet Radio terminal program for the IBM-PC to controll a PK-232
  15. multi-mode terminal node controller (TNC). The eprom of the PK-232 software must
  16. be dated 30.DEC.88 or later.
  17.  
  18.  
  19.                         Major features of PHS
  20.                         ═════════════════════
  21.  
  22.    * support of packet, amtor, rtty, ascii, morse and signal modes.
  23.    * user configurable comm-port, colors and texts.
  24.    * split screen operation.
  25.    * command and parameter entry in mode sensitive dialog windows.
  26.    * extended help functions.
  27.    * review of received text (backscrolling).
  28.    * printing and snapshooting the review-buffer.
  29.    * logging (capturing) to file.
  30.    * online printer support.
  31.    * send text from file.
  32.    * binary file transfer using YAPP protocol (packet mode).
  33.    * multi-channel operation (packet mode).
  34.    * heard list showing the path (packet mode).
  35.    * Net/Rom frames are decoded (packet mode).
  36.    * wordwrapping is available (packet mode).
  37.    * temporary exit to DOS.
  38.    * built-in message editor.
  39.    * support for screens up to 80*60.
  40.    * 16550A Chip support with FIFO.
  41.  
  42.  
  43. PHS has been derived from THS V2.50 (my TNC Hostmode Server for TNCs with the
  44. WA8DED software or for the PC*Packet Adapter from DRSI). By this, the 
  45. initial version number of PHS is 3.00.
  46.  
  47.  
  48. PHS has been developped on a PC/AT under IBM DOS 4.0. PHS may run or may not run
  49. on other hardware, and on earlier (pre 3.3) or other versions of the operating
  50. system.
  51.  
  52. For slower PCs the maximum usable serial line speed is limited to 4800 or 2400
  53. baud unless the 8250 or 16450 UART chip of the async adapter has been replaced
  54. by a 16550A chip. The replacement is highly recommended for faster machines as
  55. well.
  56.  
  57. The memory requirements of PHS are about 360 kB. If you can start PHS, but get
  58. once the message "TERMINAL ERROR: cannot open a window" you do not have enough
  59. memory to run PHS.  It is possible to reduce the memory requirements of PHS by
  60. reducing the window sizes.  The minimum requirements will be about 250kB.
  61.  
  62. PHS is a hobby project and covers my needs, so I implemented the features which
  63. I wished to have, and did not bother to fit all tastes and to match all
  64. possibilities.  PHS may well be not adequate for your requirements, please
  65. remember however that you are not forced to use it, nor did you have to pay for
  66. it.
  67.  
  68.  
  69.  
  70.  
  71.                         PRINCIPLES OF OPERATION
  72.                         ═══════════════════════
  73.  
  74. PHS runs the PK-232 software exclusively in HOST mode, which permits a maxiumum
  75. of control and cooperation. PHS is written in TURBO-C and uses a realtime kernel
  76. called CTASK. CTASK is public domain software written by Thomas Wagner, Berlin,
  77. West-Germany and which is found on BIX (a truly remarkable piece of software!).
  78.  
  79. The internal implementation of PHS in form of several concurrent tasks.  This
  80. permits full parallel service of communications control, screen, and keyboard -
  81. you will never notice delays when you type (opposed to other similar programs).
  82.  
  83. The windowing system is implemented using the VITAMIN C library (with
  84. modifications), a commercially available software library.  Vitamin C permits
  85. writing to non-active windows, so scrolling in an underlying window is possible.
  86.  
  87. This feature, together with the real-time operation, permits to continue the
  88. receiving and displaying of received packets even when support windows (e.g.
  89. help windows or parameter dialog windows) are opened.
  90.  
  91. The PK-232 device is also called "device" or "TNC" in this document.
  92.  
  93.  
  94.  
  95.                               INSTALLATION
  96.                               ════════════
  97.  
  98.  
  99. It is expected that you are familiar with the operation of the PK-232 and with
  100. the documents describing that software.
  101.  
  102.  
  103. PHS consists of the following files:
  104.  
  105.         PHS.EXE         PK-232 Hostmode Server.
  106.     PHS.CFG        Configuration file.
  107.     PHSHELP.MSG    Help file.
  108.     PHSHELP.IDX    Index file.
  109.         PHS.DOC         Document file
  110.         PHSCOLOR.EXE    Utility to determine the PHS colors
  111.  
  112. The first four files must reside in the same directory. Before you can run PHS,
  113. you MUST edit the configuration file PHS.CFG to reflect YOUR environment, and
  114. possibly you might have to configure your PK-232 also. Please refer to the
  115. description of the configuration file at the end of this manual.
  116.  
  117. The syntax to call PHS is: "PHS [filename]" where filename is the name of a
  118. configuration file. If filename is omitted, PHS will use the default, PHS.CFG.
  119.  
  120. The PK-232 has a support battery to buffer the parameter values. If you use this
  121. battery, some PK-232 parameter must be preset to values which allow PHS to
  122. communicate with the PK-232. The communication line parameters of the PK-232
  123. must be set to 8 bits, no parity, and the line speed must match the selected
  124. line speed for PHS.
  125.  
  126. Alternatively, when no battery is connected, PHS will switch the PK-232 to the
  127. selected line speed of PHS.
  128.  
  129. Though not neccessarily required for hostmode operation PHS requires the
  130. standard 8-wire connection (lines 2-8 and 20) for the RS-232 communication line.
  131. You can however override this requirement by a parameter in the configuration
  132. file.
  133.  
  134.  
  135.  
  136.                         PHS OPERATION
  137.                         ═════════════
  138.  
  139. After you invoked PHS, you get the PHS opening screen:
  140. ───────────────────────────────────────────────────────────────────────────────
  141.  
  142.  
  143.  
  144.  
  145.      ╒══════════════ PK-232 Host mode Server V3.00 - HB9CVV ═══════════════╕
  146.      │                                                                     │
  147.      │  COM Port parameters - Address: 0x3E0, IRQ: 3, Baud: 9600 (8N1)     │
  148.      │  Initializing COM Port - DSR: on, CTS: on, CD: on, FIFO: yes        │
  149.      │  Initializing TNC - please wait........done.                        │
  150.      │  PK-232 eprom date is: 30-DEC-88.                                   │
  151.      │  Loading TNC parameters: done.                                      │
  152.      │  Loading "%" parameters: done.                                      │
  153.      │  READY - 137 kb free. Use ESC for help.                             │
  154.      │                                                                     │
  155.      ╘═════════════════════════════════════════════════════════════════════╛
  156.  
  157.  
  158.  
  159.  
  160.  
  161.                                                          │    ║ 23-OCT 12:34:56
  162.  
  163.  
  164.  
  165.  
  166. ───────────────────────────────────────────────────────────────────────────────
  167.  
  168. PHS will read the number-of-lines of your current video mode from the system and
  169. adjust its windows accordingly. For the screendumps, the standard of 25 lines
  170. has been used.
  171.  
  172. The single line with the date and time is the statusline, which is normally
  173. invers - you cannot see this in this printout. You also see that PHS divides the
  174. screen into the upper receive window and the lower transmit window which are
  175. seperated by the statusline. The statusline is different for each mode.  During
  176. initialisation and for a short time during the PK-232 mode switching the
  177. statusline is blanked in the left part.
  178.  
  179. You can change the colors of all windows (this includes the statusline) by
  180. editing the associated values in the configuration file.
  181.  
  182. When this opening screen disappears, PHS switches the PK-232 into the initial
  183. PK-232 mode, which is also specified in the configuration file.
  184.  
  185. You will realize that PHS temporarily switches the PK-232 into the morse mode
  186. during the initialisation phase. Also, when you exit PHS, the PK-232 is left in
  187. the morse mode.
  188.  
  189. "FIFO: yes" indicates that PHS has detected an NS16550A asynchronous
  190. communictions chip and has enabled the fifo-buffer operation of this chip.
  191.  
  192.  
  193.  
  194.                         THE GENERAL KEYS
  195.                         ────────────────
  196.  
  197.  
  198. The ESC key is the general help key to call the help window. If you press ESC in
  199. packet mode, then the packet-mode help screen pops up:
  200.  
  201. ───────────────────────────────────────────────────────────────────────────────
  202.   ╒═══════════════════════════════ PACKET MODE ═══════════════════════════════╕
  203.   │                                     ║                                     │
  204.   │ ALT/P   TNC mode param setup menu   ║ ALT/I   TNC text-param setup menu   │
  205.   │ ALT/T   PHS parameter setup menu    ║ ALT/V   View DOS directory          │
  206.   │ ALT/W   Command string directory    ║ ALT/J   Toggle printer on/off       │
  207.   │ ALT/F   View function-key setup     ║ ALT/L   Logging (capture) on/off    │
  208.   │ ALT/R   or î Review (scrollback)    ║ ALT/S   Send an ASCII file          │
  209.   │ ALT/K   Call Editor                 ║ ALT/E   Temporary exit to DOS       │
  210.   │ ALT/B   Enter urcall (remote call)  ║ CTRL/U  Erase TX-window             │
  211.   │ ALT/X   Exit PHS                    ║ CTRL/X  Erase RX-window             │
  212.   │ ALT/M   Switch TNC modes            ║ CTRL/ESC  Direct command entry      │
  213.   │ ─────────────────────────────────── ║ ─────────────────────────────────── │
  214.   │ ALT/C   Connect menu                ║ ALT/H   Show formatted heard list   │
  215.   │ ALT/D   Disconnect                  ║ ALT/G   Show raw heard list         │
  216.   │ PgUp    Binary file upload (YAPP)   ║ INS     Toggle status line display  │
  217.   │ PgDn    Binary file download (YAPP) ║ <- ->   Select Channel              │
  218.   │                                     ║                                     │
  219.   ╘═══════════════════════════════════════════════════════════════════════════╛
  220.  
  221.  
  222.  
  223.  M1234 ║ VHF ║ UA:00 RTY:00 │ DISCONNECTED               │    ║ 23-OCT 12:34:56
  224.  
  225.  
  226.  
  227. ───────────────────────────────────────────────────────────────────────────────
  228.  
  229. The help window called by ESC is mode sensitive. The upper half of the help
  230. window (down to the seperator) is identical for all modes because the keys are
  231. valid in all modes and are called general keys. The lower half presents the keys
  232. which are mode specific, and are called mode keys.
  233.  
  234. We will now discuss the actions and the support windows caused by the general
  235. keys presented in the upper part of the help window, followed by a discussion of
  236. the individual modes and the mode-related keys and windows.
  237.  
  238. Note that when any support window is open and you want to cancel it, press ESC
  239. and the window will disappear. If there is no action from the keyboard, any of
  240. these windows will also disappear after some time.
  241.  
  242. You will also notice that the activity in the receive window will continue when
  243. any of the support windows is popped up.
  244.  
  245.  
  246.  
  247. ALT/P is a general key and available for all modes. It pops up a window and
  248. shows the PK-232 parameters which are related to the currently selected mode.
  249. Consequently, the ALT/P window is discussed individually for each mode later.
  250.  
  251.  
  252. ALT/I pops up the PK-232 text parameter setup window:
  253.  
  254. ───────────────────────────────────────────────────────────────────────────────
  255.  
  256.  
  257.  
  258.  
  259.  
  260.                               ╒═══ SELECT ═══╕
  261.                               │              │
  262.                               │ (A) CFROM    │
  263.                               │ (B) DFROM    │
  264.                               │ (C) MFROM    │
  265.                               │ (D) MTO      │
  266.                               │ (E) UNPROTO  │
  267.                               │ (F) BTEXT    │
  268.                               │ (G) CTEXT    │
  269.                               │ (H) AAB      │
  270.                               │              │
  271.                               ╘══════════════╛
  272.  
  273.  
  274.  
  275.  
  276.  M1234 ║ VHF ║ UA:00 RTY:00 │ DISCONNECTED               │    ║ 23-OCT 12:34:56
  277.  
  278.  
  279.  
  280. ───────────────────────────────────────────────────────────────────────────────
  281.  
  282. To select the command parameter for inspection or change, you can either press
  283. the marked character (A, B, C etc), or move the scroll bar up and down and then
  284. press ENTER (the bar is just not visible in this printout).  This window will
  285. then disappear and the associated parameter entry window will pop up.
  286.  
  287. This window will pop up regardless of the current PK-232 mode.
  288.  
  289.  
  290. When you select CFROM, DFROM, MFROM or MTO then the associated parameter entry
  291. window pops up - for example:
  292.  
  293. ───────────────────────────────────────────────────────────────────────────────
  294.  
  295.  
  296.  
  297.                  ╒═══ CFROM ════╕
  298.                  │              │
  299.                  │     ALL      │
  300.                  │              │
  301.                  │              │
  302.                  │              │
  303.                  │              │
  304.                  │              │
  305.                  │              │
  306.                  │              │
  307.                  │              │
  308.                  │              │
  309.                  │              │
  310.                  │ <F1>  HELP   │
  311.                  │ <ESC> ABORT  │
  312.                  │ <F10> ACCEPT │
  313.                  │              │
  314.                  │              │
  315.  M1234 ║ VHF ║ UA╘══════════════╛CONNECTED               │    ║ 23-OCT 12:34:56
  316.  
  317.  
  318.   Valid entries are: ALL / NONE / YES / NO
  319. ───────────────────────────────────────────────────────────────────────────────
  320.  
  321. You can enter a qualifier (ALL, NONE, YES or NO) and a list of callsigns.
  322.  
  323.  
  324.                        Operation of Support Windows
  325.                        ────────────────────────────
  326.  
  327. For all support windows which show the parameter values of commands, PHS always
  328. READS the current parameter values first so you can inspect the actual values
  329. and then apply changes. The cursor is the positioned on the first input field,
  330. and the size of each input field is visible on the screen (which is not visible
  331. in the printouts here). You move to another commands input field with the
  332. down-arrow and up-arrow keys. For each command you will always get a short help
  333. line on the bottom of the screen. If you need more help about the command and
  334. the parameters, press F1.
  335.  
  336. With kind permission from AEA, the help texts for the PK-232 commands have been
  337. derived from manual files supplied by AEA and is copyrighted material.
  338.  
  339. Finally you may press either F10 to accept the data and apply the parameter
  340. values, or ESC to discard it, in case you changed your mind.
  341.  
  342.  
  343.  
  344. You must follow the rules for the parameters of a command as described in the
  345. PK-232 manual.  In case of the CFROM window - if you enter ALL, followed by a
  346. callsign list this makes no sense, and you will get an error message from the
  347. PK-232:
  348.  
  349. ───────────────────────────────────────────────────────────────────────────────
  350.  
  351.  
  352.  
  353.                  ╒═══ CFROM ════╕
  354.                  │              │
  355.                  │     ALL      │
  356.                  │              │
  357.                 ╒═══════════════════ TNC: ════════════════════╕
  358.                 │ CFROM - msg from device: "Too many params"  │
  359.                 ╘═════════════════════════════════════════════╛
  360.                  │   HB9DDD     │
  361.                  │   HB9EEE     │
  362.                  │   HB9FFF     │
  363.                  │              │
  364.                  │              │
  365.                  │              │
  366.                  │ <F1>  HELP   │
  367.                  │ <ESC> ABORT  │
  368.                  │ <F10> ACCEPT │
  369.                  │              │
  370.                  │              │
  371.  M1234 ║ VHF ║ UA╘══════════════╛CONNECTED               │    ║ 23-OCT 12:34:56
  372.  
  373.  
  374.  
  375. ───────────────────────────────────────────────────────────────────────────────
  376.  
  377. MFROM and MTO is preset to "NO", followed by your callsign. The reason for this
  378. is that PHS monitors when connected, and this excludes your own packets from the
  379. monitor screen. You should not change this if not absolutely neccessary.
  380.  
  381.  
  382.  
  383. Here is an example of the UNPROTO parameter entry window:
  384.  
  385. ───────────────────────────────────────────────────────────────────────────────
  386.  
  387.  
  388.                  ╒══ UNPROTO ═══╕
  389.                  │              │
  390.                  │ To:          │
  391.                  │   DB0CZ      │
  392.                  │ via          │
  393.                  │   HB9PD-7    │
  394.                  │   DB0HP      │
  395.                  │              │
  396.                  │              │
  397.                  │              │
  398.                  │              │
  399.                  │              │
  400.                  │              │
  401.                  │              │
  402.                  │ <F1>  HELP   │
  403.                  │ <ESC> ABORT  │
  404.                  │ <F10> ACCEPT │
  405.                  │              │
  406.  M1234 ║ VHF ║ UA╘══════════════╛CONNECTED               │    ║ 23-OCT 12:34:56
  407.  
  408.  
  409.   Callsign and SSID of a digipeater
  410. ───────────────────────────────────────────────────────────────────────────────
  411.  
  412. In this example the cursor is positioned somewhere in the "via" list of
  413. callsigns.
  414.  
  415.  
  416.  
  417. If you selected the BTEXT window, you will get this screen:
  418.  
  419. ───────────────────────────────────────────────────────────────────────────────
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.   ╒══════════════════════════════ BEACON TEXT ═══════════════════════════════╕
  429.   │                                                                          │
  430.   │ *** Peter, Qth: Port/Biel - JN37OC                                       │
  431.   │                                                                          │
  432.   │     <F1> HELP    <ESC> ABORT    <CR> or <F10> ACCEPT                     │
  433.   │                                                                          │
  434.   ╘══════════════════════════════════════════════════════════════════════════╛
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  M1234 ║ VHF ║ UA:00 RTY:00 │ DISCONNECTED               │    ║ 23-OCT 12:34:56
  441.  
  442.  
  443.   Enter beacon text. Use % to clear it
  444. ───────────────────────────────────────────────────────────────────────────────
  445.  
  446. The initial beacon text has been sent from the beacon string in the
  447. configuration file during the initialisation phase of PHS. It is read from the
  448. TNC for presentation, so you will always see the actual beacon text. Note
  449. however that PHS limits the length of the beacon string to 72 characters.
  450.  
  451. You will get a similar window for the CONNECT message (CTEXT), and for AAB. The
  452. input field for CTEXT is also 72 characters, for AAB it is 16 characters.
  453.  
  454.  
  455.  
  456. The ALT/V key pops up this window which allows you to specify a DOS directory
  457. for viewing, e.g.:
  458.  
  459. ───────────────────────────────────────────────────────────────────────────────
  460.  
  461.  
  462.      ╒═════════════════════ Directory ══════════════════════╕
  463.      │                                                      │
  464.      │ C:\DOS\*.*                                           │
  465.      │                                                      │
  466.      ╘══════════════════════════════════════════════════════╛
  467.  
  468.  
  469. ────────────────────────────────── .... ───────────────────────────────────────
  470.  
  471. Next you will get something like this:
  472.  
  473. ───────────────────────────────────────────────────────────────────────────────
  474.  
  475.  
  476.           ╒═════════════════ DIRECTORY ═════════════════╕
  477.           │                                             │
  478.           │  ANSI    .SYS      9172   29-MAR-89  12:00  │
  479.           │  APPEND  .EXE     11186   03-AUG-88  12:00  │
  480.           │  ASSIGN  .COM      5785   17-JUN-88  12:00  │
  481.           │  ATTRIB  .EXE     18247   17-JUN-88  12:00  │
  482.           │  BACKUP  .COM     33818   11-NOV-88  12:00  │
  483.           │  CHKDSK  .COM     17771   17-JUN-88  12:00  │
  484.           │  CMOSCLK .SYS       878   19-SEP-88  12:00  │
  485.           │  COMMAND .COM     37652   11-NOV-88  12:00  │
  486.           │  COMP    .COM      9491   17-JUN-88  12:00  │
  487.           │  CONFIG  .SYS        99   21-SEP-88  14:38  │
  488.           │  COUNTRY .SYS     12838   17-JUN-88  12:00  │
  489.           │  DEBUG   .COM     21606   17-JUN-88  12:00  │
  490.           │  DISKCOMP.COM      9889   17-JUN-88  12:00  │
  491.           │  DISKCOPY.COM     10428   17-JUN-88  12:00  │
  492.           │  DISPLAY .SYS     15741   11-NOV-88  12:00  │
  493.           │  DRIVER  .SYS      5274   17-JUN-88  12:00  │
  494.           │          ...more...                         │
  495.  M1234 ║ V│                                             ││    ║ 23-OCT 12:34:56
  496.           ╘═════════════════════════════════════════════╛
  497.  
  498.  
  499. ───────────────────────────────────────────────────────────────────────────────
  500.  
  501.  
  502. The ALT/E key suspends PHS and temporarily exits to DOS:
  503.  
  504. ───────────────────────────────────────────────────────────────────────────────
  505.  
  506. IBM DOS Version 4.00
  507.             (C)Copyright International Business Machines Corp 1981, 1988
  508.             (C)Copyright Microsoft Corp 1981-1986
  509.  
  510. Enter 'EXIT' to return to PHS
  511. D:\PHS> mem
  512.  
  513.  
  514.     655360 bytes total memory
  515.     655360 bytes available
  516.     133792 largest executable program size
  517.  
  518.     393216 bytes total EMS memory
  519.     393216 bytes free EMS memory
  520.  
  521.    3145728 bytes total extended memory
  522.    1572864 bytes available extended memory
  523.  
  524. Enter 'EXIT' to return to PHS
  525. D:\PHS> EXIT
  526.  
  527. ───────────────────────────────────────────────────────────────────────────────
  528.  
  529. After you typed EXIT at the DOS prompt, PHS will return on the screen. Note that
  530. PHS is completely suspended when you exited to DOS. The PK-232 will continue to
  531. receive data which are not called by PHS during the suspension.  You will loose
  532. data if you do not return to PHS timely.
  533.  
  534.  
  535. ALT/W pops up the command string directory:
  536.  
  537. ───────────────────────────────────────────────────────────────────────────────
  538.                      ╒══════════ COMMAND STRINGS ══════════╕
  539.                      │                                     │
  540.                      │ (A) C DK1SL VIA HB9F                │
  541.                      │ (B) C HB9SDD                        │
  542.                      │ (C) C HB9PD                         │
  543.                      │ (D) C HB9BRC                        │
  544.                      │ (E) C 4U1ITU-8 VIA HB9PD-7, HB9X... │
  545.                      │                                     │
  546.                      ╘═════════════════════════════════════╛
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  M1234 ║ VHF ║ UA:00 RTY:00 │ DISCONNECTED               │    ║ 23-OCT 12:34:56
  560.  
  561.  
  562.  
  563. ───────────────────────────────────────────────────────────────────────────────
  564.  
  565. You will see the command string lines from the configuration file (these are the
  566. lines with '$' in column one). The number of command strings is limited to 20,
  567. and the length of each line is limited to 72. Because the width of this window
  568. is far less than 72, all lines which are too long to fit are truncated for
  569. presentation, which is indicated by the "...".
  570.  
  571. Again, to select a command for execution, you can either press the marked
  572. character (A, B, C etc), or move the scroll bar up and down and then press ENTER
  573. (the bar is just not visible in this printout).
  574.  
  575. Quite obviously, a line must contain a valid PK-232 command or you will get an
  576. error message when you try to execute it. PHS not allow the execution of all
  577. PK-232 commands - it will refuse to send commands which would interfere with its
  578. operation. Please refer to the discussion of CTRL/ESC key.
  579.  
  580.  
  581.  
  582. ALT/F lets you inspect your function key setup:
  583.  
  584. ───────────────────────────────────────────────────────────────────────────────
  585.                      ╒════════ FUNCTION KEY SETUP ═════════╕
  586.                      │                                     │
  587.                      │ F01  Name & Qth                     │
  588.                      │ F02  Rig SHORT                      │
  589.                      │ F03  Rig LONG                       │
  590.                      │ F04  FEC CQ                         │
  591.                      │ F05  RYRYRY                         │
  592.                      │                                     │
  593.                      ╘═════════════════════════════════════╛
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  M1234 ║ VHF ║ UA:00 RTY:00 │ DISCONNECTED               │    ║ 23-OCT 12:34:56
  607.  
  608.  
  609.  
  610. ───────────────────────────────────────────────────────────────────────────────
  611.  
  612. You will get the function key title string, not the function key text which can
  613. be much longer than the title, and even contain several lines.
  614.  
  615. The function key title strings as well as the function key text strings are
  616. defined in the configuration file.
  617.  
  618. This window also pops up should you press a function key which has not been
  619. loaded with a string. Whenever you press a 'loaded' function key, then the
  620. associated function key text is inserted in your output to the PK-232.
  621.  
  622.  
  623.  
  624. ALT/T in any mode pops up the PHS parameter setup window:
  625. ───────────────────────────────────────────────────────────────────────────────
  626.                                                   ╒═ PHS Parameters ══╕
  627.                                                   │                   │
  628.                                                   │ BELL            1 │
  629.                                                   │ CBELL           1 │
  630.                           │ YPKLEN        254 │
  631.                                                   │ WORDWRAP        1 │
  632.                                                   │ MWINDOW         0 │
  633.                                                   │ FILTER          1 │
  634.                                                   │                   │
  635.                                                   │  <F1>  HELP       │
  636.                                                   │  <ESC> EXIT       │
  637.                                                   │  <F10> SET PARAM  │
  638.                                                   ╘═══════════════════╛
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  M1234 ║ HF  ║ UA:00 RTY:00 │ DISCONNECTED               │    ║ 23-OCT 12:34:56
  648.  
  649.  
  650.   Enable the BELL (1/0)
  651. ───────────────────────────────────────────────────────────────────────────────
  652.  
  653. The cursor is positioned at the input field of the first parameter (BELL).  With
  654. any such setup window, you use  the up- and down-arrows to select  the parameter
  655. which you want to change.
  656.  
  657. As with the ALT/P parameter entry windows, PHS reads the actual values, lets you
  658. apply changes, writes the parameters and then re-reads them again. If you
  659. violated a given range for a parameter, then no change is done, and this is
  660. immediately visible after PHS reread the parameters.
  661.  
  662. The PHS parameters are parameters for PHS rather than for the PK-232, and allow
  663. you to:
  664.  
  665.  - enable or disable if you want to hear 'bells' sent to you from a connected
  666.    station (you will never hear bells from monitored stations) (BELL).  This
  667.    parameter is effective in the packet modes only.
  668.  
  669.  - enable or disable if you want to hear a bell (warble) when you get a connect
  670.    (CBELL). This parameter is effective in the packet modes only.
  671.  
  672.  - set the packet frame length for binary transfers (YPKLEN). This parameter is
  673.    effective in the packet modes only.
  674.  
  675.  - enable or disable input word wrapping (WORDWRAP). This parameter is effective
  676.    in the packet modes only where the entered text is not sent before the ENTER
  677.    key is pressed and may contain more than one line.
  678.  
  679.  - define the window which gets the monitored frames (MWINDOW).  By default,
  680.    this is window zero (because channel zero is the monitor channel).  You can
  681.    however route all monitored frames to another channel window of your own
  682.    choice. This parameter is effective in the packet modes only.
  683.  
  684.  - filter out non-printable charcters (MFILTER). If this is enabled, only BELL,
  685.    HT, LF, VT, FF, CR and the characters with ASCII values from 0x20 to 0x7E are
  686.    displayed as is, the filtered charcter are shown as a small solid rectangle.
  687.    If you use a national character set, MFILTER should be disabled.
  688.  
  689.    The initial setting of MFILTER is defined in the configuration file's PHS
  690.    parameter definition line (the "}" line).
  691.  
  692.  
  693. YPKLEN needs an explanation. For binary sends, PHS switches the PK-232 into  the
  694. transparent mode and the packet length  is defined by YPKLEN. That is,  PHS will
  695. read YPKLEN slices from the file, add the YAPP protocol layer and send it to the
  696. PK-232 (the PK-232 parameter PACLEN remain always preset to the maximum value of
  697. 256 bytes).
  698.  
  699.  
  700.  
  701. ALT/K invokes the online editor of PHS. You are first asked for a filename of a
  702. file which you want to edit. If the filename does not exist, PHS asks you if you
  703. want to create the file. If you confirm, you can start editing. In the example
  704. the filename "ROLF.MSG" was given and because such a file did not exist, PHS was
  705. told to create the file. Pressing F1 pops up a series of help windows for the
  706. editor:
  707.  
  708. ───────────────────────────────────────────────────────────────────────────────
  709.    ╔═════════ File: "ROLF.MSG"  Line:005  Col:14  Free=7838  Insert   ═════════╗
  710.    ║Hallo Rolf,                                                                ║
  711.    ║                                                                           ║
  712.    ║i╒═══════════════════════ HELP - Use F2 to exit ═══════════════════════╕   ║
  713.    ║s│                                                                     │   ║
  714.    ║a│                                                                     │   ║
  715.    ║ │ ESC            Exit the editor. You get the option to save the      │   ║
  716.    ║ │                file to disk. If you don't, calling the editor       │   ║
  717.    ║ │                again will place you exactly where you left.         │   ║
  718.    ║ │ INSERT KEY     Toggles insert and overwrite modes                   │   ║
  719.    ╚═│ F8             Toggles whether carriage returns are symbolically    │═══╝
  720.      │                displayed in the edit window                         │
  721.      │ F9             Toggles editor display from 128 ASCII characters     │
  722.      │                to 256 IBM characters                                │
  723.      │ UP-ARROW       Moves cursor up a line                               │
  724.      │ DOWN-ARROW     Moves cursor down a line                             │
  725.      │ LEFT-ARROW     Moves cursor left a space                            │
  726.      │ RIGHT-ARROW    Moves cursor right a space                           │
  727.      │                                                            more...  │
  728.      ╘═════════════════════════════════════════════════════════════════════╛
  729.  
  730.  M1234 ║ VHF ║ UA:00 RTY:00 │ DISCONNECTED               │    ║ 23-OCT 12:34:56
  731.  
  732.  
  733.  
  734. ───────────────────────────────────────────────────────────────────────────────
  735.  
  736. After you finished editing you will save the file to disk. This file can then be
  737. sent by pressing the ALT/S key in any PK-232 mode. You cannot send an unsaved
  738. file. At any time you can edit the saved file again.
  739.  
  740. You will not save the file to disk (but keep the text it the editors buffer) if
  741. you temporarliy want to exit the editor and want to continue editing later. If
  742. the editor is called with a previously unsaved buffer, it pops up with
  743. the cursor positioned excatly where you left before.
  744.  
  745. When you edit, just realize that the Amtor and RTTY modes do not support the
  746. full ascii character set.
  747.  
  748. The editor buffer is limited to 8000 bytes which is sufficient for message
  749. editing.
  750.  
  751.  
  752.  
  753.                        Printing and Logging
  754.                        ────────────────────
  755.  
  756.  
  757. ALT/J toggles the printer on or off. In packet-mode, printing is possible for
  758. one channel at a time only in order to avoid a mixup of different channel
  759. outputs on the printer.
  760.  
  761. ───────────────────────────────────────────────────────────────────────────────
  762.  M1234 ║ VHF ║ UA:00 RTY:00 │ DISCONNECTED               │ P  ║ 23-OCT 12:34:56
  763. ───────────────────────────────────────────────────────────────────────────────
  764.  
  765. If printing is on, this is indicated by the print-flag "P" in column 60 of the
  766. statusline. If printing is on for one channel, and you shift to another channel
  767. and press ALT/J there, then the printing of the previous channel ends and the
  768. printing of the current channel begins. PHS cannot print because the printer is
  769. offline, or out of paper, then PHS will silently stop printing and remove the
  770. printing indicator.
  771.  
  772. Everything which appears on the receive window of a channel will go to the
  773. printer if printing is enabled for that channel.
  774.  
  775.  
  776. ALT/L toggles the logging to a file. Logging can be enabled individually for
  777. each channel which will go to different files. When you press ALT/L then a
  778. window pops up and asks you for the filename of the file which will receive the
  779. logged data. You cannot specify anything else but the filename, the extension is
  780. always "CAn" where 'n' is the channel number. The logfiles will be created in
  781. the current DOS directory.
  782.  
  783. You are offered a filename which is constructed from the current date and time
  784. but you are free to select another filename. The filename which is offered has
  785. the format "MDD_hhmm.CAn" where 'M' is the hexadecimal number of the month (i.e.
  786. 1 to 9 for january to september, and A, B and C for october, november and
  787. december). 'DD' is the day of the month, 'hh' is the hour and 'mm' is the
  788. minute. A logfile started October 23, at 12:34 for channel 3 would be given the
  789. filename "A23_1234.CA3". Furthermore, if a subdirectory "LOG" exists in the
  790. current directory, then the file is opened in the LOG subdirectory, otherwise
  791. in the current directory.
  792.  
  793. ───────────────────────────────────────────────────────────────────────────────
  794.  M1234 ║ VHF ║ UA:00 RTY:00 │ DISCONNECTED               │  L ║ 23-OCT 12:34:56
  795. ───────────────────────────────────────────────────────────────────────────────
  796.  
  797. If logging is on for a channel, this is indicated by the logging-flag "L" in
  798. column 61 of the statusline.
  799.  
  800. When logging is already switched on for the channel and you press ALT/L then you
  801. are asked if you want to stop logging.
  802.  
  803. Everything which appears on the receive window of a channel will go to the
  804. logfile if logging is enabled for that channel.
  805.  
  806. You can have both printing and logging enabled for a channel.
  807.  
  808.  
  809.  
  810. ALT/S permits to send any file containing Ascii text. You are asked for the
  811. filename of the file to be sent. This filename is preset to the filename you
  812. specified for editing (if you did edit before) but can be overwritten.
  813.  
  814. ───────────────────────────────────────────────────────────────────────────────
  815. KANALZUTEILUNG
  816. *** Bulletin-ID: 158902HB9PD ***
  817.      ╒═══════════════════════ ASCII FILE SEND ════════════════════════╕
  818. de HB│                                                                │
  819.      │ Filename: PRIGCHAN.TXT                                         │
  820. Als B│ Sending line 22 of 37 - ALT/A to abort                         │
  821. "USER│                                                                │
  822. ausre╘════════════════════════════════════════════════════════════════╛
  823. abgerufen.
  824. Interessant dabei duerfte neben dem Call der USER auch sein auf
  825. welcher Frequenz der jeweilige Benutzer die Box erreicht hat.
  826.  
  827. Die Kanalzuteilung ist wie folgt organisiert:
  828.  
  829. Total 18 Kanaele
  830. ****************
  831.  
  832. Kanal 1-4      Direktzugang auf 70cm Freqq. 430.675
  833.  
  834. Kanal 5-9
  835.                Store und Forward mit HB9AJ, HB9XC und DB0CZ
  836.  M1234 ║ VHF ║ UA:05 RTY:00 │ INFORMATION TRANSFER       │    ║ 23-OCT 12:34:56
  837.  
  838.  
  839.  
  840. ───────────────────────────────────────────────────────────────────────────────
  841.  
  842. Note that the line number which is sent refers to the line which is currently
  843. sent to the PK-232, not the line which is actually transmitted by the PK-232.
  844.  
  845. In the packet modes, the text scrolls behind the ASCII FILE SEND window when it
  846. is sent. In the other modes, the text scrolls in the transmit window, and in the
  847. receive window the echo will appear from the PK-232 when the text is
  848. transmitted.
  849.  
  850.  
  851.  
  852. CTRL/ESC pops up the direct command input window:
  853.  
  854. ───────────────────────────────────────────────────────────────────────────────
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861. ╒═════════════════════════════ TNC COMMAND ENTRY ══════════════════════════════╕
  862. │ CMD> MYSELCAL               ╒═══ RESPONSE ════╕                              │
  863. ╘═════════════════════════════│ MYSELCAL: HCVV  │══════════════════════════════╛
  864.                               ╘═════════════════╛
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  RECEIVE  ║ AMTOR LISTEN  │  Phasing      ║              │    ║ 23-OCT 12:34:56
  877.  
  878.  
  879.  
  880. ───────────────────────────────────────────────────────────────────────────────
  881.  
  882. You use the 'normal' command mnemonics of the dialog mode of the PK-232. PHS
  883. translates this into hostmode commands, and also translates the host-mode
  884. response back to the dialoge mode mnemonics.
  885.  
  886. In the CMD entry window you can inspect ALL parameters and modify most of them.
  887. Writing of some parameters is disabled however because a direct execution would
  888. interfere with the operation of PHS. In either case you will get a message like
  889. one of the following:
  890.  
  891. ───────────────────────────────────────────────────────────────────────────────
  892.  
  893. ╒═════════════════════════════ TNC COMMAND ENTRY ══════════════════════════════╕
  894. │ CMD> PA   ╒════════════════════ INFORMATION ════════════════════╕            │
  895. ╘═══════════│ PACKET: disabled - use ALT/M to switch device modes │════════════╛
  896.             ╘═════════════════════════════════════════════════════╛
  897.  
  898. ───────────────────────────────────────────────────────────────────────────────
  899.  
  900. ╒═════════════════════════════ TNC COMMAND ENTRY ══════════════════════════════╕
  901. │ CMD> MF╒═══════════════════════ INFORMATION ═══════════════════════╕         │
  902. ╘════════│ MFILTER: disabled - this parameter must remain unchanged  │═════════╛
  903.          ╘═══════════════════════════════════════════════════════════╛
  904.  
  905. ───────────────────────────────────────────────────────────────────────────────
  906.  
  907.  
  908. ALT/M in any mode pops up the device mode select screen:
  909.  
  910. ───────────────────────────────────────────────────────────────────────────────
  911.  
  912.  
  913.  
  914.  
  915.  
  916.                               ╒══ DEVICE MODE ══╕
  917.                               │                 │
  918.                               │  Packet (V)HF   │
  919.                               │  Packet (H)F    │
  920.                               │ Amtor (L)isten  │
  921.                               │ Amtor (S)tandby │
  922.                               │  (R)TTY Baudot  │
  923.                               │    (A)SCII      │
  924.                               │    (M)orse      │
  925.                               │    S(I)gnal     │
  926.                               │                 │
  927.                               ╘═════════════════╛
  928.  
  929.  
  930.  
  931.  
  932.  M1234 ║ HF  ║ UA:00 RTY:00 │ DISCONNECTED               │    ║ 23-OCT 12:34:56
  933.  
  934.  
  935.  
  936. ───────────────────────────────────────────────────────────────────────────────
  937.  
  938. To select the PK-232 mode, you can either press the marked character, or move
  939. the scroll bar up and down and then press ENTER. The bar is not visible in this
  940. printout.
  941.  
  942. The two different modes for packet just use different values for some PK-232
  943. parameters.
  944.  
  945. Packet VHF uses:  "VHF Y", "HBAUD 1200", "FRACK 3" and "MAXFRAME 4".
  946. Packet HF uses:   "VHF N", "HBAUD 300",  "FRACK 8" and "MAXFRAME 1".
  947.  
  948. The different packet modes are indicated in the statusline. You will see "VHF"
  949. in place of "HF" if the PK-232 is in packet-VHF.
  950.  
  951. The FAX and NAVTEX modes are not supported.
  952.  
  953. The remainder of the general keys will be discussed after the discussion of the
  954. individual modes.
  955.  
  956.  
  957.  
  958.                                 PACKET MODES
  959.                                 ────────────
  960.  
  961. There is one difference between the packet-modes and the other modes: in packet
  962. you are offered one monitor channel window and four connectable channel windows
  963. (for all other modes there is just one receive window). The channels numbers are
  964. from zero to four, but channel zero is marked with an "M" to remind you that
  965. this is the monitor channel. You use the left-arrow and right-arrow keys to
  966. switch the channels. When you switch to a new channel, the full (upper) receive
  967. window is completely replaced by the new channel window. The status line changes
  968. also, reflecting the status of currently selected window.
  969.  
  970. The channel indicator is on the leftmost side of the status line. The current
  971. channel is indicated by a reverse letter, that is, one of the letters of the
  972. M1234 string - which is normally (like the rest of the statusline) dark on cyan
  973. - is cyan on black. Also, if you selected one channel - this is called the
  974. active channel and the active (receive) window - and ANOTHER channel gets input,
  975. then the indicator of that channel changes to white on cyan. Once you selected
  976. that window for inspection, the indicator returns to its normal color.
  977.  
  978. The monitored channel gets all monitored packets and you cannot connect on this
  979. channel. The statusline for the monitored channel is:
  980.  
  981. ───────────────────────────────────────────────────────────────────────────────
  982.  M1234 ║ VHF ║          ─── MONITOR CHANNEL ───          │    ║ 23-OCT 12:34:56
  983. ───────────────────────────────────────────────────────────────────────────────
  984.  
  985. However you can redirect the monitored input to one of the connectable channels
  986. if you want to see the monitoring there. Please refer to the MWINDOW command in
  987. the ALT/T window.
  988.  
  989. For the channels 1 to 4 the status line is like this:
  990.  
  991. ───────────────────────────────────────────────────────────────────────────────
  992.  M1234 ║ VHF ║ UA:03 RTY:00 │ INFORMATION TRANSFER       │    ║ 23-OCT 12:34:56
  993. ───────────────────────────────────────────────────────────────────────────────
  994.  
  995. The number after the "UA:" is the number of unacknowledged frames, RTY displays
  996. the number of retries so far. The next field is the link state.
  997.  
  998. Pressing the INS key toggles the status line to the other display format:
  999.  
  1000. ───────────────────────────────────────────────────────────────────────────────
  1001.  M1234 ║ VHF ║ HB9PD via HB9PD-7                         │    ║ 23-OCT 12:34:56
  1002. ───────────────────────────────────────────────────────────────────────────────
  1003.  
  1004. The UA/RTY and linkstate field is replaced by the connectee. If you use several 
  1005. digipeaters and the string is gets too long, the connectee string is truncated 
  1006. on the right hand side.
  1007.  
  1008.  
  1009.  
  1010.  
  1011. ALT/P in packet mode pops up the packet mode PK-232 parameter setup window:
  1012.  
  1013. ───────────────────────────────────────────────────────────────────────────────
  1014.           ╒═════════════════════ TNC Parameters ══════════════════════╕
  1015.           │                                                           │
  1016.           │ AUDELAY         0   MCON            6   RETRY          10 │
  1017.           │ AXDELAY         0   MDIGI           Y   SLOTTIME       10 │
  1018.           │ AXHANG          0   MID             0   SQUELCH         N │
  1019.           │ AX25L2V2        Y   MONITOR         6   TRIES           0 │
  1020.           │ BEACON        E 0   MRPT            Y   TXDELAY        40 │
  1021.           │ CHECK          25   MSTAMP          N   USERS           4 │
  1022.           │ CMSG            N   MYALIAS    BIENNE   XMITOK          Y │
  1023.           │ CONPERM         N   MYCALL   HB9CVV-1                     │
  1024.           │ DWAIT          16   PASSALL         N   <F1>  HELP        │
  1025.           │ FRACK           4   PERSIST        64   <ESC> EXIT        │
  1026.           │ FULLDUP         N   PPERSIST        Y   <F10> SET PARAM   │
  1027.           │ HID             N   RELINK          N                     │
  1028.           │ MAXFRAME        4   RESPTIME        5                     │
  1029.           │                                                           │
  1030.           ╘═══════════════════════════════════════════════════════════╛
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  M1234 ║ VHF ║ UA:00 RTY:00 │ DISCONNECTED               │    ║ 23-OCT 12:34:56
  1036.  
  1037.  
  1038.   Audio delay in 10mS (range 0-120)
  1039. ───────────────────────────────────────────────────────────────────────────────
  1040.  
  1041. PHS always reads the parameters from the PK-232, so you get the actual PK-232
  1042. parameters. You can now move the cursor to a command and change the parameter.
  1043. To apply the changes, press F10. PHS then writes the parameters to the PK-232
  1044. and re-reads them again. If a parameter which you have changed again gets the
  1045. old value, then you have violated a range check and the PK-232 refused to accept
  1046. your value. The process of reading, writing, and re-reading is indicated in the
  1047. window. It also takes a few seconds, even when the communiation line to the
  1048. PK-232 is operated at 9600 bauds.
  1049.  
  1050. You will see all parameter which are valid for the packet mode, and which you
  1051. may change. You may miss some packet mode commands here - but the parameters of
  1052. such commands must remain unchanged at preset values for a proper operation of
  1053. PHS.
  1054.  
  1055. There are some commands like MRPT and PASSALL which should be changed only if
  1056. neccessary, because there is still a possible interaction. For example, quite
  1057. obviously, if you surpress the indication of digipeaters in monitored frames
  1058. then the HEARD-List of PHS will not contain only incomplete information. Also,
  1059. if PASSALL is YES, you can get 'clobbered' callsigns in the heard-list.
  1060.  
  1061. For some commands (BEACON, MCON and MONITOR) you will get a secondary selection
  1062. window which offers you discrete choices.
  1063.  
  1064.  
  1065.  
  1066. A typical screen from the monitored channel is like this:
  1067.  
  1068. ───────────────────────────────────────────────────────────────────────────────
  1069. HB9X-7*>HB9X-9 [I;3,3]:
  1070. NON - Bid 21A90BHB9X deja recu
  1071. 8>
  1072. HB9X-6*>4U1ITU-8 (RR;3)
  1073. HB9X-6*>4U1ITU-8 [I;3,2]:
  1074. SB ALL    < OH1HS  @ EU $787_ON4HU
  1075. HB9X-7*>HB9X-9 (RR;4)
  1076. HB9X-6*>4U1ITU-8 (RR,F;3)
  1077. HB9X-7*>HB9CED [I;3,2]:
  1078. MOL:HB9X-7} Invalid command (CONNECT CQ IDENT NODES PARMS ROUTES USERS)
  1079. HB9X-7*>HB9DIG>HB9DIG-7 [RR,P;6]
  1080. HB9X-6*>4U1ITU-8 (RR,F;3)
  1081. HB9DIG-7>HB9DIG*>HB9X-7 [I;1,6]CF:
  1082. ■NET/ROM frame: orgin node DB0FRG-2 to dst node HB9X-7, ttl: 24
  1083. INFO ACK: ckt 0/238, rxseq 2
  1084. HB9X-7*>HB9X-9 [I;4,4]:
  1085. NON - Bid 21A90BHB9X deja recu
  1086. 8>
  1087. HB9X-7*>HB9CED [RR,P;3]
  1088. HB9X-7*>HB9CED (RR,F;3)
  1089. HB9X-6*>4U1ITU-8 (RR;4)
  1090.  M1234 ║ VHF ║          ─── MONITOR CHANNEL ───          │    ║ 23-OCT 12:34:56
  1091.  
  1092.  
  1093.  
  1094. ───────────────────────────────────────────────────────────────────────────────
  1095.  
  1096. If something is scrolled off-screen, press ALT/R or Up-arrow to review it again.
  1097. Reviewing is possible individually for all channels on packet (and for the
  1098. single channel of the other modes). The lower (transmit) window will be
  1099. superseded by:
  1100.  
  1101. ────────────────────────────────── .... ───────────────────────────────────────
  1102.        REVIEWING - all channels with input to this window are halted
  1103.                          Use: ^ v PgUp PgDn, ESC to exit
  1104.           ALT/J - Snapshot to printer    ALT/L - Snapshot to file
  1105. ───────────────────────────────────────────────────────────────────────────────
  1106.  
  1107. Use the indicated keys for moving, and ESC to leave the reviewing. The number of
  1108. lines which you have for reviewing depends on parameters in the configuration
  1109. file. The minimum is 50, the maximum is 200. These values can be set
  1110. individually for each channel.
  1111.  
  1112. Use ALT/J to print the window. Note that all lines (i.e. up to the number of
  1113. lines of the channels virtual window) are printed, not just the currently
  1114. visible part. ALT/L lets you snapshot the virtual window to a file in the
  1115. current DOS directory. The filename is generated from the date and time and the
  1116. extension is always "SNP". For the 23 October at 12:34:56 the generated filename
  1117. will be "A23_1234.SNP" (see "Logging and Printing" for a discussion of the
  1118. generated filenames). Furthermore, if a subdirectory "LOG" exists in the
  1119. current directory, then the file is opened in the LOG subdirectory, otherwise
  1120. in the current directory.
  1121.  
  1122.  
  1123.  
  1124. You press ALT/H to get the heard list formatted and sorted last heard first:
  1125.  
  1126. ───────────────────────────────────────────────────────────────────────────────
  1127. BBS H╒═══════ HEARD LIST (entries: 10) - XXXX - <Enter> to connect ════════╕
  1128.      │  1. 23-OCT 12:34:56  HB9X-7                                         │
  1129. Enreg│  2. 23-OCT 12:34:56  HB9CED-15                                      │
  1130. Enreg│  3. 23-OCT 12:34:56  HB9DIG-7 via HB9DIG                            │
  1131.      │  4. 23-OCT 12:34:56  HB9AC-8 via HB9DIG HB9AC                       │
  1132. Pas d│  5. 23-OCT 12:34:56  DG7KAR-8 via HB9DIG DB0DQ DB0GE-2              │
  1133. HB9CE│  6. 23-OCT 12:34:56  HB9X-6                                         │
  1134. DG7KA│  7. 23-OCT 12:34:56  HB9X-9                                         │
  1135. HB9AC│  8. 23-OCT 12:34:56  DG7KAR-7                                       │
  1136. HB9CE│  9. 23-OCT 12:34:56  HB9X-14                                        │
  1137. HB9X-│ 10. 23-OCT 12:34:56  DB1EC-15                                       │
  1138. HB9X-╘═════════════════════════════════════════════════════════════════════╛
  1139. HB9DIG-7>HB9DIG*>HB9X-7 (RR,F;1)
  1140. HB9X-7*>HB9CED [I;1,2]:
  1141. tion pour l'instant.
  1142.  
  1143. (H)elp (C)heck (L)ist (R)ead (S)end (E)rase (D)ir (U)sage (SP)eak (Q)uit
  1144. HB9CED de HB9X>
  1145. HB9CED-15*>HB9X [I;2,0]:
  1146. C HB9N-7
  1147. HB9X-7*>HB9CED (RR;2)
  1148.  M1234 ║ VHF ║          ─── MONITOR CHANNEL ───          │    ║ 23-OCT 12:34:56
  1149.  
  1150.  
  1151.  
  1152. ───────────────────────────────────────────────────────────────────────────────
  1153.  
  1154. If you select the raw heard list, you get the original frames unformatted but
  1155. still sorted by time:
  1156.  
  1157. ───────────────────────────────────────────────────────────────────────────────
  1158. Enreg╒═══════ HEARD LIST (entries: 10) - XXXX - <Enter> to connect ════════╕
  1159. Enreg│  1. 23-OCT 12:34:56  HB9CED-15*>HB9X (RR;3)                         │
  1160.      │  2. 23-OCT 12:34:56  HB9X-7*>HB9CED (RR,F;2)                        │
  1161. Pas d│  3. 23-OCT 12:34:56  HB9DIG-7>HB9DIG*>HB9X-7 (RR,F;1)               │
  1162. HB9CE│  4. 23-OCT 12:34:56  HB9AC-8>HB9AC>HB9DIG*>HB9X-9 [C,P]             │
  1163. DG7KA│  5. 23-OCT 12:34:56  DG7KAR-8>DB0GE-2>DB0DQ>HB9DIG*>HB9X-7 (RR,F;4) │
  1164. HB9AC│  6. 23-OCT 12:34:56  HB9X-6*>4U1ITU-8 (DM,F)                        │
  1165. HB9CE│  7. 23-OCT 12:34:56  HB9X-9*>HB9X-7 (DM,F)                          │
  1166. HB9X-│  8. 23-OCT 12:34:56  DG7KAR-7*>4U1ITU-8 (RR;4)                      │
  1167. HB9X-│  9. 23-OCT 12:34:56  HB9X-14*>HB9DIG>HB9AC>HB9AC-8 [I;2,1]:         │
  1168. HB9DI│ 10. 23-OCT 12:34:56  DB1EC-15*>4U1ITU-8 [D,P]                       │
  1169. HB9X-╘═════════════════════════════════════════════════════════════════════╛
  1170. tion pour l'instant.
  1171. ────────────────────────────────── .... ───────────────────────────────────────
  1172.  
  1173. The heard list will contain a maximum of 50 different stations. If more than 50
  1174. stations have been heard, the oldest call is superseded. You use the arrow keys
  1175. to scroll within the heard list. A scroll bar, which again is not visible here
  1176. is moving - you can position the bar on an entry on the heard list and simply
  1177. press the ENTER key to try a connect. You must first select an unconnected
  1178. channel, pop up the heard-list by ALT/H, select the entry and press ENTER.
  1179.  
  1180. The arrows are visible in place of the "XXXX" which you see here in the heard
  1181. list title.  These little arrows cannot be used in this printout and had to be
  1182. substituted.
  1183.  
  1184.  
  1185. ALT/C pops up the Connect window, this has the same look-and-feel like the
  1186. UNPROTO window which we discussed before. To summarize, if you want to
  1187. initialize a connection, you have three choices:
  1188.  
  1189.      - the Connect-window by ALT/C
  1190.      - by a selection of the heard-list
  1191.      - by an entry in the command directory (ALT/W), provided you have
  1192.        preset connect commands there.
  1193.  
  1194. ALT/D is used to initialize a disconnect.
  1195.  
  1196. If someone is connecting you, PHS will give a sound (warble). For incoming
  1197. connects the PK-232 selects the lowest unconnected channel, which might not
  1198. necessarily be the channel which you have currently selected for display.  You
  1199. will still realize such a connect because of the warble, and because the
  1200. channels indicator is highlighted.
  1201.  
  1202. Any text which you type will appear in the lower transmit window. If
  1203. word-wrapping is on (which is the default, see ALT/T), your text will wrap. The
  1204. input text is sent to the PK-232 when you press the ENTER key. It is then
  1205. removed from the transmit window and inserted into the receive window.
  1206. Additionally the text is highlighted in the receive window, so you can easily
  1207. distinguish between your text and the received text.
  1208.  
  1209. Note that the transmit buffer of PHS is 250 characters. You will get the warning
  1210. "At end of TX-buffer" if you reached the end of the buffer. You will get the
  1211. warning "At beginning of TX-buffer" when you erase characters and no more
  1212. characters are available for deletion.
  1213.  
  1214.  
  1215.                         BINARY FILE TRANSFERS
  1216.                         ─────────────────────
  1217.  
  1218. The next and last chapters for the Packet-modes show how binary transfers are
  1219. done. PHS implements the YAPP protocol as defined by Jeff Jacobson, WA7MBL.
  1220. Care should be exercised when employing binary transfers because upon entry of
  1221. the yapp transfer mode, PHS will change the PK-232 parameters to obtain maximum
  1222. throughput. These parameters are reset to the previous values when you leave the
  1223. yapp transfer mode. To keep friends, yapp-transfers should not be done on qso
  1224. channels - use a free channel. You also CANNOT change channels during a binary
  1225. transfer, you will have to finish or abort the transfer first.  Consequently you
  1226. can invoke a binary transfer on ONE channel only. Again, this is optimized for
  1227. throughput and is intended to provide fast transfers.
  1228.  
  1229. Yapp uploading (sending of a binary file) is invoked with the PgUp key,
  1230. downloading (receiving) with the PgDn key. PHS will ask you for a filename
  1231. first, and then enter the yapp transfer mode. Note that when you are receiving,
  1232. you will also have to specify the filename of a file which will get the data.
  1233.  
  1234.  
  1235.  
  1236.  
  1237. When sending a binary transfer, you get a window like this:
  1238.  
  1239. ───────────────────────────────────────────────────────────────────────────────
  1240.                     ╒═════ Uploading (YAPP) - ALT/A: Cancel - ALT/K: Kill ═════╕
  1241. 23-Oct-89  12:29:32 │                                                          │
  1242.                     │    FILE: PHS.EXE                                         │
  1243.                     │    Size:  198583                                         │
  1244.                     │    Date: 23-OCT-89 20:41                                 │
  1245.                     │                                                          │
  1246.                     │  Header:  PHS.EXE  198583 bytes, 23-OCT-89 20:41         │
  1247.                     │   Bytes:    11938 read,   10414 sent                     │
  1248.                     │    Rate:       95 bytes/sec, time to go:  33:00          │
  1249.                     │                                                          │
  1250.                     │   STATE:  Sending DATA                                   │
  1251.                     │                                                          │
  1252.                     │   TNC buffer full, waiting.                              │
  1253.                     │                                                          │
  1254.                     ╘══════════════════════════════════════════════════════════╛
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  M1234 ║ VHF ║ UA:06 RTY:00 │ INFORMATION TRANSFER       │    ║ 23-OCT 12:34:56
  1262.  
  1263.  
  1264.  
  1265. ───────────────────────────────────────────────────────────────────────────────
  1266.  
  1267. The bytes read indicate the number of bytes read from the file, the bytes sent
  1268. is the number of acknowledged bytes. The message "TNC buffer full, waiting."
  1269. indicates that the PK-232s buffer are full and that PHS is waiting for the
  1270. PK-232 to become ready for another slice of data.
  1271.  
  1272. Unfortunately the PK-232 does not buffer more than MAXF frames, which reduces
  1273. the maximum obtainable troughput to below 100 bytes per second. With other
  1274. devices like TNC-2 or the PC*Packet Adapter it is possible to reach up to 125
  1275. bytes per second. Yes, the link is 1200 bauds, but AX-25 is a syncronous
  1276. protocol, so a single data byte is not framed with start and stop bits as on
  1277. asynchronous RS-232 links. The theoretical maximum is 1200/8 bytes per second,
  1278. and the AX-25 protocol overhead reduces this number then by at least 15%.
  1279.  
  1280. If you want to abort a transfer, you can use ALT/A to cancel it, which uses the
  1281. cancel mechanism of the yapp protocol. If you got a bad link however you will
  1282. have a TNC full with untransmitted frames and the frame with the cancel request
  1283. queued behind. Unfortunately the only way to flush the untransmitted data in the
  1284. PK-232 is a disconnect.
  1285.  
  1286. This is why ALT/K has been introduced: ALT/K will kill the transfer by
  1287. disconnecting the link and then will re-connect. All of this is accompanied by
  1288. messages on the screen.
  1289.  
  1290. The YAPP-download window is similar to the upload window. Note however that the
  1291. number for the troughput (bytes/sec) will always differ slightly between
  1292. receiver and sender - there are always some data packets on the air.
  1293.  
  1294.  
  1295.  
  1296.  
  1297.                                 AMTOR MODES
  1298.                                 ───────────
  1299.  
  1300. ESC in the amtor modes pops up the amtor-modes help screen:
  1301.  
  1302. ───────────────────────────────────────────────────────────────────────────────
  1303.   ╒═══════════════════════════════ AMTOR MODES ═══════════════════════════════╕
  1304.   │                                     ║                                     │
  1305.   │ ALT/P   TNC mode param setup menu   ║ ALT/I   TNC text-param setup menu   │
  1306.   │ ALT/T   PHS parameter setup menu    ║ ALT/V   View DOS directory          │
  1307.   │ ALT/W   Command string directory    ║ ALT/J   Toggle printer on/off       │
  1308.   │ ALT/F   View function-key setup     ║ ALT/L   Logging (capture) on/off    │
  1309.   │ ALT/R   or î Review (scrollback)    ║ ALT/S   Send an ASCII file          │
  1310.   │ ALT/K   Call Editor                 ║ ALT/E   Temporary exit to DOS       │
  1311.   │ ALT/B   Enter urcall (remote call)  ║ CTRL/U  Erase TX-window             │
  1312.   │ ALT/X   Exit PHS                    ║ CTRL/X  Erase RX-window             │
  1313.   │ ALT/M   Switch TNC modes            ║ CTRL/ESC  Direct command entry      │
  1314.   │ ─────────────────────────────────── ║ ─────────────────────────────────── │
  1315.   │ ALT/C   Start ARQ call              ║ GRAY +  Start FEC transmit          │
  1316.   │ ALT/Y   Start SELFEC call           ║ GRAY -  FEC: Receive - immediate    │
  1317.   │ INS     Amtor-Listen: Resynchronize ║ GRAY -  ARQ: Break Link - immediate │
  1318.   │ INS     ARQ: Force changeover       ║ GRAY *  Clear TNC transmit buffer   │
  1319.   │ DEL     Force LETTERS case          ║ <- ->   Toggle LISTEN <--> STANDBY  │
  1320.   │ ───────────── in text ───────────── ║ ───────────── in text ───────────── │
  1321.   │ CTRL/D  FEC: Switch to receive      ║ CTRL/O  Send LETTERS character      │
  1322.   │         ARQ: Break link             ║ CTRL/N  Send FIGURES character      │
  1323.   │ CTRL/F  Like CTRL/D, add CW-id      ║ CTRL/B  Send "urcall de mycall"     │
  1324.  R│ CTRL/T  Send date+time              ║ END     Send "+?"                   │
  1325.   │                                     ║                                     │
  1326.   ╘═══════════════════════════════════════════════════════════════════════════╛
  1327.  
  1328. ───────────────────────────────────────────────────────────────────────────────
  1329.  
  1330. The single 'R' visible on the left side is from the covered status line. If you
  1331. had setup another screen size before calling PHS (e.g. 80*43), then the
  1332. statusline would not be covered by the window and would be visble.
  1333.  
  1334. The status line in the Amtor modes is like:
  1335.  
  1336. ───────────────────────────────────────────────────────────────────────────────
  1337.  RECEIVE  ║ AMTOR LISTEN  │  Phasing      ║              │    ║ 23-OCT 12:34:56
  1338. ───────────────────────────────────────────────────────────────────────────────
  1339.  
  1340. where the first field will indicate either "RECEIVE" or "TRANSMIT", and the
  1341. second field will show "AMTOR LISTEN", "AMTOR STANDBY" "AMTOR QSO", "FEC" or
  1342. "SELFEC". The third field indicates the current PK-232 status and closely
  1343. follows the LED indicators of the PK-232. The forth field is always empty. The
  1344. fifth field will contain the "P" and "L" indicators, when printing or logging is
  1345. on.
  1346.  
  1347. Opposed to the packet mode, where your text is sent to the PK-232 when you press
  1348. the ENTER key, in non-packet modes your text is sent to the PK-232 on a
  1349. word-by-word basis, and is buffered in the PK-232. The text is not cleared in
  1350. the lower transmit window but instead it will scroll there. It is echoed in the
  1351. upper receive window by the PK-232 whenever it is sent out (echo-as-sent). The
  1352. wordwise operation allows you to correct only the current word. It is not
  1353. possible to correct text which has already been sent to the PK-232. For an
  1354. indication about what has already been sent to the PK-232, the already-sent text
  1355. is highlighted. So if you typed in:
  1356.  
  1357.         Did you have to apply any modificatio
  1358.  
  1359. and the cursor is positioned after the 'o', then all previous lines, and this
  1360. line up to and including the word 'any' is highlighted, but 'modificatio' is
  1361. not, because it has not yet been sent.
  1362.  
  1363. You start a FEC transmission with the GRAY PLUS key (on the keypad). Normally
  1364. you will not stop the transmission with the GRAY MINUS key because the PK-232
  1365. will then immediately switch to receive, regardless of still untransmitted text.
  1366. If you switch to receive with untransmitted text, you will get a warning message
  1367. from PHS ("transmit data remaining"). This data will be sent the next time when
  1368. you switch to transmit. However you have the option to flush the data by
  1369. clearing the PK-232's transmit buffer with the GRAY-* key.
  1370.  
  1371. Anytime you can insert a CTRL/D or CTRL/F into the text which you input. The
  1372. PK-232 will switch to receive whenever it detects such a character (refer to the
  1373. PK-232 manual) in the transmit data stream. Just a note: when you insert a
  1374. CTRL/D followed by a carriage return (Enter-key), then you will get the
  1375. transmit-data-remaining warning, because after switching to receive by the
  1376. CTRL/D, the carriage return is still untransmitted.
  1377.  
  1378. To start a Amtor QSO, press ALT/C and you will get a small window which lets you
  1379. enter the other stations selcal. For a SELFEC transmission, press ALT/Y.
  1380.  
  1381. You may use ALT/B to pop up a window which lets you enter the remote stations
  1382. callsign, and once you did, whenever you insert a CTRL/B into the transmit text,
  1383. it is replaced by PHS with the string " <remote-callsign> DE <my-callsign> ".
  1384. My-callsign is from line one in the configuration file (a possible packet-SSID
  1385. is removed).
  1386.  
  1387. For convenience, in ARQ, the END key inserts the Amtor-changeover signal "+?"
  1388. into the transmit text.
  1389.  
  1390. If you are in Amtor-Listen mode and you have difficulties to monitor an
  1391. Amtor-qso use the INS key to force a resynchronisation. If you are in an ARQ
  1392. qso, the INS key forces a changeover.
  1393.  
  1394.  
  1395. ALT/P in the amtor modes pops up the amtor-modes PK-232 parameter setup window:
  1396.  
  1397. ───────────────────────────────────────────────────────────────────────────────
  1398.  
  1399.                                                   ╒═ TNC Parameters ══╕
  1400.                                                   │                   │
  1401.                                                   │ ACRRTTY        72 │
  1402.                                                   │ ADELAY          4 │
  1403.                                                   │ ARQTIMO        90 │
  1404.                                                   │ MYALTCAL     HCVV │
  1405.                                                   │ MYSELCAL     HCVV │
  1406.                                                   │ RFEC            Y │
  1407.                                                   │ RXREV           N │
  1408.                                                   │ SRXALL          Y │
  1409.                                                   │ TXREV           N │
  1410.                                                   │ WIDESHFT        N │
  1411.                                                   │ WRU             N │
  1412.                                                   │                   │
  1413.                                                   │ <F1>  HELP        │
  1414.                                                   │ <ESC> EXIT        │
  1415.                                                   │ <F10> SET PARAM   │
  1416.                                                   │                   │
  1417.                                                   ╘═══════════════════╛
  1418.  
  1419.  
  1420.  RECEIVE  ║ AMTOR LISTEN  │  Phasing      ║              │    ║ 23-OCT 12:34:56
  1421.  
  1422.  
  1423.   Auto CR column in RTTY (range 0-255, 0 disables)
  1424. ───────────────────────────────────────────────────────────────────────────────
  1425.  
  1426.  
  1427.                                 RTTY MODE
  1428.                                 ─────────
  1429.  
  1430. ESC in rtty mode pops up the rtty-mode help screen:
  1431. ───────────────────────────────────────────────────────────────────────────────
  1432.   ╒════════════════════════════════ RTTY MODE ════════════════════════════════╕
  1433.   │                                     ║                                     │
  1434.   │ ALT/P   TNC mode param setup menu   ║ ALT/I   TNC text-param setup menu   │
  1435.   │ ALT/T   PHS parameter setup menu    ║ ALT/V   View DOS directory          │
  1436.   │ ALT/W   Command string directory    ║ ALT/J   Toggle printer on/off       │
  1437.   │ ALT/F   View function-key setup     ║ ALT/L   Logging (capture) on/off    │
  1438.   │ ALT/R   or î Review (scrollback)    ║ ALT/S   Send an ASCII file          │
  1439.   │ ALT/K   Call Editor                 ║ ALT/E   Temporary exit to DOS       │
  1440.   │ ALT/B   Enter urcall (remote call)  ║ CTRL/U  Erase TX-window             │
  1441.   │ ALT/X   Exit PHS                    ║ CTRL/X  Erase RX-window             │
  1442.   │ ALT/M   Switch TNC modes            ║ CTRL/ESC  Direct command entry      │
  1443.   │ ─────────────────────────────────── ║ ─────────────────────────────────── │
  1444.   │ GRAY +  Transmit                    ║ GRAY *  Clear TNC transmit buffer   │
  1445.   │ GRAY -  Receive - immediate         ║ DEL     Force LETTERS case          │
  1446.   │ ───────────── in text ───────────── ║ ───────────── in text ───────────── │
  1447.   │ CTRL/D  Switch to receive           ║ CTRL/O  Send LETTERS character      │
  1448.   │ CTRL/F  Like CTRL/D, add CW-id      ║ CTRL/N  Send FIGURES character      │
  1449.   │ CTRL/B  Send " urcall de mycall "   ║ CTRL/T  Send date+time              │
  1450.   │                                     ║                                     │
  1451.   ╘═══════════════════════════════════════════════════════════════════════════╛
  1452.  
  1453.  RECEIVE  ║ RTTY          ║                              │    ║ 23-OCT 12:34:56
  1454.  
  1455.  
  1456.  
  1457. ───────────────────────────────────────────────────────────────────────────────
  1458. ALT/P in rtty mode pops up the rtty mode PK-232 parameter setup window:
  1459. ───────────────────────────────────────────────────────────────────────────────
  1460.  
  1461.                                                   ╒═ TNC Parameters ══╕
  1462.                                                   │                   │
  1463.                                                   │ ACRRTTY        72 │
  1464.                                                   │ CCITT           N │
  1465.                                                   │ CODE            0 │
  1466.                                                   │ CRADD           N │
  1467.                                                   │ DIDDLE          Y │
  1468.                                                   │ RBAUD          45 │
  1469.                                                   │ RXREV           N │
  1470.                                                   │ TXREV           N │
  1471.                                                   │ USOS            Y │
  1472.                                                   │ WIDESHFT        N │
  1473.                                                   │ WRU             N │
  1474.                                                   │                   │
  1475.                                                   │ <F1>  HELP        │
  1476.                                                   │ <ESC> EXIT        │
  1477.                                                   │ <F10> SET PARAM   │
  1478.                                                   │                   │
  1479.                                                   ╘═══════════════════╛
  1480. ────────────────────────────────── .... ───────────────────────────────────────
  1481.  
  1482.  
  1483.                                 ASCII MODE
  1484.                                 ──────────
  1485.  
  1486. ESC in the ascii mode pops up the ascii-mode help screen:
  1487. ───────────────────────────────────────────────────────────────────────────────
  1488.   ╒═══════════════════════════════ ASCII MODE ════════════════════════════════╕
  1489.   │                                     ║                                     │
  1490.   │ ALT/P   TNC mode param setup menu   ║ ALT/I   TNC text-param setup menu   │
  1491.   │ ALT/T   PHS parameter setup menu    ║ ALT/V   View DOS directory          │
  1492.   │ ALT/W   Command string directory    ║ ALT/J   Toggle printer on/off       │
  1493.   │ ALT/F   View function-key setup     ║ ALT/L   Logging (capture) on/off    │
  1494.   │ ALT/R   or î Review (scrollback)    ║ ALT/S   Send an ASCII file          │
  1495.   │ ALT/K   Call Editor                 ║ ALT/E   Temporary exit to DOS       │
  1496.   │ ALT/B   Enter urcall (remote call)  ║ CTRL/U  Erase TX-window             │
  1497.   │ ALT/X   Exit PHS                    ║ CTRL/X  Erase RX-window             │
  1498.   │ ALT/M   Switch TNC modes            ║ CTRL/ESC  Direct command entry      │
  1499.   │ ─────────────────────────────────── ║ ─────────────────────────────────── │
  1500.   │ GRAY +  Transmit                    ║ GRAY *  Clear TNC transmit buffer   │
  1501.   │ GRAY -  Receive - immediate         ║                                     │
  1502.   │ ───────────── in text ───────────── ║ ───────────── in text ───────────── │
  1503.   │ CTRL/D  Switch to receive           ║ CTRL/F  Like CTRL/D, add CW-id      │
  1504.   │ CTRL/B  Send "urcall de mycall"     ║ CTRL/T  Send date+time              │
  1505.   │                                     ║                                     │
  1506.   ╘═══════════════════════════════════════════════════════════════════════════╛
  1507.  
  1508.  
  1509.  RECEIVE  ║ ASCII         ║                              │    ║ 23-OCT 12:34:56
  1510.  
  1511.  
  1512.  
  1513. ───────────────────────────────────────────────────────────────────────────────
  1514. ALT/P in ascii mode pops up the ascii mode PK-232 parameter setup window:
  1515. ───────────────────────────────────────────────────────────────────────────────
  1516.  
  1517.                                                   ╒═ TNC Parameters ══╕
  1518.                                                   │                   │
  1519.                                                   │ ABAUD         300 │
  1520.                                                   │ ACRRTTY        72 │
  1521.                                                   │ DIDDLE          Y │
  1522.                                                   │ RXREV           N │
  1523.                                                   │ TXREV           N │
  1524.                                                   │ WIDESHFT        N │
  1525.                                                   │ WRU             N │
  1526.                                                   │                   │
  1527.                                                   │ <F1>  HELP        │
  1528.                                                   │ <ESC> EXIT        │
  1529.                                                   │ <F10> SET PARAM   │
  1530.                                                   │                   │
  1531.                                                   ╘═══════════════════╛
  1532. ────────────────────────────────── .... ───────────────────────────────────────
  1533.  
  1534.  
  1535.                                 MORSE MODE
  1536.                                 ──────────
  1537.  
  1538. ESC in the morse mode pops up the morse-mode help screen:
  1539. ───────────────────────────────────────────────────────────────────────────────
  1540.   ╒═══════════════════════════════ MORSE MODE ════════════════════════════════╕
  1541.   │                                     ║                                     │
  1542.   │ ALT/P   TNC mode param setup menu   ║ ALT/I   TNC text-param setup menu   │
  1543.   │ ALT/T   PHS parameter setup menu    ║ ALT/V   View DOS directory          │
  1544.   │ ALT/W   Command string directory    ║ ALT/J   Toggle printer on/off       │
  1545.   │ ALT/F   View function-key setup     ║ ALT/L   Logging (capture) on/off    │
  1546.   │ ALT/R   or î Review (scrollback)    ║ ALT/S   Send an ASCII file          │
  1547.   │ ALT/K   Call Editor                 ║ ALT/E   Temporary exit to DOS       │
  1548.   │ ALT/B   Enter urcall (remote call)  ║ CTRL/U  Erase TX-window             │
  1549.   │ ALT/X   Exit PHS                    ║ CTRL/X  Erase RX-window             │
  1550.   │ ALT/M   Switch TNC modes            ║ CTRL/ESC  Direct command entry      │
  1551.   │ ─────────────────────────────────── ║ ─────────────────────────────────── │
  1552.   │ GRAY +  Transmit                    ║ INS     Unlock receive speed (WPM)  │
  1553.   │ GRAY -  Receive - immediate         ║ DEL     Lock receive speed (WPM)    │
  1554.   │ GRAY *  Clear TNC transmit buffer   ║                                     │
  1555.   │ ───────────── in text ───────────── ║ ───────────── in text ───────────── │
  1556.   │ CTRL/D  Switch to receive           ║ CTRL/B  Send "urcall de mycall"     │
  1557.   │ CTRL/T  Send date+time              ║                                     │
  1558.   │                                     ║                                     │
  1559.   ╘═══════════════════════════════════════════════════════════════════════════╛
  1560.  
  1561.  RECEIVE  ║ MORSE         │ 20 WPM ║                     │    ║ 23-OCT 12:34:56
  1562.  
  1563.  
  1564.  
  1565. ───────────────────────────────────────────────────────────────────────────────
  1566. ALT/P in morse mode pops up the morse mode PK-232 parameter setup window:
  1567. ───────────────────────────────────────────────────────────────────────────────
  1568.  
  1569.                                                   ╒═ TNC Parameters ══╕
  1570.                                                   │                   │
  1571.                                                   │ MSPEED         20 │
  1572.                                                   │ MWEIGHT        10 │
  1573.                                                   │                   │
  1574.                                                   │ <F1>  HELP        │
  1575.                                                   │ <ESC> EXIT        │
  1576.                                                   │ <F10> SET PARAM   │
  1577.                                                   │                   │
  1578.                                                   ╘═══════════════════╛
  1579. ────────────────────────────────── .... ───────────────────────────────────────
  1580.  
  1581.  
  1582.  
  1583.                                 SIGNAL MODE
  1584.                                 ───────────
  1585.  
  1586. ESC in the signal mode pops up the signal-mode help screen:
  1587. ───────────────────────────────────────────────────────────────────────────────
  1588.  
  1589.   ╒═══════════════════════════════ SIGNAL MODE ═══════════════════════════════╕
  1590.   │                                     ║                                     │
  1591.   │ ALT/P   TNC mode param setup menu   ║ ALT/I   TNC text-param setup menu   │
  1592.   │ ALT/T   PHS parameter setup menu    ║ ALT/V   View DOS directory          │
  1593.   │ ALT/W   Command string directory    ║ ALT/J   Toggle printer on/off       │
  1594.   │ ALT/F   View function-key setup     ║ ALT/L   Logging (capture) on/off    │
  1595.   │ ALT/R   or î Review (scrollback)    ║ ALT/S   Send an ASCII file          │
  1596.   │ ALT/K   Call Editor                 ║ ALT/E   Temporary exit to DOS       │
  1597.   │ ALT/B   Enter urcall (remote call)  ║ CTRL/U  Erase TX-window             │
  1598.   │ ALT/X   Exit PHS                    ║ CTRL/X  Erase RX-window             │
  1599.   │ ALT/M   Switch TNC modes            ║ CTRL/ESC  Direct command entry      │
  1600.   │ ─────────────────────────────────── ║ ─────────────────────────────────── │
  1601.   │ INS     Ok - accept & switch        ║                                     │
  1602.   │ ─────────────── NOTE ────────────── ║                                     │
  1603.   │    DO NOT SWITCH TO FAX or NAVTEX   ║                                     │
  1604.   │                                     ║                                     │
  1605.   ╘═══════════════════════════════════════════════════════════════════════════╛
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  RECEIVE  ║ SIGNAL                                       │    ║ 23-OCT 12:34:56
  1611.  
  1612.  
  1613.  
  1614. ───────────────────────────────────────────────────────────────────────────────
  1615.  
  1616.  
  1617. Please do not switch to an unsupported mode (FAX or NAVTEX), it will not work.
  1618.  
  1619. There is no signal mode PK-232 parameter setup window.
  1620.  
  1621.  
  1622.  
  1623.  
  1624. Finally, the secret ALT-key:
  1625.  
  1626. Whenever you give ALT/A, any incoming message to the currently selected window
  1627. is accompanied by a deep summing tone. Another ALT/A disables the sound. There
  1628. is no visible indication of ALT/A, because obviously there is an audible one.  I
  1629. often use ALT/A when my partner says "wait a minute", because I have no klicking
  1630. relais in my TRX which would attract my attention after that minute. Obviously,
  1631. ALT/A should be avoided in non-packet modes...
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.                         THE CONFIGURATION FILE
  1638.                         ══════════════════════
  1639.  
  1640. PHS reads the configuration file whenever you start PHS.  The configuration file
  1641. contains information about hardware and software parameters. If this information
  1642. is not accurate, PHS will be unable to proceed.
  1643.  
  1644. NOTE:  PHS does not do much consistency checks or range checks when reading from
  1645. the CFG-file. You must not omit lines, or use parameters with values other than
  1646. specified in this chapter.
  1647.  
  1648. You must edit the file PHS.CFG to reflect your hardware configuration, callsigns
  1649. and texts. If you are not able to edit a text-file you cannot operate PHS.
  1650.  
  1651. Here is an example of a configuration file:
  1652.  
  1653. ───────────────────────────────────────────────────────────────────────────────
  1654. HB9CVV-1
  1655. HCVV  My Selcall
  1656. 0x3E0 Address of TNC COMPORT
  1657. 3     Interrupt of TNC COMPORT
  1658. 9600  Baudrate
  1659. 1     Printer number
  1660. 1     direct video i/o
  1661. Operator is OFFLINE, this message is recordedt - 73 de Peter
  1662. *** Peter, Qth: Port/Biel - JN37OC ***
  1663. 07,00,07,00,00,02,01,15,07,00  Receive (upper, permanent)
  1664. 07,00,07,00,00,02,01,15,07,00  Transmit (lower, permanent)
  1665. 04,07,07,04,03,00,07,00,04,15  Statusline (middle, permanent)
  1666. 01,11,01,11,01,11,01,02,07,04  Immediate command entry
  1667. 01,15,01,15,07,00,00,14,01,14  Opening, THS-Help, Review
  1668. 01,11,01,11,03,00,03,01,07,00  Parameter Dialogs
  1669. 01,11,01,11,01,15,01,11,07,00  Activity during YAPP xfer
  1670. 00,02,00,02,01,14,00,00,07,00  Parameter Dialog Help Line
  1671. 01,11,01,11,01,15,01,11,07,00  Parameter Dialog Extended Help (File)
  1672. 01,11,01,11,01,15,01,11,07,00  Other
  1673. 00,11,03,11,00,00,00,00
  1674. #Name & Qth
  1675. My name is Peter, the QTH is Port, 20 miles west of Berne City.
  1676. #Rig SHORT
  1677. The rig here is: a PC/AT, PK-232, Ten-Tec Paragon with 100W to a GP.
  1678. I am using my own PK-232 Hostmode Server (PHS) program.
  1679. #Rig LONG
  1680. The rig here is:
  1681. -----------------------------------------------------------
  1682. Programs  : THS (TNC Hostmode Server) 2.50
  1683.             PHS (PK-232 Hostmode Server) 3.00
  1684. Computers : PC/AT, 4MB RAM, 109MB disk.
  1685.             386AT, 5MB RAM, 150MB disk, 44MB removable disk
  1686.             Toshiba T-5100
  1687. TRX       : Ten-Tec Paragon, 100W
  1688.             IC-271H, 100W
  1689.             TW-4100E, 45W
  1690. Antenna   : Remotely tuned GP for HF
  1691.         2 * 11 element Yagi (2m)
  1692.             19 element Yagi (70cm)
  1693.             X-300 2m/70cm vertical
  1694. TNC       : TNC-1 with WA8DED V1.3
  1695.             TNC-2 with WA8DED V2.3
  1696.             DRSI PC*Packet Adapter
  1697.             PK-232
  1698. -----------------------------------------------------------
  1699. In use: PHS, PC/AT, PK-232, Paragon, GP.
  1700. #FEC CQ
  1701. CQ CQ CQ CQ CQ DE HB9CVV HB9CVV HB9CVV (HCVV)
  1702. CQ CQ CQ CQ CQ DE HB9CVV HB9CVV HB9CVV (HCVV)
  1703. CQ CQ CQ CQ CQ DE HB9CVV HB9CVV HB9CVV (HCVV)
  1704. CQ CQ CQ CQ CQ DE HB9CVV HB9CVV HB9CVV (HCVV)
  1705. SELCAL HCVV HCVV HCVV - PSE KKKKK
  1706. (
  1707. #RYRYRY
  1708. RYRYRYRYRYRYRYRYRYRYRYRYRYRYRYRYRYRYRYRYRYRYRY
  1709. $C DK1SL VIA HB9F
  1710. $C HB9SDD
  1711. $C HB9PD
  1712. $C HB9BRC
  1713. $C HB9PD VIA HB9PD-7
  1714. %MYALIAS BIENNE
  1715. %TXREV NO
  1716. %RXREV NO
  1717. %ABAUD 300
  1718. %ADELAY 4
  1719. }1,200,200,200,50,50,2,0,0,1,-1
  1720. ───────────────────────────────────────────────────────────────────────────────
  1721.  
  1722.  
  1723. The first line
  1724.  
  1725. contains your callsign and optionally the SSID. No comments are possible on this
  1726. line.
  1727.  
  1728. The second line
  1729.  
  1730. contains your Amtor selcal.
  1731.  
  1732. The third line
  1733.  
  1734. defines the address of your communications port. You must specify it in this
  1735. hexadecimal presentation (0xhhh).  PHS will detect and report the access of a
  1736. non-existent commport.  (Standard values are 0x3F8 for COM1 and 0x2F8 for COM2).
  1737. You can specify any address here, PHS has a built in communications driver and
  1738. is able operate communication ports at non-standard addresses.
  1739.  
  1740. The forth line
  1741.  
  1742. defines the interrupt number of your communications port. (Standard values are 4
  1743. for COM1 and 3 for COM2).
  1744.  
  1745. The fifth line
  1746.  
  1747. defines the baud-rate for the communications port. It must of course match the
  1748. baudrate you selected for the PK-232.
  1749.  
  1750. *** NOTE: If PHS is unable to contact the PK-232, then a wrong commport address
  1751. and/or interrupt, or a wrong baudrate could be the cause. The same is true if
  1752. you get permanent RS-232 error reports from PHS after startup.
  1753.  
  1754. The sixth line
  1755.  
  1756. defines the printer number (printer port). Legal values are 1 to 3, for LPT1,
  1757. LPT2 and LPT3.  Printer output to printers connected to serial lines is not
  1758. possible.
  1759.  
  1760. The seventh line
  1761.  
  1762. defines the video access. A '1' is used for direct video i/o, and should be used
  1763. for all video cards other than CGA.  If a value of 1 causes snow or other visual
  1764. effects, switch to a value of 2. This changes PHS to use retrace synchronisation
  1765. - which is requred for older CGA cards.
  1766.  
  1767. The eighth line
  1768.  
  1769. contains your connect message. The line may not exceed 72 characters, if it
  1770. does, then the line is truncated. This line is loaded into the PK-232 whenever
  1771. PHS is started. You can however alter your connect message any time online.
  1772.  
  1773. The ninth line
  1774.  
  1775. contains your beacon text. The line may not excced 72 characters, if it does,
  1776. then the line is truncated. You can alter the beacon text online.
  1777.  
  1778.  
  1779. The next TEN lines specify the color attributes of all windows. The scheme is:
  1780.  
  1781.  +------------------------------------ Border, background
  1782.  |  +--------------------------------- Border, foreground
  1783.  |  |
  1784.  |  |  +------------------------------ Title, background
  1785.  |  |  |  +--------------------------- Title, foreground
  1786.  |  |  |  |
  1787.  |  |  |  |  +------------------------ Text, background
  1788.  |  |  |  |  |  +--------------------- Text, foreground
  1789.  |  |  |  |  |  |
  1790.  |  |  |  |  |  |  +------------------ Inactive Input field, background
  1791.  |  |  |  |  |  |  |  +--------------- Inactive Input field, foreground
  1792.  |  |  |  |  |  |  |  |
  1793.  |  |  |  |  |  |  |  |  +------------ Active Input field, background
  1794.  |  |  |  |  |  |  |  |  |  +--------- Active Input field, foreground
  1795.  |  |  |  |  |  |  |  |  |  |
  1796. 07,00,07,00,00,02,01,15,07,00  Receive (upper, permanent)
  1797. 07,00,07,00,00,02,01,15,07,00  Transmit (lower, permanent)
  1798. 04,07,07,04,03,00,07,00,04,15  Statusline (middle, permanent)
  1799. 01,11,01,11,01,11,01,02,07,04  Immediate command entry
  1800. 01,15,01,15,07,00,00,14,01,14  Opening, PHS-Help, Review
  1801. 01,11,01,11,03,00,03,01,07,00  Parameter Dialogs
  1802. 01,11,01,11,01,15,01,11,07,00  Activity during YAPP xfer
  1803. 00,02,00,02,01,14,00,00,07,00  Parameter Dialog Help Line
  1804. 01,11,01,11,01,15,01,11,07,00  Parameter Dialog Extended Help (File)
  1805. 01,11,01,11,01,15,01,11,07,00  Other
  1806.  
  1807. The numers are decimal. PHS does not validate the range.
  1808.  
  1809. Number    Foreground    Background
  1810.  
  1811. 00    BLACK        BLACK
  1812. 01    BLUE        BLUE
  1813. 02    GREEN        GREEN
  1814. 03    CYAN        CYAN
  1815. 04    RED        RED
  1816. 05    MAGENTA        MAGENTA
  1817. 06    BROWN        BROWN
  1818. 07    LIGHTGRAY    LIGHGRAY
  1819. 08    DARKGRAY    |
  1820. 09    LIGHTBLUE    |
  1821. 10    LIGHTGREEN    |
  1822. 11    LIGHTCYAN    |- as above, blinking
  1823. 12    LIGHTRED    |
  1824. 13    LIGHTMAGENTA    |
  1825. 14    YELLOW        |
  1826. 15    WHITE        |
  1827.  
  1828. You can run the PHSCOLOR program which comes with PHS to see the foreground -
  1829. background combinations. If this is confusing, use the supplied values until you
  1830. are familiar with PHS.
  1831.  
  1832. Line twenty
  1833.  
  1834. must contain eight numbers.  The first four numbers defines the attributes for
  1835. the channel indicator. Please refer to the discussion of channels below.  The
  1836. first two numbers in this line define the color attributes of the on-screen
  1837. channel, the next two numbers define the attributes for an off-screen channel
  1838. which has received data. Of the two number pairs, the first is the background
  1839. attribute, the second is the foreground attribute. In the example, the
  1840. statusline text attributes are "03,00" which means 'black on cyan'. The example
  1841. line 20 is:
  1842.  
  1843. 00,11,03,11,02,00,00,00         Channel indicator attributes & echo text
  1844.  
  1845. which reads: the number of the on-screen channel is 'lightcyan on black' (00,11)
  1846. - and the number of a off-screen window which has received data is 'lightcyan on
  1847. cyan' (03,11).
  1848.  
  1849. The third number pair defines the attributes for the transmitted text in the
  1850. receive window for the packet modes. To keep the defaults, insert 00,00 here.
  1851.  
  1852. In all modes, the text you type is echoed in the lower (transmit) window.  In
  1853. the packet mode, when you send the text by typing a carriage return, then the
  1854. text is moved to the upper (receive) window, and the transmit window is cleared.
  1855. PHS uses different attributes so you can easily distinguish the text which you
  1856. sent from the text you receive.  By default, the text sent has the same text and
  1857. background color as the received text, but is intensified. This is what you get
  1858. if you do not specify the third number pair. If you do, PHS will use these
  1859. attributes.
  1860.  
  1861. Example:  if you have defined 'green on black' for the text- and background
  1862. color of the receive window, which is the number pair 00,02 and you want your
  1863. text reversed, not intensified, then define 02,00 here.
  1864.  
  1865. In the non-packet modes, the entered text for transmission is sent to the PK-232
  1866. word-by-word and you get the echo in the receive window from the PK-232
  1867. (echo-as-sent). For to get an indication up to which part of your text has
  1868. already been sent to the PK-232, that part is highlighted when you use the
  1869. default pair of 00,00. If you prefer another presentation, you can experiment
  1870. with other values.
  1871.  
  1872.  
  1873. The next lines
  1874.  
  1875. are optional and are composed of four different types of strings:
  1876.  
  1877.         - (#) function key text strings and titles.
  1878.     - (%) initialisation command strings.
  1879.     - ($) online command strings.
  1880.     - (}) PHS parameters
  1881.  
  1882.  
  1883.                  #-lines: The function key texts
  1884.  
  1885. The function key text strings are assigned to the function keys F01 to F10 in
  1886. the sequence in which they appear in the configuration file. When you press such
  1887. a function key, PHS sends the associated text string to the PK-232. By pressing
  1888. ALT/F PHS shows the titles of the text strings in a window box.
  1889.  
  1890. The line with a hash-sign (#) in column one defines the title which can contain
  1891. up to 30 charcters. Everything exceeding 30 characters is cut off.  The lines
  1892. following the title line until the next title line, or the end of the file form
  1893. the text string. The length of all text strings together is limited only by the
  1894. available memory space.  The text strings are intended for reasonable sized
  1895. texts like station descriptions or cq calls.
  1896.  
  1897. The function-key text must contain only printable characters, and two characters
  1898. have a special meaning: The '(' character at the end of a line (and only at the
  1899. end of a line !) is translated into CTRL/D when PHS reads the line.  The '<'
  1900. character is translated into CTRL/F (if at the end of a line).  CTRL/D and
  1901. CTRL/F are used by the PK-232 to switch to receive when embedded in text.
  1902.  
  1903. In the sample CFG-file you find a FEC-cq call. The single line with the
  1904. opening-bracket character (which is at the end of that line) is translated into
  1905. CTRL/D and the PK-232 will switch to receive at the end of this cq-call.
  1906.  
  1907. Up to ten #-lines are possible. If you specify more that ten #-lines, they are
  1908. ignored.
  1909.  
  1910.  
  1911.  
  1912.                 %-lines: Initialisation command strings
  1913.  
  1914.  
  1915. You can specify up to 10 lines with percent (%) sign in column one.  The text
  1916. following the percent sign must not exceed 40 characters and is sent as a
  1917. command to the PK-232 when PHS loads the PK-232 parameters during startup.  This
  1918. is done after PHS has sent the default set of parameter commands and so allows
  1919. the user to override the default parameter set of PHS. You should however take
  1920. some care - the contents of the %-lines are sent unconditionally to the PK-232
  1921. and must be a valid command to be effective. A %-line can only contain a command
  1922. which does not interfere with PHS operation. The non-interfering commands which
  1923. appear in the ALT/P windows.
  1924.  
  1925.  
  1926.                   $-lines: online command strings.
  1927.  
  1928.  
  1929. The $-lines must also contain valid PK-232 commands. Up to 20 lines not
  1930. exceeding 72 characters are possible.  They are stored by PHS and presented
  1931. together with a selection character when you press ALT/W.  When you press the
  1932. selection character or move the bar to the desired entry, then the associated
  1933. string is sent as a command to the on-screen channel.  The $-lines are intended
  1934. to build a call-sign directory for connects, you may however use other commands
  1935. there as well, so it is called "Command String Directory".
  1936.  
  1937.  
  1938.                  }-line: Changing the default PHS parameters
  1939.  
  1940.  
  1941. The }-line allows you to modify the default PHS configuration. This line is
  1942. optional. The format is:
  1943.  
  1944.         }a0,b0,b1,b2,b3,b4,c0,d0,d1,e0,f0
  1945.  
  1946.  
  1947. RS-232 control line usage: a0
  1948.  
  1949. If a0 is zero, then PHS ignores the RS-232 control-lines (DCD, RTS, CTS).  This
  1950. allows just a 3-wire (TXD, RXD & GND) connection to the PK-232.  Note however
  1951. that in this case PHS cannot detect if a PK-232 is offline, and will always
  1952. enter the PK-232-initialisation routine.  The default is non-zero.
  1953.  
  1954.  
  1955. Column size of the virtual receive windows: b0 to b4
  1956.  
  1957. b0 to b4 define the number of lines in the virtual receive windows for channels
  1958. zero to four.  This defines how many lines are available for reviewing.  The
  1959. minimum value is 40, the maximul value is 200. The default is the maximum for
  1960. all windows.
  1961.  
  1962.  
  1963. The initial PK-232 mode: c0
  1964.  
  1965. You can select the initial PK-232 mode here. The mode numbers are 0 to 7 for
  1966. Packet-VHF, Packet-HF, Amtor-Listen, Amtor-Standby, RTTY, Ascii, Morse and
  1967. Signal mode.
  1968.  
  1969. Editor window size: d0, d1
  1970.  
  1971. d0 and d1 define the editor window size, columns and rows. The range for d0
  1972. (column) is 64 to 79, and includes the window border. If a given value exceeds
  1973. one of the limits, then the according limit value is taken. If you omit this
  1974. parameter, or specify a zero, then the default value of 76 is taken. The range
  1975. for d1 (row) depends on the size of the (upper) receive window, which itself
  1976. depends on the number of lines of your current video mode. The range if from
  1977. half that window to full size minus one. For the standard 25 line mode, the
  1978. range is 10 to 20, also including the border.  The default here is the lowest
  1979. value, i.e. half the size of the receive window.
  1980.  
  1981.  
  1982. Filter received characters: e0
  1983.  
  1984. e0 determines the initial value of the MFILTER variable, see the description of
  1985. the ALT/T command. A zero disables the filtering, a one enables it. The default
  1986. (e.g. if omitted) is zero.
  1987.  
  1988.  
  1989. Time-offset for UTC: f0
  1990.  
  1991. During startup, PHS gets the current system time of your PC, adds f0 hours, and
  1992. loads this date and time into the PK-232. The intention is to have the PK-232
  1993. loaded with the UTC rather than with the local time - in case you want to use
  1994. the CTRL/T feature of the PK-232 to send date and time. Note however that if
  1995. there is a non-zero UTC offset specified, then the link status messages (e.g.
  1996. "CONNECTED to") are always time-stamped by the PK-232 and will consequently show
  1997. the PK-232s time. This time differs by f0 hours from the time on the status line
  1998. of PHS.
  1999.  
  2000. The date/time of the PK-232 is refreshed every full hour by PHS because the PC's
  2001. clock is more accurate that the PK-232 clock.
  2002.  
  2003.  
  2004.  
  2005.  
  2006.                         ERROR REPORTS
  2007.                         ═════════════
  2008.  
  2009. Whenwever PHS detects an error, it will open a window and display an error
  2010. message and optionally parameters. Note that it is not always possible to
  2011. recover from these errors. The message types are
  2012.  
  2013.     RS-232 Port Overrun error
  2014.     RS-232 Port Parity error
  2015.     RS-232 Port Framing error
  2016.     RS-232 Port BREAK interrupt
  2017.     Hostmode waiting for SOH: timeout
  2018.     Hostmode waiting for databyte: timeout
  2019.     Hostmode excessive input, no ETB
  2020.     Unknown error during input, code: nnnn
  2021.  
  2022. The RS-232 errors (besides timeout) are signalled by the ACE chip (8250/16450),
  2023. i.e.  hardware error reports or faults.
  2024.  
  2025. Parity and framing errors, or break interrupt indicate a chip problem, this
  2026. could however be on either end of the serial line. Try to use another port on
  2027. the PC, and/or reduce the transmission baud rate.
  2028.  
  2029. Whenever you get an overrun error this indicates that the your PC is not fast
  2030. enough to process the incoming characters. This can be solved by either reducing
  2031. the frequency in which the incoming characters appear, i.e. by reducing the
  2032. communications baudrate, or by using a more sophisticated serial communications
  2033. controller chip, or by increasing the CPU speed.
  2034.  
  2035. Unfortunatly if the System has not enough time to process an incoming character
  2036. timely this may be caused by other code which executes concurrently and which
  2037. disables the interrupt recognition for a too long time period. ALL keyboard
  2038. drivers from a DOS version higher than 3.20 exhibit this problem. You could
  2039. disable this driver by CTRL/ALT/F1 which gives you the US keyboard layout, or
  2040. try drivers from older or other DOS versions.
  2041.  
  2042. Possibly the best solution is to replace the standard serial controller chips by
  2043. a 16550A chip which has a built-in FIFO (a 16 byte hardware data stack).  PHS
  2044. supports this chip, and the use of this chip generally solves all overrun
  2045. problems.  If PHS detects such a chip, then you will see the string "FIFO:yes"
  2046. in the opening window, otherwise a "FIFO:no" is printed.
  2047.  
  2048. The "hostmode" errors signal a problem with the PHS-PK-232 hostmode
  2049. communication. Up to now I have ever only seen the first one (timeout waiting
  2050. for SOH), and only during startup of PHS. A hardware reset of the PK-232 and or
  2051. a hardware (!) reset of the PC cured it (on the PC side, a CTRL-ALT-DEL will not
  2052. help).
  2053.  
  2054.  
  2055.                        DECODING OF NET/ROM FRAMES
  2056.                        ══════════════════════════
  2057.  
  2058. PHS decodes Net/Rom routing broadcast messages and the inter-node frames into a
  2059. plain English text format. For an interpretation of the various variables shown,
  2060. please refer to "Net/Rom Version 1.3 Documentation" from Software 2000 Inc.
  2061.  
  2062.  
  2063.                               FINAL REMARKS
  2064.                               ═════════════
  2065.  
  2066. I will be interested in your proposals and comments. Please note however that I
  2067. will feel no obligation of any kind. I am a professinal software designer, but
  2068. THIS is a hobby project.
  2069.  
  2070. My address is:          Peter H. Heinrich
  2071.                              HB9CVV
  2072.                         Allmendstr. 25
  2073.                         CH-2562 Port
  2074.                         Switzerland
  2075.  
  2076. You can also contact me on CompuServe [71470,32].
  2077.  
  2078.  
  2079.  
  2080.                              REVISION HISTORY
  2081.                              ════════════════
  2082.  
  2083.  
  2084. 3.00    October 1989    Initial release
  2085.  
  2086.  
  2087. ───────────────────────────── end of file ─────────────────────────────────────
  2088. so far.
  2089.  
  2090.