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