XMAP3 Version 5

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

XMAP3 入門

入門書

3020-7-510-10

目　　次

前書き

変更内容

はじめに

第1編　紹介

1.　XMAP3を紹介します

1.1　XMAP3でできることについて紹介します

1.2　XMAP3の製品体系について紹介します

1.3　XMAP3を使った業務開発の流れを紹介します

1.4　例題で利用するシステム構成を紹介します

2.　XMAP3を理解しましょう

2.1　XMAP3をインストールしましょう

2.1.1　XMAP3をインストールします

2.1.2　ドローをセットアップします

2.2　XMAP3のドローの基本操作を覚えましょう

2.2.1　定義の基本手順を覚えます

2.2.2　XMAP3を起動します

2.2.3　レイアウトを定義するウィンドウについて理解します

2.2.4　レイアウトを定義します

2.2.5　レイアウト定義の基本操作を紹介します

2.2.6　レイアウト定義でのキー操作を覚えます

2.2.7　XMAP3を終了します

第2編　準備

3.　例題プログラムを紹介します

3.1　こんな例題を使います

3.2　画面用の例題プログラム

3.3　帳票用の例題プログラム

3.4　書式オーバレイ用の例題プログラム

3.5　例題プログラムの作成手順

4.　例題プログラムを作成する前にXMAP3の準備をしましょう

4.1　サンプルを準備します

4.2　例題の作成に使用するフォルダを準備します

4.3　アプリケーションプログラム作成の準備をします

4.3.1　COBOL2002をインストールします

4.3.2　アプリケーションプログラムを作成するためのフォルダを用意します

4.3.3　XMAP3の標準提供ファイルから，必要なファイルを複写しておきます

4.4　アプリケーションプログラムの作成方法を解説します

4.4.1　APパターン・AP部品とは

4.4.2　APパターンを利用したアプリケーションプログラムの作成手順

第3編　画面の作成

5.　GUI画面を作成しましょう

5.1　例題で作成するGUI画面を紹介します

5.2　GUI画面を作成しましょう

6.　CUI画面を作成しましょう

6.1　例題で作成するCUI画面を紹介します

6.2　CUI画面を作成しましょう

7.　画面を使ったアプリケーションプログラムを作成しましょう

7.1　コーディングを理解します

7.1.1　処理の流れ

7.1.2　コーディングのポイント

7.2　コーディングします

7.3　アプリケーションプログラムをコンパイルします

7.4　画面の作成で使用したサンプルプログラムを紹介します

第4編　帳票の作成

8.　帳票を作成しましょう

8.1　例題で作成する帳票を紹介します

8.2　帳票を作成しましょう

9.　帳票を使ったアプリケーションプログラムを作成しましょう

9.1　コーディングを理解します

9.1.1　処理の流れ

9.1.2　コーディングのポイント

9.2　コーディングします

9.3　アプリケーションプログラムをコンパイルします

9.4　帳票の作成で使用したサンプルプログラムを紹介します

第5編　書式オーバレイの作成

10.　書式を作成しましょう

10.1　例題で作成する書式を紹介します

10.2　書式を作成しましょう

11.　書式を使ったアプリケーションプログラムを作成しましょう

11.1　コーディングを理解します

11.1.1　処理の流れ

11.1.2　コーディングのポイント

11.2　コーディングします

11.3　アプリケーションプログラムをコンパイルします

11.4　書式の作成で使用したサンプルプログラムを紹介します

第6編　コンパイルと実行

12.　コンパイルし，実行しましょう

12.1　コンパイルと実行に必要な準備

12.1.1　コンパイルの準備

12.1.2　実行の準備

12.2　コンパイルと実行の手順

12.2.1　コンパイルするためのフォルダを準備します

12.2.2　コンパイルします

12.2.3　実行します

付録

付録A　XMAP3ではこんなこともできます

付録A.1　こんな機能が使えます

付録A.2　画面に関してこんな機能が使えます

付録A.3　帳票に関してこんな機能が使えます

付録A.4　開発環境のセットアップに関してこんな機能が使えます

付録A.5　実行環境のセットアップに関してこんな機能が使えます

付録A.6　チューニングやデバッグに関してこんな機能が使えます

付録B　知っていると便利なレイアウト定義の操作

付録C　トラブルが発生した場合には

付録D　APパターンとサンプルの紹介

付録D.1　APパターン一覧

付録D.2　サンプルの入手方法

付録E　XMAP3 Version 5の機能一覧

付録F　このマニュアルの参考情報

付録F.1　関連マニュアル

付録F.2　このマニュアルでの表記

付録F.3　KB（キロバイト）などの単位表記について

付録G　用語解説

索引

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

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

前書き

■ 対象製品

P-262B-5C54　 XMAP3 Developer Version 5　 05-02（適用OS：Windows XP，Windows Vista，Windows 7，Windows Server 2003，Windows Server 2003 R2，Windows Server 2008，Windows Server 2008 R2）
P-262B-5354　 XMAP3 Server Runtime Version 5　 05-04（適用OS：Windows XP，Windows Vista，Windows 7，Windows Server 2003，Windows Server 2003 R2，Windows Server 2008，Windows Server 2008 R2）
P-1M2B-2551　 XMAP3 Server Runtime Version 5　 05-01（適用OS：AIX V6.1）
P-1J2B-2551　 XMAP3 Server Runtime Version 5　 05-01（適用OS：HP-UX 11i V2(IPF)，HP-UX 11i V3(IPF)）
P-2C2B-5454　 XMAP3 Client Runtime Version 5　 05-04（適用OS：Windows XP，Windows Vista，Windows 7）
P-F262B-54542　 XMAP3 Client 印刷拡張機能 Version 5　 05-04（適用OS：Windows XP，Windows Vista，Windows 7）
P-262B-5F54　 XMAP3/Web for Cosminexus　 05-04（適用OS：Windows XP Professional，Windows Server 2003，Windows Server 2003 R2，Windows Server 2008，Windows Server 2008 R2）
P-F262B-5C541　 XMAP3 Developer 開発支援ユティリティ Version 5　 05-02（適用OS：Windows XP，Windows Vista，Windows 7，Windows Server 2003，Windows Server 2003 R2，Windows Server 2008，Windows Server 2008 R2）

上記のバージョン/リビジョン以降でも，このマニュアルをご利用になれる場合があります。最新バージョン/リビジョンは「リリースノート」でご確認ください。
これらの製品は，ISO9001およびTickITの認証を受けた品質マネジメントシステムで開発されました。

■ 輸出時の注意

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

■ 商標類

Acrobatは，Adobe Systems Incorporated(アドビシステムズ社)の商標です。
ActiveXは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Adobe，およびReaderは，Adobe Systems Incorporated(アドビシステムズ社)の米国ならびに他の国における商標または登録商標です。
AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
DOS/V は，日本アイ・ビー・エム（株）の商品名称です。
ESC/Pは，セイコーエプソン(株)の商標です。
HP-UXは，Hewlett-Packard Development Company,L.P.のオペレーティングシステムの名称です。
Hyper-Vは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
InstallShieldは，Macrovision Corporationの米国および/ または他の国における登録商標または商標です。
Internet Explorerは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
LIPSは，キヤノン(株)が開発した言語仕様です。
LIPSII+は，キヤノン(株)が開発した言語仕様です。
LIPSIIIは，キヤノン(株)が開発した言語仕様です。
LIPSIVcは，キヤノン(株)が開発した言語仕様です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Microsoft .NETは，お客様，情報，システムおよびデバイスを繋ぐソフトウェアです。
Microsoft Internet Information Servicesは，米国Microsoft Corporationの商品名称です。
Microsoft OfficeおよびExcelは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
Visual C++は，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
その他記載の会社名，製品名は，それぞれの会社の商標もしくは登録商標です。

■ マイクロソフト製品のスクリーンショットの使用について

Microsoft Corporationのガイドラインに従って画面写真を使用しています。

■ マイクロソフト製品の表記について

このマニュアルでは，マイクロソフト製品の名称を次のように表記しています。

表記 | 製品名
ActiveX | ActiveX(R)
Excel | Microsoft(R) Excel
Microsoft(R) Office Excel
Hyper-V | Microsoft(R) Hyper-VTM
Internet Explorer | Microsoft(R) Internet Explorer(R)
Windows(R) Internet Explorer(R)
Internet Information Services | Microsoft(R) Internet Information Services
Visual C++ | Visual C++ .NET 2003 | Microsoft(R) Visual C++(R) .NET 2003
Visual C++ 2005 | Microsoft(R) Visual C++(R) 2005
Visual C++ 2008 | Microsoft(R) Visual C++(R) 2008
Visual C++ 2010 | Microsoft(R) Visual C++(R) 2010
Windows | Windows XP | Windows XP Professional | Microsoft(R) Windows(R) XP Professional Operating System
Windows XP Home Edition | Microsoft(R) Windows(R) XP Home Edition Operating System
Windows Vista | Microsoft(R) Windows Vista(R) Business 日本語版(32ビット版)
Microsoft(R) Windows Vista(R) Enterprise 日本語版(32ビット版)
Microsoft(R) Windows Vista(R) Ultimate 日本語版(32ビット版)
Windows 7 | Microsoft(R) Windows(R) 7 Professional 日本語版(32ビット版)
Microsoft(R) Windows(R) 7 Enterprise 日本語版(32ビット版)
Microsoft(R) Windows(R) 7 Ultimate 日本語版(32ビット版)
Microsoft(R) Windows(R) 7 Professional 日本語版(64ビット版)
Microsoft(R) Windows(R) 7 Enterprise 日本語版(64ビット版)
Microsoft(R) Windows(R) 7 Ultimate 日本語版(64ビット版)
Windows Server 2003 | Microsoft(R) Windows Server(R) 2003, Standard Edition 日本語版
Microsoft(R) Windows Server(R) 2003, Enterprise Edition 日本語版
Microsoft(R) Windows Server(R) 2003, Standard x64 Edition 日本語版
Microsoft(R) Windows Server(R) 2003, Enterprise x64 Edition 日本語版
Windows Server 2003 R2 | Microsoft(R) Windows Server(R) 2003 R2, Standard Edition 日本語版
Microsoft(R) Windows Server(R) 2003 R2, Enterprise Edition 日本語版
Microsoft(R) Windows Server(R) 2003 R2, Standard x64 Edition 日本語版
Microsoft(R) Windows Server(R) 2003 R2, Enterprise x64 Edition 日本語版
Windows Server 2008 | Microsoft(R) Windows Server(R) 2008 Standard 32-bit 日本語版
Microsoft(R) Windows Server(R) 2008 Enterprise 32-bit 日本語版
Microsoft(R) Windows Server(R) 2008 Standard 日本語版
Microsoft(R) Windows Server(R) 2008 Enterprise 日本語版
Windows Server 2008 R2 | Microsoft(R) Windows Server(R) 2008 R2 Standard 日本語版
Microsoft(R) Windows Server(R) 2008 R2 Enterprise 日本語版
Microsoft(R) Windows Server(R) 2008 R2 Datacenter 日本語版

■ 発行

2012年10月　3020-7-510-10

■ 著作権

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

変更内容

変更内容（3020-7-510-10）XMAP3 Server Runtime Version 5　05-04，XMAP3 Client Runtime Version 5　05-04，XMAP3 Client 印刷拡張機能 Version 5　05-04

追加・変更内容 | 変更個所
対象製品にXMAP3 Client 印刷拡張機能 Version 5を追加した。 | 1.2，1.3，付録E

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

はじめに

このマニュアルは，XMAP3の基本的な使用方法について説明したものです。

＜はじめにの構成＞

対象読者

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

オンラインヘルプの紹介

対象読者

XMAP3を初めて使用する方を対象としています。また，次に示す項目について理解，習得していることを前提とします。

Windowsの基本的な操作方法

COBOLでのプログラミング

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

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

記号
意味

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

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

［　　］－［　　］
一つ前のメニューを選択し，続けて後ろの項目を選択することを示します。
例：［ファイル］－［開く］
　　［ファイル］メニューから［開く］コマンドを選択することを示します。

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

斜体
インストールフォルダなど可変の個所を示します。

オンラインヘルプの紹介

XMAP3では，オンラインヘルプ（以降，ヘルプと呼びます）を提供しています。ヘルプでは，詳細な操作手順，トラブルの対処方法，用語，ダイアログやウィンドウの項目の説明などを参照できます。

1.　XMAP3を紹介します

XMAP3とは，画面，帳票や書式の定義から表示，印刷までを一貫して支援するシステムです。

この章では，XMAP3でできること，製品体系，および業務開発の流れを紹介します。

＜この章の構成＞

1.1　XMAP3でできることについて紹介します

1.2　XMAP3の製品体系について紹介します

1.3　XMAP3を使った業務開発の流れを紹介します

1.4　例題で利用するシステム構成を紹介します

1.1　XMAP3でできることについて紹介します

XMAP3とは，アプリケーションプログラムによる基幹業務の構築および運用で，画面，帳票および書式の定義から，画面の表示および帳票の印刷までを一貫してサポートする製品です。XMAP3の概要を次の図に示します。

図1-1　XMAP3の概要

企業の基幹業務では，GUI画面/CUI画面を使った操作や，売上明細，決裁書，在庫一覧表などビジネスに応じたさまざまな様式の帳票が活用されています。一連の業務はアプリケーションプログラムで構築し，業務の効率を上げることが課題となっています。

XMAP3を適用すると，表現力の豊かな画面および帳票を開発/保守でき，使いやすいユーザインタフェースで業務システムを運用できるようになります。XMAP3は，COBOLとの親和性が高い画面・帳票ツールなので，メインフレーム業務のオープン化や旧オフコン業務のリプレースに利用実績があります。

XMAP3を導入するメリットを次に示します。

基幹業務向けの画面・帳票が作成できる
業務処理のオペレータ向けに，グラフやボタン，スクロールバー付きの明細表など，業務処理の実行結果をわかりやすく表示する画面を作成できます。さらに，Windowsで快適に操作できるように，マルチウィンドウに対応しています。
帳票の出力では，ビジネスで使用する帳票に必要なバーコード，OCR文字印刷を始め，マルチフォントやイメージデータを印刷できます。出力先には，カット紙，連続紙，さらにペーパーレス化の目的でPDFファイルを選択できます。

効率良く業務を開発できる
画面や帳票を定義する開発環境（ドローおよびドローセットアップ）では，各種パターンのひな型や部品を使用して，画面・帳票を効率良く開発できます。プログラミング言語にはCOBOL，C/C++，Javaを利用できるので，プログラマのスキルに合わせてアプリケーションプログラムを開発できます。
また，画面・帳票のレイアウトとアプリケーションプログラムのプログラミングを独立/分離して設計および開発できる上，APIがOSで共通なので，COBOLプログラムなどの既存資産を有効活用できます。一度開発した画面・帳票は長期間利用できるように上位互換を保持しているため，既存のプログラムロジックも最小限の変更で済み，使い慣れた操作性や安定性を維持したまま，効率良く新しいシステムに移行できます。

いろいろな業務システムに幅広く対応できる
XMAP3は，スタンドアロン環境で運用できるだけでなく，多数のクライアントを接続したC/SシステムやWebシステムでも利用できます。どのシステム構成でも，XMAP3の画面操作は同じです。そのため，C/SシステムのクライアントとWebシステムのクライアントを同じ操作で実行できます。
また，Cosminexusアプリケーションサーバ，HiRDB，JP1，OpenTP1などの日立オープンミドルウェア製品と連携し，さまざまな形態の基幹システムに幅広く利用できます。
帳票の出力では，出力先や出力様式をアプリケーションプログラムで制御できるため，オンライン帳票（即時印刷），バッチ帳票（大量/夜間印刷），電子帳票に対応できます。

1.2　XMAP3の製品体系について紹介します

XMAP3には，画面・帳票を作成するための開発環境，スタンドアロン，バッチシステム，C/Sシステム，OLTPなどの基幹業務を実現する実行環境，さらにWebシステム（Windowsマシン/Webサーバ利用）を活用したWeb実行環境に対応する製品があります。

XMAP3の製品を次に示します。

開発環境
XMAP3 Developer（Windows版）
XMAP3 開発支援ユティリティ（Windows版）

実行環境（オンラインシステム向け）
XMAP3 Server Runtime（Windows版/UNIX版）
XMAP3 Client Runtime（Windows版）

Web実行環境（Web連携システム向け）
XMAP3/Web for Cosminexus（Windows版）

XMAP3での製品の位置づけを次の図に示します。

図1-2　XMAP3の製品の位置づけ

＜この節の構成＞

(1)　XMAP3 Developer

(2)　XMAP3 開発支援ユティリティ

(3)　XMAP3 Server Runtime

(4)　XMAP3 Client Runtime

(5)　XMAP3/Web for Cosminexus

(1)　XMAP3 Developer

XMAP3の画面，帳票定義，アプリケーションプログラムの開発など，XMAP3開発環境を提供する製品です。

(2)　XMAP3 開発支援ユティリティ

XMAP3 Developerでのマップ開発業務を拡張する機能を提供する製品です。UNIXおよびメインフレームのマップをWindowsに移管したり，画面や帳票などのマップファイルを別の形式に変換したりできるため，マップ開発の利便性が向上します。

(3)　XMAP3 Server Runtime

XMAP3のスタンドアロンおよびC/Sシステムのサーバ実行環境を提供する製品です。Windows対応のXMAP3 Server Runtimeでは，C/Sシステムのクライアント実行環境も提供しています。XMAP3で作成した画面のクライアントへの表示，および帳票の印刷ができます。UNIX版XMAP3 Server Runtimeでは，UNIX上のプリンタに印刷できます。

(4)　XMAP3 Client Runtime

XMAP3のスタンドアロン，およびC/Sシステムのクライアント実行環境を提供する製品です。XMAP3で作成した画面や帳票を，Windowsマシンで表示・印刷できます。

参考

XMAP3 Client RuntimeをインストールしたマシンにXMAP3 Client 印刷拡張機能をインストールすると，XMAP3 Server Runtimeの機能である印刷拡張セットアップを使用できるようになります。

(5)　XMAP3/Web for Cosminexus

XMAP3の画面と帳票のWeb実行環境を提供する製品です。XMAP3/Web for Cosminexusには，基盤とするWeb連携システムに応じて次に示す機能があります。

XMAP3 Cosminexus連携機能

Cosminexusアプリケーションサーバと連携して動作するWebシステムで，XMAP3を使用します。

XMAP3 TP1/Web連携機能

TP1/Webと連携して動作するWebシステムでXMAP3を使用します。

1.3　XMAP3を使った業務開発の流れを紹介します

XMAP3を使った業務開発の流れを次に示します。

画面・帳票の設計

マップの生成

アプリケーションプログラムの作成

アプリケーションプログラムのコンパイル，リンケージ，テスト

業務の実行および運用・保守

このマニュアルの例題では，手順2.～手順4.について説明しています。

XMAP3では，画面，帳票および書式のレイアウトやコーディングのサンプルをサポートサービスのWebサービスで提供しています。必要に応じてダウンロードし，各手順で参照・使用してください。

XMAP3の業務システムを構築する手順を次の図に示します。

ポイント

画面・帳票設計，マップ生成は，Windows版XMAP3で実行します。アプリケーションプログラムのコーディングは，Windows上でもUNIX上でもできます。

Windows版XMAP3実行環境でアプリケーションプログラムを使用する場合は，Windows上でアプリケーションプログラムをコンパイルします。UNIX版XMAP3実行環境でアプリケーションプログラムを使用する場合は，マップをUNIXマシン上に転送してから，UNIX上でアプリケーションプログラムをコンパイルします。

図1-3　XMAP3の業務システムを構築する手順

画面・帳票の設計
実際に画面・帳票を作成する前に，どのような形式の画面・帳票を作成するかを設計します。作成したい画面や帳票のレイアウト，画面の遷移などを考えます。
レイアウトはXMAP3のウィンドウ上で直接定義するので，ここでは，ラフスケッチなどで大体のイメージを把握しておきます。また，ここで，あらかじめデータ設計をしておきます。画面または帳票の設計については，マニュアル「XMAP3 開発ガイド」またはマニュアル「XMAP3 プログラミングガイド」を参照してください。

マップの生成
手順1.で考えたイメージを基に，ドローを使って画面，帳票，または書式のレイアウトを定義します。
レイアウトの定義を始める前に，必要に応じてXMAP3の開発環境をカスタマイズします。開発環境の設定には，ドローセットアップを使います。
また，レイアウトのひな型となるレイアウトパターンやレイアウト部品も必要に応じてドローで作成しておきます。
レイアウトに問題がなければ，レイアウトの定義情報をマップの定義情報を格納するファイル（マップ定義ファイル）に保存し，アプリケーションプログラムの実行に必要なマップを生成します。
なお，Windowsマシンでドローセットアップを使って設定した開発環境は，XMAP3 Developerの環境ファイル操作を使って，ほかのWindowsマシンに配布できます。
画面，帳票，または書式の開発については，マニュアル「XMAP3 開発ガイド」を参照してください。

アプリケーションプログラムの作成
XMAP3では，コーディングのひな型となるAPパターン・AP部品を用意しています。プログラムの処理内容に応じたAPパターン・AP部品を利用し，コーディングします。
アプリケーションプログラムの作成については，マニュアル「XMAP3 プログラミングガイド」を参照してください。

アプリケーションプログラムのコンパイル，リンケージ，テスト
作成したアプリケーションプログラムをコンパイラでコンパイルし，リンケージします。
UNIX版XMAP3の場合は，UNIX上のコンパイラでアプリケーションプログラムをコンパイルするため，マップをUNIXに転送してからコンパイルしてください。
アプリケーションプログラムのコンパイル，リンケージについては，マニュアル「XMAP3 プログラミングガイド」を参照してください。
アプリケーションプログラムをテストする前に，アプリケーションプログラムの実行環境を設定します。実行環境の設定方法は，XMAP3が動作するOSによって異なります。

適用OS
実行環境の設定方法

Windows版XMAP3
GUIで操作するXMAP3のセットアップ機能を使用します。セットアップ機能を次に示します。

表示・印刷セットアップ※
XMAP3の画面および帳票に関する環境を設定します。

UNIX版XMAP3
環境設定ファイルをテキストエディタで編集します。

注※

表示・印刷セットアップは，次に示す製品で提供します。

・XMAP3 Server Runtime

・XMAP3 Client Runtime

・XMAP3/Web for Cosminexus

アプリケーションプログラムのテストについては，マニュアル「XMAP3 実行ガイド」を参照してください。

業務の実行および運用・保守
実行する前に，画面の外観や操作キーの割り当て，プリンタの印刷モードなどを設定します。実行環境の設定方法は，XMAP3が動作するOSによって異なります。

適用OS
実行環境の設定方法

Windows版XMAP3
GUIで操作するXMAP3のセットアップ機能を使用します。セットアップ機能を次に示します。

表示・印刷セットアップ※1
XMAP3の画面および帳票に関する環境を設定します。

C/Sセットアップ※2
C/S構成に関する環境を設定します。

印刷拡張セットアップ※2
帳票印刷に関する拡張機能の環境を設定します。

UNIX版XMAP3
環境設定ファイルをテキストエディタで編集します。

注※1

表示・印刷セットアップは，次に示す製品で提供します。

・XMAP3 Server Runtime

・XMAP3 Client Runtime

・XMAP3/Web for Cosminexus

注※2

C/Sセットアップおよび印刷拡張セットアップは，XMAP3 Server Runtimeで提供します。

XMAP3 Client RuntimeをインストールしたマシンにXMAP3 Client 印刷拡張機能をインストールすると，XMAP3 Server Runtimeの機能である印刷拡張セットアップを使用できるようになります。

ポイント

C/S構成の場合，クライアント側とサーバ側のXMAP3の両方で，表示・印刷セットアップを実行します。

Webシステム構成の場合，表示・印刷セットアップはWebサーバ側だけで，Webクライアントには表示・印刷セットアップはありません。Webクライアントの画面の外観や操作キーの割り当て，プリンタの印刷モードなどは，Webサーバ側で設定します。

アプリケーションプログラムの実行
各種の設定が完了したら，アプリケーションプログラムを実行します。必要に応じて，ハードコピーで画面を印刷物として保管したり，ロギング支援で実行時のログ情報を取得したりします。

バックアップの取得
Windows版XMAP3の場合，表示・印刷セットアップなどで設定した実行環境は，XMAP3 Server RuntimeまたはXMAP3 Client Runtimeの環境ファイル操作を使ってバックアップできます。バックアップした実行環境は，JP1/NETM/DMなどを利用して配布し，環境ファイル操作を使ってリストアします。

アプリケーションプログラムの保守
運用では，完成したファイルやアプリケーションプログラムを保守します。アプリケーションプログラム実行時，アプリケーションプログラムから出力したデータが正しく画面に表示されているか確認したいときや，トラブルが発生したときのデバッグなどに，ハードコピーを利用できます。また，ロギング支援を使用してログ情報を確認したり，実行環境の情報を確認したりできます。

業務の実行および運用・保守については，マニュアル「XMAP3 実行ガイド」を参照してください。

1.4　例題で利用するシステム構成を紹介します

このマニュアルの例題は，一つのWindowsマシン上でXMAP3とアプリケーションプログラムを実行することを前提に説明しています。

例題で使用するシステム構成を次の図に示します。

図1-4　例題で使用するシステム構成

上記のように，単一のマシンで業務を実行する構成をスタンドアロン構成といいます。

XMAP3では，このほかにもクライアントとサーバで通信するシステム構成や，Cosminexusアプリケーションサーバと連携したシステム構成などさまざまなシステム構成を実現できます。詳細については，マニュアル「XMAP3 実行ガイド」を参照してください。

2.　XMAP3を理解しましょう

この章では，XMAP3の準備から，画面や帳票のレイアウトを定義するための基礎知識について説明します。実際の開発を始める前に，XMAP3の基本操作や，プログラム作成のおおまかな流れを理解しましょう。

＜この章の構成＞

2.1　XMAP3をインストールしましょう

2.2　XMAP3のドローの基本操作を覚えましょう

2.1　XMAP3をインストールしましょう

XMAP3を使って画面や帳票を設計する準備をしましょう。はじめに，XMAP3を業務開発に使うWindowsマシンにインストールし，作業に使用するフォルダを準備します。

ここでは，XMAP3 Developerをインストールする手順について説明しています。作成した画面，帳票，または書式のテスト表示・印刷をする場合，XMAP3 Developerに加えて，XMAP3 Server RuntimeまたはXMAP3 Client Runtimeをインストールしてください。

＜この節の構成＞

2.1.1　XMAP3をインストールします

2.1.2　ドローをセットアップします

2.1.1　XMAP3をインストールします

まず，XMAP3をインストールします。ここでは，XMAP3を新規にインストールする場合の手順について説明します。

XMAP3は，COBOLやC言語などのアプリケーションプログラムの開発言語と連携して業務の開発を支援します。したがって，この時点で，あらかじめ開発言語の環境をインストールしたり，アプリケーションプログラム作成に使うフォルダなどの環境を整えたりしておくことをお勧めします。

このマニュアルでは，日立で提供しているCOBOL2002を使用することを前提として説明を進めます。COBOL2002の準備については，「4.3　アプリケーションプログラム作成の準備をします」を参照してください。

＜この項の構成＞

(1)　インストールする前に

(2)　インストールの操作方法

(3)　アンインストール

(1)　インストールする前に

インストールを始める前に，次の内容を確認してください。

XMAP3に必要なディスクの空き容量がWindowsマシンに確保されているかを，十分に確認しておいてください。特に，空き容量があってもディスクが断片化されていると，インストールできない場合がありますので注意してください。

必ずWindows上で動作しているアプリケーションをすべて終了させてから，インストールを始めてください。

Windowsの場合は，Administratorsグループに属するユーザでインストールしてください。

(2)　インストールの操作方法

インストールする提供媒体からインストーラを起動します。
［ようこそ］ダイアログが表示されます。

ダイアログの内容を確認し，［次へ］ボタンを選びます。
［ユーザ情報］ダイアログが表示されます。

「ユーザ名」と「会社名」を入力し，［次へ］ボタンを選びます。

［インストール先のフォルダ］ダイアログが表示されます。

インストール先のフォルダを確認します。

インストール先のドライブやフォルダを変更したい場合は，［変更］ボタンを選び，インストールしたい場所を指定してください。
標準のインストール先は次のとおりです。

Windowsインストールドライブ¥Program files¥HITACHI¥XMAP3

注

すでにほかのXMAP3（XMAP3 Server RuntimeやXMAP3 Client Runtimeなど）がインストールされている場合，この画面は表示されません。XMAP3 Developerは，すでにインストールされているXMAP3のインストール先にインストールされます。

インストール構成の内容に問題がなければ，［インストール］ボタンを選びます。

インストールが開始されます。中止したい場合は［キャンセル］ボタンを選びます。インストールが完了すると，インストールが完了したことを通知するダイアログが表示されます。

［完了］ボタンを選びます。

(3)　アンインストール

アンインストールの操作方法を次に説明します。

Windowsの場合は，Administratorsグループに属するユーザでアンインストールしてください。また，必ずWindows上で動作しているアプリケーションをすべて終了させてから，アンインストールを始めてください。

Windowsの［コントロールパネル］を開き，［プログラムの追加と削除］を選びます。
［プログラムの追加と削除のプロパティ］ダイアログが表示されます。

「XMAP3 Developer Version 5」を選択して，［追加と削除］ボタンを選びます。
削除するかどうかを尋ねるダイアログが表示されます。

［はい］ボタンを選びます。
インストールされたファイルが削除されます。

なお，アンインストール後，Windowsの状態によっては，スタートメニューからインストール時に作成されたメニューが削除されなかったり，インストールされたファイルが削除されなかったりすることがあります。このような場合は，Windowsを再起動してください。

2.1.2　ドローをセットアップします

画面や帳票の定義（ドロー）に関する標準値を設定するには，ドローセットアップを使用します。ただし，XMAP3ではドローで仮定する標準値を用意しているため，この標準値を変更する場合だけ，ドローセットアップを使用します。

ドローセットアップで設定した内容は，マップの形式に関係していますので，標準値の変更は，ドローで画面や帳票を作成する前に済ませておく必要があります。ドローセットアップの詳細については，マニュアル「XMAP3 開発ガイド」を参照してください。

なお，このマニュアルの例題プログラムは，標準設定のままでXMAP3を使用することを前提としています。

2.2　XMAP3のドローの基本操作を覚えましょう

ここでは，XMAP3を起動して，画面・帳票を定義し，内容を確認したあと，XMAP3を終了するまでの流れを簡単に説明しています。また，XMAP3のウィンドウに表示されるさまざまなアイコンの紹介と，その機能について説明しています。

＜この節の構成＞

2.2.1　定義の基本手順を覚えます

2.2.2　XMAP3を起動します

2.2.3　レイアウトを定義するウィンドウについて理解します

2.2.4　レイアウトを定義します

2.2.5　レイアウト定義の基本操作を紹介します

2.2.6　レイアウト定義でのキー操作を覚えます

2.2.7　XMAP3を終了します

2.2.1　定義の基本手順を覚えます

新しく画面や帳票のレイアウトを定義するときの基本手順を次に示します。ここでは，GUI画面のレイアウトの定義を例に説明します。

