home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / d / mt2ker.doc < prev    next >
Text File  |  2020-01-01  |  38KB  |  673 lines

  1. :
  2. 1
  3. -
  4.                    THE UNIVERSITY OF BRITISH COLUMBIA
  5.                          6356 Agricultural Road
  6.                     Vancouver, B.C., Canada  V6T 1W5
  7. -
  8. 0    Computing Centre                    Name    : UBC KERMIT
  9.                                          Date    : April 1984
  10.                                          Revised : September 10, 1984
  11. -                              MTS_KERMIT
  12. +                              ___ ______
  13. -
  14.      Bruce Jolliffe                                  Computing Centre
  15. -                           Table_of_Contents
  16. +                           _____ __ ________
  17. -    1. INTRODUCTION ...............................................1
  18. 0    2. USING KERMIT WITH A MICROCOMPUTER ..........................1
  19.         a. File Transfers With MTS Server Kermit ...................2
  20.         b. File Transfers With MTS User Kermit .....................3
  21. 0    3. USING KERMIT BETWEEN MTS SITES .............................4
  22. 0    4. NOTATION ...................................................4
  23. 0    5. MTS KERMIT COMMANDS ........................................5
  24. 0    6. MTS SET OPTIONS ............................................6
  25. 0    7. APPLE KERMIT ...............................................9
  26. 0    8. APPLE SET OPTIONS .........................................10
  27. 0    9. IBM PC KERMIT .............................................12
  28. 0   10. VICTOR KERMIT .............................................12
  29. 0   11. VICTOR SET OPTIONS ........................................14
  30. :
  31. 1                                                          UBC KERMIT
  32.                                                                     1
  33. -    1. INTRODUCTION
  34. +       ____________
  35. 0       Kermit provides a mechanism for the exchange of data  between
  36.         two  like  or  unlike  computers  over  standard telephone or
  37.         computer network communication lines. The microcomputer  uses
  38.         its  RS-232  serial  communications  port  for  the transfer.
  39.         Cooperating Kermits are started on each machine and  data  is
  40.         transferred  between  these  programs  using a communications
  41.         protocol. The protocol  provides  a  mechanism  whereby  data
  42.         integrity  can  be guaranteed. Kermit breaks the data up into
  43.         packets, appends a checksum to the packets and sends them off
  44.         to the other Kermit. If the other Kermit  is  satisfied  that
  45.         the  data  has  not  been  corrupted  during  transmission it
  46.         returns a positive acknowledgement.  If  the  data  has  been
  47.         damaged  then  it  returns  a negative acknowlegement and the
  48.         packet  is   retransmitted.   This   mechanism   allows   the
  49.         transmission  of  data  over relatively noisy lines with some
  50.         assurance of data quality.
  51. 0       The Kermit protocol allows the  transmission  of  both  ASCII
  52.         text  and  binary files over any network that will accept the
  53.         printable ASCII characters. In the case of binary files,  any
  54.         characters  that are non-printable are encoded into printable
  55.         characters and decoded at the other end by the other Kermit.
  56. 0       MTS Kermit can be used to send files between MTS and  another
  57.         computer  that  has  Kermit. When the two cooperating Kermits
  58.         are on MTS hosts an exact image of the MTS file including its
  59.         line numbers will be transmitted.
  60. 0    2. USING_KERMIT_WITH_A_MICROCOMPUTER
  61. +       _____ ______ ____ _ _____________
  62. 0       The microcomputer Kermit programs combine a terminal emulator
  63.         with with the Kermit file transfer mechanism. When you  start
  64.         a  microcomputer Kermit it will display a prompt 'Kermit-xx>'
  65.         where 'xx'  will  be  some  number  or  name  indicating  the
  66.         microcomputer  being  used.  In  the  case of the IBM PC this
  67.         number is '86' indicating that  the  microcomputer  uses  the
  68.         8086 family of microprocessors.
  69. 0       After  the  Kermit  prompt  is  displayed  set  any necessary
  70.         parameters such as baud rates (usually 300 or  1200),  parity
  71.         (none),    and   possibly   other   microcomputer   dependant
  72.         parameters. Then enter CONNECT to establish a connection with
  73.         the mainframe. If you are using a dial-up modem then you will
  74.         have to establish contact with MTS by either manually dialing
  75.         MTS or by entering a command that will cause  your  modem  to
  76.         dial MTS.
  77. 0       When  the  connection  has  been  made the UBCNet logo should
  78.         appear on the screen and you can choose the system  you  wish
  79.         to  call  (usually  G or I). If you want to take advantage of
  80.         the particular terminal emulation properties of your  Kermit,
  81.         such   as  VT52  emulation  then  enter  the  device  command
  82.         '%Device=VT52' or whatever device name is  appropriate.  This
  83.         will  tell the NIM what type of device it is talking to. Next
  84. 1    UBC KERMIT
  85.      2
  86. -       you should signon to MTS. Once you are signed on you can  use
  87.         MTS as you would from any terminal.
  88. 0       All   microcomputer   Kermits   have   an   "escape  back  to
  89.         micromputer" sequence. Typically  this  is  the  sequence  of
  90.         keystrokes  'Ctrl-C'. This sequence is used to return to the
  91.         microcomputer Kermit command mode.  You  can  return  to  the
  92.         local  microcomputer  operating system by entering the Kermit
  93.         command EXIT. Remember  that  escaping  back  to  your  local
  94.         microcomputer  does  not  sign you off. You must reconnect to
  95.         the mainframe and issue '$signoff' to signoff.
  96. 0       a. File_Transfers_With_MTS_Server_Kermit
  97. +          ____ _________ ____ ___ ______ ______
  98. 0          To transfer files between the your microcomputer  and  MTS
  99.            you must start Kermit on MTS. To start Kermit enter:
  100. 0             $Run Net:Kermit
  101. 0          Kermit will start in user mode and respond with the prompt
  102.            "Kermit-UBC...>".  If your Kermit is capable of talking to
  103.            a  server  Kermit  (see   the   individual   microcomputer
  104.            descriptions) enter:
  105. 0             SERVER
  106. 0          If  you  cannot  talk  to  a  server  Kermit  see the next
  107.            subsection.
  108. 0          At this point you are ready to transfer files. Escape back
  109.            to your local microcomputer Kermit ('Ctrl-C'). The  local
  110.            computer  Kermit  prompt  (Kermit-xx>)  will appear on the
  111.            screen. If you wish to send a file from the micromputer to
  112.            MTS enter:
  113. 0             SEND  filename
  114. 0          where 'filename' is the name of the local filename  to  be
  115.            sent  to  MTS.  A file by that name will be created on MTS
  116.            and the data from local file will be placed into  the  MTS
  117.            file.  If  the file already exists on MTS the file will be
  118.            emptied before the transfer begins.  To  transfer  a  file
  119.            from MTS to the microcomputer enter one of:
  120. 0             GET  filename
  121. 0          or
  122. 0             RECEIVE  filename
  123. 0          where  'filename'  is  the  name  of  the  MTS  file to be
  124.            transferred to the microcomputer. See the section  on  the
  125.            relevant microcomputer for which command to use.
  126. 0          While the file is being transferred the microcomputer will
  127.            display  the  number  of packets transferred and any error
  128. 1                                                          UBC KERMIT
  129.                                                                     3
  130. -          conditions that  might  arise.  After  you  have  finished
  131.            transferring  files  to  and  from the microcomputer enter
  132.            FINISH to shut down the MTS Kermit server.  You  can  then
  133.            enter CONNECT and resume your MTS terminal session.
  134. 0       b. File_Transfers_With_MTS_User_Kermit
  135. +          ____ _________ ____ ___ ____ ______
  136. 0          If  your Kermit is incapable of talking to a server Kermit
  137.            follow the procedures in this section. As described in the
  138.            last section start MTS Kermit by entering the command:
  139. 0             $Run Net:Kermit
  140. 0          This  will   start   Kermit   in   user   mode   and   the
  141.            "Kermit-UBC..>"  will  appear. To transfer a file from the
  142.            microcomputer to MTS enter the command:
  143. 0             RECEIVE  mts_filename
  144. 0          where 'mts_filename' is the name of the file  to  be  used
  145.            for  the  data  transferred  from  the  microcomputer. Now
  146.            escape back to the microcomputer ('Ctrl-C') and enter the
  147.            command:
  148. 0             SEND  micro_filename
  149. 0          where 'micro_file' is the name of the  microcomputer  file
  150.            that  is to be transferred to MTS. After the file has been
  151.            sent enter the  CONNECT  command  to  return  to  the  MTS
  152.            terminal  session.  At this point you will still be in MTS
  153.            Kermit. Enter STOP to exit from MTS Kermit.
  154. 0          To transfer a file from MTS to the microcomputer start MTS
  155.            Kermit in user mode as described above and then enter  the
  156.            command
  157. 0             SEND  mts_filename  micro_filename
  158. 0          where  'mts_filename'  is the name of the MTS file that is
  159.            to be transferred and 'micro_filename' is the name of  the
  160.            file  on the microcomputer that the transferred data is to
  161.            be  placed.  Now  escape   back   to   the   microcomputer
  162.            ('Ctrl-C') and enter the command:
  163. 0             RECEIVE
  164. 0          There  will  be some delay and then the file transfer will
  165.            begin. The delay is to allow you time to enter the RECEIVE
  166.            command. The SET DELAY command can be used when in the MTS
  167.            Kermit to change this value. Once  the  file  transfer  is
  168.            complete  you  can  return  to  the  terminal  session  by
  169.            entering the CONNECT command. At this point you will be in
  170.            MTS Kermit. You can enter STOP  to  quit  MTS  Kermit  and
  171.            return to MTS.
  172. 1    UBC KERMIT
  173.      4
  174. -    3. USING_KERMIT_BETWEEN_MTS_SITES
  175. +       _____ ______ _______ ___ _____
  176. 0       If MTS Kermit is installed at a remote site then files may be
  177.         easily  sent  to  or  gotten  from  the remote site using the
  178.         standard Net:Call program. Kermit is invoked in  Net:Call  by
  179.         issuing  the  /Kermit  command.  This  command  will start up
  180.         Kermit at the local site and attempt to start  up  Kermit  at
  181.         the  remote  site.  A  banner line will be printed and Kermit
  182.         will be ready to accept commands as  described  in  the  "MTS
  183.         Kermit"  section.  If Kermit is unable to start up the remote
  184.         Kermit a message to that effect will  be  printed.  Currently
  185.         remote  MTS  Kermit  sites  include  Simon  Fraser University
  186.         (SFU),  University  of  Alberta  (UQV),  and  University   of
  187.         Michigan (UM).
  188. 0       Kermit may be batched by using the net call command:
  189. 0          /Kermit input=Kermit_Commands
  190. 0       where 'Kermit_Commands' is a file containing a list of Kermit
  191.         commands.  It  is  also  a  good  idea  to  include  a /Delay
  192.         statement before the /Kermit command so that things are given
  193.         a chance to settle down before the Kermit program is started.
  194.         The following is an example of a batch job  to  grab  a  file
  195.         from a remote site.
  196. 0             1   sig ccid
  197.               2   password
  198.               3   $Mount Net *MERIT* Dest=Telenet-31300062
  199.               4   $Run Net:Call 0=*merit* par=/input *source*
  200.               5   um
  201.               6   sig wubc
  202.               7   password
  203.               8   /delay 10
  204.               9   /kermit input=kermit.move(1000)
  205.              10   sig $
  206.              11   $endfile
  207.              12
  208.            1000   get remotefile localfile
  209.            1001   stop
  210. -
  211.      4. NOTATION
  212. +       ________
  213. 0       The  following  notation is used in the command descriptions.
  214.         Items in UPPER CASE letters are what is to be entered.  Items
  215.         in  lower  case  letters  are generic terms and what is to be
  216.         entered is given in the description  of  the  command.  Items
  217.         appearing  with  in square braces ('' and '') are optional.
  218.         Items of the form 'a!b' mean that you  must  choose  either
  219.         'a' or 'b'.
  220. 1                                                          UBC KERMIT
  221.                                                                     5
  222. -    5. MTS_KERMIT_COMMANDS
  223. +       ___ ______ ________
  224. 0       In  this  section  the  commands  available to MTS Kermit are
  225.         given.
  226. 0           BYE
  227. 0             A synonym for STOP.
  228. 0           EXIT
  229. 0             A synonym for STOP.
  230. 0           FINISH
  231. 0             This command  stops  a  remote  server  Kermit  without
  232.               stopping the local Kermit.
  233. 0           GET  remote_filename  local_filename
  234. 0             The  'remote_filename'  is  a file at the remote Kermit
  235.               that is to be  copied  to  the  local  system.  If  the
  236.               optional 'local_filename' is specified the file will be
  237.               placed  into  the  local  file having that name. If the
  238.               optional  parameter   is   not   specified   then   the
  239.               'remote_filename'  will  be  used.  If  the  local file
  240.               doesn't exist it is created and if it already exists it
  241.               is emptied before the text  from  the  remote  file  is
  242.               added.  If Kermit is unable to open the local file then
  243.               the incoming file will be placed in  the  scratch  file
  244.               -KERMIT.  This  command  is  only  applicable  when the
  245.               remote Kermit is a Server Kermit. In MTS  to  MTS  file
  246.               transfer the remote Kermit will be a Server Kermit.
  247. 0           HELP
  248. 0             This command invokes the Kermit help server.
  249. 0           QUIT
  250. 0             A synonym for STOP.
  251. 0           RECEIVE  local_filename
  252. 0             This  command  is  used when MTS Kermit is in user mode
  253.               talking to another Kermit in user mode.  In  that  case
  254.               file  transfer  is a two step process. If MTS Kermit is
  255.               the local Kermit, that is, it established a  connection
  256.               with the other Kermit using either the SET LINE command
  257.               or  the  NET:CALL  command /Kermit then the steps given
  258.               below apply. If MTS Kermit is the remote  Kermit,  that
  259.               is,  the  other  Kermit  is  a  microcomputer Kermit or
  260.               another mainframe Kermit  made  a  connection  to  this
  261.               Kermit  then  the  procedures  given  in the subsection
  262.               "File  Transfers  With  MTS  User  Kermit"  should   be
  263.               followed.
  264. 1    UBC KERMIT
  265.      6
  266. -
  267.               First  the  SEND command is issued by the remote Kermit
  268.               and the user escapes back to MTS Kermit. The user  then
  269.               issues  a  RECEIVE  command and the file is transferred
  270.               after a short DELAY.
  271. 0           SEND  local_filename  remote_filename
  272. 0             The 'local_filename' is sent to the remote  Kermit.  If
  273.               the second parameter 'remote_filename' is specified the
  274.               file  will  be  sent  to  the  file by that name at the
  275.               remote location. If the second parameter is  not  given
  276.               then the file will be sent to the file by the same name
  277.               as the 'local_filename' at the remote location.
  278. 0           SERVER
  279. 0             This command puts Kermit into Server mode. In this mode
  280.               the  user  must  escape to the other Kermit and talk to
  281.               this  Kermit  through  the   other   Kermit.   When   a
  282.               "$Run Net:Kermit"  is issued on MTS the Kermit comes up
  283.               in server mode. If the user specifies "Par=u" then  the
  284.               Kermit will come up in user mode.
  285. 0           SET  set_option
  286. 0             This  command  is  used  to  set various options. It is
  287.               covered in a separate section 'MTS Set Options'.
  288. 0           SHOW  show_option
  289. 0             This command is used to display any of the options that
  290.               can be set by the SET command. See the section on  "MTS
  291.               Set Options" for further details.
  292. 0           STOP
  293. 0             This  command  stops  the  local  Kermit  and  if it is
  294.               talking to a remote MTS server Kermit it also stops it.
  295.               Synonyms for this command are 'Bye', 'Exit' and 'Quit'.
  296. 0           $MTS_Command
  297. 0             This  passes  the  'MTS_Command'  to  the   local   MTS
  298.               operating system.
  299. 0    6. MTS_SET_OPTIONS
  300. +       ___ ___ _______
  301. 0       There  are  a  number of set options. The options given below
  302.         are set by issuing the SET command followed  by  the  option.
  303.         The  value  of  the  option  can be found by issuing the SHOW
  304.         command and the name of the option.
  305. 1                                                          UBC KERMIT
  306.                                                                     7
  307. -           BINARY-BLOCKSIZE  n
  308. 0             This option sets the number of  bytes  that  should  be
  309.               used  per  line  when a binary file is received by MTS.
  310.               The default is 64 bytes but this value can  be  set  to
  311.               any 'n' in the range 1 to 32,767.
  312. 0           DEBUG  OFF!ON
  313. 0             This  option  is  primarily  for  those  in  charge  of
  314.               maintaining  MTS   Kermit.   It   causes   the   packet
  315.               transmission  to be logged on a file KERMIT.LOG. If for
  316.               some reason this file is unavailable -KER.LOG  will  be
  317.               used.  If  the Kermit is talking to a remote MTS Kermit
  318.               then logging will also be done at the remote site.
  319. 0           DELAY
  320. 0             This option is used to control the amount of  time  the
  321.               SEND  command  waits  after it is issued before sending
  322.               the first packet. This  is  to  accommodate  non-server
  323.               remote  Kermits.  When both Kermits are running in user
  324.               mode and a file is to be sent from  MTS  to  the  other
  325.               Kermit  the user must issue a SEND from the MTS Kermit,
  326.               escape back to his local Kermit and  issue  a  RECEIVE.
  327.               The  delay  gives  him a chance to do this. The default
  328.               delay is 10 seconds. If MTS Kermit knows it is  talking
  329.               to  another  remote MTS server Kermit the delay will be
  330.               zero.
  331. 0           FILETYPE  TEXT!BINARY!MTS-BINARY
  332. 0             Files can be sent in one of three modes, text,  binary,
  333.               and   MTS-binary.  The  default  mode  for  talking  to
  334.               microcomputers is text. In this mode MTS Kermit expects
  335.               the remote Kermit to send each  line  of  the  file  in
  336.               ASCII  with  a  carriage  return  (CR)  line  feed (LF)
  337.               separating  each  line.  The  MTS   Kermit   translates
  338.               incoming   lines   into  their  equivalent  MTS  EBCDIC
  339.               characters using the ASCII to MTS EBCDIC system tables.
  340.               For outgoing files the MTS EBCDIC to ASCII  translation
  341.               table  is  applied and an ASCII CRLF is appended to the
  342.               end of each line.
  343. 0             In binary mode CRLF are not treated in any special way.
  344.               Binary mode results in an exact image on a byte by byte
  345.               basis of the file. No translation is done from ASCII to
  346.               MTS   EBCDIC   or   vice   versa.   The   SET    option
  347.               'BINARY-BLOCKSIZE'  can  be  used  to set the number of
  348.               bytes to store in each line of an incoming binary file.
  349.               No CRLF's are inserted into the text of outgoing binary
  350.               files. Binary is useful for moving object code from one
  351.               machine to the other. Of course  if  the  machines  are
  352.               incompatiable   the   binary   code  will  probably  be
  353.               uninteligiable on the other machine. Still  the  remote
  354.               machine can be used for storage and the like.
  355. 1    UBC KERMIT
  356.      8
  357. -
  358.               The MTS-binary mode makes sense only between two remote
  359.               MTS  Kermit  sites. In this mode, as in binary mode, no
  360.               translation takes place on  route  between  sites.  The
  361.               MTS-binary  differs  in  that  the new transferred file
  362.               retains the line numbering  and  line  lengths  of  the
  363.               original  file.  It  also tries to create a file at the
  364.               remote site as close as possible to the original  file.
  365.               It  creates  a  file  of  the same type, either line or
  366.               sequential having the same minsize as the original. The
  367.               Nosave status and Pkey are also retained. The resulting
  368.               file is essentially 'Duplicated'.  The  only  attribute
  369.               that  is  not  duplicated  is  the permit status of the
  370.               file. This mode is not  part  of  the  original  Kermit
  371.               protocol but is implemented as an added layer on top of
  372.               the binary mode.
  373. 0           NOTIFY  n
  374. 0             When  MTS  Kermit  is  sending  or receiving packets it
  375.               prints a  count  of  the  number  of  packets  sent  or
  376.               received.  The  notify  option can be used to determine
  377.               the frequency at which this  count  is  displayed.  The
  378.               default is every 20 packets.
  379. 0           LINE  *n*
  380. 0             This  command  is  used  to  connect Kermit to a remote
  381.               site. The psuedo device name *n* should  be  a  mounted
  382.               network  connection  to the remote site that the Kermit
  383.               is to talk to. The remote connection can  alternatively
  384.               be indicated by assigning a remote connection to unit 0
  385.               when  Kermit is started. Note that in the case of using
  386.               Kermit   within   Net:Call,   the    /Kermit    command
  387.               automatically assigns the remote connection to Kermit.
  388. 0           RECEIVE  Receive_Parameter  n
  389. 0             This  command  can  be  used  to  adjust  some  of  the
  390.               characteristics of the Kermit protocol  to  accommodate
  391.               non-standard  Kermits.  The Receive parameters are used
  392.               to set the values you expect incoming packets to  have.
  393.               The   Receive  parameters  should  be  from  the  list:
  394.               END-OF-LINE, PACKET-LENGTH,  PADDING,  PADCHAR,  QUOTE,
  395.               START-OF-PACKET,  and TIMEOUT. The 'n' parameter should
  396.               be an integer. In cases where a character  is  required
  397.               such   as  END-OF-LINE,  this  number  is  the  decimal
  398.               equivalent of the ASCII character.
  399. 0           SEND  Send_Parameter  n
  400. 0             This  command  can  be  used  to  adjust  some  of  the
  401.               characteristics  of  the Kermit protocol to accommodate
  402.               non-standard Kermits. The Send parameters are  used  to
  403.               set the values you expect outgoing packets to have. The
  404.               Send  parameters  should be from the list: END-OF-LINE,
  405. 1                                                          UBC KERMIT
  406.                                                                     9
  407. -             PACKET-LENGTH,      PADDING,      PADCHAR,       QUOTE,
  408.               START-OF-PACKET,  and TIMEOUT. The 'n' parameter should
  409.               be an integer.In cases where a  character  is  required
  410.               such   as  END-OF-LINE,  this  number  is  the  decimal
  411.               equivalent of the ASCII character.
  412. 0    7. APPLE_KERMIT
  413. +       _____ ______
  414. 0       Apple Kermit (Kermit-65) can be used to emulate a VT52 and to
  415.         transfer files between the Apple II and MTS. A  list  of  the
  416.         Apple Kermit commands follows. In the commands below the term
  417.         remote Kermit means the other Kermit that the Apple Kermit is
  418.         talking  to. In most cases this will be MTS Kermit. The Apple
  419.         Kermit can talk to a Server Kermit so  to  use  it  with  MTS
  420.         follow the directions given in the subsection "File Transfers
  421.         With  MTS  Server  Kermit".  Also  see  "FILE-BYTE-SIZE"  and
  422.         "FILE-TYPE" in "Apple Set Options".
  423. 0       The Apple Kermit is available in the public file  KER:APPLEK.
  424.         If  you  already  have  MCP  AMIE  then you can %TELECOPY, in
  425.         binary, the program to your Apple. Apple Kermit  is  also  on
  426.         the  MCP  AMIE  floppy  discs  that  are  available  from the
  427.         Computing Centre Reception area.
  428. 0           BYE
  429. 0             This command tells the remote server Kermit to stop and
  430.               to sign you off. When  this  is  done  it  stops  Apple
  431.               Kermit and returns you to DOS.
  432. 0           CONNECT
  433. 0             This  command  starts  Apple  Kermit terminal emulation
  434.               mode.
  435. 0           EXIT
  436. 0             This command stops Apple Kermit and you are returned to
  437.               DOS.
  438. 0           FINISH
  439. 0             This command stops a remote server Kermit.
  440. 0           GET  remote_filename
  441. 0             This commands is  used  to  transfer  the  remote  file
  442.               'remote_filename'  from  a  Server Kermit to the Apple.
  443.               The file will be placed into a file with the same  name
  444.               on the Apple.
  445. 0           QUIT
  446. 0             A synonym for EXIT.
  447. 1    UBC KERMIT
  448.      10
  449. -           RECIEVE  local_filename
  450. 0             The  receive  command  is  used  when  Apple  Kermit is
  451.               talking to another Kermit in user mode and a file is to
  452.               be transferred from the remote user Kermit to the Apple
  453.               Kermit.  If  a  'local_filename'  is  given  then   the
  454.               incoming  file  will  be  placed into that file, if not
  455.               then the incoming filename will be used.
  456. 0           SEND  filename
  457. 0             The file with given 'filename'  will  be  sent  to  the
  458.               other remote Kermit. This command can be used with both
  459.               remote User and remote Server Kermits.
  460. 0           SET  set_option
  461. 0             This  command  is  used  to  set  various options. More
  462.               details  may  be  found  in  the  section  'Apple   Set
  463.               Options'.
  464. 0           SHOW  show_option
  465. 0             This  command is used to display the current setting of
  466.               any settable option. See  the  section  on  "Apple  Set
  467.               Options" for further details.
  468. 0           STATUS
  469. 0             This  command  is  used  display some statistics on the
  470.               file transfer. This includes counts of  the  number  of
  471.               characters sent.
  472. 0    8. APPLE_SET_OPTIONS
  473. +       _____ ___ _______
  474. 0       There  are  a  number  of  options  that  may be set in Apple
  475.         Kermit. The options are set by entering SET followed  by  the
  476.         keyword  and  value  given  below.  The  current value of any
  477.         settable option can be found by entering SHOW followed by the
  478.         name of the option.
  479. 0           DEBUGGING  OFF!TERSE!VERBOSE
  480. 0             If TERSE or VERBOSE is given then a copy of each packet
  481.               is displayed on the screen.
  482. 0           DEVICE-DRIVER  device
  483. 0             This  option  is  used  to  tell  Apple   Kermit   what
  484.               communications  device  is  being used. 'device' may be
  485.               one  of  APPLE-COM-CARD  (Apple  Communications  Card),
  486.               DC-HAYES  (D.C. Hayes Micromodem II), or SUPER-SER-CARD
  487.               (Apple Super Serial Card).
  488. 1                                                          UBC KERMIT
  489.                                                                    11
  490. -           EIGHT-BIT-QUOTING ON!OFF
  491. 0             This option sets  eight-bit-quoting  on  or  off.  This
  492.               option can be used when talking to another Apple Kermit
  493.               though  a  connection that only allows seven bits to be
  494.               sent.
  495. 0           ESCAPE  hex_value
  496. 0             This  option  resets  the  escape  character   to   the
  497.               'hex_value' given. 'hex_value' is a pair of hexadecimal
  498.               digits.
  499. 0           FILE-BYTE-SIZE  size
  500. 0             'size'  should  be set to SEVEN if text files are to be
  501.               transferred and 'EIGHT'  if  binary  files  are  to  be
  502.               transferred.
  503. 0           FILE-TYPE  type
  504. 0             This option sets the filetype begin transferred. 'type'
  505.               is   one   of  APPLESOFT,  BINARY,  INTEGER,  or  TEXT.
  506.               APPLESOFT and INTEGER  are  flavours  of  Basic  files,
  507.               BINARY  is a core image (use eight-bit file-byte-size),
  508.               and  TEXT  is  ASCII  (use  seven-bit   file-byte-size,
  509.               received characters will be written in negative ASCII).
  510. 0           FILE-WARNING  ON!OFF
  511. 0             If  FILE-WARNING  is ON then any incoming file with the
  512.               same name as an already existing file, say x,  will  be
  513.               put  into  a  different  file  with  a  with  the  name
  514.               'x.version' where version is an integer chosen to  make
  515.               the  name  unique.  If  FILE-WARNING  is  OFF  then any
  516.               incoming file will replace any  existing  file  by  the
  517.               same name.
  518. 0           IBM  ON!OFF
  519. 0             Allows  transfer to IBM hosts that require XON (Ctrl-Q)
  520.               to "turn the line around". This option also sets parity
  521.               to mark and turns local echo on.  This  option  is  NOT
  522.               applicable to MTS hosts.
  523. 0           LOCAL-ECHO  ON!OFF
  524. 0             Specifies  whether  or  not  characters  entered during
  525.               terminal emulation mode should be echoed. Normally this
  526.               is OFF since the host will echo all characters entered.
  527. 0           PARITY  type
  528. 0             'type' is one of NONE (default,  eight  data  bits,  no
  529.               parity), MARK (seven data bits, parity bit set to one),
  530.               SPACE  (seven  data  bits with parity bit set to zero),
  531. 1    UBC KERMIT
  532.      12
  533. -             EVEN (seven data  bits,  parity  set  to  make  overall
  534.               parity  even), ODD (seven data bits, parity set to make
  535.               overall parity odd).
  536. 0           RECEIVE  receive_parameter  nn
  537. 0             This  command  can  be  used  to  adjust  some  of  the
  538.               characteristics  of  the Kermit protocol to accommodate
  539.               non-standard Kermits. The receive parameters  are  used
  540.               to  set the values you expect incoming packets to have.
  541.               The  receive  parameters  should  be  from  the   list:
  542.               EIGHT-BIT-QUOTE-CHAR,    END-OF-LINE,    PACKET-LENGTH,
  543.               PAD-CHAR, PADDING, QUOTE-CHAR, and  TIMEOUT.  The  'nn'
  544.               parameter should be a pair hexadecimal of digits.
  545. 0           SEND  send_parameter  nn
  546. 0             This  command  can  be  used  to  adjust  some  of  the
  547.               characteristics of the Kermit protocol  to  accommodate
  548.               non-standard  Kermits.  The send parameters are used to
  549.               set the values you expect outgoing packets to have. The
  550.               send   parameters   should   be    from    the    list:
  551.               EIGHT-BIT-QUOTE-CHAR,    END-OF-LINE,    PACKET-LENGTH,
  552.               PAD-CHAR, PADDING, QUOTE-CHAR, and  TIMEOUT.  The  'nn'
  553.               parameter should be a pair of hexadecimal digits.
  554. 0           SLOT  n
  555. 0             'n' is the slot number in which the communications card
  556.               has been placed. The default is 2.
  557. 0           VT52-EMULATION  ON!OFF
  558. 0             Tells Kermit whether or not to act like a VT52 terminal
  559.               when in terminal emulation mode (CONNECTed).
  560. 0    9. IBM_PC_KERMIT
  561. +       ___ __ ______
  562. 0       PC  Kermit  can  be  used  to  emulate a VT52 terminal and to
  563.         transfer  files  between  MTS  and  an   IBM   PC.   Detailed
  564.         documentation  may be found in the file KER:MSKERMIT.DOC. The
  565.         IBM PC Kermit can talk to  a  Server  Kermit  so  you  should
  566.         follow the directions given in the subsection "File Transfers
  567.         With MTS Server Kermit".
  568. 0       PC  Kermit  is available in the public file KER:PCKERMIT.EXE.
  569.         If you  already  have  MCP  WINDOW  then  this  file  can  be
  570.         %TELECOPIED in binary to your PC.
  571. 0   10. VICTOR_KERMIT
  572. +       ______ ______
  573. 0       The Victor Kermit commands are given below. The Victor Kermit
  574.         does not seem to recognize 'Alt-' as the start of the escape
  575.         back to microcomputer sequence. To be able to escape back use
  576.         'SET  ESCAPE  char' to set 'char' to some printable character
  577.         you don't expect to use during a terminal session.
  578. 1                                                          UBC KERMIT
  579.                                                                    13
  580. -
  581.         MS-DOS  Victor  Kermit  is  available  in  the  public   file
  582.         KER:VICKER.EXE. If you already have MCP WINDOW then this file
  583.         can be %TELECOPIED in binary to your PC.
  584. 0           BYE
  585. 0             This command tells the remote server Kermit to stop and
  586.               to  sign  you  off.  When  this is done it stops Victor
  587.               Kermit and returns you to DOS.
  588. 0           CONNECT
  589. 0             This commands starts Victor Kermit  terminal  emulation
  590.               mode.
  591. 0           EXIT
  592. 0             This  command  stops Victor Kermit and you are returned
  593.               to DOS.
  594. 0           FINISH
  595. 0             This command stops a remote server Kermit.
  596. 0           LOGOUT
  597. 0             This command tells the remote server Kermit to stop and
  598.               to sign you off. When this is done  it  leaves  you  in
  599.               Victor Kermit.
  600. 0           RECEIVE remote_filename
  601. 0             The  receive  command gets a file from a remote Kermit.
  602.               If 'remote_filename' is  specified  the  Victor  Kermit
  603.               assumes  you  are  talking  to a Server Kermit and will
  604.               transfer the file  'remote_filename'  from  the  remote
  605.               Kermit and place it into a local file by the same name.
  606. 0           SEND  filename
  607. 0             The  file  with  given  'filename'  will be sent to the
  608.               other remote Kermit.
  609. 0           SET  set_option
  610. 0             This command is  used  to  set  various  options.  More
  611.               details  may  be  found  in  the  section  "Victor  Set
  612.               Options".
  613. 0           SHOW  show_option
  614. 0             This command is used to display the current setting  of
  615.               any  settable  option.  See  the section on "Victor Set
  616.               Options" for further details.
  617. 1    UBC KERMIT
  618.      14
  619. -           STATUS
  620. 0             This command is used display  some  statistics  on  the
  621.               file transfer.
  622. 0   11. VICTOR_SET_OPTIONS
  623. +       ______ ___ _______
  624. 0       There  are  a  number  of  options  that may be set in Victor
  625.         Kermit. The options are set by entering SET followed  by  the
  626.         keyword  and  value  given  below.  The  current value of any
  627.         settable option can be found by entering SHOW followed by the
  628.         name of the option.
  629. 0           BACKARROW  BACKSPACE!DELETE
  630. 0             This option determines which value  will  be  sent  the
  631.               host  when a backarrow is entered in terminal emulation
  632.               mode.
  633. 0           BAUD  speed
  634. 0             Set the terminal speed to use. 'speed' may  be  one  of
  635.               the numbers 300, 1200, 1800, 4800 (default) or 9600.
  636. 0           BELL  ON!OFF
  637. 0             Set the bell so that it rings after a file transfer.
  638. 0           DEBUG  ON!OFF
  639. 0             If  DEBUG  is  ON  packets  are  displayed  during file
  640.               transfer.
  641. 0           END-OF-LINE  n
  642. 0             Resets the end-of-line character to the decimal  number
  643.               'n'. The number must be between 0 and 31.
  644. 0           ESCAPE  char
  645. 0             Change the escape character from the default 'Ctrl-'.
  646. 0           FILE-WARNING  ON!OFF
  647. 0             If  FILE-WARNING  is ON Victor Kermit and Victor Kermit
  648.               receives a file by the same name as an already existing
  649.               file, then it will warn you and put the  incoming  file
  650.               into a file with another name.
  651. 0           H19-EMULATION  ON!OFF
  652. 0             If ON then Kermit will emulate an H19 (VT52).
  653. 1                                                          UBC KERMIT
  654.                                                                    15
  655. -           IBM  ON!OFF
  656. 0             If  ON  then  Victor  Kermit  will  send  the necessary
  657.               control information to talk to  an  IBM  mainframe.  It
  658.               will  also  set  the parity appropriately and set local
  659.               echoing  on.  Default  is  OFF.  This  option  is   NOT
  660.               applicable to MTS hosts.
  661. 0           INCOMPLETE  DISCARD!KEEP
  662. 0             If  a file transfer terminates unexpectedly and DISCARD
  663.               is set then any portion of the file so far  transferred
  664.               will  be  discarded. If KEEP is given then whatever was
  665.               transferred will be kept. The default is DISCARD.
  666. 0           PARITY  type
  667. 0             'type' is one of NONE (default,  eight  data  bits,  no
  668.               parity), MARK (seven data bits, parity bit set to one),
  669.               SPACE  (seven  data  bits with parity bit set to zero),
  670.               EVEN (seven data  bits,  parity  set  to  make  overall
  671.               parity  even), ODD (seven data bits, parity set to make
  672.               overall parity odd).
  673.