DSN コマンド (TSO)
TSO コマンド DSN は DSN セッションを開始します。
TSOコマンドDSNで発行できるコマンドのリストについては、 Db2 コマンドを 参照してください。
DSN サブコマンド
DSN コマンドには、以下のサブコマンドがあります。
| DSNサブコマンド | 説明 |
|---|---|
| ABEND | DSN サブコマンド ABEND は、DSN セッションを異常終了完了コード X'04E' と異常終了理由コード X'00C50101' で終了させます。 重要：
 ABENDサブコマンドは診断目的でのみ使用され、 IBM サポートの指示の下でのみ使用されることを意図している。 DSNまたは Db2 の問題を診断する場合のみ使用してください。 |
| BIND PACKAGE | DSN サブコマンド BIND PACKAGE は、アプリケーション・パッケージを作成します。 Db2 は、カタログ表にパッケージの記述を記録し、準備されたパッケージをディレクトリーに保存します。 BIND PACKAGEは、サポートが終了したパッケージのコピーも削除します。 |
| BIND SERVICE | BIND SERVICE (DSN) サブコマンドは、 Db2 REST サービスを表すアプリケーションパッケージを構築します。 |
| BIND PLAN | DSN サブコマンド BIND PLAN は、アプリケーション・プランを作成します。 Db2 のすべてのプログラムでは、 Db2 のリソースを割り当て、実行時に発生するSQLリクエストをサポートするためのアプリケーションプランが必要です。 |
| BIND QUERY | DSN サブコマンドの BIND QUERY は、ステートメント・テキスト、デフォルト・スキーマ、およびバインド・オプションのセットを DSN_USERQUERY_TABLE のすべての行から読み取り、相関関係の EXPLAIN 表の行から情報を読み取ります。 LOOKUP(NO) が有効な場合、Db2 は適切なデータを特定のカタログ表に挿入します。 |
| FREE PACKAGE | FREE PACKAGE サブコマンドを使用すると、特定のバージョンのパッケージ、パッケージの全バージョン、またはパッケージのコレクション全体を削除することができます。 |
| FREE SERVICE | FREE SERVICE サブコマンドは、 Db2 REST サービスを表すアプリケーションパッケージを削除します。 |
| FREE PLAN | FREE PLAN サブコマンドは、 Db2 からアプリケーションプランを削除します。 |
| FREE QUERY | FREE QUERY サブコマンドは、1つまたは複数のクエリに対して、特定のカタログテーブルから行を削除します。 指定した照会のいずれかが動的ステートメント・キャッシュ内にある場合、FREE QUERY は動的ステートメント・キャッシュからこれらを消去します。 |
| FREE STABILIZED DYNAMIC QUERY |
FREE STABILIZED DYNAMIC QUERY コマンドは、特定のカタログ・テーブルから1つまたは複数の安定化された動的クエリを削除します。 指定されたクエリが動的ステートメントキャッシュに存在する場合、 FREE STABILIZED DYNAMIC QUERY は動的ステートメントキャッシュからそのステートメントも削除します。 |
| DCLGEN (DECLARATIONS GENERATOR) | 宣言生成プログラム (DCLGEN) は、SQL DECLARE TABLE ステートメントと、カタログに名前が指定されている表またはビューの COBOL、PL/I、または C のデータ宣言を生成します。 |
| REBIND PACKAGE | DSN サブコマンド REBIND PACKAGE は、パッケージに影響を与える変更を行ったが、プログラム内の SQL ステートメントを変更していない場合に、アプリケーション・パッケージを再バインドします。 |
| REBIND PLAN | DSN サブコマンド REBIND PLAN は、プランの属性 (パッケージ・リストなど) を変更したときに、アプリケーション・プランを再バインドします。 |
| REBIND TRIGGER PACKAGE | DSN サブコマンド REBIND TRIGGER PACKAGE は、基本トリガー用のパッケージを再バインドします。 基本トリガーは、SYSIBM.SYSTRIGGERS カタログ表を照会することによって識別できます。 SQLPL 列のブランク値は、基本トリガーを識別します。 高度なトリガーについては、代わりにREBIND PACKAGEコマンドを使用してください。 |
| RUN | DSN サブコマンド RUN は、SQL ステートメントを入れることができるアプリケーション・プログラムを実行します。 |
| SPUFI | DSN サブコマンド SPUFI は、ファイル入力を使用して SQL 処理プログラムを 実行します。 |
DSNセッション中には、STARTコマンドを除く Db2 コマンドを入力することもできます DB2。 Db2 コマンドはハイフン（-）で始まらなければならない。 コマンドの詳細については、 Db2 Db2 commands の下にある、 (Db2
) の後に認識文字 -
が続く名前のコマンドを参照のこと。
アスタリスク (*) を先頭に付けて、コメントを入力することもできます。
TEST '
prefix
.SDSNLOAD(DSN)' CP なお、パーセント・コマンドは DSN セッション中では認識されません。TSO コマンド・プロセッサー だけがそれらのコマンドをサポートします。
環境 DSN
DSN セッションは、TSO 下においてフォアグラウンドまたはバックグラウンドのいずれかのモードで実行します。 バックグラウンド・モードで実行すると、 情報を訂正したり必要な別の情報を入力するためのプロンプトは出されません。
DSN セッションはさらに、フォアグラウンドまたはバックグラウンドのいずれかのモード で実行する CLIST から開始することができます。
データ共用範囲: メンバー
承認 DSN
DSN コマンドが必要とする許可はありませんが、 サブコマンドの大部分には許可が必要です。
構文 DSN
オプションの説明 DSN
- SYSTEM
- (サブシステム名 )
- Db2 サブシステムの名前を指定します。
- ( グループ添付名 )
- データ共用グループのグループ接続機構の名前を指定します。
- ( サブグループアタッチメント名 )
- データ共用グループのサブグループ接続機構の名前を指定します。
デフォルトは SYSTEM( DSN ) で す。 この値は、 Db2 のインストール中に変更することができます。
- RETRY (integer )
- Db2 が稼働していない場合、またはDSN発行時にバッチ接続の最大数に達している場合に、 Db2 サブシステムへの接続を試みる追加回数を指定します（整数）。 再試行は 30 秒間隔で行われます。
デフォルトは RETRY( 0 ) です。 また、再試行の最大数は 120 です。
- TEST (integer )
- そのモジュール名の最後の 2 桁 (整数) を指定して、1 つの DSN モジュールをトレース します。 100 を超える数を指定すれば、すべての DSN モジュールを トレースできます。 DSN トレース情報は TSO SYSTSPRT DD ステートメントに、 またオプションで DSNTRACE DD ステートメントに、書き込まれます。
- GROUP
- ( YES)
- システムが非アクティブの場合にグループ接続処理を考慮することを指定します。
- （いいえ）
- グループ接続処理を考慮しないことを指定します。
- ASUSER (ユーザーID )
- 現行 DSN セッションのトラステッド接続に
関連付けるユーザー ID を指定します。
Db2 で定義された信頼されたコンテキストに、プライマリ認証IDとジョブ名が一致する場合、信頼された接続が確立されます。 ASUSER として指定するユーザー ID は、標準許可および接続終了処理を経て、 1 次 ID および 2 次 ID をピックアップします。 プライマリ認証IDが認証なしで信頼済み接続を使用することが許可されている場合、 Db2 はASUSERユーザーIDに対して信頼済み接続を確立します。 これで、1 次許可 ID、2 次許可 ID、および ASUSER ユーザー ID に関連したロールは、 トラステッド接続に対して有効になります。
ASUSER オプションに指定したユーザー ID に関連した 1 次許可 ID が、トラステッド接続 の使用を許可されていない場合または認証情報を必要とする場合には、接続要求は失敗します。
Db2 ASUSERの値はDSNセッションが有効である間のみ保持されます。
使用上の注意事項 DSN
- フォアグラウンド操作では、端末でのプロンプト・ストリング DSN によって 入力が要求されます。 バックグラウンド・モードの場合、入力は SYSTSIN データ・セットから読み取られます。
- DCLGEN コマンド内に指定された、区切り文字で区切られた複数の表名の場合を除いて、 小文字での入力は大文字に変えられます。
- サブコマンドのキーワードが重複して指定された場合、 それらのキーワードのうち最後のものが処理され ます。 例えば、MEMBER( dbrm-member-name1) と MEMBER( dbrm-member-name2) の両方が BIND PLAN に指定されている場合、Db2 は後の方である MEMBER( dbrm-member-name2) を受け入れます。
- DSNセッション中にATTENTION ( PA1 ) が押され、TSOユーザープロファイルでPROMPTが指定されている場合、 DSNE005 というメッセージが表示されます。
EXECUTION IS INTERRUPTED, ENTER C TO CANCEL, OR ANY OTHER REPLY TO RESUME THE subcommand SUBCOMMAND。Cを入力すると、現在のサブコマンドがキャンセルされ、現在の Db2 接続が終了します。新しい接続が確立され、別のDSNプロンプトが表示されます。 ATTENTION 以外の他の応答は、 中断された時点から現行サブコマンドを続行させます。
DSN セッションが CLIST から開始されているか、あるいは CLIST が DSN の下で実行 している場合は、メッセージ DSNE005 を受け取るために CLIST に CONTROL PROMPT を 指定する必要があります。
- DSN セッション中にコマンドの処理が終わると、 入力の要求がなされます。 セッションが終了するまで、このサイクルが続きます。
- セッションを終了させるには、以下のいずれかのアクションを実行します。
- END サブコマンドを出す。 これで制御が TSO に渡されます。
- ATTENTION を押し、もう一度 ATTENTION キーを押してメッセージに応答する。
- DSN コマンドをもう一度出す。 これで古いセッションが終了し、新しいセッションが開始されます。
DSN 返送コード処理：DSN セッションの終了時に、セッション内の任意の DSN サブコマンド、または RUN サブコマンドを使用して実行された任意のプログラムによって使用された最高値がレジスタ 15 に格納されます。 ランタイム環境では、この値を戻りコードとしてフォーマットすることがあります。 しかし、この値は DSN によるものではありません。
TSO および DB2I を使用したトラステッド・コンテキストの確立: DB2I は、ISPF サービスを 使用して TSO のもとで稼働します。 DB2I 機能は、SPUFIやDCLGENなどのツールや、 Db2 プログラムの準備、計画とパッケージのバインドなどのタスクのための ISPF フロントエンドを提供します。 DB2I のデフォルト・パネルに「AS USER」フィールドがあります。 「AS USER」フィールドを使用して、トラステッド接続に関連した現行セッションに使用する許可名を指定します。 トラステッド接続は、TSO ログオン ID が、トラステッド・コンテキストに対して定義されている システム許可 ID およびジョブ名と一致する場合に確立されます。 「AS USER」フィールドは、DB2I への入力では常にブランクです。 「AS USER」フィールドに値を入力すると、その値は、DSN (TSO) コマンドの ASUSER オプションを使用して、 すべての TSO アタッチ (DSN) 呼び出しに渡されます。
モニター用アタッチメント機能 ：モニターなどの長時間実行されるプログラムには、 Db2 TSOアタッチメント機能ではなく、CAFやRRSAFのようなプログラマブルなアタッチメント機能を使用してください。 TSO 接続機能は、長時間実行プログラムで使用するようには設計されていません。 そのタイプのプログラムに対して TSO 接続機能を使用すると、ストレージまたはリカバリーで問題が発生する可能性があります。
例 DSN
- 例: 複数回の再試行を設定して DSN セッションを開始する
- 次のコマンドは、DSN セッションを開始します。 Db2 への接続に失敗した場合、30秒間隔で最大5回まで再試行が行われます。
DSN SYSTEM (DB2) RETRY (5) - 例: DSN セッションを開始し、プログラムを実行し、DSN セッションを終了する
- 次の例は、DSN セッションを開始し、プログラムを実行し、DSN セッションを終了するためのコマンドを示しています。
TSO prompt : READY USER enters: DSN SYS(SSTR) DSN prompt : DSN USER enters: RUN PROGRAM(MYPROG) DSN prompt : DSN USER enters: END TSO prompt : READY