SQL/MX 2.x Reference Manual (H06.04+)

SQL/MX Utilities
HP NonStop SQL/MX Reference Manual—540440-003
5-17
Syntax Description of GOAWAY
If you do not specify this option, the default is -both.
-df
directs GOAWAY to drop a data fork file.
guardian-file must be the name of the data fork. Successful delete of a
data fork with the data fork option generates an informational message. If you
specify a resource fork name, the operation fails.
-rf
directs GOAWAY to drop a resource fork file.
guardian-file must be the name of the resource fork. If you specify a data
fork name, the operation fails.
-both
directs GOAWAY to drop both files.
guardian-file must be the name of the data fork. If you specify a resource
fork name, the operation fails.
If you specify -both and only the resource fork exists or only the data fork
exists, the operation fails.
If you request the data fork option and a resource fork exists, an error is returned. If
you request the resource fork option and a data fork exists, an error is returned.
Valid examples are:
mxtool GOAWAY figaro.\$vol.subvol.file00 -df
mxtool GOAWAY figaro.\$vol.subvol.file01 -rf
mxtool GOAWAY figaro.\$vol.subvol.file00
mxtool GOAWAY figaro.\$vol.subvol.file00 -both
If GOAWAY fails to remove the specified file, it returns an error. Because GOAWAY
can do no more, you should notify your service provider.
-s
When you run mxtool, specific SQL/MX information is extracted including the
ANSI name associated with the physical file. This takes some time to process and
errors can occur while NonStop SQL/MX is extracting this information. This option
allows mxtool to skip this step and drop the label.
!
When a drop is performed, GOAWAY requests confirmation with each file that
matches the list of files specified in guardian-file to be dropped (data and