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 パラメーター値として使用されます。