Neoview Command Interface (NCI) Guide (R2.5)

STOP DS Command
The STOP DS command stops a data source under a specified service. The actual termination
occurs at different times, depending on the STOPMODE attribute that you specify. The data
source enters the stopped state only after all of its NDCS servers are stopped.
Syntax
STOP DS $service-name, DSNAME data-source-name, STOPMODE mode,
REASON 'reason-text'
mode is:
IMMEDIATE | DISCONNECT
$service-name
is the name of the association server of the NDCS service where the data source should be
stopped.
DSNAME data-source-name
is the name of the data source to be stopped. data-source-name is case-sensitive and
cannot be the asterisk (*) wild card. The data source must exist, or the command fails.
STOPMODE
specifies how quickly the command stops the NDCS server. Choose one of these values:
IMMEDIATE
terminates the NDCS server immediately (abort as fast as possible). A client connected
to the NDCS server receives the communication link failure error on the next
action that accesses the server. The client is expected to either disconnect and connect to
another NDCS server or quit. Incomplete transactions are rolled back.
DISCONNECT
terminates the NDCS server but not until the remote client terminates the connection.
The client connected to an NDCS server is not notified of the termination request and
continues working until it disconnects normally. It could take hours or days for the client
to disconnect normally. This mode is the default.
REASON 'reason-text'
is a nonempty SQL string literal of up to 70 characters, which indicates why the data source
is being shut down. It is written to the EMS log by the NDCS service if the command is
accepted. Single quotes are required. Use an underscore instead of a space between two or
more words in the string.
Considerations
• To run this command in SQL mode, you must first run the CMDOPEN command. This
command does not run in CS mode.
• The command requires an SQL terminator.
• Only users associated with roles that have OPERATOR privileges can execute this command.
For more information, see the “ADD USER Command” (page 158) or “ALTER USER
Command” (page 167).
• The wild card (*) is not supported for the data source name, and the data source name is
case-sensitive.
• The data source must exist, or the command fails.
• Issuing STOP DS inhibits new client access to the target data source.
• If the target data source is already stopped or stopping, STOP DS returns a success message.
• Before you can delete the data source by using the DELETE DS command, you must stop
the data source in all NDCS services on the system.
182 Connectivity Commands