contents.gifindex.gifprev1.gifnext1.gif

3.3.5 Extracting Records from a File

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

vutil  -extract  [ -x ]  file

A synopsis of the file is printed, and then you are asked to specify which key you want to read by (unless there is only one key). The primary key is key "0". Then you are asked for a starting value (which is padded internally with LOW-VALUES). Finally, you are asked how many records you want. 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 that if the file contains binary or COMP-3 data, then this data may contain carriage returns (binary "0D"s). Each binary "0D" will be interpreted as a carriage return, and that will be reflected in the display of the extracted record.

The "-x" option allows record extraction to continue if an error occurs. Any records that generate errors are not included in the output file.

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