DSN1SDMP 制御ステートメントのサンプル
以下の制御ステートメントのサンプルを、独自の DSN1SDMP 制御ステートメントを作成するためのモデルとして使用できます。
例 1: DSN1SDMP 用の JCL を作成する
この例は、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) がデフォルトのため、明示的に指定する必要はありません。
//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 キーワードで指定されたアクションを実行します。 この例では、ジョブを異常終了させ、エージェントを再試行します。
//* 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) もデフォルトです。
//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 はダンプを生成します。
//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)
/*