.no autojustify;.justify;.fill		! fill to margin, and pad lines
.page size 55				! 55 lines to a page (49 of text)
.set paragraph 0,1,2			! paragraph spacing
.autoparagraph				! lines with space or tab start para.
.spacing 1				! single spacing
.layout 1,2				! page numbers at bottom of page
.left margin 5				! left margin in 5 from left
.right margin 70			! right margin out at column 70
.display levels D,D,D,D,D,D		! all sections and subsections in dec.
.style headers 7,0,7,1,1,1,1,5,2	! describes format of section titles
.number level -1,1,1,1,1,1		! 1st level starts at 0, others 1
.number page 1				! restart page numbering at 1 for sect.
.center;TAPSE:  THE ADA(R) PROGRAMMING SUPPORT ENVIRONMENT
.blank 2
.center;Stephen R. Rainier
.center;The MITRE Corporation
.blank 3
.footnote
.left margin 5
.blank
(R) - Ada is a registered trademark of the U.S. Government (Ada Joint Program
Office).
.end footnote
^&
.header level 1 ABSTRACT
\&
 The success of any large-scale software development project is very much
dependent on the program development environment available.  The Ada 
programming language is a big step in the right direction, but not enough 
emphasis was placed on the Ada programming support environment (APSE) aspects,
initially.  Much like the historical development of the Ada programming 
language [1], practical experience must be gained in programming environments 
in order to define a concise and complete specification for an Ada programming 
support environment.  TAPSE is an experiment in APSE development.
^&
.header level 1 INTRODUCTION
\&
 Ada is not just another programming language; it is a programming 
environment.  The Ada language is a Department of Defense (DoD) standardized
programming language with features that encourage and enforce modern software
engineering practices.  Some of the standardization and portability advantages
of the Ada language can be enhanced by a consistent, well-defined Ada 
programming support environment (APSE).  Approximately twelve years have been 
invested in developing the Ada language; unfortunately, little of that time 
was spent in defining a standard Ada programming support environment to go 
hand in hand with the language.
.page
^&
.header level 1 APPENDIX A
\&
.center;TAPSE Default Commands
.blank 2
 The following list is a list of all the TAPSE specific commands available
