Db2 オンライン・ユーティリティーを呼び出すための提供されている JCL プロシージャー (DSNUPROC)

Db2® オンライン・ユーティリティーを呼び出すための 1 つの方法は、提供されている JCL プロシージャー DSNUPROC を使用する方法です。 DSNUPROC は、オンライン・ユーティリティーを呼び出すための IBM® が提供する標準 JCL セットの 1 つです。 DSNUPROC を使用する利点は、作成する必要のある JCL の量が限定されることにあります。

インストール時に、この JCL プロシージャーをカスタマイズします (SYS1.PROCLIB 内)。

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 プロシージャーを実行します。

図 1. 提供される JCL プロシージャー 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