home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / hp9816.zip / hpbsee.me < prev    next >
Text File  |  1990-03-09  |  10KB  |  249 lines
  1.  
  2.  
  3.        HP-KERMIT  DOS  DISTRIBUTION DISC   - Version 1.03
  4.                                              Mar 20, 1990
  5.  
  6.        Congratulations on obtaining a copy of KERMIT for the
  7.        Hewlett-Packard Family 9000 Series 200/300 BASIC Workstation.
  8.        I hope that you find the program useful in meeting your file
  9.        transfer needs.
  10.  
  11.         This program will operate only on the HP-BASIC Workstation,
  12.         and not on the PC-BASIC Language Co-Processor, nor will it
  13.         run on the HP-BASIC/UX Language product for hp-ux due to a
  14.         lack of sufficient Serial Interface support in those
  15.         products.
  16.  
  17.        This is a modified version of the HP-KERMIT LIF distribution
  18.        diskette. It contains HP-KERMIT in two formats, a DOS text
  19.        format, and a LIF PROG file image existing on DOS media. A
  20.        utility program called HPWUTIL.EXE has been included on the
  21.        disc to allow you to copy the LIF File images from the DOS
  22.        distrbution disc to an HP-LIF disc.
  23.  
  24.        The HPWUTIL.EXE program is part of HP's 82300B BASIC LANGUAGE
  25.        CO-PROCESSOR product and is Copyright (C) Hewlett-Packard.
  26.        Permission is granted to use the product for installing the
  27.        HP-Kermit distribution disc.
  28.  
  29.        If you have obtained the 82300 BASIC Processor Card for the PC
  30.        you can use the BASIC copy command to copy files directly from
  31.        this installation disc to a LIF disc. Without the
  32.        Hardware product you must use the HPWUTIL.EXE Utility.
  33.        Remember - the Processor Card can only be used to COPY the
  34.        files to a S/200/300 LIF disc - you cannot run KERMIT on the
  35.        PC-Coprocessor Card.
  36.  
  37.        If you are using version C.00.00 or later of the Processor
  38.        Card Software, please note that the KERMIT distribution
  39.        disc must be accessed as a LIF (HPW) volume, not a DFS (DOS
  40.        File System) volume. That is, you need to access the disc
  41.        using:
  42.  
  43.             COPY "HPBKERM:,1500,x" TO "HPBKERM:,1500,x"
  44.  
  45.        rather than using the DFS access method,
  46.  
  47.             COPY "HPBKERM:,DOS,A" TO "HPBKERM:,DOS,B"
  48.  
  49.  
  50.  
  51.         This DOS distribution disc is being distributed by Columbia
  52.         University - Kermit Distribution Dept.  at the Center For
  53.         Computing Activities.  You may obtain a HP-LIF Distribution
  54.         disc from INTEREX HP-Users Group (Membership Required) at
  55.         the following Address:
  56.  
  57.            INTEREX
  58.            680 Almanor Ave
  59.            Sunnyvale, CA  94086-3513
  60.  
  61.            Attention: HP Kermit Distribution
  62.        =============================================================
  63.        IMPORTANT:
  64.  
  65.        The filenames on the distribution disc need to be renamed
  66.        before the installation procedure will succeed. This was done
  67.        to allow distribution of the files using the HPB (HP BASIC)
  68.        suffix, and a 6.3 filename format. The install utility
  69.        HPWUTIL.EXE will expect to see different filenames.
  70.  
  71.        CHANGE the following filenames before proceeding !!
  72.  
  73.        Change this Filename      to       This Filename
  74.        ---------------------              -------------------
  75.  
  76.           HPBLIF   DIR                    HPWLIF   DIR
  77.           HPBKER   PRG                    HPBKERM
  78.           HPBHLP                          HPBHELP
  79.           HPBINI                          HPBINIT
  80.           HPBMSC                          HPBMISC
  81.  
  82.           HPBUTL   EXE                    HPWUTIL EXE
  83.           HPBSEE   ME                     README
  84.  
  85.        The files on the disc should now correspond with the
  86.        disc directory shown below:
  87.        =============================================================
  88.  
  89.        After renaming the files,
  90.        the files on this diskette include the following:
  91.  
  92.         DOS FILENAME            FILE TYPE        FILE CONTENTS
  93.  
  94.         HPWLIF   DIR     9728   LIF Image File   Directory Info
  95.      *  HPBKERM        194048   LIF-PROG Image   Kermit Program
  96.         HPBINIT           256   LIF-ASCII Image  Kermit Init Script
  97.         HPBHELP         11776   LIF-PROG Image   Help Subprogram
  98.      *  HPBMISC         33024   LIF-PROG Image   CSUB Source Code
  99.         HPBGET           4096   LIF-ASCII Image  LIF "README" file
  100.         HPBDOC         135680   LIF-ASCII Image  Kermit User Manual
  101.  
  102.         HPWUTIL  EXE            DOS Program      Install Copy Utility
  103.         HPBDOC   PRN   134528   DOS TEXT         Kermit User Manual 1.0
  104.      *  HPBASC   TXT   208958   DOS TEXT         Kermit Prog (Ascii)
  105.      *  README           6784   DOS TEXT         This README File
  106.  
  107.      * = Files revised 3/20/90
  108.  
  109.        To Install the files on this disc you will need to use the
  110.        HPWUTIL.EXE program from DOS. Have ready a LIF Initialized
  111.        disc(s) from an HP BASIC Workstation. You will need two
  112.        5 inch (blue) floppies, or a grey 3.5 inch floppy. They must be
  113.        initialized with 256 byte sectors (normal INITIALIZE command),
  114.        and the newer black 1.4 Mb discs cannot be used.  If you are
  115.        copying the files to a 3.5 inch LIF floppy you will need to
  116.        have a 3.5 inch dos disc drive on your PC.  External floppy
  117.        discs such as the HP-9122 cannot be used, the discs must be DOS
  118.        internal drive mechanisms.
  119.  
  120.  
  121.        COPYING THE DOS - LIF IMAGES TO AN HP-LIF DISC
  122.  
  123.        The DOS-LIF Image files are known as HPW (HP Workstation)
  124.        files. You will be copying from a HPW volume to a LIF Volume.
  125.        The following steps show you how to use the HPWUTIL program to
  126.        install the Kermit files:
  127.  
  128.        In the following example the DOS Kermit Distribution Disc is in
  129.        drive A: and the HP LIF Formatted disc is in drive B:
  130.  
  131.  
  132.      (1) A:> HPWUTIL            Run the Utility Program
  133.  
  134.      (2) Press F2               Press the COPY Option
  135.  
  136.      (3) Press F5               Select  HPW to LIF  Copy
  137.  
  138.      (4) Type Source DOS Directory  (KERMIT Distribution Floppy)
  139.  
  140.          A:\    <enter>
  141.  
  142.      (5) Type the Destination LIF Drive Name
  143.  
  144.          B:     <enter>             (S/200/300 LIF Floppy)
  145.  
  146.      WARNING: DO NOT ACCIDENTALLY INSTALL THE FILES TO A DOS HARD DISC
  147.               THIS MAY CORRUPT THE DOS HARD DISC VOLUME.
  148.  
  149.      (6) "Please insert an HP LIF-Formatted Destination Disc
  150.           in drive B:
  151.  
  152.           Warning: The Destination Disc will be completely
  153.           overwritten ....
  154.  
  155.           Press <return> to begin copy
  156.  
  157.      (7)  You will see the folowing file copy status screen during
  158.           copying:
  159.  
  160.  
  161.           Source:    DOS HPW subsystem in directory:  A:\
  162.           Destination:  LIF Disc in drive B:
  163.           File Count = x
  164.           Copying File: HPBKERM
  165.  
  166.           After the copy is complete you will see the followiung
  167.           message on the screen:
  168.  
  169.          "DOS HPW directory to HP-LIF Volume copy is complete.
  170.           Number of files copied is 6."
  171.  
  172.           <Hit any key to continue>
  173.  
  174.  
  175.    (8)  To verify the copy operation you can perform a catalog
  176.         function (F3) on the destination disc:
  177.  
  178.  
  179.         From the HPWUTIL main (entry) screen -
  180.  
  181.           (a) Press F3      Catalog Function
  182.           (b) Press F1      LIF Disc
  183.           (c) B:            Type the DOS Drive for the LIF disc
  184.           (d) <enter>       Press Enter when ready
  185.  
  186.                 The LIF Disc is cataloged
  187.  
  188.           (e) <enter>       Press <enter> after catalog to exit
  189.           (f) Press F8      Press F8 to return to DOS
  190.  
  191.  
  192.         You can now place the LIF disc into an HP BASIC Workstation
  193.         S/200 or S/300 disc drive and LOAD the Kermit PROG file
  194.         HPBKERM. You can rename the file to any valid BASIC PROG
  195.         filename such as KERMIT3 or HPKERMIT.
  196.  
  197.        --------------------------------------------------------------
  198.  
  199.         Printing the Kermit Documentation from DOS:
  200.  
  201.        The HP-Kermit Users Manual is included on this disc as both a
  202.        DOS Text-Formatted Print File and LIF ASCII File.  There are no
  203.        non-printable or escape sequences in the document.  To print
  204.        the user manual from DOS use the DOS PRINT command:
  205.  
  206.         C:> PRINT HPBDOC.PRN
  207.  
  208.        Don't try to print the LIF-ASCII document HPBDOC from DOS -
  209.        It can only be printed from HP-BASIC.
  210.  
  211.        --------------------------------------------------------------
  212.  
  213.        The  HPBASC.TXT  File
  214.  
  215.        The HPBASC.TXT is a DOS text listing of the HP-Kermit
  216.        Program File. The File is really meant for viewing and printing
  217.        from DOS. It can be used to bootstrap the program from a
  218.        file transfer or tape with some concerns:
  219.  
  220.        Because the DOS program listing is ascii, all compiled
  221.        sections of the HPBERM Program have been replaced with the
  222.        BASIC interpreted source code.  The program text will run
  223.        Kermit at one-forth the speed of the BASIC PROG file because
  224.        of the three missing compiled subprograms SUB Spack, SUB
  225.        Encode_pack, and SUB Decode_pack.  The PHYREC CSUBS are also
  226.        missing, and no source is available for these.  The PHYREC
  227.        CSUBS are part of the BASIC 5.x product from HP and can be
  228.        "loadsub'd" from the BASIC Utilities disc with the following
  229.        command:
  230.  
  231.        LOADSUB ALL FROM "PHYREC:,7xx,1"
  232.  
  233.        The source code for the Spack, Encode_pack, and Decode_pack
  234.        subprograms can be compiled using any supported HP BASIC 5.x
  235.        compiler on the BASIC Workstation:
  236.  
  237.        LOAD "HPBKERM"
  238.        LOAD BIN "COMPILER"
  239.        COMPILE Spack
  240.        COMPILE Encode_pack
  241.        COMPILE Decode_pack
  242.  
  243.        The entire program could be compiled by entering the
  244.        COMPILE command. However this results in increased code size,
  245.        and not much more performance if any. Consult the Compiler
  246.        manual for compiler directives on optimizing for speed, code
  247.        size, etc. Make sure the ! $EOL ON directive is used to
  248.        enable End-of-line Interrupts.
  249.