dcmstop [-abf] [-p] {-g multinode-subarea-identifier|-w node-identifier [, node-identifier]...}

The dcmstop command terminates the following OpenTP1 nodes at the same time:

• All OpenTP1 nodes that configure multinode areas to which the OpenTP1 node corresponding to the command input environment variable DCDIR belongs
• All OpenTP1 nodes that configure the specified multinode subareas
• OpenTP1 nodes with the specified w option

Processing for an OpenTP1 node differs depending on its status taken when the dcmstart command is executed.

The dcmstop command watches all OpenTP1 nodes in the specified range until it verifies that they have been successfully terminated or failed to terminate. The command reports (by issuing a message) OpenTP1 nodes under termination process every about 30 seconds.

If the command cannot verify success in, or failure to, terminate before a certain time (the value specified in dcmstop_watch_time of the multinode configuration definition) from entry of the command, system outputs a message and discontinues watching the remaining nodes. Termination process continues for these nodes, but some may be delayed in terminating. The user must investigate the pending nodes and take appropriate actions.

For an OpenTP1 node using the system switchover facility, termination process takes place for its running and standby systems. When issued, a message relates to both systems.

-a

Terminates each OpenTP1 node belonging to the multinode area or subarea in planned termination A mode.

-b

Terminates each OpenTP1 node belonging to the multinode area or subarea in planned termination B mode.

-f

Terminates each OpenTP1 node belonging to the multinode area or subarea in forced termination mode.

The -a, -b and -f options cannot be specified at the same time.

If none of the options is specified, each OpenTP1 node belonging to the multinode area or subarea is terminated normally.

-p

The command returns the moment it requests an OpenTP1 node to start. The result of termination processing for the node is not checked.

-g multinode-subarea-identifier~<1-8 character identifier>

Specifies one identifier for the multinode subarea to terminate. If an asterisk (*) is specified as the subarea name, it is assumed that a multinode area has been specified. Use \ or " instead of * so that the name is not extended to a shell. The g option enables termination of all OpenTP1 nodes configuring multinode areas or subareas specified in the definition command dcmarea of the multinode configuration definition.

-w node-identifier~<4 character identifier>

Terminates the specified OpenTP1 node. When more than one node identifier is specified, a comma (,) must be placed between identifiers.

Message ID	Description	Output destination
KFCA01860-E	dcmstop command input format is invalid.	Standard error output
KFCA04607-I	OpenTP1 node began the termination processing.	Standard output
KFCA04608-I	OpenTP1 node terminated.	Standard output
KFCA04609-W	OpenTP1 node cannot be terminated.	Standard output
KFCA04610-W	Termination of OpenTP1 node could not be confirmed.	Standard output
KFCA04613-E	The dcmstop command argument is invalid.	Standard error output
KFCA04614-W	OpenTP1 node exceeded termination watch time.	Standard output
KFCA04615-E	Error exists in the definition file.	Standard error output
KFCA04616-E	Error exists in the multinode configuration definition.	Standard error output
KFCA04617-E	Command specification does not match the specification in the multinode configuration definition.	Standard error output
KFCA04618-I	OpenTP1 node is terminating.	Standard output
KFCA04621-E	Error occurred during executing the multinode function.	Standard error output
KFCA04626-I	Standby termination process has begun for OpenTP1 node.	Standard output

• Each OpenTP1 node can be terminated independently with the dcstop command. The dcmstop and dcstop commands must not be executed concurrently. Executing these two concurrently may cause the dcmstop command's message to become invalid.
• If a response from the OpenTP1 node to which a termination instruction is sent does not come within the maximum wait time specified in the multinode configuration definition, a message indicating the occurrence of timeout is output and the processing for the OpenTP1 node discontinues.
• System operation is not guaranteed when the dcmstop command is executed at occurrence of system switchover.
• The dcmstop command's message must not be executed concurrently for the same OpenTP1 nodes. Otherwise, the dcmstop command's message may become invalid.
• With one OpenTP1 node duplicated in more than one multinode subarea, termination process is valid even if any multinode subarea identifier is specified in the -g option.
• For a node for which no host name has been collected from the multinode physical definition, '********' is displayed in the host name area of a message.