Hitachi

OpenTP1 Version 7 分散トランザクション処理機能 TP1/Financial Service Platform プログラム作成の手引


6.2.5 ユーザが値を設定する項目

〈この項の構成〉

(1) インタフェースエリア

表6‒14 インタフェースエリア情報

項番

項目

内容

更新可否

1

開始モード

データ連携支援の開始モード

EETRN_RKS_START_N:正常開始

EETRN_RKS_START_R:再開始

EETRN_RKS_START_F:強制開始

EETRN_RKS_START_S:再開始(読み出しUJ指定)

×

2

リターンコード

UOCの処理結果

詳細については,表6-15を参照してください。

3

ノード識別子

ユーザデータ(UJ)を出力したTP1/EEのノード識別子

×

4

ランID

ユーザデータ(UJ)を出力したTP1/EEのランID

×

5

中央処理通番

ユーザデータ(UJ)を出力したトランザクションの中央処理通番

×

6

サービス名長

ユーザデータ(UJ)を出力したトランザクションのサービス名の長さ

サービス名のないトランザクションのときは0が設定されます。

×

7

サービス名

\0終端あり)

ユーザデータ(UJ)を出力したトランザクションのサービス名

サービス名長が0のときは参照しないでください。

×

8

UJ数

UOCで渡すユーザデータ(UJ)数

UJ数の履歴情報レコードインデクスがあります。

×

9

先頭累積データ通番

トランザクション内の先頭の累積データ通番

先頭のUAP履歴情報がUJ以外(IJ/OJ)の場合は,先頭のユーザデータ(UJ)の累積データ通番を設定します。

×

10

最終累積データ通番

トランザクション内の最終の累積データ通番

PJがある最終のUAP履歴情報の累積データ通番を設定します。

×

11

反映サービス名長

実行している反映サービス名の長さ

×

12

反映サービス名

実行している反映サービス名

反映先指定UOCでは参照しないでください。

×

13

ユーザIFAエリアサイズ

ユーザIFAエリアのサイズ

×

14

ユーザIFAエリアポインタ

ユーザIFAエリアのポインタ

ユーザIFAエリアサイズが0の場合は,値を参照できません。

×

15

ユーザSATエリアサイズ

ユーザSATエリアのサイズ

×

16

ユーザSATエリアポインタ

ユーザSATエリアのポインタ

ユーザSATエリアサイズが0の場合は,値を参照できません。

×

17

接続ハンドル

接続ハンドル

trnrks_service定義の-nオプションおよび-iオプションで指定したリソースマネジャに対応した接続ハンドルです。

×

(凡例)

○:更新可

×:更新不可(無視する)

表6‒15 リターンコード情報

項番

項目

内容

1

EETRN_RKS_RTN_00

データ連携支援を続行します。

該当するトランザクションのUJをサービスへ登録し,次のトランザクションのUJの処理をします。

2

EETRN_RKS_RTN_08

データ連携支援を続行しますが,データ連携支援中断後の再開始時,このUAP履歴情報から引き渡します(再開始(読み出しUJ指定)指示)。

3

EETRN_RKS_RTN_12

データ連携支援を中断します。

再開始時,データ連携支援は中断したUAP履歴情報から渡します。

4

EETRN_RKS_RTN_16

データ連携支援を中断します。

再開始時,データ連携支援は中断したときのトランザクションの次のトランザクションのUAP履歴情報から引き渡します。

5

EETRN_RKS_RTN_100

データ連携支援を強制停止させます。

再開始時,データ連携支援は反映処理が未完了だったトランザクションのUAP履歴情報から引き渡します。

6

上記以外

(2) ユーザ引き継ぎエリア

データ連携支援中断後の再開始に備えて,UOCがデータ連携支援間で引き継ぎをするためのエリアで,UOCが自由に使用できる4,000バイトのエリアです。ユーザ引き継ぎエリアの情報は,UOCリターン後,ユーザデータ(UJ)の反映処理が完了したあとにPJ管理表に出力され,再開始時にUOCに渡し始めるユーザデータ(UJ)とユーザ引き継ぎエリアの内容の整合性を取れるようにします。EEFDPARMパラメタのCONTROL文のPJUPITVLオペランドを指定しているときは,反映先指定UOC処理を定義の指定値の回数分行い,該当するユーザデータ(UJ)の反映処理がすべて完了したあとに,PJ管理表に出力することで整合性を取ります。

