Progress
Database Administration
Guide and Reference
PROUTIL HOLDER Qualifier
Determines whether the database currently in use is in single-user mode, multi-user mode, or in use by a Progress utility. This information is useful before performing a database backup or shutting down a database.
When you execute this command, PROUTIL returns a different return code depending on how you are running Progress. To get the information, you must run PROUTIL with the HOLDER qualifier and test the command return code in a UNIX script or Windows batch file.
SYNTAX
db-name
Specifies the database you are using.
NOTES
- When the HOLDER qualifier completes, it sets a return code that you can test in a UNIX script or Windows batch file. The return codes for the HOLDER qualifier on UNIX are shown in the following table:
SYNTAX Operating System Return Code Description UNIXWindows 0 Database not in use. 14 Database locked by single user, PROUTIL, or RFUTIL. 16 Database open in multi-user mode.Any other nonzero return code indicates that an error has occurred.
- Return codes can be added or changed from one release to the next. Use scripts that depend on a specific return code with caution.
- This example shows how you might use the HOLDER qualifier on UNIX in a script that performs a database backup:
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |