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

入門書

3020-7-592-50

目　　次

前書き

変更内容

はじめに

第1編　紹介編

1.　XMAP3を紹介します

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

1.2　XMAP3の機能について紹介します

1.2.1　画面機能を紹介します

1.2.2　帳票機能を紹介します

1.2.3　開発環境の紹介

1.2.4　実行環境の紹介

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

1.4　画面・帳票定義とアプリケーションプログラムの関係について紹介します

1.5　アプリケーションプログラムインタフェースの概要について紹介します

1.6　アプリケーションプログラム作成の概要について紹介します

1.7　WSの分散開発と分散実行について紹介します

1.8　メインフレームの分散開発と分散実行について紹介します

1.9　開発環境・実行環境の配布について紹介します

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.2.1　COBOL2002またはCOBOL85をインストールします

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

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

4.2.4　APパターンをCOBOLエディタのテンプレートに登録します（COBOL85 Version 5.0の場合）

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

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

4.3.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　コンパイルします（COBOL2002，COBOL85 Version 7，およびVersion 6の場合）

12.2.3　実行します（COBOL2002，COBOL85 Version 7，およびVersion 6の場合）

12.2.4　コンパイルします（COBOL85 Version 5.0の場合）

12.2.5　実行します（COBOL85 Version 5.0の場合）

付録

付録A　例題プログラムの論理マップ

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

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

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

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

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

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

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

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

付録D　Visual Basic，Access，およびDelphiでのアプリケーションプログラムのコーディング例

付録D.1　例題の概要

付録D.2　Visual BasicおよびAccessでのアプリケーションプログラムのコーディング例

付録D.3　Delphiでのアプリケーションプログラムのコーディング例

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

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

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

付録F.2　画面・帳票の定義サンプル

付録F.3　提供APサンプル

付録G　XMAP3シリーズの提供機能一覧

付録H　用語解説

索引

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

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

前書き

■ 対象製品

P-262B-5344　 XMAP3/NET Version 4　 04-06 (適用OS：Windows 95，Windows 98，Windows Me，Windows NT 4.0，Windows 2000，Windows XP，Windows Server 2003)＊
P-262B-534U　 XMAP3/NET Version 4 Upgrade　 04-06 (適用OS：Windows 95，Windows 98，Windows Me，Windows NT 4.0，Windows 2000，Windows XP，Windows Server 2003)＊
P-262B-5744　 XMAP3/REPORT3 Version 4　 04-06 (適用OS：Windows 95，Windows 98，Windows Me，Windows NT 4.0，Windows 2000，Windows XP，Windows Server 2003)＊
P-262B-574U　 XMAP3/REPORT3 Version 4 Upgrade　 04-06 (適用OS：Windows 95，Windows 98，Windows Me，Windows NT 4.0，Windows 2000，Windows XP，Windows Server 2003)＊
P-262B-5C44　 XMAP3/Enterprise Edition Version 4　 04-06 (適用OS：Windows 95，Windows 98，Windows Me，Windows NT 4.0，Windows 2000，Windows XP，Windows Server 2003)＊
P-262B-5C4U　 XMAP3/Enterprise Edition Version 4 Upgrade　 04-06 (適用OS：Windows 95，Windows 98，Windows Me，Windows NT 4.0，Windows 2000，Windows XP，Windows Server 2003)＊
P-262B-5F44　 XMAP3/Web Version 4　 04-06 (適用OS：Windows NT Server 4.0，Windows 2000 Professional，Windows 2000 Server, Windows 2000 Advanced Server, Windows XP Professional，Windows Server 2003)＊
P-262B-5Q44　 XMAP3/Web for Cosminexus　 04-06（適用OS：Windows 2000 Advanced Server，Windows 2000 Datacenter Server，Windows 2000 Server，Windows Server 2003）

＊印の製品は，ISO9001およびTickITの認証を受けた品質マネジメントシステムで開発されました。

■ 輸出時の注意

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

■ 商標類

Acrobatは，Adobe Systems Incorporated（アドビシステムズ社）の商標です。

Adobeは，Adobe Systems Incorporated（アドビシステムズ社）の商標です。

AIXは，米国における米国International Business Machines Corp.の登録商標です。

AXは，AX協議会のシステム名称です。

BackOfficeは，米国Microsoft Corp.の登録商標です。

Delphiは，米国Borland International,Inc.の登録商標です。

ESC/Pは，セイコーエプソン(株)の商標です。

HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。

InstallShield(R)は，InstallShield Software Corporationのサービスマーク及び登録商標です。

Itaniumは，アメリカ合衆国および他の国におけるインテル コーポレーションまたはその子会社の登録商標です。

Java及びすべてのJava関連の商標及びロゴは，米国及びその他の国における米国Sun Microsystems,Inc.の商標または登録商標です。

Linuxは，Linus Torvaldsの米国およびその他の国における登録商標あるいは商標です。

LIPSは，キヤノン(株)が開発した言語仕様です。

Microsoftは，米国およびその他の国における米国Microsoft Corp.の登録商標です。

Microsoft Accessは，米国およびその他の国における米国Microsoft Corp.の登録商標です。

Microsoft Internet Explorerは，米国Microsoft Corp.の商品名称です。

Microsoft Internet Information Servicesは，米国Microsoft Corp.の商品名称です。

MS-DOSは，米国およびその他の国における米国Microsoft Corp.の登録商標です。

PC-9800は，日本電気(株)の商品名称です。

Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標若しくは商標です。

Solarisは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。

TurboLinuxの名称及びロゴは，TurboLinux, Inc.の商標です。

UNIXは，X/Open Company Limitedが独占的にライセンスしている米国ならびに他の国における登録商標です。

Visual Basicは，米国およびその他の国における米国Microsoft Corp.の登録商標です。

Windowsは，米国およびその他の国における米国Microsoft Corp.の登録商標です。

Windows NTは，米国およびその他の国における米国Microsoft Corp.の登録商標です。

Windows Serverは，米国およびその他の国における米国Microsoft Corp.の商標です。

■ 発行

2001年 4月 (第１版) 3020-7-592
2004年10月 (第6版) 3020-7-592-50

■ 著作権

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

変更内容

変更内容(3020-7-592-50)　XMAP3 Version 4 04-06

追加・変更機能 | 変更個所
XMAP3/Web for Cosminexusを追加した。 | 1.1，1.2.4，1.3
Windowsクラスタ構成での実行に対応した。 | 1.2.4

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

変更内容(3020-7-592-40)　XMAP3 Version 4 04-05

追加・変更機能

Windows Server 2003に対応した。

変更内容(3020-7-592-30)　XMAP3 Version 4 04-04

追加・変更機能

プリンタスプールに登録される印刷データに任意のドキュメント名を指定できるようにした。

ページプリンタ用の帳票をPDFファイル形式で出力できるようにした。

COBOL2002に対応した。

表示・印刷セットアップで，挿入キーの動作設定時，挿入/上書きモードの初期状態を設定できるようにした。

XMAP3 Version 4 04-03

追加・変更機能

グラフィック帳票で連結出力バーコードを使用できるようにした。

変更内容(3020-7-592-20)　XMAP3 Version 4 04-02

追加・変更機能

グラフィック帳票の文字カラー印刷機能を追加した。

Windowsターミナルサービスを利用した開発機能を追加した。

適用OSにWindows XPを追加した。

プレプリント帳票，グラフィック帳票，書式オーバレイでのカーソルキーによるオブジェクトの移動機能を追加した。

日立COBOL85 Version 7に対応した。

はじめに

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

P-262B-5344　XMAP3/NET Version 4

P-262B-534U　XMAP3/NET Version 4 Upgrade

P-262B-5744　XMAP3/REPORT3 Version 4

P-262B-574U　XMAP3/REPORT3 Version 4 Upgrade

P-262B-5C44　XMAP3/Enterprise Edition Version 4

P-262B-5C4U　XMAP3/Enterprise Edition Version 4 Upgrade

P-262B-5F44　XMAP3/Web Version 4

P-262B-5Q44　XMAP3/Web for Cosminexus

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

対象読者

COBOLの知識を持ち，Windowsの基本操作を理解している方で，XMAP3を初めて使用する方を対象としています。

マニュアルの構成

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

第1編　紹介編

第１章　XMAP3を紹介します

XMAP3の機能や特長について説明しています。また，XMAP3を使った業務開発の流れを説明しています。

第２章　XMAP3を理解しましょう

XMAP3のインストールから，XMAP3の基本的な操作，XMAP3のウィンドウ構成について説明しています。また，XMAP3の大まかな流れについて説明しています。

第２編　準備編

第３章　例題プログラムを紹介します

このマニュアルで扱っている例題プログラムの内容について説明しています。なお，このマニュアルでは，画面用，帳票用，書式オーバレイ用の３本のアプリケーションプログラムの作成手順を紹介しています。

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

XMAP3を使ってプログラムの作成を始める前に，知っておいた方がよいアプリケーションプログラムの作成方法について説明しています。

第３編　画面編

第５章　GUI画面を作成しましょう

画面用例題プログラムで使用するGUI画面の作成方法を説明しています。

第６章　CUI画面を作成しましょう

画面用例題プログラムで使用するCUI画面の作成方法を説明しています。

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

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

第４編　帳票編

第8章　帳票を作成しましょう

帳票用例題プログラムで使用する帳票の作成方法を説明しています。

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

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

第５編　書式オーバレイ編

第10章　書式を作成しましょう

書式用例題プログラムで使用する書式の作成方法を説明しています。

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

書式オーバレイ用アプリケーションプログラムのコーディングについて説明しています。

第６編　コンパイル，実行編

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

作成したアプリケーションプログラムのコンパイルと実行の操作方法を説明しています。

付録A　例題プログラムの論理マップ

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

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

付録D　Visual Basic，Access，およびDelphiでのアプリケーションプログラムのコーディング例

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

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

付録G　XMAP3シリーズの提供機能一覧

付録H　用語解説

マニュアル体系

XMAP3のマニュアル体系を次に示します。

関連マニュアル

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

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

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

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

画面・帳票サポートシステム　XMAP3　メインフレーム連携ガイド（3020-7-595）

画面・帳票サポートシステム　XMAP3/Web（3020-7-596）

画面・帳票サポートシステム　XMAP3/Web for Cosminexus（3020-7-597）

画面・帳票サポートシステム　XMAP3 Server（3000-7-508）

COBOL85　言語（3020-3-782）

COBOL85　操作ガイド（3020-3-851）※

COBOL85　ユーザーズガイド（3020-3-852）

COBOL85　操作ガイド（3020-3-873）

COBOL2002　操作ガイド（3020-3-D41）

COBOL2002　ユーザーズガイド（3020-3-D42）

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

COBOL2002　言語　拡張仕様編（3020-3-D45）

注※　COBOL85　Version 5.0の場合にお読みください。

このマニュアルでの表記

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

製品名称
略称

AIX 5L V5.1
AIX 5L V5.2
AIX

Cosminexus Application Server Standard Version 6
Cosminexus Application Server Enterprise Version 6
Cosminexus Application Server
Cosminexus

Cosminexus Developer Light Version 6
Cosminexus Developer Standard Version 6
Cosminexus Developer Professional Version 6
Cosminexus Developer

HP-UX 10.20
HP-UX 11
HP-UX 11i
HP-UX 11i V2.0（IPF）
HP-UX

Java(TM)
Java

JP1/Network Printing System
JP1/NPS

Microsoft Access(R)
Access

Microsoft(R) Internet Explorer
Internet Explorer

Microsoft(R) Internet Information Services 5.0
IIS

Microsoft(R) Windows(R) 95 Operating System
Windows 95

Microsoft(R) Windows(R) 98 Operating System
Windows 98

Microsoft(R) Windows(R) Millennium Edition Operating System
Windows Me

Microsoft(R) BackOffice(R) Small Business Server Version 4.0
Windows NT Server 4.0
Windows NT 4.0

Microsoft(R) Windows NT(R) Server, Enterprise Edition Version 4.0

Microsoft(R) Windows NT(R) Server Network Operating System Version 4.0

Microsoft(R) Windows NT(R) Workstation Operating System Version 4.0
Windows NT
Workstation 4.0

Microsoft(R) Windows(R) 2000 Advanced Server Operating System
Windows 2000
Advanced Server
Windows 2000

Microsoft(R) Windows(R) 2000 Datacenter Server Operating System
Windows 2000
Datacenter Server

Microsoft(R) Windows(R) 2000 Professional Operating System
Windows 2000
Professional

Microsoft(R) Windows(R) 2000 Server Operating System
Windows 2000 Server

Microsoft(R) Windows(R) XP Home Edition Operating System
Windows XP
Home Edition
Windows XP

Microsoft(R) Windows(R) XP Professional Operating System
Windows XP
Professional

Microsoft(R) Windows Server(TM) 2003, Enterprise Edition
Windows Server 2003,
Enterprise
Windows Server 2003

Microsoft(R) Windows Server(TM) 2003, Standard Edition
Windows Server 2003,
Standard

Microsoft(R) MS-DOS(R) Version 5.0/V以降
MS-DOS

Solaris 7
Solaris 8
Solaris 9
Solaris

TP1/Message Control
TP1/MCF

TP1/NET/Library

TP1/NET/XMAP3

TurboLinux Server 日本語版 6.1
Red Hat Linux 6.2J
Linux

Microsoft(R) Visual Basic(R)
Visual Basic(またはVB)

XMAP3/Enterprise Edition Version 4
XMAP3/Enterprise Edition

XMAP3/NET Version 4
XMAP3/NET

XMAP3/REPORT3 Version 4
XMAP3/REPORT3

XMAP3/Web Version 4
XMAP3/Web

このマニュアルでは，Windows 95，Windows 98，Windows Me，Windows NT 4.0，Windows 2000，Windows XP，およびWindows Server 2003で機能差がない場合，Windowsと表記します。

このマニュアルでは，AIX，HP-UX，Solaris，およびLinuxで機能差がない場合，WSと表記します。

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

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

略称 | 正式名称
C/Sシステム | Client / Server System
CSV | Comma Separated Values
CUI | Character User Interface
EUC | Extended UNIX Code
GDI | Graphical Device Interface
GUI | Graphical User Interface
HTML | Hyper Text Markup Language
IPF | Itanium(R) Processor Family
LAN | Local Area Network
OLTP | Online Transaction Processing
OS | Operating System
PC | Personal Computer
PDF | Portable Document Format
PDL | Page Description Language
MSCS | Microsoft Cluster Server
Web | World Wide Web
WS | Work Station

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

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

記号
意味

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

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

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

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

図中で使用する記号

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

オンラインヘルプの紹介

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

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

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

個所（かしょ）　　矩形（くけい）　　貼り付け（はりつけ）　　汎用（はんよう）

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

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

1.　XMAP3を紹介します

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

この章では，XMAP3の特長，業務開発の流れ，アプリケーションプログラムの仕組みなどを紹介します。

＜この章の構成＞

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

1.2　XMAP3の機能について紹介します

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

1.4　画面・帳票定義とアプリケーションプログラムの関係について紹介します

1.5　アプリケーションプログラムインタフェースの概要について紹介します

1.6　アプリケーションプログラム作成の概要について紹介します

1.7　WSの分散開発と分散実行について紹介します

1.8　メインフレームの分散開発と分散実行について紹介します

1.9　開発環境・実行環境の配布について紹介します

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

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

XMAP3では，表現力の豊かな画面・帳票を，さまざまな環境で簡単に作成するための開発環境を提供しています。また，スタンドアロンはもちろん，バッチシステム，C/Sシステム，Webシステム（PC/Webサーバ利用），OLTP，メインフレーム（VOSシリーズ）との連携など，さまざまな環境で利用できる実行環境を提供しています。

開発環境は，次に示す三つのプログラムプロダクトを提供しています。

XMAP3/REPORT3 Version 4

XMAP3/NET Version 4

XMAP3/Enterprise Edition Version 4

また，XMAP3での，各製品の位置づけを図1-1に示します。

図1-1　製品の位置づけ

実行環境は，それぞれの開発環境に対応する三つのランタイムシステムを提供しています。

XMAP3/REPORT3 Run Time System Version 4

XMAP3/NET Run Time System Version 4

XMAP3/Enterprise Edition Run Time System Version 4

さらに，Webブラウザ上に画面を表示させたり，帳票を印刷したりするための実行環境として，次のプログラムプロダクトも提供しています。

XMAP3/Web Version 4

XMAP3/Web for Cosminexus

＜この節の構成＞

(1)　XMAP3/REPORT3：帳票機能

(2)　XMAP3/NET：画面・帳票／ネットワーク機能

(3)　XMAP3/Enterprise Edition：画面・帳票／WS分散開発／メインフレーム連携機能

(4)　XMAP3/Web：Web連携機能

(5)　XMAP3/Web for Cosminexus：Cosminexus連携機能

(1)　XMAP3/REPORT3：帳票機能

帳票および書式の設計と，帳票および書式を使用するアプリケーションプログラムの開発環境を提供します。単独のPC上で業務処理を行う，スタンドアロン構成の業務の開発を対象としています。

帳票機能の詳細については，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　帳票編」を参照してください。

(2)　XMAP3/NET：画面・帳票／ネットワーク機能

画面，帳票，および書式の設計と，これらを使用するアプリケーションプログラムの開発環境を提供します。クライアントPCとサーバPCをLANで接続して共通の業務処理を行う，C/Sシステム構成の業務の開発を対象にしています。

また，日立の分散トランザクションマネージャ「OpenTP1」を利用した，オンライントランザクション処理（OLTP）のシステム構成が利用できます。

さらに，画面・帳票の保守機能を出力するドキュメンテーション支援，環境ファイルのバックアップ・リストアなどのユティリティ機能，画面ハードコピー採取機能なども提供しています。

画面・帳票の機能については，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　画面編」，またはマニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　帳票編」を参照してください。また，C/Sシステム構成，OLTP構成，およびその他ユティリティ機能については，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

(3)　XMAP3/Enterprise Edition：画面・帳票／WS分散開発／メインフレーム連携機能

XMAP3/Enterprise Editionは，XMAP3/NETの機能に加えて，メインフレームとPCとを接続したシステム環境で，画面や帳票を作成したり，実行したりできます。この機能をメインフレーム連携機能といい，次のような環境を提供しています。

メインフレームとPCを分散して画面・帳票を利用するアプリケーションの開発環境と実行環境を提供します。メインフレーム上でアプリケーションプログラムを実行させ，マッピング処理をPCに分散させる環境を提供します。

PCをメインフレームの定義ツールとして利用するための環境を提供します。PCでメインフレーム用のパネル定義文を生成します。

WS用の画面・帳票の開発環境を提供します。PCでWS用の論理マップや物理マップを生成します。

メインフレームとPCとで処理を分散させて実行または開発したい業務を対象にしています。

メインフレーム連携機能については，マニュアル「画面・帳票サポートシステム XMAP3　メインフレーム連携ガイド」を参照してください。また，WS用のマップ生成については，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

(4)　XMAP3/Web：Web連携機能

XMAP3/Webは，従来のC/Sシステムで利用していたクライアント側の画面をWebブラウザ上に表示したり，帳票を出力したりするための環境を提供します。XMAP3/Webが動作するユーザアプリケーションプログラムは，TP1/Webの環境下で動作します。また，XMAP3/Webで使用できるWebブラウザは，Internet Explorer 5.0以降となります。

クライアント側のメンテナンス作業を軽減させたい，XMAP3の画面をWebブラウザに表示させたい業務を対象にしています。

詳しくは，マニュアル「画面・帳票サポートシステム XMAP3/Web」を参照してください。

(5)　XMAP3/Web for Cosminexus：Cosminexus連携機能

XMAP3で開発した画面および帳票は，Cosminexusと連携したシステムでも使用できます。XMAP3/Web for Cosminexusでは，Cosminexusアプリケーションサーバと連携して，XMAP3で開発した画面をWebブラウザ上に表示したり，帳票を出力したりするための環境を提供します。クライアント側のメンテナンス作業を軽減させたい，XMAP3の画面をWebブラウザに表示させたい業務を対象にしています。

Cosminexus連携機能を使用する場合，サーバ側では，アプリケーションサーバにCosminexus Application Serverを，WebサーバにHitachi Web ServerまたはIISを使用します。また，クライアント側では，WebブラウザにInternet Explorer 5.5またはInternet Explorer 6.0を使用します。

詳しくは，マニュアル「画面・帳票サポートシステム XMAP3/Web for Cosminexus」を参照してください。

1.2　XMAP3の機能について紹介します

XMAP3では，表現力の豊かな画面・帳票を，さまざまな環境で簡単に作成できます。

画面は，マルチウィンドウに対応しています。また，グラフやボタン，スクロールバー付きの明細表などを画面に表示できます。

帳票は，ビジネスに必要なバーコード，OCR文字印刷をはじめ，マルチフォントやイメージデータの印刷ができます。また，PDFファイルへの出力にも対応しています。

画面や帳票を利用したアプリケーションプログラムの作成には，COBOLやC言語を利用できます。特に帳票を利用したアプリケーションプログラムは，Visual BasicやAccess，Delphiなどでも作成できます。

ここで説明する機能概要のほか，さらにXMAP3でどのようなことができるかを知りたい方は，「付録B　XMAP3ではこんなこともできます 」を参照してください。

＜この節の構成＞

1.2.1　画面機能を紹介します

1.2.2　帳票機能を紹介します

1.2.3　開発環境の紹介

1.2.4　実行環境の紹介

1.2.1　画面機能を紹介します

XMAP3の画面機能は，GUI画面およびCUI画面の作成と，これらを使用したアプリケーションプログラムの開発を支援します。

GUI画面とは，ウィンドウに表示されるメニューやボタンを，マウスやキーボードを使って操作したりデータ入力したりする画面をいいます。これに対してCUI画面とは，従来のメインフレームやオフィスコンピュータで使用されていたような文字ベースの画面をいいます。

＜この項の構成＞

(1)　こんな画面が作れます

(2)　こんな操作ができます

(3)　画面を先に確定できます

(1)　こんな画面が作れます

XMAP3ではグラフやイメージデータを表示したGUI画面を作成できます。例えば，ボタンに任意のビットマップデータを貼り付けられます。また，GUI画面の中に従来のCUI画面を取り込み，明細表をスクロールして参照するようなGUI画面も作成できます。なお，従来のオンライン端末と同様のCUI画面も作成できます。XMAP3で作成したGUI画面の例を，図1-2に示します。

図1-2　XMAP3で作成したGUI画面の例

(2)　こんな操作ができます

XMAP3では，電卓のように右側から数字が現れる入力フィールドや，日付や時刻の入力をチェックするフィールドなど，操作性の良いオブジェクトを用意しています。また，GUI画面では，マウスでの操作のほかに，キーボードを中心とした操作ができます。このように，従来のCUI画面と同じような操作でGUI画面を扱えます。

(3)　画面を先に確定できます

GUI画面のイベント処理はXMAP3が吸収しています。このため，COBOLの知識で画面単位の入出力ができます。また，画面のレイアウト情報はアプリケーションプログラムとは別のファイルで管理されているため，画面のレイアウトを変更してもアプリケーションプログラムを変更する必要がありません。このように，画面を先に確定してから業務を開発できます。

1.2.2　帳票機能を紹介します

XMAP3の帳票機能は，シリアルインパクトプリンタおよびページプリンタ用の帳票，書式の作成と，これらを使用したアプリケーションプログラムの開発を支援します。

＜この項の構成＞

(1)　こんな帳票が作れます

(2)　各種APインタフェースに対応しています

(3)　プリンタの特性を生かしたきめ細かい印刷ができます

(4)　FAXに帳票を出力できます

(5)　帳票管理システムと連携できます

(6)　電子帳票システムを構築できます

(1)　こんな帳票が作れます

