NAME

ada.umgr − examine and modify an Ada library

SYNOPSIS

ada.umgr [ -r | -u ] libraryname

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.umgr, the Ada unit manager, can be used to examine and modify the contents of an Ada library. 

The following options are recognized:

−r Open the Ada library in read-only mode.  The Ada library can only be examined, but not modified.  This is the default mode. 

−u Open the Ada library in update mode.  The ERASE and ACQUIRE commands and the RESET option of the CHECK command require that the Ada library be opened in update mode. 

Ada.umgr is an interactive tool which, when executed, prompts with "Unit_Manager".  Commands are then entered to examine or modify the contents of the Ada library. 

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

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

Acquire Make links in the current Ada library to units in another Ada library (in the same family or INSTALLATION family). 

Check Verify that links in the current Ada library to units in other Ada libraries are valid (that is, up to date). 

Default Set default values for commands. 

Erase Erase units in the current Ada library. 

Global Set global characteristics for commands. 

Help Obtain help on the various ada.umgr commands. 

Invoke Read ada.umgr commands from a file. 

Join Compute a program closure (that is, determine whether a bind can be performed). 

List List units in the current Ada library. 

Other Change the current Ada library. 

Quit Leave ada.umgr. 

System Execute a shell command. 

Users List dependencies of a unit in the current Ada library. 

View Obtain general information about the current Ada library. 

The help command provides online help for all the commands. 

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

If the file .ada.umgrdf exists in the user’s home directory, its commands are executed after those in .ada.umgrrc (if present) and before the first prompt is issued.  The commands in this file are DEFAULT commands saved automatically by using 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.umgr) 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 part which holds the lock.  An Ada family or library locked for reading can be accessed by any part of the Ada compilation system which only desires to read from the Ada family or library. 

If ada.umgr 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 might be locked, but the locking program(s) might 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 may 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 which might find the contents invalid or might damage the Ada family or Ada library. 

AUTHOR

Ada.umgr was developed by HP and Alsys. 

FILES

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

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

$ADA_PATH/ada.umgr Ada interactive unit manager command. 

$ADA_PATH/adacli Ada command language interpreter. 

$ADA_PATH/ada.mngrs.bin Ada components manager subprocess. 

$ADA_PATH/ada.umgr.hlp Ada unit manager help command data. 

$ADA_PATH/ada.umgr.btl Ada unit manager command tables. 

SEE ALSO

ada(1), ada.fmgr(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.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