V03.62-5_min 31-May-93 1 ?

advertisement
V03.62-5_min 31-May-93
1 ?
The question mark used as an argument dumps the dispatch
table for that command, thus listing all things possible:
Kermit-11>?
; display available commands
Kermit-11>SET ?
; show all possible sets
Kermit-11>SET FILE ?
; list all valid options
1 @
Open an indirect file for command input. Same as TAKE.
If no device is specified DK and SY will be tried in
that order. Either "!" or ";" may be used as a comment
delimiter in Kermit-11 TAKE files. All Kermit commands
except control characters are ok, and EXIT may be used
in place of ^Z.
Kermit-11>@ file
Kermit-11>@file
; default type is .COM
; RT-11 syntax is ok
1 ASCII_Set
Table of Octal, Decimal and Hex values for ASCII characters
Char
Hex
----NUL
60
SOH
61
STX
62
ETX
63
EOT
64
ENQ
65
ACK
66
BEL
67
BS
68
HT
69
LF
6A
Key Oct Dec Hex
Ch Oct Dec Hex
Ch Oct Dec Hex
Ch Oct Dec
--- --- --- ---
-- --- --- ---
-- --- --- ---
-- --- --- -
^SP 000
0.
0
SP 040 32. 20
@
100 64. 40
`
140
96.
^A
001
1.
1
!
041 33. 21
A
101 65. 41
a
141
97.
^B
002
2.
2
"
042 34. 22
B
102 66. 42
b
142
98.
^C
003
3.
3
#
043 35. 23
C
103 67. 43
c
143
99.
^D
004
4.
4
$
044 36. 24
D
104 68. 44
d
144 100.
^E
005
5.
5
%
045 37. 25
E
105 69. 45
e
145 101.
^F
006
6.
6
&
046 38. 26
F
106 70. 46
f
146 102.
^G
007
7.
7
'
047 39. 27
G
107 71. 47
g
147 103.
^H
010
8.
8
(
050 40. 28
H
110 72. 48
h
150 104.
^I
011
9.
9
)
051 41. 29
I
111 73. 49
i
151 105.
^J
012 10.
A
*
052 42. 2A
J
112 74. 4A
j
152 106.
VT
6B
FF
6C
CR
6D
SO
6E
SI
6F
^K
013 11.
B
+
053 43. 2B
K
113 75. 4B
k
153 107.
^L
014 12.
C
,
054 44. 2C
L
114 76. 4C
l
154 108.
^M
015 13.
D
-
055 45. 2D
M
115 77. 4D
m
155 109.
^N
016 14.
E
.
056 46. 2E
N
116 78. 4E
n
156 110.
^O
017 15.
F
/
057 47. 2F
O
117 79. 4F
o
157 111.
DLE
70
DC1
71
DC2
72
DC3
73
DC4
74
NAK
75
SYN
76
ETB
77
^P
020 16. 10
0
060 48. 30
P
120 80. 50
p
160 112.
^Q
021 17. 11
1
061 49. 31
Q
121 81. 51
q
161 113.
^R
022 18. 12
2
062 50. 32
R
122 82. 52
r
162 114.
^S
023 19. 13
3
063 51. 33
S
123 83. 53
s
163 115.
^T
024 20. 14
4
064 52. 34
T
124 84. 54
t
164 116.
^U
025 21. 15
5
065 53. 35
U
125 85. 55
u
165 117.
^V
026 22. 16
6
066 54. 36
V
126 86. 56
v
166 118.
^W
027 23. 17
7
067 55. 37
W
127 87. 57
w
167 119.
CAN
78
EM
79
SUB
7A
ESC
7B
FS
7C
GS
7D
RS
7E
US
7F
^X
030 24. 18
8
070 56. 38
X
130 88. 58
x
170 120.
^Y
031 25. 19
9
071 57. 39
Y
131 89. 59
y
171 121.
^Z
032 26. 1A
:
072 58. 3A
Z
132 90. 5A
z
172 122.
^[
033 27. 1B
;
073 59. 3B
[
133 91. 5B
{
173 123.
^\
034 28. 1C
<
074 60. 3C
\
134 92. 5C
|
174 124.
^]
035 29. 1D
=
075 61. 3D
]
135 93. 5D
}
175 125.
^~
036 30. 1E
>
076 62. 3E
^
136 94. 5E
~
176 126.
^?
037 31. 1F
?
077 63. 3F
_
137 95. 5F
DEL 177 127.
1 ASSIGN
Like that of RT-11, except only DK (the default disk) is supported.
This specifies what Kermit will use as its default disk, it doesn't
modify the monitor's assignment for DK.
Kermit-11>ASS LD0 DK
1 Binary_Files
Binary files include task or save images and other special types
requiring all eight bits in each byte. Text files like program
sources normally only use the lower seven bits. Binary files
should be transferred on an eight-bit line, which on most PDP-11
systems is the default. Under RT-11 Kermit-11 defaults to space
parity as its handlers are 7-bit devices, and 8-bit quoting will
be required to transfer binary data. This adds a byte for every
one with the high bit set and thus increases the transfer time.
Various Kermits are at different stages of development. Some
may NOT handle binary files automatically thus the command SET
FILE FIXED must be done on BOTH before a binary file transfer.
Versions 2.16 and up of Kermit-11 do automatically switch into
the binary mode. Under RT-11 the file type must be defined in
sending Kermit's binary types list (see HELP SET BINARY) prior
to transmission.
Binary files are best exchanged using CRC error checking. This
isn't the default and may need to be SET on the other Kermit if
it can't recover yours from the init packet.
Note that transferring a text file with one or both Kermits set
to binary mode may result in an unusable file due to the chance
of including embedded record control information. If this does
occur KED may be used (open the file and then immediately EXIT)
to strip the hi bits from it.
Prior to Version 2.21 Kermit-11 didn't support 8-bit prefixing.
Before V2.23, repeat character encoding wasn't supported.
A problem was discovered with attribute packet processing
in versions of Kermit-11 prior to 3.49. This implies that
versions 3.49 or later of Kermit-11 will not be completely
compatible with older versions.
The best workaround until
a copy of ver 3.49 or later can be obtained is to disable
attribute packet processing with the SET NOATTR command then
SET FILE FIXED on BOTH ends before transferring binary data.
1 BUG
Displays where to get help should one encounter a bug in this program.
1 CD
Makes the specified device the default
file operations for which no device is
This only modifies Kermit, the monitor
you'll be back where you started after
disk, directing to it
explicitly specified.
remains unchanged and
exiting the program.
1 CLS
CLear Screen, with numerous resets for VT-100 terminal.
CLX does the same, then enables the reverse video mode.
1 CLX
Clears a VT-100 screen ala CLS, then sets the reverse video mode.
1 COPY
Creates a copy of the input file. Wildcards are not supported,
and it is more efficient to use COPY from the monitor. You may
move a single file retaining the input file name with:
Kermit-11>COP file dev:
1 CWD
Synonym for CD.
1 Debugging
Various debug options are available. See HELP SET DEBUG for
in depth information. Try HELP SET RANDOM regarding a means
to deliberately force errors to test recovery from them, and
HELP EXAMINE for info about looking at data in memory.
Logging to a file:
LOG file debug_mode
Packets/Files/States
SET DEB PACKET file
Raw terminal I/O
SET DEB RAW file
Turn off debugging
SET DEB OFF
1 DELETE
Deletes a single specified file. Wildcards are not supported.
The entire command name "DELETE" must be used (no substring is
acceptable) as some small protection against accidents.
1 DIRECTORY
Displays the default device directory, or that of a specified device.
Wildcarding is implicit regardless of how the monitor has been set.
Switches (/opt) are not implemented.
Kermit-11>DIR
Kermit-11>DIR
Kermit-11>DIR
Kermit-11>DIR
Kermit-11>DIR
Kermit-11>DIR
Kermit-11>DIR
; all files on DK: (default device)
.MAC
; all files of type .MAC (same as *.MAC)
KRT*.MAC
; all beginning with KRT of type .MAC
LD0:.MAC
; all files of type .MAC on LD0:
EDIT.
; file name must be just EDIT with no type
EDIT%
; 5 chars, first 4 are EDIT, any type
.MAP,.SAV ; comma delimits, see HELP SET FILE CSI
1 EXAMINE
Format and print global read/write data to the terminal:
Kermit-11>EXA PACKET
; dump packet buffer to TT
Kermit-11>EXA *
; all defined variables
Kermit-11>EXA 44 ; address of your choice
Please note attempting to examine an illegal address
will crash the program. The .MAP file for the Kermit you
are using may be used to locate addresses not included in
the internal symbol table. Some overlays are permanently
loaded (refer to the link command file for the version in
use) but most are not, and these most likely will be gone
by the time one has returned to Kermit's command line.
1 EXIT
Terminates Kermit-11 and exits to the monitor, resetting the link
device and modem if same were assigned from within the program.
1 HELP
Entering HELP alone prints the list of available topics.
For detailed information about a specific function:
Kermit-11>HELP topic [subtopic] ..
Should one prefer the printed page, this dumps help text
to LP to produce a handy reference:
Kermit-11>HPRINT topic [subtopic] ..
HELP and HPRINT also support wildcarding, as in:
Kermit-11>H *
; everything
Kermit-11>H SET * ; all sets
Kermit-11>H SET FIL * ; all file types
This modified Kermit-11 contains an internal index to its
help text file. If KRTHLP.HLP is modified Kermit must be
rebuilt. See KRTHLP.PRE for instructions.
1 HOME
Resets the default device to the home directory.
This is, if not set otherwise, DK when Kermit-11
was started. SHOW displays current assignments.
1 HPRINT
Like HELP but also dumps text to LP to produce a handy reference:
Kermit-11>HPRINT topic [subtopic] ..
Kermit-11>HPRINT *
You may ASSIGN xx LP under RT-11 (where xx is a disk) then run KRT
and use HPRINT to create a disk file of the text formatted as it's
displayed by the program.
The file name KRTHLP.OUT will be used.
1 LOGFILE
Creates the debug and session logging file. One may optionally specify
a debug mode as an additional argument following the desired file name,
or must later select something to be written into the file. When a log
file is closed all debug modes are reset (turned off). If file size is
a consideration it may be specified via SET FILE CREATE_SIZE first.
Kermit-11>LOG TMP PACK ! default type is .LOG, logs packets
Kermit-11>LOG LP: ALL ! LP MUST be spooled, or very fast..
Kermit-11>LOG
! close file, turn off debugging
Check HELP Debug for a brief list or HELP SET DEBUG for detailed
descriptions of debugging modes.
1 Long_Packets
Kermit-11 supports the use of packet lengths greater than 94. This is
particularly useful in file transfers over links with delays exceeding
one second, or whenever transmission errors are sufficiently low that
time saved in ACK packets (as opposed to time lost in resending longer
data packets) improves efficiency. The main restriction on the packet
size is the link, a given circuit may not pass a given number of chars
in a single packet. Also, BOTH Kermits must support this extension to
the protocol, it is always negotiated before any file transfer.
Long packets are enabled by setting the receive
Kermit which will be receiving the transfer:
packet length on the
Kermit>SET RECEIVE PACKET_LENGTH 1024
; use 1kb packets
Kermit>SET BLO 3
; CRC error checking
Here the above may also be accomplished in one command with:
Kermit-11>SET LONG ON
; max packets, CRC error tests
It is highly recommended you use the CRC block check, as the default
type one checksum is inadequate for such packet lengths. Please note
it may be necessary to preset this on both sides, before invoking the
server. The maximum packet size possible here may be determined with
SHOW PARAMETERS.
You may disable long packets at this end via SET NOLONG.
When talking to VMS Kermit or C-Kermit you will probably need to
also SET SEN PAC nnnn on them before long packets will function.
1 Parity
Sometimes what appears to be valid packet is constantly rejected.
This usually happens when the requesting Kermit asks a server for
a file and then rejects the server's first packet until the retry
limit is reached. This may be caused by parity being introduced
somewhere, as when a modem is generating parity, or by a private
or public net. If the communications link is at fault a simple
fix is to SET PARITY SPACE on each Kermit, forcing removal of bit
seven from the incoming data. Normally this will not stop binary
transfers since most Kermits can do eight bit prefixing, a method
of sending eight bit data over a seven bit link. You MUST use
parity (even if MARK or SPACE) when using Kermit-11 with the IBM
CMS Series/1 or 7171 3270 emulator. See HELP SET PARITY for info
about specific options.
Under RT-11 parity will default to SPACE, TT is a 7-bit device.
1 PRINT
Copies a single (non-wildcarded) file to LP.
1 PWD
Displays the current default device (DK), home directory and, if
running under TSX-Plus V6.2 or above, mounted logical disks.
1 QUIT
Synonym for EXIT.
1 RECEIVE
The RECEIVE command tells Kermit-11 to receive a file or file group
from the other system. File names are taken from the incoming file
headers - that is, files to be sent are specified on the other system
with its SEND command (wildcarding may be used if sender supports it):
Kermit>SEND afile ; a single file
Kermit>SEND *.MAC ; all .MAC files
Then one escapes back to one's local machine and initiates receive:
Kermit-11>RECEIVE ; note no file name argument is used
As files are created, their names will be displayed on your screen.
If a file arrives that you don't really want, you can try to cancel it
by typing Ctrl-X which sends the request to the remote Kermit. A file
group can be bombed by typing Ctrl-Z. These control chars are checked
at the end of each DATA packet.
Use Ctrl-C to abort before receiving
the beginning of the first file.
If the first file arrives too soon, use SET DELAY on the sending side.
If an incoming file has the same name as an existing file Kermit-11 by
default will create a new file. To preserve existing files check HELP
SET FILE PROTECT.
When receiving text files from a non RT-11 system this Kermit will add
25% to the received file size as record terminators are often excluded
from what is reported, or are of a different size (Unix). Files close
to the maximum free space may be accommodated by SET FILE CREATE_SIZE,
which overrides any passed size attribute.
If you are trying to receive binary files from a Kermit which does not
support attribute transmission SET FILE TYPE FIXED and SET BLOCK_CHECK
on BOTH ends first, or the transmission may appear fine while all high
bits are actually being tossed.
Normally it is much easier to run the remote Kermit as a SERVER.
that isn't possible, the RECEIVE command is useful.
When
1 RENAME
Renames a single, local (only) file.
Kermit-11>RENAME oldname newname
1 SEND
Sends a file or group of files to the other system.
Wildcards may be
used, in which case files are sent in order of their directory entries
in the device containing them. If you're SENDing on Kermit-11 running
in its remote mode, SET DELAY governs the time allowed to escape back
to one's local Kermit to initiate the RECEIVE mode (default = 6 secs).
If you miss the first packet Kermit will retry it after timing out.
If the automatic
the transmission
for each file.
need to SET FILE
before starting.
binary file select is on (SET FILE AUTO, the default)
mode is determined by searching the binary types list
If it is not possible to exchange attributes you will
TYPE and SET BLOCK_CHECK as required on both sides
If parity is in use (see HELP SET PARITY) Kermit-11 will ask the other
Kermit to use a special kind of "prefixing" notation for binary files.
This is an advanced feature and not all Kermits have it. If the other
Kermit can't accommodate this feature, binary files can not be sent
correctly. This includes executable programs, object modules, and any
text file containing characters with the high bit set.
Kermit-11 will also check the other side for a special prefix encoding
for repeated characters. If supported, files with long strings of the
same character will be transmitted very efficiently.
Columnar data,
highly indented text and binary files are the primary beneficiaries of
this technique.
SEND Command Summary:
Sends files to another Kermit. If that Kermit isn't a server the
transmission begins after the number of seconds specified by SET
DELAY. This allows time to escape back to your local Kermit and
issue a receive command. The server is far easier to use, unless
your Kermit can't do remote commands.
supported.
Wildcarded renaming is not
Kermit-11>SEND *.MAC
Kermit-11>SEND afile asfile ; rename to asfile
Kermit-11>SEND afile,b*,cfile
; comma delimits file names
1 SERVER
The SERVER command puts a remote Kermit into a server mode, so that it
expects further commands as packets from your own local client Kermit,
allowing various things to be done at the remote without the bother of
first connecting back to it. This Kermit-11 when run as a server will
handle these commands:
CD, COPY, DELETE, DIRECTORY, FINISH, GET,
HELP, RENAME, SEND, SPACE and TYPE.
Kermit-11 will use the client's block check scheme, packet length and
such as long as nothing affecting any of that has been shut off before
invoking the server. The BINARY_TYPE list will be used to select text
or image mode when sending unless specific file type has been set. If
your local Kermit doesn't support exchanging attributes, SET FILE TYPE
and SET BLOCK_CHECK as needed on BOTH ends before running the server.
SERVER Command Summary:
REMOTE
REMOTE
REMOTE
REMOTE
FINISH
GET
REMOTE
REMOTE
SEND
REMOTE
REMOTE
COPY Copy a file to another
CWD Changes server default
DELETE
Erases specified file
DIR Prints
a
directory
Exit server, reconnect
Send file(s) to remote
HELP Prints this help text
RENAME
Rename old file to new
Send file(s) to server
SPACE
Shows blocks used/free
TYPE Types a specified file
1 SET
The SET command is used to modify various parameters in Kermit.
Multiple arguments, including spaces between them, for the same
parameter may be delimited with commas.
Kermit-11>SET parameter keyword[, key words_1, keyword_2, ..]
2 ATTRIBUTES
Part of the Kermit protocol is the support of file attributes.
Connected Kermits that support this can send information to each other
about size, date/time of creation, protection and other useful things.
Due to potential problems with incompatible implementations attributes
may be disabled. In this case, Kermit will not send them, even though
the receiver may have indicated that it supports them. The default is
attributes enabled.
Kermit-11>SET ATTR OFF
Kermit-11>SET ATTR ON
Note the determination of whether to send a file in the image mode is
by the state of SET FILE, and it may be necessary to select something
specific (besides AUTO, which defaults to text) for it when disabling
ATTRIBUTES.
When receiving text files from a non RT-11 system this Kermit will add
25% to the received file size as record terminators are often excluded
from what is reported, or are of a different size (Unix). Files close
to the maximum free space may be accommodated by SET FILE CREATE_SIZE,
which overrides any passed size attribute.
This modified Kermit-11 supports the following attributes:
!
"
#
.
0
(oct
(oct
(oct
(oct
(oct
(oct
1
(oct 61)
Notes:
41)
42)
43)
55)
56)
60)
File length (1kb blocks)
File type (ASCII, Binary, Image)
Creation date (1972 to 2099 only)
Protection code (within RT-11's limits)
Machine and operating system of origin
Special system-dependent parameters:
" (oct 42) includes DEC_Multinational files
Exact file length in bytes
File protected when no write, append or delete access.
2 BINARY_TYPE
Kermit-11 maintains a list of file types that's scanned to decide
if a file should be sent in the binary mode.
This list includes
commonly used binary file types, may be displayed with SHO BINARY
and appended up to 31 total types, one type per command line.
Kermit-11>SET BIN xyz
The state of SET FILE determines whether the binary list test will
be used to control the transmission mode for files. Use SHOW FILE
to display it.
2 BLOCK_CHECK_TYPE
Determines the block checking scheme to be used during transmission to
to detect errors. There are three types available: the one character
checksum (default), the two character checksum and the three character
CRC (cyclic redundancy check).
Both Kermits involved in the transfer
must agree on the block check type.
Kermit-11 will request the block
check set by this command be used for a transfer. If the other Kermit
can't recover this from the init packet then the block check type must
be manually set on BOTH sides, otherwise the single character checksum
will be used. Binary files should be sent with CRC block checking.
Kermit-11>SET BLO 1
Kermit-11>SET BLO 2
Kermit-11>SET BLO 3
; one char checksum
; two char checksum
; three char CRC
2 DEBUG
Used to specify the type and level of debugging written to a disk
file, which must first have been created via the LOGFILE command,
or may be optionally specified as an additional argument for this
command. There are also options to display debugging data on the
terminal with or without writing to a disk file.
When a logfile
is closed all debug modes are reset (turned off).
Kermit-11>SET DEBUG mode [logfile]
3 NONE
Turns off all debugging and closes the logfile.
3 OFF
Turns off all debugging and closes the logfile.
3 ON
Enables PACKET logging to the disk file specified by the LOGFILE
command.
3 PACKET
Logs all packets sent and received to the file specified with LOGFILE
using headers indicating packet number, type and length. An asterisk
"*" displayed as the packet type indicates a received checksum error.
If the type itself is bad (not A-Z) a "?" is substituted.
REC.SW = STA.DAT Data
<<< RPACK - Paknum 54
Type *
Length
82
40!100!200>,curatr; hose bits 0,2,5 and unused biuc
6,7#M#J#Ibeq#I10$#M#
J#Iclr#Ipr
BAD Checksum: RCV,CALC = 24670, 3312
>>> SPACK - Paknum 54
Type N
Length
0
Numeric overflow is indicated by a "*" (in the most significant digit's
column) preceding the remainder of the value, which is also displayed.
Received and calculated values of bad checksums are displayed following
any data present in the packet.
Severe telephone line noise and/or retraining of modems may cause a bad
packet length value, in which case data logged are truncated to fit the
maximum available ($ALLSIZ-2) buffer space.
Selecting this option cancels any other debug option(s) then in use.
3 RAW
Logs everything received or sent as 8-bit data to a binary logfile.
This option is mutually exclusive of all other functions.
2 DEFAULT
Makes the specified device the default disk, directing to it
file operations for which no device is explicitly specified.
2 DELAY
Sets the number of seconds to wait before beginning sending a file
while in the remote mode. This is the time allowed to escape back
to your local Kermit and issue a RECEIVE command.
Kermit-11>SET DELAY number_of_seconds
2 END_OF_LINE
The END_OF_LINE parameter is the ASCII character used as a
line terminator for all packets sent to and received from
the other Kermit. This is normally not changed. See HELP
ASCII for octal values.
Kermit-11>SET END octal_value_of_char
2 FILE_TYPE
When it's started Kermit-11 defaults to automatically getting a file
type from the BINARY_TYPE list when sending and incoming attributes
if receiving.
Some Kermits may not accommodate this, in which case
it's necessary to manually SET a particular FILE_TYPE, and match the
BLOCK_CHECK as well, on both sides before continuing.
The file type ASCII should be used to for text files which are to be
used as text files. The file type BINARY should be used for binary
files, such as save images, in which bit 7 must not be stripped when
transferred. The file type DEC_MULTINATIONAL may be used for text
files containing 8-bit chars only when it is a supported type on the
other end. Check HELP Binary_Files for important additional info.
Once a FILE_TYPE is SET that aspect of exchanging file attributes is
superseded by the designated type regardless of whatever remains on
with the rest of attribute processing. SET FILE AUTO to restore the
default. SHOW FILE displays the current type.
Kermit-11>SET
Kermit-11>SET
Kermit-11>SET
Kermit-11>SET
3 ASCII
FILE
FILE
FILE
FILE
ASCII
BINARY
DEC_MULTINATIONAL
AUTO
Force the file type to ASCII, for 7-bit text files. For
text files containing 8-bit chars use DEC_MULTINATIONAL,
if supported by the other Kermit, or if not, use BINARY.
SET FILE AUTO restores automatic ASCII/Binary selection.
3 AUTO
Decide if a file should be sent in the binary mode as determined
from an internal list of binary file types and use any type data
found in an incoming file's attributes.
Setting the FILE_TYPE to any particular value overrides both the
send and receive automatic type selection.
3 BINARY
Force the file type to BINARY, for non-text files. If parity is set to
anything besides NONE, the other Kermit must support eight bit quoting.
SET FILE AUTO restores automatic ASCII/Binary selection.
3 CREATE_SIZE
The largest file RT-11 can open without specifying a particular size
is half the biggest piece of contiguous free space. When talking to
a Kermit that doesn't support passing the file size with attributes,
SET CREATE_SIZE may be used to get a file that otherwise wouldn't be
possible. If your largest free space is 3000 blocks and you need to
get a 2499 block file:
Kermit-11>SET FIL CRE 2499
Note that a SET size supersedes a received attribute value.
Kermit-11>SET FIL CRE 0
; default, restores size attribute
This parameter is cleared (reset to its default) after the next open
(.enter) of ANY kind, and thus may also be used to set the size of a
log file. Conversely, if meant to be used otherwise it shouldn't be
be set until AFTER a log file has been opened.
3 CSI_PARSING
Determines whether multiple file specs provided to the local GET and
SEND commands delimited by commas are parsed by the real CSISPC call
(limit is six arguments) or by a software emulation (limited only by
command line length) useful when the other Kermit chokes on commas.
Kermit-11>SET FILE CSI EMULATED
Kermit-11>SET FILE CSI REAL ; the default
Directory listings and remote file name strings are always parsed by
the real RT-11 Command String Interpreter.
3 DEC_MULTINATIONAL
Under RT-11 this is functionally the same as the BINARY type, and is
provided here for compatibility with other systems where it serves a
useful purpose. DEC_Multinational is for text files (using carriage
control) with 8-bit records.
SET FILE AUTO restores automatic ASCII/Binary selection.
3 FIXED
Synonym for SET FILE BINARY.
3 IMAGE
Synonym for SET FILE BINARY under RT-11.
3 NOPROTECT
Allows Kermit-11 to accept files regardless if the file then exists
on the receiving system, the default. See HELP SET FILE PROTECT if
you wish to retain existing files. In no case will Kermit ever zap
a file protected via PIP (rename/protect).
3 NOREPLACE
Synonym for SET FILE PROTECT.
3 NOVOLUME_VERIFY
Normally Kermit-11 checks the directory header of a disk to verify it
most likely contains a valid file structure before trying to read the
directory. If for some reason your disk doesn't contain the standard
data at offset 760 in the header, Kermit will not read the directory.
SET FILE NOVOL bypasses this test.
3 PROTECT
Forces Kermit-11 to bomb a incoming file when one of the same name
then exists.
The main use of this is to resume getting a group of
files (as in KRT*.*) having lost the connection after transferring
some of them. If protection is set, any files already gotten won't
be again. This assumes the sending Kermit can reject a single file
in a possible group. When using long packets be advised the create
is not attempted until the first data packet has been received, and
this may take several seconds at slower speeds. Files protected by
PIP (ren/prot) can not be deleted by Kermit.
SHOW FILE displays the status of Kermit's file protection.
3 REPLACE
Synonym for SET FILE NOPROTECT.
3 TEXT
Synonym for SET FILE ASCII.
3 TYPE
SET FILE TYPE xxx is the same as the SET FILE xxx, the keyword TYPE
is ignored but provides compatibility with other implementations of
Kermit.
3 VOLUME_VERIFY
Check the directory header of a disk to verify that it contains a
valid RT-11 file structure before trying to read it (the default).
DECRT11 and DECVMSEX are acceptable headers, otherwise you may SET
FILE NOVOL to disable this check (for "foreign" floppies).
2 HOME
Modifies the home directory name to the specified device.
2 INCOMPLETE_FILE_DISPOSITION
Allows determination of 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 some fraction of the file is received. If the disposition
is DISCARD (the default) anything not completely received is discarded.
If the other Kermit supports the "D" (discard) byte in the "Z" (EOF)
packet, a file skipped or aborted when sending from this Kermit will be
treated according to this parameter as SET on the OTHER Kermit.
Kermit-11>SET INCOMPLETE_FILE_DISPOSITION action
Where 'action' is either DISCARD or KEEP.
2 LINE
This special minimum version of Kermit-11 for floppy disk based systems
only supports TT. Use KRT or KRTTSX if you need a comm handler.
2 LOGFILE
Synonym for the LOGFILE command.
2 LONG_PACKETS
Options are ON, OFF, or you may SET NOLONG_PACKETS. This may be used
to disable use of long packets regardless of packet length set locally
or received from a remote system. Setting the packet length greater
than 94 on this end restores long packet operation if set off via this
command.
In the past, SET LONG ON merely restored use of long packets if they'd
first been enabled by SET REC PAC nnn, and wouldn't in itself actually
alter the packet length. Here, it has been enhanced to accomplish and
is equivalent to this:
Kermit-11>SET BLOCK_CHECK_TYPE 3
You may need to SET BLO 3 on the other Kermit
Kermit-11>SET RECEIVE PACKET_LENGTH max_possible
See HELP Long_Packets for more info.
available buffer length.
SHOW PACKET to check the maximum
2 NOATTRIBUTES
Disables automatic exchange of file attributes during transfers.
2 NODEBUG
Turns off all debugging and closes the logfile.
2 NOLONG_PACKETS
Disables use of packets longer than 94 bytes.
2 NOREPEAT_QUOTING
Disables compression of repeated characters during file transfers.
2 PARITY
Specifies the type of parity on the remote link. It defaults to
NONE and can also be ODD, EVEN, MARK or SPACE. Parity generation
is done via software, no special hardware is used. Software
parity generation is restricted to 8-bit links only. The format,
if parity is set to anything besides NONE, will be 7 bits of data
with the high bit set or cleared per the parity scheme in use.
SPACE parity is essentially nothing in the hi bit and thus may be
used to work around bottlenecks such as TT (a 7-bit handler).
When parity (other than NONE) is used Kermit-11 will be forced to
use 8-bit prefixing for binary files, which increases transfer
time. This modified Kermit checks the need to prefix before each
transaction, so one need not exit the program to turn it off.
See HELP Parity for application info.
2 PAUSE
Specifies number of seconds to wait before each packet is sent.
This may be useful under situations of heavy system load.
2 PROMPT
Useful if you are using two Kermit-11s to talk to each other.
By using the SET PROMPT command, you can change the prompt on
either or both Kermits to something indicative of the systems
in use. The prompt string also prefixes error messages, sans
the last byte if it is a ">". Prompts may be up to 30 chars.
2 RECEIVE
Alters various parameters concerning receiving packets.
Kermit-11>SET REC parameter value
3 PACKET_LENGTH
This serves two purposes. The first is to reduce incoming packet length
in the event normal sized Kermit packets can not be passed through the
communications circuit. There could be, perhaps, some "black box" somewhere in the link that has a very small buffer size. This command would
be used to reduce the size that the SENDING Kermit will use.
Long_packets are also enabled by setting the receive packet length.
HELP Long_Packets for specific operational information.
See
3 START_OF_PACKET
Modifies the character used for the RECEIVE (only) start of packet
to the specified octal_value from the default Ctrl-A. Both sides
must support the new value as it can't be negotiated in transfers.
The only reasons this should ever be changed are some piece of gear
somewhere between the two Kermit programs will not pass through the
Ctrl-A, or something similarly placed is echoing its input. In the
latter case, the recipient can change the packet outbound packet
prefix to be different from that of arriving packets so the echo
will be ignored. See HELP ASCII for octal values.
3 TIME_OUT
This is the wait in seconds for a packet from the other Kermit, after
which it will be considered missing and appropriate action taken. If
system loads are high or you are using a MNP protocol you may need to
increase this (and the SEND TIME_OUT on the other Kermit).
To disable it, SET RECEIVE TIME_OUT 0 (actually 65535. ticks).
2 REPEAT_QUOTING
One may SET REPEAT OFF or ON (default) to control character compression
during packet transmission. This might be necessary with older Kermits
that do not support this part of the protocol.
2 RETRY
Sets the maximum number of times Kermit will try to send specific
packets. There are two retry parameters, one for the initial
connection (the SEND_INIT or REC_INIT), the other comes into play
after this init succeeds, governing all further data packets.
The default value for the initial connection is 5, and 16 for all
other packets.
Kermit-11>SET RETRY type nn
Where "type" is either INITIAL_CONNECTION (for initial connection
packet) or PACKET (for all other packets), and "nn" is the number
of retries (decimal) to attempt. Legal values are 3 to 30. SHOW
RETRY to check the current settings.
2 SEND
Alter various parameters concerning packets sent.
Kermit-11>SET SEND parameter value
3 NOXON
Disables prefixing packets with a ^Q (the default).
3 PACKET_LENGTH
This command may be used to reduce packet lengths in the event that
normal sized Kermit packets will not pass through the data circuit.
When Kermit-11 is started it defaults to the maximum possible size.
Once set, it limits sent packets to the specified length regardless
of what the other Kermit may request. SHOW PACKET displays its SET
or default value.
LONG_PACKET operation is a completely separate function and must be
enabled at and requested by the receiving Kermit. More information
is available via HELP Long_Packets.
3 PADCHARACTER
The character used to delay the beginning of actual packet data.
See also SET SEND PADDING. See HELP ASCII for octal values.
Kermit-11>SET SEN PADCHAR <octal_value>
3 PADDING
The number of pad characters used to delay the beginning of each
packet sent. One must first SET SEN PADCHAR <octal_value>.
Kermit-11>SET SEN PADDING <decimal_#_of_pad_chars>
3 START_OF_PACKET
Modifies the character used for the SEND (only) start of packet to
the specified octal_value from the default Ctrl-A. Both Kermits
must support the new value as it can't be negotiated in transfers.
The only reasons this should ever be changed are some piece of gear
somewhere between the two Kermit programs will not pass through the
Ctrl-A, or something similarly placed is echoing its input. In the
latter case, the recipient can change the packet outbound packet
prefix to be different from that of arriving packets so the echo
will be ignored. See HELP ASCII for octal values.
3 TIME_OUT
This is the wait in seconds for a result from the other Kermit, after
which it will be considered missing and appropriate action taken. If
system loads are high or you are using a MNP protocol you may need to
increase this (and the RECEIVE TIME_OUT on the other Kermit). When a
slow speed and long packets are in use be aware that the timer starts
after the write is queued, which may be a few seconds before the last
byte of data is actually shipped out. A longer time_out value should
be used if this presents a problem.
To disable it, SET SEND TIME_OUT 0 (actually 65535. ticks).
3 XON
Prefixes packets with ^Q.
operation.
SET SEN NOXON returns to non-prefixed
2 SERVER
Controls the period at which an idle server times out and sends a NAK.
Kermit-11>SET SER TIME_OUT secs
; default is 60 secs
Kermit-11>SET SER NOTIME_OUT ; disables (actually 2 hrs)
2 SL
Allows control of the Single-Line Editor:
Kermit-11>SET SL ON,KED
! turns SL on, enables Keypad mode
Kermit-11>SET SL NOKED ! offs Keypad mode
Kermit-11>SET SL OFF
! turns SL off
See HELP SL_Editor for operational details.
2 START_OF_PACKET
Modifies the start_of_packet to the specified octal_value from the
default Ctrl-A for BOTH send and receive operations. Both Kermits
must support the new value as it can't be negotiated in transfers.
Send and receive SOHs may also be SET individually.
2 TERMINAL
Controls display formatting.
Kermit checks RT-11 for its SET TT
[NO]SCOPE status or TSX-Plus for a terminal type and uses it for
the default terminal. This may be changed from Kermit's command
line:
Kermit-11>SET
Kermit-11>SET
Kermit-11>SET
Kermit-11>SET
Kermit-11>SET
TT
TT
TT
TT
TT
NOSCOPE
TTY
VT100
SCOPE
VT200
!
!
!
!
! printing terminal
tube terminal, but not a VT-xxx
itself
here same as VT100
itself
Informational messages may be offed by SET TERM QUIET. The default
is NOQUIET, allowing everything to be displayed.
The init file is
not usually echoed, you may SET TT NOQUIET in it to modify this.
2 TT:
Synonym for SET TERMINAL.
1 SHOW
The SHOW command will display the parameters Kermit uses to interpret
and process commands and data, some of which are modifiable with SET.
Kermit-11>SHOW parameter
Kermit-11>SHOW
; defaults to "SHOW ASSIGNS"
2 ALL
Displays Kermit's most pertinent operating parameters.
2 ASSIGNS
Displays the current home directory and default device.
2 ATTRIBUTES
Displays the current status of attribute packet processing.
2 BINARY_TYPE
Lists file types which are considered to be binary (8-bit).
2 BLOCK_CHECK_TYPE
Displays the type of checksum in use.
2 DEBUG
Shows debugging status.
2 DEFAULT
Displays the default disk device.
2 DELAY
Displays the number of seconds delay before
SEND begins when invoked in the remote mode.
2 FILE_TYPE
Show the current file mode (ASCII, AUTO or BINARY) and various file
options.
2 INCOMPLETE_FILE_DISPOSITION
Shows what will be done with an arriving file when the transfer fails
before finishing. When this Kermit is the remote your local Kermit
must support the "D" (discard) byte in the "Z" (EOF) packet if a file
skipped or aborted there is to be actually discarded when this is set
to discard here.
2 LINE
Displays parameters associated with the current link device.
2 PACKET
Displays current SOH, EOL and packet lengths.
2 PARAMETERS
Displays various send, receive and packet parameters.
2 PARITY
Shows the software parity scheme in use.
2 PAUSE
Displays the pause time before sending each packet.
2 REPEAT_QUOTING
Displays the current status of repeated character quoting.
2 RETRY
Lists the current INITIAL_CONNECTION and PACKET retry limits.
2 SERVER
Displays the current server time_out.
2 SL
Displays SL_Editor status.
2 START_OF_PACKET
Displays the current SOH (start_of_packet) character.
2 TERMINAL
Displays the current Kermit terminal type and associated parameters.
2 TIME_OUT
Displays the current packet time_out in seconds.
2 TT:
Synonym for SHOW TERMINAL.
2 VERSION
Displays current version and edit of this program.
1 SL_Editor
A basic Single Line Editor is available at the command line. Most
operations require a VT-100 terminal, although SL may be enabled
regardless of terminal type.
Kermit-11>SET SL ON,KED
! turns SL on, enables Keypad mode
Kermit-11>SET SL NOKED ! offs Keypad mode
Kermit-11>SET SL OFF
! turns SL off
The last 10 command lines are stored. This editor flips direction
when hitting either end of the line. Note the undelete_word and
undelete_line routines share a common buffer, and with the non-EIS
assembly the number of stored commands is limited to 3.
A list of currently defined function keys is available at any time
during entry of a command via the PF2 key, and the contents of
your command line buffer will be restored and retyped afterwards.
2 Function_Keys
Left arrow
Right arrow
Up arrow
Down arrow
Delete
Line Feed
PF1
PF2
PF4
Ctrl-A
Ctrl-B
Ctrl-C
Ctrl-D
=
=
=
=
=
=
=
=
=
=
=
cursor left
cursor right
recall previous command lines
move back after up arrow use
=
delete char to left of cursor
delete word to left of cursor
prefix to undelete char, word, or line
prints this list then retypes command line
delete line, from cursor to end
toggle insert mode off/on
recall previous command lines
=
cancel command
cursor left
Ctrl-E
Ctrl-F
Ctrl-R
Ctrl-U
Ctrl-V
Ctrl-W
=
=
=
=
recall previous command lines
cursor right
=
retype line
=
delete line, from top to char left of cursor
move back after up_arrow/^B/^E use
retype line
2 KED_Mode_Functions
Left arrow
Right arrow
Up arrow
Down arrow
Tab
=
Backspace
Delete
Keypad Enter
Keypad 0
Keypad 1
Keypad 2
Keypad 3
Keypad 4
Keypad 5
Keypad ,
Keypad Line Feed
PF1
PF2
PF4
Ctrl-C
Ctrl-R
Ctrl-U
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
cursor left
cursor right
recall previous command lines
move back after up arrow use
toggle insert mode off/on
delete char to left of cursor
=
delete char to left of cursor
return
goto start of line
move one word
goto end of line
move one char
set ADVANCE mode
set BACKUP mode (default)
delete char
delete word starting from cursor
delete word to left of cursor
prefix to undelete char, word, or line
prints this list then retypes command line
delete line, from cursor to end
=
resets recall pointer
=
retype line
=
delete line, from top to char left of cursor
1 SPACE
Shows a summary of used and free disk space available.
A device or files argument is optional.
1 STATUS
Displays packet transaction statistics.
1 TAKE
The TAKE command tells Kermit-11 to execute commands from the specified
file. The RT-11 syntax "@file" may also be used:
Kermit-11>TAKE file
Kermit-11>@file
"File" is any normal RT-11 file specification. The default type is .COM
and if no device is given DK and SY will be tried in that order. "!" or
";" may prefix comments in Kermit TAKE files, and all commands except
control characters are supported.
1 TYPE
Types files to your terminal. Switches (/opt) are not implemented.
When typing a binary file most non-printing characters are filtered
to prevent possible interference with one's terminal attributes.
If the terminal type is VT100 or lower, the hi bit will be stripped
from everything typed. Use VT200 to see all eight bits.
Kermit-11>TY
Kermit-11>TY
Kermit-11>TY
Kermit-11>TY
GUIDE
.MAC
*
*.*
; default type is .LST
; type all .MAC files
; type all .LST files
; types the world..
1 Upgrades
This special version of Kermit-11 for RT-11 and TSX-Plus may be from
time to time updated/upgraded, or various bugs may be found and fixed.
The latest revision may be had by calling the system on which the work
is done:
Host:
Available:
Phone:
Local Out-dials:
Logon/Password:
Modem speeds:
Protocols:
Billy's Place, Culver City, California
24 hours, 3 lines, immediate access
+1.310.837.0892
BT North America: 9203, SprintNet: CALAN
1000/moving_target
300/1200/2400 only
Kermit, VTCOM/TRANSF, Xmodem
Access is free other than whatever it costs to place the call. Any bug
found will be fixed. Please leave mail regarding same to account #1 on
the above. Also on-line here are the complete Kermit-11 T3.60 sources,
along with a massive amount of RT-11 SIG and other public domain/gratis
software. Mail to youdelman@eisner.decus.org or billy@mix.com may also
be used to report bugs. A fairly recent edition of this package may be
gotten from ftp.utoledo.edu in their [PDP11-KERMIT.K-RT11] directory.
Download