Hitachi

OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 プロトコル TP1/NET/Secondary Logical Unit - TypeP2編


SEND − メッセージの送信(データ操作言語)

〈このページの構成〉

形式1(セグメントの内容を設定して送信する場合)

DATA DIVISION(通信記述項)の指定

CD   通信記述名
     FOR {OUTPUT|I-O}
   〔STATUS  KEY  IS  データ名1〕
   〔SYMBOLIC  TERMINAL  IS  データ名2〕
   〔SYNCHRONOUS  MODE  IS  {SYNC|ASYNC|データ名6}〕
   〔SWITCHING  MODE  IS  {NORMAL|PRIOR|データ名7}〕
   〔DETAIL  MODE  IS  データ名10〕
   〔WAITING  TIME  IS  データ名11〕.

DATA DIVISION(データ記述項)の指定

01  一意名1.
    02  データ名A   PIC 9(4)  COMP.
    02  データ名B   PIC X(2).
    02  データ名C   PIC X(n).
01  一意名3.
    02  データ名D   PIC 9(4)  COMP.
    02  データ名E   PIC X(2).
    02  データ名F   PIC X(n).

PROCEDURE DIVISION(通信文)の指定

SEND  通信記述名  FROM  一意名1
    〔WITH  {ESI|EMI|一意名2}〕
    〔BEFORE  RECEIVING  MESSAGE  INTO  一意名3〕.

形式2(セグメントの内容を設定しないで,メッセージの送信の終了だけ連絡する場合)

DATA DIVISION(通信記述項)の指定

CD   通信記述名
     FOR {OUTPUT|I-O}
   〔STATUS  KEY  IS  データ名1〕
   〔SYMBOLIC  TERMINAL  IS  データ名2〕
   〔SWITCHING  MODE  IS  {NORMAL|PRIOR|データ名7}〕.

PROCEDURE DIVISION(通信文)の指定

SEND 通信記述名 WITH  EMI.

機能

次に示すCALLインタフェースの機能を実現します。

同期型の問い合わせメッセージの送受信では,単一セグメントの論理メッセージだけを扱えます。

セグメントを送信する領域(一意名1で示す領域)の形式を次に示します。

[図データ]

同期型メッセージの送受信の場合,セグメントを受信する領域(一意名3で示す領域)も設定します。

セグメントを受信する領域の形式を次に示します。

[図データ]

UAPで値を設定する項目

●FOR句

次のどちらかの値を設定します。

OUTPUT

一方送信メッセージの送信

I-O

同期型のメッセージの送受信または一方送信メッセージの送信

注※

一方送信メッセージを送信する場合,UAP共通定義(mcfmuap -c)のnoansreplyオペランドにyesを指定してください。noを指定した場合,SEND文はステータスコード(72000)を返します。

●SYMBOLIC TERMINAL句

論理端末名称を設定したデータ項目を指定します。データ名2に出力先の論理端末名称を設定します。論理端末名称は最大8バイトの長さです。8バイトに満たない場合,論理端末名称の後ろを空白で埋めてください。

●SYNCHRONOUS MODE句

非同期型でメッセージを送信するか,同期型でメッセージを送信するかを設定します。

SYNC

同期型のメッセージの送受信

同期型のメッセージの送受信のとき設定します。

ASYNC

非同期型のメッセージの送信

一方送信メッセージの送信のとき設定します。

データ名6

次の値を設定したデータ項目

'0'または'△':非同期型のメッセージの送信

'1':同期型のメッセージの送受信

省略した場合は,ASYNC(非同期型メッセージの送信)が設定されます。

●SWITCHING MODE句

一方送信メッセージの場合に,一般か優先かを設定します。

NORMAL

一般の一方送信メッセージ

PRIOR

優先の一方送信メッセージ

データ名7

次の値を設定したデータ項目

'0'または'△':一般の一方送信メッセージ

'1':優先の一方送信メッセージ

省略した場合およびFOR句にI-Oを設定した場合は,NORMAL(一般の一方送信メッセージ)が設定されます。

●DETAIL MODE句

非同期型のメッセージの送信の場合に,出力通番を付けるかどうかを設定します。データ名10に次のどちらかを設定します。

データ名10

次の値を設定したデータ項目

'0'または'△':出力通番を付けます。

'1':出力通番を付けません。

省略した場合およびFOR句にI-Oを設定した場合は,出力通番を付けません。

●WAITING TIME句

SEND文を実行してから終了するまでの,最大時間を設定したデータ項目を設定します。同期型のメッセージの送受信の場合に設定します。

データ名11

監視時間の値をHHMMSS00(HH:時 MM:分 SS:秒 00は固定)の形式で設定したデータ項目を設定します。

省略した場合,またはデータ名11に'00000000'を設定した場合,MCFマネジャ定義のUAP共通定義で指定した同期型送受信監視時間(mcfmuap -t sndrcvtim)が設定されます。

注意事項

監視時間の精度は秒単位です。また,タイマ定義(mcfttim -t)のbtimオペランドで指定する時間の間隔でタイムアウトが発生したかどうかを監視しています。このため,設定した監視時間と実際にタイムアウトを検出する時間には秒単位の誤差が生じます。そのため,タイミングによっては,設定した監視時間よりも短い時間で起動することがあります。監視時間が小さくなるほど,誤差の影響を受けやすくなりますので,監視時間は3秒以上の値の設定を推奨します。

