RFUTIL AIMAGE QUERY qualifier

Queries an AI file and displays information from the query.

Syntax

rfutil db-name -C aimage query query-option by search-optionsearch-value

db-name

Specifies the database you are using.

query-option

Specifies the information you want to gather about the AI extent. You can supply one of the AIMAGE QUERY options from the table that follows.

Table 105. 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 how you are identifying the AI extent to query. Supply one of the options from column one of Table 106.

search-value

Specifies the match criteria for the search-option. Supply the value indicated in column two of Table 106 that matches your search-option.

Table 106. 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

The AIMAGE QUERY qualifier returns minimal output.

The output of the AIMAGE QUERY qualifier is intended to be used in automated after-imaging procedures.