XMAP3を起動します。
Windowsの［スタート］にあるプログラム一覧から［XMAP3］－［XMAP3 Developer］－［ドロー］を選びます。
［新規・更新選択］ダイアログが表示されます。

レイアウトを定義する前に定義対象を選択します。
「画面・帳票・書式を新規作成する」を選び，「対象」を選びます。
対象には「マップ」，「パターン」，または「部品」が選べます。ここでは，「マップ」を選びます。

［OK］ボタンをクリックすると，［新規作成］ダイアログが表示されます。

「マップ名」，「定義対象の選択」，および「パターンの選択」を設定します。
レイアウトに付ける名称（マップ名）を設定したあとで，「定義対象の選択」から作成したい画面，帳票，または書式の種類を選択します。
次に，「パターンの選択」から，作成したい画面，帳票，または書式のパターンを選択します。

［OK］ボタンをクリックすると，GUI画面定義ウィンドウが表示されます。

レイアウトを定義します。
ツールボックスのボタンから配置したいオブジェクトを選び，画面，帳票，または書式のレイアウトを定義します。定義したオブジェクトに詳細な設定をしたい場合は，ダイアログを表示して設定します。操作方法や内容がわからないとき，またはレイアウト定義のヒントを知りたいときなどには，ヘルプを参照してください。

定義内容を確認します。
テスト表示をして，レイアウトを確認します。画面を実際に表示して，目的のレイアウトが定義されているかどうかを確認してください。なお，帳票の場合は，テスト印刷機能を利用して帳票をプリンタに出力すると，レイアウトを確認できます。

注

テスト表示・印刷をするためには，XMAP3 Server RuntimeまたはXMAP3 Client Runtimeをインストールする必要があります。

また，レイアウト定義から生成される論理マップを表示して，内容を確認します。

レイアウト定義を終了します。
レイアウトをマップ定義ファイルに保存して，レイアウト定義を終了します。このとき，論理マップと物理マップ（書式の場合は，書式イメージファイルと行制御データファイル）が自動的に生成されます。

2.2.2　XMAP3を起動します

XMAP3を起動するには，次の二つの方法があります。

スタートメニューに用意されたアイコンから起動する

エクスプローラなどから目的のファイルを直接選んで起動する

また，COBOL開発マネージャから呼び出すこともできます。

スタートメニューからXMAP3のドローを起動する操作方法を説明します。

Windowsの［スタート］にあるプログラム一覧から［XMAP3］－［XMAP3 Developer］－［ドロー］を選びます。

2.2.3　レイアウトを定義するウィンドウについて理解します

レイアウト定義に使用するウィンドウは，定義する内容に応じて次のように分類されます。

GUI画面定義ウィンドウ

CUI画面定義ウィンドウ

帳票定義ウィンドウ

書式定義ウィンドウ

帳票定義ウィンドウには，ページプリンタ用とシリアルプリンタ用の2種類のウィンドウがあります。このマニュアルでは，これらをまとめて「帳票定義ウィンドウ」と呼びます。帳票定義ウィンドウおよび書式定義ウィンドウについては，マニュアル「XMAP3 開発ガイド」を参照してください。

ここでは，GUI画面定義ウィンドウを例に挙げて，レイアウトを定義するウィンドウの構成について説明します。

GUI画面定義ウィンドウを次の図に示します。

図2-1　GUI画面定義ウィンドウの構成

＜この項の構成＞

(1)　タイトルバー

(2)　メニューバー

(3)　ツールバー

(4)　ツールボックス

(5)　レイアウト領域

(6)　ステータスバー

(1)　タイトルバー

XMAP3の製品名と，レイアウトを定義しているマップ定義ファイルの名称が表示される領域です。画面および帳票では「マップ名.imp」が，書式では「書式名.ifm」が表示されます。

(2)　メニューバー

定義の操作をメニューとして表示し，操作する領域です。メニューの中から［ヘルプ］を選ぶとヘルプが使えます。

(3)　ツールバー

メニューバーの中にある機能のうち，使用頻度の高いものをボタンで表示してある領域です。ボタンを選ぶだけでよいので，操作手順を簡略化できます。

ボタンの種類は，GUI画面，CUI画面，帳票，書式によって一部異なります。ツールバーのボタンのうち，定義種別ごとに異なるものについて説明します。

(a)　GUI画面定義ウィンドウのツールバーのボタン

GUI画面定義ウィンドウのツールバーのボタンを次の表に示します。

表2-1　GUI画面定義ウィンドウのツールバーのボタン

ボタン | 名称 | 内容
[図データ]　 | レイアウトへ戻る | GUI画面定義ウィンドウに切り替えるときに使う。
[図データ]　 | 画面属性 | タイトルやメニューバーを定義するときに使う。また，画面の表示形態や文字サイズ，背景色などを指定するときに使う。
[図データ]　 | 文字色／背景色 | オブジェクトの背景色や文字色を設定するウィンドウに切り替えるときに使う。
[図データ]　 | 文字属性／枠高 | オブジェクトの書体やサイズを設定するウィンドウに切り替えるときに使う。
[図データ]　 | 線種／太さ | セパレータとフィールドボックスのデータを定義するウィンドウの状態から，けい線の線種を設定するウィンドウに切り替える場合に使う。
[図データ]　 | データ名 | レイアウト画面上に定義しているすべてのオブジェクトのデータ名を一覧で表示するときに使う。また，データ名の変更や，論理マップの生成順を指定するときに使う。
[図データ]　 | テスト表示 | 定義したGUI画面を実際に画面にテスト表示するときに使う。
[図データ]　 | 論理マップ表示 | 定義したGUI画面から生成される論理マップを確認したいときに使う。

(b)　CUI画面定義ウィンドウのツールバーのボタン

CUI画面定義ウィンドウのツールバーのボタンを次の表に示します。

表2-2　CUI画面定義ウィンドウのツールバーのボタン

ボタン | 名称 | 内容
[図データ]　 | レイアウトへ戻る | CUI画面定義ウィンドウに切り替えるときに使う。
[図データ]　 | 画面属性 | 画面属性やパネル属性動的変更を設定するときに使う。
[図データ]　 | 文字色 | オブジェクトの文字色を設定するウィンドウに切り替えるときに使う。
[図データ]　 | データ名 | レイアウト画面上に定義しているすべてのオブジェクトのデータ名を一覧で表示するときに使う。また，データ名の変更や，論理マップの生成順を指定するときに使う。
[図データ]　 | テスト表示 | 定義したCUI画面を実際に画面にテスト表示するときに使う。
[図データ]　 | 論理マップ表示 | 定義したCUI画面から生成される論理マップを確認したいときに使う。

(c)　帳票定義ウィンドウのツールバーのボタン

帳票定義ウィンドウのツールバーのボタンを次の表に示します。

表2-3　帳票定義ウィンドウのツールバーのボタン

ボタン | 名称 | 内容
[図データ]　 | レイアウトへ戻る | 帳票定義ウィンドウに切り替えるときに使う。
[図データ]　 | 帳票属性 | 用紙サイズや書式を変更するときに使う。
[図データ]　 | 文字色 | オブジェクトの文字色を設定するウィンドウに切り替えるときに使う（グラフィック帳票の場合）。
[図データ]　 | 文字属性 | 文字サイズや書体の種類を指定するウィンドウに切り替えるときに使う。
[図データ]　 | 線種／太さ | ページプリンタの場合，けい線の線種を設定するウィンドウに切り替えるときに使う（シリアルプリンタの場合は使えない）。
[図データ]　 | 網掛けパターン | ページプリンタの場合，網掛けのパターンを設定するウィンドウに切り替えるときに使う（グラフィック帳票の場合）。
[図データ]　 | データ名 | レイアウト画面上に定義しているすべてのオブジェクトのデータ名を一覧で表示するときに使う。また，データ名の変更や，論理マップの生成順を指定するときに使う。
[図データ]　 | テスト印刷 | 定義した帳票を実際にテスト印刷するときに使う。
[図データ]　 | 印刷プレビュー | 定義中の帳票の印刷イメージを表示するときに使う。
[図データ]　 | 論理マップ表示 | 定義した帳票から生成される論理マップを確認したいときに使う。

(d)　書式定義ウィンドウのツールバーのボタン

書式定義ウィンドウのツールバーのボタンを次の表に示します。

表2-4　書式定義ウィンドウのツールバーのボタン

ボタン | 名称 | 内容
[図データ]　 | レイアウトへ戻る | 書式定義ウィンドウに切り替えるときに使う。
[図データ]　 | 書式属性 | 用紙サイズや書式を変更するときに使う。
[図データ]　 | 文字属性 | 文字拡大の種類，文字サイズ，書体を指定するウィンドウに切り替えるときに使う。
[図データ]　 | 線種／太さ | けい線の線種を設定するウィンドウに切り替えるときに使う。
[図データ]　 | 網掛けパターン | 網掛けのパターンを設定するウィンドウに切り替えるときに使う。
[図データ]　 | テスト印刷 | 定義した書式を実際にテスト印刷するときに使う。
[図データ]　 | 印刷プレビュー | 定義中の書式の印刷イメージを表示するときに使う。

(4)　ツールボックス

ツールボックスには，画面や帳票の構成要素であるオブジェクトをボタンにしたものが入っています。ボタンの種類は，GUI画面，CUI画面，帳票，または書式によって異なります。また，ボタンの中には，複数の種類を持つものがあります。

(a)　GUI画面定義ウィンドウのツールボックスのボタン

GUI画面定義ウィンドウのツールボックスのボタンを次の表に示します。

表2-5　GUI画面定義ウィンドウのツールボックスのボタン

ボタン
名称
内容

[図データ]　
オブジェクト選択
選択状態のオブジェクトを解除したいとき，またはレイアウト領域のオブジェクトを選択状態にしたいときに使う。

[図データ]　
固定テキスト
画面の入出力時に変化しない文字列を定義するときに使う。ボタンの種類を次に示す。

固定テキスト（日本語）

固定テキスト（英数）

[図データ]　
出力テキスト
画面出力時にアプリケーションプログラムから表示する文字列の領域を定義するときに使う。ボタンの種類を次に示す。

出力テキスト（数字）

出力テキスト（日本語）

出力テキスト（英数）

[図データ]　
出力日付／時刻テキスト
画面出力時にアプリケーションプログラムから表示する日付や時刻の領域を定義するときに使う。ボタンの種類を次に示す。

出力日付テキスト

出力時刻テキスト

[図データ]　
予約テキスト
OpenTP1がサポートする予約項目名を定義するときに使う。

[図データ]　
入出力テキスト
（数字用）
画面上で入力，または入出力した数字をアプリケーションプログラムで受け取る領域を定義するときに使う。ボタンの種類を次に示す。

入出力テキスト（数字）

入出力テキスト（金額）

入出力テキスト（数値）

[図データ]　
入出力テキスト
（文字用）
画面上で入力，または入出力した文字列をアプリケーションプログラムで受け取る領域を定義するときに使う。ボタンの種類を次に示す。

入出力テキスト（日本語）

入出力テキスト（カナ）

入出力テキスト（英数）

[図データ]　
ポップアップ
候補（メニュー項目）の選択によってデータを入力するときに使う。ボタンの種類を次に示す。

固定ポップアップ

可変ポップアップ

[図データ]　
コンボボックス
表示されたデータの中から必要なデータを選択するボックスを定義するときに使う。ボタンの種類を次に示す。

固定コンボボックス

可変コンボボックス

キー入力固定コンボボックス

キー入力可変コンボボックス

[図データ]　
入出力日付／時刻テキスト
画面上で入力，または入出力した日付や時刻をアプリケーションプログラムで受け取る領域を定義するときに使う。ボタンの種類を次に示す。

入出力日付テキスト

入出力時刻テキスト

[図データ]　
スピンボックス
特定の範囲内の数値からデータを選択する場合に使う。

[図データ]　
フィールドボックス
GUI画面上で，キャラクタベースで定義したい項目があるときに使う※。

[図データ]　
プッシュボタン
画面に表示された情報に対して，どのように対応するかを選択するときや，メニュー画面で処理を選択するときに選ぶボタンを定義するときに使う。ボタンの種類を次に示す。

プッシュボタン（複数）

プッシュボタン（単独／追加）

[図データ]　
ラジオボタン
表示されたデータの中から，データを一つ選択するときに選ぶボタンを定義するときに使う。ボタンの種類を次に示す。

固定ラジオボタン（新規）

固定ラジオボタン（追加）

可変ラジオボタン（新規）

可変ラジオボタン（追加）

[図データ]　
チェックボタン
表示されたデータの中から複数のデータを選択するときに選ぶボタンを定義するときに使う。ボタンの種類を次に示す。

固定チェックボタン（単独／追加）

固定チェックボタン（複数）

可変チェックボタン（単独／追加）

可変チェックボタン（複数）

[図データ]　
セパレータ
複数のボタンやテキストの間を区切る線を引くときに使う。ボタンの種類を次に示す。

縦／横セパレータ

横セパレータの繰り返し

縦セパレータの繰り返し

[図データ]　
グループボックス
画面上のボタン，テキストなどをグループ化するボックスを定義するときに使う。ボタンの種類を次に示す。

グループボックス（枠あり）

グループボックス（枠なし）

[図データ]　
リストボックス
表示しているデータの中から必要なデータを選択するボックスを定義するときに使う。ボタンの種類を次に示す。

リストボックス（単一選択）

リストボックス（複数選択）

[図データ]　
メッセージアイコン
メッセージ画面などを定義するときに，メッセージの種別が視覚的にわかるようにアイコンを定義したい場合に使う。ボタンの種類を次に示す。

メッセージアイコン（インフォメーション）

メッセージアイコン（ワーニング）

メッセージアイコン（クエスチョン）

メッセージアイコン（エラー）

[図データ]　
グラフィック
イメージデータを定義画面内に取り込みたいときに使う。ボタンの種類を次に示す。

固定グラフィック

出力グラフィック

注※

フィールドボックス内で使うボタンを次の表に示します。

ボタン
名称
内容

[図データ]　
オブジェクト選択
ツールボックスからオブジェクトを選択したい場合，またはレイアウト領域に定義されているオブジェクトを選択状態にしたい場合に使う。

[図データ]　
固定フィールド
画面の入出力時に変化しない文字列を定義するときに使う。ボタンの種類を次に示す。

固定フィールド（日本語）

固定フィールド（英数）

[図データ]　
出力フィールド
画面出力時にアプリケーションプログラムから表示する文字列を定義するときに使う。ボタンの種類を次に示す。

出力フィールド（数字）

出力フィールド（日本語）

出力フィールド（英数）

[図データ]　
出力日付／時刻フィールド
画面出力時にアプリケーションプログラムから表示する日付や時刻を定義するときに使う。ボタンの種類を次に示す。

出力日付フィールド

出力時刻フィールド

[図データ]　
予約フィールド
OpenTP1がサポートする予約項目名を定義するときに使う。

[図データ]　
入出力フィールド（数字用）
画面上で入力，または入出力した数字をアプリケーションプログラムで受け取る領域を定義するときに使う。ボタンの種類を次に示す。

入出力フィールド（数字）

入出力フィールド（金額）

入出力フィールド（数値）

[図データ]　
入出力フィールド（文字用）
画面上で入力，または入出力した文字列をアプリケーションプログラムで受け取る領域を定義するときに使う。ボタンの種類を次に示す。

入出力フィールド（日本語）

入出力フィールド（カナ）

入出力フィールド（英数）

[図データ]　
入出力日付／時刻フィールド
画面上で入力，または入出力した日付や時刻をアプリケーションプログラムで受け取る領域を定義するときに使う。ボタンの種類を次に示す。

入出力日付フィールド

入出力時刻フィールド

[図データ]　
ポップアップ
候補（メニュー項目）の選択によってデータを入力するときに使う。ボタンの種類を次に示す。

固定ポップアップ

可変ポップアップ

[図データ]　
トグルフィールド
画面上で「オン／オフ」の選択をする領域を定義するときに使う。

[図データ]　
フレーム
フィールドなどを反復して組み合わせ，表形式で並べる場合に使う。ボタンの種類を次に示す。

フレーム（縦繰り返し）

フレーム（横繰り返し）

[図データ]　
塗りつぶし
塗りつぶしをするときに使う。ボタンの種類を次に示す。

塗りつぶし

塗りつぶし（枠付き）

塗りつぶしの繰り返し（1行間隔）

[図データ]　
表けい線の枠
表けい線を作成するときに使う。ボタンの種類を次に示す。

表けい線の枠（見出しなし）

表けい線の枠（見出しあり）

[図データ]　
けい線の繰り返し
一定の間隔を空けて，表けい線の横線または縦線を繰り返して引くときに使う。ボタンの種類を次に示す。

横けい線の繰り返し（2行間隔）

横けい線の繰り返し（1行間隔）

横けい線の繰り返し（自動間隔）

縦けい線の繰り返し（自動間隔）

[図データ]　
けい線
けい線を引くときに使う。ボタンの種類を次に示す。

縦（左）／横（上）けい線

縦（中央）／横（中央）けい線

縦（右）／横（下）けい線

[図データ]　
矩形
複数のけい線で構成される矩形を定義するときに使う。

(b)　CUI画面定義ウィンドウのツールボックスのボタン

CUI画面定義ウィンドウのツールボックスのボタンを次の表に示します。

表2-6　CUI画面定義ウィンドウのツールボックスのボタン

ボタン
名称
内容

[図データ]　
オブジェクト選択
ツールボックスからオブジェクトを選択したい場合，またはレイアウト領域に定義されているオブジェクトを選択状態にしたい場合に使う。

[図データ]　
固定フィールド
画面の入出力時に変化しない文字列を定義するときに使う。ボタンの種類を次に示す。

固定フィールド（日本語）

固定フィールド（英数）

[図データ]　
出力フィールド
画面出力時にアプリケーションプログラムから表示する文字列を定義するときに使う。ボタンの種類を次に示す。

出力フィールド（数字）

出力フィールド（日本語）

出力フィールド（英数）

[図データ]　
予約フィールド
OpenTP1がサポートする予約項目名を定義するときに使う。

[図データ]　
入出力フィールド（数字）
画面上で入力，または入出力した数字をアプリケーションプログラムで受け取る領域を定義するときに使う。

[図データ]　
入出力フィールド（文字用）
画面上で入力，または入出力した文字列をアプリケーションプログラムで受け取る領域を定義するときに使う。ボタンの種類を次に示す。

入出力フィールド（日本語）

入出力フィールド（カナ）

入出力フィールド（英数）

[図データ]　
フレーム
フィールドなどを反復して組み合わせ，表形式で並べる場合に使う。ボタンの種類を次に示す。

フレーム（縦繰り返し）

フレーム（横繰り返し）

[図データ]　
表けい線の枠
表けい線を作成するときに使う。ボタンの種類を次に示す。

表けい線の枠（見出しなし）

表けい線の枠（見出しあり）

[図データ]　
けい線の繰り返し
一定の間隔を空けて，表けい線の横線または縦線を繰り返して引くときに使う。ボタンの種類を次に示す。

横けい線の繰り返し（2行間隔）

横けい線の繰り返し（1行間隔）

横けい線の繰り返し（自動間隔）

縦けい線の繰り返し（自動間隔）

[図データ]　
縦／横けい線
縦，横のけい線を引くときに使う。

[図データ]　
矩形
複数のけい線で構成される矩形を定義するときに使う。

(c)　帳票定義ウィンドウのツールボックスのボタン

帳票定義ウィンドウのツールボックスのボタンを次の表に示します。

表2-7　帳票定義ウィンドウのツールボックスのボタン

ボタン
名称
内容

[図データ]　
オブジェクト選択
ツールボックスからオブジェクトを選択したい場合，またはレイアウト領域に定義されているオブジェクトを選択状態にしたい場合に使う。

[図データ]　
固定フィールド
帳票出力時に変化しない文字列を定義するときに使う。ボタンの種類を次に示す。

固定フィールド（日本語）※1

固定フィールド（英数）※1

[図データ]　
出力フィールド
帳票出力時にアプリケーションプログラムから印字する文字列を定義するときに使う。ボタンの種類を次に示す。

出力フィールド（数字）

出力フィールド（日本語）

出力フィールド（英数）

[図データ]　
出力日付／時刻フィールド
帳票出力時にアプリケーションプログラムから印字する日付や時刻を定義するときに使う。ボタンの種類を次に示す。

出力日付フィールド※2，※3

出力時刻フィールド※2，※3

[図データ]　
予約フィールド
OpenTP1がサポートする予約項目名を定義するときに使う。

[図データ]　
フレーム
フィールドなどを反復して組み合わせ，表形式で並べる場合に使う。ボタンの種類を次に示す。

フレーム（縦繰り返し）

フレーム（横繰り返し）

[図データ]　
デリミタ線
文字の1けたごとに区切る目盛り状の線を作成するときに使う※1，※2，※3。

[図データ]　
表けい線の枠
表けい線を作成するときに使う。ボタンの種類を次に示す。

表けい線の枠（見出しなし）※1

表けい線の枠（見出しあり）※1

[図データ]　
けい線の繰り返し
一定の間隔を空けて，表けい線の横線または縦線を繰り返して引くときに使う。ボタンの種類を次に示す。

横けい線の繰り返し（2行間隔）※¹

横けい線の繰り返し（1行間隔）※1

横けい線の繰り返し（自動間隔）※1

縦けい線の繰り返し（自動間隔）※1

[図データ]　
けい線
縦，横，斜めのけい線を引くときに使う。ボタンの種類を次に示す。

縦（左）／横（上）けい線※1

縦（中央）／横（中央）けい線※1，※2，※3

縦（右）／横（下）けい線※1，※2，※3

斜めけい線※1，※2，※3

[図データ]　
矩形
複数のけい線で構成される矩形を定義するときに使う。ボタンの種類を次に示す。

矩形※2

矩形（ラウンドコーナ）※1，※2

[図データ]　
円
円を作成するときに使う。ボタンの種類を次に示す。

円（実線）※1，※2，※3

円（点線）※1，※2，※3

[図データ]　
円弧
円弧を作成するときに使う。ボタンの種類を次に示す。

円弧（実線・角度大）※1，※2，※3

円弧（実線・角度中）※1，※2，※3

円弧（実線・角度小）※1，※2，※3

円弧（点線・角度大）※1，※2，※3

円弧（点線・角度中）※1，※2，※3

円弧（点線・角度小）※1，※2，※3

[図データ]　
網掛け
網掛けするときに使う。ボタンの種類を次に示す。

網掛け※1，※2

網掛けの繰り返し（1行間隔）※1，※2

網掛け（ラウンドコーナ）※1，※2

[図データ]　
バーコード
バーコードを印字するときに使う。ボタンの種類を次に示す。

出力バーコード※2，※3

固定バーコード※1，※2，※3

連結出力バーコード※1，※2，※3

[図データ]　
グラフィック
帳票出力時にイメージデータを取り込みたいときに使う。ボタンの種類を次に示す。

固定グラフィック※1，※2，※3

出力グラフィック※1，※2，※3

[図データ]　
出力OCR
OCR用の文字でデータをアプリケーションプログラムから印字するときに使う※3，※4。

注

グラフィック帳票の場合は，すべてのボタンが使用できます。

注※1

プレプリント帳票の場合は，使用できません。

注※2

けい線帳票の場合は，使用できません。

注※3

網掛け帳票の場合は，使用できません。

注※4

XMAP3で規定している範囲のOCRです。JISで規定された範囲ではありません。

(d)　書式定義ウィンドウのツールボックスのボタン

書式定義ウィンドウのツールボックスのボタンを次の表に示します。

表2-8　書式定義ウィンドウのツールボックスのボタン

ボタン
名称
内容

[図データ]　
オブジェクト選択
ツールボックスからオブジェクトを選択したい場合，または，レイアウト領域に定義されているオブジェクトを選択状態にしたい場合に使う。

[図データ]　
固定フィールド
書式印刷時に変化しない文字列を定義するときに使う。ボタンの種類を次に示す。

固定フィールド（日本語）

固定フィールド（英数）

[図データ]　
表けい線の枠
表けい線を作成するときに使う。ボタンの種類を次に示す。

表けい線の枠（見出しなし）

表けい線の枠（見出しあり）

[図データ]　
けい線の繰り返し
一定の間隔を空けて，表けい線の横線または縦線を繰り返して引くときに使う。ボタンの種類を次に示す。

横けい線の繰り返し（2行間隔）

横けい線の繰り返し（1行間隔）

横けい線の繰り返し（自動間隔）

縦けい線の繰り返し（自動間隔）

[図データ]　
けい線
縦，横，斜めのけい線を引くときに使う。ボタンの種類を次に示す。

縦（左）／横（上）けい線

縦（中央）／横（中央）けい線

縦（右）／横（下）けい線

斜めけい線

[図データ]　
矩形
複数のけい線で構成される矩形を定義するときに使う。ボタンの種類を次に示す。

矩形

矩形（ラウンドコーナ）

[図データ]　
円
円を作成するときに使う。ボタンの種類を次に示す。

円（実線）

円（点線）

[図データ]　
円弧
円弧を作成するときに使う。ボタンの種類を次に示す。

円弧（実線・角度大）

円弧（実線・角度中）

円弧（実線・角度小）

円弧（点線・角度大）

円弧（点線・角度中）

円弧（点線・角度小）

[図データ]　
網掛け
網掛けするときに使う。ボタンの種類を次に示す。

網掛け

網掛けの繰り返し（1行間隔）

網掛け（ラウンドコーナ）

[図データ]　
固定グラフィック
書式印刷時に変化しないイメージデータを取り込みたいときに使う。

(5)　レイアウト領域

画面，帳票，書式レイアウトを定義，編集する領域です。行・列で区切られています。GUI画面定義ウィンドウは，行に相当する「縦」座標と，列に相当する「横」座標で区切られています。縦の幅は行の幅の1/2になっています。このため，GUI画面のオブジェクトの位置をより詳細に指定できます。ただし，文字サイズはCUI画面，帳票の場合と同じです。

また，帳票では，ミリ／ドット／ます目単位でオブジェクトを配置することもできます。

(6)　ステータスバー

定義中の状態を表示する領域です。左側には，ツールバーやツールボックスから選択したボタンの名称が，右側には，定義中のオブジェクトの位置やサイズが表示されます。

2.2.4　レイアウトを定義します

レイアウトを定義する手順を，GUI画面定義ウィンドウでの固定テキストの定義を例に挙げて説明します。定義種別やオブジェクトによって多少の差異はありますが，レイアウト定義の基本手順は次のようになります。なお，GUI画面定義ウィンドウを表示するには，「5.2　GUI画面を作成しましょう」を参照してください。

作成したいオブジェクトのボタンを選びます。
ツールボックスの中から，該当するボタンをクリックします。ボタンの中には，単数か複数か，出力か固定かなどによって，複数の種類を持つものがあります。その場合は，ボタンをクリックすると種類が変わります。作成したいボタンが現れるまでクリックしてください。
選択したボタンの選択状態を解除したい場合は，［オブジェクト選択］ボタンを選ぶか，ほかのオブジェクトを選んでください。
例えば，固定テキストのボタンには，「固定テキスト（日本語）」と「固定テキスト（英数）」の2種類があります。ボタンをクリックすると，その二つが交互に表示されます。

レイアウト領域にオブジェクトを位置づけます。
レイアウト領域にマウスのポインタを位置づけてドラッグ（またはクリック）すると，レイアウト領域に固定テキストの領域が確保されます。

それぞれのオブジェクトを定義します。
確保した領域に「商品コード」と入力します。［Enter］キーを押すと，入力した文字列が確定します。このとき，領域の長さは，文字列の長さに合わせて自動的に変化します。

さらに詳細な定義をする場合は，ダイアログを表示して定義します。
XMAP3では，各オブジェクトに標準値が仮定されているので，特にダイアログで定義する必要はありません。標準値を変更したい場合は，詳細設定用のダイアログを表示して，詳細な情報を定義してください。各ダイアログの詳細については，マニュアル「XMAP3 開発ガイド」を参照してください。
確定した「商品コード」をダブルクリックすると，［固定テキストボックス］ダイアログが表示されます。このダイアログで，テキストに枠を付けたり，色を変えたりする定義ができます。

●オブジェクトの配置について

帳票を作成する場合，レイアウト定義でオブジェクトを配置する方法には，ます目配置モードとスケール配置モードがあります。それぞれの配置モードで指定できるグリッド種別を次の表に示します。

表2-9　配置モードで指定できるグリッド種別

項番 | 配置モードの種類 | グリッド種別
ます目 | ミリ | ドット
1 | ます目配置モード | ○ | × | ×
2 | スケール配置モード | ○ | ○ | ○

（凡例）

○：配置できます

×：配置できません

なお，スケール配置モードは，プレプリント帳票，グラフィック帳票，および書式オーバレイだけで利用できます。このほかの帳票や画面の場合は，常にます目配置モードです。

ます目配置モード

通常の配置モードです。行・列から成るます目単位のグリッドに沿ってオブジェクトを配置します。オブジェクトの作成や移動をするときは，ます目に沿って配置します。

スケール配置モード

プレプリント帳票，グラフィック帳票，および書式オーバレイだけで利用できる配置モードです。オブジェクトの位置を微調整できます。オブジェクトの作成や移動をするときは，ます目に関係なく，ミリやドット単位で配置します。

配置モードの切り替え

ます目配置モードとスケール配置モードの両方が利用できる帳票で配置モードを切り替える場合は，メニューバーの［表示］－［ます目配置］を選びます。［ます目配置］がチェックされている場合は，ます目配置モードになります。［ます目配置］がチェックされていない場合は，スケール配置モードになります。メニューバーの指定例を次に示します。

ます目配置モードの指定

スケール配置モードの指定（チェックを外す）

スケール配置モードの場合は，メニューバーの［表示］－［グリッド種別］から，［ミリ］，［ドット］または［ます目］を選びます。メニューバーの指定例を次に示します。

なお，配置済みのオブジェクトは，配置モードの切り替えによって再配置されることはありません。

2.2.5　レイアウト定義の基本操作を紹介します

レイアウト定義でよく使う，基本的な編集操作を紹介します。

＜この項の構成＞

(1)　オブジェクトを選択する

(2)　複数のオブジェクトを選択する

(3)　オブジェクトを切り取る

(4)　オブジェクトを削除する

(5)　直前に切り取ったオブジェクトや削除したオブジェクトを元に戻す

(6)　オブジェクトをクリップボードにコピーする

(7)　オブジェクトの位置を移動する

(8)　レイアウト領域にオブジェクトを貼り付ける

(9)　グループを解除する

(10)　レイアウト領域やプレーンのサイズを変更する

(1)　オブジェクトを選択する

レイアウト領域に配置したオブジェクトを選択します。

ツールボックスから[図データ]（［オブジェクト選択］）を選びます。
ポインタが次の形状になります。

レイアウト領域のオブジェクトをクリックします。
オブジェクトが選択されます。選択されたオブジェクトの例を次に示します。

選択されているオブジェクトを対象にして，移動，削除，色の変更，けい線種別の変更などの操作ができます。

(2)　複数のオブジェクトを選択する

複数のオブジェクトを選択して，移動，削除，色の変更，けい線種別の変更などの操作ができます。

ツールボックスから[図データ]（［オブジェクト選択］）を選びます。
ポインタが次の形状になります。

