home *** CD-ROM | disk | FTP | other *** search
/ Programmer's ROM - The Computer Language Library / programmersrom.iso / ada / sql / dames.doc < prev    next >
Encoding:
Text File  |  1988-05-03  |  5.2 KB  |  126 lines
  1.  
  2.  
  3.             Organization of the files related to DAMES
  4.             ------------------------------------------
  5.         This description applies to the files
  6.             provided on  the  MV  10000  of  IDA.
  7.  
  8.  
  9.         This is a  description  of  the  files  to  be provided to NOSC for the
  10.     acceptance procedure of the Ada interface to DAMES, rev. 1.These files  are
  11.     contained  in  a  single  directory; the name of  this  directory  is
  12.     :UDD:TCOURTWRIGHT.The files contained in TCOURTWRIGHT are :
  13.  
  14.         - the present help document (HELP file),
  15.         - the TOOLS subdirectory,
  16.         - the DAMES  subdirectory,
  17.         - the INTERFACE subdirectory,
  18.         - the USERS subdirectory,
  19.         - the TESTBED subdirectory,
  20.     - the LIBRARY_FOR_VAX subdirectory,
  21.     - the ABSTRACT file.
  22.  
  23.     TOOLS subdirectory
  24.     - - - - - - - - -
  25.  
  26.  
  27.         The TOOLS subdirectory contains CLI macros to be used for installation.
  28.  
  29.  
  30.     DAMES subdirectory
  31.     - - - - - - - - -
  32.  
  33.  
  34.         The DAMES  subdirectory  contains  the  DAMES relocatable object codes.
  35.     These codes have to be linked to  any  Fortran77  application program using
  36.     DAMES,   and   are   also   used   by   the   Ada   interface   to   DAMES.
  37.  
  38.         The DAMES subdirectory also contains the DAMES executable program to be
  39.     used  to  access databases  via  the  on-line  interactive  User  Language.
  40.  
  41.  
  42.     INTERFACE subdirectory
  43.     - - - - - - - - - - -
  44.  
  45.  
  46.         The INTERFACE subdirectory contains the Ada  interface  to DAMES(source
  47.     and object code).It is actually  an  ADE  project  which contains a library
  48.     called INTERFACE. This library must be added  to  the  libsearchlist of the
  49.     user  which  wants  to  use  the packages of the Ada  interface  to  DAMES.
  50.     If the interface is to be transported into another location ( on  the  same
  51.     system, or on another by using a tape), then all source code (files with
  52.     extensions ADA F77 and SR ) must  be  transported , and  the  pragmas  LOAD
  53.     contained in the ADA_FORTRAN.ADA and F77_ACCESS.ADA files must be updated
  54.     accordingly to the new location before compiling the interface. The list of
  55.     the files of the interface and the order in which they have to be compiled
  56.     is contained in the text file :UDD:TCOURTWRIGHT:TOOLS:INTERFACE_FILES.
  57.  
  58.     USERS  subdirectory
  59.     - - - - - - - - - -  
  60.  
  61.  
  62.         The  USERS  subdirectory  is  an  ADE  project   which   contains  four
  63.     application programs  using  the  Ada  interface to DAMES.These application
  64.     programs are :
  65.  
  66.         - Three short programs testing the basic capabilities of the interface.
  67.     They are initialized by using the EX_CLEAR_DB macro, which initializes  the
  68.     databases  (MEMO,  RICH_CORP  and SPARE_CORP) used  by  these  programs.The
  69.     programs  can  then  be  run  by  issuing  the X EXAMPLE1, X EXAMPLE2 and X
  70.     EXAMPLE3 commands.
  71.  
  72.  
  73.         - A long program testing most of the features of the  Ada  interface to
  74.     DAMES.It is run by executing the EXECUTE_DEMO macro.This  one  performs the
  75.     following operations :
  76.  
  77.             1.  Initialize the weekly input file to a predefined content.   You
  78.                can fill  yourself  this  weekly  input  file by creating a file
  79.                called TEXT_INPUT, entering in it your updates,  and  then using
  80.                the TRANSLATE macro to get the WEEKLY_UPDATE file actually  used
  81.                by the application program.
  82.  
  83.             2.  Initialize the PROJDB database to a predefined content.You  can
  84.                look at this or modify this by using the interactive DAMES  User
  85.                Language (the command to be  used  in  order  to invoke DAMES is
  86.                'DAMES').
  87.  
  88.             3.  Run the actual application program.You can perform it  directly
  89.                by issuing the 'X PROJECT_PROCEDURE' command.
  90.  
  91.  
  92.  
  93.     TESTBED subdirectory
  94.     - - - - - - - - - -
  95.  
  96.  
  97.         The testbed subdirectory is an ADE project which  contains  the TESTBED
  98.     tool.This subdirectory contains itself  two  subdirectories  : STANDARD and
  99.     DEMO.Before using  the  TESTBED  tool,  one  must  move to one of these two
  100.     directories (DIR command);STANDARD contains about 350 standards test  cases
  101.     which can be used to check the correctness of the interface after an update
  102.     has been done;DEMO can be used for training in  the  use  of the testbed.In
  103.     both cases, after the current directory has been set to  STANDARD  or DEMO,
  104.     the  testbed  is  run  by  issuing  the TESTBED macro.All details about the
  105.     testbed  use  are  given in the  "Validation  Plan"  document  of  the  Ada
  106.     interface to DAMES.
  107.  
  108.  
  109.     Two ordered lists (ordered in  compilation  order)  of  the files to be
  110.     compiled for the testbed and the demonstration program are contained in the
  111.     TOOLS   directory;   these  files   are   TESTBED_FILES   and   DEMO_FILES.
  112.  
  113.     LIBRARY_FOR_VAX
  114.     - - - - - - - -
  115.  
  116.     This directory contains all the source and text files to be transferred
  117.     to the host of MITRE for Major T. COURTWRIGHT.
  118.  
  119.  
  120.     ABSTRACT
  121.     - - - - 
  122.  
  123.     This file is the abstract of the Ada interface to DAMES to be
  124.     provided to Major T. COURTWRIGHT.
  125.  
  126.