NET/MASTER Management Services (MS) Command Reference Manual

LBANNER
UDBCTL CLOSE
NonStop NET/MASTER MS Commands
2–576 115412 Tandem Computers Incorporated
UDBCTL CLOSE The UDBCTL CLOSE command closes a user database (UDB) or UDB pair. A UDB or
UDB pair is a file or a pair of related 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.
When this command closes the UDB or UDB pair, it disassociates the UDB or UDB
pair from its UDB identifier. If the UDB or UDB pair is in use by a NonStop
NET/MASTER MS user when you execute this command, the command is rejected.
UDBCTL CLOSE={ file-spec | ( file-spec , file-spec ) }
file-spec :
[ \ sys . ][ $ volume . ][ subvolume . ] file-name
file-spec
specifies the name of the file to close. If you opened the file as a single file, you
must close the file as a single file; you cannot close it as part of a pair of files.
( file-spec , file-spec )
specifies the names of a pair of files to close. If you opened the two files as a pair,
you must close the two files as a pair; you cannot close the files individually.
Considerations
The default authority level of this command is 3.
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.
Examples
1. The following example closes a UDB:
UDBCTL CLOSE=\SYS1.$DATA10.SUBVOL3.MYFILE1
2. The following example closes a UDB pair:
UDBCTL CLOSE=(MYFILE1,MYFILE2)