Tenacity / Sleep automatic adjustment in FastLoad

Tools
Tools covers the tools and utilities you use to work with Teradata and its supporting ecosystem. You'll find information on everything from the Teradata Eclipse plug-in to load/extract tools.
Teradata Employee

Tenacity / Sleep automatic adjustment in FastLoad

Teradata FastLoad has a feature named Tenacity that allows user to specify the number of hours that FastLoad continues trying to log on when the maximum number of load operations is already running on the Teradata Database.

By default the Tenacity feature is not turned on. The feature is turned on by the script command:

Tenacity n;

Where n specifies the number of hours FastLoad continues trying to logon. The n specification must be greater than zero. If zero is entered, Teradata FastLoad responds with an error message and terminates. During the Tenacity duration, FastLoad tries to log on every 6 minutes by default. The 6 minute default can be changed by using the script command:

Sleep m;

Where m specifies the number of minutes Teradata FastLoad sleeps before retrying the logon operation. The m specification must be greater than zero. If zero is entered, Teradata FastLoad responds with an error message, and terminates.

Below is an example of Tenacity usage. Suppose the commands in the script are:

Tenacity 1;

Sleep 15;

The Tenacity duration is 60 minutes and the Sleep interval is 15 minutes.

When Teradata FastLoad tries to log on for a new session, and the Teradata Database indicates that the maximum number of load sessions is already running, the Teradata FastLoad utility:

  • Logs off any new sessions that were logged on
  • Waits (i.e. sleeps) for 15 minutes
  • Tries again to log on to the Teradata Database

Teradata FastLoad repeats this process until it has either logged on for the required number of sessions or the total of time it waits (or sleeps) equates the amount of time specified by the Tenacity command (which is 60 minutes as in the example). In the latter case, FastLoad terminates with an error message.

In this example, the maximum total of time intervals FastLoad can wait equates to the Tenacity duration specified.

What happens when the value of Sleep is greater than Tenacity? If in the above example, the Sleep command is “Sleep 17;” The first 3 sleeps take 51 minutes, the last (or the fourth) sleep takes 17 minutes then the total of sleep time is 68 minutes that is greater than the Tenacity duration which is 60 minutes.  It is more than what of the user expects and are willing to wait. Therefore, to ensure that the total of sleep time matches with the Tenacity duration, FastLoad automatically adjusts the last sleep time interval to 9 minutes and displays the below message to inform user about this adjustment.

Sleep interval is dynamically adjusted and reset to 9 minutes

Another example of Sleep time adjustment is when the specification of the Sleep time interval is greater than that of the Tenacity duration:

Sleep 65;

Tenacity 1;

In that case, the Sleep time is 65 minutes and the Tenacity is 60 minutes. When Teradata FastLoad tries to log on for a new session, and the Teradata Database indicates that the maximum number of load sessions is already running. FastLoad automatically adjusts the Sleep time interval to 60 minutes before going to sleep and displays the message:

Sleep interval is adjusted to 60 minutes as it exceeds tenacity

Note: This article discusses about Teradata FastLoad automatically adjusts Sleep time interval to match with the Tenacity duration. But other SA utilities (FastExport, MultiLoad and TPump) also have the Tenacity feature and do the same automatic adjustment logic.

2 REPLIES

Re: Tenacity / Sleep automatic adjustment in FastLoad

hi all

could u pls tell me ,  is there any settings or parameter that decreasing the waiting duration against next available new session on the teradata database which reached the max number of the sessions?

thanks in advance..

Teradata Employee

Re: Tenacity / Sleep automatic adjustment in FastLoad

Hello,

I am not aware of such settings or parameter. I don't think there is.

Thanks!