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

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｝〕
  〔NEXT  TRANSACTION  IS データ名8〕
  〔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  ｛EMI｜一意名2｝〕
    〔BEFORE  RECEIVING  MESSAGE  INTO  一意名3〕.

●FOR句

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

OUTPUT

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

I-O

応答メッセージの送信，同期型のメッセージの送受信，または，同期型のメッセージの送信。

●SYMBOLIC TERMINAL句

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

●SYNCHRONOUS MODE句

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

SYNC

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

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

ASYNC

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

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

データ名6

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

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

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

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

●SWITCHING MODE句

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

NORMAL

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

PRIOR

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

データ名7

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

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

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

省略した場合，および非応答型のアプリケーションから応答メッセージを送信した場合は，NORMAL（一般の一方送信メッセージ）が設定されます。

●NEXT TRANSACTION句

＜継続問い合わせ応答形態の場合＞

次のメッセージ受信時に起動するアプリケーションを設定します。データ名8に起動するMHPのアプリケーション名を設定します。アプリケーション名は最大8バイトの長さです。8バイトに満たない名称を設定する場合は，後ろを空白で埋めてください。

NEXT TRANSACTION句を省略，または，データ名8に空白を設定した場合，実行中のアプリケーションを次のメッセージ受信時に再び起動します。

応答メッセージの送信を行うSEND（メッセージの送信）文を呼び出すサービスでDISABLE（継続問い合わせ応答の終了）文を呼び出す場合はNEXT TRANSACTION句を省略，または，データ名8に空白を設定してください。

継続問い合わせ応答を引き継いだエラーイベントで応答メッセージの送信を行うSEND（メッセージの送信）文を発行する際に，NEXT TRANSACTION句を省略，または，データ名8に空白を設定した場合，継続問い合わせ応答を終了します。ただし，継続問い合わせ応答を引き継いだエラーイベントで，SEND（アプリケーションプログラムの起動）文を発行して継続問い合わせ応答型のアプリケーションを起動し，起動先のアプリケーションで応答メッセージの送信を行うSEND（メッセージの送信）文を発行する際に，NEXT TRANSACTION句を省略，または，データ名8に空白を設定した場合，継続問い合わせ応答を終了しないで，SEND（アプリケーションプログラムの起動）文を発行したときに設定した継続問い合わせ応答型のアプリケーションを次のメッセージ受信時に再び起動します。

＜継続問い合わせ応答形態以外の場合＞

NEXT TRANSACTION句を省略，または，データ名8に空白を設定します。

●DETAIL MODE句

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

データ名10

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

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

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

省略した場合，および非応答型のアプリケーションから応答メッセージを送信した場合は，出力通番を付けません。

●WAITING TIME句

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

データ名11

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

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

注意事項

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

●データ名A

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

●データ名B

送信完了通知イベントを設定します。データ名Bとビットの設定値の関係を次に示します。

AIX，HP-UXの場合

送信完了通知イベントの要否は，データ名Bの領域の2⁴ビットに設定します。

領域の2⁴ビットに1を設定

送信完了通知イベントを通知させます。ただし，送信完了通知イベント処理用のMHPをMCFアプリケーション定義で指定していない場合は無効です。

領域の2⁴ビットに0を設定

送信完了通知イベントを通知させません。

Linux，Windowsの場合

送信完了通知イベントの要否は，データ名Bの領域の2¹²ビットに設定します。

領域の2¹²ビットに1を設定

送信完了通知イベントを通知させます。ただし，送信完了通知イベント処理用のMHPをMCFアプリケーション定義で指定していない場合は無効です。

領域の2¹²ビットに0を設定

送信完了通知イベントを通知させません。

●データ名C

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

●データ名E

MCFで使用する領域です。

●WITH句

送信するセグメントが単一の論理メッセージであることを設定します。

EMI

単一セグメントを設定します。

一意名2

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

'2'：EMI（単一セグメント）

指定を省略した場合は，EMI（単一セグメント）を設定します。

●BEFORE句

同期型のメッセージの送受信の場合に，セグメントを受信するデータ項目（一意名3）を設定します。一方送信メッセージの送信，応答メッセージの送信，または，同期型のメッセージの送信の場合，BEFORE句を省略します。

●STATUS KEY句

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

●データ名D

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

●データ名F

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