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