hdestop (terminate the source Datareplicator)

Function

The hdestop command terminates the source Datareplicator in the forced termination mode. To terminate the source Datareplicator in the normal termination mode, specify true in the syncterm operand in the extraction system definition.

Format

hdestop [ -t sendterm ]
        [ -e ]
        [ -s [ target-identifier [{{,target-identifier }} ...]]]
        [ -w ]

Options

-t sendterm: Specify this option to cancel processing forcibly in order to terminate transmission processing. This option is applicable when transmission processing only is active and the option to terminate transmission processing (when neither the -e nor the -s option is specified, or when the -s option is specified) had been specified.; If you omit the -t option, the source Datareplicator terminates transmission processing after sending all update information that was read from the extraction information queue file during the transmission interval.

-e: Specify this option to terminate only extraction of update information from the HiRDB system log file.

-s [ target-identifier [{{,target-identifier }} ...]]

Specify this option to terminate transmission processing only for specified destinations.

target-identifier: To terminate transmission processing for a specified target identifier, specify the target identifier (this must be a target identifier that is specified in the extraction system definition). If you specify multiple target identifiers, do not specify any spaces before or after a delimiter comma. Specifying ** as the target identifier will result in an invalid-argument error.; If you do not specify any target identifiers, the source Datareplicator terminates transmission processing for all targets.

-w

Specify this option to cause hdestop command processing not to terminate after it sends a termination request to the source Datareplicator's master process (hdemaster) until after hdemaster has terminated.

Specify this option when you need to terminate the command after the Datareplicator has terminated completely, such as when a Datareplicator termination shell is used for planned system switchover.

If the -w option is omitted, the hdestop command terminates itself after sending a termination request to the master process (the master process and the command terminate asynchronously).

If the -w option is specified, the hdestop command sends a termination request to the master process, waits until the master process terminates, and then terminates itself (when the command terminates, the master process has already terminated).

The following table shows the permitted combinations of hdestop command options:

hdestop command option	-t	-e	-s	-w
-t	--	Y	Y	Y
-e	Y	--	Y	--
-s	Y	Y	--	--
-w	Y	--	--	--

Y: Permitted combination.

--: Combination not permitted (if executed with this combination, an error message will be issued).

Rules

You can have the source Datareplicator terminate automatically when the source HiRDB terminates normally, or you can terminate the source Datareplicator manually by entering the hdestop command. The following table shows the relationship between the source Datareplicator's termination method and the termination mode.

Table 7-9 Relationship between the source Datareplicator's termination method and the termination mode

Termination method	Termination mode	Termination processing
Automatic termination when the source HiRDB terminates normally	Normal termination	The source Datareplicator terminates when all the following conditions are satisfied: The source HiRDB's normal termination is detected. No transactions have occurred at the source HiRDB since detection of the source HiRDB's normal termination. The extraction process has completed extracting all update information from the system log into the extraction information queue file. The transmission process has completed sending all update information from the extraction information queue file to the target system. (In the case of transmission delay start, update information in the extraction information queue file is not sent unless the transmission process is started before the extraction process detects the source HiRDB's normal termination.) To have the source Datareplicator terminate when the source HiRDB terminates normally, you must specify true in the syncterm operand in the extraction system definition.
Execution of the hdestop command	Forced termination	When the hdestop command is executed, the source Datareplicator terminates upon completion of the current extraction and transmission processing.

If you execute the hdestop command when true is specified in the syncterm operand in the extraction system definition, the source Datareplicator terminates in the forced termination mode according to the hdestop command.
You can execute the hdestop command only while the source Datareplicator is active. An error results if you execute the hdestop command while the source Datareplicator is inactive.
If the hdestop command terminates normally, it returns 0. If it terminates abnormally, it returns 1.

Notes

If a termination request is issued to an extraction or transmission process that has already been terminated, the termination processing is not executed (because termination processing can be executed only on an active extraction or transmission process). In such a case, the hdestop command terminates normally (however, the command outputs an event to that effect to the error information file).
Once repeated execution of termination processing on extraction or transmission processes results in termination of all extraction and transmission processes, the source Datareplicator terminates.
If you specify sendmst in the sendcontrol operand in the extraction system definition to terminate only a specific transmission target, the transmission interval for other transmission targets is cancelled when the hdestop command is accepted, and the transmission processing is then started.
The hdestop command outputs the KFRB04411-E message and terminates with an error when all of the following apply: server is specified in the nodecontrol operand in the extraction system definition, the extraction node master process is active, and the extraction master process is inactive. The active extraction node master process does not terminate.