NAME

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

SYNOPSIS

ada.fmgr

Remarks:

This command requires installation of optional Ada software (not included with the standard HP-UX operating system) before it can be used. 

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. 

There are two families that are special to the the Ada compilation system.  They are the PUBLIC and INSTALLATION families.  These two families can only be created, moved, and removed using ada.fmgr, and can not be manipulated with the ada.mkfam, ada.mvfam, and ada.rmfam commands.  However, other operations may be performed on the INSTALLATION and PUBLIC families using the appropriate commands and options. 

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. 

Mend Rebuild an Ada family from a list of libraries. 

New Create a new Ada family. 

Quit Leave ada.fmgr. 

Rename Rename an Ada family. 

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 DEFAULT commands saved automatically by the use of the DEFAULTS => KEEP parameter of the QUIT command. 

Environment Variables

The environment variable ADA_PATH is associated with all components of the Ada compilation system.  It 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 libraries within them are manipulated.  However, sometimes multiple Ada libraries must be locked for longer periods during a single operation.  If more than one library must be locked for a single operation, at most one library is locked for updating and all other locked libraries are locked for read-only. 

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 after a suitable number of retries,, 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 locked but should not be locked, you can remove the lock. 

Use ada.unlock(1) to unlock an Ada library and ada.funlock(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. 

WARNINGS

Care should be taken when specifying the names PUBLIC, INSTALLATION, and OLD.  These keywords are recognized by the family manager as having special meanings, and their use as local family names is strongly discouraged. 

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 Ada interactive family manager command. 

$ADA_PATH/adacli Ada command language interpreter. 

$ADA_PATH/ada.mngrs.bin
Ada components 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.funlock(1), ada.lmgr(1), ada.lsfam(1), ada.lslib(1), ada.make(1), ada.mkfam(1), ada.mklib(1), ada.mvfam(1), ada.mvlib(1), ada.probe(1), ada.protect(1), ada.rmfam(1), ada.rmlib(1), ada.umgr(1), ada.unlock(1), ada.xref(1),

Ada User’s Guide (Series 300).

EXTERNAL INFLUENCES

International Code Set Support

Single-byte character code sets are supported within file names. 

Hewlett-Packard Company  —  HP-UX Release 7.0: Sept 1989