17.00 - Teradata PT Status Messages - Parallel Transporter

Teradata® Parallel Transporter Application Programming Interface Programmer Guide

prodname
Parallel Transporter
vrm_release
17.00
created_date
June 2020
category
Programming Reference
featnum
B035-2516-220K

The following table 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 Connection Class, Schema Class, and DML Group Class for the possible status messages returned by each function.

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.

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.

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.

TD_Unavailable The data for an event is currently unavailable.