構文 - Access Module

Teradata® Tools and Utilities Access Moduleリファレンス

Product
Access Module
Release Number
16.20
Published
2019年9月
Language
日本語
Last Update
2020-01-29
dita:mapPath
ja-JP/igy1527114222333.ditamap
dita:ditavalPath
ja-JP/igy1527114222333.ditaval
dita:id
B035-2425
Product Category
Teradata Tools and Utilities


初期化文字列またはパラメータ ファイル(-parmfile)にパラメータ属性を定義する際には、キーワードの大文字と小文字は区別されます。無効な値を含む認識されないキーワードを使用すると直ちに終了します。

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

初期化構文
構文要素 説明
parmfile <ObjectName> さらに多くのアクセス モジュール パラメータが常駐できるファイルの、任意選択のオブジェクト名です。 MVSでは、JCLで定義されるDDNAMEです。
  • パラメータ ファイルの各行には、1つのキーワード(パラメータ)とその値が含まれる。
  • 空の行は無視される。
  • ポンド文字(#)で始まる行は無視される。
  • キーワードは、必ず最初の列で始まる。

MVS JCL要件を参照してください。

help 有効なパラメータ ファイルのキーワードのリスト表示を要求する、任意選択のキーワードです。
QMGR <WebSphere MQ Manager Name> WebSphereのMQ Managerを指定する、必須パラメータです。MQ Managerは、メッセージを適切な待ち行列に連携およびルーティングします。

このパラメータが提供されない場合、オペレータは致命的エラーで終了します。

qnm <WebSphere Qname> 待ち行列名を指定する、必須キーワードです。
CKFILE <ObjectName/Statement> ディスク装置の使用を通じてチェックポイント サポート リクエストを許可する、任意選択のパラメータです。

MVS/ESAでは、チェックポイント データを書き込む先のObjectNameはDDNAMEになります。例えば、次のようになります。

CKFILE <DDNAME>

ここで、<DDNAME>は、JCLで定義済みのDDNAMEを指します。

MVS/USSでは、<Statement>でDD文を定義します。例えば、次のようになります。

ckfile dsorg=ps,dsn=tpt.x2cuss,disp=new,ndisp=catlg,
cdisp=catlg,track,primary=100,secondary=20,recfm=u,
blksize=32760,lrecl=0

再始動の場合は、disp値をshrに設定します。 この処理値がnewに等しい場合、また、既存のデータセットがある場合は、割り当て処理およびジョブは失敗します。 他のパラメータについては、IBM MVSのマニュアルを参照してください。

チェックポイントされたすべてのメッセージを格納するための十分なディスク記憶領域と、そのファイルをコピーするためのスペースが必要です。

このパラメータが提供されない場合、ファイルベースのチェックポイント サポートは使用できません。

ワークステーション プラットフォームでは、復元中のチェックポイントを容易にするために一時ファイルが作成され、チェックポイント ファイルと同じディレクトリに常駐します。 MQAMtmp.<pid>というファイルは、古くなったレコードをチェックポイント ファイルから削除するプロセスをサポートします。 このファイルは、チェックポイント操作の完了時に削除されます。
FLUSH <Yes/No> すべてのチェックポイント データがメディアに書き込まれたことを確認する、任意選択のパラメータです。Yesを選択した場合、アクセス モジュールはすべてのチェックポイント データをメディアに書き込みます。このオプションを使用するためには、ファイルベースのチェックポイント サポートを有効にしておく必要があります。

Noを選択すると、チェックポイント データはメディアに書き込まれません。 このオプションを選択すると、消費されるシステム リソースが著しく少なくなります。

このパラメータが提供されない場合、デフォルトの設定はNoです。

TDM <Yes/No> 重複メッセージの終了を許可する、任意選択のパラメータです。Yesを選択した場合、アクセス モジュールは重複メッセージがあると疑われる場合にEOFを返します。Noを選択すると、アクセス モジュールは重複メッセージを返します。

重複メッセージは、メッセージがチェックポイント ファイルに書き込まれた時刻とそのメッセージがMQCMITコマンドによってコミットされた時刻の間に発生したクラッシュまたは異常終了からの回復中にのみ発生します。

このパラメータが提供されない場合、デフォルトの設定はYesです。

BKSZ <MaximumMsgSize> WebSphere MQメッセージのブロック サイズを指定する、任意選択のパラメータです。 予想される最大サイズのメッセージを格納するための十分な大きさのブロックを定義する必要があります。

パラメータBLKZの値は、チェックポイントDD文のJCLで指定されたDCB BLKSIZEの値以下でなければなりません。

許容範囲: 1バイト–16MB

このパラメータが提供されない場合、デフォルトの設定は1,048,576バイトです。

受け入れられない値が提供された場合、以下のエラーが発行され、アクセス モジュールは失敗します。

Teradata WebSphere MQ AMOD/OpenCkPtFile(!ERROR!): Checkpoint DD DCB BLKSIZE (<DCB BLKSIZE value>) less than potential required (<BLKZ + 4>) (a function of keyword 'BKSZ')
RWAIT <MaximumSeconds> MQGET待機時間を指定する、任意選択のパラメータです。この待機時間は、直ちに受信可能なメッセージがない場合に、MQGETが待機する時間です。 MQGETは、最大反復回数が読み取り待機間隔の値に設定されたループ内で、繰り返し呼び出されます。 このループ本体には、シグナル ハンドラーが確実に呼び出されるようにするためのsleep(0)呼び出しが組み込まれています。

許容範囲: 1~600秒を入力するか、無制限の待機時間として-1を入力します。

このパラメータが提供されない場合、デフォルトの設定は1秒です。

待ち行列で長さ0のメッセージが見つかると、アプリケーションに対してEOFがトリガーされます。 これは、無制限の待機機能(RWAIT -1)を使用している場合に役立つことがあります。

ALLOWSIGNALS <Yes/No> シグナル ハンドラーの呼び出しの有無を決定する、任意選択のパラメータです。 デフォルトはYesです。この場合、メッセージ着信の待機中にシグナル ハンドラーが呼び出されます。 Noを選択した場合は、シグナル ハンドラーは呼び出されません。
OWAIT <MaximumSeconds> MQOPENの再試行間隔を指定する、任意選択のパラメータです。この間隔は、MQOPEN呼び出しが失敗した後、次に呼び出すまでの待機時間です。

許容範囲: 1~600秒

関連情報については、OTENACITYパラメータの項を参照してください。

このパラメータが提供されない場合、デフォルトの設定は5秒です。

OTENACITY <MaximumSeconds> 指定された待ち行列をアクセス モジュールがMQOPEN呼び出しを使用して開こうとする時間を指定する、任意選択のパラメータです。

許容範囲: 1~6000秒

このパラメータが提供されない場合、デフォルトの設定は5秒です。

LOGFILL <Yes/No> ログ レコードを圧縮してディスク領域の無駄を最小限に抑える、任意選択のパラメータです。Yesを選択した場合、モジュールは各ディスク ブロックをData Control Blockで指定されたブロック サイズに格納します。Noを選択した場合は、モジュールは各ディスク ブロックを1つのメッセージに格納します。

このパラメータが提供されない場合、デフォルトの設定はYesです。

LOG <LogObjectName/LogObjectStatement> ログ オブジェクトを要求および指定する、任意選択のパラメータです。 MQから受信されたすべてのメッセージは、指定されたログにエコーされます。

MVS/USSでは、<LogObjectStatement>でDD文を定義します。例えば、次のようになります。

log dsorg=ps,dsn=tpt.x2luss,disp=new,ndisp=catlg,
cdisp=catlg,track,primary=100,secondary=20,recfm=u,
blksize=2000,lrecl=0

既存のログに追加するためには、disp値をmodに設定します。 disp値をnewに設定した場合は、新しいログが開始されるため、既存のデータ セットが存在していてはならないことになります。 他のパラメータについては、IBM MVSのマニュアルを参照してください。

このパラメータが提供されない場合、ログは保存されません。

ALTERNATELOG <DDNAME> Teradata Access Module for WebSphere MQのMVSバージョンに指定する、代替ログを開くための任意選択のパラメータです。代替ログを指定すると、外部処理の基本ログを閉じることができます。外部通知出口ルーチンは、信号をアクセス モジュールに送信して、-LOG <DDNAME>で定義される宛先と-AlternateLog <DDNAME>で定義される宛先間でスワッピングを行ないます。ログ間のスワッピングは、信号が受信されるたびに行なわれます。

このパラメータが提供されない場合、代替ログは保存されません。

TLF <Yes/No> ログの失敗を原因とする致命的なエラーを発生させるかどうかを指定する、任意選択のパラメータです。Yesを選択した場合、アクセス モジュールは何らかの理由でログに書き込みを行なうことができない場合に終了します。Noを選択した場合、アクセス モジュールが動作を継続している間、ロギングできなくなります。

このパラメータが提供されない場合、デフォルトの設定はYesです。

MQEX MQが指定した待ち行列だけを開くためのプロセスを許可する、任意選択のパラメータです。

このパラメータが提供されない場合、特定の待ち行列を個別のプロセスで開くことはできません。

CONVERT <Yes/No/CCSID Num> WebSphere MQメッセージの文字セットを要求する、任意選択のパラメータです。Yesを選択した場合、アクセス モジュールはデータを常駐文字セットに変換します。Noを選択した場合、アクセス モジュールはデータを変換しないでメッセージを処理します。

このパラメータが提供されない場合、デフォルトの設定はNoです。

TRCL <level> <ObjectName> 診断のための任意選択のパラメータです。レベル0から4は、それぞれ次の内容を示します。
  • 0: 診断トレースは実行されない
  • 1: レポートされたジョブ イベントのみ
  • 2: I/Oイベント
  • 3: I/Oバッファ
  • 4: 詳細情報

デフォルトの設定は0で、トレースは実行されないことを意味します。 1以上のレベルで、診断またはチェックポイント サポートが実行されます。

MVSのfilenameの宛先は、DDNAMEです。

アクセス モジュールやDataConnectorではなく、使用しているロード ユーティリティがジョブ ログを作成します。
CHNL <name> WindowsプラットフォームでWebSphere MQチャネル名を確立します。UNIXプラットフォームの場合、チャネル名はシェルとシステムによってMQSERVERなどの環境変数を使用して定義されます。

正しい構文と環境変数の使用については、http://ibm.com/webspheremqに掲載されているWebSphereのマニュアルを参照してください。

SRVR <name>[:port] WindowsプラットフォームでWebSphere MQサーバー名を確立します。UNIXプラットフォームの場合、サーバー名はシェルとシステムによってMQSERVERなどの環境変数を使用して定義されます。

正しい構文と環境変数の使用については、http://ibm.com/webspheremqに掲載されているWebSphereのマニュアルを参照してください。