データ連携支援は,ユーザ引き継ぎエリアの内容に関係なく,EEFDPARMパラメタのOUTPUT文のUSRAREAオペランドでYES指定があったときだけ,内容をPJ管理表に出力します。

PJ管理表の更新時にSQLエラーが発生した場合,以前にPJ管理表を更新した最新の引き継ぎ情報を,ユーザ引き継ぎエリアに設定します。

UOCがEETRN_RKS_RTN_12,EETRN_RKS_RTN_100でリターンした場合,ユーザ引き継ぎエリアの情報は再開始に引き継がれません。

(3) 反映サービス指定エリア

抽出したUJを反映処理するサービスを,ユーザが指定するエリアです。詳細を次の表に示します。

項番

項目

内容

更新可否

1

末尾指定

一括で引き渡す複数のUJのうち,末尾にあたるUJかどうかを指定する領域。

2

最大サービス数

ユーザが設定可能な最大サービス数。

trnrks_service定義の定義数。

×

3

サービス数

対象UJを反映処理するサービス数。

4

サービス名指定エリア

対象UJを反映処理するサービス名を指定するエリア。

(凡例)

○:更新可

×:更新不可(無視する)

(a) 反映処理するサービスの指定

反映サービス名はサービス名指定エリアに指定します。入力形式を図6-3に示します。配列の先頭から順に反映サービス名を書き込みます。反映サービス名が32バイト未満の場合,空き領域をスペースで埋めてください。

反映サービス名は配列先頭から最大サービス数分の行まで指定できます。

サービス数に,反映処理するサービス数を指定します。サービス名指定エリアで,配列先頭からサービス数分の行に設定した反映サービス名を,データ連携支援が読み込みます。サービス数分の行以降に設定した反映サービス名は読み込みません。

サービス数は最大サービス数まで指定できます。サービス数に0を指定した場合,データ連携支援は対象UJを反映処理しません。

次の表の指定をした場合データ連携支援を強制停止します。

表6‒16 データ連携支援が停止するエラー内容

項番

エラーの対象

エラー内容

1

サービス名指定エリア

サービス名の重複です。

2

trnrks_service定義で未定義のサービス名を指定しています。

3

サービス数

最大サービス数の超過です。

図6‒3 サービス名指定エリアへの反映サービス名設定方法

[図データ]

(b) 反映サービスへ一括で引き渡すUJの単位の指定

反映サービスへ一括で引き渡すUJの単位を指定します。反映サービスに一括で引き渡す複数のUJのうち,末尾にしたいUJの末尾指定にEETRN_RKS_BUNDLE_ENDを指定します。

末尾指定にEETRN_RKS_BUNDLE_ENDを指定したUJまでを一括で反映サービスへ引き渡します。このとき,EETRN_RKS_BUNDLE_ENDを指定したUJの反映サービスへUJを引き渡します。1トランザクション内末尾のUJは末尾指定の指定有無に関わらず,EETRN_RKS_BUNDLE_ENDを指定した場合と同様に扱います。

1トランザクション内すべてのUJの末尾指定が未指定の場合,1トランザクション内UJすべてを一括して,1トランザクション内末尾のUJの反映サービスへ引き渡します。

図6‒4 UJを一括して反映サービスへ引き渡すかの指定

[図データ]

(4) UOC間連携エリア

UOC間連携エリアは編集UOCでデータ編集処理,または反映UOCで反映処理するに当たって,反映先指定UOCと編集UOC/反映UOC間で引き継ぎをするためのエリアです。UOC間連携エリアの情報は反映先指定UOCリターン後,反映サービス名指定エリアで指定したサービスのUOCに引き継ぎます。UOC間連携エリアはユーザが自由に使用できます。

UOC間連携エリアは128バイトであり,初期化されていません。