1 02/08/85 hp_delete_vtoce
 2 
 3 Syntax as a command:  hp_delete_vtoce pvname vtoc_index {-control_args}
 4 
 5 
 6 Function:  deletes a specified Volume Table of Contents Entry (VTOCE).
 7 You can use it when cleaning up after a sweep_pv to get rid of orphans,
 8 or whenever you want a forward connection failure.
 9 
10 
11 Arguments:
12 pvname
13    is the name of the physical volume on which the VTOCE to be expunged
14    exists.
15 vtoc_index
16    is the index (in octal) of the VTOCE to be expunged.
17 
18 
19 Control arguments:
20 -brief, -bf
21    suppresses the message announcing the deletion of the VTOCE, which
22    is only printed if no questions are asked.
23 -clear
24    uses the privileged entry that sets an entire VTOCE to zero, rather
25    than deleting it.  Give -clear only when a VTOCE contains invalid
26    information that may cause problems (reused addresses, crashes,
27    etc.)  if you delete it as usual, since it leaves the volume on
28    which the VTOCE existed in an inconsistent state.  Salvage such
29    volume with the volume salvager after you have deleted all the
30    seriously inconsistent VTOCEs.  Don't use this control argument to
31    delete a reverse connection failure VTOCE (an ordinary orphan).
32 
33 
34 -force, -fc
35    forces the deletion of the VTOCE if it is an orphan, with no
36    intervening questions; if it is not, you must supply also -no_check
37    to suppress all questions.
38 -no_check, -nch
39    suppresses the check made to see whether or not the VTOCE is an
40    orphan; if it is not, deleting it causes a forward connection
41    failure in its parent directory.
42 -query, -qy
43    always queries whether or not to delete the VTOCE, even if it is an
44    orphan.
45 
46 
47 Access required:  You require access to the phcs_ and hphcs_ gates.
48 
49 
50 Notes:  You cannot use this command to delete the VTOCE of an active
51 segment.  The default is to check whether the VTOCE is an orphan, and
52 delete it if it is, or ask whether to delete it if is not.