6.1.1　XMAP3での書式の出力

〈この項の構成〉

(1)　書式用APで使用するAPIの種類

XMAP3には，書式用APの開発に使用するプログラミング言語ごとにAPIを提供しています。APIの種類を次の図に示します。

図6‒1　書式用APで使用するAPIの種類

COBOLの命令文です。レコード名，または一意名のCHARACTER TYPE句で行単位の表示属性を指定します。WRITE文で書き出します。Windows/UNIXで共通の文法です。
XMAP3が提供しているC言語用の関数です。jstqlctp関数を使用して行単位の表示属性を指定します。Windows/UNIXで共通の文法です。
XMAP3が提供しているWindows専用のC言語またはC++用の汎用関数です。XmapFrmSet×××関数を使用して，行単位の表示属性を指定します。
XMAP3が提供している書式オーバレイ印刷用のコマンドです。行データをユーザ責任でテキストファイルに出力して，このコマンドの入力とします。Windows/UNIXで提供コマンドが異なります。

書式用APで使用する要求とAPIの関係を次の表に示します。また，書式用APとXMAP3との処理の概要を次の図に示します。

表6‒1　書式用APで使用する要求とAPIの関係
要求	COBOLの命令文	C言語	汎用関数
オープン	OPEN文	jstqlopn関数	XmapFrmCreateOpen
行の出力	WRITE文	jstqldat関数	XmapFrmSetPage
印刷要求	WRITE文（PAGE指定）またはCLOSE文	jstqllpt関数	XmapFrmSetLine
クローズ	CLOSE文	jstqlcls関数	XmapFrmClose

図6‒2　書式用APとXMAP3との処理の概要

注

行データを出力する場合，行データおよびページデータの上限値によってデータを出力できないことがあります。

ページデータの上限値を超えるデータがAPから指定された場合，XMAP3が改ページを行い，上限値を超えるデータは次のページに出力されます。

書式オーバレイ使用時の注意事項について説明します。書式オーバレイを使用するときには，次の点に注意してください。