.VR SYSTEM
.P0
.ap
.LM1.RM70
.I-1
.IF SYSTEM
1 Kermit
.ENDIF SYSTEM

Kermit is a file transfer protocol. It allows the transfer of files over
terminal lines from a remote Kermit program to the local Kermit program.

Kermit-32 can be run from SYS$SYSTEM:.  It will then prompt for input
from SYS$COMMAND:.

Kermit-32 can be run in either local or remote modes.  In remote mode,
transfers take place over the controlling terminal line.  Ususally,
Kermit-32 is used in remote mode as a "server", meaning that it will
accept commands from the other Kermit.  In local mode, Kermit-32 will
perform transfers over a terminal line other than the controlling terminal.
In local mode, Kermit-32 is capable of giving commands to a "server" Kermit.
Note that in order to use Kermit-32 in local mode, the protection code
for the terminal to be used must allow the user access.  This is set by
the system manager.

When Kermit-32 starts up, it will determine a default terminal line to
be used for file transfers (and the CONNECT command) by the following
process.  If there is a logical name "KER$COMM" which translates to
a terminal name, the default transfer terminal will be that terminal.
Otherwise, Kermit checks "SYS$INPUT", "SYS$OUTPUT" and "SYS$COMMAND", (in
that order), and the first one which translates to a terminal name is
used as the default.  If none of these are terminals, Kermit will use
the terminal which controls the job which owns the process.  If
the process does not have a controlling terminal, or if the terminal
which was found cannot be allocated, Kermit will not have a default terminal,
and the SET LINE TTcn: command must be used before any commands which
require the transfer terminal (SEND, GET, etc.).  Kermit will type out
a message indicating the default transfer terminal when it is started.

.I-1
.IF SYSTEM
2 BYE
.ELSE SYSTEM
1 BYE
.ENDIF SYSTEM

This command will cause Kermit-32 (when in local mode) to tell the other
Kermit (which should be in server mode) to exit from Kermit and, if
applicable, terminate its job (or process, etc.).  When Kermit-32 receives
the acknowledgement that this is being done, it will exit to VMS.
.b.i+10
Kermit-32>BYE
.b

.I-1
.IF SYSTEM
2 CONNECT
.ELSE SYSTEM
1 CONNECT
.ENDIF SYSTEM

The CONNECT command will allow you to connect in as a virtual terminal
over the line that was specified by the SET LINE command, or to the
terminal line specified in the command.
The terminal line must be one which is accessible to the users process.  This
means that the applicable protection code for the terminal must have been
set to allow your process to access it (done by the system manager).
If a session log file was previously specified, a new version of the file
will be created, and all typeout logged in the file.  The file will be
closed when the command is completed (by use of an escape-character "C"
command).
The format of the CONNECT command
is:
.b.I+10
Kermit-32>CONNECT
.b
or
.b.I+10
Kermit-32>CONNECT TTcn:
.b
where TTcn: is the terminal line name to be used.

.I-1
.IF SYSTEM
2 EXIT
.ELSE SYSTEM
1 EXIT
.ENDIF SYSTEM

The EXIT command will cause Kermit to return to command level.  This command
is the same as the QUIT command.  An example of this command is:
.b.I+10
Kermit-32>EXIT

.I-1
.IF SYSTEM
2 FINISH
.ELSE SYSTEM
1 FINISH
.ENDIF SYSTEM

This command will cause Kermit-32 (when in local mode) to tell the other
Kermit (which should be in server mode) to exit from Kermit.
After receiving the acknowledgement that this is being done, Kermit-32
will prompt for another command.
.b.i+10
Kermit-32>FINISH
.b

.I-1
.IF SYSTEM
2 GET
.ELSE SYSTEM
1 GET
.ENDIF SYSTEM

The GET command is used to have a local Kermit-32 request
a file from the remote Kermit.
Kermit-32 must be running
as a local Kermit (i.e., a SET LINE command must have been done).  Kermit-32
will then request the other Kermit (which must be running in server mode)
to transfer the specified file (or set of files) to Kermit-32.  The file
specification must be in the format of the system on which the server Kermit
is running.
The format of the command is:
.b.i+10
Kermit-32>GET file-specification
.b
Where "file-specification" is any valid file specification on the
system on which the server Kermit is running.

.I-1
.IF SYSTEM
2 LOCAL
.ELSE SYSTEM
1 LOCAL
.ENDIF SYSTEM

This command allows the user of Kermit-32 to perform various actions on the
user's system.
These commands provide for listing the contents of a directory, deleting
files, typing files, displaying the amount of disk space used, etc.
Many of these commands are performed by spawning a subprocess to execute
the corresponding DCL command; therefore, the standard parameters and
qualifiers which DCL allows may be used.
.b.i+10
Kermit-32>LOCAL keyword arguments
.b
Where keyword is the name of the command, and arguments are the optional
arguments for the command.
.I-1
.IF SYSTEM
3 COPY
.ELSE SYSTEM
2 COPY
.ENDIF SYSTEM

This causes Kermit-32 to make a copy of the specified file.
This command uses the standard DCL COPY command.  Any options valid for DCL's
COPY command may be used.
.b.i+10
Kermit-32>LOCAL COPY old-local-file
.I+10;New file: new-local-file
.b
Where 'old-local-file' is the name of the file you wish to copy, and
'new-local-file' is the name for the copy.
.I-1
.IF SYSTEM
3 CWD
.ELSE SYSTEM
2 CWD
.ENDIF SYSTEM

This command (short for "Change Working Directory") causes Kermit-32 to
the default directory that
will be used for files whose specification does not include the directory
information.
This is similar to the DCL SET DEFAULT command.  If no device or directory
is given, the default device and directory is set back to that which was
being used when Kermit-32 was started.
.b.i+10
Kermit-32>LOCAL CWD local-directory-specification
.b
or
.b.i+10
Kermit-32>LOCAL CWD
.b
Where 'local-directory-specification' is the device and/or directory portion
of a standard VMS file specification.  It may include logical names, but
not wildcards.
.I-1
.IF SYSTEM
3 DELETE
.ELSE SYSTEM
2 DELETE
.ENDIF SYSTEM

