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

$service-name
is the name of the association server of the NDCS service to be stopped.
STOPMODE
specifies how quickly the command stops the NDCS service, data sources, and servers. Choose
one of these values:
IMMEDIATE
terminates all NDCS servers immediately. 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 servers 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 service 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 NDCS service enters the stopped state only when all active data sources and NDCS
servers have also entered the stopped state.
• New clients cannot connect to an NDCS server associated with a stopping or stopped NDCS
service.
• The STOP SERVICE command does not terminate the association server and the configuration
server.
• If the NDCS service is already in the stopped or stopping state, STOP SERVICE is successful
(that is, does not return any errors) but has no effect.
• STOP SERVICE stops all data sources except Admin_Load_DataSource.
Example
This command stops the service $MXOAS:
SQL>stop service $mxoas, stopmode immediate, reason 'test';
184 Connectivity Commands