The following reflects Pro/Kermit version 1.0. Pro/Kermit ---------- 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. 1. 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. 2. GET command. You can get a file from a remote Kermit. 3. SEND command. 4. The following generic commands can be sent to a remote Kermit. 1. LOGOUT 2. FINISH 3. BYE - A combination of LOGOUT and a Pro/Kermit exit. 4. TYPE - Type a remote file 5. DIRECTORY - Get a directory of remote files. 6. DISK - Get the disk usage on a remote system. 7. CHANGE - Change the working directory. 8. STATUS - Get the status of the server Kermit. 9. HELP - Get help on commands that the server Kermit supports. 10. HOST - Perform a command on the server's host system. All output from the command will be displayed on the user's screen. 11. COPY - Copy remote file to a different remote file. 12. RENAME - Rename files on the remote system. 13. WHO - Who is logged into the remote system. 5. Server mode is supported on the Professional. The following generic functions are supported by Pro/Kermit. 1. SEND - Send a file from the Professional. 2. RECEIVE - Receive a file from the remote Kermit. 3. TYPE - Type a file. 4. FINISH/LOGOUT - Terminate Pro/Kermit. 6. 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: 1. Disk/diskette services 2. File services 3. Print services 4. View Message/Status 5. P/OS Set-Up (What you enter when you press the Set-Up key when the main menu is displayed). 7. SET commands. A full range of parameter setting is provided by the "Set parameters" option in the main menu. Kermit Sources ------ ------- 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. Common BLISS source modules: 1. PROTT.BLI - Common BLISS source for the terminal text output support. This module produces PROTT.MAC. 2. PROGLB.BLI - Common BLISS source for the global storage for PROMSG.BLI. This module produces PROGLB.MAC. 3. PROMSG.BLI - Common BLISS source for the protocol handling module. This module produces PROMSG.MAC. 4. 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. The following files make up Pro/Kermit: 1. 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. 2. PROCMN.MAC - The common task is created from this module and two others. This contains the global Pro/Kermit storage. 3. PROCON.MAC - This module contains the terminal emulation processing for Pro/Kermit. 4. PRODF.MAC - The default file I/O routines are contained in this module. 5. PROERR.MAC - Error processing for Pro/Kermit is contained in this module. 6. 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. 7. 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. 8. PROITC.MAC - Intertask communication routines are contained in PROITC.MAC. These routines are used to allow KERMIT.TSK and KERFIL.TSK to communicate. 9. PROLIB.MAC - Various library routines are contained in this module. 10. PROMIT.MAC - This is the main module for KERMIT.TSK. It contains the starting address. 11. PROMLB.MAC - This is the macro library file for Pro/Kermit. 12. PROMNU.MAC - The menu processing for Pro/Kermit is done by this module. 13. PROMSG.MAC - This is the protocol module for Pro/Kermit. This module is generated by Bliss-16 from the KERMSG.BLI source file. 14. PROSCR.MAC - Various screen support routines are contained in PROSCR.MAC. This module contains the starting address of KERFIL.TSK. 15. PROSND.MAC - The SEND and RECEIVE support routines for PROMSG are contained in this module. 16. 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. 17. PROXFR.MAC - This module supports the various REMOTE commands in the KERFIL.TSK. 18. PROXK.MAC - The XK0: routines are contained in this module. XK0: is the communications port for the Professional 300 series machines. 19. 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. 20. PROMIT.INS - The installation file used to install Pro/Kermit into the P/OS menu system. This should be renamed to KERMIT.INS. 21. PROBLD.CMD - DCL indirect command file for the Pro/Tool Kit to build Pro/Kermit. 22. PROVMS.COM - VAX/VMS DCL command file to build Pro/Kermit using the Host Tool Kit. 23. PROMIT.CMD - Task builder command file to build KERMIT.TSK. 24. PROMIT.ODL - Task builder overlay descriptor file to build KERMIT.TSK. 25. PROCMN.CMD - Task builder command file to build KERCMN.TSK. 26. PROFIL.CMD - Task builder command file to build KERFIL.TSK. 27. PROFIL.ODL - Task builder overlay descriptor file to build KERFIL.TSK. 28. PROCON.CMD - Task builder command file to build KERCON.TSK. 29. PROCON.ODL - Task builder overlay descriptor file to build KERCON.TSK. 30. 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. 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. 1. PROMIT.MND/.XND - Kermit menu file source for FDT to produce KERMIT.MNU. This file contains the Pro/Kermit menus. 2. PROMIT.MNU/.XNU - Converted menu file. 3. PROMIT.HLD/.XLD - Kermit help frame source file for FDT to produce KERMIT.HLP. This file contains all of the Pro/Kermit help messages. 4. PROMIT.HLP/.XLP - Converted help file. 5. PROMIT.MSD/.XSD - Kermit error message source file for FDT to produce KERMIT.MSG. 6. PROMIT.MSG/.XSG - Converted message file of Kermit errors. Must be renamed to KERMIT.MSG. 7. PRORMSERR.MSD/.XSD - Message file source for FDT to produce the RMSERR.MSG file. This file contains the PRO/RMS error messages. 8. PRORMSERR.MSG/.XSG - Converted message file of RMS-11 errors. Must be renamed to RMSERR.MSG. 9. 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. 10. 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. 11. 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. 12. 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. 13. 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. 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. 1. PROHEX.MAC - Hexification program. 2. PROHEX.HEX - Hexified version of PROHEX.TSK. 3. PROHEX.CMD - Task builder command file to build PROHEX.TSK. 4. PROHEX.ODL - Task builder overlay descriptor file to build PROHEX.TSK. 5. 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. 6. PRODEH.HEX - Hexified version of PRODEH.TSK. This is used in the bootstrap procedure. 7. PRODEH.CMD - Task builder command file to build PRODEH.TSK. 8. PRODEH.ODL - Task builder overlay descriptor file to build PRODEH.TSK. 9. VMSHEX.MAR - Hexification program to run under VAX/VMS. 10. VMSDEH.MAR - Dehexification program to run under VAX/VMS. The following files are provided for use in bootstrapping Pro/Kermit. 1. PROBOOT.FOR - A sample FORTRAN-77 program for use on the host during the bootstrap process. This version is from a VAX/VMS system. 2. 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. 3. PROLOADXK.BAS - Pro/BASIC program to perform initial bootstrapping over the communications port. This requires Pro/BASIC version 1.2 for correct operation. 4. PROTERM.BAS - Pro/BASIC program to perform terminal emulation for bootstrapping. This requires Pro/BASIC version 1.2. 5. 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.