This causes Kermit-32 to delete the specified file(s). This uses the standard
DCL DELETE command.
.b.i+10
Kermit-32>LOCAL DELETE file-specification
.B
Where file-specification is a valid VAX/VMS file specification.
.I-1
.IF SYSTEM
3 DIRECTORY
.ELSE SYSTEM
2 DIRECTORY
.ENDIF SYSTEM

This causes Kermit-32 to display a directory listing.
This uses the standard DCL DIRECTORY command.
.B.I+10
Kermit-32>LOCAL DIRECTORY file-specification
.B
Where the file-specification is an optional valid VAX/VMS file specification.
.I-1
.IF SYSTEM
3 DISK__USAGE
.ELSE SYSTEM
2 DISK__USAGE
.ENDIF SYSTEM

This causes Kermit-32 to display
the amount of disk space used and available for
the given UIC (or the user's UIC if none is given). This uses the standard
DCL SHOW QUOTA command.
.B.I+10
Kermit-32>LOCAL DISK__USAGE uic
.B
Where uic is an optional UIC (in square brackets).
.I-1
.IF SYSTEM
3 HELP
.ELSE SYSTEM
2 HELP
.ENDIF SYSTEM

This causes Kermit-32 to display the help message which it sends as the
reply when it receives a "REMOTE HELP" command in server mode.
This describes the REMOTE commands which Kermit-32 implements.
.b.i+10
Kermit-32>LOCAL HELP
.b
.I-1
.IF SYSTEM
3 HOST
.ELSE SYSTEM
2 HOST
.ENDIF SYSTEM

This command requests Kermit-32 to perform the specified command
as if it were typed by the user on a terminal.  Any results of the command
will be printed on the user's terminal.  Note that this should only be used
for commands which will not require any more user input, since there will
be no way for the user to interact with the subprocess to supply more
input.
This works by spawning a subprocess (much like the DCL SPAWN command) to
perform the command.
.B.I+10
Kermit-32>LOCAL HOST command
.B
Where 'command' is any valid DCL command.
.I-1
.IF SYSTEM
3 RENAME
.ELSE SYSTEM
2 RENAME
.ENDIF SYSTEM

This command causes Kermit-32 to change the
name on a file.  This uses the standard DCL RENAME command.
.B
.I+10;Kermit-32>LOCAL RENAME old-local-file
.I+10;New file: New-local-file
.B
Where 'old-local-file' is the name of the file to be renamed, and
'new-local-file' is the new name for the file.
.I-1
.IF SYSTEM
3 SEND__MESSAGE
.ELSE SYSTEM
2 SEND__MESSAGE
.ENDIF SYSTEM

This command causes Kermit-32 to send a short (one line) message
to the given terminal.
Because this uses the DCL REPLY command, OPER priveleges are needed.
.B
.I+10;Kermit-32>LOCAL SEND__MESSAGE terminal-name
.I+10;Message: message-text
.B
Where 'terminal-name' is a valid name for a terminal, and
'message-text' is the message to be sent.
.I-1
.IF SYSTEM
3 TYPE
.ELSE SYSTEM
2 TYPE
.ENDIF SYSTEM

This causes Kermit-32 to display
the specified file(s) on the terminal.
.B.I+10
Kermit-32>LOCAL TYPE file-specification
.b
Where file-specification is a valid VAX/VMS file specification.
.I-1
.IF SYSTEM
3 WHO
.ELSE SYSTEM
2 WHO
.ENDIF SYSTEM

This displays the output of a SHOW SYSTEM command.
.b
.i+10;Kermit-32>LOCAL WHO
.B

.i-1
.IF SYSTEM
2 LOG
.ELSE SYSTEM
1 LOG
.ENDIF SYSTEM

The LOG command allows the user to specify the file names to be used
for the various log files Kermit is capable of creating.  A LOG command
without a file specification will cause no log file of that type to be
created.
.B
.I+10;Kermit-32>LOG keyword filespec
.B
Where keyword is DEBUG, SESSION, or TRANSACTION, and filespec is the file
specification to use for that type of log file.  If filespec is not present,
that type of logging is disabled.
.I-1
.IF SYSTEM
3 DEBUG
.ELSE SYSTEM
2 DEBUG
.ENDIF SYSTEM

The LOG DEBUG command sets the file specification to be used for the debugging
log file.  This file will be used for the debugging output produced when
a SET DEBUG ON command is done.  A new version of the file is created each
time a transfer command is performed, and closed upon the completion of the
transfer command.
.b
.i+10;Kermit-32>LOG DEBUG filespec
.B
Where filespec is the file specification to use for the debugging log file.
If the filespec is null, the debugging log file is disabled.
.I-1
.IF SYSTEM
3 SESSION
.ELSE SYSTEM
2 SESSION
.ENDIF SYSTEM

The LOG SESSION command sets the file name to be used for a log file of
a "CONNECT" session.  A new version of this file is created each time
the CONNECT command is used, and closed when the CONNECT command finishes
(as a result of the escape command to close the session).  All output
to the controlling terminal will be logged in the session log file.
.b
.i+10;Kermit-32>LOG SESSION filespec
.B
Where filespec is the file specification to use for the session log file.
If the filespec is null, the session log file is disabled.
.I-1
.IF SYSTEM
3 TRANSACTION
.ELSE SYSTEM
2 TRANSACTION
.ENDIF SYSTEM

The LOG TRANSACTION command sets the name of the file to be used as
a transaction log file.  A new version of this file is created each
time a transfer command is given (SEND, GET, SERVER, etc.).  Information
about the transfer is logged in this file.  This includes the names
of the files being transferred, any errors, etc.
.b
.i+10;Kermit-32>LOG TRANSACTION filespec
.B
Where filespec is the file specification to use for the transaction log file.
If the filespec is null, the transaction log file is disabled.

.I-1
.IF SYSTEM
2 LOGOUT
.ELSE SYSTEM
1 LOGOUT
.ENDIF SYSTEM

This command will cause Kermit-32 (when in local mode) to tell the other
Kermit (which should be in server mode) to exit from Kermit and, if
applicable, terminate its job (or process, etc.).  When Kermit-32 receives
the acknowledgement that this is being done, it will prompt for another
command.
.b.i+10
Kermit-32>LOGOUT
.b

.i-1
.IF SYSTEM
2 QUIT
.ELSE SYSTEM
1 QUIT
.ENDIF SYSTEM

This command will cause Kermit to return to command level.  This is the same
as the EXIT command.
.b.I+10
Kermit-32>QUIT

.I-1
.IF SYSTEM
2 RECEIVE
.ELSE SYSTEM
1 RECEIVE
.ENDIF SYSTEM

The RECEIVE command is used to put Kermit-32 into remote mode waiting
for a single file transfer transaction.
This is most useful if the other Kermit does not support local server commands.
If no file specification is given, Kermit-32 will use whatever file
specification is supplied by the other Kermit (suitably altered to conform
to VMS standards).  If a file specification is given, Kermit-32 will use
that file specification instead of that supplied by the other Kermit.  This
is most useful when the file name on the other system is such that it
does not map well into a VMS file specification.  Note that if the other
Kermit sends more than one file, the same name will be used for all of them.
Only the version numbers will be different.  Therefore, it is best to use
a file-specification on this command only when transferring a single file.
The format of the command is:
.b.I+10
Kermit-32>RECEIVE
.b
or
.b.i+10
Kermit-32>RECEIVE file-specification
.b
Where "file-specification" is any valid VMS file specification.

.I-1
.IF SYSTEM
2 REMOTE
.ELSE SYSTEM
1 REMOTE
.ENDIF SYSTEM

This command allows the user of Kermit-32 (in local mode) to give
various commands to the other Kermit (which must be in server mode).
These commands provide for listing the contents of a directory, deleting
files, typing files, displaying the amount of disk space used, etc.
Note that not all server Kermits support all commands, but all server
Kermits should repsond with a message saying the command is not implemented
if it does not support it.
.b.i+10
Kermit-32>REMOTE keyword arguments
.b
Where keyword is the name of the command, and arguments are the optional
arguments for the command.
.I-1
.IF SYSTEM
3 COPY
.ELSE SYSTEM
2 COPY
.ENDIF SYSTEM

This causes Kermit-32 to request that the server Kermit make a copy of the
specified file.  Both the old and new files are files on the server's system -
no file transfer between systems is done.
The server Kermit should respond with some indication that either the file
was successfully copied, or with an error message.  Note that some
Kermit's will allow wild-carded copies, while others will only allow a single
file to be copied per command.
.b.i+10
Kermit-32>REMOTE COPY old-remote-file
.I+10;New file: new-remote-file
.b
Where 'old-remote-file' is the name of the file you wish to copy, and
'new-remote-file' is the name for the copy.
.I-1
.IF SYSTEM
3 CWD
.ELSE SYSTEM
2 CWD
.ENDIF SYSTEM

This command (short for "Change Working Directory") causes Kermit-32 to request
that the server Kermit change the default directory (path, device, etc.) that
will be used for files whose specification does not include the directory
information.  For some systems a password can be supplied which will allow
access to the new directory.  Since Kermit-32 can not know whether the server
Kermit requires a password, it will always ask for one.  If no directory
is specified in the command, the server Kermit will set the default
directory back to the users default.  This may be either the directory
which is the default when a job created, or the default directory which
was in effect when the server Kermit was started.
The server Kermit should respond with a message which indicates where
the new default directory has been set, or with an error message.
.b.i+10
Kermit-32>REMOTE CWD remote-directory-specification
.I+10;Password: password for remote directory
.b
or
.b.i+10
Kermit-32>REMOTE CWD
.b
Where 'remote-directory-specification' is a string which is acceptable
as a directory indication for the server system.  The password is any string
which is required as a password for access to the given directory.  The
password will not be echoed.
.I-1
.IF SYSTEM
3 DELETE
.ELSE SYSTEM
2 DELETE
.ENDIF SYSTEM

This causes Kermit-32 to request the server Kermit to delete the specified
file (or files if the server Kermit supports wild-card deletes).  The
server Kermit should respond with a message indicating whether the file
(or files) has been deleted.
.b.i+10
Kermit-32>REMOTE DELETE file-specification
.B
Where file-specification is a valid file specification for the remote
Kermit's system.
.I-1
.IF SYSTEM
3 DIRECTORY
.ELSE SYSTEM
2 DIRECTORY
.ENDIF SYSTEM

This causes Kermit-32 to request a directory listing from the server
Kermit.  The directory listing will be printed on the users terminal.
The format of the listing is determined by the server Kermit.
.B.I+10
Kermit-32>REMOTE DIRECTORY file-specification
.B
Where the file-specification is an optional valid file specification for the
server Kermits system.
.I-1
.IF SYSTEM
3 DISK__USAGE
.ELSE SYSTEM
2 DISK__USAGE
.ENDIF SYSTEM

This causes Kermit-32 to request the server Kermit to reply with
an indication of the amount of disk space used and available for
the given directory (or the default directory if none is given).
.B.I+10
Kermit-32>REMOTE DISK__USAGE directory-specification
.B
Where directory-specification is an optional directory specification
for the server Kermit's system.
.I-1
.IF SYSTEM
3 EXIT
.ELSE SYSTEM
2 EXIT
.ENDIF SYSTEM

This command is identical to the FINISH command.  It requests the server
Kermit to exit to its system command parser, allowing the terminal to be
used for normal commands.
.B.I+10
Kermit-32>REMOTE EXIT
.B
.I-1
.IF SYSTEM
3 HELP
.ELSE SYSTEM
2 HELP
.ENDIF SYSTEM

This causes Kermit-32 to request the server Kermit to reply with a sort
summary of what commands it supports in server mode.  If an argument
is given, help on the specific topic is requested.  The resulting
help message will be typed on the users terminal.
.b.i+10
Kermit-32>REMOTE HELP topic
.b
or
.b.i+10
Kermit-32>REMOTE HELP
.b
Where topic is an option subject for more detailed help.  If no topic is
given, a general help message is requested.
.I-1
.IF SYSTEM
3 HOST
.ELSE SYSTEM
2 HOST
.ENDIF SYSTEM

This command requests the server Kermit to perform the specified command
as if it were typed by the user on a terminal.  Any results of the command
will be printed on the user's terminal.  Note that this should only be used
for commands which will not require any more user input, since there will
be no way for the user to interact with the remote system to supply more
input.
.B.I+10
Kermit-32>REMOTE HOST command
.B
Where 'command' is any valid command to be processed by the remote systems
standard command parser.
.I-1
.IF SYSTEM
3 LOGIN
.ELSE SYSTEM
2 LOGIN
.ENDIF SYSTEM

This command allows the user to supply the server Kermit with accounting
information.  The server Kermit may use this to validate the users access to
the system as well as for billing purposes.  It may also use this information
to provide the user with access to files on its system.
.B.I+10
Kermit-32>REMOTE LOGIN user-id
.I+10;Account: remote-accounting-info
.I+10;Password: remote-password
.B
Where 'user-id' is a string which represents a valid user identification on the
remote system, 'remote-accounting-info' is any additional accounting
information required by the remote system (such as account strings), and
'remote-password' is the password for the remote system which corresponds to
the given user-id.  The password will not be echoed.
.I-1
.IF SYSTEM
3 LOGOUT
.ELSE SYSTEM
2 LOGOUT
.ENDIF SYSTEM

This command is the same as the LOGOUT command.  It will request the
server Kermit to exit and logout its job.
.B.I+10
Kermit-32>REMOTE LOGOUT
.B
.I-1
.IF SYSTEM
3 RENAME
.ELSE SYSTEM
2 RENAME
.ENDIF SYSTEM

This command causes Kermit-32 to request that the server Kermit change the
name on a file.  The server Kermit should respond with an indication that
the operation is completed successfully, or else with an error message.
Some Kermit's may allow wild-card file specifications to be used, and
will repsond with a list of files and new names.
.B
.I+10;Kermit-32>REMOTE RENAME old-remote-file
.I+10;New file: New-remote-file
.B
Where 'old-remote-file' is the name of the file to be renamed, and
'new-remote-file' is the new name for the file.
.I-1
.IF SYSTEM
3 SEND__MESSAGE
.ELSE SYSTEM
2 SEND__MESSAGE
.ENDIF SYSTEM

This command requests the server Kermit to send a short (one line) message
to the given destination.  Depending on the system, the destination may
be a terminal, a user name, a mailbox name or some other destination
address.  The server Kermit should respond with an indication of success
or failure.
.B
.I+10;Kermit-32>REMOTE SEND__MESSAGE destination-address
.I+10;Message: message-text
.B
Where 'destination-address' is a valid destination for the server's system, and
'message-text' is the message to be sent.
.I-1
.IF SYSTEM
3 STATUS
.ELSE SYSTEM
2 STATUS
.ENDIF SYSTEM

This requests the status of the server Kermit.  The server Kermit will reply
with some indication of its status.
.B
.I+10;Kermit-32>REMOTE STATUS
.B
.I-1
.IF SYSTEM
3 TYPE
.ELSE SYSTEM
2 TYPE
.ENDIF SYSTEM

This causes Kermit-32 to request the server Kermit to transmit
the specified file (or files if the server supports wildcards)
so that the file(s) can be typed on the users terminal.
.B.I+10
Kermit-32>REMOTE TYPE file-specification
.b
Where file-specification is a valid file specification for the server
Kermit's system.
.I-1
.IF SYSTEM
3 WHO
.ELSE SYSTEM
2 WHO
.ENDIF SYSTEM

This requests the server Kermit to display a list of users of its system,
along with other information about the users and/or system.  A specific
user-id may be supplied, which may result in more detailed information about
the particular user.  It is also possible to supply options for use by
the server Kermit in determining the format, etc., of the resulting list.
.b
.i+10;Kermit-32>REMOTE WHO user-id
.I+10;Options: options-list
.B
Where 'user-id' is an optional string representing a specific user, and
'options-list' is an optional list of formatting or selection options.

.I-1
.IF SYSTEM
2 SEND
.ELSE SYSTEM
1 SEND
.ENDIF SYSTEM

The SEND command will allow you to send a file(s) to the other Kermit.  The
SEND command will allow file wild card processing as is found in VMS.
If Kermit-32 is running in remote mode, the file will be sent on the
controlling terminal line after waiting the number of seconds specified
by the SET DELAY command.  This gives the user time to escape back to the
other Kermit and issue a receive command.  If Kermit-32 is running in
local mode, the file will be sent immediately on the terminal line 
specified by the SET LINE command.
.B
The command format is:
.b.i+10
Kermit-32>SEND file-specification
.b
Where "file-specification" is any normal VAX/VMS file specification.

.I-1
.IF SYSTEM
2 SERVER
.ELSE SYSTEM
1 SERVER
.ENDIF SYSTEM

This command will cause Kermit-32 to enter server mode.  The other Kermit can
then issue server commands to send and receive files without having to give
SEND or RECEIVE commands to Kermit-32.
Kermit-32 may be put into SERVER mode while running as either a remote
Kermit (transmitting over the controlling terminal line), or as a local
Kermit (transmitting over a terminal specified by a SET LINE command).
Note that in order to correctly receive binary files while in SERVER mode,
a SET FILE TYPE BINARY must be done first.  At this time there is no
way for Kermit-32 to determine whether an incoming file is ASCII or binary.
.B
The format of the command is:
.B.I+10
Kermit-32>SERVER
.B

.I-1
.IF SYSTEM
2 SET
.ELSE SYSTEM
1 SET
.ENDIF SYSTEM

The SET command is used to set various parameters in Kermit.

.I-1
.IF SYSTEM
3 BLOCK__CHECK__TYPE
.ELSE SYSTEM
2 BLOCK__CHECK__TYPE
.ENDIF SYSTEM

The SET BLOCK__CHECK__TYPE command is used to determine the type
of block check sequence which will be used during transmission. The
block check sequence is used to detect transmission errors.  There
are three types of block check available.  These are the
single character checksum (default), the two character checksum,
and the three character CRC (cyclic redundancy check).  This command
does not ensure that the desired type of block check will be used, since
both Kermit's involved in the transfer must agree on the block check type.
Kermit-32 will request that the type of block check set by this
command be used for a transfer.  If the other Kermit has also had
the same block check type requested, then the desired block check type
will be used.  Otherwise, the single character checksum will be used.
(See Kermit protocol manual for more information.)
.b.i+10
Kermit-32>SET BLOCK__CHECK__TYPE keyword
.b
Where keyword is one of:
.ls1
.le;1__CHARACTER__CHECKSUM or ONE__CHARACTER__CHECKSUM
.le;2__CHARACTER__CHECKSUM or TWO__CHARACTER__CHECKSUM
.le;3__CHARACTER__CRC__CCITT or THREE__CHARACTER__CRC__CCITT
.els

.I-1
.IF SYSTEM
3 DEBUGGING
.ELSE SYSTEM
2 DEBUGGING
.ENDIF SYSTEM

The SET DEBUGGING command is used to set the debug type out on the user's
terminal.  The command will accept either the keywords ON or OFF.
Kermit-32 can only do debugging type out when running as a local Kermit
(SET LINE command done).  This is because the debugging type out
would interfere with the file transfer if it were sent to the controlling
terminal line in remote mode.
.b.I+10
Kermit-32>SET DEBUGGING state
.b
Where state is either 'ON' or 'OFF'.

.I-1
.IF SYSTEM
3 DELAY
.ELSE SYSTEM
2 DELAY
.ENDIF SYSTEM

The DELAY parameter is the number of seconds to wait before sending
data after a SEND command is given.  This is used when Kermit-32 is
running in remote mode to allow the user time to escape back to the
other Kermit and give a RECEIVE command.
.b.i+10
Kermit-32>SET DELAY number-of-seconds
.b
Where number of seconds is the (decimal) number of second to wait
before sending data.

.I-1
.IF SYSTEM
3 ESCAPE
.ELSE SYSTEM
2 ESCAPE
.ENDIF SYSTEM

This command will set the escape character for the CONNECT processing.
The command will take the octal value of the character to use as the
escape character.
This is the character which is used to "escape" back to Kermit-32 after
using the CONNECT command.  It defaults to ^] (octal 35).  It is
usually a good idea to set this character to something which is not
used (or at least not used very much) on the system being to which
Kermit-32 is CONNECTing.
.b.i+10
Kermit-32>SET ESCAPE octal-character-value
.b
Where octal-character-value is the ASCII value of the character
to use as the escape character (in octal).

