Extracting Records From a File

The -extract option prints selected records on the standard output. The command syntax is:

vutil  -extract  [ -x ]  [ -k# ]  [ -n# ]  
   [ -v value ]  [ -q ]  file

When using the "-extract option, you may use command-line options to specify the primary key, starting value, and the number of records. If you do that, vutil does not interrupt the -extract later (after printing a synopsis of the file) to prompt for those parameters. vutil does a START NOT LESS THAN on the desired key and proceeds to print records on the standard output. Each record is printed on its own line.

Note: If the file contains binary or COMP-3 data, that data may contain carriage returns (binary 0Ds). Each binary 0D is interpreted as a carriage return, and that is reflected in the display of the extracted record.

These options can be used with -extract:

-k# This option specifies the key number to extract from.
-n# This option specifies the number of records to extract.
-v value This option specifies the key value from which to start the extract.
-q    When you use this option, the key number defaults to "0" (zero), the number of records defaults to all, and the keyval defaults to low-values, unless you specify these values with the -k, -n, and -v options.
-x This option allows record extraction to continue if an error occurs. Records that generate errors are not included in the output file.

vutil will not let you extract records from an encrypted file.