1 07/13/83  vfile_adjust, vfa
 2 
 3 Syntax:  vfa path {-control_arg}
 4 
 5 
 6 Function:  adjusts structured files left in an inconsistent state by an
 7 interrupted opening, or unstructured files in any state.
 8 
 9 
10 Arguments:
11 path
12    is the pathname of a file to be adjusted.
13 
14 
15 Control arguments:  must be specified only for unstructured files.
16 -set_bc
17    sets the bit count of the file's last nonempty segment to the last
18    nonzero byte in that segment.  Any components beyond it are deleted.
19 -set_nl
20    appends a newline character if the last nonzero byte in the file is
21    not a newline character.  The bit count of the file's last nonempty
22    segment is then set to the file's last nonzero byte (which is now
23    sure to be a newline character).
24 -use_bc {N}
25    truncates the file to the byte specified by the bit count of
26    multisegment file component N.  If N is not given, it is taken to be
27    the last nonempty component.
28 -use_nl
29    truncates the file after the last newline character.
30 
31 
32 Notes:  For unstructured files a control argument must specify the
33 desired adjustment; otherwise, no control arguments are allowed.  A
34 sequential or blocked file is adjusted by truncation after the last
35 complete record.  An indexed file is adjusted by finishing the
36 interrupted operation.
37 
38 The adjust_bit_count command used with -character is equivalent to
39 vfile_adjust used with -set_bc except that the latter only operates on
40 a file that appears to be unstructured.
41 
42 See the description of the vfile_ I/O module in the Subroutines manual
43 for further details.