.I-1
.IF SYSTEM
3 FILE
.ELSE SYSTEM
2 FILE
.ENDIF SYSTEM

The SET FILE command allows setting of parameters relating to the file
format and file naming conventions used by Kermit.
.I-1
.IF SYSTEM
4 NAMING
.ELSE SYSTEM
3 NAMING
.ENDIF SYSTEM

This command sets the type of processing Kermit should do on file names
that are being sent and received.  Kermit can either send the complete
file specification (including device, directories, file name, file type
and version number) or only the file name and type.  When receiving a
file specification, Kermit can either attempt to use it as a VMS file
specification as is, or first perform some substitutions and truncations
in order to force the received specification to be just a valid file name
and type.
.b.I+10
Kermit-32>SET FILE NAMING type
.I-1
.IF SYSTEM
5 FULL
.ELSE SYSTEM
4 FULL
.ENDIF SYSTEM

This will cause Kermit to send complete file specifications and perform
no translations on received file specifications.
.I-1
.IF SYSTEM
5 NORMAL__FORM
.ELSE SYSTEM
4 NORMAL__FORM
.ENDIF SYSTEM

This will cause Kermit to send only the file name and file type, and
perform translations on received file specifications to force them
to be only a valid file name and type.
.I-1
.IF SYSTEM
5 UNTRANSLATED
.ELSE SYSTEM
4 UNTRANSLATED
.ENDIF SYSTEM

