home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
kermit.columbia.edu
/
kermit.columbia.edu.tar
/
kermit.columbia.edu
/
archives
/
cmsoriginal.tar.gz
/
cmsoriginal.tar
/
cmsv2hlp.txt
< prev
next >
Wrap
Text File
|
1985-04-15
|
12KB
|
305 lines
.cs 1 on
KERMIT
.sp 2
Kermit-CMS is a program that implements the KERMIT file transfer
protocol for IBM 370-series mainframes running the VM/CMS operating
system. It allows for the transfer of files between computers over
normal terminal communication lines (asynchronous ASCII lines attached
to a 3705-style front end, such as the COMTEN) or a Series/1 running
the Yale ASCII Terminal Communication System. The program should also
work on the IBM 7171 ASCII Device Control Unit and the 4994, although
this has not been verified as of this writing. For more details on
this, see the section SET SERIES1. The calling format for Kermit-CMS
is:
.sp 1
.cs 1 off
.cs 2 on
+----------------------------------+
| | |
| KERMIT | [kercmd ... kercmd] |
| | |
+----------------------------------+
where kercmd is a valid Kermit-CMS command. If no Kermit commands are
supplied, Kermit-CMS will issue a prompt and wait for instructions.
Kermit may also be invoked with optional command line arguments. In
this case, Kermit will exit and return to CMS after completing the
specified command or commands. Several commands may be given on the
command line as long as they are separated by the linend character.
The command line may contain up to 130 characters.
.sp 1
.cs 2 off
.cs 3 on
Commands:
.sp 2
.of 8
SEND <fn> <ft> [<fm>]
.sp 1
Send a file or file group from the CMS system to the Kermit on the
remote system. The wildcard characters "*" or "%" may be used. A "*"
matches any string of characters from the current position to the end
of the field, including no characters at all; a "%" matches any single
character. If the input contains wildcard characters then all
matching files will be sent. If the optional filemode is omitted, a
filemode of "*" is used. In this case, the users disks are scanned
according to the search order and the first occurrence of the file is
the one that is sent. If a file exists by the same name on more than
one disk, only the first one encountered is sent. The user may
override the search order by specifying a filemode.
.sp 1
.of 8
RECEIVE [<fn> <ft> [<fm>]]
.sp 1
Receive a file or file group from the other system. If the optional
filename is not included, Kermit-CMS will use the name(s) provided by
the other Kermit. If that name is not a legal CMS file name,
Kermit-CMS will delete excessive characters from it, and will change
illegal characters to the letter "X". Kermit-CMS supplies a default
type of "X" if one is not provided by the remote system. Use the file
specification to indicate that the incoming file should be stored
under a different name. The filespec may include a filemode to
designate the destination disk. If none is provided, the file will be
saved with filemode A1. If you want to use the same name but a
different filemode, specify "= = FM", where FM is the access mode of
the destination disk. Wildcards may not be used in any field. If the
optional filespec is provided, but more than one file arrives, the
first file will be stored under the given filespec, and the remainder
will be stored under their own names on the A disk. If, however,
"= = FM" is used, all files will be placed onto the specified disk.
.sp 1
.of 8
TAKE <fn> <ft> [<fm>]
.sp 1
Execute Kermit commands from the specified file. The command file may
include TAKE commands.
.sp 1
.of 8
SERVER
.sp 1
Kermit-CMS is capable of acting as a server. The user connects to the
CMS system once to set various options and to start the server. From
then on, he need not connect to the CMS system again. The current
version of Kermit-CMS can send files (the user on the other end types
the GET command, using either a space or a period as the delimiter
between filename, filetype, and filemode), receive files (the user
types SEND), and terminate by either returning to CMS (user types
FINISH) or logging the user out (user types BYE). To put Kermit-CMS
into server mode, first issue any desired SET commands to select
various options and then issue the SERVER command. Kermit-CMS will
await all further instructions from the Kermit on the other end of the
connection.
.sp 1
.of 8
SET <parameter> <value>
.sp 1
Establish or modify various parameters for file transfer. You can
examine their values with the SHOW command. Valid options are:
.sp 1
.in 8
.of 8
ATOE <num1 num2>
.sp 0
Modify the ASCII-to-EBCDIC translate table used by Kermit-CMS to
conform to your system. Specify the offset of the ASCII value within
the table and the new value for that location. Both "num1" and
"num2" should be between 0 and 255 (decimal). Note that the table
is twice as long as necessary because the translate instruction
expects a table that contains 256 characters.
.sp 1
.of 8
BLOCK <num>
.sp 0
Determine the type of block check used during file transfer. Valid
options for "num" are: 1 (for a one character checksum), 2 (for a two
character checksum) and 3 (for a three character CRC).
.sp 1
.of 8
DEBUG <ON | OFF>
.sp 0
If ON, keep a journal of all packets sent and received in the file KER
LOG A1. If the file already exists, it is overwritten. If OFF, stop
logging the packets.
.sp 1
.of 8
END-OF-LINE <num>
.sp 0
If the remote system needs packets to be terminated by anything other
than carriage return, specify the decimal value of the desired ASCII
character. "num" must be between 0 and 31 (decimal).
.sp 1
.of 8
ETOA <num1 num2>
.sp 0
This command allows you to modify the EBCDIC-to-ASCII translate table
used by Kermit-CMS to conform to your system. Specify the offset of
the EBCDIC value within the table and the new ASCII value for that
location. Both "num1" and "num2" should be between 0 and 255
(decimal).
.sp 1
.of 8
FILE <BINARY | TEXT>
.sp 0
If BINARY, CMS Kermit treats each character as a string of bits and
does not perform translation on the data. Also, carriage returns are
not added to the end of outgoing records. Incoming bytes are added to
the end of the current record which is written out when the specified
LRECL is reached. If TEXT, CMS Kermit treats the file as plain text.
ASCII-to-EBCDIC and EBCDIC-to-ASCII translation is performed on the
data. A carriage return-linefeed is appended to each outgoing record
and is used to determine the end of each incoming record.
.sp 1
.of 8
LRECL <num>
.sp 0
Set the logical record length for incoming files to a "num" from
1 to 65536 (64K). This variable is used only for fixed format files.
The default is 80.
.sp 1
.of 8
PACKET-SIZE <num>
.sp 0
Use the specified "num" as the maximum length for incoming packets.
The valid range is 26-94, where 94 is the default.
.sp 1
.of 8
QUOTE <char>
.sp 0
Use the indicated printable character for prefixing (quoting) control
characters and other prefix characters. The only reason to change
this would be for sending a very long file that contains very many
"#" characters (the normal control prefix) as data. It must be a
single character in the range: 33-62, 96, or 123-126 (decimal).
.sp 1
.of 8
RECFM <F | V>
.sp 0
Set the record format to use for incoming files, using "F" for fixed
format and "V" for variable format. The default is variable.
.sp 1
.of 8
SERIES1 <ON | OFF>
.sp 0
Kermit-CMS automatically determines whether you are connected via a
Series/1 emulation controller or a TTY line. This command is provided
though so you can override Kermit-CMS. If SERIES1 is ON, Kermit
disables the 3270 protocol conversion function by putting the Series/1
into "transparent mode"; this allows Kermit packets to pass through
the Series/1 intact.
.sp 1
.of 8
WARNING <ON | OFF>
.sp 0
If the incoming file has the same name as a file that already exists,
and WARNING is OFF, the original file will be overwritten. If WARNING
is set ON, Kermit-CMS will change the incoming name so as not to
obliterate the pre-@|existing file. It attempts to rename the file by
replacing the first character with a dollar sign ("$"). If a file
by that name exists, it also replaces the second character with a
dollar sign. It continues in this manner for all characters of the
filename and filetype.
.in 0
.of 8
SHOW <option>
.sp 1
Display the values of all parameters that can be changed with the SET
command, except for ATOE and ETOA (see the TDUMP command). "option"
can be a particular parameter or the keyword "ALL".
.sp 1
.of 8
STATUS
.sp 1
Return the status of the previous command. The response will either
display the message "Kermit completed successfully", or the last error
encountered.
.sp 1
.of 8
TDUMP <table-name>
.sp 1
Display the contents of "table-name" since it can be modified using
the SET command. The ATOE and ETOA tables can presently be 'dumped'.
.sp 1
.of 8
CMS Issue a CMS command from within Kermit-CMS.
.sp 1
.of 8
CP Issue a CP command from within Kermit-CMS.
.sp 1
.of 8
HELP Display a message that briefly explains Kermit-CMS commands.
.sp 1
.of 8
EXIT Exit from KERMIT back to the host operating system.
.sp 1
.of 8
QUIT Synonym for EXIT.
.sp 1
.of 8
? List all legal Kermit-CMS commands.
.sp 2
.of 0
You may use the help ("?") feature while typing Kermit-CMS commands.
A question mark typed at almost any point in a command, followed by a
carriage return, produces a brief description of what is expected or
possible at that point.
.sp 1
.of 0
Usage Notes:
.sp 1
.of 4
1. When connecting to the CMS system as a TTY device ("line at a
time" mode) several flags must first be set on the micro version of
Kermit. You should set the LOCAL-ECHO flag to ON (this is used to
indicate half-duplex). This is the norm but not true in every case;
if each character appears twice, set the LOCAL-ECHO flag OFF.
HANDSHAKE should be set to XON and FLOW-CONTROL should be set to NONE.
The parity should be set according to the system's specifications. On
some micro versions of Kermit, all of the above is done in one step
using the DO IBM macro (or SET IBM ON). Set the baud rate to
correspond to the line speed.
.sp 1
.of 4
2. When connecting to the CMS system through the Series/1 terminal
emulation controller ("full-screen" mode), certain flags must be set
on the micro version of Kermit. You should set the LOCAL-ECHO flag to
OFF (this is used to indicate full-duplex). HANDSHAKE should be set
to OFF and FLOW-CONTROL should be set to XON/XOFF. For most systems,
the PARITY should be set to EVEN. Set the baud rate to correspond to
the line speed. Immediately after issuing a SEND, RECEIVE or SERVER
command to Kermit-CMS, the screen will be cleared. This is to make
sure the terminal is not stuck in a MORE or HOLDING state before
packets are sent via the full-screen I/O operation. After the file
transfer is complete, and you re-connect to Kermit-CMS, you should
enter the Series/1 "Master Reset" sequence (probably "CTRL-G") so that
the screen is refreshed.
.sp 1
.of 4
3. Three CP SET parameters MSG, IMSG and WNG are always set OFF during
the actual file transfer (and restored afterwards) to prevent CP from
interrupting any I/O in progress.
.sp 1
.of 4
4. When receiving files, if the record format is fixed, any record
longer than the logical record length will be split up to as many
records as necessary. If the record format is variable, the record
length can be as high as 64K. For sending files, the maximum
record length is 64K.
.sp 1
.of 4
5. The current version of Kermit-CMS does not support timeouts.
The user, therefore, should hit the carriage return key after a
long period of inactivity (that is, when the screen display does
not change.)
.sp 1
.of 4
6. When sending packets to Kermit-CMS, the micro must use a
carriage return as the end-of-line character. Both TTY and
Series/1 connections require a carriage return to terminate a read
from the terminal; thus, if any other character is used, Kermit-CMS
will never get the packets.
.sp 0
.of 0
.cs 3 off