Columbia Kermit/kermit.zip/decpro300/prov1.rno

Text File | 2020-01-01 | 12KB | 249 lines

.LM0.RM80
.NPA
The following reflects
Pro/Kermit version 1.0.
.B
.C;Pro/Kermit
.c;----------
.b
This is the first release of Kermit for the Digital Professional 350
series personal computers.  This version was based on the Common BLISS
modules that are used in Kermit-10 and VAX Kermit, so contains most of the
functionality of Kermit-10 and VAX Kermit.  Pro/Kermit is not dependent
on any Digital product to do the communications, so Pro/Communications is
not required to run Pro/Kermit.

The following functionality is currently implemented in Pro/Kermit.
.ls
.le;CONNECT command.  This allows the Professional to act as if it
were a terminal.  It will use the communications port as the terminal line.
Note that Pro/Kermit does not attempt to emulate any type of terminal - it
just lets everything pass through to the Pro's terminal subsystem.  This
makes the Pro appear as if it were a VT102 (or VT220) for almost all purposes.
The one exception is that the Pro will not respond with the same response
to the identify yourself code as a VT102, so programs which query
the terminal to determine its type may not understand the response.  This
is certainly the case with the VMS SET TERMINAL/INQUIRE command.
.le;GET command.  You can get a file from a remote Kermit.
.le;SEND command.
.LE;The following generic commands can be sent to a remote Kermit.
.ls1
.le;LOGOUT
.LE;FINISH
.LE;BYE - A combination of LOGOUT and a Pro/Kermit exit.
.le;TYPE - Type a remote file
.LE;DIRECTORY - Get a directory of remote files.
.le;DISK - Get the disk usage on a remote system.
.le;CHANGE - Change the working directory.
.le;STATUS - Get the status of the server Kermit.
.LE;HELP - Get help on commands that the server Kermit supports.
.le;HOST - Perform a command on the server's host system.  All output from
the command will be displayed on the user's screen.
.le;COPY - Copy remote file to a different remote file.
.le;RENAME - Rename files on the remote system.
.le;WHO - Who is logged into the remote system.
.ELS
.LE;Server mode is supported on the Professional.  The following generic
functions are supported by Pro/Kermit.
.ls1
.le;SEND - Send a file from the Professional.
.le;RECEIVE - Receive a file from the remote Kermit.
.le;TYPE - Type a file.
.LE;FINISH/LOGOUT - Terminate Pro/Kermit.
.els
.le;P/OS Services - Enter various P/OS services from Kermit.  These are the
various services found in the main menu of P/OS.  These include:
.ls1
.le;Disk/diskette services
.le;File services
.le;Print services
.le;View Message/Status
.le;P/OS Set-Up (What you enter when you press the Set-Up key when the main
menu is displayed).
.els
.le;SET commands.  A full range of parameter setting is provided by
the "Set parameters" option in the main menu.
.els
.b
.c;Kermit Sources
.c;------ -------
.b
The following describes the sources for Pro/Kermit.  Note that some of the
files are common between Pro/Kermit, VAX/VMS Kermit, and Kermit-10.  On
the Kermit distribution tape and on network distribution areas, the "PRO"
versions of these files may only contain a pointer to the file which
contains the complete version of the source.
.b
Common BLISS source modules:
.ls
.LE;PROTT.BLI - Common BLISS source for the terminal text output support.
This module produces PROTT.MAC.
.LE;PROGLB.BLI - Common BLISS source for the global storage
for PROMSG.BLI.  This module produces PROGLB.MAC.
.LE;PROMSG.BLI - Common BLISS source for the protocol
handling module.  This module produces PROMSG.MAC.
.LE;PROCOM.REQ - Common BLISS require file which defines various common
parameters.  This is required by PROMSG.BLI.
This file must be renamed to KERCOM.REQ.
.els