This will cause Kermit to send only the file name and file type, and
perform no translations on received file specifications.
.I-1
.IF SYSTEM
4 TYPE
.ELSE SYSTEM
3 TYPE
.ENDIF SYSTEM

This command will set the file type that Kermit is receiving.  A file
type of ASCII should be used to receive text files which are to be
used as text files on the VMS system.
The file type BINARY should be used for binary files, such as CP/M .COM files,
which need to be kept in a format that allows the file to be returned without
any changes.
.b.I+10
Kermit-32>SET FILE TYPE type
.I-1
.IF SYSTEM
5 ASCII
.ELSE SYSTEM
4 ASCII
.ENDIF SYSTEM

File type ASCII is for text files.
.I-1
.IF SYSTEM
5 BINARY
.ELSE SYSTEM
4 BINARY
.ENDIF SYSTEM

File type BINARY is for non-text files.  Note that binary files which
are generated on a VMS system cannot be transferred to another VMS system
without losing file attributes.  This means that (for example), an .EXE
file cannot be transmitted with Kermit-32.  (This problem should be
resolved in a future verison of Kermit).
.;.I-1
.;.IF SYSTEM
.;5 BLOCK
.;.ELSE SYSTEM
.;4 BLOCK
.;.ENDIF SYSTEM
.;
.;The BLOCK file type is for transferring files with the RMS-32 header
.;information.  This is used mainly for transferring files between Kermit-32
.;and Pro/Kermit.
.I-1
.IF SYSTEM
5 FIXED
.ELSE SYSTEM
4 FIXED
.ENDIF SYSTEM

