Previous Topic: RMTNTFYL

Next Topic: Parameters


Checkpointing and Restarting Transfers

By setting the parameters described in this section, a transfer is marked for checkpointing and automatic restart if an interruption occurs during the transfer attempt. After an interruption the daemon scans its table of transfers and automatically attempts to restart eligible transfers.

The CHECKPOINT_COUNT parameter indicates where to restart the transfer after it has been interrupted. If a transfer is interrupted, it is resumed from a checkpoint rather than starting over from the beginning of the file. When CHECKPOINT_COUNT=1000, CA XCOM Data Transport performs a check after every 1000 records sent, to ensure that the records are stored on the destination system. Then the next 1000 records are transmitted.

The restart parameters automatically restart a transfer after a transmission error, based on the number of retries and the retry time specified. Transmission conditions that permit restarts generally include most transmission errors. Restarts will also be attempted when a transfer is suspended by the remote system, and when a link goes down. Conditions that are not considered for restart include errors such as invalid passwords and "data set not cataloged" messages.

Note: Restart parameters can be specified without setting a checkpoint.

Important! Checkpointing impacts performance. Set the CHECKPOINT_COUNT as high as possible, or turn off checkpointing if it is not needed.

Example 1

In the following example, the xcom62 command is used. If the transfer is interrupted, it restarts from the most recent checkpoint of every 2000 records, and up to three attempts are made to retry the transfer at intervals of 30 seconds.

xcom62 -f CHECKPOINT_COUNT=2000 NUMBER_OF_RETRIES=3  
RESTART_SUPPORTED=YES RETRY_TIME=30

All other necessary parameters are read from the default configuration file, xcom.cnf.

Example 2

In the following example, the xcomtcp command is used. If the transfer is interrupted, it restarts from the most recent checkpoint of every 2000 records, and up to three attempts are made to retry the transfer at intervals of 30 seconds.

xcomtcp -f CHECKPOINT_COUNT=2000 NUMBER_OF_RETRIES=3  
RESTART_SUPPORTED=YES RETRY_TIME=30

All other necessary parameters are read from the default configuration file, xcom.cnf.