Function

The following are the functions of the hdsrfctl command:

• Restart of import processing
  Import processing restarts using the specified import method. When you execute the hdsrfctl command, import processing restarts immediately.
  
• Termination of import processing
  You can terminate import processing while keeping reception processing active. The import processing termination timing depends on the specified options.
  
• Modification of the import method
  To modify the import method while import processing is underway, use the following procedure:
  
  1. Stop import processing.
  2. Specify either the transaction-based import method or the table-based import method, and then restart import processing.
• Modification of the import processing commit interval
  You can change the commit interval for the current import processing. If import processing is stopped, the command restarts import processing with the specified commit interval.
  

Format 1

hdsrfctl -d data-linkage-identifier -m { trn|tbl|spd|immediate }
       [ -c import-processing-commit-interval ]

Format 2

hdsrfctl -g synchronous-import-group-name
       -m { start|immediate }

Options (Format 1)

-d data-linkage-identifier

Specify the data linkage identifier of the source system that corresponds to the import processing that is to be subject to the command's processing. Specifying ** for the data linkage identifier will result in an invalid-argument error.

For details about the data linkage identifier when the source database is a HiRDB, see 5.2 Extraction system definition. For details about the data linkage identifier when the source database is a mainframe database, see the VOS3 XDM/DS manual.

-m { trn|tbl|spd|immediate }

trn

Execute import processing using the transaction-based import method.

tbl

Execute import processing using a table-based import method (table-based partitioning method, key range-based partitioning method, or hash partitioning method).

spd

Terminate import processing when an event issued from the source system is detected during import processing after the command executes.

immediate

Terminate import processing when the import processing that was underway when the command was executed terminates. If update information is being received when the command is executed, import processing terminates when Datareplicator finishes storing the update information in the import information queue file.

-c import-processing-commit-interval

~ <unsigned integer> <<value of the cmtintvl operand in the import environment definition>> ((1-32767))

Specify the interval at which the import processing subject to the command's processing is to issue commit to the target HiRDB. This value is applied to import processing that starts after execution of the hdsrfctl command. If you execute the hdsstop command or re-execute the hdsrfctl command, Datareplicator will ignore the previous value specified in the -c option.

If the hdsrfctl command with the -c option specified results in an error while restarting import processing or changing the commit interval, the specified commit interval will be ignored.

Options (Format 2)

-g synchronous-import-group-name

Specify the synchronous import group to be controlled.

-m { start|immediate }

start

Starts the synchronous import group. If the synchronous import group was disabled during the previous termination, it is started in disabled status.

immediate

Terminates import processing. The termination methods are as follows:

If a synchronous event is detected during transaction processing, the command commits the transaction, and then terminates the import processing.

If the end of the import information queue file is detected during transaction processing, the command rolls back the transaction, and then terminates the import processing.

If no transaction processing is underway, the command terminates the import processing immediately.

Rules

• The hdsrfctl command controls import processing only for a specific data linkage identifier. To control import processing for multiple data linkage identifiers, you must execute the hdsrfctl command for each data linkage identifier.
• Execute the hdsrfctl command specifying a data linkage identifier for each source system.
• Before you can change the import method with the hdsrfctl command, you must terminate the import processing in the event termination mode using the hdsrfctl -m spd command.
• The target Datareplicator gives precedence to an hdsrfctl command request over an event request. For example, if you execute an event requesting modification of the import method as well as an import processing termination request with the hdsrfctl command, Datareplicator terminates import processing according to the command request.
• When the hdsrfctl command is executed, the target Datareplicator is placed in event wait status. If you re-execute the hdsrfctl command in this event wait status, the second hdsrfctl command executed becomes subject to the event wait status.
• An error results if you execute the hdsrfctl command while the target Datareplicator is engaged in termination processing due to execution of the hdsstop command.
• If import processing terminates abnormally while the target Datareplicator has been placed in event wait status by the hdsrfctl command, the hdsrfctl command subject to event wait status is cancelled.
• If you are executing import processing with the delayed start method specifying a delay time (breaktime operand), you can invalidate the specified delay time and cancel the delayed start by executing the hdsrfctl -m spd command, in which case the import processing will not start at the specified time.
• If some import groups have terminated with an error during import processing in the table-based import mode, you cannot restart only the import groups that have terminated. For details about the handling procedure when some import groups terminate with an error, see 6.7.1 Handling of import processing.
• If you have specified spd or immediate in the -m option of the hdsrfctl command, Datareplicator ignores any commit interval that is specified in the -c option.
• If you execute the hdsstop or hdsrfctl command more than once, the operation depends on the specified options; for details, see Table 7-16 Datareplicator's action when the hdsstop or hdsrfctl command is executed more than once.
• The following table shows the hdsrfctl command's return values, the termination classifications, and the termination causes:
  

  Return value	Classification	Cause
  0	Normal termination	--
  1	Abnormal termination	Main causes are as follows: Invalid argument Invalid command execution environment (such as an invalid environment variable or an invalid definition file) System call error Source Datareplicator is inactive
  11	Impossible to accept command	Import processing is already executing.
  12		There was no response to the import processing start request.