The FIXED file type will cause Kermit to create a file with 512 byte fixed
length records, containing only the data received from the other Kermit.
This format can be used for transferring VMS _.EXE files or RSX-11/M (P/OS)
_.TSK files, or any other binary file which is stored in 512 byte fixed
length records.

.I-1
.IF SYSTEM
3 IBM__MODE
.ELSE SYSTEM
2 IBM__MODE
.ENDIF SYSTEM

The SET IBM__MODE command allows Kermit-32 to be put into a mode which
will allow transfers to an IBM host.  This causes Kermit-32 to wait
for the IBM turnaround character (XON, CTRL-Q) before sending
any characters to the other Kermit.  It also forces the parity type to
be mark, and turns on local echo for the CONNECT command.
.b.i+10
Kermit-32>SET IBM__MODE keyword
.b
Where keyword is either ON or OFF.

.I-1
.IF SYSTEM
3 INCOMPLETE__FILE__DISPOSITION
.ELSE SYSTEM
2 INCOMPLETE__FILE__DISPOSITION
.ENDIF SYSTEM

The SET INCOMPLETE__FILE__DISPOSITION allows the user to determine what
is done with a file that is not completely received.  If the disposition
is KEEP, all file received will be kept, even if only a portion of the file
is received.  If the disposition is DISCARD (the default), files which
are not completely received are discarded.
.b.i+10
Kermit-32>SET INCOMPLETE__FILE__DISPOSITION keyword
.b
Where keyword is either DISCARD or KEEP.

