Function

The hdestop_n command partially terminates the source Datareplicator.

The following table provides an overview of this command's operation:

-b option	Process to be terminated
	Extraction master process	Extraction master process	Extraction process	Transmission process
Omitted	Y#1, #2	--	--	--
Specified	--	Y#1, #3, #4	Y#4	Y#4

#1: If the process is not active, the command terminates with an error.

#2: After the extraction master process has terminated, any active extraction node master process waits for restart of the extraction master process; it waits the amount of time specified in the connection_retry_waittime operand. If communication cannot be established with the extraction master process within the specified amount of time, the extraction node master process terminates automatically.

#3: After all extraction node master processes have terminated, any active extraction master process waits for restart of an extraction node master process; it waits the amount of time specified in the connection_retry_waittime operand. If it cannot communicate with any extraction node master process within the specified amount of time, it terminates automatically.

#4: The processes to be terminated are the extraction node master process that corresponds to the back-end server specified in the -b option and any extraction and transmission processes under it. The command does nothing to the processes in other back-end servers.

Format

hdestop_n  [ -b server-name[ -t sendterm ][ -c initial|continue ]][ -w ]

Options

-b server-name[ -t sendterm ][ -c initial|continue ]

Specifies that the extraction node master process at the source Datareplicator is to be terminated. When this option is omitted, the extraction master process is terminated.

-b server-name

~ <identifier of 1-8 characters>

Specifies the name of the back-end server that corresponds to the extraction node master process to be terminated.

If the extraction master process or extraction node master process to be terminated is not found, the hdestop_n command terminates with an error.

-t sendterm

Specifies that transmission processing is to be terminated forcibly. This option is applicable only when a transmission process is active under the extraction node master process that is to be terminated.

When this option is omitted, the process is terminated at the time of completion of the transmission of the update information that was read from the extraction information queue file during the transmission interval.

-c initial | continue

When only the extraction or transmission process currently active as the result of a command request is to be started when the next source Datareplicator is started, this option is used to terminate the process.

For details about the operation of extraction and transmission processes that depend on the -c option, see the description of the -c option in the hdestart_n command (partially start the source Datareplicator).

-w

Specifies that the hdestop_n command is not to terminate until the target process has terminated.

You specify this operand in order to terminate the hdestop_n command after Datareplicator has been terminated completely, such as when a Datareplicator termination shell is used for planned system switchover. When this option is specified, the target process must have terminated in order for the hdestop_n command to terminate.

When this option is omitted, the hdestop_n command terminates immediately after a termination request has been issued to the target process (the target process and the hdestop_n command terminate asynchronously).

Rules

• If the hdestop_n command terminates normally, it returns 0. If it terminates abnormally, it returns 1.
• To execute the hdestop_n command, you must specify server in the nodecontrol operand in the extraction system definition (however, normal execution might be possible; for details, see the rules for the hdestart_n command (partially start the source Datareplicator).
• The following table lists and describes the -b option value and the operation after execution of the hdestop_n command.
  

  Table 7-10 -b option value and operation after execution of the hdestop_n command

  Machine where command is executed		-b option value	Operation after execution of the hdestop_n command
  System manager unit	Current	Omitted	The command terminates only the extraction master process, and then terminates itself normally.
  		The specified server does not exist in the source HiRDB.	The command terminates with an error because the error information file cannot be found.
  		The specified server exists in the source HiRDB but not in the system manager unit.
  		The specified server exists in the source HiRDB and in the system manager unit.	The command terminates only the corresponding extraction node master process, and then terminates itself normally.
  	Standby	Omitted	The command terminates with an error because the extraction master process or extraction node master process to be terminated does not exist.
  		The specified server does not exist in the source HiRDB.	The command terminates with an error because the error information file cannot be found.
  		The specified server exists in the source HiRDB but not in the system manager unit.
  		The specified server exists in the source HiRDB and in the system manager unit.	The command terminates with an error because the error information file cannot be found or the process to be terminated does not exist.
  Non-system manager unit	Current	Omitted	The command terminates with an error because the extraction system definition file cannot be found.
  		The specified server does not exist in the source HiRDB.	The command terminates with an error because the error information file cannot be found.
  		The specified server exists in the source HiRDB but not in the system manager unit.
  		The specified server exists in the source HiRDB and in the system manager unit.	The command terminates only the corresponding extraction node master process, and then terminates itself normally.
  	Standby	Omitted	The command terminates with an error because the extraction system definition file cannot be found.
  		The specified server does not exist in the source HiRDB.	The command terminates with an error because the error information file cannot be found.
  		The specified server exists in the source HiRDB but not in the system manager unit.
  		The specified server exists in the source HiRDB and in the system manager unit.	The command terminates with an error because the error information file cannot be found or the extraction node master process does not exist.