レイアウト領域で，複数のオブジェクトを囲むようにマウスでドラッグします。
ドラッグ中はポインタが次の形状になります。

ドラッグした範囲は一時的に枠で囲まれます。

マウスのボタンを離します。
オブジェクトが選択されます。

選択されたオブジェクト上にポインタを移動します。
移動ポインタ[図データ]が表示されます。

移動先までマウスでドラッグします。
移動範囲が枠で表示されます。

移動先でマウスのボタンを離します。
選択されたオブジェクトが移動します。

(3)　オブジェクトを切り取る

選択したオブジェクトをクリップボードへ転送し，オブジェクトをレイアウト領域から削除します。

切り取りたいオブジェクトを選択します。

ツールバーの［切り取り］，またはメニューバーの［編集］－［切り取り］を選びます。

(4)　オブジェクトを削除する

レイアウト領域からオブジェクトを削除します。この操作では，オブジェクトがクリップボードに転送されないため，注意してください。

削除したいオブジェクトを選択します。

ツールバーの［削除］，またはメニューバーの［編集］－［削除］を選びます。

(5)　直前に切り取ったオブジェクトや削除したオブジェクトを元に戻す

直前に実行した［切り取り］や［削除］の操作を取り消して，オブジェクトをレイアウト領域に戻します。3回までさかのぼって取り消せます。

ただし，位置情報を持たないオブジェクト（ボタンボックス中のボタンなど）は，同じ位置に戻らない場合があります。このような場合は，位置を設定し直してください。また，［削除］や［切り取り］のあとで，ほかの操作をしている場合，オブジェクトの重なりなどの制限によって元に戻せない場合があります。

ツールバーの［削除／切り取りを元に戻す］，またはメニューバーの［編集］－［削除／切り取りを元に戻す］を選びます。

(6)　オブジェクトをクリップボードにコピーする

選択したオブジェクトをクリップボードに転送します。

コピーしたいオブジェクトを選択します。

ツールバーの［コピー］，またはメニューバーの［編集］－［コピー］を選びます。

(7)　オブジェクトの位置を移動する

レイアウト領域に配置されたオブジェクトを移動します。

移動したいオブジェクトを選択します。
複数のオブジェクトが選択できます。選択したすべてのオブジェクトが移動の対象になります。
ポインタは，次の形状になる位置に移動してください。

目的の位置までドラッグします。
複数のオブジェクトを選択している場合は，選択状態のオブジェクトのうち一つをドラッグすると全体が移動します。
また，プレプリント帳票，グラフィック帳票，および書式オーバレイでは，カーソルキーによる移動操作もできます。ミリやドット単位で配置している場合，微調整をするときに適しています。

(8)　レイアウト領域にオブジェクトを貼り付ける

［切り取り］や［コピー］によって，クリップボードに転送されたオブジェクトをレイアウト領域に貼り付けます。

ツールバーの［貼り付け］または，メニューバーの［編集］－［貼り付け］を選びます。
オブジェクトがレイアウト領域の左上に貼り付けられます。配置したい位置にドラッグして移動してください。

(9)　グループを解除する

グループボックス中のオブジェクトは削除しないで，グループボックスだけを削除します。なお，グループを解除しないで［削除］や［切り取り］などをした場合は，グループ全体が対象になります。

グループボックスを選択します。

メニューバーの［編集］－［グループボックスを消す］を選びます。

グループが解除されます。グループ内のオブジェクトは削除されません。

(10)　レイアウト領域やプレーンのサイズを変更する

レイアウト領域上でサイズを変更できます。ほかに［属性設定］ダイアログで数値を指定する方法があります。なお，画面や帳票の種類によっては，サイズを変更できないものもあります。

領域の端にマウスポインタを位置づけます。
ポインタが次の形状になります。

サイズ変更したい位置までドラッグします。

2.2.6　レイアウト定義でのキー操作を覚えます

キーボードを使ったレイアウト定義の操作について説明します。ここでは，DOS/V標準キーボードのキーで説明します。

＜この項の構成＞

(1)　キーだけを使った操作

(2)　キーとマウスを使った操作

(1)　キーだけを使った操作

(a)　ダイアログを呼び出す，文字を確定する

オブジェクトを選択したとき復改キーを押すと，ダイアログを表示します。また，文字の入力時には，その入力文字を確定します。

［Enter[図データ]］キー

(b)　オブジェクトを削除する，文字を削除する

オブジェクトの選択状態で削除キーを押すと，レイアウト領域から削除します。文字入力時には，1文字削除します。

［Delete］キー

(c)　カーソルを先頭に位置づける

文字入力時に始点キーを押すと，カーソルをフィールドの先頭に移します。

［Home］キー

(d)　カーソルを最後に位置づける

文字入力時にENDキーを押すと，カーソルをフィールドの最後に移します。

［End］キー

(e)　機能拡張キー

レイアウト領域で有効な機能拡張キーは，ドローのメニューバーに表示されるメニュー項目の末尾に表示されます。次に，頻繁に使用する機能拡張キーを示します。

削除／切り取りを元に戻す：［Ctrl］＋［Z］キー

コピー　：［Ctrl］＋［C］キー

貼り付け：［Ctrl］＋［V］キー

切り取り：［Ctrl］＋［X］キー

(2)　キーとマウスを使った操作

(a)　オブジェクト配置時に反復して定義する

例えば，GUI画面のフィールドボックス中の入出力フィールドや，帳票の出力フィールドなどを，一度の操作で縦に繰り返して配置できます。レイアウト領域に配置するときに，配置したい位置を［Shift］キーを押したままマウスをドラッグしてカーソル領域で囲んでください。この領域にフィールドが下方向に配置されます。この操作のほか，ダイアログで繰り返し回数を指定することもできます。

(b)　オブジェクトをコピーする

レイアウト領域に定義したオブジェクトを［Ctrl］キーを押したままマウスで選び，オブジェクトを配置したい位置までドラッグするとコピーできます。

(c)　同じ種類のオブジェクトを連続して配置する

レイアウト領域に配置するときに，［Ctrl］キーを押したまま配置すると，同じ種類のオブジェクトを続けて配置できます。ツールボックスのアイコンを毎回選ぶ手間を省けます。

(d)　オブジェクトの配置操作を中止する

レイアウト領域でオブジェクトの配置先をドラッグ操作で指定しているときに，［Esc］キーを押すと，配置の操作を中止できます。

(e)　重なっているオブジェクトを選択する

GUI画面のボタンボックスやグラフィック帳票の網掛けなどで，レイアウト領域にオブジェクト同士を重ねて配置している場合，［Shift］キーを押したままマウスをクリックすると，目的のオブジェクトを選択できます。

2.2.7　XMAP3を終了します

レイアウト定義の作業が終了したとき，または作業を途中で中断したいときには，次の手順でXMAP3を終了します。

レイアウト定義ウィンドウのツールバーから［ドローの終了］を選びます。または，メニューバーの［ファイル］－［ドローの終了］を選びます。

レイアウト定義をファイルに保存するために［はい］ボタンを選びます。

XMAP3が終了します。

3.　例題プログラムを紹介します

このマニュアルでは，例題プログラムの開発作業を通して，XMAP3を使って画面，帳票，または書式を作成する方法を説明しています。この章では，マニュアル中で使用する例題プログラムについて説明します。実際に操作を始める前に，例題プログラムの概要を理解しておきましょう。

＜この章の構成＞

3.1　こんな例題を使います

3.2　画面用の例題プログラム

3.3　帳票用の例題プログラム

3.4　書式オーバレイ用の例題プログラム

3.5　例題プログラムの作成手順

3.1　こんな例題を使います

このマニュアルでは，次の3件の例題プログラムについて説明しています。

画面の例題：受注データ入力プログラム

得意先から注文を受けた商品データを画面から入力したあと，受注ファイルに格納するプログラムです。GUI画面とCUI画面の2種類の画面の作成方法を学習します。

帳票の例題：納品伝票印刷プログラム（帳票）

受注ファイルからデータを入力して，合計金額を計算し，商品に添付する伝票を印刷するプログラムです。論理マップを経由してデータを出力する帳票の作成方法を学習します。

書式オーバレイの例題：納品伝票印刷プログラム（書式オーバレイ）

受注ファイルからデータを入力して，合計金額を計算し，商品に添付する伝票を印刷するプログラムです。納品伝票の定型部分（固定の文字列やけい線）だけを書式としてレイアウト定義します。アプリケーションプログラムで書式と可変のデータを重ねあわせて出力する書式オーバレイ印刷の作成方法について学習します。

これらの例題プログラムで使用する画面，帳票，および書式には，XMAP3の定義を体験してもらうのに必要な最低限のオブジェクトが盛り込まれています。実際の運用を想定したものではないのでご注意ください。

例題プログラムの概要を次の図に示します。

図3-1　例題プログラムの概要

3.2　画面用の例題プログラム

受注データ入力プログラムは，入力画面をGUI画面とCUI画面の2種類の画面で作成できます。

GUI画面とは，キーボード入力のほかに，画面上のボタンやメニューをマウスで選んでデータを入力できる画面です。マウスを使って操作するので，キーボード操作に慣れていない人に向いています。また，GUI画面は視覚的にわかりやすいので，不特定多数の人が利用する画面に適しています。

CUI画面とは，キーボードからデータを入力する画面です。主に，データを，データに割り当てられているコード（例：商品コード）で入力するので，顧客に対して早い対応が求められたり，大量のデータを短時間に入力する必要があったりするデータエントリ業務に向いています。また，すでにCUI画面の操作に慣れているようなケース，つまりメインフレームやオフィスコンピュータから移行したシステムの業務にも適しています。

GUI画面とCUI画面では，作成方法が違います。GUI画面を作成する場合は，「5.　GUI画面を作成しましょう」を，CUI画面を作成する場合は，「6.　CUI画面を作成しましょう」を参照してください。

次に，受注データ入力プログラムの仕様について，利用する画面別に説明します。

＜この節の構成＞

(1)　GUI画面を利用する場合

(2)　CUI画面を利用する場合

(1)　GUI画面を利用する場合

得意先コードを入力します。
手元にある得意先コードと得意先名の対応表を見て，得意先コードをキーボードから入力します。入力後，フォーカスは自動的に入金区分の欄に位置づけられます。

入金区分を選択します。
ラジオボタンで入金区分を選択します。何も選択しない場合は，「現金」が選択されます。

リストボックスの中から商品名を選択します。
選択した商品名が反転表示されます。商品名は，一つだけ選択できます。

数量を4けた以内の数字で入力します。

割引特典が付く場合は，「割引あり」のチェックボタンをオンにします。
商品の単価の10％が割引になります。

一とおり注文内容を入力したら，次の処理に該当するプッシュボタンを選択します。

［次入力］ボタンを選択した場合

同じ得意先から続けて注文を受ける場合に，このボタンを選択します。得意先コードが正しければ，選択後，次の商品の注文を受け付ける状態になり，フォーカスが商品名の欄に位置づけられます。得意先コードが誤っている場合は，フォーカスが得意先コードの欄に位置づけられます。

［終了］ボタンを選択した場合

受注ファイルに注文内容を格納してから，処理を終了します。

(2)　CUI画面を利用する場合

得意先コードに該当するコード番号をキーボードから入力します。
カーソルは，自動的に入金区分の欄に位置づけられます。

入金区分に該当する番号をキーボードから入力します。
カーソルは，自動的に商品コードの欄に位置づけられます。

商品コードに該当する番号をキーボードから入力します。
カーソルは自動的に数量の欄に位置づけられます。

数量を4けた以内の数字で入力したあとで，［Enter］キーを押します。
カーソルは自動的に割引区分の欄に位置づけられます。

割引特典の有無を選び，該当する番号をキーボードから入力します。
1を選ぶと，商品の単価が10％引きになります。

一とおり注文内容を入力したら，次の処理に該当する［ファンクション］キーを押します。

［F2］キーを押した場合

同じ得意先から続けて商品の注文を受ける場合に，このキーを押します。得意先コードが正しければ，キーを押すと，次の商品の注文を受け付ける状態になります。カーソルは，商品コードの欄に位置づけられます。得意先コードが誤っている場合，カーソルは得意先コードの欄に位置づけられます。

［F3］キーを押した場合

受注ファイルに注文内容を格納して，処理を終了します。

3.3　帳票用の例題プログラム

納品伝票印刷プログラム（帳票）では，注文を受けた商品の一覧とその合計金額を得意先別に出力します。ただし，出力できる注文データは最大4件です。画面から入力したデータが5件以上あった場合，5件目以降のデータは出力されないのでご注意ください。

納品伝票印刷プログラム（帳票）の仕様について説明します。

受注ファイルからデータを入力します※。

得意先コードから得意先名を引き出します。

商品コードに対応する商品名と単価を引き出します。

単価に数量を掛けて，金額を計算します。
割引特典の「割引あり」が選択されている場合は，単価を10％引きにして金額を計算します。

金額を合計して合計金額を算出します。

得意先別にプリンタ出力し，伝票を発行します。

注※

このプログラムでは，受注ファイルから入力したデータに関係なく，一定のデータが帳票出力される仕様になっています。

3.4　書式オーバレイ用の例題プログラム

納品伝票印刷プログラム（書式オーバレイ）では，注文を受けた商品の一覧とその合計金額を得意先別に出力します。明細には，最大4件の注文データを出力できます。

次に，納品伝票印刷プログラム（書式オーバレイ）の仕様について説明します。

受注ファイルからデータを入力します※。

得意先コード，得意先名を編集して出力します。

各商品の金額を加算して合計金額を算出し，明細行を編集※して出力します。
この処理を4件分繰り返します。注文データが3件以下の場合は，空白行を出力します。

合計金額を編集して出力します。

改ページしたあと，納品伝票の印刷処理を終了します。

注※

このプログラムでは，これらの処理を仮定しています。明細行のデータは，書式に合わせて編集済みの行データを，テキストファイルから読み込みます。

3.5　例題プログラムの作成手順

例題プログラムは，次の図に示す手順で作成すると効率良く開発できます。

図3-2　例題プログラムの作成手順

それぞれの工程での，このマニュアルの参照先を次の表に示します。開発したい例題プログラムの種類に応じて，各章を順番に参照してください。

表3-1　各工程でのマニュアルの参照先

項番
工程
このマニュアルの参照先

画面の作成
帳票の作成
書式オーバレイの作成

1
XMAP3の準備
4章

2
レイアウトの定義

GUI画面
5章

CUI画面
6章

8章
10章

3
アプリケーションプログラムの作成
7章
9章
11章

4
コンパイル・実行
12章

4.　例題プログラムを作成する前にXMAP3の準備をしましょう

この章では，例題プログラムを作成する前に，XMAP3の準備，およびCOBOL2002を使ったアプリケーションプログラム作成の概要について説明します。

＜この章の構成＞

4.1　サンプルを準備します

4.2　例題の作成に使用するフォルダを準備します

4.3　アプリケーションプログラム作成の準備をします

4.4　アプリケーションプログラムの作成方法を解説します

4.1　サンプルを準備します

XMAP3では，レイアウトやコーディングのサンプルをサポートサービスで提供しています。このマニュアルの例題で作成する画面・帳票や，アプリケーションプログラムのコーディングなどもサンプルで提供しています。

例題プログラムを作成する前に，サポートサービスのWebサイトからダウンロードしたサンプルを任意のフォルダに格納しておきましょう。

4.2　例題の作成に使用するフォルダを準備します

画面や帳票のマップ定義ファイルを格納したり，生成された論理マップや物理マップを格納したりするためのフォルダを用意します。開発環境に合わせて，フォルダの分類，作成位置や名称を決めましょう。

XMAP3をインストールしたフォルダの下には，¥USER¥MAPSというフォルダが用意されています。XMAP3をインストールした直後は，このフォルダがマップ定義ファイルの保存フォルダとして表示されます。フォルダの場所を次の図に示します。

図4-1　マップデータの格納をお勧めするフォルダの場所

注

XMAP3のマップデータを格納するフォルダは任意ですが，¥XMAP3¥TEMPフォルダはXMAP3で使用しています。¥XMAP3¥TEMPの下に，ユーザのフォルダを作成したり，ファイルを格納したりしないでください。

4.3　アプリケーションプログラム作成の準備をします

COBOL2002をWindowsマシンにインストールし，アプリケーションプログラムを作成するためのフォルダを準備しましょう。

＜この節の構成＞

4.3.1　COBOL2002をインストールします

4.3.2　アプリケーションプログラムを作成するためのフォルダを用意します

4.3.3　XMAP3の標準提供ファイルから，必要なファイルを複写しておきます

4.3.1　COBOL2002をインストールします

COBOL2002をインストールします。

COBOL2002のインストールについては，マニュアル「COBOL2002 ユーザーズガイド」を参照してください。

4.3.2　アプリケーションプログラムを作成するためのフォルダを用意します

ソースプログラムや登録集原文を格納したり，コンパイルで生成される作業ファイルを格納したりするフォルダを用意します。開発環境に合わせて，フォルダの分類，作成位置や名称を決めましょう。

例えば，COBOL2002をインストールしたフォルダ下に「UserProg」というフォルダを作成します。「UserProg」というフォルダを作成した場合のCOBOL2002のフォルダ構成を次の図に示します。

図4-2　COBOL2002のフォルダ構成

4.3.3　XMAP3の標準提供ファイルから，必要なファイルを複写しておきます

XMAP3では，アプリケーションプログラムの作成に必要な登録集原文を，XMAP3インストールフォルダ¥INCLUDEの下に標準提供しています。この登録集原文は，「4.3.2　アプリケーションプログラムを作成するためのフォルダを用意します」で作成したフォルダに複写して使用することをお勧めします。また，アプリケーションプログラム作成に使うAPパターンも複写しておきましょう。

標準提供されている登録集原文（COBOL用）を紹介します。

動的変更テーブル「X3MODTBL.cbl」

アプリケーションプログラムの実行中に画面の色などの表示属性を変更したり，出力エリア（出力論理マップ）の初期化に使用する定数が指定されています。

インタフェース領域「JSVWATBL.cbl」

CALL文で画面の送受信または帳票の送信をするときに使用します。このマニュアルで説明しているSEND文，RECEIVE文，またはTRANSCEIVE文を使う場合は必要ありません。

4.4　アプリケーションプログラムの作成方法を解説します

XMAP3では，画面入出力や帳票出力処理のコーディングのひな型を標準提供しています。これを，APパターンといいます。APパターンを利用することによって，効率良くコーディングできます。また，各プログラムの構造は，APパターンを基に標準化されるため，プログラムのわかりやすさを向上できます。ここでは，APパターンを利用したアプリケーションプログラムの作成方法を解説します。

なお，サポートサービスのWebサイトで提供されているAPサンプルのソースプログラムを流用し，アプリケーションプログラムを作成できます。

＜この節の構成＞

4.4.1　APパターン・AP部品とは

4.4.2　APパターンを利用したアプリケーションプログラムの作成手順

4.4.1　APパターン・AP部品とは

画面，帳票，書式に対応して複数のAPパターンとAP部品が用意されています。

APパターン

COBOLソースプログラムの見出し部，データ部，手続き部など，プログラム全体の標準的な骨組みが記述されています。

AP部品

APパターン共通に，頻繁に使うと考えられる処理の手続きが記述されています。

4.4.2　APパターンを利用したアプリケーションプログラムの作成手順

コーディングを始める前に，標準提供されているAPパターンの種類と，それぞれの処理内容について，ある程度理解しておくことをお勧めします。APパターンの種類については，「付録D.1　APパターン一覧」を参照してください。

プログラムパターンと部品パターンを編集したり，コーディングしたりする作業は通常，エディタ上で行います。APパターンの利用イメージを次の図に示し，アプリケーションプログラムの作成手順を説明します。

図4-3　APパターンの利用イメージ

＜この項の構成＞

(1)　アプリケーションプログラムの作成手順

(1)　アプリケーションプログラムの作成手順

画面や帳票のレイアウト定義と合わせて，プログラムの仕様を決定します。

APパターンを決定します。
プログラムの仕様を基に，コーディングに利用するAPパターンを選びます。APパターンを参考にしながら，処理の流れ，データ入出力の流れを詳細に検討します。

AP部品を挿入します。
処理内容に合わせて利用するAP部品を決めます。手順2.で検討した処理の流れに従ってAP部品を挿入し，コーディングのベースを作ります。

コーディングします。
プログラム名や，マップ名，ファイルなどを定義し，業務固有の手続きをコーディングしましょう。このとき，コンパイルで取り込む論理マップや動的変更テーブルをCOPY文に指定します。
コーディングを終えたソースプログラムは，コンパイルしたあと，実行してテスト・デバッグします。

5.　GUI画面を作成しましょう

例題プログラムでは，受注データを入力する画面をGUI画面とCUI画面の2とおりの画面形式で作成できます。この章では，GUI画面を作成する方法を説明します。

＜この章の構成＞

5.1　例題で作成するGUI画面を紹介します

5.2　GUI画面を作成しましょう

5.1　例題で作成するGUI画面を紹介します

例題で作成するGUI画面のイメージを次の図に示します。

図5-1　例題で作成するGUI画面

このGUI画面のレイアウト定義（マップ定義ファイル）は，サンプルとしてサポートサービスのWebサイトで提供されています。詳細については，「7.4　画面の作成で使用したサンプルプログラムを紹介します」を参照してください。

＜この節の構成＞

(1)　GUI画面の例題をレイアウト定義するときの注意点

(1)　GUI画面の例題をレイアウト定義するときの注意点

レイアウトに配置するオブジェクトのデータ名はアプリケーションプログラムとのやり取りに利用されるため，変更や削除をしないでください。基本的に，このマニュアルの手順に従って操作すれば，データ名が変更されることはありません。誤って変更してしまった場合には，生成された論理マップとコーディング内容を確認してからコンパイルする必要があります。コンパイルと実行については，「12.　コンパイルし，実行しましょう」を参照してください。

5.2　GUI画面を作成しましょう

図5-1のGUI画面の例題では，次に示す手順に従って作成します。

定義を開始します

タイトルと画面に関する情報を定義します

オブジェクトを配置します

得意先コードの欄を定義します

数量の欄を定義します

入金区分の欄を定義します

商品名の欄を定義します

割引特典の欄を定義します

グループボックスを定義します

プッシュボタンを定義します

完成したGUI画面を確認します

定義を終了します

＜この節の構成＞

(1)　定義を開始します

(2)　タイトルと画面に関する情報を定義します

(3)　オブジェクトを配置します

(4)　完成したGUI画面を確認します

(5)　定義を終了します

(6)　作成されるファイル

(7)　オブジェクトのデータ名に関する注意事項

(1)　定義を開始します

Windowsの［スタート］にあるプログラム一覧から［XMAP3］－［XMAP3 Developer］－［ドロー］を選びます。
［新規・更新選択］ダイアログが表示されます。

「画面・帳票・書式を新規作成する」を選びます。

［OK］ボタンを選びます。
［新規作成］ダイアログが表示されます。

「マップ名」に「JYU1GC」と入力します。

「定義対象の選択」から「GUI画面（一次）」を選び，「パターンの選択」から「中汎用ウィンドウ」を選びます。「言語種別」が「COBOL」になっていることを確認します。

［OK］ボタンを選びます。
GUI画面定義ウィンドウが表示されます。

(2)　タイトルと画面に関する情報を定義します

ツールバーから[図データ]（［画面属性］アイコン）を選びます。
［画面属性］ダイアログが表示されます。

［画面属性］ダイアログで次のように設定します。

画面の縦方向のますに「36」，横方向のますに「48」を入力します。

「ウィンドウ」の背景色から「白」を選びます。

「タイトル」に「受注データ入力」と入力します。

［メニューバー定義］ボタンを選びます。
［メニューバー定義］ダイアログが表示されます。

［メニューバー定義］ダイアログで次のように設定します。

「プルダウンメニュー」・・・「終了」

「通知コード」・・・「PF03」

［OK］ボタンを選んで，［メニューバー定義］ダイアログを閉じます。
［画面属性］ダイアログが表示されます。

［OK］ボタンを選びます。
GUI画面定義ウィンドウが表示されます。

(3)　オブジェクトを配置します

オブジェクトを配置する手順について説明します。

説明文中にある「△」は，半角1文字分の空白を示します。

(a)　得意先コードの欄を定義します

ツールボックスから[図データ]（固定テキスト（日本語））を選びます。

レイアウト領域の「縦 5」「横 6」にポインタを位置づけてクリックします。

「得意先コード」と入力したあとで，［Enter］キーを押します。
「得意先コード」が配置されます。

ツールボックスの[図データ]（入出力テキスト（文字用））を数回クリックして，[図データ]（入出力テキスト（英数））を選びます。

レイアウト領域の「縦 5」「横 22」に，ポインタを位置づけてクリックします。
自動的に横8ます分の入出力テキストが配置されます。

(b)　数量の欄を定義します

ツールボックスから[図データ]（固定テキスト（日本語））を選びます。

レイアウト領域の「縦 28」「横 6」にポインタを位置づけてクリックします。

「数量」と入力したあとで，［Enter］キーを押します。
同様に，[図データ]（固定テキスト（日本語））を選び，レイアウト領域の「縦 28」「横 29」の位置に定義して，「台」と入力します。
オブジェクトが次のように配置されます。

ツールボックスの[図データ]（入出力テキスト（数字））を数回クリックして[図データ]（入出力テキスト（数値））を選びます。

レイアウト領域の「縦 28」「横 19」にポインタを位置づけてクリックします。
自動的に横4ます分の入出力テキストが配置されます。

定義した入出力テキストをダブルクリックします。
［入出力テキストボックス］ダイアログが表示されます。

「空白入力」から「禁止」を選びます。

［OK］ボタンを選びます。
GUI画面定義ウィンドウが表示されます。

(c)　入金区分の欄を定義します

ツールボックスから[図データ]（固定テキスト（日本語））を選びます。次に，レイアウト領域の「縦 9」「横 6」にポインタを位置づけクリックします。

「入△金△区△分」と入力したあとで，［Enter］キーを押します。

ツールボックスから[図データ]（固定ラジオボタン（新規））を選びます。

レイアウト領域の「縦 9」「横 19」にポインタを位置づけ，「縦 10」「横 14」サイズ分ドラッグします。

いちばん上のラジオボタンのラベルをクリックしたあとで，「現△△△△金」と入力します。

［Enter］キーを押します。

同様に，ほかの二つのボタンに「手△△△△形」，「銀行振込」と入力します。

いちばん上のラジオボタンの領域をダブルクリックします。
［固定ラジオボタン］ダイアログが表示されます。

「動的変更（APから表示属性を変更する）」のチェックボタンをオンにしたあとで，［OK］ボタンを選びます。

残り二つのボタンについても，［固定ラジオボタン］ダイアログを表示させて，「動的変更（APから表示属性を変更する）」を設定します。

(d)　商品名の欄を定義します

ツールボックスから[図データ]（固定テキスト（日本語））を選びます。

レイアウト領域の「縦 19」「横 6」にポインタを位置づけクリックします。

「商△品△名」と入力したあとで，［Enter］キーを押します。

ツールボックスから[図データ]（リストボックス（単一選択））を選びます。

レイアウト領域の「縦 21」「横 6」にポインタを位置づけ，「縦6」「横26」サイズ分ドラッグします。

定義したリストボックスをダブルクリックします。
［単一選択リストボックス］ダイアログが表示されます。

プレーンの行に「6」と入力します。

［OK］ボタンを選びます。
GUI画面定義ウィンドウが表示されます。

(e)　割引特典の欄を定義します

ツールボックスから[図データ]（固定テキスト（日本語））を選びます。

レイアウト領域の「縦 31」「横 6」にポインタを位置づけクリックします。

「割引特典」と入力したあとで，［Enter］キーを押します。

ツールボックスから[図データ]（固定チェックボタン（単独／追加））を選びます。

レイアウト領域の「縦 31」「横 18」にポインタを位置づけクリックします。

配置されたチェックボタンをダブルクリックします。
［固定チェックボタン］ダイアログが表示されます。

「ラベル」に「割引あり」と入力します。

［OK］ボタンを選びます。

(f)　グループボックスを定義します

ツールボックスから[図データ]（グループボックス（枠あり））を選びます。

レイアウト領域の「縦 3」「横 3」にポインタを位置づけ，「縦 32」「横 31」サイズ分ドラッグします。

(g)　プッシュボタンを定義します

ツールボックスから[図データ]（プッシュボタン（複数））を選びます。

レイアウト領域の「縦 4」「横 36」にポインタを位置づけ，「縦 7」「横 11」サイズ分ドラッグします。

上のプッシュボタンをダブルクリックします。
［プッシュボタン］ダイアログが表示されます。

「テキスト」に表示されている「OK」を削除して，「次入力」と入力します。また，「通知コード」に「PF02」を設定します。

［OK］ボタンを選びます。
同様に，［キャンセル］のプッシュボタンをダブルクリックします。表示された［プッシュボタン］ダイアログで，「テキスト」の「キャンセル」を削除したあとで，「終△△了」と入力します。また，「通知コード」に「PF03」を設定します。

(4)　完成したGUI画面を確認します

ツールバーから[図データ]（テスト表示）を選びます。
実際に画面上で表示されるレイアウトを確認します。気になる部分があれば，「2.2.5　レイアウト定義の基本操作を紹介します」を参照して修正してください。

注

テスト表示・印刷をするためには，XMAP3 Server RuntimeまたはXMAP3 Client Runtimeをインストールする必要があります。

テスト表示されたGUI画面から［終了］のプッシュボタンを選びます。
任意のファンクションキー，または［Enter］キーを押してテスト表示を終了することもできます。

ツールバーから[図データ]（論理マップ表示）を選び，論理マップを確認します。

［閉じる］ボタンを選びます。
GUI画面定義ウィンドウが表示されます。

(5)　定義を終了します

ツールバーから[図データ]（ドローの終了）を選びます。またはメニューバーの［ファイル］－［ドローの終了］を選びます。

レイアウト定義の保存を問い合わせるダイアログから［はい］ボタンを選びます。
［名前を付けて保存］ダイアログが表示されます。

ファイル名を確認して［保存］ボタンを選びます。
自動的に論理マップと物理マップが生成されます。

(6)　作成されるファイル

レイアウト定義を保存してドローを終了すると，レイアウト定義を保存したフォルダに次のファイルが作成されます。なお，ファイル名は，指定したマップ名によって異なります。ここでは，例題どおりマップ名を「JYU1GC」と指定した場合のファイル名を示します。

JYU1GC.imp（マップ定義ファイル）

JYU1GC.lsx（生成結果リストファイル）

JYU1GCND.pmp（物理マップ）

JYU1GCI.cbl（入力論理マップ）
例題で作成したGUI画面の入力論理マップの内容を次に示します。