●データ名A

送信するセグメントの長さ+4を設定します。

●データ名B

MCFで使用する領域です。

●データ名C

送信するセグメントの内容を設定します。一つのセグメントで32000バイトまで送信できます。

●データ名E

MCFで使用する領域です。

●WITH句

送信するセグメントを設定します。非同期型のメッセージ送信の場合だけ設定します。

ESI

先頭セグメントまたは中間セグメントの送信

EMI

最終セグメントまたは単一セグメントの送信

一意名2

次の値を設定したデータ項目

'1':ESI(先頭セグメントまたは中間セグメント)

'2':EMI(最終セグメントまたは単一セグメント)

省略した場合は,EMI(最終セグメントまたは単一セグメントの送信)が設定されます。

なお,同期型のメッセージの送受信(SENDRECV)の場合は,EMI を指定するか,または指定を省略してください。

●BEFORE句

同期型のメッセージの送受信の場合に,セグメントを受信するデータ項目(一意名3)を設定します。一方送信メッセージの送信の場合,BEFORE句を省略します。

OpenTP1から値が返される項目

●STATUS KEY句

ステータスコードを受け取りたい場合に設定します。省略した場合は,ステータスコードを受け取れません。データ名1にステータスコードが返されます。

●データ名D

受信したセグメントの長さ+4が返されます。

●データ名F

受信したセグメントの内容が返されます。

ステータスコード

ステータスコード

意味

00000

正常に終了しました。

71002

メッセージキューへの出力処理中に障害が発生しました。

メッセージキューが閉塞されています。

メッセージキューが割り当てられていません。

データ名Aに32004バイトを超える値を設定しています。

MCFが終了処理中のため,メッセージの送信を受け付けられません。

71003

メッセージキューが満杯です。

71004

メッセージを格納するバッファをメモリ上に確保できませんでした。

71108

メッセージを送信しようとしましたが,送信先の管理テーブルが確保できませんでした。

プロセスのローカルメモリが不足しています。

72000

<MHPの実行でリターンした場合>

  • 先頭セグメントを受信するRECEIVE文を実行する前に,SEND文を実行しています。

  • FOR句にI-Oを設定した一方送信メッセージを送信するSEND文を実行していますが,UAP共通定義(mcfmuap -c)のnoansreplyオペランドにnoを指定しています。

<SPPの実行でリターンした場合>

  • トランザクションでないSPPの処理から,一方送信メッセージを送信するSEND文を実行しています。

  • SPPでは,応答メッセージを送信するSEND文を実行できません。

72001

SYMBOLIC TERMINAL句に設定した論理端末名称が間違っています。

SYMBOLIC TERMINAL句に設定した論理端末名称は,定義されていません。

SEND文を実行できない論理端末を設定しています。

72005

<WITH句にESIを設定またはWITH句に1を設定した一意名2を設定した場合>

データ名Aに0から4バイト,またはマイナス値を設定しています。

72013

データ名Fのサイズを超えるセグメントを受信しました。データ名Fのサイズを超えた部分は切り捨てられました。

32763バイトを超えるセグメントを受信しました。32763バイトを超えた部分は切り捨てられました。

72017

DETAIL MODE句に設定した値が間違っています。

72018

SWITCHING MODE句に設定した値が間違っています。

72020

SYNCHRONOUS MODE句に設定した値が間違っています。

72024

FOR句に設定した値が間違っています。

72026

WITH句に設定した値が間違っています。

72036

データ名Fのサイズが不足しています。5バイト以上の領域を確保してください。

72037

BEFORE句に設定した値が間違っています。

72041

<WITH句を省略またはWITH句にEMIを設定またはWITH句に2を設定した一意名2を設定した場合>

データ名Aに0から4バイト,またはマイナス値を設定しています。

<メッセージの送信の終了を連絡した場合>

WITH句にESIを設定またはWITH句に1を設定した一意名2を設定したSEND文を呼び出さないで,メッセージの送信の終了を連絡しています。

72045

継続問い合わせ応答型のアプリケーションはサポートしていません。

72047

継続問い合わせ応答型のアプリケーションはサポートしていません。

72073

非同期型のメッセージの送信処理で仕掛り中です。

73001

データ名11に60秒を加算した時間が経過しましたが,MCF通信プロセスからの応答がありません。

出力キューからのメッセージの読み込み時に障害が発生しました。

相手システムから否定応答(-RSP)を受信しました。

出力先の論理端末でMCF通信プロセスの内部障害が発生しました。

73005

データ名11に設定した時間が経過しましたが,論理端末からの応答がありません。

73008

論理端末が閉塞中,またはMCFが終了処理中に,SEND文を実行しました。

73010

入力または出力メッセージ編集UOCで障害が発生しました。

メッセージの読み込み時に障害が発生しました。

メッセージの編集エラーが発生しました。

73015

出力先の論理端末は,ほかのUAPで仕掛り中です。

73018

WAITING TIME句に設定した値が間違っています。

73020

出力先の論理端末は停止しています。

上記以外

プログラムの破壊などによる,予期しないエラーが発生しました。