
                           KERMIT HELP


GENERAL INFORMATION

To begin with, KERMIT.EXE should be copyed over to your  'system'
disk.  This is the executable file that will be run when you give
the command KERMIT to MS-DOS.

You should connect your modem or terminal line to J2 on the  back
of  your  Z-100.  If you have configured your Z-100 such that the
printer is at that connector, you must  configure  the  auxillary
device  to  be at J1 and then connect your modem or terminal line
to J1.

It is important that you be 'logged in' on the disk that you will
be transfering files to or from.   'Logged  in'  means  that  the
MS-DOS  prompt,  normally  A>, be ?>, where ?  is the name of the
disk that you  expect  to  send  or  receive  data  from.   After
'logging in' on the proper disk, type A:KERMIT.

Over  a  phone  line  at 300 baud, it will take a LONG time for a
file to transfer.  Be patient.



COMMANDS

These are the commands for the Z-100 KERMIT.  The  commands  will
be  given, and a description of them will follow.  If the command
requires parameters, or opens up a new level of discussion,  that
will also be given in the command description.

Square  brackets  ('[',']')  will  be  used  to  enclose optional
parameters.  Mandatory parameters will be listed in lower case.


BYE

This command requires no parameters.  Its function  is  to  cause
the KERMIT Server running on the Host to exit, and logout the job
on the Host.  The local Kermit will exit to the command level  of
MS-DOS.


CONNECT

This command requires no parameters.  Its function  is  to  allow
the  Z-100  to  act  as  a  terminal on the Host.  It will give a
message which will give the  'escape'  character.   This  is  the
character  that  is  used  to return to the KERMIT running on the
Z-100.  The baud rate  needs  to  be  properly  set  before  this
command is issued to allow use of the Host.

EXIT

This  command  requires  no parameters.  Its function is to cause
the KERMIT running on the Z-100 to exit to MSDOS command level.


FINISH

This  command  requires  no parameters.  Its function is to cause
the KERMIT Server running on the  Host  to  exit  to  the  Host's
command level.  It does not cause the KERMIT running on the Z-100
to exit.


HELP

This  command provides a list of commands and a brief explanation
of their function.


LOGOUT

This  command  requires  no parameters.  Its function is to cause
the KERMIT running on the Host to exit and to cause the job  that
the  KERMIT was running under to log out.  It does not affect the
local KERMIT on the Z-100 in any way.


RECEIVE [filename.ext]

This command may optionally take a file name.  Its function is to
get a file from the Host onto the  Z-100.   In  its  basic  form,
RECEIVE,  it will use the file name provided by the KERMIT on the
Host to create a file on the Z-100.  It will place the data  sent
to  the local kermit in the file.  A SEND command should be given
to the Host KERMIT before the RECEIVE command is  issued  on  the
local KERMIT.

The  Host should be set up as a Server before using the parameter
with this command.  When the  parameter  is  specified  with  the
command,  the  local  KERMIT  will  request Server to send it the
named file.  If the KERMIT on the Host is not a Server, an  error
message will be generated.


SEND filename.ext

This command requires a file name as its parameter.  Its function
is  to  send the named file to the Host.  If the Host KERMIT is a
Server, this is the only command that need be done  in  order  to
send  a  file  to the Host from the Z-100.  If the Host KERMIT is
not running as a Server, then you need CONNECT to  the  Host  and
give it a RECEIVE command.


SET parameter[parameters]

This command is used to set and reset various  items  in  KERMIT.
At least one parameter is always requires, that being the name of
the item being affected.  The following is  a  list  of  settable
items, telling what they do and their possible values.

    BAUD baud-rate

    This  set  command  is  used to choose the transmission speed
    that KERMIT will use.  The one chosen should match the Host's
    transmission  speed (baud rate).  The following are the legal
    speeds:

    45.5, 50, 75, 110, 134.5, 150, 300, 600,  1200,  1800,  2000,
    2400, 4800, 9600, 19200, 38400

    Note  that  at speeds of over 2400 baud, the Z-100 will spend
    all of its time taking care of the communications and may not
    always  get  it  right.   It  will  also  tend  to ignore the
    keyboard.


    DEBUG on/off

    This  command  will cause KERMIT to display the messages that
    is sends and receives on the lower  portion  of  the  screen.
    Its  normal state is OFF.  When it is turned ON, the speed at
    which it transfers files is greatly reduced.


    ESCAPE escape-character

    This  set command allows you to change the 'escape' character
    to whatever you like it to be as long as it is in the  proper
    range of characters.

    Note  that  this command is a little strange in that you must
    reissue it if you ask for help while you are entering it.


    FILE-WARNING on/off

    When  set  ON, this set command will cause KERMIT to check to
    see if the file name that it has been told to create  already
    exists.   If  it  does,  it will add an '&' to the end of the
    file name and try to create it again.  This is to prevent the
    accidential destruction of a file.  The normal state for this
    item is OFF.


    IBM on/off

    When  set  on,  this  item causes the Z-100 to understand and
    talk to IBM mainframe computers.  This item is normally  off.


    LOCAL-ECHO on/off

    When  set  on, this item will causes the whatever is typed on
    the keyboard to be displayed on the screen.  This  is  useful
    when  communicating over half-duplex lines.  THe normal state
    for this item is off.

    The above are all of the SET commands.  For  the  most  part,
    they should be left in their normal state as KERMIT will work
    on the UNO mainframes as is.  The exception to this  rule  is
    the SET BAUD command, which should be set to the proper speed
    for the line you are using.


    STATUS

    This  command will display the current values of the settable
    items.  It has no parameters.


In  addition  to  these  commands, there are two single keystroke
commands.  These are the '?' and the ESC keys.

You can use the '?' to find out what the legal parameters  for  a
command  are; that is, after typing a command name, press '?' and
KERMIT will tell you what it is expecting to see.

The ESC key will complete  a  command  name  for  you.   IF,  for
example,  you  were  to  type STA followed by the ESC key, KERMIT
would add the TUS thus causing the complete command  name  STATUS
to  appear  on  the screen.  If the command is still ambigious at
the time when you press ESC, KERMIT will beep at you.  The  Z-100
does  not  have tha capability to croak or make other Kermit-like
sounds.



