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"を指定し,次に示す文を使用します。
使用する文 |
処理 |
---|---|
SEND文 |
ディスプレイに画面データを送信し,応答の完了を待たないで非同期にプログラムを続行する。
|
RECEIVE文 |
NO REPLY指定のないSEND文で受信したデータを受け取る。 |
TRANSCEIVE文 |
ディスプレイに画面データを送信し,受信した画面データを受け取る。 |
DISABLE文 |
ディスプレイに出力された画面データを消去する。 |
-
NO REPLY指定のないSEND文とRECEIVE文との間でSEND文またはTRANSCEIVE文を実行した場合,最後のSEND文またはTRANSCEIVE文が有効となります。
(3) 画面の表示モード
SEND文またはTRANSCEIVE文では,ドロー(パネル定義)機能で画面(パネル)定義時に指定した表示モードで画面データを表示します。ただし,開かれていない画面データの送受信先に対してSEND文またはTRANSCEIVE文を初めて実行する場合,上書き(WRITE)モードを指定してはなりません。
ドロー(パネル定義)機能で,画面(パネル)定義時にこのシステムに任せる指定をした場合,次の規則に従って画面データが表示されます。
-
初めての送受信要求で指定した物理マップ名と異なるときは,書き換え(ERASE)モードで表示される。
-
現在の送受信要求で指定した物理マップ名が直前の送受信要求で指定した物理マップ名と同じときは,上書き(WRITE)モードで表示される。
(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) 送受信先の設定方法
画面機能では,送受信先を指定することで,ネットワーク上に接続されたディスプレイに画面データを送受信できます。送受信先の指定方法について,次に示します。
(a) 送受信先の決定のしかた
画面データの送受信先は,通信記述項でのSYMBOLIC TERMINAL句の指定の有無と,環境変数の指定の有無によって次のように決定されます。
- 注※
-
マニュアル「画面・帳票サポートシステム XMAP3 Server」を参照してください。
(b) 環境変数による送受信先の設定
送受信先を設定するための環境変数には次の2種類があります。