Update Global Variable - Parallel Transporter

Teradata® Parallel Transporter Operator プログラマ ガイド

Product
Parallel Transporter
Release Number
17.20
Published
2022年6月
Language
日本語
Last Update
2022-08-22
dita:mapPath
ja-JP/yvm1645201744157.ditamap
dita:ditavalPath
ja-JP/obe1474387269547.ditaval
dita:id
B035-2435
Product Category
Teradata Tools and Utilities

目的

Update Global Variableは、グローバル変数に値を割り当てるサービス関数です。

構造

#include <pxoper.h>
PXSTC_Code PX_UpdateGlobalVar(PX_OperatorHandle  operator,
   PX_Name  varName,
   PX_Addr  itemBufferAddr,
   PX_Length  itemBufferSize);
   PX_Count  itemIndex,

次のような場合に当てはまります。

パラメータ 機能 指定
itemBufferAddr 入力 グローバル変数への割当て値が格納されるバッファのアドレス
itemBufferSize 入力 項目バッファの値のサイズ
itemIndex 入力 更新するグローバル変数の項目

itemIndexパラメータは、1から、グローバル変数の作成時に指定された上限までの範囲となります。

operator 入力 グローバル変数を更新するオペレータ ハンドル
varName 入力 グローバル変数の名前

戻りコード

以下のUpdate Global Variable関数のステータス コードは、Teradata PTオペレータ インターフェースによって定義されます。

ステータス コード 意味
PXSTC_InvalidArgument 1つ以上の正しくない入力引数
PXSTC_BadHandle 未定義のオペレータ ハンドル
PXSTC_LengthError 更新値の長さが、グローバル変数バッファの長さと一致しない
PXSTC_NotEnough グローバル変数のサイズが大きすぎる
PXSTC_Success グローバル変数の更新アクセスの成功

使用上の注意

Update Global Variable関数を定義する場合の注意事項は、以下を考慮してください。

対象 使用上の注意
ステータス 関数のステータスがPXSTC_Successの場合は、itemBufferAddrの位置に格納された値が、itemIndexグローバル変数の指定されたvarNameに割り当てられます。
関連項目