NET/MASTER Management Services (MS) Command Reference Manual

LBANNER

UDBCTL STOP

NonStop NET/MASTER MS Commands

115412 Tandem Computers Incorporated 2–583

UDBCTL STOP The UDBCTL STOP command disassociates a user database (UDB) identifier from a

UDB or UDB pair. 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.

The UDB ID must not be in use by any NCL process or the attempt to disassociate the

UDB ID from the UDB or UDB pair will fail. The UDB or UDB pair remains open after

this command and you can assign a new unique UDB ID to the file or pair of files at

any time; however, NCL cannot access the UDB or UDB pair while it does not have a

UDB ID.

The UDBCTL file-spec command assigns a UDB ID to an open UDB or UDB pair.

UDBCTL STOP=

udb-id

specifies a UDB ID. You can specify a UDB ID from one through eight characters,

beginning with a character other than a digit. The UDBCTL OPEN command lists

valid characters.

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.

Example

The following example disassociates a UDB ID from a UDB or UDB pair:

UDBCTL STOP=UDBID1