Purpose
Put Column Value is the service function that stores a value in the specified column.
Structure
#include <pxoper.h> PXSTC_Code PX_PutColumnValue(PX_ColumnHandle columnHandle, PX_Indicator nullIndicator, PX_Addr dataAddr, PX_Length dataLength);
where the following is true:
| Parameter | Function | Specification |
|---|---|---|
| columnHandle | input | Column handle where the value is to be stored. |
| dataAddr | input | The address of the value. |
| dataLength | input | Length of the value. |
| nullIndicator | input | Truth value indicating whether or not the column value can be NULL. |
Return Codes
The following Put Column Value function status codes are defined by the Teradata PT operator interface.
| Status Code | Signifies |
|---|---|
| PXSTC_InvalidArgument | One or more bad input arguments. |
| PXSTC_BadHandle | An undefined column handle. |
| PXSTC_Success | Successful storage of the specified column value. |
Usage Notes
Consider the following when defining the Put Column Value function.
| Topic | Usage Notes |
|---|---|
| Status | If the function status is PXSTC_Success, the value is stored in the internal buffer associated with the specified column. See also the Get Column Value function. |