01  JYU1GCI.
  02  JYU1GCS                 PIC  S9(4)   COMP-5  
                                            VALUE  +30.[図データ]
  02  JYU1GC0                 PIC  S9(4)   COMP    
                                            VALUE  +0.
  02  JYU1GCK.
    03  JYU1GC-INCI        PIC  X(4).[図データ]
    03  JYU1GC-INCURS-LOCI PIC  X(2).[図データ]
    03  JYU1GC-FIELD0001-H.  
      04  JYU1GC-FIELD0001-I
                            PIC  X(8).[図データ]
    03  JYU1GC-FIELD0003-H.                  
      04  JYU1GC-FIELD0003-I  
                            PIC  X(2).[図データ]
    03  JYU1GC-FIELD0007-H.
      04  JYU1GC-FIELD0007-I  
                            PIC  X(4).[図データ]
    03  JYU1GC-FIELD0002-H.
      04  JYU1GC-FIELD0002-I
                            PIC  9999.[図データ]
    03  JYU1GC-FIELD0008-H.
      04  JYU1GC-FIELD0008-I
                            PIC  X(2).[図データ]

コーディングの説明を次に示します。次の番号は，コーディング例中の丸付き数字の番号と対応しています。
1：論理マップ長
2：イベント通知コード
3：カーソル位置
4：得意先コード
5：入金区分
6：商品コード
7：数量
8：割引特典

JYU1GCO.cbl（出力論理マップ）
例題で作成したGUI画面の出力論理マップの内容を次に示します。

01  JYU1GCO.
   02  JYU1GCL     PIC  S9(4)   COMP-5
                                 VALUE  +194.[図データ]
   02  JYU1GCZ     PIC  S9(4)  COMP
                                 VALUE  +0.  
   02  JYU1GCG.
     03  JYU1GC-CNTRLO          PIC  X(2).    
     03  JYU1GC-OUTCURS-LOCO    PIC  X(2).[図データ]
     03  JYU1GC-FIELD0001-O     PIC  X(8).[図データ]
     03  JYU1GC-RADIO0004-A     PIC  X(2).  
     03  JYU1GC-RADIO0005-A     PIC  X(2).[図データ]
     03  JYU1GC-RADIO0006-A     PIC  X(2).  
     03  JYU1GC-LIST0007-O                      OCCURS  6.
       04  JYU1GC-LIST-CODE0007-O  
                                PIC  X(4).[図データ]
       04  JYU1GC-LIST-LABEL0007-O
                                PIC  X(24).[図データ]
     03  JYU1GC-FIELD0002-O     PIC  9999.[図データ]
*
 01  JYU1GCT     PIC  S9(4)  COMP-5
                             VALUE  +194.
 01  JYU1GCD.[図データ]
   02  JYU1GC-FIELD0001-T.                     [図データ]
     03  FILLER     PIC  X(2)  VALUE  X'000A'.
   02  JYU1GC-FIELD0003-T.                     [図データ]
     03  FILLER     PIC  X(2)  VALUE  X'0012'.
   02  JYU1GC-FIELD0007-T.                     [図データ]
     03  FILLER     PIC  X(2)  VALUE  X'0014'.
   02  JYU1GC-FIELD0002-T.                     [図データ]
     03  FILLER     PIC  X(2)  VALUE  X'0018'.
   02  JYU1GC-FIELD0008-T.                     [図データ]
     03  FILLER     PIC  X(2)  VALUE  X'001C'.
   02  JYU1GC-INCT.                            [図データ]
     03  FILLER     PIC  X(2)  VALUE  X'0004'.
   02  JYU1GC-PBOX0009-T.                                                
     03  FILLER     PIC  X(2)  VALUE  X'8006'.  

コーディングの説明を次に示します。説明の番号は，コーディング例中の丸付き数字の番号と対応しています。
1：論理マップ長
2：論理カーソル指定
3：得意先コード
4：ラジオボタン選択状態設定エリア
5：商品コード
6：商品名
7：数量
8：カーソル定数
9：得意先コードへの位置づけ
10：入金区分への位置づけ
11：商品名への位置づけ
12：数量への位置づけ
13：割引特典への位置づけ
14：プッシュボタンへの位置づけ

(7)　オブジェクトのデータ名に関する注意事項

定義した画面の各項目に対応するデータ名（COBOLプログラムで参照・更新するデータ領域の名称）は，XMAP3が適当な名称を仮定します。通常の開発手順では，仮定されたデータ名を参照しながらコーディングを行います。

ただし，サポートサービスで提供するCOBOLプログラムのコーディングサンプルをそのまま使う場合には，各項目のデータ名は，コーディングサンプルで参照・更新している領域名に合わせておく必要があります。

サポートサービスで提供するCOBOLプログラムをそのまま使用する場合には，ドローのレイアウト定義画面から，メニューバーの［属性］－［データ名］を選んで「データ名編集」画面を表示し，データ名を修正してください。

サンプルで設定しているデータ名を次の画面に示します。データ名が異なる場合は，次の画面の「データ名」に合わせて修正してください。なお，データ名とオブジェクト名の対応については，「5.2(6)　作成されるファイル」を参照してください。

6.　CUI画面を作成しましょう

例題プログラムでは，受注データを入力する画面をGUI画面とCUI画面の2とおりの画面形式で作成できます。この章では，CUI画面を作成する方法を説明します。

＜この章の構成＞

6.1　例題で作成するCUI画面を紹介します

6.2　CUI画面を作成しましょう

6.1　例題で作成するCUI画面を紹介します

例題で作成するCUI画面のイメージを次の図に示します。

図6-1　例題で作成するCUI画面

このCUI画面のレイアウト定義（マップ定義ファイル）はサンプルとしてサポートサービスのWebサイトで提供されています。詳細については，「7.4　画面の作成で使用したサンプルプログラムを紹介します」を参照してください。

6.2　CUI画面を作成しましょう

図6-1の例題では，次に示す作成手順に従ってCUI画面を作成します。

定義を開始します

タイトルを定義します

オブジェクトを配置します

得意先コードの欄を定義します

入金区分の欄を定義します

ファンクションキーのガイダンスを定義します

完成したCUI画面を確認します

文字色を変更します

定義を終了します

＜この節の構成＞

(1)　定義を開始します

(2)　タイトルを定義します

(3)　オブジェクトを配置します

(4)　完成したCUI画面を確認します

(5)　文字色を変更します

(6)　定義を終了します

(7)　作成されるファイル

(8)　オブジェクトのデータ名に関する注意事項

(1)　定義を開始します

Windowsの［スタート］にあるプログラム一覧から［XMAP3］－［XMAP3 Developer］－［ドロー］を選びます。
［新規・更新選択］ダイアログが表示されます。

「画面・帳票・書式を新規作成する」を選びます。

［OK］ボタンを選びます。
［新規作成］ダイアログが表示されます。

「マップ名」に「JYU1CC」と入力します。

「定義対象の選択」から「CUI画面」を選び，「パターンの選択」から「フリー」を選びます。「言語種別」が「COBOL」になっていることを確認します。

［OK］ボタンを選びます。
［画面属性］ダイアログが表示されます。

［OK］ボタンを選びます。
CUI画面定義ウィンドウが表示されます。

(2)　タイトルを定義します

ツールボックスから[図データ]（固定フィールド（日本語））を選びます。

レイアウト領域の「3行」「27列」にポインタを位置づけクリックします。

「受注データ入力」と入力したあとで，［Enter］キーを押します。

［受注データ入力］をダブルクリックします。
［固定フィールド］ダイアログが表示されます。

「文字の拡大」から「倍角」を選びます。

［OK］ボタンを選びます。

(3)　オブジェクトを配置します

CUI画面のオブジェクトを配置する手順について説明します。

説明文中の「△」は，半角1文字分の空白を示します。

(a)　得意先コードの欄を定義します

ツールボックスから[図データ]（固定フィールド（日本語））を選びます。

レイアウト領域の「7行」「11列」にポインタを位置づけてクリックします。

「得意先コード△:△( 」と入力したあとで，［Enter］キーを押します。
「:」と「( 」は半角文字で入力します。

ツールボックスの[図データ]（入出力フィールド（日本語））を数回クリックして[図データ]（入出力フィールド（英数））を選びます。

レイアウト領域の「7行」「28列」にポインタを位置づけてクリックします。
8列分の入出力フィールドが配置されます。

ツールボックスから[図データ]（固定フィールド（日本語））を選びます。

レイアウト領域の「7行」「37列」にポインタを位置づけクリックします。

「 )」と入力して［Enter］キーを押します。
「 )」は半角文字で入力します。同様に，「商品コード」，「数量」の欄を定義します。

注※1

入出力フィールド（英数）は，クリックすると8列分の領域が配置されます。領域を8列より多く，または少なく取りたい場合は，必要な分だけドラッグしてください。ここでは，5列分をドラッグします。

注※2

入出力フィールド（数字）は，クリックすると4列分の領域が配置されます。領域を4列より多く，または少なく取りたい場合は，必要な分だけドラッグしてください。ここでは，4列分の領域を配置します。

(b)　入金区分の欄を定義します

ツールボックスから[図データ]（固定フィールド（日本語））を選びます。

レイアウト領域の「10行」「11列」にポインタを位置づけてクリックします。

「入△金△区△分△△:△( 」と入力したあとで，［Enter］キーを押します。

ツールボックスから[図データ]（入出力フィールド（英数））を選びます。

レイアウト領域の「10行」「28列」にポインタを位置づけ，1列分ドラッグします。

ツールボックスから[図データ]（固定フィールド（日本語））を選びます。

レイアウト領域の「10行」「30列」にポインタを位置づけてクリックします。

「 )△△△( △1＝現金△2＝手形△3＝銀行振込△) 」と入力したあとで，［Enter］キーを押します。

同様に，「割引特典」の欄を定義します。

(c)　ファンクションキーのガイダンスを定義します

ツールボックスから[図データ]（固定フィールド（日本語））を選びます。

レイアウト領域の「23行」「11列」にポインタを位置づけてクリックします。

「F2△△：△△次入力△△△△△△△△△△F3△△：△△終了」と入力し，［Enter］キーを押します。

(4)　完成したCUI画面を確認します

ツールバーから[図データ]（テスト表示）を選びます。
実際に画面上で表示されるレイアウトを確認します。気になる部分があれば，「2.2.5　レイアウト定義の基本操作を紹介します」を参照して修正してください。

注

テスト表示・印刷をするためには，XMAP3 Server RuntimeまたはXMAP3 Client Runtimeをインストールする必要があります。

［F3］キーを押します。
任意のファンクションキー，または［Enter］キーを押して，テスト表示を終了することもできます。

ツールバーから[図データ]（論理マップ表示）を選び，論理マップを確認します。

［閉じる］ボタンを選びます。
CUI画面定義ウィンドウが表示されます。

(5)　文字色を変更します

ツールバーから[図データ]（文字色）を選び，タイトルの「受注データ入力」をクリックします。

ツールボックスから[図データ]（文字色（空色））ボタンを選びます。
タイトル「受注データ入力」の表示色が空色に変わります。

ツールバーから[図データ]（レイアウトへ戻る）を選びます。
CUI画面定義ウィンドウに戻ります。再度テスト表示して全体のバランスを確認しましょう。

(6)　定義を終了します

ツールバーから[図データ]（ドローの終了）を選びます。またはメニューバーの［ファイル］－［ドローの終了］を選びます。

レイアウト定義の保存を問い合わせるダイアログから［はい］ボタンを選びます。
［名前を付けて保存］ダイアログが表示されます。

ファイル名を確認して［保存］ボタンを選びます。
自動的に論理マップと物理マップが生成されます。

(7)　作成されるファイル

レイアウト定義を保存してドローを終了すると，レイアウト定義を保存したフォルダに次のファイルが作成されます。なお，ファイル名は，指定したマップ名によって異なります。ここでは，例題どおりマップ名を「JYU1CC」と指定した場合のファイル名を示します。

JYU1CC.imp（マップ定義ファイル）

JYU1CC.lsx（生成結果リストファイル）

JYU1CCNC.pmp（物理マップ）

JYU1CCI.cbl（入力論理マップ）
例題で作成したCUI画面の入力論理マップの内容を次に示します。

01  JYU1CCI.
  02  JYU1CCS     PIC  S9(4)  COMP-5 VALUE  +29.[図データ]
  02  JYU1CC0     PIC  S9(4)  COMP   VALUE  +0.
  02  JYU1CCK.
    03  JYU1CC-INCI           PIC  X(4).[図データ]
    03  JYU1CC-INCURS-LOCI    PIC  X(2).[図データ]
    03  JYU1CC-FIELD0001-H.
      04  JYU1CC-FIELD0001-I  PIC  X(8).[図データ]
    03  JYU1CC-FIELD0004-H.
      04  JYU1CC-FIELD0004-I  PIC  X(1).[図データ]
    03  JYU1CC-FIELD0002-H.
      04  JYU1CC-FIELD0002-I  PIC  X(5).[図データ]
    03  JYU1CC-FIELD0003-H.              
      04  JYU1CC-FIELD0003-I  PIC  9999.[図データ]
    03  JYU1CC-FIELD0005-H.
      04  JYU1CC-FIELD0005-I  PIC  X(1).[図データ]

コーディングの説明を次に示します。次の番号は，コーディング例中の丸付き数字の番号と対応しています。
1：論理マップ長
2：イベント通知コード
3：カーソル位置
4：得意先コード
5：入金区分
6：商品コード
7：数量
8：割引特典

JYU1CCO.cbl（出力論理マップ）
例題で作成したCUI画面の出力論理マップの内容を次に示します。

01  JYU1CCO.
   02  JYU1CCL     PIC  S9(4)    COMP-5  VALUE  +27.[図データ]
   02  JYU1CCZ     PIC  S9(4)    COMP     VALUE  +0.
   02  JYU1CCG.
     03  JYU1CC-CNTRLO            PIC  X(2).
     03  JYU1CC-OUTCURS-LOCO      PIC  X(2).[図データ]
     03  JYU1CC-FIELD0001-O       PIC  X(8).[図データ]
     03  JYU1CC-FIELD0004-O       PIC  X(1).[図データ]
     03  JYU1CC-FIELD0002-O       PIC  X(5).[図データ]
     03  JYU1CC-FIELD0003-O       PIC  9999.[図データ]
     03  JYU1CC-FIELD0005-O       PIC  X(1).[図データ]
*
 01  JYU1CCT      PIC  S9(4)  COMP-5  VALUE  +27.
 01  JYU1CCD.     [図データ]
   02  JYU1CC-FIELD0001-T.                     [図データ]
     03  FILLER      PIC  X(2)  VALUE X'000A'.
   02  JYU1CC-FIELD0004-T.                     [図データ]
     03  FILLER      PIC  X(2)  VALUE X'0012'.
   02  JYU1CC-FIELD0002-T.                     [図データ]
     03  FILLER      PIC  X(2)  VALUE X'0013'.
   02  JYU1CC-FIELD0003-T.                     [図データ]
     03  FILLER      PIC  X(2)  VALUE X'0018'.
   02  JYU1CC-FIELD0005-T.                     [図データ]
     03  FILLER      PIC  X(2)  VALUE X'001C'.

コーディングの説明を次に示します。説明の番号は，コーディング例中の丸付き数字の番号と対応しています。
1：論理マップ長
2：論理カーソル指定
3：得意先コード
4：入金区分
5：商品コード
6：数量
7：割引特典
8：カーソル定数
9：得意先コードへの位置付け
10：入金区分への位置付け
11：商品コードへの位置付け
12：数量への位置付け
13：割引特典への位置付け

(8)　オブジェクトのデータ名に関する注意事項

定義した画面の各項目に対応するデータ名（COBOLプログラムで参照・更新するデータ領域の名称）は，XMAP3が適当な名称を仮定します。通常の開発手順では，仮定されたデータ名を参照しながらコーディングを行います。

ただし，サポートサービスで提供するCOBOLプログラムのコーディングサンプルをそのまま使う場合には，各項目のデータ名は，コーディングサンプルで参照・更新している領域名に合わせておく必要があります。

サポートサービスで提供するCOBOLプログラムをそのまま使用する場合には，ドローのレイアウト定義画面から，メニューバーの［属性］－［データ名］を選んで「データ名編集」画面を表示し，データ名を修正してください。

サンプルで設定しているデータ名を次の画面に示します。データ名が異なる場合は，次の画面の「データ名」に合わせて修正してください。なお，データ名とオブジェクト名の対応については，「6.2(7)　作成されるファイル」を参照してください。

7.　画面を使ったアプリケーションプログラムを作成しましょう

XMAP3でアプリケーションプログラムを作成するときには，SEND文，RECEIVE文やTRANSCEIVE文を利用して画面の入出力を指定します。この章では，受注データ入力プログラムのポイントと，その作成方法を説明します。

＜この章の構成＞

7.1　コーディングを理解します

7.2　コーディングします

7.3　アプリケーションプログラムをコンパイルします

7.4　画面の作成で使用したサンプルプログラムを紹介します

7.1　コーディングを理解します

＜この節の構成＞

7.1.1　処理の流れ

7.1.2　コーディングのポイント

7.1.1　処理の流れ

GUI画面の例題で作成した「受注データ入力プログラム」のフローチャートを次の図に示します。

図7-1　「受注データ入力プログラム」（GUI画面用）の処理の流れ

7.1.2　コーディングのポイント

画面を使ったアプリケーションプログラムのコーディングのポイントを説明します。

＜この項の構成＞

(1)　コーディングに使用する論理マップ

(2)　アプリケーションプログラムのコーディング

(1)　コーディングに使用する論理マップ

コーディングでは，GUI画面の例題で作成した「受注データ入力プログラム」の入力論理マップと出力論理マップを使用します。

入力論理マップ
入力論理マップを次に示します。

01  JYU1GCI.
  02  JYU1GCS                 PIC  S9(4)   COMP-5  
                                            VALUE  +30.[図データ]
  02  JYU1GC0                 PIC  S9(4)   COMP    
                                            VALUE  +0.
  02  JYU1GCK.
    03  JYU1GC-INCI        PIC  X(4).[図データ]
    03  JYU1GC-INCURS-LOCI PIC  X(2).[図データ]
    03  JYU1GC-FIELD0001-H.  
      04  JYU1GC-FIELD0001-I
                            PIC  X(8).[図データ]
    03  JYU1GC-FIELD0003-H.                  
      04  JYU1GC-FIELD0003-I  
                            PIC  X(2).[図データ]
    03  JYU1GC-FIELD0007-H.
      04  JYU1GC-FIELD0007-I  
                            PIC  X(4).[図データ]
    03  JYU1GC-FIELD0002-H.
      04  JYU1GC-FIELD0002-I
                            PIC  9999.[図データ]
    03  JYU1GC-FIELD0008-H.
      04  JYU1GC-FIELD0008-I
                            PIC  X(2).[図データ]

コーディングの説明を次に示します。説明の番号は，コーディング例中の丸付き数字の番号と対応しています。
1：論理マップ長
2：イベント通知コード
3：カーソル位置
4：得意先コード
5：入金区分
6：商品コード
7：数量
8：割引特典

出力論理マップ
出力論理マップを次に示します。

01  JYU1GCO.
   02  JYU1GCL     PIC  S9(4)   COMP-5
                                 VALUE  +194.[図データ]
   02  JYU1GCZ     PIC  S9(4)  COMP
                                 VALUE  +0.  
   02  JYU1GCG.
     03  JYU1GC-CNTRLO          PIC  X(2).    
     03  JYU1GC-OUTCURS-LOCO    PIC  X(2).[図データ]
     03  JYU1GC-FIELD0001-O     PIC  X(8).[図データ]
     03  JYU1GC-RADIO0004-A     PIC  X(2).  
     03  JYU1GC-RADIO0005-A     PIC  X(2).[図データ]
     03  JYU1GC-RADIO0006-A     PIC  X(2).  
     03  JYU1GC-LIST0007-O                      OCCURS  6.
       04  JYU1GC-LIST-CODE0007-O  
                                PIC  X(4).[図データ]
       04  JYU1GC-LIST-LABEL0007-O
                                PIC  X(24).[図データ]
     03  JYU1GC-FIELD0002-O     PIC  9999.[図データ]
*
 01  JYU1GCT     PIC  S9(4)  COMP-5
                             VALUE  +194.
 01  JYU1GCD.[図データ]
   02  JYU1GC-FIELD0001-T.                     [図データ]
     03  FILLER     PIC  X(2)  VALUE  X'000A'.
   02  JYU1GC-FIELD0003-T.                     [図データ]
     03  FILLER     PIC  X(2)  VALUE  X'0012'.
   02  JYU1GC-FIELD0007-T.                     [図データ]
     03  FILLER     PIC  X(2)  VALUE  X'0014'.
   02  JYU1GC-FIELD0002-T.                     [図データ]
     03  FILLER     PIC  X(2)  VALUE  X'0018'.
   02  JYU1GC-FIELD0008-T.                     [図データ]
     03  FILLER     PIC  X(2)  VALUE  X'001C'.
   02  JYU1GC-INCT.                            [図データ]
     03  FILLER     PIC  X(2)  VALUE  X'0004'.
   02  JYU1GC-PBOX0009-T.                                                
     03  FILLER     PIC  X(2)  VALUE  X'8006'.  

コーディングの説明を次に示します。説明の番号は，コーディング例中の丸付き数字の番号と対応しています。
1：論理マップ長
2：論理カーソル指定
3：得意先コード
4：ラジオボタン選択状態設定エリア
5：商品コード
6：商品名
7：数量
8：カーソル定数
9：得意先コードへの位置づけ
10：入金区分への位置づけ
11：商品名への位置づけ
12：数量への位置づけ
13：割引特典への位置づけ
14：プッシュボタンへの位置づけ

(2)　アプリケーションプログラムのコーディング

「受注データ入力プログラム」のコーディングから重要な部分を抜粋したものを図7-2から図7-3に示し，ポイントを説明します。

図7-2　ポイントとなる部分のコーディング（画面）（1/2）

図7-3　ポイントとなる部分のコーディング（画面）（2/2）

ポイント1　論理マップ中に出力したいデータを指定します

GUI画面のリストボックスのラベルを指定しておきます。ここで指定しないと，リストボックスの中が空白になります。

ポイント2　COPY文で論理マップを取り込みます

XMAP3では，COPY文を使用して，アプリケーションプログラムへ論理マップを取り込みます。論理マップには，入力論理マップと出力論理マップがあり，それぞれ名称が異なります。名称の最後に「I」が付く場合は入力論理マップ名，「O」が付く場合は出力論理マップ名になります。

ここでは，出力論理マップ名「JYU1GCO」と入力論理マップ名「JYU1GCI」を指定します。

ポイント3　通信記述項に画面の入出力に必要な情報を指定します

TRANSCEIVE文で使用する通信記述名を格納する領域を指定します。ここでは，「DSP」と指定します。

TRANSCEIVE文で入出力する物理マップ名を格納する領域を指定します。ここでは，「画面マップ名」と指定します。「画面マップ名」には，手続き部でMOVE文を使って，物理マップ名「JYU1GCND」を設定します（物理マップ名は「マップ名+ND」となります）。

仮想端末名を格納する領域を指定します。ここでは，「画面端末名」と指定します。

画面の入出力が正しく実行されたかどうかを判定する領域の名称を指定します。TRANSCEIVE文実行後，この領域にリターンコード「00000」が返されれば，画面の入出力が正しく行われたことになります。ここでは，「画面-RC」と指定します。

ポイント4　TRANSCEIVE文で画面の入出力を指定します

TRANSCEIVE文でディスプレイ端末への画面の入出力をまとめて指定します。画面表示をSEND文で，画面入力をRECEIVE文で指定することもできます。TRANSCEIVE文は，このSEND文とRECEIVE文の両方の機能を合わせ持っています。通常の画面の送受信にはTRANSCEIVE文を使うことをお勧めします。

TRANSCEIVE文では，通信記述項で指定した通信記述名，出力論理マップ名，および入力論理マップ名を指定します。ここでは，順に「DSP」，「JYU1GCO」，「JYU1GCI」と指定します。

アプリケーションプログラムの作成について詳しく知りたい方は，マニュアル「XMAP3 プログラミングガイド」を参照してください。

7.2　コーディングします

「受注データ入力プログラム」のように，一つの画面に対して入出力処理をするプログラムのコーディングには，APパターン「GENDSP01.cbl」を利用します。このパターンには，画面入出力処理に必要な，ディスプレイに対する通信記述項の指定や標準的な手続きの骨組みが記述されています。このAPパターンを基にして，使用するマップ名や，業務固有の手続きをコーディングしていきましょう。

APパターンを利用したコーディングについては，「4.4.2　APパターンを利用したアプリケーションプログラムの作成手順」もあわせて参照してください。

完成したコーディングは，サンプル（COBOLソースプログラム）としてサポートサービスで提供されています。コーディングの際には，ソースリストを印刷したり，エディタで開いたりして参考にすることをお勧めします。詳細については，「7.4　画面の作成で使用したサンプルプログラムを紹介します」を参照してください。

＜この節の構成＞

(1)　APパターンを利用してコーディングしましょう

(2)　サンプルを利用してコーディングするときの注意事項

(1)　APパターンを利用してコーディングしましょう

使用しているエディタのウィンドウを開きます。

APパターン「GENDSP01.cbl」を開きます※。
APパターンは，次のフォルダに格納されています。
　　XMAP3インストールフォルダ¥PATTERNS¥COBOL

コーディングします。
固有のプログラム名，マップ名，データ定義や手続きなどを記述してソースプログラムを作成します。手続きのコーディングには，共通処理として用意されているAP部品を，処理内容に合わせて挿入します。受注データ入力プログラムでは，次のAP部品を利用します。
　　SETCRS01…フォーカス位置の設定

コーディングが終了したら，エディタのウィンドウを閉じて保存します。

注※

COBOLエディタを使用している場合は，次の説明を参照してください。

COBOLエディタでプログラムテンプレートを利用するには

COBOLエディタでのプログラムテンプレートの利用手順を説明します。

COBOLエディタウィンドウのメニューバーの［ファイル］－［新規作成］を選びます。
［新規作成］ダイアログが表示されます。

作成したいファイルの種類を選びます。

［...］ボタンを選び，表示されるダイアログからテンプレートファイルを選びます。
テンプレートファイルは次の場所に格納されています。
XMAP3インストールフォルダ¥PATTERNS¥COBOL

プログラムテンプレートのチェックボタンをオンにします。

［OK］ボタンを選びます。
新規にファイルが作成され，テンプレートの内容が表示されます。
APパターンを挿入するには，挿入したい行にテキストカーソルを位置づけ，メニューバーの［編集］－［ファイルの挿入］を選びます。ダイアログに表示されたファイルの一覧から，目的のAP部品を選択してください。

(2)　サンプルを利用してコーディングするときの注意事項

「5.　GUI画面を作成しましょう」および「6.　CUI画面を作成しましょう」で作成した画面は，APパターンを使わないで，サポートサービスで提供しているCOBOLプログラムをそのまま使ってコンパイル・実行できます。このとき，作成した画面の各オブジェクトのデータ名とコーディングサンプル中のデータ名を合わせておく必要があります。

データ名を合わせるには，次に示す方法があります。

コーディングサンプルを作成した画面のデータ名に合わせて修正する。

ドローのレイアウト定義の［データ名編集］ダイアログで，コーディングサンプルで使用しているデータ名に変更する。

ドローのレイアウト定義での変更については，「5.2(7)　オブジェクトのデータ名に関する注意事項」を参照してください。

7.3　アプリケーションプログラムをコンパイルします

作成した例題（GUI画面またはCUI画面）のマップファイルとアプリケーションプログラムを，COBOL2002のコンパイラを用いてコンパイル，およびリンケージします。コンパイルしたアプリケーションプログラムは，実行して問題なく動作するかを確認します。

COBOL2002を使用したアプリケーションプログラムのコンパイル，およびアプリケーションプログラムの実行については，「12.　コンパイルし，実行しましょう」を参照してください。

また，コンパイルに使用するマップファイルやアプリケーションプログラムのサンプルについては，「7.4　画面の作成で使用したサンプルプログラムを紹介します」に記載してありますので，コンパイル時の参考に使用してください。

7.4　画面の作成で使用したサンプルプログラムを紹介します

GUI画面の例題またはCUI画面の例題で作成されたファイルの一覧を示します。

＜この節の構成＞

(1)　使用するファイル一覧

(2)　例題で使用するファイルが提供されているフォルダ

(3)　提供されているアプリケーションプログラムサンプル（APサンプル）

(4)　C言語の場合に必要となるファイル

(1)　使用するファイル一覧

GUI画面の例題プログラムおよびCUI画面の例題プログラムを作成するために必要なファイルを次に示します。

(a)　GUI画面の例題

GUI画面の例題で使用するファイルを次の表に示します。

表7-1　例題プログラムに使用するファイル（GUI画面）

項番 | ファイル名 | 用途 | 作成方法
1 | JYU1GC.imp※ | マップ定義ファイル | ドローでユーザが作成する
2 | JYU1GCI.cbl | 入力論理マップ | 定義情報ファイル作成後，保存すると自動生成される
3 | JYU1GCO.cbl | 出力論理マップ | 定義情報ファイル作成後，保存すると自動生成される
4 | JYU1GCND.pmp | 物理マップ | 定義情報ファイル作成後，保存すると自動生成される
5 | X3MODTBL.cbl | 動的変更テーブル | XMAP3の提供ファイルを利用する
6 | JYUTUGC.cbl※ | COBOLソース | エディタでユーザが作成する
7 | JYUTUGC.exe | 実行可能ファイル | COBOLソースに論理マップを取り込んでコンパイル，リンケージし作成する

注※

サンプルとしてサポートサービスで提供されています。

(b)　CUI画面の例題

CUI画面の例題で使用するファイルを次の表に示します。

表7-2　例題プログラムに使用するファイル（CUI画面）

項番 | ファイル名 | 用途 | 作成方法
1 | JYU1CC.IMP※ | マップ定義ファイル | ドローでユーザが作成する
2 | JYU1CCI.CBL | 入力論理マップ | 定義情報ファイル作成後，保存すると自動生成される
3 | JYU1CCO.CBL | 出力論理マップ | 定義情報ファイル作成後，保存すると自動生成される
4 | JYU1CCNC.PMP | 物理マップ | 定義情報ファイル作成後，保存すると自動生成される
5 | X3MODTBL.CBL | 動的変更テーブル | XMAP3の提供ファイルを利用する
6 | JYUTUCC.CBL※ | COBOLソース | エディタでユーザが作成する
7 | JYUTUCC.EXE | 実行可能ファイル | COBOLソースに論理マップを取り込んでコンパイル，リンケージし作成する

注※

サンプルとしてサポートサービスで提供されています。

(2)　例題で使用するファイルが提供されているフォルダ

GUI画面およびCUI画面の例題では，動的変更テーブルの準備も必要です。これらのプログラムでは，出力エリア（出力論理マップ）を初期化する際に動的変更テーブルの指定を利用しています。動的変更テーブル「X3MODTBL」は，登録集原文としてXMAP3から次のフォルダに標準提供されています。作業用のフォルダに複写して利用しましょう。

　　XMAP3インストールフォルダ¥INCLUDE

(3)　提供されているアプリケーションプログラムサンプル（APサンプル）

XMAP3のサポートサービスでは，このマニュアルの例題プログラムのほかに，COBOL用とC言語用のAPサンプルを提供しています。APサンプルでは，XMAP3を適用したアプリケーションプログラムの例題の，マップ定義ファイルやソースプログラムなどを参照できます。このマニュアルの例題を一とおり学習したあと，さらに詳細な機能を知りたい場合や，業務開発の参考にしたい場合などにお役立てください。

(4)　C言語の場合に必要となるファイル