XMAP3では，バーコード，OCR文字などを使用した帳票を作成できます。また，さまざまなフォントに対応し，網掛けやけい線の種類も豊富なため，ビジネスに適した帳票が作れます。さらに，グラフやイメージデータを印刷できるので，わかりやすく見栄えの良い帳票を利用できます。作成したグラフィック帳票の文字をカラー印刷することもできます。XMAP3で作成した帳票の例を，図1-3に示します。

図1-3　XMAP3で作成した帳票の例

(2)　各種APインタフェースに対応しています

アプリケーションプログラムからは，ページまたは行単位のインタフェースでデータを渡すことができます。書式の部分はアプリケーションプログラムとは関係なく設計できるので，レイアウトを先に確定できます。ページ単位のインタフェースでは，書式を変更してもアプリケーションプログラムを変更する必要はありません。このため，プリンタによってけい線とデータがずれてしまうといったトラブルがありません。Visual Basic，Access，またはDelphiなど，さまざまな開発環境で作成したアプリケーションプログラムから，同一のインタフェースで利用できます。

(3)　プリンタの特性を生かしたきめ細かい印刷ができます

XMAP3では，Windows共通のGDIインタフェースに加え，プリンタを直接コントロールするページ制御言語（XMAP3がPDLを直接生成）により，プリンタの特性を生かしたきめ細かい印刷ができます。

プリンタを直接コントロールできるので，改ページ制御や給紙サイズに応じたカセットも選択できます。

(4)　FAXに帳票を出力できます

FAXコネクション(FAXC/SPOOL)または一般のFAX通信プログラムと連携して，プリンタ出力と同様に，FAXに帳票を出力できます。

(5)　帳票管理システムと連携できます

日立拡張プリンタマネージャや，日立JP1と連携してプリントエラー時のリカバリを実現します。さらに日立JP1を利用すると，帳票の出力保留，仕分け，定期的削除の自動化といったスプール管理など，本格的な運用管理ができます。

またXMAP3ではプリンタスプーラに登録されるドキュメント名を任意に指定できるので，よりスムーズな運用管理を実現できます。

(6)　電子帳票システムを構築できます

ページプリンタ用の帳票は，プリンタに出力するだけでなくPDFファイルへも出力できるので，少ない導入・運用コストで電子帳票を作成できます。また，HOPSS3/AS 日立電子帳票システムと連携した，本格的な電子帳票システムも構築できます。

1.2.3　開発環境の紹介

＜この項の構成＞

(1)　開発環境がそろっています

(2)　効率良く画面・帳票定義ができます

(3)　メインフレーム・WSのアプリケーションプログラムの分散開発に対応しています

(4)　Webブラウザ用の画面を定義できます

(5)　Windowsターミナルサービスを利用した開発を支援します

(1)　開発環境がそろっています

画面や帳票を扱うアプリケーションプログラムの開発には，XMAP3が提供している，ひな型となるAPパターンや部品を利用できます。このため，アプリケーションプログラムを効率良く開発できます。定義した情報は，ドキュメントに出力して保守に役立てられます。そのほか，遷移シミュレーションやマップコンペアなど各種ユティリティを提供し，開発効率を向上させています。なお，複数のPCに同じ開発環境を設定する場合は，ユティリティを用いて環境設定情報をバックアップし，各PCに配布後リストアすることで，開発環境を効率良くセットアップできます。

XMAP3の開発環境の概要を，図1-4に示します。

図1-4　XMAP3の開発環境の概要

(2)　効率良く画面・帳票定義ができます

画面，帳票の属性に関する初期値などは，あらかじめドローセットアップで指定できるので，効率良くレイアウトを定義できます。また，メニューや表などをパターンや部品として登録できます。パターンや部品は複数の画面や帳票で共用できるため，登録しておくと生産性が向上します。

ドロー画面は，更新用と参照用を開くことができるので，互いの定義内容をコピーし，貼り付けることもできます。

けい線や書体などは，一括して属性の修正ができます。プレプリント帳票や，グラフィック帳票，書式オーバレイ用には，既存の帳票をスキャナで読んで下敷きとして活用する機能があります。

定義した帳票は，画面に表示したり，テスト用に印刷したりできます。

(3)　メインフレーム・WSのアプリケーションプログラムの分散開発に対応しています

(a)　メインフレームで使用する画面・帳票の分散開発

XMAP3のメインフレーム連携機能では，メインフレームで使用する画面・帳票の定義ができます。PCのXMAP3で定義した定義結果は，パネル定義文の形でファイルに出力されるので，これをメインフレームに転送します。メインフレームでは，XMAPシリーズでオンライン端末用の画面・帳票が生成できます。また，PC版の日立COBOL85と併用すると，PC上で単体テストまでできるので，さらに生産性の向上が期待できます。

また，XMAP3では，メインフレームで使用するタイプ１書式，タイプ２書式，タイプ3書式，およびタイプR書式をPCで定義できます。

(b)　WSで使用する画面・帳票の分散開発

XMAP3では，WSで使用する画面・帳票の定義ができます。PCのXMAP3で定義した定義結果は，物理マップ，論理マップの形でファイルに出力されるので，これをWSに転送します。また，PC版の日立COBOL85と併用すると，PC上で単体テストまでできるので，さらに生産性の向上が期待できます。

(4)　Webブラウザ用の画面を定義できます

Webブラウザを用いたシステムで利用するための画面・帳票の定義ができます。またアプリケーションプログラムがなくても，Webブラウザによるテスト表示や印刷によって，定義内容が確認できます。

注

製品によって，利用できる機能が異なるため，詳細は「付録G　XMAP3シリーズの提供機能一覧」を参照してください。

(5)　Windowsターミナルサービスを利用した開発を支援します

ターミナルサービスを利用して，クライアントでXMAP3の画面や帳票を作成できます。ターミナルサービスを利用すると，各クライアントでXMAP3やアプリケーションプログラムをインストールする必要がありません。セットアッププログラムを共用して，共通の開発環境で作業することができます。また，XMAP3やアプリケーションの開発に使用する各種のファイル（定義ファイル，論理マップなど）をクライアントに配布する必要もなく，リソースをサーバで集中管理できます。

注　

利用できる機能の詳細については，マニュアル「画面・帳票サポートシステムXMAP3　開発・実行ガイド」を参照してください。

1.2.4　実行環境の紹介

＜この項の構成＞

(1)　テスト・運用を支援します

(2)　サーバ集中C/Sシステムを構築できます

(3)　分散マップでGUIを実現します

(4)　Webブラウザでの実行を支援します

(5)　Cosminexusアプリケーションサーバでの実行を支援します

(6)　Windowsターミナルサービスを利用した実行を支援します

(7)　Windowsクラスタ構成で実行できます

(1)　テスト・運用を支援します

アプリケーションプログラムの実行環境のセットアップでは，キーボードのキーに対する機能の割り当てのほか，表示色・表示文字など，画面や帳票の実行環境を設定できます。複数のPCに同じ実行環境を設定する場合は，環境設定情報をバックアップおよびリストアして配布することで，効率良くセットアップできます。

アプリケーションプログラムの実行時には，画面のハードコピーを採ったり，ログ情報を出力したりできるので，デバッグやチューニングにも役立ちます。

(2)　サーバ集中C/Sシステムを構築できます

XMAP3のネットワーク機能を使用すると，クライアントにアプリケーションプログラムやマップ（画面）を配布する必要がありません。サーバ側でアプリケーションプログラムと画面の一元管理ができます。クライアントには表示・印刷に必要なXMAP3実行時システムを配置するだけです。また，XMAP3では，サーバとクライアントとを画面単位で通信して，画面の表示性能の向上を図っています。

(3)　分散マップでGUIを実現します

XMAP3のメインフレーム連携機能では，メインフレームの画面処理をPCへ分散できます。マッピングの部分をPCに分散するので，通信データはアプリケーションプログラムからのデータだけとなり，通信コストを削減できます。画面の表示にはPC用の物理マップを使用するので，メインフレームのアプリケーションプログラムから本格的なGUI画面を利用できます。

(4)　Webブラウザでの実行を支援します

XMAP3/Webを利用することで，Webブラウザ上でXMAP3の画面を表示したり，XMAP3の帳票を印刷したりできます。Web連携機能を使用することによって，ユーザアプリケーション，XMAP3，物理マップファイルなどを，クライアントに配布する必要がありません。また，アプリケーションプログラムやXMAP3をインストールする必要がないため，リソースをサーバで集中管理できます。

(5)　Cosminexusアプリケーションサーバでの実行を支援します

XMAP3/Web for Cosminexusを利用し，Cosminexusアプリケーションサーバと連携することで，Webブラウザ上でXMAP3の画面を表示したり，XMAP3の帳票を印刷したりできます。Cosminexus連携機能を使用することによって，クライアントに必要なファイルはすべて自動的にダウンロードされるため，クライアントへの配布作業が不要になります。

また，アプリケーションサーバで実行するためのXMAP3の画面および帳票は，既存の資産を使用することもできるので，Web化のために新たに画面および帳票を開発する必要はありません。既存のXMAP3の資産を生かした，効率の良いフロントエンドの開発ができます。なお，バックエンドプログラムには，通常，Javaを使用しますが，XMAP3/Web for CosminexusではJavaのほかに，COBOL2002と連携することでCOBOLも使用できます。

(6)　Windowsターミナルサービスを利用した実行を支援します

ターミナルサービスを利用して，クライアントにXMAP3の画面を表示したり，XMAP3の帳票を印刷したりできます。ターミナルサービスを利用すると，ユーザアプリケーション，XMAP3，物理マップファイルなどを，クライアントに配布する必要がありません。また，アプリケーションプログラムやXMAP3をインストールする必要がないため，リソースをサーバで集中管理できます。

(7)　Windowsクラスタ構成で実行できます

XMAP3のサーバPCを，クラスタ構成にして実行することもできます。Windowsクラスタ（MSCS）を利用してXMAP3のサーバPCをクラスタ構成で実行すれば，稼動中のサーバPCに障害が発生しても，待機中のサーバPCにフェールオーバすることで，システムの可用性を高めることができます。

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

XMAP3を使った業務開発の流れについて説明します。ここでは，アプリケーションプログラムの開発にCOBOL2002またはCOBOL85を使用する場合について説明します。業務の流れは，次の四つのパターンについて説明します。

PCを利用したシステム開発の流れ

WSを利用したシステム開発の流れ

メインフレームとPCを分散したシステム開発の流れ

メインフレームの定義ツールとして利用する開発の流れ

なお，XMAP3/Webを利用した業務開発の流れについては，マニュアル「画面・帳票サポートシステム　XMAP3/Web」を，XMAP3/Web for Cosminexusを利用した業務開発の流れについては，マニュアル「画面・帳票サポートシステム　XMAP3/Web for Cosminexus」を参照してください。

＜この節の構成＞

(1)　PCを利用したシステム開発の流れ

(2)　WSを利用したシステム開発の流れ

(3)　メインフレームとPCを分散したシステム開発の流れ

(4)　メインフレームの定義ツールとして利用する開発の流れ

(1)　PCを利用したシステム開発の流れ

XMAP3には，画面や帳票の業務開発に使用するさまざまな機能が用意されています。次に，XMAP3を利用したPC用システムでの開発の流れ（新規パターン作成の業務開発）を，図1-5および図1-6に示します。

図1-5　PCを利用したシステム開発の流れ(1/2)

図1-6　PCを利用したシステム開発の流れ(2/2)

XMAP3の概要を理解します
業務開発を始める前に，XMAP3でどのようなことができるか，また，どのような手順で作業を進めればよいかを理解しましょう。XMAP3の概要を理解するために，次に示すドキュメントやサンプル機能を利用できます。

入門マニュアル，またはXMAP3ホームページのデモプログラム

入門マニュアル，またはXMAP3ホームページのデモプログラムを参照します。

APサンプル

ソースプログラムや画面・帳票のレイアウト定義のサンプルが提供されています。実際にプログラムを実行することもできます。

定義サンプル

画面や帳票のレイアウト定義のサンプルが提供されています。

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

画面や帳票のレイアウトを定義し，マップを生成します
2.で考えたイメージを基に，ドロー機能を使って画面，帳票，または書式のレイアウトを定義します。
レイアウトの定義を始める前に，必要に応じてXMAP3の開発環境をカスタマイズします。開発環境の設定には，ドローセットアップ機能を使います。画面の外観や操作キーの割り当て，プリンタの印刷モードなど，ユーザの使用環境に合わせて，表示または印刷の各種設定ができます。テスト表示またはテスト印刷するためには，表示・印刷セットアップ機能を使います。
また，レイアウトのひな型となるレイアウトパターンやレイアウト部品も必要に応じてドロー機能を使って作成しておきます。
定義したレイアウトや画面遷移は，テスト支援機能を使って，表示または印刷して確認します。画面を印刷物として保管したい場合は，ハードコピー機能を使用することもできます。また，ドキュメンテーション支援機能を使用すると，マップ一覧，レイアウトリストなどを出力でき，レイアウト定義の確認や，作成したファイルの管理に利用できます。
レイアウトに問題がなければ，定義情報をマップ定義ファイルに保管し，アプリケーションプログラムの実行に必要なマップを生成します。
なお，ユティリティを使うと，１台のPCでドローセットアップ機能を使って設定した開発環境を，複数のPCに配布できます。

アプリケーションプログラムをコーディングします
XMAP3では，コーディングのひな型となるAPパターンを標準提供しています。プログラムの処理内容に応じたAPパターンを利用し，エディタを使ってコーディングします。また，必要に応じ，APサンプルのソースプログラムを参考にしてコーディングします。

アプリケーションプログラムをコンパイル，実行してテストします
作成したアプリケーションプログラムをCOBOL2002やCOBOL85などのコンパイラでコンパイルし，リンケージします。このとき，画面または帳票を使用するプログラムでは，COPY文に指定した論理マップが取り込まれます。
また，アプリケーションを実行する前に，必要に応じて画面や帳票の実行環境を設定します。この作業には，表示・印刷セットアップ機能を使います。
コンパイルを終えたあと，アプリケーションプログラムを実行してテストしましょう。必要に応じてロギング支援機能を使い，実行時のログ情報を取得します。

アプリケーションプログラムを保守，運用します
完成したアプリケーションプログラムを保守，運用します。定義したマップは，ドキュメンテーション支援機能を使って保守ドキュメントを出力します。
また，このとき，ユティリティを使ってマップや環境設定の情報などを一括バックアップすることができます。ユティリティを使うと，１台のPCで表示・印刷セットアップなどで設定した実行環境を，複数のPCに配布するためにバックアップすることができます。バックアップした実行環境は，JP1/NETM/DMなどを利用して配布し，ユティリティを使ってリストアします。

ドローセットアップ，表示・印刷セットアップについては，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

レイアウト定義で使用するオブジェクトやアプリケーションプログラムの作成方法の詳細については，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　画面編」または「画面・帳票サポートシステム XMAP3　プログラミングガイド　帳票編」を参照してください。

XMAP3の各機能を操作しているとき，ヘルプを利用すると，詳細な操作方法や説明が参照できます。

(2)　WSを利用したシステム開発の流れ

ターゲットをWSに設定し，WSで利用していた資産（パネル定義文）をPCにインポートします。その後，PCのXMAP3を利用して画面・帳票を開発し，WS上でアプリケーションプログラムを開発する流れを，図1-7および図1-8に示します。

図1-7　WSを利用したシステム開発の流れ(1/2)

図1-8　WSを利用したシステム開発の流れ(2/2)

ターゲットを設定します
ドローセットアップ機能でターゲットとする業務開発環境（AIX（文字コード：シフトJIS）用の画面・帳票開発など）を設定します。

レイアウトを定義し，マップを生成します
定義したレイアウトをテスト表示したり，テスト印刷したりするために，あらかじめ表示・印刷セットアップ機能を使用して，画面環境の設定や印刷環境の設定をしておきます。
SEWB3などの定義資産（パネル定義文）※をユティリティのインポート機能を使って，マップ定義ファイルに変換します。変換されたマップ定義ファイルは，ドロー機能を使って画面，帳票，または書式のレイアウトを定義します。また，レイアウトのひな型となるレイアウトパターンやレイアウト部品も必要に応じてドロー機能を使って作成しておきます。
定義したレイアウトや画面遷移は，テスト支援機能を使って，表示または印刷して確認します。画面を印刷物として保管したい場合は，ハードコピー機能を使用することもできます。また，ドキュメンテーション支援機能を使用すると，マップ一覧，レイアウトリストなどを出力でき，レイアウト定義の確認や，作成したファイルの管理に利用できます。
ドローで作成したWS用の論理マップおよび物理マップは，FTPなどを使用してWSへ転送します。また，ドローで編集したマップ定義ファイルをユティリティのマップ生成機能を使用して一括でマップを生成することもできます。
EUC環境で使用する場合は，WSへ転送後，iconvコマンドなどを使用して，論理マップをシフトJISからEUCに変換します。

注※

資産があるのは，HP-UX，HI-UX/WE2だけです。

アプリケーションプログラムをコーディング，コンパイル，実行してテストします
WSに転送された論理マップおよび物理マップを利用して，アプリケーションプログラムを作成します。
作成したアプリケーションプログラムをCOBOL85などのコンパイラでコンパイル，リンケージします。
WSでC/S構成に対応する環境設定をして，プログラムのテストをします。

画面・帳票およびマップを保守します
作成した画面・帳票およびマップをPC上で保守します。
このとき，ユティリティを使ってマップや環境設定の情報などを一括バックアップすることができます。

ドローセットアップ，表示・印刷セットアップ，ユティリティ，ドキュメント支援については，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

また，既存資産を流用したPC上でのWSで利用する画面・帳票の作成，およびWSで利用する画面・帳票を新規に作成するなどの詳細については，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

レイアウト定義などの詳細については，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　画面編」または「画面・帳票サポートシステム XMAP3　プログラミングガイド　帳票編」を参照してください。

(3)　メインフレームとPCを分散したシステム開発の流れ

ターゲットを「メインフレーム－PC分散」に設定し，メインフレームで利用していた資産（パネル定義文）をPCにインポートします。その後，PCのXMAP3を利用して画面・帳票を開発し，PC上で画面管理プログラム，メインフレーム上でアプリケーション開発する流れを，図1-9および図1-10に示します。

図1-9　メインフレームとPCを分散したシステム開発の流れ(1/2)

図1-10　メインフレームとPCを分散したシステム開発の流れ(2/2)

ターゲットを設定します
ドローセットアップ機能でターゲットとする業務開発環境（メインフレーム－PC分散用の画面・帳票）を設定します。

画面や帳票のレイアウトを定義し，マップを生成します
定義したレイアウトをテスト表示したり，テスト印刷したりするために，あらかじめ表示・印刷セットアップ機能を使用して，画面環境の設定や印刷環境の設定をしておきます。
メインフレームの定義資産（パネル定義文）をユティリティのインポート機能を使って，マップ定義ファイルに変換します。変換されたマップ定義ファイルは，ドロー機能を使って画面，帳票，または書式のレイアウトを定義します。また，レイアウトのひな型となるレイアウトパターンやレイアウト部品も必要に応じてドロー機能を使って作成しておきます。
定義したレイアウトや画面遷移は，テスト支援機能を使って，表示または印刷して確認します。画面の確認にはハードコピー機能を使用することもできます。
なお，ユティリティを使うと，１台のPCで表示・印刷セットアップなどで設定した実行環境を，複数のPCに配布するためにバックアップすることができます。
定義したマップは，ドキュメンテーション支援機能を使って保守ドキュメントを出力します。
ドローで作成した論理マップを，IFITなどを使用してメインフレームへ転送します。また，ドローで編集したマップ定義ファイルをユティリティのマップ生成機能を使用して一括でマップを生成することもできます。

画面管理プログラムを作成します
PC環境では，メインフレームと連携してPCの画面・帳票の入出力を処理するための画面管理プログラムを作成します。画面管理プログラムは，サンプルとして提供されていますので，それを利用し，エディタを使ってコーディングします。

アプリケーションプログラムをコンパイル，実行してテストします
メインフレーム環境では，プログラムの処理内容に応じて，エディタを使ってコーディングします。
作成したアプリケーションソースは，メインフレームのCOBOL85などのコンパイラでコンパイルし，リンケージします。このソースは，画面または帳票を使用するプログラムでは，COPY文に指定した論理マップを取り込みます。
アプリケーションを実行する前に，必要に応じて画面や帳票のメインフレームでの実行環境を設定します。

アプリケーションプログラムを保守，運用します
完成した画面・帳票，マップを保守，運用します。
定義したマップは，ドキュメンテーション支援機能を使って保守ドキュメントを出力します。

メインフレーム連携による分散開発，ドローセットアップについては，マニュアル「画面・帳票サポートシステム XMAP3　メインフレーム連携ガイド」を参照してください。

表示・印刷セットアップについては，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

レイアウト定義，アプリケーションプログラムの作成方法については，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　画面編」または「画面・帳票サポートシステム XMAP3　プログラミングガイド　帳票編」を参照してください。

(4)　メインフレームの定義ツールとして利用する開発の流れ

ターゲットを「メインフレーム（VOS3/VOS1/VOS K）の画面・帳票開発」に設定し，メインフレームで利用していた資産（パネル定義文）をPCにインポートします。その後，PCのXMAP3を利用して画面・帳票を開発し，パネル定義文をメインフレームへ転送する流れを，図1-11に示します。

図1-11　メインフレームの定義ツールとして利用する開発の流れ

ターゲットを設定します
ドローセットアップ機能でターゲットとする業務開発環境（VOS1，VOS3環境など）を設定します。

画面や帳票のレイアウトを定義し，マップを生成します
定義したレイアウトをテスト表示したり，テスト印刷したりするために，あらかじめ表示・印刷セットアップ機能を使用して，画面環境の設定や印刷環境の設定をしておきます。
メインフレームの定義資産（パネル定義文）をユティリティのインポート機能を使って，マップ定義ファイルを生成します。生成されたマップ定義ファイルは，ドロー機能を使って画面，帳票，または書式のレイアウトを定義します。また，レイアウトのひな型となるレイアウトパターンやレイアウト部品も必要に応じてドロー機能を使って作成しておきます。
定義したレイアウトは，ドローのテスト表示・印刷機能を使って確認します。
定義したマップは，ドキュメンテーション支援機能を使って保守ドキュメントを出力します。

メインフレームで運用します
ドローで作成したパネル定義文をメインフレームへ転送します。
また，ドローで編集したマップ定義ファイルを，ユティリティのエクスポート機能を使用して，一括でパネル定義文を生成することもできます。

ドローセットアップ，表示・印刷セットアップについては，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

レイアウト定義で使用するオブジェクトやアプリケーションプログラムの作成方法の詳細については，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　画面編」または「画面・帳票サポートシステム XMAP3　プログラミングガイド　帳票編」を参照してください。

メインフレーム資産の定義ツールとしての利用については，マニュアル「画面・帳票サポートシステム XMAP3　メインフレーム連携ガイド」を参照してください。

XMAP3の各機能を操作しているときには，ヘルプを使用すると，詳細な操作方法や説明を参照できます。

1.4　画面・帳票定義とアプリケーションプログラムの関係について紹介します

XMAP3では，画面や帳票のレイアウト（定義）と，アプリケーションプログラムの処理を分離したマッピング方式を採用しています。これによって，画面や帳票の設計作業とコーディング作業とを分離できます。

画面と帳票を例に，画面・帳票の定義とアプリケーションプログラムの関係を，図1-12に示します。

図1-12　画面・帳票定義とアプリケーションプログラムの関係

1.5　アプリケーションプログラムインタフェースの概要について紹介します

画面入力／表示，帳票印刷，書式オーバレイ印刷のそれぞれについて，XMAP3とアプリケーションプログラムとのインタフェースの概要を説明します。

