NET/MASTER Management Services (MS) Command Reference Manual

LBANNER
UDBCTL RESET
NonStop NET/MASTER MS Commands
2–582 115412 Tandem Computers Incorporated
UDBCTL RESET The UDBCTL RESET command performs a Guardian PURGEDATA operation on a
file. (A file opened using the UDBCTL OPEN command is a UDB; NCL works with
UDBs. However the UDB must be closed before you can use UDBCTL RESET;
therefore, strictly speaking, it is no longer a UDB.) Entry-sequenced files, key-
sequenced files, edit files, and Guardian processes are all regarded as UDBs by NCL.
This command logically removes all data from the UDB by setting the end-of-file
(EOF) pointer to 0. The file must be closed before you can use this command.
A UDB or UDB pair is a file or a pair of files, respectively, opened using the UDBCTL
OPEN command; NCL works with UDBs and UDB pairs. Entry-sequenced files, key-
sequenced files, edit files, and Guardian processes are all regarded as UDBs by NCL.
You can open only key-sequenced files in a UDB pair.
UDBCTL RESET= file-spec
file-spec :
[ \ sys . ][ $ volume . ][ subvolume . ] file-name
Note You cannot use this command with edit files. This command does not apply to a pair of files.
file-spec
specifies the name of the file on which to perform the Guardian PURGEDATA
operation.
Considerations
The default authority level of this command is 4.
You can enter this command from any NCL procedure, including the INIT NCL
procedure, by using either the CMD core statement or the INTCMD verb.
Refer to the Enscribe Programmer’s Guide, the File Utility Program (FUP) Reference
Manual, and the Tandem NonStop Kernel Programmer’s Guide for additional
information on Enscribe.
For related information, see the SHOW FILES, SHOW UDB, SHOW UDBUSER,
and other UDBCTL commands.
Example
The following example performs a Guardian PURGEDATA operation on a UDB:
UDBCTL RESET=MYFILE1