WebSphere Extended Deployment Compute Grid, Version 6.1.1
             オペレーティング・システム: AIX , HP-UX, Linux, Solaris, Windows,


エラー許容ステップ

エラー許容汎用バッチ・ステップは、1 入力、1 出力ストリーム、および 1 エラー・ストリームを処理します。このステップは、バッチ・ループの毎回の反復中に、バッチ・データ・ストリーム (BDS) 入力ストリームから単一のエントリーを読み取り、処理のためそれを BatchRecordProcessor に渡します。

始める前に

BatchRecordProcessor は、許容可能なエラーの場合、有効なデータ・オブジェクトまたはヌル値のいずれかを返します。戻り値がヌルの場合、inputStream から読み取られたレコードは、エラー・ストリームに記録され、ThresholdPolicy で invalidRecordEncountered メソッドが呼び出されます。しきい値ポリシーは、エラー許容しきい値に達したかどうかを判別します。しきい値に達している場合、STEP_CONTINUE_FORCE_CHECKPOINT_BEFORE_PROCESSING_CANCEL を返し、これは、チェックポイントを強制し、ジョブを再始動可能状態にします。達していない場合は、ジョブは通常通り続行されます。BatchRecordProcessor.processRecord から返されたデータが有効な場合、そのデータは、BDS Outputstream に渡されます。

このタスクについて

表 1. 必須プロパティー
プロパティー名 説明

threshold_policy

Java クラス名

com.ibm.websphere.batch.devframework.thresholdpolicies.ThresholdPolicy インターフェースを実装するクラス

BATCHRECORDPROCESSOR

Java クラス名

BatchRecordProcessor インターフェースを実装するクラス

表 2. オプションのプロパティー
プロパティー 説明

debug

true または false (デフォルトは false)

ステップに対するトレースおよびデバッグを使用可能にします。

EnablePerformanceMeasurement

true または false (デフォルトは false)

ステップ内でかかった時間を測定します。

プロシージャー

  1. インターフェース、com.ibm.websphere.batch.devframework.steps.technologyadapters.BatchRecordProcessor を実装し、ステップにビジネス・ロジックを提供します。ステップの xJCL では、インターフェースの実装に設定された値でプロパティー、BATCHRECORDPROCESSOR を宣言する必要があります。以下に例を示します。
    ...
    		<props>
    	<prop name="BATCHRECORDPROCESSOR" value="com.ibm.websphere.batch.samples.tests.steps.InfrastructureVerificationTest"/>
    </props>
    ...    
  2. インターフェース、com.ibm.websphere.batch.devframework.thresholdpolicies.ThresholdPolicy を実装し、ステップにしきい値ポリシーを提供します。また、com.ibm.websphere.batch.devframework.thresholdpolicies.PercentageBasedThresholdPolicy または com.ibm.websphere.batch.devframework.thresholdpolicies.RecordBasedThresholdPolicy などの製品実装を使用することもできます。 以下のコード・スニペットに示されているように、xJCL で使用する ThresholdPolicy を宣言します。
    ...  
    <props>		 		
    		 <prop name="threshold_policy" value="com.ibm.websphere.batch.devframework.thresholdpolicies.PercentageBasedThresholdPolicy"/>  
    </props>
    ...  
  3. BDS 入力ストリーム論理名を inputStream に、BDS 出力ストリーム論理名を outputStream に、エラーの BDS 出力ストリームを errorStream に設定します。論理名は、xJCL に宣言されます。以下に例を示します。
    <batch-data-streams>
       <bds>
    <logical-name>inputStream</logical-name>
    	<props>
            .... 
       </bds>
        <bds>
    <logical-name>outputStream</logical-name>
    	<props>
    	...
        </bds>
        <bds>
    	<logical-name>errorStream</logical-name>
    	<props>
    	...
         </bds>
    </batch-data-streams>	        
    
  4. パッケージ化に BatchPackager を使用し、アプリケーションの jobstepclass を com.ibm.websphere.batch.devframework.steps.technologyadapters.ThresholdBatchStep に設定する必要があります。 以下に例を示します。
    ejbname.1=IVTStep1
    jndiname.1=ejb/MyThresholdBatchStep
    jobstepclass.1=com.ibm.websphere.batch.devframework.steps.technologyadapters.ThresholdBatchStep



関連概念
バッチ・データ・ストリームのフレームワークとパターン
関連タスク
単純なバッチ・アプリケーションの開発
タスク・トピック    

ご利用条件 | フィードバック

最終更新: 2009/09/17 16時38分56秒EDT
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r1m1/index.jsp?topic=/com.ibm.websphere.gridmgr.doc/info/scheduler/tcgerrant.html