home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / decpro300 / prov1.mem < prev    next >
Text File  |  2020-01-01  |  14KB  |  320 lines
  1.  
  2.  
  3.  
  4. The following reflects Pro/Kermit version 1.0.
  5.  
  6.                                    Pro/Kermit
  7.                                    ----------
  8.  
  9. This is the first release of Kermit for  the  Digital  Professional  350  series
  10. personal computers.  This version was based on the Common BLISS modules that are
  11. used in Kermit-10 and VAX Kermit, so  contains  most  of  the  functionality  of
  12. Kermit-10 and VAX Kermit.  Pro/Kermit is not dependent on any Digital product to
  13. do the communications, so Pro/Communications is not required to run  Pro/Kermit.
  14. The following functionality is currently implemented in Pro/Kermit.
  15.  
  16.      1.  CONNECT command.  This allows the Professional to act as if it  were  a
  17.          terminal.   It  will  use the communications port as the terminal line.
  18.          Note that Pro/Kermit does not attempt to emulate any type of terminal -
  19.          it  just  lets everything pass through to the Pro's terminal subsystem.
  20.          This makes the Pro appear as if it were a VT102 (or VT220)  for  almost
  21.          all  purposes.  The one exception is that the Pro will not respond with
  22.          the same response to the identify yourself code as a VT102, so programs
  23.          which  query  the terminal to determine its type may not understand the
  24.          response.  This is certainly the case with the VMS SET TERMINAL/INQUIRE
  25.          command.
  26.  
  27.      2.  GET command.  You can get a file from a remote Kermit.
  28.  
  29.      3.  SEND command.
  30.  
  31.      4.  The following generic commands can be sent to a remote Kermit.
  32.  
  33.          1.  LOGOUT
  34.  
  35.          2.  FINISH
  36.  
  37.          3.  BYE - A combination of LOGOUT and a Pro/Kermit exit.
  38.  
  39.          4.  TYPE - Type a remote file
  40.  
  41.          5.  DIRECTORY - Get a directory of remote files.
  42.  
  43.          6.  DISK - Get the disk usage on a remote system.
  44.  
  45.          7.  CHANGE - Change the working directory.
  46.  
  47.          8.  STATUS - Get the status of the server Kermit.
  48.  
  49.          9.  HELP - Get help on commands that the server Kermit supports.
  50.  
  51.         10.  HOST - Perform a command on the server's host system.   All  output
  52.              from the command will be displayed on the user's screen.
  53.  
  54.         11.  COPY - Copy remote file to a different remote file.
  55.  
  56.         12.  RENAME - Rename files on the remote system.
  57.  
  58.         13.  WHO - Who is logged into the remote system.
  59.  
  60.  
  61.      5.  Server mode is supported on the Professional.   The  following  generic
  62.          functions are supported by Pro/Kermit.
  63.  
  64.          1.  SEND - Send a file from the Professional.
  65.  
  66.          2.  RECEIVE - Receive a file from the remote Kermit.
  67.  
  68.          3.  TYPE - Type a file.
  69.  
  70.          4.  FINISH/LOGOUT - Terminate Pro/Kermit.
  71.  
  72.  
  73.      6.  P/OS Services - Enter various P/OS services from Kermit.  These are the
  74.          various services found in the main menu of P/OS.  These include:
  75.  
  76.          1.  Disk/diskette services
  77.  
  78.          2.  File services
  79.  
  80.          3.  Print services
  81.  
  82.          4.  View Message/Status
  83.  
  84.          5.  P/OS Set-Up (What you enter when you press the Set-Up key when  the
  85.              main menu is displayed).
  86.  
  87.  
  88.      7.  SET commands.  A full range of parameter setting  is  provided  by  the
  89.          "Set parameters" option in the main menu.
  90.  
  91.  
  92.                                  Kermit Sources
  93.                                  ------ -------
  94.  
  95. The following describes the sources for Pro/Kermit.  Note that some of the files
  96. are  common  between  Pro/Kermit,  VAX/VMS Kermit, and Kermit-10.  On the Kermit
  97. distribution tape and on network distribution areas, the "PRO" versions of these
  98. files may only contain a pointer to the file which contains the complete version
  99. of the source.
  100.  
  101. Common BLISS source modules:
  102.  
  103.      1.  PROTT.BLI - Common BLISS source for the terminal text  output  support.
  104.          This module produces PROTT.MAC.
  105.  
  106.      2.  PROGLB.BLI - Common BLISS source for the global storage for PROMSG.BLI.
  107.          This module produces PROGLB.MAC.
  108.  
  109.      3.  PROMSG.BLI - Common BLISS source  for  the  protocol  handling  module.
  110.          This module produces PROMSG.MAC.
  111.  
  112.      4.  PROCOM.REQ - Common BLISS require file  which  defines  various  common
  113.          parameters.  This is required by PROMSG.BLI.  This file must be renamed
  114.          to KERCOM.REQ.
  115.  
  116. The following files make up Pro/Kermit:
  117.  
  118.      1.  PROBLI.MAC - This module contains support  routines  for  the  Bliss-16
  119.          character  processing  routines.   These routines include the character
  120.          move, copy and find character routines.
  121.  
  122.      2.  PROCMN.MAC - The common task  is  created  from  this  module  and  two
  123.          others.  This contains the global Pro/Kermit storage.
  124.  
  125.      3.  PROCON.MAC - This module contains the terminal emulation processing for
  126.          Pro/Kermit.
  127.  
  128.      4.  PRODF.MAC - The default file I/O routines are contained in this module.
  129.  
  130.      5.  PROERR.MAC - Error processing  for  Pro/Kermit  is  contained  in  this
  131.          module.
  132.  
  133.      6.  PROFIL.MAC - The file I/O routines for sending and receiving files  are
  134.          contained in this module.  These routines are only used for the support
  135.          of KERMSG.
  136.  
  137.      7.  PROGLB.MAC - Global storage that is used by KERMSG is contained in this
  138.          module.   This file is generated by Bliss-16 from the KERGLB.BLI source
  139.          file.
  140.  
  141.      8.  PROITC.MAC  -  Intertask  communication  routines  are   contained   in
  142.          PROITC.MAC.  These routines are used to allow KERMIT.TSK and KERFIL.TSK
  143.          to communicate.
  144.  
  145.      9.  PROLIB.MAC - Various library routines are contained in this module.
  146.  
  147.     10.  PROMIT.MAC - This is the main module for KERMIT.TSK.  It  contains  the
  148.          starting address.
  149.  
  150.     11.  PROMLB.MAC - This is the macro library file for Pro/Kermit.
  151.  
  152.     12.  PROMNU.MAC - The menu processing for Pro/Kermit is done by this module.
  153.  
  154.     13.  PROMSG.MAC - This is the protocol module for Pro/Kermit.   This  module
  155.          is generated by Bliss-16 from the KERMSG.BLI source file.
  156.  
  157.     14.  PROSCR.MAC  -  Various  screen  support  routines  are   contained   in
  158.          PROSCR.MAC.  This module contains the starting address of KERFIL.TSK.
  159.  
  160.     15.  PROSND.MAC - The SEND and  RECEIVE  support  routines  for  PROMSG  are
  161.          contained in this module.
  162.  
  163.     16.  PROTT.MAC - This routine contains the terminal  I/O  routines  used  by
  164.          KERMSG.BLI.   This  module  is generated by Bliss-16 from the KERTT.BLI
  165.          source file.
  166.  
  167.     17.  PROXFR.MAC - This module supports the various REMOTE  commands  in  the
  168.          KERFIL.TSK.
  169.  
  170.     18.  PROXK.MAC - The XK0:  routines are contained in this module.  XK0:   is
  171.          the communications port for the Professional 300 series machines.
  172.  
  173.     19.  PROREG.MAC - The save and restore register co-routines are contained in
  174.          this  module.   These  routines are used by the Bliss-16 generated code
  175.          and by the Macro-11 routines.  This should be renamed to SAVREG.MAC.
  176.  
  177.     20.  PROMIT.INS - The installation file used to install Pro/Kermit into  the
  178.          P/OS menu system.  This should be renamed to KERMIT.INS.
  179.  
  180.     21.  PROBLD.CMD - DCL indirect command file for the Pro/Tool  Kit  to  build
  181.          Pro/Kermit.
  182.  
  183.     22.  PROVMS.COM - VAX/VMS DCL command file to  build  Pro/Kermit  using  the
  184.          Host Tool Kit.
  185.  
  186.     23.  PROMIT.CMD - Task builder command file to build KERMIT.TSK.
  187.  
  188.     24.  PROMIT.ODL - Task builder overlay descriptor file to build KERMIT.TSK.
  189.  
  190.     25.  PROCMN.CMD - Task builder command file to build KERCMN.TSK.
  191.  
  192.     26.  PROFIL.CMD - Task builder command file to build KERFIL.TSK.
  193.  
  194.     27.  PROFIL.ODL - Task builder overlay descriptor file to build KERFIL.TSK.
  195.  
  196.     28.  PROCON.CMD - Task builder command file to build KERCON.TSK.
  197.  
  198.     29.  PROCON.ODL - Task builder overlay descriptor file to build KERCON.TSK.
  199.  
  200.     30.  PRODDT.MAC - Source for symbolic debugger for Macro-11.   This  can  be
  201.          loaded  as  the  debugging aid.  It provides for setting breakpoints at
  202.          any instruction, single steping, etc., (all the functions of ODT), with
  203.          the  additional  feature  of  providing  instruction formt type-out and
  204.          input.  The commands are documented in a large comment in the source.
  205.  
  206. The following files are provided in "hexified" versions.  These are binary files
  207. containing  the menu, help and error messages for Pro/Kermit.  Also included are
  208. the task image files.  Since most distibution channels  for  Kermit  only  allow
  209. text  files, the binary files are supplied in a hexified version.  The file type
  210. (extension) for all the hexified versions of the files has the  first  character
  211. replaced  with an "X".  The binary versions of the files may be available if the
  212. distribution medium(s) have made it possible to keep them intact.
  213.  
  214.      1.  PROMIT.MND/.XND  -  Kermit  menu  file  source  for  FDT   to   produce
  215.          KERMIT.MNU.  This file contains the Pro/Kermit menus.
  216.  
  217.      2.  PROMIT.MNU/.XNU - Converted menu file.
  218.  
  219.      3.  PROMIT.HLD/.XLD - Kermit help frame source  file  for  FDT  to  produce
  220.          KERMIT.HLP.  This file contains all of the Pro/Kermit help messages.
  221.  
  222.      4.  PROMIT.HLP/.XLP - Converted help file.
  223.  
  224.      5.  PROMIT.MSD/.XSD - Kermit error message source file for FDT  to  produce
  225.          KERMIT.MSG.
  226.  
  227.      6.  PROMIT.MSG/.XSG - Converted message file of  Kermit  errors.   Must  be
  228.          renamed to KERMIT.MSG.
  229.  
  230.      7.  PRORMSERR.MSD/.XSD -  Message  file  source  for  FDT  to  produce  the
  231.          RMSERR.MSG file.  This file contains the PRO/RMS error messages.
  232.  
  233.      8.  PRORMSERR.MSG/.XSG - Converted message file of RMS-11 errors.  Must  be
  234.          renamed to RMSERR.MSG.
  235.  
  236.      9.  PROMIT.TSK/.XSK - Task image file for the user interface to Pro/Kermit.
  237.          This  task  displays  the menus, accepts commands, etc.  When used on a
  238.          Pro, this is named KERMIT.TSK.
  239.  
  240.     10.  PROCMN.TSK/.XSK - Common area for  intertask  communication.   This  is
  241.          used  by all of the Pro/Kermit task for storing common parameters, etc.
  242.          When used on a Pro, this is named KERCMN.TSK.
  243.  
  244.     11.  PROFIL.TSK/.XSK - Task image file which implements the Kermit  protocol
  245.          and  all necessary support.  This task is the only Kermit task which is
  246.          actually active during  a  file  transfer  (or  other  Kermit  protocol
  247.          activity).  When used on a Pro, this is name KERFIL.TSK.
  248.  
  249.     12.  PROCON.TSK/.XSK -  Task  image  file  which  implements  the  "connect"
  250.          command.   This  provides  the terminal emulation.  When used on a Pro,
  251.          this is named KERCON.TSK.
  252.  
  253.     13.  PROKRM.HEX - This file contains the hexifed  versions  of  the  set  of
  254.          binary  files  which are necessary to run Pro/Kermit.  This is the file
  255.          from  which  Pro/Kermit  is  bootstrapped  onto  a  bare  system.   The
  256.          dehexification  program  (see  below)  breaks  this  file  up  into the
  257.          individual binary files.  The files produced are:   [KERMIT]KERMIT.TSK,
  258.          [ZZKERMIT]KERFIL.TSK,    [ZZKERMIT]KERCON.TSK,    [ZZKERMIT]KERCMN.TSK,
  259.          [ZZKERMIT]KERMIT.MNU,    [ZZKERMIT]KERMIT.HLP,    [ZZKERMIT]KERMIT.MSG,
  260.          [ZZKERMIT]RMSERR.MSG, and [KERMIT]KERMIT.INS.
  261.  
  262. The following programs  are  utilities  for  hexifying/dehexifying  files  on  a
  263. Pro-3xx.   These  programs are used as part of the distribution process, and may
  264. also be used to transfer binary files from  a  Pro-3xx  to  another  system  for
  265. archiving/backup  purposes.  When the files are then transferred back to the Pro
  266. and dehexified, the necessary attributes should be correctly set.  Note that the
  267. hexified  files  which  are  produced  by these programs contain the name of the
  268. original file (actually the name which was typed in response to the prompt  from
  269. the  hexification  program).  This is the name which will be used for the binary
  270. file when the dehexification program is run.
  271.  
  272.      1.  PROHEX.MAC - Hexification program.
  273.  
  274.      2.  PROHEX.HEX - Hexified version of PROHEX.TSK.
  275.  
  276.      3.  PROHEX.CMD - Task builder command file to build PROHEX.TSK.
  277.  
  278.      4.  PROHEX.ODL - Task builder overlay descriptor file to build PROHEX.TSK.
  279.  
  280.      5.  PRODEH.MAC - Dehexification  program.   This  allows  the  file  to  be
  281.          dehexified  to  be  read  from  a  file  on  disk,  or  from either the
  282.          communications or  printer  ports  (assuming  there  is  a  cooperating
  283.          computer  program  on the other end of the port).  This program is also
  284.          used in bootstrapping Pro/Kermit from another system.
  285.  
  286.      6.  PRODEH.HEX - Hexified version of  PRODEH.TSK.   This  is  used  in  the
  287.          bootstrap procedure.
  288.  
  289.      7.  PRODEH.CMD - Task builder command file to build PRODEH.TSK.
  290.  
  291.      8.  PRODEH.ODL - Task builder overlay descriptor file to build PRODEH.TSK.
  292.  
  293.      9.  VMSHEX.MAR - Hexification program to run under VAX/VMS.
  294.  
  295.     10.  VMSDEH.MAR - Dehexification program to run under VAX/VMS.
  296.  
  297. The following files are provided for use in bootstrapping Pro/Kermit.
  298.  
  299.      1.  PROBOOT.FOR - A sample FORTRAN-77 program for use on  the  host  during
  300.          the bootstrap process.  This version is from a VAX/VMS system.
  301.  
  302.      2.  PROLOAD.BAS - Pro/BASIC program to perform initial bootstrapping.  This
  303.          version works over the printer port, not the communications port.  This
  304.          is  supplied  because  Pro/BASIC  could  not   perform   I/O   to   the
  305.          communications  port  before version 1.2.  Note that a special cable is
  306.          required to use the bootstraping procedure with this version.
  307.  
  308.      3.  PROLOADXK.BAS - Pro/BASIC program to perform initial bootstrapping over
  309.          the  communications  port.   This  requires  Pro/BASIC  version 1.2 for
  310.          correct operation.
  311.  
  312.      4.  PROTERM.BAS - Pro/BASIC  program  to  perform  terminal  emulation  for
  313.          bootstrapping.  This requires Pro/BASIC version 1.2.
  314.  
  315.      5.  PROLOAD.HEX  -  Hexified  file  for  initial  bootstrapping.   This  is
  316.          actually  a  copy  of PRODEH.HEX (the dehexification program).  This is
  317.          the file which is initially loaded  onto  the  Pro  by  PROLOAD.BAS  or
  318.          PROLOADXK.BAS.
  319.  
  320.