15.10 - Return Time - Call-Level Interface Version 2

Teradata Call-Level Interface Version 2 Reference for Mainframe-Attached Systems

prodname
Call-Level Interface Version 2
vrm_release
15.10
category
Programming Reference
featnum
B035-2417-035K

Return Time is a one byte field that specifies if time stamps are to be generated for the application.

 

In this language...

The variable name for Return Time is...

COBOL

DBCAREA‑RET‑TIME

PL/I

RET_TIME

C

ret_time

IBM Assembler

DBORTS

 

This routine...

Does this for Return Time...

DBCHINI

writes

DBCHCL

reads (CON; RSUP; IWPF; IRQ; CRQ)

 

Return Time is used by...

To...

applications

write

Return Time is initialized by DBCHINI to the default value provided for Return Time in the HSHSPB.

When the value for Return Time is not appropriate for the application, you should perform the following procedure before calling DBCHCL:

1 Set Change Options to ‘Y‘.

2 Change the value for Return Time as follows.

 

If time stamps are...

Then change the value for Return Time to...

to be provided

Y

not to be provided

N

Use mnemonics for the codes. Mnemonics are provided in the language definition file for the DBCAREA.

When time stamps are specified for the Fetch function, the time stamps provided are valid only on the first call to DBCHCL for the Fetch function.

The time stamps may be changed later. For example, if DBCHCL exchanges information with the Teradata Database to keep the response buffer stocked.

You should only use the time stamp capability for diagnostic applications.