13.2.1　帳票印刷命令（汎用関数）

(1)　XmapDrvCreateOpen関数

ドライバを起動し，仮想端末をオープンします。一つのAP（プロセス）内で同時にオープンできる端末数の上限は15個です。

データ有無コードには標準値「1F」が仮定されます。

形式

long APIENTRY XmapDrvCreateOpen(tname)
  unsigned char          *tname;                     /*仮想端末名*/

仮想端末名（tname）：仮想端末名を指定します。仮想端末名（8バイト以下，9バイト以降は切り捨て）には，最後にNULLで終わる文字列を指定してください。

リターンコード

1以上：正常終了（仮想端末識別子）

0：異常終了

(2)　XmapDrvClose関数

仮想端末をクローズし，ドライバを解放します。

形式

long APIENTRY XmapDrvClose(termid)
  long               termid;                           /*仮想端末識別子*/

仮想端末識別子（termid）：オープン要求関数の戻り値を指定します。

リターンコード

0：正常終了

−1：異常終了

(3)　XmapDrvSend関数

帳票を出力します。

形式

long APIENTRY XmapDrvSend(termid，pmpname，olog);
  long               termid;                      /* 仮想端末識別子 */
  unsigned char     *pmpname;                     /* 物理マップ名   */
  unsigned char     *olog;                        /* 出力論理マップ */

1. 仮想端末識別子（termid）：オープン要求関数の戻り値を指定します。

2. 物理マップ名（pmpname）：出力する物理マップ名を指定します。

3. 出力論理マップ（olog）：出力論理セグメントを指定します。

リターンコード

0：正常終了

−1：異常終了

(4)　XmapDrvGetError関数

直前に発行した関数のエラー詳細を取得します。

形式

long APIENTRY XmapDrvGetError( )

リターンコード

0以上：正常終了（詳細エラーコード）

(5)　XmapDrvCreate関数

ドライバを起動します。

形式

long APIENTRY XmapDrvCreate( )

リターンコード

1以上：正常終了（仮想端末識別子）

0：異常終了

(6)　XmapDrvOpen関数

仮想端末をオープンします。一つのAP（プロセス）内で同時にオープンできる端末数の上限は15個です。

形式

long APIENTRY XmapDrvOpen(termid，tname)
  long                termid;                    /* 仮想端末識別子 */
  unsigned char      *tname;                     /* 仮想端末名     */

1. 仮想端末識別子（termid）：XmapDrvCreateの戻り値を指定します。

2. 仮想端末名（tname）：仮想端末定義ファイルで指定した名称を指定します。

リターンコード

0：正常終了

−1：異常終了

(7)　XmapDrvSetDataCode関数

データの有無コードを設定します。この関数を発行しない場合，データ有無コードには標準値「1F」が仮定されます。

形式

long APIENTRY XmapDrvSetDataCode(termid，code)
  long                termid;                      /*仮想端末識別子*/
  unsigned char       code;                       /*データ有無コード*/

1. 仮想端末識別子（termid）：オープン要求関数の戻り値を指定します。

2. データ有無コード（code）：データ有無コード（(00)₁₆〜(1F)₁₆，または(FF)₁₆）を設定します。データ有無コードは，すべてのAPにかかわるコードのため，できるだけ標準値（(1F)₁₆）を利用することをお勧めします。

リターンコード

0：正常終了