Progress
Version 9
Product Update Bulletin


AIMAGE QUERY Qualifier

The AIMAGE QUERY qualifier to RFUTIL provides you with a tool to query the status of a specified AI extent. The output of AIMAGE QUERY is intentionally brief. For most queries, the result returned will be a single number or word. The output is designed to be easily incorporated into scripts for managing your after-imaging.

Operating System
Syntax
UNIX
Windows
rfutil db-name -C aimage query query-option by 
search-option search-value 

db-name

Specifies the database you are using.

query-option

Specifies the information you want to gather about the AI extent. Supply one of the options from column 1 of Table O–1.

Table O–1: AIMAGE QUERY Options
query-option
Value Returned
EXTNUM
The extent number.
STATUS
The status of the extent: FULL, LOCKED, BUSY, EMPTY.
TYPE
The type of file: Fixed Length or Variable Length.
SIZE
The size of the extent in 1K blocks.
USED
The amount of the extent used in 1K blocks.
NAME
The full filename of the extent.
SEQUENCE
The sequence number.
STARTDATE
The date and time after-imaging started writing to the extent.
ALL
All of the above information.

search-option

Specifies the how you are identifying the AI extent to query. Supply one of the options from column one of Table O–2.

search-value

Specifies the match criteria for the search-option. Supply the value indicated in column 2 of Table O–2 that matches your search-option.

Table O–2: AIMAGE QUERY Search Options and Values 
search-option
search-value
EXTNUM
Integer value. In a file named, dbname.an, the EXTNUM is the value n.
NAME
Character string. The extent file name.
SEQUENCE
Integer value. The sequence number of the extent.

NOTES:


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095