DSNU CLIST コマンド構文
DSNU CLIST コマンドは、TSO コマンド・プロセッサーから、また は「DB2I Utilities (DB2I ユーティリティー)」パネルから実行することができます。
構文
>>-+---+--DSNU--UTILITY(utility-name)---------------------------> '-%-' >--INDSN(data-set-name-+---------------+-)----------------------> '-(member-name)-' .-CONTROL--(--NONE--)---------------. .-DB2I--(--NO--)--. >--+-----------------------------------+--+-----------------+---> | .-:--------------. | '-DB2I--(--YES--)-' | V | | '-CONTROL--(----control-option-+--)-' >--+------------------------+-----------------------------------> '-DISCDSN(data-set-name)-' >--+----------------------------------------------------+-------> '-COPYDSN(data-set-name)-+-------------------------+-' '-COPYDSN2(data-set-name)-' >--+-----------------------------------------------------+------> '-RCPYDSN1(data-set-name)-+-------------------------+-' '-RCPYDSN2(data-set-name)-' >--+-----------------------+------------------------------------> '-RECDSN(data-set-name)-' .-EDIT--(--NO--)------. >--+-------------------------------+--+---------------------+---> '-PUNCHDSN--(--data-set-name--)-' '-EDIT--(--+-SPF-+--)-' '-TSO-' .-RESTART--(--NO--)----------. >--+----------------------------+-------------------------------> '-RESTART--(--+-CURRENT-+--)-' +-PHASE---+ '-PREVIEW-' .-SUBMIT--(--NO--)---------. >--+--------------------------+---------------------------------> '-SUBMIT--(--+-YES----+--)-' '-PROMPT-' .-SYSTEM--(--DSN--)----------------. >--+----------------------------------+--+-----------------+----> '-SYSTEM--(--+-subsystem-name-+--)-' '-UID(utility-id)-' '-group-attach---' .-UNIT--(--SYSDA--)-----. >--+-----------------------+--+-----------------+---------------> '-UNIT--(--unit-name--)-' '-VOLUME(vol-ser)-' >--+--------------------+-------------------------------------->< '-LIB(data-set-name)-'
DSNU CLIST のオプションの説明
以下の説明の中で示す括弧は必要です。 構文にエラーがあったり、パラメーター値を省略した場合、パラメーターの正しい スペルおよび省略した値を入力するように、TSO からプロンプトが出されます。
- %
- DSNU がコマンド・プロシージャー・ライブラリーのメンバーであることを示しています。 このパラメーターの指定はオプションですが、指定した方がパフォーマンスは向上します。
- UTILITY (utility-name)
- 実行するユーティリティーを指定します。
オンライン・ユーティリティーと、各ユーティリティーに関連付けられた制御ファイル名のリストについては、表 1を参照してください。
- INDSN(data-set-name (member-name))
- ユーティリティー・ステートメントと制御ステートメントの入っているデータ・セットを指定します。
2 バイト文字セット・データが入っているデータ・セットは指定しないでください。
- (data-set-name)
- データ・セットの名前を指定します。 データ・セット名を指定しない場合は、デフォルトのコマンド・プロシージャーからデータ・セット名 を入力するようプロンプトが出されます。
- (member-name)
- メンバー名を指定します。 データ・セットが区分の場合には、メンバー名を指定する必要があります。
- CONTROL(control-option: …)
- CLIST コマンドの実行をトレースするかどうかを指定します。
- NONE
- トレースを省略します。
- control-option
- 以下のオプションを 1 つ以上、リストします。
リスト中の項目はコロン (:) で区切ります。
オプション名を短縮する場合は、その最初の文字だけを指定します。
- LIST
- シンボリック置換の後、かつコマンド実行前の TSO コマンドを表示します。
- CONLIST
- シンボリック置換の後、かつコマンド実行前の CLIST コマンドを表示します。
- SYMLIST
- シンボリック置換をスキャンする前のすべての実行可能ステートメント (TSO コマンド および CLIST ステートメント) を表示します。
- NONE
- オプション NOLIST、NOCONLIST、および NOSYMLIST を持つ CONTROL ステートメントを生成します。
- DB2I
- DSNU CLIST コマンドが呼び出される環境を示します。
- (NO)
- DSNU CLIST コマンドが DB2I 環境から呼び出されないことを示します。
- (YES)
- DSNU CLIST コマンドが DB2I 環境から呼び出されることを示します。 DB2I(YES) を指定した CLIST コマンドを実行できるのはユーティリティー・パネルのみです。
- DISCDSN(data-set-name)
- LOAD および REORG が DISCARD データ・セットに使用するカタログ式データ・セットの 名前。LOAD の場合、このデータ・セットはロードされないレコードを保持します。REORG の場合は、 再ロードされないレコードを保持します。
- COPYDSN(data-set-name)
- Db2® ユーティリティーがターゲット (出力) データ・セット として使用するカタログ式データ・セットの名前。この情報を指定しない場合は、CLIST コマンドはこの情報を入力するようプロンプトを出します。 このキーワードは LOAD および SHRLEVEL NONE を伴う REORG の場合はオプションであり、COPY、MERGECOPY、 および SHRLEVEL REFERENCE または CHANGE を指定した REORG の場合は必要です。
- COPYDSN2 (data-set-name)
- Db2 ユーティリティーがバックアップ・コピーのターゲット (出力) データ・セット として使用するカタログ式データ・セットの名前。このキーワードは、COPY、MERGECOPY、LOAD、および REORG の場合はオプションです。
- RCPYDSN1 (data-set-name)
- Db2 ユーティリティーがリモート・サイト 1 次コピーの ターゲット (出力) データ・セットとして使用するカタログ式データ・セットの名前。このキーワードは、COPY、LOAD、および REORG の場合はオプションです。
- RCPYDSN2 (data-set-name)
- Db2 ユーティリティーがリモート・サイトのバックアップ・コピーのターゲット (出力) データ・セット として使用するカタログ式データ・セットの名前。このキーワードは、COPY、LOAD、および REORG の場合はオプションです。
- RECDSN(data-set-name)
- LOAD が入力に使用する、あるいは REORG TABLESPACE または UNLOAD が アンロード・データ・セットとして使用するカタログ式データ・セットの名前。 この情報を指定しない場合は、CLIST コマンドはこの情報を入力するようプロンプトを出します。 このキーワードは、LOAD および REORG TABLESPACE の場合のみ必要です。
- PUNCHDSN(data-set-name)
- UNLOAD EXTERNAL または DISCARD 用に生成された LOAD ユーティリティー制御ステートメントを 保持するために、REORG または UNLOAD が使用するカタログ式データ・セットの名前。
- EDIT
- CLIST コマンドが生成した一時ファイルを編集するために、
エディターを呼び出すかどうかを指定します。
- (NO)
- エディターを呼び出しません。
- (SPF)
- ISPF エディターを呼び出します。
- (TSO)
- TSO エディターを呼び出します。
- RESTART
- このジョブが現行ユーティリティー・ジョブを再始動するかどうか、再始動
する場合はどのポイントから行うかを指定します。
- (NO)
- ユーティリティーが新規のジョブであり、再始動ジョブではないことを示し ます。ユーティリティー ID (UID) は、ユーティリティー・ジョブ・ステップ ごとに固有のものでなければなりません。
- (CURRENT)
- ユーティリティーを最新のコミット・ポイントで再始動します。
- (PHASE)
- ユーティリティーを現在停止しているフェーズの最初で再始動します。 現在停止しているフェーズは、DISPLAY UTILITY コマンドを出せば判別できます。
- (PREVIEW)
- ユーティリティーを PREVIEW モードで再始動し ます。PREVIEW モードでは、ユーティリティーはすべてのユーティリティー制御ステートメントの 構文エラーを検査しますが、通常のユーティリティーの実行は行われません。
- SUBMIT
- 生成された JCL をサブミットして処理するかどうかを指定します。
- (NO)
- JCL データ・セットの処理をサブミットしません。
- (YES)
- TSO SUBMIT コマンドを使用することにより、JCL データ・セットをバックグラウンド・プロセスにサブミットします。
- (PROMPT)
- データ・セットを処理した後、JCL データ・セットのバッチ処理を サブミットするかどうかを指定するようにプロンプトが出されます。CLIST コマンド を TSO バッチ環境で実行している場合は、PROMPT は使用できません。
- SYSTEM(subsystem-name)
- Db2 サブシステムまたはグループ接続名を指定します。デフォルト値 は DSN です。
- UID(utility-id)
- このユーティリティー・ジョブの Db2 内での
ユニーク ID を指定します。そのユーティリティーを再始動させる場合を除き、
まだ終了していない停止状態のユーティリティーの ID を再使用しないでください。
同じユーティリティー ID を使用して別のユーティリティーが呼び出された
場合、Db2 は SYSUTIL ディレクトリー表に保管されている情報を用いて、
元の停止しているユーティリティーの再始動を試行します。
デフォルト値 は tso-userid.control-file-name です。ここで、各ユーティリティーの control-file-name は、 下の表にリストされているとおりです。
表 1. それぞれのユーティリティーごとの制御ファイル名 ユーティリティー control-file-name CHECK INDEX DSNUCHI CHECK DATA DSNUCHD CHECK LOB DSNUCHL COPY DSNUCOP DIAGNOSE DSNUDIA LOAD DSNULOA MERGECOPY DSNUMER MODIFY DSNUMOD QUIESCE DSNUQUI REBUILD INDEX DSNUREB RECOVER DSNUREC REORG INDEX DSNURGI REORG LOB DSNURGL REORG TABLESPACE DSNURGT REPAIR DSNUREP REPORT DSNURPT RUNSTATS DSNURUN STOSPACE DSNUSTO UNLOAD DSNUUNL - UNIT(unit-name)
- 新規の一時データ・セットまたは永続データ・セットを収容する装置の、
装置アドレス、総称装置タイプ、またはユーザー割り当てのグループ名を割り当て
ます。CLIST コマンドが JCL を生成する場合は、生成された DD ステートメントの UNIT 文節の
後に unit-name が入ります。
デフォルト値は SYSDA です。
- VOLUME(vol-ser)
- 新規の一時データ・セットまたは永続データ・セットが常駐する、 ボリュームの通し番号を割り当てます。CLIST コマンドが JCL を生成する場合は、 生成された DD ステートメントの VOL=SER 文節の後に vol-ser が入り ます。VOLUME を省略した場合は、生成された DD ステートメントから VOL=SER 文節が省略されます。
- LIB (data-set-name)
- Db2 サブシステム・ライブラリーのデータ・セット名を指定します。指定した値は、 DSNUPROC JCL プロシージャーが起動されるときに LIB パラメーター値として使用されます。
