dcstop [{-n|-a|-b|-f|[-d]}]

The dcstop command terminates OpenTP1 in the computer.

-n

Specifies that OpenTP1 is to be terminated forcibly even if:

• A user server has forcibly been stopped by the dcsvstop -f command.
• The abnormally terminated user server is an SUP or an SPP that receives requests from the socket.

The difference from normal termination is that forced termination checks the forcibly stopped or abnormally terminated servers and continues normal termination of the system.

-a

Specifies that OpenTP1 is to be terminated by planned termination A.

-b

Specifies that OpenTP1 is to be terminated by planned termination B.

-d

Collects the core files from all active processes and the shared memory information when OpenTP1 is forced to terminate. This option can be specified to collect core files and shared memory information as troubleshooting information when the dcstop command has not been terminated or when a system error has occurred.

The -d option must be specified with the -f option.

-f

Specifies that OpenTP1 is to be terminated forcibly.

When none of these options are specified, OpenTP1 is terminated normally.

The -n, -a, -b, and -f options are mutually exclusive.

Message ID	Description	Output destination
KFCA01801-E	DCDIR environment variable has not been set.	Standard error output
KFCA01821-E	OpenTP1 cannot be resumed.	Message log file
KFCA01840-I	OpenTP1 is terminating.	Message log file
KFCA01841-I	OpenTP1 has been terminated.	Standard output
KFCA01842-I	A server is terminating.	Message log file
KFCA01844-E	Server termination processing failed.	Standard error output
KFCA01846-E	System cannot be terminated normally.	Message log file, standard error output
KFCA01847-E	System cannot be terminated.	Message log file, standard error output
KFCA01848-I	All user servers have been terminated.	Message log file
KFCA01849-W	Waiting for server termination.	Message log file, standard output
KFCA01860-E	dcstop command input format is invalid.	Standard error output
KFCA01861-E	dcstop command processing failed.	Standard error output
KFCA01863-E	dcstop command cannot be executed.	Message log file, standard error output
KFCA01864-E	Overtime occurred.	Message log file, standard error output
KFCA01865-E	dcstop command has been cancelled.	Message log file, standard error output
KFCA01867-E	Shared memory cannot be allocated.	Standard error output
KFCA01869-E	dcstop command cannot be executed.	Standard error output

• If the dcstop command is entered when an error occurs with the system service, OpenTP1 may abnormally terminate at some timing.
• A partially recovered OpenTP1 cannot be terminated.
• A server is inhibited from restarting during termination process.
• When the dcstop command fails to terminate or a system error occurs, the cause can be investigated by forcing to stop OpenTP1 with the dcstop -fd command and collecting core files and shared memory information.
• When the dcstop -fd command is entered, the machine load increases because of the operation to collect error information. Where two or more OpenTP1s are operating on the same machine, a timeout may occur at another OpenTP1 for a multiOpenTP1 configuration, or a slowdown or timeout for an HA configuration (such as a mutually hot-standby configuration).
• For HP-UX, the linkage bind mode of the user server started by the dcsvstart command must be immediate. When an executable file linked in any other mode is used, operations of OpenTP1 cannot be guaranteed. If the user server terminated abnormally for unknown reason, use the OS's chatr command to check that the bind mode is immediate.
• OpenTP1 may terminate abnormally if you use an OS command to forcibly stop the dcstop command.