home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / honeywellgcosa / hd6kerdoc.txt < prev    next >
Text File  |  2020-01-01  |  14KB  |  334 lines
  1.  
  2.          DOCUMENTATION  FOR  SUPERKERMIT  ON  THE  DPS-6
  3.  
  4.  
  5.      This document describes the idiosyncrancies of SUPERKERMIT
  6. Ver. 2.00 for the DPS-6, further information should be obtained
  7. from the included Kermit Users's Manual.  These brief notes are
  8. to allow novice personnel to start using SUPERKERMIT for the
  9. Honeywell DPS-6 mini-computer.  This Kermit was written using the
  10. Honeywell 'C' optimizing compiler to generate executable code.
  11. This software was developed in response to the need for several
  12. facilities that are lacking in the VIP-3 terminal emulation and
  13. file-transfer package. A few, but certainly not all, of the
  14. shortcomings of VIP-3 are:
  15.  
  16. o  Will not operate at 19,200 bps and above. (Independent tests at
  17.    9600 bps have shown Superkermit to be 3 times faster on binary
  18.    file transfers and two times faster on ASCII file transfers than
  19.    VIP-3 at 9600 !  You can nearly double these figures at 19.2 kbps.)
  20. o  No wild-card, batch or time-activated transfers (e.g. trans-
  21.    ferring files in unattended mode at midnight).
  22. o  No data-compression...VIP-3 transfers data 'as-is' including
  23.    white-space, repeated-strings, etc..
  24. o  VIP-3 is not a 'well-behaved' application as it usurps the
  25.    MSDOS screen and keyboard interrupts.
  26. o  VIP-3 always creates a MOD400 sequential file for incoming
  27.    data regardless of its true type (e.g. binary or 'save' format).
  28. o  Superkermit does NOT have to run in a swappool under the Honeywell
  29.    4.0 operating system as VIP3.1 does.
  30. o  Superkermit has many new advanced server features - see HD6KER.BWR.
  31.  
  32.  
  33.      Basically SUPERKERMIT on the DPS-6 allows one to perform
  34. telecommunications using a slightly modified MSKermit (Version
  35. 3.01) on the PC microcomputer with all of its attendant
  36. scripting, batch, LAN and data mangement utilities.  This
  37. modified MSKermit is still 100% compatible with ANY other
  38. computer and files can thus be transferred from the DPS-6 to the
  39. Defense Data Network, IBM mainframes, the Novelli network, etc.
  40. without using any other telecommunications package.
  41.  
  42. Superkermit Capabilities At A Glance:
  43.  
  44.    Local operation:                Yes
  45.    Remote operation:               Yes
  46.    Transfers text files:           Yes
  47.    Transfers binary files:         Yes
  48.    Wildcard send:                  Yes
  49.    File transfer interruption:     Yes
  50.    Filename collision avoidance:   No
  51.    Can time out:                   No
  52.    8th-bit prefixing:              Yes
  53.    Repeat count compression:       Yes
  54.    Alternate block check types:    Yes
  55.    Terminal emulation:             None
  56.    Communication settings:         None
  57.    Transmit BREAK:                 No
  58.    IBM mainframe communication:    Yes
  59.    Transaction logging:            Yes
  60.    Session logging (raw download): No
  61.    Raw upload:                     No
  62.    Act as server:                  Yes
  63.    Talk to server:                 No
  64.    Advanced server functions:      Yes
  65.    Advanced commands for servers:  Yes
  66.    Local file management:          Yes
  67.    Command/init files:             No
  68.    Command macros:                 No
  69.    Extended-length packets:        Yes
  70.    Local area networks:            Yes (Honeywell/Bridge Ethernet)
  71.    MS-Windows compatibility:       N/A
  72.    Attribute packets:              Yes
  73.    Sliding windows:                No
  74.  
  75.  
  76.     Although the PC Kermit is a 'full-blown' Kermit,
  77. SUPERKERMIT for the DPS-6 can only send files, receive files and
  78. act as a server.  There is no 'connect' facility.  Also, the DPS-6
  79. has certain communication parameters that do not change and
  80. MSKermit on the microcomputer must be set for them as follows:
  81.  
  82.           SET PARITY EVEN <cr>
  83.           SET FLOW-CONTROL NONE <cr>
  84.       SET HANDSHAKE NONE <cr>
  85.       SET SEND START-OF-PACKET 01 <cr>
  86.       SET RECEIVE START-OF-PACKET 01 <cr>
  87.  
  88.     If using MSKermit 3.02 ALSO perform the following two commands:
  89.  
  90.           SET TERMINAL HONEY <cr>
  91.           SET RECEIVE IGNORE 10 <cr>
  92.  
  93.     for 3.1 operating system while using MSKermit 3.02:
  94.  
  95.           SET SEND DOUBLE 92 <cr>
  96.  
  97.      The speed at which MSKermit can send packets to the DPS-6
  98. (since hardware/software handshaking is not available) can actually
  99. EXCEED the turn-around capabilities of the ATD line driver and
  100. produce (^G) BEL characters as a packet response.  Therefore the
  101. best way to use Kermit is to put a slight delay between packets
  102. and use the largest packet size, e.g.
  103.  
  104.       SET SEND PACKET-SIZE 2000 <cr>
  105.       SET RECEIVE PACKET-SIZE 2000 <cr>
  106.       SET SEND PAUSE 20 <cr>
  107.  
  108.      This delay can be tuned for greatest throughput at different
  109. baud rates etc..
  110.  
  111.      Baud rates, packet-size, block-checks are all configurable
  112. as discussed below.  It should be noted that the Honeywell sends
  113. an identification string to its VIP type terminals anytime the
  114. system been rebooted, an inactivity timeout occurs or an
  115. UNPLUG/REPLUG command has been executed.  The string basically
  116. asks 1) What type of terminal are you? and 2) Do you have a
  117. printer attached?.  A user terminal MUST respond to these
  118. inquiries before a login banner will appear.  The supplied files start-
  119. ing with a '!' char illustrate the proper PC response to these questions
  120. when in batch mode.  MSKermit 3.02 has been modified to automatically
  121. answer this escape string when in terminal emulation via a
  122. 'connect' command (HONEY mode).  In addition, the supplied file
  123. MSKERMIT.INI contains many useful macros and settings for DPS-6
  124. file transfer and is automatically executed when MSKermit is
  125. invoked.  The settings for the PC that vary for a particular
  126. Kermit environment are as follows:
  127.  
  128.    SET PORT 1/2 <cr>                        (use COM1 or COM2 on PC)
  129.    SET SPEED 2400/9600/etc. <cr>            (set comm line speed)
  130.    SET SEN PACKET-SIZE 94/2000/etc. <cr>    (set size of trans-
  131.    SET REC PACKET-SIZE 94/2000/etc. <cr>             mission packets)
  132.    SET BLOCK-CHECK 1/2/3 <cr>           (set the error-checking type)
  133.  
  134.      The DPS-6 Kermit, the 'remote' Kermit, can be invoked in
  135. several ways depending on the type of file being transferred and
  136. the intervening electronic pathway (e.g. LANs or multiplexors).
  137. Several examples are given below:
  138.  
  139.  
  140.               To send/receive an ASCII file:
  141.  
  142.                SUPERKERM |R| [filename] <cr>
  143.                          |S|
  144.  
  145.  
  146.            To send/receive a binary Honeywell file:
  147.  
  148.                SUPERKERM |R|B [filename] <cr>
  149.              |S|
  150.  
  151.           To send/receive an executable MSDOS file:
  152.  
  153.                SUPERKERM |R|F [filename] <cr>
  154.              |S|
  155.  
  156.  
  157.     To place SUPERKERMIT in binary, ASCII or FOREIGN server mode:
  158.  
  159.                SUPERKERM V|A| <cr>
  160.                           |B|
  161.                           |F|
  162.  
  163.       ( This method is highly recommended and has been
  164.             extensively tested in send and receive modes.
  165.             Extended packets will be negotiated automatically
  166.         if your PC Kermit requests them.)
  167.  
  168.  
  169.      There are also many permutations of the above examples that
  170. will work.  Typing SUPERKERM H <cr> on the DPS-6 will list all of
  171. the available command arguments.  Also if you type SET ATTRIB ON
  172. <cr> on the PC Kermit will show the percentage of the incoming
  173. file that has been received during file transfers.  This only
  174. works for fixed-relative files (bound-units) as variable-length
  175. record files sizes can only be determined by reading the entire
  176. file.  More importantly if file attributes are used when
  177. uploading bound-units, the proper size DPS-6 file will be pre-
  178. created instead of growing all over the disk in the default
  179. growth size of 32 Control Intervals per file extent.  If you MUST
  180. know the percentage transferred of incoming variable-length
  181. record files (e.g. ASCII text), SAVE them into a pre-created
  182. fixed-relative MOD400 save file and download them in binary mode.
  183. Attributes MUST be set on for MSDOS executable file transfers.
  184.  
  185.  
  186.                         *********************
  187.                         *   N - O - T - E   *
  188.                         *********************
  189.  
  190.      If you have any trouble at all with the 'enhanced' features
  191. of Kermit, stick to 'classic' Kermit with 94-byte packets,
  192. attributes turned off, ASCII mode only, etc..  Also, if an ASCII
  193. file pre-exists on the DPS-6, Superkermit will APPEND incoming
  194. data to the file if the concatenate option 'C' is used on the
  195. command line!  Binary transfers automatically overwrite any
  196. existing files by the same name.
  197.  
  198.      Once you have logged into the DPS-6 you may use the supplied
  199. PC BAT files, GET and PUT, to transfer files from/to the DPS-6;
  200. just type GET or PUT without any arguments and they will print
  201. help information.  The bound unit 'SUPERKERM' must be in your
  202. DPS-6 search path.  SUPERKERMIT also requires the Honeywell
  203. Scientific Instruction Processor or an equivalent simulator (SIPSIM).
  204.  
  205.  
  206.                 Questions  and  Answers  about  Superkermit
  207.  
  208.  
  209. Q.  Can I send/receive ASCII files using 'binary' or 'FOREIGN' mode?
  210.  
  211. A.  Yes, but the output will be garbled as Superkermit will not
  212.     handle line feed, carriage returns combinations properly.
  213.  
  214.  
  215. Q.  Can I operate the PC Kermit in 'server' mode and initiate transfers
  216.     from the DPS-6?
  217.  
  218. A.  Yes, connect the PC Kermit into the DPS-6 and then put it into 'server'
  219.     mode. File transfers can then be started at a DPS-6 user terminal thus:
  220.     SG KM 2 !KVxxx -OUT !KVxxx -EFN SUPERKERM -ARG S/R [filename] <CR>
  221.  
  222.  
  223. Q.  Can I operate Superkermit 'host-to-host' directly from one DPS-6 to
  224.     another?
  225.  
  226. A.  Not at this time, this feature was not incorporated as the Honeywell
  227.     LAN allows file transfers quite easily via the PC Kermit.
  228.  
  229.  
  230. Q.  Can any Kermit on the PC work with the DPS-6 Superkermit
  231.     (e.g. PROCOMM, QMODEM)?
  232.  
  233. A.  No! Although the PC MS-Kermit 3.01 provided will work with ANY other
  234.     host Kermit..it has been modified to detect and take special action
  235.     during DPS-6 file transfers.  However, under the Honeywell 4.0
  236.     operating system ONLY, Superkermit will communciate correctly with
  237.     the VIP-3 PC Terminal Emulation package.  The VIP3 software must be
  238.     configured for the '7-bit other host' Kermit file transfer protocol.
  239.     It can perform binary transfers in this fashion without the need to
  240.     precreate a 'fixed relative' file on the DPS-6.  The speed will be
  241.     greatly reduced as VIP-3 only supports 94-byte packets in this mode.
  242.  
  243.  
  244. Q.  Can I send any DPS-6 file types back and forth to the PC
  245.     (e.g. indexed, IDS_II, relative,etc.) ?
  246.  
  247. A.  Absolutely, you must first create a fixed-relative file (e.g.
  248.     CR myfile -F_REL) on the DPS-6 and then use the 'SAVE'
  249.     command to store the desired files into the pre-created file
  250.     (e.g. SAVE mydirectory myfile) then as long as transfers are
  251.     performed in 'binary' mode and the results rebuilt using the
  252.     DPS-6 'RESTORE' command any type file can be transferred.
  253.     (NOTE: EOF must be set to No CTL-Z in MSKermit on the PC.)
  254.  
  255.  
  256.  Q.  Can PC executable files (.EXE and .COM) files be sent to the
  257.      DPS-6 and back ?
  258.  
  259.  A.  Yes, version 2.00 of Superkermit has introduced a new file type
  260.      called 'FOREIGN'.  UNIX and/or MSDOS files can be uploaded and
  261.      downloaded and not only will they retain their 'executability';
  262.      they will also retain their host system creation date, user access
  263.      rights, etc..  See HD6KER.BWR for more details.
  264.  
  265.  
  266.  Q.  Is Superkermit smart about Honeywell directory structures ?
  267.  
  268.  A.  Yes. To send a file to a specific directory issue the PC Kermit command:
  269.  
  270.            SEND myfile >mydir>myfile <cr>
  271.  
  272.      To receive a file from a specific directory use the GET command thusly:
  273.  
  274.            GET <cr>
  275.            Remote Source File: >mydir>myfile <cr>
  276.            Local Destination File: myfile <cr>
  277.  
  278.      NOTE: Superkermit will accept the 'remote cwd' command from MSKermit;
  279.      this allows one to change directories on the DPS-6 without terminating
  280.      Superkermit  ( e.g. remote cwd \udd\mydir <c/r> ).  Due to an MSKermit
  281.      bug you must use the '/' (forward slash) character to replace the '>' 
  282.      symbol in remote cwd DPS-6 attempts.  See HD6KER.BWR for details.
  283.  
  284.  
  285.  Q.  What Honeywell operating systems does Superkermit work with ?
  286.  
  287.  A.  It works with both the 3.1 and 4.0 operating systems. It is highly
  288.      recommended that you use MSKermit 3.02 or higher with Superkermit.
  289.      See the HD6KER.BWR file for details.
  290.  
  291.      Incidentally, the Superkermit server can perform MANY advanced
  292.      Kermit server functions such as typing a host file (in your
  293.      Honeywell WORKING directory only!) to your PC screen or executing
  294.      host commands for you and sending results to your PC screen:
  295.  
  296.                   'remote type START_UP.EC (c/r)'          
  297.                   'remote host STS -ALL (c/r)'
  298.  
  299.      See HD6KER.BWR for details.
  300.  
  301.  
  302.  Q.  Will sliding windows be implemented in a future Superkermit ?
  303.  
  304.  A.  It is doubtful...with the use of MSKermit 3.10 a file transfer can
  305.      use up to 2000-byte packets.  Although sliding windows provide some
  306.      advantages over large extended packets, this is offset by the fact 
  307.      that extended packets allow the data compression algorithm to be more 
  308.      efficient and the packet overhead/data ratio is much smaller.  
  309.  
  310.  
  311.  Q.  Can I perform 'wildcard' transfers using Superkermit ?
  312.  
  313.  A.  Yes, Version 2.00 fully implements wildcard transfers.  You can
  314.      perform Superkermit 'send' commands using wildcards or do wildcard
  315.      'get' commands on the PC while Superkermit is running in server mode.
  316.      The only restriction is that only files matching the wildcard name
  317.      AND having the Honeywell file type specified on the Superkermit
  318.      command line will be transferred.  For example, if you perform the
  319.      following server command on the Honeywell:  Superkerm VA <c/r>, then 
  320.      escape back to MSKermit and execute a 'get *.C' command, you will 
  321.      only receive sequential (ASCII) files having a filename extension 
  322.      of 'C'.  NOTE:  If you want ALL Honeywell files of a specific type 
  323.      the correct wildcard string for the DPS-6 is '**' NOT '*.*' !!!
  324.  
  325.  
  326.                       Frank Dreano (Code 431)
  327.  
  328.      2403 Tarkington Ct.     or   Navy Management System Support Office
  329.      Chesapeake, Va. 23322        1441 Crossways Boulevard
  330.      (804) 421-3785               Chesapeake, Va. 23320
  331.                                   (804) 523-8190
  332.  
  333.                   END  OF  HD6KER.DOC FILE    09/19/90
  334.