構文 - Parallel Transporter

デフォルトでは、Teradata PTデータ ストリームは、プロデューサのチャネル設定アレイにある、最初に準備完了(利用可能)した Consumerオペレータに、データのブロックを送信します。プロセスが切り替わるのは、最初の Consumerオペレータがビジーのため、新たに入力を受信できないときだけです。 -Cオプションを使用すると、データが確実に各 Consumerオペレータに、均等に配置されます。

このオプションを使用すると、tbuildのために呼び出されたすべての内部機能のトレース メッセージと戻りコードが出力されます。 内部エラー条件コードとトレース メッセージは、通常はインフラストラクチャ レベルで発生している問題のデバッグに役立ちます。 ただし、オペレータで提供されるトレース オプションとともにこのオプションを使用すると、ジョブの完全なトレースを取得できます。

このオプションを指定しない場合、デバッグ トレース機能は無効になります。

指定しない場合は、デフォルトの文字セットとして7ビットASCII互換(UNIX OSとWindowsの場合)またはEBCDIC (z/OSの場合)が使用されます。

-e characterSetは、ジョブ スクリプトがUTF-16でエンコードされている場合に必須です。

すべての値は、大文字と小文字が区別されず、ハイフン付きまたはハイフン無しで指定できます。つまり、UTF-16、UTF16、utf16-beなどという表記はどれも有効になります。次の値がcharacterSetで有効です。

• UTF-16

  (推奨表記)デフォルトのエンディアンは、クライアント プラットフォームに従います。

• UTF-8

  (推奨表記)UTF-8の指定は任意選択です。 UTF-8以外のスクリプトでUTF-8を指定すると、エラーが発生します。 UTF-8エンコーディングでは、エンディアンは関係ありません。

• UTF-16LE

  (推奨表記)リトル エンディアン エンコーディングのジョブ スクリプトを指定します。 ビッグ エンディアンのプラットフォームで実行した場合は、スクリプト エンコーディングは、実行前に、ビッグ エンディアンに変換されます。 クライアント セッション文字セット名としては、許可されません。

• UTF-16BE

  (推奨表記)ビッグ エンディアン エンコーディングのジョブ スクリプトを指定します。 リトル エンディアンのプラットフォームで実行した場合は、スクリプト エンコーディングは、実行前に、リトル エンディアンに変換されます。 クライアント文字セット名としては、許可されません。

オプションには以下のものが含まれます。

• -h value。valueには共有メモリのサイズをバイト単位で指定します。1,048,576バイト～4,294,967,295バイトの範囲の値を指定できます。
• -h valueK。valueKには共有メモリのサイズをキロバイト単位で指定します。1024K(1,048,576バイト)～4,194,304K(4,294,967,295バイト)の範囲の値を指定できます。
• -h valueM。valueMには共有メモリのサイズをメガバイト単位で指定します。1M(1,048,576バイト)～4096M(4,294,967,295バイト)の範囲の値を指定できます。

例えば、次のように指定します。

tbuild -h 24M

-hオプションが指定されていない場合、Teradata PTは、<Teradata® Parallel Transporterユーザー ガイド, B035-2445>で概説されている計算に従って共有メモリを割り当てます。

-hオプションが無効である場合は、警告メッセージが出力され、<Teradata® Parallel Transporterユーザー ガイド, B035-2445>で概説されている計算に従って共有メモリが割り当てられます。

-hのメモリ サイズが無効です。この指定は無視されます。

• TPTインストール ディレクトリにあるグローバル構成ファイルtwbcfg.ini
• ユーザーのホーム ディレクトリにあるローカル構成ファイル.twbcfg.ini

<parameter> = <single-quoted string>

CheckpointDirectory='/opt/teradata/client/16.20/tbuild/checkpoint'
LogDirectory='/opt/teradata/client/16.20/tbuild/logs'

<user name>-<job sequence number>

値を指定しない場合、バッファがいっぱいになるまでデータ ストリームからデータが読み取られます。 バッファがいっぱいになると、すべてのバッファ レコードがデータベースに書き込まれます。

jobLogDirectoryは、Teradata PTファイルが格納されているディレクトリのフルパス名です。

このオプションは、z/OSではサポートされません。

このオプションを指定しない場合、統計情報は収集されません。

