RECEIVE − メッセージの受信（データ操作言語）

DATA DIVISION（通信記述項）の指定

CD  通信記述名
    FOR  ｛INPUT|I-O｝
   〔STATUS  KEY  IS  データ名1〕
   〔SYMBOLIC  TERMINAL  IS  データ名2〕
   〔MESSAGE  DATE  IS  データ名3〕
   〔MESSAGE  TIME  IS  データ名4〕
   〔SYNCHRONOUS  MODE  IS ｛SYNC|ASYNC|データ名6｝〕
   〔WAITING  TIME  IS  データ名11〕.

DATA DIVISION（データ記述項）の指定

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

PROCEDURE DIVISION（通信文）の指定

RECEIVE  通信記述名
   〔FIRST〕 SEGMENT
       INTO  一意名1.

●FOR句

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

INPUT

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

I-O

問い合わせメッセージまたは同期型メッセージの受信

●SYMBOLIC TERMINAL句

非同期型のメッセージ（中間セグメントまたは最終セグメント）の受信，または，同期型のメッセージの受信の場合，論理端末名称を設定したデータ項目を設定します。データ名2にメッセージ入力元の論理端末名称を設定します。論理端末名称は最大8バイトの長さです。8バイトに満たない名称を設定する場合は，後ろを空白で埋めてください。

非同期型のメッセージ（中間セグメントまたは最終セグメント）の受信の場合，先頭セグメントの受信時に返された論理端末名称を設定してください。

非同期型のメッセージ（先頭セグメント）の受信処理終了後，SYMBOLIC TERMINAL句にはOpenTP1から値が返されます。

●SYNCHRONOUS MODE句

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

SYNC

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

ASYNC

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

データ名6

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

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

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

省略した場合は，ASYNC（非同期型のメッセージの受信）が設定されます。

●WAITING TIME句

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

データ名11

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

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

注意事項

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

●データ名B

MCFで使用する領域です。

●FIRST

先頭セグメントを受信する場合に設定します。

●STATUS KEY句

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

●SYMBOLIC TERMINAL句

非同期型のメッセージ（先頭セグメント）の受信の場合，入力元の論理端末名称を受け取りたいときに設定します。省略した場合は，論理端末名称を受け取れません。データ名2にメッセージ入力元の論理端末名称が返されます。論理端末名称は最大8バイトの長さです。8バイトに満たない場合，論理端末名称の後ろが空白で埋められます。

中間セグメントまたは最終セグメントを受信する場合は，ここで返された論理端末名称をSYMBOLIC TERMINAL句に設定します。

●MESSAGE DATE句

メッセージを受信した日付を受け取りたい場合に設定します。省略した場合は，メッセージを受信した日付を受け取れません。データ名3にメッセージを受信した日付がYYMMDD（YY：西暦下2けた　MM：月　DD：日）の形式で返されます。

●MESSAGE TIME句

メッセージを受信した時刻を受け取りたい場合に設定します。省略した場合は，メッセージを受信した時刻を受け取れません。データ名4にメッセージを受信した時刻がHHMMSS00（HH：時　MM：分　SS：秒　00は固定）の形式で返されます。

●データ名A

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

●データ名C

受信したセグメントの内容が返されます。一つのセグメントで32,763バイトまで受信できます。