home *** CD-ROM | disk | FTP | other *** search
/ Programmer's ROM - The Computer Language Library / programmersrom.iso / ada / debug / sdread.me < prev    next >
Encoding:
Text File  |  1988-05-03  |  5.4 KB  |  199 lines
  1.  
  2.  
  3.  
  4.                         Ada Symbolic Debugger Version 1.0
  5.         
  6.                      * * *  INSTALLATION INSTRUCTIONS  * * *
  7.         
  8.                                        for
  9.  
  10.                                  DEC VAX VMS 4.0
  11.                                    (or later)
  12.  
  13.         -----------------------------------------------------------------
  14.         
  15.         Minimum Installation Requirements:
  16.         
  17.           1.  System:               VAX VMS 4.0 or later
  18.  
  19.           2.  Magnetic Tape Drive:  (1) 9 Track / 1600 BPI
  20.  
  21.           2.  Ada Compiler System:  VAX Ada Version 1.0 or later
  22.  
  23.           3.  Disk Storage:         At least 10,000 blocks in the 
  24.                                     current working directory.
  25.  
  26.         -----------------------------------------------------------------
  27.         The  Ada  Symbolic  Debugger  is  provided on 9  Track  1600  BPI 
  28.         magnetic tape in DEC VAX VMS 4.0 "backup" format. The contents of 
  29.         the tape are described below.
  30.  
  31.         READ.ME                 These installation instructions
  32.  
  33.         INSTALL.COM             Command file to install, compile and Link
  34.                                 WIS_DEBUG.EXE  and  build  the  Run  Time 
  35.                                 Monitor program library
  36.  
  37.         DEBUG.ADA               Source code for Symbolic Debugger
  38.  
  39.         RTM.ADA                 Source code for Run_Time_Monitor
  40.  
  41.         DEBUG.UG                User's Guide for the Symbolic Debugger
  42.  
  43.         SYMDEBUG.HLP            Text file containing help commmands  for 
  44.                                 the Run-Time Monitor 
  45.  
  46.         WISDEBUG.HLP            The file containing help commands for the
  47.                                 shell
  48.         
  49.                                     IMPORTANT
  50.         
  51.         Path  names for user directories will vary from system to system. 
  52.         For  the purposes of these installation  instructions  a  working 
  53.         directory  name  of [TOOLS]  will be used to name  the  directory 
  54.         where the tools will be located,  and [USER] will be used to name 
  55.         the  user's directory.  You should replace [TOOLS] with the  full 
  56.         path  name  of the working directory you will be using to  create 
  57.         the  Symbolic  Debugger and replace [USER] with the name  of  the 
  58.         directory(s) where the tool will be used.
  59.  
  60.  
  61.                                         1
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.         
  73.                                   INSTALLATION
  74.         
  75.         The  following instructions contain all information necessary  to 
  76.         install  all source code and user documentation for the  debugger 
  77.         and  generate an executeable version of the program using the VAX 
  78.         Ada Compiler System Version 1.0 or later.
  79.  
  80.  
  81.  
  82.         1. Get  into  the  working  directory where  the  tools  will  be 
  83.            installed.
  84.  
  85.            Command:  $ SET DEF [TOOLS]
  86.  
  87.  
  88.         2. Mount the Intermetrics Ada Symbolic Debugger Distribution Tape 
  89.            on  a  1600 BPI tape drive and issue  the  following  commands 
  90.            where "TAPE:" is the physical tape drive name (e.g. MTA0:)
  91.  
  92.            Commands:  $ MOUNT/FOREIGN TAPE:/DENSITY=1600
  93.                       $ BACKUP/REWIND/LOG/VERIFY TAPE:DEBUG.BCK *
  94.  
  95.            When  loading  is  completed  the  distribution  tape  may  be 
  96.            dismounted as it will no longer be needed.
  97.  
  98.  
  99.         3. This   step creates the WIS_DEBUG program.   It may be skipped    
  100.            if you use the WIS_DEBUG.EXE provided on the tape.  
  101.  
  102.            Create  a  program  library and compile  DEBUG.ADA  into  this 
  103.            library.   Copy  the  body  for the SYSDEP  package  into  the 
  104.            library.
  105.  
  106.            Commands:  $ ACS CREATE LIBRARY [TOOLS.LIB]
  107.                       $ ACS SET LIBRARY [TOOLS.LIB]
  108.                       $ ADA DEBUG.ADA
  109.                       $ ACS COPY FOREIGN SYSDEP.OBJ SYSDEP
  110.  
  111.            A  package  body  now  needs  to  be  added  for  the  package 
  112.            SYSTEM_PARAMETERS.  This body is used to define where the base 
  113.            program library is located.
  114.  
  115.            Commands:  $ CREATE SYSPARMS.BDY
  116.                       package body SYSTEM_PARAMETERS is
  117.                       begin
  118.                         BASE_PROGRAM_LIBRARY := CREATE("[TOOLS]");
  119.                       end SYSTEM_PARAMETERS;
  120.                       <CNTL>-Z
  121.                       $ ADA SYSPARMS.BDY
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                                         2
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.            WIS_DEBUG   can  now  be  linked  and  the   program   library    
  137.            destroyed. 
  138.  
  139.            Commands:  $ ACS LINK WIS_DEBUG
  140.                       $ ACS DELETE LIBRARY [TOOLS.LIB]
  141.  
  142.         4. The runtime library now needs to be created.  
  143.  
  144.            Commands: $ ACS CREATE LIBRARY [TOOLS.RTLIB]
  145.                      $ ADA RTM.ADA
  146.                      $ ADA SYSPARMS.BDY
  147.                      $ ACS COPY FOREIGN SYSDEP.OBJ SYSDEP
  148.  
  149.         5. In  each  working directory,  a  link needs to be made to  the 
  150.            runtime  library.
  151.  
  152.            Commands: $ ACS CREATE SUBLIB/PARENT=[TOOLS.RTLIB] [USER.LIB]
  153.                      
  154.            This library will now be used to compile instrumented source.
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.                                         3
  194.  
  195.  
  196.  
  197.  
  198.  
  199.