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 |
システムエラーが起こりました。 |
注意事項
スキップの対象となるメッセージがない場合は,正常扱いになります。