• ジョブ ステップがゼロ以外の終了コードを受信した場合、ジョブは続行します。
• ステップがステータス“failure"(4よりも大きい終了コード)で終了した場合、後続のステップは、前に失敗したステップで残されたチェックポイント ファイルを回避します。

必須の構文は次のとおりです。

tbuild -f <scriptFile> -n

このオプションを指定しない場合、ステップが失敗するとジョブは終了します。

-oオプションを指定しない場合、出力は標準出力に書き込まれません。

-r オプションを指定しないと、チェックポイント ファイルは、デフォルトのチェックポイント ディレクトリに格納されます。このディレクトリは、Teradata PTの構成ファイルで定義されています。

ジョブ ステップは、スクリプト内のジョブ ステップ名、またはスクリプト内でのジョブ ステップの物理的な順序に対応する暗黙のジョブ ステップ番号(1、2、3など)によって識別されます。

ジョブは、指定したジョブ ステップから開始されます。ジョブ スクリプト内で開始指定よりも前にあるジョブ ステップは、すべてスキップされます。

上記の条件に一致するチェックポイント ファイルは後続のステップで無効となるため、-sオプションに指定されたステップを開始する前に自動的に削除されます。

• ddnameを指定する場合: tbuild -S logDestination

  ここで、logDestinationはDD:<ddname> (ログ ファイルの宛先ddname)です。

• dsnameを指定する場合: tbuild -S logDestination

  ここで、logDestinationは<dsname> (ログ ファイルの宛先データセット名)です。

  完全修飾のデータセット名は、名前を単一引用符で囲んで指定します。
• SYSOUTクラスを指定する場合: tbuild -S logDestination

  ここで、logDestinationは<sysout class> (ログ ファイルのSYSOUTクラス)です。

-Sオプションを指定しない場合、tbuildはプライベート ログもパブリック ログも、指定された場所に書き込みません。 ただし、tbuildは、JOBLOG DD文によって参照されているデータセットにはログを書き込みます。

このオプションを指定しない場合、トレースは無効になります。

このオプションは、ジョブ スクリプトの現在の実行に対してコマンド ラインでジョブ変数割り当てを指定するために使用します。

ATTRIBUTES
(
   VARCHAR UserName = @UsrID,
   VARCHAR UserPassword = @Pwd
);

tbuild -f scriptFileName -u "UsrID = 'John Doe', Pwd = 'ABC123' "

このオプションは、スクリプトに指定されているジョブ変数に対して実行時に値を割り当てる-uオプションに似ていますが、次のようなコマンドによってtbuildが参照する外部ファイルに変数値が格納される点が異なります。

tbuild -f scriptFileName -v jobVariablesFile

ここで、jobVariableFileは、置き換えられる値を含んでいるファイルです。

UsrID = 'John Doe',
Pwd = 'ABC123'

ジョブ変数ファイルが格納されているディレクトリ以外でtbuildコマンドを実行している場合、jobVariablesFileは完全修飾ファイル名である必要があります。ジョブ変数ファイルは、ASCII、UTF-8、またはUTF-16で保存でき、UTFバイト オーダー マーク付きとマークなしのどちらでも構いません。

他のオプションとともに使用しないでください。 このオプションは、UNIXおよびWindowsプラットフォームでのみ機能します。

このオプションを指定しないと、自動再起動と自動再起動の間に待機が行なわれません。

有効な再起動待機期間の値は、1から86400(秒)までの正の整数でなければなりません。

TPTがサブプロセスを生成するまで待機する秒数を指定します。値には1～900の整数を指定できます。ジョブが次のエラーとともに頻繁に失敗する場合に、このオプションの使用を検討してください。

エラー: タスク初期化の待機が時間切れになりしました。

-Wオプションが指定されない場合、TPTはデフォルトの120秒を使用します。

-Wオプションが無効(つまり、0または数値以外)の場合、TPTはデフォルト値の120秒を使用し、次のメッセージが発行される。

TPT_INFRA: TPT04215: 警告: -Wタイムアウト値は無効であり、無視されます。

-Wオプションが最大許容値900秒より大きい場合、TPTは最大値900秒を使用し、次のメッセージを表示します。

TPT_INFRA: TPT04214: 警告: -Wタイムアウトの値は許容最大値を超えるので900に下げられます。