Function

The hdestart_n command partially starts the source Datareplicator.

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

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

#1: If the process is already active, the command outputs a warning message and terminates normally.

#2: If all extraction node master processes are in inactive status when the wait time (-t option value) since the extraction master process started elapses, the extraction master process terminates automatically.

#3: Once started, the extraction node master process waits until it can communicate with the extraction master process. If it cannot communicate with the extraction master process within the specified wait time (-t option value), the extraction node master process terminates automatically.

#4: The processes to be started are the extraction node master process that corresponds to the back-end server specified in the -b option, and the extraction and transmission processes under it. The command has no effect on processes in other back-end servers.

Format

hdestart_n  [ -b server-name -x extraction-master-process's-host-name
          -n service-name[ -c initial|continue ][ -r ]]
         [ -t wait-time ]

Options

-b server-name -x extraction-master-process's-host-name -n service-name[ -c initial|continue ]

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

-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 started.

-x extraction-master-process's-host-name

~ <identifier of 1-32 characters>

Specifies the name of the host where the extraction master process is run (host with IP address inheritance that has been allocated for the source Datareplicator) in order to issue a start request to the extraction master process. This must be a host name that was specified in the connection_accept_hostname operand in the extraction system definition.

If the specified host name is invalid, the hdestart_n command terminates normally, but the extraction node master process that was started by this command will terminate with an error due to a communication timeout.

-n service-name

~ <identifier of 1-64 characters>

Specifies the service name used to establish communication between the extraction master process and extraction node master process. This service name must have been specified in the connection_accept_service operand in the extraction system definition.

The following table describes what occurs when the wrong service name is specified:

-n option value	-x option value	Operation
Service name specified in the mstservice operand in the extraction system definition	Name of the host at which the source Datareplicator is located	The extraction node master process starts at the host specified in the -x option and the host where the hdestart_n command was executed, and this command terminates normally. After that, both extraction node master processes terminate with a communication error.
Service name specified in the hdeservice operand in the transmission environment definition	Name of the host at which the target Datareplicator is running	The hdestart_n command terminates normally, and then the extraction node master process terminates with a communication timeout error. The target Datareplicator detects an error during port checking (detail code = 16) and refuses reception.
Other		The hdestart_n command terminates normally, and then the extraction node master process terminates with a communication timeout error.

-c initial|continue

Specifies that only the extraction or transmission process that had been activated by a command request when the previous source Datareplicator was terminated is to be started.

The following describes the operation of extraction and transmission processes depending on the specification of the -c option.

Process	Previous termination status	-c option value
		initial	continue
Extraction process	continue was specified in the -c option of the hdestop_n command	Started	Started
	Error termination		Started#1
	Abnormal termination
	Other		Not started
Transmission process	continue was specified in the -c option of the hdestop_n command		Started
	Error termination		Started#1
	Abnormal termination
	Other		Not started
Update-SQL output process	--	Not started#2	Not started#2

#1: With respect to error termination and abnormal termination, taking into account the case where an error results during system switchover processing, the process is started regardless of the -c option's specification.

#2: The update-SQL output process is not started and the extraction and transmission processes are started.

-r

Specify this option to reset the data transmission count when the source Datareplicator is started.

This option is applicable when false is specified in the send_counter_reset operand in the extraction system definition.

-t wait-time

~ <unsigned integer> ((1-3600)) <<300>> (seconds)

Specifies the wait time until the first connection is established. This option depends on whether the -b option is specified.

The following table describes what the -t option's value represents, depending on whether the -b option is specified:

-b option	Meaning of the -t option's value
Specified	Specifies the wait time until the extraction node master process started by the hdestart_n command establishes connection with the extraction master process. If connection cannot be established within the specified amount of time, the extraction node master process terminates with a timeout.
Omitted	Specifies the wait time until the extraction master process started by the hdestart_n command establishes connection with an extraction node master process. If connection cannot be established within the specified amount of time, the extraction master process terminates with a timeout.

This operand's value is applicable only to the first connection after the process has started. If another process is terminated after connection has been established, connection establishment is retried, but this retry is based on the specification of the connection_retry_time operand in the extraction system definition.

Rules

• To execute the hdestart_n command, you must specify server in the nodecontrol operand in the extraction system definition. If unit is specified in the nodecontrol operand, the operation is as follows:
  
  • When the -b option is specified
    The hdestart_n command terminates normally, but the started extraction node master process terminates with a timeout. In such a case, you can use the hdestop_n command to terminate the extraction node master process without having to wait for the timeout to occur.
    
  • When the -b option is omitted
    The hdestart_n command terminates normally, but the extraction master process terminates with a definition analysis error.
    
• If the hdestart_n command terminates normally, it returns 0. If it terminates abnormally, it returns 1.
• Table 7-9 lists and describes the -b option value and the operation after execution of the hdestart_n command.
  

  Table 7-8 -b option value and operation after execution of the hdestart_n command

  Machine where command is executed		-b option value	Operation after execution of the hdestart_n command
  System manager unit	Current	Omitted	The command starts only the extraction master process, and then terminates itself normally.
  		The specified server does not exist in the source HiRDB.	The command starts the extraction node master process, and then terminates itself normally. The extraction master process outputs a request acceptance error (invalid server name) message, and the extraction node master process terminates with an error.
  		The specified server exists in the source HiRDB but not in the system manager unit.	The command starts the extraction node master process, and then terminates itself normally. The corresponding extraction node master process starts, and then terminates with an input/output error on the extraction server status file.
  		The specified server exists in the source HiRDB and in the system manager unit.	The command starts only the extraction node master process that corresponds to the specified server, and then terminates itself normally. The extraction node master process starts the extraction and transmission processes.
  	Standby	Omitted	The command terminates normally. The extraction master process terminates with an input/output error on the extraction master status file.
  		The specified server does not exist in the source HiRDB.	The command starts the extraction node master process, and then terminates itself normally. The extraction master process outputs a request acceptance error (invalid server name) message, and the extraction node master process terminates with an error.
  		The specified server exists in the source HiRDB but not in the system manager unit.	The command starts the extraction node master process, and then terminates itself normally. The corresponding extraction node master process starts, and then terminates with an input/output error on the extraction server status file.
  		The specified server exists in the source HiRDB and in the system manager unit.
  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 starts the extraction node master process, and then terminates itself normally. The extraction master process outputs a request acceptance error (invalid server name) message, and the extraction node master process terminates with an error.
  		The specified server exists in the source HiRDB but not in the system manager unit.	The command starts the extraction node master process, and then terminates itself normally. When the extraction master process starts and issues a start request to the corresponding extraction node master process, the extraction node master process terminates with an input/output error on the extraction server status file.
  		The specified server exists in the source HiRDB and in the system manager unit.	The command starts only the extraction node master process that corresponds to the specified server, and then terminates itself normally. The extraction node master process starts the extraction and transmission processes.
  	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 starts the extraction node master process, and then terminates itself normally. The extraction master process outputs a request acceptance error (invalid server name) message, and the extraction node master process terminates with an error.
  		The specified server exists in the source HiRDB but not in the system manager unit.	The command starts the extraction node master process, and then terminates itself normally. The corresponding extraction node master process starts, and then terminates with an input/output error on the extraction server status file.