The following files make up Pro/Kermit:
.ls
.LE;PROBLI.MAC - This module contains support routines for the Bliss-16
character processing routines.  These routines include the character move, copy
and find character routines.
.LE;PROCMN.MAC - The common task is created from this module and two others.
This contains the global Pro/Kermit storage.
.LE;PROCON.MAC - This module contains the terminal emulation processing
for Pro/Kermit.
.LE;PRODF.MAC - The default file I/O routines are contained in this module.
.LE;PROERR.MAC - Error processing for Pro/Kermit is contained in this module.
.LE;PROFIL.MAC - The file I/O routines for sending and receiving files are
contained in
this module.  These routines are only used for the support of KERMSG.
.LE;PROGLB.MAC - Global storage that is used by KERMSG is contained in this
module.  This file is generated by Bliss-16 from the KERGLB.BLI source file.
.LE;PROITC.MAC - Intertask communication routines are contained in
PROITC.MAC.  These routines are used to allow KERMIT.TSK and KERFIL.TSK
to communicate.
.LE;PROLIB.MAC - Various library routines are contained in this module.
.LE;PROMIT.MAC - This is the main module for KERMIT.TSK.  It contains the
starting address.
.LE;PROMLB.MAC - This is the macro library file for Pro/Kermit.
.LE;PROMNU.MAC - The menu processing for Pro/Kermit is done by this module.
.LE;PROMSG.MAC - This is the protocol module for Pro/Kermit.  This
module is generated by Bliss-16 from the KERMSG.BLI source file.
.LE;PROSCR.MAC - Various screen support routines are contained in
PROSCR.MAC.  This module contains the starting address of KERFIL.TSK.
.LE;PROSND.MAC - The SEND and RECEIVE support routines for PROMSG are contained
in this module.
.LE;PROTT.MAC - This routine contains the terminal I/O routines used by
KERMSG.BLI.  This module is generated by Bliss-16 from the KERTT.BLI source
file.
.LE;PROXFR.MAC - This module supports the various REMOTE commands
in the KERFIL.TSK.
.LE;PROXK.MAC - The XK0: routines are contained in this module.  XK0: is the
communications port for the Professional 300 series machines.
.LE;PROREG.MAC - The save and restore register co-routines are contained
in this module.  These routines are used by the Bliss-16 generated code
and by the Macro-11 routines. This should be renamed to SAVREG.MAC.
.LE;PROMIT.INS - The installation file used to install Pro/Kermit into the
P/OS menu system.  This should be renamed to KERMIT.INS.
.LE;PROBLD.CMD - DCL indirect command file for the Pro/Tool Kit to build
Pro/Kermit.
.LE;PROVMS.COM - VAX/VMS DCL command file to build Pro/Kermit using the
Host Tool Kit.
.LE;PROMIT.CMD - Task builder command file to build KERMIT.TSK.
.LE;PROMIT.ODL - Task builder overlay descriptor file to build KERMIT.TSK.
.LE;PROCMN.CMD - Task builder command file to build KERCMN.TSK.
.LE;PROFIL.CMD - Task builder command file to build KERFIL.TSK.
.LE;PROFIL.ODL - Task builder overlay descriptor file to build KERFIL.TSK.
.LE;PROCON.CMD - Task builder command file to build KERCON.TSK.
.LE;PROCON.ODL - Task builder overlay descriptor file to build KERCON.TSK.
.LE;PRODDT.MAC - Source for symbolic debugger for Macro-11.  This can be loaded
as the debugging aid.  It provides for setting breakpoints at any instruction,
single steping, etc., (all the functions of ODT), with the additional feature
of providing instruction formt type-out and input.  The commands are documented
in a large comment in the source.
.ELS

