サンプル Java クラス・ユーザー出口のコンパイル (UNIX および Linux®)

CDC Replication Engine for InfoSphere® DataStage® には、ご使用の環境に合わせて拡張または変更できるサンプル・カスタム・データ・フォーマットが用意されています。

このタスクについて

サンプルは samples.jarにあります。これは、 CDC Replication Engine for InfoSphere DataStage インストール・ディレクトリーの samples ディレクトリーにあります。 このファイルには、以下のサンプルが入っています。

  • SampleDataStageDataFormat.java —IBM® IBM®DataStageファイル リーダーおよび列インポーター ステージに適したデータをフォーマットします。 このサンプルは com.datamirror.ts.userexit.sample にあります。

次のことに注意してください。

  • サンプル・カスタム・データ形式を変更せずに実行するには、 管理コンソールで、コンパイル済みカスタム・データ形式の完全修飾パスを指定する必要があります。 例えば、com.datamirror.ts.target.publication.userexit.sample.UserExitSampleなどです。
  • コンパイル済みサンプル・カスタム・データ形式は、 ts.jar ファイルにあります。このファイルは、 CDC Replication Engine for InfoSphere DataStage インストール・ディレクトリーの lib ディレクトリーにあります。 ts.jar ファイルにあるコンパイル済みカスタム・データ形式には、*.class 拡張子が付いています。
  • サンプル・カスタム・データ形式を変更する場合は、ソース・コードに変更を加えた後でカスタム・データ形式をコンパイルしなければなりません。
  • カスタム・データ形式は、クラスパスにも必要です。
  • Java クラスが変更または変更された場合、変更されたユーザー出口を取得するには、 CDC Replication Engine for InfoSphere DataStage インスタンスを再始動する必要があります。

手順

  1. CDC Replicationを停止します。
  2. samples.jar ファイルを IBM Data Replication インストール・ディレクトリー内の lib ディレクトリーに unzip します。 jar ファイルの unzip 時は、ディレクトリー構造を必ず維持してください。
    jar ファイルの unzip 後、以下のようなディレクトリー構造になります。
    <installation_directory>/lib/com/datamirror/ts/target/publication/userexit/sample
  3. サンプル・カスタム・データ形式に変更を加えます。
  4. 変更したカスタム・データ形式をコンパイルします。 例えば、 UserExitSample.javaをコンパイルする場合は、コマンド・ウィンドウを開き、 lib フォルダーにナビゲートして、以下のコマンドを発行します。
    javac  -classpath ts.jar:. com/datamirror/ts/target/publication/userexit/sample
    /UserExitSample.java

    このコマンドが正常に実行されると、画面には何も出力されません。

    前提条件: このコマンドを実行するには、システムに Java™ JDK が必要です。
    注: ユーザー出口は Java 8 でコンパイルすることをお勧めします。 Java 7 でのユーザー出口のコンパイルのサポートは非推奨になっており、将来削除される可能性があります。 Java 6 以下でのユーザー出口のコンパイルはサポートされません。
  5. コマンドを正常に実行した後、以下のディレクトリーにナビゲートし、 UserExitSample.class ファイルを作成したことを確認します。
    <installation_directory>/lib/com/datamirror/ts/target/publication/userexit/sample
  6. CDC Replicationを開始します。
  7. カスタム・データ・フォーマットを構成するための最後のステップは、 管理コンソールUserExitSample への完全修飾パスを指定することです。 次に例を示します。
    com.datamirror.ts.target.publication.userexit.sample.UserExitSample
    注: .class 拡張子は指定しないでください。
  8. さまざまなエンジン用の UNIX または Linux オペレーティング・システムのユーザー出口資料のコンパイル・コマンドは、以下のコマンドを使用します。
    javac -classpath ts.jar:.
            com/datamirror/ts/target/publication/userexit/sample/UserExitSample.java
    これを内部的に検証するには、前述のコマンドに含まれる追加の jar を使用するか、「*」を使用して現行 lib ディレクトリー内のすべてのファイルを使用するか、以下のいずれかを使用します。
    javac -classpath ts.jar:user-exit-xxxx.jar
            com/datamirror/ts/target/publication/userexit/sample/UserExitSample.java
    それとも
    javac -cp "*"
            com/datamirror/ts/target/publication/userexit/sample/SampleDataStageDataFormat.java

次の作業

CDC Replicationには、サンプル Java クラス・ユーザー出口も用意されています。 これらのサンプルは、ご使用の環境に合わせて拡張または変更することができます。
注: Java クラスが変更または変更された場合、変更されたユーザー出口を取得するには、 CDC Replication インスタンスを再始動する必要があります。
注: 実稼働環境でサンプル・カスタム・データ形式を使用する予定の場合は、デプロイする前にサンプルをテストする必要があります。 IBM は、変更またはカスタマイズされたカスタム・データ・フォーマットによって生じる悪影響に対して責任を負いません。