home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Columbia Kermit
/
kermit.zip
/
b
/
vmsmit.doc
< prev
next >
Wrap
Text File
|
2020-01-01
|
54KB
|
2,613 lines
1 ASCII_Set
Oct Char Oct Char Oct Char Oct Char
--- ---- --- ---- --- ---- --- ----
0 NUL 40 SP 100 @ 140 `
1 SOH 41 ! 101 A 141 a
2 STX 42 " 102 B 142 b
3 ETX 43 # 103 C 143 c
4 EOT 44 $ 104 D 144 d
5 ENQ 45 % 105 E 145 e
6 ACK 46 & 106 F 146 f
7 BEL 47 ' 107 G 147 g
10 BS 50 ( 110 H 150 h
11 HT 51 ) 111 I 151 i
12 LF 52 * 112 J 152 j
13 VT 53 + 113 K 153 k
14 FF 54 , 114 L 154 l
15 CR 55 - 115 M 155 m
16 SO 56 . 116 N 156 n
17 SI 57 / 117 O 157 o
20 DLE 60 0 120 P 160 p
21 DC1 61 1 121 Q 161 q
22 DC2 62 2 122 R 162 r
23 DC3 63 3 123 S 163 s
24 DC4 64 4 124 T 164 t
25 NAK 65 5 125 U 165 u
26 SYN 66 6 126 V 166 v
27 ETB 67 7 127 W 167 w
30 CAN 70 8 130 X 170 x
31 EM 71 9 131 Y 171 y
32 SUB 72 : 132 Z 172 z
33 ESC 73 ; 133 [ 173 {
34 FS 74 < 134 \ 174 |
35 GS 75 = 135 ] 175 }
36 RS 76 > 136 ^ 176 ~
37 US 77 ? 137 _ 177 DEL
1 BYE
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 VAX/VMS.
Kermit-32>BYE
1 CONNECT
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 type-out 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:
Kermit-32>CONNECT
or
Kermit-32>CONNECT terminal-name
where 'terminal-name' is the terminal line name to be used.
2 Escape_Character
This character is used to issue a limited set of commands to
Kermit-32 after using the CONNECT command. Its default value is
CTRL-] (35 octal, ASCII GS) and can be changed via the SET ESCAPE
command. 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 to which Kermit-32 is CONNECTing. The command that is issued
is determined by the character that is typed after the escape
character. The following characters are recognized by Kermit-32
after the escape character:
C - Return to VAX/VMS Kermit-32
Q - Suspend logging to session log file (if any)
R - Resume logging to session log file (if any)
S - Show status
0 - Send a null
? - Type this text
CTRL-] - Send escape character
Any other character will cause Kermit-32 to ring the bell at the
local terminal. The escape-character S (show status) command
displays the terminal line being used, the escape character and the
settings of local echo, parity and session logging.
1 Control_Chars
During a file transfer (GET, RECEIVE or SEND commands) with Kermit-32
in local mode the following control characters can be used to affect
the transfer in progress:
CTRL-A - Print a brief status report
CTRL-C - Abort the protocol
CTRL-D - Turn logging to the debugging log file on/off
CTRL-M - (or RETURN) Force a protocol timeout
CTRL-X - Abort the file currently being transferred
CTRL-Z - Abort the file group currently being transferred
The CTRL-A status report displays the protocol state and the number
of NAKs sent and received.
1 EXIT
The EXIT command will cause Kermit-32 to return to command level.
This command is the same as the QUIT command. An example of this
command is:
Kermit-32>EXIT
1 FINISH
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.
Kermit-32>FINISH
1 GET
The GET command is used to have a local mode Kermit-32 request a file
from a remote Kermit server. 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:
Kermit-32>GET file-spec
Where 'file-spec' is any valid file specification on the system on
which the server Kermit is running.
1 HELP
Typing HELP alone prints a brief summary of Kermit-32 and its
commands. You can also type
Kermit-32>HELP topic [subtopic]...
for any Kermit-32 command, e.g. "help send" or "help set parity" to
get more detailed information about a specific command.
1 LOCAL
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.
Kermit-32>LOCAL keyword arguments
Where 'keyword' is the name of the command, and 'arguments' are the
optional arguments for the command.
2 COPY
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.
Kermit-32>LOCAL COPY old-local-file
New file: new-local-file
Where 'old-local-file' is the name of the file you wish to copy, and
'new-local-file' is the name for the copy.
2 CWD
This command (short for "Change Working Directory") causes Kermit-32
to change 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.
Kermit-32>LOCAL CWD local-directory-spec
or
Kermit-32>LOCAL CWD
Where 'local-directory-spec' is the device and/or directory portion
of a standard VAX/VMS file specification. It may include logical
names, but not wild-cards.
2 DELETE
This causes Kermit-32 to delete the specified file(s). This uses the
standard DCL DELETE command.
Kermit-32>LOCAL DELETE file-spec
Where 'file-spec' is a valid VAX/VMS file specification.
2 DIRECTORY
This causes Kermit-32 to display a directory listing. This uses the
standard DCL DIRECTORY command.
Kermit-32>LOCAL DIRECTORY file-spec
or
Kermit-32>LOCAL DIRECTORY
Where 'file-spec' is a valid VAX/VMS file specification.
2 DISK_USAGE
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.
Kermit-32>LOCAL DISK_USAGE uic
or
Kermit-32>LOCAL DISK_USAGE
Where 'uic' is a UIC specification (in square brackets). LOCAL SPACE
is a synonym for the LOCAL DISK_USAGE command.
2 HELP
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.
Kermit-32>LOCAL HELP
2 HOST
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.
Kermit-32>LOCAL HOST command
Where 'command' is any valid DCL command.
2 RENAME
This command causes Kermit-32 to change the name of a file. This
uses the standard DCL RENAME command.
Kermit-32>LOCAL RENAME old-local-file
New file: new-local-file
Where 'old-local-file' is the name of the file to be renamed, and
'new-local-file' is the new name for the file.
2 SEND_MESSAGE
This command causes Kermit-32 to send a short (one line) message to
the given terminal. Because this uses the DCL REPLY command, OPER
privilege is needed.
Kermit-32>LOCAL SEND_MESSAGE terminal-name
Message: message-text
Where 'terminal-name' is a valid name for a terminal, and
'message-text' is the message to be sent.
2 TYPE
This causes Kermit-32 to display the specified file(s) on the
terminal.
Kermit-32>LOCAL TYPE file-spec
Where 'file-spec' is a valid VAX/VMS file specification.
2 WHO
This displays the output of a DCL SHOW SYSTEM command.
Kermit-32>LOCAL WHO
1 LOG
The LOG command allows the user to specify the file names to be used
for the various log files Kermit-32 is capable of creating. A LOG
command without a file specification will cause no log file of that
type to be created.
Kermit-32>LOG log-type file-spec
or
Kermit-32>LOG log-type
Where 'log-type' is DEBUG, SESSION, or TRANSACTION, and 'file-spec'
is the file specification to use for that type of log file. If
file-spec does not specify a file-type Kermit-32 will supply a
default of .LOG. If 'file-spec' is not present, that type of logging
is disabled.
2 DEBUG
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.
Kermit-32>LOG DEBUG file-spec
or
Kermit-32>LOG DEBUG
Where 'file-spec' is the file specification to use for the debugging
log file. If file-spec does not specify a file-type Kermit-32 will
supply a default of .LOG. If 'file-spec' is not present, the
debugging log file is disabled.
2 SESSION
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.
Kermit-32>LOG SESSION file-spec
or
Kermit-32>LOG SESSION
Where 'file-spec' is the file specification to use for the session
log file. If file-spec does not specify a file-type Kermit-32 will
supply a default of .LOG. If 'file-spec' is not present, the session
log file is disabled.
2 TRANSACTION
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.
Kermit-32>LOG TRANSACTION file-spec
or
Kermit-32>LOG TRANSACTION
Where 'file-spec' is the file specification to use for the
transaction log file. If file-spec does not specify a file-type
Kermit-32 will supply a default of .LOG. If 'file-spec' is not
present, the transaction log file is disabled.
1 LOGOUT
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.
Kermit-32>LOGOUT
1 Notes
Kermit-32 knows how to handle most standard file types. However, it
does not properly handle "stream" files. You will probably find that
stream files that contain binary data will confuse Kermit-32, very
likely causing buffer overflows. You may be able to get around the
problem by SET FILE TYPE BLOCK, but there is no guarantee the file
will get through unscathed. Your best option would be to convert any
stream files to another type before transferring them.
FILE TYPE BLOCK causes Kermit to do Block I/O operations ($READ,
$WRITE), instead of the normal RMS $GET and $PUT operations. Any
file can be transferred using Block I/O, but the record information
will be lost.
When reading a file (any file type that Kermit-32 understands), it is
not necessary to tell Kermit what the file type is. When writing a
file, be sure to set FILE TYPE BINARY or FILE TYPE FIXED as
appropriate if the file is not a text file.
1 PUSH
The PUSH command spawns a DCL subprocess which allows you to interact
with DCL without exiting Kermit-32.
1 QUIT
This command will cause Kermit-32 to return to command level. This
is the same as the EXIT command.
Kermit-32>QUIT
1 RECEIVE
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 VAX/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 VAX/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:
Kermit-32>RECEIVE
or
Kermit-32>RECEIVE file-spec
Where 'file-spec' is any valid VAX/VMS file specification.
1 REMOTE
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 respond with a message saying the
command is not implemented if it does not support it.
Kermit-32>REMOTE keyword arguments
Where 'keyword' is the name of the command, and 'arguments' are the
optional arguments for the command.
2 COPY
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 versions of Kermit will allow wild-carded copies, while others
will only allow a single file to be copied per command.
Kermit-32>REMOTE COPY old-remote-file
New file: new-remote-file
Where 'old-remote-file' is the name of the file you wish to copy, and
'new-remote-file' is the name for the copy.
2 CWD
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.
Kermit-32>REMOTE CWD remote-directory-spec
Password: password for remote directory
or
Kermit-32>REMOTE CWD
Where 'remote-directory-spec' is a string which is acceptable as a
directory specification 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.
2 DELETE
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.
Kermit-32>REMOTE DELETE file-spec
Where 'file-spec' is a valid file specification for the remote
Kermit's system.
2 DIRECTORY
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.
Kermit-32>REMOTE DIRECTORY file-spec
or
Kermit-32>REMOTE DIRECTORY
Where 'file-spec' is a valid file specification for the server
Kermit's system.
2 DISK_USAGE
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).
Kermit-32>REMOTE DISK_USAGE directory-spec
or
Kermit-32>REMOTE DISK_USAGE
Where 'directory-spec' is a directory specification for the server
Kermit's system. REMOTE SPACE is a synonym for the REMOTE DISK_USAGE
command.
2 EXIT
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.
Kermit-32>REMOTE EXIT
2 HELP
This causes Kermit-32 to request the server Kermit to reply with a
short 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.
Kermit-32>REMOTE HELP
or
Kermit-32>REMOTE HELP topic
Where 'topic' is a subject for more detailed help. If no topic is
given, a general help message is requested.
2 HOST
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.
Kermit-32>REMOTE HOST command
Where 'command' is any valid command to be processed by the remote
systems standard command parser.
2 LOGIN
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.
Kermit-32>REMOTE LOGIN user-id
Account: remote-accounting-info
Password: remote-password
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.
2 LOGOUT
This command is the same as the LOGOUT command. It will request the
server Kermit to exit and logout its job.
Kermit-32>REMOTE LOGOUT
2 RENAME
This command causes Kermit-32 to request that the server Kermit
change the name of a file. The server Kermit should respond with an
indication that the operation is completed successfully, or else with
an error message. Some version of Kermit may allow wild-card file
specifications to be used, and will respond with a list of files and
new names.
Kermit-32>REMOTE RENAME old-remote-file
New file: new-remote-file
Where 'old-remote-file' is the name of the file to be renamed, and
'new-remote-file' is the new name for the file.
2 SEND_MESSAGE
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.
Kermit-32>REMOTE SEND_MESSAGE destination-address
Message: message-text
Where 'destination-address' is a valid destination for the server's
system, and 'message-text' is the message to be sent.
2 STATUS
This requests the status of the server Kermit. The server Kermit
will reply with some indication of its status.
Kermit-32>REMOTE STATUS
2 TYPE
This causes Kermit-32 to request the server Kermit to transmit the
specified file (or files if the server supports wild-cards) so that
the file(s) can be typed on the users terminal.
Kermit-32>REMOTE TYPE file-spec
Where 'file-spec' is a valid file specification for the server
Kermit's system.
2 WHO
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.
Kermit-32>REMOTE WHO user-id
Options: options-list
Where 'user-id' is an optional string representing a specific user,
and 'options-list' is an optional list of formatting or selection
options.
1 SEND
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 VAX/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.
Kermit-32>SEND file-spec
Where 'file-spec' is any valid VAX/VMS file specification.
1 SERVER
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 command must be done
first. At this time there is no way for Kermit-32 to determine
whether an incoming file is ASCII or binary.
Kermit-32>SERVER
1 SET
The SET command is used to set various parameters in Kermit-32.
2 BLOCK_CHECK_TYPE
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 checks 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 programs 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.)
Kermit-32>SET BLOCK_CHECK_TYPE type
Where 'type' is one of:
o 1_CHARACTER_CHECKSUM or ONE_CHARACTER_CHECKSUM
o 2_CHARACTER_CHECKSUM or TWO_CHARACTER_CHECKSUM
o 3_CHARACTER_CRC_CCITT or THREE_CHARACTER_CRC_CCITT
2 DEBUGGING
The SET DEBUGGING command is used to set the debug type-out on the
user's terminal. The command will accept either of the states 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.
Kermit-32>SET DEBUGGING state
Where 'state' is either ON or OFF.
2 DELAY
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.
Kermit-32>SET DELAY n
Where 'n' is the number of seconds to wait before sending data.
2 ESCAPE
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 35 octal (ASCII GS, CTRL-]).
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 to which
Kermit-32 is CONNECTing.
Kermit-32>SET ESCAPE octal-char-value
Where 'octal-char-value' is the ASCII value (in octal) of the
character to use as the escape character.
2 FILE
The SET FILE command allows setting of parameters relating to the
file format and file naming conventions used by Kermit-32.
3 BLOCKSIZE
This command sets the record size to be used when creating
(receiving) files in either BINARY or FIXED mode.
Kermit-32>SET FILE BLOCKSIZE n
Where 'n' is the record size in bytes. The default is 512 byte
records.
3 NAMING
This command sets the type of processing Kermit-32 should do on file
names that are being sent and received. Kermit-32 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-32 can either attempt to
use it as a VAX/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.
Kermit-32>SET FILE NAMING type
Where 'type' is either FULL, NORMAL_FORM or UNTRANSLATED.
4 FULL
This will cause Kermit-32 to send complete file specifications and
perform no translations on received file specifications.
4 NORMAL_FORM
This will cause Kermit-32 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.
4 UNTRANSLATED
This will cause Kermit-32 to send only the file name and file type,
and perform no translations on received file specifications.
3 TYPE
This command will set the file type that Kermit-32 is receiving. A
file type of ASCII should be used to receive text files which are to
be used as text files on the VAX/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.
Kermit-32>SET FILE TYPE type
Where 'type' is either ASCII, BINARY, BLOCK or FIXED.
4 ASCII
File type ASCII is for text files.
4 BINARY
File type BINARY is for non-text files. Note that binary files which
are generated on a VAX/VMS system cannot be transferred to another
VAX/VMS system without losing file attributes.
4 BLOCK
File type BLOCK causes Kermit to do Block I/O operations ($READ,
$WRITE), instead of the normal RMS $GET and $PUT operations. Any
file can be transferred using Block I/O, but the record information
will be lost.
This type is most useful when a file has a set of attributes which
would generate extra characters when kermit transmits a line. One
such example would be a file with the record attribute of "Carriage
return carriage control" and a record format of FIXED or STREAM.
Type BINARY would normally add a <CR><LF> at the end of each record
transmitted; type BLOCK will transmit the file as it is stored on
disk, including record length counts or record seperators imbedded in
the file, without regard for record boundaries.
4 FIXED
The FIXED file type will cause Kermit-32 to create a file with fixed
length records, containing only the data received from the other
Kermit. Unless specified with the SET FILE BLOCKSIZE command the
file will be created with 512 byte records. This format can be used
for transferring VAX/VMS .EXE files or RSX-11/M (P/OS) .TSK files, or
any other binary file which is stored in fixed length record format.
2 HANDSHAKE
Sets the half duplex line turnaround handshake character Kermit-32
will use. Normally required for communication with half duplex
systems like IBM mainframes.
Kermit-32>SET HANDSHAKE octal-char-value
or
Kermit-32>SET HANDSHAKE NONE
Where 'octal-char-value' is the ASCII value (in octal) of the
character to use for the handshake character. The SET HANDSHAKE NONE
command turns handshaking off.
2 IBM_MODE
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.
Kermit-32>SET IBM_MODE state
Where 'state' is either ON or OFF.
2 INCOMPLETE_FILE_DISPOSITION
The SET INCOMPLETE_FILE_DISPOSITION command allows the user to
determine what is done with a file that is not completely received.
If the disposition is KEEP, all files 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.
Kermit-32>SET INCOMPLETE_FILE_DISPOSITION action
Where 'action' is either DISCARD or KEEP.
2 LINE
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).
Kermit-32>SET LINE terminal-name
The 'terminal-name' device must be a terminal line (e.g. TTA0:).
2 LOCAL_ECHO
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).
Kermit-32>SET LOCAL_ECHO state
Where 'state' is either ON or OFF.
2 MESSAGE
This command sets the type of type-out Kermit-32 will do during
transfers in local mode. Kermit-32 can type out the file
specification being transferred, the packet numbers being sent and
received, both or neither. The default is to type file
specifications but not packet numbers.
Kermit-32>SET MESSAGE type state
Where 'type' is either FILE or PACKET, and 'state' is either ON or
OFF.
2 PARITY
This command determines the type of parity to use on the transmission
line. Kermit-32 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-32 can send characters as
seven data bits plus a parity bit.
Kermit-32>SET PARITY state
Where 'state' is one of:
o NONE (default) - eight data bits and no parity bit.
o MARK - seven data bits with the parity bit set to one.
o SPACE - seven data bits with the parity bit set to zero.
o EVEN - seven data bits with the parity bit set to make the
overall parity even.
o ODD - seven data bits with the parity bit set to make the overall
parity odd.
2 PROMPT
This command sets the string to be used for the command prompt. If
no argument is given, the default prompt (Kermit-32>) is used.
Kermit-32>SET PROMPT new-prompt-text
or
Kermit-32>SET PROMPT
Where 'new-prompt-text' is the new prompt to use.
2 RECEIVE
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.
3 END_OF_LINE
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 parameter must be an octal number in the
range 1 to 37. The default value is 15 octal (ASCII CR, CTRL-M).
Kermit-32>SET RECEIVE END_OF_LINE octal-char-value
Where 'octal-char-value' is the ASCII value (in octal) of the
character to use for the end of line character.
3 EIGHT_BIT_QUOTE
This command sets the character to be used (when necessary) to quote
characters which have the eighth bit (parity bit) set. This is used
to transfer eight-bit bytes on a transmission medium which only
supports seven data bits. The parameter must be an octal number in
the range 41 to 76 or 140 to 176. The default value is 46 octal
(ASCII "&"). Eighth-bit quoting will only be used if both Kermit
programs can handle it, and the transmission medium does not transmit
8 data bits (as indicated by the SET PARITY command).
Kermit-32>SET RECEIVE EIGHT_BIT_QUOTE octal-char-value
Where 'octal-char-value' is the ASCII value (in octal) of the
character to use for quoting characters which have the eighth bit
set.
3 PACKET_LENGTH
This will set the receive packet length. The value for this
parameter must be between 10 and 1000. Packet lengths outside of
this range are illegal. The default value is 80.
Kermit-32>SET RECEIVE PACKET_LENGTH n
Where 'n' is the receive packet length to use.
3 PADCHAR
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. The default value is 0 (ASCII NUL, CTRL-@).
Kermit-32>SET RECEIVE PADCHAR octal-char-value
Where 'octal-char-value' is the ASCII value (in octal) of the
character to be used as a pad character.
3 PADDING
This command will set the number of padding characters that will be
sent to the other Kermit. The default value is 0.
Kermit-32>SET RECEIVE PADDING n
Where 'n' is the number of padding characters to use.
3 QUOTE
This will set the quoting character that Kermit-32 will expect on
incoming messages. This is the character used to quote control
characters. The parameter must be an octal number in the range 40 to
176. The default value is 43 octal (ASCII "#").
Kermit-32>SET RECEIVE QUOTE octal-char-value
Where 'octal-char-value' is the ASCII value (in octal) of the quoting
character.
3 START_OF_PACKET
This command will set the start of packet character for Kermit-32.
The start of packet character must be in the range of 1 to 37 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 programs.
Kermit-32>SET RECEIVE START_OF_PACKET octal-char-value
Where 'octal-char-value' is the ASCII value (in octal) of the receive
start-of-packet character to use.
3 TIMEOUT
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.
Kermit-32>SET RECEIVE TIMEOUT n
Where 'n' is the number of seconds to wait for a message.
2 REPEAT_QUOTE
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
programs must support repeat compression for this to be in effect.
The parameter must be an octal number in the range 41 to 76 or 140 to
176. The default value is 176 octal (ASCII "~"). The character will
only be used on files which are being transmitted by Kermit-32. The
REPEAT_QUOTE character used for incoming files is decided on by the
other Kermit. A value of 40 octal (a space) will disable repeat
compression.
Kermit-32>SET REPEAT_QUOTE octal-char-value
Where 'octal-char-value' is the ASCII value (in octal) for the repeat
quoting character.
2 RETRY
This command sets the maximum number of times Kermit-32 should try to
send specific packets. 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.
Kermit-32>SET RETRY type n
Where 'type' is either INITIAL_CONNECTION (for initial connection
packet) or PACKET (for all other packets), and 'n' is the number of
retries (in decimal) to attempt.
2 SEND
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 programs 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.
3 END_OF_LINE
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 parameter must be an octal number in the range 1 to 37. The
default value is 15 octal (ASCII CR, CTRL-M).
Kermit-32>SET SEND END_OF_LINE octal-char-value
Where 'octal-char-value' is the ASCII value (in octal) of the
character to use for the end of line character.
3 PACKET_LENGTH
This will set the SEND packet length. The value for this parameter
must be between 10 and 1000. Packet lengths outside of this range
are illegal. The default value is 80.
Kermit-32>SET SEND PACKET_LENGTH n
Where 'n' is the send packet length to use.
3 PADCHAR
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. The default value is 0 (ASCII NUL, CTRL-@).
Kermit-32>SET SEND PADCHAR octal-char-value
Where 'octal-char-value' is the ASCII value (in octal) of the
character to be used as a pad character.
3 PADDING
This command will set the number of padding characters that will be
sent to the other Kermit. The default value is 0.
Kermit-32>SET SEND PADDING n
Where 'n' is the number of padding characters to use.
3 QUOTE
This will set the quoting character that Kermit-32 will expect on
incoming messages. This is the character used to quote control
characters. The parameter must be an octal number in the range 40 to
176. The default value is 43 octal (ASCII "#").
Kermit-32>SET SEND QUOTE octal-char-value
Where 'octal-char-value' is the ASCII value (in octal) of the quoting
character.
3 START_OF_PACKET
This command will set the start of packet character for Kermit-32.
The start of packet character must be in the range of 1 to 37 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 programs.
Kermit-32>SET SEND START_OF_PACKET octal-char-value
Where 'octal-char-value' is the ASCII value (in octal) of the
start-of-packet character to use.
3 TIMEOUT
This will set the number of seconds before Kermit-32 will time out a
message it has sent to the other Kermit. This time out is used to
handle transmission errors which totally lose a message. The default
value is 15 seconds.
Kermit-32>SET SEND TIMEOUT n
Where 'n' is the number of seconds to wait for a message.
2 SERVER_TIMER
This specifies the number of seconds between timeouts during server
command wait. A value of 0 specifies that no timeouts should occur
during server command wait. When a Kermit server times out, it sends
a NAK packet. Some systems cannot clear piled-up NAKs from their
input buffers; if you're using such a system to communicate with a
Kermit-32 server, and you expect to be leaving the server idle for
long periods of time, you should use this command to turn off server
command-wait timeouts.
Kermit-32>SET SERVER_TIMEOUT n
Where 'n' is the number of seconds between server timeouts.
2 TRANSMIT
It is possible to set a few parameters associated with the raw
TRANSMIT command that vary both what the user sees on the screen as
well as the speed of the transmit.
3 DELAY
This parameter is the amount of time to delay after each carriage
return is transmitted. Valid delay values range between 0 (the
default) and 9 tenths of a second. The format of the command is:
Kermit-32>SET TRANSMIT DELAY d
Where 'd' is a single decimal digit representing tenths of a second.
Some remote hosts may not be able to receive the characters as fast
as Kermit-32 can send them. The TRANSMIT DELAY can be used to slow
up the transfer by adding a slight delay after each line is sent.
The transfer also runs slower if the transmit echo is on, and the
remote system is echoing the characters as it receives them. If the
transmit delay is set to 9 tenths of a second, the remote system is
echoing characters, the transmit echo is on, and the remote system
still cannot keep up, then the connection should be made at a slower
baud rate.
Conversely, the file transfer speed can be increased by: setting the
delay to 0 and the echo off, stopping the remote system from echoing
the characters it receives, and connecting at higher baud rates.
3 ECHO
This command controls what the user sees on the screen during the
file transfer. The format of the command is:
Kermit-32>SET TRANSMIT ECHO state
Where 'state' is either ON or OFF.
By default, the transmit echo is left off and the user sees the
number of each line after it has been transmitted. With transmit
echo on, the user sees whatever the remote system would normally echo
back to him while he is typing in a file. Note that turning the echo
on typically slows the file transfer down.
1 SHOW
The SHOW command will allow you to show the various parameters that
are set with the SET command.
2 ALL
The SHOW ALL command will cause all of the parameters to be listed.
2 BLOCK_CHECK_TYPE
This command will type out what type of block check is being
requested.
2 COMMUNICATIONS
This command will type out the communications line related
parameters. This includes the terminal line being used, the parity
type, etc.
2 DEBUGGING
The SHOW DEBUGGING command will print the state of the debugging
flag.
2 DELAY
This will display the number of seconds delay that Kermit-32 will use
before attempting to send or receive a file.
2 ESCAPE
This will display the current escape character for the CONNECT
processing.
2 FILE_PARAMETERS
This will display the parameters related to files being used. This
includes the file type and the incomplete file disposition.
2 INCOMPLETE_FILE_DISPOSITION
This will display the disposition of incompletely received files.
2 LINE
This command displays the terminal line that will be used for CONNECT
and file transfers commands.
2 LOCAL_ECHO
This will display the status of the local echo flag.
2 PACKET
This will display the current settings of the send and receive packet
parameters.
2 PARITY
This will display the current parity setting.
2 RECEIVE
The current values of the RECEIVE parameters will be displayed on the
user's terminal. Only the parameters that can be set will be
displayed.
2 RETRY
This command will show the maximum number of retries that Kermit-32
will attempt to send a message to the remote Kermit.
2 SEND
All of the send parameters will be displayed on the user's terminal.
2 TIMING
All of the timing parameters will be displayed on the user's
terminal.
2 TRANSMIT
This will display the parameters related to the TRANSMIT command.
2 VERSION
Displays the version number of Kermit-32 in use.
1 Startup
2 KER$COMM
When Kermit-32 is first invoked it will attempt to use the
translation of the logical name KER$COMM as the default terminal line
for external communications.
2 VMSKERMIT
When Kermit-32 is first invoked it looks for a file specified by the
VMSKERMIT logical name assignment to use as an initialization file.
If this file does not exist Kermit-32 looks for a file in your
default directory with the name VMSKERMIT.INI.
If either of the above cases is true Kermit-32 will use this file as
a startup command file.
If the file does not exist Kermit-32 starts up in the default state.
For instance, placing the following two lines in the startup file
would simplify using Kermit-32's large packet capability.
SET RECEIVE PACKET_LENGTH 1000
SET SEND PACKET_LENGTH 1000
1 STATUS
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.
1 TAKE
The TAKE command tells Kermit-32 to execute commands from the
specified file. You may also use the VAX/VMS notation "@" instead of
Take to specify a command file.
Kermit-32>TAKE file-spec
or
Kermit-32>TAKE file-spec /DISPLAY
Where 'file-spec' is any normal VAX/VMS file specification. If
file-spec does not specify a file-type Kermit-32 will supply a
default of .COM. The /DISPLAY option causes the commands read from
the file to be displayed on the user's terminal.
1 TRANSMIT
The TRANSMIT command will allow you to transmit a file(s) to remote
systems that do not have Kermit available. Note that there is no
error checking or packets involved in this method of file transfer.
The format of the command is:
Kermit-32>TRANSMIT file-spec
Where 'file-spec' is any valid VAX/VMS file specification.
This command does a raw transmit of an ASCII file, one character at a
time, with carriage returns (no line-feeds) at the end of each line.
It is used with Kermit-32 in local mode. The user must first prepare
the remote host to receive the file by starting an edit session in
input mode. Then the user can escape back to Kermit-32 and issue the
TRANSMIT command. After the transmit is finished, the user then
CONNECTs back to the remote host again and ends the edit session.
2 Control_Characters
During a file transmit, the following control characters can be used
to affect the transfer in progress:
CTRL-C - Abort the transmit
CTRL-X - Abort the file currently being transmitted
CTRL-Z - Abort the file group currently being transmitted
2 Delay
Some remote hosts may not be able to receive the characters as fast
as Kermit-32 can send them. The SET TRANSMIT DELAY command can be
used to slow up the transfer by adding a slight delay after each line
is sent.
The transfer also runs slower if the transmit echo is on, and the
remote system is echoing the characters as it receives them. If the
transmit delay is set to 9 tenths of a second, the remote system is
echoing characters, the transmit echo is on, and the remote system
still cannot keep up, then the connection should be made at a slower
baud rate.
Conversely, the file transfer speed can be increased by: setting the
delay to 0 and the echo off, stopping the remote system from echoing
the characters it receives, and connecting at higher baud rates.
2 Echo
The SET TRANSMIT ECHO command controls what the user sees on the
screen during the file transfer. With transmit echo off, the user
sees the number of each line after it has been transmitted. With
transmit echo on, the user sees whatever the remote system would
normally echo back to the user while he is typing in a file.