画面入力／表示のインタフェース
GUI画面およびCUI画面のレイアウト定義からは，物理マップのほかに，出力論理マップと入力論理マップの2種類の論理マップが生成されます。
出力論理マップには，画面に表示する可変データや，実行中に変更する表示属性などを設定します。また，入力論理マップには，画面から入力されたデータや，どのボタンが選択されたのかといった情報が設定されます。
COBOLでアプリケーションプログラムを作成する場合は，COPY文で入力論理マップと出力論理マップの取り込みを指定します。実行時には，アプリケーションプログラムに取り込まれた論理マップのデータ領域を介して，データがやり取りされます。
画面入力／表示のインタフェースの仕組みを図1-13に示します。

図1-13　画面入力／表示のインタフェース

帳票印刷のインタフェース
帳票印刷では，アプリケーションプログラムとのインタフェースに出力論理マップを使用します。出力論理マップには，帳票に印刷する可変データを設定します。
COBOLでアプリケーションプログラムを作成する場合は，COPY文で出力論理マップの取り込みを指定します。実行時には，アプリケーションプログラムに取り込まれた論理マップのデータ領域を介して，ページ単位でデータが出力されます。
帳票印刷のインタフェースの仕組みを図1-14に示します。

図1-14　帳票印刷のインタフェース

書式オーバレイ印刷のインタフェース
書式のレイアウト定義からは，書式イメージファイルと行制御データファイルが生成されます。書式イメージファイルには，書式の文字列やけい線などの情報が格納されています。また，行制御データファイルには，行データの文字サイズや行の間隔などの情報が格納されています。
アプリケーションプログラムでは，可変データが格納された行データを読み込み，1行（1レコード）ずつ印刷するデータを出力します。
書式オーバレイ印刷のインタフェースの仕組みを図1-15に示します。

図1-15　書式オーバレイ印刷のインタフェース

1.6　アプリケーションプログラム作成の概要について紹介します

アプリケーションプログラム作成の概要を，図1-16に示します。

図1-16　アプリケーションプログラム作成の概要

作成したい画面，帳票または書式オーバレイの仕様に合ったAPパターンを選択します。
APパターンは，次のフォルダに提供されています。
XMAP3のインストールフォルダ¥Patterns

画面または帳票の場合は，レイアウト定義から生成された論理マップを，アプリケーションプログラムに取り込む指定をします。
標準提供されている登録集原文の取り込みも指定します。この登録集原文は，次のフォルダに提供されています。
XMAP3のインストールフォルダ¥Include

ユーザ固有の処理を追加します。
アプリケーションプログラムを作成するときには，提供部品を活用しましょう。必要に応じ，APサンプルのコーディングを参考にしてください。APサンプルは，次のフォルダに提供されています。
XMAP3のインストールフォルダ¥Samples

1.7　WSの分散開発と分散実行について紹介します

XMAP3では，画面・帳票を定義する機能に加えて，WSの資産をPCにインポートして，PCの環境で画面・帳票を編集します。また，新規にWS用の画面・帳票のレイアウトを定義できます。

WSで利用する画面・帳票をPCに移行する
PCを開発および実行に利用する形態です。概要を図1-17に示します。
従来，WSで利用していたパネル定義文※をPCに転送し，WS用のインポート機能を利用してPC用のマップ定義ファイルに変換します。変換したマップ定義ファイルは，PCのXMAP3で編集できます。これで，WSの画面・帳票をPC用に変換して，PC上のアプリケーションプログラムから利用できます。

注※

資産があるのは，HP-UX，HI-UX/WE2だけです。

図1-17　WSの画面・帳票をPCに移行する形態の概要

PCで定義した画面・帳票をWSで運用する
PCを開発環境として利用する形態です。概要を図1-18に示します。
XMAP3で画面・帳票を定義して，マップ定義ファイルから，WS用のマップ（論理マップおよび物理マップ）を生成します。この論理マップおよび物理マップをWSへファイル転送し，アプリケーションプログラムで利用します。
EUC環境で使用する場合は，WSへ転送後，iconvコマンドを使用して，論理マップをシフトJISからEUCに変換します。

図1-18　PCで定義してWSで運用する形態の概要

1.8　メインフレームの分散開発と分散実行について紹介します

XMAP3では，画面・帳票を定義する機能に加えて，メインフレームの資産をPCインポートして，PCの環境で画面・帳票を扱うアプリケーションプログラムの開発や実行ができます。また，メインフレームの資産をPCにインポートして定義ツールとして使用することもできます。このような機能をメインフレーム連携機能と呼びます。メインフレーム連携機能については，マニュアル「画面・帳票サポートシステム XMAP3　メインフレーム連携ガイド」を参照してください。

ここでは，メインフレーム連携機能の三つの利用形態について説明します。

メインフレームのマッピングをPCに分散する
PCを開発および実行に利用する形態です。メインフレームでのマッピングをPCに分散する形態の概要を，図1-19に示します。
メインフレームへの負荷を軽減させるために，アプリケーションプログラムはメインフレーム上で動作させ，画面・帳票データの編集および入出力マッピングをPCへ分散します。マッピング処理をメインフレームからPCに分散すると，メインフレーム上のアプリケーションプログラムからPCのGUI画面を利用できます。また，PC側でマッピングするため，メインフレームとPCの間でのデータ転送量が少なくなり，データ量の削減ができます。なお，メインフレームとPCで扱う文字コードの違いはXMAP3が吸収するので，メインフレーム側のアプリケーションプログラムに大きな変更を加えないでGUI画面を利用できます。

図1-19　メインフレームでのマッピングをPCに分散する形態の概要

また，メインフレーム用のパネル定義文をPCのマップ定義ファイルに変換するためのインポート機能を提供しています。これによって，画面・帳票定義のPCへの移行，またはPC上での画面・帳票定義の編集が簡単にできます。

メインフレームの画面・帳票をPCに移行する
PCを開発および実行に利用する形態です。概要を図1-20に示します。
従来，メインフレームで使用していたパネル定義文をPCに転送し，インポート機能を利用してPC用のマップ定義ファイルに変換します。変換したマップ定義ファイルは，PCのXMAP3で編集できます。これで，メインフレームの画面・帳票をPC用に変換して，PC上のアプリケーションプログラムから利用できます。

図1-20　メインフレームの画面・帳票をPCに移行する形態の概要

PCで定義した画面・帳票をメインフレームで運用する
PCを開発環境として利用する形態です。概要を図1-21に示します。
XMAP3で画面・帳票を定義して，パネル定義文を作成します。このパネル定義文をメインフレームへファイル転送し，メインフレーム上のXMAPシリーズを使ってパネル定義文からマップを生成し，アプリケーションプログラムで利用します。
PC上での優れた画面・帳票定義環境で，画面・帳票定義の生産性を大幅に向上できます。

図1-21　PCで定義してメインフレームで運用する形態の概要

1.9　開発環境・実行環境の配布について紹介します

ユティリティの機能を利用して，XMAP3の開発環境・実行環境をバックアップし，ほかの環境にリストアできます。

ドローセットアップや表示・印刷セットアップなどの環境設定情報のバックアップとリストアには，ユティリティの環境ファイル操作機能を利用します。また，画面・帳票定義などの資源のバックアップとリストアには，ユティリティのマップファイル操作機能を利用します。バックアップした開発環境および実行環境の配布には，JP1/NETM/DMの資源管理機能を利用できます。

ここでは，バックアップとリストアの概要を説明します。詳細については，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

開発環境の配布
運用管理者が準備した開発環境を，開発メンバの複数のPCに配布する例を，図1-22に示します。それぞれのPCで開発環境を構築する必要がなく，また，開発環境を容易に統一できます。

図1-22　開発環境の配布の例

実行環境の配布
C/Sシステム構成の実行環境を配布する例を，図1-23に示します。
実行環境の構築だけでなく，テスト環境から運用環境へと環境を移行したい場合などにも，ユティリティの機能を利用して効率良く作業できます。

図1-23　実行環境の配布の例（C/Sシステム構成）

2.　XMAP3を理解しましょう

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

＜この章の構成＞

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

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

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

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

＜この節の構成＞

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

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

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

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

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

このマニュアルでは，日立で提供しているCOBOL2002またはCOBOL85の使用を前提として説明を進めていきます。COBOL2002またはCOBOL85の準備については，「4.2　アプリケーションプログラム作成の準備をします」で概要を紹介しています。

＜この項の構成＞

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

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

(3)　アンインストール

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

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

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

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

Windows NT 4.0，Windows 2000，Windows XP，およびWindows Server 2003の場合は，Administratorsグループに属するユーザでインストールしてください。

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

インストールする提供媒体をドライブに挿入します。

提供媒体の中にあるインストーラを起動します。
製品統合CD-ROM，またはBUSINESSPOWERの提供統合CD-ROMの中のHCD_INST.EXEを実行してください。インストーラの画面の指示に従って操作し，インストールしたいXMAP3のプログラムを選択します。XMAP3のインストールの準備が終わると，［インストールの前に］ダイアログボックスが表示されます。

ダイアログボックスの内容を確認し，［はい］ボタンを選びます。
ようこそダイアログボックスが表示されます。

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

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

［セットアップタイプ］ダイアログボックスが表示されます。

「標準」「コンパクト」「カスタム」の中からセットアップ方法を選択します。

インストール先のフォルダを確認します。
インストール先のドライブやフォルダを変更したい場合には，［参照］ボタンを選び，インストールしたい場所を指定できます。ただし，すでにXMAP3やXMAP3/Webがインストールされている場合は，インストール先は変更できません。インストール済みのXMAP3と同じフォルダにインストールされます。
標準のインストール先は次のとおりです。

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

［セットアップタイプ］ダイアログボックスで［次へ］ボタンを選びます。
セットアップ方法に，「標準」または「コンパクト」を選択した場合は，［インストールコンポーネント］ダイアログボックスが表示されます。

「カスタム」を選択した場合には［インストール環境の選択］ダイアログボックスが表示されます（XMAP3/REPORT3 Run Time Systemでは表示されません）。ここで，インストールする環境を選択し，次に表示される［コンポーネントの選択］ダイアログボックスでインストールしたいコンポーネントを選びます。コンポーネント選択の詳細については，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

［インストールコンポーネント］ダイアログボックスで［次へ］ボタンを選びます。
［プログラム フォルダの選択］ダイアログボックスが表示されます。

［プログラム フォルダの選択］ダイアログボックスで，プログラムアイコンを追加するフォルダを指定して，［次へ］ボタンを選びます。

［ファイル コピーの開始］ダイアログボックスが表示されます。

これまでのダイアログボックスで指定したインストールの内容に，問題がなければ［次へ］ボタンを選びます。

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

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

(3)　アンインストール

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

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

Windowsの［コントロールパネル］アイコンを開き，［アプリケーションの追加と削除］を選びます。
［アプリケーションの追加と削除のプロパティ］ダイアログボックスが表示されます。

削除したいXMAP3（例えば「XMAP3/NET」）を選択して，［追加と削除］ボタンを選びます。
削除するかどうかを尋ねるダイアログボックスが表示されます。

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

XMAP3のアンインストール中に共用ファイルを削除するかどうかの問い合わせダイアログが表示されることがあります。ファイルによっては，ほかのアプリケーションが起動できなくなるものがありますので，削除してよいかわからない場合は，削除しないでください。

なお，アンインストール後，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を起動します。
［スタート］－［プログラム］－［XMAP3］から［ドロー］アイコンを選びます。
「新規・更新選択」ダイアログボックスが表示されます。

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

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

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

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

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

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

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

2.2.2　XMAP3を起動します

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

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

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

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

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

［スタート］－［プログラム］－［XMAP3］から［ドロー］アイコンを選びます。

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

レイアウト定義に使用するウィンドウは，定義の種類に対応して「GUI画面定義ウィンドウ」，「CUI画面定義ウィンドウ」，「帳票定義ウィンドウ」，および「書式定義ウィンドウ」に分類されます。なお，帳票定義ウィンドウには，ページプリンタ用とシリアルプリンタ用の２種類のウィンドウがあります。このマニュアルでは，それらをまとめて「帳票定義ウィンドウ」と呼びます。帳票定義ウィンドウおよび書式定義ウィンドウについては，「画面・帳票サポートシステム XMAP3　プログラミングガイド　帳票編」を参照してください。

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

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

1.タイトルバー

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

2.メニューバー

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

3.ツールバー

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

ボタンの種類は，GUI画面，CUI画面，帳票，書式によって一部異なります。ツールバーのボタンのうち，定義種別ごとに異なるものを表2-1から表2-4に示します。

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

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

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

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

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

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

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

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

4.ツールボックス

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

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

ボタン
名　称
内　　容

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

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

固定テキスト（日本語）

固定テキスト（英数）

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

出力テキスト（数字）

出力テキスト（日本語）

出力テキスト（英数）

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

出力日付テキスト

出力時刻テキスト

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

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

入出力テキスト（数字）

入出力テキスト（金額）

入出力テキスト（数値）

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

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

入出力テキスト（カナ）

入出力テキスト（英数）

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

固定ポップアップ

可変ポップアップ

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

固定コンボボックス

可変コンボボックス

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

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

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

入出力日付テキスト

入出力時刻テキスト

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

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

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

プッシュボタン（複数）

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

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

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

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

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

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

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

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

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

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

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

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

縦／横セパレータ

横セパレータの繰り返し

縦セパレータの繰り返し

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

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

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

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

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

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

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

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

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

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

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

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

固定グラフィック

出力グラフィック

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

ボタン
名　称
内　　容

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

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

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

固定フィールド（英数）

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

出力フィールド（数字）

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

出力フィールド（英数）

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

出力日付フィールド

出力時刻フィールド

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

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

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

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

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

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

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

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

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

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

入出力日付フィールド

入出力時刻フィールド

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

固定ポップアップ

可変ポップアップ

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

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

フレーム（縦繰り返し）

フレーム（横繰り返し）

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

塗りつぶし

塗りつぶし（枠付き）

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

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

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

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

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

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

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

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

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

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

縦(左)／横(上)けい線

縦(中央)／横(中央)けい線

縦(右)／横(下)けい線

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

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

ボタン
名　称
内　　容

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

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

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

固定フィールド（英数）

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

出力フィールド（数字）

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

出力フィールド（英数）

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

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

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

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

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

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

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

フレーム（縦繰り返し）

フレーム（横繰り返し）

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

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

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

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

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

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

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

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

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

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

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

ボタン
名　称
内　　容

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

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

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

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

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

出力フィールド（数字）

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

出力フィールド（英数）

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

出力日付フィールド※２ ※３

出力時刻フィールド※２ ※３

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

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

フレーム（縦繰り返し）

フレーム（横繰り返し）

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

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

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

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

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

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

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

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

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

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

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

縦（中央）／横（中央）けい線※１ ※２ ※３

縦（右）／横（下）けい線※１ ※２ ※３

斜めけい線※１ ※２ ※３

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

矩形※２

矩形（ラウンドコーナ）※１ ※２

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

円（実線）※１ ※２ ※３

円（点線）※１ ※２ ※３

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

円弧（実線・角度大）※１ ※２ ※３

円弧（実線・角度中）※１ ※２ ※３

円弧（実線・角度小）※１ ※２ ※３

円弧（点線・角度大）※１ ※２ ※３

円弧（点線・角度中）※１ ※２ ※３

円弧（点線・角度小）※１ ※２ ※３

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

網掛け※１ ※２

網掛けの繰り返し（１行間隔）※１ ※２

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

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

出力バーコード※２ ※３

固定バーコード※１※２ ※３

連結出力バーコード※１※２ ※３

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

固定グラフィック※１ ※２ ※３

出力グラフィック※１ ※２ ※３

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

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

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

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

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

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

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

ボタン
名　称
内　　　　　容

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

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

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

固定フィールド（英数）

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

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

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

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

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

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

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

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

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

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

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

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

斜めけい線

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

矩形

矩形（ラウンドコーナ）

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

円（実線）

円（点線）

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

円弧（実線・角度大）

円弧（実線・角度中）

円弧（実線・角度小）

円弧（点線・角度大）

円弧（点線・角度中）

円弧（点線・角度小）

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

網掛け

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

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

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

5.レイアウト領域

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

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

6.ステータスバー

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

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

レイアウトを定義する手順を，GUI画面定義ウィンドウでの固定テキストの定義を例に挙げて説明します。定義種別やオブジェクトによって多少の差異はありますが，レイアウト定義の基本手順は次のようになります。

GUI画面定義ウィンドウを表示するには，「5.2　GUI画面を作成しましょう」を参照してください。

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

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

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

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

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

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

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

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

（凡例）

○：配置できます　　　×：配置できません

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

ます目配置モード

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

スケール配置モード

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

配置モードの切り替え

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

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

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

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　レイアウト定義でのキー操作を覚えます

キーボードを使ったレイアウト定義の操作について説明します。なお，使用するキーは，お使いになっているキーボードの種類によって異なる場合があります。この場合には，キーボード種類との対応を，次のa～cで説明しています。

a：106/109日本語キーボード，および101/104英語キーボード

b：AX仕様キーボード

c：PC-9801キーボード

＜この項の構成＞

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

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

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

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

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

ａ：［Enter[図データ]］キー

ｂ：［Enter］キー

ｃ：［[図データ]］キー

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

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

ａ：［Delete］キー

ｂ：［Delete］キー

ｃ：［DEL］キー

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

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

ａ：［Home］キー

ｂ：［Home］キー

ｃ：［HOME CLR］キー

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

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

ａ：［End］キー

ｂ：［End］キー

ｃ：［HELP］キー