C言語で同様のアプリケーションプログラムを作成する場合も，マップ定義ファイルやC言語ソースプログラムはサポートサービスで提供されています。

コンパイルおよびリンケージで必要なファイルは，次の場所に標準提供されています。

ヘッダファイル

XMAP3インストールフォルダ¥INCLUDE¥X3MODTBL.H

XMAP3インストールフォルダ¥INCLUDE¥JSVWATBL.H

ライブラリファイル

XMAP3インストールフォルダ¥LIB¥X3MWDR32.LIB

8.　帳票を作成しましょう

この章では，「納品伝票印刷プログラム（帳票）」で使用するマップ帳票の作成方法を説明します。

＜この章の構成＞

8.1　例題で作成する帳票を紹介します

8.2　帳票を作成しましょう

8.1　例題で作成する帳票を紹介します

「受注データ入力プログラム」で画面から入力されたデータは，ファイルに出力されます。納品伝票印刷プログラムでは，そのファイルからデータを呼び出して帳票に出力します。

「納品伝票印刷プログラム（帳票）」では，シリアルインパクトプリンタ用（連続紙またはカット紙），およびページプリンタ用の帳票を作成できます。使用するプリンタに合わせて，作成する帳票を選んでください。なお，このマニュアルでは，ページプリンタ用の帳票の作成を例に説明します。

例題で作成するマップ帳票のイメージを次の図に示します。

図8-1　例題で作成する帳票

この帳票のレイアウト定義（マップ定義ファイル）はサンプルとしてサポートサービスで提供されています。詳細については，「9.4　帳票の作成で使用したサンプルプログラムを紹介します」を参照してください。

＜この節の構成＞

(1)　帳票例題のレイアウト定義に関する注意事項

(1)　帳票例題のレイアウト定義に関する注意事項

レイアウトに配置するオブジェクトのデータ名はアプリケーションプログラムとのやり取りに利用されるため，変更や削除をしないでください。基本的に，このマニュアルの手順に従って操作すればデータ名が変更されることはありません。誤って変更してしまった場合には，生成された論理マップとコーディング内容を確認してからコンパイルする必要があります。コンパイルと実行については，「12.　コンパイルし，実行しましょう」を参照してください。

8.2　帳票を作成しましょう

図8-1の例題では，次に示す手順に従って帳票を作成します。

定義を開始します

タイトルを定義します

オブジェクトを配置します

得意先コードの欄を定義します

表の見出しを定義します

表の出力欄を定義します

合計欄を定義します

表けい線の枠を引きます

完成した帳票を確認します

定義を終了します

＜この節の構成＞

(1)　定義を開始します

(2)　タイトルを定義します

(3)　オブジェクトを配置します

(4)　完成した帳票を確認します

(5)　定義を終了します

(6)　作成されるファイル

(7)　オブジェクトのデータ名に関する注意事項

(1)　定義を開始します

Windowsの［スタート］にあるプログラム一覧から［XMAP3］－［XMAP3 Developer］－［ドロー］を選びます。
［新規・更新選択］ダイアログが表示されます。

「画面・帳票・書式を新規作成する」を選びます。

［OK］ボタンを選びます。
［新規作成］ダイアログが表示されます。

「マップ名」に「JYU1PC」と入力します。

「定義対象の選択」から「グラフィック帳票」を選び，「パターンの選択」から「フリー」を選びます。「言語種別」が「COBOL」になっていることを確認します。

［OK］ボタンを選びます。
［グラフィック帳票属性］ダイアログが表示されます。

［OK］ボタンを選びます。
帳票定義ウィンドウが表示されます。

(2)　タイトルを定義します

タイトルを定義する手順について説明します。

説明文中の「△」は，半角1文字分の空白を示します。

ツールボックスから[図データ]（固定フィールド（日本語））を選びます。

レイアウト領域の「縦 2行」「横 27列」にポインタを位置づけてクリックします。

「納△△品△△伝△△票」と入力したあとで，［Enter］キーを押します。

ツールバーから[図データ]（文字属性）を選びます。

「納△△品△△伝△△票」をクリックしたあとで，ツールボックスから[図データ]（倍角）を選びます。
タイトルの文字列が倍角になります。

ツールバーから[図データ]（レイアウトへ戻る）を選びます。
帳票定義ウィンドウが表示されます。

(3)　オブジェクトを配置します

(a)　得意先コードの欄を定義します

ツールボックスから[図データ]（固定フィールド（日本語））を選びます。

レイアウト領域の「縦 5行」「横 4列」にポインタを位置づけてクリックします。

「得意先コード:」と入力したあとで，［Enter］キーを押します。
「:」は半角文字で入力します。

ツールボックスの[図データ]（出力フィールド（数字））を数回クリックして[図データ]（出力フィールド（英数））を選びます。

レイアウト領域の「縦 5行」「横 17列」にポインタを位置づけ，「横 8列」サイズ分ドラッグします。

同様に，「得意先名」の欄を次のように定義します。

(b)　表の見出しを定義します

「商品コード」を定義します。ツールボックスから[図データ]（固定フィールド（日本語））を選びます。

レイアウト領域の「縦 8行」「横 4列」にポインタを位置づけてクリックします。

「商品コード」と入力したあとで，［Enter］キーを押します。
「商品コード」の見出しが定義されます。

同様に，「商品名」，「単価」，「数量」，および「金額」の見出しを次のように定義します。

(c)　表の出力欄を定義します

商品コードの出力領域を定義します。ツールボックスから[図データ]（出力フィールド（英数））を選びます。

レイアウト領域の「縦 9行」「横 6列」にポインタを位置づけ，［Shift］キーを押したまま，「縦 4行」「横 5列」サイズ分ドラッグします。

フィールドが縦4行分反復します。
同様に，「商品名」および「数量」の出力フィールドを次のように定義します。「商品名」および「数量」の出力フィールドも，縦4行分反復させてください。

単価の出力欄を定義します。ツールボックスから[図データ]（出力フィールド（数字））を選びます。

レイアウト領域の「縦 9行」「横 45列」にポインタを位置づけ，［Shift］キーを押したまま，「縦 4行」「横 7列」サイズ分ドラッグします。

「単価」と「数量」の出力フィールドをダブルクリックします。
［出力フィールド］ダイアログが表示されます。

「APが渡す項目」の「データ型」をそれぞれ次のように選びます。

「単価」・・・「Z,ZZ9」

「数量」・・・「ZZZZ9」

［OK］ボタンを選びます。
［出力フィールド］ダイアログが閉じ，帳票定義ウィンドウが表示されます。
同様に，「金額」の出力フィールドのデータ型を「Z,ZZ9」に設定します。

(d)　合計欄を定義します

ツールボックスから[図データ]（固定フィールド（日本語））を選びます。

レイアウト領域の「縦 14行」「横 49列」にポインタを位置づけてクリックします。

「合△計」と入力したあとで，［Enter］キーを押します。

ツールボックスから[図データ]（出力フィールド（数字））を選びます。

レイアウト領域の「縦 14行」「横 57列」にポインタを位置づけ，「横 18列」サイズ分ドラッグします。

「合計」の出力フィールドをダブルクリックします。
［出力フィールド］ダイアログが表示されます。

「APが渡す項目」の「データ型」から「¥,¥¥9」を選びます。

［OK］ボタンを選びます。
［出力フィールド］ダイアログが閉じ，帳票定義ウィンドウが表示されます。

ツールボックスから[図データ]（縦（左）／横（上）けい線）を選びます。

レイアウト領域の「縦 15行」「横 49列」にポインタを位置づけ，「横 27列」サイズ分ドラッグします。
マウスボタンから指を離すと，横けい線が配置されます。

(e)　表けい線の枠を引きます

ツールボックスの[図データ]（表けい線の枠（見出しなし））を数回クリックして，[図データ]（表けい線の枠（見出しあり））を選択します。

レイアウト領域の「縦 8行」「横 3列」にポインタを位置づけ，「縦 5行」「横 74列」サイズ分ドラッグします。
マウスボタンから指を離すと，表の枠とタイトル部の横けい線が配置されます。

ツールボックスから[図データ]（横けい線の繰り返し（2行間隔））を数回クリックして，[図データ]（横けい線の繰り返し（1行間隔））を選択します。

レイアウト領域の「縦 8行」「横 3列」にポインタを位置づけ，「縦 5行」「横 74列」サイズ分ドラッグします。
マウスボタンから指を離すと，横けい線が配置されます。

(4)　完成した帳票を確認します

ツールバーから[図データ]（印刷プレビュー）を選びます。
プレビューウィンドウに帳票がテスト表示され，レイアウトを確認できます。

気になる部分があれば，「2.2.5　レイアウト定義の基本操作を紹介します」を参照して修正してください。
なお，表示・印刷セットアップで印刷環境が設定されている場合は，ツールバーの[図データ]（テスト印刷）で帳票をテスト印刷できます。

注

テスト表示・印刷をするためには，XMAP3 Server RuntimeまたはXMAP3 Client Runtimeをインストールする必要があります。

ツールバーから[図データ]（論理マップ表示）を選びます。
帳票用論理マップ表示ウィンドウが表示され，論理マップを確認できます。

プレビューウィンドウ，および帳票用論理マップ表示ウィンドウのそれぞれの［閉じる］ボタンを選びます。

(5)　定義を終了します

ツールバーから[図データ]（ドローの終了）を選びます。またはメニューバーの［ファイル］－［ドローの終了］を選びます。

レイアウト定義の保存を問い合わせるダイアログから，［はい］ボタンを選びます。
［名前を付けて保存］ダイアログが表示されます。

ファイル名を確認して［保存］ボタンを選びます。
自動的に論理マップと物理マップが生成されます。

(6)　作成されるファイル

レイアウト定義を保存してドローを終了すると，レイアウト定義を保存したフォルダに次のファイルが作成されます。なお，ファイル名は，指定したマップ名によって異なります。ここでは，例題どおりマップ名を「JYU1PC」と指定した場合のファイル名を示します。

JYU1PC.imp（マップ定義ファイル）

JYU1PC.lsx（生成結果リストファイル）

JYU1PC6G.pmp（物理マップ）

JYU1PCO.cbl（出力論理マップ）
例題で作成した帳票の出力論理マップの内容を次に示します。

01  JYU1PCO.
   02  JYU1PCL          PIC  S9(4)  COMP-5    VALUE  +256.[図データ]
   02  JYU1PCZ          PIC  S9(4)  COMP      VALUE  +0.
   02  JYU1PCG.
     03  JYU1PC-FIELD0001-O   PIC  X(8).                    [図データ]
     03  JYU1PC-FIELD0002-O   PIC  X(6).                    [図データ]
     03  JYU1PC-FIELD0003-O   PIC  X(5)           OCCURS  4.[図データ]
     03  JYU1PC-FIELD0004-O   PIC  X(26)          OCCURS  4.[図データ]
     03  JYU1PC-FIELD0006-O   PIC  ZZZ,ZZ9        OCCURS  4.[図データ]
     03  JYU1PC-FIELD0005-O   PIC  ZZZ9           OCCURS  4.[図データ]
     03  JYU1PC-FIELD0007-O   PIC  Z,ZZZ,ZZZ,ZZ9  OCCURS  4.[図データ]
     03  JYU1PC-FIELD0008-O   PIC  ¥¥,¥¥¥,¥¥¥,¥¥¥,¥¥9.      [図データ]
*
01  JYU1PCT            PIC  S9(4)    COMP-5   VALUE  +256.

コーディングの説明を次に示します。説明の番号は，コーディング例中の丸付き数字の番号と対応しています。
1：論理マップ長
2：得意先コード
3：得意先名
4：商品コード
5：商品名
6：単価
7：数量
8：金額
9：合計

(7)　オブジェクトのデータ名に関する注意事項

定義した帳票の各項目に対応するデータ名（COBOLプログラムで参照・更新するデータ領域の名称）は，XMAP3が適当な名称を仮定します。通常の開発手順では，仮定されたデータ名を参照しながらコーディングを行います。

ただし，サポートサービスで提供するCOBOLプログラムのコーディングサンプルをそのまま使う場合には，各項目のデータ名は，コーディングサンプルで参照・更新している領域名に合わせておく必要があります。

サポートサービスで提供するCOBOLプログラムをそのまま使用する場合には，ドローのレイアウト定義画面から，メニューバーの［属性］－［データ名］を選んで「データ名編集」画面を表示し，データ名を修正してください。

サンプルで設定しているデータ名を次の画面に示します。データ名が異なる場合は，次の画面の「データ名」に合わせて修正してください。なお，データ名とオブジェクト名の対応については，「8.2(6)　作成されるファイル」を参照してください。

9.　帳票を使ったアプリケーションプログラムを作成しましょう

XMAP3でアプリケーションプログラムを作成するときには，SEND文を利用して，帳票への出力を指定します。この章では，納品伝票印刷プログラム（帳票）のポイントと，その作成方法を説明します。

＜この章の構成＞

9.1　コーディングを理解します

9.2　コーディングします

9.3　アプリケーションプログラムをコンパイルします

9.4　帳票の作成で使用したサンプルプログラムを紹介します

9.1　コーディングを理解します

＜この節の構成＞

9.1.1　処理の流れ

9.1.2　コーディングのポイント

9.1.1　処理の流れ

「納品伝票印刷プログラム（帳票）」のフローチャートを次の図に示します。

図9-1　「納品伝票印刷プログラム（帳票）」の処理の流れ

9.1.2　コーディングのポイント

帳票を使ったアプリケーションプログラムのコーディングのポイントを説明します。

＜この項の構成＞

(1)　コーディングに使用する論理マップ

(2)　アプリケーションプログラムのコーディング

(1)　コーディングに使用する論理マップ

コーディングでは，帳票の例題で作成した「納品伝票印刷プログラム」の出力論理マップを使用します。

出力論理マップ
出力論理マップを次に示します。

01  JYU1PCO.
   02  JYU1PCL          PIC  S9(4)  COMP-5    VALUE  +256.[図データ]
   02  JYU1PCZ          PIC  S9(4)  COMP      VALUE  +0.
   02  JYU1PCG.
     03  JYU1PC-FIELD0001-O   PIC  X(8).                    [図データ]
     03  JYU1PC-FIELD0002-O   PIC  X(6).                    [図データ]
     03  JYU1PC-FIELD0003-O   PIC  X(5)           OCCURS  4.[図データ]
     03  JYU1PC-FIELD0004-O   PIC  X(26)          OCCURS  4.[図データ]
     03  JYU1PC-FIELD0006-O   PIC  ZZZ,ZZ9        OCCURS  4.[図データ]
     03  JYU1PC-FIELD0005-O   PIC  ZZZ9           OCCURS  4.[図データ]
     03  JYU1PC-FIELD0007-O   PIC  Z,ZZZ,ZZZ,ZZ9  OCCURS  4.[図データ]
     03  JYU1PC-FIELD0008-O   PIC  ¥¥,¥¥¥,¥¥¥,¥¥¥,¥¥9.      [図データ]
*
01  JYU1PCT            PIC  S9(4)    COMP-5   VALUE  +256.

コーディングの説明を次に示します。説明の番号は，コーディング例中の丸付き数字の番号と対応しています。
1：論理マップ長
2：得意先コード
3：得意先名
4：商品コード
5：商品名
6：単価
7：数量
8：金額
9：合計

(2)　アプリケーションプログラムのコーディング

「納品伝票印刷プログラム（帳票）」のコーディングから重要な部分を抜粋したものを図9-2から図9-3に示し，ポイントを説明します。

図9-2　ポイントとなる部分のコーディング（帳票）（1/2）

図9-3　ポイントとなる部分のコーディング（帳票）（2/2）

ポイント1　COPY文で出力論理マップを取り込みます

XMAP3では，COPY文を使用して，アプリケーションプログラムへ出力論理マップを取り込みます。出力論理マップは，名称の最後に「O」が付きます。

ここでは，出力論理マップ名「JYU1PCO」を指定します。

ポイント2　通信記述項に帳票の出力に必要な情報を指定します

SEND文で使用する通信記述名を指定します。ここでは，「PRT」と指定します。

SEND文で出力する物理マップ名を指定します。ここでは，「帳票マップ名」と指定します。「帳票マップ名」には，手続き部でMOVE文を使って，物理マップ名「JYU1PC6G」を設定します（物理マップ名は，グラフィック帳票の場合，「マップ名+6G」となります）。

仮想端末名を指定します。ここでは，「帳票端末名」と指定します。

帳票の出力が正しく実行されたかどうかを判定する領域の名称を指定します。SEND文実行後，この領域にリターンコード「00000」が返されれば，帳票が正しく出力されたことになります。ここでは，「帳票-RC」と指定します。

ポイント3　SEND文で帳票の出力を指定します

SEND文でプリンタ端末への帳票印刷を指定します。SEND文では，通信記述項で指定した通信記述名，出力論理マップ名を指定します。ここでは，順に「PRT」，「JYU1PCO」と指定します。また，最後に必ず「WITH　EMI」と指定してください。

アプリケーションプログラムの作成について詳しく知りたい方は，マニュアル「XMAP3 プログラミングガイド」を参照してください。

9.2　コーディングします

納品伝票印刷プログラム（帳票）のように，帳票出力処理をするプログラムのコーディングには，APパターン「GENREP01.cbl」を利用します。このパターンには，帳票出力処理に必要な，プリンタに対する通信記述項の指定や標準的な手続きの骨組みが記述されています。APパターンを基にして，使用するマップ名や業務固有の手続きをコーディングしていきましょう。

APパターンを利用したコーディングについては，「4.4.2　APパターンを利用したアプリケーションプログラムの作成手順」もあわせて参照してください。

完成したコーディングは，サンプル（COBOLソースプログラム）としてサポートサービスで提供されています。ソースリストを印刷したり，エディタで開いたりして参考にすることをお勧めします。詳細については，「9.4　帳票の作成で使用したサンプルプログラムを紹介します」を参照してください。

＜この節の構成＞

(1)　APパターンを利用してコーディングしましょう

(2)　サンプルを利用してコーディングするときの注意事項

(1)　APパターンを利用してコーディングしましょう

使用しているエディタのウィンドウを開きます。

APパターン「GENREP01.cbl」を開きます※。
APパターンは，次のフォルダに格納されています。
　　XMAP3インストールフォルダ¥PATTERNS¥COBOL

コーディングします。
固有のプログラム名，マップ名，データ定義や手続きなどを記述してソースプログラムを作成します。手続きのコーディングには，共通処理として用意されているAP部品を処理内容に合わせて挿入します。

コーディングが終了したら，エディタのウィンドウを閉じて保存します。

注※

COBOLエディタを使用している場合は，次の説明を参照してください。

COBOLエディタでプログラムテンプレートを利用するには

COBOLエディタでのプログラムテンプレートの利用手順を説明します。

COBOLエディタウィンドウのメニューバーの［ファイル］－［新規作成］を選びます。
［新規作成］ダイアログが表示されます。

作成したいファイルの種類を選びます。

［...］ボタンを選び，表示されるダイアログからテンプレートファイルを選びます。
テンプレートファイルは次の場所に格納されています。
XMAP3インストールフォルダ¥PATTERNS¥COBOL

プログラムテンプレートのチェックボタンをオンにします。

［OK］ボタンを選びます。
新規にファイルが作成され，テンプレートの内容が表示されます。
APパターンを挿入するには，挿入したい行にテキストカーソルを位置づけ，メニューバーの［編集］－［ファイルの挿入］を選びます。ダイアログに表示されたファイルの一覧から，目的のAP部品を選択してください。

(2)　サンプルを利用してコーディングするときの注意事項

「8.　帳票を作成しましょう」で作成した画面は，APパターンを使わないで，サポートサービスで提供しているCOBOLプログラムをそのまま使ってコンパイル・実行できます。このとき，作成した画面の各オブジェクトのデータ名とコーディングサンプル中のデータ名を合わせておく必要があります。

データ名を合わせるには，次に示す方法があります。

コーディングサンプルを作成した画面のデータ名に合わせて修正する。

ドローのレイアウト定義の［データ名編集］ダイアログで，コーディングサンプルで使用しているデータ名に変更する。

ドローのレイアウト定義での変更については，「8.2(7)　オブジェクトのデータ名に関する注意事項」を参照してください。

9.3　アプリケーションプログラムをコンパイルします

作成した例題（帳票）のマップファイルとアプリケーションプログラムを，COBOL2002のコンパイラを用いてコンパイル，およびリンケージします。コンパイルしたアプリケーションプログラムは，実行して問題なく動作するかを確認します。

COBOL2002を使用したアプリケーションプログラムのコンパイル，およびアプリケーションプログラムの実行については，「12.　コンパイルし，実行しましょう」を参照してください。

また，コンパイルに使用するマップファイルやアプリケーションプログラムのサンプルについては，「9.4　帳票の作成で使用したサンプルプログラムを紹介します」に記載してありますので，コンパイル時の参考に使用してください。

9.4　帳票の作成で使用したサンプルプログラムを紹介します

帳票の例題で作成されたファイルの一覧を示します。

＜この節の構成＞

(1)　使用するファイル一覧

(2)　例題で使用するファイルが提供されているフォルダ

(3)　提供されているアプリケーションプログラムサンプル（APサンプル）

(4)　C言語の場合に必要となるファイル

(1)　使用するファイル一覧

帳票の例題で使用するファイルを次の表に示します。

表9-1　例題プログラムに使用するファイル（帳票）

項番 | ファイル名 | 用途 | 作成方法
1 | JYU1PC.imp※¹ | マップ定義ファイル | ドローでユーザが作成する
2 | JYU1PCO.cbl | 出力論理マップ | 定義情報ファイル作成後，保存すると自動生成される
3 | JYU1PC6G.pmp※² | 物理マップ | 定義情報ファイル作成後，保存すると自動生成される
4 | X3MODTBL.cbl | 動的変更テーブル | XMAP3の提供ファイルを利用する
5 | JYUTUPC.cbl※¹ | COBOLソース | エディタでユーザが作成する
6 | JYUTUPC.exe | 実行可能ファイル | COBOLソースに論理マップを取り込んでコンパイル，リンケージし作成する

注※1

サンプルとしてサポートサービスで提供されています。

注※2

グラフィック帳票の場合のファイル名です。

(2)　例題で使用するファイルが提供されているフォルダ

帳票の例題では，動的変更テーブルの準備も必要です。これらのプログラムでは，出力エリア（出力論理マップ）を初期化する際に動的変更テーブルの指定を利用しています。動的変更テーブル「X3MODTBL」は，登録集原文としてXMAP3から次のフォルダに標準提供されています。作業用のフォルダに複写して利用しましょう。

　　XMAP3インストールフォルダ¥INCLUDE

(3)　提供されているアプリケーションプログラムサンプル（APサンプル）

XMAP3のサポートサービスでは，このマニュアルの例題プログラムのほかに，COBOL用とC言語用のAPサンプルを提供しています。APサンプルでは，XMAP3を適用したアプリケーションプログラムの例題の，マップ定義ファイルやソースプログラムなどを参照できます。このマニュアルの例題を一とおり学習したあと，さらに詳細な機能を知りたい場合や，業務開発の参考にしたい場合などにお役立てください。

(4)　C言語の場合に必要となるファイル

C言語で同様のアプリケーションプログラムを作成する場合も，マップ定義ファイルやC言語ソースプログラムはサポートサービスで提供されています。

コンパイルおよびリンケージで必要なファイルは，次の場所に標準提供されています。

ヘッダファイル

XMAP3インストールフォルダ¥INCLUDE¥X3MODTBL.H

XMAP3インストールフォルダ¥INCLUDE¥JSVWATBL.H

ライブラリファイル

XMAP3インストールフォルダ¥LIB¥X3MWDR32.LIB

10.　書式を作成しましょう

この章では，「納品伝票印刷プログラム（書式オーバレイ）」で使用する書式帳票の作成方法を説明します。

＜この章の構成＞

10.1　例題で作成する書式を紹介します

10.2　書式を作成しましょう

10.1　例題で作成する書式を紹介します

例題で作成する書式のイメージを次の図に示します。

図10-1　例題で作成する書式

この書式のレイアウト定義（マップ定義ファイル）は，サンプルとしてサポートサービスで提供されています。詳細については，「11.4　書式の作成で使用したサンプルプログラムを紹介します」を参照してください。

10.2　書式を作成しましょう

図10-1の例題では，次に示す作成手順に従って書式帳票を作成します。

定義を開始します

タイトルを定義します

オブジェクトを配置します

得意先コードの欄を定義します

明細の表の見出しを定義します

明細の表のけい線を定義します

明細行の網掛けを定義します

合計欄を定義します

完成した書式を確認します

定義を終了します

＜この節の構成＞

(1)　定義を開始します

(2)　タイトルを定義します

(3)　オブジェクトを配置します

(4)　完成した書式を確認します

(5)　定義を終了します

(6)　作成されるファイル

(1)　定義を開始します

Windowsの［スタート］にあるプログラム一覧から［XMAP3］－［XMAP3 Developer］－［ドロー］を選びます。
［新規・更新選択］ダイアログが表示されます。

「画面・帳票・書式を新規作成する」を選びます。

［OK］ボタンを選びます。
［新規作成］ダイアログが表示されます。

「マップ名」に「JYU1FC」と入力します。

「定義対象の選択」から「書式オーバレイ」を選び，「パターンの選択」から「A4横 9ポイント文字，5ポイント間隔（10CPI），6LPI」を選びます。

［OK］ボタンを選びます。
書式定義ウィンドウが表示されます。

(2)　タイトルを定義します

タイトルを定義する手順について説明します。

説明文中の「△」は，半角1文字分の空白を示します。

ツールボックスから[図データ]（固定フィールド（日本語））を選びます。

レイアウト領域の「縦 2行」「横 27列」にポインタを位置づけてクリックします。

「納△△品△△伝△△票」と入力したあとで，［Enter］キーを押します。

ツールバーから[図データ]（文字属性）を選びます。

「納△△品△△伝△△票」をクリックしたあとで，ツールボックスから[図データ]（倍角）を選びます。
タイトルの文字列が倍角になります。

ツールバーから[図データ]（レイアウトへ戻る）を選びます。

ツールボックスから[図データ]（矩形（ラウンドコーナ））を選びます。

レイアウト領域の「縦 2行」「横 26列」にポインタを位置づけ，「縦 2行」「横 30列」サイズ分ドラッグします。

ツールボックスから[図データ]（網掛け（ラウンドコーナ））を選びます。

レイアウト領域の「縦 2行」「横 26列」にポインタを位置づけ，「縦 2行」「横 30列」サイズ分ドラッグします。

(3)　オブジェクトを配置します

(a)　得意先コードの欄を定義します

ツールボックスから[図データ]（固定フィールド（日本語））を選びます。

レイアウト領域の「縦 5行」「横 4列」にポインタを位置づけてクリックします。

「得意先コード：」と入力したあとで，［Enter］キーを押します。

ツールボックスから[図データ]（固定フィールド（日本語））を選びます。

レイアウト領域の「縦 6行」「横 4列」にポインタを位置づけてクリックします。

「得意先名△△△△：」と入力したあとで，［Enter］キーを押します。

(b)　明細の表の見出しを定義します

ツールボックスから[図データ]（固定フィールド（日本語））を選びます。

レイアウト領域の「縦 8行」「横 4列」にポインタを位置づけてクリックします。

「商品コード」と入力したあとで，［Enter］キーを押します。
「商品コード」の見出しが定義されます。

同様に，「商品名」，「単価」，「数量」，および「金額」の見出しを次のように定義します。

(c)　明細の表のけい線を定義します

ツールボックスの[図データ]（表けい線の枠（見出しなし））を数回クリックして，[図データ]（表けい線の枠（見出しあり））を選択します。

レイアウト領域の「縦 8行」「横 3列」にポインタを位置づけ，「縦 5行」「横 72列」サイズ分ドラッグします。
見出し付きの表のけい線が定義されます。

ツールボックスから[図データ]（縦（右）／横（下）けい線）を選びます。

レイアウト領域の「縦 9行」「横 45列」にポインタを位置づけ，「縦 4行」サイズ分ドラッグします。

ツールバーから[図データ]（線種／太さ）を選びます。

破線に変更するけい線をクリックしたあと，ツールボックスから[図データ]（破線（細））を選びます。

ツールバーから[図データ]（レイアウトへ戻る）を選びます。
手順4.～手順6.の操作を繰り返して，残りの破線を引きます。

(d)　明細行の網掛けを定義します

ツールボックスの[図データ]（網掛け（ラウンドコーナ））を数回クリックして[図データ]（網掛けの繰り返し（1行間隔））を選びます。

レイアウト定義の「縦 9行」「横 3列」にポインタを位置づけ，「縦 4行」「横 72列」サイズ分ドラッグします。
1行置きに網掛けが定義されます。

(e)　合計欄を定義します

ツールボックスから[図データ]（固定フィールド（日本語））を選びます。

レイアウト領域の「縦 14行」「横 49列」にポインタを位置づけてクリックします。

「合計」と入力したあとで，［Enter］キーを押します。

ツールボックスから[図データ]（縦（左）／横（上）けい線）を選びます。

レイアウト領域の「縦 15行」「横 49列」にポインタを位置づけ，「横 23列」サイズ分ドラッグします。
ここで，けい線の種類を実線（中）に変更します。操作手順は「10.2(3)(c)　明細の表のけい線を定義します」を参考にしてください。

ツールバーから[図データ]（レイアウトへ戻る）を選びます。

(4)　完成した書式を確認します

ツールバーから[図データ]（印刷プレビュー）を選びます。
プレビューウィンドウに書式帳票がテスト表示され，レイアウトを確認できます。

気になる部分があれば，「2.2.5　レイアウト定義の基本操作を紹介します」を参照して修正してください。

なお，表示・印刷セットアップで印刷環境が設定されている場合は，ツールバーの[図データ]（テスト印刷）で書式をテスト印刷できます。

テスト印刷をする場合は，メニューバーの［ツール］－［印刷先の設定］で，サービス名が表示・印刷セットアップで設定した名称と同じかどうか確認してください。

注

テスト表示・印刷をするためには，XMAP3 Server RuntimeまたはXMAP3 Client Runtimeをインストールする必要があります。

(5)　定義を終了します

ツールバーから[図データ]（ドローの終了）を選びます。またはメニューバーの［ファイル］－［ドローの終了］を選びます。

レイアウト定義の保存を問い合わせるダイアログから，［はい］ボタンを選びます。
［名前を付けて保存］ダイアログが表示されます。

ファイル名を確認して［保存］ボタンを選びます。
自動的に書式データファイルと行制御データファイルが生成されます。

(6)　作成されるファイル

レイアウト定義を保存してドローを終了すると，レイアウト定義を保存したフォルダに次のファイルが作成されます。なお，ファイル名は，指定したマップ名によって異なります。ここでは，例題どおりマップ名を「JYU1FC」と指定した場合のファイル名を示します。

JYU1FC.ifm（書式定義ファイル）

JYU1FC.lsx（生成結果リストファイル）

JYU1FC6G.fmp（書式イメージファイル）

JYU1FC6G.pci（行制御データファイル）

11.　書式を使ったアプリケーションプログラムを作成しましょう

XMAP3でアプリケーションプログラムを作成するときには，APPLY FORMS-OVERLAY句で書式オーバレイの印刷を指定し，WRITE文を利用して行データの出力を指定します。この章では，納品伝票印刷プログラム（書式オーバレイ）のポイントと，その作成方法を説明します。