.I-1
.IF SYSTEM
3 LINE
.ELSE SYSTEM
2 LINE
.ENDIF SYSTEM

This will set the terminal line that you are using.
The terminal line must be one which is accessible to the users process.  This
means that the applicable protection code for the terminal must have been
set to allow your process to access it (done by the system manager).
.b.I+10
Kermit-32>SET LINE device:
.B
The device must be a terminal line (TTA0:).

.I-1
.IF SYSTEM
3 LOCAL__ECHO
.ELSE SYSTEM
2 LOCAL__ECHO
.ENDIF SYSTEM

The SET LOCAL__ECHO command specifies whether characters should be
echoed locally when CONNECTing to another system.  If LOCAL__ECHO is
set to ON, any character typed on the terminal will be echoed immediately
to the terminal, as well as being sent to the other system.
If LOCAL__ECHO is set to OFF (the default), the characters
typed on the terminal are only sent to the other system (which would
normally be echoing the characters).
.b.i+10
Kermit-32>SET LOCAL__ECHO keyword
.b
Where keyword is either ON or OFF.

.i-1
.IF SYSTEM
3 MESSAGE
.ELSE SYSTEM
2 MESSAGE
.ENDIF SYSTEM

This command sets the type of typeout Kermit-32 will do during transfers
in local mode.  Kermit-32 can type out the file specification being
transferred, the packet numbers being sent an received, both or neither.
The default is to type file specifications but not packet numbers.
.b.i+10
Kermit-32>SET MESSAGE type keyword
.b
Where type is either FILE or PACKET, and keyword is either ON or OFF.

.i-1
.IF SYSTEM
3 PARITY
.ELSE SYSTEM
2 PARITY
.ENDIF SYSTEM

This command determines the type of parity to use on the transmission line.
Kermit normally uses characters which consist of eight data bits with
no parity bit.  For systems or transmission media which require a
specific parity type, Kermit can send characters as seven data bits plus
a parity bit.
.b.i+10
Kermit-32>SET PARITY keyword
.b
Where keyword is one of:
.ls1
.le;NONE (default) - eight data bits and no parity bit.
.le;MARK - seven data bits with the parity bit set to one.
.le;SPACE - seven data bits with the parity bit set to zero.
.le;EVEN - seven data bits with the parity bit set to make the overall parity even.
.le;ODD - seven data bits with the parity bit set to make the overall parity odd.
.ELS

.i-1
.IF SYSTEM
3 PROMPT
.ELSE SYSTEM
2 PROMPT
.ENDIF SYSTEM

This command sets the string to be used for the command prompt.  If no
argument is given, the default prompt (Kermit-32>) is used.
.B.I+10
Kermit-32>SET PROMPT new-prompt-text
.B

.i-1
.IF SYSTEM
3 REPEAT__QUOTE
.ELSE SYSTEM
2 REPEAT__QUOTE
.ENDIF SYSTEM

This command sets the character to be used as the lead-in character for
a repeat sequence (a string of characters which represents some number
of characters which are repeated in the data).  Both Kermit's must support
repeat compression for this to be in effect.
The character set by this
command must be in the range 41 ("1") to 76 (">") or 140 ("`") to 176 ("~").
The character will only be used on file which are being transmitted by Kermit-32.
The REPEAT__QUOTE character used for incoming files is decided on by the
other Kermit.
The default value is 176 ("~").  A value of 40 (a space) will disable
repeat compression.
.b.i+10
Kermit-32>SET REPEAT__QUOTE nnn
.b
Where nnn is the ASCII value for the repeat quoting character (in octal).

.i-1
.IF SYSTEM
3 RETRY
.ELSE SYSTEM
2 RETRY
.ENDIF SYSTEM

