12.1.2　画面に対する入出力

(1)　画面の定義

通信節による画面機能を使用する場合，画面はXMAP3のドロー（パネル定義）機能を利用して定義します。ドロー（パネル定義）機能については，次に示すマニュアルを参照してください。

XMAP3 Version 4の場合

• マニュアル「画面・帳票サポートシステム XMAP3 プログラミングガイド 画面編」

• マニュアル「画面・帳票サポートシステム XMAP3 開発・実行ガイド」

XMAP3 Version 5の場合

• マニュアル「XMAP3 Version 5 画面・帳票サポートシステム XMAP3 開発ガイド」

• マニュアル「XMAP3 Version 5 画面・帳票サポートシステム XMAP3 プログラミングガイド」

• マニュアル「XMAP3 Version 5 画面・帳票サポートシステム XMAP3 実行ガイド」

(2)　使用する文

画面データを送受信したり画面を閉じたりするには，原始プログラム中のデータ部通信記述項のFOR句で"I-O WS"を指定し，次に示す文を使用します。

• NO REPLY指定のないSEND文とRECEIVE文との間でSEND文またはTRANSCEIVE文を実行した場合，最後のSEND文またはTRANSCEIVE文が有効となります。

(3)　画面の表示モード

画面データの表示モードには次の2種類のモードがあります。

• 書き換え（ERASE）モード：画面を消去して画面データを表示する。

• 上書き（WRITE）モード：画面を消去しないで画面データを表示する。

SEND文またはTRANSCEIVE文では，ドロー（パネル定義）機能で画面（パネル）定義時に指定した表示モードで画面データを表示します。ただし，開かれていない画面データの送受信先に対してSEND文またはTRANSCEIVE文を初めて実行する場合，上書き（WRITE）モードを指定してはなりません。

ドロー（パネル定義）機能で，画面（パネル）定義時にこのシステムに任せる指定をした場合，次の規則に従って画面データが表示されます。

• 初めての送受信要求で指定した物理マップ名と異なるときは，書き換え（ERASE）モードで表示される。

• 現在の送受信要求で指定した物理マップ名が直前の送受信要求で指定した物理マップ名と同じときは，上書き（WRITE）モードで表示される。

(4)　実行時のカーソルの位置づけ

プログラム実行時にカーソルの位置を変更するときは，原始プログラム中で論理マップとして展開したカーソルフィールドに値を設定します。

(5)　データ有無コード

データ有無コードとは，論理項目に値を設定しているかどうかを区別するためのコードで，1バイトのコードX'00'〜X'FF'で指定します。

データ有無コードには，原始プログラム中の通信記述項のDATA ABSENCE CODE句で指定したデータ名に設定した値が使われます。

DATA ABSENCE CODE句を指定したときは，プログラム中の通信記述項ごとの最初の通信文を実行する前に値を必ず設定しておく必要があります。データ名に値を設定しなかった場合の動作は保証しません。また，通信文の実行後に値を変更してはなりません。

(6)　実行状態を示すコード

続行できない異常な状態が通信文で発生すると，エラーメッセージが出力されます。通信記述項にSTATUS KEY句の指定があれば，通信文の実行状態を示す5けたのコードがこの句で指定したデータ名に設定され，処理が続行されます。

STATUS KEY句がないときに続行できないエラーが発生すると，プログラムは異常終了します。

STATUS KEY句のデータ名に設定されるコードについては，マニュアル「COBOL2002　言語　拡張仕様編」　「11.1.1　通信記述項（CD）（通信節による画面機能）」を参照してください。

(7)　送受信先の設定方法

画面機能では，送受信先を指定することで，ネットワーク上に接続されたディスプレイに画面データを送受信できます。送受信先の指定方法について，次に示します。

(8)　送受信間の物理マップ

ディスプレイに対して画面データを送受信する場合，SEND文（NO REPLY指定なし）の前に通信記述項のMAP NAME句のデータ名に物理マップ名を指定し，画面データを送受信します。RECEIVE文はその物理マップ名に対して画面データを受信するため，RECEIVE文で物理マップ名は指定しません。

複数の仮想端末に送信した画面データを受信するとき，それぞれの最後に送信したSEND文で指定した物理マップが，RECEIVE文の物理マップとなります。