(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-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］キーを押します。
カーソルは自動的に割引区分の欄に位置づけられます。

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

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

［F2］キーを押した場合

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

［F3］キーを押した場合

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

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

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

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

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

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

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

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

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

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

注※

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

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

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

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

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

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

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

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

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

注※

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

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

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

例題プログラムの作成手順を図3-2に示します。

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

また，それぞれの工程での，このマニュアルの参照先を次に示します。

開発したい例題プログラムの種類に応じて，各章を順番に参照してください。

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

（1）
4章

（2）

5章：GUI画面

6章：CUI画面

8章
10章

（3）
7章
9章
11章

（4）
12章

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

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

＜この章の構成＞

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

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

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

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

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

XMAP3をインストールしたフォルダの下には，任意に使用できる「¥User¥Maps」というフォルダが用意されています。このフォルダを次に示します。

注

¥XMAP3¥Tempの下にはファイルを保存できないので注意してください。¥XMAP3¥Tempの下に，ユーザのフォルダを作成したり，ファイルを格納しないでください。

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

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

＜この節の構成＞

4.2.1　COBOL2002またはCOBOL85をインストールします

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

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

4.2.4　APパターンをCOBOLエディタのテンプレートに登録します（COBOL85 Version 5.0の場合）

4.2.1　COBOL2002またはCOBOL85をインストールします

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

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

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

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

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

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

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

注※

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

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

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

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

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

4.2.4　APパターンをCOBOLエディタのテンプレートに登録します（COBOL85 Version 5.0の場合）

COBOL2002およびCOBOL85のCOBOLエディタは，ひな型を基にして効率良くコーディングするためのテンプレート機能を備えています。COBOL85 Version 5.0の場合は，XMAP3が標準提供しているAPパターンをテンプレートとして登録して利用できます。COBOL2002，COBOL85 Version 7，およびVersion 6の場合は，登録操作は必要ありません。

APパターンをテンプレートに登録し，コーディングの準備をしておきましょう。APパターンの利用については，「4.3　アプリケーションプログラムの作成方法を解説します」を参照してください。

登録方法を，次に説明します。

COBOL85のグループからアイコン「COBOLエディタ」を選びます。
COBOLエディタが起動され，エディタウィンドウが表示されます。

エディタウィンドウのメニューバー［オプション］－［カスタマイズ］を選びます。
カスタマイズのダイアログボックスが表示されます。

ダイアログボックスから「テンプレート」タブを選びます。

テンプレートのフォルダに，APパターンが格納されているフォルダを入力します。
次に示すフォルダを入力してください。
XMAP3のインストールフォルダ¥Patterns¥Cobol

［OK］ボタンを選び，ダイアログボックスを閉じます。
APパターンがテンプレートに登録されます。APパターンが格納されているフォルダから拡張子「.cet」のファイルが取り込まれ，プログラムテンプレートとして利用できるようになります。

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

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

なお，XMAP3から標準提供されているAPサンプルのソースプログラムを流用し，アプリケーションプログラムを作成することもできます。APサンプルの概要については，「付録F.3　提供APサンプル」を参照してください。

＜この節の構成＞

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

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

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

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

APパターン

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

AP部品

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

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

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

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

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

＜この項の構成＞

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

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

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

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

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

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

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

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

＜この章の構成＞

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

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

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

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

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

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

＜この節の構成＞

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

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

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

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

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

定義を開始します

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

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

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

数量の欄を定義します

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

商品名の欄を定義します

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

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

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

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

定義を終了します

＜この節の構成＞

(1)　定義を開始します

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

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

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

(5)　定義を終了します

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

(1)　定義を開始します

［スタート］－［プログラム］－［XMAP3］から［ドロー］アイコンを選びます。
「新規・更新選択」ダイアログボックスが表示されます。

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

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

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

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

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

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

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

「画面属性」ダイアログボックスで次のように設定します。

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

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

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

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

「メニューバー定義」ダイアログボックスで次のように設定します。

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

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

［OK］ボタンを選んで，ダイアログボックスを閉じます。
「画面属性」ダイアログボックスが表示されます。

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

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

(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　レイアウト定義の基本操作を紹介します」を参照して修正してください。

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

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

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

(5)　定義を終了します

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

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

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

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

定義した画面の各項目に対応するデータ名（COBOLプログラムで参照・更新するデータ領域の名称）は，XMAP3が適当な名称を仮定します。通常の開発手順では，仮定されたデータ名を参照しながらコーディングを行います。

ただし，製品添付のCOBOLプログラムのコーディングサンプルをそのまま使う場合には，各項目のデータ名は，コーディングサンプルで参照・更新している領域名称に合わせておく必要があります。

製品添付のCOBOLプログラムをそのまま使用する場合には，ドローのレイアウト定義画面から，メニューバーの［属性］－［データ名］を選んで「データ名」画面を表示し，データ名を修正する必要があります。

サンプルで設定しているデータ名を次に示します。データ名が異なる場合は，次の内容に合わせて修正してください。なお，データ名とオブジェクト名の対応については「付録A　例題プログラムの論理マップ」を参照してください。

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

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

＜この章の構成＞

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

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

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

例題で作成するCUI画面のイメージを，図6-1に示します。

図6-1　例題で作成するCUI画面

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

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

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

定義を開始します

タイトルを定義します

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

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

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

ファンクションキーのガイダンスを定義します

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

文字色を変更します

定義を終了します

＜この節の構成＞

(1)　定義を開始します

(2)　タイトルを定義します

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

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

(5)　文字色を変更します

(6)　定義を終了します

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

(1)　定義を開始します

［スタート］－［プログラム］－［XMAP3］から［ドロー］アイコンを選びます。
「新規・更新選択」ダイアログボックスが表示されます。

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

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

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

［定義対象の選択］から「CUI画面」を選び，［パターンの選択］から「フリー」を選びます。［言語種別］が「COBOL」になっていることを確認します。

［OK］ボタンを選びます。
「画面属性」ダイアログボックスが表示されます。

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

(2)　タイトルを定義します

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

レイアウト領域の「3行 27列」にポインタを位置づけクリックします。

「受注データ入力」と入力したあとで，［Enter］キーを押します。

［受注データ入力］をダブルクリックします。
「固定フィールド」ダイアログボックスが表示されます。

文字の拡大から［倍角］を選びます。

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

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

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

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

レイアウト領域の「７行 11列」にポインタを位置づけ，クリックします。

「得意先コード△:△（ 」と入力したあとで，［Enter］キーを押します。
「:」と「( 」は半角文字で入力します。
注　’△’は半角１文字分の空白を表します。

ツールボックスの[図データ]（入出力フィールド（日本語））を数回クリックして[図データ]（入出力フィールド（英数））を選びます。

レイアウト領域の「７行 28列」にポインタを位置づけ，クリックします。
８列分の入出力フィールドが配置されます。

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

レイアウト領域の「７行 37列」にポインタを位置づけクリックします。

「 )」と入力して［Enter］キーを押します。
「 )」は半角文字で入力します。同様に，「商品コード」，「数量」の欄を定義します。

注※１

入出力フィールド（英数）は，クリックすると８列分の領域が配置されます。領域を８列より多く，または少なく取りたい場合は，必要な分だけドラッグしてください。ここでは，５列分をドラッグします。

注※２

入出力フィールド（数字）は，クリックすると４列分の領域が配置されます。領域を４列より多く，または少なくとりたい場合は，必要な分だけドラッグしてください。ここでは，４列分をドラッグします。

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

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

レイアウト領域の「10行 11列」にポインタを位置づけてクリックします。

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

ツールボックスから[図データ]（入出力フィールド（英数））を選びます。

レイアウト領域の「10行 28列」にポインタを位置づけ，１列分ドラッグします。

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

レイアウト領域の「10行 30列」にポインタを位置づけ，クリックします。

「 ）△△△( △１＝現金△２＝手形△３＝銀行振込△) 」と入力したあとで，［Enter］キーを押します。

同様に，「割引特典」の欄を定義します。

(c)　ファンクションキーのガイダンスを定義します

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

レイアウト領域の「23行 11列」にポインタを位置づけてクリックします。

「Ｆ２△△：△△次入力△△△△△△△△△△Ｆ３△△：△△終了」と入力し，［Enter］キーを押します。

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

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

［Ｆ3］キーを押します。
任意のファンクションキー，または［Enter］キーを押して，テスト表示を終了することもできます。

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

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

(5)　文字色を変更します

ツールバーから[図データ]（文字色）を選び，タイトルの「受注データ入力」をクリックします。

ツールボックスから[図データ]（文字色（空色））ボタンを選びます。
タイトル「受注データ入力」の表示色が空色に変わります。

ツールバーから[図データ]（レイアウトへ戻る）を選びます。
「CUI画面定義」ウィンドウに戻ります。再度テスト表示して全体のバランスを確認しましょう。

(6)　定義を終了します

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

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

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

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

定義した画面の各項目に対応するデータ名（COBOLプログラムで参照・更新するデータ領域の名称）は，XMAP3が適当な名称を仮定します。通常の開発手順では，仮定されたデータ名を参照しながらコーディングを行います。

ただし，製品添付のCOBOLプログラムのコーディングサンプルをそのまま使う場合には，各項目のデータ名は，コーディングサンプルで参照・更新している領域名称に合わせておく必要があります。

製品添付のCOBOLプログラムをそのまま使用する場合には，ドローのレイアウト定義画面から，メニューバーの［属性］－［データ名］を選んで「データ名」画面を表示し，データ名を修正する必要があります。

サンプルで設定しているデータ名を次に示します。データ名が異なる場合は，次の内容に合わせて修正してください。なお，データ名とオブジェクト名の対応については「付録A　例題プログラムの論理マップ」を参照してください。

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に示します。

図7-1　「受注データ入力プログラム」（GUI画面用）の処理の流れ

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

「受注データ入力プログラム」のコーディングから重要な部分を抜粋したものを図7-2から図7-3に示し，ポイントを説明します。なお，このプログラムで使用する論理マップの内容は，「付録A　例題プログラムの論理マップ 」で解説しています。必要に応じて参照してください。

図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.3.2　APパターンを利用したアプリケーションプログラムの作成手順」もあわせて参照してください。

完成したコーディングは，サンプル（COBOLソースプログラム）として提供されています。コーディングの際には，ソースリストを印刷したり，エディタで開いたりして参考にすることをお勧めします。詳細については，「7.4　画面の作成で使用したサンプルプログラムを紹介します」を参照してください。

＜この節の構成＞

(1)　APパターンを利用してコーディングしましょう

(2)　サンプルを利用してコーディングするときの注意事項

(1)　APパターンを利用してコーディングしましょう

使用しているエディタのウィンドウを開きます。

APパターン「GENDSP01.cbl」を開きます※。
APパターンは，次のフォルダに格納されています。
　　XMAP3インストールフォルダ¥Patterns¥Cobol

コーディングします。
固有のプログラム名，マップ名，データ定義や手続きなどを記述してソースプログラムを作成します。手続きのコーディングには，共通処理として用意されているAP部品を，処理内容に合わせて挿入します。受注データ入力プログラムでは，次のAP部品を利用します。
　　SETCRS01…フォーカス位置の設定

コーディングが終了したら，エディタのウィンドウを閉じて保存します。

注※

　COBOLエディタを使用している場合は，次の説明を参照してください。

COBOLエディタでプログラムテンプレートを利用するには

COBOLエディタでのプログラムテンプレートの利用手順を説明します。なお，COBOL85 Version 5.0でプログラムテンプレートを利用するには，あらかじめ，XMAP3のAPパターンを登録しておく必要があります。APパターンの登録方法については「4.2.4　APパターンをCOBOLエディタのテンプレートに登録します（COBOL85 Version 5.0の場合）」を参照してください。

COBOL2002，COBOL85 Version 7およびVersion 6の場合

COBOLエディタウィンドウのメニューバー［ファイル］－［新規作成］を選びます。
「新規作成」ダイアログが表示されます。

作成したいファイルの種類を選びます。

［...］ボタンを選び，表示されるダイアログボックスからテンプレートファイルを選びます。
テンプレートファイルは次の場所に格納されています。
XMAP3のインストールフォルダ¥Patterns¥Cobol

プログラムテンプレートのチェックボックスをオンにします。

［OK］ボタンを選びます。
新規にファイルが作成され，テンプレートの内容が表示されます。
APパターンを挿入するには，挿入したい行にテキストカーソルを位置づけ，メニューバー［編集］－［ファイルの挿入］を選びます。ダイアログボックスに表示されたファイルの一覧から，目的のAP部品を選択してください。

COBOL85 Version 5.0の場合

COBOLエディタウィンドウのメニューバー［ファイル］－［新規作成］を選びます。
「新規作成」ダイアログが表示されます。

ファイルタイプから作成したいファイルの種類を選びます。

テンプレートファイルの一覧から，目的のAPパターンを選びます。

［OK］ボタンを選びます。
APパターンを挿入するには，挿入したい行にテキストカーソルを位置づけ，メニューバー［編集］－［ファイルの挿入］を選びます。ダイアログボックスに表示されたファイルの一覧から，目的のAP部品を選択してください。

(2)　サンプルを利用してコーディングするときの注意事項

なお，5章，6章で作成した画面は，APパターンを使わずに，製品添付のCOBOLプログラムをそのまま使ってコンパイル・実行できます。このとき，作成した画面の各オブジェクトのデータ名とコーディングサンプル中のデータ名を合わせておく必要があります。

データ名を合わせるには，次に示す方法があります。

コーディングサンプルを作成した画面のデータ名に合わせて修正する。

ドローのレイアウト定義の「データ名編集」ダイアログボックスで，コーディングサンプルで使用しているデータ名に変更する。

ドローのレイアウト定義での変更については「5.2(6)　オブジェクトのデータ名に関する注意事項」を参照してください。

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

作成した例題（GUI画面またはCUI画面）のマップファイルと，アプリケーションプログラムをCOBOL2002やCOBOL85などのコンパイラを用いて，コンパイル，リンケージします。コンパイルしたアプリケーションプログラムは，実行して問題なく動作するかを確認します。

COBOL2002またはCOBOL85を使用したアプリケーションプログラムのコンパイル，およびアプリケーションプログラムの実行については，「12　コンパイルし，実行しましょう」を参照してください。

また，コンパイルに使用するマップファイルやアプリケーションプログラムのサンプルについては，「7.4　画面の作成で使用したサンプルプログラムを紹介します」に記載してありますので，コンパイル時の参考に使用してください。

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

GUI画面の例題またはCUI画面の例題で作成されたファイルの一覧を示します。また，例題で使用するファイルが提供されているフォルダ，提供されているアプリケーションプログラムサンプル（APサンプル）のフォルダなどについて説明します。

＜この節の構成＞

(1)　使用するファイル一覧

(2)　例題で使用するファイルが提供されているフォルダ

(3)　提供されているアプリケーションプログラムサンプル（APサンプル）

(4)　C言語の場合に必要となるファイル

(1)　使用するファイル一覧

GUI画面の例題プログラムおよびCUI画面の例題プログラムを作成するために必要なファイルを次に示します。

(a)　GUI画面の例題

GUI画面の例題で使用するファイルを表7-1に示します。

表7-1　例題プログラムに使用するファイル（GUI画面）

ファイル名 | 用途 | 作成方法
JYU1GC.imp※ | マップ定義ファイル | ドロー機能でユーザが作成する
JYU1GCI.cbl | 入力論理マップ | 定義情報ファイル作成後，保存すると自動生成される
JYU1GCO.cbl | 出力論理マップ | 定義情報ファイル作成後，保存すると自動生成される
JYU1GCND.pmp | 物理マップ | 定義情報ファイル作成後，保存すると自動生成される
X3MODTBL.cbl※ | 動的変更テーブル | XMAP3の提供ファイルを利用する
JYUTUGC.cbl※ | COBOLソース | エディタでユーザが作成する
JYUTUGC.exe | 実行可能ファイル | COBOLソースに論理マップを取り込んでコンパイル，リンケージし作成する

注※

サンプルとして提供されています。格納場所は「（2） 例題で使用するファイルが提供されているフォルダ」を参照してください。

(b)　CUI画面の例題

CUI画面の例題で使用するファイルを表7-2に示します。

表7-2　例題プログラムに使用するファイル（CUI画面）

ファイル名 | 用途 | 作成方法
JYU1CC.IMP※ | マップ定義ファイル | ドロー機能でユーザが作成する
JYU1CCI.CBL | 入力論理マップ | 定義情報ファイル作成後，保存すると自動生成される
JYU1CCO.CBL | 出力論理マップ | 定義情報ファイル作成後，保存すると自動生成される
JYU1CCNC.PMP | 物理マップ | 定義情報ファイル作成後，保存すると自動生成される
X3MODTBL.CBL※ | 動的変更テーブル | XMAP3の提供ファイルを利用する
JYUTUCC.CBL※ | COBOLソース | エディタでユーザが作成する
JYUTUCC.EXE | 実行可能ファイル | COBOLソースに論理マップを取り込んでコンパイル，リンケージし作成する

注※

サンプルとして提供されています。格納場所については「（2） 例題で使用するファイルが提供されているフォルダ」を参照してください。

(2)　例題で使用するファイルが提供されているフォルダ

例題で使用するマップ定義ファイル，ソースプログラム，およびテキストファイルは，サンプルとして次のフォルダに提供されています。

　　XMAP3のインストールフォルダ¥Samples¥Cobol

なお，GUI画面およびCUI画面の例題では，動的変更テーブルの準備も必要です。これらのプログラムでは，出力エリア（出力論理マップ）を初期化する際に動的変更テーブルの指定を利用しています。動的変更テーブル「X3MODTBL」は，登録集原文としてXMAP3から次のフォルダに標準提供されています。作業用のフォルダに複写して利用しましょう。

　　XMAP3のインストールフォルダ¥Include

(3)　提供されているアプリケーションプログラムサンプル（APサンプル）

XMAP3では，このマニュアルの例題プログラムのほかに，APサンプルを標準提供しています。APサンプルでは，XMAP3を適用したユーザアプリケーションプログラムの例題を，マップ定義ファイルやソースプログラムなどを参照できます。このマニュアルの例題を一とおり学習したあと，さらに詳細な機能を知りたい場合や，業務開発の参考にしたい場合などにお役立てください。

アプリケーションプログラムの開発言語として，COBOLを中心にC言語，Visual Basic，Access，およびDelphiのサンプルが提供されています。提供フォルダを次に示します。

COBOL用

XMAP3のインストールフォルダ¥Samples¥Cobol

C言語用

XMAP3のインストールフォルダ¥Samples¥C

Visual Basic，Access，およびDelphi用

XMAP3のインストールフォルダ¥Samples¥Other

提供されているAPサンプルを，「付録F.3　提供APサンプル」に示します。詳しい利用方法については，各マニュアルまたはヘルプを参照してください。

(4)　C言語の場合に必要となるファイル

C言語で同様のアプリケーションプログラムを作成する場合，マップ定義ファイルやCOBOLソースプログラムは次のフォルダに格納されていますのでご利用ください。

　　XMAP3のインストールフォルダ¥Samples¥C

また，コンパイルの際にリンクする必要のあるファイルは次のとおりです。

ヘッダ

　　XMAP3のインストールフォルダ¥Include¥x3modtbl.h

　　XMAP3のインストールフォルダ¥Include¥jsvwatbl.h

ライブラリ

　　XMAP3のインストールフォルダ¥lib¥x3mwdr32.lib

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

この章では，納品伝票印刷（帳票）プログラムで使用するマップ帳票の作成方法を説明します。

＜この章の構成＞

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

8.2　帳票を作成しましょう

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

「受注データ入力プログラム」で画面から入力されたデータは，ファイルに出力されます。納品伝票印刷プログラムでは，そのファイルからデータを呼び出して帳票に出力します。

「納品伝票印刷プログラム（帳票）」では，シリアルインパクトプリンタ用（連続紙またはカット紙），およびページプリンタ用の帳票を作成できます。使用するプリンタに合わせて，作成する帳票を選んでください。なお，このマニュアルでは，ページプリンタ用の帳票の作成を例に説明します。

例題で作成するマップ帳票のイメージを，図8-1に示します。

図8-1　例題で作成する帳票

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

＜この節の構成＞

(1)　帳票例題のレイアウト定義に関する注意事項

(1)　帳票例題のレイアウト定義に関する注意事項

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

8.2　帳票を作成しましょう

図8-1の例題の帳票は，次に示す作成手順に従って作成します。

定義を開始します

タイトルを定義します

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

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

表の見出しを定義します

表の出力欄を定義します

合計欄を定義します

表けい線の枠を引きます

完成した帳票を確認します

定義を終了します

＜この節の構成＞

(1)　定義を開始します

(2)　タイトルを定義します

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

(4)　完成した帳票を確認します

(5)　定義を終了します

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

(1)　定義を開始します

［スタート］－［プログラム］－［XMAP3］から［ドロー］アイコンを選びます。
「新規・更新選択」ダイアログボックスが表示されます。

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

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

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

［定義対象の選択］から「グラフィック帳票」を選び，［パターンの選択］から「フリー」を選びます。［言語種別］が「COBOL」になっていることを確認します。

［OK］ボタンを選びます。
「グラフィック帳票属性」ダイアログボックスが表示されます。

［OK］ボタンを選びます。
「帳票定義」ウィンドウが表示されます。

(2)　タイトルを定義します

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

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

「納△△品△△伝△△票」と入力したあとで，［Enter］キーを押します。
注　’△’は，半角１文字分の空白を表します。

ツールバーから[図データ]（文字属性）を選びます。

「納△△品△△伝△△票」をクリックしたあとで，ツールボックスから[図データ]（倍角）を選びます。

ツールバーから[図データ]（レイアウトへ戻る）を選びます。
「帳票定義」ウィンドウが表示されます。

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

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

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

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

「得意先コード:」と入力したあとで，［Enter］キーを押します。
「:」は半角文字で入力します。

ツールボックスの[図データ]（出力フィールド（数字））を数回クリックして[図データ]（出力フィールド（英数））を選びます。

レイアウト領域の「縦 5 行」「横 17 列」にポインタを位置づけ，「横８列」分ドラッグします。

同様に，「得意先名」の欄を次のように定義します。

(b)　表の見出しを定義します

最初に「商品コード」を定義します。ツールボックスから[図データ]（固定フィールド（日本語））を選びます。

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

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

同様に，「商品名」「単価」「数量」，および「金額」の見出しを，次のように定義します。

(c)　表の出力欄を定義します

最初に，商品コードの出力領域を定義します。ツールボックスから[図データ]（出力フィールド（英数））を選びます。

レイアウト領域の「縦 9 行」「横 6 列」にポインタを位置づけ，［Shift］キーを押しながら，「縦4行」，「横5列」サイズ分ドラッグします。

フィールドが縦４行分反復します。
同様に，「商品名」「数量」の出力フィールドを次のように定義します。

単価の出力欄を定義します。ツールボックスから[図データ]（出力フィールド（数字））を選びます。

レイアウト領域の「縦 9 行」「横 45 列」にポインタを位置づけ，［Shift］キーを押しながら，「縦 4 行」「横 7 列」サイズ分ドラッグします。

「単価」と「数量」の出力フィールドをダブルクリックします。
「出力フィールド」ダイアログボックスが表示されます。

[APが渡す項目]の[データ型]をそれぞれ次のように選びます。

「単価」・・・「Z,ZZ9」

「数量」・・・「ZZZZ9」

［OK］ボタンを選びます。
「出力フィールド」ダイアログボックスが閉じ，「帳票定義」ウィンドウが表示されます。
同様に，「金額」の出力フィールドのデータ型を次のように定義します。

(d)　合計欄を定義します

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

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

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

ツールボックスから[図データ]（出力フィールド（数字））を選びます。

レイアウト領域の「縦 14 行」「横 57 列」にポインタを位置づけ，「横 18 列」分ドラッグします。

「合計」の出力フィールドをダブルクリックします。
「出力フィールド」ダイアログボックスが表示されます。

［APが渡す項目］の［データ型］から「¥,¥¥9」を選びます。

［OK］ボタンを選びます。
「出力フィールド」ダイアログボックスが閉じ，「帳票定義」ウィンドウが表示されます。

ツールボックスから[図データ]（縦（左）／横（上）けい線）を選びます。

レイアウト領域の「縦 15 行」「横 49 列」にポインタを位置づけ，「横 27 列」分ドラッグします。
マウスボタンから指を離すと，横けい線が配置されます。

(e)　表けい線の枠を引きます

ツールボックスの[図データ]（表けい線の枠（見出しなし））を数回クリックして，[図データ]（表けい線の枠（見出しあり））を選択します。

レイアウト領域の「縦 8 行」「横 3 列」にポインタを位置づけ，「縦 5 行」「横 74 列」サイズ分ドラッグします。
マウスボタンから指を離すと，表の枠とタイトル部の横けい線が配置されます。

ツールボックスから[図データ]（横けい線の繰り返し（２行間隔））を数回クリックして，[図データ]（横けい線の繰り返し（１行間隔））を選択します。

レイアウト領域の「縦 8 行」「横 3 列」にポインタを位置づけ，「縦 5 行」「横 74 列」サイズ分ドラッグします。
マウスボタンから指を離すと，横けい線が配置されます。

(4)　完成した帳票を確認します

ツールバーから[図データ]（印刷プレビュー）を選びます。
「プレビュー」ウィンドウが表示され，帳票レイアウトを確認できます。

気になる部分があれば，「2.2.5　レイアウト定義の基本操作を紹介します」を参照して修正してください。
なお，表示・印刷セットアップで印刷環境が設定されている場合は，ツールバーの[図データ]（テスト印刷）で帳票をテスト印刷できます。

ツールバーから[図データ]（論理マップ表示）を選びます。
「帳票用論理マップ表示」ウィンドウが表示され，論理マップを確認できます。

「プレビュー」ウィンドウ，および「帳票用論理マップ表示」ウィンドウのそれぞれの［閉じる］ボタンを選びます。

(5)　定義を終了します

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

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

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

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

定義した画面の各項目に対応するデータ名（COBOLプログラムで参照・更新するデータ領域の名称）は，XMAP3が適当な名称を仮定します。通常の開発手順では，仮定されたデータ名を参照しながらコーディングを行います。

ただし，製品添付のCOBOLプログラムのコーディングサンプルをそのまま使う場合には，各項目のデータ名は，コーディングサンプルで参照・更新している領域名称に合わせておく必要があります。

製品添付のCOBOLプログラムをそのまま使用する場合には，ドローのレイアウト定義画面から，メニューバーの［属性］－［データ名］を選んで「データ名」画面を表示し，データ名を修正する必要があります。

サンプルで設定しているデータ名を次に示します。データ名が異なる場合は，次の内容に合わせて修正してください。なお，データ名とオブジェクト名の対応については「付録A　例題プログラムの論理マップ」を参照してください。

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　納品伝票印刷プログラム（帳票）の処理の流れ

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

納品伝票印刷プログラム（帳票）のコーディングから重要な部分を抜粋したものを図9-2から図9-3に示し，ポイントを説明します。なお，このプログラムで使用する論理マップの内容は，「付録A　例題プログラムの論理マップ」で解説しています。必要に応じて参照してください。

図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パターンを基にして，使用するマップ名や業務固有の手続きをコーディングしていきましょう。

完成したコーディングは，サンプル（COBOLソースプログラム）として提供されています。ソースリストを印刷したり，エディタで開いたりして参考にすることをお勧めします。詳細については，「9.4　帳票の作成で使用したサンプルプログラムを紹介します」を参照してください。

＜この節の構成＞

(1)　APパターンを利用してコーディングしましょう

(2)　サンプルを利用してコーディングするときの注意事項

(1)　APパターンを利用してコーディングしましょう

使用しているエディタのウィンドウを開きます。

APパターン「GENREP01.cbl」を開きます※。
APパターンは，次のフォルダに格納されています。
　　XMAP3のインストールフォルダ¥Patterns¥Cobol

コーディングします。
固有のプログラム名，マップ名，データ定義や手続きなどを記述してソースプログラムを作成します。手続きのコーディングには，共通処理として用意されているAP部品を処理内容に合わせて挿入します。

コーディングが終了したら，エディタのウィンドウを閉じて保存します。

注※

　COBOLエディタを使用している場合は，次の説明を参照してください。

COBOLエディタでプログラムテンプレートを利用するには

COBOLエディタでのプログラムテンプレートの利用手順を説明します。なお，COBOL85 Version 5.0でプログラムテンプレートを利用するには，あらかじめ，XMAP3のAPパターンを登録しておく必要があります。APパターンの登録方法については「4.2.4　APパターンをCOBOLエディタのテンプレートに登録します（COBOL85 Version 5.0の場合）」を参照してください。

COBOL2002，COBOL85 Version 7およびVersion 6の場合

COBOLエディタウィンドウのメニューバー［ファイル］－［新規作成］を選びます。
「新規作成」ダイアログが表示されます。

作成したいファイルの種類を選びます。

［...］ボタンを選び，表示されるダイアログボックスからテンプレートファイルを選びます。
テンプレートファイルは次の場所に格納されています。
XMAP3のインストールフォルダ¥Patterns¥Cobol

プログラムテンプレートのチェックボックスをオンにします。

［OK］ボタンを選びます。
新規にファイルが作成され，テンプレートの内容が表示されます。
APパターンを挿入するには，挿入したい行にテキストカーソルを位置づけ，メニューバー［編集］－［ファイルの挿入］を選びます。ダイアログボックスに表示されたファイルの一覧から，目的のAP部品を選択してください。

COBOL85 Version 5.0の場合

COBOLエディタウィンドウのメニューバー［ファイル］－［新規作成］を選びます。
「新規作成」ダイアログが表示されます。

ファイルタイプから作成したいファイルの種類を選びます。

テンプレートファイルの一覧から，目的のAPパターンを選びます。

［OK］ボタンを選びます。
APパターンを挿入するには，挿入したい行にテキストカーソルを位置づけ，メニューバー［編集］－［ファイルの挿入］を選びます。ダイアログボックスに表示されたファイルの一覧から，目的のAP部品を選択してください。

(2)　サンプルを利用してコーディングするときの注意事項

なお，5章，6章で作成した画面は，APパターンを使わずに，製品添付のCOBOLプログラムをそのまま使ってコンパイル・実行できます。このとき，作成した画面の各オブジェクトのデータ名とコーディングサンプル中のデータ名を合わせておく必要があります。

データ名を合わせるには，次に示す方法があります。

コーディングサンプルを作成した画面のデータ名に合わせて修正する。

ドローのレイアウト定義の「データ名編集」ダイアログボックスで，コーディングサンプルで使用しているデータ名に変更する。

ドローのレイアウト定義での変更については「5.2(6)　オブジェクトのデータ名に関する注意事項」を参照してください。

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

作成した帳票例題のマップファイルと，アプリケーションプログラムをCOBOL2002やCOBOL85などのコンパイラを用いて，コンパイル，リンケージします。コンパイルしたアプリケーションプログラムは，実行して問題なく動作するかを確認します。

COBOL2002またはCOBOL85を使用したアプリケーションプログラムのコンパイル，およびアプリケーションプログラムの実行については，「12　コンパイルし，実行しましょう」を参照してください。

また，コンパイルに使用するマップファイルやアプリケーションプログラムのサンプルについては，「9.4　帳票の作成で使用したサンプルプログラムを紹介します」に記載してありますので，コンパイル時の参考に使用してください。

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

帳票の例題で作成されたファイルの一覧を示します。また，例題で使用するファイルが提供されているフォルダ，提供されているアプリケーションプログラムサンプル（APサンプル）のフォルダなどについて説明します。

＜この節の構成＞

(1)　使用するファイル一覧

(2)　例題で使用するファイルが提供されているフォルダ

(3)　提供されているアプリケーションプログラムサンプル（APサンプル）

(4)　C言語の場合に必要となるファイル

(1)　使用するファイル一覧

帳票印刷の例題で使用するファイルを表9-1に示します。

表9-1　例題プログラムに使用するファイル（帳票印刷）

ファイル名 | 用途 | 作成方法
JYU1PC.imp※¹ | マップ定義ファイル | ドロー機能でユーザが作成する
JYU1PCO.cbl | 出力論理マップ | 定義情報ファイル作成後，保存すると自動生成される
JYU1PC6G.pmp※² | 物理マップ | 定義情報ファイル作成後，保存すると自動生成される
X3MODTBL.cbl※¹ | 動的変更テーブル | XMAP3の提供ファイルを利用する
JYUTUPC.cbl※¹ | COBOLソース | エディタでユーザが作成する
JYUTUPC.exe | 実行可能ファイル | COBOLソースに論理マップを取り込んでコンパイル，リンケージし作成する

注※１

サンプルとして提供されています。格納場所は「（2） 例題で使用するファイルが提供されているフォルダ」を参照してください。

注※２

グラフィック帳票の場合のファイル名です。

(2)　例題で使用するファイルが提供されているフォルダ

例題で使用するマップ定義ファイル，ソースプログラム，およびテキストファイルは，サンプルとして次のフォルダに提供されています。

　　XMAP3のインストールフォルダ¥Samples¥Cobol

なお，帳票の例題では，動的変更テーブルの準備も必要です。これらのプログラムでは，出力エリア（出力論理マップ）を初期化する際に動的変更テーブルの指定を利用しています。動的変更テーブル「X3MODTBL」は，登録集原文としてXMAP3から次のフォルダに標準提供されています。作業用のフォルダに複写して利用しましょう。

　　XMAP3のインストールフォルダ¥Include

(3)　提供されているアプリケーションプログラムサンプル（APサンプル）

XMAP3では，このマニュアルの例題プログラムのほかに，APサンプルを標準提供しています。APサンプルでは，XMAP3を適用したユーザアプリケーションプログラムの例題を，マップ定義ファイルやソースプログラムなどを参照できます。このマニュアルの例題を一とおり学習したあと，さらに詳細な機能を知りたい場合や，業務開発の参考にしたい場合などにお役立てください。

アプリケーションプログラムの開発言語として，COBOLを中心にC言語，Visual Basic，Access，およびDelphiのサンプルが提供されています。提供フォルダを次に示します。

COBOL用

XMAP3のインストールフォルダ¥Samples¥Cobol

C言語用

XMAP3のインストールフォルダ¥Samples¥C

Visual Basic，Access，およびDelphi用

XMAP3のインストールフォルダ¥Samples¥Other

提供されているAPサンプルを，「付録F.3　提供APサンプル」に示します。詳しい利用方法については，各マニュアルまたはヘルプを参照してください。

(4)　C言語の場合に必要となるファイル

C言語で同様のアプリケーションプログラムを作成する場合，マップ定義ファイルやC言語ソースプログラムは次のフォルダに格納されていますのでご利用ください。

　　XMAP3のインストールフォルダ¥Samples¥C

また，コンパイルの際にリンクする必要のあるファイルは次のとおりです。

ヘッダ

　　XMAP3のインストールフォルダ¥Include¥x3modtbl.h

　　XMAP3のインストールフォルダ¥Include¥jsvwatbl.h

ライブラリ

　　XMAP3のインストールフォルダ¥lib¥x3mwdr32.lib

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

この章では，「納品伝票印刷プログラム」（書式オーバレイ）で使用する書式帳票の作成方法を説明します。

＜この章の構成＞

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

10.2　書式を作成しましょう

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

例題で作成する書式のイメージを，図10-1に示します。

図10-1　例題で作成する書式

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

10.2　書式を作成しましょう

図10-1の例題は，次に示す作成手順に従って書式帳票を作成します。

定義を開始します

タイトルを定義します

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

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

明細の表の見出しを定義します

明細の表のけい線を定義します

明細行の網掛けを定義します

合計欄を定義します

完成した書式を確認します

定義を終了します

＜この節の構成＞

(1)　定義を開始します

(2)　タイトルを定義します

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

(4)　完成した書式を確認します

(5)　定義を終了します

(1)　定義を開始します

［スタート］－［プログラム］－［XMAP3］から［ドロー］アイコンを選びます。
「新規・更新選択」ダイアログボックスが表示されます。

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

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

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

［定義対象の選択］から「書式オーバレイ」を選び，［パターンの選択］から「A4横 9ポイント文字，5ポイント間隔（10CPI），6LPI」を選びます。

［OK］ボタンを選びます。
「書式定義」ウィンドウが表示されます。

(2)　タイトルを定義します

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

レイアウト領域の「縦 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.～5.の操作を繰り返して，残りの破線を引きます。

(d)　明細行の網掛けを定義します

ツールボックスの[図データ]（網掛け（ラウンドコーナ））を数回クリックして[図データ]（網掛けの繰り返し（1行間隔））選びます。

レイアウト定義の「縦 9 行」「横 3 列」にポインタを位置づけ，「縦 4 行」「横 72 列」サイズ分ドラッグします。
1行置きに網掛けが定義されます。

(e)　合計欄を定義します

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

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

「合計」と入力したあとで，［Enter］キーを押します。

ツールボックスから[図データ]（縦（左）／横（上）けい線）を選びます。

レイアウト領域の「縦 15 行」「横 49 列」にポインタを位置づけ，「横 23 列」サイズ分ドラッグします。
ここで，けい線の種類を実線（中）に変更します。操作手順は「(c)　明細の表のけい線を定義します」を参考にしてください。

ツールバーから[図データ]（レイアウトへ戻る）を選びます。

(4)　完成した書式を確認します

ツールバーから[図データ]（印刷プレビュー）を選びます。

書式帳票がテスト表示されます。気になる部分があれば，「2.2.5　レイアウト定義の基本操作を紹介します」を参照して修正してください。

なお，表示・印刷セットアップで印刷環境が設定されている場合は，ツールバーの[図データ]（テスト印刷）で書式をテスト印刷できます。

テスト印刷をする場合は，メニューバーの［ツール］－［印刷先の設定］で，サービス名が表示・印刷セットアップで設定した名称と同じかどうか確認してください。

(5)　定義を終了します

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

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

ファイル名を確認して［保存］ボタンを選びます。
自動的に書式データファイルと行制御データファイルが生成されます。

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　納品伝票印刷プログラム（書式オーバレイ）の処理の流れ

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

納品伝票印刷プログラム（書式オーバレイ）のコーディングから重要な部分を抜粋したものを図11-2から図11-3に示し，ポイントを説明します。

図11-2　ポイントとなる部分のコーディング（書式オーバレイ）（1/2）

図11-3　ポイントとなる部分のコーディング（書式オーバレイ）（2/2）

ポイント１　ファイル管理記述項に書式印刷するプリンタを割り当てます

書式オーバレイ印刷するプリンタのファイル名を指定し，外部装置に割り当てます。ここでは，ファイル名に「プリンタ」を，外部装置名に環境変数「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パターンを基にして，使用する書式名や業務固有の手続きをコーディングしていきましょう。

完成したコーディングは，サンプル（COBOLソースプログラム）として提供されています。ソースリストを印刷したり，エディタで開いたりして参考にすることをお勧めします。詳細については，「11.4　書式の作成で使用したサンプルプログラムを紹介します 」を参照してください。

＜この節の構成＞

(1)　APパターンを利用してコーディングしましょう

(1)　APパターンを利用してコーディングしましょう

使用しているエディタのウィンドウを開きます。

APパターン「GENOVL01.cbl」を開きます※。
APパターンは，次のフォルダに格納されています。
　　XMAP3のインストールフォルダ¥Patterns¥Cobol

コーディングします。
固有のプログラム名，書式名，データ定義や手続きなどを記述してソースプログラムを作成します。

コーディングが終了したら，エディタのウィンドウを閉じて保存します。

注※

　COBOLエディタを使用している場合は，次の説明を参照してください。

COBOLエディタでプログラムテンプレートを利用するには

COBOLエディタでのプログラムテンプレートの利用手順を説明します。なお，COBOL85 Version 5.0でプログラムテンプレートを利用するには，あらかじめ，XMAP3のAPパターンを登録しておく必要があります。APパターンの登録方法については「4.2.4　APパターンをCOBOLエディタのテンプレートに登録します（COBOL85 Version 5.0の場合）」を参照してください。

COBOL2002，COBOL85 Version 7およびVersion 6の場合

COBOLエディタウィンドウのメニューバー［ファイル］－［新規作成］を選びます。
「新規作成」ダイアログが表示されます。

作成したいファイルの種類を選びます。

［...］ボタンを選び，表示されるダイアログボックスからテンプレートファイルを選びます。
テンプレートファイルは次の場所に格納されています。
XMAP3のインストールフォルダ¥Patterns¥Cobol

プログラムテンプレートのチェックボックスをオンにします。

［OK］ボタンを選びます。
新規にファイルが作成され，テンプレートの内容が表示されます。
APパターンを挿入するには，挿入したい行にテキストカーソルを位置づけ，メニューバー［編集］－［ファイルの挿入］を選びます。ダイアログボックスに表示されたファイルの一覧から，目的のAP部品を選択してください。

COBOL85 Version 5.0の場合

COBOLエディタウィンドウのメニューバー［ファイル］－［新規作成］を選びます。
「新規作成」ダイアログが表示されます。

ファイルタイプから作成したいファイルの種類を選びます。

テンプレートファイルの一覧から，目的のAPパターンを選びます。

［OK］ボタンを選びます。
APパターンを挿入するには，挿入したい行にテキストカーソルを位置づけ，メニューバー［編集］－［ファイルの挿入］を選びます。ダイアログボックスに表示されたファイルの一覧から，目的のAP部品を選択してください。

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

作成した書式例題のマップファイルと，アプリケーションプログラムをCOBOL2002やCOBOL85などのコンパイラを用いて，コンパイル，リンケージします。コンパイルしたアプリケーションプログラムは，実行して問題なく動作するかを確認します。

COBOL2002またはCOBOL85を使用したアプリケーションプログラムのコンパイル，およびアプリケーションプログラムの実行については，「12　コンパイルし，実行しましょう」を参照してください。

また，コンパイルに使用するマップファイルやアプリケーションプログラムのサンプルについては，「11.4　書式の作成で使用したサンプルプログラムを紹介します」に記載してありますので，コンパイル時の参考に使用してください。

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

書式の例題で作成されたファイルの一覧を示します。また，例題で使用するファイルが提供されているフォルダ，提供されているアプリケーションプログラムサンプル（APサンプル）のフォルダなどについて説明します。

＜この節の構成＞

(1)　例題で使用するファイル一覧

(2)　例題で使用するファイルが提供されているフォルダ

(3)　提供されているアプリケーションプログラムサンプル（APサンプル）

(4)　C言語の場合に必要となるファイル

(1)　例題で使用するファイル一覧

書式オーバレイ印刷の例題で使用するファイルを表11-1に示します。

表11-1　例題プログラムに使用するファイル（書式オーバレイ印刷）

ファイル名 | 用途 | 作成方法
JYU1FC.ifm※ | 書式定義ファイル | ドロー機能でユーザが作成する
JYU1FC6G.fmp | 書式イメージファイル | 定義情報ファイル作成後，保存すると自動生成される
JYU1FC6G.pci | 行制御データファイル | 定義情報ファイル作成後，保存すると自動生成される
JYUTUFC.cbl※ | COBOLソース | エディタでユーザが作成する
JYUTUFC.txt※ | 行データのテキストファイル | エディタでユーザが作成する
JYUTUFC.exe | 実行可能ファイル | COBOLソースをコンパイル，リンケージし作成する

注※

サンプルとして提供されています。格納場所は「（2） 例題で使用するファイルが提供されているフォルダ」を参照してください。

(2)　例題で使用するファイルが提供されているフォルダ

例題で使用するマップ定義ファイル，ソースプログラム，およびテキストファイルは，サンプルとして次のフォルダに提供されています。

　　XMAP3のインストールフォルダ¥Samples¥Cobol

(3)　提供されているアプリケーションプログラムサンプル（APサンプル）

XMAP3では，このマニュアルの例題プログラムのほかに，APサンプルを標準提供しています。APサンプルでは，XMAP3を適用したユーザアプリケーションプログラムの例題を，マップ定義ファイルやソースプログラムなどを参照できます。このマニュアルの例題を一とおり学習したあと，さらに詳細な機能を知りたい場合や，業務開発の参考にしたい場合などにお役立てください。

アプリケーションプログラムの開発言語として，COBOLを中心にC言語，Visual Basic，Access，およびDelphiのサンプルが提供されています。提供フォルダを次に示します。

COBOL用

XMAP3のインストールフォルダ¥Samples¥Cobol

C言語用

XMAP3のインストールフォルダ¥Samples¥C

Visual Basic，Access，およびDelphi用

XMAP3のインストールフォルダ¥Samples¥Other

提供されているAPサンプルを「付録F.3　提供APサンプル」に示します。詳しい利用方法については，各マニュアルまたはヘルプを参照してください。

(4)　C言語の場合に必要となるファイル

C言語で同様のアプリケーションプログラムを作成する場合，マップ定義ファイルやC言語ソースプログラムは次のフォルダに格納されていますのでご利用ください。

XMAP3のインストールフォルダ¥Samples¥C

また，コンパイルの際にリンクする必要のあるファイルは次のとおりです。

ヘッダ

　　XMAP3のインストールフォルダ¥Include¥jstglcom.h

ライブラリ

　　XMAP3のインストールフォルダ¥lib¥x3klib32.lib

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

この章では，COBOL2002またはCOBOL85を使ったコンパイルおよび実行に必要な前準備と，例題のアプリケーションプログラムをコンパイルして実行する方法について説明します。

＜この章の構成＞

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

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

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

COBOL2002またはCOBOL85でコンパイル，実行する前の準備について説明します。

＜この節の構成＞

12.1.1　コンパイルの準備

12.1.2　実行の準備

12.1.1　コンパイルの準備

アプリケーションプログラムをコンパイルして，実行可能ファイルを準備するまでの主なデータの流れとフォルダ例を，次に示します。

＜この項の構成＞

(1)　XMAP3と連携するためのコンパイラオプションを指定します

(2)　動的変更テーブルの格納フォルダを指定します

(1)　XMAP3と連携するためのコンパイラオプションを指定します

必要なコンパイラオプションを次に示します。

画面・帳票

COBOL2002の場合
-Comp5および-JPN,Alnumオプションを必ず指定してください。-Comp5は，USAGE句のCOMP-5指定を利用できるようにするオプションです。また，-JPN,Alnumは，日本語項目，日本語編集項目をそれぞれ英数字項目，英数字編集項目として扱うようにするオプションです。どちらも論理マップの生成内容に関連しています。

COBOL85の場合
-X5および-Naオプションを必ず指定してください。-X5は，USAGE句のCOMP-5指定を利用できるようにするオプションです。また，-Naは，日本語項目，日本語編集項目をそれぞれ英数字項目，英数字編集項目として扱うようにするオプションです。どちらも論理マップの生成内容に関連しています。

書式オーバレイ

COBOL2002の場合
-XMAP,LinePrintオプションを必ず指定してください。-XMAP,LinePrintは，XMAP3の書式オーバレイや印刷制御機能を利用できるようにするオプションです。

COBOL85の場合
-Ksオプションを必ず指定してください。-Ksは，XMAP3の書式オーバレイや印刷制御機能を利用できるようにするオプションです。

(2)　動的変更テーブルの格納フォルダを指定します

動的変更テーブルのように，ソースプログラムが格納されているフォルダ以外のフォルダから登録集原文を参照するとき，登録集原文を格納するフォルダをコンパイル時の環境変数CBLLIBに指定します。XMAP3から生成された登録集原文も，ユーザが作成した原文と同様に扱うこともできます。コンパイルでは，COPY文で定義した原文名が，指定したフォルダから検索され，アプリケーションプログラムに取り込まれます。なお，ソースプログラムと登録集原文を同じフォルダに格納している場合は，環境変数を指定しなくてもかまいません。

注１

リンケージでは，COBOL2002またはCOBOL85のリンカからXMAP3が提供しているライブラリが検索されます。

注２

画面または帳票を使用するアプリケーションプログラムをコンパイルする場合は，次の点に注意してください。

レイアウト定義で，例えば，入出力テキストなどの，アプリケーションプログラムとデータをやり取りする項目を，誤って削除したり，データ名を変更したりする場合があります。

削除または変更前の論理マップに使われているデータ名で，手続きをコーディングしていると，コンパイル時にエラーとなります。したがって，レイアウト定義を変更した場合には，生成された論理マップ，およびコーディングを確認したうえ，コンパイルしてください。

12.1.2　実行の準備

単独のPC上（スタンドアロン構成）でアプリケーションプログラムを実行するときの主なデータの流れとフォルダ例を，次に示します。XMAP3を使ったアプリケーションプログラムの実行には，XMAP3の実行環境と，COBOL2002またはCOBOL85の実行環境が必要です。

＜この項の構成＞

(1)　定義体と実行可能ファイル（アプリケーションプログラム）を同じフォルダに格納します

(2)　印刷環境を設定します（帳票・書式の場合）

(1)　定義体と実行可能ファイル（アプリケーションプログラム）を同じフォルダに格納します

アプリケーションプログラムを実行する前に，必要なファイルを実行用のフォルダに準備します。

画面・帳票

物理マップ（拡張子「.pmp」）を実行可能ファイルと同じフォルダに格納しておきます。

書式オーバレイ

書式イメージファイル（拡張子「.fmp」）と行制御データファイル（拡張子「.pci」）を，実行可能ファイルと同じフォルダに格納しておきます。

(2)　印刷環境を設定します（帳票・書式の場合）

Windows上でのプリンタの設定

使用するプリンタに対応するプリンタドライバを組み込みます。次に，使用するプリンタを，通常使うプリンタとして設定しておきます。

表示・印刷セットアップ

「表示・印刷セットアップ」ダイアログボックスの「プリンタ」タブで，仮想端末「PRT001」，およびサービス名「#PRT」を標準プリンタ（ページプリンタ）として割り当てておきます。標準プリンタ以外のページプリンタに印刷する場合は，サービス名「#PRT1」を割り当ててください。

「表示・印刷セットアップ」ダイアログボックスについては，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

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

GUI画面の例題プログラムを例に，アプリケーションプログラムをCOBOL2002またはCOBOL85でコンパイル，実行する方法について説明します。

COBOL2002を使用する場合の詳細については，マニュアル「COBOL2002 操作ガイド」を参照してください。COBOL85を使用する場合の詳細については，マニュアル「COBOL85 操作ガイド」を参照してください。

＜この節の構成＞

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

12.2.2　コンパイルします（COBOL2002，COBOL85 Version 7，およびVersion 6の場合）

12.2.3　実行します（COBOL2002，COBOL85 Version 7，およびVersion 6の場合）

12.2.4　コンパイルします（COBOL85 Version 5.0の場合）

12.2.5　実行します（COBOL85 Version 5.0の場合）

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

画面，帳票，および書式の例題作成で作成されたマップファイル，APサンプルをコンパイルするための作業フォルダを準備します。

ここでは，次に示す作業フォルダを作成し，その下で例題アプリケーションプログラムをコンパイルします。

　　C:¥xmap3¥nyumon¥test

＜この項の構成＞

(1)　作業フォルダに格納するファイル（ユーザ作成）

(2)　作業フォルダに格納するファイル（自動生成されるファイル）

(3)　作業フォルダに格納するファイル（提供ファイル）

(4)　コンパイルを実行した結果作成されるファイル

(1)　作業フォルダに格納するファイル（ユーザ作成）

これまでに例題で作成したレイアウト定義のファイル（マップ定義ファイル，または書式定義ファイル）と，COBOLソースプログラムファイルを複写してコンパイル用の作業フォルダ（例 C:¥xmap3¥nyumon¥test）に格納してください。

なお，これらのファイルはサンプルとしても提供されています。サンプル格納先は，次のとおりです。

XMAP3のインストールフォルダ¥Samples¥Cobol

ファイルの種類 | 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　コンパイルします（COBOL2002，COBOL85 Version 7，およびVersion 6の場合）

コンパイルは，COBOL85 Version 6　06-03のもので説明しています。GUI画面の例題プログラムを例に，コンパイル手順について説明します。帳票の例題アプリケーションプログラムのコンパイルは，GUI画面の例題プログラムと同じ操作でコンパイルできます。

「COBOL開発マネージャ」ウィンドウを表示させます。

メニューバーの［プロジェクトマスタ］－［新規作成］コマンドを選択します。
「プロジェクトマスタの作成」ダイアログボックスが表示されます。

プロジェクトマスタ名，およびプロジェクトマスタフォルダ名を入力します。

［完了］ボタンを選びます。
「プロジェクトの作成」ダイアログボックスが表示されます。

プロジェクト名を入力します。

［OK］ボタンを選びます。
「プロジェクトの追加」ダイアログボックスが表示されます。

［実行形式プログラム］を選び，［次へ］ボタンを選びます。

COBOL85 Version 6

COBOL2002，COBOL85 Version 7

プロジェクトの種類に［-Mw指定メインプログラム］（COBOL2002の場合は［System指定メインプログラム］）を選び，［次へ］ボタンを選びます。

実行形式ファイル名「jyutugc.exe」を入力したあと，［次へ］ボタンを選びます。

注

CUI画面の場合
実行形式ファイル名「jyutucc.exe」を入力してください。

帳票の場合
実行形式ファイル名「jyutupc.exe」を入力してください。

書式オーバレイの場合
実行形式ファイル名「jyutufc.exe」を入力してください。

プログラムのソースファイル名「JYUTUGC.cbl」を入力したあと，［完了］ボタンを選びます。

「COBOL開発マネージャ」ウィンドウに戻り，実行可能ファイル名，COBOLソースファイル，および依存ファイルのフォルダが表示されます。

メニューバーの［プロジェクト］－［ソースファイルの追加］コマンドを選択し，マップ定義ファイル「JYU1GC.imp」を追加します。

COBOL85の「登録集原文」を入力するダイアログボックスが表示されます。ドローで生成された入力論理マップ「JYU1GCI.cbl」および出力論理マップ「JYU1GCO.cbl」を指定します。

注

CUI画面の場合
マップ定義ファイル名「JYU1CC.imp」，入力論理マップ「JYU1CCI.cbl」および出力論理マップ「JYU1CCO.cbl」を指定します。

帳票の場合
マップ定義ファイル名「JYU1PC.imp」，出力論理マップ「JYU1PCO.cbl」を入力します。さらに「ファイル名」に「JYU1PCI.cbl」と入力します。
補足説明
「JYU1PCI.cbl」は，実際には参照されないファイルですが，COBOL85との連携のために指定します。

書式オーバレイの場合
この操作は必要ありません。

コンパイラオプションに「-X5」（COBOL2002の場合は「-Comp5」）が追加された旨のメッセージが表示されます。

メニューバー［プロジェクト］－［プロジェクトの設定］コマンドを選びます。
「プロジェクト設定」ダイアログボックスが表示されます。

コンパイラオプションを設定します。
［その他］タブを選び，「-Na」（COBOL2002の場合は「-JPN,Alnum」）を設定します。

注

CUI画面の場合
［その他］タブを選び，「-Na」（COBOL2002の場合は「-JPN,Alnum」）を設定します。

帳票の場合
［その他］タブを選び，「-Na」（COBOL2002の場合は「-JPN,Alnum」）を設定します。

書式オーバレイの場合
［製品連携］タブを選び，「-Ks」（COBOL2002の場合は「-XMAP,LinePrint」）を設定します。

［環境変数］タブから環境変数CBLLIBに，論理マップや動的変更テーブルが格納されているフォルダ（XMAP3のインストールフォルダ¥Include）を設定します。

注

動的変更テーブルなどのAPで使う登録集原文を，別フォルダに格納している場合だけ設定してください。

書式オーバレイの場合
この操作は必要ありません。

メニューバーの［ビルド］－［ビルド］コマンドを選びます。

ビルドが完了すると，メッセージが表示されます。

エラーメッセージが表示された場合は，表示されたメッセージを基にデバッグをしてください。エラー内容については，COBOL2002，COBOL85，およびXMAP3のヘルプを参照してください。

12.2.3　実行します（COBOL2002，COBOL85 Version 7，およびVersion 6の場合）

実行を始める前に，次のファイルが実行可能ファイルと同じフォルダ（操作例では，C:¥xmap3¥nyumon¥testの下）に格納されているか確認しましょう。

画面，または帳票の例題

物理マップ（拡張子「.pmp」）

書式オーバレイの例題

書式イメージファイル（拡張子「.fmp」），行制御データファイル（拡張子「.pci」）

書式の例題では，このほかに，行データを入力するためのテキストファイル（JYUTUFC.txt）を準備します。例題で使用するテキストファイルはXMAP3で提供されています。ファイルの格納先は次のとおりです。

　　　XMAP3のインストールフォルダ¥Samples¥Cobol

また，印刷環境を次のとおりに設定してください。

Windows上でのプリンタ設定

使用するプリンタに対応するプリンタドライバを組み込みます。次に，使用するプリンタを，通常使うプリンタとして設定しておきます。

表示・印刷セットアップ

「表示・印刷セットアップ」ダイアログボックスの「プリンタ」タブで，仮想端末「PRT001」，およびサービス名「#PRT」を標準プリンタ（ページプリンタ）として割り当てておきます。標準プリンタ以外のページプリンタに印刷する場合は，サービス名「#PRT1」を割り当ててください。

「表示・印刷セットアップ」ダイアログボックスについては，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

COBOL開発マネージャのメニューバー［ビルド］－［実行］コマンドを選びます。

「実行」ダイアログボックスが表示されます。

［実行プログラム名］に実行したい実行可能ファイルの名称が表示されていることを確認して［OK］ボタンを選びます（COBOL2002またはCOBOL85 Version 7の場合は，[実行可能ファイル名]に実行したい実行可能ファイルの名称が表示されていることを確認して[OK]ボタンを選びます）。

COBOL85 Version 6

COBOL2002，COBOL85 Version 7

アプリケーションプログラムが実行されます。

注1

書式オーバレイの例題では，2.の手順で［OK］ボタンを選ぶと，物理ファイルを割り当てるダイアログボックスが表示されます。標準プリンタ（ページプリンタ）に印刷する場合は，環境変数CBLX_PRT001に「#PRT」を指定してください。標準プリンタ以外のページプリンタに印刷する場合は，「表示・印刷セットアップ」で割り当てた「#PRT1」を指定してください。

注２

帳票を印刷する場合に，ページプリンタ以外を標準プリンタにしているときは，印刷機能のセットアップが必要です。その場合は，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

12.2.4　コンパイルします（COBOL85 Version 5.0の場合）

コンパイルは，COBOL85 Version 5.0　05-03のもので説明しています。GUI画面の例題プログラムを例に，コンパイル手順について説明します。帳票の例題アプリケーションプログラムのコンパイルは，GUI画面の例題プログラムと同じ操作でコンパイルできます。

COBOL開発マネージャのウィンドウを開きます。

メニューバーの［ファイル］－［新規作成］コマンドを選択します。
「新規作成」ダイアログボックスが表示されます。

プロジェクトファイル名称を入力して，リンケージ処理を行う指定をします。
必要に応じて作業フォルダ，実行可能ファイル名を入力してください。

［OK］ボタンを選びます。
「編集」ダイアログボックスが表示されます。

ファイルリストから，コンパイルするソースプログラムを選択します。
「JYUTUGC.cbl」を選択します。

［追加］ボタンを選んだあと［閉じる］ボタンを選びます。
次のダイアログボックスが表示されます。

COBOL開発マネージャのメニューバー［オプション］－［コンパイラ］コマンドを選びます。
コンパイラオプションを指定するダイアログボックスが表示されます。

コンパイラオプションを設定します。

「-Na」と「-X5」を設定します。

注

書式オーバレイの場合は，「-Ks」を設定します。

［環境変数設定］ボタンを選びます。
「環境設定」ダイアログボックスが表示されます。

注

書式オーバレイの場合は，10. ～ 12.の操作は必要ありません。

環境変数CBLLIBに，動的変更テーブルが格納されているフォルダを設定します。

［OK］ボタンを選びます。
「コンパイラオプション」ダイアログボックスに戻ります。

コンパイラオプションのダイアログボックスの［OK］ボタンを選びます。
COBOL開発マネージャのウィンドウに戻ります。

「JYUTUGC.cbl」を選択し，メニューバーから［プロジェクト］－［編集］コマンドを選びます。
「編集」ダイアログが表示されます。

ドローで生成された入力論理マップ「JYU1GCI.cbl」および出力論理マップ「JYU1GCO.cbl」を指定します。

［追加］ボタンを選び，［閉じる］ボタンを選びます。
COBOL開発マネージャのウィンドウに戻ります。

メニューバーから［プロジェクト］－［編集］コマンドを使って画面のようなプロジェクト構成にします。

注

書式オーバレイの場合は，この操作は必要ありません。

メニューバー［プロジェクト］－［ビルド］コマンドを選びます。
ビルドが完了すると，メッセージが表示されます。
エラーメッセージが表示された場合は，表示されたメッセージを基にデバッグをしてください。エラー内容については，COBOL85，およびXMAP3のヘルプを参照してください。

12.2.5　実行します（COBOL85 Version 5.0の場合）

実行を始める前に，次のファイルが実行可能ファイルと同じフォルダ（操作例では，c:¥xmap3¥nyumon¥testの下）に格納されているか確認しましょう。

画面，または帳票の例題

物理マップ（拡張子「.pmp」）

書式オーバレイの例題

書式イメージファイル（拡張子「.fmp」），行制御データファイル（拡張子「.pci」）

書式の例題では，このほかに，行データを入力するためのテキストファイル（JYUTUFC.txt）を準備します。例題で使用するテキストファイルはXMAP3で提供されています。ファイルの格納先は次のとおりです。

　　　XMAP3のインストールフォルダ¥Samples¥Cobol

また，印刷環境を次のとおりに設定してください。

Windows上でのプリンタ設定

使用するプリンタに対応するプリンタドライバを組み込みます。次に，使用するプリンタを，通常使うプリンタとして設定しておきます。

表示・印刷セットアップ

「表示・印刷セットアップ」ダイアログボックスの「プリンタ」タブで，仮想端末「PRT001」，およびサービス名「#PRT」を標準プリンタ（ページプリンタ）として割り当てておきます。標準プリンタ以外のページプリンタに印刷する場合は，サービス名「#PRT1」を割り当ててください。

「表示・印刷セットアップ」ダイアログボックスについては，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

COBOL開発マネージャのメニューバー［実行］－［実行］コマンドを選びます。

「実行」ダイアログボックスが表示されます。

コマンドラインに実行したい実行可能ファイルの名称が表示されていることを確認して［OK］ボタンを選びます。

アプリケーションプログラムが実行されます。GUI画面の場合，次のダイアログボックスが表示されます。

注1

書式オーバレイの例題では，2.の手順で［OK］ボタンを選ぶと，物理ファイルを割り当てるダイアログボックスが表示されます。標準プリンタ（ページプリンタ）に印刷する場合は，環境変数CBLX_PRT001に「#PRT」を指定してください。標準プリンタ以外のページプリンタに印刷する場合は，「表示・印刷セットアップ」で割り当てた「#PRT1」を指定してください。

注２

帳票を印刷する場合に，ページプリンタ以外を標準プリンタにしているときは，印刷機能のセットアップが必要です。その場合は，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

注3

GUI画面，CUI画面では，設計した画面が表示されます。帳票，書式オーバレイでは，直接プリンタに出力されます。

付録

＜この付録の構成＞

付録A　例題プログラムの論理マップ

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

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

付録D　Visual Basic，Access，およびDelphiでのアプリケーションプログラムのコーディング例

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

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

付録G　XMAP3シリーズの提供機能一覧

付録H　用語解説

付録A　例題プログラムの論理マップ

画面，帳票の例題で使用する論理マップを示し，各データ項目の内容を解説します。

＜この節の構成＞

(1)　GUI画面用入力論理マップ（JYU1GCI）

(2)　GUI画面用出力論理マップ（JYU1GCO）

(3)　CUI画面用入力論理マップ（JYU1CCI）

(4)　CUI画面用出力論理マップ（JYU1CCO）

(5)　帳票用出力論理マップ（JYU1PCO）

(1)　GUI画面用入力論理マップ（JYU1GCI）

(2)　GUI画面用出力論理マップ（JYU1GCO）

(3)　CUI画面用入力論理マップ（JYU1CCI）

(4)　CUI画面用出力論理マップ（JYU1CCO）

(5)　帳票用出力論理マップ（JYU1PCO）

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

ここでは，このマニュアルの例題プログラムに盛り込まれた基本的な機能のほかに，XMAP3でできる応用的な機能を紹介します。

＜この節の構成＞

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

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

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

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

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

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

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

機能１　C言語を使ってアプリケーションプログラムを作成する

アプリケーションプログラムの開発言語にC言語を使用することもできます。

詳細については，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　画面編」または「画面・帳票サポートシステム XMAP3　プログラミングガイド　帳票編」を参照してください。なお，このマニュアルで紹介した例題のＣ言語を使用したサンプルは，「XMAP3のインストールフォルダ¥Samples¥C」に提供されています。

機能２　作成したレイアウト定義の内容をほかの言語用に変換する

作成したレイアウト定義の内容を，COBOLからＣ言語に，またはＣ言語からCOBOLに変換できます。変換には，ユティリティのコンバート機能を使用します。

操作方法については，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

機能３　TRANSCEIVE文やSEND文の代わりにCALL文を使って送受信する

画面の送受信，または帳票の送信命令には，COBOLの標準仕様であるCALL文を使うこともできます。この場合に使用するCALLインタフェースも標準提供されています。詳細については，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　画面編」または「画面・帳票サポートシステム XMAP3　プログラミングガイド　帳票編」を参照してください。

機能４　生成される論理マップのデータ名や展開順を変更する

レイアウト定義時に，論理マップに生成されるデータ名や展開順をデータ名編集ダイアログボックスで変更できます。なお，展開順はウィンドウに配置されたオブジェクトの位置の順にソートしたり，任意の順に変更したりできます。

詳細については，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　画面編」または「画面・帳票サポートシステム XMAP3　プログラミングガイド　帳票編」を参照してください。

機能５　テキストなどを反復して組み合わせ表形式で並べる

画面や帳票では，テキストなどを組み合わせて，縦方向または横方向に反復して表形式で並べることができます。この機能はフレームを使用して定義します。フレームは，テキストのほかにもポップアップやバーコードなどにも使用できます。

詳細については，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　画面編」または「画面・帳票サポートシステム XMAP3　プログラミングガイド　帳票編」を参照してください。

機能６　ドローの定義画面を複数表示してオブジェクトをコピーする

画面・帳票のレイアウトの定義時に，同じ定義対象のレイアウト定義画面を二つまで表示できます。表示したレイアウト定義画面から，オブジェクトを指定してレイアウト定義している画面にコピーできます。

詳細については，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　画面編」または「画面・帳票サポートシステム XMAP3　プログラミングガイド　帳票編」を参照してください。

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

＜この項の構成＞

(1)　レイアウト定義

(2)　アプリケーションプログラム作成

(1)　レイアウト定義

機能１　デフォルトでチェックボタンやラジオボタンを選択済みの状態にする

該当するボタンをダブルクリックすると，ダイアログボックスが表示されます。このダイアログボックスで，「選択済みにする」を選択してください。

機能２　壁紙を使用する

各オブジェクトの背後に壁紙としてグラフィックを表示できます。壁紙のグラフィックには，31,000バイト以下のビットマップファイル（.BMP）が使えます。壁紙は，画面属性ダイアログボックスで設定します。なお，設定した壁紙はテスト表示で確認できます。

機能３　数字やカナの入力チェックをXMAP3で行う

入出力テキストをダブルクリックすると，ダイアログボックスが表示されます。このダイアログボックスで「詳細目的」に「数字」や「カナ」などの組み合わせを設定すると，実行時に入力できる文字を制限します。

機能４　画面確定のタイミングを変更する

画面確定のタイミングは，アプリケーションプログラムに制御を渡す単位によって決まります。制御を渡す単位には，通常の方法（画面単位）のほかにフィールド単位やイベント単位などがあります。制御を渡す単位を変更するには，画面属性ダイアログボックスを使用します。

フィールド単位では，アプリケーションプログラムでフォーカスやカーソルを設定したオブジェクトだけが操作対象となります。このオブジェクトから次のオブジェクトにフォーカス・カーソルを移動するとアプリケーションプログラムに制御が渡されます。

イベント単位では，すべてのオブジェクト（不活性を指定しているものを除く）が活性状態で表示されます。これらのオブジェクトの一つから，データ入力または選択操作をしたあと，次のオブジェクトにカーソル・フォーカスを移動するとアプリケーションプログラムに制御が渡されます。

定義方法およびアプリケーションプログラムの作成方法については，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　画面編」を参照してください。

機能５　特定のキーを抑止する

PFキーを押してもアプリケーションプログラムに制御を返さないで，押されたことを無効にすることができます。また，有効・無効にするキーをアプリケーションプログラムで変更することもできます。

詳細は，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　画面編」を参照してください。

機能６　スプラッシュ画面を作成する

スプラッシュ画面を作成するには，画面が表示された直後に，アプリケーションプログラムに制御を渡します。表示直後にアプリケーションに制御を渡す設定は，画面属性ダイアログボックスを使用します。また，この制御を渡すまでの時間を任意に指定できます。

操作方法については，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　画面編」を参照してください。

機能７　フォーカスの移動順序を設定する

グループボックス間で，フォーカスを移動する順序を設定できます。グループボックスとは，画面上のオブジェクト（セパレータを除く）を囲んでグループ化するオブジェクトです。

操作方法については，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　画面編」を参照してください。

(2)　アプリケーションプログラム作成

アプリケーションプログラムでの応用的な機能を紹介します。機能１から機能４に関連するコーディングのひな型は，APパターンのAP部品に用意されています。画面用のAP部品の種類については，「付録F.1　APパターン一覧」を参照してください。

機能１　カーソルやフォーカス位置の設定を変更する

論理マップの中のカーソルまたはフォーカス制御項目に，位置づけたいフィールドやボックス対応の定数を設定することで，アプリケーションプログラムからカーソルまたはフォーカス位置の初期設定ができます。

この機能は，部品パターン「SETCRS01」に関連しています。コーディング方法については，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　画面編」を参照してください。

機能２　メッセージを二次ウィンドウで表示する

XMAP3で定義する画面には，一次ウィンドウと二次ウィンドウがあります。一次ウィンドウは，メインとなる画面で,何も表示されていない状態のときに表示します。業務を選択するメニューや，各業務の主画面として使用します。

二次ウィンドウは，一次ウィンドウを表示したまま新しく表示する画面です。データ入力の入力補助，メッセージ，ヘルプなどに使用します。メッセージを二次ウィンドウで表示するには，TRANSCEIVE文（またはRECEIVE文）で一次ウィンドウから入力したデータの内容を判定したあと，TRANSCEIVE文（またはSEND文）で表示するマップ名を二次ウィンドウのマップ名に変更します。このTRANSCEIVE文（またはSEND文）を実行すると，二次ウィンドウを使ってメッセージを表示できます。このとき，次の手順に従って，あらかじめ二次ウィンドウのレイアウトを確認しておいてください。

レイアウト定義ウィンドウを起動するときに表示されるダイアログボックスで，定義種別から「ディスプレイGUI画面（二次）」を選ぶ。さらに，使用する定義パターンを選択する。

レイアウト定義ウィンドウで画面のレイアウトを定義する。このとき，「OK」のような二次ウィンドウを終了するプッシュボタンを定義して，特定のイベント通知コードが返されたら二次ウィンドウを終了するように指定しておく。

この機能は，AP部品「FLDHLP01」と「PATWRT01」に関連しています。コーディングについては，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　画面編」を参照してください。

機能３　入力エラーのとき，テキストやフィールド(入出力)の色をアプリケーションプログラムで変更する

該当するオブジェクトをダブルクリックして，「動的変更（APから表示属性を変更する）」を選びます。アプリケーションプログラム実行時，制御項目に標準提供している動的変更テーブルのエラー修飾名'ER'を設定すると，赤色でフィールドを表示できます。この機能は，AP部品「ATRCRS01」と「MODATR01」に関連しています。

また，このほかの修飾名も用意されています。詳細は，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　画面編」を参照してください。

機能４　データエントリ画面で入力フィールドだけをクリアする

アプリケーションプログラム実行時，ウィンドウ制御に動的変更テーブルのウィンドウコントロール'CL'を設定すると，画面の入力テキストやフィールドに表示されていたデータがクリアされます。この機能は，AP部品「CLRINP01」に関連しています。詳細は，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　画面編」を参照してください。

機能５　グラフやイメージデータを表示する

グラフやイメージなどのグラフィックデータをアプリケーションプログラムから表示できます。表示するグラフィックデータは，あらかじめ，ほかのツールで作成してファイルやクリップボードに保存しておきます。

詳細は，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　画面編」を参照してください。

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

＜この項の構成＞

(1)　レイアウト定義

(2)　アプリケーションプログラム作成

(1)　レイアウト定義

機能１　用紙のフォーマットイメージをレイアウト定義ウィンドウの背後に表示しながら定義する

プレプリント帳票，グラフィック帳票，および書式オーバレイでは，帳票のフォーマットイメージをレイアウト定義ウィンドウの背後に下敷きとして表示しながら定義できます。用紙上のけい線などに合わせてオブジェクトの位置を調整する場合に使います。下敷きは，下敷きダイアログボックスで設定します。このダイアログボックスでは，下敷きとして使う用紙をスキャナで読み込むなどしたビットマップファイル（.BMP）を設定します。

操作方法については，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　帳票編」を参照してください。

機能２　シリアルプリンタ用に定義した帳票をページプリンタ用に変換する

シリアルプリンタ用に作成した帳票（けい線帳票）の定義内容を，ページプリンタ用の帳票（網掛け帳票）に変換できます。変換には，ユティリティのコンバート機能を使用します。既存の帳票定義をある程度流用できるように変換できます。

操作方法については，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

(2)　アプリケーションプログラム作成

アプリケーションプログラムでの応用的な機能を紹介します。

機能１　帳票のフィールドで文字の書体を変更したり文字に網掛けしたりする

アプリケーションプログラムから文字の書体を変更したり網掛けしたりできます。この機能は，グラフィック帳票の場合に使用できます。文字の書体や，網掛けのほかに，文字の強調表示や抹消線を引くこともできます。

詳細は，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　帳票編」を参照してください。

機能２　帳票のけい線表示を変更する

アプリケーションプログラムからけい線の表示を変更できます。この機能は，グラフィック帳票の場合に使用できます。表示の変更は，けい線の種類や太さのほかに，けい線を引かなくすることもできます。

詳細は，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　帳票編」を参照してください。

機能３　印刷ドキュメント名をアプリケーションプログラムから変更する

帳票を印刷する際に，Windowsのプリンタスプールに登録される印刷ドキュメント名をアプリケーションプログラムから変更できます。

詳細については，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　帳票編」を参照してください。

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

機能１　アプリケーションプログラムから表示属性を変更する場合の修飾名，通知

コード（ファンクションキーなど）を変更する

表示属性の動的変更に使用する修飾名や通知コードを，必要に応じてドローセットアップで変更できます。詳細については，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

機能２　開発環境の設定内容を印刷する

ドローセットアップの設定内容を印刷できます。設定内容が一覧形式で印刷されるため，標準設定値やカスタマイズ結果を確認したり，開発時のドキュメントとして利用したりできます。詳細については，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

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

実行環境のセットアップには，表示・印刷セットアップを使用します。

機能１　制御キーを変更する

画面操作時に使用する制御キーの動作を，表示・印刷セットアップの設定区分「キー割当」で変更できます。例えば，［Ctrl］，［Tab］，［Enter］をほかのキーに割り当てることができます。詳細については，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

機能２　画面の表示色，または帳票の印刷色を調整する

XMAP3の画面で使用する文字色（またはラベル色）および背景色や，グラフィック帳票で使用する印刷色の定義は変更しないで，外部から動的に調整できます。変更したい色は，任意のRGB値で指定します。画面で使用する色を変更したい場合は，表示・印刷セットアップの設定区分「表示色」で設定してください。グラフィック帳票で使用する印刷色を変更したい場合は，表示・印刷セットアップの設定区分「印刷色」で設定してください。

詳細については，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

機能３　画面の表示文字を調整する

XMAP3で画面を表示するときに採用する，文字の書体やサイズの定義は変更しないで，外部から動的に調整できます。標準で割り当てられている文字の書体やサイズを変更して表示することもできます。変更したい場合は，表示・印刷セットアップの設定区分「表示文字」で設定してください。詳細については，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

機能４　プリンタを高速印刷モードにする

出力対象のプリンタに対し，高速印刷をするためにLIPSまたはESC/Pコマンドによって，プリンタを直接コントロールすることができます。変更したい場合は，表示・印刷セットアップの設定区分「プリンタ」の「印刷モード」で設定します。使用しているプリンタに適した印刷モードに変更してください。詳細については，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

機能５　帳票をPDFファイルに出力後，任意のアプリケーションプログラムを自動的に起動する

XMAP3では，帳票をPDFファイルに出力したあとに任意のアプリケーションプログラムを自動的に起動することができます。これによって，出力後のPDF帳票を自動的にプレビュー表示したり，HOPSS3/AS 日立電子帳票システムと連携して帳票を自動管理したりできます。

詳細については，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

機能6　画面の文字入力のデフォルトを変更する

XMAP3で作成した画面では，文字入力のデフォルトが上書きモードになっていますが，挿入モードをデフォルトに設定することもできます。設定を変更したい場合は，表示・印刷セットアップの設定区分「キー操作1」の「挿入キーの動作」で変更します。詳細については，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

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

機能１　実行時のログを採取する

画面表示および帳票印刷時のログをロギング支援機能を使用して採取できます。ロギング支援では，ログの確認だけでなく，実行環境の設定情報を確認することもできます。

詳細については，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

機能２　実行時の画面ハードコピーを利用する

XMAP3を使用したGUI画面やCUI画面のハードコピーを印刷できます。これには，ハードコピー機能を使用します。ハードコピー機能では，ホットキーの割り当て，日付・時刻の印刷，モノクロ化する条件などが設定できます。

詳細については，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

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

ここでは，知っているとさらに便利なレイアウト定義の操作について説明します。

＜この節の構成＞

(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)　データ長のカスタマイズ

混在項目，およびカナ項目の論理マップの長さ（データ長）は，ドローセットアップで指定したターゲットに応じて変化します。データ長は，論理マップで使用したい半角文字数（けた）を基にXMAPが自動的に推奨値を設定しますが，扱う文字コードの特性として「けた＜データ長」となるターゲットでは，混在項目のデータ長の値をカスタマイズすることもできます（カナ項目はできません）。

詳細は，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」，または「画面・帳票サポートシステム XMAP3　メインフレーム連携ガイド」を参照してください。

(9)　ボタン順序の変更

プッシュボタン，固定ラジオボタン，および固定チェックボタンの順序を変更できます。

ボタンを選びます。

ボタンを変更したい位置へドラッグします。
ドラッグ中に表示される枠が，変更したい位置のボタンと重なる位置でマウスのボタンを離します。
ドラッグ中に表示される枠が，変更したい位置のボタンと重ならない位置でマウスのボタンを離すと，ボタン間隔が変わります。

付録D　Visual Basic，Access，およびDelphiでのアプリケーションプログラムのコーディング例

書式を使ったアプリケーションプログラムは，COBOLのほかにVisual Basic，Access，およびDelphiでも作成できます。ここでは，納品伝票印刷プログラム（書式オーバレイ）の例題を使用してコーディングのポイントを説明します。

＜この節の構成＞

付録D.1　例題の概要

付録D.2　Visual BasicおよびAccessでのアプリケーションプログラムのコーディング例

付録D.3　Delphiでのアプリケーションプログラムのコーディング例

付録D.1　例題の概要

例題で使用する納品伝票印刷プログラムの書式，および処理の流れは，Visual Basic，Access，およびDelphiで共通です。

＜この項の構成＞

(1)　例題で使用する書式

(2)　処理の流れ

(1)　例題で使用する書式

例題で作成する書式のイメージを，図D-1に示します。

なお，定義ファイル名は，JYUOVL.ifmです。

図D-1　例題で作成する書式

(2)　処理の流れ

納品伝票印刷プログラム（書式オーバレイ）のフローチャートを，図D-2に示します。

図D-2　納品伝票印刷プログラム（書式オーバレイ）の処理の流れ

付録D.2　Visual BasicおよびAccessでのアプリケーションプログラムのコーディング例

Visual BasicおよびAccessでは，同様のコーディングでアプリケーションプログラムを作成できます。

Visual BasicおよびAccessでのコーディングの例とポイントを次に示します。

付録D.3　Delphiでのアプリケーションプログラムのコーディング例

Delphiでのコーディングの例とポイントを次に示します。

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

＜この節の構成＞

(1)　インストール時のトラブルには

(2)　レイアウト定義時のトラブルには

(3)　テスト表示／印刷時のトラブルには

(4)　コンパイル時のトラブル（COBOL2002またはCOBOL85を使用する場合）には

(5)　実行時のトラブルには

(1)　インストール時のトラブルには

XMAP3のインストールでトラブルが発生した場合には，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

(2)　レイアウト定義時のトラブルには

レイアウト定義時にトラブルが発生した場合には，XMAP3ヘルプのドローに関するヘルプを参照してください。

(3)　テスト表示／印刷時のトラブルには

テスト表示／印刷時にトラブルが発生した場合は，XMAP3ヘルプの開発時のトラブルに関するヘルプを参照してください。また，エラーメッセージとリターンコードについても，XMAP3ヘルプを参照してください。

(4)　コンパイル時のトラブル（COBOL2002またはCOBOL85を使用する場合）には

アプリケーションプログラムのコンパイル時の主なエラーとその対処を表E-1に，リンケージ時の主なエラーとその対処を表E-2に示します。

注意

エラーコードの「KCCC」はCOBOL85では「KCCB」になります。

XMAP3ヘルプでも対処方法を知ることができます。

表E-1　コンパイル時の主なエラー（COBOL2002またはCOBOL85）

エラー
意味
対処方法

KCCC1076C-S
COPY文で取り込もうとしているファイルが，APのソースが格納されているフォルダ中にないことが考えられる。
ファイルが，APのソースが格納されているフォルダ中にあるか見直し，ない場合はファイルをコピーしてコンパイルし直す。

KCCC1076C-S
COPY文で取り込もうとしているファイルの名称が誤っていることが考えられる。
XMAP3で作成した論理マップファイルの名称であるか見直し，ファイルの名称が誤っているときは正しい名称に修正してコンパイルし直す。

KCCC3015C-S
データ名，または変数名に不当な文字を指定していることが考えられる。
データ名，および変数名を見直す。

KCCC3015C-S
必要なテーブル「X3MODTBL」がAPを格納しているフォルダにないことが考えられる。
APを格納しているフォルダに次のファイルをコピーして，コンパイルし直す。
「XMAP3インストールフォルダ
¥Include¥X3MODTBL.cbl」

表E-2　リンケージ時の主なエラー（COBOL2002またはCOBOL85）

エラー
意味
対処方法

LNK1104
アプリケーション実行時に必要なXMAP3のライブラリを参照できない。
コンパイル環境のPCにXMAP3の開発モデルがインストールされているか確認する（CALL文のインタフェースで作成したアプリケーションの場合はリンケージ環境）。

LNK2001
LNK1120
リンケージ時に必要なXMAP3のライブラリを参照できない。
リンケージオプションを次の手順で設定する。
COBOL2002，COBOL85 Version 7，およびVersion 6の場合

COBOL開発マネージャの［プロジェクト］－［プロジェクトの設定］コマンドを選ぶ。

「リンク」タブの「ライブラリの指定」にチェックを入れる。
表示されるダイアログの設定内容に，次の内容を追加する。
"XMAP3インストールフォルダ
¥LIB¥x3mwdr32.lib"

COBOL85 Version 5.0の場合

COBOL開発マネージャの［オプション］から［リンカ］を選択する。

リンカオプション設定ダイアログボックスで，次のように設定する。
リンカオプション：何も指定しない
インポートライブラリ/ユーザ指定ライブラリ：
"XMAP3インストールフォルダ
¥LIB¥x3mwdr32.lib"

(5)　実行時のトラブルには

アプリケーションプログラムの実行時の主なエラーとその対処をE-3に示します。

またXMAP3ヘルプでも対処方法を知ることができます。

表E-3　実行時の主なエラー（COBOL2002またはCOBOL85のコンソール画面）

エラー
意味
対処方法

KCCC5008R-S
エラーコードで示すエラーがXMAP3で発生した
入出力時のエラーコードを見て対処する。エラーコードについては，マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　画面編」または
マニュアル「画面・帳票サポートシステム XMAP3　プログラミングガイド　帳票編」を参照し，リターンコード・詳細コードを確認のこと。

KCCC3417R-S
サービス名称不足

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

＜この節の構成＞

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

付録F.2　画面・帳票の定義サンプル

付録F.3　提供APサンプル

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

画面のアプリケーションプログラムのコーディングに利用するAPパターンを表

F-1に，帳票と書式オーバレイのアプリケーションプログラムのコーディングに利

用するAPパターンを表F-1，表F-2に示します。これらのAPパターンは，次のフォルダに提供されています。

XMAP3のインストールフォルダ¥Patterns

表F-1　APパターン（画面）

●APパターン

パターン名称
（適用言語）
パターンの内容
パターンの使用ケース
使用する定義
サンプル

BTMENU01
(COBOL)
(C言語)
ログイン画面からメニュー画面を起動させます。プッシュボタンによる多目的メニューです。ボタン，ファンクションキー，またはテンキー選択に対応してAPを起動します。

ログイン画面は必要に応じて削除してください。

実行ファイル(.EXE)をCALL文で呼び出していますが，内部ルーチン用に変更することもできます。

すべての業務をまとめた初期メニューとしての使用を想定しています。

内部ルーチン用に変更して，サブメニューとしても使用できます。

ログインウィンドウ(GPASW1)，一段ボタンメニュー(BMENU1)との併用を想定しています。

SLMENU01
(COBOL)
(C言語)
ログイン画面からメニュー画面を起動させます。ラジオボタン，またはテンキー選択による初期メニューです。選択した番号に対応してAPを起動します。

ログイン画面は必要に応じて削除してください。

実行ファイル(.EXE)をCALL文で呼び出していますが，内部ルーチン用に変更することもできます。

すべての業務をまとめた初期メニューとしての使用を想定しています。

内部ルーチン用に変更して，サブメニューとしても使用できます。

ログインウィンドウ(GPASW1)，
一段ラジオボタンメニュー(SMENU1)との併用を想定しています。

GENDSP01
(COBOL)
(C言語)
汎用画面入出力プログラムです。一つの画面に対応した画面入出力処理を行います。

１画面だけの表示を想定しています。追加画面は，部品NXTDSP 01を追加して行います。

入力後のチェック結果によって，AP部品を随時挿入します。

COBOL用では，メインプログラムへは戻らないことを想定しています。メインプログラムへ戻す場合には，「STOP RUN」を変更して使用します。

メニュープログラムを使用したメインメニューから呼ばれることを想定しています。
一般の画面に適用できます。

GENDSP02
(COBOL)
汎用画面入出力プログラムです。一つの画面に対応した画面入出力処理を，CALLインタフェースを利用して行います。

１画面だけの表示を想定しています。追加画面は，同じくCALLインタフェースを使用しているGENDSP03を追加して行います。

入力後のチェック結果によって，AP部品を随時挿入します。

メインプログラムへは戻らないことを想定しています。メインプログラムへ戻す場合には，「STOP RUN」を変更して使用します。

メニュープログラムを使用したメインメニューから呼ばれることを想定しています。

COBOLのCALLインタフェースを使用して画面入出力を行うケースを想定しています。

一般の画面に適用できます。

GENDSP03
(COBOL)
GENDSP02から呼び出されるサブプログラムです。
GENDSP02との組み合わせを想定しています。
一般の画面に適用できます。

GENFLD01
(COBOL)
(C言語)
フィールド単位アクセス用入出力プログラムです。カーソルが位置づいているフィールドだけ入力できます。

APでは，入力データをチェックし，対応する処理を行います。

チェックでOKであれば，次に入力したいフィールドにカーソルを位置づけて画面を再表示します。

フィールド単位にAPに返して，入力データをチェックすることを想定しています。

COBOLのWINDOW SECTIONで実現していた業務をGUIに移行する際のAPを想定しています。

フィールド単位画面(FIE1GCまたはFIE1GH)の使用を想定しています。

GENEVN01
(COBOL)
(C言語)
イベント単位アクセス用入出力プログラムです。画面上のどこからでも入力することができ，APにイベントを返します。

APでは，イベント通知コードの領域に，入力したフィールドのイベント定数が返ってきます。

イベントごとの処理を行うセクションを設けて，各フィールドの処理を行います。

複数のトグルフィールドから一つだけを選択して処理を行うことを想定しています。
イベント単位画面(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言語)
表示されている画面に対して，ある１項目だけを書き換えます。ほかの項目の状態はそのままとします。

エラーメッセージなどをメッセージフィールドに表示する場合に使用します。

１項目だけでなく，複数項目またはすべての項目を書き換えるように変更することで，固定部分をそのままにして可変部分をすべて書き換えて表示する場合にも応用できます。

GENDSP01，
DSPPRT01，
BTMENU01，
SLMENU01，
NXTDSP01，
GENFLD01，
GENEVN01への挿入を想定しています。
一般の画面に適用できます。

SETCRS01
(COBOL)
(C言語)
表示されている画面に対して，フォーカスやカーソル位置を設定し直します。ほかの項目の値は変更しません。
GENDSP01，
DSPPRT01，
BTMENU01，
SLMENU01，
NXTDSP01への挿入を想定しています。
一般の画面に適用できます。

BTPROT01
(COBOL)
(C言語)
表示されている画面に対して，ボタンを不活性状態に変更します。
BTMENU01，
SLMENU01，
GENDSP01，
NXTDSP01への挿入を想定しています。
一般の画面に適用できます。

表F-2　APパターン（帳票，書式オーバレイ）

●APパターン

パターン名称
（適用言語）
パターンの内容
パターンの使用ケース
使用する定義
サンプル

GENREP01
(COBOL)
(C言語)
汎用帳票出力プログラムです。１種類の帳票に対応した帳票出力処理を行います。

１帳票だけの印刷を想定しています。追加帳票は，部品NXTREP 01を追加して行います。

メニュープログラムを使用したメインメニューから呼ばれることを想定しています。

バッチ業務の帳票出力としても使用できます。

一般の帳票に適用できます。

GENREP02
(COBOL)
汎用帳票出力プログラムです。１種類の帳票に対応した帳票出力処理を，CALLインタフェースを利用して行います。

１帳票だけの印刷を想定しています。追加帳票は，同じくCALLインタフェースを使用しているGENREP03を追加して行います。

メニュープログラムを使用したメインメニューから呼ばれることを想定しています。

バッチ業務の帳票出力としても使用できます。

COBOLのCALLインタフェースを使用して帳票印刷を行うケースを想定しています。

一般の帳票に適用できます。

GENREP03
(COBOL)
GENREP02から呼び出されるサブプログラムです。
GENREP02との組み合わせを想定しています。
一般の帳票に適用できます。

GENOVL01
(COBOL)
(C言語)
汎用書式オーバレイ出力プログラムです。１種類の書式に対応した書式印刷処理を行います。

１書式だけの印刷を想定しています。

ヘッダ部，明細部，トレイラ部で構成される書式を印刷することを想定しています。なお，ヘッダ処理やトレイラ処理は，必要に応じて削除してください。

バッチ業務の書式出力として使用できます。
一般の書式オーバレイに適用できます。

●AP部品

パターン名称
（適用言語）
パターンの内容
パターンの使用ケース
使用する定義
サンプル

NXTREP01
(COBOL)
(C言語)
帳票出力処理の追加コーディングです。
GENREP01，
DSPPRT01への挿入を想定しています。
一般の帳票に適用できます。

MODATR02
(COBOL)
(C言語)
特定フィールドの属性およびけい線の種別を変更します。
GENREP01，
DSPPRT01への挿入を想定しています。
一般の帳票に適用できます。

付録F.2　画面・帳票の定義サンプル

XMAP3では，業務の開発に参考にしたり，流用したりするための画面，帳票および書式のレイアウトのサンプルを標準提供しています。これを定義サンプルといい，マップ定義ファイルで提供されています。定義サンプルの例を，次に示します。

一般の業務を想定したさまざまな種類の定義サンプルが用意されていますので，効率良く画面や帳票のレイアウトを定義できます。

定義サンプルは，次のフォルダに提供されています。

画面

XMAP3のインストールフォルダ¥Samples¥Dspmap

帳票，書式

XMAP3のインストールフォルダ¥Samples¥Prtmap

付録F.3　提供APサンプル

XMAP3では，このマニュアルの例題プログラムのほかに，APサンプルを標準提供しています。APサンプルでは，XMAP3を適用したユーザアプリケーションプログラムの例題を，マップ定義ファイルやソースプログラムなどを参照したり，実行したりして体験できます。このマニュアルの例題を一とおり学習したあと，さらに詳細な機能を知りたい場合や，業務開発の参考にしたい場合などにお役立てください。

アプリケーションプログラムの開発言語として，COBOLを中心にC言語，Visual Basic，Access，およびDelphiのサンプルが提供されています。提供フォルダを次に示します。

COBOL用

XMAP3のインストールフォルダ¥Samples¥Cobol

C言語用

XMAP3のインストールフォルダ¥Samples¥C

Visual Basic，Access，およびDelphi用

XMAP3のインストールフォルダ¥Samples¥Other

提供されているAPサンプルを，表F-3および表F-4に紹介します。詳しい利用方法については，各マニュアルまたはヘルプを参照してください。

表F-3　APサンプル一覧（画面）

AP名称
［ファイル名称］
概要
作成言語
参照する
マニュアル※1

GUI入門例題(GUI画面)
［JYUTUGx.xxx］
GUIのオブジェクトを使用した入門例題
COBOL
入門

C言語
画面編

画面単位入力(GUI画面)
［GAMENGx.xxx］
GUIで画面単位にAPとやり取りする例題
COBOL
画面編

C言語
なし

行単位入力(GUI画面)
［LINEGx.xxx］
GUIで行単位にAPとやり取りする例題
COBOL
画面編

C言語
なし

イベント単位入力(GUI画面)
［EVENTGx.xxx］
GUIでイベント単位にAPとやり取りする例題
COBOL
画面編

C言語
なし

フィールド単位入力(GUI画面)
［FIELDGx.xxx］
GUIでフィールド単位にAPとやり取りする例題
COBOL
画面編

C言語
なし

受発注業務(GUI画面)
［KADN1Gx.xxx］
GUIのオブジェクトを使用して受発注業務を想定した例題
COBOL
ヘルプ

C言語

OLTPクライアント(GUI画面)
［OLTP1GC.CBL］
一連の受発注業務をサーバ側のOpenTP1に処理要求する例題
COBOL
画面編

CUI入門例題(CUI画面)
［JYUTUCx.xxx］
CUIのオブジェクトを使用した入門例題
COBOL
入門

C言語
なし

画面単位入力(CUI画面)
［GAMENCx.xxx］
CUIで画面単位にAPとやり取りする例題
COBOL
画面編

C言語
なし

行単位入力(CUI画面)
［LINECx.xxx］
CUIで行単位にAPとやり取りする例題
COBOL
画面編

C言語
なし

フィールド単位入力(CUI画面)
［FIELDCx.xxx］
CUIでフィールド単位にAPとやり取りする例題
COBOL
画面編

C言語
なし

受発注業務(CUI画面)
［KADN1Cx.xxx］
CUIのオブジェクトを使用して受発注業務を想定した例題
COBOL
ヘルプ

C言語

注

ファイル名称の「x.xxx」は，作成言語の種類によって異なります。

注※１

マニュアルの正式名称は，次のとおりです。

入門：「画面・帳票サポートシステム　XMAP3　入門」

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

表F-4　APサンプル一覧（帳票・書式オーバレイ）

ＡＰ名称
［ファイル名称］
概要
作成言語
参照する
マニュアル※1

帳票入門例題(ページプリンタ)
［JYUTUPx.xxx］
ページプリンタのオブジェクトを使用した入門例題
COBOL
入門

C言語
帳票編

標準帳票(ページプリンタ)
［STDPRPx.xxx］
ページプリンタのオブジェクトを使用した標準例題
COBOL
帳票編

C言語
なし

表サイズ変更(ページプリンタ)
［MDLINPx.xxx］
ページプリンタでけい線を使った表のサイズを動的に変更する例題
COBOL
帳票編

C言語
なし

文字強調変更(ページプリンタ)
［MDCHRPx.xxx］
ページプリンタで文字／強調属性を動的に変更する例題
COBOL
帳票編

C言語
なし

重ね印刷(ページプリンタ)
［OVCHRPx.xxx］
ページプリンタで文字と文字とを重ね印刷する例題
COBOL
帳票編

C言語
なし

書式オーバレイ入門例題
(書式オーバレイ)
［JYUTUFx.xxx］
書式オーバレイのオブジェクトを使用した入門例題
COBOL
入門

C言語
なし

Access※2
入門，
帳票編

Visual Basic※3

Delphi※4

標準書式(書式オーバレイ)
［STDPRFx.xxx］
書式オーバレイのオブジェクトを使用した標準例題
COBOL
帳票編

C言語
なし

CSVファイル印刷(書式オーバレイ)
［CSVPRFx.xxx］
CSVファイルを使用した書式オーバレイ例題
COBOL
帳票編

C言語
なし

ブレーク項目(書式オーバレイ)
［BRKPRFCx.xxx］
ブレークポイントを利用してフォーマットを変更して印刷する書式オーバレイ例題
COBOL
帳票編

注

ファイル名称の「x.xxx」は，作成言語の種類によって異なります。

注※１

マニュアルの正式名称は，次のとおりです。

入門：「画面・帳票サポートシステム　XMAP3　入門」

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

注※２

XmapFrmxxx インタフェースを使用したAccessでの例題です。なお，ソースプログラムを参照する場合はAccessが必要となります。

また，実行時には，Accessのアプリケーションプログラム中で使用する書式マップファイル（JYUOVL6G.fmpとJYUOVL6G.pci）の格納先フォルダを，表示・印刷セットアップの「アプリケーション」タブの「マップパス」に指定してください。詳細については，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

注※３

２種類のVisual Basicでの例題です。XmapFrmxxxインタフェースを使用した例題と，書式オーバレイ印刷ユティリティ(X3KFOG)を使用した例題があります。

注※４

XmapFrmxxxインタフェースを使用したDelphiでの例題です。

付録G　XMAP3シリーズの提供機能一覧

XMAP3シリーズのプログラムプロダクトが提供する機能の一覧を，表G-1に示します。

表G-1　XMAP3シリーズの提供機能一覧

提供機能
XMAP3

REPORT3
NET
Enterprise
Edition

ドロー
画面定義(COBOL/C対応)
×
○
○

帳票定義(COBOL/C対応)
○
○
○

書式定義(言語制限なし)
○
○
○

ドロー
セットアップ
ターゲット環境の指定
×
×
○

上記以外
○
○
○

テスト支援
画面表示
×
○
○

帳票・書式印刷
○
○
○

遷移シミュレーション
○
○
○

ユティリティ
マップ・書式生成（PC用）
○
○
○

マップ・書式生成（WS用）
×
×
○

マップ生成（メインフレーム連携用）
×
×
○

コンバート
×
○
○

エクスポート(メインフレームのパネル定義文出力)
×
×
○

エクスポート(メインフレームのタイプ３書式パネル定義文出力)
×
×
○

エクスポート(メインフレームの書式記述文出力)
×
×
○

インポート(メインフレームのパネル定義文の入力)
×
×
○

インポート(メインフレーム/WSの書式記述文の入力)
×
×
○

マップコンペア
×
○
○

環境ファイル操作
×
○
○

マップファイル操作
○
○
○

セットアップ情報反映
○
○
○

ポップアップメニューエディタ
×
○
○

画面・帳票・書
式の定義サンプル
画面サンプル
×
○
○

帳票・書式サンプル
○
○
○

APサンプル
画面サンプル
×
○
○

帳票・書式サンプル
○
○
○

APパターン
COBOL用
×
○
○

C言語用
×
○
○

ドキュメンテー
ション支援
マップ一覧
×
○
○

遷移図
×
○
○

論理マップリスト
×
○
○

画面・帳票属性
×
○
○

オブジェクト表示属性一覧
×
○
○

オブジェクト注釈一覧
×
○
○

レイアウトリスト
×
○
○

画面ハードコピー
×
○
○

ロギング支援
○
○
○

実行環境
セットアップ
画面表示
×
○
○

帳票印刷
○
○
○

AP環境
○
○
○

C/S構成
×
○
○

アプリケーションサーバ型C/S実行
×
○
○

メインフレーム分散実行機能
×
×
○

XMAP3/Web用画面テスト表示機能
×
○
○

Java言語用ツール
×
×
○

（凡例）

○：提供あり

×：提供なし

注１

インポートとは，日立メインフレームで開発した画面・帳票を，XMAP3で利用できるように変換する機能です。

注２

エクスポートとは，日立メインフレームで利用する画面・帳票を開発する機能です。

注３

Java言語用ツールとは，Cosminexus連携機能を使用する場合，Webアプリケーションに必要なファイルを生成する機能です。詳細については，マニュアル「画面・帳票サポートシステム XMAP3　開発・実行ガイド」を参照してください。

付録H　用語解説

（英字）

AP（Application Program）

画面・帳票に入出力する業務プログラムです。

APパターン・AP部品

APの定型的な型としてXMAP3が提供しているCOBOL用のパターンです。APパターンは，プログラムの標準的な骨組みです。AP部品は，処理の手続きです。これらを組み合わせて利用すると，APを効率良く作成でき，定型的なコーディングの統一も図れます。

格納場所と名前：XMAP3インストールフォルダ¥Patterns¥Cobol（またはC）

C/Sシステム（Client / Server System）

サーバとクライアントで処理を分散する業務形態です。また，一つの処理をネットワーク上のサーバとクライアントで分担する機器構成モデル，または処理方式です。

C/Sセットアップ

XMAP3のC/Sシステム構成でのC/Sシステム環境を設定します。C/Sセットアップ機能では，サーバPCとクライアントPCに設定されたTCP/IPのホスト名，アプリケーションプログラムで指定する仮想端末名，および表示・印刷サービス名などを設定します。

CPI（Character Per Inch）

文字間隔の単位で，インチ（25.4mm）当たり何文字印字できるかを表します。

例えば，10CPIは25.4mm当たりに10文字になります。

CSVファイル（Comma Separated Values）

リレーショナルデータベースで扱えるテキストデータを格納するファイルです。データの区切りをコンマ（，）で表します。XMAP3では，ドキュメンテーション支援で，各種情報をCSVファイルに出力できます。

CUI画面

キーボードからの文字入力が中心の画面です。従来のメインフレーム型オンライン業務か，MS-DOSベースの業務で使用していた画面です。XMAP3では，画面の入出力を物理マップと論理マップを使って実現しています。

EUC（Extended UNIX Code）

ターゲットが「AIX」，「Linux」，「Solaris」の場合に使用する文字コードです。

GUI画面

キーボードからの入力のほかに，マウスによる操作ができる画面です。Windowsの「ボタン」「スクロール」「プルダウン・カスケード」「ポップアップ」などが使用できます。XMAP3では，画面の入出力を物理マップと論理マップを使って実現しています。

LIPS（LBP Image Processing System）スルーモード

ページプリンタ固有の印刷モードです。キヤノン社のページプリンタが該当します。LIPSには，LIPS II＋，LIPS IIIなどがあります。

LPI（Line Per Inch）

行の間隔の単位で，インチ（25.4mm）当たり何行印字できるかを表します。

XMAP3で「ます目の設定」を「自由な設定」にした場合，3，4，6，8，10，12LPIの中から選べます。例えば，8LPIは25.4mm当たりが8行になります。

PDF（Portable Document Format）

Adobe Acrobatが扱う文書のファイル形式で，特定のプラットフォームに依存しないで文書を表示できます。XMAP3では，ページプリンタ用帳票をPDFファイルに出力できます。

Webブラウザ

インターネット上のWebページを閲覧（ブラウズ）するためのもの。

Windows対応プリンタ

Windows用にプリンタドライバが提供されているプリンタです。XMAP3では，GDIモードで印刷するときの対象となるプリンタをWindows対応プリンタと呼びます。

（ア行）

アクセスキー

メニューバー，ポップアップメニュー(ポップアップメニューファイルを使用する場合も含める)，およびプッシュボタンボックスで，候補の選択操作をするためのキーです。

これらのオブジェクトにフォーカスが位置づいているとき，アクセスキーを押すことで該当するメニュー項目やボタンを選択できます。また，［Alt］+アクセスキーを押すことでメニューバーのメニュー項目を選択（プルダウンメニューを表示）できます。

イベント通知コード

コマンドコントロールオブジェクト（プッシュボタン，メニューバー）や確定キー（PFキーなど）に割り当てるコードです。オブジェクトやキーを操作するとイベントが発生し，通知コードに対応付けた動作（AP通知など）が実行されます。イベント通知コードの値はドローセットアップで変更できます。動作はドローで変更できます。これを「INC定数」といいます。また，入力単位がイベントのとき通知される「イベント定数」もあります。

印刷ドキュメント名

帳票印刷時，Windowsのプリンタスプールに登録されるXMAP3の印刷データのドキュメント名です。印刷ドキュメント名は帳票属性または書式属性として指定できます。また，マップ帳票の印刷ドキュメント名はアプリケーションプログラムで帳票を印刷するときの出力論理マップ中に指定することで，アプリケーションプログラムから動的に変更できます。この機能を利用することによって，印刷した帳票の種別や内容の判別が容易になり，帳票印刷業務でのリカバリ処理などの効率化が実現できます。

なお，帳票をPDFファイルに出力する場合，印刷ドキュメント名がPDFファイルのファイル名になります。

インポート

ユティリティの機能の一つです。ほかのシステムで作成した定義ファイルを入力して，XMAP3で入力できる形式の定義ファイルに変換します。XMAP3/Enterprise Editionで利用できます。

エクスポート

ユティリティの機能の一つです。XMAP3で作成したマップ定義ファイルから，XMAP3/Enterprise Editionのメインフレーム用のパネル定義文ファイルを生成します。

（カ行）

画面属性

入力項目の扱いや表示形態などの画面全体に関する属性です。GUI画面では「画面属性」ダイアログで属性を指定します。また，画面属性はAP実行時に動的に変更することもできます。APから動的に変更するには，ドローセットアップの「表示属性の動的変更」で変更したい表示属性を定義します。ここで指定した修飾名を制御項目に代入することで，指定した表示属性に変更できます。

環境ファイル操作

ユティリティの機能の一つです。バックアップファイル（.SBK）を使って，セットアップ内容などの各種の情報を保存・復元します。開発環境のバックアップを取る場合や，実行環境をほかのPCに移行する場合などに使います。

行制御データファイル

書式オーバレイの使用時に，ユーザの行データを印字する行の間隔や，標準の文字サイズ・文字間隔などの情報を格納するファイルです。拡張子は.PCIです。書式オーバレイの定義終了時に，書式イメージファイルとともに生成されます。

APでは，印刷するデータを1行(1レコード)ずつ出力し，1ページ分となった時点で書式がオーバレイされて印字されます。

グラフィック帳票

240dpi／300dpiのページプリンタ用の帳票です。網掛け帳票の機能に加え，オブジェクトやけい線などのバリエーションなどをより豊富に備えています。

（サ行）

ショートカットキー

メニューバーのメニュー項目の選択操作するキーです。フォーカス・カーソルの位置に関係なく，［Ctrl］ + ショートカットキーを押すことで該当するメニュー項目を選択できます。なお，メニューバーのメニュー項目，またはカスケードメニューを持つプルダウンメニューにはショートカットキーを定義できません。

書式イメージファイル

書式オーバレイの文字列やけい線などの情報を格納するファイル（拡張子.FMP）です。書式オーバレイの定義終了時に，行制御データファイルとともに生成されます。

書式オーバレイ

240dpi／300dpiのページプリンタ用の書式オーバレイです。定型帳票から書式（文字列やけい線などの固定項目）を分離し，アプリケーション（行データ）を印刷時に重ねあわせるソフトオーバレイ方式を採っています。書式をプリンタ（ハードウェア側）に登録するメインフレームおよびWSの出力方式とは異なります。

書式定義ファイル

ドローで定義した書式の定義情報を格納したファイル（拡張子.IFM）です。

ソースマップ

ソースマップは，ドロー機能で定義した画面や帳票の定義情報です。ソースマップには，画面・帳票定義用のマップ定義ファイルと書式用の書式定義ファイルがあります。また，ソースマップの情報は，定義体および論理マップが生成される基になります。

（タ行）

定義体

定義体は，画面や帳票のレイアウトに関する情報です。

テスト支援

ドローで作成した物理マップファイルや書式イメージファイルを使って，帳票の内容を確認するための機能です。APを作成する前に，実行時の帳票印刷をテストできます。「単体表示／印刷」，「連続表示／印刷」，「遷移シミュレーション」の３種類のテストができます。

動的変更テーブル

画面や帳票の実行時に色などの属性をAPから変更するときに，XMAP3が用意する属性変更用の定数テーブルの修飾名を表示属性の動的変更制御項目に代入します。

登録集原文

COBOLのプログラム中でよく利用される標準化した手続き，ファイル記述，レコード記述，または完全な一つのプログラムなどをコンパイルするプログラムと別のファイルに登録したもの。

ドキュメンテーション支援

画面／帳票の定義内容をリストにして，定義内容の見直しや情報管理をするための機能です。レイアウト情報や属性の定義情報など，各種のドキュメントを作成できます。

ドロー

画面や帳票を定義する機能（エディタ）です。画面や帳票のレイアウトや各オブジェクトの属性を定義します。定義内容から，マップ定義ファイル(書式オーバレイでは書式定義ファイル)，物理マップと論理マップ（書式オーバレイでは行制御データファイルと書式イメージファイル）を作成します。

また，ドローからテスト表示やテスト印刷，および論理マップ表示などの機能も利用できます。

ドローセットアップ

ドローセットアップは，画面や帳票の定義に関する標準の値を設定するための機能です。XMAP3では，セットアップする項目の標準値を用意していて，この標準値を変更する場合にだけ設定します。このセットアップの内容はマップの形式に関係していますので，画面や帳票を作成する前にセットアップを済ませておく必要があります。

（ハ行）

パネル定義文

メインフレームのXMAPシリーズでマップ生成するための定義文です。

ユティリティの「インポート」でパネル定義文からPC用の定義ファイルに変換できます。また，「エクスポート」で定義ファイルからメインフレーム用のパネル定義文を生成することもできます。

表示・印刷環境ファイル

XMAP3での画面表示，および帳票印刷環境の設定ファイルです。このファイルの内容は，表示・印刷セットアップで設定します。

なお，このファイルの設定項目には，直接ファイルをエディタで開いて編集する（セットアップで設定できない）項目もあります。表示・印刷セットアップで設定できる項目については，セットアップ情報が優先されます。

表示・印刷セットアップ

XMAP3が表示・印刷する画面・帳票の環境を必要に応じて設定するための機能です。ユーザ画面の外観や操作キーの割り当て，プリンタの印刷モードなどの各種設定があります。

表示属性

表示属性とは，画面では，テキストやフィールドに出力する文字色やボタンの活性／不活性などを指定する属性をいいます。また，帳票では，フィールドの文字の書体やけい線の種類などを指定する属性をいいます。ドローでは，必要に応じて各ダイアログで変更できます。また，表示属性は定義上の指定のほかに，APから動的に変更できる属性もあります。APから動的に表示属性を変更するためには，ドローセットアップの動的変更を指定する修飾名で指定します。

フォーカス

GUI画面を表示した際，操作対象となるオブジェクトに表示される枠です。APから操作対象となるオブジェクトを選択することを，APからフォーカスを位置づける，といいます。

物理マップ

画面や帳票のオブジェクトの位置などを格納した情報ファイルで，拡張子は.PMPです。画面・帳票の定義終了時に，論理マップとともに生成されます。ディスプレイやプリンタの入出力データを論理マップデータに変換したり，論理マップデータを入出力データに変換したりするときにXMAP3が参照します。

（マ行）

マッピングライブラリ

実行支援のコンポーネントの一つです。マップを参照して画面表示や帳票印刷に必要なデータを生成します。

マップ

XMAP3では,画面や帳票のフォーマット情報をアプリケーションプログラムから切り離して，マップと呼ばれる入れ物に保管します。マップにはソースマップ，定義体,および論理マップがあります。

マップコンペア

ユティリティの機能の一つです。物理マップファイル，書式イメージファイル，行制御データファイルをファイル単位またはフォルダ単位で比較します。ファイルの生成・更新日付，サイズ，内容について，違いを確認できます。

マップ生成

ユティリティの機能の一つです。マップ定義ファイルから，論理マップファイルと物理マップファイルを生成します。

また，書式定義ファイルから書式イメージファイルと行制御データファイルを生成します。

マップ定義ファイル

ドローで定義した画面や帳票の定義情報であるソースマップを格納したファイルで，拡張子は.IMPです。画面・帳票の定義終了時に，論理マップとともに生成されます。物理マップと論理マップは，このマップ定義ファイルを基に生成されます。

（ラ行）

レイアウトパターン

ドローで画面／帳票を新規作成するときに，用途に応じて指定するパターンです。標準的なレイアウト領域のサイズやパターンなどがあらかじめ設定されていて，ドローでのレイアウト定義の基本フォーマットとなります。XMAP3が標準提供しているレイアウトパターンのほかに，ユーザが独自に作成・登録することもできます。

連結出力バーコード

バーコードを印字するオブジェクトです。連結出力バーコードは，従来のJANコードなどのような単一データ（商品コードなど）をバーコードとして印字するオブジェクトに対して，複数データ（メーカーコード，支払い期限，支払い金額など）を一つのバーコードとして印字するオブジェクトです。データはアプリケーションプログラムから指定し，論理マップを介して帳票に印字します。このとき，一つのバーコードに対して複数の論理項目（分類項目）を使用します。

バーコードの種類には，EAN-128があります。EAN-128バーコードを印刷する場合は，300dpi（推奨は600dpi）以上のプリンタを使用してください。

論理マップ

論理マップは，プログラムの可変データを入れる受け皿です。COBOLで開発する場合は，登録集原文として生成されます。画面データの入出力や帳票データの出力時に，アプリケーションプログラムがXMAP3に対するパラメタとして利用します。

COBOLでAPを作成する場合は，COPY文で論理マップを取り込みます。AP実行時には，APに取り込まれた論理マップのデータ領域を介して，データがやり取りされます。ファイルの拡張子は，COBOLの場合（.cbl）に，C言語の場合（.h）になります。

また，書式オーバレイ印刷の場合は，論理マップを使用しません。画面，帳票の物理マップに相当する書式イメージファイルと行制御データファイルを使用します。

索引

[記号]
[Ａ][Ｃ][Ｅ][Ｆ][Ｇ][Ｊ][Ｌ][Ｐ][Ｒ][Ｓ][Ｔ][Ｗ][Ｘ]
[ア行][カ行][サ行][タ行][ナ行][ハ行][マ行][ラ行]

(記号)

-Comp5

-JPN,Alnum

-Ks

-Na

-X5

-XMAP,LinePrint

(英字)

(Ａ)

AP

APPLY FORMS-OVERLAY句

APサンプル

APサンプル

APサンプル

APサンプル一覧（画面）

APサンプル一覧（帳票・書式オーバレイ）

APパターン

APパターン

APパターン

APパターン

APパターン（画面）

APパターン（帳票，書式オーバレイ）

APパターン一覧

AP部品

AP部品

(Ｃ)

C/Sシステム

C/Sセットアップ

CALL文

COPY文

COPY文

Cosminexus連携機能

CPI

CSVファイル

CUI画面

CUI画面

CUI画面

CUI画面定義ウィンドウ

CUI画面定義ウィンドウのツールバー

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

CUI画面の例題

CUI画面用出力論理マップ

CUI画面用入力論理マップ

(Ｅ)

EUC

(Ｆ)

FAXに帳票を出力できます

(Ｇ)

GUI画面

GUI画面

GUI画面

GUI画面

GUI画面定義ウィンドウ

GUI画面定義ウィンドウの構成

GUI画面定義ウィンドウのツールバー

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

GUI画面の例題

GUI画面用出力論理マップ

GUI画面用入力論理マップ

(Ｊ)

JYU1CCI

JYU1CCO

JYU1GCI

JYU1GCO

JYU1PCO

(Ｌ)

LIPSスルーモード

LPI

(Ｐ)

PCで定義した画面・帳票をWSで運用する

PCで定義した画面・帳票をメインフレームで運用する

PCを利用したシステム開発の流れ

PDF

(Ｒ)

RECEIVE文

(Ｓ)

SEND文

SEND文

(Ｔ)

TRANSCEIVE文

(Ｗ)

Webブラウザ

Web連携機能

Windows対応プリンタ

WRITE文

WSで利用する画面・帳票をPCに移行する

WSの分散開発と分散実行

WSを利用したシステム開発の流れ

(Ｘ)

X3dmain.exe

XMAP3/Enterprise Edition

XMAP3/NET

XMAP3/REPORT3

XMAP3/Web

XMAP3/Web for Cosminexus

XMAP3シリーズの提供機能一覧

XMAP3と連携するためのコンパイラオプション

XMAP3のドローの基本操作

XMAP3をインストール

XMAP3を終了

(ア行)

(あ)

アクセスキー

アプリケーションプログラムインタフェース

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

網掛けパターンの変更

アンインストール

(い)

移動する

イベント通知コード

印刷色を調整する

印刷ドキュメント名

インストール時のトラブル

インストールする前に

インストールの操作方法

インタフェース領域

インポート

(う)

ウィンドウの構成

(え)

エクスポート

(お)

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

オブジェクトの配置

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

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

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

(カ行)

(か)

カーソルキーによる移動操作

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

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

開発環境

開発環境

開発環境・実行環境の配布

開発環境の配布

各種APインタフェースに対応しています

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

画面・帳票定義とアプリケーションプログラム

画面機能

画面属性

画面入力／表示のインタフェース

画面の例題

画面を先に確定できます

環境ファイル操作

(き)

キーだけを使った操作

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

起動

機能拡張キー

行制御データファイル

行制御データファイル

行データ

業務開発の流れ

切り取る

(く)

グラフィック帳票

グループボックスの枠の削除

グループを解除する

(こ)

コーディング

コーディング

コーディング

コーディングのポイント

コーディングのポイント

コーディングのポイント

コピーする

こんな画面が作れます

こんな操作ができます

こんな帳票が作れます

コンパイル

コンパイル

コンパイル時の主なエラー

コンパイル時のトラブル

コンパイルするためのフォルダ

コンパイルと実行の手順

コンパイルの準備

(サ行)

(さ)

サイズを変更する

削除する

削除する

サンプルを利用してコーディングする

(し)

実行

実行

実行環境

実行環境

実行環境の配布

実行時の主なエラー

実行時のトラブル

実行の準備

自動生成されるファイル

終了

受注データ入力プログラム

受注データ入力プログラム

出力論理マップ

出力論理マップ

出力論理マップ名

使用するファイル一覧

使用するファイル一覧

ショートカットキー

書式イメージファイル

書式イメージファイル

書式オーバレイ

書式オーバレイ印刷のインタフェース

書式オーバレイの例題

書式定義ウィンドウ

書式定義ウィンドウのツールバー

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

書式定義ファイル

処理の流れ

(す)

スケール配置モード

ステータスバー

スプラッシュ画面

(せ)

線種・太さの変更

選択する

(そ)

ソースマップ

(タ行)

(た)

ダイアログボックスを呼び出す

タイトルバー

(ち)

帳票印刷のインタフェース

帳票機能

帳票機能

帳票定義ウィンドウ

帳票定義ウィンドウのツールバー

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

帳票の例題

帳票用出力論理マップ

(つ)

ツールバー

ツールボックス

(て)

定義サンプル

定義サンプル

定義サンプル

定義体

定義の基本手順

提供APサンプル

提供されているアプリケーションプログラムサンプル

提供されているアプリケーションプログラムサンプル

提供されているアプリケーションプログラムサンプル

データ長のカスタマイズ

データ名

テスト支援

テスト表示／印刷時のトラブル

(と)

動的変更テーブル

動的変更テーブル

登録集原文

登録集原文

ドキュメンテーション支援

ドロー

ドローセットアップ

ドローのコマンド起動

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

(ナ行)

(に)

入力論理マップ

入力論理マップ名

(ね)

ネットワーク機能

(の)

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

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

納品伝票印刷プログラム（帳票）

納品伝票印刷プログラム（帳票）

(ハ行)

(は)

配置モードの切り替え

パネル定義文

貼り付ける

(ひ)

表示・印刷環境ファイル

表示・印刷セットアップ

表示属性

(ふ)

フォーカス

フォーカスの移動順序

物理マップ

物理マップ名

物理マップ名

プリンタの特性を生かしたきめ細かい印刷ができます

(ほ)

ボタン順序の変更

(マ行)

(ま)

ます目配置モード

マッピングライブラリ

マップ

マップコンペア

マップ生成

マップ定義ファイル

マップを生成

(め)

メインフレームとPCを分散したシステム開発の流れ

メインフレームの画面・帳票をPCに移行する

メインフレームの定義ツールとして利用する開発の流れ

メインフレームの分散開発と分散実行

メインフレームのマッピングをPCに分散する

メインフレーム連携機能

メニューバー

(も)

文字カラー印刷

文字色・背景色の変更

文字属性・枠高の変更

文字を確定する

元に戻す

(ラ行)

(り)

リンケージ時の主なエラー

(れ)

レイアウト定義

レイアウト定義時のトラブル

レイアウト定義でのキー操作

レイアウト定義の基本操作

レイアウトパターン

レイアウト部品の配置

レイアウト領域

レイアウトを定義するウィンドウ

レイアウトを定義する手順

例題

例題で使用する書式

例題で使用するファイル一覧

例題の概要

例題プログラムに使用するファイル（CUI画面）

例題プログラムに使用するファイル（GUI画面）

例題プログラムに使用するファイル（書式オーバレイ印刷）

例題プログラムに使用するファイル（帳票印刷）

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

連結出力バーコード

(ろ)

論理マップ

■ 商標類

Acrobatは，Adobe Systems Incorporated（アドビシステムズ社）の商標です。

Adobeは，Adobe Systems Incorporated（アドビシステムズ社）の商標です。

AIXは，米国における米国International Business Machines Corp.の登録商標です。

AXは，AX協議会のシステム名称です。

BackOfficeは，米国Microsoft Corp.の登録商標です。

Delphiは，米国Borland International,Inc.の登録商標です。

ESC/Pは，セイコーエプソン(株)の商標です。

HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。

InstallShield(R)は，InstallShield Software Corporationのサービスマーク及び登録商標です。

Itaniumは，アメリカ合衆国および他の国におけるインテル コーポレーションまたはその子会社の登録商標です。

Java及びすべてのJava関連の商標及びロゴは，米国及びその他の国における米国Sun Microsystems,Inc.の商標または登録商標です。

Linuxは，Linus Torvaldsの米国およびその他の国における登録商標あるいは商標です。

LIPSは，キヤノン(株)が開発した言語仕様です。

Microsoftは，米国およびその他の国における米国Microsoft Corp.の登録商標です。

Microsoft Accessは，米国およびその他の国における米国Microsoft Corp.の登録商標です。

Microsoft Internet Explorerは，米国Microsoft Corp.の商品名称です。

Microsoft Internet Information Servicesは，米国Microsoft Corp.の商品名称です。

MS-DOSは，米国およびその他の国における米国Microsoft Corp.の登録商標です。

PC-9800は，日本電気(株)の商品名称です。

Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標若しくは商標です。

Solarisは，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。

TurboLinuxの名称及びロゴは，TurboLinux, Inc.の商標です。

UNIXは，X/Open Company Limitedが独占的にライセンスしている米国ならびに他の国における登録商標です。

Visual Basicは，米国およびその他の国における米国Microsoft Corp.の登録商標です。

Windowsは，米国およびその他の国における米国Microsoft Corp.の登録商標です。

Windows NTは，米国およびその他の国における米国Microsoft Corp.の登録商標です。

Windows Serverは，米国およびその他の国における米国Microsoft Corp.の商標です。