＜この章の構成＞

11.1　コーディングを理解します

11.2　コーディングします

11.3　アプリケーションプログラムをコンパイルします

11.4　書式の作成で使用したサンプルプログラムを紹介します

11.1　コーディングを理解します

＜この節の構成＞

11.1.1　処理の流れ

11.1.2　コーディングのポイント

11.1.1　処理の流れ

納品伝票印刷プログラム（書式オーバレイ）のフローチャートを次の図に示します。

図11-1　納品伝票印刷プログラム（書式オーバレイ）の処理の流れ

11.1.2　コーディングのポイント

納品伝票印刷プログラム（書式オーバレイ）のコーディングから重要な部分を抜粋したものを図11-2から図11-3に示し，ポイントを説明します。

図11-2　ポイントとなる部分のコーディング（書式オーバレイ）（1/2）

図11-3　ポイントとなる部分のコーディング（書式オーバレイ）（2/2）

ポイント1　ファイル管理記述項に書式印刷するプリンタを割り当てます

書式オーバレイ印刷するプリンタのファイル名を指定し，外部装置に割り当てます。ここでは，ファイル名に「プリンタ」を，外部装置名に環境変数「PRT001」を指定しています。

FILE STATUS句に，プリンタの入出力状態値が設定されるデータ項目名を指定します。この指定によって，プリンタに対する入出力動作（OPEN文，CLOSE文，WRITE文の実行）の状態を判定して，きめ細かく処理を分岐したり，異常があればプログラムを終了したりできます。この例題プログラムでは，入出力状態値が00（入出力の動作が成功したことを示します）であれば処理を続行し，00以外の場合は何らかの異常が発生したと見なしてプログラムを終了させています。

ポイント2　入出力管理記述項に書式印刷を指定します

APPLY FORMS-OVERLAY句で書式印刷を指定します。書式を示すデータ名と，「ポイント1」で割り当てたプリンタファイルを指定します。ここでは，データ名を「書式名」にして，直接指定していません。手続き部でMOVE文を使い，書式データファイル名「JYU1FC6G」を書式名に設定しています。

ポイント3　行データの編集領域を指定します

書式のレイアウトに合わせて，行データのレコード長を決めます。また，レイアウトの異なる行ごとに，編集領域を記述します。各編集領域の長さは，行データの長さと等しくします。

ポイント4　WRITE文で行データの出力を指定します

行データを編集したあと，WRITE文を使って行データの出力を指定します。書式レイアウトを参照しながら，BEFORE ADVANCING指定またはAFTER ADVANCING指定で行送りの数を記述してください。先頭行にポインタを位置づけたい場合や，改行だけをしたい場合などには，行データのレコードに空白を設定して行送りを指定します。

WRITE文で行送りを指定するとき，BEFORE指定を使用するか，AFTER指定を使用するかをプログラム中で統一しましょう。統一によってわかりやすいコーディングとなります。また，コーディングミスによる重ね打ちを防ぐこともできます。

アプリケーションプログラムの作成について詳しく知りたい方は，マニュアル「XMAP3 プログラミングガイド」を参照してください。

11.2　コーディングします

納品伝票印刷プログラム（書式オーバレイ）のように，書式オーバレイ印刷処理をするプログラムのコーディングには，APパターン「GENOVL01.cbl」を利用します。このパターンには，書式オーバレイ印刷処理に必要な，プリンタに対するファイル管理記述項，入出力管理記述項の指定や標準的な手続きの骨組みが記述されています。APパターンを基にして，使用する書式名や業務固有の手続きをコーディングしていきましょう。

APパターンを利用したコーディングについては，「4.4.2　APパターンを利用したアプリケーションプログラムの作成手順」もあわせて参照してください。

完成したコーディングは，サンプル（COBOLソースプログラム）としてサポートサービスで提供されています。ソースリストを印刷，またはエディタでサンプルファイルを開いて，どのようにコーディングされているか確認することをお勧めします。

詳細については，「11.4　書式の作成で使用したサンプルプログラムを紹介します」を参照してください。

＜この節の構成＞

(1)　APパターンを利用してコーディングしましょう

(1)　APパターンを利用してコーディングしましょう

使用しているエディタのウィンドウを開きます。

APパターン「GENOVL01.cbl」を開きます※。
APパターンは，次のフォルダに格納されています。
　　XMAP3インストールフォルダ¥PATTERNS¥COBOL

コーディングします。
固有のプログラム名，書式名，データ定義や手続きなどを記述してソースプログラムを作成します。

コーディングが終了したら，エディタのウィンドウを閉じて保存します。

注※

COBOLエディタを使用している場合は，次の説明を参照してください。

COBOLエディタでプログラムテンプレートを利用するには

COBOLエディタでのプログラムテンプレートの利用手順を説明します。

COBOLエディタウィンドウのメニューバーの［ファイル］－［新規作成］を選びます。
［新規作成］ダイアログが表示されます。

作成したいファイルの種類を選びます。

［...］ボタンを選び，表示されるダイアログからテンプレートファイルを選びます。
テンプレートファイルは次の場所に格納されています。
XMAP3インストールフォルダ¥PATTERNS¥COBOL

プログラムテンプレートのチェックボタンをオンにします。

［OK］ボタンを選びます。
新規にファイルが作成され，テンプレートの内容が表示されます。
APパターンを挿入するには，挿入したい行にテキストカーソルを位置づけ，メニューバーの［編集］－［ファイルの挿入］を選びます。ダイアログに表示されたファイルの一覧から，目的のAP部品を選択してください。

11.3　アプリケーションプログラムをコンパイルします

作成した例題（書式）のマップファイルとアプリケーションプログラムを，COBOL2002のコンパイラを用いて，コンパイルおよびリンケージします。コンパイルしたアプリケーションプログラムは，実行して問題なく動作するかを確認します。

COBOL2002を使用したアプリケーションプログラムのコンパイル，およびアプリケーションプログラムの実行については，「12.　コンパイルし，実行しましょう」を参照してください。

また，コンパイルに使用するマップファイルやアプリケーションプログラムのサンプルについては，「11.4　書式の作成で使用したサンプルプログラムを紹介します」に記載してありますので，コンパイル時の参考に使用してください。

11.4　書式の作成で使用したサンプルプログラムを紹介します

書式の例題で作成されたファイルの一覧を示します。

＜この節の構成＞

(1)　例題で使用するファイル一覧

(2)　提供されているアプリケーションプログラムサンプル（APサンプル）

(3)　C言語の場合に必要となるファイル

(1)　例題で使用するファイル一覧

書式オーバレイ印刷の例題で使用するファイルを次の表に示します。

表11-1　例題プログラムに使用するファイル（書式オーバレイ印刷）

項番 | ファイル名 | 用途 | 作成方法
1 | JYU1FC.ifm※ | 書式定義ファイル | ドローでユーザが作成する
2 | JYU1FC6G.fmp | 書式イメージファイル | 定義情報ファイル作成後，保存すると自動生成される
3 | JYU1FC6G.pci | 行制御データファイル | 定義情報ファイル作成後，保存すると自動生成される
4 | JYUTUFC.cbl※ | COBOLソース | エディタでユーザが作成する
5 | JYUTUFC.txt※ | 行データのテキストファイル | エディタでユーザが作成する
6 | JYUTUFC.exe | 実行可能ファイル | COBOLソースをコンパイル，リンケージし作成する

注※

サンプルとしてサポートサービスで提供されています。

(2)　提供されているアプリケーションプログラムサンプル（APサンプル）

XMAP3のサポートサービスでは，このマニュアルの例題プログラムのほかに，COBOL用とC言語用のAPサンプルを提供しています。APサンプルでは，XMAP3を適用したアプリケーションプログラムの例題の，マップ定義ファイルやソースプログラムなどを参照できます。このマニュアルの例題を一とおり学習したあと，さらに詳細な機能を知りたい場合や，業務開発の参考にしたい場合などにお役立てください。

(3)　C言語の場合に必要となるファイル

C言語で同様のアプリケーションプログラムを作成する場合，マップ定義ファイルやC言語ソースプログラムは，サポートサービスで提供されています。

コンパイルおよびリンケージで必要なファイルは，次の場所に標準提供されています。

ヘッダファイル

XMAP3インストールフォルダ¥INCLUDE¥JSTGLCOM.H

ライブラリファイル

XMAP3インストールフォルダ¥LIB¥X3KLIB32.LIB

12.　コンパイルし，実行しましょう

この章では，COBOL2002を使ったコンパイルおよび実行に必要な準備と，例題のアプリケーションプログラムをコンパイルして実行する方法について説明します。

＜この章の構成＞

12.1　コンパイルと実行に必要な準備

12.2　コンパイルと実行の手順

12.1　コンパイルと実行に必要な準備

COBOL2002でコンパイル，実行する前の準備について説明します。

＜この節の構成＞

12.1.1　コンパイルの準備

12.1.2　実行の準備

12.1.1　コンパイルの準備

アプリケーションプログラムをコンパイルして，実行可能ファイルを準備するまでの主なデータの流れを次の図に示します。

図12-1　コンパイルの準備のデータの流れ

＜この項の構成＞

(1)　XMAP3と連携するためのコンパイラオプションを指定します

(2)　動的変更テーブルの格納フォルダを指定します

(1)　XMAP3と連携するためのコンパイラオプションを指定します

XMAP3と連携するために必要なコンパイラオプションを次に示します。

画面・帳票

-Comp5オプションおよび-JPN,Alnumオプションを必ず指定してください。-Comp5オプションは，USAGE句のCOMP-5指定を利用できるようにするオプションです。また，-JPN,Alnumオプションは，日本語項目，日本語編集項目をそれぞれ英数字項目，英数字編集項目として扱うようにするオプションです。どちらも論理マップの生成内容に関連しています。

書式オーバレイ

-XMAP,LinePrintオプションを必ず指定してください。-XMAP,LinePrintオプションは，XMAP3の書式オーバレイや印刷制御機能を利用できるようにするオプションです。

(2)　動的変更テーブルの格納フォルダを指定します

動的変更テーブルのように，ソースプログラムが格納されているフォルダ以外のフォルダから登録集原文を参照するとき，登録集原文を格納するフォルダをコンパイル時の環境変数CBLLIBに指定します。XMAP3から生成された登録集原文も，ユーザが作成した登録集原文と同様に扱うことができます。コンパイルでは，COPY文で定義した登録集原文名が，指定したフォルダから検索され，アプリケーションプログラムに取り込まれます。なお，ソースプログラムと登録集原文を同じフォルダに格納している場合は，環境変数を指定する必要はありません。

注1

リンケージでは，COBOL2002のリンカからXMAP3が提供しているライブラリが検索されます。

注2

画面または帳票を使用するアプリケーションプログラムをコンパイルする場合は，次の点に注意してください。

レイアウト定義で，入出力テキストなどのアプリケーションプログラムとデータをやり取りする項目を，誤って削除したり，データ名を変更したりする場合があります。

削除または変更前の論理マップに使われているデータ名で，手続きをコーディングしていると，コンパイル時にエラーとなります。したがって，レイアウト定義を変更した場合には，生成された論理マップ，およびコーディングを確認した上でコンパイルしてください。

12.1.2　実行の準備

単独のWindowsマシン上（スタンドアロン構成）でアプリケーションプログラムを実行するときの，主なデータの流れを次の図に示します。XMAP3を使ったアプリケーションプログラムの実行には，XMAP3の実行環境と，COBOL2002の実行環境が必要です。

図12-2　実行時のデータの流れ

＜この項の構成＞

(1)　定義体と実行可能ファイル（アプリケーションプログラム）を同じフォルダに格納します

(2)　印刷環境を設定します（帳票・書式の場合）

(1)　定義体と実行可能ファイル（アプリケーションプログラム）を同じフォルダに格納します

アプリケーションプログラムを実行する前に，必要なファイルを実行用のフォルダに準備します。

画面・帳票

物理マップ（拡張子「.pmp」）を実行可能ファイルと同じフォルダに格納しておきます。

書式オーバレイ

書式イメージファイル（拡張子「.fmp」）と行制御データファイル（拡張子「.pci」）を，実行可能ファイルと同じフォルダに格納しておきます。

(2)　印刷環境を設定します（帳票・書式の場合）

Windows上でのプリンタの設定

使用するプリンタに対応するプリンタドライバを組み込みます。次に，使用するプリンタを，通常使うプリンタとして設定しておきます。

表示・印刷セットアップ

［表示・印刷セットアップ］ダイアログの［プリンタ］タブで，仮想端末「PRT001」，およびサービス名「#PRT」を標準プリンタ（ページプリンタ）として割り当てておきます。標準プリンタ以外のページプリンタに印刷する場合は，サービス名「#PRT1」を割り当ててください。

［表示・印刷セットアップ］ダイアログについては，マニュアル「XMAP3 実行ガイド」を参照してください。

12.2　コンパイルと実行の手順

GUI画面の例題プログラムを例に，アプリケーションプログラムをCOBOL2002でコンパイル，実行する方法について説明します。

COBOL2002でコンパイルする手順については，マニュアル「COBOL2002 操作ガイド」を参照してください。

＜この節の構成＞

12.2.1　コンパイルするためのフォルダを準備します

12.2.2　コンパイルします

12.2.3　実行します

12.2.1　コンパイルするためのフォルダを準備します

画面，帳票，および書式の例題作成で作成されたマップファイル，APサンプルをコンパイルするための作業フォルダを準備します。

ここでは，次に示す作業フォルダを作成し，その下で例題アプリケーションプログラムをコンパイルします。

　　C:¥xmap3¥nyumon¥test

＜この項の構成＞

(1)　作業フォルダに格納するファイル

(2)　作業フォルダに格納するファイル（自動生成されるファイル）

(3)　作業フォルダに格納するファイル（提供ファイル）

(4)　コンパイルを実行した結果，作成されるファイル

(1)　作業フォルダに格納するファイル

これまでに例題で作成したレイアウト定義のファイル（マップ定義ファイル，または書式定義ファイル）と，COBOLソースプログラムファイルを複写して，コンパイル用の作業フォルダ（例 C:¥xmap3¥nyumon¥test）に格納してください。

なお，これらのファイルはサポートサービスでサンプルとして提供されています。

ファイルの種類 | GUI画面 | CUI画面 | 帳票 | 書式オーバレイ
マップ定義ファイル | JYU1GC.imp | JYU1CC.imp | JYU1PC.imp | －
COBOLソース | JYUTUGC.cbl | JYUTUCC.cbl | JYUTUPC.cbl | JYUTUFC.cbl
書式定義ファイル | － | － | － | JYU1FC.ifm

（凡例）

－：なし。

(2)　作業フォルダに格納するファイル（自動生成されるファイル）

マップ定義ファイル，または書式定義ファイルから自動生成された次のファイルを，コンパイル用の作業フォルダ（例 C:¥xmap3¥nyumon¥test）に複写して格納します。

ファイルの種類
GUI画面
CUI画面
帳票
書式オーバレイ

入力論理マップ
JYU1GCI.cbl
JYU1CCI.cbl
－
－

出力論理マップ
JYU1GCO.cbl
JYU1CCO.cbl
JYU1PCO.cbl
－

物理マップ
JYU1GCND.pmp
JYU1CCNC.pmp
JYU1PC6G.pmp※
－

書式イメージ
ファイル
－
－
－
JYU1FC6G.fmp

行制御データ
ファイル
－
－
－
JYU1FC6G.pci

（凡例）

－：なし。

注※

グラフィック帳票の場合のファイル名です。

(3)　作業フォルダに格納するファイル（提供ファイル）

次に示すファイルは，必ずXMAP3から提供されているファイルを複写してください。COBOLソースプログラムと同じフォルダに複写するか，環境変数CBLLIBにこのフォルダを指定してください。ファイルの格納先は，次のとおりです。

XMAP3インストールフォルダ¥INCLUDE

ファイルの種類 | GUI画面 | CUI画面 | 帳票 | 書式オーバレイ
動的変更テーブル | X3MODTBL.cbl | X3MODTBL.cbl | X3MODTBL.cbl | －

（凡例）

－：なし。

(4)　コンパイルを実行した結果，作成されるファイル

例題どおりにコンパイルを実行した結果，作成されるファイルを次に示します。

ファイルの種類 | GUI画面 | CUI画面 | 帳票 | 書式オーバレイ
実行可能ファイル | jyutugc.exe | jyutucc.exe | jyutupc.exe | jyutufc.exe

12.2.2　コンパイルします

GUI画面の例題プログラムを例に，COBOL2002のコンパイル手順について説明します。帳票の例題アプリケーションプログラムのコンパイルは，GUI画面の例題プログラムと同じ操作でコンパイルできます。

COBOL開発マネージャウィンドウを表示させます。

メニューバーの［プロジェクトマスタ］－［新規作成］を選択します。
［プロジェクトマスタの作成］ダイアログが表示されます。

プロジェクトマスタ名，およびプロジェクトマスタフォルダ名を入力します。

［完了］ボタンを選びます。
［プロジェクトの作成］ダイアログが表示されます。

プロジェクト名を入力します。
また，「プロジェクトフォルダと作業フォルダを同一にする。」のチェックボタンをオンにします。

［OK］ボタンを選びます。
［プロジェクトの追加］ダイアログが表示されます。

「実行形式プログラム」を選び，［次へ］ボタンを選びます。

プロジェクトの種類に［System指定メインプログラム］を選び，［次へ］ボタンを選びます。

実行可能ファイル名「jyutugc.exe」を入力したあと，［次へ］ボタンを選びます。

注

CUI画面の場合
実行可能ファイル名「jyutucc.exe」を入力してください。

帳票の場合
実行可能ファイル名「jyutupc.exe」を入力してください。

書式オーバレイの場合
実行可能ファイル名「jyutufc.exe」を入力してください。

プログラムのソースファイル名「JYUTUGC.cbl」を入力したあと，［完了］ボタンを選びます。

COBOL開発マネージャウィンドウに戻り，実行可能ファイル名，COBOLソースファイル，および依存ファイルのフォルダが表示されます。

メニューバーの［プロジェクト］－［ソースファイルの追加］を選択し，マップ定義ファイル「JYU1GC.imp」を追加します。

COBOL2002の「登録集原文」を入力するダイアログが表示されます。ドローで生成された入力論理マップ「JYU1GCI.cbl」および出力論理マップ「JYU1GCO.cbl」を指定します。

注

CUI画面の場合
マップ定義ファイル名「JYU1CC.imp」，入力論理マップ「JYU1CCI.cbl」および出力論理マップ「JYU1CCO.cbl」を指定します。

帳票の場合
マップ定義ファイル名「JYU1PC.imp」，出力論理マップ「JYU1PCO.cbl」を入力します。さらに「ファイル名」に「JYU1PCI.cbl」と入力します。
補足説明
「JYU1PCI.cbl」は，実際には参照されないファイルですが，COBOL2002との連携のために指定します。

書式オーバレイの場合
この操作は必要ありません。

コンパイラオプションに「-Comp5」が追加された旨のメッセージが表示されます。

メニューバーの［プロジェクト］－［プロジェクトの設定］を選びます。
［プロジェクト設定］ダイアログが表示されます。

コンパイラオプションを設定します。
［その他］タブを選び，「-JPN,Alnum」を設定します。

注

CUI画面の場合
［その他］タブを選び，「-JPN,Alnum」を設定します。

帳票の場合
［その他］タブを選び，「-JPN,Alnum」を設定します。

書式オーバレイの場合
［製品連携］タブを選び，「-XMAP,LinePrint」を設定します。

［環境変数］タブから環境変数CBLLIBに，論理マップや動的変更テーブルが格納されているフォルダ（XMAP3インストールフォルダ¥INCLUDE）を設定します。

注

動的変更テーブルなどのアプリケーションプログラムで使う登録集原文を，別フォルダに格納している場合だけ設定してください。

書式オーバレイの場合，この操作は必要ありません。

メニューバーの［ビルド］－［ビルド］を選びます。

ビルドが完了すると，メッセージが表示されます。

エラーメッセージが表示された場合は，表示されたメッセージを基にデバッグをしてください。エラー内容については，COBOL2002，およびXMAP3のヘルプを参照してください。

12.2.3　実行します

実行を始める前に，次のファイルが実行可能ファイルと同じフォルダ（操作例では，C:¥xmap3¥nyumon¥testの下）に格納されているか確認しましょう。

画面，または帳票の例題

物理マップ（拡張子「.pmp」）

書式オーバレイの例題

書式イメージファイル（拡張子「.fmp」），行制御データファイル（拡張子「.pci」）

書式の例題では，このほかに，行データを入力するためのテキストファイル（JYUTUFC.txt）を準備します。例題で使用するテキストファイルはサポートサービスでサンプルとして提供されています。

また，印刷環境を次のとおりに設定してください。

Windows上でのプリンタ設定

使用するプリンタに対応するプリンタドライバを組み込みます。次に，使用するプリンタを，通常使うプリンタとして設定しておきます。

表示・印刷セットアップ

［表示・印刷セットアップ］ダイアログの［プリンタ］タブで，仮想端末「PRT001」，およびサービス名「#PRT」を標準プリンタ（ページプリンタ）として割り当てておきます。標準プリンタ以外のページプリンタに印刷する場合は，サービス名「#PRT1」を割り当ててください。

［表示・印刷セットアップ］ダイアログについては，マニュアル「XMAP3 実行ガイド」を参照してください。

COBOL開発マネージャのメニューバー［ビルド］－［実行］を選びます。

［実行］ダイアログが表示されます。

「実行可能ファイル名」に実行したい実行可能ファイル名が表示されていることを確認して[OK]ボタンを選びます。

アプリケーションプログラムが実行されます。

注1

書式オーバレイの例題では，手順2.で［OK］ボタンを選ぶと，物理ファイルを割り当てるダイアログが表示されます。標準プリンタ（ページプリンタ）に印刷する場合は，環境変数CBLX_PRT001に「#PRT」を指定してください。標準プリンタ以外のページプリンタに印刷する場合は，「表示・印刷セットアップ」で割り当てた「#PRT1」を指定してください。

注2

帳票を印刷する場合に，ページプリンタ以外を標準プリンタにしているときは，印刷機能のセットアップが必要です。その場合は，マニュアル「XMAP3 実行ガイド」を参照してください。

付録

＜この付録の構成＞

付録A　XMAP3ではこんなこともできます

付録B　知っていると便利なレイアウト定義の操作

付録C　トラブルが発生した場合には

付録D　APパターンとサンプルの紹介

付録E　XMAP3 Version 5の機能一覧

付録F　このマニュアルの参考情報

付録G　用語解説

付録A　XMAP3ではこんなこともできます

このマニュアルの例題プログラムに盛り込まれた基本的な機能のほかに，XMAP3でできる応用的な機能を紹介します。

＜この節の構成＞

付録A.1　こんな機能が使えます

付録A.2　画面に関してこんな機能が使えます

付録A.3　帳票に関してこんな機能が使えます

付録A.4　開発環境のセットアップに関してこんな機能が使えます

付録A.5　実行環境のセットアップに関してこんな機能が使えます

付録A.6　チューニングやデバッグに関してこんな機能が使えます

付録A.1　こんな機能が使えます

＜この項の構成＞

(1)　レイアウト定義

(2)　アプリケーションプログラム作成

(1)　レイアウト定義

機能1　生成される論理マップのデータ名や展開順を変更する

レイアウト定義時に，論理マップに生成されるデータ名や展開順を［データ名編集］ダイアログで変更できます。なお，展開順はウィンドウに配置されたオブジェクトの位置の順にソートしたり，任意の順に変更したりできます。

詳細については，マニュアル「XMAP3 開発ガイド」を参照してください。

機能2　テキストなどを反復して組み合わせ表形式で並べる

画面や帳票では，テキストなどを組み合わせて，縦方向または横方向に反復して表形式で並べることができます。この機能はフレームを使用して定義します。フレームは，テキストのほかにもポップアップやバーコードなどにも使用できます。

詳細については，マニュアル「XMAP3 開発ガイド」を参照してください。

機能3　ドローの定義画面を複数表示してオブジェクトをコピーする

画面・帳票のレイアウトの定義時に，同じ定義対象のレイアウト定義画面を二つまで表示できます。表示したレイアウト定義画面から，オブジェクトを指定してレイアウト定義している画面にコピーできます。

詳細については，マニュアル「XMAP3 開発ガイド」を参照してください。

(2)　アプリケーションプログラム作成

機能1　C言語を使ってアプリケーションプログラムを作成する

アプリケーションプログラムの開発言語にC言語を使用することもできます。

詳細については，マニュアル「XMAP3 プログラミングガイド」を参照してください。なお，このマニュアルで紹介した例題のC言語を使用したサンプルは，サポートサービスで提供されています。

機能2　作成したレイアウト定義の内容をほかの言語用に変換する

作成したレイアウト定義の内容を，COBOLからC言語に，またはC言語からCOBOLに変換できます。変換には，XMAP3 開発支援ユティリティのコンバートを使用します。

操作方法については，マニュアル「XMAP3 開発支援ユティリティ」を参照してください。

機能3　TRANSCEIVE文やSEND文の代わりにCALL文を使って送受信する

画面の送受信，または帳票の送信命令には，COBOLの標準仕様であるCALL文を使うこともできます。この場合に使用するCALLインタフェースも標準提供されています。詳細については，マニュアル「XMAP3 プログラミングガイド」を参照してください。

付録A.2　画面に関してこんな機能が使えます

＜この項の構成＞

(1)　レイアウト定義

(2)　アプリケーションプログラム作成

(1)　レイアウト定義

機能1　デフォルトでチェックボタンやラジオボタンを選択済みの状態にする

該当するボタンをダブルクリックすると，ダイアログが表示されます。このダイアログで，「選択済みにする」を選択してください。

機能2　壁紙を使用する

各オブジェクトの背後に壁紙としてグラフィックを表示できます。壁紙のグラフィックには，31,000バイト以下のビットマップファイル（.BMP）が使えます。壁紙は，［画面属性］ダイアログで設定します。なお，設定した壁紙はテスト表示で確認できます。

注

テスト表示をするためには，XMAP3 Server RuntimeまたはXMAP3 Client Runtimeをインストールする必要があります。

機能3　数字やカナの入力チェックをXMAP3で行う

入出力テキストをダブルクリックすると，ダイアログが表示されます。このダイアログで「詳細目的」に「数字」や「カナ」などの組み合わせを設定すると，実行時に入力できる文字を制限します。

機能4　画面確定のタイミングを変更する

画面確定のタイミングは，アプリケーションプログラムに制御を渡す単位によって決まります。制御を渡す単位には，通常の方法（画面単位）のほかにフィールド単位やイベント単位などがあります。制御を渡す単位を変更するには，［画面属性］ダイアログを使用します。

フィールド単位

フィールド単位では，アプリケーションプログラムでフォーカスやカーソルを設定したオブジェクトだけが操作対象となります。このオブジェクトから次のオブジェクトにフォーカス・カーソルを移動するとアプリケーションプログラムに制御が渡されます。

イベント単位

イベント単位では，すべてのオブジェクト（不活性を指定しているものを除く）が活性状態で表示されます。これらのオブジェクトの一つから，データ入力または選択操作をしたあと，次のオブジェクトにカーソル・フォーカスを移動するとアプリケーションプログラムに制御が渡されます。

定義方法およびアプリケーションプログラムの作成方法については，マニュアル「XMAP3 プログラミングガイド」を参照してください。

機能5　特定のキーを抑止する

PFキーを押してもアプリケーションプログラムに制御を返さないで，押されたことを無効にできます。また，有効・無効にするキーをアプリケーションプログラムで変更できます。

詳細については，マニュアル「XMAP3 プログラミングガイド」を参照してください。

機能6　スプラッシュ画面を作成する

スプラッシュ画面を作成するには，画面が表示された直後に，アプリケーションプログラムに制御を渡します。表示直後にアプリケーションに制御を渡す設定は，［画面属性］ダイアログを使用します。また，この制御を渡すまでの時間を任意に指定できます。

操作方法については，マニュアル「XMAP3 プログラミングガイド」を参照してください。

機能7　フォーカスの移動順序を設定する

グループボックス間で，フォーカスを移動する順序を設定できます。グループボックスとは，画面上のオブジェクト（セパレータを除く）を囲んでグループ化するオブジェクトです。

操作方法については，マニュアル「XMAP3 開発ガイド」を参照してください。

機能8　キーで選択できるポップアップメニューを作成する

ポップアップメニューとしてアクセスキーを指定しておくと，マウスだけではなく，キー入力でもメニューを選択できるようになります。アクセスキーとして指定できるけた数は1～4です。

ポップアップメニューの作成方法については，マニュアル「XMAP3 開発ガイド」を参照してください。

(2)　アプリケーションプログラム作成

アプリケーションプログラムでの応用的な機能を紹介します。機能1から機能4に関連するコーディングのひな型は，APパターンのAP部品に用意されています。画面用のAP部品の種類については，「付録D.1　APパターン一覧」を参照してください。

機能1　カーソルやフォーカス位置の設定を変更する

論理マップの中のカーソルまたはフォーカス制御項目に，位置づけたいフィールドやボックス対応の定数を設定することで，アプリケーションプログラムからカーソルまたはフォーカス位置の初期設定ができます。

この機能は，部品パターン「SETCRS01」に関連しています。コーディング方法については，マニュアル「XMAP3 プログラミングガイド」を参照してください。

機能2　メッセージを二次ウィンドウで表示する

XMAP3で定義する画面には，一次ウィンドウと二次ウィンドウがあります。一次ウィンドウはメインとなる画面で，何も表示されていない状態のときに表示します。業務を選択するメニューや，各業務の主画面として使用します。

二次ウィンドウは，一次ウィンドウを表示したまま新しく表示する画面です。データ入力の入力補助，メッセージ，ヘルプなどに使用します。メッセージを二次ウィンドウで表示するには，TRANSCEIVE文（またはRECEIVE文）で一次ウィンドウから入力したデータの内容を判定したあと，TRANSCEIVE文（またはSEND文）で表示するマップ名を二次ウィンドウのマップ名に変更します。このTRANSCEIVE文（またはSEND文）を実行すると，二次ウィンドウを使ってメッセージを表示できます。このとき，次のように，あらかじめ二次ウィンドウのレイアウトを確認しておいてください。

レイアウト定義ウィンドウを起動するときに表示されるダイアログで，定義種別から「ディスプレイGUI画面（二次）」を選ぶ。さらに，使用する定義パターンを選択する。

レイアウト定義ウィンドウで画面のレイアウトを定義する。このとき，「OK」のような二次ウィンドウを終了するプッシュボタンを定義して，特定のイベント通知コードが返されたら二次ウィンドウを終了するように指定しておく。

この機能は，AP部品「FLDHLP01」と「PATWRT01」に関連しています。コーディングについては，マニュアル「XMAP3 プログラミングガイド」を参照してください。

機能3　入力エラーのとき，テキストやフィールド（入出力）の色をアプリケーションプログラムで変更する

該当するオブジェクトをダブルクリックして，「動的変更（APから表示属性を変更する）」を選びます。アプリケーションプログラム実行時，制御項目に標準提供している動的変更テーブルのエラー修飾名'ER'を設定すると，赤色でフィールドを表示できます。この機能は，AP部品「ATRCRS01」と「MODATR01」に関連しています。

