Hitachi

OpenTP1 Version 7 分散トランザクション処理機能 TP1/Server Base Enterprise Option プログラム作成の手引


CBLEESCD('MSGSKIP ')【XTC限定】

〈このページの構成〉

名称

滞留メッセージのスキップ

形式

PROCEDURE DIVISIONの指定

CALL 'CBLEESCD' USING 一意名1 一意名2

DATA DIVISIONの指定

01 一意名1.
  02 データ名A  PIC X(8) VALUE 'MSGSKIP '.
  02 データ名B  PIC X(5).
  02 FILLER     PIC X(3).
  02 データ名Z  PIC S9(9) COMP VALUE ZERO.
01 一意名2.
  02 データ名C  PIC 9(9) COMP VALUE ZERO.
  02 データ名D  PIC X(4) VALUE '    '.
  02 データ名E  PIC X(1) VALUE 'A'.
  02 データ名F  PIC X(32).

機能

入力キュー(ITQ)に滞留しているメッセージを読み出し済みとして入力キューから破棄します。

指定したサービス名に対応する入力キューのメッセージを読み出し済みとします。スキップ要求は,該当サービスの処理キューが引き出し禁止状態,かつ該当サービスのトランザクションが動作していない場合に受け付けられます。

UAPで値を設定するデータ領域

●データ名A

サービスの要求を示す要求コードを「VALUE 'MSGSKIP△'」と設定します。

●データ名Z

0を設定します。

●データ名C

0を設定します。

●データ名D

VALUE '△△△△'を設定します。

●データ名E

次の値を設定します。

VALUE 'A'

入力キューに滞留しているすべてのメッセージを読み出し済みにします。

●データ名F

サービス名を,31バイト以内のアスキー文字列で設定します。文字列の最後には空白を設定してください。この空白は文字列の長さに数えません。

TP1/EEから値が返されるデータ領域

●データ名B

ステータスコードが,5けたの数字で返されます。

ステータスコード

ステータスコード

意味

00000

正常に終了しました。

00001

TP1/EEの環境下にありません。

00004

UOCから発行しているため,この機能は使用できません。

00005

オフラインバッチプロセスから発行しているため,この機能は使用できません。

00801

データ名に設定した値が間違っています。要求コード(データ名A)が間違っている場合も含みます。

00802

データ名Fに設定したサービス名は,定義されていません。

00803

リソースが不足しました。

00804

発行条件が不正です(プロセス関連定義のxtc_useオペランドにNを指定してこの関数を発行)。

00881

この関数を発行できる状態ではありません。

00899

システムエラーが起こりました。

注意事項

スキップの対象となるメッセージがない場合は,正常扱いになります。