DSN1SDMP 制御ステートメントのサンプル

以下の制御ステートメントのサンプルを、独自の DSN1SDMP 制御ステートメントを作成するためのモデルとして使用できます。

例 1: DSN1SDMP 用の JCL を作成する

この例は、DSN1SDMP ジョブ 用のスケルトン JCL を示します。

図 1. DSN1SDMP 用のスケルトン JCL
//DSN1J018 JOB 'IFC SD',CLASS=A,
//         MSGLEVEL=(1,1),USER=SYSADM,PASSWORD=SYSADM,REGION=1024K
//**********************************************************************
//*
//*       THIS IS A SKELETON OF THE JCL USED TO RUN DSN1SDMP.
//*       YOU MUST INSERT SDMPIN DD.
//*
//**********************************************************************
//IFCSD    EXEC PGM=IKJEFT01,DYNAMNBR=20,COND=(4,LT)
//STEPLIB  DD DISP=SHR,DSN=prefix.SDSNLOAD
//SYSPRINT DD SYSOUT=*
//SYSTSPRT DD SYSOUT=*
//SDMPPRNT DD SYSOUT=*
//SDMPTRAC DD DISP=(NEW,CATLG,CATLG),DSN=IFCSD.TRACE,
//            UNIT=SYSDA,SPACE=(8192,(100,100)),DCB=(DSORG=PS,
//            LRECL=32756,RECFM=VB,BLKSIZE=32760)
//SDMPIN   DD *
//**********************************************************************
//*
//*       INSERT SDMPIN DD HERE.  IT MUST BEGIN WITH A VALID
//*       START TRACE COMMAND (WITHOUT THE SUBSYSTEM RECOGNITION CHAR)
//*
//**********************************************************************
 
                   (VALID SDMPIN GOES HERE)
 
