画面・帳票サポートシステム

XMAP3 Server

解説・手引書

3000-7-508-50

目　　次

前書き

変更内容

はじめに

1.　製品の概要

1.1　XMAP3 Serverの特長

1.2　XMAP3 Serverの位置づけ

2.　システム構成

2.1　実行環境のシステム構成

2.2　ハードウェア構成

2.2.1　システム装置

2.2.2　サポートするプリンタ

2.3　機能範囲

3.　XMAP3 Serverの組み込みと削除

3.1　PPの組み込み手順

3.2　上書きインストールの注意事項

3.3　PPの削除手順

4.　画面・帳票・アプリケーションの開発から実行までの手順

4.1　開発手順

4.1.1　画面・帳票を開発する手順

4.1.2　書式オーバレイを開発する手順

4.2　PC XMAP3で作成したファイルの転送

4.2.1　物理マップのファイル転送

4.2.2　論理マップ・動的変更テーブルのファイル転送

4.2.3　書式イメージ・行制御データのファイル転送（AIX，HP-UX，Solaris）

4.3　物理マップの移行

4.3.1　コマンドの概要

4.3.2　コマンドの使用方法

4.4　書式イメージ・行制御データの形式チェック（AIX，HP-UX，Solaris）

4.4.1　コマンドの概要

4.4.2　コマンドの使用方法

4.5　論理マップおよび動的変更テーブルの文字コード変換（AIX，Linux，Solaris）

5.　アプリケーションの開発

5.1　XMAP3 ServerのAPインタフェース

5.1.1　XMAP3 Serverでの画面入出力および帳票出力の基本

5.1.2　XMAP3 Serverでの書式出力の基本（AIX，HP-UX，Solaris）

5.1.3　アプリケーションプログラム間でオープンを引き継ぐ場合

5.1.4　アプリケーションプログラム分割時の注意

5.1.5　アプリケーションプログラムでの入力論理マップ上のデータチェック

5.2　COBOLの画面入出力および帳票出力命令

5.2.1　論理マップの取り込み方法

5.2.2　スタンドアロン環境，およびC/S環境下での画面入出力および帳票出力命令

5.3　COBOLの書式印刷命令（AIX，HP-UX，Solaris）

5.3.1　プリンタ出力用ファイルの定義

5.3.2　印刷する書式の設定

5.3.3　行データの帳票印刷

5.4　C言語の画面入出力および帳票出力命令

5.4.1　論理マップの取り込み方法

5.4.2　スタンドアロン環境，およびC/S環境下での画面入出力および帳票出力命令

5.5　C言語の書式印刷命令（AIX，HP-UX，Solaris）

5.5.1　印刷する書式の設定

5.5.2　行データの帳票印刷

5.6　C言語固有のコーディング例

5.7　その他のコーディング上で必要な知識

5.7.1　DBの利用方法

5.7.2　帳票出力時のXMAP3 Serverとアプリケーションプログラムの関係

5.7.3　書式オーバレイ印刷時のXMAP3 ServerとAPの関係（AIX，HP-UX，Solaris）

5.7.4　書式オーバレイ印刷時の印刷ページとスプール登録する文書の関係（AIX，HP-UX，Solaris）

5.7.5　EUC文字コードでの半角かなの扱い方（AIX，Linux，Solaris）

5.8　標準パターン

5.8.1　レイアウトパターンとアプリケーションのパターン

5.8.2　画面サンプルとAPパターンの組み合わせ

5.9　標準パターンを使用した機能別の作成例（COBOL）

5.9.1　BTMENU01パターンを使用したメニュー画面の表示

5.9.2　GENDSP01パターンを使用したメニュー画面からの次画面表示

5.9.3　GENDSP01パターンを使用したCUI画面でのフィールド単位のデータ入力

5.9.4　GENDSP01パターンを使用した行単位のデータ入力

5.9.5　GENDSP01パターンを使用した入力フィールドのクリア

5.9.6　GENDSP01パターンを使用したAPからのフィールド属性の変更

5.9.7　GENDSP01パターンを使用した表形式の一覧表示

5.9.8　GENDSP01パターンを使用した出力フィールドの再表示

5.9.9　GENDSP01パターンを使用したヘルプ画面の表示

5.9.10　GENDSP01パターンを使用したダイアログの表示

5.9.11　DSPPRT01パターンを使用した画面表示と帳票印刷

5.9.12　GENREP01パターンを使用した同一帳票の複数枚印刷

5.9.13　GENREP01パターンを使用した複数種類の帳票印刷

6.　アプリケーションのコンパイルから実行

6.1　画面入出力・帳票出力するAPのコンパイル

6.1.1　COBOL2002

6.1.2　COBOL85

6.1.3　C言語

6.1.4　COBOL，およびC言語のAPが混在する場合のコンパイルとリンケージ

6.2　書式オーバレイ印刷するAPのコンパイル（AIX，HP-UX，Solaris）

6.2.1　COBOL2002

6.2.2　COBOL85

6.2.3　C言語

6.3　書式オーバレイ印刷時の環境変数（AIX，HP-UX，Solaris）

6.4　AP実行時の注意事項

6.4.1　共用ライブラリ使用時の環境変数（Linux，Solaris）

6.4.2　書式オーバレイ印刷時の優先順位（AIX，HP-UX，Solaris）

6.4.3　書式オーバレイ印刷時の注意事項（AIX，HP-UX，Solaris）

6.5　書式オーバレイ印刷ユティリティ（AIX，HP-UX，Solaris）

6.5.1　環境変数の設定

6.5.2　書式オーバレイ印刷ユティリティコマンド

6.5.3　印刷例

7.　XMAP3 Serverの環境設定

7.1　LANG環境変数

7.2　AP作成の準備

7.2.1　APを作成するためのディレクトリを用意する

7.2.2　XMAP3 Serverの標準提供ファイルから必要なファイルを複写する

7.2.3　APの作成方法

7.2.4　プログラムパターンと部品パターン

7.2.5　APパターンを利用したAPの作成手順

7.3　スタンドアロン構成での環境設定例

7.3.1　帳票を印刷するAPを実行する場合

7.4　WSとPCによるC/S構成での環境設定例

7.4.1　各PCで実行するAPが異なる場合

7.4.2　各PCで実行するAPが共通な場合

7.4.3　C/Sシステムの通信設定の簡略化

7.4.4　起動クライアントを通知する場合の設定（AIX，HP-UX）

7.5　クラスタ構成での環境設定（HP-UX（PA-RISC），AIX）

7.5.1　システム構成

7.5.2　クラスタ構成でのサーバ側の環境設定

7.5.3　クラスタ構成でのクライアント側の環境設定

7.5.4　クラスタ構成での環境設定例

7.6　環境設定ファイルの編集

7.6.1　実行環境の設定に必要な情報を取得する

7.6.2　編集するファイルの一覧

7.6.3　仮想端末定義ファイル

7.6.4　マッピング構成ファイル

7.6.5　マッピング属性ファイル

7.6.6　マップドライバ環境定義ファイル

7.6.7　サービス名ファイルを編集する

7.6.8　表示・印刷環境ファイルを編集する

7.6.9　ホストアドレス管理ファイルを編集する

7.6.10　ポート番号管理ファイルを編集する

7.6.11　環境設定ファイルの設定項目とAPの設定項目との関係

7.7　XMAP3でのプリンタの設定

7.7.1　AIXでのプリンタの登録

7.7.2　HP-UXでのプリンタの登録

7.7.3　Linuxでのプリンタの登録

7.7.4　Solarisでのプリンタの登録

7.7.5　XMAP3 Serverでの印刷環境の設定

7.7.6　プリンタ使用時の注意事項

7.8　表示・印刷環境のカスタマイズ

7.8.1　表示・印刷環境ファイルの運用方法

7.8.2　表示・印刷環境ファイルの形式

7.8.3　クライアント側の表示・印刷環境ファイルを有効にする運用

7.8.4　表示・印刷サービス共通の設定項目

7.8.5　表示サービスに対する設定項目

7.8.6　印刷サービスに対する設定項目

7.8.7　表示・印刷環境ファイルの初期状態

7.9　表示色をカスタマイズする

7.9.1　表示・印刷環境ファイルとPC XMAP3の画面定義との関係

7.9.2　PC XMAP3の画面定義で色指定できないオブジェクトの表示色を指定する

7.9.3　GUI画面とCUI画面で使用する表示色の初期値

7.10　印刷色をカスタマイズする（AIX，HP-UX，Solaris）

7.10.1　表示・印刷環境ファイルとPC XMAP3の帳票定義との関係

7.11　通信データを圧縮する

7.12　印刷環境をカスタマイズする

7.12.1　LPスプールシステムでの帳票一括出力機能

7.12.2　LAN接続プリンタ使用時の注意事項

7.12.3　JP1/NQSEXECのqprxコマンドオプション付加

7.13　プレプリント帳票を印刷するための準備（AIX，Linux，Solaris）

7.13.1　文字フォントの準備

7.13.2　注意事項

7.14　外字の設定（AIX，HP-UX）

7.14.1　外字マッピングファイルの標準値

7.14.2　AIX用外字の定義と登録

7.14.3　HP-UX用外字の作成と登録

7.14.4　シフトJISで利用できる文字の範囲

7.15　PDFファイル出力に関連する設定と注意事項（AIX，HP-UX，Solaris）

7.15.1　PDFファイルの出力先

7.15.2　PDFファイル出力後のプログラム起動

7.15.3　PDFファイルの圧縮

7.15.4　注意事項

7.16　出力／固定グラフィック帳票をスタンドアロン構成で印刷する（HP-UX（PA-RISC），AIX）

7.16.1　利用できるグラフィックデータの種類

7.16.2　前提となる印刷モード

7.16.3　帳票の作成方法

7.16.4　注意事項

7.17　JP1/NPS連携時に1ページごとにジョブを登録する（HP-UX（PA-RISC），AIX）

7.17.1　JP1/NPS連携時に1ページごとにジョブを登録する機能の概要

7.17.2　注意事項

7.18　ESC/Pプリンタでプリンタ任せの改ページ印刷をする（AIX）

7.18.1　ESC/Pプリンタでプリンタ任せの改ページ印刷をする機能の概要

7.19　論理ハードコピーを印刷する

7.19.1　論理ハードコピー機能の操作

7.19.2　表示・印刷環境ファイル（XPWconfig）の設定

7.19.3　設定項目が有効となる印刷モード

7.19.4　論理ハードコピー機能を使用するときの注意

8.　運用・保守

8.1　XMAP3サーバの起動

8.1.1　コマンド入力によってXMAP3サーバを起動する場合

8.1.2　XMAP3サーバを自動起動する場合

8.1.3　XMAP3サーバでの表示サービス/印刷サービスの障害監視設定

8.1.4　XMAP3サーバの複数起動

8.2　クラスタ構成でのXMAP3サーバおよびアプリケーションの起動（HP-UX（PA-RISC），AIX）

8.2.1　XMAP3サーバの起動と停止

8.2.2　アプリケーションの起動

8.2.3　注意事項

8.3　PC XMAP3クライアントの起動

8.4　ユーザアプリケーションプログラムの通信障害監視の設定

9.　デバッグとチューニング

9.1　トラブルの対処方法

9.1.1　コンパイル時のトラブルシューティング

9.1.2　XMAP3サーバ起動時のトラブルシューティング

9.1.3　AP実行時のトラブルシューティング

9.2　ログ情報の利用方法

9.2.1　ログ情報の種類

9.2.2　ログ情報採取の指定

9.2.3　APの再実行（トラブル現象の再現）

9.2.4　ログファイルの内容確認

9.3　チューニング

9.3.1　環境定義ファイルの運用方法

9.3.2　環境定義ファイルの形式

9.3.3　物理マップの常駐について

9.3.4　書式オーバレイのデータ制限（AIX，HP-UX，Solaris）

9.3.5　行データ出力用の推奨コーディング（AIX，HP-UX，Solaris）

9.4　AP実行時のXMAP3 Serverのリターンコード

9.4.1　画面表示・帳票出力時のリターンコード

9.4.2　書式オーバレイ印刷時のリターンコード（AIX，HP-UX，Solaris）

9.5　取得する必要がある情報

9.6　要因別取得情報の一覧

9.7　AP実行時の詳細エラーコード

9.7.1　詳細エラーコード

9.8　XMAP3サーバが出力するメッセージ

9.8.1　メッセージの形式

9.8.2　メッセージの一覧

9.8.3　エラーコードの一覧

付録

付録A　提供ファイル一覧

付録A.1　共通ファイル

付録A.2　AIX固有のファイル

付録A.3　HP-UX固有のファイル

付録A.4　Linux固有のファイル

付録A.5　Solaris固有のファイル

付録B　標準提供例題プログラムの使用方法

付録B.1　提供サンプルの種類と利用方法

付録B.2　提供サンプルの利用手順

付録C　サポートプリンタの機能差

付録D　旧製品からXMAP3 Serverへの移行

付録D.1　XMAP2/W，XMAP2/W/FOG，XMAP3/DISPLAY，XMAP3/PRINTER，XP/Wからの移行

付録D.2　FOG2/W，XP/Wからの移行

付録D.3　KAPS/W/PS，XMAP3/PRINTER UTILITY，XP/Wからの移行

付録E　用語解説

索引

[他社商品名称に関する表示]

All Rights Reserved. Copyright (C) 2001, 2010, Hitachi, Ltd.

前書き

■ 対象製品

P-1M2B-2521　 XMAP3 Server　 04-10（適用OS：AIX 5L V5.1，AIX 5L V5.2，AIX 5L V5.3，AIX V6.1）

なお，次に示すプログラムプロダクトについては変更ありません。

P-1B2B-2521　 XMAP3 Server　 04-06（適用OS：HP-UX 10.20，HP-UX 11，HP-UX 11i，HP-UX 11i V2（PA-RISC））
P-1J2B-2521　 XMAP3 Server　 04-05（適用OS：HP-UX 11i V2（IPF））
P-9S2B-2521　 XMAP3 Server　 04-01（適用OS：TurboLinux Server 日本語版 6.1，Red Hat Linux 6.2J）
P-9D2B-2521　 XMAP3 Server　 04-04（適用OS：Solaris 7，Solaris 8，Solaris 9）

これらのプログラムプロダクトのほかにもこのマニュアルをご利用になれる場合があります。詳細は「ソフトウェア添付資料」でご確認ください。

■ 輸出時の注意

本製品を輸出される場合には，外国為替および外国貿易法ならびに米国の輸出管理関連法規などの規制をご確認の上，必要な手続きをお取りください。
なお，ご不明な場合は，弊社担当営業にお問い合わせください。

■ 商標類

Acrobatは，Adobe Systems Incorporated（アドビシステムズ社）の商標です。
Adobeは，Adobe Systems Incorporated（アドビシステムズ社）の商標です。
AIXは，米国におけるInternational Business Machines Corporationの登録商標です。
AIX 5Lは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
ESC/Pは，セイコーエプソン(株)の商標です。
HACMPは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
Itaniumは，アメリカ合衆国および他の国におけるインテル コーポレーションまたはその子会社の登録商標です。
JFIFは，C-Cube Microsystems社が規定したフォーマットの名称です。
Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
LIPSは，キヤノン（株）が開発した言語仕様です。
LIPSII+は，キヤノン（株）が開発した言語仕様です。
LIPSIIIは，キヤノン（株）が開発した言語仕様です。
Microsoftは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
MS-DOSは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
PA-RISCは，米国Hewlett-Packard Companyの商標です。
PC-9800は，日本電気（株）の商品名称です。
PC/ATは，米国International Business Machines Corp.の商品名称です。
PostScriptは，米国Adobe Systems, Inc.が開発した言語仕様です。
Red Hatは，米国およびその他の国でRed Hat,Inc. の登録商標若しくは商標です。
Solarisは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Sun Microsystemsは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
TurboLinuxの名称及びロゴは，TurboLinux, Inc. の商標です。
Turbolinuxは，ターボリナックス株式会社の商標または登録商標です。
UNIXは，X/Open Company Limited が独占的にライセンスしている米国ならびに他の国における登録商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows NTは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Windows Serverは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
X Window Systemは，米国X Consortium, Inc.が開発したソフトウェアです。
プログラムプロダクト「P-9D2B-2521」には，米国Sun Microsystems, Inc.が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D2B-2521」には，UNIX System Laboratories, Inc.が著作権を有している部分が含まれています。

■ 発行

2001年6月（第1版）3000-7-508
2010年2月（第6版）3000-7-508-50

■ 著作権

All Rights Reserved. Copyright (C) 2001, 2010, Hitachi, Ltd.

変更内容

変更内容（3000-7-508-50）P-1M2B-2521　XMAP3 Server　04-10

追加・変更内容 | 変更個所
「/attach」指定時の注意について説明を追加した。 | 7.4.3(5)，9.4.1，9.7.1
テキストデータをXMAP3の画面へコピー&ペーストする際に，タブおよび改行コードもペーストするかどうかを設定できるようにした。 | 7.8.5(2)
GUI画面を一部上書で表示したときに，画面のフィールドボックスのスクロール位置を保持するかどうかを設定できるようにした。 | 7.8.5(2)
論理ハードコピー機能の説明を追加した。さらに，印刷サービスに設定するパラメタを追加した。 | 7.8.6(5)，7.19，9.7.1
タイマ値設定機能の説明を追加した。 | 8.1.3，8.4，9.7.1
書式オーバレイの行データの上限値について，04-10以降の場合の概算式を追加した。 | 9.3.4
XMAP3サーバの停止時に，syslogファイルへメッセージを出力するようにした。 | 9.8.1，9.8.2
XMAP3 Serverへの移行の説明で，移行前の旧製品にXMAP2/W/FOGを追加した。 | 付録D.1

単なる誤字・脱字などはお断りなく訂正しました。

変更内容（3000-7-508-40）P-1M2B-2521　XMAP3 Server　04-07，P-1B2B-2521　XMAP3 Server　04-06

追加・変更内容

クラスタ構成に対応した。

HP-UX（PA-RISC）およびHP-UX（IPF）の両方に対応した。

AIX環境でのコンパイルで，COBOL2002に対応した。

出力／固定グラフィック帳票をスタンドアロン構成で印刷する機能に対応した。

JP1/NPS連携時に1ページごとにジョブを登録する機能に対応した。

ESC/Pプリンタでプリンタ任せの改ページ印刷をする機能に対応した。

マップドライバ機能のsyslogファイル出力内容の公開に対応した。

XMAP3サーバからsyslogファイルへの情報出力の強化に対応した。

対応OSに，HP-UX（PA-RISC）およびAIXを追加した。

変更内容（3000-7-508-30）P-1J2B-2521　XMAP3 Server　04-05

追加・変更内容

PostScriptレベル3準拠プリンタの利用をサポートした。

IPF版のCPUに対応した。

cmapcpコマンド，mapfchkコマンドおよび実行環境で，物理マップのエンディアンのチェックを行うようにした。

COBOL2002に対応した。

印刷ドキュメント名指定機能をサポートした。

起動クライアント通知機能をサポートした。

挿入モードのデフォルトに関する設定をサポートした。

印刷サービスでカラー印刷をサポートした。

印刷色のカスタマイズ機能をサポートした。

PDFファイル出力機能をサポートした。

変更内容（3000-7-508-20）P-1M2B-2521　XMAP3 Server　04-05

追加・変更内容

印刷ドキュメント名指定機能をサポートした。

起動クライアント通知機能をサポートした。

PostScriptレベル3準拠プリンタの利用方法をサポートした。

PDFファイル出力機能をサポートした。

挿入モードのデフォルトに関する設定をサポートした。

変更内容（3000-7-508-20）P-9D2B-2521　XMAP3 Server　04-04

追加・変更内容

印刷ドキュメント名指定機能をサポートした。

PostScriptレベル3準拠プリンタの利用方法をサポートした。

PDFファイル出力機能をサポートした。

挿入モードのデフォルトに関する設定をサポートした。

印刷色のカスタマイズ機能をサポートした。

グラフィック帳票のEAN-128バーコード対応をサポートした。

変更内容（3000-7-508-20）P-1M2B-2521　XMAP3 Server　04-03

追加・変更内容

印刷色のカスタマイズ機能をサポートした。

グラフィック帳票のEAN-128バーコード対応をサポートした。

はじめに

このマニュアルは，次に示すプログラムプロダクトの機能，および使用方法について説明したものです。

P-1M2B-2521 XMAP3 Server

P-1B2B-2521 XMAP3 Server

P-1J2B-2521 XMAP3 Server

P-9S2B-2521 XMAP3 Server

P-9D2B-2521 XMAP3 Server

このマニュアルでは，上記プログラムプロダクトをXMAP3 Serverと表記しています。

＜はじめにの構成＞

対象読者

マニュアルの構成

関連マニュアル

このマニュアルでの表記

このマニュアルの操作説明で使用している記号

このマニュアルでのマウスの操作の表記

図中で使用する記号の説明

このマニュアルで使用する略語

このマニュアルで使用する記号

常用漢字以外の漢字の使用について

KB（キロバイト）などの単位表記について

対象読者

システム設計者，およびXMAP3 Serverを使って画面表示または帳票印刷を実行する方を対象としています。次に示す項目について理解，習得していることを前提とします。

UNIXの基本的な操作方法

XMAP3を使ったシステム構成や基本操作

COBOLまたはC言語

マニュアルの構成

このマニュアルは，次に示す章と付録から構成されています。

第1章　製品の概要

XMAP3 Serverの概要，および機能について説明しています。

第2章　システム構成

XMAP3 Serverを使ったシステム構成について説明しています。

第3章　XMAP3 Serverの組み込みと削除

日立PPインストーラを使用したXMAP3 Serverの組み込みおよび削除方法について説明しています。

第4章　画面・帳票・アプリケーションの開発から実行までの手順

画面・帳票およびAPの開発からXMAP3 Server実行までの手順について説明しています。

第5章　アプリケーションの開発

アプリケーションプログラムのコーディングについて説明しています。

第6章　アプリケーションのコンパイルから実行

アプリケーションのコンパイル方法と実行方法について説明しています。

第7章　XMAP3 Serverの環境設定

システム構成別の環境設定例と，実行環境の設定手順について説明しています。

第8章　運用・保守

XMAP3 Serverを使ったアプリケーションプログラムの実行からデバッグまでの運用と保守方法について説明しています。

第9章　デバッグとチューニング

XMAP3 Serverを使用中に発生したトラブルの原因と対処方法について説明しています。また，ログ情報の利用方法についても説明しています。

付録A　提供ファイル一覧

付録B　標準提供例題プログラムの使用方法

付録C　サポートプリンタの機能差

付録D　旧製品からXMAP3 Serverへの移行

付録E　用語解説

関連マニュアル

このマニュアルに関連するマニュアルを次に示します。

(1)ワークステーション

COBOL85　言語（3020-3-782）

COBOL85　使用の手引（3000-3-354）

COBOL2002　言語　標準仕様編（3020-3-D44）

COBOL2002　使用の手引　手引編（3000-3-D42）

OpenTP1 Version 5　分散トランザクション処理機能　OpenTP1 プロトコル　TP1/NET/XMAP3編（3000-3-375）

JP1 Version 6　JP1/Network Printing System　運用・操作編（3000-3-174）

(2)パーソナルコンピュータ

画面・帳票サポートシステム　XMAP3　入門（3020-7-592）

画面・帳票サポートシステム　XMAP3　開発・実行ガイド（3020-7-591）

画面・帳票サポートシステム　XMAP3　プログラミングガイド　画面編（3020-7-594）

画面・帳票サポートシステム　XMAP3　プログラミングガイド　帳票編（3020-7-593）

このマニュアルでの表記

このマニュアルでは，製品名を次のように表記しています。

製品名 | 表記
AIX 5L V5.1 | AIX
AIX 5L V5.2
AIX 5L V5.3
AIX V6.1
COBOL85 | 日立COBOL
COBOL2002
HP-UX 10.20 | HP-UX（PA-RISC）
HP-UX 11
HP-UX 11i
HP-UX 11i V2（PA-RISC）
HP-UX 11i V2（IPF） | HP-UX（IPF）
JP1/Network Printing System | JP1/NPSまたはJP1
Solaris 7 | Solaris
Solaris 8
Solaris 9
TP1/Message Control | TP1/MCF
TP1/NET/Library
TP1/NET/XMAP3
TurboLinux Server 日本語版 6.1 | TurboLinux
Red Hat Linux(R) 6.2J | Red Hat Linux
Microsoft(R) Windows(R) 95 Operating System | Windows 95
Microsoft(R) Windows(R) 98 Operating System | Windows 98
Microsoft(R) Windows(R) Millennium Edition Operating System | Windows Me
Microsoft(R) Windows NT(R) Server Network Operating System Version 4.0 | Windows NT
Microsoft(R) Windows NT(R) Server Network Operating System Version 4.0 Enterprise Edition
Microsoft(R) BackOffice Small Business Server Version 4.0
Microsoft(R) Windows NT(R) Workstation Operating System Version 4.0
Microsoft(R) Windows (R) 2000 Server Operating System | Windows 2000
Microsoft(R) Windows(R) 2000 Advanced Server Operating System
Microsoft(R) Windows(R) 2000 Datacenter Server Operating System
Microsoft(R) Windows(R) 2000 Professional Operating System
Microsoft(R) Windows(R) XP Professional Operating System | Windows XP
Microsoft(R) Windows(R) XP Home Edition Operating System
Microsoft(R) Windows Server(R) 2003, Standard Edition 日本語版 | Windows Server 2003
Microsoft(R) Windows Server(R) 2003, Enterprise Edition 日本語版
Microsoft(R) Windows Server(R) 2003 R2, Standard Edition 日本語版
Microsoft(R) Windows Server(R) 2003 R2, Enterprise Edition 日本語版
Microsoft(R) Windows Server(R) 2003, Standard x64 Edition 日本語版
Microsoft(R) Windows Server(R) 2003, Enterprise x64 Edition 日本語版
Microsoft(R) Windows Server(R) 2003 R2, Standard x64 Edition 日本語版
Microsoft(R) Windows Server(R) 2003 R2, Enterprise x64 Edition 日本語版
XMAP3/Enterprise Edition Version 4※ | PC XMAP3
XMAP3/Enterprise Edition Run Time System Version 4※
XMAP3/NET Version 4※
XMAP3/NET Run Time System Version 4※

Windows 95，Windows 98，Windows Me，Windows NT，Windows 2000，Windows XP，Windows Server 2003で機能差がない場合，Windowsと表記しています。

HP-UX（PA-RISC），HP-UX（IPF）で機能差がない場合，HP-UXと表記しています。

TurboLinux，Red Hat Linuxで機能差がない場合，Linuxと表記しています。

HP-UX，Solaris，AIXおよびLinuxを総称して，UNIXと表記することがあります。

注※　開発系製品は実行系製品の機能を含んでいます。

このマニュアルの操作説明で使用している記号

このマニュアルの操作説明で使用する記号を次のように定義しています。

記号
意味

［　　］
メニュータイトル，メニュー項目，ボタン，キー，およびアイコンの名称を示す。
例：［ファイル］メニュー
　　［OK］ボタン
　　［Enter］キー など

［　　］+［　　］
+の前のキーを押したまま，後ろのキーを押すことを示す。
例：［Shift］+［A］キー
　　［Shift］キーを押したまま［A］キーを押す。

［　　］－［　　］
例：［ファイル］－［開く］
　　［ファイル］メニューから［開く］を選択することを示す。

このマニュアルでのマウスの操作の表記

このマニュアルでは，マウスの操作を次のように定義しています。

マウスの操作
意味

クリック
右手用に設定したマウスの場合，左ボタンを押すことを示します。
左手用に設定したマウスの場合，右ボタンを押すことを示します。

ダブルクリック
右手用に設定したマウスの場合，左ボタンを続けて2回押すことを示します。
左手用に設定したマウスの場合，右ボタンを続けて2回押すことを示します。

右クリック
右手用に設定したマウスの場合，右ボタンを押すことを示します。
左手用に設定したマウスの場合，左ボタンを押す「左クリック」ことを示します。

図中で使用する記号の説明

このマニュアルの図中で使用する記号を，次のように定義します。

このマニュアルで使用する略語

このマニュアルでは，次に示す用語を略して表現しています。

略語 | 正式名称
AP | Application Program
API | Application Programming Interface
C/Sシステム | Client / Server System
CD-ROM | Compact Disc Read Only Memory
COBOL | Common Business Oriented Language
CPU | Central Processing Unit
CUI | Character User Interface
DB | Database
DBMS | Data Base Management System
DHCP | Dynamic Host Configuration Protocol
DNS | Domain Name System
GUI | Graphical User Interface
IPF | Itanium(R) Processor Family
JIS | Japanese Industrial Standards
KEIS | Kanji processing Extended Information System
LAN | Local Area Network
LIPS | LBP Image Processing System
OLTP | Online Transaction Processing
OS | Operating System
PC | Personal Computer
PDL | Page Description Language
PP | Program Product
RPC | Remote Procedure Call
UAP | User Application Program
WS | Workstation

このマニュアルで使用する記号

このマニュアルで使用する記号を，次のように定義します。

文法に使用する記号

記号
意味

｜
横に並べられた複数の項目に対し，項目の間の区切りを示し，「または」の意味を示す。

（例）

A｜B｜Cは「AまたはBまたはC」を意味する。

{　}
この記号で囲まれている複数の項目のうちから一つを選択することを示す。

（例）

｛A｜B｜C｝は「AまたはBまたはCのどれかを指定する」ことを示す。

〔　〕
この記号で囲まれている項目は省略してよいことを意味する。

（例）

〔A〕は「何も指定しない」か，「Aを指定する」ことを示す。

〔B｜C〕では「何も指定しない」か，「BまたはCを指定する」ことを示す。

△
空白を空けること，またはスペースキーを指定された数だけ押すことを示す。

（例）

EDIT△PANELはEDITとPANELの間に一つ空白を空けることを示す。

変数指定に使用する記号

記号 | 意味
～ | この記号の前に示された項目が，記号～に続く＜＞，((　))などの規則に従わなければならないことを示す。
＜　＞ | 項目を記述するとき従わなければならない構文要素を示す。
((　)) | 項目で指定できる値の範囲を示す。
斜体 | 入力する値が可変となることを示す。

構文要素を説明する記号

構文要素 | 意味 | 正しい例 | 誤った例
＜英数字＞ | 英字で始まる半角の英字または数字の集まり | 3，A | &
＜10進数＞ | 10進数字の集まり | 3 | A
＜英数字，-，_＞ | 英字で始まる半角の英数字，ハイフン，およびアンダーラインの集まり | 3，- | &

常用漢字以外の漢字の使用について

このマニュアルでは，常用漢字を使用することを基本としていますが，次に示す用語については，常用漢字以外の漢字を使用しています。

宛先（あてさき）　個所（かしょ）　矩形（くけい）　毎（ごと）　汎用（はんよう）　必須（ひっす）　頁（ページ）

KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

1.　製品の概要

この章では，WSおよびPCで画面表示，帳票印刷を一貫して支援する画面・帳票サポートシステム XMAP3 Serverの概要について説明します。

＜この章の構成＞

1.1　XMAP3 Serverの特長

1.2　XMAP3 Serverの位置づけ

1.1　XMAP3 Serverの特長

WS上で使用するXMAP3 Serverの特長を図1-1に示します。

図1-1　XMAP3 Serverの特長

＜多彩な表現力＞

基幹業務系システムにプレゼンテーション能力の高い画面・帳票が追加できる。

本格的なGUI画面を，論理マップインタフェースで容易に利用できる。

ホストで使用していたT-560/20端末と同等なCUI画面を利用できる。

けい線や拡大文字などを使用したシリアルプリンタ用帳票が印刷できる。

表の角を丸めたラウンドコーナや網かけ，バーコードなどを使用したページプリンタ用帳票が印刷できる。

＜豊富な適用環境＞

TP1/MCFと連携したOLTP環境。

WSとPC（表示・印刷サービス）によるC/S環境。

WSスタンドアロン環境（印刷）。

＜高い親和性＞

画面・帳票定義はPC XMAP3で実行するため，PC/WSの両方で利用できる。

SEWB3/SYSTEMで作成した定義は，PC XMAP3でインポート後，WS用に作成した物理マップ，論理マップ，動的変更テーブルをWSへ転送し利用できる。

WS用に日立COBOLで作成するアプリケーションプログラムのAPIは，論理マップを使用したSEND/RECEIVE，TRANSCEIVEインタフェースであり，メインフレームやPCと共通に使用できる。

＜高い生産性＞

マッピングアーキテクチャ（マッピング方式）を採用しているため，画面・帳票のレイアウトを変更してもアプリケーションプログラムの変更は不要である。

X Window System，WindowsおよびC言語の知識がなくても，COBOL言語だけでGUI画面を使ったアプリケーションプログラムが作成できる。

アプリケーションプログラムは，COBOL言語だけでなく，C言語でもプログラミングできる。

PC XMAP3による画面・帳票設計となり，操作性の良いドロー定義ができる。

1.2　XMAP3 Serverの位置づけ

XMAP3 Serverは，PC XMAP3で開発したWS用論理マップ，物理マップを使用して，APから画面表示，帳票印刷するAP開発および実行を支援する製品です。

XMAP3 Serverでは，主に次の機能を提供します。

PC XMAP3で作成した物理マップの実行環境への移行機能

WS上のAPとのインタフェースを持つマップドライバ機能※1

WS上で表示・印刷を制御するXMAP3サーバ機能※2

WS上で印刷を実行する印刷サービス機能※3

注※1

従来のXMAP3/DISPLAY（Run Time Systemを含む），XMAP3/PRINTER（Run Time Systemを含む）のマップドライバ機能と互換があります。

注※2

従来のXP/Wの管理デーモンと互換があります。

注※3

従来のXP/Wの印刷サーバ機能と互換があります。

開発・実行環境に必要なXMAP3製品を表1-1，XMAP3 Serverの位置づけを図1-2に示します。

表1-1　開発・実行環境に必要なXMAP3製品

分類 | XMAP3 Server | PC XMAP3
開発環境 | 画面・帳票定義 | × | 　○※1
AP開発 | 　○※2 | ×
実行環境 | 画面入出力※3 | C/Sシステム | ○ | ○
帳票出力※4 | スタンドアロン | ○ | －
C/Sシステム | ○ | ○

（凡例）　○：必要である　×：不要である　－：該当しない

注※1

画面・帳票の定義およびマップを作成する場合，XMAP3/Enterprise Edition Version 4によるWS用マップ生成が前提となります。

なお，マップ作成時のPC XMAP3のバージョンは，XMAP3 Server以前のバージョン（同じバージョン・リビジョンを含む）が前提となります。

XMAP3/DISPLAY，XMAP3/PRINTERで使用していたマップは，そのまま使用できます。旧製品からの移行については，「付録D　旧製品からXMAP3 Serverへの移行」を参照してください。

注※2

PC XMAP3で作成したWS用マップを実行環境で使用できる形式にする場合と，APのコンパイル時に必要となります。

注※3

画面入出力を実行する場合は，下記のPC XMAP3とのC/S構成で使用できます。

なお，クライアント側のPC XMAP3のバージョンは，XMAP3 Server以降のバージョン（同じバージョン・リビジョンを含む）が前提となります。

XMAP3/Enterprise Edition Version 4

XMAP3/Enterprise Edition Run Time System Version 4

XMAP3/NET Version 4

XMAP3/NET Run Time System Version 4

注※4

帳票出力を実行する場合は，WSスタンドアロン，PC XMAP3とのC/S構成で使用できます。C/S構成では，注※3に示すPC XMAP3が必要です。

図1-2　XMAP3 Serverの位置づけ

2.　システム構成

この章では，XMAP3 Serverを使ったシステム構成について説明します。

＜この章の構成＞

2.1　実行環境のシステム構成

2.2　ハードウェア構成

2.3　機能範囲

2.1　実行環境のシステム構成

XMAP3 Serverを使ったシステムでは，WSでのスタンドアロン，WSとPCでのC/Sシステムが適用できます。

＜この節の構成＞

(1)　スタンドアロン構成

(2)　C/S構成

(3)　OLTP構成（AIX，HP-UX，Solaris）

(4)　クラスタ構成

(1)　スタンドアロン構成

XMAP3 Serverをスタンドアロン構成で使用する場合は，帳票印刷機能が使用できます。

常に特定のプリンタで印刷する場合

プリンタを2台以上接続して，APの指定で印刷するプリンタを使い分けたい場合

(2)　C/S構成

XMAP3 Serverでは，次のようなC/S構成での運用ができます。

(a)　クライアントから起動するサーバAPを共用するC/S構成

APおよびマッピングライブラリがサーバ側にあり，表示サービスがクライアントにある構成です。複数のクライアントをサーバに接続して共通の業務をする場合は，この構成になります。

(b)　クライアントから起動するサーバAPが異なるC/S構成

APおよびマッピングライブラリがサーバ側にあり，表示サービスがクライアントにある構成です。複数のクライアントをサーバ接続して，クライアントごとに別々の業務を実行する場合や，1クライアントで複数の業務を行う場合は，この構成となります。

(c)　LAN直結プリンタを複数PCで共用するC/S構成

XMAP3のC/S構成の場合，XMAP3のAPを自動起動する機能を利用して，クライアント側でXMAP3の表示サービスが起動されたタイミングでサーバのAPを起動し，サーバのAPからLAN直結プリンタへ帳票印刷できます。

(d)　サーバAPから出力先プリンタを指定するC/S構成

サーバにあるAPから出力先プリンタを指定するC/S構成です。ここでは，3台のプリンタを目的に応じて使い分ける構成を示します。

(e)　JP1を利用した印刷環境を共用するC/S構成

サーバ側に用意されたJP1が提供する印刷システムを使ったC/S構成です。JP1と連携することで，より信頼性の高い印刷運用環境を実現できます。

(f)　サーバが2台以上のC/S構成

クライアントから複数のサーバに対して接続する場合の構成です。

(3)　OLTP構成（AIX，HP-UX，Solaris）

AIX，HP-UXおよびSolaris環境では，日立の分散トランザクションマネージャ「OpenTP1」の「TP1/NET/XMAP3」を利用したOLTP構成で，XMAP3 Serverをサーバ，PC XMAP3をクライアントで利用することができます。

(4)　クラスタ構成

XMAP3サーバは，クラスタリング機能をサポートしたミドルウェア製品（HAモニタおよびHACMP）を前提として，クラスタ構成で運用できます。

2.2　ハードウェア構成

＜この節の構成＞

2.2.1　システム装置

2.2.2　サポートするプリンタ

2.2.1　システム装置

対応するシステム装置を次に示します。

<AIX>

EP8000シリーズ

<HP-UX（PA-RISC）>

HITACHI　9000Vシリーズ，またはHP互換機

<HP-UX（IPF）>

HITACHI　HA8500シリーズ，またはHP互換機

<Linux>

Linuxを搭載できるPC/AT互換機

<Solaris>

SunSPARCシリーズ

2.2.2　サポートするプリンタ

XMAP3 Serverで利用できるプリンタについて説明します。プリンタによる印刷機能範囲については，「付録C　サポートプリンタの機能差」を参照してください。

＜この項の構成＞

(1)　WSスタンドアロン印刷時に利用できるプリンタ

(2)　PCとのC/S印刷時に利用できるプリンタ

(1)　WSスタンドアロン印刷時に利用できるプリンタ

WSがスタンドアロン構成の印刷時に利用できるプリンタは次のとおりです。

表2-1　WSスタンドアロン印刷時に利用できるプリンタ

分類
マップ定義対象
適用できるプリンタの特徴

シリアルプリンタ帳票用
けい線帳票
ESC/P J84コマンドのプリンタ言語を認識できる180dpiプリンタ

プレプリント帳票

ページプリンタ帳票用
網掛け帳票
次のどれかのプリンタ言語を認識できるページプリンタ

LIPS IIIコマンド※1

LIPS II+コマンド※2

PostScriptレベル2※3

グラフィック帳票

書式オーバレイ

注※1

300dpiの解像度と想定しています。また，LIPS IVプリンタの場合もLIPS IIIのコマンド範囲で利用できます。

注※2

240dpiの解像度と想定しています。

注※3

PostScriptレベル3準拠プリンタもPostScriptレベル2のコマンド範囲で利用できます（AIX，HP-UX（PA-RISC），HP-UX（IPF），Solaris）。

(2)　PCとのC/S印刷時に利用できるプリンタ

PCとのC/S構成での印刷で利用できるプリンタは次のとおりです。

表2-2　PCとのC/S印刷時に利用できるプリンタ

分類
マップ定義対象
適用できるプリンタの特徴

シリアルプリンタ帳票用
けい線帳票

ESC/P J84コマンドのプリンタ言語を認識できる180dpiプリンタ

Windows対応のプリンタドライバを提供している各社シリアルプリンタ

プレプリント帳票

ページプリンタ帳票用
網掛け帳票

Windows対応のプリンタドライバを提供している各社ページプリンタ

次のどちらかのプリンタ言語を認識できるページプリンタ
LIPS IIIコマンド※1
LIPS II+コマンド※2

グラフィック帳票

書式オーバレイ

注※1

300dpiの解像度と想定しています。また，LIPS IVプリンタの場合もLIPS IIIのコマンド範囲で利用できます。

注※2

240dpiの解像度と想定しています。

2.3　機能範囲

XMAP3 Serverで提供する機能範囲として，C/S構成では同一バージョンのPC XMAP3の機能が利用できます。ただし，次に示す機能範囲（画面表示，サーバでの帳票印刷機能）には，OSごとに機能差がありますので，対応する機能を確認してください。

表2-3　画面表示，サーバでの帳票印刷の機能範囲

機能 | AIX | HP-UX | Linux | Solaris
画面機能 | 画面種別 | CUI画面 | ○ | ○ | ○ | ○
GUI画面 | ○ | ○ | ○ | ○
構成 | スタンドアロン | × | × | × | ×
C/S（クライアントはPCが前提） | ○ | ○ | ○ | ○
OLTP（TP1/NET/XMAP3構成でクライアントはPCが前提） | ○ | ○ | × | ○
帳票機能 | 帳票種別 | シリアルインパクト けい線帳票 | ○ | ○ | ○ | ○
シリアルインパクト プレプリント帳票 | ○ | ○ | ○ | ○
ページプリンタ 網掛け帳票 | ○ | ○ | ○ | ○
ページプリンタ グラフィック帳票 | ○ | ○ | ○ | ○
ページプリンタ 書式オーバレイ※1 | ○ | ○ | × | ○
構成 | スタンドアロン | ○ | ○ | ○ | ○
C/S（クライアントはPCが前提） | ○ | ○ | ○ | ○
OLTP（TP1/NET/XMAP3構成） | ○ | ○ | × | ○
接続形態 | ローカル接続プリンタ | × | ○ | ○ | ×
リモート接続プリンタ | ○ | ○ | ○ | ○
プリンタ種別 | LIPS II+準拠プリンタ | ○ | ○ | ○ | ○
LIPS III準拠プリンタ | ○ | ○ | ○ | ○
PostScriptレベル2準拠プリンタ | ○ | ○ | ○ | ○
PostScriptレベル3準拠プリンタ | ○ | ○ | × | ○
ESC/P J84準拠プリンタ | ○ | ○ | ○ | ○
印刷方式 | LPスプール出力 | ○ | ○ | ○ | ○
JP1/NQSEXEC連携方式※2 | ○ | ○ | × | ○
文字コード | シフトJIS | 内字出力※3 | ○ | ○ | × | ○
外字出力 | ○ | ○ | × | ○※4
EUC | 内字出力※3 | ○ | × | ○ | ○
外字出力 | × | × | × | ×

（凡例）

○：サポート

×：未サポート

注※1

書式オーバレイ機能は，TP1/NET/XMAP3環境では使用できません。

注※2

日立ミドル製品JP1/NQSEXECが提供するジョブ登録コマンド「qprx」を発行することで，直接JP1/NQSEXECのジョブキューに印刷データを登録する方式です。

注※3

内字とは，外字（ユーザ定義文字）を除く文字です。

注※4

クライアント側にPCを利用するC/S構成の場合で，クライアント側に対してだけ外字を出力できます。

3.　XMAP3 Serverの組み込みと削除

XMAP3 Serverの組み込みおよび削除は，日立PPインストーラを使用してください。この章では日立PPインストーラの使用方法について説明します。

＜この章の構成＞

3.1　PPの組み込み手順

3.2　上書きインストールの注意事項

3.3　PPの削除手順

3.1　PPの組み込み手順

日立PPインストーラを使用して，XMAP3 Serverを組み込む手順について説明します。

なお，OSによって，コマンドの指定方法が異なりますので，使用する環境に合わせて操作してください。

＜この節の構成＞

(1)　ログイン

(2)　日立PPインストーラの起動

(3)　PPのインストール

(4)　PP一覧の表示

(1)　ログイン

日立PPインストーラは，スーパユーザ以外では実行できません。このため，インストール対象のマシンにスーパユーザでログインしてください。

(2)　日立PPインストーラの起動

日立PPインストーラは提供媒体に格納されています。日立PPインストーラを起動する際には次の点に注意してください。

デバイススペシャルファイル名やCD-ROMのマウントディレクトリは，OS，ハードおよび環境であらかじめ準備されているディレクトリまたは任意のディレクトリを使用してください。あらかじめ用意されているディレクトリを使用する場合は，マニュアルや使用環境などを確認の上実行してください。

日立PPインストーラ実行時の言語種別と，実行するターミナルの言語を一致させておく必要があります。

日立PPインストーラの起動手順を次に示します。

CD-ROMファイルシステムのマウント
始めにCD-ROMファイルシステムをマウントする必要があります。マウントするには次のコマンドを実行します。

<AIX>

mount -r -v cdrfs /dev/cd0 /cdrom

<HP-UX>

mount -r -F cdfs /dev/dsk/c0t2d0 /cdrom

<Linux>

mount -o mode=0544 /dev/cdrom /mnt/cdrom

<Solaris>

mount -r -F hsfs /dev/dsk/c0t4d0s0 /cdrom

注意事項

下線部のデバイススペシャルファイル名およびCD-ROMファイルシステムのマウントディレクトリ名は，環境によって異なります。

Solaris環境下の場合は，通常，CD-ROMファイルシステムは自動マウントされます。マウントされていない場合だけ，コマンドによるマウントが必要になります。

インストール作業完了後にCD-ROM媒体をドライブから外す場合は，必ずCD-ROMのマウント状態を解除（アンマウント）してから実行してください。アンマウントのコマンドは次のとおりです。
unmount /cdrom

CD-ROMセットアッププログラムの起動
CD-ROMセットアッププログラムは次に示すコマンドで起動します。これによって，日立PPインストーラと常駐プロセス自動起動プログラムをハードディスク上にインストールし，日立PPインストーラを自動的に起動します。

<AIX>

/cdrom/aix/setup /cdrom

<HP-UX（PA-RISC）>

/cdrom/HPUX/SETUP /cdrom

<HP-UX（IPF）>

/cdrom/IPFHPUX/SETUP /cdrom

<Linux>

/mnt/cdrom/linux/setup /mnt/cdrom

<Solaris>

/cdrom/cdrom0/solaris/setup /cdrom/cdrom0

CD-ROMのディレクトリ名やファイル名は，マシン環境によっては記述した内容と見え方が異なることがあります。lsコマンドで確認してから，表示されたファイル名をそのまま入力してください。

注意事項

下線部には使用するCD-ROMのマウントディレクトリ名を指定してください。

(3)　PPのインストール

日立PPインストーラまたはCD-ROMセットアッププログラムを，提供媒体を指定して起動します。提供媒体を媒体装置にセットしておいてください。

メインメニューで［I］を選択します。
インストール画面が表示されます。図3-1に画面イメージを示します。

図3-1　PPインストール画面

インストールしたいPPにカーソルを移動させ，スペースキーで選択します。
選択したPPの左側には，「<@>」が表示されます。このとき，複数のPPを選択することもできます。

［I］を入力します。
最下行に次のメッセージが表示されます。

［y］または［Y］を選択します。
インストールが開始されます。［n］または［N］を選択すると，インストールが中止されPPインストール画面に戻ります。

［Q］を入力します。
メインメニューに戻ります。

(4)　PP一覧の表示

メインメニューで［L］を選択します。
PP一覧表示画面が表示されます。この画面では，そのマシンにインストールされているPPの一覧が表示されます。図3-2に画面イメージを示します。

図3-2　PP一覧表示画面

［P］を選択すると，インストール済みPP一覧が/tmp/hitachi_PPLISTに出力されます。

［Q］を入力します。
メインメニューに戻ります。

3.2　上書きインストールの注意事項

日立PPインストーラでは，新規インストール（XMAP3 Serverがインストールされていない状態），および上書きインストール（すでにインストールされた状態）が実行できます。

上書きインストール時は，XMAP3 Serverが提供する環境設定ファイルおよび外字KEIS←→シフトJISコード変換テーブルを除いて，インストールを実行した提供ファイルに書き換えられます。上書きを抑止（インストール前の内容を保持）する提供ファイルの一覧を表3-1に示します。

表3-1　上書きを抑止する提供ファイル一覧

ファイルの種類
ファイル名

仮想端末定義ファイル
/etc/opt/HIXMAP/XMAPhosts

マッピング構成ファイル
/etc/opt/HIXMAP/XMAPconfig

マッピング属性ファイル
/etc/opt/HIXMAP/XMAPsrv/xps

マップドライバ環境定義ファイル
/etc/opt/HIXMAP/XMAPdrv

サービス名ファイル
/etc/opt/HIXMAP/XPWhosts

表示・印刷環境ファイル
/etc/opt/HIXMAP/XPWconfig

外字KEIS←→シフトJISコード変換テーブル

Solaris

/usr/openwin/lib/X11/fonts/hitachi/cnv_map_tbl

上記以外

/usr/lib/X11/fonts/hitachi/cnv_map_tbl

3.3　PPの削除手順

PPを削除する手順について説明します。

PPを削除するためのコマンドを入力します。

/etc/hitachi_setup

メインメニューで［D］を選択します。
PP削除画面が表示されます。図3-3に画面イメージを示します。

図3-3　PP削除画面

削除したいPPにカーソルを移動させ，スペースキーで選択します。
選択したPPの左側には，「<@>」が表示されます。このとき，複数のPPを選択することもできます。

［D］を入力します。
最下行に次のメッセージが表示されます。

［y］または［Y］を選択します。
削除が開始されます。［n］または［N］を選択すると，PP削除が中止されPP削除画面に戻ります。

［Q］を入力します。
メインメニューに戻ります。

4.　画面・帳票・アプリケーションの開発から実行までの手順

画面・帳票およびAPの開発からXMAP3 Server実行までの手順について説明します。また，WS上で開発するまでに必要な手順について説明します。

＜この章の構成＞

4.1　開発手順

4.2　PC XMAP3で作成したファイルの転送

4.3　物理マップの移行

4.4　書式イメージ・行制御データの形式チェック（AIX，HP-UX，Solaris）

4.5　論理マップおよび動的変更テーブルの文字コード変換（AIX，Linux，Solaris）

4.1　開発手順

アプリケーションの開発から実行までの手順について説明します。

＜この節の構成＞

4.1.1　画面・帳票を開発する手順

4.1.2　書式オーバレイを開発する手順

4.1.1　画面・帳票を開発する手順

画面・帳票の開発から実行までの手順を示します。各項目の詳細については，「参照」欄に記述したマニュアルおよび記述場所を参照してください。

表4-1　画面・帳票の開発からAPの実行までの手順

開発から実行までの手順
参照

┌──────────────────┐
│１．画面・帳票のレイアウトを決める　│
└┬─────────────────┘
　│・画面の大きさを決める。
　│・画面の行単位を決める。
　│・各項目のレイアウトを決める。
　↓

「プログラミングガイド　画面編」

「プログラミングガイド　帳票編」

┌──────────────────┐
│２．画面・帳票を定義する　　　　　　│
└┬─────────────────┘
　│・PC XMAP3のドローを用いて
　│　ワープロイメージで定義する。
　↓

「プログラミングガイド　画面編」

「プログラミングガイド　帳票編」

┌──────────────────┐
│３．マップを生成する　　　　　　　　│
└┬─────────────────┘
　│・PC XMAP3によって，
　│　APで使用する論理マップと
　│　実行時に使用する物理マップを生成する。
　↓

「開発・実行ガイド」

┌──────────────────┐
│４．マップをＷＳで利用可能にする　　│
└┬─────────────────┘
　│・WSへマップを転送する。
　│・物理マップを実行環境に移行する。
　│・論理マップをAPコンパイル環境に
　│　移行する。
　↓

4.2節

4.3節

4.5節

┌──────────────────┐
│５．ＡＰをコーディングする　　　　　│
└┬─────────────────┘
　│・業務の流れに従って，画面の入出力
　│　および帳票出力をコーディングする。
　│・PC XMAP3のドキュメンテーション
　│　支援の情報を見て項目名などを確認する。
　↓

「プログラミングガイド　画面編」

「プログラミングガイド　帳票編」

5章

┌──────────────────┐
│６．ＡＰをコンパイル・リンケージする│
└┬─────────────────┘
　│・APのコンパイルと各実行ライブラリ
　│　とのリンケージを行う。
　↓

6章

┌──────────────────┐
│７．実行環境を設定する　　　　　　　│
└┬─────────────────┘
　│・開発環境のマップおよびプログラムを
　│　実行環境へ移す。
　│・各セットアップファイルを変更する。
　↓

7章

┌──────────────────┐
│８．ＡＰを実行する　　　　　　　　　│
└┬─────────────────┘
　│・XMAP3サーバを起動する。
　│・APを実行する。
　↓

8章

┌──────────────────┐
│９．デバッグとチューニング　　　　　│
└──────────────────┘

9章

（凡例）

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

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

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

4.1.2　書式オーバレイを開発する手順

書式オーバレイの開発から実行までの手順を示します。各項目の詳細については，「参照」欄に記述したマニュアルおよび記述場所を参照してください。

表4-2　書式オーバレイの開発からAPの実行までの手順

開発から実行までの手順
参照

┌──────────────────┐
│１．書式のレイアウトを決める　　　　│
└┬─────────────────┘
　│・各項目のレイアウトを決める。
　↓

「プログラミングガイド　帳票編」

┌──────────────────┐
│２．書式を定義する　　　　　　　　　│
└┬─────────────────┘
　│・PC XMAP3のドローを用いて
　│　ワープロイメージで定義する。
　↓

「プログラミングガイド　帳票編」

┌──────────────────┐
│３．書式イメージおよび行制御データを│
│　　生成する　　　　　　　　　　　　│
└┬─────────────────┘
　│・PC XMAP3によって，実行時に
　│　使用する書式イメージおよび行制御
　│　データを生成する。
　↓

「開発・実行ガイド」

┌──────────────────┐
│４．書式イメージおよび行制御データを│
│　　ＷＳで利用可能にする　　　　　　│
└┬─────────────────┘
　│・WSへ書式イメージおよび行制御データ
　│　を転送する。
　│・書式イメージおよび行制御データの
　│　形式チェックを実行する。
　↓

4.2節

4.4節

┌──────────────────┐
│５．ＡＰをコーディングする　　　　　│
└┬─────────────────┘
　│・業務の流れに従って，
　│　書式出力をコーディングする。
　│・PC XMAP3のドキュメンテーション支援
　│　の情報を見て行データの位置などを
　│　確認する。
　↓

「プログラミングガイド　帳票編」

5章

┌──────────────────┐
│６．ＡＰをコンパイルとリンケージする│
└┬─────────────────┘
　│・APのコンパイルと各実行ライブラリ
　│　とのリンケージを行う。
　↓

6.2節

6.3節

┌──────────────────┐
│７．実行環境を設定する　　　　　　　│
└┬─────────────────┘
　│・開発環境の書式イメージ，行制御データ，
　│　およびプログラムを実行環境へ移す。
　│・各セットアップファイルを変更する。
　↓

7章

┌──────────────────┐
│８．ＡＰを実行する　　　　　　　　　│
└┬─────────────────┘
　│・XMAP3サーバを起動する。
　│・APを実行する。
　↓

8章

6.4節

6.5節

┌──────────────────┐
│９．デバッグとチューニング　　　　　│
└──────────────────┘

9章

（凡例）

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

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

4.2　PC XMAP3で作成したファイルの転送

PC XMAP3でWS用に作成した物理マップ，論理マップおよび動的変更テーブルをWSへファイル転送します。

＜この節の構成＞

4.2.1　物理マップのファイル転送

4.2.2　論理マップ・動的変更テーブルのファイル転送

4.2.3　書式イメージ・行制御データのファイル転送（AIX，HP-UX，Solaris）

4.2.1　物理マップのファイル転送

＜この項の構成＞

(1)　ファイル転送時の注意事項

(2)　ファイルの転送方法

(1)　ファイル転送時の注意事項

PC XMAP3でWS用に作成した物理マップ（拡張子「.pmp」）ファイルは，バイナリ形式でファイル転送する必要があります。

ファイルの拡張子はそのままでファイル転送してください（WS上での拡張子は英小文字にする必要があります）。

(2)　ファイルの転送方法

ftpコマンドによる物理マップのファイル転送手順を次に示します。

MS-DOS(R)のコマンドプロンプトを起動し，カレントディレクトリを物理マップ格納ディレクトリに変更する。

ftpコマンドを実行する。

ftp △ 転送先ホスト名

ユーザ名，パスワードを入力する。

転送モードをバイナリに変更する。

ftp > bin

物理マップを転送する。

ftp > put △ 物理マップ名.pmp

ftpコマンドを終了する。

ftp > bye

注意事項

ログイン後のカレントディレクトリは，ユーザ名に対応するホームディレクトリとなります。

物理マップ格納ディレクトリ下のすべてのファイルを転送する場合は，次のとおり実行してください。

　ftp > prompt
　ftp > mput △ *.pmp

4.2.2　論理マップ・動的変更テーブルのファイル転送

＜この項の構成＞

(1)　ファイル転送時の注意事項

(2)　ファイルの転送方法

(1)　ファイル転送時の注意事項

PC XMAP3でWS用に作成した論理マップ（拡張子「.cbl」）ファイルおよび動的変更テーブル（X3MODTBL.cblまたはX3MODTBL.h）ファイルは，テキスト形式でファイル転送する必要があります。

ファイルの拡張子はそのままでファイル転送してください。

(2)　ファイルの転送方法

(a)　動的変更テーブルの標準出力先

PC XMAP3で作成する動的変更テーブルは，標準の出力先のままで作成した場合，次の場所に出力されています。別の出力先に作成した場合は，そのファイルをファイル転送してください。

PC XMAP3インストール先フォルダ¥INCLUDE¥X3MODTBL.cbl
PC XMAP3インストール先フォルダ¥INCLUDE¥X3MODTBL.h

(b)　転送手順

ftpコマンドによる論理マップのファイル転送手順を次に示します。

MS-DOSのコマンドプロンプトを起動し，カレントディレクトリを論理マップ格納ディレクトリに変更する。

ftpコマンドを実行する。

ftp △ 転送先ホスト名

ユーザ名，パスワードを入力する。

論理マップを転送する。

ftp > put △ 論理マップ名.cblまたは論理マップ名.h

ftpコマンドを終了する。

ftp > bye

注意事項

ログイン後のカレントディレクトリは，ユーザ名に対応するホームディレクトリとなります。

論理マップ格納ディレクトリ下のすべてのファイルを転送する場合は，次のとおり実行してください。

　ftp > prompt
　ftp > mput △ *.cblまたは*.h

4.2.3　書式イメージ・行制御データのファイル転送（AIX，HP-UX，Solaris）

PC XMAP3で生成される書式イメージ，行制御データをWSへファイル転送します。

＜この項の構成＞

(1)　ファイル転送時の注意事項

(2)　ファイルの転送方法

(1)　ファイル転送時の注意事項

PC XMAP3で作成した書式イメージ（拡張子「.fmp」）ファイル，行制御データ（拡張子「.pci」）ファイルは，バイナリ形式でファイル転送する必要があります。

ファイルの拡張子はそのままでファイル転送してください（WS上での拡張子は英小文字にする必要があります）。

(2)　ファイルの転送方法

ftpコマンドによる書式イメージ，行制御データのファイル転送方法を次に示します。

MS-DOSのコマンドプロンプトを起動し，カレントディレクトリを書式イメージファイル，行制御データファイルが格納されているディレクトリに変更する。

ftpコマンドを実行する。

ftp△転送先ホスト名

ユーザ名，パスワードを入力する。

転送モードをバイナリに変更する。

ftp > bin

書式イメージ，行制御データのファイルを転送する。

ftp > put△書式イメージファイル名.fmpまたは行制御データファイル名.pci

ftpコマンドを終了する。

ftp > bye

注意事項

ログイン後のカレントディレクトリは，ユーザ名に対応するホームディレクトリとなります。

書式イメージファイル，行制御データファイル格納ディレクトリ下のすべてファイルを転送する場合は，次のとおり実行してください。

　ftp > prompt
　ftp > mput△*.fmpまたは*.pci

4.3　物理マップの移行

PC XMAP3で作成したWS用の物理マップは，WS側へ転送したあと，cmapcpコマンドを実行して実行環境に移行します。

＜この節の構成＞

4.3.1　コマンドの概要

4.3.2　コマンドの使用方法

4.3.1　コマンドの概要

cmapcpコマンドは，次に示すファイルを実行環境に移行し，さらにXMAP3 Serverで使用できる物理マップの形式かどうかのチェックをします。

なお，形式のチェックでは実行環境で参照するすべての情報はチェックしませんので，実行環境でエラーとなる場合があります。

拡張子が「.pmap」の物理マップファイル

拡張子が「.pmp」の物理マップファイル

4.3.2　コマンドの使用方法

＜この項の構成＞

(1)　形式

(2)　機能

(3)　オプション

(4)　環境変数の設定

(5)　実行結果

(6)　実行時のエラー

(1)　形式

cmapcp　〔オプション〕

(2)　機能

対象の拡張子を削除したファイル名でファイルを複写します。

(3)　オプション

- i dir

対象の拡張子が付けられたファイルをサーチするディレクトリの名称を指定します。入力ディレクトリ下のすべてのディレクトリをサーチの対象とします。省略時はカレントディレクトリを入力ディレクトリとします。

- o dir

ファイル名から拡張子を削除したファイルを出力するディレクトリの名称を指定します。省略時はカレントディレクトリにファイルを出力します。

(4)　環境変数の設定

コマンドを実行する前に，環境変数PATHに，/opt/HIXMAP/binを設定してください。

(5)　実行結果

cmapcpコマンドを実行した結果は，次の内容で標準出力に出力されます。

なお，形式チェックの結果が正常なファイルについては，ファイル名は出力されません。

注※　

エラーメッセージの内容については，「(6)　実行時のエラー」を参照してください。

(6)　実行時のエラー

cmapcpコマンド実行時にエラーが発生した場合，次のエラーメッセージが標準出力に出力されます。

表4-3　cmapcpコマンド実行時のエラーメッセージ

出力メッセージ
エラー内容

Physicalmap endian error.（file：ファイル名）
物理マップのエンディアンが不正です。
(S)処理を続行します。
(P)実行環境に合ったエンディアンとなるように，物理マップを再作成します。

Physicalmap is broken.（file：ファイル名）
物理マップの形式が不正です。
ファイル転送時にテキストファイルとして転送している場合が考えられます。
(S)処理を続行します。
(P)ファイル転送に誤りがないか確認し，正しい物理マップを指定します。

Physicalmap version error.（file：ファイル名）
物理マップ作成時のバージョンが合っていません。PC XMAP3のバージョンがXMAP3 Serverよりも新しいため，XMAP3 Serverで使用できません。
(S)処理を続行します。
(P)PC XMAP3のバージョンに合うXMAP3 Serverを使用し，再実行します。

cmapcp error.
コマンド実行できないエラーが発生しました。
(S)処理を終了します。
(P)WS上のリソース不足やファイル参照できない環境になっていないか確認し，問題を解決して再実行します。

（凡例）

(S)：システムの対処

(P)：プログラマの対処

4.4　書式イメージ・行制御データの形式チェック（AIX，HP-UX，Solaris）

PC XMAP3でWS用に作成した書式イメージファイル，行制御データファイルをWS側へ転送したあと，mapfchkコマンドを使って，ファイルの形式チェックを実行します。

＜この節の構成＞

4.4.1　コマンドの概要

4.4.2　コマンドの使用方法

4.4.1　コマンドの概要

mapfchkコマンドは，次のファイルを対象にファイルの形式チェックを実行します。

なお，形式チェックでは実行環境で参照するすべての情報はチェックしませんので，実行環境でエラーとなる場合があります。

拡張子が「.fmp」の書式イメージファイル

拡張子が「.pci」の行制御データファイル

4.4.2　コマンドの使用方法

＜この項の構成＞

(1)　形式

(2)　機能

(3)　オプション

(4)　環境変数の設定

(5)　実行結果

(6)　実行時のエラー

(1)　形式

mapfchk  ［オプション］

(2)　機能

対象ファイルの形式をチェックします。

(3)　オプション

-i dir

対象の拡張子が付けられているファイルをサーチするディレクトリの名称を指定します。入力ディレクトリ下のすべてのディレクトリをサーチの対象とします。

省略時はカレントディレクトリを入力ディレクトリとします。

-h

ヘルプ情報を出力します。

(4)　環境変数の設定

コマンドを実行する前に，環境変数PATHに，/opt/HIXMAP/binを設定してください。

(5)　実行結果

mapfchkコマンドを実行した結果は，次の内容で標準出力に出力されます。

なお，形式チェックの結果が正常なファイルについては，ファイル名は出力されません。

注※　

エラーメッセージの内容については，「(6)　実行時のエラー」を参照してください。

(6)　実行時のエラー

mapfchkコマンド実行時にエラーが発生した場合，次のエラーメッセージが標準出力に出力されます。

表4-4　mapfchkコマンド実行時のエラーメッセージ

出力メッセージ
エラー内容

Formmap endian error.（file：ファイル名）
物理マップのエンディアンが不正です。
(S)処理を続行します。
(P)実行環境に合ったエンディアンとなるように，物理マップを再作成します。

Formmap is broken.（file：ファイル名)
書式イメージファイルの形式が不正です。
ファイル転送時にテキストファイルとして転送している場合が考えられます。
(S)処理を続行します。
(P)ファイル転送に誤りがないか確認し，正しい書式イメージファイルを指定します。

Formmap version error.（file：ファイル名）
書式イメージファイル作成時のバージョンが合っていません。PC XMAP3のバージョンがXMAP3 Serverよりも新しいため，XMAP3 Serverで使用できません。
(S)処理を続行します。
(P)PC XMAP3のバージョンに合うXMAP3 Serverを使用し，再実行します。

Pagec module is broken.（file：ファイル名）
行制御データファイルの形式が不正です。
ファイル転送時にテキストファイルとして転送している場合が考えられます。
(S)処理を続行します。
(P)ファイル転送に誤りがないか確認し，正しい行制御データファイルを指定します。

Pagec module version error.（file：ファイル名）
行制御データファイル作成時のバージョンが合っていません。PC XMAP3のバージョンがXMAP3 Serverよりも新しいため，XMAP3 Serverで使用できません。
(S)処理を続行します。
(P)PC XMAP3のバージョンに合うXMAP3 Serverを使用し，再実行します。

mapfchk error.
コマンド実行できないエラーが発生しました。
(S)処理を終了します。
(P)WS上のリソース不足やファイル参照できない環境になっていないか確認し，問題を解決して再実行します。

指定オプション option error.
コマンドに指定されたオプションに誤りがあります。
(S)処理を終了します。
(P)指定したオプションを見直し，再実行します。

指定ディレクトリ is not exist.
コマンドに指定されたディレクトリが存在しません。
(S)処理を終了します。
(P)正しいディレクトリを指定し，再実行します。

（凡例）

(S)：システムの対処

(P)：プログラマの対処

4.5　論理マップおよび動的変更テーブルの文字コード変換（AIX，Linux，Solaris）

PC XMAP3で生成される論理マップおよび動的変更ファイルは，文字コードがシフトJISであるため，AIX，LinuxおよびSolarisのEUC環境で利用するには，ファイルを転送したあと，シフトJISからEUCへコード変換する必要があります。

コマンド
文字コードをシフトJISからEUCに変換するには，iconvコマンドを実行します。

変換例
iconvコマンドによる変換例をOSごとに示します。ここでは，論理マップおよび動的変更ファイルがCOBOLの場合を例にしています。

＜AIX（EUC環境）＞

iconv -f IBM-932 -t IBM-eucJP X3MODTBL.cbl > /tmp/X3MODTBL.cbl
iconv -f IBM-932 -t IBM-eucJP MAP001I.cbl > /tmp/MAP001I.cbl

＜Linux＞

iconv -f sjis -t ujis X3MODTBL.cbl > /tmp/X3MODTBL.cbl
iconv -f sjis -t ujis MAP001I.cbl > /tmp/MAP001I.cbl

＜Solaris（EUC環境）＞

iconv -f SJIS -t eucJP X3MODTBL.cbl > /tmp/X3MODTBL.cbl
iconv -f SJIS -t eucJP MAP001I.cbl > /tmp/MAP001I.cbl

注意事項

AIX，LinuxおよびSolarisのEUC環境では，論理マップおよび動的変更テーブルの文字コードをEUC以外のコードで，COBOL APをコンパイルするとソースファイルの形式不正でエラーとなります。詳細については，日立COBOLのマニュアルを参照してください。

5.　アプリケーションの開発

この章では，アプリケーションプログラムのコーディングについて説明します。

＜この章の構成＞

5.1　XMAP3 ServerのAPインタフェース

5.2　COBOLの画面入出力および帳票出力命令

5.3　COBOLの書式印刷命令（AIX，HP-UX，Solaris）

5.4　C言語の画面入出力および帳票出力命令

5.5　C言語の書式印刷命令（AIX，HP-UX，Solaris）

5.6　C言語固有のコーディング例

5.7　その他のコーディング上で必要な知識

5.8　標準パターン

5.9　標準パターンを使用した機能別の作成例（COBOL）

5.1　XMAP3 ServerのAPインタフェース

XMAP3 ServerのAPインタフェースについて説明します。なお，XMAP3のAPインタフェース（ライブラリ）は，マルチスレッドで動作するAPからの実行に対応していません。

＜この節の構成＞

5.1.1　XMAP3 Serverでの画面入出力および帳票出力の基本

5.1.2　XMAP3 Serverでの書式出力の基本（AIX，HP-UX，Solaris）

5.1.3　アプリケーションプログラム間でオープンを引き継ぐ場合

5.1.4　アプリケーションプログラム分割時の注意

5.1.5　アプリケーションプログラムでの入力論理マップ上のデータチェック

5.1.1　XMAP3 Serverでの画面入出力および帳票出力の基本

＜この項の構成＞

(1)　APインタフェースの種類

(2)　APインタフェースの概要

(1)　APインタフェースの種類

XMAP3 Serverで画面入出力および帳票出力をするための実行支援には，三つのAPインタフェースがあります。

解説

日立COBOLインタフェース
COBOL言語仕様に取り込まれた言語インタフェースです。日立COBOLで使用できます。すべてのOSで共用できる文法です。

CALLインタフェース
COBOLのCALLインタフェースで呼び出す方法です。日立COBOLなど，標準CALLインタフェースを持つCOBOL言語から使用できます。

C言語インタフェース
XMAP3 Server共通のC言語用APインタフェースです。すべてのOSで共用できる文法です。

(2)　APインタフェースの概要

APからXMAP3 Serverを使用するときの命令を表5-1に示します。また，APとXMAP3 Serverの間で渡される情報を図5-1に示します。

表5-1　XMAP3 Serverでの画面入出力および帳票出力の基本

要求
日立COBOLの命令
COBOLのCALL文
C言語

オープン
最初のSEND文またはTRANSCEIVE文発行時
「OPEN」
「MDO△」
要求
「OPEN」
「MDO△」
要求

画面出力または帳票出力
SEND文またはTRANSCEIVE文
「SEND」要求
「SEND」要求

画面入力
RECEIVE文またはTRANSCEIVE文
「RECV」要求
「RECV」要求

クローズ
DISABLE文，EXIT PROGRAM文，（APの）STOP RUN文
「CLOS」要求
「CLOS」要求

図5-1　XMAP3 ServerとAP間のデータのやり取り（画面入出力および帳票出力）

注※

必ず指定します。

5.1.2　XMAP3 Serverでの書式出力の基本（AIX，HP-UX，Solaris）

＜この項の構成＞

(1)　APインタフェースの種類

(2)　APインタフェースの概要

(1)　APインタフェースの種類

XMAP3 Serverで書式出力を実行するための実行支援には，三つのAPインタフェースがあります。

解説

日立COBOLインタフェース
レコード名または一意名のCHARACTER TYPE句で行単位の表示属性を指定します。
WRITE文で書き出します。

C言語インタフェース
jstqlctp関数を使用して行単位の表示属性を指定します。

書式オーバレイ印刷ユティリティ
行データをユーザ追加処理でテキストファイルに出力して，このユティリティの入力とします。

(2)　APインタフェースの概要

書式用APでのXMAP3を使用するときの命令を次に示します。

表5-2　XMAP3での書式出力の基本

要求 | 日立COBOLの命令 | C言語
オープン | OPEN文 | jstqlopn関数
行の出力要求 | WRITE文 | jstqldat関数
印刷要求 | WRITE文（PAGE指定）またはCLOSE文 | jstqllpt関数
クローズ | CLOSE文 | jstqlcls関数

書式用APとXMAP3の間で渡される情報を次に示します。

図5-2　XMAP3とAP間のデータのやり取り（書式出力）

5.1.3　アプリケーションプログラム間でオープンを引き継ぐ場合

メッセージを出す共通部分を別ライブラリ化したり，プログラムが大きいので分割したりする場合などは，オープンをプログラム間で引き継がせることで不要なオープン／クローズを抑止できます。オープンを引き継ぐためには，日立COBOLの場合，APを実行する前に環境変数「CBLTERMSHAR=YES」を指定しておくことで実現します。なお，「CBLTERMSHAR=YES」は，SEND/RECEIVE/TRANSCEIVEインタフェースのときだけ有効であり，CALLインタフェースでは無効になります。

オープンを引き継ぐことによって，AP1からAP2を呼び出すとき，AP1でのクローズ（日立COBOLのときDISABLE文の発行）およびAP2でのオープンは発生しません。そのため画面遷移の時間が短くなります。

図5-3　アプリケーション間でオープンを引き継ぐ場合

5.1.4　アプリケーションプログラム分割時の注意

日立COBOLでは，明示的にCALL文でオープンを要求する場合を除き，一つのコンパイル単位で最初のSEND文またはTRANSCEIVE文が発行されると画面がオープンされます。そのため，1画面が1実行可能ファイルのような構成にすると，画面ごとにオープンをすることになります。この場合，オープン・クローズ，SEND文またはTRANSCEIVE文を発行する実行可能ファイル，ビジネス処理をする実行可能ファイルをそれぞれ分けた方が実行性能が高くなります。ビジネス処理をする実行可能ファイルは，共用ライブラリでも代用できます。実行可能ファイルにするか共用ライブラリにするかは，処理の形態によって次のように使い分けます。

実行可能ファイル：メニュー画面など処理が続く場合（実行可能ファイル間でのデータの受け渡しはない）

共用ライブラリ：処理が単独で閉じる場合（1ウィンドウで閉じる）

また，複数のコンパイル単位のものを合わせて一つの実行可能ファイルにするときは，各コンパイル単位でオープンを発行しないようにするため，日立COBOLの実行支援の環境変数で，「CBLTERMSHAR=YES」を指定します。なお，「CBLTERMSHAR=YES」はSEND/RECEIVE/TRANSCEIVEインタフェースのときだけ有効であり，CALLインタフェースでは無効になります。

CALLインタフェースの場合，または「CBLTERMSHAR」をサポートしていないバージョンの日立COBOLを使用している場合で，AP間のオープン引き継ぎをするときは，ユーザがXMAP3 Serverインタフェースエリアの情報を引き継ぐようなコーディングをする必要があります。サンプルコーディングとしてAPパターンのGENDSP02およびGENDSP03が利用できます。

＜この項の構成＞

(1)　メインの実行可能ファイルから別の実行可能ファイルを呼び出す場合

(2)　新しい画面を表示するとき前の画面を消さないで表示しておくケース

(3)　新しい画面を表示するとき前の画面を消す場合

(4)　一つの表示サービスに複数画面表示する場合

(1)　メインの実行可能ファイルから別の実行可能ファイルを呼び出す場合

メインメニュー（AP1）から各サブプログラム（AP2～n）を呼び出すケースを図5-4に示します。

図5-4　メインメニュー（AP1）から各サブプログラム（AP2～n）を呼び出すケース

AP1，AP2～nの各APで，オープン～クローズを実行します。

AP1からAP2～nを呼び出すときは，表示している画面を一度消してから，新しい画面を表示し直します。

(2)　新しい画面を表示するとき前の画面を消さないで表示しておくケース

AP1からAP2～nを呼び出すとき，AP1の画面を消さないで表示しておくケースを図5-5に示します。ただし，この方法ではAPの動作が遅くなります。

図5-5　AP1からAP2～nを呼び出すとき，AP1の画面を消さないで表示しておくケース

AP1で画面をオープンし，AP2～nを呼び出します。

AP2～nでオープン～クローズを実行します。

(3)　新しい画面を表示するとき前の画面を消す場合

AP1からAP2～nを呼び出すとき，AP1の画面を消してAP2を表示するケースを図5-6に示します。ただし，この方法ではAPの動作が遅くなります。

図5-6　AP1からAP2～nを呼び出すとき，AP1の画面を消してAP2を表示するケース

注※

DISABLE文を発行します（COBOLだけ）。

(4)　一つの表示サービスに複数画面表示する場合

C/SおよびOLTP（TP1/NET/XMAP3）構成で，一つの表示サービスに対して複数の画面を表示する場合，同時に表示できる画面数（GUI画面の場合は，一次／二次ウィンドウの総数）は15個までです。16個以上の画面表示を要求するとエラー（ログ情報に出力される詳細コードが「0x01001303」エラー）となり，16個目からの画面は表示されませんので注意してください。ログ情報に出力される詳細コードについては，「9.7　AP実行時の詳細エラーコード」を参照してください。

5.1.5　アプリケーションプログラムでの入力論理マップ上のデータチェック

＜この項の構成＞

(1)　イベント通知コード

(2)　フォーカス／カーソル位置のチェック

(1)　イベント通知コード

画面送信時のイベント通知コード（例えば，PF1キーではPF01）を返します。イベント通知コードの値は，PC XMAP3のドローセットアップで変更できます。

(2)　フォーカス／カーソル位置のチェック

画面送信時に，どのオブジェクトにフォーカス／カーソルが位置づいているかをチェックできます。

(a)　フォーカス位置の通知（GUI画面の場合）

画面送信時のフォーカス位置を，論理定数で返します。

論理定数は，例えば，入出力テキスト定義でデータ名をMAP001-FIELD0001-に設定した場合は，MAP001-FIELD0001-Tの名称で論理マップ中に生成されます。この論理定数とフォーカス定数の一致するオブジェクトが，画面入力時のフォーカス位置になります。

(b)　カーソル位置の通知

画面送信時のカーソル位置を，論理定数で返します。

論理定数は，例えば，入出力テキスト定義でデータ名をMAP001-FIELD0001-に設定した場合は，MAP001-FIELD0001-Tの名称で論理マップ中に生成されます。

この論理定数とカーソル定数の一致するオブジェクトが，画面入力時のカーソル位置になります。

PC XMAP3のドローセットアップで行列（2進）カーソルに変更できます。

5.2　COBOLの画面入出力および帳票出力命令

＜この節の構成＞

5.2.1　論理マップの取り込み方法

5.2.2　スタンドアロン環境，およびC/S環境下での画面入出力および帳票出力命令

5.2.1　論理マップの取り込み方法

アプリケーションプログラム中に論理マップを取り込む場合，COBOL言語のWORKING STORAGE SECTION，またはLINKAGE SECTIONにCOPY文を指定します。ただし，論理マップ中に定数を展開しているものについては，LINKAGE SECTIONに取り込むことはできません。

アプリケーションプログラムに論理マップMAP003OとMAP003Iを取り込む例を次に示します。

（取り込みの例）

5.2.2　スタンドアロン環境，およびC/S環境下での画面入出力および帳票出力命令

マップドライバを使ったスタンドアロン環境およびC/S環境下では，次に示す方法でアプリケーションプログラムからWS，PCに対する帳票印刷およびPCに対する画面の入出力ができます。

日立COBOLのSEND文，RECEIVE文およびTRANSCEIVE文による方法

COBOL言語のCALL文による方法

＜この項の構成＞

(1)　SEND文，RECEIVE文およびTRANSCEIVE文による方法

(2)　CALL文による方法

(1)　SEND文，RECEIVE文およびTRANSCEIVE文による方法

GUI画面で受注伝票発行業務（メニュー画面）を出力したあと，クリックされたプッシュボタンを判定し，「受注データ修正：ヘッダ画面」（データ入力画面）を出力するまでのコーディングを図5-7に示します。

図5-7　コーディング例

日立COBOLのSEND文，RECEIVE文およびTRANSCEIVE文によって画面の入出力をする方法について指定例を使用して説明します。

詳細については，マニュアル「COBOL2002　言語　標準仕様編」またはマニュアル「COBOL85　言語」を参照してください。

(a)　通信記述項

画面の入出力に必要な情報をCOMMUNICATION SECTION中に指定します。

（例）

注

1，2，3は必ず指定します。5は画面入出力時に必ず指定します。ほかの項目は，必要に応じて指定します。

〈例の説明〉

通信記述名（必須）

DSP：画面入出力時に，SEND文，RECEIVE文およびTRANSCEIVE文で使用する名称

PRT：シリアル／ページプリンタ出力時，SEND文で使用する名称

通信種別（必須）

I-O WS：ディスプレイへの画面入出力用であることを示します。

OUTPUT WS：シリアル／ページプリンタへの帳票印刷用であることを示します。

物理マップ名称格納エリア（必須）
SEND文，RECEIVE文およびTRANSCEIVE文で出力，または入力する場合に物理マップ名称を格納するエリアです。格納するマップ名には，次に示すデバイスIDを付ける必要があります。

GUI画面の場合：ND

CUI画面の場合：NC

シリアルプリンタ（けい線帳票）の場合：6A

シリアルプリンタ（プレプリント帳票）の場合：6H

ページプリンタ（網掛け帳票）の場合：6B

ページプリンタ（グラフィック帳票）の場合：6G

仮想端末名格納エリア
最初のSEND文およびTRANSCEIVE文を実行する前に，仮想端末名を格納しておくエリアです。仮想端末定義ファイル（XMAPhosts）で定義した仮想端末名を指定します。正しい名称を指定しないと，実行時に表示・印刷先が決定できなくなりエラーになります。
SYMBOLIC TERMINAL句を省略した場合は，仮想端末定義ファイルの先頭に定義されている仮想端末名が格納されているものとして入出力が実行されます。

マッピングオプション（画面入出力時必須，帳票印刷時不要）
論理マップ，または物理マップのマッピング方式を指定します。詳細については，「5.2.2(1)(f)　MAPPING MODE句の扱い（マッピングオプション）」を参照してください。

リターンコード格納エリア
SEND文，RECEIVE文およびTRANSCEIVE文のリターンコードを格納するエリアです。SEND文，RECEIVE文およびTRANSCEIVE文が正常に処理されたかを判定する場合，このエリアを参照します。詳細については，「5.2.2(1)(g)　STATUS KEY句のリターンコード」を参照してください。

データ有無コード格納エリア
データ有無コードを変更する場合には，最初のSEND文を実行する前にデータ有無コードを格納しておく必要があります。「DATA ABSENCE CODE IS」を省略すると，データ有無コードとして標準の(1F)₁₆が仮定されます。

(b)　SEND文

ディスプレイへの画面表示，またはシリアル／ページプリンタへの帳票印刷を実行します。画面表示，帳票印刷時に変更したいデータは，出力論理マップへ格納したあとに実行します。

画面の出力から入力までの間にAPでほかの処理をする場合などに使用します。ただし，二次ウィンドウ，または二次ウィンドウがある一次ウィンドウの場合の入出力には，TRANSCEIVE文を使用してください。

（例）

(c)　RECEIVE文

ディスプレイからの画面入力を実行します。画面入力の結果は，入力論理マップに格納されます。SEND文と対で指定してください。

（例）

(d)　TRANSCEIVE文

ディスプレイでの画面の入出力をまとめて実行します。SEND文とRECEIVE文の機能を持ちます。通常の画面の入出力には，TRANSCEIVE文を使用します。

（例）

(e)　DISABLE文

AP中の最初のSEND文または，TRANSCEIVE文が発行されたとき，ディスプレイ，またはプリンタをオープンし，プログラム終了まで解放（クローズ）しません。

画面表示，または帳票印刷をしていないときは，ディスプレイ端末またはプリンタ端末を解放し，ほかのプログラムが表示，印刷できるようにDISABLE文を使用します。

「例」のようにコーディングすると，次のオープン命令が発行された場合，ディスプレイ上に表示されているウィンドウは閉じて，新たにウィンドウが表示されます。

（例）

(f)　MAPPING MODE句の扱い（マッピングオプション）

通信記述項のMAPPING MODE句には，画面を表示するときのオプションとしてディスプレイ用に次に示すものが指定できます。

目的
MAPPING MODE句の指定値
説明

2回目または1回目でユーザデータを表示したいとき
△，または0
〈マージ〉
論理マップに代入したデータと物理マップをマージして画面を表示します。同一画面を書き換えるときに使用します。
表示属性の変更要求をしないオブジェクト属性については，画面定義時に指定した表示属性となります。同じ画面に対し，2回目以降の表示では固定部分（タイトルやけい線）は再描画しません。

同じ画面に対して一部上書をしたいとき
2
〈論理マップだけ〉
論理マップに代入したデータを使用して画面を表示します。一般的に，2回目以降の表示で，入力した状態をそのままにして部分的に書き換えるときに使用します。
表示属性の変更指定をしないオブジェクト属性については，直前の表示属性となります。

ユーザデータなしで1回目（初期）表示用
3
〈物理マップだけ〉
論理項目，または制御項目に指定したデータを無視して，画面定義時の情報（物理マップ）だけで画面を表示します。論理マップをすべてデータ有無コードでクリアしたときと同じであり，メニューなどの初期表示に使用します。

(g)　STATUS KEY句のリターンコード

STATUS KEY句のリターンコードの意味を次に示します。

コード
意味
状態/要因/対処方法

00000
正常終了
データの入出力が正常に終了しました。

00008
論理エラー
COBOLのAPに誤りがあります。APに誤りがないかを調べて修正します。

10004
10008
マッピングエラー
画面データのマッピング中にエラーが発生しました。STATUS KEY句の指定がない場合，実行を中止します。STATUS KEY句の指定がある場合，処理を続行します。画面入出力時のリターンコードの内容を調査して対処する必要があります。※

20008
入出力エラー
画面データの入出力中にエラーが発生しました。STATUS KEY句の指定がない場合，実行を中止します。STATUS KEY句の指定がある場合，処理を続行します。画面入出力時のリターンコードの内容を調査して対処する必要があります。※

注※

画面入力時のリターンコードの内容については，「9.4　AP実行時のXMAP3 Serverのリターンコード」を参照してください。

なお，これらのリターンコードは標準出力に出力されます。

(2)　CALL文による方法

ここでは，COBOL言語のCALLインタフェースによってマップドライバを使用する方法を説明します。

(a)　CALL文の発行順序

マップドライバの機能と発行順序を図5-8に示します。

図5-8　マップドライバの機能と発行順序

注※1

ディスプレイとプリンタを使う場合それぞれに必要です。

注※2

画面・帳票数分を繰り返します。

注※3

マッピングオプション変更時に発行します。

注※4

ディスプレイからデータを入力する場合に必要であり，プリンタの場合は発行しません。

(b)　CALL命令

CALL命令の形式を次に示します。

XMAP-COM
共通インタフェース領域を指定します。形式の詳細を表5-3に示します。この領域は，画面・帳票を出力したい端末単位に作成し，オープンしたときの領域をクローズ要求まで引き継いで使用します。また，次に示す各要求時にマッピングおよび入出力I/Oに必要な情報をセットします。

オープン要求時：仮想端末名，通信種別を指定する。

出力要求時：物理マップ名称を指定する。

入力要求時：入力論理マップ長を指定する。

表5-3　共通インタフェース領域の形式（XMAP-COM）

データ項目名 | 長さ（位置） | データ形式 | 指定内容（データ名）
アイキャッチャ | 4 | X(4) | 「*XP△」とします（XMAP-COM-ID）
リターン値 | 2(4) | 9(4)COMP※ | 2進形式で格納（XMAP-COM-RTN）
リターン情報詳細 | 2(6) | 9(4)COMP※ | 2進形式で格納（XMAP-COM-RSN）
未使用 | 3(8) | X(3) | (00)₁₆とします（XMAP-COM-RSV1）
id区分 | 1(11) | X | 必ず「I」とします（XMAP-COM-ITYPE）
仮想端末名称 | 8(12) | X(8) | 仮想端末定義ファイルで指定した名称を左詰めで指定し，残りは空白とします。仮想端末名を省略して，空白を8バイトセットすると仮想端末定義ファイル中の先頭に定義された仮想端末名が仮定されます（XMAP-COM-TNAME）
未使用 | 4(20) | X(4) | (00)₁₆とします（XMAP-COM-RSV2）
通信種別 | 4(24) | X(4) | ディスプレイ要求時は，「BWS△」とし，プリンタ要求時は，「OWS△」とします（XMAP-COM-MSG）
未使用 | 44(28) | X(44) | (00)₁₆とします（XMAP-COM-RSV3）
マップ名称 | 8(72) | X(8) | 物理マップ名をデバイスID付きの左詰めで指定します。残りは空白です（XMAP-COM-MAPNAME）
未使用 | 2(80) | X(2) | (00)₁₆とします（XMAP-COM-RSV4）
未使用 | 6(82) | X(6) | (00)₁₆とします（XMAP-COM-PAGENAME）
入力論理マップ長 | 4(88) | S9（8）COMP※ | 入力論理マップ長を指定します（XMAP-COM-INLNG）
未使用 | 68(92) | X(68) | (00)₁₆とします（XMAP-COM-RSV5）

注※　

Linuxの場合は，「COMP-5」になります。

XMAP-REQ
要求インタフェース領域を指定します。形式を表5-4に示します。この領域は必ず指定してください。この領域を指定した内容によって，要求種別が決まります。

表5-4　要求インタフェース領域の形式（XMAP-REQ）

データ項目名
長さ（位置）
データ形式
指定内容（データ名）

要求種別
4
X(4)
OPEN：オープン要求
CLOS：クローズ要求
SEND：出力要求
RECV：入力要求
MDO△：オプション設定要求（XMAP-REQ-TYPE）

RECEIVEオプション
1(4)
X
F：入力要求時
△：上記以外（XMAP-REQ-OPT1）

SENDオプション
1(5)
X
1：出力要求時
△：上記以外（XMAP-REQ-OPT2）

未使用
2(6)
X(2)
「△△」とします（XMAP-REQ-RSV）

データ名3
入出力要求やオープン要求などの要求種別に応じて適切な内容を指定します。

出力要求時：出力論理マップを指定する。

入力要求時：入力論理マップを指定する。

オープン要求時：オープンインタフェース領域を指定する。形式の詳細を表5-5に示す。この領域は必ず指定する。

表5-5　オープンインタフェース領域の形式（XMAP-OPN）

データ項目名
長さ（位置）
データ形式
指定内容（データ名）

データ有無コード使用選択
1
X
1：データ有無コードを有効にします
その他：データ有無コードを無効にします（XMAP-OPN-DCODE-SET）

データ有無コード
1(1)
X
データ有無コードを指定します（XMAP-OPN-DCODE）

未使用
2(2)
X(2)
「△△」とします（XMAP-OPN-RSV）

クローズ要求時：0を指定する。

オプション設定要求時：1を指定する。

データ名4
オプション設定要求時は，マッピングインタフェース領域を指定します。形式の詳細を表5-6に示します。なお，マッピングオプションを指定しない場合は，0を指定します。

表5-6　マッピングインタフェース領域の形式（XMAP-MDO）

データ項目名
長さ（位置）
データ形式
指定内容（データ名）

マッピングオプション大分類
4
9(8)COMP※1
XMAP-MDO-SFLDの内容をセットします（XMAP-MDO-OPT1）

マッピングオプション小分類
4(4)
9(8)COMP※1
マージ：XMAP-MDO-MAPFLDの内容をセットします※2
物理マップだけ：XMAP-MDO-PHFLDの内容をセットします※2
論理マップだけ：MAP-MDO-LOGFLDの内容をセットします※2（XMAP-MDO-OPT2）

注※1

Linuxの場合は，「COMP-5」になります。

注※2

詳細は「5.2.2(1)(f)　MAPPING MODE句の扱い（マッピングオプション）」を参照してください。

(i)インタフェース領域の取り込み方法

XMAP3 Serverが提供しているインタフェース領域（JSVWATBL.cbl）をアプリケーションプログラムに取り込む場合，COBOL言語のWORKING STORAGE SECTION，またはLINKAGE SECTIONにCOPY文を指定します。また，コンパイルする前にJSVWATBL.cblのディレクトリ名をCBLLIBに設定しておいてください。

インタフェース領域を図5-9に示します。

図5-9　インタフェース領域

(ii)オープン要求

CALL命令を使用する場合，画面・帳票を表示，印字したい端末に付けた仮想端末名単位にオープン要求を実行します。複数の仮想端末（ディスプレイとプリンタ）をオープン要求する場合，インタフェース領域は，仮想端末ごとに用意します。

（例）

注※

SPACEをセットした場合は，仮想端末定義ファイルの先頭に定義された仮想端末名が仮定されます。

(iii)オプション設定要求

仮想端末へ画面表示，帳票印刷をする場合，マッピングオプションを指定できます。オープン要求で使った共通インタフェース領域を引き継いで使います。

（例）

(iv)出力要求

オープン要求した仮想端末へ画面表示，帳票印刷を実行します。オープン要求で使用した共通インタフェース領域を引き継いで使用します。

（例）

(v)入力要求

入力要求によって，画面から入力した情報をアプリケーションプログラムへ入力します。画面表示要求で使用したインタフェース領域を引き継いで使用します。ただし，プリンタの場合は指定できません。

（例）

(vi)クローズ要求

仮想端末をクローズします。オープン要求，出力要求および入力要求で使用したインタフェース領域を引き継いで使用します。

（例）

(vii)コーディング例

CALL文を使ったアプリケーションプログラムのコーディングについては，標準提供例題プログラムのソースファイルを参照してください。なお，ソースファイルのファイル名称については「付録A　提供ファイル一覧」を参照してください。

5.3　COBOLの書式印刷命令（AIX，HP-UX，Solaris）

ここでは，COBOL言語を使用した書式オーバレイのAPのコーディング方法について説明します。なお，詳細については，マニュアル「COBOL2002　使用の手引　手引編」およびマニュアル「COBOL2002　言語　標準仕様編」，またはマニュアル「COBOL85　使用の手引」およびマニュアル「COBOL85　言語」を参照してください。

＜この節の構成＞

5.3.1　プリンタ出力用ファイルの定義

5.3.2　印刷する書式の設定

5.3.3　行データの帳票印刷

5.3.1　プリンタ出力用ファイルの定義

プリンタ出力するファイルは，INPUT-OUTPUT SECTIONで順編成を宣言します。

印刷サービス名称は，日立COBOLの環境変数「CBLX_外部装置名=印刷サービス名称」で，サービス名ファイル（/etc/opt/HIXMAP/XPWhosts）に設定した出力先の印刷用サービス名称を指定します。AP実行時，印刷サービス名称は，SELECT句で宣言したプリンタ出力用ファイルのASSIGN句で指定した外部装置名に割り当てられます。

（例）

(a)　例の説明

プリンタ出力するファイルの宣言
プリンタ出力するファイルを順編成として宣言します。
日立COBOLの環境変数「CBLX_外部装置名」の外部装置名はASSIGNで指定した外部装置名に割り当てられます。

5.3.2　印刷する書式の設定

印刷する書式の名称（書式オーバレイ名称）を指定します。書式を設定する場合，I-O-CONTROLに，APPLY　FORMS-OVERLAY句で出力する書式オーバレイ名称を格納するエリアを指定します。このエリアに格納した書式オーバレイを重ねて印刷できます。

（例）

(a)　例の説明

書式名格納エリア
書式名のエリアに格納された書式オーバレイを使用して，プリンタに指定したプリンタ出力用ファイルに対して印刷します。

書式オーバレイ名称の格納
書式名格納エリアに書式オーバレイ名称を格納します。書式オーバレイ名称には，書式イメージファイルの拡張子「.fmp」なしの名称を指定します。印刷する書式を変更する場合は，書式名格納エリアの内容を書き換えます。書式名は必ず指定します。
なお，環境変数「XMAP3_FMP」に書式名を指定する方法もあります。環境変数での書式名を有効にする場合は，書式名格納エリアに必ずNULLまたは空白だけを格納してください。環境変数については，「6.3　書式オーバレイ印刷時の環境変数（AIX，HP-UX，Solaris）」を参照してください。
書式オーバレイなしの行データだけの印刷はできません。ただし，何も定義していない空の書式を指定すると，行データだけの印刷ができます。

5.3.3　行データの帳票印刷

APから書式印刷をする場合，印刷用ファイルへ行データを出力するためにPROCEDURE DIVISIONで指定する文を次に示します。

また，APで行データをコーディングするときに，印刷時のずれを防ぐために設定する行データの属性と指定値を「(2)　行データの属性の設定」に示します。

＜この項の構成＞

(1)　書式印刷するときのPROCEDURE DIVISIONの指定

(2)　行データの属性の設定

(1)　書式印刷するときのPROCEDURE DIVISIONの指定

表5-7　PROCEDURE DIVISIONで指定する文

命令文
内容

オープン
（OPEN文）
プリンタ出力用ファイルの処理を開始する準備をします。OPEN文のモードに出力専用（OUTPUT）を指定して実行します。

出力
（WRITE文）
レコードをプリンタ出力用ファイルに書き出します。明示的または間接的※にADVANCING指定をします。

クローズ
（CLOSE文）
プリンタ出力用ファイルの処理を終了します。

注※　

同じファイルに対するほかのWRITE文にADVANCING指定されていることを意味します。

（例）

(a)　コーディング例の説明

プリンタのオープン
FILE-CONTROLで指定した出力先のプリンタをオープンします。

プリンタへのレコードの書き出し

データ名で指定した領域の内容が行データに指定した領域に格納されたあと，行データを出力先のプリンタに書き出します。WRITE文で書き出されたレコードの内容は，使用できなくなります。

AFTER：ADVANCING以降の記述内容を実行したあと，WRITE文が実行されます。

BEFORE：WRITE文を実行したあと，ADVANCING以降の記述内容が実行されます。

ADVANCING：行送り（改行）または改ページを指定します。

n LINE（S）：nに指定した分だけ改行します。nが1の場合は「1　LINE」になり，nが2以上の場合は「n　LINES」になります。

呼び名：CSP（改行しない），またはC01（改ページする）を指定します。

PAGE：改ページします。

プリンタのクローズ
オープンした出力先のプリンタをクローズします。

(2)　行データの属性の設定

書式印刷時にずれを生じさせないように，書式設計前にAPで行データの属性を決定しておきます。APで設定できる属性と指定値を次に示します。

表5-8　行データの属性と指定値

属性 | 指定値 | 内容
文字サイズ※1 | 5／7／9／12 | 文字サイズを5，7，9，または12ポイントにして文字を配置します
文字の間隔※1 | 0 | 文字の間隔を空けないで文字を配置します
1～7 | 文字の間隔を1～7ポイントにして文字を配置します
書体※1 | 0 | 文字の書体を元に戻します
1 | 文字を明朝体にして配置します
2 | 文字をゴシック体にして配置します
9 | 文字をOCR体にして配置します※2
拡大 | 指定あり | 横方向に2倍に拡大した文字を配置します
指定なし | 横方向の拡大を解除した文字を配置します

注※1　

属性の指定がない場合，上位の項目に属性の指定があるときは，その属性の指定値に戻して文字を配置します。上位の項目に属性の指定がないときは，ドローで定義した属性で文字を配置します。上位の項目とは，レベル番号が上位にあるデータ記述項を示します。

注※2　

OCR体は，文字サイズに9ポイントを指定したときだけ有効です。

APで属性を設定する場合，レコード名または一意名にCHARACTER　TYPE句を指定します。CHARACTER　TYPE句の形式を次に示します。

(a)　形式の説明

POINT-l
文字サイズを指定します。lに指定できる文字サイズは，5／7／9／12です。指定値の意味については，表5-8を参照してください。

INTERVAL-m
文字の間隔（字間値）を指定します。mに指定できる文字の間隔は，0～7です。指定値の意味については，表5-8を参照してください。

FORMAT-n
書体を指定します。nに指定できる書体は，0／1／2／9です。指定値の意味については，表5-8を参照してください。

WIDE
文字を横方向に2倍に拡大します。

CHARACTER　TYPE句の詳細については，マニュアル「COBOL2002　言語　標準仕様編」またはマニュアル「COBOL85　言語」を参照してください。また，WRITE文の形式によって，レコード名のCHARACTER　TYPE句を有効にするか，一意名のCHARACTER　TYPE句を有効にするかが異なります。

(b)　「WRITE　レコード名」の場合

「WRITE　レコード名」の場合は，レコード名にCHARACTER　TYPE句があるときだけ，行データの印刷制御をします。WRITE文とCHARACTER　TYPE句の関係を次に示します。

図5-10　WRITE文とCHARACTER　TYPE句の関係（「WRITE　レコード名」の場合）

レコード名にCHARACTER　TYPE句を宣言
レコード名にCHARACTER　TYPE句を宣言して，行データの印刷制御をします。

プリンタへのレコード書き出し
1行改行したあとに，行データをプリンタに出力します。行データの印刷制御は，レコード名で宣言したCHARACTER　TYPE句での設定を使用します。

(c)　「WRITE　レコード名　FROM　一意名」の場合

「WRITE　レコード名　FROM　一意名」の場合は，一意名にCHARACTER　TYPE句があるときだけ，行データの印刷を制御します。このとき，レコード名にCHARACTER　TYPE句があっても無視されます。WRITE文とCHARACTER　TYPE句の関係を次に示します。

図5-11　WRITE文とCHARACTER　TYPE句の関係（「WRITE　レコード名　FROM　一意名」の場合）

レコード名の宣言
レコード名を宣言します。

一意名にCHARACTER　TYPE句を宣言
一意名にCHARACTER　TYPE句を宣言して，行データの印刷制御を実行します。

プリンタへのレコードの書き出し
1行改行したあとに，行データをプリンタに出力します。また，行データの印刷制御は，一意名で宣言したCHARACTER　TYPE句での設定を使用します。

5.4　C言語の画面入出力および帳票出力命令

ここでは，アプリケーションプログラム中に論理マップを取り込む方法およびC言語インタフェースによるマップドライバ用のjsvwadrv関数の使用方法を説明します。

＜この節の構成＞

5.4.1　論理マップの取り込み方法

5.4.2　スタンドアロン環境，およびC/S環境下での画面入出力および帳票出力命令

5.4.1　論理マップの取り込み方法

アプリケーションプログラム中に論理マップを取り込むには，#include指示語を使います。

アプリケーションプログラムに論理マップMAP003O.hおよびMAP003I.hを取り込む例を次に示します。

（取り込みの例）

5.4.2　スタンドアロン環境，およびC/S環境下での画面入出力および帳票出力命令

＜この項の構成＞

(1)　jsvwadrv関数の発行順序

(2)　jsvwadrv関数

(1)　jsvwadrv関数の発行順序

jsvwadrv関数の機能と発行順序を図5-12に示します。

図5-12　jsvwadrv関数の機能と発行順序

注※1

ディスプレイとプリンタを使う場合，それぞれに必要です。

注※2

画面・帳票数分を繰り返します。

注※3

マッピングオプション変更時に発行します。

注※4

ディスプレイからデータを入力する場合に必要であり，プリンタの場合は発行しません。

(2)　jsvwadrv関数

jsvwadrv関数の形式を次に示します。

XMAP_COMアドレス
共通インタフェース領域のアドレスを指定します。形式の詳細を表5-9に示します。この領域は，画面・帳票を出力したい端末単位に作成し，オープンしたときの領域をクローズ要求まで引き継いで使用します。また，次に示す各要求時にマッピング，および入出力I/Oに必要な情報をセットします。

オープン要求時：仮想端末名，通信種別を指定する。

出力要求時：物理マップ名称を指定する。

入力要求時：入力論理マップ長を指定する。

表5-9　共通インタフェース領域の形式（XMAP_COM）

データ項目名 | 長さ（位置） | データ形式 | 指定内容（データ名）
アイキャッチャ | 4 | char［4］ | 「*XP△」とします（xmap_com_id）
リターン値 | 2(4) | unsigned short | 2進形式で格納（xmap_com_rtn）
リターンコード詳細 | 2(6) | unsigned short | 2進形式で格納（xmap_com_rsn）
未使用 | 3(8) | char［3］ | (00)₁₆とします（xmap_com_rsvl）
id区分 | 1(11) | char | 必ず「I」とします（xmap_com_itype）
仮想端末名称 | 8(12) | char［8］ | 仮想端末定義ファイルで指定した名称を左詰めで指定し，残りは空白です。仮想端末名を省略して空白を8バイトセットすると，仮想端末定義ファイル中の先頭に定義された仮想端末名が仮定されます（xmap_com_tname）
未使用 | 4(20) | char［4］ | (00)₁₆とします（xmap_com_rsv2）
通信種別 | 4(24) | char［4］ | ディスプレイの場合は，「BWS△」とします。プリンタの場合は，「OWS△」とします（xmap_com_msg）
未使用 | 44(28) | char［44］ | (00)₁₆とします（xmap_com_rsv3）
マップ名称 | 8(72) | char［8］ | 物理マップ名を左詰めでデバイスID付きで指定します。残りは空白です（xmap_com_mapname）
未使用 | 2(80) | char［2］ | (00)₁₆とします（xmap_com_rsv4）
未使用 | 6(82) | char［6］ | (00)₁₆とします（xmap_com_pagename）
入力論理マップ長 | 4(88) | long | 入力論理マップ長を指定します（xmap_com_inlng）
未使用 | 68(92) | char［68］ | (00)₁₆とします（xmap_com_rsv5）

XMAP_REQアドレス
要求インタフェース領域のアドレスを指定します。形式を表5-10に示します。この領域は必ず指定します。この領域で指定した内容によって，要求種別が決まります。

表5-10　要求インタフェース領域の形式（XMAP_REQ）

データ項目名
長さ（位置）
データ形式
指定内容（データ名）

要求種別
4
char［4］
OPEN：オープン要求
CLOS：クローズ要求
SEND：出力要求
RECV：入力要求
MDO△：オプション設定要求（xmap_req_type）

RECEIVEオプション
1(4)
char
F：入力要求
△：入力要求以外（xmap_req_opt1）

SENDオプション
1(5)
char
1：出力要求
△：出力要求以外（xmap_req_opt2）

未使用
2(6)
char［2］
「△△」とします（xmap_req_rsv）

パラメタ3
入出力要求やオープン要求などの要求種別に応じて適切な内容を指定します。

出力要求時：出力論理マップのアドレスを指定する。

入力要求時：入力論理マップのアドレスを指定する。

オープン要求時：オープンインタフェース領域のアドレスを指定する。オープンインタフェース領域の形式の詳細を表5-11に示す。

表5-11　オープンインタフェース領域の形式（XMAP_OPN）

データ項目名
長さ（位置）
データ形式
指定内容（データ名）

データ有無コード使用選択
1
char
1：データ有無コードを有効にします
その他：データ有無コードを無効にします（xmap_opn_dcode_set）

データ有無コード
1(1)
unsigned char
データ有無コードを指定します（xmap_opn_dcode）

未使用
2(2)
char［2］
「△△」とします（xmap_opn_rsv）

クローズ要求時：0を指定する。

オプション設定要求時：1を指定する。

パラメタ4
オプション設定要求時は，マッピングインタフェース領域を指定します。形式の詳細を表5-12に示します。なお，マッピングオプションを指定しない場合は，0を指定します。

表5-12　マッピングインタフェース領域の形式（XMAP_MDO）

データ項目名
長さ（位置）
データ形式
指定内容（データ名）

マッピングオプション大分類
4
unsigned long
XMAP_MDO_SFLDの内容をセットします（xmap_mdo_opt1）

マッピングオプション小分類
4(4)
unsigned long
マージ：XMAP_MDO_MAPFLDの内容をセットします※
物理マップだけ：XMAP_MDO_PHFLDの内容をセットします※
論理マップだけ：XMAP_MDO_LOGFLDの内容をセットします※（xmap_mdo_opt2）

注※

詳細については，「5.2　COBOLの画面入出力および帳票出力命令」を参照してください。

(a)　リターン情報

共通インタフェース領域のxmap_com_rtnにリターン値が設定されます。リターン値を次に示します。

0：正常終了

4，8：異常終了（詳細については，共通インタフェース領域のxmap_com_rsnに設定されます）

12：パラメタ不正

(b)　インタフェーステーブルの取り込み方法

XMAP3 Serverが提供しているインタフェーステーブル（jsvwatbl.h）をアプリケーションプログラムに取り込む場合，#include指示語を使います。

ただし，jsvwatbl.h中のインタフェーステーブルは，構造体の形式などを定義しているだけで，#include指示語によってアプリケーションプログラムに実領域が取られるのではありません。そのため，アプリケーションプログラム中でインタフェース領域を定義しなければなりません。インタフェース領域を定義する例を図5-13に示します。

図5-13　インタフェース領域の定義例

(c)　オープン要求

jsvwadrv関数を使用する場合，画面・帳票を表示，印刷したい端末に付けた仮想端末名単位にオープン要求を実行します。複数の仮想端末（ディスプレイとプリンタ）をオープン要求する場合，インタフェース領域は仮想端末ごとに用意します。

（例）

(d)　クローズ要求

仮想端末をクローズします。オープン要求，出力要求および入力要求で使用したインタフェース領域を引き継いで使用します。

（例）

(e)　出力要求

オープン要求した仮想端末へ画面表示，帳票印刷を実行します。オープン要求で使用した共通インタフェース領域を引き継いで使用します。

（例）

注

jsvwadrv関数を呼ぶ前に表示・印刷したいデータを出力論理マップにセットしてください。

(f)　入力要求

入力要求によって，画面から入力した情報をアプリケーションプログラムへ入力します。画面表示要求で使用したインタフェース領域を引き継いで使用します。ただし，プリンタの場合は指定できません。

（例）

(g)　オプション設定要求

仮想端末へ画面表示をする場合，マッピングオプションを指定できます。オープン要求で使用した共通インタフェース領域を引き継いで使用します。

（例）

5.5　C言語の書式印刷命令（AIX，HP-UX，Solaris）

ここでは，C言語を使用した書式オーバレイのAPのコーディング方法について説明します。

＜この節の構成＞

5.5.1　印刷する書式の設定

5.5.2　行データの帳票印刷

5.5.1　印刷する書式の設定

印刷する書式の名称（書式オーバレイ名称）を指定します。書式の名称は，jstqlpag関数の*ovlnameで指定します。jstqlpag関数については，「5.5.2　行データの帳票印刷」を参照してください。行データは，この関数で指定した書式に重ねて印刷されます。

5.5.2　行データの帳票印刷

APから書式印刷をする場合，行データを出力するために，次に示す関数を発行します。関数の機能と発行順序を示します。

図5-14　関数の機能と発行順序

＜この項の構成＞

(1)　jstqlopn関数

(2)　jstqlpag関数

(3)　jstqlctp関数

(4)　jstqldat関数

(5)　jstqllpt関数

(6)　jstqlcls関数

(1)　jstqlopn関数

環境変数を取り込んで，行データの編集を開始します。なお，環境変数については，「6.3　書式オーバレイ印刷時の環境変数（AIX，HP-UX，Solaris）」を参照してください。

(a)　形式の説明

JSTQL_COMアドレス
APで確保したユーザインタフェース領域の先頭アドレスを指定します。ユーザインタフェース領域の形式を次に示します。

表5-13　ユーザインタフェース領域の形式

属性および名称
位置
長さ
内容
備考

（バイト）

unsigned char lcomid
0
4
テーブル
ID:「XMP3」
jstqlopn関数を呼び出す前に設定
します

unsigned char *lcomsvnm
4
4
印刷サービス名称のアドレス

unsigned char lcomdevnm
8
6
予備
jstqlopn関数を呼び出す前に必
ず，NULL（0x00）でクリア
します※¹

unsigned char lcomrsv1
14
2
予備

unsigned char lcompgcnm
16
8
予備

unsigned char *lcompgedr
24
4
予備

long lcomrc
28
4
リターンコード
関数呼び出し後に参照します※²

long lcomerr
32
4
エラー詳細コード※³

unsigned char lcomsync
36
1
予備
jstqlopn関数を呼び出す前に
必ずNULL（0x00）でクリア
します※¹

unsigned char lcomrsv3
37
1
予備

unsigned char lcomrsv4
38
1
予備

unsigned char lcomrsv5
39
1
予備

unsigned char lcomrsv6
40
12
予備

unsigned char *lcomxppdr
52
4
予備

unsigned char lcomperr
56
4
ページ制御エラー情報
ページ制御のエラー発生時に参照します※²

unsigned char *lcomxperr
60
4
予備
jstqlopn関数を呼び出す前に必ずNULL（0x00）でクリア
します※¹

unsigned char lcomwrk
64
192
XMAP3の作業領域
jstqlopn関数を呼び出す前に必ずNULL（0x00）でクリア
します※¹

注※1

NULL（0x00）でクリアしたあとは，使用しないでください。

注※2

各関数を呼び出す前に，必ずNULL（0x00）でクリアしてください。

注※3

エラー詳細コードについては，「9.4.2　書式オーバレイ印刷時のリターンコード（AIX，HP-UX，Solaris）」を参照してください。

ユーザインタフェース領域には，次に示す項目に情報を設定し，そのほかの項目はNULL（0x00）でクリアします。

lcomid（テーブルID）
テーブルIDとして文字列「XMP3」を設定します。

lcomsvnm（印刷サービス名アドレス）
印刷サービス名は，14バイト以内の文字列で，NULLを終端とします。印刷サービス名は，サービス名ファイル（/etc/opt/HIXMAP/XPWhosts）に設定した出力先の印刷用サービス名称を指定します。
印刷サービス名アドレスの指定がNULLポインタのとき，文字列がNULLまたはスペースだけのときは，環境変数「XMAP3_PSNAME」で指定した名称が仮定されます。

(b)　リターン情報

関数のリターン値を次に示します。

0：正常終了

8：異常終了（ユーザインタフェース領域内のエラー詳細コードを参照してください）

12：パラメタ不正（ユーザインタフェース領域のアドレスまたはIDが不正です）

(2)　jstqlpag関数

ページ制御情報を作成して，ページバッファに格納します。

(a)　形式の説明

JSTQL_COMアドレス
jstqlopn関数で指定したユーザインタフェース領域の先頭アドレスを指定します。

予備
必ず，NULLを指定します。

予備
必ず，NULLを指定します。

書式名格納領域のアドレス
書式イメージファイルの拡張子「.fmp」なしの名称が格納されている領域のアドレスを必ず指定します。書式名は，8バイト以内の文字列で，NULLまたはスペースを終端とします。書式名を9バイト以上で指定した場合は，先頭から8バイト分を書式名と見なし，8バイト未満で指定した場合は，先頭からNULLまたはスペースの直前までの文字列を書式名と見なします。
書式名の指定がNULLポインタのとき，文字列がNULLまたは空白だけのときは，環境変数「XMAP3_FMP」で指定した名称が仮定されます。
また，書式オーバレイなしの行データだけの印刷はできません。ただし，何も定義していない空の書式を指定すると，行データだけの印刷ができます。

(b)　リターン情報

関数のリターン値を次に示します。

0：正常終了

8：異常終了（ユーザインタフェース領域内のエラー詳細コードを参照してください）

12：パラメタ不正（ユーザインタフェース領域のアドレスまたはIDが不正です）

(c)　注意事項

jstqldat関数での行データをjstqllpt関数で出力していない場合，この関数によって出力されます。また，この関数を発行するjstqlcls関数を発行するまでは，前に発行した関数の情報（書式名など）が引き継がれます。

(3)　jstqlctp関数

書式印刷時にずれを生じさせないように，行データの制御情報を作成して，行バッファに格納します。ここで指定した制御情報は，jstqllpt関数の発行，または改ページまで有効です。

(a)　形式の説明

JSTQL_COMアドレス
jstqlopn関数で指定したユーザインタフェース領域の先頭アドレスを指定します。

JSTQL_CTLアドレス
行データの制御情報を設定する制御情報テーブルの先頭アドレスを指定します。制御情報テーブルの形式，制御情報テーブルに指定できる定数と値を次に示します。

図5-15　 行データの制御情報テーブル（JSTQL_CTL）の形式

表5-14　行データの制御情報テーブル（JSTQL_CTL）に指定できる定数と値

制御情報の
種類
定数（ctl_type）
指定値
（ctl_val）
意味

文字サイズ
JSTQ_TYPE_PNT
50
文字サイズに5ポイントを指定します。

70
文字サイズに7ポイントを指定します。

90
文字サイズに9ポイントを指定します。

120
文字サイズに12ポイントを指定します。

文字の間隔
JSTQ_TYPE_INT
0
文字の間隔を指定しません。

1～7
文字の間隔に1～7ポイントを指定します。

書体
JSTQ_TYPE_FMT
0
書体を元に（標準値に）戻します。

1
書体に明朝体を指定します。

2
書体にゴシック体を指定します。

9
書体にOCR体を指定します※。

拡大（平体）
JSTQ_TYPE_WID
0
拡大を指定しません。

1
拡大を指定します。

注※　

OCR体は，文字サイズに9ポイントを指定したときだけ有効です。

項目数
制御情報テーブル中に設定した制御情報の項目数を指定します。

（例）

(b)　リターン情報

関数のリターン値を次に示します。

0：正常終了

8：異常終了（ユーザインタフェース領域内のエラー詳細コードを参照してください）

12：パラメタ不正（ユーザインタフェース領域のアドレスまたはIDが不正です）

(c)　注意事項

行の先頭での制御情報の初期値は，文字サイズ，文字の間隔および書体はドローで定義した値，平体は指定なしです。ただし，環境定数（XMAP3_FORMAT）で書体を指定している場合，環境変数で指定した書体が有効となります。ここで指定した制御情報は，jstqllpt関数の発行，または改ページまで有効です。

(4)　jstqldat関数

文字データを編集して，行バッファに格納します。

(a)　形式の説明

JSTQL_COMアドレス
jstqlopn関数で指定したユーザインタフェース領域の先頭アドレスを指定します。

文字データのアドレス
出力する文字データ（行データ）のアドレスを指定します。

文字データの長さ
出力する文字データ（行データ）の長さを，バイト数で指定します。

(b)　リターン情報

関数のリターン値を次に示します。

0：正常終了

8：異常終了（ユーザインタフェース領域内のエラー詳細コードを参照してください）

12：パラメタ不正（ユーザインタフェース領域のアドレスまたはIDが不正です）

(c)　注意事項

この関数では，印刷する文字データ（行データ）だけを指定し，行送りなどはjstqllpt関数で指定します。

(5)　jstqllpt関数

行バッファに格納されている行データに行送り情報を付けて，1行分のデータをページバッファに出力します。ただし，改ページを指定したときや，改ページが発生したときは，ページバッファに格納されている1ページ分のデータをプリンタに出力します。

(a)　形式の説明

JSTQL_COMアドレス
jstqlopn関数で指定したユーザインタフェース領域の先頭アドレスを指定します。

JSTQL_CTLアドレス
行送り情報を設定する制御情報テーブルの先頭アドレスを指定します。制御情報テーブルの形式と，制御情報テーブルに指定できる定数と値を次に示します。

図5-16　 行送りの制御情報テーブル（JSTQL_CTL）の形式

表5-15　行送りの制御情報テーブル（JSTQL_CTL）に指定できる定数と値

制御情報の種類
定数（ctl_type）
指定値
(ctl_val)
意味

改行
JSTQ_TYPE_NLN
0～99
0～99行分改行します

チャネル
スキップ
JSTQ_TYPE_CNL
0
行送りをしません

1
紙送りチャネル番号C01（改ページ）を指定します

行出力と行送りのタイミング
行データを行送り後に出力するか，または行送り前に出力するかを指定します。行送り後に行データを出力する場合は「0」を，行送り前に出力する場合は「1」を指定します。0または1以外の値を指定した場合は「0」を仮定します。

(b)　リターン情報

関数のリターン値を次に示します。

0：正常終了

8：異常終了（ユーザインタフェース領域内のエラー詳細コードを参照してください）

12：パラメタ不正（ユーザインタフェース領域のアドレスまたはIDが不正です）

(c)　注意事項

この関数を発行しない場合でも，ページバッファに格納された行データの数が1ページに印刷できる行数を超えるとき，またはページバッファに格納できるデータ長の制限を超えるときは，自動的に改ページされます。

(6)　jstqlcls関数

行データの編集を終了します。

(a)　形式の説明

JSTQL_COMアドレス
jstqlopn関数で指定したユーザインタフェース領域の先頭アドレスを指定します。

(b)　リターン情報

関数のリターン値を次に示します。

0：正常終了

8：異常終了（ユーザインタフェース領域内のエラー詳細コードを参照してください）

12：パラメタ不正（ユーザインタフェース領域のアドレスまたはIDが不正です）

(c)　注意事項

この関数を発行したとき，バッファ中に残っている行データは，すべて出力されます。なお，行バッファの文字データは，ページバッファに格納され，ページバッファから出力されます。

5.6　C言語固有のコーディング例

C言語にはCOBOL言語のような編集項目（PIC Z，9），文字項目（PIC X）という概念がないため，数を扱う場合，そのデータが文字（数字）か，または数値かをユーザが意識してアプリケーションプログラムを作成する必要があります。また，コンマを付けるなどの出力数字編集もアプリケーションプログラムで実行する必要があります。ここでは，C言語でアプリケーションプログラムを作成する場合に，注意が必要な固有のコーディングについて説明します。

＜この節の構成＞

(1)　エリアの一括クリアには，memsetを使う

(2)　データの一括コピーにはmemcpyを使う

(3)　配列データ，またはメモリ領域の比較にはmemcmpを使う

(4)　出力論理マップ中のカーソル位置（行，列）のクリアには(00)₁₆を使う

(5)　数字から数値への変換には文字列変換関数atol，またはatofを使う

(6)　数値から数字への変換には書式付き出力関数sprintfを使う

(1)　エリアの一括クリアには，memsetを使う

（例）

出力項目を空白でクリアする。なお，エリアサイズを求めるには，sizeof演算子を使用する。

(2)　データの一括コピーにはmemcpyを使う

（例）

項目属性に「PROT」を設定する。

(3)　配列データ，またはメモリ領域の比較にはmemcmpを使う

（例）

INCコードが「PF01」であるかどうかを判定する。

(4)　出力論理マップ中のカーソル位置（行，列）のクリアには(00)₁₆を使う

（例）

出力カーソルの行列位置エリアをクリアする。

(5)　数字から数値への変換には文字列変換関数atol，またはatofを使う

（例）

入力論理マップmapli中の項目（char MAP003_SU1_I[5]）に設定されている数字データを数値データに変換する。

(6)　数値から数字への変換には書式付き出力関数sprintfを使う

（例）

数値を文字に変換して出力論理マップの項目（char MAP003_GOUKEI_O[15];）に格納し，計算結果などを画面に表示する。

5.7　その他のコーディング上で必要な知識

＜この節の構成＞

5.7.1　DBの利用方法

5.7.2　帳票出力時のXMAP3 Serverとアプリケーションプログラムの関係

5.7.3　書式オーバレイ印刷時のXMAP3 ServerとAPの関係（AIX，HP-UX，Solaris）

5.7.4　書式オーバレイ印刷時の印刷ページとスプール登録する文書の関係（AIX，HP-UX，Solaris）

5.7.5　EUC文字コードでの半角かなの扱い方（AIX，Linux，Solaris）

5.7.1　DBの利用方法

アプリケーションプログラム内で使う論理マップの各項目の順序とDB内の項目の順序を一致させておくと，データの移動が少なくて済みます。

DBとAPの設計例を次に示します。

良い設計方法について次に示します。

画面・帳票，論理マップおよびDBの項目の順序が一致している。
論理マップにDBのデータをセットする場合，AP内の操作としてDB1レコードをそのまま論理マップへ複写すればよい。

画面・帳票に使うデータをDB内にセットする場合，DBのデータタイプは，固定長文字データ属性（CHARACTER）を使う。可変長データ（BINARY）と数値データ（NUMERIC）は使わない。

5.7.2　帳票出力時のXMAP3 Serverとアプリケーションプログラムの関係

帳票を印刷する場合の印刷形態と，アプリケーションプログラムのコーディング内容の関係を示します。なお，ここではプログラミング言語として日立COBOLが使用されていることを仮定します。

＜この項の構成＞

(1)　同じ内容の帳票を複数枚印刷（コピー印刷）

(2)　同じ帳票で中身が異なるものを複数枚印刷

(3)　異なる帳票を交互に印刷

(4)　異なるプリンタに帳票を印刷

(1)　同じ内容の帳票を複数枚印刷（コピー印刷）

同じ内容の帳票を複数枚印刷する場合，例えば3枚の帳票を印刷する場合は，次のようにコーディングします。

表5-16　コピー印刷時のコーディング

プリンタの種類 | アプリケーションプログラムのコーディング | 備考
シリアルプリンタ | SEND文を3回発行します。 | スプールに同じものを3部入れます。
ページプリンタ | 何部印刷するかを指定して，SEND文を1回発行します。 | プリンタハードウェアの機能を使用してマルチコピーします。スプールの中には1部だけ入れます。

(2)　同じ帳票で中身が異なるものを複数枚印刷

マップ名は同じのまま，論理マップ中のデータを変えて，3回SEND文を発行します。

(3)　異なる帳票を交互に印刷

それぞれの帳票を印刷するためのSEND文を交互に書きます。

(4)　異なるプリンタに帳票を印刷

仮想端末名を別プリンタに割り当てて，それぞれにSEND文を書きます。ただし，スタンドアロンの場合は，途中にDISABLE文などを入れ，一度クローズする必要があります。

5.7.3　書式オーバレイ印刷時のXMAP3 ServerとAPの関係（AIX，HP-UX，Solaris）

帳票を印刷する場合の印刷形態と，APのコーディング内容の関係を示します。なお，ここではプログラミング言語として日立COBOLが使用されていることを仮定します。

＜この項の構成＞

(1)　同じ内容のものを複数枚印刷

(2)　同じ帳票レイアウトで中身が異なるものを複数枚印刷

(3)　異なる帳票を交互に印刷

(4)　異なるプリンタに帳票を印刷

(1)　同じ内容のものを複数枚印刷

同じ内容のものを複数枚，印刷する場合です。例えば，3枚の帳票を印刷するときは，3回同じ印刷を繰り返します。スプールには，同じものが3部格納されます。なお，書式名称は，1回だけ指定します。

(2)　同じ帳票レイアウトで中身が異なるものを複数枚印刷

書式オーバレイ名称は同じで，データを変えて3回改ページします。

(コーディング例)

(3)　異なる帳票を交互に印刷

(コーディング例)

(4)　異なるプリンタに帳票を印刷

書式オーバレイで一つのAPから異なるプリンタに印刷する場合には，印刷するプリンタごとに印刷サービスをオープンし，印刷要求をします。

5.7.4　書式オーバレイ印刷時の印刷ページとスプール登録する文書の関係（AIX，HP-UX，Solaris）

＜この項の構成＞

(1)　1ページを1文書でスプール登録する

(2)　複数ページを1文書でスプール登録する

(1)　1ページを1文書でスプール登録する

APとXMAP3 Serverの間で，APが1ページ出力したら，1ページを一つの文章としてスプール登録および印刷するようにします。1ページごとに出力するようにするには，XMAP3サーバを起動する前に環境変数に「XPWCSTMW=OFF」を設定するか，この環境変数を設定しないでください。環境変数の詳細については，「7.12.1　LPスプールシステムでの帳票一括出力機能」を参照してください。

(2)　複数ページを1文書でスプール登録する

APとXMAP3 Serverの間で，APから複数ページの出力を要求して，APからのクローズ要求で一つの文章としてスプール登録および印刷するようにします。複数ページを出力するようにするには，XMAP3サーバを起動する前に，環境変数に「XPWCSTMW=ON」を設定します。環境変数の詳細については，「7.12.1　LPスプールシステムでの帳票一括出力機能」を参照してください。

5.7.5　EUC文字コードでの半角かなの扱い方（AIX，Linux，Solaris）

AIX，LinuxおよびSolarisのEUC環境での半角かなは，シフトJISとは異なり1バイト文字ではなく，2バイト文字として扱われます。このため，半角かなを使用した項目の論理項目長は，レイアウト上の長さの2倍がデフォルトになります。

PC XMAP3のドロー定義時に対象となる項目を表5-17に示します。

表5-17　PC XMAP3のドロー定義時に対象となる項目

使用目的 | 詳細目的 | データ型
入力データ型 | 出力データ型
日本語 | 混在（全角・半角） | 文字（XX） | 文字（XX）
カナ | カナ・半角 | 文字（XX） | 文字（XX）
カナ
カナ・英大・数
カナ・英大・数・マイナス
カナ・英大・数・長音
カナ・英大・数・マイナス・長音
カナ・数
カナ・数・マイナス
カナ・数・長音
カナ・数・マイナス・長音
POP（手動・カナ） | カナ・半角 | 文字（XX） | 文字（XX）
POP（手動・日本語） | 混在（全角・半角） | 文字（XX） | 文字（XX）
POP（自動・日本語） | 混在（全角・半角） | 文字（XX） | 文字（XX）

注意事項

オブジェクト，ラベルおよび選択ラベルの埋字に，半角かなは使用できません。指定した場合，「埋めない」に変換されます。

COBOL APで使用する論理マップ内のデータ名に半角かなを指定した場合，コンパイル時にオプションの指定が必要となる場合があります（COBOLコンパイル時に半角かなを2バイトとして扱うため，72カラムの制限でエラーとなるケースがあります）。
COBOL APのコンパイル方法については，「6.1.1　COBOL2002」および「6.2.1　COBOL2002」，または「6.1.2　COBOL85」および「6.2.2　COBOL85」を参照してください。

「カナ」「混在」指定でない項目に半角かなを入力，または初期値として半角かなを指定した場合や，通知コードとして半角かなを指定した場合，APにリターンされるデータは，論理項目長で切り捨てられます。

5.8　標準パターン

XMAP3 Serverでは，APを効率良く開発する目的で標準パターンを提供しています。標準パターンには，画面の定義時に利用できる「定義サンプル」，「レイアウトパターン」と，AP作成時に利用できる「APパターン」とがあります。

ここでは，業務目的別にXMAP3 Serverが標準提供している画面の定義サンプルとAPパターンの業務目的別の組み合わせを紹介します。また，「5.9　標準パターンを使用した機能別の作成例（COBOL）」では，COBOLの標準パターンを利用した例題を使用して，AP作成時に留意する点を説明します。

＜この節の構成＞

5.8.1　レイアウトパターンとアプリケーションのパターン

5.8.2　画面サンプルとAPパターンの組み合わせ

5.8.1　レイアウトパターンとアプリケーションのパターン

＜この項の構成＞

(1)　定義サンプル

(2)　APパターン

(1)　定義サンプル

XMAP3 Serverでは，一般の業務を想定した画面レイアウトのサンプルを「定義サンプル」として標準提供しているため，ユーザが作成する画面レイアウトの参考にできます。この定義サンプルは，PC XMAP3で生成した物理マップおよび論理マップとして提供されています。

COBOL用の定義サンプルは，「/opt/HIXMAP/map/COBOL」の下にあり，開発ディレクトリに複写して利用します。

(2)　APパターン

XMAP3 Serverでは，APの定型的な型として，COBOL用のAPパターンを用意しています。APパターンには，プログラムパターンと部品パターンとがあります。

プログラムパターン
COBOLソースプログラムの見出し部，データ部，手続き部など，プログラム全体の標準的な骨組みが記述されているので，メインプログラムとして利用できます。

部品パターン
業務共通に，頻繁に使用すると考えられる処理の手続きが記述されているので，サブルーチンとして利用できます。

XMAP3 Serverで作成した画面を取り込むソースプログラム作成時には，これらのパターンを組み合わせて使用することで，APを効率良く作成できるほか，定型的なコーディングの統一を図ることができます。

コーディング時には，@@@XXX（XXXは数字）で示されているマップ名を6文字以内の半角英数字に変更するほか，ユーザ独自の処理を加えます。

5.8.2　画面サンプルとAPパターンの組み合わせ

業務目的に合った画面の定義サンプルとAPパターンの組み合わせを表5-18に示します。定義サンプルは「/opt/HIXMAP/map/COBOL」に，APパターンは「/opt/HIXMAP/patterns」にそれぞれ格納されています。

表5-18　画面の定義サンプルとAPパターンの組み合わせ（COBOL）

業務目的
APパターンファイル名
例題の
説明個所

メニュー画面表示
ユーザ登録確認
BTMENU01.cbl
5.9.1

初期メニュー表示

メニュー画面からの次画面表示
GENDSP01.cbl
NXTDSP01.cbl
5.9.2

データの入出力
フィールド単位
GENDSP01.cbl
5.9.3

行単位
GENDSP01.cbl
5.9.4

画面単位
GENDSP01.cbl
5.9.5

5.9.6

一覧リストの表示
表形式の一覧表示
GENDSP01.cbl
5.9.7

可変項目の再表示
5.9.8

オプション画面の表示
ヘルプ画面の表示
5.9.9

ダイアログボックスの表示
5.9.10

帳票印刷機能との連携
画面表示と帳票印刷
DSPPRT01.cbl
5.9.11

帳票印刷
同一帳票の複数枚印刷
GENREP01.cbl
5.9.12

複数種類の帳票印刷
GENREP01.cbl
NXTREP01.cbl
5.9.13

5.9　標準パターンを使用した機能別の作成例（COBOL）

＜この節の構成＞

5.9.1　BTMENU01パターンを使用したメニュー画面の表示

5.9.2　GENDSP01パターンを使用したメニュー画面からの次画面表示

5.9.3　GENDSP01パターンを使用したCUI画面でのフィールド単位のデータ入力

5.9.4　GENDSP01パターンを使用した行単位のデータ入力

5.9.5　GENDSP01パターンを使用した入力フィールドのクリア

5.9.6　GENDSP01パターンを使用したAPからのフィールド属性の変更

5.9.7　GENDSP01パターンを使用した表形式の一覧表示

5.9.8　GENDSP01パターンを使用した出力フィールドの再表示

5.9.9　GENDSP01パターンを使用したヘルプ画面の表示

5.9.10　GENDSP01パターンを使用したダイアログの表示

5.9.11　DSPPRT01パターンを使用した画面表示と帳票印刷

5.9.12　GENREP01パターンを使用した同一帳票の複数枚印刷

5.9.13　GENREP01パターンを使用した複数種類の帳票印刷

5.9.1　BTMENU01パターンを使用したメニュー画面の表示

＜この項の構成＞

(1)　処理の概要

(2)　使用するマップの概要

(3)　AP作成上のポイント

(4)　コーディング例

(1)　処理の概要

ユーザIDとパスワードを入力するためのユーザ登録確認画面を表示します。ユーザIDとパスワードを照合して登録があれば，次にメニュー画面を表示します。このメニュー画面で，プッシュボタンまたはファンクションキーを使用して次の処理を選ぶと，選ばれたメニューに対応した使用ごとのAPを起動します。

メニュー画面の表示処理の概要を次に示します。

図5-17　メニュー画面の表示処理

(2)　使用するマップの概要

作成する画面の基になる定義サンプル，または画面のレイアウトパターンを次に示します。

作成する画面
適用できるパターン

画面の定義サンプル名
画面のレイアウトパターン名

ユーザ登録確認画面：
GPASW1ND
ログインウィンドウ

メニュー画面：
BMENU1ND
一段ボタンメニュー

ユーザ登録確認画面には次の特長があります。

パスワードを入力する項目の使用目的を「パスワード」と指定すると，パスワード入力時は入力データを「＊」や「空白」で隠せる。

ユーザIDまたはパスワードに誤りがあった場合に利用できるエラーメッセージ用の項目を用意している。

(3)　AP作成上のポイント

作成するAPの基になるAPパターンを次に示します。

メインプログラムで使用するAPパターン名：BTMENU01

メインプログラムには，次の特長があります。

対応しないファンクションキーや［Enter］キーが押されたときの処理が用意されている。

メニュー画面からは，［F1...見積書］ボタンまたは［F1］キーを選んだときの業務のAPをCALL文で呼び出す仕様となっている。

メニュー画面から業務ごとのAPを呼び出すとき，メニュー画面をDISABLE文でクローズしている。

なお，このAPパターンを使用してのメインプログラム作成時には次の注意が必要です。

ユーザIDおよびパスワードの照合処理は含まれていないため，ユーザ独自のコーディングが必要となる。

(4)　コーディング例

この例題のソースプログラムを「MENUOUT.cbl」として/opt/HIXMAP/samples/COBOLに標準提供しています。ソースプログラムからコーディング上のポイントを抜粋して次に示します。

マップ名を変更する。
プログラム中の「@@@111」を「GPASW1」に，「@@@444」を「BMENU1」に変更します。

実行ファイル名を変更する。
プログラム中の「###EXE01.exe」を「DSPCLEAR」に変更します。

CALL文を使用してAPを呼び出す。
CALL 'DSPCLEAR'

5.9.2　GENDSP01パターンを使用したメニュー画面からの次画面表示

＜この項の構成＞

(1)　処理の概要

(2)　使用するマップの概要

(3)　AP作成上のポイント

(4)　コーディング例

(1)　処理の概要

処理を選ぶためのメニュー画面を表示します。この画面でメニューを選び，［OK］ボタンを選ぶと，選ばれたメニューに対応する業務ごとの画面を表示します。

メニュー画面から次画面（この例題では「支払い状況一覧画面」）を表示する処理の概要を次に示します。

図5-18　メニュー画面からの次画面表示処理

(2)　使用するマップの概要

作成するGUI画面の基になる定義サンプルを次に示します。

メニュー画面の定義サンプル：SMENU1ND

支払い状況一覧画面の定義サンプル（次画面）：GOPTN1ND

(3)　AP作成上のポイント

作成するAPの基になるAPパターンとAP部品を次に示します。

メインプログラムで使用するAPパターン名：GENDSP01

サブルーチンで使用するAP部品名：NXTDSP01

このパターンを使用してのAP作成時には，次の注意が必要です。

メニュー画面でエラーチェックをするためには，コーディングを追加する必要がある。

メニューに対応して表示される画面の数に合わせて，AP部品「NXTDSP01」を使用して画面表示処理を追加する。

メニュー画面でエラーが発生した場合の後続画面の表示スキップ処理を必要に応じて追加する。

一次ウィンドウから一次ウィンドウへ遷移するため，サブルーチンでの画面表示時のマッピングオプションは，最初は常に初期表示の指定をする。

(4)　コーディング例

この例題のソースプログラムを「OUTDSP01.cbl」として/opt/HIXMAP/samples/COBOLに標準提供しています。ソースプログラムからコーディング上のポイントを抜粋して次に示します。

マップ名を変更する
プログラム中の「@@@555」を「SMENU1」に変更します。

「GENDSP01」に「NXTDSP01」を取り込み，「@@@666」を「GOPTN1」に変更する

選択されたメニューの判定と，該当画面を表示する処理を追加する

5.9.3　GENDSP01パターンを使用したCUI画面でのフィールド単位のデータ入力

＜この項の構成＞

(1)　処理の概要

(2)　使用するマップの概要

(3)　AP作成上のポイント

(4)　コーディング例

(1)　処理の概要

受注データ入力画面を表示します。ファンクションキーなどを使用しないで，テンキーだけを操作してデータ入力をし，フィールド単位でデータの処理をします。

受注データ入力画面でのデータ入力処理の概要を次に示します。

図5-19　受注データ入力画面でのデータ入力処理（フィールド単位）

(2)　使用するマップの概要

作成するCUI画面の基になる定義サンプルを次に示します。

受注データ入力画面の定義サンプル：FIE1CCNC

定義サンプルを使用しない場合は，レイアウトパターンの「フリー」を選んで定義してください。

受注データ入力画面の作成時には，次の注意が必要です。

すべての入出力フィールドに「自動スキップ（選択したら次のフィールドにフォーカスを移す）」の属性を指定する。これによって，フィールドの領域いっぱいまで文字を入力すると，自動的に次の入出力フィールドにカーソルが移動される。

すべての入出力フィールドに「自動送信（入力直後にAPへ制御を渡す）」の属性を指定する。これによって，データ入力後にほかのフィールドにカーソルが移動したときに，このフィールドは送信（実行）キーが押された状態になり，APへ自動的に通知される。

処理済みのフィールドを書き込み禁止状態にするために，すべての入出力フィールドに「動的変更（APから表示属性を変更する）」の属性を指定する。

(3)　AP作成上のポイント

作成するAPの基になるAPパターンを次に示します。

メインプログラムで使用するAPパターン名：GENDSP01

このAPパターンを使用してのAP作成時には次の注意が必要です。

フィールド単位で，順にデータ入力，表示処理をする。このとき処理済みのフィールドに，APから「入力不可」属性を指定することで，フィールドが書き込み禁止の状態になる。

ファイルの入出力処理は，必要に応じて追加する。

(4)　コーディング例

この例題のソースプログラムを「FIELDCC.cbl」として/opt/HIXMAP/samples/COBOLに標準提供しています。ソースプログラムからコーディング上のポイントを抜粋して次に示します。

マップ名を変更する
プログラム中の「@@@555」を「FIE1CC」に変更します。

APから表示属性を変更するための修飾名を設定する

画面の表示とデータを入力する

5.9.4　GENDSP01パターンを使用した行単位のデータ入力

＜この項の構成＞

(1)　処理の概要

(2)　使用するマップの概要

(3)　AP作成上のポイント

(4)　コーディング例

(1)　処理の概要

受注データ入力画面を表示します。1行ずつデータが入力できる状態になり，行単位で入力を確認して，入力データを処理します。

受注データ入力画面でのデータ入力処理の概要を次に示します。

図5-20　受注データ入力画面でのデータ入力処理（行単位）

(2)　使用するマップの概要

作成するGUI画面の基になる定義サンプルを次に示します。

受注データ入力画面の定義サンプル：LIN1GCND

定義サンプルを使用しない場合は，レイアウトパターンの「フリー」を選んで定義してください。

受注データ入力画面の作成時には，次の注意が必要です。

すべての入出力フィールドに「入力不可―標準表示」の表示属性を指定する。

すべての入出力フィールドに「動的変更（APから表示属性を変更する）」の属性を指定する。

行の最後の入出力フィールド（数量）には「自動送信（入力直後にAPへ制御を渡す）」の属性を指定する。

(3)　AP作成上のポイント

作成するAPの基になるAPパターンとAP部品を次に示します。

メインプログラムで使用するAPパターン名：GENDSP01

サブルーチンで使用するAP部品名：PATWRT01

このAPパターンを使用してAPを作成するには，次の注意が必要です。

行単位で，順にデータ入力，表示処理をする。このとき，1行ずつ入力できるように行単位で「入力可能―標準表示」の表示属性を動的変更する。

データ処理後の表示済みのフィールドは2回目の画面表示以降ではデータを送らないようにして，必要以上に画面がちらつかないようにする。

ファイルの入出力処理は，必要に応じて追加する。

(4)　コーディング例

この例題のソースプログラムを「LINEGC.cbl」として/opt/HIXMAP/samples/COBOLに標準提供しています。ソースプログラムからコーディング上のポイントを抜粋して次に示します。

マップ名を変更する
プログラム中の「@@@555」を「LIN1GC」に変更してください。

入力する行の入力フィールドを活性に変更する

フォーカスを位置づける

画面の表示とデータの入力

入力した行の入力フィールドを不活性に戻す

表示済みのフィールドに対するデータを転送しないようにする

5.9.5　GENDSP01パターンを使用した入力フィールドのクリア

＜この項の構成＞

(1)　処理の概要

(2)　使用するマップの概要

(3)　AP作成上のポイント

(4)　コーディング例

(1)　処理の概要

受注データ登録画面を表示します。受注伝票の内容を入力後に［確認］ボタンまたは［登録］ボタンを選ぶと，表示画面はそのままにして入力したデータをすべてクリアし，次の伝票を入力できる状態にします。

受注データ登録画面でのデータ入力処理の概要を次に示します。

図5-21　受注データ登録画面でのデータ入力処理

(2)　使用するマップの概要

作成するGUI画面の基になる定義サンプルを次に示します。

受注データ登録画面の定義サンプル：GFILD3ND

受注データ登録画面の作成時には，次の注意が必要です。

各入出力フィールドに初期値は指定しない。

(3)　AP作成上のポイント

作成するAPの基になるAPパターンとAP部品を次に示します。

メインプログラムで使用するAPパターン名：GENDSP01

サブルーチンで使用するAP部品名：GFILD3

このAPパターンを使用してAPを作成するには，次の注意が必要です。

2回目以降の画面表示ではマッピングオプションを「マージ」に，画面属性ダイアログのウィンドウ属性の「入力・選択状態の扱い」を「初期状態」に変更して送信する。

入力データのエラーチェックは必要に応じて追加する。

入力データをデータベースなどに書き込む処理を追加する。

(4)　コーディング例

この例題のソースプログラムを「DSPCLEAR.cbl」として/opt/HIXMAP/samples/COBOLに標準提供しています。ソースプログラムからコーディング上のポイントを抜粋して次に示します。

マップ名を変更する
プログラム中の「@@@555」を「GFILD3」に変更します。

APパターン「GENDSP01」にAP部品「CRLINP01」を取り込む

2回目の表示でマッピングオプションおよびウィンドウ属性を変更する処理を追加する

5.9.6　GENDSP01パターンを使用したAPからのフィールド属性の変更

＜この項の構成＞

(1)　処理の概要

(2)　使用するマップの概要

(3)　AP作成上のポイント

(4)　コーディング例

(1)　処理の概要

入力したデータに誤りがあった場合，エラーメッセージを表示します。このときエラーとなったフィールドを赤色にしてカーソルを設定し，データの再入力を促します。

エラー発生時のフィールド表示の変更処理の概要を次に示します。

図5-22　エラー発生時のフィールド表示の変更処理

(2)　使用するマップの概要

作成するGUI画面の基になる定義サンプルを次に示します。

ユーザ登録画面の定義サンプル：GPASW1ND

画面作成時には次の注意が必要です。

エラーメッセージ表示用の出力フィールドの使用目的を「日本語」に変更する。

(3)　AP作成上のポイント

作成するAPの基になるAPパターンとAP部品を次に示します。

メインプログラムで使用するAPパターン名：GENDSP01

サブルーチンで使用するAP部品名：MODATR01

このAPパターンを使用してAPを作成するには，次の注意が必要です。

画面の初期表示のときと，エラー表示のときにはマッピングオプションを変更している。

入力したユーザIDが「AAAAAAAA」のときエラーにするという仕様は，ユーザ独自の仕様に変更する。

エラーメッセージは1種類だけ用意している。

(4)　コーディング例

この例題のソースプログラムを「FILDCHG1.cbl」として/opt/HIXMAP/samples/COBOLに標準提供しています。ソースプログラムからコーディング上のポイントを抜粋して次に示します。

マップ名を変更する
プログラム中の「@@@555」を「GPASW1」に変更します。

APパターン「GENDSP01」にAP部品「MODATR01」を取り込む

エラーチェック処理を追加する

エラー表示，フィールド表示属性を変更するコーディングを追加する

5.9.7　GENDSP01パターンを使用した表形式の一覧表示

＜この項の構成＞

(1)　処理の概要

(2)　使用するマップの概要

(3)　AP作成上のポイント

(4)　コーディング例

(1)　処理の概要

店舗別の在庫管理表を一覧で表示します。メニューバーの［ファイル］－［終了］，または［キャンセル］ボタンを選ぶことで画面表示を終了します。

表形式の一覧の表示処理について，概要を次に示します。

図5-23　表形式の一覧の表示処理

(2)　使用するマップの概要

作成するGUI画面の基になる定義サンプルを次に示します。

店舗別管理表の定義サンプル：GCTBL1ND

定義サンプルを使用しない場合は，レイアウトパターンの「表」を選んで定義してください。

店舗別管理表の定義サンプルには，次の特長があります。

各項目はすべて出力フィールドで定義しているため，画面からの入力はない。

出力フィールドには「動的変更（APから表示属性を変更する）」の属性を指定していない。

(3)　AP作成上のポイント

作成するAPの基になるAPパターンを次に示します。

メインプログラムで使用するAPパターン名：GENDSP01

このAPパターンを使用してAPを作成するには，次の注意が必要です。

該当しないファンクションキーが押された場合は，画面を再表示するだけの仕様のため，エラー処理は必要に応じて追加する。

ファイルの入出力処理は，必要に応じて追加する。

(4)　コーディング例

この例題のソースプログラムを「TABLEOUT.cbl」として/opt/HIXMAP/samples/COBOLに標準提供しています。ソースプログラムからコーディング上のポイントを抜粋して次に示します。

マップ名を変更する
プログラム中の「@@@555」を「GCTBL1」に変更します。

出力データの代入処理をする

終了の判定を変更する

5.9.8　GENDSP01パターンを使用した出力フィールドの再表示

＜この項の構成＞

(1)　処理の概要

(2)　使用するマップの概要

(3)　AP作成上のポイント

(4)　コーディング例

(1)　処理の概要

店舗別の在庫管理表を一覧で表示します。［後頁］のプッシュボタンを押すと，表中に次のデータを表示します。

表中の可変データだけを入れ換えて表示する処理の概要を次に示します。

図5-24　表中の可変データだけを再表示する処理

(2)　使用するマップの概要

作成するGUI画面の基になる定義サンプルを次に示します。

店舗別管理表の定義サンプル：GCTBL1ND

定義サンプルを使用しない場合は，レイアウトパターンの「表」を選んで定義してください。

店舗別管理表の画面サンプルには，次の特長があります。

各項目はすべて出力フィールドで定義しているため，画面からの入力はない。

出力フィールドには「動的変更（APから表示属性を変更する）」の属性は指定していない。

［キャンセル］，［後頁］，［前頁］ボタンが押されたときだけの処理をサポートしている。ほかのボタンが押された場合は画面を再表示する。

(3)　AP作成上のポイント

作成するAPの基になるAPパターンを次に示します。

メインプログラムで使用するAPパターン名：GENDSP01

このAPパターンを使用してAPを作成するには，次の注意が必要です。

2度目の画面表示では，マッピングオプションを「論理マップだけ」に指定する。

サポートしていないプッシュボタンを押された場合は，画面の再表示だけをする。エラー処理は，必要に応じて追加する。

ファイル入出力処理は実行していないため，必要に応じて追加する。表示データは固定となっている。

(4)　コーディング例

この例題のソースプログラムを「DSPWRITE.cbl」として/opt/HIXMAP/samples/COBOLに提供しています。ソースプログラムからコーディング上のポイントを抜粋して次に示します。

マップ名を変更する
プログラム中の「@@@555」を「GCTBL1」に変更します。

出力データの代入処理をする

ボタンの判定処理をする

マッピングオプションを設定する

5.9.9　GENDSP01パターンを使用したヘルプ画面の表示

＜この項の構成＞

(1)　処理の概要

(2)　使用するマップの概要

(3)　AP作成上のポイント

(4)　コーディング例

(1)　処理の概要

受注データ登録画面を一次ウィンドウとして表示します。「顧客コード」または「商品コード」にカーソルがあるときに［F10］キーを押すと，それぞれの項目の入力を補助するためのヘルプ画面を二次ウィンドウとして表示します。

ヘルプ画面から一次ウィンドウに戻ると，ヘルプ画面は消えて，一次ウィンドウが活性状態になります。入力途中でヘルプ画面を表示した場合でも，そのデータは保証されます。

顧客コードの項目に対するヘルプ画面を表示する場合の処理の概要を次に示します。

図5-25　ヘルプ画面の表示処理

(2)　使用するマップの概要

作成するGUI画面の基になる定義サンプルを次に示します。

受注データ登録画面の定義サンプル：GFILD3ND

ヘルプ画面の定義サンプル：HELP01ND

ヘルプ画面のレイアウトは，任意に定義してください。

一次ウィンドウ作成時には，次の注意が必要です。

一次ウィンドウに対する二次ウィンドウの表示位置をあらかじめ指定しておく。

一次ウィンドウには，ヘルプ画面を表示するためのファンクションキー，またはプッシュボタンを割り当てておく。

二次ウィンドウであるヘルプ画面を作成するときには，次の点に注意する必要があります。

サンプルは一次ウィンドウのため，二次ウィンドウとして指定し直す必要がある。

また，ヘルプ画面には，次の特長があります。

［OK］ボタンのプッシュボタンダイアログで「二次ウィンドウを閉じる」の属性が指定してある。

画面に入出力フィールドは配置していない。

(3)　AP作成上のポイント

作成するAPの基になるAPパターンとAP部品を次に示します。

メインプログラムで使用するAPパターン：GENDSP01

サブルーチンで使用するAP部品：FLDHLP01

このAP部品を使用してAPを作成するには，次の注意が必要です。

一次ウィンドウの再表示ではマッピングオプションを変更する。

ヘルプ画面消去後も一次ウィンドウでの入力データを保持するために，入力フォーカス項目とフォーカス定数を比較して，フォーカスのあるフィールドを特定する。

(4)　コーディング例

この例題のソースプログラムを「HELPOUT.cbl」として/opt/HIXMAP/samples/COBOLに標準提供しています。ソースプログラムからコーディング上のポイントを抜粋して次に示します。

マップ名を変更する
プログラム中の「@@@555」を「GFILD3」に変更し，「HELP01O」と「HELP01I」の取り込み処理を追加します。

［F10］キーを押したかどうかのチェック処理を追加する

APパターン「GENDSP01」にAP部品「FLDHLP01」を取り込み，@@@333を「HELP01」に変更する

カーソルのあるフィールドを特定する処理を追加する

ヘルプ画面を表示する処理を追加する

5.9.10　GENDSP01パターンを使用したダイアログの表示

＜この項の構成＞

(1)　処理の概要

(2)　使用するマップの概要

(3)　AP作成上のポイント

(4)　コーディング例

(1)　処理の概要

受注データ登録画面を一次ウィンドウとして表示します。［F10］キーを押すと，商品を検索できるダイアログを二次ウィンドウとして表示します。

ダイアログは，受注データ登録画面に重ねて表示されます。ダイアログでは，はじめに「商品分類」のリストで商品の候補を絞り込みます。次に「商品一覧」のリストから商品名を選んで［OK］ボタンを押すと，ダイアログが消えて，受注データ入力画面の「商品名」の欄に選んだ商品名が反映されます。

ダイアログを使用した入力補助の概要を次に示します。

図5-26　ダイアログを使用した入力補助

(2)　使用するマップの概要

作成するGUI画面の基になる定義サンプルを次に示します。

受注データ登録画面の定義サンプル：GFILD3ND

定義サンプルを使用しない場合は，レイアウトパターンの「中汎用ウィンドウ」を使用して定義してください。

ダイアログのサンプル：GLBOX3ND

複数選択リストボックスを使用した「商品一覧」のダイアログです。画面のサンプルを使用しない場合は，レイアウトパターンの「二次ウィンドウ／二段リストボックス（複数選択）」を使用して定義してください。

一次ウィンドウの作成時には，次の注意が必要です。

一次ウィンドウに対する二次ウィンドウの表示位置をあらかじめ指定しておく。

一次ウィンドウにダイアログを表示するためのファンクションキー，またはプッシュボタンを割り当てておく。

二次ウィンドウの作成時には，次の注意が必要です。

サンプルは一次ウィンドウのため，二次ウィンドウとして指定し直す必要がある。

また，二次ウィンドウには次の特長があります。

［OK］ボタンのプッシュボタンダイアログで「二次ウィンドウを閉じる」の属性が指定してある。

二次ウィンドウの結果は固定的に一次ウィンドウに反映される。

(3)　AP作成上のポイント

作成するAPの基になるAPパターンを次に示します。

メインプログラムで使用するAPパターン：GENDSP01

このAPパターンを使用してAPを作成するには，次の注意が必要です。

一次ウィンドウの再表示ではマッピングオプションを設定する。

ダイアログを表示する場合と，一次ウィンドウを表示する場合との区別をする。

ダイアログの再表示ではマッピングオプションを設定する。

一次ウィンドウや二次ウィンドウでのデータ入力のチェック処理は含まれていないため，必要があれば追加する。

ダイアログに表示するデータは，固定となっている。必要があれば，マスタファイルから入力して代入する処理などに変更する。

(4)　コーディング例

この例題のソースプログラムを「DAIALOG.CBL」として/opt/HIXMAP/samples/COBOLに標準提供しています。ソースプログラムからコーディング上のポイントを抜粋して次に示します。

マップ名を変更する
プログラム中の「@@@555」を「GFILD3」に変更します。

ファンクションキーの判定処理をする

APパターン「GENDSP01」にAP部品「NXTDSP01」を取り込み，「@@@666」を「GLBOX3」に変更する

二次ウィンドウの再表示処理（絞り込み後の選択）をする

二次ウィンドウの選択結果の一次ウィンドウへの反映をする

5.9.11　DSPPRT01パターンを使用した画面表示と帳票印刷

XMAP3/NETを使用すると，画面と帳票を定義できます。一つのAPで画面の表示と帳票の印刷をする業務を想定した例題を説明します。

＜この項の構成＞

(1)　処理の概要

(2)　使用するマップの概要

(3)　AP作成上のポイント

(4)　コーディング例

(1)　処理の概要

各帳票を印刷するためのメニュー画面を表示します。メニューから［F2...納品書］のプッシュボタンを選ぶと，納品書の帳票を印刷します。このとき，帳票はシリアルインパクトプリンタへ印刷されます。

メニュー画面の表示と帳票印刷の処理の概要を次に示します。

図5-27　メニュー画面の表示と帳票印刷

(2)　使用するマップの概要

作成する画面・帳票の基になる定義サンプルを次に示します。

メニュー画面の定義サンプル：BMENU1ND
画面のサンプルは，プッシュボタンのメニューだけから成るGUI画面です。

納品書の帳票の定義サンプル：LTABL16A
納品書の帳票はシリアルインパクトプリンタ用のものです。

(3)　AP作成上のポイント

作成するAPの基になるAPパターンを次に示します。

メインプログラムで使用するAPパターン：DSPPRT01

このAPでは，［F2...納品書］ボタンが押されたときの処理だけを記述しています。「納品書」を1ページ印刷すると，プログラムが終了します。

このAP作成時には，次の点に注意してください。

［F2...納品書］以外のボタンが押されたときの処理を追加する。

印刷データの代入処理を追加する。

メニュー画面でのエラーチェックを必要に応じて追加する。

(4)　コーディング例

この例題のソースプログラムを「NOHIN.cbl」として/opt/HIXMAP/samples/COBOLに標準提供しています。ソースプログラムからコーディング上のポイントを抜粋して次に示します。

マップ名を変更する
プログラム中の「@@@888」をBMENU1に変更し，「¥¥¥222」を「LTABL1」に変更します。

ファンクションキーの判定処理をする

印刷データの代入処理をする

5.9.12　GENREP01パターンを使用した同一帳票の複数枚印刷

1種類の帳票を一つのAPから複数枚印刷する方法について説明します。

＜この項の構成＞

(1)　処理の概要

(2)　帳票定義上のポイント

(3)　AP作成上のポイント

(4)　コーディング例

(1)　処理の概要

注文書3ページ分のデータを読み込み，帳票を無条件に3部印刷します。

注文書を印刷するときの処理概要を次に示します。

図5-28　注文書の印刷

(2)　帳票定義上のポイント

作成する帳票の基になる定義サンプルを次に示します。

注文書の定義サンプル：PTABL5

この定義サンプルは，ページプリンタ　網掛け帳票用です。印刷部数は1部で指定してあります。

(3)　AP作成上のポイント

作成するAPの基になるAPパターンを次に示します。

メインプログラムで使用するAPパターン名：GENREP01
このAPパターンでは，帳票に出力するデータは固定データを代入して，無条件に帳票を3部印刷する仕様になっています。ファイルからデータを読み込む仕様にする場合は，別にコーディングを追加する必要があります。

このほかに，AP作成時には次の注意が必要です。

出力先がページプリンタであるため，物理マップ名は「マップ名6B」を指定します。

印刷データがない場合に出力論理マップをクリアする処理を追加します。

印刷処理の繰り返し方法および印刷を終了するタイミングを指定します。

(4)　コーディング例

この例題のソースプログラムを「PRTREP03.CBL」として標準提供しています。ソースプログラムからコーディング上のポイントを抜粋して次に示します。

マップ名の変更
プログラム中の「¥¥¥111」を「PTABL5」に，「XX」を「6B」に変更します。

出力データの代入

帳票の印刷

5.9.13　GENREP01パターンを使用した複数種類の帳票印刷

2種類以上の帳票を一つのAPで印刷する方法について説明します。

＜この項の構成＞

(1)　処理の概要

(2)　帳票定義上のポイント

(3)　AP作成上のポイント

(4)　コーディング例

(1)　処理の概要

注文書を印刷したあとで，商品管理台帳を印刷します。

図5-29　2種類の帳票の印刷

(2)　帳票定義上のポイント

作成する帳票の基になる定義サンプルを次に示します。

注文書の定義サンプル：PTABL5

商品管理台帳の定義サンプル：PTABL7

上記のどちらの帳票も，ページプリンタ　網掛け帳票用です。印刷部数は1部で指定してあります。

(3)　AP作成上のポイント

作成するAPの基になるAPパターンを次に示します。

メインプログラムで使用するAPパターン名：GENREP01

サブルーチンで使用するAP部品名：NXTREP01
このプログラムでは，帳票に出力するデータは固定データを代入して，「注文書」印刷後，無条件に「商品管理台帳」を印刷する仕様になっています。ファイルからデータを読み込む仕様にする場合は，別にコーディングを追加する必要があります。このほかに，AP作成時には，印刷データがない場合に出力論理マップをクリアする処理を追加する必要があります。

(4)　コーディング例

この例題のソースプログラムを「PRTPAGES.cbl」として標準提供しています。ソースプログラムからコーディング上のポイントを抜粋して次に示します。

マップ名の変更
プログラム中の「¥¥¥111」を「PTABL5」に，「¥¥¥333」を「PTABL7」に，「XX」を「6B」に変更します。

出力データの代入および部品パターン「NXTPRT01」の取り込み

帳票の印刷

6.　アプリケーションのコンパイルから実行

アプリケーションのコンパイルから実行までの方法について説明します。

＜この章の構成＞

6.1　画面入出力・帳票出力するAPのコンパイル

6.2　書式オーバレイ印刷するAPのコンパイル（AIX，HP-UX，Solaris）

6.3　書式オーバレイ印刷時の環境変数（AIX，HP-UX，Solaris）

6.4　AP実行時の注意事項

6.5　書式オーバレイ印刷ユティリティ（AIX，HP-UX，Solaris）

6.1　画面入出力・帳票出力するAPのコンパイル

アプリケーションプログラムは，日立COBOLおよびC言語のそれぞれのコマンドを使ってコンパイルおよびリンケージします。また，リンケージでは，マップドライバライブラリと表示・印刷ライブラリとをリンクします。使用可能なライブラリは，アーカイブと共用があり，リンケージ時に選択できます。

実行可能ファイルの作成手順を図6-1に示します。

図6-1　実行可能ファイルの作成手順

＜この節の構成＞

6.1.1　COBOL2002

6.1.2　COBOL85

6.1.3　C言語

6.1.4　COBOL，およびC言語のAPが混在する場合のコンパイルとリンケージ

6.1.1　COBOL2002

COBOL2002で作成した，画面・帳票出力用APのコンパイル方法を説明します。なお，COBOL2002を使用できるのは，HP-UX（IPF）およびAIXの場合だけです。

＜この項の構成＞

(1)　HP-UX（IPF）環境でのコンパイル

(2)　AIX環境でのコンパイル（シフトJIS）

(3)　AIX環境でのコンパイル（EUC）

(1)　HP-UX（IPF）環境でのコンパイル

COBOL2002で記述した画面・帳票出力用APのソースプログラム（xxx.cbl）をHP-UX環境でコンパイルする方法について説明します。使用するコマンドは，ccbl2002コマンドです。

(a)　環境変数の設定

XMAP3 Serverで提供する登録集原文をCOPY文でAPに取り込む場合は，環境変数CBLLIBにXMAP3 Serverが提供する登録集原文のパスを設定します。

CBLLIB=$CBLLIB:/opt/HIXMAP/include/XMAP
export CBLLIB

(b)　オプション

使用するコンパイルオプションを次に示します。

-OutputFile：リンケージ時に実行可能ファイル名称を指定する場合に指定する

-JPN,Alnum：日本語項目などを英数字項目として扱う場合に指定する

-Main,System モジュール名：メインモジュールのコンパイルの場合に指定する。複数のモジュールをコンパイルする場合は，メインモジュール名の次にサブモジュール名を指定する

-L ライブラリパス：使用ライブラリの検索パスを指定する（必須）

-Wl,-a,default：共用ライブラリを使用する場合に指定する（省略時仮定値）

-Wl,-a,archive：アーカイブライブラリを使用する場合に指定する

-lxpdrv：マップドライバ実行ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

(c)　コンパイル例

HP-UX環境でのccbl2002コマンドによるコンパイル例を図6-2および図6-3に示します。

図6-2　HP-UX環境でのccbl2002コマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（画面・帳票印刷）

図6-3　HP-UX環境でのccbl2002コマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（画面・帳票印刷）

(2)　AIX環境でのコンパイル（シフトJIS）

COBOL2002で記述した画面・帳票出力用APのソースプログラム（xxx.cbl）をAIXのシフトJIS環境でコンパイルする方法について説明します。使用するコマンドは，ccbl2002コマンドです。

(a)　環境変数の設定

XMAP3 Serverで提供する登録集原文をCOPY文でAPに取り込む場合は，環境変数CBLLIBにXMAP3 Serverが提供する登録集原文のパスを設定します。

CBLLIB=$CBLLIB:/opt/HIXMAP/include/XMAP
export CBLLIB

(b)　オプション

使用するコンパイルオプションを次に示します。

-OutputFile：リンケージ時に実行可能ファイル名称を指定する場合に指定する

-JPN,Alnum：日本語項目などを英数字項目として扱う場合に指定する

-Main,System モジュール名：メインモジュールのコンパイルの場合に指定する。複数のモジュールをコンパイルする場合は，メインモジュール名の次にサブモジュール名を指定する

-L ライブラリパス：使用ライブラリの検索パスを指定する（必須）

-bdynamic：共用ライブラリを使用する場合に指定する（省略時仮定値）

-bstatic：アーカイブライブラリを使用する場合に指定する

-lxpdrv：マップドライバ実行ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

(c)　コンパイル例

AIXのシフトJIS環境でのccbl2002コマンドによるコンパイル例を図6-4および図6-5に示します。

図6-4　AIXのシフトJIS環境でのccbl2002コマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（画面・帳票印刷）

図6-5　AIXのシフトJIS環境でのccbl2002コマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（画面・帳票印刷）

(3)　AIX環境でのコンパイル（EUC）

COBOL2002で記述した画面・帳票出力用APのソースプログラム（xxx.cbl）をAIXのEUC環境でコンパイルする方法について説明します。使用するコマンドは，ccbl2002コマンドです。

なお，コンパイル時に使用する論理マップおよび動的変更テーブルは文字コードがシフトJISのため，EUCへのコード変換が必要です。詳細については，「4.5　論理マップおよび動的変更テーブルの文字コード変換（AIX，Linux，Solaris）」を参照してください。

(a)　環境変数の設定

XMAP3 Serverで提供する登録集原文をCOPY文でAPに取り込む場合は，環境変数CBLLIBにXMAP3 Serverが提供する登録集原文のパスを設定します。

CBLLIB=$CBLLIB:/opt/HIXMAP/include/XMAP
export CBLLIB

(b)　オプション

使用するコンパイルオプションを次に示します。

-OutputFile：リンケージ時に実行可能ファイル名称を指定する場合に指定する

-JPN,Alnum：日本語項目などを英数字項目として扱う場合に指定する

-EucPosition：半角かな使用時に72カラム制限を抑止する

-Main,System モジュール名：メインモジュールのコンパイルの場合に指定する。複数のモジュールをコンパイルする場合は，メインモジュール名の次にサブモジュール名を指定する

-L ライブラリパス：使用ライブラリの検索パスを指定する（必須）

-bdynamic：共用ライブラリを使用する場合に指定する（省略時仮定値）

-bstatic：アーカイブライブラリを使用する場合に指定する

-lxpdrv：マップドライバ実行ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

(c)　コンパイル例

AIXのEUC環境でのccbl2002コマンドによるコンパイル例を図6-6および図6-7に示します。

図6-6　AIXのEUC環境でのccbl2002コマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（画面・帳票印刷）

図6-7　AIXのEUC環境でのccbl2002コマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（画面・帳票印刷）

6.1.2　COBOL85

COBOL85で作成した，画面・帳票出力用APのコンパイル方法をOSごとに説明します。

＜この項の構成＞

(1)　AIX環境でのコンパイル（シフトJIS）

(2)　AIX環境でのコンパイル（EUC）

(3)　HP-UX環境でのコンパイル

(4)　Linux環境でのコンパイル

(5)　Solaris環境でのコンパイル（EUC）

(6)　Solaris環境でのコンパイル（シフトJIS）

(1)　AIX環境でのコンパイル（シフトJIS）

COBOL85で記述した画面・帳票出力用APのソースプログラム（xxx.cbl）をAIXのシフトJIS環境でコンパイルする方法について説明します。使用するコマンドは，ccblコマンドです。

(a)　環境変数の設定

XMAP3 Serverで提供する登録集原文をCOPY文でAPに取り込む場合は，環境変数CBLLIBにXMAP3 Serverが提供する登録集原文（JSVWATBL.cbl）のディレクトリ名称（/opt/HIXMAP/include/XMAP）を設定します。

CBLLIB=$CBLLIB:/opt/HIXMAP/include/XMAP
export CBLLIB

(b)　オプション

コンパイル時に使用するオプションを次に示します。

-o：リンケージ時に実行可能ファイル名称を指定する場合に指定する

-Na：日本語項目などを英数字項目として扱う場合に指定する

-Mw モジュール名：メインモジュールのコンパイルの場合に指定する。複数のモジュールをコンパイルする場合は，メインモジュール名の次にサブモジュール名を指定する

-L ライブラリパス：使用ライブラリの検索パスを指定する（必須）

-bdynamic：共用ライブラリを使用する場合に指定する（省略時仮定値）

-bstatic：アーカイブライブラリを使用する場合に指定する

-lxpdrv：マップドライバ実行ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

(c)　コンパイル例

AIXのシフトJIS環境でのccblコマンドによるコンパイル例を図6-8および図6-9に示します。

図6-8　AIXのシフトJIS環境でのccblコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（画面・帳票印刷）

図6-9　AIXのシフトJIS環境でのccblコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（画面・帳票印刷）

(2)　AIX環境でのコンパイル（EUC）

COBOL85で記述した画面・帳票出力用APのソースプログラム（xxx.cbl）をAIXのEUC環境でコンパイルする方法について説明します。使用するコマンドは，ccblコマンドです。

なお，コンパイル時に使用する論理マップおよび動的変更テーブルは文字コードがシフトJISのため，EUCへのコード変換が必要です。詳細については，「4.5　論理マップおよび動的変更テーブルの文字コード変換（AIX，Linux，Solaris）」を参照してください。

(a)　環境変数の設定

XMAP3 Serverで提供する登録集原文をCOPY文でAPに取り込む場合は，環境変数CBLLIBにXMAP3 Serverが提供する登録集原文（JSVWATBL.cbl）のディレクトリ名称（/opt/HIXMAP/include/XMAP）を設定します。

CBLLIB=$CBLLIB:/opt/HIXMAP/include/XMAP
export CBLLIB

(b)　オプション

コンパイル時に使用するオプションを次に示します。

-o：リンケージ時に実行可能ファイル名称を指定する場合に指定する

-Na：日本語項目などを英数字項目として扱う場合に指定する

-K1：半角かな使用時に72カラム制限を抑止する

-Mw モジュール名：メインモジュールのコンパイルの場合に指定する。複数のモジュールをコンパイルする場合は，メインモジュール名の次にサブモジュール名を指定する

-L ライブラリパス：使用ライブラリの検索パスを指定する（必須）

-bdynamic：共用ライブラリを使用する場合に指定する（省略時仮定値）

-bstatic：アーカイブライブラリを使用する場合に指定する

-lxpdrv：マップドライバ実行ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

(c)　コンパイル例

AIXのEUC環境でのccblコマンドによるコンパイル例を図6-10および図6-11に示します。

図6-10　AIXのEUC環境でのccblコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（画面・帳票印刷）

図6-11　AIXのEUC環境でのccblコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（画面・帳票印刷）

(3)　HP-UX環境でのコンパイル

COBOL85で記述した画面・帳票出力用APのソースプログラム（xxx.cbl）をHP-UX環境でコンパイルする方法について説明します。使用するコマンドは，ccblコマンドです。

(a)　環境変数の設定

XMAP3 Serverで提供する登録集原文をCOPY文でAPに取り込む場合は，環境変数CBLLIBにXMAP3 Serverが提供する登録集原文のパスを設定します。

CBLLIB=$CBLLIB:/opt/HIXMAP/include/XMAP
export CBLLIB

(b)　オプション

使用するコンパイルオプションを次に示します。

-o：リンケージ時に実行可能ファイル名称を指定する場合に指定する

-Na：日本語項目などを英数字項目として扱う場合に指定する

-Mw モジュール名：メインモジュールのコンパイルの場合に指定する。複数のモジュールをコンパイルする場合は，メインモジュール名の次にサブモジュール名を指定する

-L ライブラリパス：使用ライブラリの検索パスを指定する（必須）

-Wl,-a,default：共用ライブラリを使用する場合に指定する（省略時仮定値）

-Wl,-a,archive：アーカイブライブラリを使用する場合に指定する

-lxpdrv：マップドライバ実行ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

(c)　コンパイル例

HP-UX環境でのccblコマンドによるコンパイル例を図6-12および図6-13に示します。

図6-12　HP-UX環境でのccblコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（画面・帳票印刷）

図6-13　HP-UX環境でのccblコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（画面・帳票印刷）

(4)　Linux環境でのコンパイル

COBOL85で記述した画面・帳票出力用APのソースプログラム（xxx.cbl）をLinux環境でコンパイルする方法について説明します。使用するコマンドは，ccblコマンドです。

なお，コンパイル時に使用する論理マップおよび動的変更テーブルは文字コードがシフトJISのため，EUCへのコード変換が必要です。詳細については，「4.5　論理マップおよび動的変更テーブルの文字コード変換（AIX，Linux，Solaris）」を参照してください。

(a)　環境変数の設定

環境変数PATHおよびLD_LIBRARY_PATHに，COBOL85で提供するccblコマンドとライブラリのパスを設定します。

PATH=$PATH:/opt/HILNGcbl/bin
LD_LIBRARY_PATH=＄LD_LIBRARY_PATH:/opt/HILNGcbl/lib
export PATH LD_LIBRARY_PATH

XMAP3 Serverで提供する登録集原文をCOPY文でAPに取り込む場合は，環境変数CBLLIBにXMAP3 Serverが提供する登録集原文のパスを設定します。

CBLLIB=$CBLLIB:/opt/HIXMAP/include/XMAP
export CBLLIB

(b)　オプション

使用するコンパイルオプションを次に示します。

-o：リンケージ時に実行可能ファイル名称を指定する場合に指定する

-K1：半角かな使用時に72カラム制限を抑止する

-X5：リトルエンディアンの論理マップを使用する場合に指定する（必須）

-Na：日本語項目などを英数字項目として扱う場合に指定する

-L ライブラリパス：使用ライブラリの検索パスを指定する（必須）

-Wl,-Bstatic：アーカイブライブラリを使用する場合に指定する

-lxpdrv：マップドライバ実行ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

(c)　コンパイル例

Linux環境でのccblコマンドによるコンパイル例を図6-14および図6-15に示します。

図6-14　Linux環境でのccblコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（画面・帳票印刷）

図6-15　Linux環境でのccblコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（画面・帳票印刷）

(5)　Solaris環境でのコンパイル（EUC）

COBOL85で記述した画面・帳票出力用APのソースプログラム（xxx.cbl）をSolarisのEUC環境でコンパイルする方法について説明します。使用するコマンドは，ccblコマンドです。

なお，コンパイル時に使用する論理マップおよび動的変更テーブルは文字コードがシフトJISのため，EUCへのコード変換が必要です。詳細については，「4.5　論理マップおよび動的変更テーブルの文字コード変換（AIX，Linux，Solaris）」を参照してください。

(a)　環境変数の設定

環境変数PATHおよびLD_LIBRARY_PATHに，COBOL85で提供するccblコマンドおよびライブラリのパスを設定します。

PATH=$PATH:/opt/HILNGcbl/bin
LD_LIBRARY_PATH=＄LD_LIBRARY_PATH:/opt/HILNGcbl/lib:/usr/dt/lib
export PATH LD_LIBRARY_PATH

XMAP3 Serverで提供する登録集原文をCOPY文でAPに取り込む場合は，環境変数CBLLIBにXMAP3 Serverが提供する登録集原文のパスを設定します。

CBLLIB=$CBLLIB:/opt/HIXMAP/include/XMAP
export CBLLIB

(b)　オプション

コンパイル時に使用するオプションを次に示します。

-o：リンケージ時に実行可能ファイル名称を指定する場合に指定する

-Na：日本語項目などを英数字項目として扱う場合に指定する

-Mw モジュール名：メインモジュールのコンパイルの場合に指定する。複数のモジュールをコンパイルする場合は，メインモジュール名の次にサブモジュール名を指定する

-K1：半角かなを使用するとき，72カラム制限を抑止する

-L ライブラリパス：使用ライブラリの検索パスを指定する（必須）

-Bstatic：アーカイブライブラリを使用する場合に指定する

-Bdynamic：共用ライブラリを使用する場合に指定する（省略時仮定値）

-lxpdrv：マップドライバ実行ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

-lsocket：TCP/IP通信時に使用するライブラリ（必須）

-lnsl：TCP/IP通信時に使用するライブラリ（必須）

(c)　コンパイル例

SolarisのEUC環境でのccblコマンドによるコンパイル例を図6-16および図6-17に示します。

図6-16　SolarisのEUC環境でのccblコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（画面・帳票印刷）

図6-17　SolarisのEUC環境でのccblコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（画面・帳票印刷）

(6)　Solaris環境でのコンパイル（シフトJIS）

COBOL85で記述した画面・帳票出力用APのソースプログラム（xxx.cbl）をSolarisのシフトJIS環境でコンパイルする方法について説明します。使用するコマンドは，ccblコマンドです。

(a)　環境変数の設定

環境変数PATHおよびLD_LIBRARY_PATHに，COBOL85で提供するccblコマンドおよびライブラリのパスを設定します。

PATH=$PATH:/opt/HILNGcbl/bin
LD_LIBRARY_PATH=＄LD_LIBRARY_PATH:/opt/HILNGcbl/lib:/usr/dt/lib
export PATH LD_LIBRARY_PATH

XMAP3 Serverで提供する登録集原文をCOPY文でAPに取り込む場合は，環境変数CBLLIBにXMAP3 Serverが提供する登録集原文のパスを設定します。

CBLLIB=$CBLLIB:/opt/HIXMAP/include/XMAP
export CBLLIB

(b)　オプション

コンパイル時に使用するオプションを次に示します。

-o：リンケージ時に実行可能ファイル名称を指定する場合に指定する

-Na：日本語項目などを英数字項目として扱う場合に指定する

-Mw モジュール名：メインモジュールのコンパイルの場合に指定する。複数のモジュールをコンパイルする場合は，メインモジュール名の次にサブモジュール名を指定する

-L ライブラリパス：使用ライブラリの検索パスを指定する（必須）

-Bstatic：アーカイブライブラリを使用する場合に指定する

-Bdynamic：共用ライブラリを使用する場合に指定する（省略時仮定値）

-lxpdrv：マップドライバ実行ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

-lsocket：TCP/IP通信時に使用するライブラリ（必須）

-lnsl：TCP/IP通信時に使用するライブラリ（必須）

(c)　コンパイル例

SolarisのシフトJIS環境でのccblコマンドによるコンパイル例を図6-18および図6-19に示します。

図6-18　SolarisのシフトJIS環境でのccblコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（画面・帳票印刷）

図6-19　SolarisのシフトJIS環境でのccblコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（画面・帳票印刷）

6.1.3　C言語

C言語で作成した，画面・帳票出力用APのコンパイル方法をOSごとに説明します。

＜この項の構成＞

(1)　AIX環境でのコンパイル（シフトJIS）

(2)　AIX環境でのコンパイル（EUC）

(3)　HP-UX環境でのコンパイル

(4)　Linux環境でのコンパイル

(5)　Solaris環境でのコンパイル（EUC）

(6)　Solaris環境でのコンパイル（シフトJIS）

(1)　AIX環境でのコンパイル（シフトJIS）

C言語で記述した画面・帳票出力用APのソースプログラム（xxx.c）をAIXのシフトJIS環境でコンパイルする方法について説明します。使用するコマンドは，xlcコマンドです。

(a)　オプション

コンパイル時に使用するオプションを次に示します。

-o：リンケージ時に実行可能ファイル名称を指定する場合に指定する

-qmbcs：AP内でマルチバイト文字（日本語）を使用している場合に指定する

-I インクルードファイルパス：インクルードファイルの検索パスを指定する

-L ライブラリパス：使用ライブラリの検索パスを指定する（必須）

-bstatic：アーカイブライブラリを使用する場合に指定する

-bdynamic：共用ライブラリを使用する場合に指定する

-lxpdrv：マップドライバ実行ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

(b)　コンパイル例

AIXのシフトJIS環境でのxlcコマンドによるコンパイル例を図6-20および図6-21に示します。

図6-20　AIXのシフトJIS環境でのxlcコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（画面・帳票印刷）

図6-21　AIXのシフトJIS環境でのxlcコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（画面・帳票印刷）

(2)　AIX環境でのコンパイル（EUC）

C言語で記述した画面・帳票出力用APのソースプログラム（xxx.c）をAIXのEUC環境でコンパイルする方法について説明します。使用するコマンドは，xlcコマンドです。

なお，コンパイル時に使用する論理マップおよび動的変更テーブルは文字コードがシフトJISのため，EUCへのコード変換が必要です。詳細については，「4.5　論理マップおよび動的変更テーブルの文字コード変換（AIX，Linux，Solaris）」を参照してください。

(a)　オプション

コンパイル時に使用するオプションを次に示します。

-o：リンケージ時に実行可能ファイル名称を指定する場合に指定する

-qmbcs：AP内でマルチバイト文字（日本語）を使用している場合に指定する

-I インクルードファイルパス：インクルードファイルの検索パスを指定する

-L ライブラリパス：使用ライブラリの検索パスを指定する（必須）

-bstatic：アーカイブライブラリを使用する場合に指定する

-bdynamic：共用ライブラリを使用する場合に指定する

-lxpdrv：マップドライバ実行ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

(b)　コンパイル例

AIXのEUC環境でのxlcコマンドによるコンパイル例を図6-22および図6-23に示します。

図6-22　AIXのEUC環境でのxlcコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（画面・帳票印刷）

図6-23　AIXのEUC環境でのxlcコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（画面・帳票印刷）

(3)　HP-UX環境でのコンパイル

C言語で記述した画面・帳票出力用APのソースプログラム（xxx.c）をHP-UX環境でコンパイルする方法について説明します。使用するコマンドは，ccコマンドです。

(a)　オプション

コンパイル時に使用するオプションを次に示します。

-I：使用するヘッダファイルの検索パスを指定する

-L：使用するライブラリの検索パスを指定する（必須）

-Wl,-a,default：共用ライブラリを使用する場合に指定する（省略時仮定値）

-Wl,-a,archive：アーカイブライブラリを使用する場合に指定する

+DAportable：PA-RISC 1.1で使用する場合に指定する

-lxpdrv：マップドライバ実行ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

注意事項

+DAportable オプションは，PA-RISC 1.1およびIPFでAPをコンパイルする場合には指定しないでください。

(b)　コンパイル例

HP-UX環境でのccコマンドによるコンパイル例を図6-24および図6-25に示します。

図6-24　HP-UX環境でのccコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（画面・帳票印刷）

図6-25　HP-UX環境でのccコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（画面・帳票印刷）

(4)　Linux環境でのコンパイル

C言語で記述した画面・帳票出力用APのソースプログラム（xxx.c）をLinux環境でコンパイルする方法について説明します。使用するコマンドは，gccコマンドです。

なお，コンパイル時に使用する論理マップおよび動的変更テーブルは文字コードがシフトJISのため，EUCへのコード変換が必要です。詳細については，「4.5　論理マップおよび動的変更テーブルの文字コード変換（AIX，Linux，Solaris）」を参照してください。

(a)　オプション

コンパイル時に使用するオプションを次に示します。

-I：使用ヘッダファイルの検索パスを指定する

-L：使用ライブラリの検索パスを指定する（必須）

-Wl,-Bstatic：アーカイブライブラリを使用する場合に指定する

-lxpdrv：マップドライバ実行ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

(b)　コンパイル例

Linux環境でのgccコマンドによるコンパイル例を図6-26および図6-27に示します。

図6-26　Linux環境でのgccコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（画面・帳票印刷）

図6-27　Linux環境でのgccコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（画面・帳票印刷）

(5)　Solaris環境でのコンパイル（EUC）

C言語で記述した画面・帳票出力用APのソースプログラム（xxx.c）をSolarisのEUC環境でコンパイルする方法について説明します。使用するコマンドは，ccコマンドです。

なお，コンパイル時に使用する論理マップおよび動的変更テーブルは文字コードがシフトJISのため，EUCへのコード変換が必要です。詳細については，「4.5　論理マップおよび動的変更テーブルの文字コード変換（AIX，Linux，Solaris）」を参照してください。

(a)　オプション

コンパイル時に使用するオプションを次に示します。

-I：使用するヘッダファイルの検索パスを指定する

-L：使用するライブラリの検索パスを指定する（必須）

-Bdynamic：共用ライブラリを使用する場合に指定する（省略時仮定値）

-Bstatic：アーカイブライブラリを使用する場合に指定する

-lxpdrv：マップドライバ実行ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

-lsocket：TCP/IP通信時に使用するライブラリ（必須）

-lnsl：TCP/IP通信時に使用するライブラリ（必須）

(b)　コンパイル例

SolarisのEUC環境でのccコマンドによるコンパイル例を図6-28および図6-29に示します。

図6-28　SolarisのEUC環境でのccコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（画面・帳票印刷）

図6-29　SolarisのEUC環境でのccコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（画面・帳票印刷）

(6)　Solaris環境でのコンパイル（シフトJIS）

C言語で記述した画面・帳票出力用APのソースプログラム（xxx.c）をSolarisのシフトJIS環境でコンパイルする方法について説明します。使用するコマンドは，ccコマンドです。

(a)　オプション

コンパイル時に使用するオプションを次に示します。

-I：使用するヘッダファイルの検索パスを指定する

-L：使用するライブラリの検索パスを指定する（必須）

-Bdynamic：共用ライブラリを使用する場合に指定する（省略時仮定値）

-Bstatic：アーカイブライブラリを使用する場合に指定する

-lxpdrv：マップドライバ実行ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

-lsocket：TCP/IP通信時に使用するライブラリ（必須）

-lnsl：TCP/IP通信時に使用するライブラリ（必須）

(b)　コンパイル例

SolarisのシフトJIS環境でのccコマンドによるコンパイル例を図6-30および図6-31に示します。

図6-30　SolarisのシフトJIS環境でのccコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（画面・帳票印刷）

図6-31　SolarisのシフトJIS環境でのccコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（画面・帳票印刷）

6.1.4　COBOL，およびC言語のAPが混在する場合のコンパイルとリンケージ

COBOL，およびC言語のAPが混在する場合のコンパイルとリンケージの実行例を図6-32に示します。この例は，AIX環境（シフトJIS）の例です。

図6-32　COBOL，およびC言語のAPが混在する場合のコンパイルとリンケージの実行例（共用ライブラリ使用の場合）

6.2　書式オーバレイ印刷するAPのコンパイル（AIX，HP-UX，Solaris）

書式オーバレイ印刷用APのコンパイル方法を，使用言語およびOSごとに説明します。

＜この節の構成＞

6.2.1　COBOL2002

6.2.2　COBOL85

6.2.3　C言語

6.2.1　COBOL2002

COBOL2002で作成した，書式オーバレイ印刷するAPのコンパイル方法を説明します。なお，COBOL2002を使用できるのは，HP-UX（IPF）およびAIXの場合だけです。

＜この項の構成＞

(1)　HP-UX（IPF）環境でのコンパイル

(2)　AIX環境でのコンパイル（シフトJIS）

(3)　AIX環境でのコンパイル（EUC）

(1)　HP-UX（IPF）環境でのコンパイル

COBOL2002で記述した書式オーバレイ印刷用APのソースプログラム（xxx.cbl）をHP-UX環境でコンパイルする方法について説明します。使用するコマンドは，ccbl2002コマンドです。

(a)　オプション

コンパイル時に使用するオプションを次に示します。

-XMAP,LinePrint：順編成ファイルをXPプリンタに出力（書式オーバレイおよび行データの印刷制御付き）（必須）

-JPN,Alnum：日本語項目などを英数字項目として扱う場合に指定する

-Main,System：メインモジュールのコンパイルの場合に指定する。複数のモジュールをコンパイルする場合は，メインモジュール名の次にサブモジュール名を指定する

-L：使用するライブラリの検索パスを指定する（必須）

-Wl,-a,default ：共用ライブラリを使用する場合に指定する（省略時仮定値）

-Wl,-a,archive ：アーカイブライブラリを使用する場合に指定する

-lxmovl：書式オーバレイ出力ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

(b)　コンパイル例

HP-UX環境でのccbl2002コマンドによる書式オーバレイ印刷用APのコンパイル例を図6-33および図6-34に示します。

図6-33　HP-UX環境でのccbl2002コマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（書式オーバレイ印刷）

図6-34　HP-UX環境でのccbl2002コマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（書式オーバレイ印刷）

(2)　AIX環境でのコンパイル（シフトJIS）

COBOL2002で記述した書式オーバレイ印刷用APのソースプログラム（xxx.cbl）をAIXのシフトJIS環境でコンパイルする方法について説明します。使用するコマンドは，ccbl2002コマンドです。

(a)　オプション

コンパイル時に使用するオプションを次に示します。

-XMAP,LinePrint：順編成ファイルをXPプリンタに出力（書式オーバレイおよび行データの印刷制御付き）（必須）

-OutputFile：リンケージ時に実行可能ファイル名称を指定する場合に指定する

-JPN,Alnum：日本語項目などを英数字項目として扱う場合に指定する

-Main,System モジュール名：メインモジュールのコンパイルの場合に指定する。複数のモジュールをコンパイルする場合は，メインモジュール名の次にサブモジュール名を指定する

-L ライブラリパス：使用するライブラリの検索パスを指定する（必須）

-bdynamic：共用ライブラリを使用する場合に指定する（省略時仮定値）

-bstatic：アーカイブライブラリを使用する場合に指定する

-lxmovl：書式オーバレイ出力ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

(b)　コンパイル例

AIXのシフトJIS環境でのccbl2002コマンドによるコンパイル例を図6-35および図6-36に示します。

図6-35　AIXのシフトJIS環境でのccbl2002コマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（書式オーバレイ印刷）

図6-36　AIXのシフトJIS環境でのccbl2002コマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（書式オーバレイ印刷）

(3)　AIX環境でのコンパイル（EUC）

COBOL2002で記述した書式オーバレイ印刷用APのソースプログラム（xxx.cbl）をAIXのEUC環境でコンパイルする方法について説明します。使用するコマンドは，ccbl2002コマンドです。

(a)　オプション

コンパイル時に使用するオプションを次に示します。

-XMAP,LinePrint：順編成ファイルをXPプリンタに出力（書式オーバレイおよび行データの印刷制御付き）（必須）

-OutputFile：リンケージ時に実行可能ファイル名称を指定する場合に指定する

-JPN,Alnum：日本語項目などを英数字項目として扱う場合に指定する

-EucPosition：半角かな使用時に72カラム制限を抑止する

-Main,System モジュール名：メインモジュールのコンパイルの場合に指定する。複数のモジュールをコンパイルする場合は，メインモジュール名の次にサブモジュール名を指定する

-L ライブラリパス：使用するライブラリの検索パスを指定する（必須）

-bdynamic：共用ライブラリを使用する場合に指定する（省略時仮定値）

-bstatic：アーカイブライブラリを使用する場合に指定する

-lxmovl：書式オーバレイ出力ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

(b)　コンパイル例

AIXのEUC環境でのccbl2002コマンドによるコンパイル例を図6-37および図6-38に示します。

図6-37　AIXのEUC環境でのccbl2002コマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（書式オーバレイ印刷）

図6-38　AIXのEUC環境でのccbl2002コマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（書式オーバレイ印刷）

6.2.2　COBOL85

COBOL85で記述した，書式オーバレイ印刷用APのコンパイル方法をOSごとに説明します。

＜この項の構成＞

(1)　AIX環境でのコンパイル（シフトJIS）

(2)　AIX環境でのコンパイル（EUC）

(3)　HP-UX環境でのコンパイル

(4)　Solaris環境でのコンパイル（EUC）

(5)　Solaris環境でのコンパイル（シフトJIS）

(1)　AIX環境でのコンパイル（シフトJIS）

COBOL85で記述した書式オーバレイ印刷用APのソースプログラム（xxx.cbl）をAIXのシフトJIS環境でコンパイルする方法について説明します。使用するコマンドは，ccblコマンドです。

(a)　オプション

コンパイル時に使用するオプションを次に示します。

-Xp：順編成ファイルをXPプリンタに出力（書式オーバレイ付き）（必須）

-Ks：順編成ファイルをXPプリンタに出力（行データの印刷制御付き）（必須）

-Na：日本語項目などを英数字項目として扱う場合に指定する

-Mw：メインモジュールを指定する

-L：使用するライブラリの検索パスを指定する（必須）

-bstatic：アーカイブライブラリを使用する場合に指定する

-bdynamic：共用ライブラリを使用する場合に指定する（省略時仮定値）

-lxmovl：書式オーバレイ印刷ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

(b)　コンパイル例

AIXのシフトJIS環境でのccblコマンドによる書式オーバレイ印刷用APのコンパイル例を図6-39および図6-40に示します。

図6-39　AIXのシフトJIS環境でのccblコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（書式オーバレイ印刷）

図6-40　AIXのシフトJIS環境でのccblコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（書式オーバレイ印刷）

(2)　AIX環境でのコンパイル（EUC）

COBOL85で記述した書式オーバレイ印刷用APのソースプログラム（xxx.cbl）をAIXのEUC環境でコンパイルする方法について説明します。使用するコマンドは，ccblコマンドです。

(a)　オプション

コンパイル時に使用するオプションを次に示します。

-Xp：順編成ファイルをXPプリンタに出力（書式オーバレイ付き）（必須）

-Ks：順編成ファイルをXPプリンタに出力（行データの印刷制御付き）（必須）

-Na：日本語項目などを英数字項目として扱う場合に指定する

-Mw：メインモジュールを指定する

-K1：半角かな使用時に72カラム制限を抑止する

-L：使用するライブラリの検索パスを指定する（必須）

-bstatic：アーカイブライブラリを使用する場合に指定する

-bdynamic：共用ライブラリを使用する場合に指定する（省略時仮定値）

-lxmovl：書式オーバレイ印刷ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

(b)　コンパイル例

AIXのEUC環境でのccblコマンドによる書式オーバレイ印刷用APのコンパイル例を図6-41および図6-42に示します。

図6-41　AIXのEUC環境でのccblコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（書式オーバレイ印刷）

図6-42　AIXのEUC環境でのccblコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（書式オーバレイ印刷）

(3)　HP-UX環境でのコンパイル

COBOL85で記述した書式オーバレイ印刷用APのソースプログラム（xxx.cbl）をHP-UX環境でコンパイルする方法について説明します。使用するコマンドは，ccblコマンドです。

(a)　オプション

コンパイル時に使用するオプションを次に示します。

-Xp：順編成ファイルをXPプリンタに出力（書式オーバレイ付き）（必須）

-Ks：順編成ファイルをXPプリンタに出力（行データの印刷制御付き）（必須）

-Na：日本語項目などを英数字項目として扱う場合に指定する

-Mw：メインモジュールのコンパイルの場合に指定する。複数のモジュールをコンパイルする場合は，メインモジュール名の次にサブモジュール名を指定する

-L：使用するライブラリの検索パスを指定する（必須）

-Wl,-a,default ：共用ライブラリを使用する場合に指定する（省略時仮定値）

-Wl,-a,archive ：アーカイブライブラリを使用する場合に指定する

-lxmovl：書式オーバレイ出力ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

(b)　コンパイル例

HP-UX環境でのccblコマンドによる書式オーバレイ印刷用APのコンパイル例を図6-43および図6-44に示します。

図6-43　HP-UX環境でのccblコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（書式オーバレイ印刷）

図6-44　HP-UX環境でのccblコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（書式オーバレイ印刷）

(4)　Solaris環境でのコンパイル（EUC）

COBOL85で記述した書式オーバレイ印刷用APのソースプログラム（xxx.cbl）をSolarisのEUC環境でコンパイルする方法について説明します。使用するコマンドは，ccblコマンドです。

(a)　環境変数の設定

環境変数PATHおよびLD_LIBRARY_PATHに，COBOL85で提供するccblコマンドおよびライブラリのパスを設定します。

PATH=$PATH:/opt/HILNGcbl/bin
LD_LIBRARY_PATH=＄LD_LIBRARY_PATH:/opt/HILNGcbl/lib:/usr/dt/lib
export PATH LD_LIBRARY_PATH

(b)　オプション

コンパイル時に使用するオプションを次に示します。

-Xp：順編成ファイルをXPプリンタに出力（書式オーバレイ付き）（必須）

-Ks：順編成ファイルをXPプリンタに出力（行データの印刷制御付き）（必須）

-Na：日本語項目などを英数字項目として扱う場合に指定する

-Mw：メインモジュールを指定する

-K1：半角かな使用時に72カラム制限を抑止する

-L：使用するライブラリの検索パスを指定する（必須）

-Bdynamic：共用ライブラリを使用する場合に指定する（省略時仮定値）

-Bstatic：アーカイブライブラリを使用する場合に指定する

-lxmovl：書式オーバレイ印刷ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

-lsocket：TCP/IP通信時に使用するライブラリ（必須）

-lnsl：TCP/IP通信時に使用するライブラリ（必須）

(c)　コンパイル例

SolarisのEUC環境でのccblコマンドによる書式オーバレイ印刷用APのコンパイル例を図6-45および図6-46に示します。

図6-45　SolarisのEUC環境でのccblコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（書式オーバレイ印刷）

図6-46　SolarisのEUC環境でのccblコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（書式オーバレイ印刷）

(5)　Solaris環境でのコンパイル（シフトJIS）

COBOL85で記述した書式オーバレイ印刷用APのソースプログラム（xxx.cbl）をSolarisのシフトJIS環境でコンパイルする方法について説明します。使用するコマンドは，ccblコマンドです。

(a)　環境変数の設定

環境変数PATHおよびLD_LIBRARY_PATHに，COBOL85で提供するccblコマンドおよびライブラリのパスを設定します。

PATH=$PATH:/opt/HILNGcbl/bin
LD_LIBRARY_PATH=＄LD_LIBRARY_PATH:/opt/HILNGcbl/lib:/usr/dt/lib
export PATH LD_LIBRARY_PATH

(b)　オプション

コンパイル時に使用するオプションを次に示します。

-Xp：順編成ファイルをXPプリンタに出力（書式オーバレイ付き）（必須）

-Ks：順編成ファイルをXPプリンタに出力（行データの印刷制御付き）（必須）

-Na：日本語項目などを英数字項目として扱う場合に指定する

-Mw：メインモジュールを指定する

-L：使用するライブラリの検索パスを指定する（必須）

-Bdynamic：共用ライブラリを使用する場合に指定する（省略時仮定値）

-Bstatic：アーカイブライブラリを使用する場合に指定する

-lxmovl：書式オーバレイ印刷ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

-lsocket：TCP/IP通信時に使用するライブラリ（必須）

-lnsl：TCP/IP通信時に使用するライブラリ（必須）

(c)　コンパイル例

SolarisのシフトJIS環境でのccblコマンドによる書式オーバレイ印刷用APのコンパイル例を図6-47および図6-48に示します。

図6-47　SolarisのシフトJIS環境でのccblコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（書式オーバレイ印刷）

図6-48　SolarisのシフトJIS環境でのccblコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（書式オーバレイ印刷）

6.2.3　C言語

C言語で記述した，書式オーバレイ印刷用APのコンパイル方法をOSごとに説明します。

＜この項の構成＞

(1)　AIX環境でのコンパイル（シフトJIS）

(2)　AIX環境でのコンパイル（EUC）

(3)　HP-UX環境でのコンパイル

(4)　Solaris環境でのコンパイル（EUC）

(5)　Solaris環境でのコンパイル（シフトJIS）

(1)　AIX環境でのコンパイル（シフトJIS）

C言語で記述した書式オーバレイ印刷用APのソースプログラム（xxx.c）をAIXシフトJIS環境でコンパイルする方法について説明します。使用するコマンドは，xlcコマンドです。

(a)　オプション

コンパイル時に使用するオプションを次に示します。

-I：使用ヘッダファイルの検索パスを指定する

-L：使用ライブラリの検索パスを指定する（必須）

-bdynamic：共用ライブラリを使用する場合に指定する（省略時仮定値）

-bstatic：アーカイブライブラリを使用する場合に指定する

-lxmovl：書式オーバレイ出力ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

(b)　コンパイル例

AIXのシフトJIS環境でのxlcコマンドによる書式オーバレイ印刷用APのコンパイル例を図6-49および図6-50に示します。

図6-49　AIXシフトJIS環境でのxlcコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（書式オーバレイ印刷）

図6-50　AIXシフトJIS環境でのxlcコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（書式オーバレイ印刷）

(2)　AIX環境でのコンパイル（EUC）

C言語で記述した書式オーバレイ印刷用APのソースプログラム（xxx.c）をAIXのEUC環境でコンパイルする方法について説明します。使用するコマンドは，xlcコマンドです。

(a)　オプション

コンパイル時に使用するオプションを次に示します。

-I：使用ヘッダファイルの検索パスを指定する

-L：使用ライブラリの検索パスを指定する（必須）

-bdynamic：共用ライブラリを使用する場合に指定する（省略時仮定値）

-bstatic：アーカイブライブラリを使用する場合に指定する

-lxmovl：書式オーバレイ出力ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

(b)　コンパイル例

AIXのEUC環境でのxlcコマンドによる書式オーバレイ印刷用APのコンパイル例を図6-51および図6-52に示します。

図6-51　AIXのEUC環境でのxlcコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（書式オーバレイ印刷）

図6-52　AIXのEUC環境でのxlcコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（書式オーバレイ印刷）

(3)　HP-UX環境でのコンパイル

C言語で記述した書式オーバレイ印刷用APのソースプログラム（xxx.c）をHP-UX環境でコンパイルする方法について説明します。使用するコマンドは，ccコマンドです。

(a)　オプション

コンパイル時に使用するオプションを次に示します。

-I：使用するヘッダファイルの検索パスを指定する

-L：使用するライブラリの検索パスを指定する（必須）

-Wl,-a,default：共用ライブラリを使用する場合に指定する（省略時仮定値）

-Wl,-a,archive：アーカイブライブラリを使用する場合に指定する

+DAportable：PA-RISC 1.1で使用する場合に指定する

-lxmovl：書式オーバレイ出力ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

注意事項

+DAportable オプションは，PA-RISC 1.1でAPをコンパイルする場合には指定しないでください。

(b)　コンパイル例

HP-UX環境でのccコマンドによる書式オーバレイ印刷用APのコンパイル例を図6-53および図6-54に示します。

図6-53　HP-UX環境でのccコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（書式オーバレイ印刷）

図6-54　HP-UX環境でのccコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（書式オーバレイ印刷）

(4)　Solaris環境でのコンパイル（EUC）

C言語で記述した書式オーバレイ印刷用APのソースプログラム（xxx.c）をSolarisのEUC環境でコンパイルする方法について説明します。使用するコマンドは，ccコマンドです。

(a)　オプション

コンパイル時に使用するオプションを次に示します。

-I：使用するヘッダファイルの検索パスを指定する

-L：使用するライブラリの検索パスを指定する（必須）

-Bdynamic：共用ライブラリを使用する場合に指定する（省略時仮定値）

-Bstatic：アーカイブライブラリを使用する場合に指定する

-lxmovl：書式オーバレイ出力ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

-lsocket：TCP/IP通信時に使用するライブラリ（必須）

-lnsl：TCP/IP通信時に使用するライブラリ（必須）

(b)　コンパイル例

SolarisのEUC環境でのccコマンドによる書式オーバレイ印刷用APのコンパイル例を図6-55および図6-56に示します。

図6-55　SolarisのEUC環境でのccコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（書式オーバレイ印刷）

図6-56　SolarisのEUC環境でのccコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（書式オーバレイ印刷）

(5)　Solaris環境でのコンパイル（シフトJIS）

C言語で記述した書式オーバレイ印刷用APのソースプログラム（xxx.c）をSolarisのシフトJIS環境でコンパイルする方法について説明します。使用するコマンドは，ccコマンドです。

(a)　オプション

コンパイル時に使用するオプションを次に示します。

-I：使用するヘッダファイルの検索パスを指定する

-L：使用するライブラリの検索パスを指定する（必須）

-Bdynamic：共用ライブラリを使用する場合に指定する（省略時仮定値）

-Bstatic：アーカイブライブラリを使用する場合に指定する

-lxmovl：書式オーバレイ出力ライブラリを指定する（必須）

-lxpw：表示・印刷ライブラリを指定する（必須）

-lsocket：TCP/IP通信時に使用するライブラリ（必須）

-lnsl：TCP/IP通信時に使用するライブラリ（必須）

(b)　コンパイル例

SolarisのシフトJIS環境でのccコマンドによる書式オーバレイ印刷用APのコンパイル例を図6-57および図6-58に示します。

図6-57　SolarisのシフトJIS環境でのccコマンドによる実行例（単一ファイル，共用ライブラリ使用の場合）（書式オーバレイ印刷）

図6-58　SolarisのシフトJIS環境でのccコマンドによる実行例（単一ファイル，アーカイブライブラリ使用の場合）（書式オーバレイ印刷）

6.3　書式オーバレイ印刷時の環境変数（AIX，HP-UX，Solaris）

書式オーバレイを印刷する場合，書式名などの情報を環境変数で設定できます。

設定できる環境変数を表6-1に示します。

表6-1　書式オーバレイ印刷時の環境変数

項目 | 環境変数名 | 指定値
印刷サービス名称 | XMAP3_PSNAME | 14文字以内の文字列
書式名 | XMAP3_FMP | 8文字以内の文字列
書体指定 | XMAP3_FORMAT | 1／2／9
印刷部数 | XMAP3_COPIES | 1～32
印刷ドキュメント名 | XMAP3_DOCNAME | 259文字以内の文字列

＜この節の構成＞

(1)　XMAP3_PSNAME（印刷サービス名）

(2)　XMAP3_FMP（書式名）

(3)　XMAP3_FORMAT（書体）

(4)　XMAP3_COPIES（印刷部数）

(5)　XMAP3_DOCNAME（印刷ドキュメント名）

(1)　XMAP3_PSNAME（印刷サービス名）

出力先の印刷サービス名を指定します。印刷サービス名は，サービス名ファイル（/etc/opt/HIXMAP/XPWhosts）に設定した出力先の印刷用サービス名称を指定します。

印刷サービス名の優先順位は，「6.4.2　書式オーバレイ印刷時の優先順位（AIX，HP-UX，Solaris）」を参照してください。

(2)　XMAP3_FMP（書式名）

出力する書式名を指定します。書式名は，書式イメージファイルの拡張子（.fmp）を除く名称を8文字以内で指定します。

書式名の優先順位は，「6.4.2　書式オーバレイ印刷時の優先順位（AIX，HP-UX，Solaris）」を参照してください。

(3)　XMAP3_FORMAT（書体）

出力する行データの書体を指定します。書体は，明朝体の場合「1」，ゴシック体の場合「2」，OCR体の場合は「9」を指定します。省略した場合は，ドローの行データ属性で指定した書体が有効となります。

書体の優先順位は，「6.4.2　書式オーバレイ印刷時の優先順位（AIX，HP-UX，Solaris）」を参照してください。

(4)　XMAP3_COPIES（印刷部数）

同じ書式を複数枚印刷するときの印刷部数を指定します。印刷部数は，1～32の範囲で指定します。印刷部数を省略した場合は，「1」が仮定されます。

(5)　XMAP3_DOCNAME（印刷ドキュメント名）

出力する印刷ドキュメント名を指定します。印刷ドキュメント名は，259文字※以内の文字列で指定します。259文字を超える文字列が指定された場合，指定は無効となります。なお，この指定値は，C/S構成でクライアントPC上の印刷サービスに印刷する場合だけ有効となります。印刷ドキュメント名の優先順位は，「6.4.2　書式オーバレイ印刷時の優先順位（AIX，HP-UX，Solaris）」を参照してください。

注※

全角1文字は，半角2文字分として数えます。

6.4　AP実行時の注意事項

APを実行する場合の注意事項について説明します。

＜この節の構成＞

6.4.1　共用ライブラリ使用時の環境変数（Linux，Solaris）

6.4.2　書式オーバレイ印刷時の優先順位（AIX，HP-UX，Solaris）

6.4.3　書式オーバレイ印刷時の注意事項（AIX，HP-UX，Solaris）

6.4.1　共用ライブラリ使用時の環境変数（Linux，Solaris）

共用ライブラリを使用したAPを実行する場合，環境変数 LD_LIBRARY_PATH にXMAP3 Serverで提供するライブラリパスを設定します。設定方法は次のとおりです。

<設定方法>

LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/HIXMAP/lib
export LD_LIBRARY_PATH

6.4.2　書式オーバレイ印刷時の優先順位（AIX，HP-UX，Solaris）

書式オーバレイ印刷するAPを実行する場合，APでの設定および環境変数の設定によって有効になる優先順位があります。設定項目ごとに優先順位を説明します。

＜この項の構成＞

(1)　印刷サービス名

(2)　書式名

(3)　書体

(4)　書式イメージファイル格納ディレクトリ

(5)　印刷ドキュメント名

(1)　印刷サービス名

印刷サービス名の優先順位は，次の順番で有効となります。

日立COBOLのAPでASSIGN句を指定し，COBOLの環境変数（CBLX_外部装置名）に指定した印刷サービス名，またはC言語のAPでjstqlopn関数に指定した印刷サービス名

環境変数（XMAP3_PSNAME）に設定した印刷サービス名

(2)　書式名

書式名の優先順位は，次の順番で有効となります。

日立COBOLのAPでAPPLY FORMS-OVERLAY句に指定したデータ名に書式名，またはC言語のAPでjstqlpag関数に指定した書式名

環境変数（XMAP3_FMP）に設定した書式名

(3)　書体

書体の優先順位は，次の順番で有効となります。

日立COBOLのAPでCHARACTER TYPE句のFORMAT-nに指定した書体，またはC言語のAPでjstqlctp関数に指定した書体

環境変数（XMAP3_FORMAT）に設定した書体
なお，書体以外の文字サイズ，文字の間隔，拡大については，APで設定した内容が反映されます。

ドロー定義時の行データ属性ダイアログで設定した書体

(4)　書式イメージファイル格納ディレクトリ

書式イメージファイルを格納するディレクトリの優先順位は，次の順番で有効となります。

マップドライバ環境定義ファイル（/etc/opt/HIXMAP/XMAPdrv）のmapPathで指定したディレクトリのパス名

AP実行時のカレントディレクトリ

(5)　印刷ドキュメント名

印刷ドキュメント名の優先順位は，次の順番で有効となります。

環境変数（XMAP3_DOCNAME)に指定した印刷ドキュメント名

書式オーバレイの定義時，書式属性中の「印刷ドキュメント名」に指定した印刷ドキュメント名

「XMAP3」または「XMAP3△△△FNAM-書式イメージファイル名」（PDFファイル出力の場合には「書式イメージファイル名」）

6.4.3　書式オーバレイ印刷時の注意事項（AIX，HP-UX，Solaris）

書式オーバレイは，シリアルプリンタには出力できません。APかユティリティ実行時に指定するサービス名は，サービス名ファイル（/etc/opt/HIXMAP/XPWhosts）に指定するデバイス名にページプリンタが指定されている必要があります。

6.5　書式オーバレイ印刷ユティリティ（AIX，HP-UX，Solaris）

書式オーバレイ印刷ユティリティは，指定された書式をテキストファイル中の行データと重ねて印刷するユティリティプログラムです。書式オーバレイ印刷ユティリティを利用することで，テキストファイルがあれば簡単に書式付きの帳票を印刷できます。また，書式だけをテスト印刷することもできます。

ここでは，書式オーバレイ印刷ユティリティの実行方法について説明します。

＜この節の構成＞

6.5.1　環境変数の設定

6.5.2　書式オーバレイ印刷ユティリティコマンド

6.5.3　印刷例

6.5.1　環境変数の設定

書式オーバレイ印刷ユティリティを実行する場合は，環境変数PATHに，「/opt/HIXMAP/bin」を設定してください。

6.5.2　書式オーバレイ印刷ユティリティコマンド

＜この項の構成＞

(1)　処理の流れ

(2)　形式の説明

(3)　注意事項

(1)　処理の流れ

(2)　形式の説明

書式オーバレイ印刷ユティリティコマンドの形式を次に示します。

-s　印刷サービス名

出力先の印刷サービス名を指定します。

印刷サービス名は，サービス名ファイル（/etc/opt/HIXMAP/XPWhosts）に設定した出力先の印刷用サービス名称を指定します。印刷サービス名を省略したときは，環境変数「XMAP3_PSNAME」で指定した名称が仮定されます。

-f　書式名

出力する書式名を指定します。書式名は，書式イメージファイルの拡張子（.fmp）を除いた8文字以内の文字列で指定します。

書式名を省略したときは，環境変数「XMAP3_FMP」で指定した名称が仮定されます。

テキストファイル

テキストファイルの名称を指定します。テキストファイルは，全角／半角から構成されるファイルで，文字，数字，記号だけのファイルとします。制御コードは，改行（(0A)₁₆）および改ページコード（(0C)₁₆）だけで，テキストファイルの先頭から行データとして印刷します。

-T　書式名

テスト印刷する書式名を指定します。書式名は，拡張子（.fmp）を除いた8文字以内の文字列で指定します。テスト印刷の場合は，必ず書式名を指定します。

コマンド終了コード

書式オーバレイ印刷ユティリティコマンドの終了コードを次に示します。

0：正常終了

1：異常終了

(3)　注意事項

テキストファイルに指定する文字コードは，LANG環境変数に対応する文字コードにしてください。

テスト印刷，またはAP実行環境で書式オーバレイをシリアルプリンタに印刷することはできません。

テスト印刷の実行環境で，書式イメージファイルと行制御データファイルは，同じディレクトリに格納してください。

書式オーバレイなしの行データだけの印刷はできません。ただし，何も定義していない空の書式を作成すると，行データだけの印刷ができます。

印刷時には，マップドライバ環境定義ファイル（/etc/opt/HIXMAP/XMAPdrv）のmapPathで指定されているディレクトリが参照されます。mapPathで指定されているディレクトリに指定した書式ファイルがない場合は，カレントディレクトリが参照されます。

6.5.3　印刷例

次に書式オーバレイ印刷ユティリティで出力した印刷例を示します。

7.　XMAP3 Serverの環境設定

XMAP3 Serverを利用した業務の運用を開始する前に，APを実行するための環境を設定しておく必要があります。

この章では，システム構成別の環境設定例と，実行環境の設定手順について説明します。

＜この章の構成＞

7.1　LANG環境変数

7.2　AP作成の準備

7.3　スタンドアロン構成での環境設定例

7.4　WSとPCによるC/S構成での環境設定例

7.5　クラスタ構成での環境設定（HP-UX（PA-RISC），AIX）

7.6　環境設定ファイルの編集

7.7　XMAP3でのプリンタの設定

7.8　表示・印刷環境のカスタマイズ

7.9　表示色をカスタマイズする

7.10　印刷色をカスタマイズする（AIX，HP-UX，Solaris）

7.11　通信データを圧縮する

7.12　印刷環境をカスタマイズする

7.13　プレプリント帳票を印刷するための準備（AIX，Linux，Solaris）

7.14　外字の設定（AIX，HP-UX）

7.15　PDFファイル出力に関連する設定と注意事項（AIX，HP-UX，Solaris）

7.16　出力／固定グラフィック帳票をスタンドアロン構成で印刷する（HP-UX（PA-RISC），AIX）

7.17　JP1/NPS連携時に1ページごとにジョブを登録する（HP-UX（PA-RISC），AIX）

7.18　ESC/Pプリンタでプリンタ任せの改ページ印刷をする（AIX）

7.19　論理ハードコピーを印刷する

7.1　LANG環境変数

XMAP3 Serverを日本語環境の設定をLANG環境変数で設定します。表7-1に対応する設定値を示します。

なお，APおよびXMAP3サーバを起動する前に，使用環境に対応する値をLANG環境変数に設定してください。

表7-1　LANG環境変数の設定値

文字コード
LANG環境変数の設定値

AIX
HP-UX
Linux
Solaris

シフトJIS
Ja_JP※
ja_JP.SJIS※
－
ja_JP.PCK

EUC
ja_JP
－
ja
ja_JP.eucJP※
ja_JP.ujis
japanese※
ja

（凡例）

－：未サポート

注※

値を設定しない場合，または設定値が不正だった場合に，XMAP3 Serverが仮定する設定値です。

7.2　AP作成の準備

日立COBOLをWSにインストールし，APを作成するためのディレクトリを準備します。

＜この節の構成＞

7.2.1　APを作成するためのディレクトリを用意する

7.2.2　XMAP3 Serverの標準提供ファイルから必要なファイルを複写する

7.2.3　APの作成方法

7.2.4　プログラムパターンと部品パターン

7.2.5　APパターンを利用したAPの作成手順

7.2.1　APを作成するためのディレクトリを用意する

ソースプログラムや登録集原文を格納したり，コンパイルで生成される作業ファイルを格納したりするディレクトリを用意します。開発環境に合わせて，ディレクトリの分類，作成位置や名称を決めます。

例えば，ルート直下でユーザユニークな名称の開発用ディレクトリ（ここでは，「XMAPUSER」とします）を作成し，この下に「userprog」というディレクトリを，その下にCOBOL登録集原文を格納する「copylib」，APのソースを格納する「source」，そして実行形式ファイルを格納する「bin」ディレクトリを作成します。

7.2.2　XMAP3 Serverの標準提供ファイルから必要なファイルを複写する

XMAP3 Serverでは，APの作成に必要な登録集原文※を標準提供しています。この登録集原文を，「7.2.1　APを作成するためのディレクトリを用意する」で作成したディレクトリに複写して使用することをお勧めします。また，APの作成に使う論理マップ，APパターンおよび提供業務サンプルのCOBOLソースプログラム，AP実行時に使用する物理マップを複写してください。

コマンドプロンプトから次のコマンドを投入し，ファイルを複写してください。

cp /opt/HIXMAP/include/XMAP/*.cbl /XMAPUSER/userprog/copylib/
cp /opt/HIXMAP/samples/COBOL/*.cbl /XMAPUSER/userprog/source/
cp /opt/HIXMAP/map/COBOL/*.cbl /XMAPUSER/userprog/source/
cp /opt/HIXMAP/map/COBOL/*NC /XMAPUSER/userprog/bin/
cp /opt/HIXMAP/map/COBOL/*ND /XMAPUSER/userprog/bin/
cp /opt/HIXMAP/map/COBOL/*6A /XMAPUSER/userprog/bin/
cp /opt/HIXMAP/map/COBOL/*6B /XMAPUSER/userprog/bin/
cp /opt/HIXMAP/map/COBOL/*6G /XMAPUSER/userprog/bin/

注※　標準提供されている登録集原文（COBOL用）を紹介します。

動的変更テーブル「X3MODTBL.cbl」

APの実行中に画面の色などの表示属性を変更する場合や，出力エリア（出力論理マップ）の初期化する場合に使用する定数が指定されています。なお，PC XMAP3でWS用の動的変更テーブルを作成した場合は，標準提供のテーブルは使用しないでください。必ず，PC XMAP3で作成した動的変更テーブルをファイル転送して使用してください。また，PC XMAP3で作成された動的変更テーブルは文字コードがシフトJISのため，EUC環境で使用する場合はEUCへのコード変換が必要です。詳細については，「4.5　論理マップおよび動的変更テーブルの文字コード変換（AIX，Linux，Solaris）」を参照してください。

インタフェース領域「JSVWATBL.cbl」

CALLインタフェースを利用する（CALL文で画面の送受信または帳票の送信を実行する）ときに使用します。このマニュアルで説明しているSEND文，RECEIVE文，またはTRANSCEIVE文を使う場合は必要ありません。

7.2.3　APの作成方法

XMAP3では，画面入出力や帳票出力処理のコーディングのひな形を標準提供しています。これを，APパターンといいます。APパターンを利用することで，効率良くコーディングできます。また，各プログラムの構造は，APパターンを基に標準化されるため，プログラムのわかりやすさを向上することもできます。ここでは，APパターンを利用したAPの作成方法を解説します。

なお，標準提供されている業務サンプルのソースプログラムを流用し，APを作成することもできます。業務サンプルの概要については，「付録B　標準提供例題プログラムの使用方法」を参照してください。ただし，AIX用に提供しているすべての例題プログラムは，シフトJIS環境を対象にしています。EUC環境では使用できませんので注意してください。

7.2.4　プログラムパターンと部品パターン

画面，帳票に対応して複数のAPパターンが用意されています。APパターンは，プログラムパターンと部品パターンに大きく分けられます。

プログラムパターン

COBOLソースプログラムの見出し部，データ部，手続き部など，プログラム全体の標準的な骨組みが記述されています。

部品パターン

業務共通に，頻繁に使うと考えられる処理の手続きが記述されています。

7.2.5　APパターンを利用したAPの作成手順

コーディングを始める前に，標準提供されているAPパターンの種類と，それぞれの処理内容について，ある程度理解しておくことをお勧めします。APパターンの種類については，「付録B　標準提供例題プログラムの使用方法」を参照してください。

プログラムパターンと部品パターンを編集したり，コーディングしたりする作業は通常，エディタを使用します。APパターンの利用イメージを図7-1に示し，APの作成手順を説明します。

図7-1　APパターンの利用イメージ

画面や帳票のレイアウト定義とあわせて，プログラムの仕様を決定します。

プログラムパターンを決定します。
プログラムの仕様を基に，コーディングに利用するプログラムパターンを選びます。プログラムパターンを参考にしながら，処理の流れ，データ入出力の流れを詳細に検討します。

部品パターンを組み込みます。
処理内容に合わせて利用する部品パターンを決めます。2で検討した処理の流れに従って部品パターンを組み込み，コーディングのベースを作ります。

コーディングします。
プログラム名や，マップ名，ファイルなどを定義し，業務固有の手続きをコーディングします。このとき，コンパイルで取り込む論理マップや動的変更テーブルをCOPY文に指定します。
コーディングを終えたソースプログラムは，コンパイルしたあと，実行してテスト・デバッグができるようになります。

7.3　スタンドアロン構成での環境設定例

スタンドアロン構成で帳票を印刷するAPの実行環境について，具体例を挙げて説明します。

＜この節の構成＞

7.3.1　帳票を印刷するAPを実行する場合

7.3.1　帳票を印刷するAPを実行する場合

APを実行する場合の環境設定例について説明します。

＜この項の構成＞

(1)　システム構成

(2)　ユーザ環境

(3)　使用するAP

(4)　環境設定ファイルを編集する

(5)　APを実行する

(1)　システム構成

(2)　ユーザ環境

ホスト名：host102

IPアドレス：200.10.10.2

プリンタ名：PR2（ページプリンタ）

上記以外の項目は，環境設定ファイルの標準値を使用します。また，XMAP3 Server以外で，ポート番号8500を使用するプログラムはないと仮定します。

(3)　使用するAP

提供サンプルソース（jyutupc.cbl）をコンパイルして生成し，実行形式ファイル用ディレクトリに出力した，実行形式ファイル（jyutupc）を使用します。APが使用する実行形式の物理マップ（JYU1PC6G）も，実行形式ファイルと同じディレクトリにあると仮定します。

jyutupc.cblのSYMBOLIC TERMINAL部のプリンタに関する部分を次に示します。

(4)　環境設定ファイルを編集する

環境設定では，次のファイルを編集します。

ポート番号管理ファイル

ホストアドレス管理ファイル

仮想端末定義ファイル

サービス名ファイル

各ファイルの記述内容を次に示します。なお，XMAP3 Serverで提供する環境設定ファイルの内容からユーザ環境に合わせて変更した部分については網掛けとします。環境設定ファイルの詳細については，「7.6　環境設定ファイルの編集」を参照してください。

ポート番号管理ファイル（services）

ホストアドレス管理ファイル（hosts）
hostsファイルに，次のように設定されているか確認してください。記述されていない場合は，記述してください。

仮想端末定義ファイル（XMAPhosts）

サービス名ファイル（XPWhosts）

(5)　APを実行する

APを実行する手順を説明します。

次のコマンドを入力して，XMAP3サーバを起動します。各サーバが起動した状態で環境設定ファイルを編集した場合は，一度停止してから再起動します。
/opt/HIXMAP/bin/xpwdaemon -s &

次のコマンドを入力して，AP（jyutupc）を実行します。
cd /XMAPUSER/userprog/bin
jyutupc
APを実行したWSに接続されたプリンタに，帳票を印刷できるようになります。

7.4　WSとPCによるC/S構成での環境設定例

WSとPCによるC/S構成で，各PCで実行するAPが異なる場合と，各PCで実行するAPが共通な場合の実行環境について，具体例を挙げて説明します。

＜この節の構成＞

7.4.1　各PCで実行するAPが異なる場合

7.4.2　各PCで実行するAPが共通な場合

7.4.3　C/Sシステムの通信設定の簡略化

7.4.4　起動クライアントを通知する場合の設定（AIX，HP-UX）

7.4.1　各PCで実行するAPが異なる場合

各PCで実行するAPが異なる場合の環境設定例について説明します。

＜この項の構成＞

(1)　システム構成

(2)　ユーザ環境

(3)　使用するAP

(4)　環境設定ファイルを編集する

(5)　APを実行する

(1)　システム構成

この例では，ホスト名host102のWSにある二つのAPを別々のPCから起動して，APを起動したPCのディスプレイに画面を表示します。具体的には，ホスト名host103のPCからAP1（jyutugc）を，ホスト名host104のPCからAP2（jyutugc2）を実行して，それぞれ自ホストのディスプレイに画面を表示します。

(2)　ユーザ環境

サーバ側の環境

ホスト名host102のWS
IPアドレス：200.10.10.2

クライアント側の環境

ホスト名host103のPC
IPアドレス：200.10.10.3

ホスト名host104のPC
IPアドレス：200.10.10.4

上記以外の項目は，環境設定ファイルの標準値を使用します。また， XMAP3 Server以外で，ポート番号8500を使用するプログラムはないと仮定します。

(3)　使用するAP

(a)　ホスト名host103のPCに画面を表示するAP

提供サンプルソース（jyutugc.cbl）をコンパイルし，実行形式ファイル用ディレクトリ（/XMAPUSER/userprog/bin）に出力した，実行形式ファイル（jyutugc）を使用します。APが使用する実行形式の物理マップ（JYU1GCND）も，実行形式ファイルと同じディレクトリにあると仮定します。

jyutugc.cblのSYMBOLIC TERMINAL部のディスプレイに関する部分を次に示します。

(b)　ホスト名host104のPCに画面を表示するAP

提供サンプルソースを編集して，APを作成します。APの作成手順を次に示します。

提供サンプルソース（jyutugc.cbl）を/XMAPUSER/userprog/sourceに複写して，jyutugc2.cblというファイル名に変更します。

ソース中の仮想端末名を，「DSP001」から「DSP002」に変更します。

コンパイルして，/XMAPUSER/userprog/binに実行形式ファイル（jyutugc2）を作成します。

なお，APが使用する実行形式の物理マップ（JYU1GCND）も，実行形式ファイルと同じディレクトリにあると仮定します。

jyutugc2.cblのSYMBOLIC TERMINAL部のディスプレイに関する部分を次に示します。

(4)　環境設定ファイルを編集する

サーバ側のWSとクライアント側のPCで，環境設定ファイルを編集します。次に，サーバとクライアントで編集するファイルについて説明します。

(a)　サーバ側で編集するファイル

ホスト名host102のWSで，次の環境設定ファイルを編集します。

ポート番号管理ファイル

ホストアドレス管理ファイル

仮想端末定義ファイル

サービス名ファイル

各ファイルの記述内容を次に示します。なお，XMAP3 Serverで提供する環境設定ファイルの内容からユーザ環境に合わせて変更した部分については網掛けとします。環境設定ファイルの詳細については，「7.6　環境設定ファイルの編集」を参照してください。

ポート番号管理ファイル（services）

ホストアドレス管理ファイル（hosts）
hostsファイルに，次のように設定されているか確認してください。記述されていない場合は，記述してください。ただし，DNSを使用した環境では，この設定は不要です。

仮想端末定義ファイル（XMAPhosts）

サービス名ファイル（XPWhosts）
クライアントがPCの場合は，デバイス名の代わりに同一行の先頭に指定したサービス名を指定します。また，APが動作するWSのホスト名やAPの完全パス名も指定する必要があります。

(b)　クライアント側で編集するファイル

ホスト名host103およびhost104の各PCで，次の環境設定ファイルを編集します。

ポート番号管理ファイル

ホストアドレス管理ファイル

各ファイルの記述内容を，次に示します。

ポート番号管理ファイル（services）

ホストアドレス管理ファイル（hosts）
hostsファイルに，次のように設定されているか確認してください。記述されていない場合は，記述してください。

(5)　APを実行する

APを実行する手順を説明します。

ホスト名host102のWSで次のコマンドを入力して，サーバ側のXMAP3サーバを起動します。各サーバが起動した状態で環境設定ファイルを編集した場合は，一度停止してから再起動します。

 /opt/HIXMAP/bin/xpwdaemon -s &

PCでXmap3clt.exeを起動して，クライアント側のXMAP3クライアントを起動します。
XMAP3クライアントが起動されると，ホスト名host102のWS上にあるAPが自動的に起動され，PCのディスプレイに画面が表示されます。

7.4.2　各PCで実行するAPが共通な場合

各PCで実行するAPが共通な場合の環境設定例について説明します。

＜この項の構成＞

(1)　システム構成

(2)　ユーザ環境

(3)　使用するAP

(4)　環境設定ファイルを編集する

(5)　APを実行する

(1)　システム構成

この例では，WS（ホスト名host102）上にある画面表示用のAP（kadnngc）をPC（ホスト名host103およびhost104）から実行し，APを起動したPCのディスプレイに画面を表示します。また，表示された画面で帳票の印刷を指示して，WS（ホスト名host102）からネットワークに接続されているプリンタに帳票を印刷します。

(2)　ユーザ環境

サーバ側の環境

ホスト名host102のWS
IPアドレス：200.10.10.2
プリンタ名：PR2（ページプリンタ）

クライアント側の環境

ホスト名host103のPC
IPアドレス：200.10.10.3

ホスト名host104のPC
IPアドレス：200.10.10.4

上記以外の項目は，環境設定ファイルの標準値を使用します。また， XMAP3 Server以外で，ポート番号8500を使用するプログラムはないと仮定します。

(3)　使用するAP

画面を表示したあと，画面操作によって帳票を印刷するAPを，提供サンプルソースを利用して作成します。利用する提供サンプルソースは，次の二つです。

画面表示用ソースファイル（kadn1gc.cbl）

帳票印刷用ソースファイル（kadn1pc.cbl）

次に，提供サンプルソースと，APの作成手順について説明します。

(a)　画面表示用ソースファイル（kadn1gc1.cbl）

画面の入出力処理が記述されたソースファイルです。次に，kadn1gc1.cblのSYMBOLIC TERMINAL部のディスプレイに関する部分を示します。

(b)　帳票印刷用ソースファイル（kadn1pc.cbl）

ページプリンタに帳票を印刷する処理が記述されたソースファイルです。次に，kadn1pc.cblのSYMBOLIC TERMINAL部のプリンタに関する部分を示します。

(c)　APの作成手順

APの作成手順の概要を次に示します。詳細については，「付録B.2　提供サンプルの利用手順」を参照してください。

提供サンプルソース（kadn1gc.cblおよびkadn1pc.cbl）をコンパイルして，実行形式ファイル（kadnngc）を/tmpに作成します。

実行形式ファイル（kadnngc）と実行形式物理マップを/XMAPUSER/userprog/binに複写します。

(4)　環境設定ファイルを編集する

サーバ側のWSとクライアント側のPCで，環境設定ファイルを編集します。次に，サーバとクライアントで編集するファイルについて説明します。

(a)　サーバ側で編集するファイル

ホスト名host102のWSで，次の環境設定ファイルを編集します。

ポート番号管理ファイル

ホストアドレス管理ファイル

仮想端末定義ファイル

サービス名ファイル

各ファイルの記述内容を次に示します。なお，XMAP3 serverで提供する環境設定ファイルの内容からユーザ環境に合わせて変更した部分については網掛けとします。環境設定ファイルの詳細については「7.6　環境設定ファイルの編集」を参照してください。

ポート番号管理ファイル（services）

ホストアドレス管理ファイル（hosts）
hostsファイルに，次のように設定されているか確認してください。記述されていない場合は，記述してください。

仮想端末定義ファイル（XMAPhosts）
この例では，一つの仮想端末名を使って複数の端末に画面を表示するので，表示サービス名に「**」を指定します。

サービス名ファイル（XPWhosts）
クライアントがPCの場合は，ディスプレイのデバイス名の代わりに同一行の先頭に指定したサービス名を指定します。また，APが動作するWSのホスト名やAPの完全パス名も指定する必要があります。

(b)　クライアント側で編集するファイル

ホスト名host103およびhost104の各PCで，次の環境設定ファイルを編集します。

ポート番号管理ファイル

ホストアドレス管理ファイル

各ファイルの記述内容を，次に示します。

ポート番号管理ファイル（services）

ホストアドレス管理ファイル（hosts）
hostsファイルに，次のように設定されているか確認してください。記述されていない場合は，記述してください。

(5)　APを実行する

APを実行する手順を説明します。

ホスト名host102のWSで次のコマンドを入力して，サーバ側のXMAP3サーバを起動します。各サーバが起動した状態で環境設定ファイルを編集した場合は，一度停止してから再起動します。

 /opt/HIXMAP/bin/xpwdaemon -s &

PCでXmap3clt.exeを起動して，クライアント側のXMAP3クライアントを起動します。
XMAP3クライアントが起動されると，ホスト名host102のWS上のAPが自動的に起動され，PCのディスプレイに画面が表示されます。

受注伝票発行業務画面［注文書印刷］ボタンを選びます。
ホスト名host102のWSに接続されているページプリンタに，帳票が印刷されます。

7.4.3　C/Sシステムの通信設定の簡略化

＜この項の構成＞

(1)　機能の概要

(2)　前提条件

(3)　環境設定と利用方法

(4)　C/Sシステムの通信設定簡略化機能を利用した設定例

(5)　使用上の注意事項

(1)　機能の概要

C/Sシステムの通信設定簡略化機能を使用すると，サービス名ファイル（XPWhosts）で，表示・印刷サービスが動作するクライアントのホスト名の指定を省略できます。これによって，どのクライアントPCからもXMAP3サーバに接続できるようになり，通信接続形態の自由度が向上します。

さらに，C/Sシステムの通信設定簡略化機能を適用することで，サーバ側のTCP/IP通信設定で，クライアントのホスト名称およびIPアドレスを設定する必要がなくなります。このため，サーバに接続するクライアントのホスト名称およびIPアドレスが変更されても，その変更の影響を受けることなくXMAP3サーバとクライアントPCの接続ができます。

C/Sシステムの通信設定簡略化機能の概要を図7-2に示します。

図7-2　C/Sシステムの通信設定簡略化機能の概要

(2)　前提条件

サーバ側で定義した一つの表示・印刷サービス名を利用するクライアントは必ず1台としてください。一つのサービス名を複数のクライアントで利用すると，1台のクライアントが強制終了したあとに，ほかのクライアントから接続できなくなる場合があります。

(3)　環境設定と利用方法

(a)　利用のための環境設定

C/Sシステムの通信設定簡略化機能は，サービス名ファイル中の通信設定を簡略したい表示・印刷サービスのエントリのホスト名項目に「*」を設定することで利用できます。

(b)　利用方法

C/Sシステムの通信設定簡略化機能を利用する場合は，クライアントPCのXMAP3クライアントの起動時に，実行時オプションの「/attach」を指定します。XMAP3クライアントの起動引数の詳細については，マニュアル「画面・帳票サポートシステム　XMAP3 開発・実行ガイド」を参照してください。

(4)　C/Sシステムの通信設定簡略化機能を利用した設定例

C/Sシステムの通信設定簡略化機能を利用した通信設定の例を図7-3に示します。

図7-3　C/Sシステムの通信設定簡略化機能を利用した通信設定の例

設定例の説明

サーバマシン（ホスト名Srvhost，IPアドレス xx.xx.xx.xx）では，XPWhostsでのクライアントホスト名の指定を省略します。また，/etc/servicesファイルにxpwポート番号（例：8500番）を指定します。なお，/etc/hostsファイルには，クライアントマシン（ホスト名Client1やClient2）の設定は不要です。

クライアントマシン（ホスト名Client1とClient2）では，SERVICESファイルにxpwポート番号（例：8500番）を指定し，HOSTSファイルにサーバマシン（ホスト名Srvhost）を指定します。

クライアントマシンのXMAP3クライアントの起動引数には，そのクライアントマシンで起動するサービス名称（xppDSP01，xppDSP02，またはxppPRT02）を指定します。

(5)　使用上の注意事項

C/Sシステムの通信設定簡略化機能を使用するときの注意事項を次に示します。

サービス名の重複定義にご注意ください
C/Sシステムの通信設定簡略化機能を使用すると，どのクライアントPCからもXMAP3サーバに接続できるようになり，本来は接続しないようなクライアントPCからも誤って接続できるようになります。したがって，運用前にクライアントPCでの表示・印刷サービス名の設定を十分に見直すようにしてください。
また，一つのXMAP3サーバと接続する複数のXMAP3クライアント同士で，それぞれのXMAP3クライアントの起動引数に誤って同じ名称の表示・印刷サービス名称を指定した場合，先にXMAP3サーバと接続できたXMAP3クライアントが有効となります。それ以外のXMAP3クライアントはXMAP3サーバと接続できません。この場合は，XMAP3サーバから出力されるエラーメッセージを参照して，誤った指定のあるクライアントを特定してください。

自動起動APが設定されているXMAP3サーバの再起動にご注意ください。
C/Sシステムで，XMAP3サーバとXMAP3クライアントが接続できている状態で，XMAP3サーバを終了し，XMAP3クライアントを起動した状態でXMAP3サーバを再起動すると，XMAP3サーバに設定されている自動起動APが（5022）₁₆または0x03010303エラーになる場合があります。
次のどちらかで対処してください。

XMAP3サーバを終了する前にXMAP3クライアントを終了させて，XMAP3サーバを起動後にXMAP3クライアントを起動してください。

エラー発生後にAPを再起動する場合，XMAP3サーバを起動したままで，XMAP3クライアントを終了したあとに再起動してください。

7.4.4　起動クライアントを通知する場合の設定（AIX，HP-UX）

この項では，C/S構成またはOLTP構成の環境で，起動中のクライアント端末をサーバ側で識別するための機能（以降，起動クライアント通知機能と表記する）の概要と利用方法ついて説明します。

＜この項の構成＞

(1)　機能概要

(2)　利用方法

(1)　機能概要

起動クライアント通知機能は，C/S構成またはOLTP構成の環境で，クライアント起動時にサーバ側APを自動実行する場合だけ利用できます。

XMAP3では，自動実行したサーバ側APの環境変数「XMAP3_CLIENTHOST」に，クライアント端末のホスト名を設定します。自動実行したサーバ側APから，環境変数「XMAP3_CLIENTHOST」に設定されたホスト名を取得することで，起動中のクライアント端末をサーバ側APで識別できます。

起動中のクライアント端末をサーバ側で識別できると，例えば，次のことができるようになります。

クライアント端末別に処理を振り分けて，処理の優先権を変更する。

クライアント端末別に，出力先のプリンタを振り分ける。

障害が発生したクライアント端末を特定する。

OLTP構成の環境の場合，確立したコネクションを，クライアント端末のホスト名から特定する。

クライアントの起動から，APがクライアント端末のホスト名を取得するまでの処理の流れを次に示します。

図中の1.～4.の処理について説明します。

ユーザがXMAP3クライアントを起動します。

XMAP3クライアントが起動すると，サーバ側APに自動実行の要求を出します。

XMAP3サーバが，自動実行するサーバ側APの環境変数「XMAP3_CLIENTHOST」に，起動したクライアント端末のホスト名「Client1」を設定します。

自動実行したサーバ側APが，環境変数「XMAP3_CLIENTHOST」から，ホスト名「Client1」を取得します。

環境変数「XMAP3_CLIENTHOST」には，サービス名ファイル（XPWhosts）で指定したホスト名が設定されます。サービス名ファイル（XPWhosts）で設定するホスト名の詳細については「7.6.7　サービス名ファイルを編集する」を参照してください。

例えば，Windows 2000の場合，環境変数「XMAP3_CLIENTHOST」には，「システムのプロパティ」の「コンピュータ名」に設定されている文字列が設定されます。

なお，クライアントの起動時に，実行時オプションの「/attach」を指定している場合，環境変数「XMAP3_CLIENTHOST」にはクライアント端末のホスト名が設定されます。「*」は設定されません。

(2)　利用方法

環境変数「XMAP3_CLIENTHOST」の値を取得するAPを作成して，作成したAPをクライアント起動時に自動実行するサーバ側APとして設定してください。設定方法の詳細については「7.6.7　サービス名ファイルを編集する」を参照してください。

7.5　クラスタ構成での環境設定（HP-UX（PA-RISC），AIX）

この節では，クラスタ構成でXMAP3 Serverを使用するための実行環境について，具体例を挙げて説明します。

＜この節の構成＞

7.5.1　システム構成

7.5.2　クラスタ構成でのサーバ側の環境設定

7.5.3　クラスタ構成でのクライアント側の環境設定

7.5.4　クラスタ構成での環境設定例

7.5.1　システム構成

＜図の説明＞

クライアント側のXMAP3クライアントでは，仮想ホストCのXMAP3サーバに接続します（物理ホストAに起動しているXMAP3サーバに接続します）（図中の（1））。
仮想ホスト名とは，/etc/hostsファイルで，クラスタ用のホスト名として定義されたホスト名称を示します。また，以降で説明する仮想IPアドレスは，クラスタ用ホスト名に対応するIPアドレスを示します。

ホストAまたはホストBのアプリケーションプログラムは，クライアントのXMAP3と通信します（図中の（2））。

サーバ上の印刷サービスは，XMAP3のサービス名ファイル（XPWhosts）の設定で，仮想ホストで動作するように設定します（図中の（3））。

系切り替えが発生した場合，物理ホストAで動作していたXMAP3サーバおよびアプリケーションプログラムを終了させる必要があります。物理ホストBでXMAP3サーバが起動されると，自動的にXMAP3クライアントが物理ホストBのXMAP3サーバと接続されます。

図中の（4）～（6）の接続で，運用が再開されます。

注

クラスタ構成でXMAP3 Serverを使用するためには，クラスタリング機能をサポートしたミドルウェア製品（HAモニタおよびHACMP）が前提となります。

7.5.2　クラスタ構成でのサーバ側の環境設定

ここでは，クラスタ構成でXMAP3 Serverを使用するためのサーバ側の環境について説明します。

＜この項の構成＞

(1)　ポート番号管理ファイルの編集

(2)　サービス名ファイル（XPWhosts）

(3)　その他のXMAP3設定ファイル

(1)　ポート番号管理ファイルの編集

クラスタ構成のサーバマシンでポート番号管理ファイル（services）に設定するサービス名（ポート番号）は，各物理ホストで同じ内容を設定します。

(2)　サービス名ファイル（XPWhosts）

サーバ側で動作する印刷サービスホスト名には，仮想ホスト名を指定します。また，APホスト名を指定する場合は，同様に仮想ホスト名を指定します。

(3)　その他のXMAP3設定ファイル

クラスタ構成のサーバマシンでは，各物理ホストで，すべて同じ内容を設定します。

7.5.3　クラスタ構成でのクライアント側の環境設定

ここでは，クラスタ構成でXMAP3 Serverを使用するためのクライアント側の環境について説明します。

＜この項の構成＞

(1)　ポート番号管理ファイル（services）の設定

(2)　ホストアドレス管理ファイル（hosts）

(3)　XMAP3クライアント起動用のショートカットアイコンの登録

(1)　ポート番号管理ファイル（services）の設定

XMAP3が利用するサービス名（ポート番号）には，サーバ側と同じ内容を設定します。

(2)　ホストアドレス管理ファイル（hosts）

接続先のサーバマシンの仮想IPアドレスと仮想ホスト名を指定します。

(3)　XMAP3クライアント起動用のショートカットアイコンの登録

XMAP3クライアントを起動するためのショートカットアイコンを登録して，起動パラメタ「/vh 仮想ホスト名」に，XMAP3サーバと接続する仮想ホスト名を指定します。起動パラメタは，次のように指定します。

XMAP3CLT.EXE /vh 仮想ホスト名

「/vh 仮想ホスト名」を指定した場合，仮想ホスト名に対応したIPアドレスで，XMAP3サーバとの通信を行います。

7.5.4　クラスタ構成での環境設定例

クラスタ構成での環境設定例を次に示します。

7.6　環境設定ファイルの編集

この節では，実行環境の設定に必要な情報を取得する方法，環境設定ファイルを編集する方法などについて説明します。

＜この節の構成＞

7.6.1　実行環境の設定に必要な情報を取得する

7.6.2　編集するファイルの一覧

7.6.3　仮想端末定義ファイル

7.6.4　マッピング構成ファイル

7.6.5　マッピング属性ファイル

7.6.6　マップドライバ環境定義ファイル

7.6.7　サービス名ファイルを編集する

7.6.8　表示・印刷環境ファイルを編集する

7.6.9　ホストアドレス管理ファイルを編集する

7.6.10　ポート番号管理ファイルを編集する

7.6.11　環境設定ファイルの設定項目とAPの設定項目との関係

7.6.1　実行環境の設定に必要な情報を取得する

環境設定ファイルに記述する情報を調査しておきます。調査する項目は，次のとおりです。

ホスト名

IPアドレス

ほかのプログラムが使用しているポート番号

プリンタ名

次に，それぞれの項目を調査する方法を説明します。

＜この項の構成＞

(1)　ホスト名を調査する

(2)　IPアドレスを調査する

(3)　ほかのプログラムが使用しているポート番号を調査する

(1)　ホスト名を調査する

作成したAPが動作するWS，画面を表示するPCおよび帳票を印刷するプリンタが接続されているWSのホスト名を調査しておきます。

WSの端末画面からhostnameコマンドを実行すると，コマンドを実行したWSのホスト名が表示されます。

コマンドの実行例を次に示します。この例では，ホスト名は「host102」になります。

C/S構成でクライアントにPCを使用する場合は，使用するPCのホスト名も調査しておいてください。ただし，C/Sシステムの通信設定の簡略化機能を使用する場合は，クライアントPCのホスト名は不要です。

(2)　IPアドレスを調査する

作成したAPが動作するWS，画面を表示するPCおよび帳票を印刷するプリンタが接続されているWSのIPアドレスを調査しておきます。

IPアドレスを調査したいWSの/etc/hostsファイルを参照して，(1)で調査したホスト名に対応するIPアドレスを検索します。

/etc/hostsファイルの表示例を次に示します。この例では，WS（ホスト名：host102）のIPアドレスは「200.10.10.2」になります。

C/S構成でクライアントにPCを使用する場合は，使用するPCのIPアドレスも調査しておいてください。

(3)　ほかのプログラムが使用しているポート番号を調査する

XMAP3 Serverとほかのプログラムが同じポート番号を使用していないか確認します。標準で使用するポート番号は8500です。

確認の手順は，次のとおりです。

ポート番号を確認したいWSの/etc/servicesファイルを参照します。
/etc/servicesファイルの表示例を次に示します。

netstat -aコマンドですべてのソケットの状態を表示して，ポート番号8500を使用しているプロセスがないかどうか確認します。
netstat -aコマンドの実行例を次に示します。

C/S構成でクライアントにPCを使用する場合は，使用するPCのservicesファイルを参照して，XMAP3 Server以外でポート番号8500を使用しているプログラムがないことを確認します。
XMAP3 Server以外でポート番号8500を使用しているプログラムがある場合には，次のファイルに設定するポート番号およびサービス番号を，ほかのプログラムが使用していない番号に変更してください。

ポート番号管理ファイル（services）

7.6.2　編集するファイルの一覧

必要な情報を取得したら，環境設定ファイルを編集します。なお，環境設定ファイルは，スーパユーザでないと編集できません。スーパユーザでログインするか，またはsuコマンドでスーパユーザになってから，各ファイルを編集してください。

編集するファイルの一覧をシステム構成別に示します。

＜この項の構成＞

(1)　スタンドアロン構成の場合に編集するファイルの一覧

(2)　C/S構成の場合に編集するファイルの一覧

(3)　OLTP構成の場合に編集するファイルの一覧

(1)　スタンドアロン構成の場合に編集するファイルの一覧

表7-2　編集するファイルの一覧（スタンドアロン構成の場合）

ファイルの種類 | ファイル名
仮想端末定義ファイル | /etc/opt/HIXMAP/XMAPhosts※1※2
マッピング構成ファイル | /etc/opt/HIXMAP/XMAPconfig※1※2
マッピング属性ファイル | /etc/opt/HIXMAP/XMAPsrv/xps※1※2
マップドライバ環境ファイル | /etc/opt/HIXMAP/XMAPdrv※1
サービス名ファイル | /etc/opt/HIXMAP/XPWhosts※1
表示・印刷環境ファイル | /etc/opt/HIXMAP/XPWconfig※1
ポート番号管理ファイル | /etc/services

注※1

定義項目は項目ごとに行末で改行してください。

注※2

書式印刷では無効なファイルです。

(2)　C/S構成の場合に編集するファイルの一覧

C/S構成の場合に編集するファイルの一覧を，サーバとクライアントに分けて示します。

表7-3　編集するファイルの一覧（C/S構成のサーバWSの場合）

ファイルの種類 | ファイル名
仮想端末定義ファイル | /etc/opt/HIXMAP/XMAPhosts※1※2
マッピング構成ファイル | /etc/opt/HIXMAP/XMAPconfig※1※2
マッピング属性ファイル | /etc/opt/HIXMAP/XMAPsrv/xps※1※2
マップドライバ環境ファイル | /etc/opt/HIXMAP/XMAPdrv※1
サービス名ファイル | /etc/opt/HIXMAP/XPWhosts※1
表示・印刷環境ファイル | /etc/opt/HIXMAP/XPWconfig※1
ポート番号管理ファイル | /etc/services
ホストアドレス管理ファイル | /etc/hosts

注※1

定義項目は項目ごとに行末で改行してください。

注※2

書式印刷では無効なファイルです。

表7-4　編集するファイルの一覧（C/S構成のクライアントPCの場合）

ファイルの種類
OS
ファイル名

ポート番号管理ファイル
Windows NT
Windows 2000
Windows XP
Windows Server 2003
Windowsフォルダ¥SYSTEM32¥DRIVERS¥ETC¥SERVICES

Windows 95
Windows 98
Windows Me
Windowsフォルダ¥SERVICES

ホストアドレス管理ファイル
Windows NT
Windows 2000
Windows XP
Windows Server 2003
Windowsフォルダ¥SYSTEM32¥DRIVERS¥ETC¥HOSTS

Windows 95
Windows 98
Windows Me
Windowsフォルダ¥HOSTS

(3)　OLTP構成の場合に編集するファイルの一覧

OLTP（TP1/NET/XMAP3）構成の場合に編集するファイルの一覧を，サーバとクライアントに分けて示します。

表7-5　編集するファイルの一覧（OLTP構成のサーバWSの場合）

ファイルの種類 | ファイル名
サービス名ファイル | /etc/opt/HIXMAP/XPWhosts
表示・印刷環境ファイル | /etc/opt/HIXMAP/XPWconfig
ポート番号管理ファイル | /etc/services
ホストアドレス管理ファイル | /etc/hosts

サービス名ファイルで定義した表示・印刷サービス名を，TP1/NET/XMAP3の「MCF通信構成定義」中の「コネクション定義（mcftalccn）」のサービス名に指定してください。

表7-6　編集するファイルの一覧（OLTP構成のクライアントPCの場合）

ファイルの種類
OS
ファイル名

ポート番号管理ファイル
Windows NT
Windows 2000
Windows XP
Windows Server 2003
Windowsフォルダ¥SYSTEM32¥DRIVERS¥ETC¥SERVICES

Windows 95
Windows 98
Windows Me
Windowsフォルダ¥SERVICES

ホストアドレス管理ファイル
Windows NT
Windows 2000
Windows XP
Windows Server 2003
Windowsフォルダ¥SYSTEM32¥DRIVERS¥ETC¥HOSTS

Windows 95
Windows 98
Windows Me
Windowsフォルダ¥HOSTS

7.6.3　仮想端末定義ファイル

＜この項の構成＞

(1)　設定ファイル

(2)　ファイルの記述形式

(1)　設定ファイル

仮想端末定義ファイルは，次に示すファイルにて設定します。

なお，TP1/NET/XMAP3を使用するOLTP構成，または書式印刷の際には無効なファイルのため，設定する必要はありません。

/etc/opt/HIXMAP/XMAPhosts

XMAP3 Serverは，マップドライバを使用してディスプレイに対して画面データの送受信を実行しています。また，プリンタに対しては帳票データの送信を実行しています。このため，実行時には仮想端末定義ファイルを指定する必要があります。このファイルの目的はアプリケーションプログラム中で指定する端末の論理名称（仮想端末名称）と実際のディスプレイ，またはプリンタとの対応です。

仮想端末定義ファイルは，1レコード（255バイト以内）に記述します。ファイル中に記述できるレコード数は1,000レコードまでです。ただし，1レコードが256バイト以上の場合は，マップドライバを起動できません。また，レコード内の各項目が不正な場合や1,000レコードを超えた仮想端末定義は無視されます。仮想端末定義ファイルの記述形式を次に示します。

(2)　ファイルの記述形式

仮想端末名称～＜英数字＞((8けた以内))

アプリケーションプログラムが指定する仮想端末名称を英字で始まる8けた以内（半角）で指定します。アプリケーションプログラム中で仮想端末名称を省略した場合は，仮想端末定義ファイルの先頭で定義した仮想端末名称を仮定します。

デバイス～＜英数字＞

仮想端末名称に対応するデバイスの種別を指定します。デバイスの種別を次に示します。

表7-7　デバイスの種別

種別 | デバイス | 備考
ディスプレイ | XDSPS1 | CUI画面
XDSPM1 | GUI画面
XDSP | 共通（CUI，GUI画面）※
プリンタ | XPRTL1 | シリアルインパクト けい線帳票
XPRTL3 | シリアルインパクト プレプリント帳票
XPRTP1 | ページプリンタ 網掛け帳票
XPRTP3 | ページプリンタ グラフィック帳票
XPRT | 共通（シリアル，ページ）※

注※

マップドライバ使用時にアプリケーションプログラム中で指定した物理マップ名称のIDによって選択されます。

ホスト名称～＜英数字，-，_＞((32文字以内))

「**」または自マシンのホスト名称を英字で始まる32文字以内（半角）で指定します。ただし，/etc/hostsファイル中に定義したホスト名称を指定します。

サービス番号～＜10進数＞((0固定))

「0」を指定します。

サービス名称

サービス名ファイル（/etc/opt/HIXMAP/XPWhosts）中に定義したサービス名称を指定します。

サービス名称は実行環境に合わせて変更します。

仮想端末の定義を増やす場合は，仮想端末の名称が，すでにある名称と重複しないようにします。

レコードの順番は変更できます。ただし，アプリケーションプログラム中で仮想端末名称の指定を省略してディスプレイへの送受信をする場合は，仮想端末定義のファイル中の先頭に定義されている仮想端末名称が仮定されます。

一つの仮想端末名称を複数クライアントで使用する場合は，サービス名称に「**」を指定してください。画面表示の場合はDISPLAY変数，帳票印刷の場合はPRINTER変数の設定値がサービス名称として扱われます。

なお，仮想端末定義ファイルで，サービス名称の省略指定「**」をした場合，サービス名ファイルの環境変数名として，DISPLAY/PRINTERの環境変数を指定してください。

マップドライバ環境定義ファイル名称

マップロードパスやプリンタ印刷方式など仮想端末ごとに環境を変える場合に，マップドライバ環境定義ファイル名を指定します。

この項目を省略した場合は，/etc/opt/HIXMAP/XMAPdrvを仮定します。

なお，存在しないファイル名称を指定した場合，仮定値でマッピングされます。

仮定値の詳細については，「表7-9　マップドライバ環境定義ファイルに指定する項目」の省略時仮定値を参照してください。

XMAP3 Serverが標準で提供するファイルでの仮想端末定義の設定値

7.6.4　マッピング構成ファイル

＜この項の構成＞

(1)　設定ファイル

(2)　ファイルの記述形式

(1)　設定ファイル

マッピング構成ファイルは，次に示すファイルで設定します。なお，書式印刷の際には無効なファイルのため，設定する必要はありません。

/etc/opt/HIXMAP/XMAPconfig

マッピング構成ファイルは，1レコード（255バイト以内）で記述します。1レコードが256バイト以上の場合，また，1レコード内の項目が不正の場合は，そのレコードを無視します。先頭から15レコードまで（不正レコードを含む）が有効であり，それよりあとのレコードは無視します。

マッピング構成ファイルの記述形式を次に示します。

(2)　ファイルの記述形式

ホスト名称～＜英数字，-，_＞((32文字以内))

「**」または自ホスト名称を英字で始まる32文字以内（半角）で指定します。また，/etc/hostsファイル中に定義されたホスト名称を指定します。

サービス番号～＜10進数＞((0固定))

「0」を指定します。

ファイル名称～＜英数字＞

「**」を指定します。

マッピング属性ファイル名称～((64文字以内))

マッピングの属性を定義したファイル名称を64文字以内（半角）で指定します。ただし，存在しないファイル名称を指定した場合，仮定値でマッピングを行います。

仮定値の詳細については，「表7-8　マッピング属性ファイルに指定する項目」の省略時仮定値を参照してください。

XMAP3 Serverが標準で提供するマッピング構成ファイルの設定値

7.6.5　マッピング属性ファイル

＜この項の構成＞

(1)　設定ファイル

(2)　ファイルの記述形式

(1)　設定ファイル

マッピング属性ファイルは，次に示すファイルで設定します。

/etc/opt/HIXMAP/XMAPsrv/xps

(2)　ファイルの記述形式

マッピング属性ファイルに指定する項目を次に示します。ただし，1項目について1レコード（255バイト以内）に記述します。1レコードが256バイト以上の場合は，ファイルの指定は無視されます。

表7-8　マッピング属性ファイルに指定する項目

項目 | パラメタ | 設定値 | 省略時仮定値
1バイトコードレベル | EBC | K｜C | K
2バイトコードレベル | KEIS | 83｜78 | 83

注：不当なキーワードは無視されます。

1バイトコードレベル

表示・印刷環境ファイルで指定したKEIS/EBCDIK使用時※の1バイトコードのレベルに合わせて指定します。指定値が不当な場合は，「K」を指定します。

EBC=K：1バイトコードとしてEBCDIKを使用する場合に指定します（標準）。

EBC=C：1バイトコードとしてEBCDICを使用する場合に指定します。

2バイトコードレベル

表示・印刷環境ファイルで指定したKEIS/EBCDIK使用時※の2バイトコードのレベルに合わせて指定します。指定値が不当な場合は，「83」を指定します。

KEIS=83：2バイトコードとしてKEIS83を使用する場合に指定します（標準）。

KEIS=78：2バイトコードとしてKEIS78を使用する場合に指定します。

注※

表示・印刷環境ファイル（XPWconfig）で指定する「*.COEBCD」パラメタおよび「*.COKSCD」パラメタの設定と合わせる必要があります。

XMAP3 Serverが標準で提供するマッピング属性ファイルの設定値

7.6.6　マップドライバ環境定義ファイル

＜この項の構成＞

(1)　設定ファイル

(2)　ファイルの記述形式

(1)　設定ファイル

マップドライバ環境定義ファイルは，次に示すファイルで設定します。

なお，TP1/NET/XMAP3を使用するOLTP構成では無効なファイルのため，設定する必要はありません。

/etc/opt/HIXMAP/XMAPdrv

(2)　ファイルの記述形式

マップドライバ環境定義ファイルは，マップドライバ実行時の属性を設定します。

また，マップドライバ環境定義ファイルは，仮想端末単位に指定できます。この場合，仮想端末定義ファイル中で指定したマップドライバ環境定義ファイルを指定します。なお，仮想端末定義ファイルでマップドライバ環境定義ファイル名称を省略した場合，標準で提供するファイルを仮定します。

マップドライバ環境定義ファイルに指定する項目を次に示します。ただし，1項目当たり1レコード（255バイト以内）に記述します。1レコードが256バイト以上の場合は，ファイルの指定は無視します。

表7-9　マップドライバ環境定義ファイルに指定する項目

項目 | パラメタ | 設定値 | 省略時仮定値
ログ種別 | logSelect | false｜standard｜full | standard
ログファイルパス | logPath | xxxxxxxx | .
マップロードパス | mapPath | xxxxxxxx | .
物理マップ常駐サイズ | PoolSize | nnnnn | 32768
プリンタ出力 | printOut | sync｜async | sync

注　不正なキーワードおよび指定値は無視します。

ログ種別～｛false｜standard｜full｝

ログ種別を指定します。ログ情報の詳細については，「9.2　ログ情報の利用方法」を参照してください。

false：ログを取得しない。

standard：標準形式でログを取得する。

full：標準形式と詳細形式でログを取得する。

ログファイルパス～((52文字以内))

ログ種別で「standard」，または「full」を指定した場合にログを格納するディレクトリのパスを52文字以内（半角）で指定します。この項目を省略した場合は，マップドライバが起動されたディレクトリにログファイルを格納します。

マップロードパス～((55文字以内))

物理マップ，書式イメージまたは行制御データを格納しているディレクトリのパスを55文字以内（半角）で指定します。ただし，末尾に「/」は付けません。この項目を省略した場合，または指定したパスで物理マップが見つからなかった場合は，マップドライバを起動したパスからロードされます。

物理マップ常駐サイズ～＜10進数＞

物理マップを常駐させるエリアのサイズを変更する場合だけその大きさをバイト数で指定します。上限は2,048,000バイトです。

プリンタ出力～｛sync｜async｝

SEND時に，プリンタへの出力指示との同期をとるかどうかを指定します。

sync：SEND時に，プリンタへの出力指示との同期をとる。

async：SEND時に，プリンタへの出力指示との同期をとらない。asyncに設定することで「7.12.1　LPスプールシステムでの帳票一括出力機能」を利用できます。

なお，帳票出力時にプリンタへの出力指示と同期をとらない場合，APからXMAP3 Serverへの各要求に同期してエラーリターンしない場合がありますので,ご注意ください。

XMAP3 Serverが標準で提供する環境定義ファイルの設定値

7.6.7　サービス名ファイルを編集する

＜この項の構成＞

(1)　設定ファイル

(2)　ファイルの記述形式

(3)　サービス名ファイルの標準値

(4)　スタンドアロンでXMAP3印刷サービスを使用するとき

(5)　クライアントPCとのC/SでXMAP3表示・印刷サービスと併用するとき

(1)　設定ファイル

サービス名ファイルは，次に示すファイルで設定します。

/etc/opt/HIXMAP/XPWhosts

サービス名ファイル（XPWhosts）は，XMAP3 Serverが提供するサービスと，その出力先となるホスト，ディスプレイ，プリンタとの対応を定義するファイルです。記述形式に従って，出力先のホスト名やデバイス名を設定してください。

なお，一つのXMAP3サーバで使用するサービス名の数は，100個以下にしてください。全クライアントの総数で100個を超える場合には，XMAP3サーバの複数起動でシステム構築し，それぞれのXMAP3サーバで使用するサービス名の数は100個以下にしてください。XMAP3サーバの複数起動については，「8.1.4　XMAP3サーバの複数起動」を参照してください。

(2)　ファイルの記述形式

サービス名ファイルの記述形式を次に示します。サービスの定義は1行ごとに記述してください。

〔〕内は省略できますが，APホスト名を指定した場合は後続のAPパス名を指定する必要があります。APホスト名が指定されているのにAPパス名の指定がない場合，その行のサービス定義は無効となります。なお，環境変数名は省略できます。

サービス名ファイルの設定項目と設定内容を次の表に示します。

表7-10　設定項目一覧

項番
設定項目
設定内容

1
サービス名
XMAP3 Server配下で動作させる表示サービスや印刷サービスの名称を，ネットワーク内で一意に求められるユニークな名称で指定します。※1
ここで指定するサービス名は仮想端末定義ファイルに指定したサービス名称と同じ名称としてください。ただし，画面を表示するクライアントがPCで，仮想端末定義ファイルのサービス名に「**」を指定した場合には，LAN内ユニークな名称を任意に指定してください。

2
サービスタイプ
指定できるサービスタイプは，次の二つです。定義するサービスの種別に応じて記述してください。

DSP：XMAP3表示サービスの場合

PRT：XMAP3印刷サービスの場合

3
プロトコル
提供するサービスとAP間で使用する通信プロトコルを指定します。指定できるプロトコルは，次のプロトコルだけです。

TCP：TCP/IPプロトコル

4
ホスト名
定義するサービスを動作させるWSまたはPCのホスト名を指定します。※2※3
表示サービスを使用する場合は，画面を表示するクライアントPCのホスト名を指定します。印刷サービスを使用する場合は，プリンタが接続されているWSまたはPCのホスト名を指定します。
C/Sシステムの通信設定の簡略化機能を使用する場合には，この項目に「*」を指定してください。
なお，WSで使用するサービスでは，ホスト名にエイリアスホスト名（別名）は指定できません。また，PCで使用するサービスでは，設定対象のPCがWindows 2000以降の場合，ホスト名にエイリアスホスト名（別名）は指定できません。

5
デバイス名
定義するサービスに対応するデバイス名を指定します。
＜表示サービス（C/S構成）の場合＞
同一行の先頭に指定した「サービス名」を指定してください。
＜印刷サービス（C/S構成）の場合＞
PC XMAP3の表示・印刷セットアップのプリンタデバイス名で設定した名称を指定してください。なお，デバイス名に「PR1」を指定した場合は，PC側の出力対象プリンタをそのPCの通常使うプリンタにしておく必要があります。
＜印刷サービス（スタンドアロン構成）の場合＞

LPスプーラを使用する場合
LPスプーラにプリンタを追加したときに設定したプリンタ名を指定してください。

JP1の印刷環境を使用する場合
JP1の運用環境で利用できる印刷用のキュー名称を指定してください。なお，表示・印刷環境ファイルにJP1/NQSEXEC連携の設定をしておく必要があります。

6
APホスト名
サービスが起動したタイミングで動作させるAPが動作するホスト名を指定します。ここで指定するホスト名はXMAP3サーバを起動するホスト名と同一となります。※2※3
なお，APホスト名には，エイリアスホスト名（別名）は指定できません。

7
APパス名
サービスが起動したタイミングで動作させるAPの完全パス名を指定します。
ただし，同一クライアントPCで表示サービスと印刷サービスが両方定義されている構成では，それぞれで起動するアプリケーションは別アプリケーションとしてください。
なお，このAP内でNo.8の環境変数の値を取得することで起動したサービス名を取得できます。また，環境変数「XMAP3_CLIENTHOST」の値を取得することで起動したサービスが動作するクライアントPCのホスト名を取得できます。

8
環境変数名
起動したサービス名をAPに伝えるための環境変数を指定します。
省略すると，表示サービスの場合には環境変数DISPLAY，印刷サービスの場合には環境変数PRINTERとなります。ただし，同一クライアントで表示サービスと印刷サービスの両方を使用する場合は，それぞれ異なる環境変数名を指定してください。

注※1

サービス名は14文字以内で指定します。サービス名に使用できる文字は次のとおりです。

JIS8文字の半角英数字および！”＄％＆’（）*＋，－．/：＜=＞？＠［￥］＾_｀｛｜｝￣

注※2

ホスト名およびAPホスト名に使用できる文字は次に示す文字です。

JIS8文字の半角英数字および！”＄％＆’（）*＋，－．/：＜=＞？＠［￥］＾_｀｛｜｝￣

ただし，記号につきましては，OSによって使用できないものがありますのでご注意ください。

注※3

ホスト名およびAPホスト名は，大文字・小文字が区別されるためご注意ください。

サービス名ファイル作成時の注意事項を次に示します。

1行（サービス当たり）は，511バイト以内で設定してください。

行の先頭に「#」を付けた場合，その行はコメント行として扱います。

各項目には，「；」，「#」を使用しないでください。

各項目のあとの「；」は必須です。

XMAP3表示サービスと，対応するクライアントPCは1対1となるように定義してください。一つのクライアントPCで複数の表示サービスを同時に起動できません。

サービス名ファイル中に，同一のサービス名が複数定義された場合には，ファイルの最終行に近い行の内容が有効となります。

一つのXMAP3サーバ配下で動作できるサービス数は，100個までとなります。100個を超える場合には，XMAP3サーバを複数起動する運用にしてください。

(3)　サービス名ファイルの標準値

XMAP3 Serverが標準で提供するサービス名ファイルの内容を次に示します。

(4)　スタンドアロンでXMAP3印刷サービスを使用するとき

XMAP3 Serverの構成例を図7-4に示します。図中の番号に対応するサービス名ファイルの設定例を図7-5に示します。

図7-4　XMAP3 Serverの構成例

項番
サービス
内容
サービス
名
サービス
タイプ
プロトコル
ホスト
名
デバイス名

1
印刷
xpwPRT1
PRT
TCP/IP
host01
プリンタ（PRT1）

図7-5　サービス名ファイルの設定例

(5)　クライアントPCとのC/SでXMAP3表示・印刷サービスと併用するとき

XMAP3 ServerとXMAP3の構成例を図7-6に示します。図中の番号に対応するサービス名ファイルの設定例を図7-7に示します。

図7-6　XMAP3 ServerおよびPC XMAP3の構成例

項番 | サービス内容 | サービス名 | サービスタイプ | プロトコル | ホスト名 | デバイス名 | APホスト名 | APパス名 | 環境変数名
1 | 表示 | xppDSP1 | DSP | TCP/IP | host01 | xppDSP1 | host02 | /tmp/sample | －
2 | 印刷 | xppPRT1 | PRT | PRT1 | － | － | －
3 | 印刷 | xpwPRT1 | PRT | host02 | PRT2 | － | － | －

（凡例）

－：該当なし

図7-7　サービス名ファイルの設定例

7.6.8　表示・印刷環境ファイルを編集する

「7.8.2　表示・印刷環境ファイルの形式」を参照してください。

7.6.9　ホストアドレス管理ファイルを編集する

WSとPCのホストアドレス管理ファイル（hosts）に，ネットワークで利用するWSおよびPCのIPアドレスとホスト名をすべて記述してください。

ただし，C/Sシステムの通信設定の簡略化機能を使用するクライアントについては，この設定は不要です。

7.6.10　ポート番号管理ファイルを編集する

WSとPCのポート番号管理ファイル（services）に，XMAP3 Serverで使用するポート番号を次のように追加します。

XMAP3 Server以外でポート番号8500を使用しているプログラムがある場合には，ほかのプログラムと重複しない番号を設定してください。

7.6.11　環境設定ファイルの設定項目とAPの設定項目との関係

この節で説明してきた環境設定ファイルの設定項目と，APの設定項目の関係を示します。ここで示す設定内容は，スタンドアロン構成で帳票を印刷（LIPS IIIプリンタへ印刷）表示するAPを実行する場合のものです。

日立COBOLのAP

仮想端末定義ファイル（XMAPhosts）

XMAPC構成ファイル（XMAPconfig）

サービス名ファイル（XPWhosts）

表示・印刷環境ファイル（XPWconfig）

ホストアドレス管理ファイル（hosts）

ポート番号管理ファイル（services）

7.7　XMAP3でのプリンタの設定

注意

ここでは，XMAP3で帳票を出力するためのプリンタの設定手順を説明しています。XMAP3以外の製品でこのプリンタを使用すると，意図した出力結果にならないことがあるので注意してください。

XMAP3 Serverを利用して帳票をスタンドアロン環境で印刷する場合は，あらかじめプリンタを設定しておく必要があります。

この節では，XMAP3 Serverを利用して帳票を印刷する場合のプリンタの設定方法について説明します。

なお，JP1/NPSを利用して帳票を印刷する場合の環境設定の方法については，マニュアル「JP1 Version 6　JP1/Network Printing System　運用・操作編」を参照してください。

＜この節の構成＞

7.7.1　AIXでのプリンタの登録

7.7.2　HP-UXでのプリンタの登録

7.7.3　Linuxでのプリンタの登録

7.7.4　Solarisでのプリンタの登録

7.7.5　XMAP3 Serverでの印刷環境の設定

7.7.6　プリンタ使用時の注意事項

7.7.1　AIXでのプリンタの登録

AIX上で，スタンドアロン構成での帳票印刷を実行する際には，AIX上に出力対象の論理プリンタを登録する必要があります。次にリモートプリンタ（含むLANプリンタ）をAIX上に作成する手順を示します。なお，AIXではローカルプリンタへの帳票印刷はできません。

スーパユーザになります。

次のどちらかの手順でシステム管理マネージャ「Smit」を起動します。

デスクトップ環境の「アプリケーションマネージャ」中の「システム管理」ウィンドウ中の「Smit」を選択実行します。

コマンドラインから「/usr/bin/smit」コマンドを実行します。

システム管理マネージャ「System Management Interface Tool」ウィンドウが起動したら，そのウィンドウ中の「印刷スプーリング」を選択します。

「印刷スプーリング」画面から「印刷キューの追加」を選択してください。

新たなウィンドウとして下記のような「単一選択リスト－印刷キューの追加」ウィンドウが表示されます。

「印刷キューの追加」ウィンドウのリストから「remote」を選択します。
なお，出力対象のプリンタがネットワークプリンタ（LAN接続プリンタ）である場合や，HP社のJetDirectプリンタである場合も，このメニューを選択します。ほかの接続タイプ（「hpjetDirect」など）は選択しないでください。

新たに単一選択リスト「リモート印刷のタイプ」が表示されます。ここでは「標準処理」を選択してください。

下記に示す「標準リモート印刷キューの追加」の画面が表示されたら，各項目に次のように入力します。

追加するキュー名

任意のプリンタ名称を記述します。

ここで定義した名称が，/etc/opt/HIXMAP/XPWhostsファイルでのXMAP3印刷サービスに設定するデバイス名称となります。

リモート・サーバのホスト名

プリントサーバホストのホスト名称を記述します。

リモート・サーバ上のキュー名

プリントサーバホストで定義したリモートプリンタ名称を記述します。LAN接続プリンタの場合には，プリンタ制御装置側でコード変換などのデータ加工をしないRAWデータ用のプリンタ名を指定してください。

リモート・サーバ上のプリント・スプーラのタイプ

プリントサーバホストで動作するプリントスプーラにあわせた設定項目を「リスト」から選択してください。例えば，lpdをサポートするUNIXサーバに接続されたプリンタに出力する場合には，「BSD」を選択します。

バックエンド・タイムアウト間隔（秒）（Num.）

必要に応じて設定してください。

先に制御ファイルを送信する

必要に応じて設定してください。

デバッグをオンにするには，出力ファイルのパス名を指定してください。

必要に応じて設定してください。

リモート・サーバ上のプリンタの記述

必要に応じて設定してください。

すべての項目の設定が終了したら，［了解］ボタンをクリックします。

正しくプリンタの登録完了時に表示される「印刷キュー「○○○」を追加しました。」のメッセージを確認後，［完了］ボタンを押してプリンタの登録を終了してください。

7.7.2　HP-UXでのプリンタの登録

XMAP3 Serverでスタンドアロン構成での帳票印刷を実行する際には，OS上に出力対象の論理プリンタを作成する必要があります。HP-UX環境下でのプリンタ作成手順を次に示します。

＜この項の構成＞

(1)　sam（システム管理マネージャ）でプリンタを登録する場合

(2)　lpadminでプリンタを登録する場合

(1)　sam（システム管理マネージャ）でプリンタを登録する場合

GUI環境を使用しないサーバ環境でのプリンタの作成手順をプリンタの接続形態別に示します。

(a)　ローカルプリンタの場合

ローカルプリンタの場合は次の手順でプリンタを登録します。

スーパユーザになります。

ターミナルウィンドウから次のコマンドを入力し，システム管理マネージャを起動します。

/usr/sbin/sam

「System Administration Manager」の画面中の「Printers and Plotters」→「LP Spooler」→「Printers and Plotters」をそれぞれ選択実行し，プリンタ定義一覧画面を表示します。

「Printers and Plotters」のプリンタ定義一覧画面のメニューバー「Actions」を選択すると，下記のようなプリンタ新規作成メニューがプルダウンで表示されます。

Add Local Printer/Plotter
Add Remote Printer/Plotter...
Add Network-Based Printer/Plotter
：

プルダウンから「Add Local Printer/Plotter」を選択し，ローカル接続インタフェースに合わせたプリンタの追加メニューを実行します。
システム標準のパラレルインタフェースに接続する場合には，「Add Parallel Printer/Plotter...」を選択します。

プリンタが接続されたデバイス名称を選択し，［OK］ボタンをクリックします。

新規プリンタ登録画面が表示されたら，各項目に次のように入力します。

Printer Name
任意のプリンタ名称を記述します。ここで定義した名称が，/etc/opt/HIXMAP/XPWhostsファイルでのXMAP3 Serverの印刷サービスに設定するデバイス名称となります。

Printer Model/Interface
必ず「xpwlpmodel」を選択します。

Printer Class
必要に応じて設定してください。

Default Request Priority
必要に応じて設定してください。

Make This Printer the Default Destination
必要に応じて設定してください。

プリンタが接続されたデバイス名称を選択し，［OK］ボタンをクリックします。

すべての項目の設定が終了したら，［OK］ボタンをクリックします。

プリンタ定義一覧画面に正しくプリンタが登録されていることを確認したあと，「システム管理マネージャ」を終了します。

(b)　リモートプリンタの場合

リモートプリンタの場合は次の手順でプリンタを登録します。

スーパユーザになります。

ターミナルウィンドウから次のコマンドを入力し，システム管理マネージャを起動します。

/usr/sbin/sam

「System Administration Manager」の画面中の「Printers and Plotters」→「LP Spooler」→「Printers and Plotters」をそれぞれ選択実行し，プリンタ定義一覧画面を表示します。

「Printers and Plotters」のプリンタ定義一覧画面のメニューバー「Actions」を選択します。
下記のようなプリンタ新規作成メニューがプルダウンで表示されます。

Add Local Printer/Plotter
Add Remote Printer/Plotter...
Add Network-Based Printer/Plotter
：

プルダウンから「Add Remote Printer/Plotter...」を選択実行します。
なお，対象のプリンタがネットワークプリンタ（LAN直結プリンタ）である場合にも，このメニューを選択します。「Add Network-Based Printer/Plotter」は選択しないでください。

新規プリンタ登録画面が表示されたら，各項目に次のように入力します。

Printer Name
任意のプリンタ名称を記述します。ここで定義した名称が，/etc/opt/HIXMAP/XPWhostsファイルでのXMAP3 Serverの印刷サービスに設定するデバイス名称となります。

Remote System Name
プリントサーバホストのホスト名称を記述します。

Remote Printer Name
プリントサーバホストで定義したリモートプリンタ名称を記述します。LAN直結プリンタの場合には，プリンタ制御装置側でコード変換などのデータ加工を行わないRAWデータ用のプリンタ名を指定してください。

Remote Printer is on a BSD System（チェックボックス）
プリントサーバホストのサポートするLPスプールシステムがBSD系（lpdを起動しているUNIXサーバなど）の場合にチェックします。

Remote Cancel Model
必ず「rcmodel」を設定します。

Remote Status Model
必ず「rsmodel」を設定します。

Default Request Priority
必要に応じて設定してください。

Allow Anyone to Cancel a Request
必要に応じて設定してください。

Make This Printer the Default Destination
必要に応じて設定してください。

すべての項目の設定が終了したら，［OK］ボタンをクリックします。

プリンタ定義一覧画面に正しくプリンタが登録されていることを確認したあと，「システム管理マネージャ」を終了します。
なお，必要に応じて，印刷実行前に接続するプリンタ用の/etc/lp/interfaceディレクトリの下にあるインタフェースファイルを次のように修正してください。

バナーページを抑止する場合
rlpコマンドのパラメタに「-h」オプションを追加する

PCに接続されているプリンタに対して，リモートプリンティング印刷する場合
rlpコマンドのパラメタに「-l」オプションを追加する

(2)　lpadminでプリンタを登録する場合

lpadminでプリンタ登録する手順をプリンタの接続形態別に説明します。

(a)　ローカルプリンタの場合

ローカルプリンタの場合は次の手順でプリンタを登録します。

スーパユーザになります。

LPスケジューラ（/usr/sbin/lpsched）を停止します。

次のコマンドを入力し，プリンタを作成します。

/usr/sbin/lpadmin△-p プリンタ名 △-m モデル名 △-v デバイス名

上記のコマンドを実行する際に，下線で示した項目に設定する内容を次に示します。

プリンタ名
任意のプリンタ名称を記述します。ここで定義した名称が，/etc/opt/HIXMAP/XPWhostsファイルでのXMAP3 Serverの印刷サービスに設定するデバイス名称となります。

モデル名
必ず「xpwlpmodel」を設定します。

デバイス名
プリンタが接続されたスペシャルデバイス名称を指定します。
（例）/dev/c1t0d0_lp

次のコマンドを入力し，プリンタを出力要求受け付けができる状態にします。

/usr/sbin/accept△プリンタ名

次のコマンドを入力し，プリンタを出力できる状態にします。

/usr/bin/enable△プリンタ名

LPスケジューラ（/usr/sbin/lpsched）を起動します。

(b)　リモートプリンタの場合

リモートプリンタの場合は次の手順でプリンタを登録します。

スーパユーザになります。

LPスケジューラ（/usr/sbin/lpsched）を停止します。

次のコマンドを入力し，プリンタを作成します。

/usr/sbin/lpadmin△-p プリンタ名 △-m モデル名
　　　　　　　　　 -v デバイス名 △-ocm キャンセルモデル名
　　　　　　　　　 -osm ステータスモデル名 △-orm サーバホスト名
　　　　　　　　　 -orp サーバプリンタ名 △ -ob3

上記のコマンドを実行する際に，下線で示した項目に設定する内容にを次に示します。

プリンタ名
任意のプリンタ名称を記述します。ここで定義した名称が，/etc/opt/HIXMAP/XPWhostsファイルでのXMAP3 Serverの印刷サービスに設定するデバイス名称となります。

モデル名
必ず「rmodel」を設定します。

デバイス名
必ず「/dev/null」を設定します。

キャンセルモデル名
必ず「rcmodel」を設定します。

ステータスモデル名
必ず「rsmodel」を設定します。

サーバホスト名
プリントサーバホストのホスト名称を記述します。

サーバプリンタ名
プリントサーバホストで定義したリモートプリンタ名称を記述します。LAN直結プリンタの場合には，プリンタ制御装置側でコード変換などのデータ加工を行わないRAWデータ用のプリンタ名を指定してください。

-ob3
プリントサーバホストのサポートするLPスプールシステムがBSD系（lpdを起動しているUNIXサーバなど）の場合にだけ指定します。それ以外の場合にはこのオプションの指定は不要です。

次のコマンドを入力し，プリンタを出力要求受け付けできる状態にします。

/usr/sbin/accept△プリンタ名

次のコマンドを入力し，プリンタを出力できる状態にします。

/usr/bin/enable△プリンタ名

LPスケジューラ（/usr/sbin/lpsched）を起動します。
必要に応じて，印刷実行前に接続するプリンタ用の/etc/lp/interfaceディレクトリの下にあるインタフェースファイルを次のように修正してください。

バナーページを抑止する場合
rlpコマンドのパラメタに「-h」オプションを追加する

PCに接続されているプリンタに対して，リモートプリンティング印刷する場合
rlpコマンドのパラメタに「-l」オプションを追加する

7.7.3　Linuxでのプリンタの登録

XMAP3 Serverでスタンドアロン構成での帳票印刷を実行する際には，OS上に出力対象の論理プリンタを作成する必要があります。使用するLinuxのGUI環境に応じてプリンタを作成してください。

＜この項の構成＞

(1)　サーバモデルでのプリンタ作成方法

(2)　ワークステーションモデルでのプリンタの登録方法

(1)　サーバモデルでのプリンタ作成方法

GUI環境を使用しないサーバ環境でのプリンタの作成手順を次に示します。

スーパユーザになります。

/etc/printcap環境ファイルに作成するプリンタの定義を，次のとおり追加します。下線部はユーザ環境に応じて変更できる項目です。

例

RemotePrinter:¥                      (a)
:sd=/var/spool/lpd/RemotePrinter:¥   (b)
:mx#0:¥                              (c)
:sh:¥                                (d)
:lp=/dev/lp0:                        (e)
または
:rm=HOSTNAME:¥                       (f)
:rp=Q-NAME:                          (g)

(a)プリンタキュー名

OS上に作成したい任意の論理プリンタ名称（プリンタキュー）を入力します。ここで定義した名称が，XMAP3サービス名ファイル /etc/opt/HIXMAP/XPWhosts に記載する印刷サービス名のデバイス名称となります。

(b)スプールディレクトリ

印刷データをスプールするディレクトリを入力します。通常では，「/var/spool/lpd/プリンタ名称」としてください。また，このディレクトリはあらかじめ作成しておいてください。

(c)ファイル制限（単位：KB）

「mx#0」固定（無制限）としてください。

(d)バナーページ抑止

「sh:」固定（バナーページを抑止する）としてください。

(e)プリンタデバイス（ローカルプリンタの場合に指定）

プリンタが接続されているスペシャルファイル名称を指定してください。

(f)リモートホスト名（リモートプリンタの場合に指定）

実プリンタが接続されているプリントサーバホスト名を入力してください。LAN接続プリンタの場合には，LANコントローラのホスト名となります。

(g)リモートプリンタ名

リモートホスト側での実プリンタ名を設定してください。なお，LAN接続プリンタの場合には，プリンタ内蔵，または外付けのLANコントローラマニュアルを参照して，RAWデータを出力する（データ加工を一切しない）プリンタ名称をここで設定してください。

/etc/printcap環境ファイルの修正が完了したら，LPDデーモン（/usr/sbin/lpd）を再起動してください。

(2)　ワークステーションモデルでのプリンタの登録方法

GUI環境を使用するワークステーションモデルのLinux環境でのプリンタの登録手順をプリンタの接続形態別に説明します。

なお，LinuxにはさまざまなGUI環境が提供されていますが，このマニュアルではTurboLinuxおよびRed Hat Linuxで利用できるGUI環境「GNOME」（GNUネットワークオブジェクトモデル環境）をTurboLinux上で利用している場合のプリンタの登録手順を示します。その他GUIでのプリンタの登録については，ここで説明する手順を参考に，各GUIに合わせた手順で登録してください。

(a)　ローカルプリンタの場合

ローカルプリンタの場合は次の手順でプリンタを登録します。

スーパユーザになります。

デスクトップ環境のポップアップメニューの「システムメニュー」から「システム管理」→「turboCfgCenter」を選択するか，または，ターミナル画面から次のコマンドラインを入力・実行し，管理ツール「turboCfgCenter」を起動します。

/usr/bin/turbocfgcenter

管理ツール「turboCfgCenter」が起動すると次のウィンドウが表示されます。

管理ツールのウィンドウ中の「プリンタ」アイコンをクリックすると，プリンタの設定をする「gNewt」ウィンドウが表示されます。
このウィンドウで［追加］ボタンをクリックすると，下記に示すプリンタのタイプを選択する「プリンタの追加」ウィンドウが表示されます。

「プリンタの追加」ウィンドウから「ローカルプリンタ」を選択します。
論理プリンタ名称（プリンタキュー）を入力するウィンドウが表示されます。OS上に作成したい任意のプリンタ名称を入力してください。ここで定義した名称が，XMAP3サービス名ファイル/etc/opt/HIXMAP/XPWhostsに記載する印刷サービスのデバイス名称となります。

プリンタ名称を入力したあと，［続行］ボタンをクリックします。
詳細設定ウィンドウが表示されます。必要に応じて各項目をカスタマイズしてください。

キュー名

前ウィンドウで入力したプリンタ名称が表示されます。

スプールディレクトリ

印刷データをスプールするディレクトリを入力します。デフォルトでは「/var/spool/lpd/プリンタ名称」となります。

ファイル制限（KB）

0（無制限）としてください。

プリンタデバイス

プリンタが接続されているスペシャルファイル名称を指定してください。

その他

デフォルトのままとしてください。

（プリンタタイプなど）

XMAP3での印刷には影響しません。

すべての項目の設定が終了したら［OK］をクリックしてください。

プリンタの設定ウィンドウのプリンタ一覧で正しくプリンタが登録されていることを確認したあと，「turboCfgCenter」を終了してください。

管理ツール「turboCfgCenter」でのプリンタ登録が完了したら，/etc/printcap環境ファイル中の各プリンタ設定中の「if」（インタフェースプログラム）の設定行を削除してください。
XMAP3では印刷サービス内部でプリンタに応じたバイナリデータを生成して印刷しますので，インタフェースなどでデータが加工されると，帳票印刷の際に文字化けが発生する場合があります。

例

/etc/printcap環境ファイルの修正が完了したら，LPDデーモン（/usr/sbin/lpd）を再起動してください。

(b)　リモートプリンタの場合

リモートプリンタの場合は次の手順でプリンタを登録します。

スーパユーザになります。

デスクトップ環境のポップアップメニューの「システムメニュー」から「システム管理」→「turboCfgCenter」を選択するか，または，ターミナル画面から次のコマンドラインを入力・実行し，管理ツール「turboCfgCenter」を起動します。

/usr/bin/turbocfgcenter

管理ツール「turboCfgCenter」が起動すると次のウィンドウが表示されます。

管理ツールのウィンドウ中の「プリンタ」アイコンをクリックすると，プリンタの設定をする「gNewt」ウィンドウが表示されます。
このウィンドウで［追加］ボタンをクリックすると，下記に示すプリンタのタイプを選択する「プリンタの追加」ウィンドウが表示されます。

「プリンタの追加」ウィンドウから「リモートLPDキュー」を選択します。
論理プリンタ名称（プリンタキュー）を入力するウィンドウが表示されます。OS上に作成したい任意のプリンタ名称を入力してください。ここで定義した名称が，XMAP3サービス名ファイル/etc/opt/HIXMAP/XPWhostsに記載する印刷サービスのデバイス名称となります。

プリンタ名称を入力したあと，［続行］ボタンをクリックします。
詳細設定ウィンドウが表示されます。必要に応じて各項目をカスタマイズしてください。

キュー名

前ウィンドウで入力したプリンタ名称が表示されます。

スプールディレクトリ

印刷データをスプールするディレクトリを入力します。デフォルトでは/var/spool/lpd/プリンタ名称となります。

ファイル制限（KB）

0（無制限）としてください。

LPD設定

［変更...］をクリックしてプリントサーバホスト名とサーバプリンタ名を設定してください。次のウィンドウが表示されます。なお，LAN接続プリンタの場合には，プリンタ内蔵または外付けのLANコントローラのマニュアルを参照したあと，RAWデータを出力する（データ加工を一切しない）プリンタ名称をここで設定してください。

その他

デフォルトのままとしてください。

（プリンタタイプなど）

XMAP3での印刷には影響しません。

すべての項目の設定が終了したら［OK］をクリックしてください。

プリンタの設定ウィンドウのプリンタ一覧で正しくプリンタが登録されていることを確認したあと，「turboCfgCenter」を終了してください。

管理ツール「turboCfgCenter」でのプリンタ登録が完了したら，/etc/printcap環境ファイル中の各プリンタ設定中の「if」（インタフェースプログラム）の設定行を削除してください。
XMAP3では印刷サービス内部でプリンタに応じたバイナリデータを生成して印刷しますので，インタフェースなどでデータが加工されると，帳票印刷の際に文字化けが発生する場合があります。

例

/etc/printcap環境ファイルの修正が完了したら，LPDデーモン（/usr/sbin/lpd）を再起動してください。

7.7.4　Solarisでのプリンタの登録

ここでは，「CDE」（共通デスクトップ環境）でのプリンタ設定手順を説明します。設定できるプリンタはリモートプリンタだけです。ローカルプリンタは使用できません。

スーパユーザになります。

デスクトップ環境のワークスペース・メニューの［ツール］-［Admintool］を選択するか，または，ターミナル画面からコマンドを実行します。
ターミナル画面からは次のコマンドを実行します。

/usr/bin/admintool

［Admintool：ユーザー］画面が表示されたら，メニューから［ブラウズ］-［プリンタ］を選択します。

［Admintool：プリンタ］画面が表示されたら，メニューから［編集］-［追加］-［プリンタへのアクセス］を選択します。

［Admintool：プリンタへのアクセス］画面が表示されたら，プリンタ名，印刷サーバを入力します。

プリンタ名および印刷サーバに設定する値は次のとおりです。

プリンタ名

プリントサーバ側で定義されているプリンタ名を設定してください。ここで設定したプリンタ名が，XMAP3サービス名ファイル（/etc/opt/HIXMAP/XPWhosts）に記載する印刷サービスのデバイス名称となります。プリンタ名は，プリントサーバ側のプリンタ名称と同じになります。LAN接続プリンタの場合には，プリンタ内蔵，または外付けのLANコントローラのマニュアルを参照して，RAWデータを出力する（データ加工を一切しない）プリンタ名称を設定してください。

印刷サーバー

プリントサーバのホスト名称を設定してください。LAN接続プリンタの場合には，LANコントローラのホスト名となります。

［了解］ボタンをクリックします。
プリンタの設定が終了すると，プリンタ一覧が表示されます。設定した内容が正しいことを確認してください。

ほかにもプリンタを設定する場合は，操作4～6を繰り返してください。

メニューの［ファイル］-［終了］を選択します。
［Admintool：プリンタ］画面が閉じられます。

7.7.5　XMAP3 Serverでの印刷環境の設定

表示・印刷環境ファイル（XPWconfig）に，使用するプリンタ種別やLIPSコマンドの作成モードを指定します。表示・印刷環境ファイルの形式については，「7.8.2　表示・印刷環境ファイルの形式」を参照してください。

＜この項の構成＞

(1)　印刷システムを指定する

(2)　プリンタ種別を指定する

(3)　LIPSコマンドの作成モードを指定する

(1)　印刷システムを指定する

XMAP3 Serverでスタンドアロン印刷する場合，二つの印刷システムを利用できます。

印刷方式 | 概要
LPスプール出力方式 | OSが標準で提供するLPスプールを経由してリモートプリンタに印刷する方式で，lprコマンドを発行することで印刷を実行する。
JP1/NQSEXEC連携方式 | 日立ミドル製品JP1/NQSEXECが提供するジョブ登録方式で，qprxコマンドを発行することで，直接JP1/NQSEXECのジョブキューに印刷データを登録する方式である。

(a)　環境設定方法

JP1/NQSEXEC連携方式での印刷の設定
印刷サービスが生成した印刷データの出力先をJP1/NQSEXECのキューにするかどうかの設定を，表示・印刷環境ファイル（/etc/opt/HIXMAP/XPWconfig）に設定します。

メンバ名 | 設定値 | 内容
*.PCQPRX | ON | JP1/NQSEXEC連携方式にて印刷する
OFF | LPスプール出力方式にて印刷する（JP1/NQSEXECと連携しない）

上記メンバ設定なしおよび不定値の場合には，OFFを仮定します。

(2)　プリンタ種別を指定する

使用するプリンタ種別を指定します。記述形式は，次のとおりです。

印刷サービス名には，LPスプーラ出力用，またはJP1/NQSEXEC連携用の印刷サービス名を記述してください。ここで指定したプリンタ種別と実際のプリンタが異なる場合，正しく印刷できません。プリンタ種別と表示・印刷環境ファイルの設定値を，次に示します。

表7-11　プリンタ種別と表示・印刷環境ファイルの設定値

プリンタ種別
設定値

ESC/P J84準拠のプリンタ
印刷サービス名.PCRPRT = ESCP_D

PostScriptレベル2準拠のプリンタまたは，
PostScriptレベル3準拠のプリンタ※
印刷サービス名.PCRPRT = PostScript2

LIPS II+準拠，LIPS III準拠のプリンタ
印刷サービス名.PCRPRT = LIPS

注※

PostScriptレベル3準拠のプリンタはAIX，HP-UXおよびSolarisで利用できます。

(3)　LIPSコマンドの作成モードを指定する

LIPS適応プリンタの場合，XMAP3 Serverが生成するLIPSコマンドの作成モードを指定できます。必要に応じて，指定してください。記述形式は，次のとおりです。

LIPSコマンドの作成モードと表示・印刷環境ファイルの設定値を，次に示します。

表7-12　LIPSコマンドの作成モードと表示・印刷環境ファイルの設定値

作成モード | 設定値
LIPS II+でデータを作成 | 印刷サービス名.PCLIPS = 2
LIPS IIIでデータを作成 | 印刷サービス名.PCLIPS = 3

LIPS II+とLIPS IIIでは，サポートする機能に差があります。それぞれのLIPSプリンタでサポートする機能については，「付録C　サポートプリンタの機能差」を参照してください。

なお，LIPS III対象プリンタ以外でPCLIPS=3を指定した場合は，正しく印刷できません。また，出力対象プリンタがLIPSプリンタ以外の場合は，設定が無効になります。

7.7.6　プリンタ使用時の注意事項

リモートプリンタや，JP1を使用する環境が正しく設定されていない場合は，XMAP3 Serverで印刷処理を続行できません。ファイル（/usr/tmp/xpw/.remote/.lprmsg_印刷サービス名）にlprコマンド，またはqprxコマンドのエラーメッセージが格納されます。リモートプリンタの場合は障害内容をOSのマニュアルで確認して，プリンタ環境を設定し直してください。また，JP1への印刷の場合はJP1のマニュアルでJP1実行環境を見直してください。

7.8　表示・印刷環境のカスタマイズ

画面表示や帳票印刷時の属性を，端末ごとにカスタマイズできます。カスタマイズするための情報は，表示・印刷環境ファイル（XPWconfig）に定義します。

この節では，表示・印刷環境ファイルの運用方法と，ファイルの形式について説明します。

＜この節の構成＞

7.8.1　表示・印刷環境ファイルの運用方法

7.8.2　表示・印刷環境ファイルの形式

7.8.3　クライアント側の表示・印刷環境ファイルを有効にする運用

7.8.4　表示・印刷サービス共通の設定項目

7.8.5　表示サービスに対する設定項目

7.8.6　印刷サービスに対する設定項目

7.8.7　表示・印刷環境ファイルの初期状態

7.8.1　表示・印刷環境ファイルの運用方法

XMAP3 Serverが提供している表示・印刷環境ファイル（XPWconfig）を編集することで，画面表示や帳票印刷時の属性をカスタマイズできます。次に，表示・印刷環境ファイルの運用方法を示します。

表示・印刷環境ファイルはXMAP3 Serverがある端末で編集しますが，クライアント側の表示・印刷環境ファイルの設定を有効にすることもできます。
なお，表示・印刷環境ファイルは，スーパユーザでないと編集できません。スーパユーザでログインするか，suコマンドでスーパユーザになってから，ファイルを編集してください。

ファイルを編集する場合は，標準提供されているファイルを「.bak」などの拡張子を付けて保存しておくことをお勧めします。誤って修正した場合には，作成したファイルを削除したあと，拡張子が「.bak」のファイルを元のファイル名に戻すことで，以前の状態に戻すことができます。

表示・印刷環境ファイルを編集したあと，XMAP3サーバを停止してxpwdaemonコマンドで再起動すると，ファイルの内容が反映されます。XMAP3サーバを再起動したら，APを再実行して指定内容が反映されていることを確認してください。また，変更後はXMAP3クライアントも再起動してください。

表示・印刷環境ファイルは，AIXの場合，ファイル提供時の文字コードがシフトJISになっています。EUC環境で使用する場合は，EUCコードへの変換が必要です。

7.8.2　表示・印刷環境ファイルの形式

表示・印刷環境ファイル（XPWconfig）は，viなどのエディタで編集します。次に，表示・印刷環境ファイルの形式を説明します。

＜この項の構成＞

(1)　ファイル名

(2)　ファイルの形式とパラメタの種類

(1)　ファイル名

表示・印刷環境ファイルの名称は，次のとおりです。

/etc/opt/HIXMAP/XPWconfig

(2)　ファイルの形式とパラメタの種類

(a)　ファイルの形式

表示・印刷環境ファイルの形式を次に示します。

1行に1項目を指定してください。行の先頭に「#」を付けると，その行はコメント行として扱われます。

なお，サービス名にサービス名ファイル（XPWhosts）で指定した名称を設定すると，サービスごとにパラメタの値を設定できます。すべてのサービスでパラメタの値を共通にする場合は，サービス名に「*」を指定します。

(b)　パラメタの種類

パラメタには，すべてのサービスで共通の設定値を持つものと，各サービスで固有の設定値を持つものがあります。

各サービスで共通のパラメタ
先頭に「CO」が付いているパラメタは，すべてのサービスで共通の設定値を持つものです。このパラメタのサービス名には，「*」を指定してください。共通のパラメタのサービス名に「*」以外のサービス名を指定した場合でも，設定したパラメタの値は，すべてのサービスで共通になります。記述形式は，次のとおりです。

各サービスで固有のパラメタ
先頭に「D」が付いているパラメタは表示サービスの設定項目，先頭に「P」が付いているパラメタは印刷サービスの設定項目です。記述形式は，次のとおりです。

(c)　表示・印刷環境ファイルの設定例

XMAP3 Serverの構成例を図7-8に示します。

図7-8　XMAP3 Serverの構成例

この構成例を基に，次に示す値を設定した表示・印刷環境ファイルの設定例を図7-9に示します。

サービス内容 | サービス名称 | パラメタ | 設定値 | 意味
－ | * | COSPCD | 4040 | 全角のスペースコードを(4040)₁₆とします。
印刷 | xpwPRT | PCDLLN | DOUBLE | 帳票印刷時の抹消線の形状を二重線とします。
表示 | xppDSP | DCSHAD | SIMPLE | 画面オブジェクトを立体的な表示にします。

（凡例）

－：印刷サービスと表示サービスで共通する項目

図7-9　表示・印刷環境ファイルの設定例

7.8.3　クライアント側の表示・印刷環境ファイルを有効にする運用

XMAP3 ServerとPCのXMAP3を連携した場合，PCのXMAP3の表示・印刷セットアップで設定した項目を，そのクライアントの表示・印刷サービスに反映させることができます。クライアント側の設定方法の詳細については，マニュアル「画面・帳票サポートシステム　XMAP3 開発・実行ガイド」を参照してください。

ここでは，PCの表示・印刷環境の設定機能を使用するときの，XMAP3 ServerとPC側XMAP3の環境設定について説明します。

XMAP3 Serverでの設定
XMAP3 Serverの持つ表示・印刷環境ファイルに，次のパラメタを設定してください。

表7-13　XMAP3 Serverでの設定パラメタ

パラメタ | 設定値 | 内容
*.COCLTCNF | ON | PC側XMAP3が保持する表示・印刷環境ファイルの設定値が有効になります。
OFF | WS側XMAP3 Serverが保持する表示・印刷環境ファイルの設定値が有効になります。

このパラメタの設定を省略した場合，または無効な値を設定した場合は，OFFとして扱われます。

PC側XMAP3での設定
クライアント側の表示・印刷環境ファイルを有効にする場合は，表示・印刷セットアップの「アプリケーション」タブの「C/Sの場合，アプリケーションサーバのセットアップだけが有効」のチェックを外します。チェックした場合は，XMAP3 Serverの持つ表示・印刷環境ファイルの設定が有効となります。
また，表示・印刷セットアップを使用しないで，直接，PC側の表示・印刷環境ファイル（［XMAP3インストールディレクトリ］¥ETC¥X3PCONFファイル）を編集する場合は，次のパラメタを設定してください。

表7-14　PC側XMAP3での設定パラメタ

パラメタ | 設定値 | 内容
*.COCLTCNF | ON | PCで起動するXMAP3表示・印刷サービスに，そのPC上の表示・印刷環境ファイルが有効になります。
OFF | PCで起動するXMAP3表示・印刷サービスに，WS側の表示・印刷環境ファイルが有効になります。

このパラメタの設定を省略した場合，または無効な値を設定した場合は，OFFとして扱われます。
サーバ・クライアントの双方で*.COCLTCNFの値がONと設定されているときだけ，クライアント側の表示・印刷環境ファイルが有効となります。なお，PC側の環境設定で*.COCLTCNFの値を変更したときは，XMAP3サーバの再起動を行うまでは変更した内容が正しく反映されません。また，COEBCD，COKSCD，COSPCDについては，常にサーバ側の設定が有効となります。

7.8.4　表示・印刷サービス共通の設定項目

ここでは，すべての表示・印刷サービスで共通の設定項目を説明します。この設定項目は先頭に「CO」が付き，すべての表示・印刷サービスで共通の設定値をとります。これらのパラメタのサービス名には，必ず「*」を指定してください。

複数行の指定がある場合は，表示・印刷環境ファイルの最終行に近い行の指定が有効になります。また，設定値が誤っている場合やパラメタ自体が存在しない場合には，デフォルト値が設定されます。

表7-15　表示・印刷サービス共通の環境設定項目

パラメタ
意味
設定値
（下線がデフォルト値）

*.COCLTCNF
PCで起動するXMAP3 表示・印刷サービスに対して，クライアントPCにある表示・印刷環境ファイルのメンバ値を有効とするか，しないかを指定します。詳細は，「7.8.3　クライアント側の表示・印刷環境ファイルを有効にする運用」を参照してください。

ON
PC上の表示・印刷環境ファイルを有効にします。

OFF
XMAP3 Server側の表示・印刷環境ファイルを有効にします。

*.COEBCD
EBCDIK/KEISを使用するときの1バイトコードを，EBCDIKとEBCDICのどちらかを選択して指定します。
この指定は，マッピング属性ファイルでの指定に合わせる必要があります。マッピング属性ファイルについては，「7.6.5　マッピング属性ファイル」を参照してください。
このパラメタは，クライアント側の表示・印刷環境ファイルが有効にされた環境でも，常にサーバ側の設定が有効となります。

EBCDIK
1バイトコードとして，EBCDIKを使用します。

EBCDIC
1バイトコードとして，EBCDICを使用します。

*.COKSCD
EBCDIK/KEISを使用するときの2バイトコードを，KEIS83とKEIS78のどちらかを選択して指定します。
この指定は，マッピング属性ファイルでの指定に合わせる必要があります。マッピング属性ファイルについては，「7.6.5　マッピング属性ファイル」を参照してください。
このパラメタは，クライアント側の表示・印刷環境ファイルが有効にされた環境でも，常にサーバ側の設定が有効となります。

KEIS83
2バイトコードとして，KEIS83を使用します。

KEIS78
2バイトコードとして，KEIS78を使用します。

*.COSPCD
全角のスペースコードを，4040とA1A1のどちらかを選択して指定します。
このパラメタは，クライアント側の表示・印刷環境ファイルが有効にされた環境でも，常にサーバ側の設定が有効となります。
なお，この指定は画面入力時のデータとしても適用されるため，ドローの画面定義時（空白入力）の指定と合わせる必要があります。

4040
全角のスペースコードとして，(4040)₁₆を使用します。

A1A1
全角のスペースコードとして，(A1A1)₁₆を使用します。

*.COKYFC
キーの割り当てをONLINEとMOTIFのどちらかを選択して指定します。MOTIFとした場合，「PF10」の機能はメニューバーへのフォーカス移動となります。

ONLINE
「PF10」を通常ファンクションキーとして使用します。

MOTIF
「PF10」をメニューバーへのフォーカス移動のためのキーとして使用します。

*.COGPTH
可変グラフィックを表示または印刷する際に，クライアントPCに配布したグラフィックファイルの読み込みパス，またはWSサーバ上でのスタンドアロン印刷時のグラフィックファイルの読み込みパスを指定します。
クライアントPCごとにグラフィックファイルの置かれる場所が異なる場合には，クライアント側の表示・印刷環境ファイルを有効にして，各クライアントでグラフィックファイルパスを設定してください。
また，クライアントPCで可変グラフィックを表示または印刷する場合に，このパラメタの指定がない場合は，XMAP3インストールフォルダ¥USER¥Graphicsが参照されます。
可変グラフィックデータの読み込みパス

7.8.5　表示サービスに対する設定項目

ここでは，クライアントPCで動作する表示サービスに対する環境設定ファイルの設定項目を説明します。この設定項目は先頭に「D」が付きます。これらのパラメタのサービス名には，「*」，または対象となる表示サービス名称を指定してください。

複数行の指定がある場合は，表示・印刷環境ファイルの最終行に近い行の指定が有効になります。また，設定値が誤っている場合やパラメタ自体が存在しない場合には，デフォルト値が設定されます。

なお，各項目の詳細については，マニュアル「画面・帳票サポートシステム　XMAP3 開発・実行ガイド」を参照してください。

＜この項の構成＞

(1)　キー割り当てに関する設定項目

(2)　キー操作に関する設定項目

(3)　ショートカットキーに関する設定項目

(4)　ファンクションキーに関する設定項目

(5)　画面デザインに関する設定項目

(6)　日本語入力に関する設定項目

(7)　表示色に関する設定項目

(8)　表示サービスに対するその他の設定

(1)　キー割り当てに関する設定項目

ここでは，キーの割り当てに関しての表示サービスの設定項目について説明します。

表7-16　表示サービスに対する環境設定項目（キー割り当てに関する設定）

パラメタ
意味
設定値
（下線がデフォルト値）

表示サービス名.DCLNFD
フルキーボード側（キーボードの文字キー側）にある［Enter］キーの動作を指定します。

RETURN
複改キーとして動作します。次の行以降で最初に入力できるオブジェクトにフォーカスを移動します。

EXECUTE
送信（実行）キーとして動作し，APにイベントを通知します。

TAB
タブキーとして動作します。

表示サービス名.DCRCTL
右［Ctrl］キーの動作を指定します。なお，この指定は，PC-9800シリーズのキーボードには使用できません。

CTRL
［Ctrl］キーとして動作します。

EXECUTE
送信（実行）キーとして動作します。

表示サービス名.DCKPUP
［PageUp］キーの動作を指定します。

PA1
［PA1キーとして動作します。

SCRL
ウィンドウを上方向にスクロールするためのキーとして動作します。

TAB
タブキーとして動作します。

BTAB
バックタブキーとして動作します。

PF13
PF13キーとして動作します。

PF14
PF14キーとして動作します。

表示サービス名.DCKPDN
［PageDown］キーの動作を指定します。

PA2
PA2キーとして動作します。

SCRL
ウィンドウを下方向にスクロールするためのキーとして動作します。

TAB
タブキーとして動作します。

BTAB
バックタブキーとして動作します。

PF13
PF13キーとして動作します。

PF14
PF14キーとして動作します。

表示サービス名.DCEXEC
キーボードのテンキー側にある［Enter］キーの動作を指定します。ノート型キーボードの場合は，この設定は無効となります。

EXECUTE
送信（実行）キーとして動作し，APにイベントを通知します。

RETURN
複改キーとして動作します。次の行以降で最初に入力できるオブジェクトにフォーカスを移動します。

TAB
タブキーとして動作します。

表示サービス名.DCKDIV
キーボードのテンキー側にある［／］キーの動作を指定します。ノート型キーボードの場合は，この設定は無効となります。
ただし，日本語入力システムが起動しているときは，文字入力として扱われます。

LETTER
文字「／」の入力キーとして動作します。

TAB
タブキーとして動作します。

BTAB
バックタブキーとして動作します。

FIELD
フィールドクリアキーとして動作します。

表示サービス名.DCKMUL
キーボードのテンキー側にある［＊］キーの動作を指定します。ノート型キーボードの場合は，この設定は無効となります。
ただし，日本語入力システムが起動しているときは，文字入力として扱われます。

LETTER
文字「＊」の入力キーとして動作します。

TAB
タブキーとして動作します。

BTAB
バックタブキーとして動作します。

FIELD
フィールドクリアキーとして動作します。

表示サービス名.DCKSUB
キーボードのテンキー側にある［－］キーの動作を指定します。ノート型キーボードの場合は，この設定は無効となります。
ただし，日本語入力システムが起動しているときは，文字入力として扱われます。

LETTER
文字「－」の入力キーとして動作します。

TAB
タブキーとして動作します。

BTAB
バックタブキーとして動作します。

FIELD
フィールドクリアキーとして動作します。

表示サービス名.DCKADD
キーボードのテンキー側にある［＋］キーの動作を指定します。ノート型キーボードの場合は，この設定は無効となります。
ただし，日本語入力システムが起動しているときは，文字入力として扱われます。

LETTER
文字「＋」の入力キーとして動作します。

TAB
タブキーとして動作します。

BTAB
バックタブキーとして動作します。

FIELD
フィールドクリアキーとして動作します。

(2)　キー操作に関する設定項目

ここでは，キーを押したときの表示サービスの動作に関しての設定項目について説明します。

表7-17　表示サービスに対する環境設定項目（キー操作に関する設定）

パラメタ
意味
設定値
（下線がデフォルト値）

表示サービス名.DCFCLR
［End］キーを押したときの動作を指定します。

AFTER
カーソル以降の文字をクリアします。

ALL
フィールド内のすべての文字列をクリアします。

表示サービス名.DCBKSP
［BackSpace］キーを押したときの動作を指定します。

BTAB
バックタブキーとして動作します。

BSDEL
直前の文字を削除し，間を詰めます。

BSNULL
直前の文字を削除し，間を詰めないでその位置をNULL文字とします。

表示サービス名.DCINMD
［Insert］キーを押したときの動作を指定します。

TGL
挿入モードと上書きモードを切り替えます。

NULL
カーソル位置にNULL文字を挿入します。

表示サービス名.DCINST※
「表示サービス名.DCINMD=TGL」を指定している場合に，［Insert］キーを使って切り替える挿入モードのデフォルト（上書き／挿入）を指定します。

UPDATE
上書きモードをデフォルトとします。

INSERT
挿入モードをデフォルトとします。

表示サービス名.DCINKY
DCINMDにNULLを指定したときに，NULL文字を挿入する範囲を指定します。

FIELD
フィールドの最後まで文字を挿入できます。挿入によって右側にはみ出した文字は削除されます。

NULL
フィールドの右側にNULL文字による空きがあるときがあるとき，空きのある数だけ挿入できます。空きがなくなった時点で入力エラーとなります。

表示サービス名.DCDTTF
データキー（106キーボードでは［Ctrl］+［End］キー）を押したときの動作を指定します。

RESET
すべての入出力テキストフィールドを未入力状態とします。そのまま何も入力しないで画面確定（送信）すると，APには初期クリア文字が返ります。

SET
すべての入出力テキストフィールドをNULLクリア状態とします。そのまま何も入力しないで画面確定（送信）すると，APにはデータ消去通知文字が返ります。

表示サービス名.DCAENT
自動送信のオブジェクトの動作を指定します。

ALL
自動送信のオブジェクトに対して，フォーカス離脱時に常にAPに制御を渡します。

UPDATE
自動送信のオブジェクトに対してデータ操作があった場合だけ，フォーカス離脱時にAPに制御を渡します。

表示サービス名.DCMLSM
リストボックスでのマウス動作を指定します。

MULTI
マウスでの選択動作は，クリックだけで操作します。

EXTENDED
複数選択リストボックスの場合，マウスクリックによる選択以外に，［Shift］キー併用やマウスドラッグによる範囲選択動作をできるようにします。

表示サービス名.DCLSTW
リストボックスでのダブルクリック時の動作を指定します。ただし，リストボックスが「自動スキップ属性」の場合は，この指定は無視されます。

SEND
「送信」と同様のイベント通知動作となります。

NOMAL
選択→選択解除のトグル動作となります。

表示サービス名.DCSRED
［PA1～3］，［Break］，［Screen］キーを強制確定キーとして使用するかどうかを指定します。

FORCE
画面上のデータ内容をチェックしないでAP通知をする強制確定キーとなります。

CHECK
画面上のデータ内容のチェックをし，その内容が妥当であればAPにイベント通知をします。

表示サービス名.DCSXPI
強制確定キーが押されたときの動作を指定します。

XPIBASE
強制確定キーが押されたときに，イベントだけの通知をして，画面上のデータをAPに送りません。

NOMAL
強制確定キーが押されたときに，画面上のデータをAPに送ります。ただし，データ内容の妥当性のチェックはAPで実行する必要があります。

表示サービス名.DCCPMD
GUI画面のフィールドボックスおよびCUI画面でのコピー＆ペーストの動作を指定します。

FIELD
単一フィールドだけがコピー＆ペーストの対象となります。

RECTANGLE
表などの形式に並べられた複数のフィールドがコピー＆ペーストの対象となります。

表示サービス名.DCDCCP
テキストエディタなどからXMAP3画面へのコピー&ペースト時に，タブおよび改行コードをペースト対象とするかどうかを指定します。

0
コピーした文字列は，タブおよび改行コードも含めてペーストします。

3
コピーした文字列は，タブおよび改行コードを削除してペーストします。
「表示サービス名.DCCPMD」で「FIELD（単一フィールド）」を選択している場合に有効です。「RECTANGLE（複数フィールド）」を選択している場合は，指定に関係なく，タブおよび改行コードは矩形領域をコピー＆ペーストするための制御用のコードとなります。

表示サービス名.DCCPKY
コピー＆ペースト操作を行うキーを指定します。

Ins
［Ctrl］+［Insert］キーをコピーキーとして使用し，［Shift］+［Insert］キーをペーストキーとして使用します。

CV
［Ctrl］+［C］［Ctrl］+［Insert］キーをコピーキーとして使用し，［Ctrl］+［V］［Shift］+［Insert］キーをペーストキーとして使用します。

表示サービス名.DCLCCP
マウスによるコピー＆ペーストの使用有無を指定します。
このオプションは，旧バージョンのXMAP3との操作での互換性を保つための機能です。
現在のウィンドウシステムでの標準的な操作性とは異なりますので，一般にはOFFを指定してください。
この設定値をOFFとしても，マウスによるコピー範囲の選択はできます。

ON
マウス左ボタンのダブルクリックをコピー操作に使用し，右ボタンのクリックをペースト操作に使用します。

OFF
マウス操作によるコピー＆ペーストを使用しません。

表示サービス名.DCCURS
GUI画面のフィールドボックスおよびCUI画面でのカーソルキーの動作を指定します。

FREE
カーソルはフィールドの有無に関係なく，画面上の何処にでも移動できます。

PROTECT1
カーソルはすべてのフィールドの先頭に移動します。

PROTECT2
カーソルはキー入力できる（活性）フィールドの先頭に移動します。

表示サービス名.DCSLCR
GUI画面のフィールドボックスおよびCUI画面でのカーソルの移動で，カーソルがウィンドウまたはフィールドボックスの端に来たとき，ウィンドウやフィールドボックスをスクロールしてカーソルを見える状態にするかどうかを指定します。

ON
カーソルと連動してスクロールします。

OFF
カーソルとスクロールは独立して操作します。したがって，カーソルをどのように移動してもウィンドウは止まったままとなります。

表示サービス名.DCVRSL
GUI画面のフィールドボックスでの縦方向のスクロール単位を指定します。

01～24（デフォルト値は01）
縦スクロールの単位行数を指定します。

表示サービス名.DCHRSL
GUI画面のフィールドボックスでの横方向のスクロール単位を指定します。

01～80（デフォルト値は01）
横スクロールの単位けた数を指定します。

表示サービス名.DCCRSL
GUI画面のフィールドボックスおよびCUI画面で，スクロール操作によってカーソルがスクロールアウトしたときの動作を指定します。

ON
カーソルが表示領域の外に出ないように自動的に移動します。

OFF
カーソルは移動しません。表示領域の外に出て見えなくなることもあります。

表示サービス名.DCCUAK
GUI画面のフィールドボックスに入力フィールドがない場合のカーソルキーの動作を指定します。

CURS
カーソルキーの操作によって，フィールドボックス上のカーソルが移動します。

BAR
カーソルキーの操作によって，フィールドボックスがスクロールします。この指定をした場合は，フィールドボックス上にカーソルは表示されません。

表示サービス名.DCKPSL
GUI画面を一部上書で表示した際，フィールドボックスを前回と同じスクロール位置で表示するかどうか指定します。表示形態が全面書換の場合は，指定は無効となります。
画面表示の設定は通信記述項のMAPPING MODE句で設定します。詳細については，「5.2.2(1)(f)　MAPPING MODE句の扱い（マッピングオプション）」を参照してください。

ON
画面表示時に前回のスクロール位置を表示します。
さらに，「表示サービス名.DCSLCR」で「ON（連動してスクロール）」を指定している場合は，カーソルが表示される位置まで移動します。

OFF
画面表示時に前回のスクロール位置は表示しないで，1行1列目（左上）を表示します。
標準値はこの設定になります。

表示サービス名.DCSGSL
ラジオボタンおよび単一選択リストボックスで，項目にフォーカスが位置づいたときの動作を指定します。

FREE
フォーカスが位置づいても，項目は選択状態になりません。項目の選択は，キーおよびマウスで操作します。

FOCUS
フォーカスが位置づいた項目は，自動的に選択されます。

表示サービス名.DCCMCS
コンボボックスのメニューが表示されていないときのカーソルキーの動作を指定します。

OPEN
カーソルキーを押すとメニューが表示されます。表示されたメニューから，メニュー項目を選択します。

SELECT
カーソルキーを押すとメニューが表示しないでメニュー項目を選択できるようになります。上カーソルキーまたは下カーソルキーを押すと，対応するメニュー項目が随時コンボボックスに表示されます。

注※

AIX，HP-UXおよびSolarisで指定ができます。

(3)　ショートカットキーに関する設定項目

ここでは，ショートカットキーに関しての表示サービスに対する設定項目について説明します。

表7-18　表示サービスに対する環境設定項目（ショートカットキーに関する設定）

パラメタ
意味
設定値

表示サービス名.DCACEL［n］
n： 1～16
メニューバーのメニューの機能を直接実行するために割り付けるキーボードのキーを指定します。
nの値は画面定義の際のメニューバーで設定するIDとなり，設定値は対応するショートカットキー（［Ctrl］キー+ 英文字）となります。入力では大文字と小文字の区別はなく，［Ctrl］キー+ 英大文字と
［Ctrl］キー+ 英小文字は同じ機能を実行します。

A～Z（半角英大文字の一文字）

デフォルト値は次のとおりです。
DCACEL[1] =A
DCACEL[2] =B
DCACEL[3] =C
DCACEL[4] =D
DCACEL[5] =E
DCACEL[6] =F
DCACEL[7] =G
DCACEL[8] =H
DCACEL[9] =J
DCACEL[10]=K
DCACEL[11]=L
DCACEL[12]=M
DCACEL[13]=N
DCACEL[14]=O
DCACEL[15]=V
DCACEL[16]=W

(4)　ファンクションキーに関する設定項目

ここでは，ファンクションキーに関しての表示サービスに対する設定項目について説明します。

表7-19　表示サービスに対する環境設定項目（ファンクションキーに関する設定）

パラメタ
意味
設定値

表示サービス名.DCFKEY[n]
n： 1～12
ファンクションキーの使用方法を指定します。（F1～F12）

ACT
標準イベント通知コードを割り当てます。DCFKEYおよびDCSKEYに対してデフォルト値となります。

NOACT
このファンクションキーを使用しません。DCCKEY，DCSCKY，DCAKEY，DCSAKY，DCCAKYに対してデフォルト値に割り当てられます。なお，DCFKEYおよびDCSKEYに対してはこの値を設定することはできません。

F01～F84
任意のイベント通知コードを割り当てます。

表示サービス名.DCSKEY[n]
n： 1～12
ファンクションキーの使用方法を指定します。（［Shift］＋F1～F12）

表示サービス名.DCCKEY[n]
n： 1～12
ファンクションキーの使用方法を指定します。（［Ctrl］＋F1～F12）

表示サービス名.DCSCKY[n]
n： 1～12
ファンクションキーの使用方法を指定します。（［Shift］＋［Ctrl］＋F1～F12）

表示サービス名.DCAKEY[n]
n： 1～12
ファンクションキーの使用方法を指定します。（［Alt］＋F1～F12）

表示サービス名.DCSAKY[n]
n： 1～12
ファンクションキーの使用方法を指定します。（［Shift］＋［Alt］＋F1～F12）

表示サービス名.DCCAKY[n]
n： 1～12
ファンクションキーの使用方法を指定します。（［Ctrl］＋［Alt］＋F1～F12）

なお，ファンクションキーについては，クライアントPCのOSの設定によって使用できない場合があります。詳細はマニュアル「画面・帳票サポートシステム　XMAP3 開発・実行ガイド」を参照してください。

(5)　画面デザインに関する設定項目

ここでは，画面デザインに関しての表示サービスに対する設定項目について説明します。

表7-20　表示サービスに対する環境設定項目（画面デザインに関する設定）

パラメタ
意味
設定値
（下線がデフォルト値）

表示サービス名.DCWNCT
ウィンドウのコントロールボックスを表示するかどうか指定します。

YES
コントロールボックスを表示します。

NO
コントロールボックスを表示しません。

表示サービス名.DCWNTL
ウィンドウのタイトルバーを表示するかどうか指定します。

MAP
タイトルバーを表示します。ただし，画面定義時に「表示しない」を指定した場合は表示しません。

NONE
画面定義に関係なく，常にタイトルバーを表示しません。

表示サービス名.DCWNMN
ウィンドウの最小化ボタンを表示するかどうか指定します。

YES
最小化ボタンを表示します。

NO
最小化ボタンを表示しません。

表示サービス名.DCWNMX
ウィンドウの最大化ボタンを表示するかどうか指定します。

YES
最大化ボタンを表示します。

NO
最大化ボタンを表示しません。

表示サービス名.DCMPCS
タイトルバーの右側の［閉じる］ボタンおよび左端のコントロールメニューで［閉じる］の項目を表示するかどうか指定します。
なお，XMAP3ではこの［閉じる］ボタンが操作されたとき，直接ウィンドウをクローズしないで，［Break］キーに対応するイベントをAPに通知します。このイベント通知コードに対応する処理がない場合，APは終了しません。

ON
［閉じる］ボタンを表示します。

OFF
［閉じる］ボタンを表示しません。

表示サービス名.DCSHAD
AP実行時に表示する画面の外観を指定します。

NORMAL
オブジェクトを2D表示（平面的な表示）とします。

SIMPLE
オブジェクトを3D表示（立体的な表示）とします。

表示サービス名.DCOPPS
オペレータインジケータの表示位置を指定します。なお，画面定義時にオペレータインジケータを表示しない指定がされている場合は，オペレータインジケータは表示されません。

BOTTOM
ウィンドウの下側に表示します。

TOP
ウィンドウの上側に表示します。

NONE
オペレータインジケータを表示しません。

EXTEND
ウィンドウの下部にステータスバー形式で表示します。

表示サービス名.DCMPPS
2回目以降の画面表示での一次ウィンドウの表示位置を画面定義に従うかを指定します。ただし，ウィンドウのXY位置が，左上，中央，右下，左下，右上とした場合は，画面定義が優先されます。

ON
画面定義で指定した位置に表示します。

OFF
前回のウィンドウのユーザが移動した位置を記憶し，その位置に表示します。

表示サービス名.DCWNSW
一次ウィンドウを全画面表示するかどうか指定します。

FULL
一次ウィンドウを全画面（デスクトップ画面に対して最大化）表示します。タイトルバーは付けられますが，ウィンドウの移動は抑止されます。

WIN
通常のウィンドウ表示となります。

表示サービス名.DCVTSL
ウィンドウの表示領域よりも画面が大きい場合に，ウィンドウにスクロールバーを付けるかどうかを指定します。

ON
スクロールバーを付けます。

OFF
スクロールバーを付けません。

表示サービス名.DCMSDG
オペレータインジケータに表示される入力エラーのダイアログ表示をするかどうかを指定します。

YES
入力エラーをダイアログとして表示します。

NO
入力エラーは，オペレータインジケータへの表示だけとなります。

表示サービス名.DCSWMV
二次ウィンドウの移動操作をできるようにするかどうか指定します。

ON
二次ウィンドウの移動操作をできるようにします。

OFF
二次ウィンドウの移動操作を抑止します。

表示サービス名.DCGEUD
GUI画面で入力できる入力テキストのアンダードットの表示有無を指定します。

ON
アンダードットを表示します。

OFF
アンダードットを表示しません。

NUM
数字，数値および金額項目にアンダードットを表示します。

表示サービス名.DCMSMV
DCMSDGにYESを指定したときに，エラーダイアログの移動操作をできるようにするかどうか指定します。

ON
エラーダイアログの移動操作をできるようにします。

OFF
エラーダイアログの移動操作を抑止します。

表示サービス名.DCGPBB
プッシュボタンにフォーカスが遷移したときの枠の太さを指定します。

DOT1
1ドットの線になります。

DOT2
2ドットの線になります。

表示サービス名.DCICFN
ユーザ定義のウィンドウアイコンを使用する場合に，クライアントPCに配布したアイコンファイル（「.ico」）のファイルパスを指定します。
指定がない場合や，指定したファイルが存在しない場合は，標準のアイコンとなります。
クライアント側でのアイコンファイルパス，またはUNCネットワークファイルパス

表示サービス名.DCGCKO
和暦日付の入力での元号のチェック条件を指定します。

ROPO
戸籍六法形式に従って元号を区切ります。戸籍六法形式に従った元号の区切りは次のようになります。
明治1年9月8日
　　　～明治45年7月29日
大正1年7月30日
　　　～大正15年12月24日
昭和1年12月25日
　　　～昭和64年1月7日
平成1年1月8日～

JIS
JIS規格に従って元号を区切ります。JIS規格に従った元号の区切りは次のようになります。
明治1年9月8日
　　　～明治45年7月30日
大正1年7月31日
　　　～大正15年12月25日
昭和1年12月26日
　　　～昭和64年1月7日
平成1年1月8日～

MIX
戸籍六法形式とJIS規格を混在させた方式に従って元号を区切ります。混在方式に従った元号の区切りは次のようになります。
明治1年9月8日
　　　～明治45年7月30日
大正1年7月30日
　　　～大正15年12月25日
昭和1年12月25日
　　　～昭和64年1月7日
平成1年1月8日～

表示サービス名.DCGSHO
和暦日付項目での元年表示の表示形式を指定します。

ON
「元年」と表示します。

OFF
「１年」と表示します。

表示サービス名.DCFLKD
GUI画面でのフィールドボックスに表示するけい線の種類を指定します。この指定はXMAP3以外のシステムで作成したマップとの互換性のために行うもので，XMAP3のドロー機能で生成したマップでは無効となります。

SOLID
実線で表示します。

ETOUT
凸型線（もり上がった線）で表示します。

ETIN
凹型線（くぼんだ線）で表示します。

表示サービス名.DCFLWD
GUI画面でのフィールドボックスに表示するけい線の太さを指定します。この指定はXMAP3以外のシステムで作成したマップとの互換性のために行うもので，XMAP3のドロー機能で生成したマップでは無効となります。
この指定はDCFLKDでSOLIDを指定したときだけ有効です。

NARROW
細線で表示します。

MIDDLE
中線で表示します。

WIDE
太線で表示します。

EWIDE
極太線で表示します。

表示サービス名.DCUDOT
CUI画面，またはGUI画面のフィールドボックスでの入出力フィールドのアンダードットの表示有無を指定します。

ON
アンダードットを表示します。

OFF
アンダードットを表示しません。

(6)　日本語入力に関する設定項目

ここでは，日本語入力に関しての表示サービスに対する設定項目について説明します。

表7-21　表示サービスに対する環境設定項目（日本語入力に関する設定）

パラメタ
意味
設定値
（下線がデフォルト値）

表示サービス名.DCWFEP
日本語入力をするとき，文字変換をする位置を指定します。

INLINE
入力するオブジェクト位置で変換します。

SYSTEM
日本語入力システムの変換ウィンドウで変換します。

表示サービス名.DCJROM
日本語入力をするときの入力方式を指定します。

DEF
日本語入力システムの設定に従います。

ON
日本語入力時，ローマ字入力になります。

OFF
日本語入力時，カナ入力になります。

表示サービス名.DCSIFT
入力できるテキスト(またはフィールド)にフォーカスが位置づいたときに，日本語入力状態を自動的に変更するかどうかを指定します。

ON
データ型が漢字の日本語テキスト(またはフィールド)にカーソルが位置づけられると，自動的に「日本語入力状態」になります。そのほかのオブジェクトに移ると，自動的に「日本語入力状態」がオフとなります。

OFF
日本語入力状態の制御をしません。

表示サービス名.DCKFEP
フォーカスが位置づいたときに，日本語入力システムを自動起動するオブジェクト種別を指定します。

FEPON
使用目的が「日本語」で詳細目的が「漢字」※，または「カナ」のオブジェクトの場合に日本語入力システムを起動します。

FEPOFF
使用目的が「日本語」で詳細目的が「漢字」※のオブジェクトの場合に日本語入力システムを起動します。

表示サービス名.DCJAMD
使用目的が「英数」，「MCR」，「パスワード」のオブジェクトで日本語入力システムを起動したときの動作を指定します。

HFALPN
自動的に半角英数字を入力するモードになります。

FLHIRA
自動的に全角のひらがなを入力するモードになります。

HFKATA
自動的に半角のカタカナを入力するモードになります。

NOCTRL
入力モードの制御をしません。

表示サービス名.DCDFEP
日本語入力の対象外の入力オブジェクトでの日本語入力の動作を指定します。

OFF
日本語入力モードを自動的にオフにします。

CONT
直前のオブジェクトで日本語入力システムを起動していた場合は，その状態を維持します。

注※

CUIの場合はデータ型「漢字（ＮＮ）」「漢字（ＸＸ）」が該当します。

(7)　表示色に関する設定項目

ここでは，CUI画面・GUI画面の実行時の表示色に関しての表示サービスに対する設定項目について説明します。

表7-22　表示サービスに対する環境設定項目（表示色に関する設定）

パラメタ
意味
設定値
（下線がデフォルト値）

表示サービス名.DCCLNM[n]
n：1～16
クライアントPC上のカラーディスプレイに表示する色情報を指定します。詳細は，「7.9　表示色をカスタマイズする」を参照してください。

000000～FFFFFF

表示サービス名.DCCLXF[n]
n：1～4
クライアントPC上のカラーディスプレイに表示する拡張文字色の色情報を指定します。詳細は，「7.9　表示色をカスタマイズする」を参照してください。

表示サービス名.DCCLXB[n]
n：1～7
クライアントPC上のカラーディスプレイに表示する拡張背景色の色情報を指定します。詳細は，「7.9　表示色をカスタマイズする」を参照してください。

表示サービス名.DCGOCC
GUI画面のオペレータインジケータの文字色を，DCCLNMで指定したパレット文字色番号から選んで指定します。

01～16（デフォルト値は08）

表示サービス名.DCGFLC
GUI画面のフィールドボックスのけい線の色を，DCCLNMで指定したパレット文字色番号から選んで指定します。

01～16（デフォルト値は08）

表示サービス名.DCGCRC
GUI画面のカーソルの色を，DCCLNMで指定したパレット文字色番号から選んで指定します。この指定を有効にするには，DCGSTCをMANUALに設定してください。

01～16（デフォルト値は08）

表示サービス名.DCGUDC
GUI画面のアンダードットの色を，DCCLNMで指定したパレット文字色番号から選んで指定します。この指定を有効にするには，DCGSTCをMANUALに設定してください。

01～16（デフォルト値は08）

表示サービス名.DCGOFC
フォーカスのないGUI画面のオペレータインジケータの背景色を，DCCLNMで指定したパレット文字色番号から選んで指定します。
なお，拡張形式のオペレータインジケータでは，この指定は無効になります。

01～16（デフォルト値は08）

表示サービス名.DCGONC
フォーカスのあるGUI画面のオペレータインジケータの背景色を，DCCLNMで指定したパレット文字色番号から選んで指定します。
なお，拡張形式のオペレータインジケータでは，この指定は無効になります。

01～16（デフォルト値は08）

表示サービス名.DCOPCC
CUI画面のオペレータインジケータの文字色を，DCCLNMで指定したパレット文字色番号から選んで指定します。
なお，拡張形式のオペレータインジケータでは，この指定は無効になります。

01～16（デフォルト値は07）

表示サービス名.DCFLCL
CUI画面のけい線の色を，DCCLNMで指定したパレット文字色番号から選んで指定します。

01～16（デフォルト値は07）

表示サービス名.DCCURC
CUI画面のカーソルの色を，DCCLNM で指定したパレット文字色番号から選んで指定します。

01～16（デフォルト値は07）

表示サービス名.DCUDTC
CUI画面のアンダードットの色を，DCCLNMで指定したパレット文字色番号から選んで指定します。

01～16（デフォルト値は07）

表示サービス名.DCOPNC
フォーカスのあるCUI画面のオペレータインジケータの背景色をDCCLNMで指定したパレット番号から選んで指定します。
なお，拡張形式のオペレータインジケータでは，この指定は無効になります。

01～16（デフォルト値は08）

表示サービス名.DCOPFC
フォーカスのないCUI画面のオペレータインジケータの背景色をDCCLNMで指定したパレット番号から選んで指定します。
なお，拡張形式のオペレータインジケータでは，この指定は無効になります。

01～16 （デフォルト値は08）

表示サービス名.DCGSTC
GUI画面で，カーソル・アンダードットの色の制御方法を指定します。

AUTO
XMAP3が自動制御します。

MANUAL
指定した色で表示します。

(8)　表示サービスに対するその他の設定

ここでは，表示サービスに対するその他の設定項目について説明します。

表7-23　表示サービスに対する環境設定項目（その他の設定）

パラメタ
意味
設定値
（下線がデフォルト値）

表示サービス名.DCMCRO
MCR装置（磁気カード読み取り装置）を使用するかどうか指定します。

NONE
MCR装置を使用しません。

ALL
MCR装置を使用します。

表示サービス名.DCMCRP
MCR装置を使用する場合に，接続するポートを指定します。設定値の1～4の数値が，それぞれCOM1，COM2，COM3，COM4に対応します。

1～4(デフォルト値は1)

表示サービス名.DCCMOB
MCR装置から入力された値が内部バッファサイズの256バイトを超えた場合に，ビープ音を鳴らすかを指定します。

NORMAL
ビープ音を鳴らします。

OFF
ビープ音を鳴らしません。

表示サービス名.DCMPTH
ポップアップメニューファイルをXMAP3インストールフォルダ¥USER¥POPMENU以外のフォルダに格納して運用する場合に，そのパスを指定します。
ドライブ名を含むフルパスで指定する必要があります。
ポップアップメニューファイルの読み込みパス

表示サービス名.DCMCSH
ポップアップメニューファイルの読み込み契機を指定します。

ON
GUI画面が書き換えられるたびにポップアップメニューファイルを読み込みます。

OFF
アプリケーションが起動されるたびにポップアップメニューファイルを読み込みます。

表示サービス名.DCCMPR
表示サービスへ送信するデータを圧縮するかどうかを指定します。
詳細は，「7.11　通信データを圧縮する」を参照してください。

ON
表示サービスへ送信するデータを圧縮します。

OFF
表示サービスへ送信するデータを圧縮しません。

表示サービス名.DCCHSZ
CUI画面に表示する文字の大きさを指定します。なお，フォントの指定方法についての詳細は，マニュアル「画面・帳票サポートシステム　XMAP3 開発・実行ガイド」を参照してください。

16
16ドットのフォントを使用します。

24
24ドットのフォントを使用します。

表示サービス名.DCPSNM
OLTP（TP1/NET/XMAP3）構成で，XMAP3画面の表示中に［Ctrl］＋［P］（印刷キー処理）操作によってCUI画面およびGUI画面のフィールドボックスを印刷します。画面そのものの印刷ではなく，オブジェクトの文字データやけい線などを論理的に印刷する論理ハードコピーを実行します。その印刷の出力先である印刷サービス名を指定します。
印刷サービスの論理ハードコピーのパラメタについては，「7.8.6(5)　印刷サービスに関するその他の設定」を参照してください。
印刷サービス名

7.8.6　印刷サービスに対する設定項目

ここでは，サーバWS，クライアントPCで動作する印刷サービスに対する環境設定ファイルの設定項目を説明します。この設定項目は先頭に「P」が付きます。これらのパラメタのサービス名には，「*」，または対象となる印刷サービス名称を指定してください。

複数行指定がある場合は，表示・印刷環境ファイルの最終行に近い行の指定が有効になります。また，設定値が誤っている場合やパラメタ自体が存在しない場合には，デフォルト値が設定されます。

＜この項の構成＞

(1)　印刷サービスに関する出力先の基本設定

(2)　印刷サービスに関するカラー印刷の設定

(3)　印刷サービスに関する用紙および印刷レイアウトの設定

(4)　印刷サービスに関するPDF出力設定（AIX，HP-UX，Solaris）

(5)　印刷サービスに関するその他の設定

(1)　印刷サービスに関する出力先の基本設定

ここでは，印刷サービスに対する出力先の基本設定項目について説明します。

表7-24　印刷サービスに関する環境設定項目（出力先の基本設定項目）

パラメタ
意味
設定値
（下線がデフォルト値）

印刷サービス名.PCRPRT
出力対象のプリンタの種別に応じた設定値を，ESCP_D，PostScript2，LIPSのどれかを選択して指定します。
なお，この指定はサーバWS上の印刷サービスに対してだけ有効です。

ESCP_D
ESC/P J84準拠のページ記述言語を認識できる180dpiのシリアルプリンタ，またはラインプリンタを使用します。

PostScript2
PostScriptレベル2，またはPostScriptレベル3のページ記述言語を認識できるページプリンタを使用します。※

LIPS
LIPS II+，またはLIPS IIIのページ記述言語を認識できるページプリンタを使用します。

印刷サービス名.PCQPRX
帳票印刷実行時に，印刷データの出力先をJP1/NQSEXECのキューにするか，LPスプールのプリンタにするかの設定をON，OFFのどちらかを選択して指定します。
なお，この指定はサーバWS上の印刷サービスに対してだけ有効です。

ON
JP1/NQSEXEC連携方式で，サービス名ファイルのデバイス名称に指定されたJP1/NQSEXECのキューに対してJP1コマンド「qprx」を発行して，印刷データの印刷指示をします。

OFF
LPスプール出力方式で，サービス名ファイルのデバイス名称に指定されたプリンタに対して，直接印刷データの印刷指示をします。

印刷サービス名.PCLIPS
LIPS適応プリンタを使用する場合の，XMAP3 Serverが生成するLIPSコマンドの作成コマンドレベルを指定します。
なお，この設定値は，LIPSプリンタの場合（PCRPRT=LIPS）だけ有効となり，その他の場合には無効となります。
また，この指定はサーバWS上の印刷サービスに対してだけ有効です。

2
LIPS II+で印刷データを生成します。

3
LIPS IIIで印刷データを生成します。

注※

この機能は，PostScript レベル2でサポートされているコマンドの範囲内で，PostScriptレベル3準拠プリンタへの出力に対応する機能です。AIX，HP-UXおよびSolarisで利用できます。

したがって，PostScriptレベル2でサポート範囲外となる，PostScriptレベル3以降にサポートされたコマンドの機能は利用できません。

(2)　印刷サービスに関するカラー印刷の設定

ここでは，印刷サービスに対するカラー印刷の設定項目について説明します。

表7-25　印刷サービスに対する環境設定項目（カラー印刷の設定項目）

パラメタ
意味
設定値
（下線がデフォルト値）

印刷サービス名.PCGRC
カラーのグラフィックデータを印刷する方式を指定します。
なお，この指定はクライアントPC上の印刷サービスに対してだけ有効です。

PRINTER_DRIVER
カラーのグラフィックデータのカラー情報をそのままプリンタに出力します。

THRESHOLDING
カラーのグラフィックデータをXMAP3がモノクロ化したあと，プリンタに出力します。

印刷サービス名.PCCLNM[n]※
n： 1～8
文字のカラー印刷を実行するときの色情報を指定します。詳細は「7.10　印刷色をカスタマイズする（AIX，HP-UX，Solaris）」を参照してください。

000000～FFFFFF

注※

AIX，HP-UXおよびSolarisで指定ができます。

(3)　印刷サービスに関する用紙および印刷レイアウトの設定

ここでは，印刷サービスに対する用紙および印刷レイアウトの設定項目について説明します。

表7-26　印刷サービスに対する環境設定項目（用紙および印刷レイアウトの設定項目）

パラメタ
意味
設定値
（下線がデフォルト値）

印刷サービス名.PCTRAY
PostScriptプリンタで印刷する場合に，プリンタの標準設定と帳票で指定された用紙サイズが合わないときの選択の動作を指定します。
なお，この機能はプリンタによっては動作しない場合があります。また，この指定はサーバWS上の印刷サービスに対してだけ有効です。

OFF
用紙選択をしません。プリンタの標準設定トレーにある用紙だけで印刷します。

OPT0
用紙サイズが合わない場合，プリンタ側でエラーメッセージを出力して，帳票は印刷しません。

OPT1
用紙サイズが合わない場合，用紙サイズを無視して，標準設定トレーの用紙で印刷します。

OPT2
用紙サイズが合わない場合，プリンタ側で用紙切り替えのメッセージを出力して，使用者に切り替えを要求します。

印刷サービス名.PCDLLN
抹消線が定義されている文字フィールドに対して，抹消線の形状を指定します。

SINGLE
抹消線の形状を一重線とします。

DOUBLE
抹消線の形状を二重線とします。

印刷サービス名.PCGSHO
和暦日付項目での元年印刷の印刷形式を指定します。

ON
「元年」と印刷します。

OFF
「１年」と印刷します。

印刷サービス名.POPAGE
帳票印刷をするときの連続紙の1ページ当たりの行数を0～99の範囲で指定します。また，この値が0のときは，マップで指定された行数をページ長とします。

0～99(デフォルト値は0)

印刷サービス名.POPASZ
用紙サイズの指定がないマップ帳票（マップ定義で給紙サイズにフリーを指定した場合など）を印刷するときに仮定する用紙のサイズを指定します。

A3L
A3横の用紙を使用します。

A4L
A4横の用紙を使用します。

A5L
A5横の用紙を使用します。

B4L
B4横の用紙を使用します。

B5L
B5横の用紙を使用します。

A3P
A3縦の用紙を使用します。

A4P
A4縦の用紙を使用します。

A5P
A5縦の用紙を使用します。

B4P
B4縦の用紙を使用します。

B5P
B5縦の用紙を使用します。

DEF
明示的に用紙サイズを指定しません（プリンタに依存します）。

印刷サービス名.POLNPC
行間隔の指定がないマップ帳票を印刷するときに仮定する行間隔を，3LPI，4LPI，6LPI，8LPIのどれかを選択して指定します。

3LPI
行間隔を3LPIにします。

4LPI
行間隔を4LPIにします。

6LPI
行間隔を6LPIにします。

8LPI
行間隔を8LPIにします。

印刷サービス名.POCHPC
字間値指定がないマップ帳票を印刷するときに仮定する字間値（文字と文字の間の長さ）を，0ポイント～15ポイントの範囲で指定します。

0～15(デフォルト値は0)

印刷サービス名.POPAOT
用紙排出に関する印刷動作の指示がないマップ帳票を印刷した場合に仮定する，用紙の排出動作（改ページ）を指定します。

NON
印刷前後とも改ページをしません。

BEF
印刷前に改ページをします。

AFT
印刷後に改ページをします。

BOT
印刷前および印刷後に改ページをします。

印刷サービス名.POMGTP

上マージン指定がないマップ帳票を印刷するときの単票での上マージンの値を0～255の範囲で指定します。上マージンの値は，単票では0mm～255mmの範囲となり，連票では0mmとなります。

なお，この指定はサーバWS上の印刷サービスに対してだけ有効です。

0～255(デフォルト値は0)

印刷サービス名.POMGLF

左マージン指定がないマップ帳票を印刷するときの単票での左マージンの値を0～255の範囲で指定します。左マージンの値は，単票では0mm～255mmの範囲となり，連票では0mmとなります。

なお，この指定はサーバWS上の印刷サービスに対してだけ有効です。

0～255(デフォルト値は0)

印刷サービス名.POOTDR
用紙の排出先指定のないカット紙のマップ帳票を水平インサータプリンタに対して印刷したときの印刷用紙の排出先を指定します。なお，この指定はサーバWS上の印刷サービスに対してだけ有効です。

STK
スタック側に用紙を排出します。

HOP
ホッパ側に用紙を排出します。

(4)　印刷サービスに関するPDF出力設定（AIX，HP-UX，Solaris）

ここでは，印刷サービスに対するPDF出力の設定項目について説明します。

表7-27　印刷サービスに対する環境設定項目（PDF出力の設定項目）

パラメタ
意味
設定値
（下線がデフォルト値）

印刷サービス名.PCFPTH
PDFファイルの出力先を指定します。また，このパラメタの指定がない場合は，クライアントPC上のXMAP3インストールフォルダ¥User¥Pdfが仮定されます。

PDFファイルの出力先フォルダのパス名

印刷サービス名.PCPAPP
PDFファイルを出力したあとに，起動するプログラムのパスを指定します。また，このパラメタの指定がない場合，PDFファイル出力後に特定のプログラムを起動しません。

起動したいプログラムのパス名

印刷サービス名.PCPDCM
PDFファイルの出力時，圧縮するかどうかを指定します。

ON
PDFファイルを圧縮します。

OFF
PDFファイルを圧縮しません。

なお，PDF出力に関する設定項目の詳細は，「7.15　PDFファイル出力に関連する設定と注意事項（AIX，HP-UX，Solaris）」を参照してください。

(5)　印刷サービスに関するその他の設定

ここでは，印刷サービスに対するその他の設定項目について説明します。

表7-28　印刷サービスに対する環境設定項目（その他の設定項目）

パラメタ
意味
設定値
（下線がデフォルト値）

印刷サービス名.PCCMPR
印刷サービスへ送信するデータを圧縮するかどうかを指定します。
詳細は，「7.11　通信データを圧縮する」を参照してください。
なお，この指定はクライアントPC上の印刷サービスに対してだけ有効です。

ON
印刷サービスへ送信するデータを圧縮します。

OFF
印刷サービスへ送信するデータを圧縮しません。

印刷サービス名.POPRHD
印刷後のヘッド位置に関する印刷動作の指示がない連続紙のマップ帳票を印刷した場合に仮定する，印刷後のヘッドの位置を指定します。
データ中に改ページの指示がない場合，指定によってオンライン印刷終了後のプリンタヘッドの位置が異なります。
ヘッドの位置は，DATENDの指定では560/20互換，MAPENDの指定ではXMAP3 Server固有となります。
なお，POPAGEの値が0のときは，この指定に関係なくヘッド位置は有効データ最終行の次行先頭になります。
また，最終行に空白行の印字があるときは，この指定に関係なくヘッド位置はマップ指定最終行の次行先頭になります。

DATEND
ヘッダ位置を有効データ最終行の次行先頭にします。

MAPEND
ヘッダ位置をマップ指定最終行の次行先頭にします。

印刷サービス名.PCFOCP
JP1/NPS連携時，JP1キューに，印刷ジョブを1ページごとに登録するか，オープン～クローズ間のページをまとめて登録するかを指定します（強制印刷指定：Forcible Print）。
詳細は，「7.17　JP1/NPS連携時に1ページごとにジョブを登録する（HP-UX（PA-RISC），AIX）」を参照してください。

ON
常に，1ページごとに印刷ジョブを登録します。

OFF
オープン～クローズ間に印刷された全ページを一つの印刷ジョブとして，クローズのタイミングで登録します。

印刷サービス名.PCSPCR
ESC/Pプリンタに「けい線帳票」および「プレプリント帳票」を出力する際に，改ページ制御を，XMAP3 Serverまたはプリンタのどちらが行うかを指定します。
この機能は，XMAP3 Serverでスタンドアロン構成での印刷を実行する場合だけ利用できます。WindowsクライアントとのC/S構成での印刷では利用できません。
詳細は，「7.18　ESC/Pプリンタでプリンタ任せの改ページ印刷をする（AIX）」を参照してください。

SOFT
XMAP3 Serverが，帳票定義の用紙長および実行環境の設定に応じて，改ページ制御を行います。

HARD
プリンタが保持する用紙長に従って，改ページを行います。

印刷サービス名.PLPAKD
論理ハードコピーを印刷する用紙の種類を指定します。パラメタおよび設定値の大文字，小文字は区別されます。

CONT
出力用紙を連続紙として排出（改ページ）します。

CUT
出力用紙を単票として排出（改ページ）します。

印刷サービス名.PLPASZ
論理ハードコピーを印刷する単票の用紙サイズを指定します。連続紙印刷の場合は，このパラメタの指定は無視されます。パラメタおよび設定値の大文字，小文字は区別されます。

A3L
A3横

A4P
A4縦

A4L
A4横

A5P
A5縦

A5L
A5横

B4P
B4縦

B4L
B4横

B5P
B5縦

B5L
B5横

DEF
指定なし（プリンタ依存）

印刷サービス名.PLLNPC
論理ハードコピー印刷での行ピッチを指定します。パラメタおよび設定値の大文字，小文字は区別されます。

3LPI

4LPI

6LPI

8LPI

印刷サービス名.PLCHPC
論理ハードコピー印刷での文字ピッチを指定します。パラメタおよび設定値の大文字，小文字は区別されます。

10CPI

12CPI

印刷サービス名.PLPAOT
論理ハードコピー印刷後に用紙を排出（改ページ）するかどうかを指定します。
連続紙印刷の場合は，このパラメタの指定は無視されます。パラメタおよび設定値の大文字，小文字は区別されます。

ON
単票の用紙排出（改ページ）をします。

OFF
単票の用紙排出（改ページ）をしません。

印刷サービス名.PLOTDR
論理ハードコピー印刷後の用紙の排出先を指定します。
連続紙印刷の場合は，このパラメタの指定は無視されます。パラメタおよび設定値の大文字，小文字は区別されます。

STK
スタッカ（紙送り方向）側に用紙を排出します。

HOP
ホッパ（紙送り方向の逆）側に用紙を排出します。

印刷サービス名.PLMGTP
論理ハードコピーを印刷する単票の上マージンの値（mm）を指定します。
連続紙印刷の場合は，このパラメタの指定は無視されます。パラメタの大文字，小文字は区別されます。

0～255
印刷する単票の上マージンの値を指定します。
パラメタの指定を省略すると，0mmが仮定されます。

印刷サービス名.PLMGLF
論理ハードコピーを印刷する単票の左マージンの値（mm）を指定します。
連続紙印刷の場合は，このパラメタの指定は無視されます。パラメタの大文字，小文字は区別されます。

0～255
印刷する単票の左マージンの値を指定します。
パラメタの指定を省略すると，0mmが仮定されます。

7.8.7　表示・印刷環境ファイルの初期状態

/etc/opt/HIXMAP/XPWconfigファイルの各パラメタの初期値を図7-10に示します。

図7-10　/etc/opt/HIXMAP/XPWconfigファイルの各パラメタの初期値

7.9　表示色をカスタマイズする

この節では，表示・印刷環境ファイルで設定する表示色とPC XMAP3で定義する表示色との関係や，表示・印刷環境ファイルのパラメタの設定方法について説明します。

＜この節の構成＞

7.9.1　表示・印刷環境ファイルとPC XMAP3の画面定義との関係

7.9.2　PC XMAP3の画面定義で色指定できないオブジェクトの表示色を指定する

7.9.3　GUI画面とCUI画面で使用する表示色の初期値

7.9.1　表示・印刷環境ファイルとPC XMAP3の画面定義との関係

表示・印刷環境ファイルで設定する表示色とPC XMAP3の画面定義で指定する表示色との関係を，図7-11に示します。

図7-11　表示・印刷環境ファイルとPC XMAP3での画面定義との関係

PC XMAP3の画面定義で指定する表示色には，それぞれパレット色番号が割り当てられています。例えば，文字色の赤には「1」，黒には「8」，背景色の赤には「9」というパレット色番号が割り当てられています。

表示・印刷環境ファイルには，そのパレット色番号に対応する色の構成要素をRGB値として定義します。RGB値とは，表示色を赤（Red），緑（Green），青（Blue）の3原色に分解し，それぞれの色合いを0～FF（255）までの16進数で表したものです。

例えば，表示・印刷環境ファイルに「*.DCCLNM[1]=FF0000」と記述した場合，PC XMAP3の画面定義で「赤」に指定した文字はRGB値「FF0000」の色で表示されます。

文字色（拡張文字色），背景色（拡張背景色）の表示・印刷環境ファイルでのパラメタを，次に示します。なお，この指定はディスプレイの表示色が256色以上のときだけ，有効となります。

表7-29　表示・印刷環境ファイルでのパラメタ（文字色と背景色）

画面定義での表示色 | パレット色番号 | パラメタ(デフォルト値)
種別 | 色
文字色 | 赤 | カラーパレット色番号1 | *.DCCLNM[1]（FF0000）
緑 | カラーパレット色番号2 | *.DCCLNM[2]（00AA00）
黄 | カラーパレット色番号3 | *.DCCLNM[3]（FFCD00）
青 | カラーパレット色番号4 | *.DCCLNM[4]（0000FF）
紫 | カラーパレット色番号5 | *.DCCLNM[5]（D24AD2）
空 | カラーパレット色番号6 | *.DCCLNM[6]（00D7FF）
白 | カラーパレット色番号7 | *.DCCLNM[7]（FFFFFF）
黒 | カラーパレット色番号8 | *.DCCLNM[8]（000000）
拡張文字色 | ダークレッド | － | *.DCCLXF[1]（800000）
ダークグリーン | － | *.DCCLXF[2]（008000）
ダークイエロー | － | *.DCCLXF[3]（FF871E）
ダークブルー | － | *.DCCLXF[4]（000080）
背景色 | 赤 | カラーパレット色番号9 | *.DCCLNM[9]（F07880）
緑 | カラーパレット色番号10 | *.DCCLNM[10]（96C896）
黄 | カラーパレット色番号11 | *.DCCLNM[11]（E5E520）
青 | カラーパレット色番号12 | *.DCCLNM[12]（729FFF）
紫 | カラーパレット色番号13 | *.DCCLNM[13]（FFA6AF）
空 | カラーパレット色番号14 | *.DCCLNM[14]（9DBFF5）
白 | カラーパレット色番号15 | *.DCCLNM[15]（F0F0F0）
グレー | カラーパレット色番号16 | *.DCCLNM[16]（BFBFC9）
拡張背景色 | 黒 | － | *.DCCLXB[1]（000000）
ライトグレー | － | *.DCCLXB[2]（E0E0E0）
ダークグレー | － | *.DCCLXB[3]（808080）
ライトグリーン | － | *.DCCLXB[4]（C0F0C0）
ダークグリーン | － | *.DCCLXB[5]（008000）
ライトイエロー | － | *.DCCLXB[6]（FFFFAA）
ダークブルー | － | *.DCCLXB[7]（000080）

（凡例）

－：該当なし

7.9.2　PC XMAP3の画面定義で色指定できないオブジェクトの表示色を指定する

表示・印刷環境ファイルを利用すると，PC XMAP3の画面定義で色を指定できないオブジェクトに対しても，表示色を指定できます。

変更したいオブジェクトに対応するパラメタに，変更したい色のパレット色番号を指定します。例えば，GUI画面のオペレータインジケータの文字色を「赤（カラーパレット色番号：1）」に変更する場合には，次のように指定します。

このほかのオブジェクトについては，「7.8.5　表示サービスに対する設定項目」を参照してください。

7.9.3　GUI画面とCUI画面で使用する表示色の初期値

GUI画面とCUI画面で使用する表示色の初期値を，次に示します。

表7-30　GUI画面とCUI画面で使用する表示色の初期値

オブジェクト
GUI画面
CUI画面

ウィンドウの背景
指定なし
（カラーパレット色番号12（青）が仮定される）
カラーパレット色番号8（黒）

オペレータインジケータの背景
（ユーザ表示エリアを除く）
指定なし
（ウィンドウの背景と同じ色になる）
カラーパレット色番号8（黒）

オペレータインジケータの文字
（ユーザ表示エリアを除く）
カラーパレット色番号8（黒）
カラーパレット色番号7（白）

けい線
カラーパレット色番号8（黒）
カラーパレット色番号7（白）

アンダードット
カラーパレット色番号8（黒）
カラーパレット色番号7（白）

カーソル
カラーパレット色番号8（黒）
カラーパレット色番号7（白）

7.10　印刷色をカスタマイズする（AIX，HP-UX，Solaris）

この節では，帳票上での，表示・印刷環境ファイルで設定する文字色とPC XMAP3で定義する文字色との関係や，表示・印刷環境ファイル（XPWconfig）のパラメタの設定方法について説明します。

＜この節の構成＞

7.10.1　表示・印刷環境ファイルとPC XMAP3の帳票定義との関係

7.10.1　表示・印刷環境ファイルとPC XMAP3の帳票定義との関係

表示・印刷環境ファイルで設定する文字色とPC XMAP3の帳票定義で指定する文字色との関係を，図7-12に示します。

図7-12　表示・印刷環境ファイルとPC XMAP3での帳票定義との関係

PC XMAP3の帳票定義で指定する文字色には，それぞれパレット色番号が割り当てられています。例えば，文字色の赤には「1」，黒には「8」というパレット色番号が割り当てられています。

表示・印刷環境ファイルには，そのパレット色番号に対応する色の構成要素をRGB値として定義します。RGB値とは，文字色を赤（Red），緑（Green），青（Blue）の3原色に分解し，それぞれの色合いを0～FF（255）までの16進数で表したものです。

例えば，表示・印刷環境ファイルに「*.PCCLNM[1]=FF0000」と記述した場合，PC XMAP3の帳票定義で「赤」に指定した文字はRGB値「FF0000」の色で印字されます。

文字色の表示・印刷環境ファイルでのパラメタを，次に示します。

表7-31　表示・印刷環境ファイルでのパラメタ（文字色）

帳票定義での印字色 | パレット色番号 | パラメタ(デフォルト値)
種別 | 色
文字色 | 赤 | カラーパレット色番号1 | *.PCCLNM[1]（FF0000）
緑 | カラーパレット色番号2 | *.PCCLNM[2]（00AA00）
黄 | カラーパレット色番号3 | *.PCCLNM[3]（FFCD00）
青 | カラーパレット色番号4 | *.PCCLNM[4]（0000FF）
紫 | カラーパレット色番号5 | *.PCCLNM[5]（D24AD2）
空 | カラーパレット色番号6 | *.PCCLNM[6]（00D7FF）
白 | カラーパレット色番号7 | *.PCCLNM[7]（FFFFFF）
黒 | カラーパレット色番号8 | *.PCCLNM[8]（000000）

7.11　通信データを圧縮する

＜この節の構成＞

(1)　C/Sシステムの通信データ圧縮の機能概要

(2)　通信データ圧縮機能が動作する運用形態

(3)　XMAP3 Serverの表示・印刷環境ファイルでの設定

(1)　C/Sシステムの通信データ圧縮の機能概要

XMAP3では，C/Sシステムの通信データを圧縮する機能（以降，通信データ圧縮機能と表記する）を提供しています。通信データ圧縮機能を使用すると，低速回線でのデータ転送時間が短縮されます。この結果，画面表示と帳票印刷の性能が向上します。また，データ転送量が削減されるため，従量制パケット回線の通信コストが軽減します。

C/S構成でのデータ転送の例を図7-13に示します。

図7-13　C/S構成でのデータ転送の例

図7-13の例で，低速回線であるWAN（Wide Area Network）を使用するデータ転送Bのケースは，データ圧縮機能によって転送データが削減されるため，アプリケーションのレスポンスが向上し，通信コストが軽減します。また，高速回線であるLAN（Local Area Network）を使用するデータ転送Aのケースでも，転送データ量の削減によって，LAN上のトラフィックが軽減され，レスポンスの向上が期待できます。

通信データ圧縮機能によるデータ転送量削減のイメージを，図7-14に示します。

図7-14　通信データ圧縮機能によるデータ転送量の削減

通信データ圧縮機能を利用すると，サーバからクライアントへ画面・帳票データを転送する時に，サーバ（サーバAP）側で転送データが圧縮されます。圧縮されたデータがクライアントに転送されると，クライアント（表示・印刷サービス）側でそのデータが解凍されます。

(2)　通信データ圧縮機能が動作する運用形態

通信データ圧縮機能は，サーバにWS，クライアントにPCを使用するC/S構成で利用できます。

通信データ圧縮機能が動作する運用形態を図7-15に示します。

図7-15　通信データ圧縮機能が動作する運用形態

(3)　XMAP3 Serverの表示・印刷環境ファイルでの設定

この機能を有効にする場合の表示・印刷環境ファイルの設定を次に示します。

(a)　表示サービスへ送信するデータを圧縮する（表示サービス名.DCCMPR =）

表示サービスへ送信するデータを圧縮するかどうかを指定します。

表示サービスへ送信するデータを圧縮する(ON)

表示サービスへ送信するデータを圧縮しない(OFF)

(b)　印刷サービスへ送信するデータを圧縮する（印刷サービス名.PCCMPR =）

印刷サービスへ送信するデータを圧縮するかどうかを指定します。

印刷サービスへ送信するデータを圧縮する(ON)

印刷サービスへ送信するデータを圧縮しない(OFF)

7.12　印刷環境をカスタマイズする

この節では，スタンドアロン構成での帳票印刷実行時の出力タイミングの変更方法や，印刷実行時の注意事項について説明します。

＜この節の構成＞

7.12.1　LPスプールシステムでの帳票一括出力機能

7.12.2　LAN接続プリンタ使用時の注意事項

7.12.3　JP1/NQSEXECのqprxコマンドオプション付加

7.12.1　LPスプールシステムでの帳票一括出力機能

「LPスプールシステムでの帳票一括出力機能」は，XMAP3 Serverからの出力をアプリケーションからのクローズ処理タイミングで，LPスプールシステムに対して一括出力する機能です。この機能を使用することで，LPスプールシステムへの出力を，アプリケーションからの要求で変えられます。この機能を使用する場合は，マップ帳票出力時は「7.6.6　マップドライバ環境定義ファイル」で説明した指定項目の「プリンタ出力」に「async」設定が必要になります。ただし，JP1連携時には常にこの機能が有効になっています。

＜この項の構成＞

(1)　環境設定

(2)　起動方法例

(3)　使用時の注意事項

(1)　環境設定

XMAP3サーバを起動する前に，次の環境変数に値を設定することで，LPスプールシステムへの一括出力するタイミングを変更できます。

環境変数：XPWCSTMW
印刷サービスを起動するWSでこの環境変数を設定後，XMAP3サーバを起動します。

なお，この環境変数での設定は，環境変数を設定したWSで起動するすべての印刷サービスを対象とします。

環境変数に設定する内容および動作を次に示します。

表7-32　帳票一括出力機能の設定値および動作

設定値
動作

ON

DISABLE発行時またはAP終了時
XMAP3内にキューイングしている印刷データをLPスプールシステムに対してスプーリングする。

SEND時には，XMAP3 Server内にキューイングするだけで，LPスプールシステムに対しては要求しない。

OFF
印刷要求SENDごとにLPスプールシステムにlpコマンドを発行する。

不定値（上記以外）

環境変数なし

(2)　起動方法例

帳票一括出力機能を使用する場合は，次の設定順でXMAP3 Serverを起動します。

（Cシェル環境の場合）

% setenv XPWCSTMW ON
% /opt/HIXMAP/bin/xpwdaemon -s &

（Bourneシェル環境の場合）

#XPWCSTMW=ON
#export XPWCSTMW
#/opt/HIXMAP/bin/xpwdaemon -s &

(3)　使用時の注意事項

環境変数に値を設定しても，マップドライバ環境定義ファイルのプリンタ出力の設定が「sync」の場合には，この機能は無効となり，SENDごとにLPスプールへの印刷指示が行われます。

この機能を使用した場合，クローズ要求以前にアプリケーションの異常終了などの障害が発生したときには，XMAP3 Serverでキューイングしているデータは，LPスプールシステムに登録されません。

7.12.2　LAN接続プリンタ使用時の注意事項

XMAP3 Serverでは，LPスプールシステムを使用して印刷するとき，表示・印刷環境ファイルの設定に従って印刷データをプリンタ記述言語（PDL）で生成します。このとき，実際に出力するプリンタがサポートしているPDLが異なっていると正しい印刷結果が得られません。したがって，表示・印刷環境ファイル設定時は，対象プリンタが一致するように設定してください。

LPスプールシステムに対して，データ加工をするようなフィルタを指定した場合，プリンタのLANコントローラでXMAP3 Serverの生成したPDLが加工されてしまい，正しい印刷結果が得られない場合があります。このため，スプール設定時はフィルタを外す設定をしてください。

印刷中のプリンタで紙無しなどの障害が発生した場合，LPスプールシステムのエラーリカバリ処理とプリンタの障害処理が競合し，印刷中の帳票の出力結果が不正になることがあります。そのため，印刷中のプリンタで紙無しなどの障害が発生した場合は，プリンタの障害を回復させたあとにプリンタをリセットし，再度，印刷の実行をやり直してください。

LPスプールシステムを使用した印刷では，印刷完了通知や用紙切れなどのプリンタ情報がUAPで取得できないため，印刷確認については運用上の注意が必要です。

7.12.3　JP1/NQSEXECのqprxコマンドオプション付加

JP1/NQSEXEC連携を有効にしてJP1/NPSを経由した印刷を行う場合，XMAP3 Serverの印刷サービスは，JP1/NQSEXECが提供するqprxコマンドを発行して，JP1のキューに印刷ジョブを登録します。このとき，ユーザプログラムから印刷サービスが発行するqprxコマンドのオプションに対し，JP1/NPSのセパレータの付加などのオプションを追加指定することができます。

qprxコマンドのオプションを指定するには，ユーザプログラムを起動する前，またはXMAP3 Serverへの帳票印刷時のオープン要求発行前に，次の環境変数に値を設定してください。

環境変数：XPWQPRX

設定値：-sfc S -rリクエスト名

環境変数の設定例を次に示します。

（例）

-sfc Sおよび-rリクエスト名は，JP1/NQSEXECのqprxコマンドのパラメタであるため，指定できるパラメタの詳細については，マニュアル「JP1 Version 6　JP1/Network Printing System　運用・操作編」を参照してください。

使用上の注意事項

qprxコマンドがパラメタ不正などの理由によってエラーとなった場合には，そのエラーメッセージを，「/usr/tmp/xpw/.remote/.lprmsg_印刷サービス名」ファイルに格納します。エラーが発生した場合には，上記ファイル中のエラーメッセージを確認の上，対処してください。また，環境変数XPWQPRXに「-me」オプションを指定することで，qprxコマンドのメッセージがメールで送信されるため，メールで確認したい場合には，qprxコマンドのオプション指定で指定してください。

環境変数XPWQPRXで指定した値は，そのAPで最初のSEND要求時に設定された値だけが有効となります。以降，DISABLE文が発行されるか，アプリケーションプログラムが終了までの間に複数のSENDを発行された場合，それらはすべて一つのジョブとしてJP1キューに登録されます（途中のSENDのタイミングで環境変数を変更しても有効にはなりません）。

7.13　プレプリント帳票を印刷するための準備（AIX，Linux，Solaris）

この節では，AIX，LinuxおよびSolaris環境でのスタンドアロン構成で，プレプリント帳票を印刷するために前もって準備する必要がある環境設定について説明します。HP-UX環境では，この環境設定は必要ありません。

＜この節の構成＞

7.13.1　文字フォントの準備

7.13.2　注意事項

7.13.1　文字フォントの準備

プレプリント帳票を印刷する前に，フォントファイルを準備する必要があります。ここでは，フォントファイルの準備方法について説明します。なお，プレプリント帳票以外の帳票デバイス（けい線帳票，網掛け帳票，グラフィック帳票）の印字の場合には，この準備は不要です。

＜この項の構成＞

(1)　AIXでの文字フォントファイルの準備

(2)　Linuxでの文字フォントファイルの準備

(3)　Solarisでの文字フォントファイルの準備

(1)　AIXでの文字フォントファイルの準備

次の手順に従って，準備してください。

/usr/lib/X11/fontsディレクトリに格納されているフォントファイルを指定されたディレクトリにコピーします。

＜コピーするフォントファイル＞

RomanKn17S.pcf.Z　（半角文字用フォントファイル）

Kanji17S.pcf.Z　　（全角文字用フォントファイル）

＜コピー先ディレクトリ＞

/usr/lib/X11/fonts/hitachi

（XMAP3 Serverインストール時に生成されます）

文字フォントファイルを解凍します。
1.で格納した文字フォントファイルをuncompressコマンドで解凍します。
正しく解凍できたら，ファイル名称の末尾の「.Z」がなくなったファイル名称になり，ファイルサイズも大きくなります。

＜コマンドの形式＞

uncompress フォントファイル名

(2)　Linuxでの文字フォントファイルの準備

次の手順に従って，準備してください。

/usr/X11R6/lib/X11fonts/miscディレクトリに格納されているフォントファイルを指定されたディレクトリにコピーします。

＜コピーするフォントファイル＞

12x24rk.pcf.gz（半角文字用フォントファイル）

jiskan24.pcf.gz（全角文字用フォントファイル）

＜コピー先ディレクトリ＞

/usr/lib/X11/fonts/hitachi

（XMAP3 Serverインストール時に生成されます）

文字フォントファイルを解凍します。
1.でコピーした文字フォントファイルを，gzipコマンドを使って解凍してください。正しく解凍できると，ファイル名の末尾の「.gz」がなくなったファイル名称になり，ファイルサイズも大きくなります。

＜コマンドの形式＞

gzip -d フォントファイル名

(3)　Solarisでの文字フォントファイルの準備

次の手順に従って，準備してください。

/usr/openwin/lib/X11/fonts/miscディレクトリに格納されているフォントファイルを指定されたディレクトリにコピーします。

＜コピーするフォントファイル＞

12x24rk.pcf.Z（半角文字用フォントファイル）

jiskan24.pcf.Z（全角文字用フォントファイル）

＜コピー先ディレクトリ＞

/usr/openwin/lib/X11/fonts/hitachi

（XMAP3 Serverインストール時に生成されます）

文字フォントファイルを解凍します。
1.でコピーした文字フォントファイルを，uncompressコマンドを使って解凍してください。正しく解凍できると，ファイル名の末尾の「.Z」がなくなったファイル名称になり，ファイルサイズも大きくなります。

＜コマンドの形式＞

uncompress フォントファイル名

7.13.2　注意事項

プレプリント帳票を印刷する場合には，あらかじめ，フォントの準備をしておかないとプレプリント帳票の文字が印字されません。

プレプリント帳票で外字を印字する場合には，フォントの設定のほかに，外字の設定が必要になります。外字の設定については「7.14　外字の設定（AIX，HP-UX）」を参照してください。

7.14　外字の設定（AIX，HP-UX）

＜この節の構成＞

7.14.1　外字マッピングファイルの標準値

7.14.2　AIX用外字の定義と登録

7.14.3　HP-UX用外字の作成と登録

7.14.4　シフトJISで利用できる文字の範囲

7.14.1　外字マッピングファイルの標準値

XMAP3 Serverは，コード変換で使用する外字マッピングファイルを提供します。外字マッピングファイルには，KEISコードとシフトJIS外字コードのマッピング（対応づけ）テーブルが設定してあります。XMAP3 Serverが提供する外字マッピングファイルは，XMAP3 Serverの標準値です。

＜この項の構成＞

(1)　ファイル名

(2)　テーブルの内容

(1)　ファイル名

外字マッピングファイル名称は，次のとおりです。

/usr/lib/X11/fonts/hitachi/cnv_map_tbl

(2)　テーブルの内容

外字マッピングテーブルは，KEISコードとシフトJIS外字コードが1対1に対応しています。XMAP3 Serverの外字マッピングテーブルの標準値を，図7-16に示します。

図7-16　XMAP3 Serverの外字マッピングテーブルの標準値

注意事項

XMAP3 Serverのインストール時，/usr/lib/X11/fonts/hitachi/cnv_map_tbl ファイルがすでにある場合は，XMAP3 Serverの外字マッピングファイルのインストールをしません。

また，XMAP3 ServerでサポートしているKEIS外字コードの範囲は，ユーザ定義文字領域81nn～A0nn（nnはA1～FEの範囲）です。ただし，図7-16に示すとおり，シフトJIS外字とのマッピング上の標準値は，81nn～9Annの範囲で設定されています。

7.14.2　AIX用外字の定義と登録

XMAP3 Serverのスタンドアロン環境で外字を印刷するためには，あらかじめ，必要な外字パターンを定義して，指定されたディレクトリに登録する必要があります。ここでは，AIX用外字の定義と登録の方法について説明します。

＜この項の構成＞

(1)　外字パターンの定義

(2)　外字ファイルの登録

(3)　フォントマッピングの関係

(1)　外字パターンの定義

AIXが提供する外字用ユティリティツール「fontutil」を使用して外字パターンを定義します。外字登録方法の詳細については，IBM社発行のマニュアルを参照してください。

ここでは，外字定義の概要を説明します。次の手順で定義してください。

外字用ユティリティツールを次のコマンドで起動します。

/usr/bin/X11/fontutil

外字用ユティリティツールを起動すると次のウィンドウが表示されます。

外字パターンを登録するフォントを読み込みます。
登録する外字ファイルは，帳票印刷時に印字する文字サイズに応じて異なりますので，必要に応じて下表に示す外字ファイルを読み込んでください。
ディレクトリ：/usr/lib/X11/fonts/

文字サイズ
サイズ
ファイル名
論理フォント名

5ポイント
16ドット
IBM_JPN12C.pcf.Z
-ibm_aix-gothic-medium-r-normal--16-120-100-100-m-160-ibm-udcjp

7ポイント
9ポイント
12ポイント
14ポイント
24ドット
IBM_JPN17C.pcf.Z
-ibm_aix-mincho-medium-r-normal--24-170-100-100-m-240-ibm-udcjp

上記フォントファイルには，標準でIBM拡張文字も含んでいます。

フォントユティリティのメニューの「拡張」を選択し，編集する文字コードを「PC（SJIS）」を選択します。

シフトJISコードで定義したい文字コード範囲（シフトJISの外字範囲は0xF040～）を横スクロールバーでウィンドウ部に表示します。

［編集］ボタンをクリックし，パターンを定義したい特定の文字コードをクリックします。
編集ウィンドウ画面「ラスタエディタ」が表示されるので，必要に応じて外字パターンを編集します。

パターンの編集が完了したら，メニューバーの「エントリ」中の「イメージ・エントリ」を選択して登録したい外字コードであることを確認後，［了解］を押してください。
フォントユティリティ画面の登録した外字コード部に外字パターンが定義されます。このイメージ・エントリの編集画面を終了する場合には，メニューバーから「終了」を選択してください。フォントユティリティ画面に戻ります。

すべての文字パターンの定義が完了したら，フォントユティリティ画面のメニューバー「ファイル」中の「保存」を選択後，格納する外字ファイルを選択してください。
このとき格納する外字ファイルは，最初に読み込んだ外字ファイルと同じファイルにしてください。

(2)　外字ファイルの登録

定義した外字ファイルをXMAP3のスタンドアロン帳票印刷時に使用するために，外字ファイルを次の手順で登録します。

外字パターンを定義した外字ファイル（IBM_JPN12C.pcf.ZおよびIBM_JPN17C.pcf.Z）を，次のディレクトリにコピーします。
なお，印字する文字サイズに関係なく必ず両方の外字ファイル（IBM_JPN12C.pcf.ZおよびIBM_JPN17C.pcf.Z）をコピーしてください。

次に示すコマンドで，格納した外字ファイルを解凍します。

正しく解凍できたら，ファイル名称の末尾の「.Z」がなくなったファイル名称になり，ファイルサイズも大きくなります。

(3)　フォントマッピングの関係

スタンドアロン構成で外字として利用できる領域の文字コードの対応（区点コード，シフトJIS，KEISコード）を次に示します。

表7-33　文字コードの対応表（AIX）

区点コード | シフトJIS | KEIS
95区01点～95区94点 | 0xf040～0xf09e | 0x81a1～0x81fe
96区01点～96区94点 | 0xf09f～0xf0fc | 0x82a1～0x82fe
97区01点～97区94点 | 0xf140～0xf19e | 0x83a1～0x83fe
: | : | :
103区01点～103区94点 | 0xf440～0xf49e | 0x89a1～0x89fe
104区01点～104区94点 | 0xf49f～0xf4fc | 0x8aa1～0x8afe
: | : | :
114区01点～114区94点 | 0xf99f～0xf9fc | 0x94a1～0x94fe

注1　

シフトJISの「0x**7FF」には定義できません。

注2　

シフトJISコード0xFA40～には，あらかじめIBM拡張文字セットが定義されているので，この領域には外字の定義をしないでください。

7.14.3　HP-UX用外字の作成と登録

HP-UX上のスタンドアロン印刷でサポートする文字コードは，シフトJISだけです。外字を利用する場合には，あらかじめ，次に示す外字の環境設定で，必要な外字を登録しておく必要があります。

なお，外字登録方法の詳細については，ヒューレットパッカード社発行のマニュアルを参照してください。

＜この項の構成＞

(1)　外字パターンの定義

(2)　UDCファイルの既存フォントへのマージ

(3)　注意事項

(1)　外字パターンの定義

HP-UXで外字を扱う際は，外字パターンをいったんUDCファイルと呼ばれる形式のファイルに格納してから，既存のフォントに外字パターンをマージして使用します。

外字パターンの定義は，HP-UXのX Window Systemに付属しているUDCエディタを使用します。

ここでは，外字定義の概要を説明します。次の手順で定義してください。

次のコマンドを実行してUDCエディタを起動します。

% xudced△UDCファイル名△幅x高さ

（例）16ドット×16ドットのUDCファイルgai16.udcを作成する場合

　　% xudced△gai16.udc△16x16

UDCエディタを起動すると，シフトJIS用（JIS X 0208と表示される）とEUC用（JIS X 0212と表示される）の2枚の編集ウィンドウが表示されますが，EUC用の編集ウィンドウは使用しないため，閉じてください。

編集ウィンドウで，外字を登録したいコードをスクロールウィンドウ内から選択します。
登録する外字のコードは区点コードになります。下記の画面では，95区01点に外字が登録されています。

区点コードとKEISコードおよびシフトJISの外字コードの対応を次に示します。

表7-34　文字コードの対応表（HP-UX）

区点コード
シフトJIS
KEIS

95区01点～95区94点
0xf040～0xf09e
0x81a1～0x81fe

96区01点～96区94点
0xf09f～0xf0fc
0x82a1～0x82fe

97区01点～97区94点
0xf140～0xf19e
0x83a1～0x83fe

：
：
：
：
：
：

118区01点～118区94点
0xfb9f～0xfbfc
0x98a1～0x98fe

119区01点～119区94点
0xfc40～0xfc9e
0x99a1～0x99fe

120区01点～120区94点
0xfc9f～0xfcfc
0x9aa1～0x9afe

120区01点～120区94点
0xfc9f～0xfcfc
0x9aa1～0x9afe

注　シフトJISの「0x**7d」には，定義できません。

「Edit」メニューの「Modify pattern...」を選択します。
ビットマップエディタが表示されるので，必要に応じて外字パターンを編集します。

ビットマップエディタの「Save」メニューで文字パターンを保存し，「Quit」メニューで終了します。
UDCエディタ側に作成した文字パターンが反映されます。

UDCエディタの「Save」メニューで外字パターンを保存してから，UDCエディタを終了します。

(2)　UDCファイルの既存フォントへのマージ

外字を定義したら，定義した外字パターンを既存のフォントファイル（PCFファイル形式）にマージします。

マージ処理は，udccコマンドを使用します。

udccコマンドの書式を次に示します。

% udcc△-m△入力元PCFファイル名△UDCファイル名 > 出力先PCFファイル名

（例）XMAP3で使用する16ドット×16ドットの漢字フォントに対してUDCファイルgai16.udcをマージした外字フォントファイルを，/tmpディレクトリに作成する場合

% udcc△-m△/usr/lib/X11/fonts/hp_japanese/100dpi/got16k.pcf△gai16.udc >
/tmp/got16k.pcf

帳票印刷で外字の印字を行う場合の，マップ帳票，書式オーバレイおよび行データにて指定した文字サイズと，XMAP3が外字出力時に読み込みを行う漢字フォントのPCFファイル名および論理フォント名称の，それぞれの対応を次の表に示します。

表7-35　文字サイズ，漢字フォントのPCFファイル名および論理フォント名称の対応

文字サイズ
フォント
ドット数
フォントファイルパス

ページ※1
シリアル※2
論理フォント名称

5
ポイント
－
16×16
/usr/lib/X11/fonts/hp_japanese/100dpi/got16k.pcf

-hp-gothic-medium-r-normal--16-116-100-100-c-160-
jisx0208.1983-0

7
ポイント
9
ポイント
24×24
/usr/lib/X11/fonts/hp_japanese/100dpi/min24k.pcf

-hp-mincho-medium-r-normal--24-173-100-100-c-240-
jisx0208.1983-0

9
ポイント
－
32×32
/usr/lib/X11/fonts/hp_japanese/100dpi/gai32.pcf

-hp-mincho-medium-r-normal-gai32c-32-232-100-100-c-320-
jisx0208.1990-0

12
ポイント
－
40×40
/usr/lib/X11/fonts/hp_japanese/100dpi/gai40.pcf

-hp-mincho-medium-r-normal-gai40c-40-288-100-100-c-400-
jisx0208.1990-0

14
ポイント
－
48×48
/usr/lib/X11/fonts/hp_japanese/100dpi/gai48.pcf

-hp-mincho-medium-r-normal-gai48c-48-346-100-100-c-480-
jisx0208.1990-0

（凡例）

－：該当なし

注※1

ページプリンタ（LIPS，PostScript）に対する，網掛け帳票，グラフィック帳票および書式オーバレイ中の文字サイズ

注※2

シリアルインパクトプリンタ（ESC/P）に対する，けい線帳票およびプレプリント帳票中の文字サイズ

外字ファイルを作成する時は，UDCエディタで作成した，それぞれのドットの外字パターンと，そのドットに対応するフォントファイルパスに記載されたPCFファイルのマージをしてください。

なお，got16k.pcf（16ドット用）およびmin24k.pcf（24ドット用）のPCFファイルは，HP-UXが標準で用意しています。gai32.pcf（32ドット用），gai40.pcf（40ドット用）およびgai48.pcf（48ドット用）のPCFファイルについては，外字が定義されていないものを，/opt/HIXMAP/lib/fontsディレクトリ下に提供していますので，/usr/lib/X11/fonts/hp_japanese/100dpiディレクトリ下にコピーして外字のマージをしてください。

(3)　注意事項

UDCエディタを使用すると，区点コード1区～94区の間にも文字パターンを定義できますが，この領域は内字コード領域とJIS X 0208の保留領域（9～15区，85～94区）の領域のため，この領域に文字が定義された場合，元のフォントに定義されている文字情報が上書きされますので，区点コード1区～94区への定義はしないでください。

UDCエディタで作成した32ドットフォント，40ドットフォントおよび48ドットフォントは，必ずXMAP3が提供しているPCFフォントとマージして使用してください。

7.14.4　シフトJISで利用できる文字の範囲

シフトJISコード範囲には，一般にベンダ固有文字と呼ばれる文字範囲があります。ここでは，XMAP3を使用した場合に利用できる文字の範囲を示します。

(a)　クライアントPCとのC/S構成の場合

クライアントPCとのC/S構成で画面表示や帳票印刷を行う場合，Windows特殊文字（0x8740～0x879C），NEC選定IBM拡張文字（0xED40～0xEEFC）およびIBM拡張文字（0xFA40～0xFC4B）の文字は利用できます。ただし，PC環境によっては文字コードに対応する文字形状が異なる場合があるため，外字登録して使用することをお勧めします。

(b)　スタンドアロン構成の場合

スタンドアロン構成でサーバから帳票印刷を行う場合，Windows特殊文字（0x8740～0x879C），NEC選定IBM拡張文字（0xED40～0xEEFC）は印刷できません。これらの文字を印刷したい場合には必ず外字登録して利用してください。また，IBM拡張文字（0xFA40～0xFC4B）は，AIXの場合だけ，「7.14.2　AIX用外字の定義と登録」に従って外字ファイルを所定のディレクトリに登録することで印刷できます。ただし，PCとのC/S構成と併用する場合は，PC側と利用する文字コードを統一する必要があるため，外字登録して使用することをお勧めします。

7.15　PDFファイル出力に関連する設定と注意事項（AIX，HP-UX，Solaris）

この節では，クライアントPCとのC/S構成で帳票をPDFファイル形式で出力するために必要な，表示・印刷環境ファイル（XPWconfig）のパラメタの設定方法と注意事項について説明します。

＜この節の構成＞

7.15.1　PDFファイルの出力先

7.15.2　PDFファイル出力後のプログラム起動

7.15.3　PDFファイルの圧縮

7.15.4　注意事項

7.15.1　PDFファイルの出力先

PDFファイルの出力先を指定するには，表示・印刷環境ファイルに次のパラメタを設定します。

印刷サービス名.PCFPTH=フォルダのパス名

フォルダ名に指定できるのは，クライアント側PCのフォルダになります。なお，このパラメタの設定を省略した場合，次に示すクライアント側のフォルダがPDFファイルの出力先となります。

XMAP3のインストールフォルダ ¥User¥Pdf

7.15.2　PDFファイル出力後のプログラム起動

PDFファイルを出力したあとに，任意のプログラムを起動したい場合は，表示・印刷環境ファイルに次のパラメタを設定します。

印刷サービス名.PCPAPP=起動したいプログラムのパス名

このパラメタに指定できるプログラムは，クライアント側PCにインストールされていて，かつクライアント側PCで実行できるプログラムです。なお，このパラメタの指定を省略した場合，プログラムの起動は実行されません。

7.15.3　PDFファイルの圧縮

出力するPDFファイルを圧縮するかどうか指定したい場合は，表示・印刷環境ファイルに次のパラメタを設定します。

印刷サービス名.PCPDCM=〔ON｜OFF〕

設定値にONを指定した場合，PDFファイルが圧縮されて出力されます。また，OFFを指定した場合，PDFファイルが圧縮されないで出力されます。なお，このパラメタの設定を省略した場合，または設定値が誤っている場合は，ONが仮定されます。出力されたPDFファイルを調査する必要がある，といった場合などを除き，通常は設定値をON（PDFファイルを圧縮する）にして運用してください。

7.15.4　注意事項

クライアントとのC/S構成で，スプール書き出し単位を「アプリケーション毎」に設定したPDFファイル出力用の印刷サービスに対して印刷を実行すると，出力した複数ページの帳票を一つのPDFファイルとして生成できます。このとき，サーバAPで実行したクローズ要求は，クライアント側でのPDFファイルの生成を待ってリターンします。

そのため，一つのPDFファイルに大量の帳票を印刷すると，クローズ要求に対するリターンに時間が掛かる場合があります。一つのPDFファイルに対して大量に帳票を印刷する場合には，業務に影響がないことをご確認いただき，必要に応じて一つのPDFファイルに印刷する帳票のページ数を影響がない範囲で分割するなどの運用をされることをお勧めします。

7.16　出力／固定グラフィック帳票をスタンドアロン構成で印刷する（HP-UX（PA-RISC），AIX）

この節では，XMAP3 Serverのスタンドアロン構成で，出力／固定グラフィック帳票を印刷する機能について説明します。

＜この節の構成＞

7.16.1　利用できるグラフィックデータの種類

7.16.2　前提となる印刷モード

7.16.3　帳票の作成方法

7.16.4　注意事項

7.16.1　利用できるグラフィックデータの種類

XMAP3 Serverのスタンドアロン構成で，出力／固定グラフィック帳票を印刷する場合は，次のグラフィックデータを出力グラフィックに指定できます。

Windowsビットマップ形式（*.bmp）

JPEGファイル（*.jpg）
JFIF準拠ベースライン形式（基本DCT方式のJFIF 01-01およびJFIF 01-02形式）だけ利用できます。

XMAP3 Serverのスタンドアロン構成で印刷できるグラフィックデータは，モノクロ（白黒2色）のグラフィックデータだけです。

XMAP3 Serverのスタンドアロン構成では，Windowsメタファイル（*.wmf）および拡張メタファイル（*.emf）は利用できません。

XMAP3 Serverのスタンドアロン構成で，利用できないグラフィックデータを指定した場合は，指定したグラフィックが破棄されて，印刷されます。

7.16.2　前提となる印刷モード

この機能をサポートする印刷モードを次に示します。

LIPSIII準拠ページプリンタ

PostScriptレベル2準拠ページプリンタまたはPostScriptレベル3準拠ページプリンタ

印刷モードを指定するには，表示・印刷環境ファイル（XPWconfig）に次のパラメタを設定します。

LIPSIII準拠ページプリンタを指定する場合

*.PCRPRT=LIPS, *.PCLIPS=3

PostScriptレベル2準拠ページプリンタまたはPostScriptレベル3準拠ページプリンタを指定する場合

*.PCRPRT=PostScript2

上記以外の印刷モードを指定した場合，指定したグラフィックが破棄されて，印刷が継続されます。

7.16.3　帳票の作成方法

PC XMAP3/Enterprise Edition Version 4を利用して，出力／固定グラフィックを指定したマップの生成を行います。

7.16.4　注意事項

XMAP3 Serverのスタンドアロン構成で印刷できるグラフィックデータは，モノクロ（白黒2色）のグラフィックデータだけです。カラーのグラフィックデータは，モノクロ（白黒2色）に変換した上で利用してください。

ユーザアプリケーションから出力ファイル名を設定する場合，出力グラフィックの論理項目の末尾に半角スペースが設定されていると，半角スペースは破棄されて処理されます。そのため，出力グラフィックファイルでは，末尾が半角スペースのファイル名は扱えません。

XMAP3 Serverのスタンドアロン構成で利用するグラフィックファイルを格納するディレクトリには，末尾が「¥」のディレクトリ名は使用できません。そのため，表示・印刷環境ファイル（XPWconfig）に設定するグラフィックファイルの読み込みパス（*.COGPTH）には，末尾が「¥」のディレクトリ名は指定しないでください。

7.17　JP1/NPS連携時に1ページごとにジョブを登録する（HP-UX（PA-RISC），AIX）

この節では，XMAP3 Serverのスタンドアロン構成で，JP1/NPSと連携して印刷するとき，1ページごとに，印刷ジョブをJP1キューに登録する機能について説明します。

＜この節の構成＞

7.17.1　JP1/NPS連携時に1ページごとにジョブを登録する機能の概要

7.17.2　注意事項

7.17.1　JP1/NPS連携時に1ページごとにジョブを登録する機能の概要

この機能では，上位APからのオープンまたはクローズのタイミングに関係なく，常に1ページの印刷指示ごとに，印刷ジョブをJP1のキューに登録できます。

この機能を使うと，用紙切れやプリンタの障害が発生したとき，JP1キューに蓄積されているジョブから再印刷の開始位置が判断されるため，ユーザが再印刷の開始位置を意識する必要はありません。

この機能を使用した場合の印刷動作を，次に示します。

図7-17　JP1/NPS連携時に1ページごとにジョブを登録する機能

この機能を利用するために前提となる環境は，次のとおりです。

XMAP3 Serverのスタンドアロン構成での帳票印刷時

JP1/NPS連携時（表示・印刷環境ファイル（XPWconfig）に「*.PCQRPX=ON」を設定した場合）

この機能を使う場合は，表示・印刷環境ファイル（XPWconfig）に次のパラメタを設定します。

印刷サービス名.PCFOCP=ON

7.17.2　注意事項

この機能をOLTP（TP1/NET/XMAP3）構成で利用する場合，複数のスレッドで印刷処理を実行すると，各スレッドの印刷処理が混ざって印刷されることがあります。そのときは，OpenTP1側の「メッセージグループ送信機能」を使って，それぞれのジョブが並行して印刷処理されないように工夫する必要があります。

この機能を，XMAP3 Serverのスタンドアロン構成またはPCとのC/S構成（OLTP構成以外のシステム構成）で利用する場合，マップドライバ環境定義ファイルのパラメタprintOutにasyncが指定されている環境で印刷するときは，印刷時またはクローズ時に，前回JP1キューに登録した帳票が印刷されます。アプリケーションからの印刷指示と同期させて帳票をキューに登録する場合は，マップドライバ環境定義ファイルのパラメタprintOutにsyncを指定してください。

この機能は，XMAP3 Serverのスタンドアロン構成でJP1/NPSと連携する場合だけ有効となり，PCとのC/S構成では無効となります。
サーバ側の表示・印刷環境ファイル（XPWconfig）に「*.COCLTCNF=ON」を設定した上で，クライアント側の表示・印刷環境ファイル（X3PCONF）に同じ設定をしても，サーバ側で動作する印刷サービスには影響しません。この機能を行う場合は，サーバ側の表示・印刷環境ファイル（XPWconfig）にサーバ側の印刷サービス名を指定して，直接追加してください。
サーバ側の表示・印刷環境ファイル（XPWconfig）に「*.COCLTCNF」を設定した上で，クライアント側の表示・印刷環境ファイル（X3PCONF）に同じ設定をすると，設定項目自体はXMAP3クライアント側で保持されますが，クライアント側の表示・印刷サービスでは，この設定項目は一切参照されないので，クライアント側の動作にも影響しません。

この機能は，「LPスプールシステムでの帳票一括出力機能」の設定（環境変数XPWCSTMWにONを設定した場合）には依存しません。

この機能を使う場合，JP1/NQSEXEC連携を有効にしたときは，「JP1/NPSでのセパレータ付加機能」について環境変数XPWQPRXに設定できる項目は，オープンからクローズまでに印刷したすべての印刷ジョブで，共通に適用されます。オープンからクローズの間に，この機能の設定項目は変更できません。変更する場合は，変更するタイミングでクローズして，環境変数の値を変更した上で，新たにオープンから印刷業務を行ってください。

7.18　ESC/Pプリンタでプリンタ任せの改ページ印刷をする（AIX）

この節では，XMAP3 ServerからESC/Pプリンタに印刷するときに，改ページ制御を，XMAP3 Serverではなくプリンタに行わせる機能について説明します。

＜この節の構成＞

7.18.1　ESC/Pプリンタでプリンタ任せの改ページ印刷をする機能の概要

7.18.1　ESC/Pプリンタでプリンタ任せの改ページ印刷をする機能の概要

この機能では，XMAP3 ServerからESC/Pプリンタに印刷するときに，印刷後または印刷前の改ページ制御を，プリンタに任せて実行させることができます。

この機能を使うと，XMAP3 Server以外のアプリケーションから印刷を実行したあと，プリンタヘッドが用紙の途中に位置づいている場合でも，プリンタによって改ページが実行されるため，XMAP3 Serverから印刷を実行しても正常な開始位置から印刷できます。

この機能を使う場合は，プリンタのハードウェアの設定に従って改ページ処理が実行されるため，改行命令ではなく改ページ命令が発行されます。この機能を使わない改ページ制御で発行される初期化命令（プリンタのページ先頭位置を設定する命令）およびJP1連携時に発行するページ長設定命令（プリンタのページ長を変更する命令）は，発行されません。

また，JP1連携時には，JP1/NPSがスプールデータの前後に初期化命令を付加するため，この機能によって十分なメインフレームとの互換性を確保することができません。

この機能を利用した場合の印刷前および印刷後の改ページ動作を次に示します。

印刷前の改ページ動作

印刷実行前にプリンタヘッドが途中に位置付いている場合，改ページ動作を行って，プリンタヘッドを正しい位置に移動させたあと，印刷を実行します。

印刷実行後は改ページ動作を行わないで，印字終了時点でプリンタヘッドが停止します。

印刷後の改ページ動作

印刷実行後，次の印刷開始位置までプリンタヘッドを移動させます。

印刷前に改ページ動作は行いません。

この機能は，XMAP3 Serverのスタンドアロン構成で印刷するときに利用できます。

この機能をサポートする印刷モードは，ESC/P J84準拠のページ記述言語を認識できる180dpiのシリアルプリンタまたはラインプリンタです。

印刷モードに，ESC/P J84準拠のページ記述言語を認識できる180dpiのシリアルプリンタまたはラインプリンタを指定するには，表示・印刷環境ファイル（XPWconfig）に次のパラメタを設定します。

印刷サービス名.PCRPRT=ESCP_D

7.19　論理ハードコピーを印刷する

OLTP構成では，論理ハードコピー機能を使用できます。論理ハードコピー機能を使用すると，CUI画面およびGUI画面のフィールドボックス中に配置した，文字，けい線などの画面オブジェクトを印刷できます。

論理ハードコピー機能の概要を次の図に示します。

図7-18　論理ハードコピー機能の概要

論理ハードコピー機能の対象画面とオブジェクトを次の表に示します。なお，GUI画面では，フィールドボックスが一つ配置してあるフィールドボックス中のオブジェクトだけが対象です。フィールドボックスが存在しない，または二つ以上配置されているGUI画面では利用できません。

表7-36　論理ハードコピー機能の対象画面とオブジェクト

対象画面
対象オブジェクト
備考

CUI画面
固定フィールド
－

出力フィールド
－

予約フィールド
－

入出力フィールド
－

けい線／矩形
－

GUI画面
固定フィールド
－

出力フィールド
－

出力日付フィールド
－

出力時刻フィールド
－

予約フィールド
－

入出力フィールド
使用目的にパスワードを設定していても，「＊」ではなく，入力した文字が印刷されます。

入出力日付フィールド／
入出力時刻フィールド
入力途中のデータは，論理ハードコピーを実行したときに表示書式の形式に編集されて，印刷されます。また，入力途中のデータの形式が不正のときは，オペレータインジケータにエラーメッセージが表示され，論理ハードコピーの印刷は実行されません。

固定ポップアップフィールド／
可変ポップアップフィールド
－

けい線／矩形
次の設定で印刷されます。

線の種類：実線

線の太さ：中

「線の位置」が中央に設定された線は，正しく印刷されません。

トグルフィールド

トグル種別に関係なく，チェックありの場合は全角文字の「1」，チェックなしの場合は全角文字の「0」に変換して印刷されます。

トグル色は黒色で印刷されます。

トグルフィールドの全体非表示は無効になり，表示された状態で印刷されます。

（凡例）

－：なし。

注

論理ハードコピーは，次に示す設定で印刷されます。

背景色：白

けい線の色：黒

文字色：黒

文字サイズ：標準

文字の書体：標準

文字の強調：標準

「文字だけ非表示」，「反転表示」属性の設定は無効になり，通常文字として印刷されます。また，画面の表示中に，印刷範囲内にカーソルが表示されていても印刷されません。

＜この節の構成＞

7.19.1　論理ハードコピー機能の操作

7.19.2　表示・印刷環境ファイル（XPWconfig）の設定

7.19.3　設定項目が有効となる印刷モード

7.19.4　論理ハードコピー機能を使用するときの注意

7.19.1　論理ハードコピー機能の操作

論理ハードコピー機能を使用するには，環境設定ファイルにパラメタを指定する必要があります。操作の準備から実行までの流れを次に説明します。

表示・印刷環境ファイル（XPWconfig）に，出力先プリンタ，用紙サイズなどの印刷設定をします。

対象とするXMAP3画面がアクティブになっている状態で，［Ctrl］+［P］キーを押します。
論理ハードコピーの印刷が実行されます。

7.19.2　表示・印刷環境ファイル（XPWconfig）の設定

論理ハードコピー機能を使用する前に，表示・印刷環境ファイル（XPWconfig）をテキストエディタで開き，設定項目を編集してください。

なお，表示・印刷環境ファイル（XPWconfig）は，次のディレクトリに格納されています。

/etc/opt/HIXMAP/

表示・印刷環境ファイル（XPWconfig）で，論理ハードコピー機能に関連する設定項目の一覧を次の表に示します。詳細については，「7.8.5　表示サービスに対する設定項目」または「7.8.6　印刷サービスに対する設定項目」を参照してください。

表7-37　表示・印刷環境ファイル（XPWconfig）で論理ハードコピー機能に関連する設定項目の一覧

設定項目 | ファイルでの記述形式
論理ハードコピー出力先の印刷サービス名 | 表示サービス名.DCPSNM=
論理ハードコピー用紙種別 | 印刷サービス名.PLPAKD=
論理ハードコピー用紙サイズ | 印刷サービス名.PLPASZ=
論理ハードコピー行ピッチ | 印刷サービス名.PLLNPC=
論理ハードコピー文字ピッチ | 印刷サービス名.PLCHPC=
論理ハードコピー用紙排出有無 | 印刷サービス名.PLPAOT=
論理ハードコピー用紙排出先 | 印刷サービス名.PLOTDR=
論理ハードコピー上マージン | 印刷サービス名.PLMGTP=
論理ハードコピー左マージン | 印刷サービス名.PLMGLF=

7.19.3　設定項目が有効となる印刷モード

論理ハードコピー機能の設定項目が有効となる印刷モードを次の表に示します。

表7-38　論理ハードコピー機能の設定項目が有効となる印刷モード

パラメタ
GDI※1
LIPS※2
ESC/P※3
PDF※4

論理ハードコピー出力先の印刷サービス名
（表示サービス名.DCPSNM=）
○
○
○
○

印刷サービス名.PLPAKD
（論理ハードコピー用紙種別）
×
×
○
×

印刷サービス名.PLPASZ
（論理ハードコピー用紙サイズ）
○
○
×
○

印刷サービス名.PLLNPC
（論理ハードコピー行ピッチ）
○
○
○
○

印刷サービス名.PLCHPC
（論理ハードコピー文字ピッチ）
○
○
○
○

印刷サービス名.PLPAOT
（論理ハードコピー用紙排出有無）
×
×
○
×

印刷サービス名.PLOTDR
（論理ハードコピー用紙排出先）
×
×
△※5
×

印刷サービス名.PLMGTP
（論理ハードコピー上マージン）
○
○
○
○

印刷サービス名.PLMGLF
（論理ハードコピー左マージン）
○
○
○
○

（凡例）

○：設定が有効となります。

△：条件によって異なります。

×：設定が無効となります。

注※1

次の印刷モードを示します。

GDI：ページプリンタ

GDI：シリアルインパクトプリンタ

日立FAXC/SPOOL出力：ページプリンタ

日立FAXC/SPOOL出力：シリアルインパクトプリンタ

注※2

次の印刷モードを示します。

PDLスルー：LIPS準拠ページプリンタ

注※3

次の印刷モードを示します。

PDLスルー：ESC/P準拠シリアルインパクトプリンタ

日立ESC/P（A）：用紙吸入量 0mmのインサータプリンタ

日立ESC/P（B）：用紙吸入量19mmのインサータプリンタ

注※4

次の印刷モードを示します。

PDFファイル出力：網掛け/グラフィック/書式用

注※5

印刷モードが「日立ESC/P（A）：用紙吸入量 0mmのインサータプリンタ」および「日立ESC/P（B）：用紙吸入量19mmのインサータプリンタ」の場合だけ有効となります。「PDLスルー：ESC/P準拠シリアルインパクトプリンタ」の場合は無効となります。

7.19.4　論理ハードコピー機能を使用するときの注意

論理ハードコピー機能を使用するときの注意を次に示します。

論理ハードコピー出力先の印刷サービス名（表示サービス名.DCPSNM=）に定義された印刷サービス名が有効になります。指定を省略すると，論理ハードコピー機能は利用できません。必ず指定してください。

印刷ドキュメント名は，プリンタへの出力の場合は「XMAP3」固定，PDFへの出力の場合は「画面のタイトル.pdf」固定です。

8.　運用・保守

この章では，XMAP3 Serverを使ったアプリケーションプログラムの実行からデバッグまでの運用と保守方法について説明します。

＜この章の構成＞

8.1　XMAP3サーバの起動

8.2　クラスタ構成でのXMAP3サーバおよびアプリケーションの起動（HP-UX（PA-RISC），AIX）

8.3　PC XMAP3クライアントの起動

8.4　ユーザアプリケーションプログラムの通信障害監視の設定

8.1　XMAP3サーバの起動

XMAP3サーバは，XMAP3システムで動作させる表示・印刷サービスを統合管理するサーバプロセスです。

XMAP3サーバは，XMAP3の表示・印刷サービスと，それらの表示・印刷サービスが動作する環境設定のすべてを管理します。このため，XMAP3サーバが動作するマシン上のサービス名ファイルおよび表示・印刷環境ファイルには，ネットワーク内のすべてのXMAP3表示・印刷サービスに関する指定をしてください。また，ネットワーク内のXMAP3クライアントの起動前に，XMAP3サーバを起動するようにしてください。

図8-1　XMAP3サーバがネットワークに一つだけある例

図8-2　XMAP3サーバがネットワーク上に複数ある例

XMAP3サーバ起動時に障害が発生した場合，次に示すメッセージが標準出力に出力され，syslogファイルに記録されます。

XMAP3サーバ起動時の障害メッセージ

KBXP5????-? xpwdaemon:メッセージ

注　「?」にはエラーの種別・部位を示す数字および記号が入ります。

障害メッセージについては，「9.8　XMAP3サーバが出力するメッセージ」を参照してください。

＜この節の構成＞

8.1.1　コマンド入力によってXMAP3サーバを起動する場合

8.1.2　XMAP3サーバを自動起動する場合

8.1.3　XMAP3サーバでの表示サービス/印刷サービスの障害監視設定

8.1.4　XMAP3サーバの複数起動

8.1.1　コマンド入力によってXMAP3サーバを起動する場合

次に示すコマンドを入力して，XMAP3サーバを起動します。起動時には引数に「-s」を必ず指定してください。

$ /opt/HIXMAP/bin/xpwdaemon -s &

また，XMAP3 Serverでは，XMAP3サーバ起動／停止シェルスクリプトを提供しています。次のように，起動／停止を実行してください。

XMAP3サーバの起動

/etc/opt/HIXMAP/xpwrc start

XMAP3サーバの停止

/etc/opt/HIXMAP/xpwrc stop

8.1.2　XMAP3サーバを自動起動する場合

WSの電源投入時にXMAP3サーバを自動起動しシャットダウン時に終了させる場合，XMAP3 Serverが提供するXMAP3サーバ起動／停止シェルスクリプトを，OSが準備する自動起動／停止用のディレクトリにコピーしてください。

次にAIXでの設定例を示します。

また，XMAP3サーバを起動する場合に環境変数などの設定を追加するときには，このコマンドを実行後，/etc/rc.d/rc2.d/S99xpwrc内の次の個所を修正してください。

8.1.3　XMAP3サーバでの表示サービス/印刷サービスの障害監視設定

表示サービスへ画面を表示したまま，または印刷サービスを起動したままなどの無通信の状態で，表示サービス／印刷サービス側でXMAP3サーバへ応答を返せない異常（停電やサーバ側が起動状態で再IPL操作をしたときなど）が発生した場合に備えて，障害監視時間を設定できます。

XMAP3 Serverは，監視時間内に表示サービス／印刷サービスから応答がなかった場合，障害が発生したものと判断して，XMAP3 Server上のユーザアプリケーションプログラムへ障害報告します。

＜この項の構成＞

(1)　障害監視時間の設定（XRESPONSETIME）

(2)　印刷サービスからの応答待ち時間の設定（XPCLOSEWAITTIME）

(1)　障害監視時間の設定（XRESPONSETIME）

障害監視時間は，次の環境変数で設定します。ただし，プリンタ端末クローズ時の印刷サービスからの応答待ち時間については，環境変数「XPCLOSEWAITTIME」で設定します。

環境変数名　XRESPONSETIME

環境変数に指定できる値は，0または25～300です。0を指定した場合，応答を監視しません。25～300を指定した場合，秒単位に指定された値をタイマとして応答を監視します。301以上の値が指定された場合，または値を省略した場合は，25を仮定し，応答を監視します。

(2)　印刷サービスからの応答待ち時間の設定（XPCLOSEWAITTIME）

プリンタ端末クローズ時にクライアント側のXMAP3印刷サービスからの応答待ち時間は，次の環境変数で設定します。

環境変数名　XPCLOSEWAITTIME

プリンタ端末クローズ時に通信が切断された場合など，クライアント側からの応答が受信できない事象が発生したとき，この環境変数を設定していないと応答待ちの状態が解除されません。帳票を印刷するシステムでは，この環境変数を設定することを推奨します。

環境変数に指定できる値は，0または25～86400です。0を指定した場合，応答を監視しません。25～86400を指定した場合，秒単位に指定された値をタイマとして応答を監視します。1～24，および86401以上の値が指定された場合，または値を省略した場合は，0を仮定し，応答を監視しません。

OpenTP1を利用したC/S構成で設定する場合，OpenTP1のシステム環境定義system_terminate_watch_timeオペランドの指定値を超えない時間を設定してください。

環境変数の設定例を次に示します。

（例）XRESPONSETIMEで100秒のタイマを設定します。

（Cシェル）

% setenv XRESPONSETIME 100
% /opt/HIXMAP/bin/xpwdaemon -s &   ←XMAP3サーバの起動

（Bourneシェル）

$ XRESPONSETIME=100
$ export XRESPONSETIME
$ /opt/HIXMAP/bin/xpwdaemon -s &   ←XMAP3サーバの起動

8.1.4　XMAP3サーバの複数起動

1台のホスト上で複数のXMAP3サーバを起動させるには，XMAP3サーバごとに，servicesファイルのサービス名（ポート番号），サービス名ファイルおよび表示・印刷環境ファイルを割り当てます。

なお，この機能は，1台のホスト上で複数の業務を負荷分散をする場合や，台数が少ないホスト構成で，複数の業務をする場合に使用します。

＜この項の構成＞

(1)　XMAP3サーバの複数起動の設定

(1)　XMAP3サーバの複数起動の設定

(a)　サービス名（ポート番号）の割り当て

複数起動させるXMAP3サーバに対して，ホスト上のservicesファイルのudpおよびtcpに，ユニークなサービス名（ポート番号）を割り当てます。

また，XMAP3クライアントを起動するPC上のservicesファイルのudpおよびtcpには，接続するXMAP3サーバに割り当てたサービス名（ポート番号）を設定します。

(b)　環境変数（XPW_DAEMON_PORT_NO）の設定

XMAP3サーバとリンクしたアプリケーションプログラムのプロセスが，表示・印刷サービスへサービス要求できるように，アプリケーションプログラムとXMAP3サーバのサービス名（ポート番号）を合わせる設定をします。

XMAP3サーバを起動させるコマンドの前に，XMAP3サーバに割り当てたポート番号に対応するサービス名を設定します。また，アプリケーションプログラムが動作する環境で，環境変数として，「XPW_DAEMON_PORT_NO」を設定します。次に「XPW_DAEMON_PORT_NO」の設定例を示します。

(c)　サービス名（ポート番号），サービス名ファイルおよび表示・印刷環境ファイルの割り当て

1台のホスト上で，おのおののXMAP3サーバにサービス名（ポート番号），サービス名ファイル，表示・印刷環境ファイルを割り当てます。

-servicesオプションの設定
おのおののXMAP3サーバの-servicesオプションに，使用するポート番号に対応するサービス名を指定します。
次に「-servicesオプション」の設定例を示します。

使用するサービス名は，システム上でそれぞれユニークにしてください。

サービス名を指定しない場合は，オプション指定エラーとして，次のエラーメッセージが標準出力されます。
「xpwdaemon：サービス名is not defind(/etc/services)」

-xオプションの設定
おのおののXMAP3サーバの-xオプションに，サービス名ファイルを割り当てます。デフォルトは，インストール時に提供しているサービス名ファイルが設定してあります。次に「-xオプション」の設定例を示します。

このオプションを指定した場合，デフォルトのサービス名ファイルは必要ありません。

読み込むサービス名ファイル中のXMAP3表示または印刷サービス名称は，重複しないようにしてください。

-cオプションの設定
おのおののXMAP3サーバの-cオプションに，表示・印刷環境ファイルを割り当てます。デフォルトは，インストール時に提供している表示・印刷環境ファイルが設定してあります。次に「-cオプション」の設定例を示します。

このオプションを指定した場合，デフォルトの表示・印刷環境ファイルは必要ありません。

(d)　XMAP3サーバの起動

XMAP3サーバに割り当てたパラメタを指定して，XMAP3サーバを起動し，XMAP3クライアントを起動します。

＜説明＞

XMAP3 Serverサーバが起動するホスト上のservicesファイルのポート番号と，XMAP3クライアントが起動するホスト上のservicesファイルのポート番号をあわせます。

アプリケーションプログラムとXMAP3サーバの起動前に，XMAP3サーバを起動させるポート名を環境変数で指定します。

任意のサービス名ファイルを作成します。

パラメタを指定してXMAP3サーバを起動すると，Serviceファイルで定義されたポート番号，サービス名ファイルが，それぞれのXMAP3 Serverサーバに割り当てられます。

XMAP3クライアントが，XMAP3サーバと同一ポート番号で接続し，表示・印刷サービスが起動します。

アプリケーションプログラムが，表示・印刷サービスへ入出力を要求します。

(e)　XMAP3サーバの停止

起動済みのXMAP3サーバのプロセスIDを調査し，停止してください。サービス名「xpex1」のXMAP3サーバを停止する場合の実行例を次に示します。

8.2　クラスタ構成でのXMAP3サーバおよびアプリケーションの起動（HP-UX（PA-RISC），AIX）

この節では，クラスタ構成で，XMAP3サーバを起動する方法について説明します。

＜この節の構成＞

8.2.1　XMAP3サーバの起動と停止

8.2.2　アプリケーションの起動

8.2.3　注意事項

8.2.1　XMAP3サーバの起動と停止

＜この項の構成＞

(1)　XMAP3サーバ起動前の設定

(2)　XMAP3サーバの起動

(3)　XMAP3サーバの停止

(1)　XMAP3サーバ起動前の設定

XMAP3サーバを起動する前に，次の環境変数に動作する仮想ホスト名を設定します。

環境変数名　XMAPserv_VirtualHost

環境変数は，次のように設定します。

(a)　BourneシェルまたはKornシェルの場合

(b)　Cシェルの場合

(2)　XMAP3サーバの起動

次に示すコマンドを入力して，XMAP3サーバを起動します。

/opt/HIXMAP/bin/xpwdaemon -vh 仮想ホスト名 -s &

起動時には，引数に「-vh 仮想ホスト名」を付けて，XMAP3サーバが動作する仮想ホスト名を指定します。省略すると，XMAP3サーバは物理ホストで動作するため，クラスタ構成では動作させられません。

XMAP3サーバ起動時に指定する引数は，「-vh」を含めて，順不同に指定できます。

(3)　XMAP3サーバの停止

クラスタ構成の環境で，系切り替えが発生した場合は，すでに起動しているXMAP3サーバを停止する必要があります。次に示すコマンドを実行して，XMAP3サーバを停止してください。

/etc/opt/HIXMAP/xpwstopvh 仮想ホスト名

このコマンドでは，コマンド実行時に指定した仮想ホストで起動されたXMAP3サーバを停止します。

8.2.2　アプリケーションの起動

アプリケーションを起動する前に，環境変数「XMAPserv_VirtualHost」に仮想ホスト名を設定します。

なお，サービス名ファイル（XPWhosts）のAPパス名に指定して，表示・印刷サービスの起動に連動してアプリケーションを起動する場合は，XMAP3サーバ起動前に設定した環境変数「XMAPserv_VirtualHost」が引き継がれます。

また，TP1/NET/XMAP3環境で環境変数を扱う場合は，OpenTP1での設定方法を確認してください。

8.2.3　注意事項

コマンドを入力してXMAP3サーバを起動する場合，「-vh 仮想ホスト名」で仮想ホスト名を指定して起動するときは，仮想ホスト名を指定しないXMAP3サーバを同時に起動しないでください。

系切り替えが発生した場合は，起動中のXMAP3サーバを停止させた後に，切り替えてください。

系切り替えが発生した場合，XMAP3サーバを再起動すると，XMAP3クライアントからの接続要求で，サービス名ファイル（XPWhosts）に設定されたAP自動起動によって，アプリケーションプログラムが起動します。
この場合，切り替え前のアプリケーションプログラムが起動されたままになっていると，クライアント上に画面が表示されたままとなり，二つの画面が表示されます。同じアプリケーションプログラムの画面を複数表示したくない場合は，アプリケーションプログラムを終了させてから，切り替えてください。

クラスタ構成の場合も，NATやDHCP環境では，XMAP3サーバは使えません。

クラスタ機能をサポートするミドルウェア製品の仕様によっては，クラスタ環境で物理ホストを使えないことがあります。

8.3　PC XMAP3クライアントの起動

マップドライバを使った場合のXMAP3クライアントを起動させる操作手順を次に示します。

WSおよびPCを起動します。

WS側でXMAP3サーバを起動します。

PC側でXMAP3クライアントのアイコンをダブルクリックします。

これ以降のXMAP3クライアント起動までの処理の流れを図8-3に示します。

図8-3　XMAP3クライアント起動までの処理の流れ

＜説明＞

XMAP3クライアントのアイコンをダブルクリックすることで，XMAP3クライアントが起動されます。

XMAP3クライアントは「Servicesファイル」からXMAP3 Serverのポート番号を求めて，XMAP3サーバと通信をします。

XMAPサーバは，「サービス名ファイル」から対応するAPホスト名称とAPパス名称を求めて，アプリケーションプログラムを起動します。

アプリケーションプログラム（マップドライバ）がXMAP3 Serverを経由してXMAP3クライアント配下の表示印刷サービスへの業務要求をします。

8.4　ユーザアプリケーションプログラムの通信障害監視の設定

クライアントPC上の表示サービスへ画面を表示したまま，または印刷サービスを起動したままなど無通信の状態で，表示サービス/印刷サービス側でユーザアプリケーションプログラムへ応答を返せない異常（停電やサーバ側が起動状態で再IPLしたときなど）が発生した場合に備えて，障害監視時間を設定できます。

XMAP3 Serverは，監視時間内に表示サービス/印刷サービスから応答がなかった場合，障害が発生したものと判断して，XMAP3 Server上のユーザアプリケーションプログラムへ障害報告します。

＜この節の構成＞

(1)　障害監視時間の設定（XRESPONSETIME）

(2)　印刷サービスからの応答待ち時間の設定（XPCLOSEWAITTIME）

(1)　障害監視時間の設定（XRESPONSETIME）

障害監視時間は，次の環境変数で設定します。ただし，プリンタ端末クローズ時の印刷サービスからの応答待ち時間については，環境変数「XPCLOSEWAITTIME」で設定します。

　環境変数名：XRESPONSETIME

環境変数に指定できる値は，0または25～300です。0を指定した場合，応答を監視しません。25～300を指定した場合，秒単位に指定された値をタイマとして応答を監視します。301以上の値が指定された場合，または値を省略した場合は，25を仮定し，応答を監視します。

(2)　印刷サービスからの応答待ち時間の設定（XPCLOSEWAITTIME）

プリンタ端末クローズ時にクライアント側のXMAP3印刷サービスからの応答待ち時間は，次の環境変数で設定します。

環境変数名　XPCLOSEWAITTIME

プリンタ端末クローズ時に通信が切断された場合など，クライアント側からの応答が受信できない事象が発生したとき，この環境変数を設定していないと応答待ちの状態が解除されません。帳票を印刷するシステムでは，この環境変数を設定することを推奨します。

環境変数に指定できる値は，0または25～86400です。0を指定した場合，応答を監視しません。25～86400を指定した場合，秒単位に指定された値をタイマとして応答を監視します。1～24，および86401以上の値が指定された場合，または値を省略した場合は，0を仮定し，応答を監視しません。

OpenTP1を利用したC/S構成で設定する場合，OpenTP1のシステム環境定義system_terminate_watch_timeオペランドの指定値を超えない時間を設定してください。

環境変数の設定例を次に示します。

（例）XRESPONSETIMEで100秒のタイマを設定します。

（Cシェル）

% setenv XRESPONSETIME 100
% sample1← ユーザアプリケーションのプログラムの起動

（Bourneシェル）

$ XRESPONSETIME=100
$ export XRESPONSETIME
$ sample1← ユーザアプリケーションのプログラムの起動

ユーザアプリケーションプログラムを自動起動する場合は，XMAP3 Serverを起動する前に，同一ユーザ（環境変数が引き継げる空間）で環境変数（XRESPONSETIME）と値を設定してください。

ユーザアプリケーションプログラムでの障害監視は，XMAP3 ServerとXMAP3表示・印刷サービス間のデータ送受信中での監視を対象とするものです。無通信状態を監視する機能ではありません。

9.　デバッグとチューニング

XMAP3 Serverを使用中に発生したトラブルの原因と対処方法について説明します。また，ログ情報の利用方法についても説明します。

＜この章の構成＞

9.1　トラブルの対処方法

9.2　ログ情報の利用方法

9.3　チューニング

9.4　AP実行時のXMAP3 Serverのリターンコード

9.5　取得する必要がある情報

9.6　要因別取得情報の一覧

9.7　AP実行時の詳細エラーコード

9.8　XMAP3サーバが出力するメッセージ

9.1　トラブルの対処方法

XMAP3 Serverのトラブルシューティングについて説明します。

＜この節の構成＞

9.1.1　コンパイル時のトラブルシューティング

9.1.2　XMAP3サーバ起動時のトラブルシューティング

9.1.3　AP実行時のトラブルシューティング

9.1.1　コンパイル時のトラブルシューティング

Q1

コンパイル時に，「KCCB1076C-S 原文名＊～＊に対応するファイルが存在しません。」というエラーメッセージが表示されます。

A1

環境変数「CBLLIB」の設定がないか，設定したディレクトリ下に原文名＊～＊に示される登録集原文ファイルがありません。原文名＊～＊に示される登録集原文ファイル（～.cbl）のあるディレクトリのパス名を「CBLLIB」に設定してください。例えば，動的変更用テーブル，論理マップが/XMAPUSER/userprog/copylibにある場合は次のように設定します。

CBLLIB=/XMAPUSER/userprog/copylib
export CBLLIB

Q2

コンパイル時に，「Unsatisfied Symbols: jsvwadrv(code)」というエラーメッセージが表示されます。

A2

ccblコマンドまたはccbl2002コマンドによるコンパイルでXMAP3 Serverのライブラリ設定（-lxpdrv）をしていません。-lxpdrvおよび-lxpwオプションを必ず指定してコンパイルしてください。

Q3

コンパイル時に，「Line n：KCCB1099C-U ソースファイルの形式に誤りがあります」というエラーメッセージが表示されます。

A3

ccblコマンドまたはccbl2002コマンドによるコンパイル時に使用する論理マップおよび動的変更テーブルが使用環境に合っていません。EUC環境で使用する場合は，EUCへのコード変換が必要です。詳細については，「4.5　論理マップおよび動的変更テーブルの文字コード変換（AIX，Linux，Solaris）」を参照してください。

9.1.2　XMAP3サーバ起動時のトラブルシューティング

Q1

xpwdaemonコマンド実行時に，「KBXP54100-E xpwdaemon: /etc/opt/HIXMAP/XPWhosts is empty.」というエラーメッセージが表示されます。

A1

XPWhostsの設定をしていません。「7.　XMAP3 Serverの環境設定」を参照して設定を済ませてからxpwdaemonコマンドで起動してください。

Q2

xpwdaemonコマンド実行時に，「KBXP50900-W xpwdaemon:cannot find ～'s service.」というエラーメッセージが表示されます。

A2

XPWhostsのホスト名が正しく設定されていません。ホスト名をエラーメッセージ中の「～」で示された名称に変更してください。また，「7.　XMAP3 Serverの環境設定」を参照して設定を済ませてからxpwdaemonコマンドで起動してください。ただし，自ホストでの印刷サービスを使用しない場合は，無視してかまいません。

Q3

xpwdaemonコマンドを実行し，ps -e | grep xpwでXMAP3サーバの起動を確認しましたが，XMAP3サーバが起動しません。

A3

/etc/servicesに次の設定がありません。

 xpw   8500/tcp
 xpw   8500/udp

設定してある場合は，「7.　XMAP3 Serverの環境設定」を参照してそのほかの実行環境の設定を済ませてから，XMAP3サーバをkillコマンドでいったん停止し，xpwdaemonコマンドで再起動してください。

9.1.3　AP実行時のトラブルシューティング

＜この項の構成＞

(1)　エラー終了の場合

(2)　画面のAP実行時の場合

(3)　帳票・書式の印刷時の問題

(1)　エラー終了の場合

Q1

日立COBOLのAPの実行時に，CD項のSTATUS KEY句からエラーコードが返りました。

A1

STATUS KEY句の実行状態コードと意味および対処方法を次に示します。

'00000'　正常終了

'00008'　論理エラー

対処：通信文の発行順序が不正です。SEND，RECEIVE，DISABLEの発行順序が誤っています。APの処理方式を見直して，正しい処理順序に修正してください。

'10004'　マッピングエラー

対処：日立COBOLが出力するメッセージKCCB5007R-S，またはKCCB5008R-Sの内容を調査してください。

原因としては次のことが考えられます。

カーソルまたはフォーカス位置に誤りがあります。APで設定している位置を確認してください。

MAPPING MODE句で指定した値に誤りがあります。「スペース」「0」「2」「3」など許されるパラメタをAPが設定しているか確認してください。

開発用XMAP3のバージョンと，実行用XMAP3 Serverのバージョンとを合わせてください。

'10008'　マッピングエラー

対処：日立COBOLが出力するメッセージKCCB5007R-S，またはKCCB5008R-Sの内容を調査してください。

APが設定したデータに誤りがあることが考えられます。詳細は，KCCB5008R-Sの「エラーコード」に表示されるコードを控え，「9.4　AP実行時のXMAP3 Serverのリターンコード」の「リターンコード詳細」から該当するエラーコードを探し，「エラー内容」の記述に従って対処してください。

'20008'　入出力エラー

対処：日立COBOLが出力するメッセージKCCB5007R-S，またはKCCB5008R-Sの内容を調査してください。

入出力時の障害の詳細は，KCCB5008R-Sの「エラーコード」に表示されるコードを控え，「9.4　AP実行時のXMAP3 Serverのリターンコード」の「リターンコード詳細」から該当するエラーコードを探し，「エラー内容」の記述に従って対処してください。

Q2

日立COBOLのAPの実行時に，「KCCB5007R-S/KCCB5040R-S入出力エラーが発生しました。プログラム名=行番号／欄=エラーコード=　」というエラーメッセージが表示されます。

A2

「9.4　AP実行時のXMAP3 Serverのリターンコード」の「リターンコード詳細」から該当するエラーコードを探し，「エラー内容」の記述に従って対処してください。

Q3

日立COBOLのAPの実行時に，「KCCB5008R-S/KCCB5042R-Sマッピングエラーが発生しました。プログラム名=行番号／欄=エラーコード=　」というエラーメッセージが表示されます。

A3

「9.4　AP実行時のXMAP3 Serverのリターンコード」の「リターンコード詳細」から該当するエラーコードを探し，「エラー内容」の記述に従って対処してください。

Q4

CALL命令に対して，jsvwadrv関数からエラーコード（0以外）が返りました。

A4

エラー時のXMAP-COMテーブル，またはログ情報からリターン情報詳細を取得してください。

XMAP-COMテーブルからリターン情報詳細を取得しない設定のAPの場合や，ログ取得の設定をしていないAPの場合は，ログ取得の設定をして再度APを実行してください。エラーを再現させ，リターン情報詳細を取得します。ログ情報の取得方法については，「9.2　ログ情報の利用方法」を参照してください。

取得したリターンコード詳細を控えて，「9.4　AP実行時のXMAP3 Serverのリターンコード」からエラーコードに対応する対処方法をとってください。

Q5

XMAPhosts，XMAPconfig，XPWhosts，hostsおよびservicesファイルの内容を修正しましたが，修正した情報が反映されません。

A5

XMAP3サーバを再起動していないことが考えられます。次の例を参考に，サーバプロセスを終了し再起動してください。

なお，XMAP3サーバを再起動した場合には，すでに接続されていたXMAP3クライアントもすべて再起動してください。

# ps -e | grep xpw           （XMAP3サーバの動作状況確認）
 1604 ?        0:00 xpwdaemon
 1611 ?        0:00 xpwprt
# kill 1604                  （XMAP3サーバの停止。xpwdaemonだけでよい）
# /opt/HIXMAP/bin/xpwdaemon -s &

(2)　画面のAP実行時の場合

(a)　動作に関する問題

Q1

二次ウィンドウが閉じません。

A1

次の点を見直してください。

二次ウィンドウ上に，二次ウィンドウを閉じる目的で作成したプッシュボタンのプッシュボタン定義ダイアログボックスで，「二次ウィンドウを閉じる」を指定してください。

一次ウィンドウの画面属性ダイアログで表示形態として「一部上書」を指定してください。

Q2

初期位置にフォーカスが位置づきません。

A2

フォーカス制御エリアを(00)₁₆でクリアしていないことが考えられます。APを見直してください。

Q3

APで指定した位置にフォーカスが位置づきません。

A3

次の点を見直してください。

フォーカス位置制御項目に指定した値が誤っていないかどうか
APを見直してください。

論理マップと物理マップの作成日付は一致しているかどうか
マップを再生成し，物理マップと論理マップを対応させてください。

カーソル位置項目とフォーカス位置制御項目の両方がある場合，片方だけに値を設定しているかどうか
この場合，カーソル位置項目とフォーカス位置制御項目は次に示すように使い分けてください。
《CUIフィールドボックスにカーソルを位置づけたいとき》
　　フォーカス位置制御項目とカーソル位置項目に値を指定します。
《そのほかのボックスにフォーカスを位置づけたいとき》
　　フォーカス位置制御項目に値を指定します。

Q4

入出力テキストにフォーカスが位置づきません。

A4

出力テキストで定義していないかどうか，定義内容を見直してください。

Q5

フォーカスは入出力テキストに位置づきますが入力できません。

A5

入出力テキスト定義ダイアログで指定する「表示方法」が「入力不可」になっています。定義内容を確認し，「入力可能」を指定してください。

Q6

ポップアップメニューで一度選んだメニューに，次の表示でカーソルが位置づきません。

A6

ポップアップメニュー上のデータ長とラベル長が一致していないことが考えられます。定数長と項目数を一致させて定義してください。

Q7

選んでもポップアップメニューが閉じません。

A7

フォーカスまたはカーソルの移動先となるほかのオブジェクトがないため，常にそのポップアップに位置づいています。そのままの状態で送信するか，またはポップアップメニュー定義ダイアログで使用目的に「手動」を指定してください。

Q8

キーボードがロックされているため入力できません。

A8

画面定義時に「キーボードのロック状態を解除する」を指定していないことが考えられます。この場合，直前の画面のキーボードロック状態は，次の画面に引き継がれます。

［Ctrl］+［R］でロック状態を解除してAPを終了したあと，PC XMAP3のドローでマップ定義ファイルを開き，画面属性ダイアログで「キーボードのロック状態を解除する」を指定してから，マップを再生成してください。

Q9

入力マッピングの結果が誤っています。

A9

次の点を見直してください。

論理マップを誤ってクリアしていないかどうか
APの内容を見直してください。

物理マップと論理マップの作成日付のうち一方だけを更新していないかどうか
物理マップと論理マップの作成日付は一致させてください。この場合，マップを再生成し，物理マップと論理マップを対応させてください。

COBOL言語のCALL文による送受信命令で使用するインタフェース領域を削除したり上書きしたりしていないかどうか
APを見直してください。

Q10

論理マップに設定した位置にカーソルが移動しません。

A10

スクロール固定領域にカーソルを移動しようとしました。APの内容を確認し，スクロール固定領域以外にカーソル位置を再設定してください。

Q11

PCとのC/S構成で，PCで［Enter］キーを押してもデータが送信されません。

A11

データ送信用の［Enter］キーを押していないことが考えられます。

［Enter］キーには，文字キー側の［Enter］キーとテンキー側の［Enter］キーとがあります。PC XMAP3の表示・印刷セットアップで，どちらを送信キーにしているか設定内容を確認してください。なお，標準値では，テンキー側の［Enter］キーが送信用，文字キー側の［Enter］キーは改行用です。

Q12

フィールドごとに送受信していて，キーOKになるのに時間が掛かります。

A12

2回目のマッピングでマッピングオプションを「マージ」または「物理マップだけ」にしていることが考えられます。APを見直しマッピングオプションを「論理マップだけ」にして，出力論理マップ中の再送不要なデータ部はデータ有無コードを設定してください。また，このときオブジェクトの属性定義ダイアログでの初期値に「指定しない」を指定し，画面属性ダイアログの「入力・選択状態の扱い」に「状態を維持」を指定してください。

Q13

プッシュボタンやPFキーを操作してもAPに制御が移りません。

A13

半角文字だけを入力できるテキストボックスに全角文字を入力したなど，入力データがオブジェクトの属性と合っていないことが考えられます。この場合，APには制御が移らないで，データ入力エラー状態となります。データを正しく修正してから，実行し直してください。なお，入力データが正しいかどうかはオペレータインジケータに表示されます。

(b)　表示結果の問題

Q1

画面が表示されません。

A1

次の点を確認してください。

ほかのウィンドウの後ろに隠れていないかどうか
ウィンドウを前面に移動してください。

ほかのAPですでに画面を表示していないかどうか
ほかのAPを終了して，再実行してください。

APでエラーが起きていないかどうか
SEND文，またはTRANSCEIVE文実行後のリターンコードを確認してください。

実際に表示できるサイズよりも大きなウィンドウを指定していないかどうか
定義内容を見直してください。

XMAP3 Serverで指定できる最大オブジェクト数を超えていないかどうか
オブジェクトの数を減らしてください。

画面表示・帳票出力時のリターンコードが「5120(1400)₁₆」の場合は，次の点を確認してください。

APに指定した物理マップの名称は正しいかどうか
物理マップの名称は，「マップ名＋物理マップの種類(例：GUI画面の場合はND)」にしてください。

PCからのマップ転送後，cmapcpコマンドで物理マップを利用可能な形式に変換しているかどうか
cmapcpコマンドで拡張子「.pmp」のない物理マップを作成する必要があります。

物理マップが正しいディレクトリに格納されているかどうか
通常，APを実行するには使用する物理マップを実行可能ファイルと同じディレクトリに用意する必要があります。なお，XMAP3 Serverの実行環境設定で別ディレクトリから物理マップを参照するようにカスタマイズしている場合（マップロードパスを指定している場合）には，そのディレクトリに物理マップがあるかどうかを確認してください。

ホスト名が一致しているかどうか
サービス名ファイル（XPWhosts），/etc/hostsファイルで指定しているホスト名を一致させてください。

Q2

画面が途中までしか表示されません。

A2

次の点を見直してください。

(20)₁₆以上の値をデータ有無コードとして使用していないかどうか
データ有無コードと文字コードの重複を避けてください。データ有無コードに(1F)₁₆以下の値を使用してください。

マップ生成時にエラーが発生したため，マップに誤りがないかどうか
マップ生成時のリターンコードとエラーメッセージを基に定義内容を見直してください。

外字フォントを正しく作成しているかどうか
外字フォントを見直してください。

論理マップ長エリアに論理マップの長さを正しく格納しているかどうか
論理マップと物理マップが対応しているか確認し，正しい論理マップの長さを格納してください。

出力論理マップをクリアしないで使ったため，出力論理マップ中に前の論理データが残っていないかどうか
APを見直し，出力論理マップをクリアしてください。

論理マップに格納したデータ内の文字コードが誤っていないかどうか
APを見直してください。

物理マップと論理マップを作成した日付が一致しているかどうか
一方を更新し忘れていないかどうか
マップ生成およびAPのコンパイルをし直してください。

XMAP3 Serverに誤った論理マップデータを渡していないかどうか
例えば，論理マップの名称が誤っている，または物理マップに対応した論理マップデータを渡していないなど。
物理マップと論理マップが対応しているかを確認し，APを見直してください。

先頭1文字がデータ有無コードになっていないかどうか
出力したいデータの前のデータ有無コードを削除してください。

PC XMAP3で実行環境と異なるターゲットを指定して生成した論理／物理マップをWSで使用していないかどうか
PC XMAP3で作成した論理／物理マップをWSに転送して利用する場合には，実行環境に合ったターゲットを指定したあと，マップ生成してください。

Q3

画面が崩れた状態で表示されます。

A3

(20)₁₆以上の値をデータ有無コードとして使用していないかどうか
データ有無コードと文字コードの重複を避けてください。データ有無コードに(1F)₁₆以下の値を使用してください。

マップ生成時にエラーが発生したため，マップに誤りがないかどうか
マップ生成時のリターンコードとエラーメッセージを基に定義内容を見直してください。

外字フォントを正しく作成しているかどうか
外字フォントを見直してください。

論理マップ長エリアに論理マップの長さを正しく格納しているかどうか
論理マップと物理マップが対応しているか確認し，正しい論理マップの長さを格納してください。

出力論理マップをクリアしないで使ったため，出力論理マップ中に前の論理データが残っていないかどうか
APを見直し，出力論理マップをクリアしてください。

論理マップに格納したデータ内の文字コードが誤っていないかどうか
APを見直してください。

物理マップと論理マップを作成した日付が一致しているかどうか
一方を更新し忘れていないかどうか
マップ生成およびAPのコンパイルをし直してください。

XMAP3 Serverに誤った論理マップデータを渡していないかどうか
例えば，論理マップの名称が誤っている，または物理マップに対応した論理マップデータを渡していないなど。
物理マップと論理マップが対応しているかを確認し，APを見直してください。

オブジェクトの属性情報が非表示になっていないかどうか
定義内容を見直してください。

先頭1文字がデータ有無コードになっていないかどうか
出力したいデータの前のデータ有無コードを削除してください。

PC XMAP3で実行環境と異なるターゲットを指定して生成した論理／物理マップをWSで使用していないかどうか
PC XMAP3で作成した論理／物理マップをWSに転送して利用する場合には，実行環境に合ったターゲットを指定したあと，マップ生成してください。

Q4

画面が一瞬だけ表示され，すぐに消えます。

A4

マップドライバの共通インタフェース領域に格納した入力論理マップ長は正しいか確認してください。誤っている場合は，物理マップに対応した入力論理マップの長さを正しく格納してください。

Q5

複数の画面が同時に表示されます。

A5

日立COBOLのAP中で複数の通信記述項を指定しています。つまり，複数のモジュールで通信記述項をそれぞれ定義しているにもかかわらず，AP実行時にCOBOLの環境変数「CBLTERMSHAR=YES」を指定していません。環境変数を設定するか，または共通モジュールで通信記述項を指定するようにAPを修正してください。

Q6

画面の表示位置が，指定した位置と異なります。

A6

定義で指定した位置と異なる場合は，次の点を確認してください。

一次ウィンドウに対して，常に直前のウィンドウと同じ位置に表示するオプションを指定していないかどうか
この場合，定義時に指定したウィンドウ位置は無視されます。指定した位置に表示するには，画面環境セットアップでオプションを変更してください。

操作者がウィンドウを移動していないかどうか
この場合，移動した位置に表示されます。

二次ウィンドウの画面定義ダイアログで指定したウィンドウ位置，またはウィンドウIDが異なっていないかどうか
定義を見直してください。

Q7

画面の表示位置が，直前の画面と異なります。

A7

二次ウィンドウの場合
二次ウィンドウの表示形態が「全面書換」となっていないか，または直前のマップと異なる二次ウィンドウを出力していないかを確認してください。また，定義時に指定したウィンドウID（識別番号）と一致しているかを確認してください。

一次ウィンドウの場合
実行プログラムが別のときは，ウィンドウ表示位置は保存されないため，定義上のウィンドウ位置に表示されます。同じプログラム内で表示をしてください。
同じプログラムの場合は，表示・印刷環境ファイル(XPWconfig)で，画面定義を優先してウィンドウ位置を決める設定がDCMPPS=ONになっていることが考えられます。設定をDCMPPS=OFFにしてください。

Q8

画面の表示位置が，マウス操作などで移動しても初期表示位置に戻ります。

A8

次の点を確認してください。

一次ウィンドウに対して，定義時のウィンドウ位置に表示するオプション(DCMPPS=ON)を指定していないかどうか
この場合，移動したウィンドウ位置は無視されます。表示・印刷環境ファイル(XPWconfig)でオプションを変更してください。

APで毎回画面をクローズしていないかどうか
一度画面をクローズすると，前回のウィンドウ位置は無効になります。

Q9

通常の場合と比べて画面の表示に時間が掛かります。

A9

次の点を確認してください。

ほかのAPが起動していないかどうか
業務に関係のないAPはなるべく起動しないでください。

1個のオブジェクトだけの表示を，全画面（デスクトップ画面に対して最大化）表示にしていないかどうか
マッピングモード，データ有無コードの設定を見直してください。

毎回画面をクローズしていないかどうか
DISABLE文の発行を見直してください。

毎回画面をオープンしていないかどうか
プログラムを分けて実行ファイルにしているとき，オープンをプログラム間で引き継ぐ指定をしているかを見直してください。

Q10

同じ画面を表示するときに画面がちらつきます。

A10

次の点を見直してください。

2回目以降の画面を表示する場合，上書きになっていないかどうか
日立COBOLの場合，CD句でMAPPING MODEを指定してないことが考えられます。APで変更したい項目のデータだけを論理マップにセットし，MAPPING MODEに「2」をセットしてSEND文を実行してください。

同じ画面を別のプログラムで表示していないかどうか
別のプログラムの場合は，直前に表示した画面の情報は引き継がれません。同じ画面は同じプログラム内で表示してください。

表示が不要な項目にスペースを送ったり，直前に表示したものと同じ内容を表示する場合に，同一データを送ったりしていないかどうか
表示データが指定されると必ず画面が描画されるため，ちらつきが発生します。表示が不要な部分は，データ有無コードをセットして表示してください。

Q11

オブジェクトが表示されません。

A11

次の点を確認してください。

(20)₁₆以上の値をデータ有無コードとして使用していないかどうか
データ有無コードと文字コードの重複を避けてください。データ有無コードに(1F)₁₆以下の値を使用してください。

マップ生成時にエラーが発生したため，マップに誤りがないかどうか
マップ生成時のリターンコードとエラーメッセージを基に定義内容を見直してください。

外字フォントを正しく作成しているかどうか
外字フォントを見直してください。

論理マップ長エリアに論理マップの長さを正しく格納しているかどうか
論理マップと物理マップが対応しているか確認し，正しい論理マップの長さを格納してください。

出力論理マップをクリアしないで使ったため，出力論理マップ中に前の論理データが残っていないかどうか
APを見直し，出力論理マップをクリアしてください。

論理マップに格納したデータ内の文字コードが誤っていないかどうか
APを見直してください。

物理マップと論理マップを作成した日付が一致しているかどうか
一方だけを更新していないかどうか
マップ生成およびAPのコンパイルをし直してください。

XMAP3 Serverに誤った論理マップデータを渡していないかどうか
例えば，論理マップの名称が誤っている，または物理マップに対応した論理マップデータを渡していないなど。
物理マップと論理マップが対応しているかを確認し，APを見直してください。

先頭1文字がデータ有無コードになっていないかどうか
出力したいデータの前のデータ有無コードを削除してください。

PC XMAP3で実行環境と異なるターゲットを指定して生成した論理／物理マップをWSで使用していないかどうか
PC XMAP3で作成した論理／物理マップをWSに転送して利用する場合には，実行環境に合ったターゲットを指定したあと，マップ生成してください。

Q12

オブジェクトの属性が正しく適用されません。

A12

次の点を見直してください。

《「文字色」などの表示属性が適用されない場合》

出力論理マップに対して入力用の属性を指定していないかどうか
APを見直してください。

属性の動的変更をする場合に，APが指定した修飾名と定義時の修飾名が一致しているかどうか
定義内容とAPの内容を確認し，修飾名を一致させてください。

《「右寄せ」の属性が適用されない（画面上で右寄せされない）場合》

入出力フィールドの文字列の最後に(20)₁₆が格納されていないかどうか
文字列の後ろをデータ有無コードでクリアしてください。

オブジェクトの属性定義ダイアログで，けた寄せ向きに「左」を指定していないかどうか
定義内容を確認し，けた寄せに「右」を指定してください。

《フィールド属性の「転送」が適用されない（表示データがAPに返されない）場合》

CD句のMAPPING MODEの記述を省略していないかどうか
省略した場合，2回目の表示時にXMAP3 Serverが転送モードをクリアします。したがって，MAPPING MODEは省略しないで，表示する画面に合った値を設定するようにしてください。

Q13

カーソルが表示されません。

A13

CUI画面で，カーソル色と背景色が同じであることが考えられます。表示・印刷環境ファイル(XPWconfig)で，実行環境の設定を確認してください。

Q14

ボタンのラベルが表示されません。

A14

次の点を見直してください。

背景色とボタンラベル色を同じ色にしていないかどうか
背景色，またはラベル色を変更してください。
可変ボタンの場合，論理テーブルに値を指定していないときは，AP中で論理テーブルにラベルデータを設定してください。
プッシュボタンの場合，ラベル色を変更してください。

ラベルに表示している文字列がスペースになっていないかどうか
スペース以外の文字を指定してください。

Q15

ボタンがオン状態で表示されません。

A15

次の点を見直してください。

画面定義で「選択済みにする」を指定しているかどうか
ボタン属性ダイアログで「選択済みにする」を指定してください。

動的変更で「選択済みにする」にしていない，または動的変更用の修飾名が誤っていないかどうか
「選択済みにする」を定義するか，転送の動的変更用修飾名を指定してください。

Q16

ボックス内にスクロールバーが表示されません。

A16

リストボックス，またはCUIフィールドボックス定義ダイアログでスクロールバー付加を指定していません。定義内容を見直してください。

Q17

アンダードット（...）が表示されません。

A17

表示・印刷機能の設定でアンダードット表示(DCUDOT=ON)を指定していません。表示・印刷環境ファイル(XPWconfig)の内容を見直してください。

Q18

可変ラジオボタン，または可変チェックボタンでラベルデータの後ろが表示されません。

A18

ラベルのデータ型に数字編集項目を指定していて，出力論理マップに設定されている長さよりラベル長の方が長いことが考えられます。出力数字編集項目以外の項目にするか，出力論理マップに設定されている長さに等しいラベルデータを指定してください。

Q19

文字が表示されません。

A19

次の点を確認してください。

(20)₁₆以上の値をデータ有無コードとして使用していないかどうか
データ有無コードと文字コードの重複を避けてください。データ有無コードに(1F)₁₆以下の値を使用してください。

マップ生成時にエラーが発生したため，マップに誤りがないかどうか
マップ生成時のリターンコードとエラーメッセージを基に定義内容を見直してください。

外字フォントを正しく作成しているかどうか
外字フォントを見直してください。

論理マップ長エリアに論理マップの長さを正しく格納しているかどうか
論理マップと物理マップが対応しているか確認し，正しい論理マップの長さを格納してください。

出力論理マップをクリアしないで使ったため，出力論理マップ中に前の論理データが残っていないかどうか
APを見直し，出力論理マップをクリアしてください。

論理マップに格納したデータに文字コードが誤っていないかどうか
APを見直してください。

物理マップと論理マップを作成した日付が一致しているかどうか
一方だけを更新していないかどうか
マップ生成およびAPのコンパイルをし直してください。

XMAP3 Serverに誤った論理マップデータを渡していないかどうか
例えば，論理マップの名称が誤っている，または物理マップに対応した論理マップデータを渡していないなど。
物理マップと論理マップが対応しているかを確認し，APを見直してください。

先頭1文字がデータ有無コードになっていないかどうか
出力したいデータの前のデータ有無コードを削除してください。

PC XMAP3で実行環境と異なるターゲットを指定して生成した論理／物理マップをWSで使用していないかどうか
PC XMAP3で作成した論理／物理マップをWSに転送して利用する場合には，実行環境に合ったターゲットを指定したあと，マップ生成してください。

Q20

全角・半角文字の混在データを表示すると，文字が不正になります。

A20

データ中で，半角と全角とが切り替わる付近にヌルデータ(00)₁₆があると，表示文字が不正になる場合があります。

(20)₁₆の次のコードは，データとして使用しないでください。例えば，スペースなどに変更してください。

Q21

固定項目以外のものが表示されます。

A21

次の点を確認してください。

(20)₁₆以上の値をデータ有無コードとして使用していないかどうか
データ有無コードと文字コードの重複を避けてください。データ有無コードに(1F)₁₆以下の値を使用してください。

マップ生成時にエラーが発生したため，マップに誤りがないかどうか
マップ生成時のリターンコードとエラーメッセージを基に定義内容を見直してください。

外字フォントを正しく作成しているかどうか
外字フォントを見直してください。

論理マップ長エリアに論理マップの長さを正しく格納しているかどうか
論理マップと物理マップが対応しているか確認し，正しい論理マップの長さを格納してください。

出力論理マップをクリアしないで使ったため，出力論理マップ中に前の論理データが残っていないかどうか
APを見直し，出力論理マップをクリアしてください。

論理マップに格納したデータの文字コードが誤っていないかどうか
APを見直してください。

物理マップと論理マップを作成した日付が一致しているかどうか
一方だけを更新していないかどうか
マップ生成およびAPのコンパイルをし直してください。

XMAP3 Serverに誤った論理マップデータを渡していないかどうか
例えば，論理マップの名称が誤っている，または物理マップに対応した論理マップデータを渡していないなど。
物理マップと論理マップが対応しているかを確認し，APを見直してください。

先頭1文字がデータ有無コードになっていないかどうか
出力したいデータの前のデータ有無コードを削除してください。

PC XMAP3で実行環境と異なるターゲットを指定して生成した論理／物理マップをWSで使用していないかどうか
PC XMAP3で作成した論理／物理マップをWSに転送して利用する場合には，実行環境に合ったターゲットを指定したあと，マップ生成してください。

Q22

オブジェクトに「？」が出力されます。

A22

日立COBOLのAP中にDATA ABSENCE CODE（データ有無コード格納エリア）を指定していないのに，(3F)₁₆をデータ有無コードとして使用しています。データ有無コード格納エリアを指定しないと，(1F)₁₆が標準値として仮定されます。データ有無コード格納エリアを指定して(3F)₁₆を設定するか，データ有無コードを(1F)₁₆にしてください。

Q23

論理項目の右寄せができません。

A23

論理項目中の有効データの後ろにデータ有無コード以外のデータが入っていないかどうか

有効データの後ろにはデータ有無コードを指定してください。

(c)　その他のトラブル

Q1

C/S構成で，先頭に指定したサービスに対応するAPしか起動できません。

A1

サービス名ファイル(XPWhosts)の記述が誤っていることが考えられます。

記述を見直してください。

Q2

C/S構成で，画面がクライアント側に表示されません。

A2

次の点を見直してください。

APで，仮想端末名を正しく指定しているかどうか
仮想端末名を省略していないか，または誤りがないかAPを見直してください。

仮想端末定義ファイル(XMAPhosts)の設定は適切かどうか
仮想端末定義ファイルは，次の形式で指定してください。
仮想端末名;デバイス名;ホスト名;サービス番号;サービス名称
C/S構成で，一つの仮想端末名称を使って複数のクライアント端末に画面を表示したい場合は，サービス名称に「**」を指定してください。サービス名称に「**」を指定すると，APを起動した端末のDISPLAY変数の設定値がその端末のサービス名称として扱われます。したがって，サービス名ファイル（XPWhosts）に記述した，クライアント端末のディスプレイに対応づけられたサービス名称を，クライアント端末のDISPLAY変数に設定しておく必要があります。
「**」を指定すると，複数あるクライアント端末のどれか一つでこのAPを起動したときでも，APを起動した端末に対して画面を表示させることができます。
（例）
　DSP001;XDSP;**;0;**
また，APが複数ある場合は，環境変数DISPLAY中に入るサービス名を調べ，仮想端末名を分けて指定してください。
（例）
　DSP001;XDSP ;**;0;xppDSP1
　DSP002;XDSP ;**;0;xppDSP2

Q3

データ有無コードが利用できません。

A3

日立COBOLのAP中の通信記述項でDATA ABSENCE CODE（データ有無コード格納エリア）を指定しましたが，そこに値を設定していないため，(00)₁₆が仮定されています。AP中でデータ有無コード格納エリアに値を設定する，またはDATA ABSENCE CODEを指定しないでデータ有無コードに標準の(1F)₁₆を使用してください。

Q4

日立COBOLで作成したAPを別のWSで実行すると，「ライブラリがありません」というエラーになります。

A4

次の点を確認してください。

実行用のWSに日立COBOLとXMAP3 Serverがインストールされているかどうか
日立COBOLで作成したAPは単独では実行できません。インストールされていない場合は，日立COBOLとXMAP3 Serverをインストールして，再び実行してください。なお，インストールしてあるのにエラーが出る場合は，インストール時のディレクトリ構成と実行時のディレクトリ構成が異なっていることが考えられます。日立COBOLとXMAP3 Serverをインストールし直してください。

Q5

メモリ不足になります。

A5

ほかのAPを終了するなどして，メモリを増やす必要があります。このほか，実メモリ不足の原因として次の点についても見直してください。

ハードディスクの空き容量を増やしてメモリのスワップアウトができるようにしてください。

大量に帳票印刷をすると，スプールとしてハードディスクを使うため，メモリ不足になります。帳票印刷が完了するまでお待ちください。

(3)　帳票・書式の印刷時の問題

(a)　印刷動作のトラブル

Q1

印刷を指示（SEND）しましたが，プリンタでの印刷が始まりません。

A1

プリンタでの印刷は，印刷APが終了した時点か，または明示的に印刷を指示した時点で開始します。したがって，APを終了させるか，またはDISABLE文で明確な指示を出してください。

Q2

シリアルプリンタで，連続紙の改ページが指定どおりになりません。

A2

次の点を見直してください。

帳票定義で指定した用紙の大きさ（インチ）と，実際にプリンタにセットした用紙の大きさが一致しているかどうか
正しい大きさの用紙をプリンタにセットしてください。

連続紙で，プリンタに設定した用紙サイズで改ページをしたい場合は，表示・印刷環境ファイル(XPWconfig)で用紙長の設定(POPAGE，POLNPC)をしてください。

XMAP3 Server以外のアプリケーションからの印刷と併用する場合は，表示・印刷環境ファイル（XPWconfig）で，ESP/プリンタでプリンタ任せの改ページ印刷を行う機能を使うように設定する必要があります（AIX）。
ESP/プリンタでプリンタ任せの改ページ印刷を行う機能の設定については，「7.18　ESC/Pプリンタでプリンタ任せの改ページ印刷をする（AIX）」を参照してください。

Q3

空白ページが余分に出力されます。

A3

次の点を見直してください。

印刷用紙と物理マップの帳票サイズが一致し，次のマップに「印字前動作」で「改ページ」の指定がないかどうか
定義内容を確認し，印字前動作の指定を取り消してください。

印刷用紙と物理マップの帳票サイズが一致し，「印字後動作」の指定がないかどうか
定義内容を確認し，印字後動作の指定を取り消してください。

帳票サイズは適切かどうか
印字できるページ範囲をはみ出た場合に空白ページが出力されることがあります。ハードウェアの印字可能範囲を確認し，帳票サイズを変更してください。

Q4

白紙ページが各ページに出力されます。

A4

次の点を見直してください。

帳票サイズは適切かどうか
印字できるページ範囲をはみ出た場合に，空白ページが出力されることがあります。ハードウェアの印字できる範囲を確認し，帳票サイズを変更してください。

Q5

AP単位の出力が有効になりません。

A5

日立COBOLのAPの場合，SEND文のあとでDISABLE文を設定していることが考えられます。この場合，この設定は無効になるため，DISABLE文は設定しないでください。

(b)　印刷結果の問題

Q1

帳票定義で設定したとおりに印刷できません。

A1

帳票定義で定義した帳票と，表示・印刷環境ファイル（XPWconfig）でのプリンタの設定が合っていないことが考えられます。表示・印刷環境ファイル（XPWconfig）の記述を見直してください。

Q2

ページの先頭から印字されません。

A2

次の点を見直してください。

改ページを指定しているかどうか
定義内容を確認し，改ページを指定してください。

表示・印刷環境ファイル(XPWconfig)の行数の指定は正しいかどうか
表示・印刷環境ファイルで，用紙長設定（POPAGE，POLNPC）を実際の用紙サイズに合わせた設定にしてください。また，この場合は帳票定義時に印刷後改ページを指定してください。

帳票定義時に設定したページサイズが実際のプリンタに設定されている用紙サイズと合っているかどうか
定義内容を確認し，ページサイズを実際の用紙サイズと合うように指定してください。

表示・印刷環境ファイル(XPWconfig)で，対応プリンタ種別を正しく選んでいるかどうか
連続紙を先頭から印字するには，表示・印刷環境ファイル(XPWconfig)で［対象リモートプリンタ(PCRPRT)］にESC/P準拠プリンタ(ESCP_D)を設定する必要があります。

XMAP3 Server以外のアプリケーションからの印刷と併用する場合は，表示・印刷環境ファイル（XPWconfig）で，ESP/プリンタでプリンタ任せの改ページ印刷を行う機能を使うように設定する必要があります（AIX）。
ESP/プリンタでプリンタ任せの改ページ印刷を行う機能の設定については，「7.18　ESC/Pプリンタでプリンタ任せの改ページ印刷をする（AIX）」を参照してください。

Q3

帳票が途中までしか印字されません。

A3

次の点を見直してください。

(20)₁₆以上の値をデータ有無コードとして使用していないかどうか
データ有無コードと文字コードの重複を避けてください。データ有無コードに(1F)₁₆以下の値を使用してください。

マップ生成時にエラーが発生したため，マップに誤りがないかどうか
マップ生成時のリターンコードとエラーメッセージを基に定義内容を見直してください。

外字フォントを正しく作成しているかどうか
外字フォントを見直してください。

論理マップ長エリアに論理マップの長さを正しく格納している，または論理マップをクリアしたあとに論理マップの長さを格納しているかどうか
論理マップと物理マップが対応しているか確認し，正しい論理マップの長さを格納してください。

出力論理マップをクリアしないで使ったため，出力論理マップ中に前の論理データが残っていないかどうか
APを見直し，出力論理マップをクリアしてください。

論理マップに格納したデータの文字コードが誤っていないかどうか
APを見直してください。

物理マップと論理マップを作成した日付が一致しているかどうか
一方だけを更新していないかどうか
マップ生成およびAPのコンパイルをし直してください。

XMAP3 Serverに誤った論理マップデータを渡していないかどうか
例えば，論理マップの名称が誤っている，または物理マップに対応した論理マップデータを渡していないなど。
物理マップと論理マップが対応しているかを確認し，APを見直してください。

Q4

帳票の右側，または下側が印字されません。

A4

《シリアルプリンタ使用時》

用紙が小さい，または用紙の向きが誤っていないかどうか
プリンタに印字したい帳票に合う用紙を正しい向きでセットしてください。

《ページプリンタ使用時》

プリンタにセットした用紙が小さくないかどうか
正しいサイズの用紙カセットをセットしてください。また，表示・印刷環境ファイル(XPWconfig)で設定した用紙のサイズ，または向きを確認してください。設定を帳票定義に合わせてください。

Q5

プリンタごとに，印刷される文字フォントが異なります。

A5

印刷に使用するフォントは，プリンタの種類などによって異なります。

Q6

オブジェクトが印字されません。

A6

次の点を見直してください。

(20)₁₆以上の値をデータ有無コードとして使用していないかどうか
データ有無コードと文字コードの重複を避けてください。データ有無コードに(1F)₁₆以下の値を使用してください。

マップ生成時にエラーが発生したため，マップが誤っていないかどうか
マップ生成時のリターンコードとエラーメッセージを基に定義内容を見直してください。

外字フォントを正しく作成しているかどうか
外字フォントを見直してください。

論理マップ長エリアに論理マップの長さを正しく格納している，または論理マップをクリアしたあとに論理マップの長さを格納しているかどうか
論理マップと物理マップが対応しているか確認し，正しい論理マップの長さを格納してください。

出力論理マップをクリアしないで使ったため，出力論理マップ中に前の論理データが残っていないかどうか
APを見直し，出力論理マップをクリアしてください。

論理マップに格納したデータの文字コードが誤っていないかどうか
APを見直してください。

物理マップと論理マップを作成した日付が一致しているかどうか
一方だけを更新していないかどうか
マップ生成およびAPのコンパイルをし直してください。

XMAP3 Serverに誤った論理マップデータを渡していないかどうか
例えば，論理マップの名称が誤っている，または物理マップに対応した論理マップデータを渡していないなど。
物理マップと論理マップが対応しているかを確認し，APを見直してください。

Q7

オブジェクトに「？」が出力されます。

A7

日立COBOLのAP中にDATA ABSENCE CODE（データ有無コード格納エリア）を指定していないのに，(3F)₁₆をデータ有無コードとして使用しています。データ有無コード格納エリアを指定しないと，(1F)₁₆が標準値として仮定されます。データ有無コード格納エリアを指定して(3F)₁₆を設定するか，またはデータ有無コードを(1F)₁₆にしてください。

Q8

文字が印字されません。

A8

定数および論理データ中のコードにプリンタがサポートしていない文字（外字）がないかどうか
印刷したい文字を外字登録してください。

Windows特殊文字（0x8740～0x879C），NEC選定IBM拡張文字（0xED40～0xEEFC）およびIBM拡張文字（0xFA40～0xFC4B）などのベンダ固有文字を使用していないかどうか
印刷したい文字を外字登録してください。

Q9

文字を正しく印刷できません。

A9

次の点を確認してください。

印刷しようとするプリンタとそれに対応するドライバが合っているかどうか
コントロールパネルなどで，プリンタドライバの設定を確認してください。また，ESC/PやLIPSに対応していないプリンタに対してセットアップでそれぞれのプリンタドライバを指定した場合も同様の現象が発生します。プリンタに添付された説明書などで使用できる機能を確認してください。

XMAP3 Serverでのプリンタの設定と実際に印刷するプリンタが合っているかどうか
表示・印刷環境ファイル(XPWconfig)の［プリンタの種類］の指定が，実際に印刷するプリンタと合っているか確認してください。

PC XMAP3で実行環境と異なるターゲットを指定して生成した論理／物理マップをWSで使用していないかどうか
PC XMAP3で作成した論理／物理マップをWSに転送して利用する場合には，実行環境に合ったターゲットを指定したあと，マップ生成してください。

Q10

バーコードが印刷されません。

A10

LIPSII+，LIPSIIIスルーモードで印刷されていないことが考えられます。表示・印刷環境ファイル(XPWconfig)の設定を見直してください。

Q11

定義時に指定した網掛けの濃さや矩形の丸めが印刷時に変化します。

A11

プリンタの種類によって，定義時の指定と異なる場合があります。表示・印刷環境ファイル(XPWconfig)で，［LIPSコマンドの作成モード(PCLIPS)］に「LIPSII+準拠プリンタ(2)」または「LIPSIII準拠プリンタ(3)」を指定した場合，プリンタ内蔵の網掛けパターンやけい線パターンが使用されます。

(c)　その他のトラブル

Q1

スタンドアロン型で運用するときのプリンタのセットアップ方法がわかりません。

A1

「7.　XMAP3 Serverの環境設定」を参照してください。

Q2

LAN直結・共用プリンタでのセットアップ方法がわかりません。

A2

「7.　XMAP3 Serverの環境設定」を参照してください。

Q3

C/S構成でのセットアップ方法がわかりません。

A3

「7.　XMAP3 Serverの環境設定」を参照してください。

Q4

印刷時に仮想端末定義ファイルの誤りのリターンコードが出力されます。

A4

次の原因が考えられます。見直してください。

仮想端末定義ファイルのレコードに記述している内容に誤りがあります。

レコードの最後に改行がありません。

レコード中に不当なコードが挿入されています。内容を削除して再入力してください。

Q5

データ有無コードが利用できません。

A5

日立COBOLのAP中の通信記述項でDATA ABSENCE CODE（データ有無コード格納エリア）を指定しましたが，そこに値を設定していないため，(00)₁₆が仮定されました。AP中でデータ有無コード格納エリアに値を設定するか，またはDATA ABSENCE CODEを指定しないでデータ有無コードに標準の(1F)₁₆を使用してください。

Q6

日立COBOLで作成したAPを別のWSで実行すると，「ライブラリがありません」というエラーになります。

A6

次の点を確認してください。

実行用のWSに日立COBOLとXMAP3 Serverがインストールされているかどうか
日立COBOLで作成したAPは単独では実行できません。インストールされていない場合は，日立COBOLとXMAP3 Serverをインストールして，再び実行してください。なお，インストールしてあるのにエラーが出る場合は，インストール時のディレクトリ構成と実行時のディレクトリ構成が異なっていることが考えられます。日立COBOLとXMAP3 Serverをインストールし直してください。

Q7

メモリ不足になります。

A7

ほかのAPを終了するなどして，メモリを増やす必要があります。また，実メモリ不足の原因として次のことも考えられますので，見直してください。

ハードディスクの空き容量を増やしてメモリのスワップアウトができるようにしてください。

大量に帳票印刷をすると，スプールとしてハードディスクを使うため，帳票印刷が完了するまでお待ちください。

Q8

画面入出力で性能が出ません。

A8

次の点を見直してください。

《定義時の性能を向上させるポイント》

けい線の見直し
・不要なけい線は削除してください。
・矩形で囲んだフィールドは反転表示にして枠を取ってください。

テキストボックスやフィールドの見直し
・テキストなどの集約
テキストボックスやフィールドはまとめて定義してください。例えば，「年」「月」「日」は三つに分けないで，一つにまとめるとマップが小さくなります。
・CUIフィールドの利用
テキストボックスに作成されている表は，CUIフィールドボックスのフィールドとして定義してください。表示性能が向上します。

《AP作成時のポイント》

同一マップを再表示するとき
同一マップの画面を再表示する場合は，部分上書きを指定しないと，画面中の一つ（または一部）のオブジェクトだけを書き換えるときでも全画面（デスクトップ画面に対して最大化）の再表示となり，表示性能が低下します。
部分上書きと全画面表示とを使い分けることをお勧めします。指定方法については「5.　アプリケーションの開発」を参照してください。

データ量を見直す
APで不要なデータを送っていないかどうか見直してください。例えば，常にスペースやゼロを送ってしまうと実行性能が劣ってしまいます。したがって，出力時の性能を上げるにはデータの量を減らすことが重要です。
・データ有無コードで論理マップをクリアします。
・不要な初期値を指定しないようにします。

AP分割を見直す
XMAP3 Serverのオープン要求がどのタイミングで出されているかを見直してください。コンパイル単位で，TRANSCEIVE文または，SEND文が発行されると，画面ごとにオープンが実行されるため，処理が遅くなります。不要な画面をオープンしないためには次の点に注意してください。
・一つのコンパイル単位にTRANSCEIVE文，SEND文をまとめ，オープンの実行は必要最低限にします。
・共通のルーチンにまとめてTRANSCEIVE文，SEND文を発行するようにAPの構造を見直します。
・日立COBOLの場合，AP間でオープンを引き継ぐ
「CBLTERMSHAR=YES」を指定すると，AP間でオープンの引き継ぎができます。
日立COBOLでは，明示的にCALL文でオープンを要求する場合を除き，一つのコンパイル単位で最初のSEND文またはTRANSCEIVE文が発行されると画面がオープンされます。そのため，1画面が1実行ファイルのような構成にすると，実行ファイルごとに画面をオープンすることになります。この場合，オープン・クローズ，SEND文，TRANSCEIVE文を発行する実行ファイル，業務処理をする実行ファイルをそれぞれ分けた方が実行性能が高くなります。
また，複数のコンパイル単位のものを合わせて一つの実行ファイルにするときは，各コンパイル単位でオープンを発行しないようにするため，日立COBOL（02-02以降）の実行支援の環境変数で，「CBLTERMSHAR=YES」を指定します。「CBLTERMSHAR=YES」は，SEND/RECEIVE/TRANSCEIVEインタフェースのときだけ有効です。CALLインタフェースでは無効になります。
CALLインタフェースの場合，または「CBLTERMSHAR」をサポートしていないバージョンの日立COBOLを使用している場合で，AP間のオープン引き継ぎをするときは，ユーザが，XMAP3 Serverインタフェースエリアの情報を引き継ぐようなコーディングをする必要があります。サンプルコーディングとして，APパターンのGENDSP02およびGENDSP03が利用できます。

画面クローズのタイミングを見直す
画面のクローズは，明示的にCALL文でクローズするか，DISABLE文を発行したタイミングです。

APとの制御のやり取りを見直す
XMAP3 Serverでは，オブジェクトからフォーカスまたはカーソルが離れたときに，APに制御を返せます（「入力と同時にAPへ制御を渡す」）。しかし，オブジェクト単位にAPとの制御のやり取りが発生する方法は，画面単位にAPに制御を返す方法と比べオーバーヘッドが大きくなり，オブジェクト遷移（フォーカス移動）が遅くなる場合があります。このため，APとの制御のやり取りは画面単位で行うことをお勧めします。オブジェクト単位でAPとやり取りをする場合は，できるだけ画面中のオブジェクト（APに制御を戻すもの）の数を少なくすることがポイントです。

《実行時のポイント》

マップの常駐化サイズの見直し
使用するマップを常駐するバッファサイズは変更できます。詳細については「9.3.3　物理マップの常駐について」を参照してください。

9.2　ログ情報の利用方法

C言語のAP，または日立COBOLでCALLインタフェースを利用しているAPで，画面表示または帳票印刷の実行時に何らかのトラブルが発生した場合，AP中でXMAP3 Serverのリターンコードを表示するようなトラブルシュート機能を備えていないときには，ログ情報を利用します。ログ情報中のXMAP3 Serverのリターンコードの内容から，トラブルとなる原因を推定して誤りを訂正します。日立COBOLでSENDインタフェースを使用しているAPでは，日立COBOLのKCCB～メッセージで表示されるXMAP3 Serverのリターンコードから原因推定ができますので，ログ情報を取得する必要はありません。XMAP3 Serverのリターンコードとその対処方法については，「9.4　AP実行時のXMAP3 Serverのリターンコード」を参照してください。

有効なログ情報を取得するためには，ログ情報採取の指定をした状態で，トラブルの発生したAPを再実行します。なお，ログ情報の出力時には，実行性能が悪化するおそれがあります。そのため，通常の運用時ではログ情報を取得しないでください。また，ログ情報は画面表示時または帳票印刷時だけに有効となる機能であり，書式印刷時については対象外となりますので，ご注意ください。

＜この節の構成＞

9.2.1　ログ情報の種類

9.2.2　ログ情報採取の指定

9.2.3　APの再実行（トラブル現象の再現）

9.2.4　ログファイルの内容確認

9.2.1　ログ情報の種類

ログ情報の種類を表9-1に示します。

表9-1　ログ情報の種類

種別 | ファイル名
標準ログ | logPath指定値/仮想端末名.n
拡張ログ | logPath指定値/仮想端末名.Fn

（凡例）

n：仮想端末名を共有するマップドライバを識別するための番号（1～15）です。

9.2.2　ログ情報採取の指定

ログ情報の採取は，XMAP3 Serverのマップドライバ環境定義ファイル（XMAPdrv）で指定します。ログファイルのファイルサイズは標準ログの場合，最大4,096バイトになります。

マップドライバ環境定義ファイル「/etc/opt/HIXMAP/XMAPdrv」に次の設定をします。

logSelect=standard
logPath=ログファイルの出力先パス名（/tmpなど）

logPathの設定を省略した場合には，AP実行時のカレントディレクトリにログファイルが出力されます。

ログファイルの拡張子は，同様の仮想端末名に対するオープン要求（サービス開始）ごとに，「9.2.1　ログ情報の種類」に示すログファイル名のnの値が更新されます。また，作成済みのログファイル数が最大数の15に満たない場合，前回オープン要求時のnに+1した値となります。

ログファイルがすでに存在する場合は，日付の古いものから更新されます。ただし，ログファイルの更新はAPを起動したユーザに権限がある場合に限ります。ログファイルがいっぱいになるとファイルの先頭から上書きします。

ログファイルをオープンできない場合，プログラムを起動できません。ログファイルがすでに最大数（15）まで作成された状態で，ログファイルの更新権限がないユーザがAPを実行すると，エラーが発生します。APを起動するユーザが複数の場合は，不要なログファイルはできるだけ削除するか，またはユーザ単位に仮想端末名を設定してください。なお，オープン要求でエラーが発生した場合には，ログ情報が格納されないことがあります。

注意事項

拡張ログは，標準ログとは異なりラップアラウンドは実行しません。このため，XMAP3 Serverへの入出力要求ごとにファイルサイズが増加しますので，注意してください。

9.2.3　APの再実行（トラブル現象の再現）

ログ情報採取の指定をしたら，トラブルの発生したAPを再実行して現象を再現させ，有効なログ情報を取得します。

APを再実行して現象を再現させると，ログ情報採取の指定でlogPathに指定したディレクトリ下にログファイルが作成されます。logPath=/tmpで，仮想端末名が「DSP001」の場合，/tmpにDSP001.1というログファイルが作成されています。

9.2.4　ログファイルの内容確認

出力したログファイルは，XMAP3 Serverが標準提供しているログファイル編集コマンドで見やすい形式に編集し，ログ情報の中からXMAP3 Serverのリターンコードを検出します。検出したリターンコードは，「9.4　AP実行時のXMAP3 Serverのリターンコード」と照らし合わせて原因を推定し，対策します。

XMAP3 Serverが標準提供しているログファイル編集コマンドは，標準では編集結果を標準出力に表示しますので，必要であればリダイレクションを利用してファイルに出力するようにしてください。

コマンドを利用した出力の方法を次に示します。なお，このコマンドは標準ログだけが対象のため，注意してください。

/opt/HIXMAP/bin/jsvwuedt ログファイル名

出力形式の例を次に示します。

出力された情報のうち，<6>，<7>のコードを控え，「9.4　AP実行時のXMAP3 Serverのリターンコード」および「9.7　AP実行時の詳細エラーコード」の一覧から該当するコードの原因と対処方法を調べて，対処方法に従って対処してください。なお，<6>，<7>のコードは16進表示となっています。

<1>ログ取得日付

<2>ログ取得時間

<3>マップ名（後ろ2文字はデバイスID）

ND：GUI画面用マップ

NC：CUI画面用マップ

6A：シリアルプリンタ（XPRTL1）用マップ

6H：シリアルプリンタ（XPRTL3）用マップ

6B：ページプリンタ（XPRTP1）用マップ

6G：ページプリンタ（XPRTP3）用マップ

<4>要求機能種別

OPEN：マップドライバのオープン要求

SEND：画面／帳票の出力要求

RECV：画面の入力要求

MDO ：マッピングオプションの変更要求

CLOS：マップドライバのクローズ要求

<5>リターンコード

「9.4.1　画面表示・帳票出力時のリターンコード」の「リターンコード」を参照してください。

<6>リターンコード詳細（16進表示）

「9.4.1　画面表示・帳票出力時のリターンコード」の「リターンコード詳細」から該当するコードを参照し，「エラー内容」に従って対処してください。

<7>XMAP3 Server詳細エラーコード（16進表示）

「9.7　AP実行時の詳細エラーコード」の「詳細エラーコード」から該当するコードを参照し，「エラー内容」に従って対処してください。

<8>データ有無コード有効フラグとデータ有無コード（16進表示）

有効フラグ「１」：有効

その他　　　　　：無効

<9>予備

9.3　チューニング

XMAP3 Serverでの処理性能のチューニングについて説明します。

＜この節の構成＞

9.3.1　環境定義ファイルの運用方法

9.3.2　環境定義ファイルの形式

9.3.3　物理マップの常駐について

9.3.4　書式オーバレイのデータ制限（AIX，HP-UX，Solaris）

9.3.5　行データ出力用の推奨コーディング（AIX，HP-UX，Solaris）

9.3.1　環境定義ファイルの運用方法

XMAP3 Serverが提供している環境定義ファイル（XMAPdrv）で，物理マップが格納されているディレクトリや物理マップの常駐サイズなどを指定することで，処理性能をチューニングできます。

ファイルを編集する場合は，標準提供されているファイルを「.bak」などの拡張子を付けて保存しておくことをお勧めします。誤って修正した場合には，作成したファイルを削除したあと，拡張子が「.bak」のファイルを元のファイル名に戻すことで，以前の状態に戻すことができます。

なお，環境定義ファイルには，ログ情報を取得するかどうかを指定するパラメタがあります。このパラメタは，処理性能のチューニングでは指定する必要はありません。ログ情報の利用方法については，「9.2　ログ情報の利用方法」を参照してください。

9.3.2　環境定義ファイルの形式

環境定義ファイルは，viなどのエディタで編集します。次に，環境定義ファイルの形式を説明します。

＜この項の構成＞

(1)　ファイル名

(2)　ファイルの形式

(3)　パラメタの種類

(1)　ファイル名

/etc/opt/HIXMAP/XMAPdrv

(2)　ファイルの形式

環境定義ファイルの形式を次に示します。

1行に1項目を255バイト以内で記述してください。1行が256バイト以上の場合，ファイルの指定は無効になります。

標準提供されているファイルの内容を次に示します。

(3)　パラメタの種類

ここでは，次のパラメタについて説明します。

ログ種別

ログファイルパス

物理マップ常駐サイズ

マップロードパス

プリンタ出力

上記以外のパラメタについては，「7.6.6　マップドライバ環境定義ファイル」を参照してください。

(a)　ログ種別（logSelect=）

ログ種別を指定します。この項目は，ログ情報を取得する場合にだけ変更してください。指定を省略すると，ログ情報は出力されません。

指定できる値とその意味を次に示します。

　false：ログを取得しない

　standard：標準形式でログを取得する

　full：標準形式と詳細形式でログを取得する

(b)　ログファイルパス（logPath=）

ログ種別でstandardまたはfullを指定した場合に，ログファイルを格納するディレクトリを52文字以内（半角）で指定します。指定を省略すると，マッピングサービスライブラリが起動されたディレクトリにログファイルが格納されます。

(c)　物理マップ常駐サイズ（PoolSize=）

マッピングサービスライブラリ中の，物理マップを常駐させるエリアのサイズを2,048,000バイト以内で指定します。指定を省略すると，常駐エリアは32,768バイトになります。

物理マップの常駐の考え方については，「9.3.3　物理マップの常駐について」を参照してください。

(d)　マップロードパス（mapPath=）

物理マップ，書式イメージまたは行制御データが格納されているディレクトリを55文字以内（半角）で指定します。ただし，末尾に「/（スラッシュ）」または「バックスラッシュ」を付けてはいけません。指定を省略した場合および指定したパスに物理マップが見つからなかった場合は，カレントパスから検索されます。

(e)　プリンタ出力（printOut=）

SEND時に，プリンタへの出力指示との同期をとるかどうかを指定します。この指定によって，「7.12.1　LPスプールシステムでの帳票一括出力機能」の利用を選択できます。指定を省略すると，sync（プリンタへの出力指示と同期をとる）を仮定して動作します。

指定できる値とその意味を次に示します。

　sync：プリンタへの出力指示と同期をとる

　async：プリンタへの出力指示と同期をとらないで，「LPスプールシステムでの帳票一括出力機能」を利用する

9.3.3　物理マップの常駐について

APから物理マップのロードを要求されると，XMAP3 Serverのマップドライバライブラリは物理マップを検索して，画面に表示します。このため，物理マップをXMAP3 Serverのマップドライバに常駐しておくと，画面表示の応答時間を短縮できます。

物理マップは，常駐エリアの空き領域エリアにロードされます。空きエリアが確保できない場合は，常駐エリアにあるいちばん古い物理マップが削除され，新しい物理マップがロードされます。ただし，物理マップのサイズが常駐エリアより大きい場合は，XMAP3 Serverがエリアを確保します。したがって，メモリの節約のために，常駐エリアのサイズを物理マップのサイズより大きく設定しておいてください。

なお，メモリやほかのAP実行のために，このエリアがスワップアウトされて効果がない場合もあります。

9.3.4　書式オーバレイのデータ制限（AIX，HP-UX，Solaris）

書式オーバレイ機能を使用する場合，行データおよび1ページのデータ量の制限があります。処理の種類に応じて，制限値を求める概算式を次に示します。コーディング時には，データ量の制限値を超えないように注意してください。なお，書式オーバレイ印刷ユティリティを使用する場合，行データの上限は1,024バイトです。

ここでは，COBOLでの例を使用して説明しています。

＜この項の構成＞

(1)　「WRITE 行データFROM データ1」形式の処理で，CHARACTER TYPE句指定なしの場合

(2)　「WRITE 行データFROM データ1」形式の処理で，データ1にCHARACTER TYPE句指定ありの場合

(3)　「WRITE 行データ」形式の処理で，CHARACTER　TYPE句指定なしの場合

(4)　「WRITE 行データ」形式の処理で，CHARACTER　TYPE句指定ありの場合

(1)　「WRITE 行データFROM データ1」形式の処理で，CHARACTER TYPE句指定なしの場合

(a)　COBOL記述例

定義部

処理部

(b)　概算式

行データの上限

04-10より前のバージョンの場合
384≧行データの領域長＋（データ中の全角／半角切り替わり回数×2）＋2

04-10以降のバージョンの場合
16383≧行データの領域長＋（データ中の全角／半角切り替わり回数×2）＋2

ページデータ量の上限
32767≧行データの和※＋62

注※

行データの和＝｛行データの領域長＋（データ中の平均全角／半角切り替わり回数×2）＋10｝×行数

(2)　「WRITE 行データFROM データ1」形式の処理で，データ1にCHARACTER TYPE句指定ありの場合

(a)　COBOL記述例

定義部

処理部

(b)　概算式

行データの上限

04-10より前のバージョンの場合
384≧データ1の各項目の長さの和
＋（データ1の各項目内での全角／半角切り替わり回数の和×2）
＋（データ1の各項目への文字サイズ指定回数の和×3）
＋（データ1の各項目への字間値指定回数の和×3）
＋（データ1の各項目への書体指定回数の和×3）
＋（データ1の各項目への横倍指定回数の和×4）
＋（データ1の項目の数×2）

04-10以降のバージョンの場合
16383≧データ1の各項目の長さの和
＋（データ1の各項目内での全角／半角切り替わり回数の和×2）
＋（データ1の各項目への文字サイズ指定回数の和×3）
＋（データ1の各項目への字間値指定回数の和×3）
＋（データ1の各項目への書体指定回数の和×3）
＋（データ1の各項目への横倍指定回数の和×4）
＋（データ1の項目の数×2）

1ページデータ量の上限
32767≧行データの和※＋62

注※

行データの和＝｛データ1の各項目の長さの和

＋（データ1の各項目内での平均全角／半角切り替わり回数の和×2）

＋（データ1の各項目への平均文字サイズ指定回数の和×3）

＋（データ1の各項目への平均字間値指定回数の和×3）

＋（データ1の各項目への平均書体指定回数の和×3）

＋（データ1の各項目への平均横倍指定回数の和×4）

＋（データ1の項目の数×2）

＋8｝×行数

(3)　「WRITE 行データ」形式の処理で，CHARACTER　TYPE句指定なしの場合

(a)　COBOL記述例

定義部

処理部

(b)　概算式

行データの上限

04-10より前のバージョンの場合
384≧行データの領域長＋（データ中の全角／半角切り替わり回数×2）＋2

04-10以降のバージョンの場合
16383≧行データの領域長＋（データ中の全角／半角切り替わり回数×2）＋2

1ページデータ量の上限
32767≧行データの和※＋62

注※

行データの和＝｛行データの領域長＋（データ中の平均全角／半角切り替わり回数×2）＋10｝×行数

(4)　「WRITE 行データ」形式の処理で，CHARACTER　TYPE句指定ありの場合

(a)　COBOL記述例

定義部

処理部

(b)　概算式

行データの上限

04-10より前のバージョンの場合
384≧行データの各項目の長さの和
＋（行データの各項目内での全角／半角切り替わり回数の和×2）
＋（行データの各項目への文字サイズ指定回数の和×3）
＋（行データの各項目への字間値指定回数の和×3）
＋（行データの各項目への書体指定回数の和×3）
＋（行データの各項目への横倍指定回数の和×4）
＋（行データの項目の数×2）

04-10以降のバージョンの場合
16383≧行データの各項目の長さの和
＋（行データの各項目内での全角／半角切り替わり回数の和×2）
＋（行データの各項目への文字サイズ指定回数の和×3）
＋（行データの各項目への字間値指定回数の和×3）
＋（行データの各項目への書体指定回数の和×3）
＋（行データの各項目への横倍指定回数の和×4）
＋（行データの項目の数×2）

1ページデータ量の上限
32767≧行データの和※＋62

注※

行データの和＝｛行データの各項目の長さの和

＋（行データの各項目内での平均全角／半角切り替わり回数の和×2）

＋（行データの各項目への平均文字サイズ指定回数の和×3）

＋（行データの各項目への平均字間値指定回数の和×3）

＋（行データの各項目への平均書体指定回数の和×3）

＋（行データの各項目への平均横倍指定回数の和×4）

＋（行データの項目の数×2）

＋8｝×行数

9.3.5　行データ出力用の推奨コーディング（AIX，HP-UX，Solaris）

書式オーバレイ印刷で行データを出力する場合，行データおよびページデータの上限値によってデータを出力できない場合があります。必要に応じて，推奨コーディングを参考にしてください。

＜この項の構成＞

(1)　ページ単位で，文字サイズ，間隔，書体，拡張などがすべて同じ場合

(2)　行単位で，文字サイズ，間隔，書体，拡張などがすべて同じ場合

(3)　ページ単位または行単位で，文字サイズ，間隔，書体，拡張などがそろっていない場合

(1)　ページ単位で，文字サイズ，間隔，書体，拡張などがすべて同じ場合

ドローの書式作成時に，書式属性ダイアログで文字サイズなどを設定します。APでCHARACTER TYPE句を指定する必要はありません。

(2)　行単位で，文字サイズ，間隔，書体，拡張などがすべて同じ場合

行データ設定用のテーブルと送信用のテーブルを用意します。WRITE文の直前で，データを送信用のテーブルにコピーしてから，送信用のテーブルを使用して，WRITE文を実行します。

行データ設定用のテーブルは，項目ごとに定義します。送信用のテーブルは，行データ設定用のテーブルの長さを1項目として定義します。CHARACTER TYPE句は，送信用のテーブルに指定します。

図9-1　推奨コーディング（ページ単位で，文字サイズ，間隔，書体，拡張などがすべて同じ場合）

(3)　ページ単位または行単位で，文字サイズ，間隔，書体，拡張などがそろっていない場合

1行中の行データを，行データの上限値を超えないようにデータを分けます。改行は，1行中の最終データを出力するときにします。1行中の最終データを出力するまでは，改行しないようにしてください。行データの上限値は，概算式を参考にします。概算式については，「9.3.4　書式オーバレイのデータ制限（AIX，HP-UX，Solaris）」を参照してください。

文字サイズなど，同じ項目が連続する場合には，行データ設定用のテーブルと送信用のテーブルを用意します。WRITE文の直前で，送信用のテーブルにデータをコピーしてから，送信用のテーブルを使用してWRITE文を実行します。送信用のテーブルでは，文字サイズなど，同じ項目が連続する領域を一つの項目として定義してください。CHARACTER TYPE句は，送信用のテーブルに指定します。

図9-2　推奨コーディング（ページ単位または行単位で，文字サイズ，間隔，書体，拡張などがそろっていない場合）

9.4　AP実行時のXMAP3 Serverのリターンコード

＜この節の構成＞

9.4.1　画面表示・帳票出力時のリターンコード

9.4.2　書式オーバレイ印刷時のリターンコード（AIX，HP-UX，Solaris）

9.4.1　画面表示・帳票出力時のリターンコード

画面表示・帳票出力時のリターンコードについて説明します。「リターンコード詳細」の16進で表現しているコードは，日立COBOLの画面に表示されるエラーコードに対応しています。

表中で使用する記号の意味を次に示します。

(S)：システムの処理
(P)：プログラマの処理

なお，表9-2のリターンコード詳細に示すエラーコードが，20480～20516（16進数では(5000)₁₆～(5024)₁₆）の場合，すでにオープン状態であっても強制的にクローズ要求されたものとして処理します。

クローズ処理によって帳票が出力され，そのあとの要求が24577エラー（16進数では(6001)₁₆エラー）となる場合がありますので，エラー原因を解決して再度アプリケーションを起動してください。

画面表示・帳票出力時のリターンコードを表9-2に示します。

表9-2　画面表示・帳票出力時のリターンコード

リターン
コード詳細
エラー内容
リターン
コード

1036
(040C)₁₆
定義している予約項目名が，OpenTP1で提供している予約項目名と一致していない。
(S)：処理を続行する。
(P)：予約項目に定義している予約項目名をOpenTP1で提供している予約項目名と一致させ，物理マップを再作成して，アプリケーションを再実行する。
　4　

1044
(0414)₁₆
定義されたイベント通知コードと対応しない確定キーが入力された。
(S):処理を続行する。
(P):入力された確定キーに対応するイベント通知コードを定義し，物理マップを再作成してAPを実行する。
　4　

1060
(0424)₁₆
カーソル位置が不正である。APで設定するカーソル位置の値が画面上に存在しない。
(S):処理を続行する。
(P):画面範囲内のカーソル位置を設定するようAPを修正し，再コンパイル後に再実行する。位置を設定しないで領域をクリアする場合には(00)₁₆を設定する。
　4　

3072
(0C00)₁₆
物理マップの内容が破壊されている。
原因として次のことが考えられる。

定義対象（デバイス）と物理マップが一致していない。例えば，プリンタで印刷するときに，APで指定したマップがディスプレイ用である。

物理マップファイルが破壊されている。

PCからファイル転送するときに，テキスト形式で転送している。

(S):処理を終了する。
(P):物理マップを再作成して，APを再実行する。または，ファイル転送での問題であることがわかっている場合は，再度ファイル転送して，APを再実行する。
　8　

3104
(0C20)₁₆
XMAP3 Serverより上位のバージョンで作成した物理マップが使用された。
(S):処理を続行する。
(P):物理マップの作成バージョンを確認し，XMAP3 Serverより上位のバージョンの場合は，XMAP3 Serverの実行可能バージョンで，物理マップを再作成してAPを実行する。
　8　

3108
(0C24)₁₆
物理マップのエンディアンが実行環境と合っていない。
(S):処理を終了します。
(P):実行環境に合ったエンディアンとなるように，物理マップを再作成する。
　8　

4096
(1000)₁₆
XMAP3 ServerおよびPC XMAP3間のデータが破壊されている。
(S):処理を終了する。
(P):XMAP3 ServerおよびPC XMAP3のバージョン関係を調べて，正しいバージョンの組み合わせで再インストールする。
　8　

4100
(1004)₁₆
何らかの原因でデータ化けが発生したことによって，物理マップ中の入力物理マップ名情報が破壊されている。
(S):処理を終了する。
(P):物理マップを再作成して，APを再実行する。メッセージとマップ名を正しく対応づける。
　8　

4104
(1008)₁₆
何らかの原因でデータ化けが発生したことによって，物理マップ中の作成管理情報が破壊されている。
(S):処理を終了する。
(P):物理マップを再作成して，APを再実行する。
　8　

5120
(1400)₁₆
APを実行したカレントディレクトリまたはマップドライバ環境定義ファイル(XMAPdrv)中のmapPathで指定したディレクトリ中に，APで指定した物理マップが存在しない。または，APで指定した仮想端末名（CALLインタフェースの場合のXMAP-COMの内容）とマップ名の物理マップIDが一致していない（プリンタ用の仮想端末名に対してディスプレイ用のマップを指定したなど）。
(S):処理を終了する。
(P):

マップドライバ環境定義ファイル中のmapPathで指定しているディレクトリまたはAPと同じディレクトリに，APで指定した物理マップを置く。

物理マップに拡張子「.pmp」が付いている場合は，cmapcpコマンドで拡張子を削除する。

AP中の仮想端末名（例えば，PRT001）に対して，マップのデバイス種別（例えば，デバイスIDが6A/6B/6G/6H）が合っているか確認し，AP中のマップ名または仮想端末定義ファイル(XMAPhosts)のデバイス※を修正後再実行する。

　8　

5124
(1404)₁₆
物理マップのロード処理中に入出力エラーが発生した。
(S):処理を終了する。
(P):物理マップを再作成して，APを再実行する。
　8　

5148
(141C)₁₆
部品用物理マップのロードで必要なメモリが不足した。
(S):部品用物理マップなしとして処理を続ける。
(P):次に示すどちらかの処理をする。

ほかのAPを終了するか，WSを再起動する。

WS上のリソースを見直し，メモリ増設などをする。

　4　

5152
(1420)₁₆
APを実行したカレントディレクトリ，マップドライバ環境定義ファイル（XMAPdrv），またはサーバ属性定義ファイル（標準：XMAPsrv/xps）中のmapPathで指定したディレクトリ中に，部品用物理マップが存在しない。
(S):部品用物理マップなしとして処理を続ける。
(P):mapPathで指定したディレクトリに部品用物理マップを置く。
　4　

5156
(1421)₁₆
部品用物理マップのロード処理中に入出力エラーが発生した。
(S):部品用物理マップなしとして処理を続ける。
(P):部品用物理マップを再作成して，APを再実行する。
　4　

5160
(1428)16
部品用物理マップの内容が破壊されている。
(S):部品用物理マップなしとして処理を続ける。
(P):部品用物理マップを再作成して，APを再実行する。
　4　

5164
(142C)16
部品用物理マップのロードパスで必要なメモリが不足した。
(S):処理を終了する。
(P):次に示すどちらかの処理をする。

ほかのAPを終了するか，WSを再起動する。

WS上のリソースを見直し，メモリ増設などをする。

　8　

16384
(4000)₁₆
次の要因が考えられる。

ホスト名取得時にエラーが発生した。

XMAPC構成ファイル（XMAPconfig）が存在しない，または参照できない（read権限がない）。

(S):処理を終了する。
(P):次の設定を見直す。

仮想端末定義ファイル（XMAPhosts）またはXMAPC構成ファイル（XMAPconfig）のホスト名を確認し，自ホストのホスト名を正しく指定する。

XMAPC構成ファイル（XMAPconfig）を作成する，またはread権限を付与する。

　8　

16388
(4004)₁₆
XMAP3 Serverが正常にインストールされていない。
(S):処理を終了する。
(P):XMAP3 Serverを再インストールする。
　8　

16396
(400C)₁₆
次のファイルの内容が不正，またはファイルが破壊されている。

仮想端末定義ファイル（XMAPhosts）

XMAPC構成ファイル（XMAPconfig）

マップドライバ環境定義ファイル（XMAPdrv）

(S):処理を終了する。
(P):ファイルの内容を見直して正しく定義する。
　8　

16428
(402C)₁₆
同時に動作しているほかのAPなどの関係，またはリソースの物理的不足によって，実行支援に必要なメモリが不足した。
(S):処理を終了する。
(P):次に示すどちらかの処理をする。

ほかのAPを終了するか，WSを再起動する。

WS上のリソースの見直し，メモリの増設などをする。

　8　

16456
(4048)₁₆
サーバサービス番号がライブラリマッピング指定(0)となっていない。
(S):処理を終了する。
(P):サーバサービス番号として，「0」を指定する。
　8　

20480
(5000)₁₆
仮想端末定義ファイル（XMAPhosts）やDISPLAY環境変数で，誤ったサービス名称を指定している。
詳細については，「9.7.1　詳細エラーコード」のTX_CECPARMのエラー内容を参照。
(P):仮想端末定義ファイル中で画面用として定義したサービス名称が，サービス名ファイル（XPWhosts）中でプリンタに対応づけられていないか，またはDISPLAY環境変数の設定値とサービス名ファイルのサービス名称が不一致でないかなど，ファイル設定の相互関係を見直し，正しく設定する。
　8　

20484
(5004)₁₆
同時に動作しているほかのAPなどの関係，またはリソースの物理的不足によって，XMAP3印刷サービスの実行時に必要なメモリが不足した。
詳細については，「9.7.1　詳細エラーコード」のTX_CECNOARのエラー内容を参照。
(P):次に示すどちらかの処理をする。

ほかのAPを終了するか，WSを再起動する。

WS上のリソースを見直し，メモリを増設する。

　8　

20485
(5005)₁₆
通常発生しないエラー，またはC/S環境での通信処理で回復不能エラーが発生した。同時に動作しているほかのAPなどの関係で，WS上のリソース（主にメモリ）が不足したことが考えられる。また，LANの回線上で障害，データ化けが発生したことが考えられる。
詳細については，「9.7.1　詳細エラーコード」のTX_CECFERRのエラー内容を参照。
(P):ほかのAPを終了するか，WSを再起動する。ログファイルを出力して原因を調査する。
　8　

20487
(5007)₁₆
XMAP3 Serverのバージョンが，物理マップを作成したPC XMAP3のバージョンと一致していない。
詳細については，「9.7.1　詳細エラーコード」のTX_CECIMAPのエラー内容を参照。
(P):PC XMAP3とXMAP3 Serverのバージョンを調べ，正しい組み合わせで再インストールしてから，物理マップを再作成して，APを再実行する。
　8　

20488
(5008)₁₆
一次ウィンドウが表示されていない状態で，二次ウィンドウを表示すると発生する。一般的にはAP内での処理が不正になっていることが考えられる。
詳細については，「9.7.1　詳細エラーコード」のTX_CECIMSGのエラー内容を参照。
(P):

画面表示するマップ名が合っているか，または画面の表示順序が合っているかを見直す。

仮想端末定義ファイルとXMAPC構成ファイル（XMAPconfig）の設定値の関係を見直す。

　8　

20489
(5009)₁₆
TCP/IP通信時，通信相手との接続でエラーが発生した。詳細については，「9.7.1　詳細エラーコード」のTX_CECDOWNのエラー内容を参照。
(P):

サービスが起動されているか確認し，起動されていない場合は，サービス起動後，APを再実行する。

サービス名ファイル中のデバイス名を正しく指定し，XMAP3サーバを再起動したあと，APを再実行する。

システム的な要因が原因である（システムリソースの異常・ほかのAPでの異常）ことが考えられる。XMAP3サーバを再起動したあと，APを再実行する。

　8　

20493
(500D)₁₆
XMAP3 Server内部処理で何らかの異常が発生したため，サーバ内のプログラムに論理矛盾が起きた。
詳細については，「9.7.1　詳細エラーコード」のTX_CECSVRCのエラー内容を参照。
(P):システム的な要因が原因である（システムリソースの異常・ほかのAPでの異常）ことが考えられる。WSを再起動・再実行する。ログファイルを出力して，原因を調査する。
　8　

20505
(5019)₁₆
別プログラムでプリンタを使用中のため，印刷できなかった。
詳細については，「9.7.1　詳細エラーコード」のTX_CECIEPRのエラー内容を参照。
(P):プリンタが使用されていないことを確認し，再度印刷要求する。
　8　

20508
(501C)₁₆
XMAP Server内部でシステムコールエラーが発生した。詳細については，「9.7.1　詳細エラーコード」のTX_CECSYTMのエラー内容を参照。
(P):

「XPW_DAEMON_PORT_NO」環境変数の設定とサービス名（/etc/servicesファイル）を確認し，間違っている場合は，修正し，XMAP3サーバ，APを再起動する。

サービス名ファイル（XPWhosts）の設定とホスト名，IPアドレス（/etc/hostsファイル）を確認し，間違っている場合は，修正し，XMAP3サーバ，APを再起動する。

サービスが起動されているか確認し，起動されていない場合は，サービス起動後，APを再実行する。

　8　

20514
(5022)₁₆

仮想端末定義ファイル（XMAPhosts）中でサービス名に「**」と指定している場合，APを起動した端末のDISPLAY環境変数に誤りがある。

仮想端末定義ファイルとサービス名ファイル（XPWhosts）のサービス名の対応づけに誤りがある。

「/attach」指定のサービスで自動起動APを起動している場合，XMAP3サーバだけを再起動した。

詳細については，「9.7.1　詳細エラーコード」のTX_CECNOSVのエラー内容を参照。
(P):

「**」と指定している場合は，サービス名ファイル中で，表示したいディスプレイ名称に対応づけられたサービス名を，端末のDISPLAY環境変数に正しく指定して，APを再実行する。

仮想端末定義ファイルとサービス名ファイルのサービス名を一致させてXMAP3サーバを再起動してから，APを再実行する。

XMAP3クライアントを再起動する。自動起動APでエラーが発生しないようにXMAP3サーバを再起動するには，XMAP3クライアントを終了させて，XMAP3サーバを再起動したあとにXMAP3クライアントを起動する。

　8　

20515
(5023)₁₆
C/S環境の場合，サーバWS上のXMAP3 Server，PC上のXMAP3クライアントのバージョンが不整合である。
詳細については，「9.7.1　詳細エラーコード」のTX_CECIVERのエラー内容を参照。
(P):それぞれインストールされているXMAP3 Server，またはPC XMAP3のバージョンを確認し，整合性のあるバージョンになるようにインストールし直す。基本的にXMAP3 Serverは同一バージョンを利用する。
また，PCとのC/S構成の場合，前提となるPC側のXMAP3クライアントのバージョンについては，「ソフトウェア添付資料」を参照のこと。
　8　

20516
(5024)₁₆
XMAP3の出力処理中に，OSまたはXMAP3の内部で回復不能なエラーが発生した。
詳細については，「9.7.1　詳細エラーコード」のTX_CECERHDのエラー内容を参照。
(P):表示・印刷サービス側にてシステム的な要因（システムリソース不足，プリントマネージャの異常検知，JP1連携での環境設定に誤りがあるなど）によってエラーが発生したことが考えられる。該当する表示・印刷サービスを起動しているマシンを再起動し，再実行する。印刷処理の場合は，出力先のプリンタが利用可能であることを確認し，再実行する。
　8　

24576
(6000)₁₆

PC上のXMAP3でビッグエンディアン指定しないで作成したマップをWSで使用した。

CALLインタフェース，またはC言語でのjsvwadrv関数で，指定したパラメタが不正である。例えば，誤った論理マップ名を指定しているなど。

(S):処理を終了する。
(P):

PC XMAP3でビッグエンディアンを指定してマップを再作成し，WSへ転送して利用する。

AP中のjsvwadrv関数を発行している処理で指定したパラメタが正しいかを見直し，再コンパイル後，再実行する。

　8　

24577
(6001)₁₆
CALLインタフェース，またはC言語でのjsvwadrv関数の発行順序が不正である（OPEN要求をしないでほかの要求をした，またはSEND要求をしないでRECEIVE要求をした）。
(S):処理を終了する。
(P):AP中のjsvwadrv関数を発行している処理で発行順序が正しいかを見直し，再コンパイル後，再実行する。
　8　

24578
(6002)₁₆
仮想端末定義ファイル（XMAPhosts）の内容に次に示す不正がある。

1行の終わりに改行が設定されていない。

1行が255バイトを超えている。

下記の各パラメタが形式外
仮想端末名：8文字以内，先頭は英字，英数字を使用
デバイス：指定できる文字は固定
ホスト名：32文字以内
サービス番号：5文字以内
サービス名：40文字以内，半角文字を使用
環境定義ファイル名：64文字以内

(S):処理を終了する。
(P):エラー内容を見直し，再設定する。
　8　

24579
(6003)₁₆
ファイルシステム容量不足や，何らかの原因によって，ログファイルのアクセス中にエラーが発生した。
(S):処理を終了する。
(P):次に示すどちらかの処理をする。

ほかのAPを終了するか，WSを再起動する。

ログファイルを出力するために指定したディレクトリに書き込みできるかを確認する。

　8　

24580
(6004)₁₆
オープン処理，または処理マップロード中に必要なメモリが不足した。
(S):処理を終了する。
(P):ほかのAPを終了するか，WSを再起動する。
　8　

24581
(6005)₁₆
仮想端末定義ファイル（XMAPhosts），マップドライバ環境定義ファイル（XMAPdrv）をアクセス中に入出力エラーが発生した。
(S):処理を終了する。
(P):次に示すどちらかの処理をする。

マップドライバ環境定義ファイルが読めるかを確認し，再実行する。

読めない場合は，アンインストール後に再インストールする。

　8　

24584
(6008)₁₆
COBOLのCALLインタフェースを使ってXMAP3 Serverの画面をアクセスする場合，またはC言語でアクセスする場合，共通インタフェーステーブル中に指定した入力論理マップの大きさが，実際の論理マップの大きさより小さい。
(S):処理を中止する。
(P):APの入力論理マップ長（XMAP-COM-INLNG）設定処理を見直し，再コンパイル後，再実行する。
　8　

注※　デバイスとマップ名の正しい組み合わせを次に示します。

XMAPhostsのデバイス | マップ名
XDSPS1 | ～NC
XDSPM1 | ～ND
XDSP | ～NC，～ND
XPRTL1 | ～6A
XPRTL3 | ～6H
XPRTP1 | ～6B
XPRTP3 | ～6G
XPRT | ～6A，～6B，～6G，～6H

9.4.2　書式オーバレイ印刷時のリターンコード（AIX，HP-UX，Solaris）

書式オーバレイ印刷で発生するリターンコードとエラー詳細コードを説明します。

＜この項の構成＞

(1)　書式オーバレイ印刷でのメッセージとエラーコード

(2)　C言語関数でのリターンコードとエラー詳細コード

(1)　書式オーバレイ印刷でのメッセージとエラーコード

書式オーバレイ印刷でエラーが発生した場合に出力されるメッセージとエラーコードの対応を次の表に示します。対処方法については，「(2)　C言語関数でのリターンコードとエラー詳細コード」の「表9-4　関数のリターンコードとエラー詳細コード」中にある，対応するエラー詳細コードの説明を参照してください。

なお，KBTQ523-Eが出力された場合，KBTQ523-Eのエラー出力より前に，ほかのエラーが発生していないかどうかを確認してください。

表9-3　書式オーバレイ印刷でのメッセージとエラーコードの対応表

メッセージID
メッセージ本文
エラーコード

KBTQ501-E
フィールド制御情報が不正です
(01000004)₁₆

KBTQ502-E
1行内のデータが多過ぎます
(01000005)₁₆

KBTQ503-E
パラメタ不正
(01000001)₁₆，
(00100001)₁₆

KBTQ504-E
ログファイルアクセスエラー
(00100002)₁₆

KBTQ505-E
メモリ不足が発生しました
(01000003)₁₆，
(00100003)₁₆

KBTQ506-E
ページ制御でエラーが発生しました
（エラーコード，エラー詳細コード）
(00010005)₁₆

KBTQ508-E
行配置情報が存在しません
(00010002)₁₆

KBTQ509-E
行配置情報が不正です
(00010003)₁₆

KBTQ510-E
I/Oエラーが発生しました
(00010004)₁₆

KBTQ513-E
XMAP3 Serverが起動されていません
(10000003)₁₆

KBTQ514-E
XMAP3 Serverでメモリ不足が発生しました
(10000004)₁₆

KBTQ515-E
XMAP3 Serverでエラーが発生しました
（エラーコード，エラー詳細コード）
(10000005)₁₆

KBTQ516-E
指定されたプリンタは使用できません
(10000006)₁₆

KBTQ520-E
プリンタに障害が発生しました
(1000000A)₁₆

KBTQ521-E
XMAP3 Serverとの通信路が切断されました
(1000000C)₁₆

KBTQ522-E
XMAP3 Serverでシステムコールエラーが発生しました
(1000000B)₁₆

KBTQ523-E
書式機能がオープンされていません
(01000006)₁₆

KBTQ524-E
書式が存在しません
(00010006)₁₆

KBTQ526-E
上位のバージョンで作成された書式マップは使用できません（書式マップVR：xx-xx-xx）
(00100007)₁₆

KBTQ527-E
上位のバージョンで作成された行制御データファイルは使用できません
（行制御データファイルVR：xx-xx-xx）
(00010007)₁₆

KBTQ532-E
書式マップのエンディアンが実行環境と合っていません
(0010000C)₁₆

(2)　C言語関数でのリターンコードとエラー詳細コード

書式オーバレイ印刷で使用する関数のリターンコードとエラー詳細コードを次に示します。次の表中で使用する記号の意味を次に示します。

(S)：システムの処理

(P)：プログラマの処理

表9-4　関数のリターンコードとエラー詳細コード

関数名称
リターンコード
(lcomrc)
エラー詳細コード
（lcomerr）
要因および対処

エラー詳細
値

jstqlopn
8
JSTQ_XPWSVNAME
268435458
(10000002)₁₆
入出力制御関連エラー：指定されたサービス名称が未登録である，または対応する印刷サービスが作動していない。
(P):サービス名称を確認して再実行する。

8
JSTQ_XPWSRVOFF
268435489
(10000003)₁₆
入出力制御関連エラー：印刷サービスが起動されていない。
(P):サービス名称を確認して再実行する。

jstqlpag
jstqlopn
8
JSTQ_NOPMOD
65538
(00010002)₁₆
行制御データファイルがない。
(P):マップドライバ環境定義ファイル（/etc/opt/HIXMAP/XMAPdrv）のmapPathで指定したディレクトリ，またはAP実行時のカレントディレクトリに行制御データファイルを格納する。

8
JSTQ_PMODERR
65539
(00010003)₁₆
行制御データファイルが不正である。
(P):正しい行制御データファイルを指定する。

8
JSTQ_IOERRP
65540
(00010004)₁₆
I/Oエラーが発生した。
(P):ディスクおよび行制御データファイルの状態を調査する。

jstqldat
jstqlctp
8
JSTQ_LDATL
16777221
(01000005)₁₆
指定できる行データの長さが制限を超えた。
(P):行送りなどを指定して，1行当たりのデータを少なくして再実行する。

JSTQ_HDATL
1048581
(00100005)₁₆

jstqlctp
8
JSTQ_CVALERR
16777220
(01000004)₁₆
文字列制御情報の指定が不正である。
(P):文字サイズ，文字の間隔などの指定を確かめる。

各関数
共通
8
JSTQ_PARMH
1048577
(00100001)₁₆
パラメタエラーが発生した。
(P):パラメタを確認して再実行する。

JSTQ_PARML
16777217
(01000001)₁₆

8
JSTQ_HDOFNOAR
1048579
(00100003)₁₆
エリアの確保時にメモリ不足が発生した。
(P):ほかの処理を終了させ，メモリを空けて再実行する。

JSTQ_LDOFNOAR
16777219
(01000003)₁₆

8
JSTQ_ABNDPMOD
65541
(00010005)₁₆
XMAP3内部のエラーを検出した。

8
JSTQ_XMPNOFORM
65542
(00010006)₁₆
書式が存在しない。
(P):マップドライバ環境定義ファイル（/etc/opt/HIXMAP/XMAPdrv）のmapPathで指定したディレクトリ，またはAP実行時のカレントディレクトリに書式を格納する。

8
JSTQ_HNOPN
1048582
(00100006)₁₆
書式機能がオープンされていない。
(P):関数の呼び出し順序を確認する。

JSTQ_LNOPN
16777222
(01000006)₁₆

8
JSTQ_FORMVERR
1048583
(00100007)₁₆
実行環境のXMAP3より上位のバージョンで作成された書式マップは使用できない。
(S):処理を終了する。
(P):実行環境のXMAP3バージョンを，書式マップの作成時に使用したXMAP3と同じバージョンにし，アプリケーションを再実行する。

8
JSTQ_FORMEDNERR
1048588
(0010000C)₁₆
書式マップのエンディアンが実行環境と合っていない。
(S):処理を終了する。
(P):実行環境に合ったエンディアンとなるように，物理マップを再作成する。

8
JSTQ_PMODVERR
65543
(00010007)₁₆
実行環境のXMAP3より上位のバージョンで作成された行制御データファイルは使用できない。
(S):処理を終了する。
(P):実行環境のXMAP3バージョンを，行制御データファイルの作成時に使用したXMAP3と同じバージョンにし，アプリケーションを再実行する。

8
JSTQ_XPWNOAR
268435460
(10000004)₁₆
入出力制御関連エラー：エリア確保時にメモリ不足が発生した。
(P):ほかの処理を終了させ，メモリを空けて再実行する。

8
JSTQ_XPWERR
268435461
(10000005)₁₆
入出力制御関連エラー：サービス名称がない，または入出力制御内で論理矛盾などが発生した。
(P):

PCクライアントへ印刷する場合，表示・印刷セットアップで指定したプリンタ名およびプリンタが利用可能であるか確認し，再実行する。

WSスタンドアロンで印刷する場合，サービス名ファイル（/etc/opt/HIXMAP/XPWhosts）に指定したデバイス名およびプリンタが利用可能であるか確認し，再実行する。

8
JSTQ_XPWIEPR
268435462
(10000006)₁₆
入出力制御関連エラー：プリンタがほかで使用中のため，排他エラーが発生した。
(P):プリンタの状態を確認して再実行する。

8
JSTQ_XPWERPR
268435466
(1000000A)₁₆
入出力制御関連エラー：プリンタで障害が発生した。
(P):プリンタの状態を確認して障害を回復後，再実行する。

8
JSTQ_XPWSYSC
268435467
(1000000B)₁₆
入出力制御関連エラー：システムコールエラーが発生した。
(P):ログファイルを出力して原因を調査する。

8
JSTQ_XPWDOWN
268435468
(1000000C)₁₆
入出力制御関連エラー：サービス名称がない，または通信路が切断された。
(P):

PCクライアントへ印刷する場合，表示・印刷セットアップで指定したプリンタ名およびプリンタが利用可能であるか確認し，再実行する。

WSスタンドアロンで印刷する場合，サービス名ファイル（/etc/opt/HIXMAP/XPWhosts）に指定したデバイス名およびプリンタが利用可能であるか確認し，再実行する。

印刷サービスを起動し直して再実行する。

9.5　取得する必要がある情報

障害が発生した場合，次の情報ファイルを媒体に取得してください。

＜この節の構成＞

(1)　XMAP3 Serverのトレース情報の取得

(2)　XMAP3 Serverのエラーロギング情報の取得

(3)　TCP/IPネットワーク情報の取得

(4)　その他

(1)　XMAP3 Serverのトレース情報の取得

(a)　印刷サービスのトレース情報の取得

印刷サービスの処理中にエラーが発生し，表示・印刷サービスの動作履歴のトレースを取得する場合には，エラー発生直後に次のコマンドを入力して，トレース情報をファイル出力してください。該当ファイルは，すぐに媒体へ保存するか，または取得時期があとで区別できるような名称で一時的にコピーしておくことで，障害発生直後の資料が残るように配慮してください。

なお，このトレース情報ファイルは，通常稼働時も定期的に出力しています。

/opt/HIXMAP/bin/xptrace　サービス名称

なお，取得できる情報は，通信インタフェースおよびシステムコールです。

トレース情報が格納されているファイルを次に示します。

/var/opt/HIXMAP/.trace/サービス名称

また，次の情報も取得してください。

/usr/tmp/xpw/.remote/.lprmsg_印刷サービス名

(b)　表示・印刷ライブラリのトレース情報の取得

表示・印刷ライブラリのトレースを取得する場合には，アプリケーションプログラムを起動する前に次の環境変数に出力ファイル名を設定してください。

環境変数　XPTRACEFILE

このファイル名を設定した場合，アプリケーションプログラム終了時に，次のファイルに表示・印刷ライブラリのトレース情報格納されます。

/var/opt/HIXMAP/.trace/ファイル名
ファイル名は，環境変数で設定した名称です。

(2)　XMAP3 Serverのエラーロギング情報の取得

XMAP3 Server内でエラーを検出した場合，XMAP3 Serverは次のディレクトリ下にXMAP3 Serverのエラーロギング情報を取得します。このため，エラーが発生した直後は，このディレクトリ下のすべての情報ファイルを媒体に取得してください。

エラーロギング情報が格納されているファイルを次に示します。

/var/opt/HIXMAPディレクトリ下の全ファイル

(3)　TCP/IPネットワーク情報の取得

XMAP3サーバや一般デーモンが起動できない場合，またはネットワーク関係の障害が発生した場合には，次に示す情報を媒体に取得してください。

/etc/hostsファイルの情報

/etc/servicesファイルの情報

netstat -nコマンドの出力結果

OSのTCP/IP定義ファイルの情報

(4)　その他

画面表示および帳票印刷時に画面表示/帳票印刷が正しく実行されない場合，次に示す情報を媒体に取得してください。

PC XMAP3で定義したシート

PC XMAP3で生成した物理マップ（拡張子「.pmp」）のファイル

/usr/tmp/xpwディレクトリのすべてのファイル

画面のハードコピー，または印刷結果

9.6　要因別取得情報の一覧

障害が発生した場合の情報を要因別に次の表に示します。情報の詳細については，「9.5　取得する必要がある情報」を参照してください。

表9-5　障害が発生した場合の情報

現象
情報の種類
その他の情報

A
B
C
D
E
F
G
H

外字が出力されない。
－
－
○
－
－
－
－
○
外字データが定義されているかどうかを確認する。

XMAP3サーバが起動できない。
○
－
－
○
○
－
－
－
TCP/IPの情報を正しく設定しているかどうかを確認する。

画面表示が不正である。
○
○
○
－
－
－
△
－
画面のハードコピーを取得および動作を調査する。

印刷結果が不正である。
○
○
○
－
－
○
△
－
印刷結果を確認する。

XMAP3でアプリケーションエラーが発生する。
○
○
○
－
－
－
△
○
アプリケーションエラー発生時のアドレスおよびワトソンログの情報を取得する。

XMAP3 Serverクライアントが接続できない。
○
－
－
○
○
－
－
－
TCP/IPの設定が正しいかどうかを確認する。
pingコマンドが到達するかどうかを確認する。
ネットワーク構成を調査する。

表示・印刷サービスが起動していない。
○
－
－
○
－
△
－
－
印刷サービスが起動できない場合には，PC上のプリンタ定義情報も取得する。

（凡例）

A：サービス名ファイル（XPWhosts）

B：表示・印刷環境ファイル（XPWconfig）

C：XMAP3 Server定義情報（定義文，物理マップ）

D：TCP/IP情報（/etc/hosts，/etc/services，brc.ipc）

E：ネットワークステータス情報（netstat -nおよびnetstat -Aコマンドの出力結果）

F：プリンタ定義情報（WSの場合：プリンタドライバ情報（printcapファイルなど））（PCの場合：レジストリ情報，プリンタのプロパティのハードコピー）

G：トレース情報

H：ロギング情報

○：取得する情報

△：必要に応じて取得する情報

－：対象外の情報

9.7　AP実行時の詳細エラーコード

AP実行時にトラブルが発生した場合，「9.2　ログ情報の利用方法」に示すログ情報を採取することで原因と対処方法を確認できます。

以降の項で，ログ情報に出力されるXMAP3 Server詳細エラーコードをエラーコード順に紹介します。

以降の項で説明する詳細エラーコード以外のエラーコードについて

以降の項で説明する詳細エラーコード以外のエラーコードについては，「9.5　取得する必要がある情報」にある情報を採取して，弊社問い合わせ窓口に連絡してください。

＜この節の構成＞

9.7.1　詳細エラーコード

9.7.1　詳細エラーコード

詳細エラーコードの障害内容と対応について，エラーコード順に説明します。

表中で使用する記号の意味を次に示します。

(S)：システムの処理
(P)：プログラマの処理

表9-6　エラーコードと詳細エラーコード

エラーコード
詳細エラーコード
エラー内容

1
（TX_CECPARM）
0x01000401
画面出力時のオープン要求がなく，クローズ要求があった。
(S)：処理を終了する。
(P)：「5.1　XMAP3 ServerのAPインタフェース」を参照し，オープン要求が正しく行われているか確認して，アプリケーションを再実行する。

1
（TX_CECPARM）
0x01000501
画面出力時のオープン要求がなく，クローズ要求があった。
(S)：処理を終了する。
(P)：「5.1　XMAP3 ServerのAPインタフェース」を参照し，オープン要求が正しく行われているか確認して，アプリケーションを再実行する。

1
（TX_CECPARM）
0x01001102
表示サービスに対して，帳票印刷時のオープン要求をした。
(S)：処理を終了する。
(P)：仮想端末定義ファイル（XMAPhosts），サービス名ファイル（XPWhosts）に，正しいデバイス情報が設定されているか見直す。

1
（TX_CECPARM）
0x01001108
クライアントのXMAP3（印刷サービス）のバージョンが古い。
(S)：処理を終了する。
(P)：クライアントにXMAP3 Serverで使用できる正しいバージョンをインストールし，該当するXMAP3を再起動して，アプリケーションを再実行する。

1
（TX_CECPARM）
0x0100110a
クライアントのXMAP3（印刷サービス）のバージョンが古い。
(S)：処理を終了する。
(P)：クライアントにXMAP3 Serverで使用できる正しいバージョンをインストールし，該当するXMAP3を再起動して，アプリケーションを再実行する。

1
（TX_CECPARM）
0x01001302
印刷サービスに対して，画面表示時のオープン要求をした。
(S)：処理を終了する。
(P)：仮想端末定義ファイル（XMAPhosts），サービス名ファイル（XPWhosts）に，正しいデバイス情報が設定されているか見直す。

1
（TX_CECPARM）
0x01001501
表示サービスへのオープン要求をしないで画面入力要求をした。
(S)：処理を終了する。
(P)：「5.1　XMAP3 ServerのAPインタフェース」を参照し，アプリケーションの処理でのオープン要求を見直して，アプリケーションを再実行する。

1
（TX_CECPARM）
0x01001c01
表示サービスへのオープン要求をしないでオペレータインジケータへの表示要求をした。
(S)：処理を終了する。
(P)：「5.1　XMAP3 ServerのAPインタフェース」を参照し，アプリケーションの処理でのオープン要求を見直して，アプリケーションを再実行する。

1
（TX_CECPARM）
0x01800102
表示サービスに対して印刷要求した。
(S)：処理を終了する。
(P)：印刷サービスに対して印刷要求するようアプリケーションを見直し，アプリケーションを再実行する。サービス名ファイル（XPWhostsファイル）のサービスタイプを誤って「PRT」に設定していない場合は，サービス名ファイルを変更し，XMAP3サーバを再起動して，アプリケーションを再実行する。

1
（TX_CECPARM）
0x03010201
仮想端末定義ファイル（XMAPhostsファイル）で指定したサービス名称が14文字を超えている。
(S)：処理を終了する。
(P)：サービス名称のけた数を14文字以下に設定して，アプリケーションを再実行する。

2
（TX_CECNOVT）
0x01000504
画面出力時のオープン要求がなく，クローズ要求があった。
(S)：処理を終了する。
(P)：「5.1　XMAP3 ServerのAPインタフェース」を参照し，オープン要求が正しく行われているか確認して，アプリケーションを再実行する。

2
（TX_CECNOVT）
0x01001505
表示サービスへのオープン要求をしないで画面入力要求をした。
(S)：処理を終了する。
(P)：「5.1　XMAP3 ServerのAPインタフェース」を参照し，オープン要求が正しく行われているか確認して，アプリケーションを再実行する。

2
（TX_CECNOVT）
0x0100150f
画面表示を要求しないで入力要求をした。
(S)：処理を終了する。
(P)：「5.1　XMAP3 ServerのAPインタフェース」を参照し，画面表示要求が正しく行われているか確認して，アプリケーションを再実行する。

2
（TX_CECNOVT）
0x01001c06
表示サービスへのオープン要求をしないでオペレータインジケータへの表示要求をした。
(S)：処理を終了する。
(P)：「5.1　XMAP3 ServerのAPインタフェース」を参照し，オープン要求が正しく行われているか確認して，アプリケーションを再実行する。

2
（TX_CECNOVT）
0x01001c18
画面が表示されていない状態で，オペレータインジケータに対する表示要求があった。
(S)：処理を終了する。
(P)：画面表示要求しているか見直し，アプリケーションを再実行する。

3
（TX_CECNOVP）
0x0100150c
画面表示を要求しないで入力要求をした。
(S)：処理を終了する。
(P)：「5.1　XMAP3 ServerのAPインタフェース」を参照し，表示要求をしているか見直して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x010F0102
論理ハードコピーの実行時に，帳票印刷時のオープン要求に対してメモリ不足が発生した。
(S)：論理ハードコピーを中断する。
(P)：不要なプロセスの停止，スワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，論理ハードコピーを再実行する。

5
（TX_CECNOAR）
0x04000208
XPWhosts情報の格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x0400020a
送信データ格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x0400020b
受信データ格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x0400020c
自ホスト名格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x04000218
XPWconfig情報の格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x04000219
XPWconfig情報の格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x0400021a
送信データ格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x0400021b
受信データ格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x0400021c
自ホスト名格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x0400021d
XPWconfig（COGPTH）情報の格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x04000220
XPWconfig（MPPATH）情報の格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x04000236
プリンタ情報格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x0400023a
送信データ格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x0400023b
受信データ格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x0400023c
自ホスト名格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x04000253
メモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x04000255
送信データ格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x04000256
受信データ格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x04000257
自ホスト名格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x0400030a
自ホスト名格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x0400030b
送信（退避）用データ領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x0400030c
送信データ格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x0400030d
受信データ格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x04000314
自ホスト名格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

5
（TX_CECNOAR）
0x04000315
送信データ格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

6
（TX_CECFERR）
0x04000235
印刷処理で不正な通信パケットデータ（XMAP3の通信プロトコルに一致しないデータ）を受信した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

6
（TX_CECFERR）
0x04000241
通常発生しないエラーが発生した。
(S)：処理を終了する。
(P)：アプリケーション内でメモリ破壊が生じたため，アプリケーション側でバッファオーバランなどの処理がないか確認し，アプリケーションを再実行する。メモリ操作に問題がない場合には，「9.5　取得する必要がある情報」を採取して，製品にお問い合わせください。

6
（TX_CECFERR）
0x04000252
不正な通信パケットデータ（XMAP3の通信プロトコルに一致しないデータ）を受信した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

6
（TX_CECFERR）
0x04000254
2回目以降の受信データで，不正な通信パケットデータ（XMAP3の通信プロトコルに一致しないデータ）を受信した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

6
（TX_CECFERR）
0x04000307
不正な通信パケットデータ（XMAP3の通信プロトコルに一致しないデータ）を受信した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

8
（TX_CECIMAP）
（詳細エラーコードを特定しない）
物理マップの内容が破壊されている。原因として，次のことが考えられる。

物理マップをテキストとしてファイル転送したおそれがある。

物理マップファイルが破壊されている。

(S)：処理を終了する。
(P)：ファイル転送に問題がないか確認する。問題がない場合は，物理マップを再作成および再転送して，アプリケーションを再実行する。

9
（TX_CECIMSG）
0x0100160a
一次ウィンドウが表示されていない状態で，二次ウィンドウを表示した。
(P)：画面表示するマップ名が合っているか，または画面の表示順序が合っているかを見直す。

10
（TX_CECDOWN）
0x03020202
XMAP3表示サービスまたはXMAP3印刷サービスからアプリケーションへのデータ受信時，クライアント側からの応答（select()）がタイムアウトした。原因として，アプリケーション実行時の「XRESPONSETIME」環境変数で設定した秒数以上応答がなかったことが考えられる。
(S)：処理を終了する。
(P)：「XRESPONSETIME」環境変数の設定値を調整し，アプリケーションを再実行する。アプリケーションが自動起動の場合は，XMAP3サーバ起動時の「XRESPONSETIME」環境変数の設定値を調整し，XMAP3サーバを再起動して，アプリケーションを再実行する。また，クライアント側で無応答になる要因がないか確認し，再実行する。

10
（TX_CECDOWN）
0x03020203
XMAP3印刷サービスからアプリケーションへのデータ受信時，クライアント側からの応答（select()）がタイムアウトした。原因として，アプリケーション実行時の「XPCLOSEWAITTIME」環境変数で設定した秒数以上応答がなかったことが考えられる。
(S)：処理を終了する。
(P)：「XPCLOSEWAITTIME」環境変数の設定値を調整し，アプリケーションを再実行する。アプリケーションが自動起動の場合は，XMAP3サーバ起動時の「XPCLOSEWAITTIME」環境変数の設定値を調整し，XMAP3サーバを再起動して，アプリケーションを再実行する。また，クライアント側で無応答になる要因がないか確認し，再実行する。

10
（TX_CECDOWN）
0x03020303
XMAP3表示サービスまたはXMAP3印刷サービスへのデータ送信時，クライアント側からの応答（select()）がタイムアウトした。原因として，アプリケーション実行時の「XRESPONSETIME」環境変数で設定した秒数の2倍以上，応答がなかったことが考えられる。
(S)：処理を終了する。
(P)：「XRESPONSETIME」環境変数の設定値を調整し，アプリケーションを再実行する。アプリケーションが自動起動の場合は，XMAP3サーバ起動時の「XRESPONSETIME」環境変数の設定値を調整し，XMAP3サーバを再起動して，アプリケーションを再実行する。また，クライアント側で無応答になる要因がないか確認し，再実行する。

10
（TX_CECDOWN）
0x03020401
TCP/IP通信（recv()）時に，通信相手との接続が切れた。原因として，次のことが考えられる。

XMAP3クライアントを終了した。

クライアントのマシンを終了した。

クライアントのシステムが不安定であった。

通信路に異常があった。

一つの印刷サービスが同時に受け付けられるOPENの数（15回）を超えて，OPEN要求が実行された。

(S)：処理を終了する。
(P)：XMAP3クライアントまたはクライアントマシンを終了していないか確認し，クライアント側のXMAP3を起動し，アプリケーションを再実行する。また，システムが不安定でなかったか，通信路に異常がないか確認する。また，一つの印刷サービスに対して同時にOPENする数を，15回以内にする。

10
（TX_CECDOWN）
0x03020501
TCP/IP通信（send()）時に，通信相手との接続が切れた。原因として，次のことが考えられる。

XMAP3クライアントを終了した。

クライアントのマシンを終了した。

クライアントのシステムが不安定であった。

通信路に異常があった。

(S)：処理を終了する。
(P)：XMAP3クライアントまたはクライアントマシンを終了していないか確認し，クライアント側のXMAP3を起動し，アプリケーションを再実行する。また，システムが不安定でなかったか，通信路に異常がないか確認する。

10
（TX_CECDOWN）
0x03020503
XMAP3表示サービスまたはXMAP3印刷サービスからアプリケーションのデータ送受信時，クライアント側からの応答（select()）のタイムアウトによって，詳細エラーコード0x03020202または0x03020303が発生したため，2回目以降の応答をスキップした。
(S)：処理を終了する。
(P)：詳細エラーコード0x03020202または0x03020303の対応をする。

10
（TX_CECDOWN）
0x03070201
TCP/IP通信時に，通信相手との接続が切れた。原因として，次のことが考えられる。

XMAP3クライアントを終了した。

クライアントのマシンを終了した。

クライアントのシステムが不安定であった。

通信路に異常があった。

(S)：処理を終了する。
(P)：XMAP3クライアントまたはクライアントマシンを終了していないか確認し，クライアント側のXMAP3を起動して，アプリケーションを再実行する。また，システムが不安定でなかったか，通信路に異常がないか確認する。

10
（TX_CECDOWN）
0x04004003
TCP/IP通信（recv()で受信データ0）時に，通信相手との接続が切れた。原因として，次のことが考えられる。

XMAP3クライアントを終了した。

クライアントのマシンを終了した。

クライアントのシステムが不安定であった。

通信路に異常があった。

(S)：処理を終了する。
(P)：XMAP3クライアントまたはクライアントマシンを終了していないか確認し，クライアント側のXMAP3を起動して，アプリケーションを再実行する。また，システムが不安定でなかったか，通信路に異常がないか確認する。

10
（TX_CECDOWN）
0x04004005
TCP/IP通信（send()で送信データ0）時に，通信相手との接続が切れた。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

10
（TX_CECDOWN）
0x04004007
XMAP3サーバからアプリケーションへのデータ受信時，XMAP3サーバからの応答（select()）がタイムアウトでエラーが発生した。

アプリケーション実行時の「XRESPONSETIME」環境変数で設定した秒数以上応答がなかった。

(S)：処理を終了する。
(P)：アプリケーション起動時の「XRESPONSETIME」環境変数の設定値を調整し，アプリケーションを再実行する。アプリケーションが自動起動の場合は，XMAP3サーバ起動時の「XRESPONSETIME」環境変数の設定値を調整し，XMAP3サーバを再起動して，アプリケーションを再実行する。また，一つのXMAP3サーバに対して複数クライアントの接続などの負荷が集中していないか，システムおよびネットワークに問題がないか確認する。

14
（TX_CECSVRC）
（詳細エラーコードを特定しない）
XMAP3 Server内部処理で何らかの異常が発生したため，サーバ内のプログラムに論理矛盾が起きた。
(P)：システム的な要因が原因である（システムリソースの異常・ほかのAPでの異常）ことが考えられる。WSを再起動・再実行する。ログファイルを出力して，原因を調査する。

16
（TX_CECSVSY）
0x04000258
システムコール（open()）でエラーが発生した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムに問題がないか確認し，アプリケーションを再実行する。

16
（TX_CECSVSY）
0x04000259
システムコール（_stat()）でエラーが発生した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムに問題がないか確認し，アプリケーションを再実行する。

16
（TX_CECSVSY）
0x04000260
外字変換テーブル（cnv_map_tbl）格納領域のメモリ確保に失敗した。
(S)：処理を終了する。
(P)：不要なプロセスの停止やスワップ領域の拡張，物理メモリの増設などによってシステムのメモリ不足を解決し，XMAP3サーバを再起動して，アプリケーションを再実行する。

16
（TX_CECSVSY）
0x04000261
外字変換テーブル（cnv_map_tbl）読み込み時のシステムコール（_read()）でエラーが発生した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムに問題がないか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

20
（TX_CECNEPR）
0x01000303
帳票印刷時のオープン要求がなく，クローズ要求があった。
(S)：処理を終了する。
(P)：「5.1　XMAP3 ServerのAPインタフェース」を参照し，アプリケーション側で，オープン要求をしないでクローズ要求をしていないか（オープン要求が正しく行われているか）確認して，アプリケーションを再実行する。

20
（TX_CECNEPR）
0x01001404
印刷サービスへのオープン要求をしないで印刷要求をした。
(S)：処理を終了する。
(P)：「5.1　XMAP3 ServerのAPインタフェース」を参照し，オープン要求が正しく行われているか確認して，アプリケーションを再実行する。

20
（TX_CECNEPR）
0x01800104
印刷サービスへのオープン要求をしないで印刷要求をした。
(S)：処理を終了する。
(P)：「5.1　XMAP3 ServerのAPインタフェース」を参照し，オープン要求が正しく行われているか確認して，アプリケーションを再実行する。

20
（TX_CECNEPR）
0x01801f03
オープン要求しないで印刷要求をした。
(S)：処理を終了する。
(P)：「5.1　XMAP3 ServerのAPインタフェース」を参照し，オープン要求が正しく行われているか確認して，アプリケーションを再実行する。

23
（TX_CECNSND）
0x0100150d
画面表示を要求しないで入力要求をした。
(S)：処理を終了する。
(P)：「5.1　XMAP3 ServerのAPインタフェース」を参照し，表示要求をしているか見直して，アプリケーションを再実行する。

25
（TX_CECPROP）
0x01001103
一つの印刷サービスに対して，同時に複数のオープンが実行された。
(S)：処理を終了する。
(P)：一つの印刷サービスに対して，複数のオープンを実行する場合には，いったんクローズした上でオープンする。「5.1　XMAP3 ServerのAPインタフェース」を参照し，処理を見直してアプリケーションを再実行する。

26
（TX_CECIEPR）
0x01001106
印刷する対象の印刷サービスが別のアプリケーションで使用されている。
(S)：処理を終了する。
(P)：印刷サービスが使用できるようになってから，アプリケーションを再実行する。

26
（TX_CECIEPR）
0x010f0201
印刷する対象の印刷サービスが別のアプリケーションで使用されている。
(S)：処理を終了する。
(P)：印刷サービスが使用できるようになってから，アプリケーションを再実行する。

27
（TX_CECNOOF）
0x01001c0e
オペレータインジケータが表示されていない画面に対し，オペレータインジケータに対する表示要求があった。
(S)：処理を終了する。
(P)：オペレータインジケータに表示要求する場合は，オペレータインジケータを表示する物理マップを再作成して，アプリケーションを実行する。

29
（TX_CECSYTM）
0x03020201
TCP/IP通信で，アプリケーションがクライアントからのデータを受信しようとした際，クライアントからのイベント待ち（select()）時にエラーが発生した。
(S)：処理を終了する。
(P)：システムに負荷が掛かっていた場合，負荷を取り除いてアプリケーションを再実行する。または，システムおよびネットワークに問題がないか確認する。

29
（TX_CECSYTM）
0x03020301
TCP/IP通信で，アプリケーションがクライアントへデータを送信しようとした際，クライアントからのイベント待ち（select()）時にエラーが発生した。
(S)：処理を終了する。
(P)：システムに負荷が掛かっていた場合，負荷を取り除いてアプリケーションを再実行する。または，システムおよびネットワークに問題がないか確認する。

29
（TX_CECSYTM）
0x03020402
TCP/IP通信（recv()）時に，通信相手との接続が切れた（コネクションの切断またはリセットされた）。原因として，次のことが考えられる。

XMAP3クライアントを終了した。

クライアントのマシンを終了した。

クライアントのシステムが不安定であった。

通信路に異常があった。

一つの表示サービスまたは印刷サービスが同時に受け付けられるOPENの数（15回）を超えて，OPEN要求が実行された。

(S)：処理を終了する。
(P)：XMAP3クライアントまたはクライアントマシンを終了していないか確認して，クライアント側のXMAP3を起動し，アプリケーションを再実行する。また，システムが不安定でなかったか，通信路に異常がないか確認する。また，一つの表示サービスまたは印刷サービスに対して同時にOPENする数を，15回以内にする。

29
（TX_CECSYTM）
0x03020502
TCP/IP通信（send()）時に，通信相手との接続が切れた（コネクションの切断またはリセットされた）。原因として，次のことが考えられる。

XMAP3クライアントを終了した。

クライアントのマシンを終了した。

通信路に異常があった。

(S)：処理を終了する。
(P)：XMAP3クライアントまたはクライアントマシンを終了していないか確認し，該当しない場合は，通信路に異常がないか見直し，クライアント側のXMAP3を起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x03020601
システムコール（gethostname()）でエラーが発生した。原因として，実行中にホスト名称を変更したことが考えられる。
(S)：処理を終了する。
(P)：実行中にホスト名（/etc/hostsファイル）を変更していないか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x03020602
システムコール（gethostbyname()）でエラーが発生した。原因として，次のことが考えられる。

実行中にホスト名称を変更した。

クライアントのホスト名が登録されていない。

(S)：処理を終了する。
(P)：実行中にホスト名（/etc/hostsファイル）を変更していないか，またクライアントのホスト名が登録されているか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x03020603
システムコール（gethostbyname()）でエラーが発生した。原因として，次のことが考えられる。

実行中にホスト名称を変更した。

クライアントのホスト名が登録されていない。

(S)：処理を終了する。
(P)：実行中にホスト名（/etc/hostsファイル）を変更していないか，またクライアントのホスト名が登録されているか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x03020604
システムコール（socket()）でエラーが発生した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x03020605
システムコール（setsockopt()）でエラーが発生した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x03020606
システムコール（connect()）でエラーが発生した。
(S)：処理を終了する。
(P)：サービス名ファイル（XPWhosts）に定義されたクライアントマシンのホスト名とIPアドレスが，サーバ側のホストアドレス管理ファイル（/etc/hosts）に正しく記述されているかどうかを見直し，間違っている場合は，正しく設定して，アプリケーションを再実行する。また，システムで使用できるソケットが不足したことが考えられるため，使用できるソケット数を見直す。また，クライアント側が何らかの要因によって通信が接続拒否されていないか確認し，クライアント側のXMAP3を再起動して，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x03020607
システムコール（bind()）でエラーが発生した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x03020608
システムコール（select()）でエラーが発生した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x03020609
システムコール（getsockopt()）でエラーが発生した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x03020a01
システムコール（shmdt()）でエラーが発生した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムに問題がないか確認し，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x03050103
クライアント側の表示・印刷サービス，またはサーバ側の印刷サービスの実行時にシステム障害が発生した。
(S)：処理を終了する。
(P)：「9.5　取得する必要がある情報」を採取して，弊社問い合わせ窓口に連絡してください。印刷の場合には，出力先のプリンタやプリンタドライバが正しく動作するかを確認してください。

29
（TX_CECSYTM）
0x03070202
システムコール（read()）でエラーが発生した。原因として，次のことが考えられる。

XMAP3クライアントを終了した。

クライアントのマシンを終了した。

クライアントのシステムが不安定であった。

通信路に異常があった。

(S)：処理を終了する。
(P)：XMAP3クライアントまたはクライアントマシンを終了していないか確認し，クライアント側のXMAP3を起動して，アプリケーションを再実行する。また，システムが不安定でなかったか，通信路に異常がないか確認する。

29
（TX_CECSYTM）
0x03070301
システムコール（select()）でエラーが発生した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000101
システムコール（gethostname()）でエラーが発生した。原因として，実行中にホスト名称を変更したことが考えられる。
(S)：処理を終了する。
(P)：実行中にホスト名（/etc/hostsファイル）を変更していないか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000102
システムコール（gethostbyname()）でエラーが発生した。原因として，次のことが考えられる。

実行中にホスト名称を変更した。

クライアントのホスト名が登録されていない。

(S)：処理を終了する。
(P)：実行中にホスト名（/etc/hostsファイル）を変更していないか，またクライアントのホスト名が登録されているか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000103
システムコール（gethostbyname()）でエラーが発生した。原因として，次のことが考えられる。

実行中にホスト名称を変更した。

クライアントのホスト名が登録されていない。

(S)：処理を終了する。
(P)：実行中にホスト名（/etc/hostsファイル）を変更していないか，またクライアントのホスト名が登録されているか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000104
システムコール（socket()）でエラーが発生した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認する。問題解決後，XMAP3，アプリケーションを再実行または再起動する。

29
（TX_CECSYTM）
0x04000105
システムコール（connect()）でエラーが発生した。
(S)：処理を終了する。
(P)：システムで使用できるソケットが不足したことが考えられるため，使用できるソケット数を見直す。また，クライアント側で何らかの要因によって通信が接続拒否されていないか確認し，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000106
システムコール（bind()）でエラーが発生した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000107
通信相手のホストアドレス取得時に，システムコール（gethostbyname()）でエラーが発生した。原因として，次のことが考えられる。

実行中にホスト名称を変更した。

クライアントのホスト名が登録されていない。

(S)：処理を終了する。
(P)：実行中にホスト名（/etc/hostsファイル）を変更していないか，またクライアントのホスト名が登録されているか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000121
システムコール（shutdown()）でエラーが発生した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000122
システムコール（close()）でエラーが発生した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000131
オープン要求時のホスト名称が127文字以下になっていない。
(S)：処理を中断する。
(P)：ホスト名称のけた数を見直して，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000132
通信相手のホスト名称取得時のシステムコール（gethostname()）でエラーが発生した。原因として，実行中にホスト名称を変更したことが考えられる。
(S)：処理を終了する。
(P)：実行中にホスト名（/etc/hostsファイル）を変更していないか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000133
自ホスト名称取得時のシステムコール（gethostname()）でエラーが発生した。原因として，実行中にホスト名称を変更したことが考えられる。
(S)：処理を終了する。
(P)：実行中にホスト名（/etc/hostsファイル）を変更していないか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000134
自ホストアドレス取得時のシステムコール（gethostbyname()）でエラーが発生した。原因として，次のことが考えられる。

実行中にホスト名称を変更した。

クライアントのホスト名が登録されていない。

(S)：処理を終了する。
(P)：実行中にホスト名（/etc/hostsファイル）を変更していないか，またクライアントのホスト名が登録されているか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000135
通信相手のホストアドレス取得時のシステムコール（gethostbyname()）でエラーが発生した。原因として，次のことが考えられる。

実行中にホスト名称を変更した。

クライアントのホスト名が登録されていない。

(S)：処理を終了する。
(P)：実行中にホスト名（/etc/hostsファイル）を変更していないか，またクライアントのホスト名が登録されているか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000136
システムコール（getservbyname()）でエラーが発生した。原因として，「XPW_DAEMON_PORT_NO」環境変数に設定したサービス名が，servicesファイルに存在しないことが考えられる。
(S)：処理を終了する。
(P)：「XPW_DAEMON_PORT_NO」環境変数とservicesファイルを確認し，再実行する。また，実行中にポート名（/etc/servicesファイル）を変更していないか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000137
システムコール（socket()）でエラーが発生した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000138
システムコール（bind()）でエラーが発生した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000139
システムコール（gethostbyname()）でエラーが発生した。原因として，次のことが考えられる。

実行中にホスト名称を変更した。

クライアントのホスト名が登録されていない。

(S)：処理を終了する。
(P)：実行中にホスト名（/etc/hostsファイル）を変更していないか，またクライアントのホスト名が登録されているか確認し，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x0400013a
システムコール（connect()）でエラーが発生した。原因として，次のことが考えられる。

XMAP3サーバを-servicesオプションで複数起動している場合，XMAP3サーバ起動時の「XPW_DAEMON_PORT_NO」環境変数を設定していないか，サービス名の指定に誤りがある。

システムで使用できるソケットが不足した。

(S)：処理を終了する。
(P)：XMAP3サーバを複数起動している場合，「XPW_DAEMON_PORT_NO」環境変数が正しいか確認する。また，システムで使用できるソケット数を見直し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000202
システムコール（gethostname()）でエラーが発生した。原因として，実行中にホスト名称を変更したことが考えられる。
(S)：処理を終了する。
(P)：実行中にホスト名（/etc/hostsファイル）を変更していないか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000203
オープン要求で指定したサービス名称に0x00が指定されている。
(S)：処理を終了する。
(P)：オープン要求で指定したサービス名を確認し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000204
オープン要求で指定したサービス名称のけた数が不正である。
(S)：処理を終了する。
(P)：オープン要求で指定したサービス名を確認し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000205
オープン要求で指定したサービス名称が指定されていない。
(S)：処理を終了する。
(P)：オープン要求で指定したサービス名を確認し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000206
不正な通信パケットデータ（エラープロトコル）を受信した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000207
不正な通信パケットデータ（XMAP3の通信プロトコルに一致しないデータ）を受信した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000212
システムコール（gethostname()）でエラーが発生した。原因として，実行中にホスト名称を変更したことが考えられる。
(S)：処理を終了する。
(P)：実行中にホスト名（/etc/hostsファイル）を変更していないか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000216
通信データとしてエラーデータを受信した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000217
XMAPの環境設定データを受信中に不正な通信パケットデータ（XMAP3の通信プロトコルに一致しないデータ）を受信した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000231
自ホスト名称取得時のシステムコール（gethostname()）でエラーが発生した。原因として，実行中にホスト名称を変更したことが考えられる。
(S)：処理を終了する。
(P)：実行中にホスト名（/etc/hostsファイル）を変更していないか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000251
自ホスト名称取得時のシステムコール（gethostname()）でエラーが発生した。原因として，実行中にホスト名称を変更したことが考えられる。
(S)：処理を終了する。
(P)：実行中にホスト名（/etc/hostsファイル）を変更していないか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000263
外字変換テーブル（cnv_map_tbl）が壊れている。原因として，ファイルサイズが5,120バイトでないことが考えられる。
(S)：処理を終了する。
(P)：XMAP3 Serverを再インストールしたあとに，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000301
システムコール（gethostname()）でエラーが発生した。原因として，実行中にホスト名称を変更したことが考えられる。
(S)：処理を終了する。
(P)：実行中にホスト名（/etc/hostsファイル）を変更していないか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000305
システムコール（gethostbyname()）でエラーが発生した。原因として，次のことが考えられる。

実行中にホスト名称を変更した。

クライアントのホスト名が登録されていない。

(S)：処理を終了する。
(P)：実行中にホスト名（/etc/hostsファイル）を変更していないか，またクライアントのホスト名が登録されているか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04000308
自ホスト名称取得時のシステムコール（gethostname()）でエラーが発生した。

実行中にホスト名称を変更した。

(S)：処理を終了する。
(P)：実行中にホスト名（/etc/hostsファイル）を変更していないか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04004001
TCP/IP通信データ受信時にシステムコール（select()）で「システム割り込み」以外のエラーが発生した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04004002
TCP/IP通信データ送信時にシステムコール（select()）で「システム割り込み」以外のエラーが発生した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04004004
TCP/IP通信データ受信時にシステムコール（recv()）で，割り込みエラーが発生した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

29
（TX_CECSYTM）
0x04004006
TCP/IP通信データ送信時にシステムコール（send()）で，割り込みエラーが発生した。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，アプリケーションを再実行する。問題が解決しない場合は，XMAP3サーバを再起動し，アプリケーションを再実行する。

31
（TX_CECVTOV）
0x01001303
一つの表示サービスに対して，16個以上の画面を同時に表示する要求をした。
(S)：処理を終了する。
(P)：一つの表示サービスに対して，同時に表示する画面が15個以下になるよう見直し，アプリケーションを再実行する。

34
（TX_CECIPSV）
0x010f0101
XPWconfigの「DCPSNM」に印刷サービス名称が指定されていない。
(S)：処理を終了する。
(P)：XPWconfigの「DCPSNM」に帳票出力する印刷サービス名称を設定して，XMAP3サーバを再起動して，アプリケーションを再実行する。

34
（TX_CECIPSV）
0x010f0103
XPWconfigの「DCPSNM」に指定されている印刷サービスが起動されていない。
(S)：処理を終了する。
(P)：該当する印刷サービスを起動して，XMAP3サーバを再起動して，アプリケーションを再実行する。

34
（TX_CECIPSV）
0x010f0104
XPWconfigの「DCPSNM」に表示サービスが指定されている。
(S)：処理を終了する。
(P)：XPWconfigの「DCPSNM」に帳票出力する印刷サービス名称を設定して，XMAP3サーバを再起動して，アプリケーションを再実行する。

35
（TX_CECNOSV）
0x03010301
サービス名称がXPWhostsに設定されていない。
(S)：処理を終了する。
(P)：指定されたサービス名称がXPWhostsに設定されているか，またはXPWhostsに設定しているサービスのタイプ（DSP／PRT）が間違っていないか確認して，XMAP3サーバを再起動して，アプリケーションを再実行する。

35
（TX_CECNOSV）
0x03010303
XPWhostsのホスト名に「*」を設定してあるサービス名をアプリケーションから指定し，該当するサービスがXMAP3クライアントの起動オプションで「/attach」を指定して起動されていない。または，XMAP3サーバ再起動時の自動起動APで｢/attach｣の情報がXMAP3サーバから取得できなかった。
(S)：処理を終了する。
(P)：該当するサービス名称を，XMAP3クライアントの「/attach」オプションで起動したあと，サービスが起動している状態で，アプリケーションを再実行する。XMAP3サーバ再起動時の自動起動APでエラーが発生する場合はXMAP3クライアントを再起動する。自動起動APでエラーが発生しないようにXMAP3サーバを再起動するには，XMAP3クライアントを終了させて，XMAP3サーバを再起動したあとにXMAP3クライアントを起動する。

35
（TX_CECNOSV）
0x04000209
サービス名称がXPWhostsに設定されていないか，サービス名称に該当する表示・印刷サービスが起動していない。
(S)：処理を終了する。
(P)：指定されたサービス名称がXPWhostsに設定されているか，該当する表示・印刷サービスが起動しているか確認して，XMAP3サーバを再起動，または，表示・印刷サービスを起動させて，アプリケーションを再実行する。

35
（TX_CECNOSV）
0x04000221
受信データにXPWconfig情報がない。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，XMAP3サーバを再起動して，アプリケーションを再実行する。

35
（TX_CECNOSV）
0x04000237
印刷処理で，プリンタ情報が受信できなかった。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，アプリケーションを再実行する。

35
（TX_CECNOSV）
0x0400023d
プリンタ情報が取得できなかった。
(S)：処理を終了する。
(P)：システム負荷が発生していないか，システムおよびネットワークに問題がないか確認し，アプリケーションを再実行する。

36
（TX_CECIVER）
0x01007215
使用しているXMAP3 Serverのバージョンより上位のバージョンで作成した物理マップが使用された。
(S)：処理を終了する。
(P)：物理マップの作成バージョンを確認し，XMAP3 Serverのバージョンより上位のバージョンの場合は，XMAP3 Serverで実行できるバージョンで物理マップを再作成して，アプリケーションを再実行する。

36
（TX_CECIVER）
0x01007217
使用しているXMAP3 Serverのバージョンより上位のバージョンで作成した物理マップが使用された。
(S)：処理を終了する。
(P)：物理マップの作成バージョンを確認し，XMAP3 Serverのバージョンより上位のバージョンの場合は，XMAP3 Serverで実行できるバージョンで物理マップを再作成して，アプリケーションを再実行する。

36
（TX_CECIVER）
0x01720115
使用しているXMAP3 Serverのバージョンより上位のバージョンで作成した物理マップが使用された。
(S)：処理を終了する。
(P)：物理マップの作成バージョンを確認し，XMAP3 Serverのバージョンより上位のバージョンの場合は，XMAP3 Serverで実行できるバージョンで物理マップを再作成して，アプリケーションを再実行する。

36
（TX_CECIVER）
0x0172020b
使用しているXMAP3 Serverのバージョンより上位のバージョンで作成した物理マップが使用された。
(S)：処理を終了する。
(P)：物理マップの作成バージョンを確認し，XMAP3 Serverのバージョンより上位のバージョンの場合は，XMAP3 Serverで実行できるバージョンで物理マップを再作成して，アプリケーションを再実行する。

36
（TX_CECIVER）
0x01720305
使用しているXMAP3 Serverのバージョンより上位のバージョンで作成した物理マップが使用された。
(S)：処理を終了する。
(P)：物理マップの作成バージョンを確認し，XMAP3 Serverのバージョンより上位のバージョンの場合は，XMAP3 Serverで実行できるバージョンで物理マップを再作成して，アプリケーションを再実行する。

36
（TX_CECIVER）
0x01720407
使用しているXMAP3 Serverのバージョンより上位のバージョンで作成した物理マップが使用された。
(S)：処理を終了する。
(P)：物理マップの作成バージョンを確認し，XMAP3 Serverのバージョンより上位のバージョンの場合は，XMAP3 Serverで実行できるバージョンで物理マップを再作成して，アプリケーションを再実行する。

36
（TX_CECIVER）
0x01800101
クライアントのXMAP3（印刷サービス）のバージョンが古い。
(S)：処理を終了する。
(P)：クライアントにXMAP3 Serverで使用できる正しいバージョンをインストールして，該当するXMAP3を再起動して，アプリケーションを再実行する。

37
（TX_CECERHD）
0x03050102
クライアント側の表示・印刷サービス，またはサーバ側の印刷サービスの実行時にシステム障害が発生した。
(S)：処理を終了する。
(P)：「9.5　取得する必要がある情報」を採取して，弊社問い合わせ窓口に連絡する。印刷の場合には，出力先のプリンタやプリンタドライバが正しく動作するかを確認する。

9.8　XMAP3サーバが出力するメッセージ

この節では，XMAP3サーバが出力するメッセージの出力形式，各メッセージの意味と対処方法，およびエラー発生時に出力されるエラーコードについて説明します。

＜この節の構成＞

9.8.1　メッセージの形式

9.8.2　メッセージの一覧

9.8.3　エラーコードの一覧

9.8.1　メッセージの形式

＜この項の構成＞

(1)　syslogへの出力タイミング

(2)　syslogの出力形式

(1)　syslogへの出力タイミング

syslogへメッセージを出力するタイミングは次のとおりです。

XMAP3サーバの起動時

XMAP3サーバの停止時

XMAP3サーバのエラー発生時

(2)　syslogの出力形式

syslogの出力形式を次に示します。△は半角スペースを示します。

MMM△DD△hh:mm:ss△ホストマシン名△[PID]:KBXPnnn00-Z△メッセージテキスト

syslogの出力項目の意味を次に示します。

MMM

出力月を英語3文字で出力します（例：10月の場合「Oct」）。

DD

出力日を出力します。

hh:mm:ss

出力時刻を「時:分:秒」形式で出力します。

PID

プロセスIDを出力します。

KBXPnnn00-Z

メッセージIDとして次の内容を出力します。

KBXP：XMAP3サーバのメッセージであることを示しています。

nnn：500～599の範囲で，メッセージの番号が表示されます。

00：WS系であることを示しています。

Z：メッセージの種類として次の内容が表示されます。

I：通知メッセージ

E：エラーメッセージ

W：警告メッセージ

Q：応答メッセージ

K：処理継続メッセージ

メッセージテキスト

各メッセージのテキスト情報を表示します。

AIXでは，メッセージテキストが511バイトを超える場合，512バイト以降のメッセージテキストは次の行に出力します。511バイト目がマルチバイト文字の1バイト目である場合は，その文字は次の行に出力されます。

例えば，次のメッセージの1行目は「xpwdaemon」～「XPWc」までが511バイトのケースです。この場合，下線部のように単語が分断され，以降のメッセージテキストは2行目に出力されます。

Oct 26 10:25:35 host1 [33684]:KBXP53600-I xpwdaemon start up :xpwdaemon … XPWc
Oct 26 10:25:35 host1 [33684]:KBXP53600-I onfig -x /etc/opt/HIXMAP/XPWhosts

9.8.2　メッセージの一覧

XMAP3サーバで標準出力およびsyslogファイルに出力されるメッセージを次に示します。なお，接続管理テーブル数が1,025個を超えた場合は，syslogファイルだけに出力されます。

表9-7　XMAP3サーバの出力メッセージ

項番
出力メッセージ
メッセージの意味と対処方法

1
KBXP53600-I xpwdaemon start up :xpwdaemonの起動コマンドライン
XMAP3サーバを起動しました。

2
KBXP53700-I xpwdaemon stop シグナル名(コード) :xpwdaemonの起動コマンドライン
XMAP3サーバを停止しました。
「シグナル名(コード)」には受信したシグナルを表示します。

3
KBXP5????-? xpwdaemon:cannot get hostname
自ホスト名称の取得に失敗しました。

（S）XMAP3サーバを終了させます。

（U）/etc/hostsに正しいホスト名称とホストアドレスを設定してください。

4
KBXP5????-? xpwdaemon:cannot open /etc/opt/HIXMAP/XPWhosts
サービス名ファイルのオープンに失敗しました。

（S）XMAP3サーバを終了させます。

（U）サービス名ファイルがあることを確認し，モードを読み込み可にしてください。

5
KBXP5????-? xpwdaemon:data too long
サービス名ファイル，または表示・印刷環境ファイルの1行のデータが511文字を超えています。

（S）該当するサーバを起動しません。

（U）1行のデータを511文字以内に修正してください。

6
KBXP5????-? xpwdaemon:/etc/opt/HIXMAP/XPWhosts is empty
サービス名ファイルに有効行がありません。

（S）XMAP3サーバを終了させます。

（U）サービス名ファイルを正しく設定してください。

7
KBXP5????-? xpwdaemon:cannot open socket（タイプ）
ソケットのオープンに失敗しました。

（S）XMAP3サーバを終了させます。

（U）/etc/servicesのXMAP3 Serverに対応するポート番号に，ほかのサービスと重複しない番号を設定してください。

8
KBXP5????-? xpwdaemon:cannot allocate memory
メモリの確保に失敗しました。

（S）XMAP3サーバを終了させます。

（U）XMAP3サーバを起動するために十分なメモリを用意してください。

9
KBXP5????-? xpwdaemon:already started
XMAP3サーバを重複して起動しようとしました。

（S）重複したXMAP3サーバを終了させます。

（U）XMAP3サーバをすでに起動していないかどうか確認してください。すでに起動されているXMAP3サーバがなければ，/etc/servicesのXMAP3サーバに対応するポート番号にほかのサービスと重複しない番号に変更してください。

10
KBXP5????-? xpwdaemon:cannot fork process
プロセスの生成に失敗しました。

（S）指定の印刷サービス，またはサービス名ファイルに指定したAPを起動しません。

（U）XMAP3サーバを，いったん終了してから，XMAP3サーバを再起動してください。

11
KBXP5????-? xpwdaemon:cannot execute server
印刷サービスの実行に失敗しました。

（S）指定の印刷サービスを起動しません。

（U）サービス名ファイルに指定したプリンタデバイスが正しいか確認してください。また，プリンタが正しい場合には，XMAP3 Serverを正しくインストールしているか確認してから，XMAP3サーバを再起動してください。

12
KBXP5????-? xpwdaemon:internal error
XMAP3サーバの内部処理でロジック不正が発生しました。

（S）XMAP3を終了します。

（U）XMAP3を再起動してください。

13
KBXP5????-? xpwdaemon:cannot find HOSTNAME's service
起動対象のサービスがありません。

（S）サービスを起動しません。

（U）自ホストで使用する印刷サービスがあれば，サービス名ファイルに起動するサービスを記述してください。

14
KBXP5????-? xpwdaemon:connection クライアントホスト名 timed out
クライアントとのコネクションがタイムアウトしました。

（S）コネクションを切断します。

（U）通信環境を見直してください。

15
KBXP5????-? xpwdaemon:xpw is not defined(/etc/services)
ポート番号が定義されていません。

（S）XMAP3サーバを終了します。

（U）/etc/servicesに，使用するポートを定義してください。

16
KBXP5????-? xpwdaemon:Requested service（サービス名） is already used.（XXXXXXXXYYYYYYYY）
割り当てが要求された表示・印刷サービスは，ほかのクライアントで使用中です。

XXXXXXXX：すでに接続中のIPアドレス

YYYYYYYY：新しく接続しようとしたIPアドレス

IPアドレスは16進数で出力されます。2文字（XXまたはYY）ごとに10進数に置き換えてください。

（S）割り当て要求を拒否します。

（U）特定のクライアントだけでそのサービスを使用するようにしてください。

または，クライアントマシンの強制的なシャットダウンや，ネットワークの一時的な停止などによって，前回接続したサービスの情報がXMAP3サーバに残っていることが考えられます。その場合は次のどちらかの方法で，XMAP3サーバ上に残っているサービスの情報をクリアしてください。

XMAP3サーバ（xpwdaemon）を再起動する。

メッセージに出力された接続中のIPアドレスからマシンを特定する。次に，そのマシンからエラーとなっているサービス名を指定してXMAP3クライアントを起動し，すぐにXMAP3クライアントを停止させる。

17
KBXP5????-? xpwdaemon:must be exec with -s option.(XMAP3 Server)
-sオプションが指定されないでxpwdaemonが起動されました。

（S）XMAP3サーバを終了します。

（U）-sオプションを指定して，XMAP3サーバを起動してください。

18
KBXP5????-? xpwdaemon:cannot find（仮想ホスト名）
起動時に指定した仮想ホスト名が，/etc/hostsファイルに定義されていません。

（S）XMAP3サーバを終了します。

（U）/etc/hostsに正しい仮想ホスト名が定義されているかどうか確認してください。

19
KBXP51000-E xpwdaemon:
The socket generation for UDP failed
UDP用のソケット生成に失敗しました。次の原因が考えられます。

システムコール（gethostbyname()）でエラーが発生した。

システムコール（getservbyname()）でエラーが発生した（servicesファイルにポート番号が指定されていない）。
この場合，次のメッセージも一緒に出力される。
「KBXP57000-E xpwdaemon:サービス名 is not defined(/etc/services)」

システムコール（socket()）でエラーが発生した。
この場合，次のメッセージも一緒に出力される。「KBXP55100-E xpwdaemon:cannot open socket(SOCK_DGRAM)」

XMAP3サーバが重複起動されている。または，ほかで使用されているポート番号を指定している。
この場合，次のメッセージも一緒に出力される。
「KBXP57100-E xpwdaemon:already started」

（S）XMAP3サーバを終了させます。

（U）次の処理のうち，どれかを行ってください。

ホスト名の設定を見直し，XMAP3サーバを再起動する。

serviceファイルにポート番号を設定し，XMAP3サーバを再起動する。

IPアドレスの設定を見直し，XMAP3サーバを再起動する。

XMAP3サーバが起動されているかを確認する。
XMAP3サーバが起動されている場合は，XMAP3サーバを終了，再起動する。
XMAP3サーバが起動されていない場合は，servicesファイルで設定したポート番号が重複していないかどうかを確認し，XMAP3サーバを再起動する。

20
KBXP51700-E xpwdaemon:
The socket generation for TCP failed
TCP用のソケット生成に失敗しました。次の原因が考えられます。

システムコール（gethostbyname()）でエラーが発生した。

システムコール（getservbyname()）でエラーが発生した（servicesファイルにポート番号が指定されていない）。
この場合，次のメッセージも一緒に出力される。
「KBXP57000-E xpwdaemon:サービス名 is not defined(/etc/services)」

システムコール（socket()）でエラーが発生した。
この場合，次のメッセージも一緒に出力される。
「KBXP55300-E xpwdaemon:cannot open socket(SOCK_STREAM)」

ほかで使用されているポート番号を指定している場合には，次のメッセージも一緒に出力される。
「KBXP57300-E xpwdaemon:already started」

（S）XMAP3サーバを終了させます。

（U）次の処理のうち，どれかを行ってください。

ホスト名の設定を見直し，XMAP3サーバを再起動する。

serviceファイルにポート番号を設定し，XMAP3サーバを再起動する。

IPアドレスの設定を見直し，XMAP3サーバを再起動する。

servicesファイルで設定したポート番号が重複していないかどうかを確認し，XMAP3サーバを再起動する。

21
KBXP51800-E xpwdaemon:
The return value of a listen() function is less than zero
listen()関数の戻り値が0未満です。

（S）XMAP3サーバを終了させます。

（U）通信情報の設定を見直し，XMAP3サーバを再起動してください。

22
KBXP51900-E xpwdaemon:
Reading of a service name file (XPWhosts) failed
サービス名ファイル(XPWhosts)の読み込みに失敗しました。

（S）XMAP3サーバを終了させます。

（U）ファイルが壊れていないかを確認し，XMAP3サーバを再起動します。

23
KBXP52000-E xpwdaemon:
Reading of display / printing environmental file (XPWconfig) failed
表示・印刷環境ファイル(XPWconfig)の読み込みに失敗しました。

（S）XMAP3サーバを終了させます。

（U）ファイルが壊れていないかを確認し，XMAP3サーバを再起動します。

24
KBXP52500-E xpwdaemon:
The reading function of printer device information failed
プリンタデバイス情報読み込み関数が失敗しました。この場合，次のメッセージも一緒に出力されます。
「KBXP57600-E xpwdaemon:cannot allocate memory」

（S）XMAP3サーバを終了させます。

（U）メモリが十分確保されていることを確認し，XMAP3サーバを再起動します。

25
KBXP52900-E xpwdaemon:
The length of the host name specified by -vh exceed 127 bytes(hostname)
-vhで指定されたホスト名の長さが127バイトを超えました。

（S）XMAP3サーバが終了させます。

（U）-vhで指定したホスト名の長さを127バイト以内にし，XMAP3サーバを再起動します。

26
KBXP53300-E xpwdaemon:
Environment variable XMAPserv_VirtualHost has no value
環境変数XMAPserv_VirtualHostが設定できませんでした。

（S）XMAP3サーバが終了させます。

（U）ほかの環境変数が設定できるかを確認し，設定できたら，XMAP3サーバを再起動します。

27
KBXP53400-W xpwdaemon:
The connection managed table exceeded 1025
接続管理テーブル数が1,025を超えました。

（S）処理を続行します。

（U）少し時間を置いてから，通信の再接続を行ってください。

（凡例）

（S）：システムの障害処理

（U）：ユーザの対応

注

メッセージテキストの「?」には，エラー種別・部位を示す数字および記号が入ります。

9.8.3　エラーコードの一覧

マップドライバ機能のエラー発生時にsyslogファイルに記録されるエラーコードについて，エラーコード順に説明します。

＜この項の構成＞

(1)　共通エラーコード

(2)　CLOSE要求時のエラーコード

(3)　MDO要求時のエラーコード

(4)　OPEN要求時のエラーコード

(5)　RECV要求時のエラーコード

(6)　SEND要求時のエラーコード

(7)　仮想端末定義ファイル解析時のエラーコード

(1)　共通エラーコード

各要求時のエラーコードを次に示します。

表9-8　マップドライバ機能のエラーコード（共通）

項番
エラーコード
エラー内容

1
01000001
要求インタフェース領域のポインタが未設定です。

（S）処理を終了します。

（U）AP中の要求インタフェース領域の設定処理を見直し，再コンパイル後，再実行してください。

2
01000002
要求種別の内容が不正です。

（S）処理を終了します。

（U）AP中の要求インタフェース領域の設定処理を見直し，再コンパイル後，再実行してください。

3
01010001
共通インタフェース領域のポインタが未設定です。

（S）処理を終了します。

（U）AP中の共通インタフェース領域の設定処理を見直し，再コンパイル後，再実行してください。

4
01010002
共通インタフェース領域のIDが不正です。

（S）処理を終了します。

（U）AP中の共通インタフェース領域の設定処理を見直し，再コンパイル後，再実行してください。

5
01000101
OPEN要求をしないで，SEND要求を発行しています。

（S）処理を終了します。

（U）AP中のjsvwadrv関数を発行している処理で，発行順序が正しいかどうか見直し，再コンパイル後，再実行してください。

6
01000102
OPEN要求をしないで，CLOSE要求を発行しています。

（S）処理を終了します。

（U）AP中のjsvwadrv関数を発行している処理で，発行順序が正しいかどうか見直し，再コンパイル後，再実行してください。

7
01000104
OPEN要求またはSEND要求をしないで，RECV要求を発行しています。または，プリンタに対してRECV要求を発行しています。

（S）処理を終了します。

（U）AP中のjsvwadrv関数を発行している処理で，発行順序が正しいかどうか見直し，再コンパイル後，再実行します。

8
01000105
OPEN要求をしないで，MDO要求を発行しています。

（S）処理を終了する。

（U）AP中のjsvwadrv関数を発行している処理で，発行順序が正しいかどうか見直し，再コンパイル後，再実行します。

（凡例）

（S）：システムの障害処理

（U）：ユーザの対応

(2)　CLOSE要求時のエラーコード

CLOSE要求時のエラーコードを次に示します。

表9-9　マップドライバ機能のエラーコード（CLOSE）

項番
エラーコード
エラー内容

1
02000301
ログファイルのクローズ処理でエラーが発生しました。

（S）処理を終了します。

（U）－

（凡例）

（S）：システムの障害処理

（U）：ユーザの対応

(3)　MDO要求時のエラーコード

MDO要求時のエラーコードを次に示します。

表9-10　マップドライバ機能のエラーコード（MDO）

項番
エラーコード
エラー内容

1
03000001
マッピングインタフェース領域のポインタが未設定です。

（S）処理を終了します。

（U）AP中のマッピングインタフェース領域の設定処理を見直し，再コンパイル後，再実行します。

2
03000002
マッピングインタフェース領域の第3引数が不正です。

（S）処理を終了します。

（U）AP中のマッピングインタフェース領域の設定処理を見直し，再コンパイル後，再実行します。

（凡例）

（S）：システムの障害処理

（U）：ユーザの対応

(4)　OPEN要求時のエラーコード

OPEN要求時のエラーコードを次に示します。

表9-11　マップドライバ機能のエラーコード（OPEN）

項番
エラーコード
エラー内容

1
04000001
ホスト名取得処理でエラーが発生しました。

（S）処理を終了します。

（U）－

2
04000201
AP内で仮想端末名を指定していない場合，仮想端末定義ファイルの先頭行の内容が不正です。

（S）処理を終了します。

（U）仮想端末定義ファイルを見直し，再実行してください。

3
04000301
ログファイルのオープンエラーまたは編集エリアの確保エラーが発生しました。

（S）処理を終了します。

（U）次のどちらかの処理をしてください。

ほかのAPを終了するか，WSを再起動する。

ログファイルを出力するために指定したディレクトリに書き込みできるかを確認する。

4
04000401
マッププールエリアの確保時にエラーが発生しました。

（S）処理を終了します。

（U）ほかのAPを終了するか，WSを再起動してください。

5
04000402
マップドライバ管理テーブルの確保時にエラーが発生しました。

（S）処理を終了します。

（U）ほかのAPを終了するか，WSを再起動してください。

（凡例）

（S）：システムの障害処理

（U）：ユーザの対応

(5)　RECV要求時のエラーコード

RECV要求時のエラーコードを次に示します。

表9-12　マップドライバ機能のエラーコード（RECV）

項番
エラーコード
エラー内容

1
05000001
物理マップ名としてスペースまたはNULL（0x00）が指定されています。

（S）処理を終了します。

（U）AP中の共通インタフェース領域の設定処理を見直し，再コンパイル後，再実行してください。

2
05000801
入力論理マップ長が必要なサイズよりも小さいです。

（S）処理を中止します。

（U）APの共通インタフェース領域の設定処理を見直し，再コンパイル後，再実行してください。

（凡例）

（S）：システムの障害処理

（U）：ユーザの対応

(6)　SEND要求時のエラーコード

SEND要求時のエラーコードを次に示します。

表9-13　マップドライバ機能のエラーコード（SEND）

項番
エラーコード
エラー内容

1
06000001
物理マップ名としてスペースまたはNULL（0x00）が指定されています。

（S）処理を終了します。

（U）AP中の共通インタフェース領域の設定処理を見直し，再コンパイル後，再実行してください。

2
06000005
論理セグメント長が制限を超えています。

（S）処理を終了します。

（U）次のどちらかの処理をしてください。

PC XMAP3でビッグエンディアン指定してマップを再作成し，WSへ転送して利用する。

AP中のjsvwadrv関数を発行している処理で指定したパラメタが正しいかどうか見直し，再コンパイル後，再実行する。

3
06000301
標準ログファイルの出力エラーが発生しました。

（S）処理を終了します。

（U）ファイルを出力するために指定したディレクトリに書き込みできるかを確認してください。

4
06000302
拡張ログファイルの出力エラーが発生しました。

（S）処理を終了します。

（U）ログファイルを出力するために指定したディレクトリに書き込みできるかを確認してください。

（凡例）

（S）：システムの障害処理

（U）：ユーザの対応

(7)　仮想端末定義ファイル解析時のエラーコード

仮想端末定義ファイル解析時のエラーコードを次に示します。

表9-14　ファイル解析のエラーコード

項番
エラーコード
エラー内容

1
09000202
AP内で仮想端末名を指定していない場合，仮想端末定義ファイルの行末が改行コードとなっていません。

（S）処理を終了します。

（U）仮想端末定義ファイルの内容を見直し，再実行してください。

2
09000203
AP内で仮想端末名を指定していない場合，仮想端末定義ファイルの内容が不正です。

（S）処理を終了します。

（U）仮想端末定義ファイルの内容を見直し，再実行してください。

3
09000204
AP内で仮想端末名を指定している場合，仮想端末定義ファイルの内容が不正です。

（S）処理を終了します。

（U）仮想端末定義ファイルの内容を見直し，再実行してください。

4
09000205
仮想端末定義ファイル内に一致する仮想端末名がありません。

（S）処理を終了します。

（U）仮想端末定義ファイルの内容を見直し，再実行してください。

5
09000401
仮想端末定義ファイルのエリア確保時にエラーが発生しました。

（S）処理を終了します。

（U）ほかのAPを終了するか，WSを再起動してください。

6
09000501
仮想端末定義ファイルのオープン処理でエラーが発生しました。

（S）処理を終了します。

（U）次のどちらかの処理をしてください。

マップドライバ環境定義ファイルが読めるかどうかを確認し，再実行する。

読めない場合は，アンインストール後，再インストールする。

7
09000502
仮想端末定義ファイルのファイルサイズ取得処理でエラーが発生しました。

（S）処理を終了します。

（U）次のどちらかの処理をします。

マップドライバ環境定義ファイルが読めるかどうかを確認し，再実行する。

読めない場合は，アンインストール後，再インストールする。

8
09000503
仮想端末定義ファイルのリード処理でエラーが発生しました。

（S）処理を終了します。

（U）次のどちらかの処理をします。

マップドライバ環境定義ファイルが読めるかどうかを確認し，再実行する。

読めない場合は，アンインストール後，再インストールする。

（凡例）

（S）：システムの障害処理

（U）：ユーザの対応

付録

＜この付録の構成＞

付録A　提供ファイル一覧

付録B　標準提供例題プログラムの使用方法

付録C　サポートプリンタの機能差

付録D　旧製品からXMAP3 Serverへの移行

付録E　用語解説

付録A　提供ファイル一覧

XMAP3 Serverでは，プログラム，コマンド，ライブラリ，インクルードファイル，標準パターン，サンプルを提供しています。

OS共通の提供ファイルの一覧を表A-1に示します。また，OS固有の提供ファイルの一覧を，それぞれ，表A-2～表A-5に示します。

OS共通の提供ファイルとOSごとに提供されるファイルの一覧を合わせて参照してください。

＜この節の構成＞

付録A.1　共通ファイル

付録A.2　AIX固有のファイル

付録A.3　HP-UX固有のファイル

付録A.4　Linux固有のファイル

付録A.5　Solaris固有のファイル

付録A.1　共通ファイル

OS共通で提供されるファイルの一覧を次に示します。

表A-1　提供ファイル一覧（共通）

組み込みディレクトリ
ファイル名
内容

/etc/opt/HIXMAP
XMAPconfig
マッピング構成ファイル

XMAPdrv
マップドライバ環境定義ファイル

XMAPhosts
仮想端末定義ファイル

XMAPsrv/xps
マッピング属性ファイル

XPWhosts
サービス名ファイル

XPWconfig※1
表示・印刷環境ファイル

xpwrc
XMAP3サーバ起動/停止シェルスクリプト

/opt/HIXMAP/bin
jsvwmpck
物理マップチェックプログラム

jsvwuedt
標準形式ログ編集ツール

cmapcp
物理マップ複写シェルスクリプト

xpwdaemon
XMAP3サーバ

xpwprt
印刷サービス

xptrace
トレース情報参照ツール

/opt/HIXMAP/bin/.dat
xpwocr24
OCR-Bフォントファイル

xpwocr32

xpwocr40

xpwpst24
バーコードイメージファイル

xpwpst30

/opt/HIXMAP/bin/sample※2
x3menu
実行サンプル

CUI/GUI/帳票/書式入門例題

CUI/GUI受発注業務

（書式入門例題は，AIX，HP-UXおよびSolarisで提供）

/opt/HIXMAP/patterns※2
ATRCRS01.cbl
エラー項目の色を変更し，カーソルを該当項目に位置づける

BTMENU01.cbl
ログイン画面とメニューを表示して，各メニューに対応する外部プログラムをCALLする

CLRINP01.cbl
初期値がないデータエントリ画面の入力項目のクリア

DSPPRT01.cbl
画面／帳票を使用したサンプル

FLDHLP01.cbl
ヘルプ画面表示の呼び出し

GENDSP01.cbl
汎用画面の入出力を行うプログラムサンプル(SEND/RECV)

GENDSP02.cbl
汎用画面の入出力を行うプログラムサンプル(CALL)

GENDSP03.cbl
汎用画面の入出力を行うプログラムサンプル(CALL)

GENREP01.cbl
帳票出力を行うサンプル(SEND)

MODATR01.cbl
項目属性の変更を行う

NXTDSP01.cbl
次画面入出力を行うプログラムサンプル

NXTREP01.cbl
帳票出力を行うサンプル（SEND）

PATWRT01.cbl
同一画面に対し，1項目だけ書き換える

SETCRS01.cbl
フォーカス・カーソルの変更を行う

SLMENU01.cbl
ログイン画面とメニューを表示して，各メニューに対応するプログラムをCALLする

gendsp01.c
汎用画面の入出力を行うプログラムサンプル

genrep01.c
帳票出力を行うサンプル

/opt/HIXMAP/samples/C※2
cmpilJCH
CUI入門例題サンプル作成コンパイルコマンド

jyutuch.c
CUI入門例題サンプル

cmpilJGH
GUI入門例題サンプル作成コンパイルコマンド

jyutugh.c
GUI入門例題サンプル

cmpilJPH
帳票入門例題（ページプリンタ）サンプル作成コンパイルコマンド

jyutuph.c
帳票入門例題サンプル（ページプリンタ）

cmpilKCH
受発注業務（CUI）サンプル作成コンパイルコマンド

kadn1ch.c
受発注業務（CUI）サンプル

cmpilKGH
受発注業務（GUI）サンプル作成コンパイルコマンド

kadn1gh.c
受発注業務（GUI）サンプル

kadn1ph.c
受発注業務（CUI/GUI）サンプルで使用する帳票例題サンプル

/opt/HIXMAP/samples/COBOL※2
cmpilJCC
CUI入門例題サンプル作成コンパイルコマンド

jyutucc.cbl
CUI入門例題サンプル

cmpilJGC
GUI入門例題サンプル作成コンパイルコマンド

jyutugc.cbl
GUI入門例題サンプル

cmpilJPC
帳票入門例題（ページプリンタ）サンプル作成コンパイルコマンド

jyutupc.c
帳票入門例題サンプル（ページプリンタ）

cmpilKCC
受発注業務（CUI）サンプル作成コンパイルコマンド

kadn1cc.cbl
受発注業務（CUI）サンプル

cmpilKGC
受発注業務（GUI）サンプル作成コンパイルコマンド

kadn1gc.cbl
受発注業務（GUI）サンプル

kadn1pc.cbl
受発注業務（CUI/GUI）サンプルで使用する帳票例題サンプル

MENUOUT.cbl
ログイン画面とメニュー画面を表示し外部プログラムをCALLするサンプル

OUTDSP01.cbl
汎用画面入出力サンプル

FIELDCC.cbl
フィールド単位入出力サンプル

LINEGC.cbl
行単位入出力サンプル

DSPCLEAR.cbl
汎用画面入出力サンプル

TABLEOUT.cbl

DSPWRITE.cbl

HELPOUT.cbl

DAIALOG.cbl

NOHIN.cbl
汎用画面/帳票サンプル

/opt/HIXMAP/map/C※2
JYU1CHNC
CUI入門例題サンプルで使用

JYU1CHO.h

JYU1CHI.h

JYU1GHND
GUI入門例題サンプルで使用

JYU1GHO.h

JYU1GHI.h

JYU1PH6G
帳票入門例題（ページプリンタ）サンプルで使用

JYU1PHO.h

JYU1PHI.h

KAD1CHNC
受発注業務（CUI）サンプルで使用

KAD1CHO.h

KAD1CHI.h

KAD2CHNC

KAD2CHO.h

KAD2CHI.h

KAD3CHNC

KAD3CHO.h

KAD3CHI.h

KAD4CHNC

KAD4CHO.h

KAD4CHI.h

KAD1GHND

KAD1GHO.h

KAD1GHI.h

KAD2GHND

KAD2GHO.h

KAD2GHI.h

KAD3GHND

KAD3GHO.h

KAD3GHI.h

KAD4GHND

KAD4GHO.h

KAD4GHI.h

KAD5GHND

KAD5GHO.h

KAD5GHI.h

KAD6GHND

KAD6GHO.h

KAD6GHI.h

KAD7GHND

KAD7GHO.h

KAD7GHI.h

KAD8GHND

KAD8GHO.h

KAD8GHI.h

KAD9GHND

KAD9GHO.h

KAD9GHI.h

KADAGHND

KADAGHO.h

KADAGHI.h

KADBGHND

KADBGHO.h

KADBGHI.h

KADCGHND

KADCGHO.h

KADCGHI.h

KADDGHND

KADDGHO.h

KADDGHI.h

KADEGHND

KADEGHO.h

KADEGHI.h

KADFGHND

KADFGHO.h

KADFGHI.h

KADGGHND

KADGGHO.h

KADGGHI.h

KAD1SH6A

KAD1SHO.h

KAD1SHI.h

KAD1PH6A

KAD1PHO.h

KAD1PHI.h

MENU01ND
実行サンプルで使用

/opt/HIXMAP/map/COBOL※2
JYU1CCNC
CUI入門例題サンプルで使用

JYU1CCO.cbl

JYU1CCI.cbl

JYU1GCND

JYU1GCO.cbl

JYU1GCI.cbl

JYU1PC6G
帳票入門例題（ページプリンタ）サンプルで使用

JYU1PCO.cbl

JYU1PCI.cbl

KAD1CCNC
受発注業務（CUI）サンプルで使用

KAD1CCO.cbl

KAD1CCI.cbl

KAD2CCNC

KAD2CCO.cbl

KAD2CCI.cbl

KAD3CCNC

KAD3CCO.cbl

KAD3CCI.cbl

KAD4CCNC

KAD4CCO.cbl

KAD4CCI.cbl

KAD1GCND
受発注業務（GUI）サンプルで使用

KAD1GCO.cbl

KAD1GCI.cbl

KAD2GCND

KAD2GCO.cbl

KAD2GCI.cbl

KAD3GCND

KAD3GCO.cbl

KAD3GCI.cbl

KAD4GCND

KAD4GCO.cbl

KAD4GCI.cbl

KAD5GCND

KAD5GCO.cbl

KAD5GCI.cbl

KAD6GCND

KAD6GCO.cbl

KAD6GCI.cbl

KAD7GCND

KAD7GCO.cbl

KAD7GCI.cbl

KAD8GCND

KAD8GCO.cbl

KAD8GCI.cbl

KAD9GCND

KAD9GCO.cbl

KAD9GCI.cbl

KADAGCND

KADAGCO.cbl

KADAGCI.cbl

KADBGCND

KADBGCO.cbl

KADBGCI.cbl

KADCGCND

KADCGCO.cbl

KADCGCI.cbl

KADDGCND

KADDGCO.cbl

KADDGCI.cbl

KADEGCND

KADEGCO.cbl

KADEGCI.cbl

KADFGCND

KADFGCO.cbl

KADFGCI.cbl

KADGGCND

KADGGCO.cbl

KADGGCI.cbl

KAD1SC6A

KAD1SCO.cbl

KAD1SCI.cbl

KAD1PC6A

KAD1PCO.cbl

KAD1PCI.cbl

BMENU1ND
汎用画面入出力サンプルなどで使用

BMENU1O.cbl

BMENU1I.cbl

FIE1CCNC
フィールド単位入出力サンプルで使用

FIE1CCO.cbl

FIE1CCI.cbl

GCTBL1ND
汎用画面入出力サンプルなどで使用

GCTBL1O.cbl

GCTBL1I.cbl

GFILD3ND

GFILD3O.cbl

GFILD3I.cbl

GLBOX3ND

GLBOX3O.cbl

GLBOX3I.cbl

GOPTN1ND

GOPTN1O.cbl

GOPTN1I.cbl

GPASW1ND

GPASW1O.cbl

GPASW1I.cbl

HELP01ND

HELP01O.cbl

HELP01I.cbl

LIN1GCND
行単位入出力サンプルで使用

LIN1GCO.cbl

LIN1GCI.cbl

SMENU1ND
汎用画面入出力サンプルなどで使用

SMWNU1O.cbl

SMWNU1I.cbl

LTABLE16A
汎用画面/帳票サンプルで使用

LTABL1O.cbl

LTABL1I.cbl

/opt/HIXMAP/include/XMAP
JSVWATBL.cbl
マップドライバ用UAPインタフェースインクルードファイル(日立COBOL CALL用)

jsvwatbl.h
マップドライバ用UAPインタフェースインクルードファイル(C言語用)

jsvwfunc.h
マッピング用UAPインタフェースインクルードファイル(C言語用)

x3modtbl.h※1
標準提供仮定値用の動的変更修飾名テーブル(C言語用)

X3MODTBL.cbl※1
標準提供仮定値用の動的変更修飾名テーブル(COBOL用)

/opt/HIXMAP/include/XPW
ccermac.h
/opt/HIXMAP/include/XPW/tx_ucommon.hにインクルードされているヘッダファイル

ccerstr.h

cckysym.h

ccmthrd.h

csetarg.h

lcuocif.h

lcupstr.h

lcuocdf.h

lcupmac.h

lcptype.h

tx_ucommon.h
UPインタフェースインクルードファイル

/opt/HIXMAP/pci
FGA4L10.pci
デフォルトのpciファイル

/var/opt/HIXMAP
－
ログ出力用ディレクトリ

（凡例）

－：該当なし

注※1

該当ファイルの文字コードはAIXの場合はシフトJIS環境，Solarisの場合はEUC環境を対象としています。そのため，AIXのEUC環境およびSolarisのシフトJIS環境で使用する場合は，使用環境に合った文字コードへの変換が必要です。

注※2

例題プログラム関連ファイルは，AIXの場合はシフトJIS環境，Solarisの場合はEUC環境を対象にしています。そのため，AIXのEUC環境およびSolarisのシフトJIS環境では使用できませんので注意してください。

付録A.2　AIX固有のファイル

AIX環境用に提供されるファイルを次に示します。

表A-2　提供ファイル一覧（AIX）

組み込みディレクトリ | ファイル名 | 内容
/opt/HIXMAP/bin | jstqpgck | 書式，PAGECチェックプログラム
mapfchk | 書式，PAGECチェックシェルスクリプト
xmovl | 書式簡易印刷プログラム
/opt/HIXMAP/samples/C※ | cmpilJFH | 書式入門例題サンプル作成コンパイルコマンド
jyutufh.c | 書式入門例題サンプル
/opt/HIXMAP/samples/COBOL※ | cmpilJFC | 書式入門例題サンプル作成コンパイルコマンド
jyutufc.cbl | 書式入門例題サンプル
/opt/HIXMAP/map/C※ | JYU1FH6G.fmp | 書式入門例題用書式マップ
JYU1FH6G.pci | 書式入門例題用行制御データファイル
JYUTUFH.txt | 書式入門例題用行データファイル
/opt/HIXMAP/map/COBOL※ | JYU1FC6G.fmp | 書式入門例題用書式マップ
JYU1FC6G.pci | 書式入門例題用行制御データファイル
JYUTUFC.txt | 書式入門例題用行データファイル
/opt/HIXMAP/lib | libxpdrv.a | マップドライバ実行モジュール（アーカイブ/共用ライブラリ用）
libxmapc.a | マッピング制御実行モジュール（アーカイブ/共用ライブラリ用）
libxpw.a | 表示・印刷ライブラリ（アーカイブ/共用ライブラリ用）
libxmovl.a | 書式オーバレイ出力ライブラリ（アーカイブ/共用ライブラリ用）
/usr/lib/X11/fonts/hitachi | cnv_map_tbl | 外字KEIS←→シフトJISコード変換テーブル

注※

AIXでの例題プログラム関連ファイルについては，シフトJIS環境を対象にしています。EUC環境では使用できませんので注意してください。

付録A.3　HP-UX固有のファイル

HP-UX環境用に提供されるファイルを次に示します。

表A-3　提供ファイル一覧（HP-UX）

組み込みディレクトリ
ファイル名
内容

/opt/HIXMAP/bin
jstqpgck
書式，PAGECチェックプログラム

mapfchk
書式，PAGECチェックシェルスクリプト

xmovl
書式簡易印刷プログラム

/opt/HIXMAP/samples/C
cmpilJFH
書式入門例題サンプル作成コンパイルコマンド

jyutufh.c
書式入門例題サンプル

/opt/HIXMAP/samples/COBOL
cmpilJFC
書式入門例題サンプル作成コンパイルコマンド

jyutufc.cbl
書式入門例題サンプル

/opt/HIXMAP/map/C
JYU1FH6G.fmp
書式入門例題用書式マップ

JYU1FH6G.pci
書式入門例題用行制御データファイル

JYUTUFH.txt
書式入門例題用行データファイル

/opt/HIXMAP/map/COBOL
JYU1FC6G.fmp
書式入門例題用書式マップ

JYU1FC6G.pci
書式入門例題用行制御データファイル

JYUTUFC.txt
書式入門例題用行データファイル

/opt/HIXMAP/lib
libxpdrv.a
マップドライバ実行モジュール
（アーカイブライブラリ用）

libxpdrv.sl※1
マップドライバ実行モジュール
（共用ライブラリ用）

libxpdrv.so※2
マップドライバ実行モジュール
（共用ライブラリ用）

libxmapc.a
マッピング制御実行モジュール
（アーカイブライブラリ用）

libxmapc.sl※1
マップドライバ実行モジュール
（共用ライブラリ用）

libxmapc.so※2
マップドライバ実行モジュール
（共用ライブラリ用）

libxpw.a
表示・印刷ライブラリ
（アーカイブライブラリ用）

libxpw.sl※1
表示・印刷ライブラリ
（共用ライブラリ用）

libxpw.so※2
表示・印刷ライブラリ
（共用ライブラリ用）

libxmovl.a
書式オーバレイ出力ライブラリ
（アーカイブライブラリ用）

libxmovl.sl※1
書式オーバレイ出力ライブラリ
（共用ライブラリ用）

libxmovl.so※2
書式オーバレイ出力ライブラリ
（共用ライブラリ用）

/opt/HIXMAP/lib/fonts
gai32.pcf
32ドット外字ベースファイル

gai40.pcf
40ドット外字ベースファイル

gai48.pcf
48ドット外字ベースファイル

/usr/lib/X11/fonts/hitachi
cnv_map_tbl
外字KEIS←→シフトJISコード変換テーブル

/usr/lib/lp/model
xpwlpmodel
ローカルプリンタ出力用モデルファイル

注※1　HP-UX（PA-RISC）の場合に提供されます。

注※2　HP-UX（IPF）の場合に提供されます。

付録A.4　Linux固有のファイル

Linux環境用に提供されるファイルを次に示します。

表A-4　提供ファイル一覧（Linux）

組み込みディレクトリ
ファイル名
内容

/opt/HIXMAP/lib
libxpdrv.a
マップドライバ実行モジュール
（アーカイブライブラリ用）

libxpdrv.so
マップドライバ実行モジュール
（共用ライブラリ用）

libxmapc.a
マッピング制御実行モジュール
（アーカイブライブラリ用）

libxmapc.so
マッピング制御実行モジュール
（共用ライブラリ用）

libxpw.a
表示・印刷ライブラリ
（アーカイブライブラリ用）

libxpw.so
表示・印刷ライブラリ
（共用ライブラリ用）

/usr/lib/X11/fonts/hitachi
cnv_map_tbl
外字KEIS←→シフトJISコード変換テーブル

付録A.5　Solaris固有のファイル

Solaris環境用に提供されるファイルを次に示します。

表A-5　提供ファイル一覧（Solaris）

組み込みディレクトリ
ファイル名
内容

/opt/HIXMAP/bin
jstqpgck
書式，PAGECチェックプログラム

mapfchk
書式，PAGECチェックシェルスクリプト

xmovl
書式簡易印刷プログラム

/opt/HIXMAP/samples/C
cmpilJFH
書式入門例題サンプル作成コンパイルコマンド

jyutufh.c
書式入門例題サンプル

/opt/HIXMAP/samples/COBOL
cmpilJFC
書式入門例題サンプル作成コンパイルコマンド

jyutufc.cbl
書式入門例題サンプル

/opt/HIXMAP/map/C
JYU1FH6G.fmp
書式入門例題用書式マップ

JYU1FH6G.pci
書式入門例題用行制御データファイル

JYUTUFH.txt
書式入門例題用行データファイル

/opt/HIXMAP/map/COBOL
JYU1FC6G.fmp
書式入門例題用書式マップ

JYU1FC6G.pci
書式入門例題用行制御データファイル

JYUTUFC.txt
書式入門例題用行データファイル

/opt/HIXMAP/lib
libxpdrv.a
マップドライバ実行モジュール
（アーカイブライブラリ用）

libxpdrv.so
マップドライバ実行モジュール
（共用ライブラリ用）

libxmapc.a
マッピング制御実行モジュール
（アーカイブライブラリ用）

libxmapc.so
マッピング制御実行モジュール
（共用ライブラリ用）

libxpw.a
表示・印刷ライブラリ
（アーカイブライブラリ用）

libxpw.so
表示・印刷ライブラリ
（共用ライブラリ用）

libxmovl.a
書式オーバレイ出力ライブラリ
（アーカイブライブラリ用）

libxmovl.so
書式オーバレイ出力ライブラリ
（共用ライブラリ用）

/usr/openwin/lib/X11/fonts/hitachi
cnv_map_tbl
外字KEIS←→シフトJISコード変換テーブル

付録B　標準提供例題プログラムの使用方法

XMAP3 Serverが標準提供する例題プログラムの使用方法について説明します。

XMAP3 Serverでは各種サンプルを提供しています。APの実行サンプルで，XMAP3 Serverを利用したAPの動作イメージをつかんでください。

また，XMAP3 Serverを利用したAPの作成を簡単にするために，日立COBOLのコーディングパターン，物理マップおよび論理マップも提供しています。開発環境へ流用することで，開発期間を短縮することができます。

なお，AIX用に提供しているすべての例題プログラムは，シフトJIS環境を対象にしています。EUC環境では使用できませんので注意してください。

＜この節の構成＞

付録B.1　提供サンプルの種類と利用方法

付録B.2　提供サンプルの利用手順

付録B.1　提供サンプルの種類と利用方法

＜この項の構成＞

(1)　実行形式AP

(2)　APパターン

(3)　サンプルAPのリソース

(1)　実行形式AP

XMAP3 Serverの画面・帳票を利用したAPの実行形式と，その実行形式APで使用する物理マップ群です。これから作成するAPの操作イメージを理解したい場合に，起動用のコマンドを実行して操作感覚を体験します。

(2)　APパターン

アプリケーションを作成する上で，よく使われる日立COBOL用のコーディングパターンです。APのコーディング時に，ユーザの開発環境にコピーして利用します。

(3)　サンプルAPのリソース

特定の業務を想定して画面・帳票を定義した物理マップおよび論理マップと画面・帳票を利用するサンプルAPのソースプログラムです。

ソースプログラムをコンパイルして実行形式のAPを作成します。作成した実行形式ファイルを実行して操作したあと，これから作成するAPに利用できそうな画面・帳票があれば対応する物理マップを，また，利用できそうな処理ロジックがあれば，ソースプログラムを，それぞれのユーザの開発環境にコピーして利用します。

付録B.2　提供サンプルの利用手順

＜この項の構成＞

(1)　実行形式AP

(2)　APパターン

(1)　実行形式AP

次の手順で実行します。なお，実行前の各種ファイルの設定方法の詳細については，「7.　XMAP3 Serverの環境設定」を参照してください。

自端末のホスト名（/etc/hosts）を設定します。

仮想端末定義ファイル（XMAPhosts）を設定します。
提供AP中で指定している仮想端末名を次に示します。
GUI画面およびCUI画面：DSP001
シリアルプリンタ　　 ：PRT001
ページプリンタ　　　 ：PRT002

サービス名ファイル（XPWhosts）を設定します。
仮想端末定義ファイル（XMAPhosts）の仮想端末名と，実際の出力先を関連づけます。

XMAP3サーバを起動します。

/opt/HIXMAP/bin/xpwdaemon -s &

実行形式APのメニュー画面を表示します。
ホスト名「host102」のディスプレイ「host102:0.0」に表示する場合を例に説明します。

コマンドの説明：x3menu
デバイス名に対応するディスプレイにメニュー画面を表示します。

メニュー画面から実行したいサンプルを選択して［了解］ボタンを選択します。

メニュー画面

ラジオボタンから実行させたいデバイスを選択すると，右のリストボックスにサンプルの種類が表示されるので実行したいサンプルを選択し［了解］ボタンを押します。
各デバイスで実行できるサンプルプログラムを表B-1に示します。

表B-1　各デバイスで実行できるサンプルプログラム

デバイス種別 | 実行できるサンプルプログラム
GUI画面 | GUI入門例題
受発注業務例題
CUI画面 | GUI入門例題
受発注業務例題
ページプリンタ向け帳票 | 帳票入門例題
書式オーバレイ※ | 書式入門例題

注※　書式入門例題はAIX，HP-UXおよびSolarisで提供しています。

(2)　APパターン

APの作成に際して，利用できそうなパターンがあれば，ユーザの開発環境にコピーして，エディタで編集してプログラム作成に利用します。これらのファイルは，次に示すディレクトリに格納されています。

/opt/HIXMAP/patterns

APパターンを表B-2～表B-5に示します。

表B-2　APパターン（画面）（プログラムパターン）

用途 | パターン名 | 概要 | 対応する定義サンプル
メニュー画面 | BTMENU01.cbl | ログイン画面からメニュー画面を起動する。プッシュボタンまたはファンクションキーの選択によって，アプリケーションプログラムを起動する。 | ログインウィンドウ（GPASW1），一段ボタンメニュー（BMENU1）との併用を想定している。
SLMENU01.cbl | ログイン画面からメニュー画面を起動する。ラジオボタンまたはテンキーの選択によって，アプリケーションプログラムを起動する。 | ログインウィンドウ（GPASW1），一段ラジオボタンメニュー（SMENU1）との併用を想定している。
画面入出力 | GENDSP01.cbl | 一つの画面に対応した画面入出力処理をする。TRANSCEIVE文を使用して画面入出力を実行する。 | 一般の画面に適用できる。
GENDSP02.cbl | 複数画面に対応した画面入出力処理をする。次画面の処理には，サブプログラム（GENDSP03で作成）を呼び出す。CALL文を使用して画面入出力を実行する。 | 一般の画面に適用できる。
GENDSP03.cbl | GENDSP02から呼ばれるサブプログラムで，CALL文を使用して画面入出力を実行する。 | 一般の画面に適用できる。
画面入出力・帳票出力 | DSPPRT01.cbl | 画面入出力処理を実行したあと，帳票を出力する。 | 一般の画面，帳票に適用できる。

表B-3　APパターン（画面）（部品パターン）

パターン名 | 処理概要 | 対応する定義サンプル
NXTDSP01.cbl | 画面入出力処理の追加コーディングである。 | 一般の画面に適用できる。
ATRCRS01.cbl | 特定の入力または入出力テキストの文字色を変更して，フォーカスまたはカーソル位置を該当テキストに設定する。 | 一般の画面に適用できる。
CLRINP01.cbl | 表示画面の入力テキストを初期化する。 | 一般の画面に適用できる。
FLDHLP01.cbl | フィールドに対応するヘルプ画面を表示する。 | 小ダイアログ・中ダイアログ（HELP01）との併用を想定している。
MODATR01.cbl | 入力，入出力，または出力テキストの文字色を変更する。 | 一般の画面に適用できる。
PRTWRT01.cbl | 表示画面の一つのテキストだけを書き換える。 | 一般の画面に適用できる。
SETCRS01.cbl | フォーカスまたはカーソル位置を設定する。 | 一般の画面に適用できる。

表B-4　APパターン（帳票，書式オーバレイ）（プログラムパターン）

用途 | パターン名 | 概要 | 対応する定義サンプル
帳票出力 | GENREP01.cbl | 1種類の帳票を出力する。 | 一般の帳票に適用できる。

表B-5　APパターン（帳票，書式オーバレイ）（部品パターン）

パターン名 | 処理概要 | 対応する定義サンプル
NXTREP01.cbl | 帳票出力処理の追加コーディングである。 | 一般の帳票に適用できる。

(a)　サンプルAPのリソース

次の手順で実行形式のAPを作成し，実行したあと，ユーザ作成のAPに利用できそうなソースファイル，画面・帳票シートをユーザの開発環境にコピーして利用します。なお，実行前の各種ファイルの設定方法の詳細については，「7.　XMAP3 Serverの環境設定」を参照してください。

自端末のホスト名（/etc/hosts）を設定します。

仮想端末定義ファイル（XMAPhosts）を設定します。
提供のAP中で指定している仮想端末名を次に示します。
GUI画面およびCUI画面：DSP001
シリアルプリンタ　　：PRT001
ページプリンタ　　　：PRT002

サービス名ファイル（XPWhosts）を設定します。
仮想端末定義ファイル（XMAPhosts）の仮想端末名と，実際の出力先を関連づけます。

XMAP3サーバを起動します。

/opt/HIXMAP/bin/xpwdaemon -s &

提供パネル定義文ファイルからマップを生成し，提供ソースをコンパイルします。
次に示す手順でマップ生成とソースコンパイルをします。なお，ここでは日立COBOLのAPについて手順を示しています。そのほかのケースについては，リソースファイルのコピー元（/opt/HIXMAP/samples/COBOL/*）を変更して作業してください。

COBOL用提供ファイル
日立COBOLのサンプルソースと，画面・帳票マップの一覧を表B-6に示します。これらのファイルは，次に示すディレクトリに格納されています。
/opt/HIXMAP/samples/COBOL サンプルソース
/opt/HIXMAP/map/COBOL 物理マップ，論理マップ

表B-6　日立COBOLのサンプルソースと，画面・帳票マップの一覧

実行形式ファイル名 | ソースファイル名 | 使用物理マップ名 | ファイルの内容
kadnngc | kadn1gc.cbl | KADxGCND | 受発注業務（GUI）
kadn1prt.cbl | KAD1SC6A | －
KAD1PC6G | －
cmpilKGC | － | コンパイルコマンド
kadnncc | kadn1cc.cbl | KADxCCNC | 受発注業務（CUI）
kadn1pc.cbl | KAD1SC6A | －
KAD1PC6G | －
cmpilKCC | － | コンパイルコマンド
jyutugc | jyutugc.cbl | JYU1GCND | GUI入門例題
cmpilJGC | － | コンパイルコマンド
jyutucc | jyutucc.cbl | JYU1CCNC | CUI入門例題
cmpilJCC | － | コンパイルコマンド
jyutupc | jyutupc.cbl | JYU1PC6G | 帳票入門例題
cmpilJPC | － | コンパイルコマンド
jyutufc | jyutufc.cbl | JYU1FC6G.fmp | 書式入門例題
cmpilJFC | － | コンパイルコマンド

（凡例）　－：該当しない

注1　実行形式ファイルは，提供コンパイルコマンドの実行によって生成されます。

注2　書式入門例題は，AIX，HP-UXおよびSolarisで提供しています。

C言語用提供ファイル
C言語のサンプルソースと，画面・帳票マップについては，次に示すディレクトリに格納されています。提供サンプルの内容は日立COBOL用と同じです。ただし，ソースファイル名は「kadn1*h～.c」となり，実行形式サンプルは，「kadnn*h～」という名称で作成されます。コンパイルコマンドの名称は日立COBOL用と同じです。
/opt/HIXMAP/samples/C サンプルソース
/opt/HIXMAP/map/C 物理マップ，論理マップ

付録C　サポートプリンタの機能差

XMAP3 Serverのサポートプリンタによる機能差を表C-1に示します。

なお，帳票種別（けい線帳票，プレプリント帳票，網掛け帳票，グラフィック帳票）ごとに，サポートする印刷機能範囲が異なりますのでご注意ください。それぞれの帳票がサポートする機能の詳細については，マニュアル「画面・帳票サポートシステム　XMAP3　プログラミングガイド　帳票編」を参照してください。

表C-1　XMAP3 Serverのサポートプリンタの機能差

機能
サポートプリンタ

ESC/P J84準拠シリアルプリンタ，ラインプリンタ
LIPS II+準拠ページプリンタ
LIPS III準拠ページプリンタ
PostScriptレベル2準拠ページプリンタ
および
PostScriptレベル3準拠ページプリンタ

帳票種別
けい線帳票
○
－
－
－

プレプリント帳票
○
－
－
－

網掛け帳票
－
○
○
○

グラフィック帳票
－
○
○
○

印刷用紙サイズ
－
○
○
×

用紙向き
－
○
○
○

用紙種類
カット紙
○
○
○
○

連続紙
○
－
－
－

行の間隔
3LPI
○
○
○
○

4LPI
○
○
○
○

6LPI
○
○
○
○

8LPI
○
○
○
○

10LPI
×
○
○
○

12LPI
×
○
○
○

字間値
○
○
○
○

印刷前後の排出指定
○
－
－
－

文字サイズ
5ポイント
×
×
○
○

7ポイント
×
○
○
○

9ポイント
○
○
○
○

12ポイント
×
×
○
○

14ポイント
×
×
○
○

文字の拡大
標準
○
○
○
○

平体
○
○
○
○

長体
○
○
○
○

倍角
○
○
○
○

書体
明朝
○
○
○
○

ゴシック
×
×
○
○

OCR-B（固定，出力）
○
○
○
○

強調
太字
×
×
○
○

斜体
×
×
×
○

抹消
一重線
二重線
×
×
○
○

文字網掛け
薄・標準・濃
×
×
○
○

けい線の太さ
極太線
×
○
○
○

太線
×
○
○
○

中線
○
○
○
○

細線
○
○
○
○

けい線の種類
実線
○
○
○
○

破線
○
○
○
○

点線
×
○
○
○

一点鎖線
×
○
○
○

二点鎖線
×
○
○
○

二重線
×
×
○
○

ラウンドコーナ（大／中／小）
×
○
○
○

網掛け
薄・標準・濃
×
○
○
○

上記以外
×
×
○
○

任意ドットパターン
×
○
○
○

バーコード
CODE39
○
○
○
○

JAN8,13
○
○
○
○

NW-7
○
×
○
○

ITF(6),(14),(16)
○
×
○
○

カスタマ
×
×
○
○

EAN-128
×
×
○
○

斜線
×
○
○
○

円・円弧
×
○
○
○

グラフィック（固定，出力）
×※1
×※1
○※2
○※2

（凡例）　○：サポート　×：未サポート　－：無効

注※1

PC XMAP3とのC/S構成でのクライアント印刷の場合だけ印刷できます。

注※2

HP-UX（PA-RISC）およびAIXでは，PC XMAP3とのC/S構成でのクライアント印刷の場合およびスタンドアロン構成での印刷の場合に印刷できます。

HP-UX（IPF），Linux，Solarisでは，PC XMAP3とのC/S構成でのクライアント印刷の場合だけ印刷できます。

付録D　旧製品からXMAP3 Serverへの移行

旧製品からXMAP3 Serverへ移行する場合のシステム構成や，ユーザ資産の移行方法について説明します。

＜この節の構成＞

付録D.1　XMAP2/W，XMAP2/W/FOG，XMAP3/DISPLAY，XMAP3/PRINTER，XP/Wからの移行

付録D.2　FOG2/W，XP/Wからの移行

付録D.3　KAPS/W/PS，XMAP3/PRINTER UTILITY，XP/Wからの移行

付録D.1　XMAP2/W，XMAP2/W/FOG，XMAP3/DISPLAY，XMAP3/PRINTER，XP/Wからの移行

＜この項の構成＞

(1)　同じシフトJIS環境への移行

(2)　シフトJIS環境からEUC環境への移行

(1)　同じシフトJIS環境への移行

(a)　想定する移行環境

HI-UX/WE2の旧製品からAIX（シフトJIS環境）のXMAP3 Serverへの移行

HI-UX/WE2の旧製品からHP-UXのXMAP3 Serverへの移行

HI-UX/WE2の旧製品からSolaris（シフトJIS環境）のXMAP3 Serverへの移行

HP-UXの旧製品からAIX（シフトJIS環境）のXMAP3 Serverへの移行

HP-UXの旧製品からHP-UXのXMAP3 Serverへの移行

HP-UXの旧製品からSolaris（シフトJIS環境）のXMAP3 Serverへの移行

(b)　システム構成の移行

同じシフトJIS環境へ移行する場合のシステム構成を次に示します。

表D-1　同じシフトJIS環境へ移行する場合のシステム構成（XMAP2/W，XMAP2/W/FOG，XMAP3/DISPLAY，XMAP3/PRINTER，XP/W）

項
番
システム構成
移行の
可否
移行方法および注意事項

大分類
中分類
小分類

1
画面入出力
スタンドアロン構成
－
×
PC XMAP3をクライアントとしたC/S構成に変更が必要です。

C/S構成
WSクライアント
×
同上

PCクライアント
○
PC XMAP3※を使用することが前提となります。

2
帳票出力
スタンドアロン構成
－
○
AIXおよびSolarisではローカルプリンタへの帳票出力はできません。

C/S構成
WSクライアント
×
スタンドアロン構成またはPCクライアントのC/S構成に変更が必要です。

PCクライアント
○
PC XMAP3※を使用することが前提となります。

（凡例）　－：該当しない　○：移行できる　×：移行できない

注※　

XMAP3 Serverと同一バージョン，またはそれ以降のバージョンが前提となります。基本的には同一バージョンを推奨します。

(c)　ユーザ資産の移行

同じシフトJIS環境へ移行する場合の各種ユーザ資産の移行方法を次に示します。

表D-2　同じシフトJIS環境へ移行する場合のユーザ資産（XMAP2/W，XMAP2/W/FOG，XMAP3/DISPLAY，XMAP3/PRINTER，XP/W）

項
番
ユーザ資産
移行の
可否
移行方法および注意事項

大分類
中分類
小分類

1
パネル定義文
－
－
△
PC版XMAP3/Enterprise Edition※1へのパネル定義文の移行が前提となります。移行手順としては，ドローセットアップでターゲット環境を移行先に合わせ，インポート機能※2でマップ定義ファイルへの移行およびPC環境でのマップ生成が必要です。

2
論理マップ
－
－
○
そのまま移行できます。

3
物理マップ
－
－
○
そのまま移行できます。

4
アプリケーション
実行ファイル
－
×
同じOSであっても，再リンケージが必要です。OSが異なる場合には，ソースファイルから移行する必要があります。

ソースファイル
COBOL
インタフェース
○
ページ制御機能(PAGEC)を使用した帳票出力は使用できません。

C言語
(jsvwadrv)
インタフェース
○
ページ制御機能(PAGEC)を使用した帳票出力は使用できません。

C言語
(tx_xxx)
インタフェース
×
XP/Wの関数は使用できません。COBOLまたはC言語(jsvwadrv)インタフェースへの変更が必要です。

5
コマンド/起動プログラム
開発系
cmap
×
マップ開発用のコマンドは提供されませんので，PC XMAP3へパネル定義文を移行してマップ生成してください。

cmapcp
○
PC XMAP3で作成した物理マップも対象に実行できます。また，物理マップが使用できるかどうかバージョンのチェックも実行します。

実行系
xmapstart
△
ライブラリマッピング機能を使用することになりますので，このコマンドは提供されません。xpwrcを使用する方法に変更してください。

jsvwdeam
×
ライブラリマッピング機能を使用することになりますので，この起動プログラムは提供されません。

jsvwuedt
○
そのまま移行できます。

xpwrc
○
そのまま移行できます。

xpwdaemon
○
そのまま移行できます。

xptrace
○
そのまま移行できます。

6
環境ファイル
XMAP関連※3
XMAPhosts
△
サーバマッピング機能を使用している場合は，ライブラリマッピング機能に変更が必要です。

XMAPconfig
△
同上

マッピングサーバ属性定義ファイル(xps)※4
○
ユーザ任意のファイルを使用して，ファイルのフルパスを変更する場合は，XMAPconfigファイルに指定が必要です。

XMAPdrv
○
そのまま移行できます。

XP/W関連※3
XPWhosts
△
画面表示をWSサーバまたはWSクライアントで行っていたものは，PCクライアントへの表示設定に変更が必要です。

XPWconfig
○
そのまま移行できます。

（凡例）　－：該当しない　○：移行できる　△：移行方法に従った移行が必要　×：移行できない

注※1

XMAP3 Serverと同一バージョン，またはそれ以前のバージョンが前提となります。基本的には同一バージョンを推奨します。

注※2

インポート機能で有効／無効となる定義情報については，マニュアル「画面・帳票サポートシステム　XMAP3　開発・実行ガイド」を参照してください。

注※3

PP入れ替え時には，現在の設定ファイルをバックアップ後にアンインストールし，新PPインストール後にバックアップファイルを提供ディレクトリへ回復してください。

注※4

サーバマッピング機能でだけ有効となるパラメタ（clientCount，mapSize）は無視されます。

(2)　シフトJIS環境からEUC環境への移行

(a)　想定する移行環境

HI-UX/WE2の旧製品からAIX（EUC環境）のXMAP3 Serverへの移行

HI-UX/WE2の旧製品からLinuxのXMAP3 Serverへの移行

HI-UX/WE2の旧製品からSolaris（EUC環境）のXMAP3 Serverへの移行

HP-UXの旧製品からAIX（EUC環境）のXMAP3 Serverへの移行

HP-UXの旧製品からLinuxのXMAP3 Serverへの移行

HP-UXの旧製品からSolaris（EUC環境）のXMAP3 Serverへの移行

(b)　システム構成の移行

シフトJIS環境からEUC環境へ移行する場合のシステム構成を次に示します。

表D-3　シフトJIS環境からEUC環境へ移行する場合のシステム構成（XMAP2/W，XMAP2/W/FOG，XMAP3/DISPLAY，XMAP3/PRINTER，XP/W）

項
番
システム構成
移行の
可否
移行方法および注意事項

大分類
中分類
小分類

1
画面入出力
スタンドアロン構成
－
×
PC XMAP3をクライアントとしたC/S構成に変更が必要です。

C/S構成
WSクライアント
×
同上

PCクライアント
○
PC XMAP3※を使用することが前提となります。

2
帳票出力
スタンドアロン構成
－
○
AIXおよびSolarisではローカルプリンタへの帳票出力はできません。

C/S構成
WSクライアント
×
スタンドアロン構成またはPCクライアントのC/S構成に変更が必要です。

PCクライアント
○
PC XMAP3※を使用することが前提となります。

（凡例）　－：該当しない　○：移行できる　×：移行できない

注※　

XMAP3 Serverと同一バージョン，またはそれ以降のバージョンが前提となります。基本的には同一バージョンを推奨します。

(c)　ユーザ資産の移行

シフトJIS環境からEUC環境へ移行する場合の各種ユーザ資産の移行方法を次に示します。

表D-4　シフトJIS環境からEUC環境へ移行する場合のユーザ資産（XMAP2/W，XMAP2/W/FOG，XMAP3/DISPLAY，XMAP3/PRINTER，XP/W）

項
番
ユーザ資産
移行の
可否
移行方法および注意事項

大分類
中分類
小分類

1
パネル定義文
－
－
△
PC版XMAP3/Enterprise Edition※1へのパネル定義文の移行が前提となります。移行手順としては，ドローセットアップでターゲット環境を移行先に合わせ，インポート機能※2でマップ定義ファイルへの移行およびPC環境でのマップ生成が必要です。

2
論理マップ※3
－
－
×
パネル定義文から移行してください。

3
物理マップ
－
－
×
同上

4
アプリケーション※3
実行ファイル
－
×
ソースファイルから移行してください。

ソースファイル
COBOL
インタフェース
△

シフトJISからEUCへの文字コード変換および半角かな対応が必要です。

ページ制御機能(PAGEC)を使用した帳票出力は使用できません。

外字を使用した画面入出力および帳票出力はできません。

C言語
(jsvwadrv)
インタフェース
△
同上

C言語
(tx_xxx)
インタフェース
×
XP/Wの関数は使用できません。COBOLまたはC言語(jsvwadrv)インタフェースへの変更が必要です。

5
コマンド/起動プログラム
開発系
cmap
×
マップ開発用のコマンドは提供されませんので，PC XMAP3へパネル定義文を移行してマップ生成してください。

cmapcp
○
PC XMAP3で作成した物理マップも対象に実行できます。また，物理マップが使用できるかどうかバージョンのチェックもします。

実行系
xmapstart
△
ライブラリマッピング機能を使用することになりますので，このコマンドは提供されません。xpwrcを使用する方法に変更してください。

jsvwdeam
×
ライブラリマッピング機能を使用することになりますので，この起動プログラムは提供されません。

jsvwuedt
○
そのまま移行できます。

xpwrc
○
そのまま移行できます。

xpwdaemon
○
そのまま移行できます。

xptrace
○
そのまま移行できます。

6
環境ファイル※4
XMAP関連
XMAPhosts
△
サーバマッピング機能を使用している場合は，ライブラリマッピング機能に変更が必要です。

XMAPconfig
△
同上

マッピングサーバ属性定義ファイル(xps)※5
○
ユーザ任意のファイルを使用して，ファイルのフルパスを変更する場合は，XMAPconfigファイルに指定が必要です。

XMAPdrv
○
そのまま移行できます。

XP/W関連
XPWhosts
△
画面表示をWSサーバまたはWSクライアントで行っていたものは，PCクライアントへの表示設定に変更が必要です。

XPWconfig
○
そのまま移行できます。

（凡例）　－：該当しない　○：移行できる　△：移行方法に従った移行が必要　×：移行できない

注※1

XMAP3 Serverと同一バージョン，またはそれ以前のバージョンが前提となります。基本的には同一バージョンを推奨します。

注※2

インポート機能で有効／無効となる定義情報については，マニュアル「画面・帳票サポートシステム　XMAP3　開発・実行ガイド」を参照してください。

注※3

シフトJISコードで作成されているファイルをEUCコードに変換する必要があります。なお，半角かな文字を使用する項目は，論理項目長が2倍になることを考慮してください。

注※4

半角英数文字以外（全角文字や半角かな文字など）を指定している場合は，シフトJISコードからEUCコードへの変換が必要です。

注※5

サーバマッピング機能でだけ有効となるパラメタ（clientCount，mapSize）は無視されます。

付録D.2　FOG2/W，XP/Wからの移行

＜この項の構成＞

(1)　同じシフトJIS環境への移行

(2)　シフトJIS環境からEUC環境への移行

(1)　同じシフトJIS環境への移行

(a)　想定する移行環境

HI-UX/WE2の旧製品からAIX（シフトJIS環境）のXMAP3 Serverへの移行

HI-UX/WE2の旧製品からHP-UXのXMAP3 Serverへの移行

HI-UX/WE2の旧製品からSolaris（シフトJIS環境）のXMAP3 Serverへの移行

(b)　システム構成の移行

同じシフトJIS環境へ移行する場合のシステム構成を次に示します。

表D-5　同じシフトJIS環境へ移行する場合のシステム構成（FOG2/W，XP/W）

項
番
システム構成
移行の
可否
移行方法および注意事項

大分類
中分類
小分類

1
帳票出力
スタンドアロン構成
－
○
AIXおよびSolarisではローカルプリンタへの帳票出力はできません。

C/S構成
WSクライアント
×
スタンドアロン構成またはPCクライアントのC/S構成に変更が必要です。PCクライアントでは，PC XMAP3※を使用することが前提となります。

（凡例）　－：該当しない　○：移行できる　×：移行できない

注※　

XMAP3 Serverと同一バージョン，またはそれ以降のバージョンが前提となります。基本的には同一バージョンを推奨します。

(c)　ユーザ資産の移行

同じシフトJIS環境へ移行する場合の各種ユーザ資産の移行方法を次に示します。

表D-6　同じシフトJIS環境へ移行する場合のユーザ資産（FOG2/W，XP/W）

項
番
ユーザ資産
移行の
可否
移行方法および注意事項

大分類
中分類
小分類

1
書式記述文
－
－
△
PC版XMAP3/Enterprise Edition※1への書式記述文の移行が前提となります。移行手順としては，ドローセットアップでターゲット環境を移行先に合わせ，インポート機能※2でマップ定義ファイルへの移行処理と，PC環境での書式イメージおよび行制御データファイルの生成が必要です。

2
書式ファイル
－
－
×
特定の日立プリンタにだけ登録できる書式ファイルであるため，書式記述文から移行してください。

3
アプリケーション
実行ファイル
－
×
ソースファイルから移行してください。

ソースファイル
COBOLインタフェース
△

書式オーバレイ名称を書式イメージファイル（拡張子なし）へ変更が必要です。

コンパイルオプションとして，「-Ks」「-Xp」が必要です。

C言語
(jstffxxx)
インタフェース
×
COBOLまたはXMAP3 Serverで提供するC言語(jstqlxxx)インタフェースへの変更が必要です。

4
コマンド/起動プログラム
開発系
cfog
×
書式開発用のコマンドは提供されませんので，PC XMAP3へ書式記述文を移行して書式イメージおよび行制御データファイルを生成してください。

cfogcp
×
同上

実行系
fogpr
△
従来のコマンドは提供されません。同等機能を提供したxmovlコマンドへの移行が必要です。

xpwrc
○
そのまま移行できます。

xpwdaemon
○
そのまま移行できます。

xptrace
○
そのまま移行できます。

5
環境ファイル
XP/W関連
XPWhosts
△
プリンタ登録の変更に合わせた設定が必要です。

XPWconfig
○
そのまま移行できます。

6
環境変数
－
FOG_PSNAME
△
XMAP3_PSNAMEへの変更が必要です。

FOG_FORM
△
XMAP3_FMPへの変更が必要です。

FOG_LCB
×
行制御データファイル名は書式オーバレイ名で決定します。

FOG_FDIR
×
XMAPdrvファイルのmapPathで設定してください。

FOG_COPY
△
XMAP3_COPIESへの変更が必要です。

FOG_SYNC
×
非同期印刷固定となります。

FOG_MSG
×
メッセージ出力あり固定となります。

FOG_PMRGNU
×
マージン値の設定は，PC版XMAP3/Enterprise Edition※1での書式定義時に設定してください。

FOG_PMRGNL
×
同上

（凡例）　－：該当しない　○：移行できる　△：移行方法に従った移行が必要　×：移行できない

注※1

XMAP3 Serverと同一バージョン，またはそれ以前のバージョンが前提となります。基本的には同一バージョンを推奨します。

注※2

インポート機能で有効／無効となる定義情報については，マニュアル「画面・帳票サポートシステム　XMAP3　開発・実行ガイド」を参照してください。

(2)　シフトJIS環境からEUC環境への移行

(a)　想定する移行環境

HI-UX/WE2の旧製品からAIX（EUC環境）のXMAP3 Serverへの移行

HI-UX/WE2の旧製品からLinuxのXMAP3 Serverへの移行

HI-UX/WE2の旧製品からSolaris（EUC環境）のXMAP3 Serverへの移行

(b)　システム構成の移行

シフトJIS環境からEUC環境へ移行する場合のシステム構成を次に示します。

表D-7　シフトJIS環境からEUC環境へ移行する場合のシステム構成（FOG2/W，XP/W）

項
番
システム構成
移行の
可否
移行方法および注意事項

大分類
中分類
小分類

1
帳票出力
スタンドアロン構成
－
○
AIXおよびSolarisではローカルプリンタへの帳票出力はできません。

C/S構成
WSクライアント
×
スタンドアロン構成またはPCクライアントのC/S構成に変更が必要です。PCクライアントでは，PC XMAP3※を使用することが前提となります。

（凡例）　－：該当しない　○：移行できる　×：移行できない

注※　

XMAP3 Serverと同一バージョン，またはそれ以降のバージョンが前提となります。基本的には同一バージョンを推奨します。

(c)　ユーザ資産の移行

シフトJIS環境からEUC環境へ移行する場合の各種ユーザ資産の移行方法を次に示します。

表D-8　シフトJIS環境からEUC環境へ移行する場合のユーザ資産（FOG2/W，XP/W）

項
番
ユーザ資産
移行の
可否
移行方法および注意事項

大分類
中分類
小分類

1
書式記述文
－
－
△
PC版XMAP3/Enterprise Edition※1への書式記述文の移行が前提となります。移行手順としては，ドローセットアップでターゲット環境を移行先に合わせ，インポート機能※2でマップ定義ファイルへの移行処理と，PC環境での書式イメージおよび行制御データファイルの生成が必要です。

2
書式ファイル
－
－
×
特定の日立プリンタにだけ登録できる書式ファイルであるため，書式記述文から移行してください。

3
アプリケーション※3
実行ファイル
－
×
ソースファイルから移行してください。

ソースファイル
COBOLインタフェース
△

シフトJISからEUCへの文字コード変換および半角かな対応が必要です。

書式オーバレイ名称を書式イメージファイル（拡張子なし）へ変更が必要です。

コンパイルオプションとして，「-Ks」「-Xp」が必要です。

外字を使用した帳票出力はできません。

C言語
(jstffxxx)
インタフェース
×

シフトJISからEUCへの文字コード変換および半角かな対応が必要です。

COBOLまたはXMAP3 Serverで提供するC言語(jstqlxxx)インタフェースへの変更が必要です。

外字を使用した帳票出力はできません。

4
コマンド/起動プログラム
開発系
cfog
×
書式開発用のコマンドは提供されませんので，PC XMAP3へ書式記述文を移行して書式イメージおよび行制御データファイルを生成してください。

cfogcp
×
同上

実行系
fogpr
△
従来のコマンドは提供されません。同等機能を提供したxmovlコマンドへの移行が必要です。

xpwrc
○
そのまま移行できます。

xpwdaemon
○
そのまま移行できます。

xptrace
○
そのまま移行できます。

5
環境ファイル※4
XP/W関連
XPWhosts
△
プリンタ登録の変更に合わせた設定が必要です。

XPWconfig
○
そのまま移行できます。

6
環境変数
－
FOG_PSNAME
△
XMAP3_PSNAMEへの変更が必要です。

FOG_FORM
△
XMAP3_FMPへの変更が必要です。

FOG_LCB
×
行制御データファイル名は書式オーバレイ名で決定します。

FOG_FDIR
×
XMAPdrvファイルのmapPathで設定してください。

FOG_COPY
△
XMAP3_COPIESへの変更が必要です。

FOG_SYNC
×
非同期印刷固定となります。

FOG_MSG
×
メッセージ出力あり固定となります。

FOG_PMRGNU
×
マージン値の設定は，PC版XMAP3/Enterprise Edition※1での書式定義時に設定してください。

FOG_PMRGNL
×
同上

（凡例）　－：該当しない　○：移行できる　△：移行方法に従った移行が必要　×：移行できない

注※1

XMAP3 Serverと同一バージョン，またはそれ以前のバージョンが前提となります。基本的には同一バージョンを推奨します。

注※2

インポート機能で有効／無効となる定義情報については，マニュアル「画面・帳票サポートシステム　XMAP3　開発・実行ガイド」を参照してください。

注※3

シフトJISコードで作成されているファイルをEUCコードに変換する必要があります。なお，半角かな文字を使用する項目は，論理項目長が2倍になることを考慮してください。

注※4

半角英数文字以外（全角文字や半角かな文字など）を指定している場合は，シフトJISコードからEUCコードへの変換が必要です。

付録D.3　KAPS/W/PS，XMAP3/PRINTER UTILITY，XP/Wからの移行

＜この項の構成＞

(1)　同じシフトJIS環境への移行

(2)　シフトJIS環境からEUC環境への移行

(1)　同じシフトJIS環境への移行

(a)　想定する移行環境

HI-UX/WE2の旧製品からAIX（シフトJIS環境）のXMAP3 Serverへの移行

HI-UX/WE2の旧製品からHP-UXのXMAP3 Serverへの移行

HI-UX/WE2の旧製品からSolaris（シフトJIS環境)のXMAP3 Serverへの移行

(b)　システム構成の移行

同じシフトJIS環境へ移行する場合のシステム構成を次に示します。

表D-9　同じシフトJIS環境へ移行する場合のシステム構成（KAPS/W/PS，XMAP3/PRINTER UTILITY，XP/W）

項
番
システム構成
移行の
可否
移行方法および注意事項

大分類
中分類
小分類

1
帳票出力
スタンドアロン構成
－
○
AIXおよびSolarisではローカルプリンタへの帳票出力はできません。

C/S構成
WSクライアント
×
スタンドアロン構成またはPCクライアントのC/S構成に変更が必要です。PCクライアントでは，PC XMAP3※を使用することが前提となります。

（凡例）　－：該当しない　○：移行できる　×：移行できない

注※　

XMAP3 Serverと同一バージョン，またはそれ以降のバージョンが前提となります。基本的には同一バージョンを推奨します。

(c)　ユーザ資産の移行

同じシフトJIS環境へ移行する場合の各種ユーザ資産の移行方法を次に示します。

表D-10　同じシフトJIS環境へ移行する場合のユーザ資産（KAPS/W/PS，XMAP3/PRINTER UTILITY，XP/W）

項
番
ユーザ資産
移行の
可否
移行方法および注意事項

大分類
中分類
小分類

1
PAGEC記述文
－
－
×
PAGEC記述文の移行はできません。
PC版XMAP3/Enterprise Edition※で新規に書式イメージおよび行制御データファイルの生成が必要です。そのため，従来プリンタ固有の機能は使用できませんので，PC XMAP3で定義できる範囲でご使用ください。

2
PAGECモジュール
－
－
×
同上

3
アプリケーション
実行ファイル
－
×
ソースファイルから移行してください。

ソースファイル
COBOLインタフェース
△

書式オーバレイ（書式イメージファイル（拡張子なし））を使用する変更が必要です（APPLY FORMS-OVERLAY句の使用が前提）。

コンパイルオプションとして，「-Ks」「-Xp」が必要です。

jstqlxxx関数
△
XMAP3 Serverで提供するjstqlxxx関数への移行が必要です（書式オーバレイを使用するjstqlpag関数の使用が前提）。

4
コマンド/起動プログラム
開発系
pgen
×
PAGECモジュール開発用のコマンドは提供されませんので，PC XMAP3で書式イメージおよび行制御データファイルを生成してください。

kploadfog
×
プリンタへの書式オーバレイ登録が必要ないため，提供されません。

kploadfont
×
プリンタへの外字フォント登録が必要ないため，提供されません。

kpcodeprt
×
コード表印刷機能は提供されません。
xmovlコマンドやAPから確認したいコード範囲の印刷を行ってください。

実行系
xpwrc
○
そのまま移行できます。

xpwdaemon
○
そのまま移行できます。

xptrace
○
そのまま移行できます。

5
環境ファイル
XP/W関連
XPWhosts
△
プリンタ登録の変更に合わせた設定が必要です。

XPWconfig
○
そのまま移行できます。

6
環境変数
－
KAPS_PSNAME
△
XMAP3_PSNAMEへの変更が必要です。

KAPS_PGCDIR
×
XMAPdrvファイルのmapPathで設定してください。

KAPS_DEV
×
デバイス名指定は必要ありません。

KAPS_SYNC
×
非同期印刷固定となります。

KAPS_MSG
×
メッセージ出力あり固定となります。

（凡例）　－：該当しない　○：移行できる　△：移行方法に従った移行が必要　×：移行できない

注※

XMAP3 Serverと同一バージョン，またはそれ以前のバージョンが前提となります。基本的には同一バージョンを推奨します。

(2)　シフトJIS環境からEUC環境への移行

(a)　想定する移行環境

HI-UX/WE2の旧製品からAIX（EUC環境）のXMAP3 Serverへの移行

HI-UX/WE2の旧製品からLinuxのXMAP3 Serverへの移行

HI-UX/WE2の旧製品からSolaris（EUC環境）のXMAP3 Serverへの移行

(b)　システム構成の移行

シフトJIS環境からEUC環境へ移行する場合のシステム構成を次に示します。

表D-11　シフトJIS環境からEUC環境へ移行する場合のシステム構成（KAPS/W/PS，XMAP3/PRINTER UTILITY，XP/W）

項
番
システム構成
移行の
可否
移行方法および注意事項

大分類
中分類
小分類

1
帳票出力
スタンドアロン構成
－
○
AIXおよびSolarisではローカルプリンタへの帳票出力はできません。

C/S構成
WSクライアント
×
スタンドアロン構成またはPCクライアントのC/S構成に変更が必要です。PCクライアントでは，PC XMAP3※を使用することが前提となります。

（凡例）　－：該当しない　○：移行できる　×：移行できない

注※　

XMAP3 Serverと同一バージョン，またはそれ以降のバージョンが前提となります。基本的には同一バージョンを推奨します。

(c)　ユーザ資産の移行

シフトJIS環境からEUC環境へ移行する場合の各種ユーザ資産を次に示します。

表D-12　シフトJIS環境からEUC環境へ移行する場合のユーザ資産（KAPS/W/PS，XMAP3/PRINTER UTILITY，XP/W）

項
番
ユーザ資産
移行の
可否
移行方法および注意事項

大分類
中分類
小分類

1
PAGEC記述文
－
－
×
PAGEC記述文の移行はできません。
PC版XMAP3/Enterprise Edition※1で新規に書式イメージおよび行制御データファイルの生成が必要です。そのため，従来プリンタ固有の機能は使用できませんので，PC XMAP3で定義できる範囲でご使用ください。

2
PAGECモジュール
－
－
×
同上

3
アプリケーション※2
実行ファイル
－
×
ソースファイルから移行してください。

ソースファイル
COBOLインタフェース
△

シフトJISからEUCへの文字コード変換および半角かな対応が必要です。

書式オーバレイ（書式イメージファイル（拡張子なし））を使用する変更が必要です（APPLY FORMS-OVERLAY句の使用が前提）。

コンパイルオプションとして，「-Ks」「-Xp」が必要です。

外字を使用した帳票出力はできません。

jstqlxxx関数
△

シフトJISからEUCへの文字コード変換および半角かな対応が必要です。

XMAP3 Serverで提供するjstqlxxx関数への移行が必要です（書式オーバレイを使用するjstqlpag関数の使用が前提）。

外字を使用した帳票出力はできません。

4
コマンド/起動プログラム
開発系
pgen
×
PAGECモジュール開発用のコマンドは提供されませんので，PC XMAP3で書式イメージおよび行制御データファイルを生成してください。

kploadfog
×
プリンタへの書式オーバレイ登録が必要ないため，提供されません。

kploadfont
×
プリンタへの外字フォント登録が必要ないため，提供されません。

kpcodeprt
×
コード表印刷機能は提供されません。
xmovlコマンドやAPから確認したいコード範囲の印刷を行ってください。

実行系
xpwrc
○
そのまま移行できます。

xpwdaemon
○
そのまま移行できます。

xptrace
○
そのまま移行できます。

5
環境ファイル※3
XP/W関連
XPWhosts
△
プリンタ登録の変更に合わせた設定が必要です。

XPWconfig
○
そのまま移行できます。

6
環境変数
－
KAPS_PSNAME
△
XMAP3_PSNAMEへの変更が必要です。

KAPS_PGCDIR
×
XMAPdrvファイルのmapPathで設定してください。

KAPS_DEV
×
デバイス名指定は必要ありません。

KAPS_SYNC
×
非同期印刷固定となります。

KAPS_MSG
×
メッセージ出力あり固定となります。

（凡例）　－：該当しない　○：移行できる　△：移行方法に従った移行が必要　×：移行できない

注※1

XMAP3 Serverと同一バージョン，またはそれ以前のバージョンが前提となります。基本的には同一バージョンを推奨します。

注※2

シフトJISコードで作成されているファイルをEUCコードに変換する必要があります。なお，半角かな文字を使用する項目は，論理項目長が2倍になることを考慮してください。

注※3

半角英数文字以外（全角文字や半角かな文字など）を指定している場合は，シフトJISコードからEUCコードへの変換が必要です。

付録E　用語解説

英字｜ア行｜カ行｜サ行｜タ行｜ハ行｜マ行｜ラ行

英字

AP（Application Program）

画面・帳票に入出力する業務プログラムです。

API（Application Programming Interface）

画面の入出力および帳票の出力時に発生するAPとのプログラムインタフェースです。

APパターン・AP部品

APの定型的な型としてXMAP3 Serverが提供しているパターンです。APパターンは，プログラムの標準的な骨組みです。AP部品は，処理の手続きです。

これらを組み合わせて利用すると，APを効率よく作成でき，定型的なコーディングの統一も図れます。

C/Sシステム（Client - Server System）

サーバとクライアントで処理を分散する業務形態です。また，一つの処理をネットワーク上のサーバとクライアントで分担する機器構成モデル，または処理方式です。

CUI画面

キーボードからの文字入力が中心の画面です。従来のメインフレーム型オンライン業務か，キャラクタベースの業務で使用していた画面です。

dpi（dots per inch）

プリンタの印刷精度を示す数値で，25.4mm（1インチ）当たりのドット数を指します。この数値が大きいプリンタほど，精密な印刷ができます。

ESC/Pスルー（EPSON Standard Code for / Page printer）モード

シリアルプリンタ固有の印刷モードです。エプソン社のインパクト型ドットプリンタが該当します。

EUC（Extended UNIX Code）

UNIXで使用するために定められたマルチバイトコードです。ターゲットOSがAIXのEUC環境，LinuxおよびSolarisの場合に使用する文字コードです。

GUI画面

キーボードからの入力のほかに，マウスによる操作ができる画面です。Windowsの「ボタン」「スクロール」「プルダウン・カスケード」「ポップアップ」などが使用できます。

LIPS（LBP Image Processing System）

ページプリンタ固有の印刷モードです。キヤノン社のページプリンタが該当します。LIPSには，LIPS II+，LIPS IIIなどがあります。

LPI（Line Per Inch）

行の間隔の単位で，25.4mm（1インチ）当たり何行印字できるかを表します。PC XMAP3で「ます目の設定」を「自由な設定」にした場合，3，4，6，8，10，12LPIの中から選べます。例えば，8LPIは25.4mm（1インチ）当たりが8行になります。

OLTP（Online Transaction Processing）

オンライントランザクション処理を実現するプログラムプロダクトで日立OpenTP1などがあります。

PDF（Portable Document Format）

Adobe Acrobatが扱う文書のファイル形式で，特定のプラットフォームに依存しないで文書を表示できます。PC XMAP3では，ページプリンタ用帳票をPDFファイルに出力できます。

ア行

網掛け帳票

240dpi／300dpiのページプリンタ用の帳票です。各種の文字サイズ，けい線，網掛けなどが使えます。

イベント通知コード

コマンドコントロールオブジェクト（プッシュボタン，メニューバー）や確定キー（PFキーなど）に割り当てるコードです。オブジェクトやキーを操作するとイベントが発生し，通知コードに対応づけた動作（AP通知など）が実行されます。

イベント通知コードの値はドローセットアップで変更できます。動作はドローで変更できます。これを「INC定数」といいます。また，入力単位がイベントのとき通知される「イベント定数」もあります。

インポート

PC XMAP3のユティリティ機能の一つです。ほかのシステムで作成した定義ファイルを入力して，PC XMAP3で使用できる形式の定義ファイルに変換します。

オペレータインジケータ

キーボード状態や送信状態などのメッセージを画面に表示するための領域です。ユーザプログラムからの操作はできません。

オペレータインジケータの有無は，PC XMAP3側で定義します。

カ行

カーソル・フォーカス制御

カーソル・フォーカス制御は，ドローセットアップで設定します。カーソル・フォーカス制御は，同時に制御するか別々に制御するかを選択できます。

仮想端末定義ファイル（XMAPhosts）

APがプログラム中で使用する仮想端末名，デバイス，サービス名などの設定ファイルです。

行制御データファイル

書式オーバレイの使用時に，ユーザの行データを印字する行の間隔や，標準の文字サイズ・文字間隔などの情報を格納するファイルです。拡張子は「.pci」です。書式オーバレイの定義終了時に，書式イメージファイルとともに生成されます。

APでは，印刷するデータを1行（1レコード）ずつ出力し，1ページ分となった時点で書式がオーバレイされて印字されます。

グラフィック帳票

240dpi／300dpiのページプリンタ用の帳票です。網掛け帳票の機能に加え，オブジェクトやけい線などのバリエーションなどをより豊富に備えています。

けい線帳票

180dpiのドットインパクトプリンタ用の帳票です。カット紙に対応するものと，連続紙に対応するものとがあります。

OCR文字も使えます。

サ行

サービス名ファイル（XPWhosts）

表示・印刷サービスに関連するサービス名やサービス種別などを設定するファイルです。この情報はサーバ側だけに設定します。

修飾名

表示属性の変更をAPから指示するための定数です。次の手順で利用します。

PC XMAP3のドローセットアップで，修飾名と表示属性の対応を定義する

PC XMAP3のドローで，オブジェクトや画面の属性に「動的変更」を指定する
制御項目（修飾名を格納する領域）が論理マップに展開されます。

APで，制御データ項目に修飾名を格納する
表示属性が動的に変更されます。

ショートカットキー

メニューバーのメニュー項目の選択操作するキーです。フォーカス・カーソルの位置に関係なく，［Ctrl］+ ショートカットキーを押すことで該当するメニュー項目を選択できます。なお，メニューバーのメニュー項目，またはカスケードメニューを持つプルダウンメニューにはショートカットキーを定義できません。

初期クリア文字

AP実行時に，画面からの入力データをAPが受け取る前に，入力論理マップの各項目をあらかじめクリアしておく文字です。

書式イメージファイル

書式オーバレイの文字列やけい線などの情報を格納するファイル（拡張子は「.fmp」）です。書式オーバレイの定義終了時に，行制御データファイルとともに生成されます。

書式オーバレイ

240dpi／300dpiのページプリンタ用の書式オーバレイです。定型帳票から書式（文字列やけい線などの固定項目）を分離し，アプリケーション（行データ）を印刷時に重ねあわせるソフトオーバレイ方式を採っています。書式をプリンタ（ハードウェア側）に登録する出力方式とは異なります。

書式定義ファイル

PC XMAP3側のドローで定義した書式の定義情報を格納したファイル（拡張子は「.ifm」）です。

タ行

データキー（［Ctrl］＋［End］）

画面上のすべての入力テキスト（または入力フィールド）の文字を削除するためのキーです。データクリアキーともいいます。

データ消去通知文字

AP実行時に，画面からフィールドキーで入出力テキスト・フィールドのデータを消去したり，(00)₁₆のデータを受信したときにAPが受け取ったりするデータです。したがって，APが受け取ったデータがデータ消去通知文字であれば，画面操作でデータ消去されたと判断できます。

初期クリア文字や初期値とデータ消去通知とを分けておくことで，入力操作がなかったのか，データ消去されたのかが区別できます。

ただし，「入力済み」属性のオブジェクトで，画面確定時に入力データや表示データがない場合は，データ消去されていなくてもデータ消去通知文字が返ります。

また，データ消去通知文字に指定できるのは半角文字だけです。データ消去通知文字に「スペース」を指定した場合は，漢字専用オブジェクトでも1文字につき半角スペース二つが通知されます。

ドロー

PC XMAP3で画面や帳票を定義する機能（エディタ）です。画面や帳票のレイアウトや各オブジェクトの属性を定義します。定義内容から，マップ定義ファイル(書式オーバレイでは書式定義ファイル)，物理マップと論理マップ（書式オーバレイでは行制御データファイルと書式イメージファイル）を作成します。

ドローセットアップ

PC XMAP3で，画面や帳票の定義に関する標準の値を設定するための機能です。

ハ行

背景色

入出力テキストのボックス内の色やボタンボックス内の色です。 背景色は，16色から選べます。色の設定は，各属性ダイアログのほかに，ツールバーの［文字色／背景色］ボタンを押して表示される文字色／背景色のツールボックスで変更することができます。このツールボックスを使うと画面全体の配色を見ながら設定できます。

パネル定義文

マップ生成するための定義文です。PC XMAP3のマップ生成機能を使用して物理マップと論理マップを生成できます。

表示・印刷環境ファイル(XPWconfig)

XMAP3 Serverでの画面表示および帳票印刷環境の設定ファイルです。

表示属性

表示属性とは，画面では，テキストやフィールドに出力する文字色やボタンの活性／不活性などを指定する属性をいいます。また，帳票では，フィールドの文字の書体やけい線の種類などを指定する属性をいいます。ドローでは，必要に応じて各ダイアログで変更できます。

また，表示属性は定義上の指定のほかに，APから動的に変更できる属性もあります。APから動的に表示属性を変更するためには，PC XMAP3側のドローセットアップの動的変更を指定する修飾名で指定します。

フォーカス

GUI画面を表示した際，操作対象となるオブジェクトに表示される枠です。APから操作対象となるオブジェクトを選択することを「APからフォーカスを位置づける」といいます。

フォーカス制御

フォーカス位置の情報を制御するための制御項目です。APでは，フォーカスを設定したいオブジェクトに対応するフォーカス定数を，制御項目に格納して渡します。また，画面上でフォーカスが位置づいているオブジェクトに対応したフォーカス定数を，制御項目で受け取ります。なお，フォーカス定数は，PC XMAP3が生成します。このため，画面のオブジェクトの位置を変更しても，APを変更する必要はありません。

物理マップ

画面や帳票のオブジェクトの位置などを格納した情報ファイルで，拡張子は「.pmp」です。画面・帳票の定義終了時に，論理マップとともに生成されます。

ディスプレイやプリンタの入出力データを論理マップデータに変換したり，論理マップデータを入出力データに変換したりするときにXMAP3 Serverが参照します。

プレプリント帳票

180dpiのドットインパクトプリンタ用の帳票です。カット紙に対応するものと，連続紙に対応するものとがあります。

プレプリント用紙（あらかじめけい線や標題などが印刷されている用紙）に対して可変データを印字するときに使います。

バーコードやOCR文字も使えます。

ポップアップメニューファイル

メニュー項目が大量にある場合や，メニューを大分類，小分類にして表示したい場合，ポップアップテキストに表示するメニューデータをAP実行時にファイルから渡すことができます。このファイルをポップアップメニューファイルといいます。ポップアップメニューファイルは，あらかじめ作成して用意しておく必要があります。

マ行

マージン

ページプリンタで，用紙に穴を開けることを想定して設定しておく余白のことです。用紙の左上を起点にしてマージンを設定し，レイアウト開始位置をずらすことができます。このようにユーザが指定するマージンをソフトマージンといいます。これに対し，プリンタドライバおよびプリンタ装置ごとに，ハードマージンと呼ばれるハード機構上，印刷できない領域があります。このハードマージンの値よりも小さいマージンを設定すると，ハードマージンが有効になるので，注意してください。

マッピングライブラリ

実行支援のコンポーネントの一つです。マップを参照して画面表示や帳票印刷に必要なデータを生成します。

マップ生成

PC XMAP3のユティリティ機能の一つです。マップ定義ファイル，またはパネル定義文ファイルから，論理マップファイルと物理マップファイルを生成します。

また，書式定義ファイルから書式イメージファイルと行制御データファイルを生成します。

マップ定義ファイル

PC XMAP3ドローで定義した画面や帳票の定義情報であるソースマップを格納したファイルで，拡張子は「.imp」です。

画面・帳票の定義終了時に，論理マップとともに生成されます。物理マップと論理マップは，このマップ定義ファイルを基に生成されます。

文字色

入出力テキスト・フィールドの文字やボタンのラベルなどの色になります。文字色は，PC XMAP3で定義したパレット番号とXMAP3 Serverの表示・印刷環境ファイルで設定された値で表示される色が決まります。

ラ行

レイアウトパターン

PC XMAP3のドローで画面／帳票を新規作成するときに，用途に応じて指定するパターンです。標準的なレイアウト領域のサイズやパターンなどがあらかじめ設定されていて，ドローでのレイアウト定義の基本フォーマットとなります。

PC XMAP3が標準提供しているレイアウトパターンのほかに，ユーザが独自に作成・登録することもできます。

論理マップ

画面や帳票の可変情報を設定する出力論理マップと，画面から入力されたデータなどを設定する入力論理マップがあります。ファイルの拡張子は，COBOLの場合は「.cbl」，C言語の場合は「.h」です。画面・帳票の定義終了時に，登録集原文として物理マップとともに生成されます。

COBOLでAPを作成する場合は，COPY文で論理マップを取り込みます。AP実行時には，APに取り込まれた論理マップのデータ領域を介して，データがやり取りされます。ファイルの拡張子は，COBOLの場合は「.cbl」に，C言語の場合は「.h」になります。

索引

[記号]
[数字]
[Ａ][Ｃ][Ｄ][Ｅ][Ｆ][Ｇ][Ｈ][Ｉ][Ｊ][Ｋ][Ｌ][Ｍ][Ｏ][Ｐ][Ｑ][Ｒ][Ｓ][Ｔ][Ｕ][Ｗ][Ｘ]
[ア行][カ行][サ行][タ行][ナ行][ハ行][マ行][ヤ行][ラ行]

(記号)

*.COCLTCNF ,[2] ,[3]

*.COEBCD

*.COGPTH

*.COKSCD

*.COKYFC

*.COSPCD

*.PCQPRX

(数字)

1バイトコードレベル

1ページを1文書でスプール登録する

2バイトコードレベル

(英字)

(Ａ)

AIXでのプリンタの登録

AIXでの文字フォントファイルの準備

AIX用外字の定義と登録

AP〔用語解説〕

API〔用語解説〕

APインタフェースの概要〔画面入出力および帳票出力〕

APインタフェースの概要〔書式出力〕

APインタフェースの種類〔画面入出力および帳票出力〕

APインタフェースの種類〔書式出力〕

APからのフィールド属性の変更

AP作成の準備

AP実行時のXMAP3 Serverのリターンコード

AP実行時のトラブルシューティング

APの再実行（トラブル現象の再現）

APの作成方法

APパターン

APパターン〔種類〕

APパターン〔用語解説〕

APパターンを利用したAPの作成手順

AP部品〔用語解説〕

APを作成するためのディレクトリを用意する

(Ｃ)

C/S構成

C/Sシステム〔用語解説〕

C/Sシステムの通信設定の簡略化

CALLインタフェース

CALL文の発行順序

CALL命令

ccbl2002コマンド〔画面入出力・帳票出力するAPのコンパイル〕 ,[2] ,[3]

ccbl2002コマンド〔書式オーバレイ印刷するAPのコンパイル〕 ,[2] ,[3]

ccblコマンド〔画面入出力・帳票出力するAPのコンパイル〕 ,[2] ,[3] ,[4] ,[5]

ccblコマンド〔書式オーバレイ印刷するAPのコンパイル〕 ,[2] ,[3] ,[4]

ccコマンド ,[2] ,[3] ,[4]

CDE（共通デスクトップ環境）でのプリンタ設定手順

CHARACTER TYPE句

cmapcpコマンド

COBOLの書式印刷命令

CUI画面〔用語解説〕

CUI画面でのフィールド単位のデータ入力

C言語インタフェース ,[2]

C言語の画面入出力および帳票出力命令

C言語の書式印刷命令

(Ｄ)

DBの利用方法

DISABLE文

dpi〔用語解説〕

(Ｅ)

ESC/Pスルー〔用語解説〕

ESC/Pプリンタでプリンタ任せの改ページ印刷をする

EUC〔用語解説〕

EUC文字コードでの半角かなの扱い方

(Ｆ)

fontutil

FORMAT-n

(Ｇ)

gccコマンド

GUI画面〔用語解説〕

GUI画面とCUI画面で使用する表示色の初期値

(Ｈ)

hosts

HP-UXでのプリンタの登録

(Ｉ)

iconvコマンド

INTERVAL-m

IPアドレスを調査する

(Ｊ)

JP1/NPS連携時に1ページごとにジョブを登録する

JP1/NQSEXECのqprxコマンドオプション付加

JP1/NQSEXEC連携方式

JP1/NQSEXEC連携方式での印刷の設定

JP1を利用した印刷環境を共用するC/S構成

JSTQL_COMアドレス〔jstqlcls関数〕

JSTQL_COMアドレス〔jstqlctp関数〕

JSTQL_COMアドレス〔jstqldat関数〕

JSTQL_COMアドレス〔jstqllpt関数〕

JSTQL_COMアドレス〔jstqlopn関数〕

JSTQL_COMアドレス〔jstqlpag関数〕

JSTQL_CTLアドレス ,[2]

jstqlcls関数

jstqlctp関数

jstqldat関数

jstqllpt関数

jstqlopn関数

jstqlpag関数 ,[2]

jsvwadrv関数

jsvwadrv関数の発行順序

(Ｋ)

kadn1gc1.cbl

kadn1pc.cbl

(Ｌ)

LAN接続プリンタ使用時の注意事項

LAN直結プリンタを複数PCで共用するC/S構成

lcomid

lcomsvnm

Linuxでのプリンタの登録

Linuxでの文字フォントファイルの準備

LIPS〔用語解説〕

LIPSコマンドの作成モード

LPI〔用語解説〕

lprコマンド

LPスプールシステムでの帳票一括出力機能

LPスプール出力方式

(Ｍ)

mapfchkコマンド

MAPPING MODE句の扱い

(Ｏ)

OLTP〔用語解説〕

OLTP構成 ,[2]

(Ｐ)

PC XMAP3クライアントの起動

PC XMAP3の画面定義で色指定できないオブジェクトの表示色を指定する

PDF〔用語解説〕

PDFファイル出力後のプログラム起動

PDFファイル出力に関連する設定と注意事項

PDFファイルの圧縮

PDFファイルの出力先

POINT-l

PP一覧の表示

PPのインストール

PPの組み込み手順

PPの削除手順

(Ｑ)

qprxコマンド

(Ｒ)

RECEIVE文

(Ｓ)

SEND文

services

Solarisでのプリンタの登録

Solarisでの文字フォントファイルの準備

STATUS KEY句のリターンコード

(Ｔ)

TRANSCEIVE文

(Ｕ)

UDCエディタ

UDCファイル

(Ｗ)

WIDE

WRITE レコード名

WSとPCによるC/S構成での環境設定例

(Ｘ)

xlcコマンド ,[2] ,[3] ,[4]

XMAP_COM

XMAP_COMアドレス

XMAP_MDO

XMAP_OPN

XMAP_REQ

XMAP_REQアドレス

XMAP-COM

XMAP-MDO

XMAP-OPN

XMAP-REQ

XMAP3_COPIES

XMAP3_DOCNAME

XMAP3_FMP

XMAP3_FORMAT

XMAP3_PSNAME

XMAP3 Server詳細エラーコード ,[2]

XMAP3 Serverの位置づけ

XMAP3 Serverの特長

XMAP3 Serverの標準提供ファイルから必要なファイルを複写する

XMAP3サーバ起動時のトラブルシューティング

XMAP3サーバ機能

XMAP3サーバでの表示サービス/印刷サービスの障害監視設定

XMAP3サーバの起動

XMAP3サーバの複数起動

XMAP3サーバを自動起動する場合

XMAP3でのプリンタの設定

XMAPhosts〔用語解説〕

XMAPserv_VirtualHost

XPWconfig ,[2]

XPWconfig〔用語解説〕

XPWCSTMW

XPWhosts〔用語解説〕

XPWQPRX

(ア行)

(あ)

アプリケーションプログラム間でオープンを引き継ぐ場合

アプリケーションプログラムでの入力論理マップ上のデータチェック

アプリケーションプログラム分割時の注意

網掛け帳票〔用語解説〕

アンダードット

(い)

イベント通知コード

イベント通知コード〔用語解説〕

印刷環境をカスタマイズする

印刷サービス機能

印刷サービス名

印刷サービス名.PCCLNM[n]

印刷サービス名.PCCMPR ,[2]

印刷サービス名.PCDLLN

印刷サービス名.PCFOCP

印刷サービス名.PCFPTH

印刷サービス名.PCGRC

印刷サービス名.PCGSHO

印刷サービス名.PCLIPS

印刷サービス名.PCPAPP

印刷サービス名.PCPDCM

印刷サービス名.PCQPRX

印刷サービス名.PCRPRT

印刷サービス名.PCSPCR

印刷サービス名.PCTRAY

印刷サービス名.PLCHPC

印刷サービス名.PLLNPC

印刷サービス名.PLMGLF

印刷サービス名.PLMGTP

印刷サービス名.PLOTDR

印刷サービス名.PLPAKD

印刷サービス名.PLPAOT

印刷サービス名.PLPASZ

印刷サービス名.POCHPC

印刷サービス名.POLNPC

印刷サービス名.POMGLF

印刷サービス名.POMGTP

印刷サービス名.POOTDR

印刷サービス名.POPAGE

印刷サービス名.POPAOT

印刷サービス名.POPASZ

印刷サービス名.POPRHD

印刷サービス名アドレス

印刷サービス名の優先順位

印刷色をカスタマイズする

印刷する書式の設定 ,[2]

印刷部数

インタフェーステーブル

インタフェーステーブルの取り込み方法

インタフェース領域

インポート〔用語解説〕

(う)

ウィンドウの背景

(え)

エラーコードの一覧

(お)

オープンインタフェース領域の形式 ,[2]

オープン要求 ,[2]

同じ帳票で中身が異なるものを複数枚印刷

同じ帳票レイアウトで中身が異なるものを複数枚印刷

同じ内容の帳票を複数枚印刷

同じ内容のものを複数枚印刷

オプション設定要求 ,[2]

オペレータインジケータ〔用語解説〕

オペレータインジケータの背景

オペレータインジケータの文字

(カ行)

(か)

カーソル

カーソル・フォーカス制御〔用語解説〕

カーソル位置の通知

外字の設定

外字パターンの定義

外字ファイルの登録

外字マッピングテーブル

外字マッピングファイルの標準値

外字マッピングファイル名称

開発手順

各PCで実行するAPが共通な場合

各PCで実行するAPが異なる場合

拡張背景色

拡張文字色

仮想端末定義ファイル

仮想端末定義ファイル〔用語解説〕

画面・帳票を開発する手順

画面サンプルとAPパターンの組み合わせ

画面デザインに関する設定項目

画面表示・帳票出力時のリターンコード

画面表示と帳票印刷

画面表示用ソースファイル

環境設定ファイルの設定項目とAPの設定項目との関係

環境設定ファイルの編集

環境定義ファイルの運用方法

環境定義ファイルの形式

(き)

キー操作に関する設定項目

キー割り当てに関する設定項目

起動クライアント通知機能

起動クライアントを通知する場合の設定

機能範囲

行送りの制御情報テーブル

行制御データファイル〔用語解説〕

行単位のデータ入力

共通インタフェース領域の形式 ,[2]

行データ出力用の推奨コーディング

行データの制御情報テーブル

行データの属性の設定

行データの帳票印刷 ,[2]

共用ライブラリ

(く)

クライアントから起動するサーバAPが異なるC/S構成

クライアントから起動するサーバAPを共用するC/S構成

クラスタ構成

クラスタ構成でのXMAP3サーバおよびアプリケーションの起動

クラスタ構成での環境設定

クラスタ構成での環境設定例

クラスタ構成でのクライアント側の環境設定

クラスタ構成でのサーバ側の環境設定

グラフィック帳票〔用語解説〕

クローズ要求 ,[2]

(け)

けい線

けい線帳票〔用語解説〕

(こ)

コード変換

異なる帳票を交互に印刷 ,[2]

異なるプリンタに帳票を印刷 ,[2]

コマンド入力によってXMAP3サーバを起動する場合

コマンドの使用方法

コンパイル時のトラブルシューティング

(サ行)

(さ)

サーバAPから出力先プリンタを指定するC/S構成

サーバが2台以上のC/S構成

サービス名ファイル〔用語解説〕

サービス名ファイルの標準値

サービス名ファイルを編集する

サポートするプリンタ

(し)

システム装置

実行可能ファイル

実行環境のシステム構成

実行環境の設定に必要な情報を取得する

実行環境への移行機能

シフトJISで利用できる文字の範囲

修飾名〔用語解説〕

出力／固定グラフィック帳票をスタンドアロン構成で印刷する

出力フィールドの再表示

出力要求 ,[2]

取得する必要がある情報

ショートカットキー〔用語解説〕

ショートカットキーに関する設定項目

初期クリア文字〔用語解説〕

書式イメージ・行制御データのファイル転送

書式イメージファイル〔用語解説〕

書式イメージファイルを格納するディレクトリの優先順位

書式オーバレイ〔用語解説〕

書式オーバレイ印刷時の環境変数

書式オーバレイ印刷時のリターンコード

書式オーバレイ印刷ユティリティ ,[2]

書式オーバレイ印刷ユティリティコマンド

書式オーバレイ名称 ,[2]

書式オーバレイを開発する手順

書式定義ファイル〔用語解説〕

書式名

書式名格納エリア

書式名格納領域のアドレス

書式名の優先順位

書体

書体の優先順位

(す)

スタンドアロン環境，およびC/S環境下での画面入出力および帳票出力命令〔COBOL〕

スタンドアロン環境，およびC/S環境下での画面入出力および帳票出力命令〔C言語〕

スタンドアロン構成

スタンドアロン構成での環境設定例

(タ行)

(た)

ダイアログの表示

(ち)

チューニング

帳票印刷用ソースファイル

帳票出力時のXMAP3 Serverとアプリケーションプログラムの関係

帳票を印刷するAPを実行する場合

(つ)

通信記述項

通信データを圧縮する

(て)

定義サンプル

データキー〔用語解説〕

データ消去通知文字〔用語解説〕

テーブルID

デバイスの種別

(と)

動的変更テーブル

動的変更テーブルの標準出力先

登録集原文

トラブルの対処方法

ドロー〔用語解説〕

ドローセットアップ〔用語解説〕

(ナ行)

(に)

入力フィールドのクリア

入力要求 ,[2]

(ハ行)

(は)

ハードウェア構成

背景色

背景色〔用語解説〕

パネル定義文〔用語解説〕

(ひ)

日立COBOLインタフェース ,[2]

日立PPインストーラ

日立PPインストーラの起動

表形式の一覧表示

表示・印刷環境のカスタマイズ

表示・印刷環境ファイル ,[2]

表示・印刷環境ファイル〔用語解説〕

表示・印刷環境ファイルとPC XMAP3の画面定義との関係

表示・印刷環境ファイルとPC XMAP3の帳票定義との関係

表示・印刷環境ファイルの運用方法

表示・印刷環境ファイルの形式

表示・印刷環境ファイルを編集する

表示サービスに対する設定項目

表示サービス名.DCACEL［n］

表示サービス名.DCAENT

表示サービス名.DCAKEY[n]

表示サービス名.DCBKSP

表示サービス名.DCCAKY[n]

表示サービス名.DCCHSZ

表示サービス名.DCCKEY[n]

表示サービス名.DCCLNM[n]

表示サービス名.DCCLXB[n]

表示サービス名.DCCLXF[n]

表示サービス名.DCCMCS

表示サービス名.DCCMOB

表示サービス名.DCCMPR ,[2]

表示サービス名.DCCPKY

表示サービス名.DCCPMD

表示サービス名.DCCRSL

表示サービス名.DCCUAK

表示サービス名.DCCURC

表示サービス名.DCCURS

表示サービス名.DCDCCP

表示サービス名.DCDFEP

表示サービス名.DCDTTF

表示サービス名.DCEXEC

表示サービス名.DCFCLR

表示サービス名.DCFKEY[n]

表示サービス名.DCFLCL

表示サービス名.DCFLKD

表示サービス名.DCFLWD

表示サービス名.DCGCKO

表示サービス名.DCGCRC

表示サービス名.DCGEUD

表示サービス名.DCGFLC

表示サービス名.DCGOCC

表示サービス名.DCGOFC

表示サービス名.DCGONC

表示サービス名.DCGPBB

表示サービス名.DCGSHO

表示サービス名.DCGSTC

表示サービス名.DCGUDC

表示サービス名.DCHRSL

表示サービス名.DCICFN

表示サービス名.DCINKY

表示サービス名.DCINMD

表示サービス名.DCINST

表示サービス名.DCJAMD

表示サービス名.DCJROM

表示サービス名.DCKADD

表示サービス名.DCKDIV

表示サービス名.DCKFEP

表示サービス名.DCKMUL

表示サービス名.DCKPDN

表示サービス名.DCKPSL

表示サービス名.DCKPUP

表示サービス名.DCKSUB

表示サービス名.DCLCCP

表示サービス名.DCLNFD

表示サービス名.DCLSTW

表示サービス名.DCMCRO

表示サービス名.DCMCRP

表示サービス名.DCMCSH

表示サービス名.DCMLSM

表示サービス名.DCMPCS

表示サービス名.DCMPPS

表示サービス名.DCMPTH

表示サービス名.DCMSDG

表示サービス名.DCMSMV

表示サービス名.DCOPCC

表示サービス名.DCOPFC

表示サービス名.DCOPNC

表示サービス名.DCOPPS

表示サービス名.DCPSNM

表示サービス名.DCRCTL

表示サービス名.DCSAKY[n]

表示サービス名.DCSCKY[n]

表示サービス名.DCSGSL

表示サービス名.DCSHAD

表示サービス名.DCSIFT

表示サービス名.DCSKEY[n]

表示サービス名.DCSLCR

表示サービス名.DCSRED

表示サービス名.DCSWMV

表示サービス名.DCSXPI

表示サービス名.DCUDOT

表示サービス名.DCUDTC

表示サービス名.DCVRSL

表示サービス名.DCVTSL

表示サービス名.DCWFEP

表示サービス名.DCWNCT

表示サービス名.DCWNMN

表示サービス名.DCWNMX

表示サービス名.DCWNSW

表示サービス名.DCWNTL

表示色をカスタマイズする

表示属性〔用語解説〕

標準パターン

(ふ)

ファイルの一覧

ファイルの転送方法〔書式イメージ・行制御データ〕

ファイルの転送方法〔物理マップ〕

ファイルの転送方法〔論理マップ・動的変更テーブル〕

ファンクションキーに関する設定項目

フォーカス／カーソル位置のチェック

フォーカス〔用語解説〕

フォーカス位置の通知（GUI画面の場合）

フォーカス制御〔用語解説〕

複数ページを1文書でスプール登録する

物理マップ〔用語解説〕

物理マップの移行

物理マップの常駐について

物理マップのファイル転送

部品パターン ,[2]

プリンタ出力用ファイルの定義

プリンタ種別

プリンタ使用時の注意事項

プレプリント帳票〔用語解説〕

プログラムパターン ,[2]

プログラムパターンと部品パターン

(へ)

ヘルプ画面の表示

編集するファイルの一覧（C/S構成のクライアントPCの場合）

編集するファイルの一覧（C/S構成のサーバWSの場合）

編集するファイルの一覧（OLTP構成のクライアントPCの場合）

編集するファイルの一覧（OLTP構成のサーバWSの場合）

編集するファイルの一覧（スタンドアロン構成の場合）

(ほ)

ポート番号管理ファイル

ポート番号管理ファイルを編集する

ポート番号を調査する

ホストアドレス管理ファイル

ホストアドレス管理ファイルを編集する

ホスト名を調査する

ポップアップメニューファイル〔用語解説〕

(マ行)

(ま)

マージン〔用語解説〕

マッピングインタフェース領域の形式 ,[2]

マッピングオプション

マッピング構成ファイル

マッピング属性ファイル

マッピング属性ファイルに指定する項目

マッピングライブラリ〔用語解説〕

マップ生成〔用語解説〕

マップ定義ファイル〔用語解説〕

マップドライバ環境定義ファイル

マップドライバ機能

(め)

メッセージの一覧

メニュー画面からの次画面表示

メニュー画面の表示処理

(も)

文字色 ,[2]

文字色〔用語解説〕

文字フォントの準備

(ヤ行)

(ゆ)

ユーザアプリケーションプログラムの通信障害監視の設定

(よ)

要求インタフェース領域の形式 ,[2]

(ラ行)

(れ)

レイアウトパターン〔用語解説〕

(ろ)

ログ情報採取の指定

ログ情報の種類

ログ情報の利用方法

ログファイルの内容確認

論理ハードコピーを印刷する

論理マップ〔用語解説〕

論理マップ・動的変更テーブルのファイル転送

論理マップの取り込み方法〔COBOL〕

論理マップの取り込み方法〔C言語〕

■ 商標類

Acrobatは，Adobe Systems Incorporated（アドビシステムズ社）の商標です。
Adobeは，Adobe Systems Incorporated（アドビシステムズ社）の商標です。
AIXは，米国におけるInternational Business Machines Corporationの登録商標です。
AIX 5Lは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
ESC/Pは，セイコーエプソン(株)の商標です。
HACMPは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
Itaniumは，アメリカ合衆国および他の国におけるインテル コーポレーションまたはその子会社の登録商標です。
JFIFは，C-Cube Microsystems社が規定したフォーマットの名称です。
Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
LIPSは，キヤノン（株）が開発した言語仕様です。
LIPSII+は，キヤノン（株）が開発した言語仕様です。
LIPSIIIは，キヤノン（株）が開発した言語仕様です。
Microsoftは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
MS-DOSは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
PA-RISCは，米国Hewlett-Packard Companyの商標です。
PC-9800は，日本電気（株）の商品名称です。
PC/ATは，米国International Business Machines Corp.の商品名称です。
PostScriptは，米国Adobe Systems, Inc.が開発した言語仕様です。
Red Hatは，米国およびその他の国でRed Hat,Inc. の登録商標若しくは商標です。
Solarisは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Sun Microsystemsは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
TurboLinuxの名称及びロゴは，TurboLinux, Inc. の商標です。
Turbolinuxは，ターボリナックス株式会社の商標または登録商標です。
UNIXは，X/Open Company Limited が独占的にライセンスしている米国ならびに他の国における登録商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows NTは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Windows Serverは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
X Window Systemは，米国X Consortium, Inc.が開発したソフトウェアです。
プログラムプロダクト「P-9D2B-2521」には，米国Sun Microsystems, Inc.が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D2B-2521」には，UNIX System Laboratories, Inc.が著作権を有している部分が含まれています。