(1) >>-+-pureQueryXML-file-----------------------+--=---------------> '-pureQueryXML-file--:--base-package-name-' >--+---------------------------------------------------------------------------------------------------------------------+--> | (2) (3) | '------------- -url--jdbc--:--db2--:--//--server--+---------+--/--database-- -username--user-ID-- -password--password-' '-:--port-' >--+-----------------------------------------+------------------> '-+- -bindOptions-- -"--bind-options--"-+-' | (4) | '-| DBRM options |--------------------' >--+----------------------------------------------+-------------> | .----------------------. | | V | | '- -configureWarning---- -configure-warnings-+-' >--+-----------------------------+--+----------------+----------> | .-FALSE-. | | (5) | '- -differenceOnly--+-TRUE--+-' '-| -grant |-----' >--+--------------------------+--+--------------------------+---> '- -isolationLevel--+-CS-+-' | .-FALSE-. | +-RR-+ '- -showDetails--+-TRUE--+-' +-RS-+ '-UR-' >--+--------------------------+-------------------------------->< | .-FALSE-. | '- -validateXml--+-TRUE--+-'
各オプションの値にスペースを含めることはできません。
これらのオプションのリストおよび説明については、BIND コマンドを参照してください。
Configure ユーティリティーの -optionsFileForBind オプションを指定すると、Configure ユーティリティーは StaticBinder オプション・ファイルを生成します。このオプション・ファイルには、バインド・オプションと追加情報が含まれています。この情報は、SQL ステートメント、ステートメント・セット、および pureQueryXML ファイル内の DB2 特殊レジスター情報に基づいています。 Configure ユーティリティーは、潜在的な問題を検出すると、-configureWarning オプションをバインド・オプションに追加します。 指定されたバインド・オプションを使用してパッケージをデータベースにバインドし、SQL ステートメントを静的に実行した場合、正しくない動作になる可能性があります。
Configure ユーティリティーは、ステートメント・セットのコメント行への警告トークンの追加も行います。 このコメントには、ステートメント・セットおよびステートメント・セット内の SQL ステートメントに関連した警告と情報が含まれることがあります。警告の修正方法については、Configure ユーティリティーによって作成されるバインド・オプションに記載された、警告とともに生成されるトークンに関する情報を参照してください。StaticBinder ユーティリティーの実行時に -configureWarning オプションを指定した場合、このユーティリティーは関連パッケージのバインドを試みます。 StaticBinder ユーティリティーは、警告によって指定された問題を示す警告メッセージの印刷も行います。
-configureWarning オプションでは、以下の値を使用することができます。
Configure ユーティリティーは、ステートメント・セットのコメント行への incrementalSpecialRegValuesPresent トークンの追加も行います。
Configure ユーティリティーは、ステートメント・セットのコメント行への missingSpecialRegValueId(IDs) トークンの追加も行います。
Configure ユーティリティーは、ステートメント・セットのコメント行への SQLGroupedBySpecialRegisters(MULTI_SRINFO) トークンの追加も行います。
Configure ユーティリティーは、ステートメント・セットのコメント行への SQLGroupedBySpecialRegisters(INCONSISTENT_SRINFO) トークンの追加も行います。
StaticBinder ユーティリティーで DBRM ファイルが生成された後に、それらのファイルをデータ・セットにコピーする必要があります。デフォルトの DBRM データ・セット名は prefix.DBRMLIB.DATA です。ここで prefix は、ユーザーの TSO プロファイルで指定された高位修飾子です。通常、prefix は TSO におけるユーザー ID です。
DBRM データ・セットがまだ存在しない場合は、それを作成する必要があります。 DBRM データ・セットには、すべての SQL ステートメントを保持するスペースと、各ホスト変数名とヘッダー情報用の追加スペースが必要です。 ヘッダー情報の概算として、DBRM ごとに 2 つのレコード、SQL レコードごとに 20 バイト、ホスト変数ごとに 6 バイトが必要です。 DBRM の厳密なフォーマットについては、DBRM マッピング・マクロである、ライブラリー prefix.SDSNMACS の DSNXDBRM を参照してください。
以下の構文図は、DBRM ファイルを生成するためのオプションを記述しています。
.-FALSE-. >>- -generateDBRM--+-TRUE--+-- -outputDBRMPath--path-----------><
生成された DBRM ファイルのルート名は、構成ユーティリティーの実行時に指定したルート・パッケージ名です。
デフォルトは FALSE です。
例えば、capture.pdqxml という名前の pureQueryXML ファイルに対して StaticBinder ユーティリティーを実行するとします。 このユーティリティーにより、パッケージ MYPKGA、MYPKGB、および MYPKGC が作成されます。 その後、ワークベンチを使用して capture.pdqxml 内のステートメント・セット MYPKGA を編集し、このファイルに対して、-cleanConfigure オプションを指定して (値としてはデフォルト値 FALSE を使用) Configure ユーティリティーを実行します。 セットが変更されたため、構成ユーティリティーは新規の整合性トークンをステートメント・セットに割り当てます。 MYPKGA の新しいバージョンをバインドするために capture.pdqxml に対して再び StaticBinder ユーティリティーを実行する際には、-differenceOnly TRUE を指定します。 ユーティリティーは MYPKGA のみを再バインドし、他の 2 つのパッケージの再バインドは行いません。
.-,--------------------. V | >>- -grant-- "--grantees--(----+-authorization-ID-+-+--) - "--->< '-PUBLIC-----------'
DB2 Database for Linux, UNIX, and Windows の場合: USER、GROUP、および ROLE キーワードを使用できます。 これらのキーワードについては、GRANT (パッケージ特権) ステートメントを参照してください。
DB2 for z/OS の場合: ROLE キーワードを使用できます。 このキーワードについては、GRANT (パッケージ特権) を参照してください。
制限: -generateDBRM オプションの値が TRUE である場合には、-grant オプションは使用できません。
分離レベルは、パッケージ内のすべての SQL ステートメントに適用されます。 IBM® Data Server Driver for JDBC and SQLJ の Connection.setTransactionIsolation() メソッドを使用して分離レベルを設定した場合は、pureQuery は静的に実行されたステートメントの分離レベルを無視します。
ファイルの拡張子は、.pdqxml または .xml でなければなりません。 ファイルをアプリケーションのクラスパス内のリソースにするか、 ファイルへの絶対パスまたは相対パスを指定する必要があります。
-url jdbc:db2://localhost:50000/SAMPLE:enableNamedParameterMarkers=1;
入力ファイルごとに XML スキーマの妥当性検査の成功または失敗が確認され、報告されます。妥当性検査に失敗した入力ファイルがあっても、StaticBinder 処理は停止せず、次のファイルが処理されます。
pureQueryXML ファイルのスキーマの妥当性検査が失敗した場合は、そのファイル内のパッケージはバインドされません。ファイルの最初のスキーマの妥当性検査エラーおよびバインドの失敗が報告されます。
現行リリースまたは前のバージョンの pureQueryXML ファイル (バージョン 4 または 3) でのみ検証されます。 それよりも古いバージョンの pureQueryXML が検出された場合、そのファイルでは妥当性検査が実行されません。