/*
//**********************************************************************
//SYSUDUMP DD SYSOUT=*
//SYSTSIN  DD *
 DSN SYSTEM(DSN)
 RUN PROG(DSN1SDMP) PLAN(DSNEDCL)
 END
//*

例 2: -904 SQL CODE でエージェントを異常終了および再試行する

この例 は、Db2® がパフォーマンス・トレース (これは 文字 A で指定されています) を開始し、IFCID 53、58 をアクティブにすることを指定しています。IFCID オプションで指定されたこれらの IFCID のみを開始するには、 トレース・クラス 30-32 を使用します。 この例ではトレース・クラス 32 が指定されています。IFCID 53 と 58 が開始され、 それらが SELECT 基準と一致しているかどうかが検査されます。

SELECT オプションは、トレース・レコードのデータに対する追加の基準を示しています。 この例では、P4,00 が現行レコード・ポインターを製品セクションに位置付けています。GE, 04,X'0005' は、トレースされる IFCID が IFCID 53 または 58 であること、および (START TRACE コマンドを介して自動的に生成される) IFCID4 ではないことを指定します。 P4,08 は、現行レコード・ポインターを、IFCID 53 または 58 の データ・セクション 1 に位置付けます。次に、10 進オフセット 74 で、SQL コード X''FFFFFC78'' についての 直接比較が行われます。

トレース・レコードが、START TRACE および SELECT キーワードの選択基準に 合格すると、DSN1SDMP は ACTION キーワードで指定されたアクションを実行します。この 例では、ジョブは理由コード 00E60188 で異常終了し、再試行されます。このアクションは、FOR オプションで示されているように、一度だけ行われ ます。FOR(1) がデフォルトのため、明示的に指定する必要はありません。

図 2. -904 SQL コードでエージェントを異常終了および再試行するジョブの例
//SDMPIN   DD *
 START TRACE=A CLASS(32) IFCID(53,58) DEST(OPX)
 FOR(1)
 AFTER(1)
 ACTION(ABENDRET(00E60188))
 SELECT
 * Position to the product section
 P4,00
 * Ensure QWHSIID = 58 or 53 (not IFCID 4)
 GE,04,X'0005'
 * Position to the data section 1
 P4,08
 * Compare SQLCODE in QW0058SQ or QW0053SQ
 DR,74,X'FFFFFC78'
/*

例 3: RMID 20 で異常終了および再試行する

この例は、Db2 がパフォーマンス・トレース (これは文字 P で指定されています) を開始し、クラス 3 および 8 のすべての IFCID をアクティブにすることを指定しています。トレース出力は、DEST オプションで示されているように、最初のフリー OPn スロットを使用する汎用宛先に記録されます。TDATA (TRA) オプションでは、CPU ヘッダーをそれぞれのトレース・ レコードの製品セクションの中に入れる指定を行っています。

SELECT オプションは、トレース・レコードのデータに対する追加の基準を示しています。 この例では、SELECT オプションは、現行レコード・ポインターをレコードの先頭に 位置している 4 バイトのフィールドに位置付けることを最初に指定しています。 次に、現行レコード・ポインターの位置にある 2 バイト・フィールドに示されているバイト数だけ、 現行レコード・ポインターを進めています。 次に、このユーティリティーは、現行レコード・ポインターからの 4 バイトのデータを、値 X'0025' と 直接比較します。

トレース・レコードが、START TRACE および SELECT キーワードの選択基準に 合格すると、DSN1SDMP は ACTION キーワードで指定されたアクションを実行します。 この例では、ジョブを異常終了させ、エージェントを再試行します。

図 3. RMID 20 で異常終了および再試行するジョブの例
//*       ABEND AND RETRY AN AGENT WHEN EVENT ID X'0025'
//*       (AGENT ALLOCATION) IS RECORDED BY RMID 20 (SERVICE
//*       CONTROLLER).
//*
//SDMPIN   DD *
*  ENSURE ONLY THE TRACE HEADER IS APPENDED WITH THE STANDARD HEADER
*  VIA THE TDATA KEYWORD ON START TRACE
 START TRACE=P CLASS(3,8) RMID(20) DEST(OPX) TDATA(TRA)
*  ABEND AND RETRY THE AGENT WITH THE DEFAULT ABEND CODE (00E60100)
 ACTION(ABENDRET)
*  SPECIFY THE SELECT CRITERIA FOR RMID.EID
 SELECT
*  OFFSET TO THE STANDARD HEADER
 P4,00
*  ADD LENGTH OF STANDARD HEADER TO GET TO TRACE HEADER
 LN,00
*  LOOK FOR EID 37 AT OFFSET 4 IN THE TRACE HEADER
 DR,04,X'0025'
/*

例 4: SQLCODE -811 RMID16 IFCID 5 でダンプを生成する

この例は、Db2 が パフォーマンス・トレース (これは文字 P で指定されています) を開始し、 クラス 3 のすべての IFCID をアクティブにすることを指定しています。トレース 出力は、システム管理機能 (SMF) に記録されます。TDATA (COR,TRA) オプションは、トレース・ヘッダーと CPU ヘッダーをそれぞれのトレース・ レコードの製品セクションの中に入れる指定を行っています。

SELECT オプションは、トレース・レコードのデータに対する追加の基準を示しています。 この例では、SELECT オプションは、現行レコード・ポインターをレコードの先頭に 位置している 4 バイトのフィールドに位置付けることを最初に指定しています。 次に、このユーティリティーは、現行レコード・ポインターからの 2 バイトのデータを、値 X'0116003A' と 直接比較します。その後、現行レコード・ポインターは、現行レコードの先頭から 8 バイト後に 位置している 4 バイトのフィールドに移動します。 次に、このユーティリティーは、現行レコード・ポインターからの 74 バイトのデータを、値 X'FFFFFCD5' と 直接比較します。

トレース・レコードが、START TRACE および SELECT キーワードの選択基準に 合格すると、DSN1SDMP は ACTION キーワードで指定されたアクションを実行します。 この例では、ジョブは理由コード 00E60188 で異常終了し、エージェントを再試行します。 このアクションは、FOR オプションで示されているように、一度だけ行われ ます。FOR(1) がデフォルトのため、明示的に指定する必要はありません。 AFTER(1) は、このアクションは、トレース・ポイントに達してはじめて実行することを 示しています。AFTER(1) もデフォルトです。

図 4. SQL コード -811 RMID16 IFCID でダンプを生成するジョブの例
//SDMPIN   DD *
 START TRACE=P CLASS(3) RMID(22) DEST(SMF) TDATA(COR,TRA)
 AFTER(1)
 FOR(1)
 SELECT
* POSITION TO HEADERS (QWHS IS ALWAYS FIRST)
  P4,00
* CHECK QWHS 01, FOR RMID 16, IFCID 58
  DR,02,X'0116003A'
* POSITION TO SECOND SECTION (1ST DATA SECTION)
  P4,08
* COMPARE SQLCODE FOR 811
  DR,74,X'FFFFFCD5'
 ACTION(ABENDRET(00E60188))
/*

例 5: 2 番目のトレースを開始する

この例の ジョブは、IFC 196 レコードでトレースを開始します。IFC 196 レコードは、ロック・タイムアウトが発生すると書き込まれます。 この例では、ロック・タイムアウトが起こると、ACTION(STTRACE) オプションで示している ように、DSN1SDMP は 2 番目のトレースを開始します。 この 2 番目のトレースは、COMMAND START TRACE(ACCTG) オプションで示しているように、 アカウンティング・トレースです。 このトレースには、FILTER(ACE) オプションで示しているように、タイムアウトになったエージェントに 関連した ACE 専用のレコードを含んでいます。 対象となるアカウンティング・レコードが検出された場合は、DSN1SDMP はダンプを生成します。

図 5. 2 番目のトレースを開始するジョブ
//SDMPIN   DD   *                                            
* START ONLY IFCID 196, TIMEOUT                              
 START TRACE=P CLASS(32) IFCID(196) DEST(SMF)                
 AFTER(1)                                                    
* ACTION = START ACCOUNTING TRACE                            
 ACTION(STTRACE)                                             
* FILTER ON JUST 196 RECORDS...                              
 SELECT                                                      
 P4,00                                                       
 DR,04,X'00C4'                                               
* WHEN ACCOUNTING IS CUT, ABEND                              
 ACTION2(ABENDRET(00E60188))                                 
* START THE ACCOUNTING TRACE FILTER ON THE ACE OF THE AGENT  
* THAT TIMED OUT                                             
 COMMAND                                                     
 START TRACE(ACCTG) CLASS(32) IFCID(3) DEST(SMF)             
* Filter can be for ACE or EB                                
 FILTER(ACE)                                                 
 /*