dcsvstop (Terminate server)

-d

Collects the user server core file when a user server is forcibly terminated. This option can be specified to collect core files as troubleshooting information when the dcsvstart or dcsvstop command has not been terminated. The option must always be used with the -f option.

-f

Specifies that the specified user server is to be terminated forcibly.

When this option is omitted, the specified server is terminated normally.

user-server-name~<identifier, 1-8 characters>

Specifies the name of the user server to be terminated. You can specify a maximum of 50 user server names in the dcsvstop command.

Message ID	Description	Output destination
KFCA01801-E	DCDIR environment variable has not been set.	Standard error output
KFCA01821-E	OpenTP1 cannot be continued.	Message log file
KFCA01842-I	Server is terminating.	Message log file
KFCA01843-I	Server has been terminated.	Message log file
KFCA01844-E	Server termination processing failed.	Message log file, standard error output
KFCA01849-W	Waiting for server termination.	Message log file, standard output
KFCA01860-E	dcsvstop command input format is invalid.	Standard error output
KFCA01861-E	dcsvstop command processing failed.	Message log file, standard error output
KFCA01862-E	Enter a server name.	Message log file, standard error output
KFCA01863-E	dcsvstop command cannot be executed.	Message log file, standard error output
KFCA01864-E	Overtime occurred.	Message log file, standard error output
KFCA01866-E	Server name duplication error occurred.	Standard error output
KFCA01867-E	Shared memory cannot be allocated.	Standard error output
KFCA01868-E	Server name is invalid.	Standard error output
KFCA01869-E	dcsvstop command cannot be accepted.	Standard error output

If the dcsvstop command does not end, the cause can be identified by forcibly terminating the UAP with the dcsvstop -df command and collecting the core file. When the dcsvstop -df command is executed, the dcsvstop command also outputs troubleshooting information to the core file and terminates. Abnormal termination of the dcsvstop command does not lead to abnormal termination of OpenTP1. However, OpenTP1 may terminate abnormally in the following cases:
- When critical=Y is specified in the user service definition for the user server specified in the dcsvstop -df command
- When the dcsvstop command is forcibly stopped by using an OS command
When you execute the dcsvstop command for an MHP, the MHP may not end since messages are retained in the input queue. In this case, determine whether to shut down the MCF (by using the mcftdctsg command and the mcfthldiq) taking into consideration the message processing after the MHP is ended by execution of the dcsvstop command.