The following files are provided in "hexified" versions.  These are binary
files containing the menu, help and error messages for
Pro/Kermit.  Also included are the task image files.
Since most distibution channels for Kermit only allow text files, the
binary files are supplied in a hexified version. The file type (extension)
for all the hexified versions of the files has the first character
replaced with an "X".
The binary versions of the files may be available if the distribution medium(s)
have made it possible to keep them intact.
.LS
.LE;PROMIT.MND/.XND - Kermit menu file source for FDT to produce KERMIT.MNU.
This file contains the Pro/Kermit menus.
.LE;PROMIT.MNU/.XNU - Converted menu file.
.LE;PROMIT.HLD/.XLD - Kermit help frame source file for FDT
to produce KERMIT.HLP.
This file contains all of the Pro/Kermit help messages.
.LE;PROMIT.HLP/.XLP - Converted help file.
.LE;PROMIT.MSD/.XSD - Kermit error message source file for FDT to produce
KERMIT.MSG.
.LE;PROMIT.MSG/.XSG - Converted message file of Kermit errors. Must be renamed
to KERMIT.MSG.
.LE;PRORMSERR.MSD/.XSD - Message file source for FDT
to produce the RMSERR.MSG file.
This file contains the PRO/RMS error messages.
.LE;PRORMSERR.MSG/.XSG - Converted message file of RMS-11 errors.
Must be renamed to RMSERR.MSG.
.LE;PROMIT.TSK/.XSK - Task image file for the user interface to Pro/Kermit.
This task displays the menus, accepts commands, etc.  When used on a Pro, this
is named KERMIT.TSK.
.LE;PROCMN.TSK/.XSK - Common area for intertask communication.  This is used
by all of the Pro/Kermit task for storing common parameters, etc. When used on
a Pro, this is named KERCMN.TSK.
.LE;PROFIL.TSK/.XSK - Task image file which implements the Kermit protocol
and all necessary support.  This task is the only Kermit task which is actually
active during a file transfer (or other Kermit protocol activity).
When used on a Pro, this is name KERFIL.TSK.
.LE;PROCON.TSK/.XSK - Task image file which implements the "connect" command.
This provides the terminal emulation. When used on a Pro, this is named
KERCON.TSK.
.LE;PROKRM.HEX - This file contains the hexifed versions of the set of
binary files which are necessary to run Pro/Kermit.  This is the file from
which Pro/Kermit is bootstrapped onto a bare system.  The dehexification
program (see below) breaks this file up into the individual binary files.
The files produced are: [KERMIT]KERMIT.TSK, [ZZKERMIT]KERFIL.TSK,
[ZZKERMIT]KERCON.TSK, [ZZKERMIT]KERCMN.TSK, [ZZKERMIT]KERMIT.MNU,
[ZZKERMIT]KERMIT.HLP, [ZZKERMIT]KERMIT.MSG, [ZZKERMIT]RMSERR.MSG, and
[KERMIT]KERMIT.INS.
.ELS

The following programs are utilities for hexifying/dehexifying files on a
Pro-3xx.
These programs are used as part of the distribution process, and may also
be used to transfer binary files from a Pro-3xx to another system for
archiving/backup purposes.  When the files are then transferred back to the
Pro and dehexified, the necessary attributes should be correctly set.
Note that the hexified files which are produced by these programs
contain the name of the original file (actually the name which was
typed in response to the prompt from the hexification program). This
is the name which will be used for the binary file when the dehexification
program is run.

.LS
.LE;PROHEX.MAC - Hexification program.
.LE;PROHEX.HEX - Hexified version of PROHEX.TSK.
.LE;PROHEX.CMD - Task builder command file to build PROHEX.TSK.
.LE;PROHEX.ODL - Task builder overlay descriptor file to build PROHEX.TSK.
.LE;PRODEH.MAC - Dehexification program.
This allows the file to be dehexified
to be read from a file on disk, or from either the communications or printer
ports (assuming there is a cooperating computer program on the other end of
the port).  This program is also used in bootstrapping Pro/Kermit from another
system.
.LE;PRODEH.HEX - Hexified version of PRODEH.TSK.  This is used in the bootstrap
procedure.
.LE;PRODEH.CMD - Task builder command file to build PRODEH.TSK.
.LE;PRODEH.ODL - Task builder overlay descriptor file to build PRODEH.TSK.
.LE;VMSHEX.MAR - Hexification program to run under VAX/VMS.
.LE;VMSDEH.MAR - Dehexification program to run under VAX/VMS.
.ELS

The following files are provided for use in bootstrapping Pro/Kermit.
.ls
.le;PROBOOT.FOR - A sample FORTRAN-77 program for use on the host during
the bootstrap process.  This version is from a VAX/VMS system.
.LE;PROLOAD.BAS - Pro/BASIC program to perform initial bootstrapping.  This
version works over the printer port, not the communications port.
This is supplied because Pro/BASIC could not perform I/O to the communications
port before version 1.2.  Note that a special cable is required to use
the bootstraping procedure with this version.
.LE;PROLOADXK.BAS - Pro/BASIC program to perform initial bootstrapping over
the communications port.  This requires Pro/BASIC version 1.2 for correct
operation.
.LE;PROTERM.BAS - Pro/BASIC program to perform terminal emulation for
bootstrapping. This requires Pro/BASIC version 1.2.
.LE;PROLOAD.HEX - Hexified file for initial bootstrapping.  This
is actually a copy of PRODEH.HEX (the dehexification program).  This
is the file which is initially loaded onto the Pro by PROLOAD.BAS or
PROLOADXK.BAS.
.ELS