to a TAPSE user with "User" priviledge.  In all the commands, "module" refers
to a standard VAX Ada unit name (with no extension).  A user is not limited
to these commands; most of the standard DCL commands are also available from
within TAPSE.
.no justify
.list " "
.test page 10
.list element;BUIld[/sw] <module>
.list "-"
.list element;Mass Ada compilation for all modules in the compilation closure
[2] of <module>.
.list element;VAX DCL Counterpart:  ACS COMPILE/WAI/LIS/SHO=ALL /NONOTE/COPY
.list element;[/sw]:  Correspond to the ACS COMPILE switches
.end list
.test page 11
.list element;CFO[/sw] <file spec.> <module>
.list "-"
.list element;Copy the foreign language object file into the current library 
as the package body of <module>.  If no UIC is specified in <file spec.>, then 
the [.INTEG] facility at the current level will be assumed as the default
directory for the object file.
.list element;VAX DCL Counterpart:  ACS COPY FOREIGN
.list element;[/sw]:  Correspond to the ACS COPY FOREIGN switches
.end list
.test page 10
.list element;CHEck[/sw] <module>
.list "-"
.list element;Display names of modules in the compilation closure of <module>
that need to be recompiled due to an update of <module>.
.list element;VAX DCL Counterpart:  ACS CHECK
.list element;[/sw]:  Correspond to the ACS CHECK switches
.end list
.test page 12
.list element;CMP <module>[.ADA][/ssw]
.list "-"
.list element;Compile <module>.ADA and update current library.  The listing
file will reside in the [.LIS] facility at the current level.
.list element;VAX DCL Counterpart:  ADA/LIS/SHO=ALL/NONOTE/COPY
.list element;[/ssw]:  Correspond to the ACS COMPILE switches excluding those
above
.end list
.test page 10
.list element;CMP/<for> <module>[.<for>][/ssw]
.list "-"
.list element;Foreign language compile of <module>.<for>.  <For> is the name of 
another VMS language compiler.  The listing file will reside in the [.LIS]
facility at the current level, and the object file will reside in the [.INTEG]
facility at the current level.
.list element;[/ssw]:  Correspond to the specified compiler's switches
.end list
.test page 8
.list element;ADELete <module>
.list "-"
.list element;Delete all reference to <module>* at the current level and mark 
<module> as "checked in", if it was "checked out".
.list element;VAX DCL Counterpart:  ACS DELETE UNIT
.end list
.test page 7
.list element;DISplay <module> [<level>]
.list "-"
.list element;Display the module header for <module> on the terminal.  TAPSE 
will attempt to find the module at the specified <level>.  The default is the 
current level.
.end list
.test page 13
.list element;EDT <module> [<type>]
.list "-"
.list element;If <module> does not exist, TAPSE creates a new Ada source file 
in the current UIC in the proper format for the specified Ada unit type.  If 
<module> does exist, it simply edits the existing module.  In both cases, a 
special Ada EDT init file is used.  The EDT init file is at the current level
and is modifiable.
.list element;[<type>]:  package ^&B\&ody, package ^&S\&pecification,
^&F\&unction, ^&P\&rocedure, ^&G\&eneric, ^&T\&ask, ^&N\&o format, or ^&Q\&uit
.end list
.test page 7
.list element;EDT <file spec>
.list "-"
.list element;Edits a file in the current UIC using the special Ada EDT init 
file.  The EDT init file is at the current level and is modifiable.
.end list
.test page 9
.list element;ENTer[/sw] <Ada lib. spec.> <module>
.list "-"
.list element;Enter a pointer into the current library for <module> from the 
specified Ada library.
.list element;VAX DCL Counterpart:  ACS ENTER UNIT
.list element;[/sw]:  Correspond to the ACS ENTER UNIT switches
.end list
.test page 6
.list element;EXIt
.list "-"
.list element;Exit from TAPSE.  Return to the UIC from whence the 
user came.  No parameters expected.
.end list
.test page 12
.list element;EXPort[/sw] <module>
.list "-"
.list element;Create an object file external to the Ada library with 
everything necessary to link the Ada <module>.  The exported object file will 
be created in the [.INTEG] facility of the current level.
.list element;VAX DCL Counterpart:  ACS EXPORT
.list element;[/sw]:  Correspond to the ACS EXPORT switches
.end list
.test page 15
.list element;GET <module>[.xxx] [<level>]
.list "-"
.list element;Extract <module>[.xxx] from the current test_bed or the specified 
level Library.  If .xxx is not specified or is ".ADA", then the source is
retrieved from the library; otherwise the retrieval is from the [.SOURCE]
facility.  Copy to <module>.xx or .ADA, and mark <module> as "checked out".
The GET will not succeed if <module>[.xxx] cannot be found at <level>, or the 
module is already "checked out".
.list element;[<level>]:  VERsion or TESt_bed
.end list
.test page 10
.list element;HELp [<option>]	
.list "-"
.list element;Help capabilities; if not a special TAPSE help request, then DCL 
Help will be spawned.  Typing "HELp HELp" will display TAPSE Help capabilities.
.list element;[<Option>]:  VERsion, TESt_bed, ENVironment, FACility, TREe, HELp,
MODule, and DIRectory
.end list
.test page 6
.list element;HOMe			
.list "-"
.list element;Default the user back to the top of the directory tree 
(i.e., [<root>]).  No parameters expected.
.end list
.test page 8
.list element;INClude[/sw] <module>	
.list "-"
.list element;Display the names of modules which depend on <module> via a "WITH"
statement (for Ada sources only).
.list element;[/sw]:  Correspond to the SEARCH switches
.end list
.test page 9
.list element;LIBrary [<module>][/ssw] 
.list "-"
.list element;Display the current library entry for <module>, or the entire 
library if <module> omitted.
.list element;VAX DCL Counterpart:  ACS DIRECTORY
.list element;[/ssw]:  Correspond to the ACS DIRECTORY switches
.end list
.test page 6
.list element;LISt <module>	
.list "-"
.list element;Type the <module>* listing file(s) from the [.LIS] facility to 
the terminal.
.end list
.test page 10
.list element;LINk[/sw] <file spec.> [...] 
.list "-"
.list element;Link a foreign language module using the standard VAX Linker.  
Unless a UIC is specified, the object files will be obtained from the [.INTEG]
facility at the current level.  The executable image will reside in the [.EXE]
facility at the current level.
.list element;[/sw]:  Correspond to the LINK switches
.end list
.test page 15
.list element;LNK[/sw] <module> [<file spec>...] 
.list "-"
.list element;Link <module> from the current library, and create the executable
image (<module>.EXE) in the [.EXE] at the current level.  The <filespec>s are 
the file specifications for foreign object files and libraries not contained 
in the current library.  Unless a UIC is specified, these additional objects 
are assumed to reside in the [.INTEG] facility at the current level.
.list element;VAX DCL Counterpart:  ACS LINK
.list element;[/sw]:  Correspond to the ACS LINK switches
.end list
.test page 9
.list element;MSG[/sw] <filespec>
.list "-"
.list element;Send a message via MAIL to the configuration manager(s) for
this software project.
.list element;VAX DCL Counterpart:  MAIL <file> <name>
.list element;[/sw]:  Correspond to the MAIL switches
.end list
.test page 11
.list element;PRT[/sw] <module>	
.list "-"
.list element;Spool the <module>* listing file(s) from the [.LIS] facility 
to the printer.
.list element;VAX DCL Counterpart:  PRINT/FLAG=ALL
.list element;[/sw]:  Correspond to the PRINT switches
.end list
.test page 5
.list element;APUrge <module>
.list "-"
.list element;Purge all references to <module>* at the current level.
.end list
.test page 10
.list element;PUT <module>[.xxx]	
.list "-"
.list element;Insert <module>[.xxx] into the current test_bed level, delete 
all references on the current level, and mark <module> as "checked in".  The 
<module> will not be removed from the current library or available to other
users until the configuration manager has completed the update procedure.
.end list
.test page 8
.list element;QUIt			
.list "-"
.list element;Exit from TAPSE, but remember the current level environment for 
later reentry (save logical names).  Return the user to the UIC from whence 
he came.  No parameters expected.
.end list
.test page 10
.list element;RECompile[/sw] <module> 
.list "-"
.list element;Recompile all modules in the compilation closure of <module> that
are affected by the update of <module>.
.list element;VAX DCL Counterpart:  ACS RECOMPILE/WAI/LIS/SHO=ALL /NONOTE/COPY
.list element;[/sw]:  Correspond to the ACS RECOMPILE switches
.end list
.test page 8
.list element;REFerence[/sw] <module> 
.list "-"
.list element;Display all Ada units "WITH"ed by <module>.
.list element;VAX DCL Counterpart:  ACS SHOW PROGRAM/BRIEF
.list element;[/sw]:  Correspond to the ACS SHOW PROGRAM switches
.end list
.test page 6
.list element;REGress
.list "-"
.list element;Back up one level in the directory structure, but do not go
past the <root>.  No parameters expected.
.end list
.test page 6
.list element;REPaint		
.list "-"
.list element;Repaint the screen contents to clear up unwanted I/O on the 
terminal windows.  No parameters expected.
.end list
.test page 7
.list element;ARUn[/sw] <module>	
.list "-"
.list element;RUN the executable image (<module>.EXE) in the [.EXE] facility
at the current level.
.list element;[/sw]:  Correspond to the RUN switches
.end list
.test page 9
.list element;ASEarch[/sw] <string> 
.list "-"
.list element;Search the source modules at the current level, reporting all 
lines containing <string>.
.list element;VAX DCL Counterpart:  SEARCH
.list element;[/sw]:  Correspond to the SEARCH switches
.end list
.test page 6
.list element;STAtus 		
.list "-"
.list element;Display the "checked out" status of all "checked out" modules.
No parameters expected.
.end list
.test page 6
.list element;TID			
.list "-"
.list element;Display TAPSE user identification information:  User Name, UIC, 
User Priviledge, and default unit name on the terminal.  No parameters expected.
.end list
.test page 8
.list element;UNIt <module>	
.list "-"
.list element;Set <module> as the Default Unit for all module commands. 
If <module> is null, then clear the Default Unit setting.  Note that all of
commands described here that require a module name will use the Default Unit
if the module name is omitted from the command line.
.end list
.test page 9
.list element;VERify[/sw]		
.list "-"
.list element;Performs a verify on the current library; will determine any 
inconsistencies in the library directory.
.list element;VAX DCL Counterpart:  ACS VERIFY
.list element;[/sw]:  Correspond to the ACS VERIFY switches
.end list
.end list
.page
^&
.header level 1 REFERENCES
\&
.list
.display elements "[",D,"]"
.list element;Booch Grady, ^&Software&#Engineering&#with&#Ada\&, 
Benjamin/Cummings Publishing Company, Inc., 1983.
.end list