また，このほかの修飾名も用意されています。詳細については，マニュアル「XMAP3 開発ガイド」，およびマニュアル「XMAP3 プログラミングガイド」を参照してください。

機能4　データエントリ画面で入力フィールドだけをクリアする

アプリケーションプログラム実行時，ウィンドウ制御に動的変更テーブルのウィンドウコントロール'CL'を設定すると，画面の入力テキストやフィールドに表示されていたデータがクリアされます。この機能は，AP部品「CLRINP01」に関連しています。詳細については，マニュアル「XMAP3 プログラミングガイド」を参照してください。

機能5　グラフやイメージデータを表示する

グラフやイメージなどのグラフィックデータをアプリケーションプログラムから表示できます。表示するグラフィックデータは，あらかじめ，ほかのツールで作成してファイルやクリップボードに保存しておきます。

詳細については，マニュアル「XMAP3 プログラミングガイド」を参照してください。

付録A.3　帳票に関してこんな機能が使えます

＜この項の構成＞

(1)　レイアウト定義

(2)　アプリケーションプログラム作成

(3)　プログラム実行

(1)　レイアウト定義

機能1　用紙のフォーマットイメージをレイアウト定義ウィンドウの背後に表示しながら定義する

プレプリント帳票，グラフィック帳票，および書式オーバレイでは，帳票のフォーマットイメージをレイアウト定義ウィンドウの背後に下敷きとして表示しながら定義できます。用紙上のけい線などに合わせてオブジェクトの位置を調整する場合に使います。下敷きは，［下敷き］ダイアログで設定します。このダイアログでは，下敷きとして使う用紙をスキャナで読み込むなどしたビットマップファイル（.BMP）を設定します。

操作方法については，マニュアル「XMAP3 開発ガイド」を参照してください。

機能2　シリアルプリンタ用に定義した帳票をページプリンタ用に変換する

シリアルプリンタ用に作成した帳票（けい線帳票）の定義内容を，ページプリンタ用の帳票（網掛け帳票）に変換できます。変換には，XMAP3 開発支援ユティリティのコンバートを使用します。既存の帳票定義をある程度流用できるように変換できます。

操作方法については，マニュアル「XMAP3 開発支援ユティリティ」を参照してください。

(2)　アプリケーションプログラム作成

アプリケーションプログラムでの応用的な機能を紹介します。

機能1　帳票のフィールドで文字の書体を変更したり文字に網掛けしたりする

アプリケーションプログラムから文字の書体を変更したり網掛けしたりできます。この機能は，グラフィック帳票の場合に使用できます。文字の書体や網掛けのほかに，文字の強調表示や抹消線を引くこともできます。

詳細については，マニュアル「XMAP3 プログラミングガイド」を参照してください。

機能2　帳票のけい線表示を変更する

アプリケーションプログラムからけい線の表示を変更できます。この機能は，グラフィック帳票の場合に使用できます。表示の変更は，けい線の種類や太さのほかに，けい線を引かなくすることもできます。

詳細については，マニュアル「XMAP3 プログラミングガイド」を参照してください。

機能3　印刷ドキュメント名またはPDFファイル名をアプリケーションプログラムから変更する

帳票を印刷する際に，Windowsのプリンタスプールに登録される印刷ドキュメント名またはPDFファイル名を，アプリケーションプログラムから変更できます。

詳細については，マニュアル「XMAP3 プログラミングガイド」を参照してください。

(3)　プログラム実行

機能1　書式オーバレイ名を環境変数で指定する

書式オーバレイの印刷では，プログラムで書式名を指定しなくても，プログラムの外部から環境変数で引数を指定できます。

詳細については，マニュアル「XMAP3 実行ガイド」を参照してください。

付録A.4　開発環境のセットアップに関してこんな機能が使えます

機能1　アプリケーションプログラムから表示属性を変更する場合の修飾名，通知コード（ファンクションキーなど）を変更する

表示属性の動的変更に使用する修飾名や通知コードを，必要に応じてドローセットアップで変更できます。詳細については，マニュアル「XMAP3 開発ガイド」を参照してください。

付録A.5　実行環境のセットアップに関してこんな機能が使えます

実行環境のセットアップには，表示・印刷セットアップを使用します。

機能1　制御キーを変更する

画面操作時に使用する制御キーの動作を，表示・印刷セットアップの［キー割当］タブで変更できます。例えば，［Ctrl］，［Tab］，［Enter］をほかのキーに割り当てることができます。詳細については，マニュアル「XMAP3 実行ガイド」を参照してください。

機能2　画面の表示色，または帳票の印刷色を調整する

XMAP3の画面で使用する文字色（またはラベル色）および背景色や，グラフィック帳票で使用する印刷色の定義は変更しないで，外部から動的に調整できます。変更したい色は，任意のRGB値で指定します。画面で使用する色を変更したい場合は，表示・印刷セットアップの［表示色］タブで設定してください。グラフィック帳票で使用する印刷色を変更したい場合は，表示・印刷セットアップの［印刷色］タブで設定してください。

詳細については，マニュアル「XMAP3 実行ガイド」を参照してください。

機能3　画面の表示文字を調整する

XMAP3の画面に表示する文字の書体やサイズは，表示・印刷セットアップで標準で割り当てられている設定を変更して表示することもできます。変更したい場合は，表示・印刷セットアップの［表示文字］タブで設定してください。詳細については，マニュアル「XMAP3 実行ガイド」を参照してください。

機能4　プリンタの特性を生かして柔軟に印刷する

XMAP3では，出力対象のプリンタの特性に合わせて，次に示す設定ができます。

シリアルインパクトプリンタ（ESC/Pスルーモード）
ミリ・ドット単位で紙送りを設定

レーザープリンタ（LIPSスルーモード）
印刷データ量を削減する設定

変更したい場合は，表示・印刷セットアップの［プリンタ］タブの「印刷モード」で設定します。使用しているプリンタに適した印刷モードに変更してください。

詳細については，マニュアル「XMAP3 実行ガイド」を参照してください。

機能5　プリンタの種類を変更，または帳票をPDFファイルに出力する

プリンタ機種を変更する場合に，プリンタ出力で適用する印刷モードを設定できます。さらに，PDFファイルに出力することもできます。

表示・印刷セットアップの［プリンタ］タブで，出力先ごとに印刷モードを設定します。

詳細については，マニュアル「XMAP3 実行ガイド」を参照してください。

機能6　帳票をPDFファイルに出力後，任意のアプリケーションプログラムを自動的に起動する

XMAP3では，帳票をPDFファイルに出力したあとに任意のアプリケーションプログラムを自動的に起動できます。これによって，出力後のPDF帳票を自動的にプレビュー表示したり，HOPSS3/AS 日立電子帳票システムと連携して帳票を自動管理したりできます。

詳細については，マニュアル「XMAP3 実行ガイド」を参照してください。

機能7　画面の文字入力のデフォルトを変更する

XMAP3で作成した画面では，文字入力のデフォルトが上書きモードになっていますが，挿入モードをデフォルトに設定することもできます。設定を変更したい場合は，表示・印刷セットアップの［キー操作1］タブの「挿入キーの動作」で変更します。

詳細については，マニュアル「XMAP3 実行ガイド」を参照してください。

機能8　画面の見た目の大きさを変更する

解像度が高いディスプレイを使う場合に，XMAP3の画面の文字サイズを大きく見やすくできます。

表示・印刷セットアップの［表示文字］タブで文字サイズを大きくすると，ディスプレイの解像度に合わせて文字サイズを自動的に大きく表示できます。

詳細については，マニュアル「XMAP3 実行ガイド」を参照してください。

付録A.6　チューニングやデバッグに関してこんな機能が使えます

機能1　実行時のログを採取する

画面表示および帳票印刷時のログは，ロギング支援機能で採取できます。ロギング支援では，ログの確認だけでなく，実行環境の設定情報を確認することもできます。

詳細については，マニュアル「XMAP3 実行ガイド」を参照してください。

機能2　実行時の画面ハードコピーを利用する

ハードコピー機能で，XMAP3を使用したGUI画面やCUI画面のハードコピーを印刷できます。ハードコピー機能では，ホットキーの割り当て，日付・時刻の印刷，モノクロ化する条件などが設定できます。

詳細については，マニュアル「XMAP3 実行ガイド」を参照してください。

付録B　知っていると便利なレイアウト定義の操作

知っているとさらに便利なレイアウト定義の操作について説明します。

＜この節の構成＞

(1)　ドローのコマンド起動

(2)　レイアウト部品の配置

(3)　文字色・背景色の変更

(4)　文字属性・枠高の変更

(5)　線種・太さの変更

(6)　網掛けパターンの変更

(7)　グループボックスの枠の削除

(8)　データ長のカスタマイズ

(9)　ボタン順序の変更

(1)　ドローのコマンド起動

コマンドによるドローの起動方法について説明します。コマンドラインからコマンドを入力して実行します。

(a)　コマンドラインの形式

X3dmain.exe△〔"ドライブ名:¥パス名¥定義ファイル名.imp"〕

△：一つ以上の空白またはタブを示す。

上記の形式は，画面または帳票の定義ファイルからマップ生成する場合のものです。書式の場合は，定義ファイルの拡張子が.ifmになります。

説明

ドライブ名

起動する定義ファイル（マップ定義ファイルまたは書式定義ファイル）が格納されているドライブ名を指定します。

パス名

起動する定義ファイルが格納されている場所を絶対パスで指定します。

ファイル名

起動する定義ファイル名を指定します。

注

X3dmain.exeコマンドだけ（ファイル名の指定なし）を実行すると，［ドロー］メニューやアイコンを選んだときと同様に［新規・更新選択］ダイアログが表示されます。また，存在しないファイル名を指定した場合，［新規作成］ダイアログが表示されます。

(2)　レイアウト部品の配置

あらかじめ登録してあるレイアウト部品をレイアウト領域に配置します。部品の登録については，マニュアル「XMAP3 開発ガイド」を参照してください。

メニューバーの［編集］－［部品貼り付け］を選びます。

［部品貼り付け］ダイアログが表示されます。

使用するレイアウト部品を部品名称の欄から選び，［OK］ボタンを選びます。
部品がレイアウト領域の左上に貼り付けられます。

ドラッグして配置したい位置に部品を移動します。
必要に応じて，オブジェクトの属性や，アプリケーションプログラムとのインタフェースであるデータ名を変更します。

(3)　文字色・背景色の変更

GUI画面，CUI画面，およびグラフィック帳票では，レイアウト定義ウィンドウに配置したオブジェクトの文字色を変更できます。また，GUI画面では，オブジェクトの背景色も変更できます。変更には，文字色や背景色の指定用ツールボックスを使用します。

ツールボックスを文字色・背景色の指定用に切り替えます。

GUI画面の場合

ツールバーから［文字色／背景色］を選びます。またはメニューバーの［属性］－［文字色／背景色］を選びます。

CUI画面およびグラフィック帳票の場合

ツールバーから［文字色］を選びます。またはメニューバーの［属性］－［文字色］を選びます。

ツールボックスが文字色・背景色の指定用に切り替わります。

文字色や背景色を変更するオブジェクトを選択します。

複数のオブジェクトが選択できます。選択したすべてのオブジェクトが変更の対象になります。

ツールボックスから文字色や背景色のボタンを選びます。
選択したオブジェクトの文字色や背景色が変更されます。

ツールバーから［レイアウトへ戻る］を選びます。またはメニューバーの［属性］－［レイアウトへ戻る］を選びます。

(4)　文字属性・枠高の変更

GUI画面，けい線帳票，プレプリント帳票，グラフィック帳票，および書式オーバレイでは，レイアウト定義ウィンドウに配置したオブジェクトの文字属性を変更できます。また，GUI画面では，オブジェクトの枠高を変更できます。変更には，文字属性や枠高の指定用ツールボックスを使用します。

ツールボックスを文字属性・枠高の指定用に切り替えます。

GUI画面の場合

ツールバーから［文字属性／枠高］を選びます。またはメニューバーの［属性］－［文字属性／枠高］を選びます。

けい線帳票，プレプリント帳票，グラフィック帳票，および書式オーバレイの場合

ツールバーから［文字属性］を選びます。またはメニューバーの［属性］－［文字属性］を選びます。

ツールボックスが文字属性・枠高の指定用に切り替わります。

文字属性や枠高を変更するオブジェクトを選択します。
選択したオブジェクトだけが変更の対象になります。

ツールボックスから文字属性や枠高のボタンを選びます。
選択したオブジェクトの文字属性や枠高が変更されます。

文字属性の指定について

文字の拡大や書体などを組み合わせて指定できます。なお，文字を拡大したり斜体にしたりすると，オブジェクトのサイズが拡大されるので，オブジェクトの回りに空きがあるか確認してください。

枠高の指定について

プッシュボタンやテキスト系のオブジェクトに対して指定できます。文字サイズとの組み合わせで高さを広げたりする場合に指定します。

プッシュボタンの場合は，高さが数段階に変更できます。変更には，［ボタンサイズ縮小］ボタンや［ボタンサイズ拡大］ボタンを使用します。ツールボックスのボタンをクリックすると，高くなったり低くなったりします。

ツールバーから［レイアウトへ戻る］を選びます。またはメニューバーの［属性］－［レイアウトへ戻る］を選びます。

(5)　線種・太さの変更

GUI画面，けい線帳票，網掛け帳票，プレプリント帳票，グラフィック帳票，および書式オーバレイでは，レイアウト定義ウィンドウに配置したけい線の線種や太さを変更できます。また，GUI画面では，セパレータの線種や太さも変更できます。

変更には，線種や太さの指定用ツールボックスを使用します。

ツールバーから［線種／太さ］を選びます。またはメニューバーの［属性］－［線種／太さ］を選びます。
ツールボックスが線種・太さの指定用に切り替わります。

線種や太さを変更するセパレータやけい線を選択します。

複数のセパレータやけい線が選択できます。選択したすべてのセパレータやけい線が変更の対象になります。

ツールボックスから線種や太さのボタンを選びます。
選択したセパレータやけい線の線種や太さが変更されます。

ツールバーから［レイアウトへ戻る］を選びます。またはメニューバーの［属性］－［レイアウトへ戻る］を選びます。

(6)　網掛けパターンの変更

網掛け帳票，グラフィック帳票，および書式オーバレイでは，レイアウト定義ウィンドウに配置した網掛けのパターンを変更できます。変更には，網掛けパターンの指定用ツールボックスを使用します。

ツールバーから［網掛けパターン］を選びます。またはメニューバーの［属性］－［網掛けパターン］を選びます。
ツールボックスが網掛けパターンの指定用に切り替わります。

パターンを変更する網掛けを選択します。
複数の網掛けが選択できます。選択したすべての網掛けが変更の対象になります。

ツールボックスから網掛けのパターンのボタンを選びます。
選択した網掛けのパターンが変更されます。

ツールバーから［レイアウトへ戻る］を選びます。またはメニューバーの［属性］－［レイアウトへ戻る］を選びます。

(7)　グループボックスの枠の削除

グループボックス中のオブジェクトは削除しないで，グループボックスの枠だけを削除します。

グループボックスを選択します。

メニューバーの［編集］－［グループボックスを消す］を選びます。
グループボックスの枠だけが削除されます。グループ内のオブジェクトは削除されません。

(8)　データ長のカスタマイズ

混在項目，およびカナ項目の論理マップの長さ（データ長）は，ドローセットアップで指定したターゲットに応じて変化します。データ長は，論理マップで使用したい半角文字数（けた）を基にXMAP3が自動的に推奨値を設定しますが，扱う文字コードの特性として「けた＜データ長」となるターゲットでは，混在項目のデータ長の値をカスタマイズすることもできます（カナ項目はできません）。

詳細については，マニュアル「XMAP3 開発ガイド」を参照してください。

(9)　ボタン順序の変更

プッシュボタン，固定ラジオボタン，および固定チェックボタンの順序を変更できます。

ボタンを選びます。

ボタンを変更したい位置へドラッグします。
ドラッグ中に表示される枠が，変更したい位置のボタンと重なる位置でマウスのボタンを離します。
ドラッグ中に表示される枠が，変更したい位置のボタンと重ならない位置でマウスのボタンを離すと，ボタン間隔が変わります。

付録C　トラブルが発生した場合には

トラブルが発生した場合の参照先について説明します。

＜この節の構成＞

(1)　インストール時のトラブルには

(2)　レイアウト定義時のトラブルには

(3)　テスト表示／印刷時のトラブルには

(4)　コンパイル時のトラブルには

(5)　実行時のトラブルには

(1)　インストール時のトラブルには

XMAP3のインストールでトラブルが発生した場合には，マニュアル「XMAP3 開発ガイド」を参照してください。

(2)　レイアウト定義時のトラブルには

レイアウト定義時にトラブルが発生した場合には，XMAP3ヘルプのドローに関する説明を参照してください。

(3)　テスト表示／印刷時のトラブルには

テスト表示／印刷時にトラブルが発生した場合は，XMAP3ヘルプの開発時のトラブルに関する説明を参照してください。また，エラーメッセージとリターンコードについても，XMAP3ヘルプを参照してください。

(4)　コンパイル時のトラブルには

アプリケーションプログラムのコンパイル時の主なエラーとその対処を次の表に示します。なお，XMAP3ヘルプでも対処方法を知ることができます。

表C-1　コンパイル時の主なエラー

項番
エラー
意味
対処方法

1
KCCC1076C-S
COPY文で取り込もうとしているファイルが，アプリケーションプログラムのソースが格納されているフォルダ中にないことが考えられる。
ファイルが，アプリケーションプログラムのソースが格納されているフォルダ中にあるか見直し，ない場合はファイルをコピーしてコンパイルし直す。

2
KCCC1076C-S
COPY文で取り込もうとしているファイル名が誤っていることが考えられる。
XMAP3で作成した論理マップファイル名であるか見直し，ファイル名が誤っているときは正しい名称に修正してコンパイルし直す。

3
KCCC3015C-S
データ名，または変数名に不当な文字を指定していることが考えられる。
データ名，および変数名を見直す。

4
KCCC3015C-S
必要なテーブル「X3MODTBL」がアプリケーションプログラムを格納しているフォルダにないことが考えられる。
アプリケーションプログラムを格納しているフォルダに次のファイルをコピーして，コンパイルし直す。
「XMAP3インストールフォルダ¥INCLUDE¥X3MODTBL.CBL」

リンケージ時の主なエラーとその対処を次の表に示します。なお，XMAP3ヘルプでも対処方法を知ることができます。

表C-2　リンケージ時の主なエラー

項番
エラー
意味
対処方法

1
LNK1104
アプリケーション実行時に必要なXMAP3のライブラリを参照できない。
コンパイル環境のWindowsマシンにXMAP3の開発モデルがインストールされているか確認する（CALL文のインタフェースで作成したアプリケーションの場合はリンケージ環境）。

2
LNK2001
LNK1120
リンケージ時に必要なXMAP3のライブラリを参照できない。
リンケージオプションを次の手順で設定する。

COBOL開発マネージャの［プロジェクト］－［プロジェクトの設定］を選ぶ。

［リンク］タブの「ライブラリの指定」にチェックを入れる。
表示されるダイアログの設定内容に，次の内容を追加する。
「XMAP3インストールフォルダ¥LIB¥X3MWDR32.LIB」

(5)　実行時のトラブルには

アプリケーションプログラムの実行時の主なエラーとその対処を次の表に示します。なお，XMAP3ヘルプでも対処方法を知ることができます。

表C-3　実行時の主なエラー（コンソール画面）

項番 | エラー | 意味 | 対処方法
1 | KCCC5008R-S | エラーコードで示すエラーがXMAP3で発生した。 | 入出力時のエラーコードを見て対処する。エラーコードについては，マニュアル「XMAP3 実行ガイド」のリターンコード・詳細コードについての説明を参照する。
2 | KCCC3417R-S | サービス名が不足している。

付録D　APパターンとサンプルの紹介

XMAP3では，APパターンを標準提供し，サンプルをサポートサービスで提供しています。APパターンとサンプルについて説明します。

＜この節の構成＞

付録D.1　APパターン一覧

付録D.2　サンプルの入手方法

付録D.1　APパターン一覧

XMAP3 Developerでは，次のアプリケーションプログラムのコーディングに利用するAPパターンを標準提供しています。

画面のアプリケーションプログラム

帳票と書式オーバレイのアプリケーションプログラム

APパターンは，次のフォルダで提供しています。

XMAP3インストールフォルダ¥PATTERNS¥COBOL（またはC）

画面のアプリケーションプログラムのコーディングに利用するAPパターンを次の表に示します。

表D-1　APパターン（画面）

●APパターン

パターン名
（適用言語）
パターンの内容
パターンの使用ケース
使用する
定義サンプル

BTMENU01
（COBOL）
（C言語）
ログイン画面からメニュー画面を起動させます。プッシュボタンによる多目的メニューです。ボタン，ファンクションキー，またはテンキー選択に対応してアプリケーションプログラムを起動します。

ログイン画面は必要に応じて削除してください。

実行ファイル（.EXE）をCALL文で呼び出していますが，内部ルーチン用に変更することもできます。

すべての業務をまとめた初期メニューとしての使用を想定しています。

内部ルーチン用に変更して，サブメニューとしても使用できます。

ログインウィンドウ（GPASW1），一段ボタンメニュー（BMENU1）との併用を想定しています。

SLMENU01
（COBOL）
（C言語）
ログイン画面からメニュー画面を起動させます。ラジオボタン，またはテンキー選択による初期メニューです。選択した番号に対応してアプリケーションプログラムを起動します。

ログイン画面は必要に応じて削除してください。

実行ファイル（.EXE）をCALL文で呼び出していますが，内部ルーチン用に変更することもできます。

すべての業務をまとめた初期メニューとしての使用を想定しています。

内部ルーチン用に変更して，サブメニューとしても使用できます。

ログインウィンドウ（GPASW1），
一段ラジオボタンメニュー（SMENU1）との併用を想定しています。

GENDSP01
（COBOL）
（C言語）
汎用画面入出力プログラムです。一つの画面に対応した画面入出力処理を行います。

1画面だけの表示を想定しています。追加画面は，部品NXTDSP 01を追加して行います。

入力後のチェック結果によって，AP部品を随時挿入します。

COBOL用では，メインプログラムへは戻らないことを想定しています。メインプログラムへ戻す場合には，「STOP RUN」を変更して使用します。

メニュープログラムを使用したメインメニューから呼ばれることを想定しています。
一般の画面に適用できます。

GENDSP02
（COBOL）
汎用画面入出力プログラムです。一つの画面に対応した画面入出力処理を，CALLインタフェースを利用して行います。

1画面だけの表示を想定しています。追加画面は，同じくCALLインタフェースを使用しているGENDSP03を追加して行います。

入力後のチェック結果によって，AP部品を随時挿入します。

メインプログラムへは戻らないことを想定しています。メインプログラムへ戻す場合には，「STOP RUN」を変更して使用します。

メニュープログラムを使用したメインメニューから呼ばれることを想定しています。

COBOLのCALLインタフェースを使用して画面入出力を行うケースを想定しています。

一般の画面に適用できます。

GENDSP03
（COBOL）
GENDSP02から呼び出されるサブプログラムです。
GENDSP02との組み合わせを想定しています。
一般の画面に適用できます。

GENFLD01
（COBOL）
（C言語）
フィールド単位アクセス用入出力プログラムです。カーソルが位置づいているフィールドだけ入力できます。

アプリケーションプログラムでは，入力データをチェックし，対応する処理を行います。

チェックでOKであれば，次に入力したいフィールドにカーソルを位置づけて画面を再表示します。

フィールド単位にアプリケーションプログラムに返して，入力データをチェックすることを想定しています。

COBOLのWINDOW SECTIONで実現していた業務をGUIに移行する際のアプリケーションプログラムを想定しています。

フィールド単位画面（FIE1GCまたはFIE1GH）の使用を想定しています。

GENEVN01
（COBOL）
（C言語）
イベント単位アクセス用入出力プログラムです。画面上のどこからでも入力することができ，アプリケーションプログラムにイベントを返します。

アプリケーションプログラムでは，イベント通知コードの領域に，入力したフィールドのイベント定数が返ってきます。

イベントごとの処理を行うセクションを設けて，各フィールドの処理を行います。

複数のトグルフィールドから一つだけを選択して処理を行うことを想定しています。
イベント単位画面（EVE1GCまたはEVE1GH）の使用を想定しています。

DSPPRT01
（COBOL）
（C言語）
GENDSP01とGENREP 01とを合わせた汎用画面入出力・帳票印刷プログラムです。画面入出力を行ったあと，帳票を出力します。
メニュープログラムを使用したメインメニューから呼ばれることを想定しています。
一般の画面・帳票に適用できます。

●AP部品

パターン名
（適用言語）
パターンの内容
パターンの使用ケース
使用する
定義サンプル

NXTDSP01
（COBOL）
（C言語）
画面入出力処理の追加コーディングです。
GENDSP01，
DSPPRT01への挿入を想定しています。
一般の画面に適用できます。

ATRCRS01
（COBOL）
（C言語）
特定の入力／入出力テキストまたはフィールドの文字色を変更して，フォーカスまたはカーソルを該当項目に設定します。該当項目以外は，元の画面の状態とします。
GENDSP01，
DSPPRT01，
BTMENU01，
SLMENU01，
NXTDSP01への挿入を想定しています。
一般の画面に適用できます。

CLRINP01
（COBOL）
（C言語）
表示画面の入力項目だけをヌルクリアして初期状態にします。データエントリ画面での利用を想定しています。
GENDSP01，
DSPPRT01，
NXTDSP01への挿入を想定しています。
一般の画面に適用できます。

FLDHLP01
（COBOL）
（C言語）
ファンクションキーやプッシュボタンが押されたときに，カーソルのある項目に対応するヘルプ画面を表示します。フィールドごとのヘルプ表示を想定しています。
GENDSP01，
DSPPRT01，
BTMENU01，
SLMENU01，
NXTDSP01への挿入を想定しています。
小ダイアログ，中ダイアログ（HELP01）との併用を想定しています。

MODATR01
（COBOL）
（C言語）
特定の入力／入出力／出力テキストまたはフィールドの文字色を変更します。

入力チェック後のエラー表示用として使用します。

表示データ代入処理と合わせて使用することで，初めから文字色を変更したい場合にも応用できます。

GENDSP01，
DSPPRT01，
BTMENU01，
SLMENU01，
NXTDSP01，
GENFLD01，
GENEVN01への挿入を想定しています。
一般の画面に適用できます。

PATWRT01
（COBOL）
（C言語）
表示されている画面に対して，ある1項目だけを書き換えます。ほかの項目の状態はそのままとします。

エラーメッセージなどをメッセージフィールドに表示する場合に使用します。

1項目だけでなく，複数項目またはすべての項目を書き換えるように変更することで，固定部分をそのままにして可変部分をすべて書き換えて表示する場合にも応用できます。

GENDSP01，
DSPPRT01，
BTMENU01，
SLMENU01，
NXTDSP01，
GENFLD01，
GENEVN01への挿入を想定しています。
一般の画面に適用できます。

SETCRS01
（COBOL）
（C言語）
表示されている画面に対して，フォーカスやカーソル位置を設定し直します。ほかの項目の値は変更しません。
GENDSP01，
DSPPRT01，
BTMENU01，
SLMENU01，
NXTDSP01への挿入を想定しています。
一般の画面に適用できます。

BTPROT01
（COBOL）
（C言語）
表示されている画面に対して，ボタンを不活性状態に変更します。
BTMENU01，
SLMENU01，
GENDSP01，
NXTDSP01への挿入を想定しています。
一般の画面に適用できます。

帳票と書式オーバレイのアプリケーションプログラムのコーディングに利用するAPパターンを次の表に示します。

表D-2　APパターン（帳票，書式オーバレイ）

●APパターン

パターン名
（適用言語）
パターンの内容
パターンの使用ケース
使用する
定義サンプル

GENREP01
（COBOL）
（C言語）
汎用帳票出力プログラムです。1種類の帳票に対応した帳票出力処理を行います。

1帳票だけの印刷を想定しています。追加帳票は，部品NXTREP 01を追加して行います。

メニュープログラムを使用したメインメニューから呼ばれることを想定しています。

バッチ業務の帳票出力としても使用できます。

一般の帳票に適用できます。

GENREP02
（COBOL）
汎用帳票出力プログラムです。1種類の帳票に対応した帳票出力処理を，CALLインタフェースを利用して行います。

1帳票だけの印刷を想定しています。追加帳票は，同じくCALLインタフェースを使用しているGENREP03を追加して行います。

メニュープログラムを使用したメインメニューから呼ばれることを想定しています。

バッチ業務の帳票出力としても使用できます。

COBOLのCALLインタフェースを使用して帳票印刷を行うケースを想定しています。

一般の帳票に適用できます。

GENREP03
（COBOL）
GENREP02から呼び出されるサブプログラムです。
GENREP02との組み合わせを想定しています。
一般の帳票に適用できます。

GENOVL01
（COBOL）
（C言語）
汎用書式オーバレイ出力プログラムです。1種類の書式に対応した書式印刷処理を行います。

1書式だけの印刷を想定しています。

ヘッダ部，明細部，トレイラ部で構成される書式を印刷することを想定しています。なお，ヘッダ処理やトレイラ処理は，必要に応じて削除してください。

バッチ業務の書式出力として使用できます。
一般の書式オーバレイに適用できます。

●AP部品

パターン名
（適用言語）
パターンの内容
パターンの使用ケース
使用する
定義サンプル

NXTREP01
（COBOL）
（C言語）
帳票出力処理の追加コーディングです。
GENREP01，
DSPPRT01への挿入を想定しています。
一般の帳票に適用できます。

MODATR02
（COBOL）
（C言語）
特定フィールドの属性およびけい線の種別を変更します。
GENREP01，
DSPPRT01への挿入を想定しています。
一般の帳票に適用できます。

付録D.2　サンプルの入手方法

XMAP3では，レイアウトやコーディングのサンプルをサポートサービスで提供しています。このマニュアルの例題で作成する画面・帳票や，アプリケーションプログラムのコーディングなどもサンプルで提供しています。

サンプルは，サポートサービスのWebサイトからダウンロードして使用してください。

付録E　XMAP3 Version 5の機能一覧

XMAP3 Version 5の機能一覧を次の表に示します。

表E-1　XMAP3 Version 5の機能一覧

機能
XMAP3 Version 5

XMAP3 Developer
XMAP3 Server Runtime
XMAP3 Client Runtime
XMAP3 開発支援ユティリティ
XMAP3/Web for Cosminexus

ドロー
画面定義
（COBOL/C対応）
○
×
×
×
×

帳票定義
（COBOL/C対応）
○
×
×
×
×

書式定義
（言語制限なし）
○
×
×
×
×

テスト表示・印刷
×
○
○
×
×

ドローセットアップ
ターゲット環境の指定
○
×
×
×
×

上記以外
○
×
×
×
×

ユティリティ
コンバート
×
×
×
○
×

インポート※1（メインフレームのパネル定義文）
×
×
×
○
×

インポート（メインフレームまたはUNIXの書式記述文）
×
×
×
○
×

マップコンペア
×
×
×
○
×

