Db2 オンライン・ユーティリティーを呼び出すための提供されている JCL プロシージャー (DSNUPROC)
Db2® オンライン・ユーティリティーを呼び出すための 1 つの方法は、提供されている JCL プロシージャー DSNUPROC を使用する方法です。 DSNUPROC は、オンライン・ユーティリティーを呼び出すための IBM® が提供する標準 JCL セットの 1 つです。 DSNUPROC を使用する利点は、作成する必要のある JCL の量が限定されることにあります。
DSNUPROC の実行
DSNUPROC プロシージャーを実行するには、以下のステートメントを格納する JCL データ・セットを作成し、サブミットする必要があります。
- DSNUPROC および必要なパラメーターを指定する EXEC ステートメント。 指定可能なパラメーターをDSNUPROC 構文にリストします。
- ユーティリティー制御ステートメント用の SYSIN DD ステートメント。
- SYSPRINT および UTPRINT 以外でジョブが必要とする他のデータ・セットの DD ステートメント。
DSNUPROC プロシージャーには、印刷出力用として SYSPRINT および UTPRINT DD ステートメント
があります。
各ユーティリティーが必要とするデータ・セットについては、オンライン・ユーティリティーが使用するデータ・セットを参照してください。
DSNUPROC は、オンライン・ユーティリティーを実行する適切な EXEC ステートメントを 作成する際に、ユーザーが与えるパラメーターを使用します。
DSNUPROC の実行例については、DSNUPROC リストのサンプルを参照してください。
DSNUPROC 構文
.-LIB=prefix.SSPGM----. .-,SIZE=OM----------. >>-DSNUPROC--+---------------------+--+-------------------+-----> '-LIB=DB2library-name-' '-,SIZE=region-size-' .-,SYSTEM=DSN------------. .-,UID=' '---------------. >--+------------------------+--+------------------------+-------> '-,SYSTEM=subsystem-name-' '-,UID=utility-qualifier-' .-,UTPROC=' '----------------------. >--+----------------------------------+------------------------>< '-,UTPROC=--+-'RESTART'----------+-' +-'RESTART(CURRENT)'-+ +-'RESTART(PHASE)'---+ '-'PREVIEW'----------'
DSNUPROC のオプションの説明
- LIB=
- Db2 サブシステム・ライブラリーのデータ・セット名を指定します。
デフォルト値 は prefix.SSPGM です。
- SIZE=
- ユーティリティー実行域の領域サイズを指定します。すなわち、この値は
このユーティリティー・ジョブに割り振られる仮想ストレージのバイト数を表しています。
デフォルト値は 0M です。
- SYSTEM=
- Db2 サブシステムまたはグループ接続名を指定します。
デフォルト値 は DSN です。
- UID=
- ユーティリティー・ジョブに固有の ID を指定します。名前の最大長は 16 文字です。
名前に特殊文字を組み込む場合は、
名前全体をアポストロフィで囲みます (例えば、'PETERS.JOB')。まだ終了はしていないが停止しているユーティリティーの ID は
再使用しないでください。
同じユーティリティー ID を使用して別のユーティリティーが呼び出された
場合、Db2 は SYSUTIL ディレクトリー表に保管されている情報を用いて、
元の停止しているユーティリティーの再始動を試行します。
デフォルトは空ストリングです。UID を指定しないか、または UID='' と指定すると、Db2 は user-id.job-name の形式のユーティリティー ID をユーティリティー・ジョブに割り当てます。user-id はユーザー ID です。 job-name は、DSNUPROC が実行される JCL 内でのジョブ名です。生成されるユーティリティー ID 全体の長さが 16 バイトより長くなる場合、ユーザー ID は 7 バイトに切り捨てられます。
- UTPROC=
- 再始動処理を制御します。デフォルトは空ストリングです。Db2 がデフォルトの再始動処理を実行できるようにする場合、デフォルトを使用します。オンライン・ユーティリティーの再始動を参照してください。
デフォルトの再始動動作をオーバーライドするには、以下の値のいずれかを指定します。
- 'RESTART'
- 最新のコミット・ポイントで再始動します。このオプションは、'RESTART(CURRENT)' と同じことを意味します。
- 'RESTART(CURRENT)'
- 最新のコミット・ポイントで再始動します。このオプションは、'RESTART' と同じことを意味します。
- 'RESTART(PHASE)'
- 最後に実行されたフェーズの先頭で再始動します。
- 'PREVIEW'
- プレビュー・モードで再始動する場合。プレビュー・モードでは、ユーティリティーはすべてのユーティリティー制御ステートメントの 構文エラーを検査しますが、通常のユーティリティーの実行は行われません。
DSNUPROC リストのサンプル
DSNUPROC を呼び出すために、以下の例のような JCL を使用できます。
//DSNUCOP JOB your-job-statement-parameters
// USER=userid,PASSWORD=password
//*ROUTE PRINT routing-information
//UTIL EXEC DSNUPROC,SYSTEM=DSN,UID=TEMP,UTPROC='
//SYSCOPY DD DSN=MYCOPIES.DSN8D11A.JAN1,DISP=(MOD,CATLG,CATLG),
// UNIT=SYSDA,SPACE=(CYL,(1,1))
//SYSIN DD *
COPY TABLESPACE DSN8D11A.DSN8S11D
FULL NO
SHRLEVEL CHANGE
/*
上記の JCL ジョブ (DSNUCOP) は以下の DSNUPROC プロシージャーを実行します。
//DSNUPROC PROC LIB='DSN!!0.SDSNLOAD',
// SYSTEM=DSN,
// SIZE=0K,UID='',UTPROC=''
//********************************************************************
//* PROCEDURE-NAME: DSNUPROC *
//* *
//* DESCRIPTIVE-NAME: UTILITY PROCEDURE *
//* *
//* FUNCTION: THIS PROCEDURE INVOKES THE ADMF UTILITIES IN THE *
//* BATCH ENVIRONMENT *
//* *
//* PROCEDURE-OWNER: UTILITY COMPONENT *
//* *
//* COMPONENT-INVOKED: ADMF UTILITIES (ENTRY POINT DSNUTILB). *
//* *
//* ENVIRONMENT: BATCH *
//* *
//* INPUT: *
//* PARAMETERS: *
//* LIB = THE DATA SET NAME OF THE DB2 PROGRAM LIBRARY. *
//* THE DEFAULT LIBRARY NAME IS PREFIX.SDSNLOAD, *
//* WITH PREFIX SET DURING INSTALLATION. *
//* SIZE = THE REGION SIZE OF THE UTILITIES EXECUTION AREA.*
//* THE DEFAULT REGION SIZE IS 2048K. *
//* SYSTEM = THE SUBSYSTEM NAME USED TO IDENTIFY THIS JOB *
//* TO DB2. THE DEFAULT IS "DSN". *
//* UID = THE IDENTIFIER WHICH WILL DEFINE THIS UTILITY *
//* JOB TO DB2. IF THE PARAMETER IS DEFAULTED OR *
//* SET TO A NULL STRING, THE UTILITY FUNCTION WILL *
//* USE ITS DEFAULT, USERID.JOBNAME. EACH UTILITY *
//* WHICH HAS STARTED AND IS NOT YET TERMINATED *
//* (MAY NOT BE RUNNING) MUST HAVE A UNIQUE UID. *
//* UTPROC = AN OPTIONAL INDICATOR USED TO DETERMINE WHETHER *
//* THE USER WANTS TO INITIALLY START THE REQUESTED*
//* UTILITY OR TO RESTART A PREVIOUS EXECUTION OF *
//* THE UTILITY. IF OMITTED, THE UTILITY WILL *
//* BE INITIALLY STARTED. OTHERWISE, THE UTILITY *
//* WILL BE RESTARTED BY ENTERING THE FOLLOWING *
//* VALUES: *
//* RESTART(PHASE) = RESTART THE UTILITY AT THE *
//* BEGINNING OF THE PHASE EXECUTED *
//* LAST. *
//* RESTART = RESTART THE UTILITY AT THE LAST *
//* OR CURRENT COMMIT POINT. *
//* *
//* OUTPUT: NONE. *
//* *
//* EXTERNAL-REFERENCES: NONE. *
//* *
//* CHANGE-ACTIVITY: *
//* *
//**********************************************************************
//DSNUPROC EXEC PGM=DSNUTILB,REGION=&SIZE,
// PARM='&SYSTEM,&UID,&UTPROC'
//STEPLIB DD DSN=&LIB,DISP=SHR
//**********************************************************************
//* *
//* THE FOLLOWING DEFINE THE UTILITIES' PRINT DATA SETS *
//* *
//**********************************************************************
//*
//SYSPRINT DD SYSOUT=*
//UTPRINT DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//*DSNUPROC PEND REMOVE * FOR USE AS INSTREAM PROCEDURE
