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

Parameters

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

search-value

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

Table 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

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