Function

The hdsstop command terminates the target Datareplicator.

Format

hdsstop [ -t { event|immediate|force }|-q wait-time ]
        [ -w ]

Options

-t { event|immediate|force }

-t event

Specify this option to execute event termination.

-t immediate

Specify this option to execute immediate termination.

-t force

Specify this option to execute forced termination.

-q wait-time

~ <unsigned integer> ((5-600)) (seconds)

To terminate the reception process, and then terminate the target Datareplicator after importing all the data that has been received, specify this option with a reception process termination wait time.

Use this parameter only if the reception process cannot detect a line disconnection due to power failure or communications line failure at the source system, or if you want to forcibly execute normal termination on the target Datareplicator in order to achieve planned system switchover. Do not specify this option with the shell during normal operation (that is, when a transmission completion message is sent from the source system and the target Datareplicator is to be terminated after importing all the data that has been transmitted). Once you execute the hdsstop command with the -q option specified, you cannot specify any option other than -t force in any subsequent issuance of the hdsstop command.

Note, however, that, in any specific hdsstop command issuance, this parameter and the -t option are mutually exclusive.

-w

Specify this option to cause hdsstop command processing not to terminate after it sends a termination request to the target Datareplicator's master process (hdsmaster) until after hdsmaster 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 hdsstop 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 hdsstop 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).

Rules

• If the hdsstop command terminates normally, it returns 0. If it terminates abnormally, it returns 1.
• You can use the -t option to select a desired termination mode. The following table shows the relationship between the -t option value and the termination mode.
  

  Table 7-14 Relationship between the -t option value and the termination mode

  Option	Termination mode	Termination processing
  Not specified	Normal termination	After executing the hdsstop command, the target Datareplicator terminates when import processing through the source system's activity unit is completed. If the source database is a HiRDB, its activity unit is from normal start to normal termination of the entire source system (for details about the activity unit when the source database is a mainframe database, see the VOS3 XDM/DS manual). Depending on the status of the connection with the source system and the options specified in the hdsstop command, the target Datareplicator might result in normal termination in cases other than the above; for details, see Table 7-15 Conditions of normal termination.
  -t event	Event termination	After executing the hdsstop command, the target Datareplicator terminates when import processing detects the first event sent from the source system. If the target Datareplicator completes processing through the source system's activity unit before detecting the event, it terminates immediately without waiting for the event. When the table-based import method is being used, import processing terminates when import of the last group is completed. Use this option only for executing planned termination; do not use this option to terminate the target Datareplicator immediately or after importing all information that has been received.
  -t immediate	Immediate termination	After executing the hdsstop command, the target Datareplicator terminates when it finishes importing the current update information being processed. When the table-based import method is being used, the target Datareplicator terminates the groups beginning with the one whose import processing has advanced the farthest, and then terminates itself when the last group has reached the termination point of the most advanced group. After execution of the hdsstop command, if the target Datareplicator receives new update information before the most advanced group has terminated, reception processing is terminated when the update information is stored in the import information queue file.
  -t force	Forced termination	After executing the hdsstop command, the target Datareplicator terminates forcibly regardless of the import status of the update information. If synchronization point processing is underway, the target Datareplicator terminates upon completion of the synchronization point processing. Executing forced termination on the target Datareplicator might result in loss of conformity between the source and target databases. If you use the restart mode the next time you start the target Datareplicator, the target database will be restored automatically.

  Table 7-15 Conditions of normal termination

  Status of connection with the source system		Import status	Whether to execute normal termination
  Connected#1		Import of all received information completed	--
  		Import of all received information not completed	#3
  Not connected	End-of-transmission message received (Normal termination at the source)	Import of all received information completed	Y
  		Import of all received information not completed	#4
  	End-of-transmission message not received (Forced termination at the source#2)	Import of all received information completed	Y
  		Import of all received information not completed	#4

  Y: Normal termination is executed.
  --: Normal termination is not executed.
  #1: This includes the case where disconnection cannot be identified due to disabled keepalive feature, for example, even if the line is actually disconnected because of a communications error.
  #2: This includes detection of linkage cancellation log information by the pdrplstop command and communication line failure because of power interrupt at the source machine or a communications error, as well as forced termination at the source (-t force).
  #3: You can execute normal termination forcibly with the hdsstop command with the -q option specified. The target Datareplicator forcibly closes the communication line and terminates itself when all received information has been imported. When the reception process cannot identify a line disconnection, use this termination method to forcibly execute normal termination.
  #4: Once all unimported information has been imported, the import status is the same as completed importing all received information.
  
• If multiple source systems are subject to import processing, the target Datareplicator terminates after importing information from all such source systems. However, if the termination mode is set to forced termination, the target Datareplicator terminates immediately.
• If there is no transmission data from the source system and the update information has been imported through the end, the target Datareplicator terminates regardless of the -t option specification.

Notes

• During termination processing by the hdsstop command, the target Datareplicator does not receive connection requests from the source system.
• If the target system terminates abnormally after the hdsstop command has been entered but before termination processing is completed, the termination command's instruction accepted before the termination will be ignored.
• If import processing on all received update information has been completed and no new update information has been sent from the source system, executing the hdsstop command will terminate the target Datareplicator regardless of the specified command options. However, in the case of a hdsstop command with no options specified (normal termination), the target Datareplicator will be terminated only if the previous termination was normal termination.
• If you execute the hdsstop or hdsrfctl command more than once, the command's processing depends on the specified options. The following table shows the Datareplicator's action when the hdsstop or hdsrfctl command is executed more than once.
  

  Table 7-16 Datareplicator's action when the hdsstop or hdsrfctl command is executed more than once

  Second command executed		First command executed
  		hdsstop command with -t option specified				hdsrfctl command with -m option specified
  		None	event	immediate	force	trn	tbl	spd	immediate
  hdsstop command with -t option specified	None	F	F	F	F	S	S	S	S
  	event	F	F	F	F	S	S	S	S
  	immediate	S	S	F	F	S	S	S	S
  	force	S	S	S	F	S	S	S	S
  hdsrfctl command with -m option specified	trn	F	F	F	F	F	F	D	D
  	tbl	F	F	F	F	F	F	D	D
  	spd	F	F	F	F	S	S	S	F
  	immediate	F	F	F	F	S	S	S	S

  S: Cancels the first command and starts processing the second command.
  D: If the first command is completed, Datareplicator starts executing the second command; otherwise, an error results when the second command is executed and Datareplicator continues processing the first command.
  F: An error results when the second command is executed and Datareplicator continues processing the first command.
  
• You cannot use the hdsstop command to terminate a target Datareplicator whose version is 05-02 or earlier when extraction processing has been terminated forcibly by the pdrplstop command or because communication between the source and target has been broken due to some kind of communications error. To terminate the target Datareplicator in such a case, execute the hdsstop -t immediate or hdsstop -t force command.