![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Control > Maintenance > Maintain (Apex/Summit)The Control > Maintenance > Maintain command checks and makes the state managed by Apex consistent when it has been corrupted (usually by outside tools). This command displays the Maintain dialog box.
Maintain always checks the directory structure and verifies the existence of required files. All inconsistencies are displayed in an Output window.
For example, Control > Maintenance > Maintain can repair the version-control state of a checked-in file whose UNIX file permissions have been changed; executing the command restores its permissions to be read-only.
This command is also used to release locks placed on files by Apex/Summit. This is described in detail in the Command Reference.
Maintain Dialog Box Fields:
Objects Field
The objects list field displays the objects names or view names that maintenance is to be performed on. Use the Object input field to add or remove object names.
Maintenance Check Boxs
- Only check for problems, don't make repairs
Displays problems in an Output window but does not repair them. If you select this check box, the other options you specify do not repair the corruptions they check for.
- Lock information maintenance
Recovers abandoned locks and reverts or completes aborted updates.
- Force Lock Recovery
Recovers locks held by a process on a machine that is temporarily inaccessible or has been removed from the network. In such cases, the Maintain command cannot positively determine whether the process holding the lock still exists and assumes that the process is still active.
This option assumes the process has terminated and recovers locks on that basis. It must be used in conjunction with Lock information maintenance.
- Unix permissions maintenance
Reverts UNIX file permissions to their proper values.
- Recursively maintain all subdirectories
Repairs corrupted parts of nested views within a named subsystem. If you name a directory outside a subsystem, the command examines its subdirectories for subsystems and views.
- Compilation state of view maintenance
Repairs corruptions in any state involving compilation, including the state associated with importing and exporting.
Version Control Check Box
- Selecting this check box checks the consistency of the information in the version-control database and makes version-control information consistent. Different objects, as specified in the Objects list field, are affected in the following way:
- Subsystem: Repairs the consistency of the version-history family databases.
- View or Directory: Repairs the consistency of information for all files in the view or directory.
- File: Repairs the consistency of the version-control information, including the contents of the file and the permissions. If the contents of any file are changed by this process, then the contents of the file's original contents are saved in an uncontrolled text file called filename.saved.
Abandon Unreachable Check Box
Selecting this check box specifies that the reservation on checked-out files is to be abandoned if the view containing the checked-out file does not exist or is otherwise unreachable. This option is used in conjunction with the Version Control Maintenance checkbox when maintenance is being applied to history information in a subsystem.
History Field
Enter the history name in the history field to specify the version-history family within the version-control database to check. The default value all makes the command check all history families. For each version-history family specified, the command checks all files associated with that family that exist in the closure specified in the file locator.
Command Line Interface: maintain
Additional Topics
Rational Software Corporation http://www.rational.com support@rational.com techpubs@rational.com Copyright © 1993-2001, Rational Software Corporation. All rights reserved. |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |