home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / honeywellgcosb / hdps8doc.txt < prev   
Text File  |  2020-01-01  |  33KB  |  925 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Honeywell GCOS Kermit
  8. Version 1.1
  9. January 1985
  10.  
  11.  
  12.      This writeup describes the  features  and  use  of  Kermit-GCOS,  a
  13. program  for Kermit protocol file transfers.  Kermit-GCOS runs under the
  14. Honeywell GCOS time sharing system (TSS)  and  should  normally  be  in-
  15. stalled on the TSS command library as file CMDLIB/KERM to run as the TSS
  16. command KERMIT.  It can, however, be placed on any user catalog and  run
  17. as  a  TSS  user  program.   Kermit-GCOS  was  written by John Huxtable,
  18. University of Kansas Academic Computing Services.
  19.  
  20.      On first reading, you may want to skip many of the  sections  which
  21. provide  detailed  information and look at only the overview and example
  22. sections.  Before using Kermit-GCOS, however, you  should  go  back  and
  23. read the full writeup.
  24.  
  25.  
  26. 1.1.1. What is Kermit?______________________
  27.  
  28.      Kermit is a protocol designed for reliable  file  transfer  between
  29. computers.   The  transfer  takes  place  through a standard RS-232 com-
  30. munications port, allowing implementation of Kermit transfer programs on
  31. most computers.  Although Kermit is technically the name of the transfer
  32. protocol, it is common practice  to  refer  to  both  the  protocol  and
  33. programs  which  use  the protocol as Kermits; this will be done through
  34. the remainder of this writeup.
  35.  
  36.      Kermit development started at the Columbia  University  Center  for
  37. Computing   Activities  in  1981.   The  primary  developers  were  Bill
  38. Catchings and Frank da Cruz.  Since that time the protocol has been  ex-
  39. tended  and implemented for many systems.  Persons interested in how the
  40. protocol works should read articles in the June and July 1984 issues  of
  41. Byte____ magazine which describe it in some detail.
  42.  
  43.      In order to transfer a file with Kermit, Kermit must be running  on
  44. both  the  sending  and  receiving computers.  One Kermit (called "local
  45. Kermit") must be able to establish the connection with the other  Kermit
  46. (called  "remote  Kermit").  In the case of transfer between a microcom-
  47. puter and a mainframe this is generally done by the microcomputer Kermit
  48. acting as a terminal as well as providing file transfer capability.
  49.  
  50.      Microcomputer versions of Kermit are available from  many  bulletin
  51. board  systems.  A tape containing all "known" versions of Kermit can be
  52. obtained from Columbia University.   For  current  ordering  information
  53. contact:
  54.  
  55.     KERMIT Distribution
  56.     Columbia University Center for Computing Activities
  57.     7th Floor, Watson Laboratory
  58.     612 West 115th Street
  59.     New York, N.Y.  10025
  60.  
  61.  
  62.                                  - 1 -
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73. 1.1.2. Syntax Conventions_________________________
  74.  
  75.      To show the syntax of commands and responses this writeup uses  the
  76. following conventions:
  77.  
  78.      Angle brackets surround a description of what should be typed.  For
  79. example,
  80.  
  81.      <option>
  82.  
  83. means to type  a  Kermit  option;  it  does  not___  mean  type  "<option>"
  84. literally.
  85.  
  86.      Square brackets surround an optional item.  For example,
  87.  
  88.      Kermit [<command>]
  89.  
  90. means type "Kermit", optionally followed by some command.  If a "*" fol-
  91. lows the closing square bracket, it means "zero or more".  For example,
  92.  
  93.      Kermit [<option>]*
  94.  
  95. means type "Kermit" followed by zero or more options.
  96.  
  97.      Control sequences are shown using the convention  that  "^x"  means
  98. "hold  the control key down, press the 'x' key, then release both keys."
  99. For example, when asked to type
  100.  
  101.      ^]
  102.  
  103. hold the control key down and push the ] key.
  104.  
  105.      When a keyword appears in a syntax description, the  letters  which
  106. appear  in  uppercase  must be typed.  The letters which appear in lower
  107. case are optional.  Digits and special characters must  be  typed.   For
  108. example:
  109.  
  110.      +OverWrite
  111.  
  112. indicates that "+", "O" and "W" MUST be typed;  the  letters  "ver"  and
  113. "rite" are optional.  The minimum entry to invoke this option would be:
  114.  
  115.      +ow
  116.  
  117. Note that the characters may be entered in either case; the case in  the
  118. syntax  description  is merely a method to indicate which characters are
  119. required.
  120.  
  121.  
  122. 1.1.3. GCOS File Formats________________________
  123.  
  124.      GCOS uses many different methods of storing  and  accessing  files.
  125. Since  other systems do not necessarily support analogs of GCOS formats,
  126. three file formats have been defined to handle all cases.
  127.  
  128.                                  - 2 -
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.      The default format is "Text".  This is the standard format used for
  140. text  files  in  GCOS  TSS.   When Kermit-GCOS transmits a text file, it
  141. removes GCOS file control and record control words  from  the  file  and
  142. transmits  a  carriage-return,  line-feed  sequence  at  the end of each
  143. record.  It also deletes the high  (9th)  bit  of  each  nine-bit  byte.
  144. These  bits  are  always  zero in a text file so no information is lost.
  145. When Kermit-GCOS receives a file in text format, it  adds  a  zero  high
  146. (9th)  bit  to each byte so that four fit evenly into each 36-bit Honey-
  147. well word.  It also converts the carriage-return, line-feed sequence  at
  148. the  end  of  each  record into Honeywell record control information and
  149. stores the file in GCOS system standard TSS format.   Files  transmitted
  150. to  GCOS can always be stored in text format even if the file content is
  151. eight-bit data, such as a .COM or .EXE file from a microcomputer.   When
  152. transferred  from  GCOS  to a system of the originating type, such files
  153. will be restored exactly to their original form.  Text is the most  con-
  154. venient  format  to  use for files transferred to GCOS for archival pur-
  155. poses.
  156.  
  157.      The second format is "BYtestream".  A bytestream file is  the  best
  158. format  to  use  when sending non-text (binary) files, such as eight-bit
  159. telemetry data, from other systems to GCOS for processing on GCOS.   The
  160. data  is  stored  with no record structure, i.e. only the bytes received
  161. with no added "control" information.  As in text mode, Kermit-GCOS  adds
  162. a  high-order zero bit to each incoming eight-bit character, to align on
  163. nine-bit Honeywell byte boundaries with four characters per 36-bit word.
  164. The  unused  portion  of  the last 1280-byte block of the file is filled
  165. with zeros (ASCII nulls).  When transmitting a bytestream file,  Kermit-
  166. GCOS  strips  the high-order bit from each 9-bit byte, and transmits the
  167. full file including any trailing zeros (nulls) which pad the last block.
  168. The  Bytestream  option  automatically  sets  the  +Random  option since
  169. bytestream files must be accessed in random (direct access) mode.
  170.  
  171.      The third format is "BItstream".  A bitstream  file  also  contains
  172. data only, with no control information.  It is different from bytestream
  173. in that each nine eight-bit bytes received are packed  into  two  36-bit
  174. Honeywell  words.   During transmission, each pair of Honeywell words is
  175. unpacked into nine eight-bit bytes.  This  format  permits  transmitting
  176. and  receiving  GCOS  files,  such as random libraries, which use all 36
  177. bits in each word.  Bitstream format is useful for archiving binary GCOS
  178. files on other systems.  One of the other two formats should be used for
  179. most other purposes.  Bitstream  files  should  be  accessed  in  random
  180. (direct access) mode.  Specifying Bitstream format automatically implies
  181. the +Random option.
  182.  
  183.  
  184. 1.1.4. GCOS Data Transfer Modes_________________
  185.  
  186.      Kermit-GCOS can operate in  two  communications  modes.   One  mode
  187. receives  packets  as  standard  ASCII  input,  with  a  carriage return
  188. (decimal 13) used to end each packet; the other receives  packets  using
  189. "paper-tape"  mode, with an ASCII DC3 character (also known as XOFF, ^S,
  190. decimal 19, or hexadecimal 13) used to end each packet.  Which mode  you
  191. should use depends on your GCOS site's system configuration.
  192.  
  193.  
  194.                                  - 3 -
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.      Between your local Kermit and Kermit-GCOS is a Honeywell communica-
  206. tions  computer,  called  a  front-end  processor.  One of the Honeywell
  207. front-end software programs is called GRTS.  GRTS uses the  at-sign  (@)
  208. as  a  character  delete  code  for  normal input and provides no way to
  209. change this.  For example, the  character  sequence  "ABC@@D"  would  be
  210. received  through GRTS as "AD".  Since the Kermit protocol requires that
  211. all printable ASCII characters (including @) can be sent  and  received,
  212. by  default Kermit-GCOS uses paper-tape mode to read packets.  In paper-
  213. tape mode, "@" is treated as a normal printing character.  In this mode,
  214. however,  the end of input is indicated by an ASCII DC3 character (XOFF)
  215. instead of a carriage return.  This means that before beginning  a  file
  216. transfer you must set the send end of line character for your local Ker-
  217. mit to this value.
  218.  
  219.      Honeywell's newer front end software has the ability to change  the
  220. character  delete  code.   If  you  change  it  to  a non-printing ASCII
  221. character (e.g. backspace or delete) then you need  not  use  paper-tape
  222. mode.   For  non-paper-tape  input  mode,  your  local  send end of line
  223. character should be a carriage return.  This is  the  default  for  most
  224. versions  of  Kermit.   To  select  this  mode  for  Kermit-GCOS use the
  225. -TapeMode option which is described in the option section below.
  226.  
  227.      Unless you must operate in paper-tape mode, it is best to  use  the
  228. -TapeMode option.  Tape mode prohibits the use of XON/XOFF flow control,
  229. since the XOFF control would also  signal  the  end  of  a  packet.   In
  230. general,  GRTS  does not support flow control; however, if your site has
  231. implemented flow control for GRTS, sending a Kermit packet while Kermit-
  232. GCOS is not in a receive state would lock the line.  You would then have
  233. to escape to interactive  mode,  type  ^Q^D^S  to  regain  control,  and
  234. restart the file transfer from the beginning.
  235.  
  236.      Flow control can also be a problem if your connection  to  GCOS  is
  237. through  a  network.   To  use  tape  mode through a network it must not
  238. depend on XON/XOFF control for blocks the size of Kermit packets (up  to
  239. 96  characters).  You may need to set network parameters to pass XOFF as
  240. data.  Consult with local support staff or see  local  documentation  if
  241. your connection is through a network.
  242.  
  243.      Finally, whenever GRTS is ready for input it  sends  an  ASCII  DC1
  244. character.  If your local Kermit has an option for DC1 (^Q or XON) hand-
  245. shaking, you should select it, especially if you are using tape mode.
  246.  
  247.  
  248. 1.2.1. An Overview of Kermit-GCOS______________
  249.  
  250.      This section presents a summary of the features of Kermit-GCOS.  It
  251. assumes  you are already familiar with some basic information about GCOS
  252. time-sharing, such as how to log on and off.  If you are not, then first
  253. read appropriate documentation for these topics.
  254.  
  255.      Kermit-GCOS operates as a remote version only.  That is,  it  never
  256. originates a connection.  It must be called by Kermit running on another
  257. system, usually a microcomputer Kermit in local mode acting  as  a  ter-
  258. minal.
  259.  
  260.                                  - 4 -
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.      Commands and options to control Kermit-GCOS can be supplied on  the
  272. command  line,  entered  following  prompts in interactive mode, or sent
  273. from your local Kermit through the use of the Kermit-GCOS server mode.
  274.  
  275.      Multiple files can be transmitted by  supplying  a  list  of  names
  276. through  the  index  file  option.   Separate file format options can be
  277. given for each entry in the index file.
  278.  
  279.      A working directory can be defined  as  the  default  location  for
  280. files  to  be  sent  or  received.  The working directory is internal to
  281. Kermit-GCOS.  It is not dependent on the working directory facility  in-
  282. troduced recently in GCOS.
  283.  
  284.  
  285. 1.2.2. Invoking Kermit-GCOS_______________
  286.  
  287.      To start Kermit-GCOS, enter the following command line:
  288.  
  289.      KERMit [<kermit command>] [<option>]*
  290.  
  291. where the "<kermit command>" is an optional Kermit command.  If  you  do
  292. not specify a command, Kermit will enter interactive mode, prompting you
  293. for commands.  If you do specify a command, Kermit will execute the com-
  294. mand and then end.  If options are given but no command, Kermit sets the
  295. options and enters interactive mode (see Kermit Options, below).
  296.  
  297.  
  298. 1.2.3. Kermit Commands______________________
  299.  
  300.      Kermit-GCOS recognizes the following commands:
  301.  
  302.    ? -- Print a List of Commands Recognized
  303.        Typing a "?" as a command will cause a list  of  recognized  com-
  304.        mands to be printed.
  305.  
  306.    Done -- Exit Kermit
  307.        Done
  308.  
  309.        The Done command exits Kermit.   You  may  also  type  "Exit"  or
  310.        "Quit".
  311.  
  312.    Help -- Provide Basic Explanations
  313.        Help <command>
  314.        Help <option>
  315.  
  316.        The Help  command  prints  information  about  the  <command>  or
  317.        <option>  specified.   Specifically, the relevant portion of this
  318.        document is printed.
  319.  
  320.    Receive -- Receive a file
  321.        Receive [<option>]*
  322.  
  323.        The Receive command causes Kermit-GCOS to wait for  files  to  be
  324.        sent  from  the  local  Kermit.  The files will be created or ac-
  325.  
  326.                                  - 5 -
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.        cessed according to the current option settings, unless  overrid-
  338.        den on the command line (see Kermit Options, below).
  339.  
  340.    SENd -- Send a File
  341.        SENd [<filespec>]* [<option>]*
  342.  
  343.        A <filespec> is either the  name  of  a  file  to  send  or  "in-
  344.        deX=filename" where the file contains Kermit SENd command options
  345.        and filespecs.
  346.  
  347.             The SENd command causes Kermit-GCOS to  send  files  to  the
  348.        local  Kermit.   The  files will be sent according to the current
  349.        option settings, unless overridden on the command line or  in  an
  350.        index  file.   Kermit-GCOS  will  wait  for the number of seconds
  351.        specified in the Delay option before starting to send the  files.
  352.        This allows you time to escape back to your local Kermit and type
  353.        RECEIVE.
  354.  
  355.    SERver -- Enter Server Mode
  356.        SERver [<option>]*
  357.  
  358.        The SERver command  causes  Kermit-GCOS  to  enter  server  mode.
  359.        While  in  server  mode,  Kermit-GCOS will wait for commands from
  360.        your local Kermit.  When a command is received, it  is  executed.
  361.        Server  mode is the preferred mode of operation, although not all
  362.        local Kermits support it.  If your local Kermit  supports  server
  363.        mode, you should use it.  The use of server mode is detailed more
  364.        fully below.
  365.  
  366.    SET -- Set Kermit Options
  367.        SET [<option>]*
  368.  
  369.        The SET command causes Kermit to set its options as  you  specify
  370.        on  the  command line.  Normally, options given on a command line
  371.        apply only to that command.  A SET command causes them to  change
  372.        until a later SET command is given.
  373.  
  374.    STatus -- Print Options Status
  375.        STatus
  376.  
  377.        The STatus command causes Kermit-GCOS to print a list of the cur-
  378.        rent option settings.
  379.  
  380.  
  381. 1.2.4. Kermit Options_____________________
  382.  
  383.      The following options are recognized (default settings are shown in
  384. parentheses):
  385.  
  386.      ?
  387.      CWD=pathname
  388.      DeBug=function (Off)
  389.      Delay=nn (10)
  390.      (+|-)Discard (-)
  391.  
  392.                                  - 6 -
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.      Format=fileformat (Text)
  404.      indeX=filename
  405.      (+|-)OverWrite (-)
  406.      (+|-)Permanent (+)
  407.      (+|-)Random (-)
  408.      SendEndOfLine=nn (13)
  409.      SendStartofPacket=nn (1)
  410.      (+|-)TapeMode (+)
  411.  
  412.  
  413. Options:
  414.  
  415.    ?
  416.        causes a list of the allowed options for the command given to  be
  417.        printed.
  418.    CWD=pathname
  419.        sets the Kermit working directory  to  the  specified  path.   By
  420.        default,  your  working  directory  is  your  USERID.   It can be
  421.        changed to any catalog or subcatalog where you want files  placed
  422.        by default.
  423.    DeBug=function
  424.        specifies how much debugging information is to be written to  the
  425.        debug file "kerm*dbg".  The default is "Off", which means that no
  426.        debugging information will be written.  "States" causes the  cur-
  427.        rent  protocol  state  to  be written when it changes.  "Packets"
  428.        causes each packet sent or received to be written.  "All"  causes
  429.        all  possible  debug information to be written.  This information
  430.        is rarely useful, unless you  suspect  that  your  communications
  431.        line is noisy and wish to inspect what is being sent.
  432.    Delay=nn
  433.        causes Kermit to wait nn seconds before sending the first  packet
  434.        when using the SENd command.  The default is 10 seconds.
  435.    +Discard
  436.        causes Kermit to discard an incomplete transmission.  If you  in-
  437.        terrupt  the transmission of a file, the file will not be created
  438.        on GCOS.  If -OverWrite is in effect, the previous contents  will
  439.        be unchanged.
  440.    Format=fileformat
  441.        causes any file transferred in either direction to be treated ac-
  442.        cording  to  the  file format specified.  The formats are "Text",
  443.        "BYtestream", and "BItstream".  See the section on file  formats.
  444.        The default is Text.
  445.    indeX=filename
  446.        specifies a file containing Kermit SENd commands and options, one
  447.        command  per  line.   This  option permits sending multiple files
  448.        with a single command.  This option is analgous to the  "wildcard
  449.        send"  feature of some Kermits in that it allows transfering mul-
  450.        tiple files easily.  It was selected for Kermit-GCOS because GCOS
  451.        does  not  support  wildcard names, and allowing an index file of
  452.        names provides additional flexiblity in sending dissimilar names.
  453.        This  option  is  only  meaningful when used with the Kermit SENd
  454.        command, or from "GET" commands received in  Server  Mode.   Only
  455.        the  "Format=", +Random, +Discard, -Permanent and  +OverWrite op-
  456.        tions may be used in index files.
  457.  
  458.                                  - 7 -
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.    +OverWrite
  470.        causes an existing file of the same name to be overwritten.   The
  471.        default  is  -OverWrite,  which  causes  the  incoming file to be
  472.        renamed to avoid conflicts.  The file  is  renamed  by  appending
  473.        "_n"  to the file, where n is the smallest digit not resulting in
  474.        a clash.  If the filename is too long,  the  underscore  will  be
  475.        omitted.   If  the filename is still too long, characters will be
  476.        deleted from the end until it fits.
  477.    -Permanent
  478.        causes Kermit to use standard GCOS rules  for  creating/accessing
  479.        files.   So  if  there  are  no  slashes  or  dollar signs in the
  480.        filename and if the filename is  less  than  or  equal  to  eight
  481.        characters long, and if a quick access file of the same name does
  482.        not already exist, the file will be created as temporary.  Other-
  483.        wise  it  will  be  created  as  permanent.   If  +Permanent (the
  484.        default) is used, the file will  always  be  created/accessed  as
  485.        permanent.
  486.    +Random
  487.        causes Kermit to access the file as random.  The default  is  se-
  488.        quential,  or  -Random.   For  non-text  files,  +Random  must be
  489.        specified.
  490.    SendEndOfLine=nn
  491.        causes Kermit to terminate its outgoing packets  with  the  ASCII
  492.        character  whose decimal value is nn.  Example:  SendEndOfLine=26
  493.        would cause Kermit to terminate its outgoing packets  with  a  ^Z
  494.        (decimal  ASCII  value  =  26).   The  default is carriage return
  495.        (value = 13).
  496.    SendStartofPacket=nn
  497.        causes Kermit to  start  its  outgoing  packets  with  the  ASCII
  498.        character  whose  decimal  value  is  nn.  Example:  SendStartof-
  499.        Packet=26 would cause Kermit to start its outgoing packets with a
  500.        ^Z (decimal ASCII value = 26).  The default is ^A (value = 1).
  501.    -TapeMode
  502.        causes Kermit to use standard GCOS terminal input mode instead of
  503.        "paper  tape"  input mode to read incoming packets.  See the GCOS
  504.        Data Transfer Modes section, above, for  more  information.   The
  505.        default,  +tapemode,  must  be  used at sites where the character
  506.        delete code is "@" because Kermit requires the  ability  to  send
  507.        and receive all printable ASCII characters.
  508.  
  509.  
  510. 1.2.5. Server Mode__________________
  511.  
  512.      Kermit-GCOS server mode enables  Kermit-GCOS  to  receive  commands
  513. through packets from your local Kermit if it supports server mode.  This
  514. eliminates the need to switch back and forth between terminal  mode  and
  515. local mode each time you start a file transfer.
  516.  
  517.      In addition to the file transfer commands, GET  and  SEND,  Kermit-
  518. GCOS Server mode supports several generic commands defined in the Kermit
  519. protocol.  A short list of the commands as given in the Kermit  Protocol
  520. manual  follows.  Be warned that not all Kermits support all Server com-
  521. mands, and even if a Kermit does support a command, it may  not  be  in-
  522. voked  with the same name as another Kermit's.  For example, the "erase"
  523.  
  524.                                  - 8 -
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535. command, which releases files, is called the "remote delete" command  by
  536. Kermit-MS.   Read  the  documentation  for your microcomputer Kermit for
  537. details.
  538.  
  539. The following server commands are supported:
  540.  
  541.      CWD        - Change Working Directory
  542.      Erase      - Release a file
  543.      Finish     - Terminate Server Mode
  544.      Get        - Receive a file from GCOS
  545.      Logout     - Terminate Kermit and Disconnect from TSS
  546.      Send       - Send a file to GCOS
  547.      Status     - Query Kermit-GCOS Status
  548.      Type       - List a file.
  549.  
  550. The following descriptions of server mode commands apply to Kermit-MS.
  551.  
  552.    Bye
  553.        This command ends your GCOS session  for  you  and  in  addition,
  554.        exits Kermit.  You will then be back in MS-DOS.
  555.  
  556.    CWD
  557.        This command is used to change your working directory  (catalog).
  558.        By  default,  your working directory is your userid, so any files
  559.        that you send will be created under your userid but not under any
  560.        catalog.   Suppose  you wanted to send your files to a subcatalog
  561.        on your account called "/microfiles".  You would enter
  562.  
  563.             REMote CWD /microfiles
  564.  
  565.        in Kermit-MS, enter a RETURN to the "Password:" prompt, and  then
  566.        use the "send" command.  Any files sent would be placed under the
  567.        "/microfiles"  catalog.   Typing  "REMote CWD"  with  no  catalog
  568.        specified causes your current working catalog to be displayed.
  569.  
  570.    Erase
  571.        Erase is used to delete a file from  your  GCOS  current  working
  572.        directory.  You must enter
  573.  
  574.             REMote DELete <filename>
  575.  
  576.        to invoke this command.  Erasing multiple files with one  command
  577.        is not supported.
  578.  
  579.    Finish
  580.        This command tells Kermit-GCOS to exit server mode.  This is use-
  581.        ful  if  you  want  to resume using Kermit-MS as a terminal after
  582.        doing some file transfers.  Just enter "Finish", then  "connect",
  583.        then enter a RETURN and you will be back at star-level on GCOS.
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.                                  - 9 -
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.    Get
  602.        To download (get) a file from GCOS to the microcomputer, enter
  603.  
  604.             GET pathname
  605.  
  606.        where "pathname" specifies the GCOS file you want  to  get.   The
  607.        file  name  at  the  end of "pathname" will be used as the MS-DOS
  608.        file name.  To give the MS-DOS file a different name, enter
  609.  
  610.             GET
  611.  
  612.        Kermit-MS will prompt  for  "Remote Source File: ".   You  should
  613.        respond  with the pathname of the GCOS file.  Kermit-MS will then
  614.        prompt for "Local Destination File: ".  You should  respond  with
  615.        the  MS-DOS  name under which you wish the file to be saved.  The
  616.        remote file may be an index file.  If you type
  617.  
  618.             get index=/mylist
  619.  
  620.        this indicates that the GCOS file "/mylist" contains the names of
  621.        files to be sent.
  622.  
  623.    Logout
  624.        This command ends your GCOS session for you  but  does  not  exit
  625.        Kermit.
  626.  
  627.    Send
  628.        To upload (send) a file from Kermit-MS to Kermit-GCOS, enter
  629.  
  630.             SEND <filespec> [<GCOS filespec> [<option>]*]
  631.  
  632.        where "<filespec>" may contain  MS-DOS  wild-card  characters  to
  633.        specify more than one file.  For example,
  634.  
  635.             SEND *.txt
  636.  
  637.        will send all files that have the  extension  "txt".   Since  the
  638.        question  mark ("?") is used within Kermit-MS to obtain help, you
  639.        must use the equal sign ("=") for single-character wild-cards.
  640.  
  641.             The <GCOS filespec> may be a list  of  filenames  and  index
  642.        files (see SEND in the commands section).
  643.  
  644.    Status
  645.        This command displays the current status  of  Kermit-GCOS.   This
  646.        Server  mode  command is not currently supported by Kermit-MS, so
  647.        there is no way to invoke it.
  648.  
  649.    Type
  650.        To display the contents of a GCOS file, enter
  651.  
  652.  
  653.  
  654.  
  655.  
  656.                                  - 10 -
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.             REMote TYPE <filename>
  669.  
  670.        and the file will be printed, maddenly slowly, on your screen.
  671.  
  672.  
  673. 1.3.1. Sample Kermit Sessions_____________
  674.  
  675.      You must always begin a Kermit transfer by starting your local Ker-
  676. mit  and  setting  local options, then connecting to TSS.  The local op-
  677. tions available and how to set them will depend  on  what  computer  and
  678. version of Kermit you are using.  However, some options must be set cor-
  679. rectly before a connection can be established and before  file  transfer
  680. is  possible.   These  include  baud  rate, local end of line, and local
  681. echo.
  682.  
  683.      The following sample session with Kermit-MS and  Kermit-GCOS  down-
  684. loads (gets) a file from GCOS to MS-DOS.  The example assumes that drive
  685. "A" is your default drive and that it contains a disk with the  MSKERMIT
  686. program.   User  input  is  underlined.   The  sequence  ^]C  refers  to
  687. "control-]" followed by "C", i.e. hold the control key  down  and  press
  688. the  ]  key then release the control key and type a "C".  For other ver-
  689. sions of microcomputer Kermit, the details will be different.
  690.  
  691.      This session transfers the GCOS file "myfile" under subcatalog "my-
  692. cat"  of your logon userid to the MS-DOS file "dosfile.txt" using a 1200
  693. baud connection to a GCOS system which uses "@" as the character  delete
  694. symbol.
  695.  
  696.      A>_m_s_k_e_r_m_i_t
  697.      IBM-PC Kermit-MS V2.26
  698.      Type ? for help
  699.  
  700.      Kermit-MS>_s_e_t_ _b_a_u_d_ _1_2_0_0
  701.      Kermit-MS>_s_e_t_ _l_o_c_a_l_-_e_c_h_o_ _o_n
  702.      Kermit-MS>_s_e_t_ _e_n_d_-_o_f_-_l_i_n_e_ _1_9
  703.      Kermit-MS>_c_o_n_n_e_c_t
  704.  
  705.      [Connecting to host, type control-] C to return to PC]
  706.      RETURN______
  707.  
  708.      HIS TIME-SHARING SYSTEM  mm/dd/yy  hh.mmm  CHANNEL xxxx
  709.  
  710.      USERID- _u_s_e_r_i_d_$_p_a_s_s_w_o_r_d
  711.      *_k_e_r_m_i_t_ _s_e_r_v_e_r
  712.      Kermit-GCOS:  Version 1.0
  713.  
  714.      Entering Server Mode.
  715.      Escape back to your local KERMIT and use server commands.
  716.      To exit Server Mode, enter the FINISH command from your local KERMIT.
  717.      To exit KERMIT in an emergency, enter control-D control-S (^D^S)
  718.      _^_]_C
  719.      Kermit-MS>_g_e_t
  720.       Remote Source File: _/_m_y_c_a_t_/_m_y_f_i_l_e
  721.  
  722.                                  - 11 -
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.       Local Destination File: _d_o_s_f_i_l_e_._t_x_t
  734.  
  735.      <Here follows the file transfer>
  736.  
  737.      Kermit-MS>_b_y_e
  738.      A>
  739.  
  740.  
  741.      The next example shows the same file transfer using version 1.20 of
  742. Kermit-PC  without server mode.  This transfer is to a GCOS system which
  743. accepts "@" as character data, so it uses the -TapeMode option.
  744.  
  745.  
  746.      A>_k_e_r_m_i_t
  747.      CUCCA IBM-PC Kermit-PC  Version 1.20
  748.  
  749.      Kermit-PC>_s_e_t_ _b_a_u_d_ _1_2_0_0
  750.      Kermit-PC>_s_e_t_ _l_o_c_a_l_ _o_n
  751.      Kermit-PC>_c_o_n_n_e_c_t
  752.      [Connecting to host. Type CTRL-]C to return to PC.]
  753.  
  754.      _R_E_T_U_R_N
  755.  
  756.      HIS TIME-SHARING SYSTEM  mm/dd/yy  hh.mmm  CHANNEL xxxx
  757.  
  758.      USERID- _u_s_e_r_i_d_$_p_a_s_s_w_o_r_d
  759.      *_k_e_r_m_i_t_ _-_t_m
  760.      Kermit-GCOS:  Version 1.0
  761.      Kermit-GCOS>_s_e_n_d_ _/_m_y_c_a_t_/_m_y_f_i_l_e
  762.      Escape back to your local KERMIT and enter RECEIVE mode.
  763.      _^_]_C
  764.      Kermit-PC>_r_e_c_e_i_v_e_ _d_o_s_f_i_l_e_._t_x_t
  765.  
  766.      <Here follows the file transfer>
  767.  
  768.      Kermit-PC>_c_o_n_n_e_c_t
  769.      _R_E_T_U_R_N
  770.      *_b_y_e
  771.      <GCOS logoff summary>
  772.      _^_]_C
  773.      Kermit-PC>_e_x_i_t
  774.      A>
  775.  
  776.  
  777.      Transferring a file from your microcomputer to GCOS is similar, but
  778. you would enter a RECEIVE command for Kermit-GCOS (or place it in server
  779. mode), then escape back to your local Kermit and enter a send command.
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.                                  - 12 -
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801. 1.4.1. Bootstrapping Kermit-GCOS___________
  802.  
  803.      There are three different ways which you  may  obtain  Kermit-GCOS:
  804. through  the HLSUA library, from Columbia University, or over a telecom-
  805. munications line.
  806.  
  807.      The easiest is through the HLSUA library as  a  FILSYS  save  tape.
  808. Installation instructions accompany the tape.
  809.  
  810.      The Columbia University CUCCA  Kermit  distribution  tape  contains
  811. five files for Kermit-GCOS.  These are:
  812.  
  813.     Name       Lines   Content
  814.  
  815.     HDPS8.B     3489   B language source for Kermit-GCOS
  816.     HDPS8.DOC    924   This documentation in printable form
  817.     HDPS8.PAK   1957   Kermit-GCOS H* in packed text format
  818.     HDPS8.ROF    915   This documentation in ROFF input form
  819.     HDPS8.FTN    122   Fortran program to convert .PAK file to H*
  820.  
  821. All five files are in text format.  The first step in installing Kermit-
  822. GCOS is, of course, to copy these files from the tape to disk.
  823.  
  824.      Since the Columbia tape cannot contain a  Honeywell  random  binary
  825. file,  Kermit is provided in packed ASCII text form (HDPS8.PAK) along
  826. with a Fortran program (HDPS8.FTN) which documents the packed  format
  827. and  converts  the  packed  file  into Honeywell executable (H*) format.
  828. Create a 65 block random file to hold the H* and run the following job:
  829.  
  830.         $$t(;)
  831.         $;ident;userid,banner
  832.         $;option;fortran
  833.         $;use;.gtlit
  834.         $;fortran;ascii,xref,optz
  835.         $$select(userid/hdps8.ftn)
  836.         $;execute
  837.         $;prmfl;01,w,r,userid/kermit
  838.         $;prmfl;02,r,s,userid/hdps8.pak
  839.         $;endjob
  840.  
  841.      After this job runs, copy file "userid/kermit" to "cmdlib/kerm"  to
  842. make Kermit available through the command library.
  843.  
  844.      The packed text file contains a checksum byte  on  each  line,  and
  845. does  not contain and GRTS character delete codes (@), so it can be sent
  846. to GCOS  over  a  telecommuncations  connection  using  any  ASCII  file
  847. transfer program.  The installation process for generating an H* file is
  848. the same as described above.  The program will print warning messages if
  849. any checksum errors are encountered.
  850.  
  851.  
  852.  
  853.  
  854.                                  - 13 -
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865. 1.4.2. Setting Local Options______________
  866.  
  867.      Kermit-GCOS contains three flags to enable setting  local  options.
  868. As  distributed,  all  three  flags  are  set to false.  The flags allow
  869. setting the default working directory to the current TSS working  direc-
  870. tory  instead  of  the  USERID when entering Kermit, enabling the server
  871. command for remote directory, and enabling the server command for remote
  872. space  information.  You should enable remote directory only if you have
  873. the LC command which is distributed with the B language package  written
  874. at  the University of Waterloo.  You should enable the remote space com-
  875. mand only if you have replaced the standard Honeywell SMCL command  with
  876. a   version  which  permits  directing  output  to  a  file  with  "SMCL
  877. >filename".  You should enable the working directory switch only if your
  878. site has enabled the Honeywell TSS working directory feature.  Note that
  879. Kermit working directories can be used regardless of the setting of this
  880. switch-- it controls only the default working directory on entry to Ker-
  881. mit.
  882.  
  883.      After running HDPS8.FTN to convert the Kermit packed text file  into
  884. an  H*,  you  can  use  LODX to modify the flag locations to match local
  885. capabilities.  The flag addresses are
  886.  
  887.     Address (Octal)     Content
  888.       000153              wat_lc
  889.       000154              wat_smcl
  890.       000155              wat_cwd
  891.  
  892. All values are initially false (zero).  The  following  example  enables
  893. remote directory and working directory initialization.
  894.  
  895.     *_l_o_d_x_ _/_k_e_r_m_i_t
  896.     patch, save or run? _p
  897.     ?_1_5_3_ _1
  898.     ?_1_5_5_ _1
  899.     ?_<_r_e_t_u_r_n_>
  900.     patch, save or run? _s
  901.     patch, save or run?_<_r_e_t_u_r_n_>
  902.     *
  903.  
  904.      These values are declared at the beginning of the EXTRN section  of
  905. the  B  source code.  You can adjust the settings for your site there if
  906. you recompile the source code.
  907.  
  908.      Note that the user documentation describes Kermit with the  default
  909. (false)  settings  for  all  three  switches.  That is, it does not list
  910. REMOTE DIRECTORY and REMOTE SPACE  as  available  server  commands,  and
  911. states  that  the  working directory is initially set to the USERID.  If
  912. you modify these flags, update the documentation.
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.                                  - 14 -
  921.  
  922.  
  923.  
  924.  
  925.