home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Columbia Kermit
/
kermit.zip
/
archives
/
music.tar.gz
/
music.tar
/
imusicdoc.txt
< prev
Wrap
Text File
|
1984-10-15
|
13KB
|
287 lines
1
Indiana University - Purdue University in Indianopolis
IUPUI MUSIC-KERMIT USERS GUIDE
(MUSIC is the McGill University System for Interactive Computing,
a timesharing system for IBM 370-series mainframe computers.)
Kermit is a protocol for reliable file transfer between computers.
The version of Kermit which runs on MUSIC (MUSIC-Kermit) may be used
in conjunction with Kermit on an IBM PC to transfer files between the
PC and MUSIC. Data and other information is passed back and forth in
small units called packets. Each packet has a specific format which
includes check data to help insure that the data transfer is correct.
MUSIC-Kermit can currently transfer only character data. Binary files
will not be transferred correctly. Files to be transferred may have a
fixed or variable record format, and the logical record length may be
up to 256 characters long.
Listed below are the commands which MUSIC-Kermit accepts, the error
messages which may be issued, and a section on how to run MUSIC-Kermit.
For more information on Kermit, see the Kermit Users Guide, Fourth
Edition.
MUSIC-KERMIT COMMANDS
_____________________
The commands for MUSIC-Kermit are listed below. All commands may
be abbreviated to 3 characters. A description of a command may be
obatined by entering the commaned followed by a ' ?'.
RECEIVE (filename)
The receive command is used to tell MUSIC-Kermit that a file will
be sent to it. The filename is optional. If given, the file being
received by MUSIC will be stored under the file name specified. If not,
it will be stored under the name sent to MUSIC from PC-Kermit. MUSIC
file names can be up to 17 characters long. The characters may be
alpha-numeric, '.', '$', '#', or '@'. The first character may not be a
'#' or '$'. If an invalid file name is sent to MUSIC-Kermit, an error
packet will be sent back to the PC.
SENd filename1 (filename2)
The send command is used to send a MUSIC file to the PC. Filename1
is the MUSIC name of the file to be sent. The file name is put in the
File Packet and sent to the PC-Kermit before the file. PC-Kermit may
alter the name to fit it's naming conventions. Filename2 is optional.
If specified, it is put into the File Packet and sent to the PC instead
of the MUSIC file name (filename1). Filename2 will then be the name of
the file on the PC after it is sent.
HELP
Help lists all the available commands with a brief summary of each.
STATUS
The STATUS command gives the completion status of the previous
MUSIC-Kermit command. After a SEND or RECEIVE has been issued, the
user generally goes back to PC-Kermit and issues the opposite command
there. If an error occurs during the file transfer, the PC user can
re-connect to MUSIC-Kermit and issue a STATUS to find out what error
occurred on the MUSIC side.
1
SET
The SET command is used to set the following parameters:
RECFM The record format for files being received by
MUSIC-Kermit. It may be set to V (variable),
VC (variable compressed), F (fixed), or FC (fixed
compressed). FC is the default.
EOL The end-of-line character that the PC should send
to MUSIC-Kermit. The default is a carriage return,
x'0D'.
QUOTE The quote character which MUSIC-Kermit should use
to send control characters. The default is #.
LRECL The logical record length for files being received by
MUSIC-Kermit. The value may be from 1 - 256. 80 is
the default.
PACKET The packet size that the PC should send to MUSIC. It
must be between 26 - 94. The default is 94.
DELAY The delay time is the number of seconds that MUSIC-
Kermit waits after a SEND command before sending the
first packet to the PC. This allows the user time
to return to PC-Kermit and issue a RECEIVE command.
The value must be between 0 - 99. The default is 15.
RETRY The retry count is the number of times that MUSIC-
Kermit will try to re-send a packet to the PC if there
is an error in the transmission. The value must be
from 0 to 100. The default is 5.
SERIES1 The type of connection to the mainframe running MUSIC.
If the terminal is connected through a SERIES/1 or
7171 protocol converter, this should be set ON other-
wise it should be set OFF. The default is OFF.
SHOW
The SHOW command will display the current value of any of the
parameters listed under the SET command.
EXIT or QUIT
The EXIT or QUIT commands will cause MUSIC-Kermit to end and
the user will be returned to MUSIC.
MUSIC-KERMIT ERROR MESSAGES
---------------------------
MUSIC-Kermit may issue the following error messages during
transmission of a file after a SEND or RECEIVE command:
1. 'Bad send packet size' The packet size being sent to or from MUSIC
was less than 26 or greater than the maximum
allowed size. Re-start the transmission.
2. 'Bad message number' The message number in the last packet read
by MUSIC-Kermit was not a valid number.
Re-start the transmission.
3. 'Unrecognozed state' MUSIC-Kermit had an error. Contact
technical services.
4. 'No SOH encountered' All packets must start with an SOH (Start Of
Header). The last data read contained no SOH.
Re-start the transmission.
5. 'Bad character count' The character count in the packet header is
bad. Re-start the transmission.
6. 'Bad checksum' The checksum from the receive side did not
match the one that was sent. This indicates
that the data did not transmit correctly.
This error should only occur after the
transmission retry count is exceeded.
Re-start the transmission.
1
7. 'Illegal packet type' The packet type in the packet header is
invalid. Re-start the transmission.
8. 'Lost a packet' The message number in the packet indicates
that a whole packet was lost during
transmission. Re-start.
9. 'Micro sent a NAK' The micro received a bad packet from MUSIC
and returned a NAK. This type of error must
be examined on the PC side.
10.'Micro aborted' The micro sent an error packet to MUSIC-
Kermit. Check the PC side to determine what
kind of error occurred.
11.'Illegal file name' A file packet was received by MUSIC-Kermit
which contained no file name. Re-start.
The error messages which may occur when MUSIC-Kermit is reading
or writing a file are listed in the MUSIC User's GuIde under the
section, Dynamic Access to Save Library Files. These errors would occur
after a SEND or RECEIVE command. Some of the more common ones are
listed below.
1. 'File name invalid' If a filename was entered on a SEND or RECEIVE
command, the name was invalid to MUSIC. Re-
issue the command with a valid filename. If
no filename was specified on a RECEIVE, then
the PC sent a filename which is invalid.
Use a 'RECEIVE filename' command to give
MUSIC a valid filename.
2. 'Data set not found' The filename specified in a SEND command does
not exist. Re-issue the command with the
correct file name.
3. 'File already exists' A file already exists with the same name as
the one being received. Re-issue the RECEIVE
command and specify a new filename, or rename
the old file.
4. 'Space quota exceeded The file being sent is too large. Try to
for this file' send several smaller files instead of one
large one.
The following error messages may be issued after the SET command.
1. 'Illegal SET command' The parameter specified after SET was not a
valid parameter.
2. 'Error in record format. Either an invalid parameter or no parameter
F,FC,V,VC allowed.' was specified after SET RECFM.
3. 'No record length given. No parameter was specified after SET LRECL.
Re-specify.'
4. 'LRECL must be a number An invalid value was given for LRECL.
from 0 to 256.'
5. 'No End-of-Line No parameter was specified after SET EOL.
character specified.'
6. 'Must be a 2 digit value The EOL value specified was invalid.
less than 31 (decimal).'
7. 'No receive packet No parameter was specified after SET PACKET
size specified.'
8. 'Bad packet size - must An invalid packet size was given.
be between 26-94
(decimal).'
9. 'The delay time cannot No parameter was specified after SET DELAY.
be blank. Re-specify.'
1
10.'Delay must be a number An invalid number was given for DELAY.
from 0-120.'
11.'No retry count given. No parameter was specified after SET RETRY.
Re-specify.'
12.'RETRY count must be a The RETRY count specified was invalid.
number from 0-100.'
13.'Quote character No parameter was specified after SET QUOTE.
cannot be a blank.
Re-specify.'
14.'Must fall between An invalid character was given for the
41-76,140, or 173-176 QUOTE control character.
(octal).
HOW TO USE MUSIC-KERMIT at IUPUI
--------------------------------
System Action Comments
------ ------ --------
PC A. Execute KERMIT.
PC_Kermit B. SET BAUD XXXX (if not 1200)
C. SET IBM ON
D. Connect
E. Dial the IUPUI network: 634-7041
DCA F. 0 (for MUSIC0) or 1 (for MUSIC1)
MUSIC G. /ID MusicId
H. Password
I. KERMIT
MUSIC_Kermit J. Set options if needed.
Type SET ? for a list
of options.
K. Enter a Kermit command.
RECEIVE Receive a file from the PC.
RECEIVE FILENAME Receive a file and store it
under the name FILENAME.
SEND FILENAME Send a MUSIC file to the PC.
L. CNTL-] C Return to PC-Kermit.
PC-Kermit M. Enter a Kermit command.
RECEIVE Receive a file from MUSIC.
SEND FILENAME Send a PC file to MUSIC.
N. Wait for file to be transferred!
O. Connect Return to MUSIC-Kermit.
MUSIC-Kermit P. If more files are to be sent
or received, go to Step J.
Q. EXIT
MUSIC R. /OFF
DCA S. CNTL-] C Return to PC-Kermit.
PC-Kermit T. EXIT
1
Installation instructions:
To assemble:
/FILE SYSPUNCH NAME(KERMIT.OBJ) NEW(REPLACE)
/SYS NOPRINT,TIME=MAX
/FILE SOURCE PDS(*.S) DEF
/FILE SYSLIB PDS($MCC:*.M,$MCM:*.VV.M,$MCM:*.M) DEF
/FILE SYSUT1 N(&&TEMP) NEW DELETE RECFM(V) SP(300) DEF
/FILE SYSUT2 N(&&TEMP) NEW DELETE RECFM(V) SP(300) DEF
/FILE SYSUT3 N(&&TEMP) NEW DELETE RECFM(V) SP(300) DEF
/FILE SYSPRINT NAME(KERMIT.LISTING) NEW(REPL) LRECL(133) SPACE(100)
/LOAD ASM
/JOB NOGO
To linkedit:
/FILE LMOD N(KERMIT.LMOD) NEW(REPLACE) PUBL SP(100)
/LOAD LKED
/JOB MAP,NOGO,PRINT,STATS,NAME=KERMIT
/INCLUDE KERMIT.OBJ
To exec:
/SYS TIME=MAX,REG=500
/FILE 5 RDR
/FILE SYSTERM TERM
/FILE LMOD NAME(KERMIT.LMOD) SHR
/LOAD EXEC
KERMIT LMOD
Further information:
Marie Schriefer
Computing Services - IUPUI
799 W. Michigan Street, Room 1023
Indianapolis, Indiana 46202
317-264-2983