This command sets the maximum number of times Kermit-32 should try to
send specific packet.  There are two retry maximums, one for the initial
connection packet (the "SEND-INIT"), the other for all other packets.
The default value for initial connections is 5.  The default value for
all other packets is 16.
.b.i+10
Kermit-32>SET RETRY keyword n
.b
Where keyword is either INITIAL__CONNECTION (for initial connection packet) or
PACKET (for all other packets), and n is the decimal number of retries to
attempt.

.I-1
.IF SYSTEM
3 RECEIVE
.ELSE SYSTEM
2 RECEIVE
.ENDIF SYSTEM

It is possible to set various parameters associated with the receiving of the
data from the remote Kermit.  SET RECEIVE will enable you to set the various
receive parameters.
.I-1
.IF SYSTEM
4 PACKET__LENGTH
.ELSE SYSTEM
3 PACKET__LENGTH
.ENDIF SYSTEM

This will set the receive packet length.  The value for this parameter must
be between 10 and 96.  Packet lengths outside of this range are illegal.
The default value is 80.
.b.I+10
Kermit-32>SET RECEIVE PACKET__LENGTH 60
.I-1
.IF SYSTEM
4 PADDING
.ELSE SYSTEM
3 PADDING
.ENDIF SYSTEM

This command will set the number of padding characters that will be sent
to the other Kermit. The default value is 0.
.b.I+10
Kermit-32>SET RECEIVE PADDING n
.b
Where n is the decimal number of padding characters to use.
.I-1
.IF SYSTEM
4 PADCHAR
.ELSE SYSTEM
3 PADCHAR
.ENDIF SYSTEM

This parameter is the padding character that is sent to the remote Kermit.
The parameter must be an octal number in the range of 0 to 37 or 177.
All other values are illegal. The default value is 0 (an ASCII NUL).
.b.I+10
Kermit-32>SET RECEIVE PADCHAR nnn
.b
Where nnn is the ASCII value of the character to be used as a pad character
(in octal).
.i-1
.IF SYSTEM
4 START__OF__PACKET
.ELSE SYSTEM
3 START__OF__PACKET
.ENDIF SYSTEM

This command will set the start of packet character for Kermit.  The
start of packet character must be in the range of 0 to 36 octal.
The default value is 1 (ASCII SOH, CTRL-A).  This value should only
be changed if absolutely necessary.  It must be set the same in both
Kermit's.
.b.i+10
Kermit-32>SET RECEIVE START__OF__PACKET 3
.I-1
.IF SYSTEM
4 TIMEOUT
.ELSE SYSTEM
3 TIMEOUT
.ENDIF SYSTEM

This will set the number of seconds before Kermit-32 will time out the attempt
to receive a message.  This time out is used to handle transmission errors
which totally lose a message. The default value is 15 seconds.
.b.i+10
Kermit-32>SET RECEIVE TIMEOUT n
.b
Where n is the number of seconds to wait for a message (in decimal).
.I-1
.IF SYSTEM
4 END__OF__LINE
.ELSE SYSTEM
3 END__OF__LINE
.ENDIF SYSTEM

This will set the end of line character the Kermit-32 expects to receive from
the remote Kermit.  This is the character which terminates a packet.
The default value is 15 (ASCII CR, CTRL-M).
.b.i+10
Kermit-32>SET RECEIVE END__OF__LINE nnn
.b
Where n is the ASCII value of the character to use for the end of line
character (in octal).
.I-1
.IF SYSTEM
4 QUOTE
.ELSE SYSTEM
3 QUOTE
.ENDIF SYSTEM

This will set the quoting character that Kermit-32 will expect on incoming
messages.  This is the character used to quote control characters.
The default value is 43 (ASCII "#").
.b.i+10
Kermit-32>SET RECEIVE QUOTE nnn
.b
Where nnn is the ASCII value of the quoting character (in octal).
.i-1
.IF SYSTEM
4 EIGHT__BIT__QUOTE
.ELSE SYSTEM
3 EIGHT__BIT__QUOTE
.ENDIF SYSTEM

This command sets the character to be used (when necessary) to quote
characters which have the eigth bit (parity bit) set.  This is used
to transfer eight-bit bytes on a transmission medium which only supports
seven data bits.  The default value is 46 (ASCII "&").  Eigth-bit
quoting will only be used if both Kermit's can handle it, and the
tranmission medium does not transmit 8 data bits (as indicated by
the SET PARITY command).
.b.i+10
Kermit-32>SET RECEIVE EIGHT__BIT__QUOTE nnn
.b
Where nnn is the ASCII value of the character (in octal) to use for
quoting characters which have the eigth bit set.

.I-1
.IF SYSTEM
3 SEND
.ELSE SYSTEM
2 SEND
.ENDIF SYSTEM

It is possible to set various parameters associated with the receiving of the
data from the remote Kermit.  SET SEND will enable you to set the various
SEND parameters.  These parameters should not normally be set, since
as part of the transfer initialization process the two Kermit's exchange
their RECEIVE parameters.  The capability of setting these parameters is
provided so that the transfer initialization can be completed even if
the default parameters are not correct.
.I-1
.IF SYSTEM
4 PACKET__LENGTH
.ELSE SYSTEM
3 PACKET__LENGTH
.ENDIF SYSTEM

This will set the SEND packet length.  The value for this parameter must
be between 10 and 96.  Packet lengths outside of this range are illegal.
The default value is 80.
.b.I+10
Kermit-32>SET SEND PACKET__LENGTH 60
.I-1
.IF SYSTEM
4 PADDING
.ELSE SYSTEM
3 PADDING
.ENDIF SYSTEM

This command will set the number of padding characters that will be sent
to the other Kermit. The default value is 0.
.b.I+10
Kermit-32>SET SEND PADDING n
.b
Where n is the decimal number of padding characters to use.
.I-1
.IF SYSTEM
4 PADCHAR
.ELSE SYSTEM
3 PADCHAR
.ENDIF SYSTEM

