15.10 - Teradata PT Status Messages - Parallel Transporter

Teradata Parallel Transporter Application Programming Interface

prodname
Parallel Transporter
vrm_release
15.10
category
Programming Reference
featnum
B035-2516-035K

Teradata PT Status Messages

Table 10 contains all the possible status messages that can be returned by the Teradata PT. The set of possible status messages returned by a specific Teradata PT function varies. See the Return Code column in Table 2, Table 3, and Table 4 for the possible status messages returned by each function.

 

Table 10: Teradata PT Status Messages 

Message

Status

CLI Error

A CLIv2 error has occurred. Values range from 300 to 500.

DBS Error

A Teradata Database error has occurred. Values range from 2,000 to 8,000.

TPTAPI Error

A Teradata PT specific error has occurred. Values range from 10000 and up.

TD_Call_EndAcq

The Teradata PT driver is signaling to the user application that the acquisition method needs to be aborted due to an error. The application must immediately call the EndAcquisition function. In a multiple instance environment, if the master or one or more slave instances receives this status code, all instances must immediately proceed to call the EndAcquisition function.

TD_END_Method

The calling application may move on to the next method. In export jobs, this status also signifies end of data when returned by the GetRow or GetBuffer functions.

In a multiple instance environment, the following must be done:

  • Each instance waits until all instances have returned the end method code.
  • Each instance enters the next method.
  • For more information, see Parallel Processing Return Codes in Chapter 7.

    TD_Error

    An error has occurred. When an error occurs, the return value is equal to or greater than TD_Error. TD_Error is a generic error code. See error types included in this table for specific numeric error code ranges.

    TD_Success

    The function has completed successfully.

    TD_SYNC_Barrier

    Used in a multiple instance environment. Signifies that the following must be done:

  • Each instance waits until all instances return the barrier code.
  • Each instance then recalls the method that returned the barrier code.
  • For more information, see Parallel Processing Return Codes in Chapter 7.

    TD_SYNC_TELINFO

    Used in a multiple instance environment. Signifies that the following must be done:

  • Each instance waits until all instances return the barrier code.
  • Get the TELINFO area from the master instance using the GetTELINFO function.
  • Pass a copy of the master’s TELINFO area to each of the slave instances.
  • Store the master’s TELINFO area within each slave instance using the PutTELINFO function.
  • Each instance then recalls the method that returned the barrier code.
  • For more information, see Parallel Processing Return Codes in Chapter 7.

    TD_Unavailable

    The data for an event is currently unavailable.