Tell About Delay - Call-Level Interface Version 2

Tell About Delay

Usage Notes

The Tell About Delay field specifies whether or not the application program is to be informed of a computer crash/restart while waiting for the restart to complete.

If a restart is detected during logoff processing, CLI reconnects the session and resubmits the logoff request.

If a restart occurs during a logoff request, CLI automatically resubmits the request.

Note: FastLoad and BTEQ applications cannot use the CAP library because it overrides FastLoad and BTEQ settings. Thus, the DBCAREA must be changed dynamically to effect a change to Tell About Crash.

Language	Variable Name
COBOL:	DBCAREA-TELL-ABOUT-DELAY
C: DBCAREA.H:	tell_about_delay

Routine	Action Taken
DBCHINI:	writes
DBCHCL:	reads (CON; RSUP: IRQ; FET; REW; ERQ; ABT)

Used by	Action Taken
application program	writes

Tell About Delay is initialized by DBCHINI to the default value provided in the site’s SPB.

If the value provided is not appropriate for the application, before calling DBCHCL the application program may:

Set Change Options to Y, and

Change the value in Tell About Delay to:

‘Y’ - if notification is to take place during the wait period

‘N’ - if notification is not to take place during the wait period.

APRC and Tell About Delay

With AP Reset Containment (APRC), the change in nomenclature (from Crash to Delay) is a more accurate designation of this variable. To prevent the need for users having to make changes to their applications, the actual field name in the structure/record definition supplied remains Tell About Crash.

Used with Wait Across Delay

The combination of Tell About Delay set to N and Wait Across Delay set to N is not allowed.

If Tell About Delay and Wait Across Delay are both set to Y, an intermediate return code of 220 is returned when communication is lost with the Teradata Database. If the request is still pending, the response’s final status will be returned after communication is restored. That is, if Wait Across Delay is set to Y, the notification it supplies is the one at the end of the waiting period, and the notification that Tell About Delay does, or does not, supply is an additional one during the waiting period.

The Fetch, Rewind, End Request, and Abort functions read and use the value of Tell About DelayCrash, but do not store it.