This parameter is the padding character that is sent to the remote Kermit.
The parameter must be an octal number in the range of 0 to 37 or 177.
All other values are illegal. The default value is 0 (an ASCII NUL).
.b.I+10
Kermit-32>SET SEND PADCHAR nnn
.b
Where nnn is the ASCII value of the character to be used as a pad character
(in octal).
.i-1
.IF SYSTEM
4 START__OF__PACKET
.ELSE SYSTEM
3 START__OF__PACKET
.ENDIF SYSTEM

This command will set the start of packet character for Kermit.  The
start of packet character must be in the range of 0 to 36 octal.
The default value is 1 (ASCII SOH, CTRL-A).  This value should only
be changed if absolutely necessary.  It must be set the same in both
Kermit's.
.b.i+10
Kermit-32>SET SEND START__OF__PACKET 3
.I-1
.IF SYSTEM
4 TIMEOUT
.ELSE SYSTEM
3 TIMEOUT
.ENDIF SYSTEM

This will set the number of seconds before Kermit-32 will time out a message
it has sent to the other Kermit.
message.  This time out is used to handle transmission errors
which totally lose a message. The default value is 15 seconds.
.b.i+10
Kermit-32>SET SEND TIMEOUT n
.b
Where n is the number of seconds to wait for a message (in decimal).
.I-1
.IF SYSTEM
4 END__OF__LINE
.ELSE SYSTEM
3 END__OF__LINE
.ENDIF SYSTEM

This will set the end of line character the Kermit-32 will send to
the remote Kermit.  This is the character which terminates a packet.
The default value is 15 (ASCII CR, CTRL-M).
.b.i+10
Kermit-32>SET SEND END__OF__LINE nnn
.b
Where n is the ASCII value of the character to use for the end of line
character (in octal).
.I-1
.IF SYSTEM
4 QUOTE
.ELSE SYSTEM
3 QUOTE
.ENDIF SYSTEM

This will set the quoting character that Kermit-32 will expect on incoming
messages.  This is the character used to quote control characters.
The default value is 43 (ASCII "#").
.b.i+10
Kermit-32>SET SEND QUOTE nnn
.b
Where nnn is the ASCII value of the quoting character (in octal).

.I-1
.IF SYSTEM
2 SHOW
.ELSE SYSTEM
1 SHOW
.ENDIF SYSTEM

The SHOW command will allow you to show the various parameters that are set
with the SET command.
.I-1
.IF SYSTEM
3 ALL
.ELSE SYSTEM
2 ALL
.ENDIF SYSTEM

The SHOW ALL command will cause all of the parameters to be listed.
.I-1
.IF SYSTEM
3 BLOCK__CHECK__TYPE
.ELSE SYSTEM
2 BLOCK__CHECK__TYPE
.ENDIF SYSTEM

This command will type out what type of block check is being requested.
.i-1
.IF SYSTEM
3 COMMUNICATIONS
.ELSE SYSTEM
2 COMMUNICATIONS
.ENDIF SYSTEM

This command will type out the communcations line related parameters.
This includes the terminal line being used, the parity type, etc.
.I-1
.IF SYSTEM
3 DEBUGGING
.ELSE SYSTEM
2 DEBUGGING
.ENDIF SYSTEM

The SHOW DEBUGGING command will print the state of the debugging flag.
.I-1
.IF SYSTEM
3 DELAY
.ELSE SYSTEM
2 DELAY
.ENDIF SYSTEM

This will display the number of seconds delay that Kermit will use before
attempting to send or receive a file.
.I-1
.IF SYSTEM
3 ESCAPE
.ELSE SYSTEM
2 ESCAPE
.ENDIF SYSTEM

This will display the current escape character for the CONNECT processing.
.I-1
.IF SYSTEM
3 FILE__PARAMETERS
.ELSE SYSTEM
2 FILE__PARAMETERS
.ENDIF SYSTEM

This will display the parameters related to files being used.  This includes
the file type and the incomplete file disposition.
.I-1
.IF SYSTEM
3 FILE__TYPE
.ELSE SYSTEM
2 FILE__TYPE
.ENDIF SYSTEM

This will display the current file type that is used in sending the file
to or receiving the from the micro computer.
.I-1
.IF SYSTEM
3 INCOMPLETE__FILE__DISPOSITION
.ELSE SYSTEM
2 INCOMPLTE__FILE__DISPOSITION
.ENDIF SYSTEM

This will display the disposition of incompletely received files.
.I-1
.IF SYSTEM
3 LOCAL__ECHO
.ELSE SYSTEM
2 LOCAL__ECHO
.ENDIF SYSTEM

This will display the status of the local echo flag.
.I-1
.IF SYSTEM
3 PACKET
.ELSE SYSTEM
2 PACKET
.ENDIF SYSTEM

This will display the current settings of the send and receive packet
parameters.
.I-1
.IF SYSTEM
3 PARITY
.ELSE SYSTEM
2 PARITY
.ENDIF SYSTEM

This will display the current parity setting.
.I-1
.IF SYSTEM
3 SEND
.ELSE SYSTEM
2 SEND
.ENDIF SYSTEM

All of the send parameters will be displayed on the user's terminal.
.I-1
.IF SYSTEM
3 RECEIVE
.ELSE SYSTEM
2 RECEIVE
.ENDIF SYSTEM

The current values of the RECEIVE parameters will be displayed on the user's
terminal.  Only the parmeters that can be set will be displayed.
.I-1
.IF SYSTEM
3 RETRY
.ELSE SYSTEM
2 RETRY
.ENDIF SYSTEM

This command will show the maximum retry attempts that Kermit will attempt to
send a message the remote.

.i-1
.IF SYSTEM
2 STATUS
.ELSE SYSTEM
1 STATUS
.ENDIF SYSTEM

The current status of Kermit-32 will be displayed.  This includes the number
of characters that have been sent and received from the remote Kermit.
Also included is an estimate of the effective baud rate of the transfer.
This number is not intended to be exact, but only an indication of what
range of throughput has been provided.