目次

Search

  1. はじめに
  2. Workflow Manager
  3. ワークフローとワークレット
  4. セッション
  5. セッション設定オブジェクト
  6. タスク
  7. ソース
  8. ターゲット
  9. 接続オブジェクト
  10. 検証
  11. ワークフローのスケジュール設定と実行
  12. メールの発信
  13. Workflow Monitor
  14. Workflow Monitorの詳細
  15. セッションとワークフローのログ
  16. セッションプロパティリファレンス
  17. ワークフロープロパティリファレンス

ワークフローベーシックガイド

ワークフローベーシックガイド

ソースノード

ソースノード

[ソース]ノードには、マッピングのソースと設定が表示されます。 特定のソースの設定項目を表示し設定するには、表示されたリストからソースを選択します。以下の設定項目を設定することができます。
  • Readers。
    統合サービスが各ソースインスタンスで使用するreaderが表示されます。 Workflow Managerでは、各ソースインスタンスごとに必要なreaderが指定されます。
  • 接続。
    ソース接続を表示します。 接続タイプおよび接続に使用する値を選択できます。また、接続オブジェクトの値を編集することもできます。
  • プロパティ。
    ソースとSource Qualifierのプロパティを表示します。 リレーショナルソースの場合は、Mapping Designerで設定したプロパティを上書きできます。
    ファイルソースの場合は、Source Analyzerで設定したプロパティを上書きできます。 また、ファイルソースに次のセッションプロパティを設定することもできます。
    ファイルソースオプションの設定項目
    説明
    ソースファイルディレクトリ
    このフィールドにはディレクトリ名を入力します。デフォルトで、統合サービスは、サービスのプロセス変数ディレクトリ$PMSourceFileDirでファイルソースを検索します。
    [Source Filename]フィールドにディレクトリとファイル名の両方を指定する場合は、このフィールドをクリアします。統合サービスはセッションの実行時に、このフィールドと[ソースファイル名]フィールドを連結します。
    また、セッションパラメータ$InputFile
    Name
    を使ってファイルディレクトリを指定することもできます。
    Source Filename
    ファイル名、またはファイル名とディレクトリを入力します。必要に応じて、このファイル名にセッションパラメータ$InputFile
    Name
    を指定することもできます。
    統合サービスはセッションの実行時に、このフィールドと[ソースファイルのディレクトリ]フィールドを連結します。たとえば[Source File Directory]フィールドに「C:\data\」と入力されている場合は、[Source Filename]フィールドに「filename.dat」と入力します。統合サービスはセッションを開始するときに「C:\data\filename.dat」を検索します。
    デフォルトでは、Workflow Managerはソース定義に設定されているファイル名を入力します。
    Source Filetype
    1つのファイルリストを使って複数のファイルソースを設定できます。
    ソースファイルにソースデータが含まれるか、または同じファイルプロパティを持つファイルのリストが含まれるかを指定します。ソースファイルにソースデータが含まれる場合には、[Direct]を選択します。ソースファイルにファイルのリストが含まれる場合には、[Indirect]を選択します。
    [Indirect]を選択した場合、セッションを開始すると統合サービスはファイルリストを検索し、リスト内の各ファイルを読み込みます。
    バッチモードでPowerExchange非リレーショナルソースからデータを抽出するセッションを設定するときに、ソースの以下のセッションプロパティを設定できます。
    属性名
    説明
    スキーマ名のオーバーライド
    ソースのPowerExchangeデータマップ内のスキーマ名をオーバーライドします。
    マップ名のオーバーライド
    ソースのPowerExchangeデータマップのデータマップ名をオーバーライドします。
    ファイル名
    ADABASアンロードソースタイプの場合、アンロードされたADABASデータベースのファイル名を指定します。
    ADABASアンロードソースタイプの場合は必須です。
    ADABASパスワード
    ADABASソースタイプ用のデータベースパスワード。
    ソースファイルのADABAS FDTがパスワードで保護されている場合、ADABAS FDTパスワードを入力します。
    PowerCenterはパスワードを暗号化し、ワークフロー用に生成したXMLファイルに暗号化されたパスワードを表示します。
    データベースIDのオーバーライド
    ADABASソースタイプとADABASアンロードソースタイプの場合、PowerExchangeデータマップ内のADABASデータベースIDをオーバーライドします。
    ファイルIDのオーバーライド
    ADABASソースタイプとADABASアンロードソースタイプの場合、PowerExchangeデータマップ内のADABASファイルIDをオーバーライドします。
    DB2サブシステムID
    DB2データマップソースタイプの場合、PowerExchangeデータマップ内のDB2サブシステムIDをオーバーライドします。
    DB2テーブル名
    DB2データマップソースタイプの場合、PowerExchangeデータマップ内のDB2テーブル名をオーバーライドします。
    アンロードファイル名
    DB2アンロードデータセットソースタイプの場合、PowerExchangeデータマップ内のDB2アンロードファイル名をオーバーライドします。
    Filter Overrides
    定義した特定の条件に基づいてPowerExchangeによって読み取られるソースデータをフィルタリングします。
    PWXPCは、フィルタ条件をSELECT SQL文のWHERE句に追加し、処理のためにSQL文をPowerExchangeに渡します。 PowerExchangeでNRDB SQLに対してサポートされている任意のフィルタ条件構文を使用できます。
    単一レコードのソースの場合は、次の構文を使用します。
    filter_condition
    例えば、TYPEという名前のカラムの値がAまたはDであるレコードを選択するには、以下のフィルタ条件を選択します。
    TYPE=‘A’ or TYPE=‘D’
    マルチレコードのソースの場合は、以下のいずれかの代替構文を使用します。
    filter_condition
    group_name1
    =
    filter
    ;
    group_name2
    =
    filter
    ;...
    group_name
    構文は、SQLクエリ条件をマルチレコードのソース定義内の特定のレコードに制限します。
    group_name
    構文を使用しない場合、SQLクエリ条件はマルチレコードのソース定義内のすべてのレコードに適用されます。
    例えば、USER1レコードおよびUSER2レコードを含むマルチレコードのソースで、IDカラムの値が「DBA」であるレコードのみを選択するには、以下のいずれかのSQLクエリ条件を指定します。
    USER1=ID=’DBA’;USER2=ID=’DBA’
    ID=’DBA’
    [フィルタオーバーライド]属性とフィルタリングWHERE句を含む[SQLクエリオーバーライド]属性の両方を指定すると、結果のSELECT文には、AND演算子を使用して[フィルタオーバーライド]フィルタ条件を[SQLクエリオーバーライド]フィルタ条件と関連付けるWHERE句が含まれます。以下に例を示します。
    SELECT * from
    schema
    .
    table
    WHERE
    Filter_Overrides_conditions
    AND
    SQL_Query_Override_conditions
    IMSアンロードファイル名
    IMSソースタイプ用のIMSデータベースのアンロードファイル名。ソースデータをIMSデータベースではなくバックアップファイルから読み取る場合は必須です。IMSアンロードファイルへの複数レコードの書き込みの場合、ソースとターゲットの両方に必要。
    IMS AMオーバーライド
    IMSソースタイプの場合、ソースのインポート済みデータ―マップのIMSアクセス方式を使用可能な他のアクセス方式でオーバーライドします。実行時に、セッションでこのオーバーライドアクセス方式を使用します。
    • DL/1 BATCHアクセス方式を指定したソースデータマップをインポートした場合は
      O
      と入力して、IMS ODBAアクセス方式でオーバーライドします。ODBAアクセスでは、
      IMS PSBNAMEオーバーライド
      属性および
      IMS PCBNAMEオーバーライド
      属性も指定する必要があります。
    • IMS ODBAアクセス方式を指定したソースデータマップをインポートした場合は
      D
      と入力して、DL/IアクセスまたはBMPアクセス指定するDL/1 BATCHアクセス方式でオーバーライドします。
      IMS PCBNUMBERオーバーライド
      属性も指定する必要があります。
    アクセス方式をオーバーライドしてセッションを実行する前に、新しいアクセス方式のPowerExchange設定タスクを完了していることを確認します。例えば、オーバーライドがDL/1 BATCHの場合は、DBMOVERメンバのLISTENER文およびNETPORT文を設定し、Netport JCLを設定する必要があります。オーバーライドがIMS ODBAの場合は、他の設定タスクを実行する必要があります。詳細については、
    『PowerExchangeナビゲータユーザーガイド』
    の「IMSデータマップ」を参照してください。
    IMS SSIDオーバーライド
    IMSソースタイプでは、ソースのIMS ODBAデータマップをインポートし、アクセス方式をオーバーライドしていない場合は、この属性を使用してセッションのデータマップのIMSサブシステムID(SSID)をオーバーライドします。
    IMS AMオーバーライド
    セッション属性でオーバーライドにODBAアクセスを指定した場合は、この値を入力する必要があります。ODBAアクセスにはSSIDが必須です。
    IMSアンロードファイルのソースがあるセッションの場合は、このオーバーライドを使用して、DBDライブラリを別のDBDライブラリに変更するためにDBMOVERメンバの別のIMSID文を参照します。オーバーライドを使用すると、IMSID文を編集または追加してPowerExchangeリスナを再起動せずにDBDライブラリを切り替えることができます。例えば、このオーバーライドを使用して、アンロードファイルに対してDBDライブラリに加えた変更をテストします。
    BMPを使用してIMSにアクセスするNetportジョブを使用する場合は、このオーバーライドとNetport JCLの%IMSID置換変数を一緒に使用し、IMS SSIDを指定してセッションに使用できます。このオーバーライドは置換変数を置き換えます。オーバーライドと置換変数を一緒に使用することで、同一のNetport JCLを使用して複数のIMS環境(開発環境、テスト環境、プロダクション環境など)にアクセスできます。
    DL/Iバッチを使用してIMSデータにアクセスしたり、IMSアンロードファイルにアクセスしたりする場合は、IMS SSIDは必要はありません。
    IMS PSBNAMEオーバーライド
    IMSソースタイプでは、ソースのIMS ODBAデータマップをインポートした場合にアクセス方式をオーバーライドしていないと、この値でデータマップのPSB名をオーバーライドします。
    [IMS AMオーバーライド]
    属性でオーバーライドにODBAアクセスを指定した場合は、この値を入力する必要があります。ODBAアクセスにはPSB名が必須です。
    DL/IバッチアクセスまたはBMPアクセスを使用し、このオーバーライドを指定する場合は、Netport JCLの
    PSB=%PSBNAME
    置換変数も指定する必要があります。オーバーライド値は、JCLの置換変数を置き換えます。
    Netport JCLの
    PSB=%PSBNAME
    ではなくPSB=%1置換変数を指定した場合は、セッションでNETPORT文のPSB名を使用します(指定した場合)。この場合、各PSBに個別のNETPORT文が必要です。DBMOVERメンバで10個のNETPORT文の制限を超えないようにするため、代わりにこのオーバーライドに%PSBNAME置換変数を使用します。
    IMSソースアンロードファイルにアクセスする際にPSB名は使用しません。
    IMS PCBNAMEオーバーライド
    IMSソースタイプでは、ソースのIMS ODBAデータマップをインポートした場合にアクセス方式をオーバーライドしていないと、この値でデータマップのPCB名をオーバーライドします。
    [IMS AMオーバーライド]
    属性でオーバーライドにODBAアクセスを指定した場合は、この値を入力する必要があります。ODBAアクセスにはPCB名が必須です。
    DL/Iバッチアクセス、BMPアクセス、またはIMSアンロードファイルへのアクセスにPCB名は使用しません。
    IMS PCBNUMBERオーバーライド
    IMSソースタイプでは、ソースのDL/1 BATCHデータマップをインポートした場合にアクセス方式をオーバーライドしていないと、この値でデータマップのPCB番号をオーバーライドします。
    [IMS AMオーバーライド]
    属性で、オーバーライドにDL/Iアクセスを指定した場合は、この値を入力する必要があります。DL/IアクセスまたはBMPアクセスにはPCB番号が必須です。
    IMS ODBAアクセスまたはIMSアンロードファイルへのアクセスにPCB番号は使用しません。
    ファイル名のオーバーライド
    VSAMファイルソースタイプとシーケンシャルファイルソースタイプの場合、PowerExchangeデータマップ内のデータセット名またはファイル名をオーバーライドします。
    完全なデータセット名またはファイル名を入力します。
    i5/OSの場合、形式は
    library_name
    /
    file_name
    です。
    [ファイルリストファイル]
    チェックボックスを選択した場合は、この属性にファイルリストファイルの名前を入力します。ファイルリストファイルは、ファイルのリストです。
    ファイルリストファイル
    VSAMファイルソースタイプとシーケンシャルファイルソースタイプの場合、ファイルのリストを含むファイルを指定します。
    [ファイル名のオーバーライド]
    フィールドにファイルリストファイルを入力した場合にのみ、この属性を選択します。
    SQLクエリーオーバーライド
    PowerExchangeに送信されたSQLクエリをオーバーライドします。
    PWXPCは、デフォルトのSQLクエリを無視し、入力されたSQL文のほうをPowerExchangeに渡して処理します。NRDB SQLに対してPowerExchangeでサポートされている任意のSQL文を入力できます。
    例えば、TYPEという名前のカラムの値がAまたはDであるレコードをテーブルUSERから選択するには、以下のSQLクエリオーバーライドを指定します。
    Select ID, NAME from USER where TYPE=‘A’ or TYPE=‘D’;
    マルチレコードのソースの場合は、次の構文を使用します。
    group_name1
    =
    sql_query_override1
    ;
    group_name2
    =
    sql_query_override2
    ;...
    例えば、USER1およびUSER2という名前の2つのレコードを含むマルチレコードのソースで、IDカラムの値がDBAであるレコードのみを選択するには、以下のSQLクエリオーバーライドを指定します。
    USER1=Select ID, NAME from USER1 where ID='DBA'; USER2=Select ID, NAME from USER2 where ID='DBA';
    [フィルタオーバーライド]属性とフィルタリングWHERE句を含む[SQLクエリオーバーライド]属性の両方を指定すると、結果のSELECT文には、AND演算子を使用して[フィルタオーバーライド]フィルタ条件を[SQLクエリオーバーライド]フィルタ条件と関連付けるWHERE句が含まれます。以下に例を示します。
    SELECT * from
    schema
    .
    table
    WHERE
    Filter_Overrides_conditions
    AND
    SQL_Query_Override_conditions
    PWXパーティション方式
    オフロードされたDB2アンロード、VSAMファイル、およびシーケンシャルファイルのソースタイプの場合、次のいずれかのパーティション方式を指定します。
    • 単一接続
      。PowerExchangeにより、データソースに対して単一の接続が作成されます。最初のパーティション用に指定するオーバーライドはいずれも、すべてのパーティションに使用されます。このオプションでは、最初のパーティションのオーバーライドとは異なるオーバーライドを他のパーティションに指定した場合、セッションは失敗し、エラーメッセージが表示されます。
    • オーバーライドドリブン
      。指定したオーバーライドがすべてのパーティションで同一の場合、PowerExchangeはデータソースに対して単一の接続を作成します。すべてのパーティションにわたってオーバーライドが同一でない場合、PowerExchangeは複数の接続を作成します。
    N 個ブロックした後にフラッシュ
    複数レコードソースの場合、どのブロックもフラッシュすることなく発生できるブロックフラッシュの最大数を指定します。
    大量の複数レコードソースの場合、デフォルトでは、バッファが完全にいっぱいになるか、またはファイルの終わりに到達したときにのみ、PWXPCがデータのブロックをフラッシュします。一部のレコードタイプのデータ量が他のレコードタイプほど多くない場合は、フラッシュが頻繁に起きないこともあります。この場合、そのレコードタイプは長い期間ターゲットにデータがなかった可能性があるので、ライタ側でフラッシュをブロックします。
    すべてのレコードタイプのバッファを定期的にフラッシュするには、この
    N 個ブロックした後にフラッシュ
    セッションプロパティを定義します。このプロパティは、フラッシュされているいずれか1つのブロックを除き、すべてのレコードタイプにわたって起きるブロックフラッシュの最大数を指定します。値に0を指定するとこの機能は無効になり、ブロックがいっぱいになったときにのみフラッシュが発生します。
    このプロパティの有効な値は、-1~100000です。
    デフォルト値「-1」は、次のように機能します。
    • シーケンスフィールドを使用しないすべての複数レコードソースの場合、この機能を無効にしてブロックがいっぱいになったときにのみフラッシュするN 個ブロックした後にフラッシュ = 0と同じ処理を行います。
    • シーケンスフィールドを使用するすべての複数レコードソースの場合、N 個ブロックした後にフラッシュ = 7 *(ソース内のレコードタイプ数)を使用します。
    バッチモードでPowerExchangeリレーショナルソースからデータを抽出するセッションを設定するときに、ソースの以下のセッションプロパティを設定できます。
    属性名
    説明
    スキーマ名のオーバーライド
    ソーススキーマ名をオーバーライドします。
    マップ名のオーバーライド
    ソーステーブル名をオーバーライドします。
    DB2サブシステムID
    PowerExchangeデータマップ内のDB2インスタンス名をオーバーライドします。
    イメージコピーデータセット
    DB2イメージコピーソースの場合、イメージコピーデータセット名を指定します。イメージコピーデータセット名を指定しない場合で、なおかつテーブルがパーティション化されていないテーブルスペース内に存在する場合は、TYPE=FULLでSHRLEVEL=REFERENECEの最新のイメージコピーデータセットが使用されます。テーブルがパーティション化されているテーブルスペース内に存在する場合は、
    [イメージコピーデータセット]
    属性を指定する必要があります。
    一貫性チェックを無効にする
    DB2イメージコピーソースに対して選択しない場合は、PowerExchangeによってカタログが読み取られ、指定したイメージコピーデータセットのDSNにSHRLEVEL=REFERENCEおよびTYPE=FULLが定義されていること、およびこのデータセットが指定したテーブルのイメージコピーであることが確認されます。DSNにこれらのプロパティが定義されていない場合、セッションは失敗します。
    選択した場合は、SHRLEVELおよびTYPEの値に関係なく、PowerExchangeによってイメージコピーデータセットが読み取られます。イメージコピーのオブジェクトIDがDB2カタログのオブジェクトIDと一致することは確認されません。
    Filter Overrides
    指定した条件に基づいてPowerExchangeによって読み取られるソースデータをフィルタリングします。
    PWXPCは、指定されたフィルタ条件をSELECT SQL文のWHERE句に追加し、処理のためにSQL文をPowerExchangeに渡します。PowerExchangeでNRDB SQLに対してサポートされている任意のフィルタ条件構文を使用できます。詳細については、『
    PowerExchangeリファレンスマニュアル
    』を参照してください。
    例えば、TYPEという名前のカラムの値がAまたはDであるレコードを選択するには、以下のフィルタ条件を指定します。
    TYPE=‘A’ or TYPE=‘D’
    [フィルタオーバーライド]属性とフィルタリングWHERE句を含む[SQLクエリオーバーライド]属性の両方を指定すると、結果のSELECT文には、AND演算子を使用して[フィルタオーバーライド]フィルタ条件を[SQLクエリオーバーライド]フィルタ条件と関連付けるWHERE句が含まれます。以下に例を示します。
    SELECT * from
    schema
    .
    table
    WHERE
    Filter_Overrides_conditions
    AND
    SQL_Query_Override_conditions
    SQLクエリーオーバーライド
    PowerExchangeに送信されたSQLクエリをオーバーライドします。
    DB2 for z/OSデータソースの場合は、PowerExchangeによってFOR FETCH ONLYがSQL SELECT文に自動的に追加されます。
    [SQLクエリーオーバーライド]
    属性(
    [プロパティ]
    領域内)にFOR FETCH ONLYを含めると、この式がSELECT文に2回含まれることになります。この場合、PowerExchangeはエラーを発行します。
    [フィルタオーバーライド]属性とフィルタリングWHERE句を含む[SQLクエリオーバーライド]属性の両方を指定すると、結果のSELECT文には、AND演算子を使用して[フィルタオーバーライド]フィルタ条件を[SQLクエリオーバーライド]フィルタ条件と関連付けるWHERE句が含まれます。以下に例を示します。
    SELECT * from
    schema
    .
    table
    WHERE
    Filter_Overrides_conditions
    AND
    SQL_Query_Override_conditions
    抽出マップを使用してCDCソースのソース定義を作成し、ソースからデータを抽出するようにセッションを設定するときに、ソースの以下のセッションプロパティを設定できます。
    属性名
    説明
    スキーマ名のオーバーライド
    PowerExchange抽出マップ内のスキーマ名をオーバーライドします。
    マップ名のオーバーライド
    PowerExchange抽出マップ名をオーバーライドします。
    ADABASパスワード
    ADABASソースタイプ用のソースファイルのADABASパスワード。
    ソースファイルのAdabas FDTがパスワードで保護されている場合、Adabas FDTパスワードを入力します。
    PowerCenterはパスワードを暗号化し、ワークフロー用に生成したXMLファイルに暗号化されたパスワードを表示します。
    データベースIDのオーバーライド
    ADABASソースタイプの場合、PowerExchangeデータマップ内のADABASデータベースIDをオーバーライドします。
    ファイルIDのオーバーライド
    ADABASソースタイプの場合、PowerExchangeデータマップ内のADABASファイルIDをオーバーライドします。
    ライブラリ/ファイルオーバーライド
    DB2i5OSリアルタイムソースタイプの場合、抽出マップ内のライブラリ名とファイル名をオーバーライドします。
    ライブラリ名とファイル名を、省略せずに次の形式で指定します。
    library
    /
    file
    もう1つの方法としては、ライブラリ名にアスタリスク(*)を指定して、複数のライブラリからファイル名が同じファイルすべてについての変更を取得します。
    この属性は、アプリケーション接続の
    [ライブラリ/ファイルオーバーライド]
    属性をオーバーライドします。
    ソーススキーマのオーバーライド
    ORACLEソースタイプの場合、ソーススキーマ名をオーバーライドします。
    Filter Overrides
    指定した条件に基づいてPowerExchangeによって読み取られるソースデータをフィルタリングします。
    PWXPCは、指定されたフィルタ条件をSELECT SQL文のWHERE句に追加し、処理のためにSQL文をPowerExchangeに渡します。PowerExchangeでNRDB SQLに対してサポートされている任意のフィルタ条件構文を使用できます。詳細については、『
    PowerExchangeリファレンスマニュアル
    』を参照してください。
    例えば、TYPEという名前のカラムの値がAまたはDであるレコードを選択するには、以下のフィルタ条件を指定します。
    TYPE=‘A’ or TYPE=‘D’
    カラムのIDとACCOUNTが変更された変更レコードを選択するには、以下のフィルタ条件を指定してDTL__CIカラムを使用することができます。
    DTL__CI_ID=‘Y’ and DTL__CI_ACCOUNT=’Y’
    [フィルタオーバーライド]属性とフィルタリングWHERE句を含む[SQLクエリオーバーライド]属性の両方を指定すると、結果のSELECT文には、AND演算子を使用して[フィルタオーバーライド]フィルタ条件を[SQLクエリオーバーライド]フィルタ条件と関連付けるWHERE句が含まれます。以下に例を示します。
    SELECT * from
    schema
    .
    table
    WHERE
    Filter_Overrides_conditions
    AND
    SQL_Query_Override_conditions
    SQLクエリーオーバーライド
    PowerExchangeに送信されたSQLクエリをオーバーライドします。
    [フィルタオーバーライド]属性とフィルタリングWHERE句を含む[SQLクエリオーバーライド]属性の両方を指定すると、結果のSELECT文には、AND演算子を使用して[フィルタオーバーライド]フィルタ条件を[SQLクエリオーバーライド]フィルタ条件と関連付けるWHERE句が含まれます。以下に例を示します。
    SELECT * from
    schema
    .
    table
    WHERE
    Filter_Overrides_conditions
    AND
    SQL_Query_Override_conditions
    リレーショナルデータベースからメタデータをインポートしてCDCソースのソース定義を作成し、ソースからデータを抽出するようにセッションを設定するときに、ソースの以下のセッションプロパティを設定できます。
    属性名
    説明
    抽出マップ名
    必須。CDCソースのPowerExchange抽出マップ名。リレーショナルソースの抽出マップ名を指定する必要があります。
    ライブラリ/ファイルオーバーライド
    オプション。DB2i5OSリアルタイムソースタイプの場合、抽出マップ内のライブラリ名とファイル名をオーバーライドします。
    ライブラリ名とファイル名を、省略せずに次の形式で指定します。
    library
    /
    file
    もう1つの方法としては、ライブラリ名にアスタリスク(*)を指定して、複数のライブラリからファイル名が同じファイルすべてについての変更を取得します。
    この属性は、アプリケーション接続の
    [ライブラリ/ファイルオーバーライド]
    の値をオーバーライドします。
    ソーススキーマのオーバーライド
    オプション。Oracle変更ソースタイプとリアルタイムソースタイプの場合、ソーススキーマ名をオーバーライドします。