View source for PowerAda: APPENDIX A. Glossary

<span id="HEADING89"></span><span id="LINK-Aglossary.frm-firstpage"></span><span id="HEADING89-0"></span>
{{Manual navigation|Pagename=PowerAda:APPENDIX A. Glossary|Displaytitle=APPENDIX A. Glossary|Chapter=A|Section=0|Order=88|Summary=|Product=PowerAda|Version=5|Platform=AIX;Linux|Source=powerada-89.html}}

<span id="HEADING89-1"></span> <span id="HEADING89-2"></span>
==== '''<span id="MARKER-9-1010"></span>American National Standards Institute (<span id="MARKER-2-1011"></span>ANSI)''' ====

An organization sponsored by the Computer and Business Equipment Manufacturers Association through which accredited organizations create and maintain voluntary industry standards.

<span id="HEADING89-4"></span>
==== '''<span id="MARKER-9-1012"></span>ANSI''' ====

See ''[[#MARKER-9-1010|American National Standards Institute (ANSI)]]''.

<span id="HEADING89-6"></span>
==== '''<span id="MARKER-9-1013"></span><span id="MARKER-9-1014"></span>baseline project''' ====

A ''[[#MARKER-9-1079|project]]'' which has been "frozen" so it may be used as the ''<span id="MARKER-2-1015"></span>[[#MARKER-9-1074|parent baseline]]'' for other projects intended to contain incremental changes to the baseline. A project is marked as a baseline using the Make Baseline operation in the Project menu, or with the [[PowerAda:APPENDIX E. Tools Reference/aprojbaseline#MARKER-9-1803|aprojbaseline]] command-line tool.

<span id="HEADING89-8"></span>
==== '''<span id="MARKER-9-1016"></span>baselines file''' ====

A text file identified by the environment variable <span id="MARKER-2-1017"></span>POWERADA_BASELINES, which associates aliases (simple names), with [[#MARKER-9-1014|baseline project]]s. This allows aliases to remain constant while the actual projects they reference may be moved or replaced. If the current project or its ancestors were created using an alias for a baseline, POWERADA_BASELINES must identify an existing baselines file associating that alias with an existing [[#MARKER-9-1082|project root]] directory.

<span id="HEADING89-10"></span>
==== '''<span id="MARKER-9-1018"></span>base name''' ====

In PowerAda, a compilation unit name specified without its type qualifier of '''lib/''' or '''sec/,''' such as <code>text_io</code>; or a file name without the path to its enclosing directory, e.g., <code>textiob.ada</code>.

<span id="HEADING89-12"></span>
==== '''<span id="MARKER-9-1019"></span>bind''' ====

In PowerAda, the operation of producing a complete Ada executable program given the name of a main unit and a program library. This processing includes confirming all units are present, generating an elaboration order, generating code to elaborate library units in the program, generating a script to link the object code using the '''ld''' command, running this script, and cleaning up afterward.

<span id="HEADING89-14"></span>
==== '''<span id="MARKER-9-1020"></span>breakpoint''' ====

A place in a program, specified by a command or condition, where the system stops execution and gives control to the user or to a specified program, such as the PowerAda debugger.

<span id="HEADING89-16"></span>
==== '''<span id="MARKER-9-1021"></span>changed file''' ====

In PowerAda, an Ada source file which a different ''[[#MARKER-9-1116|time stamp]]'' and a different source checksum than the file by the same name that is currently ''[[#MARKER-9-1065|loaded]]'' or ''[[#MARKER-9-1027|compiled]]''.

<span id="HEADING89-18"></span>
==== '''<span id="MARKER-9-1022"></span>CM''' ====

See ''[[#MARKER-9-1029|configuration management]]''.

<span id="HEADING89-20"></span>
==== '''<span id="MARKER-9-1023"></span>CM_INFO''' ====

# Configuration management (CM) information associated with a text file and the compilation unit(s) it contains, and shown by the PowerAda navigator and other tools.
# The name of a pragma recognized by the PowerAda compiler which specifies a text string to be recorded as the CM information for the source file containing it. The pragma SCCS_ID is an equivalent pragma. A common argument to pragma CM_INFO is an ''[[#MARKER-9-1094|sccs_id]]'' string.

<span id="HEADING89-23"></span>
==== '''<span id="MARKER-9-1024"></span>code''' ====

# Instructions to the computer.
# To write instructions for the computer.
# A representation of a condition, such as an error code.
# To represent data or a computer program in a symbolic form that can be accepted by a data processor.

<span id="HEADING89-28"></span>
==== '''<span id="MARKER-9-1025"></span>compilation''' ====

In PowerAda, a compilation is generally the translation of an Ada source program into an executable object module. When you use the PowerAda debugger, a compilation consists of one or more compilation units in a single file. If you include three package specifications and two package bodies in one file, that file represents one compilation consisting of five compilation units: three library units and two secondary units. There is usually only one compilation unit in a compilation.

<span id="HEADING89-30"></span>
==== '''<span id="MARKER-9-1026"></span>compilation unit''' ====

The smallest element of an Ada program that may be independently compiled. Formally, a compilation unit may be one of seven syntactic entities: a package specification, a package body, a subprogram specification, a subprogram body, a generic specificationspeciosities and body together, a library unit that is a generic instantiation, or a subunit. Names of compilation units are either the Ada subprogram name of the unit or (for Ada subunits) the name of the unit's ultimate ancestor followed by a period, (.), followed by the Ada subprogram name of the subunit.

<span id="HEADING89-32"></span>
==== '''<span id="MARKER-9-1027"></span>compile''' ====

# To translate a program written in a high-level programming language into an intermediate language, assembly language, or a matching language. See also, ''[[#MARKER-9-1065|load]]''.
# The computer actions required to transform a source file into an executable object file. A program that does this is called a compiler.

<span id="HEADING89-35"></span>
==== '''<span id="MARKER-9-1028"></span>compiled unit''' ====

A unit for which semantic information and machine code has been generated, as distinguished from a ''[[#MARKER-9-1075|pending unit]]'' for which only syntactic and dependency information has been recorded.

<span id="HEADING89-37"></span>
==== '''<span id="MARKER-9-1029"></span>configuration management''' ====

The tracking and controlling of how and why source files are created, organized, accessed, and changed, and from which versions of source a program is built. This is commonly referred to as CM.

<span id="HEADING89-39"></span>
==== '''<span id="MARKER-9-1030"></span>current''' ====

For a PowerAda compilation unit, the state where none of that unit's supporters has been recompiled since the unit itself was compiled. This state implies that all of the supporters exist, since the Ada language requires this in order for the program to be compiled. Currency implies that all supporters of a unit were compiled in the correct order, as defined by Ada language rules.

<span id="HEADING89-41"></span>
==== '''<span id="MARKER-9-1031"></span>dead variable''' ====

In PowerAda, a variable that is initialized, but is not used within the context of the program. Like unreachable code, dead variables are detected and removed by the optimizer.

<span id="HEADING89-43"></span>
==== '''<span id="MARKER-9-1032"></span>debugger''' ====

A program used to detect, trace, and eliminate errors in computer programs or software.

<span id="HEADING89-45"></span>
==== '''<span id="MARKER-9-1033"></span>dependents''' ====

PowerAda compilation units that would have to be recompiled if another unit were to be recompiled because of the compilation order imposed by the Ada language.

<span id="HEADING89-47"></span>
==== '''<span id="MARKER-9-1034"></span>delta project''' ====

A ''[[#MARKER-9-1079|project]]'' that has a [[#MARKER-9-1074|parent baseline]] project, and whose contents reflect "deltas" or changes to the contents of that parent.

<span id="HEADING89-49"></span>
==== '''<span id="MARKER-9-1035"></span>delta sublibrary''' ====

A hidden ''[[#MARKER-9-1101|sublibrary]]'' created within a user-visible sublibrary (e.g., adalib) to allow changes to the sublibrary while other tools such as the debugger or PowerAda Source Browser have a ''[[#MARKER-9-1091|read-lock]]'' on it.

<span id="HEADING89-51"></span>
==== '''ELF''' ====

The Executable and Linking Format (ELF) was originally developed by Unix System Laboratories and is rapidly becoming the standard for file formats. This is the standard object file format on the Linux operating system.

<span id="HEADING89-53"></span>
==== '''<span id="MARKER-9-1036"></span>executable file''' ====

A compiled and linked program which is usually generated by a compiler. Often, an executable file is named "a.out".

<span id="HEADING89-55"></span>
==== '''<span id="MARKER-9-1037"></span>exception''' ====

An error situation that may arise during program execution. Ada programs can respond to exceptions if they declare exception handlers.

<span id="HEADING89-57"></span>
==== '''<span id="MARKER-9-1038"></span>exports''' ====

For a PowerAda compilation unit U, all the direct dependents of U. That is, the set of all units whose ''[[#MARKER-9-1046|imports]]'' ('''[[#MARKER-9-1122|with]]s''') include U.

<span id="HEADING89-59"></span>
==== '''<span id="MARKER-9-1039"></span>extended family''' ====

The set of all of a PowerAda compilation unit's ''[[#MARKER-9-1114|supporters]]'' and all of their families, including the associated bodies and subunits. (The supporters of a unit include only the library units required for its compilation, not the associated bodies or subunits.) The extended family of a main subprogram includes exactly those units needed to ''[[#MARKER-9-1019|bind]]'' a program from that subprogram.

<span id="HEADING89-61"></span>
==== '''<span id="MARKER-9-1040"></span>extended line number''' ====

For [[PowerAda:APPENDIX E. Tools Reference/aprojbaseline#MARKER-9-1801|aprojbaseline]] or the PowerAda debugger ([[PowerAda:APPENDIX E. Tools Reference/adbg#MARKER-9-1750|adbg]]),a line number relative to the Ada compilation that contains the specified compilation unit. Extended line numbers are used for debugging generic instantiations and subprograms included due to ''[[#MARKER-9-1048|inlining]]''.

<span id="HEADING89-63"></span>
==== '''<span id="MARKER-9-1041"></span>external''' ====

In PowerAda, an entity--file, directory, ''[[#MARKER-9-1117|unit]] or [[#MARKER-9-1101|sublibrary]]''--is referred to as ''external'' when that entity exists outside the current ''[[#MARKER-9-1044|full project]]'', That is, it is neither ''[[#MARKER-9-1066|local]]'' to the ''[[#MARKER-9-1123|working project]]'' nor ''[[#MARKER-9-1097|shadowed]]'' in a ''[[#MARKER-9-1014|baseline project]]''.

<span id="HEADING89-65"></span>
==== '''<span id="MARKER-9-1042"></span>family''' ====

A PowerAda library unit together with its body and subunits (if any). Not all potential family members need be present: a library unit may have only an implicit specification. The family of a secondary unit is that unit together with any subunits.

<span id="HEADING89-67"></span>
==== '''full imports''' ====

The transitive closure of sublibrary imports for a given sublibrary, identifying the ''[[#MARKER-9-1081|project-relative name]]'' of all sublibraries that must be present in order for units in a given sublibrary to compile.

<span id="HEADING89-69"></span>
==== '''<span id="MARKER-9-1043"></span>fully qualified name''' ====

A qualified name that includes all names in the hierarchical sequence above the structure member to which the name refers, as well as the name of the member itself.

<span id="HEADING89-71"></span>
==== '''<span id="MARKER-9-1044"></span>full project''' ====

All files, directories, and sublibraries in the working project and all its imported ''[[#MARKER-9-1014|baseline project]]s.''

<span id="HEADING89-73"></span>
==== '''<span id="MARKER-9-1045"></span>history''' ====

A list of PowerAda debugger commands entered recently. The history command has a default list of the 20 most recently entered commands. You can use history to re-enter a previous command, or to form a new command by editing the history reference text.

<span id="HEADING89-75"></span>
==== '''<span id="MARKER-9-1046"></span>imports''' ====

''v.t.'' references or ''[[#MARKER-9-1122|with]]s,'' as in "unit A imports unit B" or "sublibrary S imports sublibrary T";

''n''. all units named in the context specification of a library unit (stated in its '''with''' clauses) and any supporting unit specifications introduced by the compiler, for example, the standard package SYSTEM. The imports of a secondary unit are all the units named in its context specification, any supporting unit requirements introduced by the compiler, its associated parent unit (if any), and the bodies of any generic specifications included among its other imports.

The imports of a ''[[#MARKER-9-1101|sublibrary]]'' are the all the sublibraries containing the imports of the units compiled in to that sublibrary. See ''[[#MARKER-9-1107|sublibrary imports]]''.

<span id="HEADING89-79"></span>
==== '''<span id="MARKER-9-1047"></span>inline expansion''' ====

Replacing a call to a subprogram with the actual code of the subprogram as part of the compilation process. This results in a speed increase at run time, but may require more run-time storage. In PowerAda, this is done only when optimization is specified, and only if the subprogram and call are within the same compilation unit, or if a pragma inline is applied to the subprogram's specification.

<span id="HEADING89-81"></span>
==== '''<span id="MARKER-9-1048"></span>inlining''' ====

See ''[[#MARKER-9-1047|inline expansion]]''.

<span id="HEADING89-83"></span>
==== '''<span id="MARKER-9-1049"></span>language reference manual (LRM83)''' ====

The document [[Guide:ada_lrm/ada_lrm|''Reference Manual for the Ada Programming Language'' (ANSI/MIL-STD-1815A-1983)]]. This document is the official, authoritative source on the syntax and semantics of the original Ada language. The ''<span id="MARKER-2-1052"></span>[[Guide:95lrm|Ada95 Reference Manual]] (SO/IEC 8652:1995), Version 6.0 defines the Ada95 language. The ''<span id="MARKER-2-1055"></span>[[Guide:9x_rationale/rat95-p1|Ada95 Rationale]]'', January 1995, from Intermetrics, Inc. is a very readable description of the rationale and functionality of the new features in Ada95, and is available on-line as part of PowerAda.''

<span id="HEADING89-85"></span>
==== '''<span id="MARKER-9-1058"></span>library''' ====

In PowerAda library management, a database that stores the various intermediate code files produced by the complier and records the dependency and order of compilation information as required by the Ada language specification. When compiling a unit that depends on other (previously compiled) units, the compiler gets the required dependency information (such as the package specification of a unit that is included with a with clause) from the library. Similarly, when an Ada program unit is to be linked, the library specifies the set of units that must be included to create an executable image.

A library is implemented by a ''[[#MARKER-9-1109|sublibrary imports file]]'' or ''[[#MARKER-9-1059|library list file]]'', together with the one or more ''[[#MARKER-9-1101|sublibrary]]'' directories named by that file.

<span id="HEADING89-88"></span>
==== '''library component''' ====

In PowerAda, a package body, package specification, subprogram body, subprogram specification, or object module that resides in a library.

<span id="HEADING89-90"></span>
==== '''<span id="MARKER-9-1059"></span>library list file''' ====

In PowerAda version 2, a text file containing the name of one or more sublibraries comprising an Ada program library. The default name for the library list file is <code>alib.list.</code> While still supported for compatibility, the library list file is superseded by the ''[[#MARKER-9-1109|sublibrary imports file]]'' file (<code>adalib.imports</code>) in PowerAda 3.

<span id="HEADING89-92"></span>
==== '''<span id="MARKER-9-1060"></span>library unit''' ====

In PowerAda, one of five syntactic entities: a subprogram declaration, a package declaration, a generic declaration, a generic instantiation, or a subprogram body in the case where there is no corresponding subprogram declaration. As the name implies, a library unit resides in the Ada program library. The significance of library units is that they may be referenced by other independently compiled units. This reference may either be explicit (referenced via a '''with''' clause) or implicit (such as the reference of a package body to its specification).

<span id="HEADING89-94"></span>
==== '''link<span id="MARKER-9-1061"></span>''' ====

To interconnect items of data or portions of one or more computer programs, such as linking object programs by a linkage editor. See ''[[#MARKER-9-1019|bind]]'', and ''[[#MARKER-9-1100|statically linked]]''.

<span id="HEADING89-96"></span>
==== '''<span id="MARKER-9-1062"></span>linkable''' ====

The state of an Ada program when all its compilation-unit dependencies have been resolved. To produce an executable file, the compiler does not need to do any translation of Ada source: it only needs to call the linkage-editor.

<span id="HEADING89-98"></span>
==== '''<span id="MARKER-9-1063"></span>linkage editor''' ====

A program that resolves cross-references between separately-assembled object modules and then assigns final addresses to create a single relocatable load module.

<span id="HEADING89-100"></span>
==== '''<span id="MARKER-9-1064"></span>link name''' ====

The symbol representing the entry point of some generated code. The terms linkname and symbol are generally used interchangeably.

<span id="HEADING89-102"></span>
==== '''<span id="MARKER-9-1065"></span>load''' ====

To syntax-check and record the dependencies and command-line options of an Ada source file in order to enable subsequent compilation operations. Source files can be ''load''ed in any order, creating ''[[#MARKER-9-1075|pending units]]'' in the sublibrary. A subsequent update operation on the sublibrary then compiles the units in the correct order.

<span id="HEADING89-104"></span>
==== '''<span id="MARKER-9-1066"></span>local''' ====

In PowerAda, an entity--file, directory, ''[[#MARKER-9-1117|unit]] or [[#MARKER-9-1101|sublibrary]]''--is referred to as ''local'' when that entity exists in the ''[[#MARKER-9-1123|working project]]''. See ''[[#MARKER-9-1097|shadowed]]'' and ''external''.

<span id="HEADING89-106"></span>
==== '''lock file''' ====

In PowerAda, a file used to implement an advisory ''[[#MARKER-9-1091|read-lock]]'' or ''[[#MARKER-9-1124|write-lock]]'' on a ''[[#MARKER-9-1101|sublibrary]]''. This file is in the sublibrary directory and is called <code>adalockfile</code>. Deleting this file defeats locking on that sublibrary.

<span id="HEADING89-108"></span>
==== '''<span id="MARKER-9-1067"></span>log file''' ====

A file that contains a record of your commands and comments and the debugger's responses. This log can be used for later analysis, for documenting program behavior, or for making comparisons after program modification.

<span id="HEADING89-110"></span>
==== '''<span id="MARKER-9-1068"></span>LRM83''' ====

See ''[[#MARKER-9-1049|language reference manual (LRM83)]]''.

<span id="HEADING89-112"></span>
==== '''<span id="MARKER-9-1069"></span>macro''' ====

A series of PowerAda debugger commands that execute in sequence when you call the macro. With the macro option, you can define and manipulate new debugger commands.

<span id="HEADING89-114"></span>
==== '''<span id="MARKER-9-1070"></span>navigate''' ====

In [[PowerAda:APPENDIX E. Tools Reference/powerada#MARKER-9-1858|powerada]], moving between views of information within a ''[[#MARKER-9-1079|project]]'' in a manner similar to moving between "web pages" with a World Wide Web browser.,

<span id="HEADING89-116"></span>
==== '''<span id="MARKER-9-1071"></span>obsolete''' ====

A PowerAda library unit that is not ''[[#MARKER-9-1030|current]]''.

<span id="HEADING89-118"></span>
==== '''<span id="MARKER-9-1072"></span>optimized unit''' ====

A PowerAda compilation unit that has been processed by one or more of the compiler's optimizing phases. Some source-level information is unavailable to the debugger when it examines the unit. You can use an optimized unit in the same contexts as the corresponding ''unoptimized'' unit. Optimized and unoptimized units can be mixed within an Ada program.

<span id="HEADING89-120"></span>
==== '''<span id="MARKER-9-1073"></span>parent''' ====

In PowerAda, the associated specification of a package body or subprogram body. The parent of a subunit or task is the body in which it was declared.

<span id="HEADING89-122"></span>
==== '''<span id="MARKER-9-1074"></span>parent baseline''' ====

The baselined project relative to which changes are made in the working project. The PowerAda project mechanism supports a hierarchy, such that the contents of a project may stand alone, or represent incremental changes to a parent baseline. The parent of a project P is specified when P is created, and may later be changed. A parent baseline project is designated by its ''[[#MARKER-9-1082|project root]]'' or by an alias defined in a ''[[#MARKER-9-1016|baselines file]].''

<span id="HEADING89-124"></span>
==== '''<span id="MARKER-9-1075"></span>pending unit''' ====

A unit which has been ''[[#MARKER-9-1065|loaded]]'' (by [[PowerAda:APPENDIX E. Tools Reference/aprojbuild#MARKER-9-1806|aprojbuild]] or a [[PowerAda:APPENDIX E. Tools Reference/powerada#MARKER-9-1858|powerada]] Build operation) but not yet compiled. When the pending unit is successfully compiled it becomes a ''[[#MARKER-9-1028|compiled unit]]'' which replaces any previously compiled unit of that name in the same sublibrary.

<span id="HEADING89-126"></span>
==== '''<span id="MARKER-9-1076"></span>PowerAda executable''' ====

An ''[[#MARKER-9-1036|executable file]]'' created by the PowerAda compiler, which has stored in it additional information about the Ada compilation units and sublibraries from which it was built, allowing consistency checking, debugging, and automatic rebuilding with PowerAda tools.

<span id="HEADING89-128"></span>
==== '''<span id="MARKER-9-1077"></span><span id="MARKER-9-1078"></span>program unit''' ====

One of four kinds of Ada program structures: a package, a subprogram (procedure or function), a generic, or a task.

<span id="HEADING89-130"></span>
==== '''<span id="MARKER-9-1079"></span>project''' ====

In PowerAda, a specially marked directory and its subdirectories which define the environment in which Ada programs are built, examined, and debugged. A project is created from with [[PowerAda:APPENDIX E. Tools Reference/powerada#MARKER-9-1858|powerada]] or with the aprojinit command line tool.

<span id="HEADING89-132"></span>
==== '''<span id="MARKER-9-1080"></span>project library''' ====

An ordered set of sublibraries, defined by a single ''[[#MARKER-9-1092|root sublibrary]]'' and the closure of all its ''[[#MARKER-9-1109|sublibrary imports file]]''.

<span id="HEADING89-134"></span>
==== '''<span id="MARKER-9-1081"></span>project-relative name''' ====

The portion of a file's pathname with the path of the ''[[#MARKER-9-1082|project root]]'' removed from the front. The project root may be indicated by "=/" in such pathnames. Source file names are stored in the ''[[#MARKER-9-1058|library]]'' with "//" indicating the start of the project-relative portion of the name.

<span id="HEADING89-136"></span>
==== '''<span id="MARKER-9-1082"></span>project root''' ====

The top-level directory of a ''[[#MARKER-9-1079|project]]''. The path of this directory is the one specified when referencing the project as a ''[[#MARKER-9-1014|baseline project]]'' and it is relative to this directory that all paths within the project are interpreted.

<span id="HEADING89-138"></span>
==== '''<span id="MARKER-9-1083"></span>qualified name''' ====

# A name made unique by the addition of one or more qualifiers.
# A data name explicitly accompanied by a specification of the class to which it belongs in a specified classification system, for example the PowerAda classification system for Ada compilation units.

<span id="HEADING89-141"></span>
==== '''qualifier''' ====

# A unique name used to identify another name.
# A modifier that makes a name unique.
# All names in a qualified name other than the rightmost, which is called the base name or simple name.

<span id="HEADING89-145"></span>
==== '''<span id="MARKER-9-1084"></span>RM95''' ====

The ''<span id="MARKER-2-1085"></span>[[Guide:95lrm|Ada95 Reference Manual]] (SO/IEC 8652:1995), Version 6.0 defines the Ada95 language. The ''<span id="MARKER-2-1088"></span>[[Guide:9x_rationale/rat95-p1|Ada95 Rationale]]'', January 1995, from Intermetrics, Inc. is a very readable description of the rationale and functionality of the new features in Ada95, and is available on-line as part of PowerAda.''

<span id="HEADING89-147"></span>
==== '''<span id="MARKER-9-1091"></span>read-lock''' ====

In PowerAda, an advisory lock held on a special file in a sublibrary indicating that the sublibrary is being read, and preventing other PowerAda operations from writing in the same sublibrary. A read-lock on a sublibrary will cause the creation of a ''[[#MARKER-9-1035|delta sublibrary]]'' by actions which create new units, such as compiling, copying, or moving.

<span id="HEADING89-149"></span>
==== '''<span id="MARKER-9-1092"></span>root sublibrary''' ====

The ''[[#MARKER-9-1101|sublibrary]]'' whose corresponding ''[[#MARKER-9-1109|sublibrary imports file]]'' define a given ''[[#MARKER-9-1080|project library]].''

<span id="HEADING89-151"></span>
==== '''<span id="MARKER-9-1093"></span>run-time checks''' ====

Error checking that occurs while a PowerAda program runs. If an error is detected, the program raises an exception.

<span id="HEADING89-153"></span>
==== '''<span id="MARKER-9-1094"></span>sccs_id''' ====

A string of special character sequences which are replaced with actual values when placing or returning a file to configuration management. If a string containing such a sequence is the argument to the PowerAda pragma [[#MARKER-9-1023|CM_INFO]] (or its equivalent pragma, SCCS_ID), it is recorded in the library and executable file and may be viewed with a number of tools. A useful sccs_id for the CMVC configuration management system is "%E% %U%, %I%, %W%".

<span id="HEADING89-155"></span>
==== '''<span id="MARKER-9-1095"></span>script file''' ====

In the PowerAda debugger, a script file is a file that contains a series of commands that can be used to drive the debugger. Script files are useful for debugging large, complex programs when you may not be able to complete a debugging session in one sitting.

<span id="HEADING89-157"></span>
==== '''<span id="MARKER-9-1096"></span>secondary unit''' ====

In PowerAda, the body of a library unit (such as a subprogram body, package body, generic body, or subprogram body) or a subunit. All compilation units that are not library units are secondary units. Secondary units are not subject to reference by other independently compiled units and can be thought of as the '''hidden''' implementation of a library unit or '''separate''' declaration.

<span id="HEADING89-159"></span>
==== '''<span id="MARKER-9-1097"></span>shadowed''' ====

In PowerAda, an entity--file, directory, ''[[#MARKER-9-1117|unit]] or [[#MARKER-9-1101|sublibrary]]''--is referred to as ''shadowed'' when that entity exists in a read-only baseline that is a parent (or ancestor) of the current project but which is not in the ''[[#MARKER-9-1123|working project]]''. See ''[[#MARKER-9-1066|local]].''

<span id="HEADING89-161"></span>
==== '''<span id="MARKER-9-1098"></span>simple name''' ====

Synonym for ''[[#MARKER-9-1018|base name]]''.

<span id="HEADING89-163"></span>
==== '''<span id="MARKER-9-1099"></span>stab strings''' ====

Information in an XCOFF module's string table which support debugging of programs compiled with AIX compilers for C, FORTRAN and other languages. See ''[[#MARKER-9-1125|XCOFF]]''.

<span id="HEADING89-165"></span>
==== '''<span id="MARKER-9-1100"></span>statically linked''' ====

This means that all shared libraries (e.g., <code>libc.a)</code> are linked into the executable. This is specified by the option <code>-bnso</code> on the '''ld''' command for AIX, and the -Bstatic option for Linux.

<span id="HEADING89-167"></span>
==== '''<span id="MARKER-9-1101"></span>sublibrary''' ====

The basic component of a PowerAda ''[[#MARKER-9-1058|library]]''. It contains information about a set of units that have been ''[[#MARKER-9-1065|loaded]]'' and ''compiled''. A sublibrary is implemented as a directory, usually (though not required to be) named <code>adalib</code>.

<span id="HEADING89-169"></span>
==== '''<span id="MARKER-9-1102"></span><span id="MARKER-9-1103"></span>sublibrary files''' ====

The Ada source files compiled into a given sublibrary. The ''[[#MARKER-9-1081|project-relative names]]'' of the files for a sublibrary are listed in a ''[[#MARKER-9-1104|sublibrary files file]]''

<span id="HEADING89-171"></span>
==== '''<span id="MARKER-9-1104"></span><span id="MARKER-9-1105"></span>sublibrary files file''' ====

A text file, usually called <code>adalib.files</code>, which names the ''[[#MARKER-9-1102|sublibrary files]]'' associated with a given ''[[#MARKER-9-1092|root sublibrary]]'', usually named <code>adalib</code>. The sublibrary imports file associated with a sublibrary named <code>S</code> is named <code>S.files</code> in the same directory.

<span id="HEADING89-173"></span>
==== '''<span id="MARKER-9-1107"></span><span id="MARKER-9-1108"></span>sublibrary imports''' ====

Other sublibraries upon which a given ''[[#MARKER-9-1101|sublibrary]]'' directly depends. Specifically, the sublibrary imports for sublibrary S are those sublibraries other than S which contain the ''[[#MARKER-9-1046|imports]]'' of ''[[#MARKER-9-1026|compilation unit]]s'' in S. The ''[[#MARKER-9-1081|project-relative names]]'' of the imports for a sublibrary are listed in a ''[[#MARKER-9-1109|sublibrary imports file]]''

<span id="HEADING89-175"></span>
==== '''<span id="MARKER-9-1109"></span><span id="MARKER-9-1110"></span>sublibrary imports file''' ====

A text file, usually called <code>adalib.imports</code>, which names the ''[[#MARKER-9-1107|sublibrary imports]]'' associated with a given ''[[#MARKER-9-1092|root sublibrary]]'', usually named <code>adalib</code>. The sublibrary imports file associated with a sublibrary named <code>S</code> is named <code>S.imports</code> in the same directory.

<span id="HEADING89-177"></span>
==== '''<span id="MARKER-9-1112"></span>subprogram''' ====

In Ada, procedure or function. Overloading makes it possible for a subprogram to be both a procedure and a function depending on how it is called.

<span id="HEADING89-179"></span>
==== '''<span id="MARKER-9-1113"></span>subunit''' ====

A subunit is the implementation of a body stub, referenced by a separate clause, that corresponds to the body of a package, subprogram or generic unit.

<span id="HEADING89-181"></span>
==== '''<span id="MARKER-9-1114"></span>supporters''' ====

In PowerAda, all the compilation units required by the language to allow a unit to be compiled. This consists of the unit's imports, their imports, and so on.

<span id="HEADING89-183"></span>
==== '''<span id="MARKER-9-1115"></span>task identifier''' ====

In PowerAda, an alphabetic label or identification for a task. This label is determined by the debugger TASKS option. A task id is assigned to each task that has not terminated.

<span id="HEADING89-185"></span>
==== '''<span id="MARKER-9-1116"></span>time stamp''' ====

Records the date and time when a PowerAda compilation unit was last modified.

<span id="HEADING89-187"></span>
==== '''traceback''' ====

For the PowerAda debugger, a listing of the routines that are in the call chain above the code you are debugging. For example, if you set a breakpoint within an Ada procedure and request a call traceback, you see a list of all the procedures that called your Ada procedure, in the order in which they called it. All the calling procedures in the call chain are listed up to, but not including, the operating system calling the original highest level routine.

<span id="HEADING89-189"></span>
==== '''<span id="MARKER-9-1117"></span>unit''' ====

Synonym for ''[[#MARKER-9-1026|compilation unit]]''.

<span id="HEADING89-191"></span>
==== '''<span id="MARKER-9-1118"></span>unreachable code''' ====

Code that cannot be reached during program execution. Unreachable code is detected and removed as part of optimization.

<span id="HEADING89-193"></span>
==== '''<span id="MARKER-9-1119"></span>unused subprograms''' ====

In PowerAda, subprograms unused only within the context of a specific program or set of units. For example, a program might call only a small subset of subprograms in a utility package. The remaining uncalled (unreachable) subprograms constitute unreachable code in the context of that program.

<span id="HEADING89-195"></span>
==== '''<span id="MARKER-9-1120"></span>update''' ====

To make ''[[#MARKER-9-1030|current]]'' all source files and ''[[#MARKER-9-1075|pending units]]'' associated with a specified ''[[#MARKER-9-1117|unit]]'', ''[[#MARKER-9-1101|sublibrary]]'', ''[[#MARKER-9-1058|library]]'', or ''[[#MARKER-9-1076|PowerAda executable]]''.

<span id="HEADING89-197"></span>
==== '''<span id="MARKER-9-1121"></span>visit''' ====

In [[PowerAda:APPENDIX E. Tools Reference/powerada#MARKER-9-1858|powerada]], the process of creating and presenting a view of information related to the current view, or to a specific element of the current view. See ''[[#MARKER-9-1070|navigate]]'',

<span id="HEADING89-199"></span><span id="MARKER-9-1122"></span>
==== '''with''' ====

The noun "with" is used to refer to a unit named in an Ada context ('''with''') clause, as in, "B is a ''with'' of A."

The verb "to with" is commonly used to mean "to name in an Ada '''with''' clause". Hence when we say A ''withs'' B, or B ''is withed by'' A, we mean:

<pre>with B;
package A is ... end A;</pre>
<span id="HEADING89-203"></span>
==== '''<span id="MARKER-9-1123"></span>working project''' ====

The project in which all work is done, as distinguished from a ''[[#MARKER-9-1014|baseline project]]'' which is read-only. See also, ''[[#MARKER-9-1066|local]]''.

<span id="HEADING89-205"></span>
==== '''<span id="MARKER-9-1124"></span>write-lock''' ====

In PowerAda, an advisory lock held on a lock file in a sublibrary (a per-sublibrary lock) or in the ''[[#MARKER-9-1082|project root]]'' (a project-wide lock) indicating that the sublibrary or project is being written to, and preventing other PowerAda operations from reading or writing in the same sublibrary or project. For most tools, the default action is to wait for the lock to be released before continuing.

<span id="HEADING89-207"></span>
==== '''<span id="MARKER-9-1125"></span>XCOFF''' ====

EXtended Common Object File Format. This is the format of object files generated by AIX compilers and assemblers and linked by the AIX '''ld''' command. This is a superset of the standard COFF format defined for many UNIX platforms. XCOFF is not well-documented in the standard AIX documentation.

__NOTOC__