Series 300 Only

NAME

ada.fmgr − create, examine, and modify an Ada family

SYNOPSIS

ada.fmgr

DESCRIPTION

Ada.fmgr, the Ada family manager, can be used to create, examine, and modify the contents of an Ada family.  An Ada family is a group of Ada libraries that are all visible to one another. 

Units in a library within a particular family can be dependent on units in another library in the same family and a program can be composed (bound) using units from any number of libraries in a given family. 

Libraries that are members of different families are normally invisible to each other and cannot access each other’s units.  There is one exception to this rule:  libraries belonging to the INSTALLATION family (a family provided with the Ada compilation system) are accessible to libraries in any other family. 

Ada.fmgr is an interactive tool that, when executed, prompts with "Family_Manager." Commands are then entered to examine or modify the contents of a family. 

For the syntax and semantics of the commands, refer to the "Ada User’s Guide," or use the available online help facility in the family manager. 

The following commands can be typed in response to the "Family_Manager" prompt:

Default Set default values for commands. 

Erase Remove an Ada family. 

Global Set global characteristics for commands. 

Help Obtain help on the various ada.fmgr commands. 

Invoke Read ada.fmgr commands from a file. 

List List the Ada libraries in an Ada family. 

New Create a new Ada family. 

Quit Leave ada.fmgr. 

Recover Rebuild an Ada family from a list of libraries. 

System Execute a shell command. 

Unlock Unlock a locked Ada family. 

The help command provides online help for all commands. 

If the file .ada.fmgrrc exists in the user’s home directory, its commands are executed before the first prompt is issued. 

If the file .ada.fmgrdf exists in the user’s home directory, its commands are executed after those in .ada.fmgrrc (if present) and before the first prompt is issued.  The commands in this file are usually DEFAULT commands saved automatically by the use of the DEFAULTS => KEEP parameter of the QUIT command. 

Environment Variables

Two environment variables, ADA_PATH and ADA_PREDEF_LIB, are associated with all components of the the Ada compilation system.  Both must be set properly and exported before any component of the Ada compilation system (including ada.fmgr) can be used (see ada(1), Environment Variables). 

Locks

To ensure the integrity of their internal data structures, Ada libraries and families are locked for the duration of operations that are performed on them.  Normally Ada families are locked only briefly when a library is added, removed, or renamed; however, sometimes multiple Ada libraries must be locked for longer periods during a single operation.  If more than one library is locked, ada places an exclusive lock on one library, for updating, and a shared lock on any others to remain open for read-only purposes. 

An Ada family or library locked for updating cannot be accessed in any way by any part of the Ada compilation system except by the locking agent.  However, an Ada family or library locked for reading can be accessed by any part of the Ada compilation system for read-only purposes. 

If ada.fmgr cannot obtain a lock, it displays an informational message and terminates. 

Under some circumstances, an Ada family or Ada library may be locked, but the locking program(s) may have terminated (for example, due to system crash or network failure).  If you determine that the Ada family or Ada library is not actually locked, you can remove the lock. 

Use ada.unlock(1) to unlock an Ada library and the UNLOCK command of ada.fmgr(1) to unlock an Ada family.  However, unlocking should be done with care.  If an Ada family or Ada library is actually locked by a tool, unlocking it permits access by other tools that might find the contents invalid or might damage the Ada family or Ada library. 

AUTHOR

Ada.fmgr was developed by HP and Alsys. 

FILES

$HOME/.ada.fmgrrc User start up commands. 

$HOME/.ada.fmgrdf User start up defaults. 

$ADA_PATH/ada.fmgr.bin
Ada family manager subprocess.

$ADA_PATH/ada.fmgr.hlp
Ada family manager help command data.

$ADA_PATH/ada.fmgr.btl
Ada family manager command tables.

SEE ALSO

ada(1), ada.format(1), ada.mklib(1), ada.mvlib(1), ada.probe(1), ada.protect(1), ada.rmlib(1), ada.umgr(1), ada.unlock(1).  ada.xref(1). 

Ada User’s Guide (Series 300), HP Part No. 98860-90000. 

INTERNATIONAL SUPPORT

8-bit file names. 

Hewlett-Packard Company  —  May 11, 2021