支援ツール
マップ・書式生成
（Windows用）
○
×
×
×
×

マップ・書式生成
（UNIX用）
○
×
×
×
×

マップ生成（メインフレーム連携用）
○
×
×
×
×

環境ファイル操作
○
○
○
×
×

マップファイル操作
○
×
×
×
×

セットアップ情報反映
○
×
×
×
×

ポップアップメニューエディタ
○
×
×
×
×

画面・帳票・書式の定義サンプル
画面サンプル
×※2
×※2
×※2
×※2
○

帳票・書式サンプル
×※2
×※2
×※2
×※2
○

APサンプル
画面サンプル
×※2
×※2
×※2
×※2
○

帳票・書式サンプル
×※2
×※2
×※2
×※2
○

APパターン
COBOL用
○
×
×
×
×

C言語用
○
×
×
×
×

画面ハードコピー
×
○
○
×
○

ロギング支援
×
○
○
×
○

実行環境
セットアップ
画面表示
×
○
○
×
×

帳票印刷
×
○
○
×
×

AP環境
×
○
○
×
×

C/S構成
×
○
○
×
×

印刷拡張セットアップ
×
○
×※4
×
×

アプリケーションサーバ型C/S実行
×
○
○
×
×

Java言語用ツール※3
○
×
×
×
×

Cosminexus基盤のWeb連携
×
×
×
×
○

TP1/Web基盤のWeb連携
×
×
×
×
○

（凡例）

○：提供あり

×：提供なし

注※1

インポートとは，日立メインフレームで開発した画面・帳票を，XMAP3で利用できるように変換する機能です。

注※2

サンプルは，サポートサービスのWebサイトで提供されています。

注※3

Java言語用ツールとは，Cosminexus連携機能を使用する場合，Webアプリケーションに必要なファイルを生成する機能です。詳細については，マニュアル「XMAP3 開発ガイド」を参照してください。

注※4

XMAP3 Client 印刷拡張機能をインストールすると，XMAP3 Client Runtimeでも印刷拡張セットアップを使用できます。

付録F　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報を示します。

＜この節の構成＞

付録F.1　関連マニュアル

付録F.2　このマニュアルでの表記

付録F.3　KB（キロバイト）などの単位表記について

付録F.1　関連マニュアル

関連マニュアルを次に示します。必要に応じてお読みください。

XMAP3 Version 5

COBOL

COBOL2002 操作ガイド（3020-3-D41）

COBOL2002 ユーザーズガイド（3020-3-D42）

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

COBOL2002 言語 拡張仕様編（3020-3-D45）

COBOL2002 操作ガイド（3020-3-D47）

COBOL2002 ユーザーズガイド（3020-3-D48）

このマニュアルでのマニュアル名の表記

このマニュアルでは，XMAP3の関連マニュアルを次のように表記しています。

マニュアル名
表記

XMAP3 Version 5 画面・帳票サポートシステム
XMAP3 概説
XMAP3 概説

XMAP3 Version 5 画面・帳票サポートシステム
XMAP3 開発ガイド
XMAP3 開発ガイド

XMAP3 Version 5 画面・帳票サポートシステム
XMAP3 プログラミングガイド
XMAP3 プログラミングガイド

XMAP3 Version 5 画面・帳票サポートシステム
XMAP3 開発支援ユティリティ
XMAP3 開発支援ユティリティ

XMAP3 Version 5 画面・帳票サポートシステム
XMAP3 実行ガイド
XMAP3 実行ガイド

XMAP3 Version 5マニュアルの紹介

XMAP3 Version 5マニュアルの記載内容を次の表に示します。

XMAP3 Version 5のマニュアル | 記載内容の概略
XMAP3 概説 | 製品や機能の概要について説明しています。
XMAP3 開発ガイド | XMAP3 Developerの概要および開発環境の設定やマップ開発について説明しています。
XMAP3 プログラミングガイド | アプリケーションプログラムの概要および開発手順について説明しています。
XMAP3 開発支援ユティリティ | XMAP3 Developerでのマップ開発業務を拡張するための機能について説明しています。
XMAP3 実行ガイド | XMAP3 Server Runtime，XMAP3 Client Runtime，XMAP3/Web for Cosminexusの概要および実行環境の設定や実行手順について説明しています。

付録F.2　このマニュアルでの表記

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

表記
製品名

COBOL2002またはCOBOL
COBOL2002 Net Client Suite

COBOL2002 Net Client Runtime

COBOL2002 Net Developer

COBOL2002 Net Server Suite

COBOL2002 Net Server Runtime

Cosminexusアプリケーションサーバ
またはCosminexus
uCosminexus Application Server Standard

uCosminexus Application Server Enterprise

uCosminexus Application Service Platform

uCosminexus Application Architect

uCosminexus Developer Standard

uCosminexus Developer Professional

OpenTP1
TP1/Server
TP1/Server Base
uCosminexus TP1/Server Base

TP1/Server Base

TP1/LiNK
uCosminexus TP1/LiNK

TP1/LiNK

TP1/Client
TP1/Client/J
uCosminexus TP1/Client/J

TP1/Client/J

TP1/Client/P
uCosminexus TP1/Client/P

TP1/Client/P

TP1 Connector
uCosminexus TP1 Connector

TP1 Connector

TP1/Web
uCosminexus TP1/Web

TP1/Web

TP1/MCF
uCosminexus TP1/Message Control

TP1/Message Control

uCosminexus TP1/NET/Library

TP1/NET/Library

uCosminexus TP1/NET/XMAP3

TP1/NET/XMAP3

UNIX
AIX
AIX V6.1

HP-UX
HP-UX 11i V2(IPF)※

HP-UX 11i V3(IPF)※

VOS3
VOS3/AS

VOS3/FS

VOS3/LS

VOS3/US

XMAP3 Version 5，
または
XMAP3
XMAP3開発環境
XMAP3 Developer
XMAP3 Developer Version 5

XMAP3開発支援ユティリティ
XMAP3 Developer 開発支援ユティリティ Version 5

XMAP3実行環境
XMAP3 Server RuntimeまたはXMAP3サーバ実行環境
XMAP3 Server Runtime Version 5

XMAP3 Client RuntimeまたはXMAP3クライアント実行環境
XMAP3 Client Runtime Version 5

XMAP3 Web実行環境
XMAP3/Web for Cosminexus

XMAP3 Cosminexus連携
XMAP3/Web for CosminexusのCosminexus連携

XMAP3 TP1/Web連携
XMAP3/Web for CosminexusのTP1/Web連携

注※

IPFは，Itanium(R) Processor Familyの略称です。

付録F.3　KB（キロバイト）などの単位表記について

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

付録G　用語解説

英字｜ア行｜カ行｜サ行｜タ行｜ハ行｜マ行｜ラ行

英字

AP（Application Program）

業務プログラムのことです。XMAP3のAPは，画面・帳票の入出力処理を実行します。

APパターン・AP部品

APの定型的な型としてXMAP3が提供しているCOBOL用とC言語用のパターンです。APパターンは，プログラムの標準的な骨組みです。AP部品は，処理の手続きです。これらを組み合わせて利用すると，APを効率良く開発でき，定型的なコーディングの統一も図れます。

格納場所：

［Windows版］XMAP3インストールフォルダ¥PATTERNS¥COBOL（またはC）

［UNIX版］/opt/HIXMAP/patterns

C/Sシステム（Client / Server System）

サーバとクライアントで処理を分散する業務形態です。また，一つの処理をネットワーク上のサーバとクライアントで分担する機器構成モデル，または処理方式です。

C/Sセットアップ

WindowsサーバとWindowsクライアントに設定されたTCP/IPのホスト名，APで指定する仮想端末名，および表示・印刷サービス名など，XMAP3のC/S構成でのC/Sシステム環境を設定するファイルです。

C/Sセットアップは，Windows版XMAP3 Server Runtimeで提供します。

CPI（Character Per Inch）

文字間隔の単位で，25.4mm（1インチ）当たり何文字印字できるかを表します。例えば，10CPIは25.4mm（1インチ）当たりに10文字になります。

CSVファイル（Comma Separated Values）

データの区切りをコンマ（，）や改行で表すテキストデータを格納するファイルです。表計算ソフトで入力して，ユーザ独自の形式に編集できます。

CUI画面（Character User Interface）

キーボードからの文字入力が中心の画面です。従来のメインフレーム型オンライン業務か，キャラクタベースの業務で使用していた画面です。

XMAP3では，画面の入出力を物理マップと論理マップを使って実現しています。

ESC/Pスルー印刷，ESC/Pスルーモード（EPSON Standard Code for / Page printer）

シリアルプリンタ固有の印刷モードです。エプソン社のインパクト型ドットプリンタが該当します。

EUC（Extended UNIX Code）

UNIXで使用するマルチバイトコードです。

GUI画面（Graphical User Interface）

キーボードからの入力のほかに，マウスによる操作ができる画面です。Windowsの「ボタン」「スクロール」「プルダウン・カスケード」「ポップアップ」などが使用できます。XMAP3では，画面の入出力を物理マップと論理マップを使って実現しています。

Java言語用ツール

ドローおよびドローセットアップで生成されたC言語用のファイルから，Webアプリケーションに必要なファイル（入力/出力データ用XML文書，定数用XML文書および動的変更用XML文書）を生成する機能です。Java言語用ツールは，XMAP3 Developerで開発した画面・帳票をCosminexusアプリケーションサーバ上で実行させるWebシステム構成のAPを作成する場合に使用します。

Java言語用ツールは，XMAP3 Developerで提供します。

LIPSスルーモード（LBP Image Processing System）

ページプリンタ固有の印刷モードです。キヤノン社のページプリンタが該当します。LIPSには，LIPSII+，LIPSIII，LIPSⅣなどがあります。

LPI（Line Per Inch）

行の間隔の単位で，25.4mm（1インチ）当たり何行印字できるかを表します。XMAP3で「ます目の設定」を「自由な設定」にした場合，3，4，6，8，10，12LPIの中から選べます。例えば，8LPIは25.4mm（1インチ）当たりが8行になります。

OpenTP1

オープンシステム上でオンライントランザクション処理をするソフトウェア（TPモニタ）です。OpenTP1を使うと，分散システム化，オープンシステム化，さらに業務の拡大に柔軟に対応できます。トランザクションとは，データ通信業務で，業務処理ごとの単位に区切って，それぞれの処理の結果を有効にするか無効にするかを決定する処理の単位のことです。

PDF（Portable Document Format）

Adobe Acrobatが扱う文書のファイル形式で，特定のプラットフォームに依存しないで文書を表示できます。XMAP3では，ページプリンタ用帳票をPDFファイルに出力できます。

Windows対応プリンタ

Windows用にプリンタドライバが提供されているプリンタです。XMAP3では，GDIモードで印刷できるプリンタをWindows対応プリンタと呼びます。

ア行

アクセスキー

メニューバー，ポップアップメニュー（ポップアップメニューファイルを使用する場合も含める），およびプッシュボタンボックスで，候補の選択操作をするためのキーです。

これらのオブジェクトにフォーカスが位置づいているときにアクセスキーを押すと，該当するメニュー項目やボタンを選択できます。また，［Alt］+アクセスキーを押すと，メニューバーのメニュー項目を選択（プルダウンメニューを表示）できます。

網掛け帳票

240dpi/300dpiのページプリンタ用の帳票です。各種の文字サイズ，けい線，網掛けなどが使えます。

イベント通知コード

コマンドコントロールオブジェクト（プッシュボタン，メニューバー）や確定キー（PFキーなど）に割り当てるコードです。オブジェクトやキーを操作するとイベントが発生し，通知コードに対応づけた動作（AP通知など）が実行されます。これを「INC定数」といいます。また，入力単位がイベントのとき通知される「イベント定数」もあります。

イベント通知コードの値はドローセットアップで変更できます。動作はドローで変更できます。

印刷ドキュメント名

帳票印刷時，Windowsのプリンタスプールに登録されるXMAP3の印刷データのドキュメント名です。印刷ドキュメント名は帳票属性または書式属性として指定できます。また，帳票を印刷するときの出力論理マップ中にマップ帳票の印刷ドキュメント名を指定すると，APから動的に変更できます。この機能を利用すると，印刷した帳票の種別や内容を判別しやすくなり，帳票印刷業務でのリカバリ処理などを効率良く実行できます。

なお，帳票をPDFファイルに出力する場合，印刷ドキュメント名がPDFファイルのファイル名になります。

インポート

UNIXまたはメインフレームのシステムで作成したパネル定義文または書式記述文を入力し，Windows版のXMAP3で入力できる形式のマップ定義ファイルまたは書式定義ファイルに変換します。

インポートは，XMAP3 開発支援ユティリティで提供します。

カ行

画面属性

入力項目の扱いや表示形態などの画面全体に関する属性です。GUI画面では［画面属性］ダイアログで属性を指定します。また，画面属性はAP実行時に動的に変更することもできます。APから動的に変更するには，ドローセットアップの［表示属性の動的変更］で変更したい表示属性を定義します。ここで指定した修飾名を制御項目に代入することで，指定した表示属性に変更できます。

環境ファイル操作

バックアップファイル（.sbk）を使って，セットアップ内容などの各種の情報を保存・復元します。XMAP3の環境をほかのWindowsマシンに移行する場合などに使います。開発環境のバックアップファイルは開発環境に，実行環境のバックアップファイルは実行環境にリストアできます。

開発環境用の環境ファイル操作は，XMAP3 Developerで提供します。

実行環境用の環境ファイル操作は，XMAP3 Server Runtime または XMAP3 Client Runtimeで提供します。

行制御データファイル

書式オーバレイの使用時に，行データを印字する行の間隔，標準の文字サイズ，文字間隔などの情報を格納するファイルで，拡張子は.pciです。APでは，印刷するデータを1行（1レコード）ずつ出力し，1ページ分となった時点で書式がオーバレイされて印刷されます。

グラフィック帳票

240dpi／300dpiのページプリンタ用の帳票です。網掛け帳票の機能に加え，オブジェクトやけい線などのバリエーションなどをより豊富に備えていて，文字のカラー印刷にも対応しています。また，複数のデータ項目を扱えるバーコード（GS1-128）を使用できます。

サ行

ショートカットキー

メニューバーのメニュー項目の選択操作をするためのキーです。フォーカス・カーソルの位置に関係なく，［Ctrl］+半角英字1字を押すと該当するメニュー項目を選択できます。

なお，メニューバーのメニュー項目，またはカスケードメニューを持つプルダウンメニューにはショートカットキーを定義できません。

書式イメージファイル

書式オーバレイの文字列やけい線などの情報を格納するファイルで，拡張子は.fmpです。書式オーバレイの定義終了時に，行制御データファイルとともに生成されます。

書式オーバレイ

240dpi／300dpiのページプリンタ用の書式オーバレイです。定型帳票から書式（文字列やけい線などの固定項目）を分離し，アプリケーション（行データ）を印刷時に重ね合わせるソフトオーバレイ方式を採用しています。書式をプリンタ（ハードウェア側）に登録するメインフレーム環境の出力方式とは異なります。

書式定義ファイル

ドローで定義した書式の定義情報を格納したファイルで，拡張子は.ifmです。書式の定義終了時に生成され，書式イメージファイルと行制御データファイルはこの書式定義ファイルを基に生成されます。

タ行

定義体

画面や帳票のレイアウトに関する情報を格納した，物理マップ，書式イメージファイルおよび行制御データファイルの総称です。

動的変更テーブル

画面や帳票の実行時に色などの属性をAPから変更するときに，XMAP3が用意する属性変更用の定数テーブルの修飾名を表示属性の動的変更制御項目に代入します。

登録集原文

COBOLのプログラム中でよく利用される標準化した手続き，ファイル記述，レコード記述，または完全な一つのプログラムなどをコンパイルするプログラムと別のファイルに登録したものです。

ドロー

XMAP3の画面や帳票を定義するエディタです。画面や帳票のレイアウトや，各オブジェクトの属性を定義します。ドローで定義した内容を基に，マップ定義ファイル（書式オーバレイでは書式定義ファイル），物理マップと論理マップ（書式オーバレイでは行制御データファイルと書式イメージファイル）が作成されます。

ドローセットアップ

XMAP3の画面や帳票の定義に関する標準の値をカスタマイズする機能です。XMAP3にはセットアップ項目の標準値があり，この標準値を変更する場合や，動的変更で修飾名を追加したい場合にドローセットアップを実行します。セットアップ項目はマップの形式に関係しているので，画面や帳票を作成する前にドローセットアップを済ませておく必要があります。

ドローセットアップは，XMAP3 Developerで提供します。

ハ行

表示・印刷環境ファイル（X3PCONF／XPWconfig）

XMAP3での画面表示，および帳票印刷環境の設定ファイルです。表示・印刷環境ファイルの内容は，Windows版XMAP3の場合は表示・印刷セットアップで設定します。UNIX版XMAP3の場合は，テキストエディタで編集して設定します。

表示・印刷環境ファイルには，Windows版XMAP3の表示・印刷セットアップで設定できない項目があります。これらの項目は，直接ファイルをエディタで開いて編集します。なお，エディタでパラメタを設定した場合でも，表示・印刷セットアップで設定できる項目については，セットアップでの設定が優先されます。

表示・印刷環境ファイルは，XMAP3 Server Runtime，XMAP3 Client Runtime，XMAP3/Web for Cosminexusで提供します。

格納場所とファイル名：

［Windows版］

XMAP3 Server Runtime または XMAP3 Client Runtimeの場合
XMAP3インストールフォルダ¥ETC¥X3PCONF

XMAP3/Web for Cosminexus（XMAP3 Cosminexus連携機能）の場合
XMAP3インストールフォルダ¥Web for Cosminexus¥ETC¥X3PCONF

XMAP3/Web for Cosminexus（XMAP3 TP1/Web連携機能）の場合
XMAP3インストールフォルダ¥Web for TP1¥ETC¥X3PCONF

［UNIX版］

/etc/opt/HIXMAP/XPWconfig

表示・印刷セットアップ

XMAP3が表示・印刷する画面・帳票の環境を必要に応じて設定するための機能です。ユーザ画面の外観や操作キーの割り当て，プリンタの印刷モードなどの各種設定があります。

表示・印刷セットアップは，Windows版XMAP3 Server Runtime，Windows版 XMAP3 Client Runtime，Windows版 XMAP3/Web for Cosminexusで提供します。

表示属性

画面での，テキストやフィールドに出力する文字色やボタンの活性/不活性などを指定する属性，および帳票での，フィールドの文字の書体やけい線の種類などを指定する属性のことです。ドローでは，必要に応じて各ダイアログで変更できます。また，表示属性は定義上の指定のほかに，APから動的に変更できる属性もあります。APから動的に表示属性を変更するためには，ドローセットアップの動的変更を指定する修飾名で指定します。

フォーカス

GUI画面を表示した際，操作対象となるオブジェクトに表示される枠です。APから操作対象となるオブジェクトを選択することを，APからフォーカスを位置づける，といいます。

物理マップ

画面のオブジェクトの位置などを格納した情報ファイルです。ファイル名はマップ名にデバイスID（マップの定義対象を示す1文字または2文字の英数字）を付けた名前で，拡張子は.pmpです。画面の定義終了時に，論理マップとともに生成されます。ディスプレイやプリンタの入出力データを論理マップデータに変換したり，論理マップデータを入出力データに変換したりするときにXMAP3が参照します。

マ行

マッピングライブラリ

XMAP3実行環境のコンポーネントの一つです。マップを参照して画面表示や帳票印刷に必要なデータを生成します。

マップ

XMAP3では，画面や帳票の様式に関する情報をAPから切り離して，マップと呼ばれる入れ物に保管します。マップにはマップ定義ファイル，物理マップ，および論理マップがあります。

マップコンペア

物理マップファイル，書式イメージファイル，行制御データファイルをファイル単位またはフォルダ単位で比較します。ファイルの生成・更新日付，サイズ，内容について，違いを確認できます。

マップコンペアは，XMAP3 開発支援ユティリティで提供します。

マップ生成

マップ定義ファイルから，論理マップファイルと物理マップファイルを生成します。また，書式定義ファイルから書式イメージファイルと行制御データファイルを生成します。

マップ生成は，XMAP3 Developerで提供します。

マップ定義ファイル

ドローで定義した画面や帳票の定義情報であるソースマップを格納したファイルで，拡張子は.impです。画面・帳票の定義終了時に，論理マップとともに生成されます。物理マップと論理マップは，このマップ定義ファイルを基に生成されます。

ラ行

レイアウトパターン

ドローで画面／帳票を新規作成するときに，用途に応じて指定するパターンです。標準的なレイアウト領域のサイズやパターンなどがあらかじめ設定されていて，ドローでのレイアウト定義の基本フォーマットとなります。

XMAP3が標準提供しているレイアウトパターンのほかに，ユーザが独自に作成・登録することもできます。

連結出力バーコード

バーコードを印字するオブジェクトです。連結出力バーコードは，従来のJANコードなどのような単一データ（商品コードなど）をバーコードとして印字するオブジェクトに対して，複数データ（メーカーコード，支払い期限，支払い金額など）を一つのバーコードとして印字するオブジェクトです。データはAPから指定し，論理マップを介して帳票に印字します。このとき，一つのバーコードに対して複数の論理項目（分類項目）を使用します。

バーコードの種類には，GS1-128があります。GS1-128バーコードを印刷する場合は，300dpi（推奨は600dpi）以上のプリンタを使用してください。

ロギング支援

XMAP3のAP実行時に，ログ情報を採取してログファイルに出力したり，ログ情報を表示したりする機能です。ログ情報は，実行時に発生した問題解決に利用します。

ロギング支援は，XMAP3 Server RuntimeおよびXMAP3 Client Runtimeで提供します。

論理マップ

論理マップは，プログラムの可変データを格納する領域です。画面データの入出力や帳票データの出力時に，APがXMAP3に対するパラメタとして利用します。

COBOLでAPを開発する場合は，論理マップは登録集原文として生成され，COPY文でAPに取り込みます。APの実行時には，APに取り込まれた論理マップのデータ領域を介して，データがやり取りされます。ファイルの拡張子は，COBOLの場合は.cbl，C言語の場合は.hになります。

書式オーバレイ印刷の場合は，論理マップを使用しません。画面，帳票の物理マップに相当する書式イメージファイルと行制御データファイルを使用します。

索引

[記号]
[Ａ][Ｃ][Ｅ][Ｇ][Ｊ][Ｌ][Ｏ][Ｐ][Ｒ][Ｓ][Ｔ][Ｗ][Ｘ]
[ア行][カ行][サ行][タ行][ナ行][ハ行][マ行][ラ行]

(記号)

-Comp5

-JPN,Alnum

-XMAP,LinePrint

(英字)

(Ａ)

AP〔用語解説〕

APPLY FORMS-OVERLAY句

APサンプル

APパターン

APパターン・AP部品〔用語解説〕

APパターン（画面）

APパターン（帳票，書式オーバレイ）

APパターン一覧

AP部品

(Ｃ)

C/Sシステム〔用語解説〕

C/Sセットアップ〔用語解説〕

CALL文

COPY文〔画面〕

COPY文〔帳票〕

CPI〔用語解説〕

CSVファイル〔用語解説〕

CUI画面

CUI画面〔用語解説〕

CUI画面定義ウィンドウ

CUI画面定義ウィンドウのツールバー

CUI画面定義ウィンドウのツールボックス

CUI画面の例題

(Ｅ)

ESC/Pスルー印刷〔用語解説〕

ESC/Pスルーモード〔用語解説〕

EUC〔用語解説〕

(Ｇ)

GUI画面

GUI画面〔用語解説〕

GUI画面定義ウィンドウ

GUI画面定義ウィンドウの構成

GUI画面定義ウィンドウのツールバー

GUI画面定義ウィンドウのツールボックス

GUI画面の例題

(Ｊ)

Java言語用ツール〔用語解説〕

(Ｌ)

LIPSスルーモード〔用語解説〕

LPI〔用語解説〕

(Ｏ)

OpenTP1〔用語解説〕

(Ｐ)

PDF〔用語解説〕

(Ｒ)

RECEIVE文

(Ｓ)

SEND文〔画面〕

SEND文〔帳票〕

(Ｔ)

TRANSCEIVE文

(Ｗ)

Windows対応プリンタ〔用語解説〕

WRITE文

(Ｘ)

X3dmain.exe

XMAP3

XMAP3/Web for Cosminexus

XMAP3 Client Runtime

XMAP3 Client 印刷拡張機能 ,[2]

XMAP3 Developer

XMAP3 Server Runtime

XMAP3 Version 5の機能一覧

XMAP3 開発支援ユティリティ

XMAP3でできること

XMAP3と連携するためのコンパイラオプション

XMAP3のドローの基本操作

XMAP3を終了

(ア行)

(あ)

アクセスキー〔用語解説〕

網掛け帳票〔用語解説〕

網掛けパターンの変更

アンインストール

(い)

移動する

イベント通知コード〔用語解説〕

印刷色を調整する

印刷ドキュメント名〔用語解説〕

インストール

インストール時のトラブル

インストールする前に

インストールの操作方法

インタフェース領域

インポート〔用語解説〕

(う)

ウィンドウの構成

(お)

同じ種類のオブジェクトを連続して配置する

オブジェクトの配置

オブジェクトの配置操作を中止する

オブジェクト配置時に反復して定義する

オブジェクトをコピーする

オブジェクトを削除する

(カ行)

(か)

カーソルキーによる移動操作

カーソルを最後に位置づける

カーソルを先頭に位置づける

重なっているオブジェクトを選択する

画面属性〔用語解説〕

画面の例題

環境ファイル操作

環境ファイル操作〔用語解説〕

(き)

キーだけを使った操作

キーで選択できるポップアップメニュー

キーとマウスを使った操作

起動

機能拡張キー

行制御データファイル〔用語解説〕

行データ

業務開発の流れ

切り取る

(く)

グラフィック帳票〔用語解説〕

グループボックスの枠の削除

グループを解除する

(こ)

コーディング〔画面〕

コーディング〔書式〕

コーディング〔帳票〕

コーディングのポイント〔画面〕

コーディングのポイント〔書式〕

コーディングのポイント〔帳票〕

コピーする

コンパイル

コンパイル時の主なエラー

コンパイル時のトラブル

コンパイルするためのフォルダ

コンパイルと実行の手順

コンパイルの準備

(サ行)

(さ)

サイズを変更する

削除する

作成されるファイル〔CUI画面の作成〕

作成されるファイル〔GUI画面の作成〕

作成されるファイル〔書式の作成〕

作成されるファイル〔帳票の作成〕

サンプルを利用してコーディングする

(し)

システム構成

実行

実行時の主なエラー

実行時のトラブル

実行の準備

自動生成されるファイル

終了

受注データ入力プログラム

出力論理マップ名

準備

使用するファイル一覧〔画面〕

使用するファイル一覧〔帳票〕

ショートカットキー〔用語解説〕

書式イメージファイル〔用語解説〕

書式オーバレイ〔用語解説〕

書式オーバレイの例題

書式定義ウィンドウ

書式定義ウィンドウのツールバー

書式定義ウィンドウのツールボックス

書式定義ファイル〔用語解説〕

(す)

スケール配置モード

ステータスバー

スプラッシュ画面

(せ)

製品体系

製品の位置づけ

線種・太さの変更

選択する

(タ行)

(た)

ダイアログを呼び出す

タイトルバー

(ち)

帳票定義ウィンドウ

帳票定義ウィンドウのツールバー

帳票定義ウィンドウのツールボックス

帳票の例題

(つ)

ツールバー

ツールボックス

(て)

定義体〔用語解説〕

定義の基本手順

提供されているアプリケーションプログラムサンプル〔画面〕

提供されているアプリケーションプログラムサンプル〔書式〕

提供されているアプリケーションプログラムサンプル〔帳票〕

データ長のカスタマイズ

データ名

テスト表示／印刷時のトラブル

(と)

動的変更テーブル

動的変更テーブル〔用語解説〕

登録集原文

登録集原文〔用語解説〕

ドロー〔用語解説〕

ドローセットアップ

ドローセットアップ〔用語解説〕

ドローのコマンド起動

ドローをセットアップします

(ナ行)

(に)

入力論理マップ名

(の)

納品伝票印刷プログラム（書式オーバレイ）

納品伝票印刷プログラム（帳票）

(ハ行)

(は)

ハードコピー ,[2]

配置モードの切り替え

貼り付ける

(ひ)

表示・印刷環境ファイル（X3PCONF／XPWconfig）〔用語解説〕

表示・印刷セットアップ〔用語解説〕

表示属性〔用語解説〕

(ふ)

フォーカス〔用語解説〕

フォーカスの移動順序

物理マップ〔用語解説〕

物理マップ名〔画面〕

物理マップ名〔帳票〕

(ほ)

ボタン順序の変更

(マ行)

(ま)

ます目配置モード

マッピングライブラリ〔用語解説〕

マップ〔用語解説〕

マップコンペア〔用語解説〕

マップ生成〔用語解説〕

マップ定義ファイル

マップ定義ファイル〔用語解説〕

(め)

メニューバー

(も)

文字色・背景色の変更

文字属性・枠高の変更

文字を確定する

文字を削除する

元に戻す

(ラ行)

(り)

リンケージ時の主なエラー

(れ)

レイアウト定義

レイアウト定義時のトラブル

レイアウト定義でのキー操作

レイアウト定義の基本操作

レイアウトパターン

レイアウトパターン〔用語解説〕

レイアウト部品

レイアウト部品の配置

レイアウト領域

レイアウトを定義するウィンドウ

レイアウトを定義する手順

例題

例題で使用するファイル一覧

例題プログラムに使用するファイル（CUI画面）

例題プログラムに使用するファイル（GUI画面）

例題プログラムに使用するファイル（書式オーバレイ印刷）

例題プログラムに使用するファイル（帳票）

例題プログラムの作成手順

連結出力バーコード〔用語解説〕

(ろ)

ロギング支援 ,[2]

ロギング支援〔用語解説〕

論理マップ〔用語解説〕

■ 商標類

Acrobatは，Adobe Systems Incorporated(アドビシステムズ社)の商標です。
ActiveXは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Adobe，およびReaderは，Adobe Systems Incorporated(アドビシステムズ社)の米国ならびに他の国における商標または登録商標です。
AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
DOS/V は，日本アイ・ビー・エム（株）の商品名称です。
ESC/Pは，セイコーエプソン(株)の商標です。
HP-UXは，Hewlett-Packard Development Company,L.P.のオペレーティングシステムの名称です。
Hyper-Vは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
InstallShieldは，Macrovision Corporationの米国および/ または他の国における登録商標または商標です。
Internet Explorerは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
LIPSは，キヤノン(株)が開発した言語仕様です。
LIPSII+は，キヤノン(株)が開発した言語仕様です。
LIPSIIIは，キヤノン(株)が開発した言語仕様です。
LIPSIVcは，キヤノン(株)が開発した言語仕様です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Microsoft .NETは，お客様，情報，システムおよびデバイスを繋ぐソフトウェアです。
Microsoft Internet Information Servicesは，米国Microsoft Corporationの商品名称です。
Microsoft OfficeおよびExcelは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
Visual C++は，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
その他記載の会社名，製品名は，それぞれの会社の商標もしくは登録商標です。