Try OpenEdge Now
skip to main content
Database Administration
Reference : RFUTIL Utility : RFUTIL utility syntax
 

RFUTIL utility syntax

Performs various roll-forward recovery activities, depending on the qualifier you supply.

Syntax

rfutil db-name -C qualifier
     [ [-userid username[-password password]]|
       [ -U username -P password ]]
         [-Passphrase]

Parameters

db-name
Specifies the database you are using.
-C
Specifies a particular utility or function when you use the RFUTIL command.
qualifier
Specifies the qualifier that you want to use. You can supply the qualifiers listed in Table 104.
-userid username[-password passwd] -U username -P passwd
A pair of username and password parameters are used together to support a common user authentication model to specify the user ID and password when connecting to an OpenEdge RDBMS.OpenEdge authenticates the user ID and password against the user accounts defined by the authentication system configured for the user's security domain.
Use username and password parameters to identify an authenticated database administrator.
If you do not specify a user ID and password for a database connection, OpenEdge assigns the OS process's user-id as the default user-id.
For more information on authentication systems and security domains, see OpenEdge Getting Started: Identity Management.
-Passphrase
For encryption-enabled databases only, directs RFUTIL to prompt for a passphrase to authenticate the key store. Utilities that open the database must at a minimum authenticate as the key store user. Utilities that modify encryption policies (such as enabling or disabling encryption of after-image files) must authenticate as the key store admin. See Transparent Data Encryption for more information on transparent data encryption and key store authentication.
If your database is enabled for transparent data encryption and configured for manual start, you must specify -Passphrase every time the database is opened.
Note: RFUTIL and its qualifiers support the use of internationalization startup parameters such as -cpinternal codepage and -cpstream codepage. See DatabaseStartup Parameters for a description of database-related internationalization startup parameters.
The table below lists the RFUTIL qualifiers. See the appropriate section for each of the qualifiers for more detailed information.
Table 104. RFUTIL utility qualifiers
Qualifier
Description
AIARCHIVER DISABLE
Disables the AI File Management Utility.
AIARCHIVER ENABLE
Enables the AI File Management Utility.
AIARCHIVER END
Shuts down the AI File Management Utility daemon.
AIARCHIVER SETDIR
Changes the archive destination directory list for the AI File Management Utility daemon.
AIARCHIVER SETINTERVAL
Changes the value of the archive interval for the AI File Management daemon.
AIARCHIVE EXTENT
Manually archives the specified AI extent when AI File Management is not running.
AIMAGE AIOFF
Disables after-imaging for a database during maintenance.
AIMAGE BEGIN
Enables after-imaging for a database.
AIMAGE END
Disables after-imaging for a database.
AIMAGE EXTENT EMPTY
Marks an AI extent as empty and informs the database manager that the indicated AI extent has been manually backed up and is now free for reuse.
AIMAGE EXTENT FULL
Displays the pathname of the oldest filled file.
AIMAGE EXTENT LIST
Displays information about extents.
AIMAGE EXTRACT
Extracts the active blocks of an AI extent and writes them to a file.
AIMAGE NEW
Switches after-imaging to the next AI extent.
AIMAGE QUERY
Queries an AI extent for status.
AIMAGE SCAN
Scans AI files and displays information for the files.
AIMAGE TRUNCATE
Truncates all of the variable-length AIextents and optionally sets the AI block size with the After-image Block Size (-aiblocksize) parameter.
AIVERIFY PARTIAL
Verifies the AI extent by validating AI files before they are applied. This verification focuses on the AI block and the rlnote structure (note headers), while providing additional information in error messages that specify issues found in the AI extent.
AIVERIFY FULL
Verifies the full AI extent, including verification of note data members.
MARK BACKEDUP
Marks the database file, indicating that you have just completed a backup of the database.
ROLL FORWARD
Reconstructs a database by applying to that database all notes stored in the AI file.
ROLL FORWARD OPLOCK
Enforces a protection mechanism during the roll forward process, so that there will be no interruption to the target database before the final roll forward session is completed.
ROLL FORWARD RETRY
Restarts the roll-forward operation on the after-image extent that was in the process of rolling forward. The retry operation finds the transaction in process at the time of failure and resumes rolling forward.
ROLL OPUNLOCK
Cancels the roll forward protection established by ROLL FORWARD OPLOCK.
SEQUENCE
Updates the after-image sequence number of a database.
Note: You cannot use RFUTIL against a database in single-user mode.
The RFUTIL entries that follow describe each of these qualifiers.