15.1.9 サーバ環境定義ファイル(X3WEBSRV)
サーバ環境定義ファイル(X3WEBSRV)とは,XMAP3 TP1/Web連携機能の場合で,環境設定ファイルの格納先や,実行時にWebクライアント側で必要なデータファイルの格納先を定義するファイルです。XMAP3 Cosminexus連携機能の場合は不要です。
サーバ環境定義ファイルは,ユーザプログラムの実行時,XMAP3 TP1/Web連携機能ライブラリから参照されます。
サーバ環境定義ファイルは,XMAP3インストールフォルダ\Web for TP1\ETC\フォルダに格納されています。サーバ環境定義ファイルをカスタマイズするには,テキストエディタで直接編集してください。ただし,設定方法を誤るなど,ファイル内容が不正になると画面表示や帳票印刷が正しく実行されなくなるため十分に注意してください。
ユーザプログラム単位で,異なるサーバ環境定義ファイルを使用できます。この場合,ユーザプログラムごとにファイル名を変更してください。また,ファイル名を変更した場合は,ユーザプログラムでXMAP3 TP1/Web連携機能ライブラリのオープン命令(OPEN要求)で,変更したファイル名を指定するようにします。
- 〈この項の構成〉
(1) 環境設定ファイルパス(EtcPath="パス名")
XMAP3 TP1/Web連携機能のシステム構成では,Webクライアント側プログラムの実行時に必要な環境設定ファイルは,すべてWebサーバ内に格納しておく必要があります。これらの環境設定ファイルは,実行時に適宜Webクライアント側にダウンロードされるため,環境設定ファイルの格納先を示すフォルダを環境設定ファイルパスに指定します。
環境設定ファイルパスに指定するフォルダは,「http://」または「https://」で始まる仮想ディレクトリ(URL)を指定してください。指定できるパス名の長さは,2,047バイト(パス名を囲む二重引用符を除く)までとなります。
また,ここで指定した仮想ディレクトリの直下には,次に示すファイルを格納しておいてください。
-
マッピング構成ファイル(X3MWCONF)
-
仮想端末名ファイル(X3MWHOST)
-
表示・印刷環境ファイル(X3PCONF)
-
フォント構成ファイル(X3PFONT)
-
プリンタ構成ファイル(X3PPINF)
-
Webクライアント環境ファイル(X3WEBCEX)
(2) データファイルパス(DataPath="パス名")
実行時,Webクライアント側に必要なデータファイルの格納先を定義します。データファイルパスに指定するフォルダは,「http://」または「https://」で始まる仮想ディレクトリ(URL)を指定してください。指定できるパス名の長さは,2,047バイト(パス名を囲む二重引用符を除く)までとなります。
データファイルパスで示すフォルダには,次に示すデータファイルを適宜格納してください。
-
物理マップファイル
-
出力グラフィックで使用するグラフィックファイル
-
可変ポップアップで使用するメニューファイル
-
FAX宛先ファイル
(3) ログ出力種別(LogSelect=)
XMAP3 Web実行環境ライブラリの実行結果についてログを出力するかどうかを指定します。ログ出力種別に指定できる値とその意味を次の表に示します。
指定できる値 |
意味 |
---|---|
false |
ログを出力しない |
standard |
エラーが発生したときにだけサーバログを出力する |
Nstandard |
エラーの発生に関係なく,常にサーバログを出力する |
サーバログについては,「20.3.1 サーバ側のログ情報(XMAP3 TP1/Web連携機能)」を参照してください。ログ出力種別の指定がない場合や,指定値に誤りがある場合は,「standard」が仮定されます。運用時は「standard」を指定することをお勧めします。