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

XMAP3 メインフレーム連携ガイド

解説・手引書

3020-7-595-80

目　　次

前書き

変更内容

はじめに

第1編　メインフレーム連携機能の概要

1.　メインフレームとの連携について

1.1　XMAP3によるメインフレームとの連携

1.1.1　連携機能の特長

1.1.2　メインフレームとPCで処理を分散する

1.1.3　メインフレームの資産をPCに移行する

1.1.4　メインフレーム用の資産をPCで定義する

1.2　VOS3-PC分散システムの構成

1.2.1　システム構成

1.2.2　ソフトウェア構成

1.3　VOS1-PC分散システムの構成

1.3.1　システム構成

1.3.2　ソフトウェア構成

1.4　VOSK-PC分散システムの構成

1.4.1　システム構成

1.4.2　ソフトウェア構成

2.　メインフレーム連携の開発環境と開発手順

2.1　メインフレーム-PC分散システムの開発環境と開発手順

2.1.1　利用できるデバイス

2.1.2　分散システムの開発環境のソフトウェア構成

2.1.3　分散システムの開発手順

2.2　メインフレーム資産を移行してPCで運用する手順

2.2.1　インポート対象となるデバイスと変換できる機能

2.2.2　メインフレームの画面・マップ帳票をPCに移行する

2.2.3　メインフレームのタイプ1/2/R書式をPCに移行する

2.3　メインフレーム用の資産をPCで開発・運用する手順

2.3.1　PC上で画面・マップ帳票を開発してメインフレームで運用する

2.3.2　PC上でタイプ3書式を開発してメインフレームで運用する

2.3.3　PC上でタイプ1/2/R書式を開発してメインフレームで運用する

第2編　VOS3とPCで処理を分散させる

3.　VOS3-PC分散システムの環境設定

3.1　開発環境の設定

3.2　実行環境の設定

3.2.1　XDM/DCCM3の設定

3.2.2　仮想端末名称の設定

3.2.3　TCP/IPの設定

3.2.4　CommuniNetの設定

3.2.5　プリンタの設定

3.2.6　TP1/Client/Pの設定

3.2.7　外字の設定

4.　VOS3-PC分散システムのAP開発から運用まで

4.1　画面・マップ帳票定義前の準備

4.1.1　フォルダを作成する

4.1.2　定義環境の設定

4.2　画面・マップ帳票の定義

4.2.1　トランザクションコードを設定する

4.2.2　「日本語」項目の定義

4.2.3　下位項目の定義

4.2.4　EAGLE2・KCORALのプログラムを利用する

4.2.5　SEWB3の画面・帳票定義を利用する

4.3　マップ生成とファイル転送

4.3.1　マップを生成する

4.3.2　マップファイルの転送

4.4　APの作成と実行

4.4.1　APの作成

4.4.2　AP実行時のVOS3側の動作

4.4.3　AP実行時のPC側の動作

4.4.4　NETM/DMを利用したマップの配布

4.4.5　AP実行時の外字の扱い

4.5　画面・帳票作成時のメッセージ

5.　VOS3でのAP作成と実行

5.1　分散処理の仕組み

5.1.1　XDM/DCCM3での拡張ホストアクセス（論理マップ長≦2,920バイトの場合）

5.1.2　XDM/DCCM3での拡張ホストアクセス（論理マップ長＞2,920バイトの場合）

5.1.3　XDM/DCCM3とTP1/Client/Pによる連携（MPP）

5.1.4　XDM/DCCM3とTP1/Client/Pによる連携（BMP）

5.1.5　TIOP3での拡張ホストアクセス

5.2　VOS3側のインタフェース

5.2.1　XDM/DCCM3でのインタフェース（CommuniNet使用時）

5.2.2　XDM/DCCM3でのインタフェース（TP1/Client/P使用時）

5.2.3　TIOP3でのインタフェース

5.3　PC側のインタフェース

5.3.1　画面管理プログラム

5.3.2　メインフレームからの命令とPC側の処理

5.4　AP作成時の注意事項

5.4.1　論理マップの項目名

5.4.2　変更属性定義

5.4.3　16進指定（DFC）の動的変更

5.4.4　XDM/DCCM3の機能を代替する

5.4.5　既存APの流用

6.　PCでの画面管理プログラムの利用と作成

6.1　サンプルプログラム

6.1.1　XDM/DCCM3で2,920バイト以内のデータをやり取りする（拡張ホストアクセス）

6.1.2　XDM/DCCM3で2,920バイトを超えるデータをやり取りする（拡張ホストアクセス）

6.1.3　TP1/Client/PによるMPPの処理

6.1.4　TP1/Client/PによるBMPの処理

6.1.5　対話処理

6.1.6　COBOLによる画面管理プログラム

6.2　利用形態に応じた変更

6.2.1　仮想端末名およびマップ名を設定する

6.2.2　入力論理マップのクリア文字を指定する

6.2.3　トランザクションコード

6.2.4　TP1/Client/Pを使って2,920バイトを超えるデータをやり取りする

6.2.5　TP1/Client/Pを使って可変長のデータをやり取りする

6.2.6　TP1/Client/Pを使ったMPPの処理でトランザクションを変更する

6.2.7　CommuniNetの端末名称を変更する

6.2.8　画面管理プログラムにメインフレームAPの処理を分散する

6.3　コンパイルから実行まで

6.3.1　画面管理プログラムのコンパイルとリンケージ

6.3.2　画面管理プログラムの実行

7.　トラブルシューティング

7.1　回線接続時のトラブルと対処方法

7.2　画面・帳票出力時のトラブルと対処方法

7.3　XDM/DCCM3使用時のトラブルと対処方法

7.4　画面管理プログラムのトラブルと対処方法

7.5　CommuniNet Extension使用時のトラブルと対処方法

第3編　VOS1とPCで処理を分散させる

8.　VOS1-PC分散システムの環境設定

8.1　開発環境の設定

8.2　実行環境の設定

8.2.1　DCCM3やGCASTの設定

8.2.2　仮想端末名称の設定

8.2.3　TCP/IPの設定

8.2.4　CommuniNetの設定

8.2.5　マップパスの設定

8.2.6　プリンタの設定

8.2.7　外字の設定

9.　VOS1-PC分散システムのAP開発から運用まで

9.1　画面・マップ帳票定義前の準備

9.1.1　フォルダを作成する

9.1.2　定義環境の設定

9.2　画面・マップ帳票の定義

9.2.1　トランザクションコードを設定する

9.2.2　「日本語」項目の定義

9.2.3　下位項目の定義

9.2.4　EAGLE2・KCORALのプログラムを利用する

9.2.5　SEWB3の画面・帳票定義を利用する

9.3　マップ生成とファイル転送

9.3.1　マップを生成する

9.3.2　マップファイルの転送

9.4　APの作成と実行

9.4.1　APの作成

9.4.2　AP実行時のVOS1側の動作

9.4.3　AP実行時のPC側の動作（DCCM3を使用する場合）

9.4.4　AP実行時のPC側の動作（BCF/GCASTを使用する場合）

9.4.5　JP1/NETM/DMを利用したマップの配布

9.4.6　AP実行時の外字の扱い

9.5　画面・帳票作成時のメッセージ

10.　VOS1でのAP作成と実行

10.1　分散処理の仕組み

10.1.1　DCCM3での拡張ホストアクセス（論理マップ長≦2,920バイトの場合）

10.1.2　DCCM3での拡張ホストアクセス（論理マップ長＞2,920バイトの場合）

10.1.3　BCF/GCASTでの拡張ホストアクセス

10.2　VOS1側のインタフェース

10.2.1　DCCM3使用時のインタフェース

10.2.2　BCF/GCASTでのインタフェース

10.3　PC側のインタフェース

10.3.1　画面管理プログラム

10.3.2　メインフレームからの命令とPC側の処理

10.4　AP作成時の注意事項

10.4.1　論理マップの項目名

10.4.2　変更属性定義

10.4.3　16進指定（DFC）の動的変更

10.4.4　DCCM3の機能を代替する

11.　PCでの画面管理プログラムの利用と作成

11.1　サンプルプログラム

11.1.1　DCCM3で2,920バイト以内のデータをやり取りする（拡張ホストアクセス）

11.1.2　DCCM3で2,920バイトを超えるデータをやり取りする（拡張ホストアクセス）

11.1.3　COBOLによる画面管理プログラム

11.2　利用形態に応じた変更

11.2.1　仮想端末名およびマップ名を設定する

11.2.2　入力論理マップのクリア文字を指定する

11.2.3　トランザクションコード

11.2.4　CommuniNetの端末名称を変更する

11.2.5　画面管理プログラムにメインフレームAPの処理を分散する

11.3　コンパイルから実行まで

11.3.1　画面管理プログラムのコンパイルとリンケージ

11.3.2　画面管理プログラムの実行

12.　トラブルシューティング

12.1　回線接続時のトラブルと対処方法

12.2　画面・帳票出力時のトラブルと対処方法

12.3　DCCM3使用時のトラブルと対処方法

12.4　画面管理プログラムのトラブルと対処方法

12.5　CommuniNet Extension使用時のトラブルと対処方法

第4編　VOSKとPCで処理を分散させる

13.　VOSK-PC分散システムの環境設定

13.1　開発環境の設定

13.2　実行環境の設定

13.2.1　仮想端末名称の設定

13.2.2　TCP/IPの設定

13.2.3　CommuniNetの設定

13.2.4　マップパスの設定

13.2.5　外字の設定

14.　VOSK-PC分散システムのAP開発から運用まで

14.1　画面定義前の準備

14.1.1　フォルダを作成する

14.1.2　定義環境の設定

14.2　画面の定義

14.2.1　「日本語」項目の定義

14.2.2　下位項目の定義

14.2.3　EAGLE/4GLのプログラムを移行する

14.3　マップ生成とファイル転送

14.3.1　マップを生成する

14.3.2　マップファイルの転送

14.4　APの作成と実行

14.4.1　APの作成

14.4.2　AP実行時のVOSK側の動作

14.4.3　AP実行時のPC側の動作

14.4.4　AP実行時の外字の扱い

14.5　画面・帳票作成時のメッセージ

15.　VOSKでのAP作成と実行

15.1　VOSKとGCASTのインタフェース

15.1.1　OSCF/GCASTでの拡張ホストアクセス

15.1.2　対話環境でのインタフェース

15.2　AP作成時の注意事項

15.2.1　論理マップの項目名

15.2.2　論理マップの長さ

15.2.3　変更属性定義

15.2.4　16進指定（DFC）の動的変更

15.2.5　仮想端末名称の割り当て方法

16.　トラブルシューティング

16.1　回線接続時のトラブルと対処方法

16.2　画面出力時のトラブルと対処方法

16.3　CommuniNet Extension使用時のトラブルと対処方法

第5編　メインフレーム資産をPCへ移行する

17.　メインフレームの画面・帳票をPCへ移行する

17.1　画面・帳票を変換する手順

17.1.1　定義を修正する

17.2　パネル定義文をPCに転送する

17.2.1　VOS3からPCへの転送

17.2.2　VOS1からPCへの転送

17.2.3　VOSKからPCへの転送

17.2.4　転送時の注意事項

17.2.5　変換オプションの設定

17.3　パネル定義文の編集

17.3.1　デバイス名のPCでの対応

17.3.2　画面・帳票の構成要素の定義

17.4　ドローセットアップでの指定

17.4.1　イベント通知コード

17.4.2　画面の表示属性動的変更

17.4.3　項目の表示属性動的変更

17.4.4　制御項目属性

17.4.5　論理マップ属性

17.5　ファイルの変換

17.5.1　インポート機能の操作

17.5.2　変換時のメッセージ

17.6　ドローによる編集

17.6.1　隠しフィールド

17.6.2　論理項目

17.6.3　フレームと重なるオブジェクト

17.6.4　けい線と重なるフィールド

17.6.5　省略時仮定値の漢字定数

18.　メインフレームのタイプ1/2/R書式をPCへ移行する

18.1　開発環境の準備

18.1.1　フォルダを作成する

18.1.2　実行環境の設定

18.2　記述文ファイルをPCに転送する

18.2.1　VOS3からPCへの転送

18.2.2　VOS1からPCへの転送

18.2.3　VOSKからPCへの転送

18.2.4　転送時の注意事項

18.3　記述文ファイルをPC用に変換する

18.3.1　文字属性名の決定

18.3.2　記述文ファイルの変換

18.4　ドローによる編集

18.4.1　位置・長さの単位

18.4.2　書式定義ファイル名

18.4.3　部品

18.4.4　用紙の種別

18.4.5　レイアウト

18.4.6　線種と太さ

18.4.7　角の丸め

18.4.8　円と円弧

18.4.9　文字列の字間値

18.4.10　文字属性名の関連づけ

18.4.11　繰り返し

18.4.12　ドットパターン

18.4.13　網掛け種別

18.5　タイプ1/2/R書式インポート時のメッセージ

第6編　メインフレーム資産をPCで開発する

19.　メインフレーム用の画面・帳票をPCで定義する

19.1　メインフレーム向け開発環境の準備

19.1.1　フォルダを作成する

19.1.2　開発環境の設定

19.1.3　実行環境の設定

19.1.4　外字の扱い方

19.2　メインフレーム用の画面・帳票の定義

19.2.1　画面の定義

19.2.2　シリアルプリンタ（HT-5344）用帳票の定義

19.2.3　ページプリンタ（HT-2311）用帳票の定義

19.3　テスト支援機能

19.3.1　シリアルプリンタ（HT-5344）の場合

19.3.2　ページプリンタ（HT-2311）の場合

19.4　パネル定義文の生成

19.5　パネル定義文の転送

19.5.1　パネル定義文をVOS3に転送する

19.5.2　パネル定義文をVOS1に転送する

19.5.3　パネル定義文をVOSKに転送する

19.6　メインフレーム用APの作成・流用の注意事項

19.6.1　論理マップの項目名

19.6.2　変更属性定義

19.6.3　16進指定（DFC）の動的変更

19.7　画面・帳票エクスポート時のメッセージ（T-560/20用）

20.　メインフレーム用のタイプ3書式をPCで定義する

20.1　開発環境の準備

20.1.1　フォルダを作成する

20.1.2　開発環境の設定

20.1.3　実行環境の設定

20.1.4　外字の扱い方

20.2　定義内容の決定

20.2.1　レイアウト領域

20.2.2　配置する項目

20.3　ドローによるタイプ3書式の定義

20.3.1　タイプ3書式の定義の手順

20.3.2　タイプ3書式定義時の注意事項

20.4　パネル定義文ファイルの生成

20.5　パネル定義文ファイルの転送

20.5.1　VOS3にパネル定義文ファイルを転送する

20.5.2　VOS1にパネル定義文ファイルを転送する

20.5.3　VOSKにパネル定義文ファイルを転送する

20.6　メインフレームでの注意事項

20.7　タイプ3書式エクスポート時のメッセージ

21.　メインフレーム用のタイプ1/2/R書式をPCで定義する

21.1　開発環境の準備

21.1.1　フォルダを作成する

21.1.2　開発環境の設定

21.1.3　実行環境の設定

21.1.4　外字の扱い方

21.2　定義内容の決定

21.2.1　レイアウト領域

21.2.2　タイプ1/2/R書式に定義する内容を決定する

21.2.3　文字属性名の決定

21.3　ドローによる書式オーバレイの定義

21.3.1　タイプ1/2/R書式の定義の手順

21.3.2　タイプ1/2/R書式定義時の注意事項

21.4　記述文ファイルの生成

21.5　記述文ファイルの転送

21.5.1　VOS3に記述文ファイルを転送する

21.5.2　VOS1に記述文ファイルを転送する

21.5.3　VOSKに記述文ファイルを転送する

21.6　タイプ1/2/R書式エクスポート時のメッセージ

付録

付録A　メインフレームとPCとの用語の対応

付録B　メインフレームとの処理分散

付録B.1　リターンコード

付録B.2　文字コードの違い

付録B.3　外字用コードの割り当て

付録B.4　プログラム例

付録B.5　CommuniNet Extensionを使用したメインフレーム・PC連携機能でのトラブルと対処方法

付録C　メインフレーム資産の移行

付録C.1　インポート機能で変換できる画面・帳票の機能範囲

付録C.2　CUI画面からGUI画面への移行

付録C.3　インポート機能で変換できる記述文の機能範囲

付録C.4　インポートした記述文の内容とドローとの関係

付録D　メインフレーム資産の開発

付録D.1　エクスポート機能で変換できるCUI画面の機能範囲

付録D.2　エクスポート機能で変換できるけい線帳票の機能範囲

付録D.3　エクスポート機能で変換できる網掛け帳票の機能範囲

付録D.4　エクスポート機能で変換できるタイプ3書式の機能範囲

付録D.5　エクスポート機能で変換できるタイプ1/2/R書式の機能範囲

付録E　用語解説

索引

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

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

前書き

■ 対象製品

P-262B-5C44　 XMAP3/Enterprise Edition Version 4　 04-10（適用OS：Windows 95，Windows 98，Windows Me，Windows NT，Windows 2000，Windows XP，Windows Server 2003，Windows Server 2003 x64）
P-262B-5C4U　 XMAP3/Enterprise Edition Version 4 Upgrade　 04-10（適用OS：Windows 95，Windows 98，Windows Me，Windows NT，Windows 2000，Windows XP，Windows Server 2003，Windows Server 2003 x64）
P-F262B-5444A　 XMAP3外字機能 Version 4　 04-08（適用OS：Windows NT，Windows 2000，Windows XP，Windows Server 2003）
P-F262B-544UA　 XMAP3外字機能 Version 4 Upgrade　 04-08（適用OS：Windows NT，Windows 2000，Windows XP，Windows Server 2003）

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

■ 輸出時の注意

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

■ 商標類

AIXは，米国における米国International Business Machines Corp.の登録商標です。
BackOfficeは，米国Microsoft Corp.の登録商標です。
ESC/Pは，セイコーエプソン（株）の商標です。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
Itaniumは，アメリカ合衆国および他の国におけるインテル コーポレーションまたはその子会社の登録商標です。
JFIFは，C-Cube Microsystems 社が規定したフォーマットの名称です。
KanjiLinkは，イースト株式会社の登録商標です。
Linuxは，Linus Torvaldsの米国およびその他の国における登録商標あるいは商標です。
LIPSII+は，キヤノン（株）が開発した言語仕様です。
LIPSIIIは，キヤノン（株）が開発した言語仕様です。
Microsoftは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
MS-DOSは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
PA-RISCは，米国Hewlett-Packard Companyの商標です。
Red Hatは，米国およびその他の国でRed Hat,Inc. の登録商標若しくは商標です。
Solarisは，米国Sun Microsystems,Inc. の米国およびその他の国における商標または登録商標です。
TrueTypeは，米国Apple Computer,Inc.の商品名称です。
TurboLinuxの名称及びロゴは，TurboLinux,Inc. の商標です。
UNIXは，X/Open Company Limited が独占的にライセンスしている米国ならびに他の国における登録商標です。
Visual C++は，米国およびその他の国における米国Microsoft Corp.の登録商標です。
VJE-Deltaは，株式会社バックスが開発した日本語入力フロントエンドプロセッサです。
Windowsは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Windows NTは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Windows Serverは，米国およびその他の国における米国Microsoft Corp. の商標です。
メーカ固有漢字セット（日立KEIS83拡張3）は，イースト（株）の製品です。

■ 発行

2001年 4月（第1版） 3020-7-595
2006年 9月（第9版） 3020-7-595-80

■ 著作権

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

変更内容

変更内容（3020-7-595-80）　XMAP3 Version 4 04-10

追加・変更内容 | 変更個所
Windows Server 2003 R2，Windows Server 2003 R2 x64に対応した。 | －
メインフレームで，GUI画面のフィールドボックスの改行入力属性を指定したフィールドを使用するための注意事項を追加した。 | 付録B.2

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

変更内容（3020-7-595-70）　XMAP3 Version 4 04-09

追加・変更内容

[ユティリティ]の[オプション設定]ダイアログに「論理セグメント文群の論理／制御項目順の論理マップを使用する（メインフレームのみ）」のチェックボックスを追加した。

対象デバイスに「4451，D2」を追加した。

変更内容（3020-7-595-60）　XMAP3 Version 4 04-08

追加・変更内容

VOS3-PC分散システムのソフトウェア構成の例に，対話環境の場合の例を追加した。

Windows Server 2003 x64に対応した。

日立コード変換 - Development Kitのバージョンによっては，ベンダ固有文字を利用できるようになった。

変更内容（3020-7-595-50）　XMAP3 Version 4 04-07

追加・変更内容

日立コード変換に対応した。

メインフレーム-PC分散システムで，画面管理プログラムをCOBOL言語で作成する場合に使用できるOSにWindows Server 2003を追加した。

はじめに

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

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

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

P-F262B-5444A　XMAP3外字機能 Version 4

P-F262B-544UA　XMAP3外字機能 Version 4 Upgrade

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

対象読者

XMAP3を利用して次のような業務を開発，または運用する方を対象としています。

メインフレームとPCで処理を分散させるアプリケーションプログラムを開発，または運用する場合。メインフレームのXMAP，およびCOBOL85について理解していることを前提とします。

既存のメインフレーム資産を流用してPC用の書式オーバレイを定義する場合。メインフレームのXMAP2/FOG，およびFOG2 E2について理解していることを前提とします。

PCで画面，帳票，および書式（タイプ3書式やタイプ1/2/R書式）を定義して，メインフレームで運用する場合。メインフレームのXMAP，XMAP2/FOG，FOG2 E2，およびCOBOL85について理解していることを前提とします。

マニュアルの構成

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

第1編　メインフレーム連携機能の概要

XMAP3のメインフレーム連携機能の機能概要と特長，および開発手順の流れについて説明しています。

第2編　VOS3とPCで処理を分散させる

VOS3とPCで処理を分散させるためのシステム構成，画面・帳票の定義，APの作成と実行について説明しています。

第3編　VOS1とPCで処理を分散させる

VOS1とPCで処理を分散させるためのシステム構成，画面・帳票の定義，APの作成と実行について説明しています。

第4編　VOSKとPCで処理を分散させる

VOSKとPCで処理を分散させるためのシステム構成，画面・帳票の定義，APの作成と実行について説明しています。

第5編　メインフレーム資産をPCへ移行する

メインフレーム上で運用していた既存の資産（画面，帳票，およびタイプ1/2/R書式）をPCで利用するための移行手順や注意事項について説明しています。

第6編　メインフレーム資産をPCで開発する

メインフレームで使用するための資産（画面，帳票，タイプ3書式，およびタイプ1/2/R書式）をPCで定義する手順や注意事項について説明しています。

付録A　メインフレームとPCとの用語の対応

付録B　メインフレームとの処理分散

付録C　メインフレーム資産の移行

付録D　メインフレーム資産の開発

付録E　用語解説

マニュアル体系図

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

関連マニュアル

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

〈Windows共通〉

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

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

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

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

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

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

COBOL85 言語（3020-3-782）

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

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

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

COBOL拡張ライブラリ（3020-3-596）

COBOL拡張ライブラリ（3020-3-766）

CommuniNet（Windows NT，Windows 95用）（3020-3-660）

CommuniNet Version 3（3020-3-821）

CommuniNet Extension（Windows NT，Windows 95用）（3020-3-661）

CommuniNet Extension Version 3（3020-3-822）

注※1

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

〈UNIX〉

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

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

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

〈Windows，UNIX共通〉

OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 運用と操作（3000-3-363）※2

OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 クライアント使用の手引（3000-3-364）※2

OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 運用と操作（3000-3-944）※2

OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編（3000-3-949）※2

OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 クライアント使用の手引 TP1/Client/J編（3000-3-950）※2

JP1 Version 5 JP1/NETM/DM（3020-3-835）※3

JP1 Version 6 JP1/NETM/DM システム運用（3020-3-928）※3

JP1 Version 7i JP1/NETM/DM システム運用1（Windows(R)用）（3020-3-G32）※3

JP1 Version 7i JP1/NETM/DM システム運用2（Windows(R)用）（3020-3-G33）※3

注※2

このマニュアルの本文では，OpenTP1関連マニュアルのタイトルにある「バージョン表記」を省略しています。省略した表記を次に示します。

マニュアル名
このマニュアルでの表記

「OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 運用と操作」
「OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 運用と操作」
「OpenTP1 運用と操作」

「OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 クライアント使用の手引」
「OpenTP1 クライアント使用の手引」

「OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」
「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」

「OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 クライアント使用の手引 TP1/Client/J編」
「OpenTP1 クライアント使用の手引 TP1/Client/J編」

「OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 プロトコル TP1/NET/XMAP3編」
「OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 プロトコル TP1/NET/XMAP3編」
「OpenTP1 プロトコル TP1/NET/XMAP3編」

注※3

このマニュアルの本文では，JP1関連マニュアルのタイトルにある「バージョン表記」を省略しています。省略した表記を次に示します。

マニュアル名
このマニュアルでの表記

「JP1 Version 5 JP1/NETM/DM」
「JP1 Version 6 JP1/NETM/DM システム運用」
「JP1 Version 7i JP1/NETM/DM システム運用1（Windows(R)用）」
「JP1 Version 7i JP1/NETM/DM システム運用1（Windows(R)用）」
「JP1/NETM/DM システム運用」

〈Windows NT，Windows 2000共通〉

コード変換ユーザーズガイド（3020-7-350）

日立コード変換ユーザーズガイド（3020-7-351）

〈VOS3/AS，VOS3/FS，VOS3/LS共通〉

データマネジメントシステム XDM E2系 解説（6190-6-620）

データマネジメントシステム XDM E2系 プログラム作成の手引（XDM/BASE・DCCM3・TM2）（6190-6-623）

TSS端末入出力プログラムTIOP3 使用の手引（6190-3-371）

COBOL85 言語（6190-3-723）

統合ネットワーク管理システム/ソフトウェア配布管理支援 NETM/DM 解説（6190-6-297）

ファイル伝送プログラム IFIT-TSS E2（6180-3-375）

EAGLE2 運用の手引（6180-3-813）

EAGLE2 システム設計編（6180-3-810）

漢字CORAL KCORAL E2 解説（6180-6-341）

漢字CORAL KCORAL E2 文法（6180-6-342）

書式オーバレイゼネレータ FOG2 E2（6190-3-479）

漢字処理ユティリティKAPS E3（6190-3-489）

端末メッセージマッピング支援 書式サポート XMAP2/FOG（6190-3-490）

〈VOS1/ES2，VOS1/FS，VOS1/LS共通〉

データコミュニケーションマネジメントシステム DCCM3 解説（6150-6-101）

データコミュニケーションマネジメントシステム DCCM3 プログラミングの手引（6150-6-103）

GUIシステム構築支援 BCF/GCAST（6150-3-375）

統合ネットワーク管理システム/ソフトウェア配布管理支援 NETM/DM（6150-3-391）

COBOL85 言語（6150-3-714）

EAGLE2（6150-3-811）

漢字CORAL KCORAL 操作（6150-6-603）

漢字CORAL KCORAL 文法（6150-6-602）

端末メッセージマッピング支援/書式サポート XMAP2/FOG（6150-3-368）

書式オーバレイゼネレータ FOG2 E2（6150-3-328）

漢字処理ユティリティ KAPS（6150-3-323）

〈VOS1/ES2〉

ワークステーション操作 －パネル編－（6140-9-105）

ワークステーション操作 －コマンド編－（6140-9-106）

対話型制御システム ES/IEX 使用の手引（6140-3-172）

〈VOS1/FS，VOS1/LS共通〉

ワークステーション操作 －パネル編－（6150-9-105）

ワークステーション操作 －コマンド編－（6150-9-106）

対話型制御システム ES/IEX 使用の手引（6150-3-172）

〈VOSK，VOSK/FS，VOSK/LS共通〉

COBOL85 －言語編－（650-3-212）

EAGLE/4GL 文法（650-3-125）

EAGLE/4GLによる業務開発（650-3-104）

GUIシステム構築支援 OSCF/GCAST（650-3-415）

書式帳票定義機能 XMAP/FOG（650-3-159）

書式オーバレイゼネレータ FOG2 E2（650-3-156）

漢字処理（650-3-154）

コマンド（650-9-161）

パネル（650-9-162）

読書手順

このマニュアルは，利用目的に合わせて直接，編を選択して読むことができます。利用目的に応じて，次の流れに従ってお読みいただくことをお勧めします。

このマニュアルでの表記

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

製品名
略称

AIX 5L V5.1
AIX

AIX 5L V5.2

AIX 5L V5.3

HP-UX 10.20
HP-UX

HP-UX 11

HP-UX 11i

HP-UX 11i V2（IPF）

HP-UX 11i V2（PA-RISC）

CommuniNet
CommuniNet

CommuniNet Version3

Microsoft(R) Visual C++(R) Version 5.0
Visual C++ Version 5.0
Visual C++またはVC++

Microsoft(R) Visual C++(R) Version 6.0
Visual C++ Version 6.0

Microsoft(R) Visual C++(R).NET 2002
Visual C++ .NET 2002
Visual C++ .NET

Microsoft(R) Visual C++(R).NET 2003
Visual C++ .NET 2003

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 Small Business Server Version 4.0
Windows NT Server
Windows NT
（またはWindows NT 4.0）

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

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

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

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, Standard Edition 日本語版
Windows Server 2003

Microsoft(R) Windows Server(TM) 2003, Enterprise Edition 日本語版

Microsoft(R) Windows Server(TM) 2003 R2, Standard Edition 日本語版

Microsoft(R) Windows Server(TM) 2003 R2, Enterprise Edition 日本語版

Microsoft(R) Windows Server(TM) 2003, Standard x64 Edition 日本語版
Windows Server 2003 x64

Microsoft(R) Windows Server(TM) 2003, Enterprise x64 Edition 日本語版

Microsoft(R) Windows Server(TM) 2003 R2, Standard x64 Edition 日本語版

Microsoft(R) Windows Server(TM) 2003 R2, Enterprise x64 Edition 日本語版

Solaris 7
Solaris

Solaris 8

Solaris 9

TP1/Message Control
TP1/MCF

TP1/NET/Library

TP1/NET/XMAP3

TurboLinux Server 日本語版 6.1
Linux

Red Hat Linux 6.2J

VOS3/AS
VOS3

VOS3/FS

VOS3/LS

VOS1/ES2
VOS1

VOS1/FS

VOS1/LS

VOSK
VOSK

VOSK/FS

VOSK/LS

XMAP3/Enterprise Edition Version4
XMAP3/Enterprise Edition

XMAP3/NET Version4
XMAP3/ NET

Microsoft(R) Windows Server(TM) 2003 R2, Standard Edition 日本語版，Microsoft(R) Windows Server(TM) 2003 R2, Enterprise Edition 日本語版をWindows Server 2003 R2と表記します。Microsoft(R) Windows Server(TM) 2003 R2, Standard x64 Edition 日本語版，Microsoft(R) Windows Server(TM) 2003 R2, Enterprise x64 Edition 日本語版を，Windows Server 2003 R2 x64と表記します。

Windows 95，Windows 98，Windows Me，Windows NT，Windows 2000，Windows XP，Windows Server 2003，およびWindows Server 2003 x64に機能差がない場合，Windowsと表記します。

AIX，HP-UX，Solaris，およびLinuxで機能差がない場合，WSと表記します。

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

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

略称 | 正式名称
AP | Application Program
BMP | Batched Message Processing Program
C/Sシステム | Client / Server System
CPI | Characters Per Inch
CUI | Character User Interface
EUC | Extended UNIX Code
GUI | Graphical User Interface
HNA | Hitachi Network Architecture
IPF | Itanium(R) Processor Family
JIS | Japanese Industrial Standard
KEIS | Kanji processing Extended Information System
LIC | LAN Interface Control
MCR | Magnetic Character Reader
MF | Main Frame
MPP | Message Processing Program
OCR | Optical Character Reader
OLTP | Online Transaction Processing
OS | Operating System
PC | Personal Computer
PDL | Page Description Language
RPC | Remote Procedure Call
TCP/IP | Transmission Control Protocol/Internet Protocol
WS | Workstation

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

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

記号
意味

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

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

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

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

図中で使用する記号

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

オンラインヘルプの紹介

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

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

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

個所（かしょ）　矩形（くけい）　桁（けた）　揃え（そろえ）　必須（ひっす）

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

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

1.　メインフレームとの連携について

この章では，PC上のXMAP3とメインフレームを連携して利用する機能について，その概要を説明します。

＜この章の構成＞

1.1　XMAP3によるメインフレームとの連携

1.2　VOS3-PC分散システムの構成

1.3　VOS1-PC分散システムの構成

1.4　VOSK-PC分散システムの構成

1.1　XMAP3によるメインフレームとの連携

＜この節の構成＞

1.1.1　連携機能の特長

1.1.2　メインフレームとPCで処理を分散する

1.1.3　メインフレームの資産をPCに移行する

1.1.4　メインフレーム用の資産をPCで定義する

1.1.1　連携機能の特長

XMAP3では，画面や帳票を定義する機能に加えて，メインフレーム（VOSシリーズ）とPCとを接続したシステム環境で扱う画面や帳票の作成や実行ができます。

これらの機能をメインフレーム連携機能と呼びます。メインフレーム連携機能には，大きく分けて次の三つがあります。

メインフレームとPCで処理を分散する

メインフレームの資産をPCに移行する（画面・帳票定義資産を流用する）

メインフレーム用の資産をPCで定義する（定義ツールとして利用する）

なお，このマニュアルではメインフレーム連携機能に関する内容を説明しています。そのほかのXMAP3の機能や概要についてはそれぞれ下記のマニュアルを参照してください。

XMAP3の機能
マニュアル名称

XMAP3の基本的な機能を知りたい。

例題を通して，XMAP3の基本的な操作方法を知りたい。

「XMAP3 入門」

XMAP3の開発環境の設定について知りたい。

XMAP3で提供されている支援機能について知りたい。

開発時や実行時のトラブルシュートについて知りたい。

「XMAP3 開発・実行ガイド」

ドロー機能を使った画面開発の概要や手順を知りたい。

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

ドロー機能を使った帳票開発の概要や手順を知りたい。

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

注意

このマニュアルでは，メインフレーム上の帳票や書式を，PC上のXMAP3で使用する用語に合わせて次のように表記します。

マップ帳票

XMAP2 E2やBSF E2などで扱える，パネル定義文によって定義された帳票を示します。

タイプ1/2/R書式

FOG2 E2やOSCF E2などで扱える，タイプ1書式，タイプ2書式，タイプR書式を示します。これらの書式は記述文によって定義されます。

マップ帳票，タイプ3書式，およびタイプ1/2/R書式を総称して「帳票」と表記します。

メインフレーム連携機能としてXMAP3では次に示す機能を用意しています。

開発機能
次に示す機能はXMAP3/Enterprise Editionだけが提供しています。

メインフレーム-PC間で，処理を分散するためのマップをPC上で生成する環境

メインフレームのXMAPシリーズで使用する，パネル定義文を生成する環境

メインフレームのXMAPシリーズで使用する，タイプ3書式やタイプ1/2/R書式を定義する環境

PC上のXMAP3で使用する画面やマップ帳票を，メインフレーム資産から流用する環境

PC上のXMAP3で使用する書式オーバレイを，メインフレーム資産から流用する環境

また，XMAP3外字機能と連携して最大6,400文字の外字を利用できるようにする機能を備えています。

実行機能
実行機能として，次の2種類があります。これらの機能はXMAP3/Enterprise Edition Run Time Systemと同じです。

メインフレーム-PC間でマッピングを分散するための実行支援機能

開発機能と同様にXMAP3外字機能と連携して最大6,400文字の外字を利用できるようにする機能

WSの画面・帳票をPCで開発したり，PCへ移行したりするWSとの連携機能については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

1.1.2　メインフレームとPCで処理を分散する

メインフレームでのマッピング処理をPCで実行し，メインフレームの負荷を分散する利用方法です。APで使用する画面やマップ帳票はPCで開発できます。マッピング処理をPCに分散する形態の概要を次の図に示します。

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

APはメインフレーム上で動作させ，画面データやマップ帳票データの編集，および入出力マッピングをPCへ分散します。マッピング処理をメインフレームからPCに分散すると，メインフレーム上のAPからPCのGUI画面を利用できます。また，PC側でマッピングするため，メインフレームとPC間でのデータ転送量を抑えることができ，通信コストを削減できます。なお，メインフレームとPCで扱う文字コードの違いはXMAP3によって処理されます。したがって，メインフレームだけで実行していた形態から分散処理形態に移行する場合でも，既存のAPを大きく変更することなくGUI画面を利用できるようになります。

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

なお，実行環境となる分散システムの構成や必要なソフトウェアについては，「1.2　VOS3-PC分散システムの構成」，「1.3　VOS1-PC分散システムの構成」，または「1.4　VOSK-PC分散システムの構成」をそれぞれ参照してください。また，分散システムの開発環境や開発手順については，「2.1　メインフレーム-PC分散システムの開発環境と開発手順」を参照してください。

利用できるXMAP3シリーズの機能

メインフレーム-PC分散システム用の画面・マップ帳票で利用できる機能を次の表に示します。

表1-1　メインフレーム-PC分散システム用の画面・マップ帳票で利用できる機能

機能の種類
利用できる範囲

適用言語
COBOL（メインフレーム側）

環境

VOS3：XDM/DCCM3またはTIOP3

VOS1：DCCM3またはBCF/GCAST

VOSK：OSCF/GCAST

画面機能
CUI画面（T-560/20　タイプ3と同等）※1
GUI画面（CUI画面と同様のコーディングでGUI画面処理ができる）※1

マップ帳票機能※²
シリアルプリンタの機能※1
ページプリンタの機能※1

APインタフェース
論理マップと物理マップの対応は1対1
DFCのビットパターンによる直接指定は使用できない

注※1

XMAP3で定義する場合，利用できる機能が一部制限されます。メインフレーム用のXMAPとPC用のXMAP3の違いについては，「付録B　メインフレームとの処理分散」を参照してください。

注※2

BCF/GCASTまたはOSCF/GCASTを使用する場合，マップ帳票機能は利用できません。

1.1.3　メインフレームの資産をPCに移行する

メインフレームで運用していたシステムをダウンサイジングするなどの目的のために，メインフレームで利用していた画面，マップ帳票，またはタイプ1/2/R書式をPCに移行する利用方法です。メインフレーム環境で実行していたAPをPC環境に移行したいとき，メインフレームの既存資産をほとんど変更しないでPC用の画面・帳票定義として流用できます。

＜この項の構成＞

(1)　画面やマップ帳票の移行

(2)　タイプ1/2/R書式の移行

(1)　画面やマップ帳票の移行

メインフレームで使用していた画面やマップ帳票のパネル定義文をPCに転送し，インポート機能を利用してPC用のマップ定義ファイルに変換します。変換したマップ定義ファイルは，XMAP3のドローで編集できます。メインフレームの画面・マップ帳票をPCに移行する形態の概要を次の図に示します。

ドローでの編集方法についてはマニュアル「XMAP3 プログラミングガイド 画面編」，またはマニュアル「XMAP3 プログラミングガイド 帳票編」を参照してください。

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

メインフレームの画面やマップ帳票をPCへ移行する作業の流れや，移行できる機能範囲などについては，「2.2　メインフレーム資産を移行してPCで運用する手順」を参照してください。

(2)　タイプ1/2/R書式の移行

メインフレームで使用していたタイプ1/2/R書式の記述文ファイルや部品ファイルをPCに転送し，インポート機能を利用してPC用の書式定義ファイルに変換します。変換した書式定義ファイルは，XMAP3のドローで編集できます。メインフレームのタイプ1/2/R書式をPCに移行する形態の概要を次の図に示します。

ドローでの編集方法についてはマニュアル「XMAP3 プログラミングガイド 帳票編」を参照してください。

図1-3　メインフレームのタイプ1/2/R書式をPCに移行する形態の概要

タイプ1/2/R書式をPCへ移行する作業の流れや，移行できる機能範囲などについては，「2.2　メインフレーム資産を移行してPCで運用する手順」を参照してください。

1.1.4　メインフレーム用の資産をPCで定義する

メインフレーム用の画面や帳票を，PCとの共通範囲内の機能を使用し，PC上で開発する利用方法です。XMAP3を画面・帳票の定義ツールとして利用すれば，優れた定義環境によって画面・帳票定義の生産性を大幅に向上できます。

＜この項の構成＞

(1)　画面・マップ帳票を定義する

(2)　タイプ3書式を定義する

(3)　タイプ1/2/R書式を定義する

(1)　画面・マップ帳票を定義する

XMAP3のドローで画面やマップ帳票を定義して，パネル定義文を生成します。このパネル定義文をメインフレームへファイル転送し，メインフレーム上のXMAPシリーズを使ってパネル定義文からマップを生成し，APで利用します。メインフレーム用の画面・マップ帳票をPCで定義する形態の概要を次の図に示します。

図1-4　メインフレーム用の画面・マップ帳票をPCで定義する形態の概要

メインフレームの画面やマップ帳票をPCで開発する手順の流れや，開発できる機能範囲などについては，「2.3.1　PC上で画面・マップ帳票を開発してメインフレームで運用する」を参照してください。

(2)　タイプ3書式を定義する

XMAP3のドローで，グラフィック帳票を定義して，パネル定義文ファイルを生成します。このパネル定義文をメインフレームへファイル転送し，メインフレーム上のXMAP2/FOGを使ってパネル定義文からマップを生成し，APで利用します。メインフレーム用のタイプ3書式をPCで定義する形態の概要を次の図に示します。

図1-5　メインフレーム用のタイプ3書式をPCで定義する形態の概要

タイプ3書式をPCで開発する手順の流れや，開発できる機能範囲などについては，「2.3.2　PC上でタイプ3書式を開発してメインフレームで運用する」を参照してください。

(3)　タイプ1/2/R書式を定義する

XMAP3のドローで，書式オーバレイを定義して，記述文ファイルを生成します。このパネル定義文をメインフレームへファイル転送し，メインフレーム上のFOG2 E2を使って記述文からマップを生成し，APで利用します。メインフレーム用のタイプ1/2/R書式をPCで定義する形態の概要を次の図に示します。

図1-6　メインフレーム用のタイプ1/2/R書式をPCで定義する形態の概要

タイプ1/2/R書式をPCで開発する手順の流れや，開発できる機能範囲などについては，「2.3.3　PC上でタイプ1/2/R書式を開発してメインフレームで運用する」を参照してください。

1.2　VOS3-PC分散システムの構成

XMAP3では，VOS3とPCの間で分散処理するためのマップをPC上で生成し，VOS3のAPと連携して運用できます。ここでは，分散システムの実行環境となるハードウェア構成や，必要なソフトウェア構成について説明します。

＜この節の構成＞

1.2.1　システム構成

1.2.2　ソフトウェア構成

1.2.1　システム構成

VOS3上のAPとXMAP3を連携して運用するシステムの，ハードウェア構成について説明します。それぞれのシステム構成で必要なソフトウェアについては，「1.2.2　ソフトウェア構成」を参照してください。

メインフレームとPCの通信制御にはXDM/DCCM3またはTIOP3を使用します。

＜この項の構成＞

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

(2)　ゲートウェイ構成

(3)　WAN経由のゲートウェイ構成

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

メインフレームとPCを同一LANに接続して処理を分散するシステム構成です。LAN上の各PCは，それぞれが直接メインフレームとデータをやり取りします。通信制御にはXDM/DCCM3またはTIOP3を使用します。

スタンドアロンのシステム構成の例を次の図に示します。

図1-7　VOS3-PC分散システムの例（スタンドアロン構成）

(2)　ゲートウェイ構成

HNA接続のメインフレームとPC側のLAN（TCP/IP接続）との中継として，ゲートウェイ機を使用するシステム構成です。ゲートウェイ機は，メインフレームとLAN上の各PCとのデータのやり取りを中継します。また，通信制御にはXDM/DCCM3またはTIOP3を使用します。ゲートウェイを使用するシステム構成の例を次の図に示します。

図1-8　VOS3-PC分散システムの例（ゲートウェイ構成）

(3)　WAN経由のゲートウェイ構成

HNA接続のメインフレームとPC側のLAN（TCP/IP接続）との中継にゲートウェイ機を使用するシステム構成です。ゲートウェイ機は，メインフレームとLAN上の各PCとのデータのやり取りを中継します。また，通信制御にはXDM/DCCM3またはTIOP3を使用します。ゲートウェイを使用するシステム構成の例を次の図に示します。

図1-9　VOS3-PC分散システムの例（WAN経由のゲートウェイ構成）

1.2.2　ソフトウェア構成

VOS3/AS，VOS3/FSまたはVOS3/LSでは，実行環境として，オンライン環境，対話環境，またはゲートウェイ環境のどれかを選びます。それぞれの環境の構成例を次の図に示します。

図1-10　VOS3-PC分散システムのソフトウェア構成の例（オンライン環境の場合）

図1-11　VOS3-PC分散システムのソフトウェア構成の例（対話環境の場合）

図1-12　 VOS3-PC分散システムのソフトウェア構成の例（ゲートウェイ環境の場合）

これらの環境によって，実行に必要なソフトウェアが異なります。実行に必要なソフトウェアを次に示します。

なお，システムの処理で外字マッピングテーブルをカスタマイズしたいときや，シフトJISの代わりにUnicodeで画面表示・帳票印刷したいときは，さらに必要となるソフトウェアがあります。詳しくは，「1.2.2(6)　外字の運用に必要なソフトウェア」を参照してください。

＜この項の構成＞

(1)　メインフレーム上に必要なソフトウェア（オンライン環境の場合）

(2)　メインフレーム上に必要なソフトウェア（対話環境の場合）

(3)　ゲートウェイ機に必要なソフトウェア

(4)　スタンドアロン端末に必要なソフトウェア

(5)　PC側の通信制御に必要なソフトウェア

(6)　外字の運用に必要なソフトウェア

(1)　メインフレーム上に必要なソフトウェア（オンライン環境の場合）

AP（COBOL85を使用して作成してください）

XDM/DCCM3

XNF E2

メインフレーム側でTCP/IP接続をする場合，さらに次のソフトウェアが必要です。

XNF/TCP，XNF/TCP/CSS560

また，PCの通信制御にTP1/Client/Pを利用する場合，次のソフトウェアが必要です。

DCCM3/TCP

DCCM3/SERVER/TP1（RPCを使用して通信するときに必要）

(2)　メインフレーム上に必要なソフトウェア（対話環境の場合）

AP（COBOL85を使用して作成してください）

通信管理プログラム（PC上のXMAP3インストールフォルダ¥SAMPLES¥C¥HSMHPROCを使用してください）

TIOP3

XNF E2

メインフレーム側でTCP/IP接続をする場合，さらに次のソフトウェアが必要です。

XNF/TCP，XNF/TCP/CSS560

また，提供されている通信管理プログラムのサンプル「HSMHPROC」はVOS3用のアセンブラのソースプログラムですが，PC上にインストールされるので，ファイルをVOS3上に転送してから使用してください。

(3)　ゲートウェイ機に必要なソフトウェア

ゲートウェイ機は，HNA接続をするときに使用します。ゲートウェイ機にPCを使用できるのは，WAN経由でメインフレームに接続する場合だけです。

(a)　OSがHI-UX/WE2の場合

CSS560/HNA

(b)　OSがHP-UXの場合

C/S560 HNA-Gateway

(c)　OSがWindows NT，Windows 2000，またはWindows Server 2003の場合

CommuniNetゲートウェイ

(4)　スタンドアロン端末に必要なソフトウェア

OSにはWindowsが必要です。

XMAP3/Enterprise Edition，またはXMAP3/Enterprise Edition Run Time System

画面管理プログラム※1

さらに，メインフレームとの通信のために次のソフトウェアのどちらかが必要です。なお，通信制御の選択については「1.2.2(5)　PC側の通信制御に必要なソフトウェア」を参照してください。

CommuniNetおよびCommuniNet Extension※1

TP1/Client/P※2

注※1

COBOL85で作成した画面管理プログラムを使用する場合は，COBOL85， COBOL85 Run Time SystemおよびCOBOL拡張ライブラリが必要です。

注※2

TP1/Client/Pを選択できるのは，メインフレーム側の通信制御にXDM/DCCM3を使用する場合だけです。

(5)　PC側の通信制御に必要なソフトウェア

XMAP3でメインフレームとデータを送受信するために，PC側の通信制御としてCommuniNetまたはTP1/Client/Pのどちらかを使用します。使用方法に応じたPC側の通信制御の選択基準を次の表に示します。

表1-2　PC側の通信制御の選択基準

想定する使用方法 | CommuniNet | TP1/Client/P
メインフレームでXDM/DCCM3を使用する | ○ | ○
メインフレームでXDM/DCCM3を使用して，2,920バイトを超えるサイズの論理マップを送受信する | ○※1 | ○
メインフレームでXDM/DCCM3を使用して，分岐メッセージによる帳票の非同期出力を行う | × | ○
メインフレームでTIOP3を使用する | ○※2 | ×
メインフレームとPCとの分散処理だけでなく，メインフレームにログインしてメインフレーム上のXMAPも使用する | ○ | ×

（凡例）

○：使用できる。

×：使用できない。

注※1

CommuniNetでは，一度に転送できる送信データの最大長は3,000バイトとなっています。ただし，XDM/DCCM3を使用する場合，論理マップのデータ転送時には，トランザクションコードや通信論理マップなど80バイト分のデータが付加されるため，一度に転送できる実質的な論理マップのデータ長は2,920バイト以下となります。

このため，論理マップのサイズが大きくなる場合は，メインフレームのAPおよび画面管理プログラムで，データを2,920バイトごとに分割して送受信する処理が必要になります。

したがって，2,920バイトを超えるデータをメインフレームとPCの間でやり取りする場合は，TP1/Client/Pを使用する方が，メインフレームのAPおよび画面管理プログラムをより簡単に作成できます。

注※2

CommuniNetでは，一度に転送できる送信データの最大長は3,000バイトとなっています。ただし，TIOP3を使用する場合，論理マップのデータ転送時には，通信論理マップ（64バイト分）のデータが付加されるため，一度に転送できる実質的な論理マップのデータ長は2,936バイト以下となります。

このため，論理マップのサイズが大きくなる場合は，メインフレームのAPおよび画面管理プログラムで，データを2,936バイトごとに分割して送受信する処理が必要になります。

(6)　外字の運用に必要なソフトウェア

PC上の外字は，シフトJISコードの外字のうち機種依存文字を除いた1,880文字だけが使用できます。また，PC上のシフトJISコードの外字は，XMAP3がメインフレームのKEISコードの対応する外字に置き換えます。PCの外字とメインフレームの外字との文字コードの対応については，「付録B.3　外字用コードの割り当て」を参照してください。

ただし，メインフレームのKEISコードで(95A1)₁₆～(A0FE)₁₆に対応する外字は，PC側に対応するシフトJISの文字コードがないので利用できません。

メインフレーム-PC間でやり取りされるデータに，これらのコードに対応する外字を使用したい場合，次の二つの方法があります。

日立コード変換 - Development Kit，またはコード変換SDKを使って，シフトJISとKEISの外字マッピングテーブルをカスタマイズする（使用する外字の数が1,880字までの場合）。
なお，ベンダ固有文字（Windows特殊文字，NEC選定IBM拡張文字，およびIBM選択文字）を使用する場合は，「付録B.2(4)　ベンダ固有文字についての注意事項」を参照してください。

XMAP3外字機能を使用して，PC側ではシフトJISの代わりにUnicodeで表示・印刷を行う（1,880字を超える外字を使用する場合）

なお，これらの運用形態を選択する場合，AP作成時に特別な処理は必要ありません。したがって，既存のAPを修正しないで，外字の運用形態を変更することもできます。

外字の運用形態の違いを次の表に示します。

表1-3　外字の運用形態

条件
標準
カスタマイズ
XMAP3外字機能

使用できる外字の個数
1,880字
1,880字
6,400字

対応するKEISコード
(81A1)₁₆～(94FE)₁₆※¹
KEISコードで(41A1)₁₆～(A0FE)₁₆のうち1,880字※¹
KEISコードで(41A1)₁₆～(A0FE)₁₆のうち6,400字※¹

開発に使用できるOS
Windows
Windows NT※2，
Windows 2000，
Windows XP，
Windows Server 2003，
Windows Server 2003 x64
Windows NT，
Windows 2000，
Windows XP，
Windows Server 2003

実行に使用できるOS
Windows
Windows
Windows NT，
Windows 2000，
Windows XP，
Windows Server 2003

PCでの外字の入力
できる
できる
できる※3

ドローでの外字の使用（固定項目での外字の使用）
できる
できる
シフトJISでも利用できる1,880字だけできる

画面・マップ帳票に出力する文字コード
シフトJIS
シフトJIS
Unicode

ソフトウェアの追加※⁴
不要
必要
必要

必要な作業

外字フォントの用意

外字フォントの用意

外字マッピングファイルのカスタマイズ

外字フォントの用意

外字セットの作成

外字セットのUnicode領域への割り当て

外字マッピングファイルのカスタマイズ※⁵

（凡例）

標準：KEISコードで(81A1)₁₆～(94FE)₁₆の範囲に割り当てられた1,880字の外字だけを使用する場合。

カスタマイズ：コード変換SDKまたは日立コード変換 - Development Kitを使用して，シフトJISとKEISの外字マッピングテーブルをカスタマイズする場合。

外字機能：XMAP3外字機能を利用して，PC上の文字コードにUnicodeを使用する場合。

注※1

下位バイトは(A1)₁₆～(FE)₁₆の範囲に限られます。

注※2

Windows NTは，コード変換SDKだけに対応します。

注※3

VJE-Delta for Unicode/XKP，またはVJE-Delta Ver.2.0 for Unicode/XKPが必要です。

注※4

必要なソフトウェアについては，「1.2.2　ソフトウェア構成」を参照してください。

注※5

コード変換SDK，コード変換ランタイム，日立コード変換 - Client Runtime，または日立コード変換 - Server Runtimeで，標準値での外字マッピングファイルを使用する場合は必要ありません。

(a)　カスタマイズしたシフトJISとKEISの外字マッピングテーブルを使用する場合

カスタマイズした外字マッピングテーブルは，実行環境に配布して使用します。このとき，OSにはWindowsが必要です。さらに，実行環境で必要となるソフトウェアを次の表に示します。

表1-4　実行環境のOSと必要なソフトウェア

OS | 必要なソフトウェア
Windows 95 | コード変換ランタイム　01-00以降
Windows 98
Windows Me | コード変換ランタイム　01-02以降
Windows NT | コード変換SDK　01-00以降，またはコード変換ランタイム　01-00以降
Windows 2000 Advanced Server，およびWindows 2000 Server | 日立コード変換 - Server Runtime　02-01以降，コード変換SDK　01-03以降，またはコード変換ランタイム　01-02以降
Windows 2000 Datacenter Server | 日立コード変換 - Server Runtime　02-01以降，コード変換SDK　01-03以降，またはコード変換ランタイム　01-03以降
Windows 2000 Professional | 日立コード変換 - Client Runtime　02-01以降，コード変換SDK　01-03以降，またはコード変換ランタイム　01-02以降
Windows XP | 日立コード変換 - Client Runtime　02-01以降，コード変換SDK　01-03以降，またはコード変換ランタイム　01-03以降
Windows Server 2003 | 日立コード変換 - Server Runtime　02-01以降，コード変換SDK　01-03以降，またはコード変換ランタイム　01-03以降
Windows Server 2003 R2 | 日立コード変換 - Server Runtime　02-02以降，コード変換SDK　01-04以降，またはコード変換ランタイム　01-04以降
Windows Server 2003 x64 | 日立コード変換 - Server Runtime　02-01以降
Windows Server 2003 R2 x64 | 日立コード変換 - Server Runtime　02-02以降

(b)　1,880字を超える外字を使用する場合

OSにはWindows NT，Windows 2000，Windows XP，またはWindows Server 2003が必要です。また，次の表に示すソフトウェアが必要です。

表1-5　1,880字を超える外字を使用する場合に必要なソフトウェア

OS
必要なソフトウェア

Windows NT

XMAP3外字機能 Version 4 04-02以降

KanjiLink XKP　01-00以降，
KanjiLink XKP V2.5　01-00以降，または
KanjiLink XKP V2.7　01-00以降

VJE-Delta for Unicode/XKP※1　01-00以降

コード変換SDK　01-00以降，または
コード変換ランタイム※2　01-00以降

Windows 2000 Advanced Server，およびWindows 2000 Server

XMAP3 外字機能 Version 4 04-02以降

KanjiLink XKP Version 2.2 for Windows 2000 実行時ライブラリ，
KanjiLink XKP　V2.2（実行時ライブラリ）01-00以降，または
KanjiLink XKP V2.7　01-00以降

VJE-Delta Ver.2.0 for Unicode/XKP※1

日立コード変換 - Server Runtime※2　02-01以降，
コード変換SDK　01-03以降，または
コード変換ランタイム※2　01-02以降

Windows 2000 Datacenter Server

XMAP3 外字機能 Version 4 04-02以降

KanjiLink XKP Version 2.2 for Windows 2000 実行時ライブラリ，
KanjiLink XKP　V2.2（実行時ライブラリ）01-00以降，または
KanjiLink XKP V2.7　01-00以降

VJE-Delta Ver.2.0 for Unicode/XKP※1

日立コード変換 - Server Runtime※2　02-01以降，
コード変換SDK　01-03以降，または
コード変換ランタイム※2　01-03以降

Windows 2000 Professional

XMAP3 外字機能 Version 4 04-02以降

KanjiLink XKP Version 2.2 for Windows 2000 実行時ライブラリ，
KanjiLink XKP　V2.2（実行時ライブラリ）01-00以降，または
KanjiLink XKP V2.7　01-00以降

VJE-Delta Ver.2.0 for Unicode/XKP※1

日立コード変換 - Client Runtime※2　02-01以降，
コード変換SDK　01-03以降，または
コード変換ランタイム※2　01-02以降

Windows XP

XMAP3 外字機能 Version 4 04-02以降

KanjiLink XKP Version 2.2 for Windows 2000 実行時ライブラリ，
KanjiLink XKP　V2.2（実行時ライブラリ）01-00以降，または
KanjiLink XKP V2.7　01-00以降

VJE-Delta for Unicode/XKP Ver2.1 01-00以降※1

日立コード変換 - Client Runtime※2　02-01以降，
コード変換SDK　01-03以降，または
コード変換ランタイム※2　01-03以降

Windows Server 2003

XMAP3 外字機能 Version 4 04-05以降

KanjiLink XKP Version 2.2 for Windows2000 実行時ライブラリ，
KanjiLink XKP V2.2（実行時ライブラリ）01-00以降，または
KanjiLink XKP V2.7 01-00以降

VJE-Delta for Unicode/XKP Ver.2.1 01-00以降※1

日立コード変換 - Server Runtime※2　02-01以降，
コード変換SDK 01-03以降，または
コード変換ランタイム※2　01-03以降

Windows Server 2003 R2

XMAP3 外字機能 Version 4 04-08以降

KanjiLink XKP V2.7 01-00以降

VJE-Delta for Unicode/XKP Ver.2.1 01-00以降※1

日立コード変換 - Server Runtime※2　02-02以降，
コード変換SDK 01-04以降，または
コード変換ランタイム※2　01-04以降

注

日立KEIS'83拡張3に相当する外字を使用する場合，「メーカ固有漢字セット（日立KEIS83拡張3）」が必要です。

注※1

画面で外字を入力する場合に必要となるソフトウェアです。

注※2

大量外字支援機能に加えて，KEIS/Unicode外字マッピングテーブルをカスタマイズすることもできます。ただし，「コード変換ランタイム」，「日立コード変換 - Server Runtime」，および「日立コード変換 - Client Runtime」ではカスタマイズできないため，「コード変換SDK」または「日立コード変換 - Development Kit」を使用してください。

1.3　VOS1-PC分散システムの構成

XMAP3では，VOS1とPCの間で分散処理するためのマップをPC上で定義し，VOS1のAPと連携して運用できます。ここでは，分散システムの実行環境となるハードウェア構成や，必要なソフトウェア構成について説明します。

＜この節の構成＞

1.3.1　システム構成

1.3.2　ソフトウェア構成

1.3.1　システム構成

VOS1上のAPとXMAP3を連携して運用するシステムの，ハードウェア構成について説明します。それぞれのシステム構成で必要なソフトウェアについては，「1.3.2　ソフトウェア構成」を参照してください。

メインフレームとPCの通信制御にはDCCM3またはBCF/GCASTを使用します。BCF/GCASTを使用する場合は，スタンドアロン構成のほかに，マップサーバ構成を選べます。どちらのシステム構成でも，ゲートウェイを使用できます。

＜この項の構成＞

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

(2)　ゲートウェイ構成

(3)　WAN経由のゲートウェイ構成

(4)　マップサーバ構成（BCF/GCASTを利用）

(5)　ゲートウェイ経由のマップサーバ構成（BCF/GCASTを利用）

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

メインフレームとPCを同一LANに接続して処理を分散するシステム構成です。LAN上の各PCは，それぞれが直接メインフレームとデータをやり取りします。通信制御にはDCCM3またはBCF/GCASTを使用します。

スタンドアロンのシステム構成の例を次の図に示します。

図1-13　VOS1-PC分散システムの例（スタンドアロン構成）

(2)　ゲートウェイ構成

HNA接続のメインフレームとPC側のLAN（TCP/IP接続）との中継として，ゲートウェイ機を使用するシステム構成です。ゲートウェイ機は，メインフレームとLAN上の各PCとのデータのやり取りを中継します。また，通信制御にはDCCM3またはBCF/GCASTを使用します。ゲートウェイを使用するシステム構成の例を次の図に示します。

図1-14　VOS1-PC分散システムの例（ゲートウェイ構成）

(3)　WAN経由のゲートウェイ構成

HNA接続のメインフレームとPC側のLAN（TCP/IP接続）との中継にゲートウェイ機を使用するシステム構成です。ゲートウェイ機は，メインフレームとLAN上の各PCとのデータのやり取りを中継します。また，通信制御にはDCCM3またはBCF/GCASTを使用します。ゲートウェイを使用するシステム構成の例を次の図に示します。

図1-15　VOS1-PC分散システムの例（WAN経由のゲートウェイ構成）

(4)　マップサーバ構成（BCF/GCASTを利用）

メインフレームと同一LAN上に接続したPCがクライアントサーバシステムとなっているシステム構成です。この構成では，マップサーバ機がマップライブラリおよびメインフレームとの通信を管理するので，各クライアント機に必要なのはXMAP3だけです。また，通信制御にはBCF/GCASTを使用するため，画面だけが利用できます。マップサーバ構成の例を次の図に示します。

図1-16　VOS1-PC分散システムの例（マップサーバ構成）

(5)　ゲートウェイ経由のマップサーバ構成（BCF/GCASTを利用）

ゲートウェイ構成とマップサーバ構成を組み合わせた構成です。メインフレームと，マップサーバ構成になっているPC側のLANとを，ゲートウェイ機を中継して接続します。通信制御にはBCF/GCASTを使用するため，画面だけが利用できます。マップサーバ構成の例を次の図に示します。

図1-17　VOS1-PC分散システムの例（ゲートウェイ経由のマップサーバ構成）

1.3.2　ソフトウェア構成

実行環境のソフトウェア構成の例を次の図に示します。

図1-18　VOS1-PC分散システムのソフトウェア構成（オンライン環境の場合）

図1-19　VOS1-PC分散システムのソフトウェア構成（対話環境の場合）

これらの環境によって，実行に必要なソフトウェアが異なります。実行に必要なソフトウェアを次に示します。

なお，システムの処理で外字マッピングテーブルをカスタマイズしたいときや，シフトJISの代わりにUnicodeで画面表示・帳票印刷したいときは，さらに必要となるソフトウェアがあります。詳しくは，「1.3.2(7)　外字の運用に必要なソフトウェア」を参照してください。

＜この項の構成＞

(1)　メインフレーム上に必要なソフトウェア（オンライン環境）

(2)　メインフレーム上に必要なソフトウェア（対話環境）

(3)　ゲートウェイ機に必要なソフトウェア

(4)　マップサーバ機に必要なソフトウェア

(5)　クライアント機に必要なソフトウェア

(6)　スタンドアロン端末に必要なソフトウェア

(7)　外字の運用に必要なソフトウェア

(1)　メインフレーム上に必要なソフトウェア（オンライン環境）

AP（COBOL85を使用して作成してください）

DCCM3

BCF E3（ES/HCAM）

メインフレーム側でTCP/IP接続をする場合，さらに次のソフトウェアが必要です。

HCAM/TCP，HCAM/TCP/CSS560

(2)　メインフレーム上に必要なソフトウェア（対話環境）

AP（COBOL85を使用して作成してください）

BCF/GCAST
BCF/GCASTを使用する場合，PCでは画面管理プログラムの代わりにPC用のGCASTを使用します。また，メインフレーム上のAPからはCUI画面およびGUI画面の入出力だけ使用できます。

BCF E3（ES/HCAM）

メインフレーム側でTCP/IP接続をする場合，さらに次のソフトウェアが必要です。

HCAM/TCP，HCAM/TCP/CSS560

(3)　ゲートウェイ機に必要なソフトウェア

ゲートウェイ機は，HNA接続をするときに使用します。ゲートウェイ機にPCを使用できるのは，WAN経由でメインフレームに接続する場合だけです。

(a)　OSがHI-UX/WE2の場合

CSS560/HNA

(b)　OSがHP-UXの場合

C/S560 HNA-Gateway

(c)　OSがWindows NT，Windows 2000，またはWindows Server 2003の場合

CommuniNetゲートウェイ

(4)　マップサーバ機に必要なソフトウェア

OSにはWindowsが必要です。

XMAP3/Enterprise Edition，またはXMAP3/Enterprise Edition Run Time System

GCAST

CommuniNet※

CommuniNet Extension※

注※

接続するクライアント台数分のCommuniNetアクセスライセンスが必要です。

(5)　クライアント機に必要なソフトウェア

OSにはWindowsが必要です。

XMAP3/NET，またはXMAP3/NET Run Time System

(6)　スタンドアロン端末に必要なソフトウェア

OSにはWindowsが必要です。

XMAP3/Enterprise Edition，またはXMAP3/Enterprise Edition Run Time System

画面管理プログラム※（DCCM3使用時）またはGCAST（BCF/GCAST使用時）

CommuniNetおよびCommuniNet Extension

注※

COBOL85で作成した画面管理プログラムを使用する場合は，COBOL85， COBOL85 Run Time SystemおよびCOBOL拡張ライブラリが必要です。

(7)　外字の運用に必要なソフトウェア

PC上の外字は，シフトJISコードの外字のうち機種依存文字を除いた1,880文字だけが使用できます。また，PC上のシフトJISコードの外字は，XMAP3がメインフレームのKEISコードの対応する外字に置き換えます。PCの外字とメインフレームの外字との文字コードの対応については，「付録B.3　外字用コードの割り当て」を参照してください。

ただし，メインフレームのKEISコードで(95A1)₁₆～(A0FE)₁₆に対応する外字は，PC側に対応するシフトJISの文字コードがないので利用できません。

メインフレーム-PC間でやり取りされるデータに，これらのコードに対応する外字を使用したい場合，次の二つの方法があります。

日立コード変換 - Development Kit，またはコード変換SDKを使って，シフトJISとKEISの外字マッピングテーブルをカスタマイズする（使用する外字の数が1,880字までの場合）。
なお，ベンダ固有文字（Windows特殊文字，NEC選定IBM拡張文字，およびIBM選択文字）を使用する場合は，「付録B.2(4)　ベンダ固有文字についての注意事項」を参照してください。

XMAP3外字機能を使用して，PC側ではシフトJISの代わりにUnicodeで表示・印刷を行う（1,880字を超える外字を使用する場合）

運用形態を選択する場合，AP作成時に特別な処理は必要ありません。したがって，既存のAPを修正しないで，外字の運用形態を変更することもできます。

外字の運用形態の違いを次の表に示します。

表1-6　外字の運用形態

条件
標準
カスタマイズ
XMAP3外字機能

使用できる外字の個数
1,880字
1,880字
6,400字

対応するKEISコード
(81A1)₁₆～(94FE)₁₆※¹
KEISコードで(41A1)₁₆～(A0FE)₁₆のうち1,880字※¹
KEISコードで(41A1)₁₆～(A0FE)₁₆のうち6,400字※¹

開発に使用できるOS
Windows
Windows NT※2，
Windows 2000，
Windows XP，
Windows Server 2003，
Windows Server 2003 x64
Windows NT，
Windows 2000，
Windows XP，
Windows Server 2003

実行に使用できるOS
Windows
Windows
Windows NT，
Windows 2000，
Windows XP，
Windows Server 2003

PCでの外字の入力
できる
できる
できる※3

ドローでの外字の使用（固定項目での外字の使用）
できる
できる
シフトJISでも利用できる1,880字だけできる

画面・マップ帳票に出力する文字コード
シフトJIS
シフトJIS
Unicode

ソフトウェアの追加※⁴
不要
必要
必要

必要な作業

外字フォントの用意

外字フォントの用意

外字マッピングファイルのカスタマイズ

外字フォントの用意

外字セットの作成

外字セットのUnicode領域への割り当て

外字マッピングファイルのカスタマイズ※⁵

（凡例）

標準：KEISコードで(81A1)₁₆～(94FE)₁₆の範囲に割り当てられた1,880字の外字だけを使用する場合。

カスタマイズ：コード変換SDKまたは日立コード変換 - Development Kitを使用して，シフトJISとKEISの外字マッピングテーブルをカスタマイズする場合。

外字機能：XMAP3外字機能を利用して，PC上の文字コードにUnicodeを使用する場合。

注※1

下位バイトは(A1)₁₆～(FE)₁₆の範囲に限られます。

注※2

Windows NTは，コード変換SDKだけに対応します。

注※3

VJE-Delta for Unicode/XKP，またはVJE-Delta Ver.2.0 for Unicode/XKPが必要です。

注※4

必要なソフトウェアについては，「1.3.2　ソフトウェア構成」を参照してください。

注※5

コード変換SDK，コード変換ランタイム，日立コード変換 - Client Runtime，または日立コード変換 - Server Runtimeで，標準値での外字マッピングファイルを使用する場合は必要ありません。

(a)　カスタマイズしたシフトJISとKEISの外字マッピングテーブルを使用する場合

カスタマイズした外字マッピングテーブルは，実行環境に配布して使用します。このとき，OSにはWindowsが必要です。さらに，実行環境で必要となるソフトウェアを次の表に示します。

表1-7　実行環境のOSと必要なソフトウェア

OS | 必要なソフトウェア
Windows 95 | コード変換ランタイム　01-00以降
Windows 98
Windows Me | コード変換ランタイム　01-02以降
Windows NT | コード変換SDK　01-00以降，またはコード変換ランタイム　01-00以降
Windows 2000 Advanced Server，およびWindows 2000 Server | 日立コード変換 - Server Runtime　02-01以降，コード変換SDK　01-03以降，またはコード変換ランタイム　01-02以降
Windows 2000 Datacenter Server | 日立コード変換 - Server Runtime　02-01以降，コード変換SDK　01-03以降，またはコード変換ランタイム　01-03以降
Windows 2000 Professional | 日立コード変換 - Client Runtime　02-01以降，コード変換SDK　01-03以降，またはコード変換ランタイム　01-02以降
Windows XP | 日立コード変換 - Client Runtime　02-01以降，コード変換SDK　01-03以降，またはコード変換ランタイム　01-03以降
Windows Server 2003 | 日立コード変換 - Server Runtime　02-01以降，コード変換SDK　01-03以降，またはコード変換ランタイム　01-03以降
Windows Server 2003 R2 | 日立コード変換 - Server Runtime　02-02以降，コード変換SDK　01-04以降，またはコード変換ランタイム　01-04以降
Windows Server 2003 x64 | 日立コード変換 - Server Runtime　02-01以降
Windows Server 2003 R2 x64 | 日立コード変換 - Server Runtime　02-02以降

(b)　1,880字を超える外字を使用する場合

OSにはWindows NT，Windows 2000，Windows XP，またはWindows Server 2003が必要です。また，次の表に示すソフトウェアが必要です。

表1-8　 1,880字を超える外字を使用する場合に必要なソフトウェア

OS
必要なソフトウェア

Windows NT

XMAP3外字機能 Version 4 04-02以降

KanjiLink XKP　01-00以降，
KanjiLink XKP V2.5　01-00以降，または
KanjiLink XKP V2.7　01-00以降

VJE-Delta for Unicode/XKP※1　01-00以降

コード変換SDK　01-00以降，または
コード変換ランタイム※2　01-00以降

Windows 2000 Advanced Server，およびWindows 2000 Server

XMAP3 外字機能 Version 4 04-02以降

KanjiLink XKP Version 2.2 for Windows 2000 実行時ライブラリ，
KanjiLink XKP　V2.2（実行時ライブラリ）01-00以降，または
KanjiLink XKP V2.7　01-00以降

VJE-Delta Ver.2.0 for Unicode/XKP※1

日立コード変換 - Server Runtime※2　02-01以降，
コード変換SDK　01-03以降，または
コード変換ランタイム※2　01-02以降

Windows 2000 Datacenter Server

XMAP3 外字機能 Version 4 04-02以降

KanjiLink XKP Version 2.2 for Windows 2000 実行時ライブラリ，
KanjiLink XKP　V2.2（実行時ライブラリ）01-00以降，または
KanjiLink XKP V2.7　01-00以降

VJE-Delta Ver.2.0 for Unicode/XKP※1

日立コード変換 - Server Runtime※2　02-01以降，
コード変換SDK　01-03以降，または
コード変換ランタイム※2　01-03以降

Windows 2000 Professional

XMAP3 外字機能 Version 4 04-02以降

KanjiLink XKP Version 2.2 for Windows 2000 実行時ライブラリ，
KanjiLink XKP　V2.2（実行時ライブラリ）01-00以降，または
KanjiLink XKP V2.7　01-00以降

VJE-Delta Ver.2.0 for Unicode/XKP※1

日立コード変換 - Client Runtime※2　02-01以降，
コード変換SDK　01-03以降，または
コード変換ランタイム※2　01-02以降

Windows XP

XMAP3 外字機能 Version 4 04-02以降

KanjiLink XKP Version 2.2 for Windows 2000 実行時ライブラリ，
KanjiLink XKP　V2.2（実行時ライブラリ）01-00以降，または
KanjiLink XKP V2.7　01-00以降

VJE-Delta for Unicode/XKP Ver2.1 01-00以降※1

日立コード変換 - Client Runtime※2　02-01以降，
コード変換SDK　01-03以降，または
コード変換ランタイム※2　01-03以降

Windows Server 2003

XMAP3 外字機能 Version 4 04-05以降

KanjiLink XKP Version 2.2 for Windows2000 実行時ライブラリ，
KanjiLink XKP V2.2（実行時ライブラリ）01-00以降，または
KanjiLink XKP V2.7 01-00以降

VJE-Delta for Unicode/XKP Ver.2.1 01-00以降※1

日立コード変換 - Server Runtime※2　02-01以降，
コード変換SDK 01-03以降，または
コード変換ランタイム※2　01-03以降

Windows Server 2003 R2

XMAP3 外字機能 Version 4 04-08以降

KanjiLink XKP V2.7 01-00以降

VJE-Delta for Unicode/XKP Ver.2.1 01-00以降※1

日立コード変換 - Server Runtime※2　02-02以降，
コード変換SDK 01-04以降，または
コード変換ランタイム※2　01-04以降

注

日立KEIS'83拡張3に相当する外字を使用する場合，「メーカ固有漢字セット（日立KEIS83拡張3）」が必要です。

注※1

画面で外字を入力する場合に必要となるソフトウェアです。

注※2

大量外字支援機能に加えて，KEIS/Unicode外字マッピングテーブルをカスタマイズすることもできます。ただし，「コード変換ランタイム」，「日立コード変換 - Server Runtime」，および「日立コード変換 - Client Runtime」ではカスタマイズできないため，「コード変換SDK」または「日立コード変換 - Development Kit」を使用してください。

1.4　VOSK-PC分散システムの構成

XMAP3では，VOSKとPCの間で分散処理するためのマップをPC上で定義し，VOSKのAPと連携して運用できます。ここでは，分散システムの実行環境となるハードウェア構成や，必要なソフトウェア構成について説明します。

＜この節の構成＞

1.4.1　システム構成

1.4.2　ソフトウェア構成

1.4.1　システム構成

VOSK上のAPとXMAP3を連携して運用するシステムの，ハードウェア構成について説明します。それぞれのシステム構成で必要なソフトウェアについては，「1.4.2　ソフトウェア構成」を参照してください。

VOSKとXMAP3とを連携させるとき，メインフレーム側の通信制御はOSCF/GCASTを使用します。また，利用できるのは画面機能だけです。

システム構成には，スタンドアロン構成とマップサーバ構成があります。さらに，それぞれのシステム構成で，ゲートウェイを使用できます。

＜この項の構成＞

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

(2)　ゲートウェイ構成

(3)　WAN経由のゲートウェイ構成

(4)　マップサーバ構成

(5)　ゲートウェイ経由のマップサーバ構成

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

メインフレームとPCを同一LANに接続し，処理を分散するシステム構成です。LAN上の各PCは，直接メインフレームとデータをやり取りします。

スタンドアロンのシステム構成の例を次の図に示します。

図1-20　VOSK-PC分散システムの例（スタンドアロン構成）

(2)　ゲートウェイ構成

HNA接続のメインフレームとPC側のLAN（TCP/IP接続）との中継として，ゲートウェイ機を使用するシステム構成です。ゲートウェイ機は，メインフレームとLAN上の各PCとのデータのやり取りを中継します。ゲートウェイを使用するシステム構成の例を次の図に示します。

図1-21　VOSK-PC分散システムの例（ゲートウェイ構成）

(3)　WAN経由のゲートウェイ構成

HNA接続のメインフレームとPC側のLAN（TCP/IP接続）との中継にゲートウェイ機を使用するシステム構成です。ゲートウェイ機は，メインフレームとLAN上の各PCとのデータのやり取りを中継します。ゲートウェイを使用するシステム構成の例を次の図に示します。

図1-22　VOSK-PC分散システムの例（WAN経由のゲートウェイ構成）

(4)　マップサーバ構成

メインフレームと同一LAN上に接続したPCがクライアントサーバシステムとなっているシステム構成です。この構成では，マップサーバ機がマップライブラリおよびメインフレームとの通信を管理するので，各クライアント機に必要なのはXMAP3だけです。マップサーバ構成の例を次の図に示します。

図1-23　VOSK-PC分散システムの例（マップサーバ構成）

(5)　ゲートウェイ経由のマップサーバ構成

ゲートウェイ構成とマップサーバ構成を組み合わせた構成です。メインフレームと，マップサーバ構成になっているPC側のLANとを，ゲートウェイ機を中継して接続します。マップサーバ構成の例を次の図に示します。

図1-24　VOSK-PC分散システムの例（ゲートウェイ経由のマップサーバ構成）

1.4.2　ソフトウェア構成

実行環境のソフトウェア構成の例を次の図に示します。

図1-25　VOSK-PC分散システムのソフトウェア構成（対話環境の場合）

これらの環境によって，実行に必要なソフトウェアが異なります。実行に必要なソフトウェアを次に示します。

なお，システムの処理で外字マッピングテーブルをカスタマイズしたいときや，シフトJISの代わりにUnicodeで画面表示したいときは，さらに必要となるソフトウェアがあります。詳しくは，「1.4.2(6)　外字の運用に必要なソフトウェア」を参照してください。

＜この項の構成＞

(1)　メインフレーム上に必要なソフトウェア

(2)　ゲートウェイ機に必要なソフトウェア

(3)　マップサーバ機に必要なソフトウェア

(4)　クライアント機に必要なソフトウェア

(5)　スタンドアロン端末に必要なソフトウェア

(6)　外字の運用に必要なソフトウェア

(1)　メインフレーム上に必要なソフトウェア

VOSK，VOSK/FSまたはVOSK/LSでは，通信制御方法として，利用できる実行環境は対話環境だけです。必要なソフトウェアを次に説明します。

AP（COBOL85を使用して作成してください）

OSCF/GCAST

OSCF E3
OSCF/GCASTを使用する場合，PCでは画面管理プログラムの代わりにPC用のGCASTを使用します。また，メインフレーム上のAPからはCUI画面およびGUI画面の入出力だけ使用できます。

メインフレーム側でTCP/IP接続をする場合，さらに次のソフトウェアが必要です。

XNF/K/TCP，XNF/K/TCP/CSS560

(2)　ゲートウェイ機に必要なソフトウェア

ゲートウェイ機は，対話環境を使用するとき，またはメインフレーム側でHNA接続をしてオンライン環境を使用するときに使用します。ゲートウェイ機にPCを使用できるのは，WAN経由でメインフレームに接続する場合だけです。

(a)　OSがHI-UX/WE2の場合

CSS560/HNA

(b)　OSがHP-UXの場合

C/S560 HNA-Gateway

(c)　OSがWindows NT，Windows 2000，またはWindows Server 2003の場合

CommuniNetゲートウェイ

(3)　マップサーバ機に必要なソフトウェア

OSにはWindows NT，Windows 2000，またはWindows Server 2003が必要です。

XMAP3/Enterprise Edition，またはXMAP3/Enterprise Edition Run Time System

GCAST

CommuniNet※

CommuniNet Extension※

注※

接続するクライアント台数分のCommuniNetアクセスライセンスが必要です。

(4)　クライアント機に必要なソフトウェア

OSにはWindowsが必要です。

XMAP3/NET，またはXMAP3/NET Run Time System

(5)　スタンドアロン端末に必要なソフトウェア

OSにはWindowsが必要です。

XMAP3/Enterprise Edition，またはXMAP3/Enterprise Edition Run Time System

GCAST

CommuniNet

CommuniNet Extension

(6)　外字の運用に必要なソフトウェア

PC上の外字は，シフトJISコードの外字のうち機種依存文字を除いた1,880文字だけが使用できます。また，PC上のシフトJISコードの外字は，XMAP3がメインフレームのKEISコードの対応する外字に置き換えます。PCの外字とメインフレームの外字との文字コードの対応については，「付録B.3　外字用コードの割り当て」を参照してください。

ただし，メインフレームのKEISコードで(95A1)₁₆～(A0FE)₁₆に対応する外字は，PC側に対応するシフトJISの文字コードがないので利用できません。

メインフレーム-PC間でやり取りされるデータに，これらのコードに対応する外字を使用したい場合，次の二つの方法があります。

日立コード変換 - Development Kit，またはコード変換SDKを使って，シフトJISとKEISの外字マッピングテーブルをカスタマイズする（使用する外字の数が1,880字までの場合）。
なお，ベンダ固有文字（Windows特殊文字，NEC選定IBM拡張文字，およびIBM選択文字）を使用する場合は，「付録B.2(4)　ベンダ固有文字についての注意事項」を参照してください。

XMAP3外字機能を使用して，PC側ではシフトJISの代わりにUnicodeで表示・印刷を行う（1,880字を超える外字を使用する場合）

なお，これらの運用形態を選択する場合，AP作成時に特別な処理は必要ありません。したがって，既存のAPを修正しないで，外字の運用形態を変更することもできます。

外字の運用形態の違いを次の表に示します。

表1-9　外字の運用形態

条件
標準
カスタマイズ
XMAP3外字機能

使用できる外字の個数
1,880字
1,880字
6,400字

対応するKEISコード
(81A1)₁₆～(94FE)₁₆※¹
KEISコードで(41A1)₁₆～(A0FE)₁₆のうち1,880字※¹
KEISコードで(41A1)₁₆～(A0FE)₁₆のうち6,400字※¹

開発に使用できるOS
Windows
Windows NT※2，
Windows 2000，
Windows XP，
Windows Server 2003，
Windows Server 2003 x64
Windows NT，
Windows 2000，
Windows XP，
Windows Server 2003

実行に使用できるOS
Windows
Windows
Windows NT，
Windows 2000，
Windows XP，
Windows Server 2003

PCでの外字の入力
できる
できる
できる※3

ドローでの外字の使用（固定項目での外字の使用）
できる
できる
シフトJISでも利用できる1,880字だけできる

画面・マップ帳票に出力する文字コード
シフトJIS
シフトJIS
Unicode

ソフトウェアの追加※⁴
不要
必要
必要

必要な作業

外字フォントの用意

外字フォントの用意

外字マッピングファイルのカスタマイズ

外字フォントの用意

外字セットの作成

外字セットのUnicode領域への割り当て

外字マッピングファイルのカスタマイズ※⁵

（凡例）

標準：KEISコードで(81A1)₁₆～(94FE)₁₆の範囲に割り当てられた1,880字の外字だけを使用する場合。

カスタマイズ：コード変換SDKまたは日立コード変換 - Development Kitを使用して，シフトJISとKEISの外字マッピングテーブルをカスタマイズする場合。

外字機能：XMAP3外字機能を利用して，PC上の文字コードにUnicodeを使用する場合。

注※1

下位バイトは(A1)₁₆～(FE)₁₆の範囲に限られます。

注※2

Windows NTは，コード変換SDKだけに対応します。

注※3

VJE-Delta for Unicode/XKP，またはVJE-Delta Ver.2.0 for Unicode/XKPが必要です。

注※4

必要なソフトウェアについては，「1.4.2　ソフトウェア構成」を参照してください。

注※5

コード変換SDK，コード変換ランタイム，日立コード変換 - Client Runtime，または日立コード変換 - Server Runtimeで，標準値での外字マッピングファイルを使用する場合は必要ありません。

(a)　カスタマイズしたシフトJISとKEISの外字マッピングテーブルを使用する場合

カスタマイズした外字マッピングテーブルは，実行環境に配布して使用します。このとき，OSにはWindowsが必要です。さらに，実行環境で必要となるソフトウェアを次の表に示します。

表1-10　実行環境のOSと必要なソフトウェア

OS | 必要なソフトウェア
Windows 95 | コード変換ランタイム　01-00以降
Windows 98
Windows Me | コード変換ランタイム　01-02以降
Windows NT | コード変換SDK　01-00以降，またはコード変換ランタイム　01-00以降
Windows 2000 Advanced Server，およびWindows 2000 Server | 日立コード変換 - Server Runtime　02-01以降，コード変換SDK　01-03以降，またはコード変換ランタイム　01-02以降
Windows 2000 Datacenter Server | 日立コード変換 - Server Runtime　02-01以降，コード変換SDK　01-03以降，またはコード変換ランタイム　01-03以降
Windows 2000 Professional | 日立コード変換 - Client Runtime　02-01以降，コード変換SDK　01-03以降，またはコード変換ランタイム　01-02以降
Windows XP | 日立コード変換 - Client Runtime　02-01以降，コード変換SDK　01-03以降，またはコード変換ランタイム　01-03以降
Windows Server 2003 | 日立コード変換 - Server Runtime　02-01以降，コード変換SDK　01-03以降，またはコード変換ランタイム　01-03以降
Windows Server 2003 R2 | 日立コード変換 - Server Runtime　02-02以降，コード変換SDK　01-04以降，またはコード変換ランタイム　01-04以降
Windows Server 2003 x64 | 日立コード変換 - Server Runtime　02-01以降
Windows Server 2003 R2 x64 | 日立コード変換 - Server Runtime　02-02以降

(b)　1,880字を超える外字を使用する場合

OSにはWindows NT，Windows 2000，Windows XP，またはWindows Server 2003が必要です。また，次の表に示すソフトウェアが必要です。

表1-11　1,880字を超える外字を使用する場合に必要なソフトウェア

OS
必要なソフトウェア

Windows NT

XMAP3外字機能 Version 4 04-02以降

KanjiLink XKP　01-00以降，
KanjiLink XKP V2.5　01-00以降，または
KanjiLink XKP V2.7　01-00以降

VJE-Delta for Unicode/XKP※1　01-00以降

コード変換SDK　01-00以降，または
コード変換ランタイム※2　01-00以降

Windows 2000 Advanced Server，およびWindows 2000 Server

XMAP3 外字機能 Version 4 04-02以降

KanjiLink XKP Version 2.2 for Windows 2000 実行時ライブラリ，
KanjiLink XKP　V2.2（実行時ライブラリ）01-00以降，または
KanjiLink XKP V2.7　01-00以降

VJE-Delta Ver.2.0 for Unicode/XKP※1

日立コード変換 - Server Runtime※2　02-01以降，
コード変換SDK　01-03以降，または
コード変換ランタイム※2　01-02以降

Windows 2000 Datacenter Server

XMAP3 外字機能 Version 4 04-02以降

KanjiLink XKP Version 2.2 for Windows 2000 実行時ライブラリ，
KanjiLink XKP　V2.2（実行時ライブラリ）01-00以降，または
KanjiLink XKP V2.7　01-00以降

VJE-Delta Ver.2.0 for Unicode/XKP※1

日立コード変換 - Server Runtime※2　02-01以降，
コード変換SDK　01-03以降，または
コード変換ランタイム※2　01-03以降

Windows 2000 Professional

XMAP3 外字機能 Version 4 04-02以降

KanjiLink XKP Version 2.2 for Windows 2000 実行時ライブラリ，
KanjiLink XKP　V2.2（実行時ライブラリ）01-00以降，または
KanjiLink XKP V2.7　01-00以降

VJE-Delta Ver.2.0 for Unicode/XKP※1

日立コード変換 - Client Runtime※2　02-01以降，
コード変換SDK　01-03以降，または
コード変換ランタイム※2　01-02以降

Windows XP

XMAP3 外字機能 Version 4 04-02以降

KanjiLink XKP Version 2.2 for Windows 2000 実行時ライブラリ，
KanjiLink XKP　V2.2（実行時ライブラリ）01-00以降，または
KanjiLink XKP V2.7　01-00以降

VJE-Delta for Unicode/XKP Ver2.1 01-00以降※1

日立コード変換 - Client Runtime※2　02-01以降，
コード変換SDK　01-03以降，または
コード変換ランタイム※2　01-03以降

Windows Server 2003

XMAP3 外字機能 Version 4 04-05以降

KanjiLink XKP Version 2.2 for Windows2000 実行時ライブラリ，
KanjiLink XKP V2.2（実行時ライブラリ）01-00以降，または
KanjiLink XKP V2.7 01-00以降

VJE-Delta for Unicode/XKP Ver.2.1 01-00以降※1

日立コード変換 - Server Runtime※2　02-01以降，
コード変換SDK 01-03以降，または
コード変換ランタイム※2　01-03以降

Windows Server 2003 R2

XMAP3 外字機能 Version 4 04-08以降

KanjiLink XKP V2.7 01-00以降

VJE-Delta for Unicode/XKP Ver.2.1 01-00以降※1

日立コード変換 - Server Runtime※2　02-02以降，
コード変換SDK 01-04以降，または
コード変換ランタイム※2　01-04以降

注

日立KEIS'83拡張3に相当する外字を使用する場合，「メーカ固有漢字セット（日立KEIS83拡張3）」が必要です。

注※1

画面で外字を入力する場合に必要となるソフトウェアです。

注※2

大量外字支援機能に加えて，KEIS/Unicode外字マッピングテーブルをカスタマイズすることもできます。ただし，「コード変換ランタイム」，「日立コード変換 - Server Runtime」，および「日立コード変換 - Client Runtime」ではカスタマイズできないため，「コード変換SDK」または「日立コード変換 - Development Kit」を使用してください。

2.　メインフレーム連携の開発環境と開発手順

この章では，メインフレーム連携機能の開発手順について，操作の流れを説明します。

＜この章の構成＞

2.1　メインフレーム-PC分散システムの開発環境と開発手順

2.2　メインフレーム資産を移行してPCで運用する手順

2.3　メインフレーム用の資産をPCで開発・運用する手順

2.1　メインフレーム-PC分散システムの開発環境と開発手順

メインフレーム-PC分散システムを開発するとき，開発環境となるXMAP3で利用できるデバイスや開発時に必要なソフトウェアを説明します。また，メインフレーム-PC分散システムの開発手順についても説明します。

＜この節の構成＞

2.1.1　利用できるデバイス

2.1.2　分散システムの開発環境のソフトウェア構成

2.1.3　分散システムの開発手順

2.1.1　利用できるデバイス

メインフレームとPCに処理を分散する環境で使用できるデバイスを，表2-1に示します。また，分散処理で利用できるメインフレームの機能，および利用できないものについて，表2-2に示します。

表2-1　メインフレームとPCで処理を分散するときに使用できるデバイス

定義対象（デバイス種別） | 分散処理するときの使用
ディスプレイCUI画面 | ○
ディスプレイGUI画面（一次） | ○
ディスプレイGUI画面（二次） | ○
シリアルインパクト けい線 帳票（連続紙） | ○※
シリアルインパクト けい線 帳票（カット紙） | ○※
シリアルインパクト プレプリント 帳票（連続紙） | ○※
シリアルインパクト プレプリント 帳票（カット紙） | ○※
ページプリンタ 網掛け 帳票 | ○※
ページプリンタ グラフィック 帳票 | ○※
ページプリンタ 書式オーバレイ | ×

（凡例）

○：使用できる。

×：使用できない。

注※

VOS1またはVOSKで，通信制御にGCASTを使用する場合，シリアルインパクトおよびページプリンタは使用できません。

表2-2　分散処理で利用できるメインフレームの機能の範囲

区分
利用できる機能
利用できない機能

適用言語

COBOL

アセンブラ，PL/Iなど

論理マップ

文字／表意指定による省略時仮定値

パネル／フィールド制御

（マップ名＋自由な名称）でのデータ名展開

論理フレーム

16進数による省略時仮定値

（自由な名称）でのデータ名展開

複数論理セグメント

画面・マップ帳票共通機能

文字指定による固定項目

可変項目

けい線

16進数による固定項目

予約項目

画面機能
（CUI画面）※

修飾名によるフィールド属性，リバース，転送，保護，数字，漢字，モジュラス，自動スキップ，桁あふれ，全桁入力，右寄せの各属性

INC定数

入力論理カーソル

隠しフィールド

16進数によるフィールド属性

ブリンク属性

ライトペン項目

マップ帳票

右記以外の各種帳票機能

OCR文字印刷

ベル鳴動

図形，画像領域

シリアルプリンタの吸入量とベタ打ち機能

その他
－

次表示マップ（ページング）

交代パネル

画面レベル（NHELP用）

（凡例）

－：該当なし。

注※

画面表示はPC側で処理するため，GUI画面の機能も利用できます。

2.1.2　分散システムの開発環境のソフトウェア構成

メインフレーム-PC分散システムを開発するとき，開発環境に必要なソフトウェア構成について，次の図に示します。

図2-1　メインフレーム-PC分散システムのソフトウェア構成（開発環境）

＜この項の構成＞

(1)　PCの開発環境

(2)　外字の運用方法に応じて，開発に必要なソフトウェア

(3)　マップ転送に必要なソフトウェア

(1)　PCの開発環境

メインフレームのOSと分散処理システムの運用形態の対応を次の表に示します。

表2-3　メインフレーム環境と対応する分散処理システムの運用形態

OS | 通信制御 | 画面管理プログラムの要否
VOS3 | オンライン | 必要※1
対話
VOS1 | オンライン
対話 | 不要※2
VOSK | 対話

注※1

画面管理プログラムは，C言語，またはCOBOL言語で作成できます。

開発時に必要なソフトウェアについては，「2.1.2(1)(a)　画面管理プログラムをC言語で作成する場合」，または「2.1.2(1)(b)　画面管理プログラムをCOBOL言語で作成する場合」を適宜参照してください。

注※2

BCF/GCAST，またはOSCF/GCASTを使用するため，通信管理プログラムは不要です。

なお，実行時に必要なソフトウェアについては，「2.1.2(1)(c)　メインフレーム側の通信管理プログラムとしてGCASTを使用する場合」を参照してください。

メインフレーム-PC分散処理の開発時，PC上に必要なソフトウェアを次に示します。なお，すべての場合でXMAP3/Enterprise Editionが必要です。

(a)　画面管理プログラムをC言語で作成する場合

画面管理プログラムをC言語で作成する場合，開発に必要なソフトウェアを次の表に示します。画面管理プログラムはXMAP3にソースプログラムとして添付されています。

表2-4　開発に必要なソフトウェア（C言語）

OS
開発に必要なソフトウェア

ファイル転送プログラム
コンパイラ

Windows 95
CommuniNet　02-00以降
CommuniNet Extension　02-00以降
Visual C++ Version 5.0以降

TP1/Client/P※1　03-04以降

Windows 98
CommuniNet　03-01以降
CommuniNet Extension　03-00以降

TP1/Client/P※1　03-04以降

Windows Me
CommuniNet　03-03以降
CommuniNet Extension　03-03以降
Visual C++ Version 6.0以降

TP1/Client/P※1　05-00-/D以降

Windows NT
CommuniNet　02-00以降
CommuniNet Extension　02-00以降
Visual C++ Version 5.0以降，
Visual C++.NET

TP1/Client/P※1　03-04以降

Windows 2000
CommuniNet　03-02以降
CommuniNet Extension　03-02以降
Visual C++ Version 6.0以降，
Visual C++.NET

TP1/Client/P※1　05-00以降

Windows XP
CommuniNet　03-04以降
CommuniNet Extension　03-04以降
Visual C++ Version 6.0以降，
Visual C++.NET

TP1/Client/P※1　05-01-/A以降

Windows Server 2003
CommuniNet 03-07以降
CommuniNet Extension 03-07以降
Visual C++ Version 6.0以降，
Visual C++.NET

TP1/Client/P※1　06-00以降

Windows Server 2003 R2
CommuniNet※2　03-08以降
CommuniNet Extension※2　03-07以降
Visual C++ Version 6.0以降，
Visual C++.NET

TP1/Client/P※1※2 06-01以降

Windows Server 2003 x64
TP1/Client/P※1※2　06-01以降
Visual C++.NET

注※1

TP1/Client/Pは，メインフレームのOSがVOS3で，通信管理プログラムがXDM/DCCM3の場合に適用できます。

注※2

使用できるバージョンについては，関連するプログラムプロダクトでご確認ください。

(b)　画面管理プログラムをCOBOL言語で作成する場合

画面管理プログラムをCOBOL言語で作成する場合，開発に必要なソフトウェアを次の表に示します。画面管理プログラムはXMAP3にソースプログラムとして添付されています。

表2-5　開発に必要なソフトウェア（COBOL言語）

OS
開発に必要なソフトウェア

ファイル転送プログラム
コンパイラ関連

Windows 95
CommuniNet　03-01以降
CommuniNet Extension　03-00以降
COBOL85　05-00以降
COBOL拡張ライブラリ　02-01以降

CommuniNet　02-00以降
CommuniNet Extension　02-00以降

Windows 98
CommuniNet　03-01以降
CommuniNet Extension　03-00以降
COBOL85　05-01以降
COBOL拡張ライブラリ　02-01以降

Windows Me
CommuniNet　03-03以降
CommuniNet Extension　03-03以降
COBOL85　06-03以降
COBOL拡張ライブラリ　02-02以降

Windows NT
CommuniNet　03-01以降
CommuniNet Extension　03-00以降
COBOL85　05-00以降
COBOL拡張ライブラリ　02-01以降

CommuniNet　02-00以降
CommuniNet Extension　02-00以降

Windows 2000
CommuniNet　03-02以降
CommuniNet Extension　03-02以降
COBOL85　06-01以降
COBOL拡張ライブラリ　02-02以降

Windows XP
CommuniNet　03-04以降
CommuniNet Extension　03-04以降
COBOL85　07-00以降
COBOL拡張ライブラリ　02-02以降

Windows Server 2003
CommuniNet　03-07以降
CommuniNet Extension　03-07以降
COBOL2002 Net Server Suite　01-01以降
COBOL拡張ライブラリ　02-03以降

Windows Server 2003 R2
CommuniNet※　03-08以降
CommuniNet Extension※　03-07以降
COBOL2002 Net Server Suite※　01-02以降
COBOL拡張ライブラリ　02-03以降

注※

使用できるバージョンについては，関連するプログラムプロダクトでご確認ください。

(c)　メインフレーム側の通信管理プログラムとしてGCASTを使用する場合

メインフレーム側の通信管理プログラムとしてGCASTを使用する場合，次の表に示すソフトウェアが必要です。

表2-6　PC側のOSと対応するGCASTのバージョン

OS | GCASTのバージョン
Windows 95 | GCAST　01-00以降
Windows 98 | GCAST　01-02以降
Windows Me | GCAST　01-04以降
Windows NT | GCAST　01-00以降
Windows 2000 | GCAST　02-00以降
Windows XP | GCAST　02-00以降
Windows Server 2003 | GCAST　02-00以降

(2)　外字の運用方法に応じて，開発に必要なソフトウェア

(a)　シフトJISとKEISの外字マッピングテーブルをカスタマイズする場合

表2-7　外字マッピングテーブルをカスタマイズする場合に必要なソフトウェア

OS | 必要なソフトウェア
Windows 95 | －
Windows 98
Windows Me
Windows NT | コード変換SDK　01-00以降
Windows 2000 | 日立コード変換 - Development Kit　02-01以降，またはコード変換SDK　01-03以降
Windows XP | 日立コード変換 - Development Kit　02-01以降，またはコード変換SDK　01-03以降
Windows Server 2003 | 日立コード変換 - Development Kit　02-01以降，またはコード変換SDK　01-03以降
Windows Server 2003 R2 | 日立コード変換 - Server Runtime　02-02以降，コード変換SDK　01-04以降，またはコード変換ランタイム　01-04以降
Windows Server 2003 x64 | 日立コード変換 - Server Runtime　02-01以降
Windows Server 2003 R2 x64 | 日立コード変換 - Server Runtime　02-02以降

（凡例）

－：該当するOSでは開発できません。

(b)　1,880字を超える外字を使用する場合

表2-8　1,880字を超える外字を使用する場合に必要なソフトウェア

OS
必要なソフトウェア

Windows NT

XMAP3外字機能　Version 4 04-02以降

KanjiLink XKP　01-00以降，
KanjiLink XKP V2.5　01-00以降，または
KanjiLink XKP V2.7　01-00以降

VJE-Delta for Unicode/XKP※1　01-00以降

コード変換SDK　01-00以降，または
コード変換ランタイム※2　01-00以降

Windows 2000 Advanced Server，およびWindows 2000 Server

XMAP3 外字機能 Version 4 04-02以降

KanjiLink XKP Version 2.2 for Windows 2000 実行時ライブラリ，
KanjiLink XKP　V2.2（実行時ライブラリ）01-00以降，または
KanjiLink XKP V2.7　01-00以降

VJE-Delta Ver.2.0 for Unicode/XKP※1
日立コード変換 - Server Runtime※2　02-01以降，
コード変換SDK　01-03以降，または
コード変換ランタイム※2　01-02以降

Windows 2000 Datacenter Server

XMAP3 外字機能 Version 4 04-02以降

KanjiLink XKP Version 2.2 for Windows 2000 実行時ライブラリ，
KanjiLink XKP　V2.2（実行時ライブラリ）01-00以降，または
KanjiLink XKP V2.7　01-00以降

VJE-Delta Ver.2.0 for Unicode/XKP※1
日立コード変換 - Server Runtime※2　02-01以降，
コード変換SDK　01-03以降，または
コード変換ランタイム※2　01-03以降

Windows 2000 Professional

XMAP3 外字機能 Version 4 04-02以降

KanjiLink XKP Version 2.2 for Windows 2000 実行時ライブラリ，
KanjiLink XKP　V2.2（実行時ライブラリ）01-00以降，または
KanjiLink XKP V2.7　01-00以降

VJE-Delta Ver.2.0 for Unicode/XKP※1

日立コード変換 - Client Runtime※2　02-01以降，
コード変換SDK　01-03以降，または
コード変換ランタイム※2　01-02以降

Windows XP

XMAP3 外字機能 Version 4 04-02以降

KanjiLink XKP Version 2.2 for Windows 2000 実行時ライブラリ，
KanjiLink XKP　V2.2（実行時ライブラリ）01-00以降，または
KanjiLink XKP V2.7　01-00以降

VJE-Delta for Unicode/XKP Ver.2.1 01-00以降※1

日立コード変換 - Client Runtime※2　02-01以降，
コード変換SDK　01-03以降，または
コード変換ランタイム※2　01-03以降

Windows Server 2003

XMAP3 外字機能 Version 4 04-05以降

KanjiLink XKP Version 2.2 for Windows2000 実行時ライブラリ，
KanjiLink XKP V2.2（実行時ライブラリ）01-00以降，または
KanjiLink XKP V2.7 01-00以降

VJE-Delta for Unicode/XKP Ver.2.1 01-00以降※1

日立コード変換 - Server Runtime※2　02-01以降，
コード変換SDK 01-03以降，または
コード変換ランタイム※2　01-03以降

Windows Server 2003 R2

XMAP3 外字機能 Version 4 04-08以降

KanjiLink XKP V2.7 01-00以降

VJE-Delta for Unicode/XKP Ver.2.1 01-00以降※1

日立コード変換 - Server Runtime※2　02-02以降，
コード変換SDK 01-04以降，または
コード変換ランタイム※2　01-04以降

注

日立KEIS'83拡張3に相当する外字を使用する場合，「メーカ固有漢字セット（日立KEIS83拡張3）」が必要です。

注※1

画面で外字を入力する場合に必要となるソフトウェアです。

注※2

大量外字支援機能に加えて，KEIS/Unicode外字マッピングテーブルをカスタマイズすることもできます。ただし，「コード変換ランタイム」，「日立コード変換 - Server Runtime」，または「日立コード変換 - Client Runtime」ではカスタマイズできないため，「コード変換SDK」または「日立コード変換 - Development Kit」を使用してください。

(3)　マップ転送に必要なソフトウェア

(a)　VOS3の場合

メインフレームでは，COBOL85を使用して，PCと分散処理するためのAPを作成します。また，PCからVOS3へマップを転送するために，IFIT-TSS E2が必要です。

(b)　VOS1の場合

メインフレームでは，COBOL85を使用して，PCと分散処理するためのAPを作成します。また，PCからVOS1へマップを転送するために，IFIT-IEX E2が必要です。

(c)　VOSKの場合

メインフレームでは，COBOL85を使用して，PCと分散処理するためのAPを作成します。また，PCからVOSKへマップを転送するために，IFITが必要です。

2.1.3　分散システムの開発手順

メインフレームとPCに処理を分散するシステムでのマップの定義から実行までの流れについて説明します。

分散システム用のマップの定義から運用までの流れを次の図に示します。

図2-2　分散システムのマップの定義から運用の流れ

なお，メインフレームやPCにはあらかじめ必要なソフトウェアを用意してください。実行環境に必要なソフトウェアについては，利用するメインフレームに応じて「1.2.2　ソフトウェア構成」，「1.3.2　ソフトウェア構成」，または「1.4.2　ソフトウェア構成」を参照してください。また，開発環境に必要なソフトウェアについては，「2.1.2　分散システムの開発環境のソフトウェア構成」を参照してください。

また，手順で示した「関連項目」も利用するメインフレームに応じて適宜参照してください。

ドローセットアップの設定
ドローセットアップのターゲット設定で，「メインフレーム-PC分散用の画面・帳票開発」を選択します。また，画面・マップ帳票を定義する前に，マップ生成用のフォルダも作成しておいてください。
外字を使用する場合，メインフレームとPCとの制限の違いに注意が必要です。詳しくは関連項目を参照してください。

〈関連項目〉

4.1　画面・マップ帳票定義前の準備

9.1　画面・マップ帳票定義前の準備

14.1　画面定義前の準備

業務内容とレイアウトの決定，画面・マップ帳票の定義とテスト
利用できる機能を確認し，運用方法を決定して，APの処理内容を決めます。また，APで扱う画面・マップ帳票のレイアウトを決めます。
次に画面・帳票の定義パターンを基にして，XMAP3のドローを使って定義します。詳しくは関連項目を参照してください。

〈関連項目〉

4.2　画面・マップ帳票の定義

9.2　画面・マップ帳票の定義

14.2　画面の定義

これらの作業を終了したら，テスト支援機能を使って，定義した画面・マップ帳票のレイアウトを確認します。なお，PC上でテスト表示およびテスト印刷をする場合，実行環境のセットアップが必要です。テスト支援機能については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

マップファイルの出力
ドローで画面・マップ帳票を定義して，物理マップと論理マップを出力します。定義した画面とマップ帳票は，そのままPC上でテスト表示・テスト印刷して内容を確認できます。
インポート機能を利用して，メインフレーム用のマップ定義ファイルをPC上に取り込んで加工することもできます。詳しくは関連項目を参照してください。

〈関連項目〉

2.2.2　メインフレームの画面・マップ帳票をPCに移行する

17. メインフレームの画面・帳票をPCへ移行する

なお，ユティリティのマップ生成機能を利用すれば，複数ある既存のマップ定義ファイルから物理マップや論理マップを一括して生成できます。この場合は手順4.～5.を実行してください。

マップ定義ファイルを出力する
ドローで画面・マップ帳票を定義して，マップ定義ファイルを出力します。

ユティリティのマップ生成機能でマップファイルを生成する
ユティリティのマップ生成機能で，4.で作成したマップ定義ファイルを指定して，論理マップと物理マップを生成します。詳しくは関連項目を参照してください。

〈関連項目〉

4.3　マップ生成とファイル転送

9.3　マップ生成とファイル転送

14.3　マップ生成とファイル転送

論理マップと通信論理マップを転送する
3.または5.で出力・生成したマップのうち，論理マップとXMAP3が提供している通信論理マップをファイル転送し，メインフレーム上のAPに取り込みます。詳しくは関連項目を参照してください。

〈関連項目〉

4.3　マップ生成とファイル転送

9.3　マップ生成とファイル転送

14.3　マップ生成とファイル転送

画面管理プログラムの準備
メインフレーム上のAPとXMAP3とで中継するための画面管理プログラムを用意します。この画面管理プログラムからXMAP3が呼び出され，XMAP3は，物理マップおよび論理マップを基にして，画面・マップ帳票への入出力を行います。
メインフレームとデータをやり取りするための画面管理プログラムは，ソースプログラムの形で提供されています。提供されているサンプルをそのまま使用するか，必要に応じて変更してください。詳しくは関連項目を参照してください。

〈関連項目〉

6. PCでの画面管理プログラムの利用と作成

11. PCでの画面管理プログラムの利用と作成

なお，通信制御としてGCASTを使用する場合，画面管理プログラムは必要ありません。

メインフレームとPCに分散して運用
APをメインフレーム上で作成し，メインフレームとPCに分散して運用します。詳しくは関連項目を参照してください。

〈関連項目〉

4.4　APの作成と実行

9.4　APの作成と実行

14.4　APの作成と実行

なお，マップの配布にはJP1/NETM/DMの資源配布機能を利用できます。
メインフレーム上のAPから，PC上の画面・マップ帳票入出力処理に論理マップのデータを転送するときは，CommuniNetの拡張ホストアクセス機能，またはTP1/Client/P※を使用します。拡張ホストアクセス機能，またはTP1/Client/Pを使用すれば，メインフレームのデータコードを変換しないでPCとやり取りできます。

注※

メインフレームのOSがVOS3の場合に選択できます。

実行時のプログラム構成を次の図に示します。

図2-3　実行時のプログラム構成

2.2　メインフレーム資産を移行してPCで運用する手順

メインフレーム-PC分散システムの開発や，メインフレームで運用していたシステムをPC環境へダウンサイジングするなどのために，メインフレームの資産をPCへ移行します。PCへ移行するにはXMAP3のインポート機能を利用します。

＜この節の構成＞

2.2.1　インポート対象となるデバイスと変換できる機能

2.2.2　メインフレームの画面・マップ帳票をPCに移行する

2.2.3　メインフレームのタイプ1/2/R書式をPCに移行する

2.2.1　インポート対象となるデバイスと変換できる機能

XMAP3のインポート機能を利用すれば，メインフレームのXMAPシリーズ用に定義したパネル定義文を，XMAP3のマップ定義ファイルに変換できます。

既存のパネル定義文がある場合は，それをPCに流用することで，画面・マップ帳票を新しく定義し直す手間を省けます。

メインフレームのパネル定義文をPCに転送し，インポート機能でマップ定義ファイルに変換します。これを基にしてPC上で画面やマップ帳票を定義します。

インポート機能については，「17. メインフレームの画面・帳票をPCへ移行する」を参照してください。

メインフレームでのデバイスについて，それぞれインポート機能でPCのどのデバイスに変換されるかを次の表に示します。

表2-9　デバイス名とインポート機能での対応

デバイス | メインフレーム | PC用のデバイス
5425,D2または4451,D2 | ○ | ディスプレイ CUI画面
5344 | ○ | シリアルインパクト けい線帳票
2311 | ○ | ページプリンタ 網掛け帳票
タイプ3（XPRT,H3） | × | －
タイプR | ○ | 書式オーバレイ
タイプ1，タイプ2 | ○ | 書式オーバレイ

（凡例）

○：インポート機能でPC用に変換できる。

×：インポート機能でPC用に変換できない。

－：該当しない。

インポート機能でPC用に変換できるメインフレームの機能，および変換できないものについて，概要を次の表に示します。詳細については，「付録C.1　インポート機能で変換できる画面・帳票の機能範囲」を参照してください。インポート機能で変換できない機能は，パネル定義文の修正，ドローセットアップでの指定，およびドローでの編集で対応する必要があります。

表2-10　インポート機能で変換できる範囲

区分
変換できる機能
変換できない機能

適用言語

COBOL

アセンブラ，PL/Iなど

論理マップ

文字／表意指定（16進漢字指定を含む）による省略時仮定値

論理フレーム

従属論理項目

16進数による省略時仮定値

パネル／フィールド制御

複数論理セグメント

任意の並び順

動的変更用項目の任意位置展開

画面・マップ帳票共通機能

文字指定（16進漢字指定を含む）による固定項目

可変項目

けい線

物理フレーム

予約項目

可変項目の初期値

画面機能※¹

リバース，転送，保護，数字，漢字，モジュラス，自動スキップ，桁あふれ，全桁入力，右寄せの各属性

カーソル位置

16進数によるフィールド属性

表示属性・項目属性の動的変更情報※2

ブリンク属性

ライトペン項目

入力固定項目

INC定数

10進カーソル位置※2

マップ帳票機能※³

右記以外の各種帳票機能

図形，画像

文章領域

その他
－

記号パラメタ指定

交代パネル

次表示マップ（ページング）

パネル順序番号

画面レベル（NHELP用）

（凡例）

－：該当なし。

注※1

「占有」の画面は「非占有」に変換されます。

注※2

ドローセットアップの設定内容に置き換わります。

注※3

「非占有」のマップ帳票は「占有」に変換されます。

2.2.2　メインフレームの画面・マップ帳票をPCに移行する

インポート機能を利用して，メインフレーム用のパネル定義文をPC用のマップ定義ファイルに変換するまでの手順を次の図に示します。

なお，あらかじめXMAP3をPCにインストールしておきます。また，メインフレーム－PC間でファイル転送に必要なソフトウェア（PCにはCommuniNet，メインフレームにはIFIT）を用意してください。

図2-4　インポート機能の操作の流れ

パネル定義文の転送
PCにパネル定義文を転送します。PCに転送したパネル定義文には，必ず拡張子を付けてください。「17.2　パネル定義文をPCに転送する」を参照してください。

パネル定義文を修正する
必要に応じて，テキストエディタなどを使用してパネル定義文の内容を修正します。「17.3　パネル定義文の編集」を参照してください。

ドローセットアップを行う
ドローセットアップを使用して，ターゲット環境を設定します。詳しくは，「17.4　ドローセットアップでの指定」を参照してください。なお，一部の機能については，このドローセットアップで指定する必要があります。

インポート機能でファイルを変換する
ユティリティのインポート機能を呼び出して，パネル定義文を変換してマップ定義ファイルを生成します。このとき，変換結果のメッセージが「X3UNMP01.TXT」として出力されます。
変換結果のメッセージの内容を確認し，エラーがあればパネル定義文の内容またはドローセットアップの設定を修正します。詳しくは，「17.5　ファイルの変換」を参照してください。

ドローで画面・マップ帳票を編集する
変換したマップ定義ファイルは，ドローを利用して編集できます。一部の機能はインポート機能ではそのまま変換されないので，ドローで改めて定義してください。詳しくは，「17.6　ドローによる編集」を参照してください。

2.2.3　メインフレームのタイプ1/2/R書式をPCに移行する

XMAP3のインポート機能を利用すれば，メインフレームのFOG2 E2シリーズ用に定義したタイプ1/2/R書式を，XMAP3の書式定義ファイルに変換できます。タイプ1/2/R書式は，メインフレームのFOG2 E2が生成する書式です。

既存の記述文がある場合は，それをPCに流用することで，書式オーバレイを新しく定義し直す手間を省けます。また，流用した既存の資産を基にして，PCで使用するための書式オーバレイを定義することもできます。

メインフレームの記述文（および部品）をPCに転送し，インポート機能で書式定義ファイルに変換します。これを基にしてPC上で書式オーバレイのレイアウトを定義します。

インポート機能については，「18. メインフレームのタイプ1/2/R書式をPCへ移行する」を参照してください。

メインフレームで運用していたタイプ1/2/R書式をPC上に移行するまでの流れを次の図に示します。

図2-5　既存の資産を基にしたタイプ1/2/R書式の定義から運用の流れ

まず，必要なソフトウェアを準備します。PCにはXMAP3とCommuniNetをインストールしてください。メインフレームにはIFITを用意してください。

記述文ファイルのPCへの転送
メインフレームから，記述文ファイルをPCに転送します。メインフレームから転送する場合はCommuniNetを利用します。部品を使用する場合は，部品ファイルも転送します。詳しくは，「18.2　記述文ファイルをPCに転送する」を参照してください。

ドローセットアップの設定と書式オーバレイ定義前の準備
ドローセットアップのターゲット設定で「PC用の画面・帳票開発」を選択します。
また，書式オーバレイを定義する前に，記述文生成用のフォルダを作成します。また，XMAP3の開発環境も設定します。さらに，PC上でテスト印刷を行うためには，実行環境のセットアップも必要です。
外字を使用する場合，メインフレームとPCとの制限の違いに注意が必要です。「18.1　開発環境の準備」を参照してください。

記述文ファイルを書式定義ファイルに変換
ユティリティのインポート機能で，1.で転送した記述文ファイル（.FOG）（および部品ファイル（.FGH））を指定して，XMAP3のドローで使用する書式定義ファイル（.IFM）に変換します。このとき，変換結果のメッセージが「X3UNFM01.TXT」として出力されます。詳しくは，「18.3　記述文ファイルをPC用に変換する」を参照してください。

書式オーバレイの定義
XMAP3のドローを使って，書式オーバレイのレイアウトを定義します。詳しくは，マニュアル「XMAP3 プログラミングガイド　帳票編」を参照してください。
また，テスト支援機能を使って，定義した書式オーバレイのレイアウトをPC上で確認します。
なお，書式オーバレイの生成については，マニュアル「XMAP3 開発・実行ガイド」およびマニュアル「XMAP3 プログラミングガイド 帳票編」を参照してください。

2.3　メインフレーム用の資産をPCで開発・運用する手順

XMAP3をメインフレーム資産の定義ツールとして利用する方法です。

メインフレーム資産をPCで開発するには，新規に作成する方法と既存資産をメインフレームからPCへ移行する方法があります。メインフレームの既存資産をPCへ移行するには，「2.2　メインフレーム資産を移行してPCで運用する手順」を参照してください。

＜この節の構成＞

2.3.1　PC上で画面・マップ帳票を開発してメインフレームで運用する

2.3.2　PC上でタイプ3書式を開発してメインフレームで運用する

2.3.3　PC上でタイプ1/2/R書式を開発してメインフレームで運用する

2.3.1　PC上で画面・マップ帳票を開発してメインフレームで運用する

XMAP3では，ターゲット環境を設定しておくと，ドローからT-560/20システム用のパネル定義文を生成できます。また，ユティリティのエクスポート機能を利用しても，T-560/20システム用のパネル定義文を生成できます。

PC上で画面やマップ帳票を定義し，PCとの共通範囲でメインフレームのXMAPシリーズの入力となるパネル定義文を生成します。生成したパネル定義文をメインフレームに転送し，論理マップや物理マップを生成して利用します。

＜この項の構成＞

(1)　前提条件

(2)　定義から運用までの流れ

(1)　前提条件

XMAP3でメインフレーム用に定義できる画面・マップ帳票について，次の表に示します。

表2-11　メインフレーム用に定義できる画面・マップ帳票の種類

PC側で選択する画面・帳票の種類
メインフレーム用のデバイス

ディスプレイCUI画面
5425,D2または4451,D2用の
パネル定義文

ディスプレイGUI画面（一次）
－

ディスプレイGUI画面（二次）
－

シリアルインパクト けい線 帳票（連続紙）
5344用のパネル定義文

シリアルインパクト けい線 帳票（カット紙）

シリアルインパクト プレプリント 帳票（連続紙）
－

シリアルインパクト プレプリント 帳票（カット紙）
－

ページプリンタ 網掛け 帳票
2311用のパネル定義文

ページプリンタ グラフィック 帳票
－※

ページプリンタ 書式オーバレイ
－※

（凡例）

－：メインフレーム用の定義には対応していない。

注※

PC上でメインフレーム用のタイプ3書式またはタイプ1/2/R書式の定義については，「2.3.2　PC上でタイプ3書式を開発してメインフレームで運用する」，または「2.3.3　PC上でタイプ1/2/R書式を開発してメインフレームで運用する」を参照してください。

XMAP3で定義できるメインフレームの機能，および定義できないものについて，概要を次の表に示します。詳細については画面・帳票の種類別に，「付録D.1　エクスポート機能で変換できるCUI画面の機能範囲」，「付録D.2　エクスポート機能で変換できるけい線帳票の機能範囲」，または「付録D.3　エクスポート機能で変換できる網掛け帳票の機能範囲」を参照してください。

エクスポート機能で変換できない機能は，変換したパネル定義文をメインフレームに転送したあとで修正するなどして対応する必要があります。詳細については，「19. メインフレーム用の画面・帳票をPCで定義する」を参照してください。

表2-12　メインフレーム用に定義できる機能の範囲

区分
定義できる機能
定義できない機能

適用言語

COBOL

アセンブラ，PL/Iなど

論理マップ

文字／表意指定による省略時仮定値の指定

パネル／フィールド制御

（マップ名＋自由な名称）でのデータ名展開

論理フレーム

従属論理項目

16進数による省略時仮定値の指定

（自由な名称）でのデータ名展開

複数論理セグメント

画面・マップ帳票共通機能

文字指定による固定項目

可変項目

けい線

予約項目

16進数による固定項目

画面機能

修飾名によるフィールド属性

リバース，転送，保護，数字，漢字，モジュラス，自動スキップ，桁あふれ，全桁入力，右寄せの各属性

INC定数

入力固定項目

16進数によるフィールド属性

ブリンク属性

ライトペン項目

マップ帳票機能

右記以外の各種帳票機能

吸入量，べた打ち機能の指定

その他
－

次表示マップ（ページング）

交代パネル

図形，画像

画面レベル（NHELP用）

（凡例）

－：該当なし。

(a)　利用できるXMAPシリーズの機能

PC上のXMAP3で定義したメインフレーム用の画面・マップ帳票で利用できる機能の範囲を次の表に示します。

表2-13　PCで定義したメインフレーム用の画面・マップ帳票で利用できる機能

機能の種類
利用できる範囲

適用言語
COBOL※1

環境
TIOP3，ES/IEX，XDM/DCCM3，DCCM3，OSCF E3

画面機能
T-560/20

帳票機能
T-560/20　HT-5344シリアルプリンタの機能※2
T-560/20　HT-2311ページプリンタの機能※2

APインタフェース
論理マップと物理マップの対応は1対1※2
DFCのビットパターンによる直接指定は使用できない

注※1

EAGLE/4GL，CUTE2，およびNHELPで使用するための画面・マップ帳票を定義することはできません。メインフレーム用に定義した画面・マップ帳票は，COBOLのAPで使用してください。

注※2

XMAP3で定義する場合，利用できる機能が一部制限されます。メインフレーム用のXMAPとPC用のXMAP3の違いについては，「付録B　メインフレームとの処理分散」を参照してください。

(b)　必要なソフトウェア

PC側では次のソフトウェアが必要です。

XMAP3/Enterprise Edition

CommuniNet

CommuniNetは，ファイルをメインフレームに転送するために使用します。

メインフレーム側で必要なソフトウェアを次の表に示します。

表2-14　メインフレーム側に必要なソフトウェア

メインフレームのOS | メインフレームに必要なソフトウェア
VOS3 | XMAP2 E2（01-00以降）※，COBOL85，IFIT-TSS
VOS1/ES2 | BSF E2（04-00以降），COBOL85，IFIT-IEX E2
VOS1/FS | BSF E3（01-00以降），COBOL85，IFIT-IEX E2
VOS1/LS | BSF E4（01-00以降），COBOL85，IFIT-IEX E2
VOSK | OSCF E2（01-00以降），COBOL85
VOSK/FS | OSCF E3（01-00以降），COBOL85
VOSK/LS | OSCF E5（01-00以降），COBOL85

注※

マップ帳票の印刷にページプリンタを使用する場合は，01-01以降を使用してください。

(2)　定義から運用までの流れ

PC上でパネル定義文を開発し，メインフレーム上で運用するまでの流れを次の図に示します。

図2-6　メインフレーム用パネル定義文の定義から運用の流れ

なお，ファイルの転送用にはCommuniNet（PC側）やIFIT（メインフレーム側）を使用します。その他，開発・運用に必要なソフトウェアについては「2.3.1(1)　前提条件」を参照してください。

ドローセットアップの設定と画面・マップ帳票定義前の準備
ドローセットアップのターゲット設定で，メインフレームに応じた環境（「VOS3用の画面・帳票開発」，「VOS1用の画面・帳票開発」，または「VOSK用の画面・帳票開発」）を選択します。
画面・マップ帳票を定義する前に，マップ生成用のフォルダを作成します。また，XMAP3の開発環境も設定します。さらに，PC上でテスト表示およびテスト印刷を行うためには，実行環境のセットアップも必要です。
外字を使用する場合，メインフレームとPCとの制限の違いに注意が必要です。「19.1　メインフレーム向け開発環境の準備」を参照してください。

業務内容とレイアウトの決定と，画面・マップ帳票の定義・テスト
利用できる機能を確認し，運用方法を決定して，APの処理内容を決めます。また，APで扱う画面・マップ帳票のレイアウトを決めます。利用できる機能については，画面・マップ帳票の種類別に応じて「付録D.1　エクスポート機能で変換できるCUI画面の機能範囲」，「付録D.2　エクスポート機能で変換できるけい線帳票の機能範囲」，または「付録D.3　エクスポート機能で変換できる網掛け帳票の機能範囲」を参照してください。
レイアウトが決定したら，画面・帳票の定義パターンを基にして，XMAP3のドローを使って定義します。「19.2　メインフレーム用の画面・帳票の定義」を参照してください。
その後，テスト支援機能を使って，定義した画面・マップ帳票のレイアウトをPC上で確認します。ただし，PCの出力結果とメインフレームでの出力には若干の相違点があります。詳しくは「19.3　テスト支援機能」を参照してください。

ドローによるパネル定義文の生成
ドローで画面・マップ帳票を定義して，マップ定義ファイルを出力します。ここで出力するパネル定義文をメインフレームへ転送して利用できます。
なお，ユティリティのエクスポート機能を利用すれば，複数ある既存のマップ定義ファイルからパネル定義文を一括して生成できます。この場合は手順4.を実行してください。

ユティリティによるパネル定義文の生成
ユティリティのエクスポート機能で，2.で作成したマップ定義ファイルを指定して，パネル定義文を生成します。詳しくは，「19.4　パネル定義文の生成」および「19.5　パネル定義文の転送」を参照してください。

パネル定義文の転送
CommuniNetを利用して，3.や4.で出力・生成したパネル定義文をメインフレームにファイル転送します。転送したファイルを基にメインフレーム上のXMAPで論理マップと物理マップを生成し，運用します。詳しくは，「19.6　メインフレーム用APの作成・流用の注意事項」を参照してください。

2.3.2　PC上でタイプ3書式を開発してメインフレームで運用する

XMAP3では，ターゲット環境を設定しておくことで，ドローからタイプ3書式用のパネル定義文を生成できます。また，ユティリティのエクスポート機能を利用して，メインフレームで使用するためのタイプ3書式を生成できます。タイプ3書式は，メインフレームのXMAP2/FOGが生成する書式です。

PC上でグラフィック帳票のレイアウトを定義し，メインフレームのXMAP2/FOGの入力となるパネル定義文を生成します。生成したパネル定義文をメインフレームに転送し，タイプ3書式を生成して利用します。

＜この項の構成＞

(1)　対象ソフトウェア

(2)　定義から運用までの流れ

(1)　対象ソフトウェア

対象となるソフトウェアを次の表に説明します。タイプ3書式を印刷できるプリンタについてはメインフレームのOSに応じて，マニュアル「端末メッセージマッピング支援 書式サポート XMAP2/FOG」（VOS3の場合），マニュアル「端末メッセージマッピング支援／書式サポート XMAP2/FOG」（VOS1の場合），またはマニュアル「書式帳票定義機能 XMAP/FOG」（VOSKの場合）を参照してください。

表2-15　対象ソフトウェア

メインフレームのOS
ソフトウェア名

VOS3
XMAP2 /FOG　04-00以降

VOS1
BSF E2　08-03以降
BSF E3　02-01以降

VOSK
OSCF E2　05-02以降
OSCF E3　02-01以降

(2)　定義から運用までの流れ

PC上でタイプ3書式のパネル定義文を開発し，メインフレーム上で運用するまでの流れを次の図に示します。

図2-7　タイプ3書式の定義から運用の流れ

なお，ファイルの転送用にはCommuniNet（PC側）やIFIT（メインフレーム側）を使用します。その他，開発・運用に必要なソフトウェアについては「2.3.2(1)　対象ソフトウェア」を参照してください。

ドローセットアップの設定とタイプ3書式定義前の準備
ドローセットアップのターゲット設定で，メインフレームに応じた環境（「VOS3用の画面・帳票開発」，「VOS1用の画面・帳票開発」，または「VOSK用の画面・帳票開発」）を選択します。
また，タイプ3書式を定義する前に，パネル定義文生成用のフォルダを作成します。さらに，XMAP3の開発環境も設定します。さらに，PC上でテスト印刷をするためには，実行環境のセットアップも必要です。外字を使用する場合，メインフレームとPCとの制限の違いに注意が必要です。詳しくは「20.1　開発環境の準備」を参照してください。

業務内容とレイアウトの決定，およびタイプ3書式の定義・テスト
利用できる機能を確認し，運用方法を決定して，APの処理内容を決めます。また，APで扱う書式のレイアウトを決めます。詳しくは「20.2　定義内容の決定」を参照してください。
タイプ3書式を定義したら，テスト支援機能を使ってタイプ3書式のレイアウトをPC上で印刷・確認します。

ドローによるパネル定義文の生成
XMAP3のドローを使って，マップ定義ファイル（.IMP）を出力します。ここで出力するパネル定義文をメインフレームへ転送して利用できます。
なお，ユティリティのエクスポート機能を利用すれば，複数ある既存のマップ定義ファイルからパネル定義文を一括して生成できます。この場合は手順4.を実行してください。

ユティリティを使ってパネル定義文ファイルを生成
ユティリティのエクスポート機能で，2.で作成したマップ定義ファイルを指定して，パネル定義文ファイル（.XMP）を生成します。詳しくは，「20.4　パネル定義文ファイルの生成」を参照してください。

パネル定義文ファイルの転送
CommuniNetを利用して，2.または3.で生成したパネル定義文をメインフレームに転送します。詳しくは，「20.5　パネル定義文ファイルの転送」を参照してください。
なお，メインフレーム上では，転送したパネル定義文ファイルを使用して，論理マップ，物理マップ，およびプレロードマップを生成し，運用します。詳しくは「20.6　メインフレームでの注意事項」を参照してください。

2.3.3　PC上でタイプ1/2/R書式を開発してメインフレームで運用する

XMAP3では，ユティリティのエクスポート機能を利用して，メインフレームで使用するためのタイプ1/2/R書式を生成できます。タイプ1/2/R書式は，メインフレームのFOG2 E2が生成する書式です。

PC上で書式オーバレイのレイアウトを定義し，ユティリティのエクスポート機能を利用して，FOG2 E2の入力となる記述文を生成します。生成した記述文をメインフレームに転送し，タイプ1/2/R書式を生成して利用します。

＜この項の構成＞

(1)　対象ソフトウェア

(2)　定義から運用までの流れ

(1)　対象ソフトウェア

対象となるソフトウェアを次の表に説明します。

なお，タイプ1/2/R書式を印刷できるプリンタについては，マニュアル「書式オーバレイゼネレータ FOG2 E2」を参照してください。

表2-16　メインフレームでの対象ソフトウェア

メインフレームのOS
ソフトウェア名

VOS3
FOG2 E2 02-00以降

VOS1
FOG2 E2 02-00以降

VOSK
OSCF E2 01-00以降
OSCF E3 01-00以降

(2)　定義から運用までの流れ

PC上で記述文を開発し，メインフレームで運用するまでの流れを次の図に示します。

図2-8　タイプ1/2/R書式の定義から運用の流れ

なお，ファイルの転送用にはCommuniNet（PC側）やIFIT（メインフレーム側）を使用します。その他，開発・運用に必要なソフトウェアについては「2.3.3(1)　対象ソフトウェア」を参照してください。

ドローセットアップの設定と書式オーバレイ定義前の準備
ドローセットアップのターゲット設定でメインフレームに応じた環境（「VOS3用の画面・帳票開発」，「VOS1用の画面・帳票開発」，または「VOSK用の画面・帳票開発」）を選択します。
また，書式オーバレイを定義する前に，記述文生成用のフォルダを作成します。また，XMAP3の開発環境も設定します。さらに，PC上でテスト印刷を行うためには，実行環境のセットアップも必要です。
外字を使用する場合，メインフレームと，PCとの制限の違いに注意が必要です。「21.1　開発環境の準備」を参照してください。

業務内容とレイアウトの決定と，書式オーバレイの定義・テスト
利用できる機能を確認し，運用方法を決定して，APの処理内容を決めます。また，APで扱うタイプ1/2/R書式のレイアウトを決めます。「21.2　定義内容の決定」を参照してください。既存資産を基にして開発する場合など，業務内容やレイアウトなどがすでに決定しているときこの手順は不要です。
業務内容やレイアウトなどを決定したあとで，XMAP3のドローを使って，書式オーバレイのレイアウトを定義し，書式定義ファイル（.IFM）を出力します。詳しくは「21.3　ドローによる書式オーバレイの定義」を参照してください。
定義が完成したら，テスト支援機能を使って，定義した書式オーバレイのレイアウトをPC上で印刷・確認します。

記述文ファイルの生成
ユティリティのエクスポート機能で，2.で作成した書式定義ファイルから記述文ファイル（.FOG）を生成します。詳しくは，「21.4　記述文ファイルの生成」を参照してください。

記述文ファイルの転送
CommuniNetを利用して，3.で生成した記述文をメインフレームに転送します。詳しくは「21.5　記述文ファイルの転送」を参照してください。
転送した記述文を基に，メインフレーム上でタイプ1/2/R書式を生成し，運用します。

なお，既存資産を基にして，タイプ1/2/R書式を流用・開発した場合は2.で定義した書式定義ファイルをPC上で資産として管理してください。更新および修正には，3.でエクスポートした記述文を再度インポートするのではなく，PC上の書式定義ファイルを使用します。

3.　VOS3-PC分散システムの環境設定

この章では，VOS3とPCに処理を分散して運用する場合の，開発環境および実行環境の設定方法について説明します。

＜この章の構成＞

3.1　開発環境の設定

3.2　実行環境の設定

3.1　開発環境の設定

XMAP3の開発環境を，メインフレーム用とPCで分散して処理するための画面・マップ帳票を定義する環境に設定します。開発環境のセットアップについては，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

次に示すターゲット環境の設定は，必ず実行してください。

＜この節の構成＞

(1)　ターゲット環境の設定

(2)　動的変更テーブルの更新

(1)　ターゲット環境の設定

XMAP3のドローセットアップを起動させます。セットアップダイアログの［運用管理者用の設定］ボタンを選択して，運用管理者用の設定を活性状態にしてください。

セットアップダイアログの［ターゲットの設定...］ボタンをクリックしてください。ターゲット環境の設定ダイアログが表示されます。

「メインフレーム-PC分散用の画面・帳票開発」を選択して［OK］ボタンをクリックしてください。メインフレームとPCで処理を分散するためのマップを生成する開発環境になります。

注意

ドローセットアップを起動しているときは，XMAP3のほかの機能を起動させないでください。

(2)　動的変更テーブルの更新

Windows／UNIXとメインフレームではデータ有無コードに違いがあるので，ターゲット環境を変更すると，動的変更テーブルの更新が必要になることがあります。また，ドローセットアップで修飾名を変更した場合も，動的変更テーブルが更新されます。

この場合，ドローセットアップで設定を保存するときにX3MODTBLの更新ダイアログが表示されます。

ファイル名や出力先を変更する場合は，［参照...］ボタンをクリックして指定してください。

［OK］ボタンをクリックすると，動的変更テーブルにデータ有無コードが書き込まれます。上書きする場合は，日付確認のメッセージが表示されます。［OK］ボタンをクリックすると，新しい動的変更テーブルが生成され，上書き前の動的変更テーブルはX3MODBAK.CBL，X3MODBAK.Hとして保存されます。

なお，「X3MODTBL.H」はC言語用の動的変更テーブルです。メインフレーム－PC分散用のマップを生成する場合は使用しません。

更新後の動的変更テーブルの先頭部分は次のようになります。

ドローセットアップでのターゲット環境とデータ有無コードの関係を次の表に示します。

表3-1　ターゲット環境の設定とデータ有無コードの関係

ターゲット環境の設定 | データ有無コード
VOS3用の画面・帳票開発 | X'3F'
VOS1用の画面・帳票開発 | X'3F'
VOSK用の画面・帳票開発 | X'3F'
メインフレーム－PC分散用の画面・帳票開発 | X'3F'
AIX（文字コード：シフトJIS）用の画面・帳票開発 | X"1F"
AIX（文字コード：EUC）用の画面・帳票開発 | X"1F"
HP-UX（文字コード：シフトJIS）用の画面・帳票開発 | X"1F"
Solaris（文字コード：シフトJIS）用の画面・帳票開発 | X"1F"
Solaris（文字コード：EUC）用の画面・帳票開発 | X"1F"
Linux（文字コード：EUC）用の画面・帳票開発 | X"1F"
Windows用の画面・帳票開発 | X"1F"

アプリケーションでほかの値のデータ有無コードを使用する場合は，動的変更テーブルを修正してください。

3.2　実行環境の設定

実行環境の設定のうち，注意が必要なものについて説明します。設定については，次のマニュアルを参照してください。

マニュアル「XMAP3 開発・実行ガイド」

マニュアル「CommuniNet （Windows NT，Windows 95用）」，またはマニュアル「CommuniNet Version 3 （Windows NT，Windows 95用）」

マニュアル「OpenTP1 運用と操作」

＜この節の構成＞

3.2.1　XDM/DCCM3の設定

3.2.2　仮想端末名称の設定

3.2.3　TCP/IPの設定

3.2.4　CommuniNetの設定

3.2.5　プリンタの設定

3.2.6　TP1/Client/Pの設定

3.2.7　外字の設定

3.2.1　XDM/DCCM3の設定

メインフレームとPCとのやり取りには，XDM/DCCM3の次のどちらかの機能を使用します。

拡張ホストアクセス機能での通信

TCP/IPプロトコルでのTP1/Client/Pとの通信

拡張ホストアクセス機能，およびTCP/IPプロトコルについては，マニュアル「データマネジメントシステム XDM E2系 解説」を参照してください。

3.2.2　仮想端末名称の設定

XMAP3の仮想端末名称の設定には，表示・印刷セットアップまたはC/Sセットアップを使用します。詳細については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

XDM/DCCM3の仮想端末名称とXMAP3の仮想端末名称はそれぞれ異なる名称を指定できます。

メインフレームからデータを転送するとき，通信論理マップに指定する仮想端末名称には，XMAP3で定義した名称を指定してください。

図3-1　APと仮想端末名称の関係

3.2.3　TCP/IPの設定

コントロールパネルの「ネットワーク」で，ネットワークの設定タブの「TCP/IP」を選択し，［プロパティ］ボタンをクリックしてIPアドレスを設定してください。ゲートウェイを使用する場合は，ゲートウェイアドレスも設定します。

3.2.4　CommuniNetの設定

CommuniNetおよびCommuniNet Extensionを使用する場合，環境設定ユティリティを起動して，［オプション］-［通信情報］コマンドを選択します。項目設定欄の［通信情報］を選択して，以下の情報を設定してください。

接続するメインフレームのサーバ名称，またはIPアドレス

メインフレーム名称

AP識別子

また，CommuniNetの端末名称とXMAP3の仮想端末名称は，それぞれ異なる名称を指定できます。画面管理プログラムのサンプルを使用する場合は，CommuniNetの端末名称を「オンライン端末」にしてください。

3.2.5　プリンタの設定

プリンタの設定については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

＜この項の構成＞

(1)　プリンタのリカバリ

(2)　印刷性能を向上させるためのXMAP3の設定

(1)　プリンタのリカバリ

プリンタ出力は，スプールに蓄積されるようになっています。そのため，印刷時にエラーが起きてもメインフレームには伝えられません。

また，Windows NT，Windows 2000，Windows XP，およびWindows Server 2003では，PDLスルー印刷の場合に拡張プリンタマネージャ，GDI印刷の場合にJP1/NPSを使用してプリンタのリカバリができます。

(2)　印刷性能を向上させるためのXMAP3の設定

印字に時間がかかるなど，プリンタの印刷性能が問題となる場合は，表示・印刷セットアップの「プリンタ」タブで，スプール書き出し単位を「アプリケーション毎」に設定してください。表示・印刷セットアップについては，マニュアル「XMAP3 開発・実行ガイド」を参照してください。メインフレーム側のAPからマップ帳票の出力命令が出された時点では印刷しないで，PC側でクローズ命令を受信してから印刷するようになるので，APの処理速度を向上できます。

3.2.6　TP1/Client/Pの設定

TP1/Client/Pを使用する場合，「XMAP3インストールフォルダ¥SAMPLES¥C」のフォルダにある「betran.ini」ファイルをWindowsフォルダ（C:¥WINNTなど）にコピーしてください。

また，テキストエディタなどを使って，「betran.ini」の次に示す個所を変更してください。

dcrcvport=(XDM/DCCM3で定義したPC側のポート番号)
dcsndhost=(メインフレーム名称またはIPアドレス)
dcsndport=(XDM/DCCM3で定義したメインフレーム側のポート番号)

3.2.7　外字の設定

＜この項の構成＞

(1)　既存の外字の割り当てを使用する場合

(2)　外字マッピングファイルをカスタマイズする場合

(3)　XMAP3外字機能を使用する場合

(1)　既存の外字の割り当てを使用する場合

(a)　概要

PCのシフトJISとメインフレームのKEISとでは，外字コードはそれぞれ異なる領域に割り当てられています。メインフレームとPCとでデータをやり取りするとき，外字コードはXMAP3がそれぞれ対応するコードに置き換えます。シフトJISとKEISとの，外字に使う文字コードの対応については，「付録B.3　外字用コードの割り当て」を参照してください。

(b)　必要な作業

Windowsに付属の外字エディタなどを使用して，外字を定義してください。定義した外字は，実行環境に配布してください。

(2)　外字マッピングファイルをカスタマイズする場合

(a)　概要

PCのシフトJISとメインフレームのKEISとの変換はXMAP3が実行します。外字部分のコード変換について，シフトJISとKEISの対応を変更したい場合は，コード変換SDK，または日立コード変換 - Development Kitを使用して外字マッピングファイルをカスタマイズしてください。

実行環境には，コード変換ランタイム，日立コード変換 - Client Runtime，または日立コード変換 - Server Runtimeをインストールしてください。また，カスタマイズされた外字マッピングファイルを実行環境に配布してください。これで，メインフレームとPCとの間でやり取りされるデータとして，KEISコードで(81A1)₁₆～(94FE)₁₆の範囲以外の外字を使用できます。

(b)　必要な作業

外字マッピングファイルのカスタマイズに必要な作業について説明します。

外字の作成
Windowsに付属の外字エディタを使用して，外字を定義してください。定義した外字は，実行環境に配布してください。

シフトJISとKEISの対応を定義する
開発環境で，コード変換SDK，または日立コード変換 - Development Kitを使用して，外字マッピングファイル（GJISKEI.TBL）をカスタマイズします。
コード変換SDKを使用する場合
コード変換SDKのコードマッピングユティリティを使用して，外字マッピングファイル（GJISKEI.TBL）をカスタマイズします。
コードマッピングユティリティの操作方法については，マニュアル「コード変換ユーザーズガイド」を参照してください。
日立コード変換 - Development Kitを使用する場合
日立コード変換 - Development Kitのコードマッピングユティリティ，またはコマンドユティリティを使用して，外字マッピングファイル（GJISKEI.TBL）をカスタマイズします。
コードマッピングユティリティ，およびコマンドユティリティの操作方法については，マニュアル「日立コード変換ユーザーズガイド」を参照してください。

外字マッピングファイルの配布
実行環境に外字マッピングファイルを配布します。
コード変換SDKを使用する場合
2.でカスタマイズした外字マッピングファイル（GJISKEI.TBL）を「コード変換ランタイムインストールフォルダ¥TABLE」の下にコピーしてください。コード変換ランタイムがインストールされている場合，XMAP3では配布された外字マッピングファイルに従って外字コードを変換します。
日立コード変換 - Development Kitを使用する場合
2.でカスタマイズした外字マッピングファイル（GJISKEI.TBL）を，「日立コード変換 - Client Runtimeインストールフォルダ¥TABLE」，または「日立コード変換 - Server Runtimeインストールフォルダ¥TABLE」の下にコピーしてください。日立コード変換 - Client Runtime，または日立コード変換 - Server Runtimeがインストールされている場合，XMAP3では配布された外字マッピングファイルに従って外字コードを変換します。

(3)　XMAP3外字機能を使用する場合

(a)　概要

シフトJISで使用できる外字は1,880字までですが，画面・マップ帳票に出力する文字コードにUnicodeを使用することで，メインフレームとPCとの間でやり取りするデータとして，6,400字までのUnicodeの外字を使用できます。ただし，画面・マップ帳票への出力にUnicodeを使用できるのは，OSがWindows NT， Windows 2000，Windows XP，またはWindows Server 2003の場合だけです。

メインフレームから受信した，KEISの外字コードは，XMAP3からコード変換ランタイム，コード変換SDK，日立コード変換 - Client Runtime，または日立コード変換 - Server Runtimeを使ってUnicodeに変換します。Unicodeを画面に表示，またはマップ帳票に出力するときは，KanjiLink XKPを経由します。

実行時の，メインフレームとPCの間でやり取りされるデータおよび表示・印刷されるデータの文字コードの遷移について，また開発時に準備が必要なファイルについて，次の図に示します。なお，画面プログラムおよびメインフレームのAPについては，特別な処理は必要ありません。

図3-2　文字コードの遷移

また，必要な作業について次に説明します。

(b)　必要な作業

外字の用意
開発環境，実行環境のそれぞれに，使用する外字のフォントを用意してください。発注・購入しない場合は，市販のアウトラインフォントエディタを使用して，外字を作成してください。なお，必ずTrueTypeフォントを用意してください。
KEIS'83拡張文字セット3を使用する場合，次のフォントを使用できます。

メーカ固有漢字セット（日立KEIS83拡張3）

文字情報を記述したファイルの作成
開発環境で，KanjiLink XKPに登録する文字情報を記述したファイルを作成してください。作成したファイルは，実行環境に配布してください。

外字セットの作成とUnicodeの割り当て
実行環境で，KanjiLink XKPの管理ツールを使用して，2.で作成したファイルから外字セットを作成してください。また，外字セットをUnicodeのどの領域に割り当てるかを決定してください。

UnicodeとKEISの対応を割り当てる
コード変換SDK，コード変換ランタイム，日立コード変換 - Client Runtime，または日立コード変換 - Server Runtimeをインストールした状態では，標準値の外字マッピングファイルを使用します。UnicodeとKEISの外字に使う文字コードの対応については，「付録B.3　外字用コードの割り当て」を参照してください。
UnicodeとKEISの対応をカスタマイズする場合は，開発環境でコード変換SDK，または日立コード変換 - Development Kitのコードマッピングユティリティを使用して，外字マッピングファイル（GUNIKEI.TBL）をカスタマイズしてください。
コード変換SDKを使用する場合
カスタマイズした外字マッピングファイルは，実行環境の「コード変換ランタイムインストールフォルダ¥TABLE」の下にコピーしてください。
コードマッピングユティリティの操作方法については，マニュアル「コード変換ユーザーズガイド」を参照してください。
日立コード変換 - Development Kitを使用する場合
カスタマイズした外字マッピングファイルは，実行環境の「日立コード変換 - Client Runtimeインストールフォルダ¥TABLE」，または「日立コード変換 - Server Runtimeインストールフォルダ¥TABLE」の下にコピーしてください。
コードマッピングユティリティの操作方法については，マニュアル「日立コード変換ユーザーズガイド」を参照してください。

なお，画面で外字を入力する場合は，実行環境にVJE-Delta for Unicode/XKPをインストールしてください。

(c)　制限事項

次に示す機能については，Unicodeの外字は使用できません。

固定項目でのUnicode外字の使用

タイトルバーおよびメニューバーでのUnicode外字表示

PDLスルー印刷モードのうち，LIPS II+でのUnicode外字出力

Windowsのプリンタマネージャにスプールする文書名でのUnicode外字の使用

印刷ダイアログでのUnicode外字表示

4.　VOS3-PC分散システムのAP開発から運用まで

この章では，VOS3とPCに処理を分散するシステムでの，マップの定義から運用までの手順について説明します。

＜この章の構成＞

4.1　画面・マップ帳票定義前の準備

4.2　画面・マップ帳票の定義

4.3　マップ生成とファイル転送

4.4　APの作成と実行

4.5　画面・帳票作成時のメッセージ

4.1　画面・マップ帳票定義前の準備

＜この節の構成＞

4.1.1　フォルダを作成する

4.1.2　定義環境の設定

4.1.1　フォルダを作成する

画面・マップ帳票の定義後に生成するマップを格納するためのフォルダが必要です。XMAP3インストール時には，XMAP3インストールフォルダに「¥USER¥MAPS」のフォルダが作成されます。これとは別のフォルダに格納したい場合，フォルダの名称や場所は任意に設定してください。

生成したファイルは，XMAP3インストールフォルダ以外のフォルダで管理することをお勧めします。なお，「XMAP3インストールフォルダ¥TEMP」の下に格納すると，正常に動作しませんので注意してください。

また，マップファイルを格納するフォルダにロングパス名を使用している場合，IFITによるマップファイルの転送ができないことがあります。フォルダ名にはロングパス名を使用しないことをお勧めします。

4.1.2　定義環境の設定

XMAP3のセットアップ機能を用いて，画面・帳票定義の環境を設定します。

環境設定については，「3. VOS3-PC分散システムの環境設定」を参照してください。

4.2　画面・マップ帳票の定義

画面・マップ帳票は，XMAP3のドローで定義します。定義環境については，マニュアル「XMAP3 プログラミングガイド 画面編」およびマニュアル「XMAP3 プログラミングガイド 帳票編」を参照してください。

また，インポート機能を利用して，メインフレームでのマップ定義をPC用のマップ定義に変換できます。インポート機能については，「17. メインフレームの画面・帳票をPCへ移行する」を参照してください。ただし，一部の機能については変換に制限があります。メインフレームのXMAPとPCのXMAP3の機能差については，「付録B　メインフレームとの処理分散」を参照してください。

なお，XMAP3外字機能で1,880字を超える外字を使用する場合でも，ドローで使用できる外字は，シフトJISコードで使用できる1,880字だけです。つまり，固定テキストなどの項目に，標準以外の外字を表示させることはできません。

＜この節の構成＞

4.2.1　トランザクションコードを設定する

4.2.2　「日本語」項目の定義

4.2.3　下位項目の定義

4.2.4　EAGLE2・KCORALのプログラムを利用する

4.2.5　SEWB3の画面・帳票定義を利用する

4.2.1　トランザクションコードを設定する

画面を定義するときに，XDM/DCCM3等で使用するトランザクションコードを定義するためには，隠しフィールドを定義してください。

ただし，XMAP3のドローで定義できる隠しフィールドの大きさは，入力論理マップの先頭8バイト分までです。

4.2.2　「日本語」項目の定義

使用目的を「日本語」，データ型を「文字」と設定した場合，生成される論理項目のデータ長は，メインフレームで利用するコードを意識して，通常は「物理長の約3倍」の長さになります。

論理項目のデータ長を，アプリケーションで利用する文字列（物理長の3倍以下の長さ）に合わせて調整できます。ドローのダイアログで「データ長を変更する」ボタンをオンにして調整します。

4.2.3　下位項目の定義

使用目的を「日本語」，データ型を「文字」と設定したフィールドで，下位項目を使用する場合，ドローのダイアログで「データ長を変更する」ボタンをオンにしてください。「データ長を変更する」ボタンがオフの場合，下位項目を定義しても，生成された論理マップには反映されません。

なお，使用目的を「日本語」，データ型を「文字」に設定するのは，パネル定義文のLOGFLD文でCODEオペランドにN（混在），LNGオペランドのピクチャにCを指定した場合に相当します。

4.2.4　EAGLE2・KCORALのプログラムを利用する

EAGLE2およびKCORALの画面・帳票をXMAP3に移行する場合に，注意が必要な点を説明します。

EAGLE2およびKCORALで生成されるメインフレームのXMAP2 E2のマップ定義文は，XMAP3には流用できません。XMAP3で画面・帳票を作り直してください。

プログラムだけを流用し，画面・帳票をXMAP3で作り直す場合は，次に説明する点を変更してください。

論理マップの形式

論理マップの形式は，ターゲット「Windows用の画面・帳票開発」のビックエンディアンと同じになります。詳細については，マニュアル「XMAP3 プログラミングガイド 画面編」，マニュアル「XMAP3 プログラミングガイド 帳票編」を参照してください。

論理マップの項目名

XMAP3では，論理マップの項目名は，次のような形式になります。

入力項目

マップ名-項目の名称I

出力項目

マップ名-項目の名称O

したがって，XMAP3で生成した論理マップの項目名を，元のソースに合わせて修正してください。

また，KCORALは拡張ホストアクセス機能に対応していないので，KCORALのソースを修正してメインフレーム-PC分散処理に使用することはできません。KCORALでCOBOLのソースを生成し，生成されたソースを修正してから利用してください。

混在項目の論理長

混在項目の論理長は，メインフレームとPCとの文字コードが異なるので，XMAP3の自動調整を利用する場合は，次の式で計算してください。

論理長＝桁（項目長）×7÷3＋3

ただし，ドローのダイアログで「データ長を変更する」ボタンをオンにしている場合は，ダイアログで指定したデータ長となります。

EAGLE2およびKCORALについては，次のマニュアルを参照してください。

EAGLE2：

マニュアル「EAGLE2 運用の手引」

マニュアル「EAGLE2 システム設計編」

KCORAL：

マニュアル「漢字CORAL KCORAL E2 解説」

マニュアル「漢字CORAL KCORAL E2 文法」

4.2.5　SEWB3の画面・帳票定義を利用する

既存のSEWB3の画面・帳票シートを流用してメインフレームとPCで処理を分散するためのマップを作成したい場合，PCのXMAP3でインポート機能を利用します。

この場合，SEWB3で画面・帳票シートからパネル定義文を生成し，そのパネル定義文をインポート機能でXMAP3のマップ定義に変換します。インポート機能については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

また，SEWB3で生成したパネル定義文からメインフレームとPCで処理を分散するためのマップを生成する場合，メインフレームとPCとの文字コードが異なるため注意が必要です。文字コードの差異に伴なう，メインフレーム上での論理長は，XMAP3の自動調整を利用する場合，次の計算式によって算出できます。

論理長＝桁（項目長）×7÷3＋3

ただし，インポート後に，ドローのダイアログで「データ長を変更する」ボタンをオンにすると，論理長を自由に変更できます。

4.3　マップ生成とファイル転送

＜この節の構成＞

4.3.1　マップを生成する

4.3.2　マップファイルの転送

4.3.1　マップを生成する

ドローが作成するマップファイルは，そのまま分散処理に利用できますが，複数の画面・帳票のマップ生成を一括して実行したい場合はユティリティのマップ生成機能を利用します。

ユティリティメインダイアログで「マップ生成」を選択し，［実行］ボタンをクリックします。

マップ生成ダイアログが表示されます。

「ファイルの選択」の［参照...］ボタンをクリックすると，ファイルの選択ダイアログが表示されます。入力となるファイルの種類と，マップ生成したいファイルのファイル名を選択し，［開く］ボタンをクリックします。
選択したファイルが，選択状態でリストボックスに表示されます。なお，リスト中のファイルの選択状態を解除すると，マップ生成の対象外にできます。

マップ生成ダイアログに「ファイルの出力先」を指定します。
次に示すファイルの出力先を指定します。
・物理マップ出力先
・論理マップ出力先
・結果リストファイル出力先
すべてのファイルの出力先を同じにする場合は，「全ての出力先」をチェックしてください。
各種ファイルの出力先などを変更する場合は，「ファイルの出力先」の［参照...］ボタンをクリックして設定してください。

各種オプションを設定する場合は，［環境設定...］ボタンをクリックします。
環境設定ダイアログが表示されます。環境設定については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。
必要な項目を設定して［OK］ボタンをクリックすると，マップ生成ダイアログに戻ります。

［生成］ボタンをクリックします。
マップ生成機能が実行されます。実行後，マップ生成ダイアログに戻ります。生成されるファイルを次に示します。
・入力論理マップ（xxxI.CBL）
・出力論理マップ（xxxO.CBL）
・物理マップ（xxx.PMP）
また，ユティリティのマップ生成機能で，マップ生成ができなかった場合，XMAP3は生成結果エラーファイル（.ERR）にエラーメッセージを出力します。エラーメッセージの内容から問題の原因を推定し，誤りを訂正してください。各種エラーメッセージに対する誤りの訂正方法については，「4.5　画面・帳票作成時のメッセージ」を参照してください。

マップ生成によって出力された結果リストファイルを表示したい場合には，［エディタ起動...］ボタンをクリックします。
エディタが起動されます。このとき使用するエディタを変更したい場合は，［環境設定...］ボタンをクリックして，環境設定ダイアログで設定してください。

注意事項

マップ生成の結果リストは，起動ごとに同じファイル名になるので，結果を別ファイルとして保存したい場合は，結果リストの表示時に別名で保存してください。

4.3.2　マップファイルの転送

XMAP3で作成したマップのうち，入力論理マップと出力論理マップをメインフレームに転送します。さらに，XMAP3で提供されているメッセージテーブルもメインフレームに転送します。メッセージテーブルは，「XMAP3インストールフォルダ¥INCLUDE」のフォルダに，次の三つが提供されています。VOS3の通信制御に応じて，どれかを使用してください。

X3TRNTBL：VOS3でXDM/DCCM3を，PCでCommuniNetを使用する場合

X3TCPTBL：VOS3でXDM/DCCM3を，PCでTP1/Client/Pを使用する場合

X3HOSTBL：VOS3でTIOP3を使用する場合

なお，メインフレーム上のAPで動的変更を利用する場合は，ドローセットアップで生成された動的変更テーブル（X3MODTBL.CBL）もメインフレームに転送してください。

上記のファイルを，PC上のCommuniNetでIFITを使用してVOS3へ転送します。IFITについては，マニュアル「ファイル伝送プログラムIFIT-TSS E2」を参照してください。

(a)　メインフレーム上の出力ファイルの属性

メインフレーム上に出力するファイルは次に示す属性にしてください。

レコード形式は固定長

レコード長は80バイト

(b)　CommuniNetの環境を設定する

CommuniNetの環境設定ユティリティを起動します。「端末名称」は転送するファイルの置かれている端末を選択して，「設定項目」の「ファイル転送」をダブルクリックします。ファイル転送の設定ダイアログが表示されるので，「コード変換」を「あり」にして，［OK］ボタンをクリックします。

(c)　IFITのメニュー画面を使用して転送する場合

ファイル伝送機能の呼び出し
IFITコマンドを実行して，ファイル伝送機能の画面を呼び出します。

転送するファイルの設定

「FUNCTION NO.」は2（TERMINAL->HOST）を選択してください。

「HOST DATA SET NAME」の項に，メインフレーム上に出力するファイル名などを指定します。このとき，PC上のファイルに付いていた拡張子は付けないでください。

「TERMINAL FILE NAME」の項に，PCから転送するファイル名を完全なパス名で指定します。

(d)　IFITコマンドを使用して転送する場合

IFITコマンドを使用した転送の形式は，次のとおりです。

コマンド
オペランド

IFIT
△'メインフレーム上に出力するファイル名'
△PCから転送するファイル名
△INPUT(TERMINAL)

4.4　APの作成と実行

＜この節の構成＞

4.4.1　APの作成

4.4.2　AP実行時のVOS3側の動作

4.4.3　AP実行時のPC側の動作

4.4.4　NETM/DMを利用したマップの配布

4.4.5　AP実行時の外字の扱い

4.4.1　APの作成

メインフレーム上のAPには，PCから転送した入力論理マップ，出力論理マップ，およびメッセージテーブルを取り込んでください。

また，メインフレーム上のAPで動的変更を行う場合は，さらに動的変更テーブル（X3MODTBL.CBL）も取り込んでください。なお，メインフレーム側に転送する場合は論理マップと同じ形式で転送してください。動的変更テーブルを更新した場合は，再度取り込む必要があります。動的変更テーブルが更新されるケースについては，「3.1　開発環境の設定」を参照してください。

分散システム用のAPを作成するときの注意事項については，「5. VOS3でのAP作成と実行」を参照してください。

4.4.2　AP実行時のVOS3側の動作

メインフレーム上のAPから，PC上の画面・マップ帳票入出力処理に論理マップのデータを転送するときは，拡張ホストアクセス機能を使用します。なお，VOS3側から転送される論理マップのデータは，EBCDIK/KEISコードのまま利用できます。

4.4.3　AP実行時のPC側の動作

メインフレームからの要求で画面管理プログラムが起動し，画面管理プログラムがXMAP3を呼び出します。XMAP3は，物理マップおよび論理マップを基にして，画面・マップ帳票への入出力を行います。XMAP3では，PC上の画面管理プログラムのサンプルが，「XMAP3インストールフォルダ¥SAMPLES¥C」に，ソースプログラムの形で添付されています。

画面管理プログラムは，必要に応じてカスタマイズして利用してください。標準のままで利用する場合は，変更する必要はありませんが，コンパイルは必要になります。

標準の画面管理プログラムにカスタマイズが必要となる場合の例を次に示します。カスタマイズすることで，GUI画面をより使いやすいものにできます。

（例）

メニュー画面を，メインフレーム側のAPを使用しないで出したい場合

ヘルプをメインフレーム側のAPを使用しないで出したい場合

サンプルプログラム，変更の方法，およびコンパイルの方法については，「6. PCでの画面管理プログラムの利用と作成」を参照してください。

4.4.4　NETM/DMを利用したマップの配布

端末の台数が多い場合，または頻繁にマップが変更される場合，すべての端末にマップを配布する作業は煩雑になります。

そこで，マップの配布にNETM/DMを利用できます。NETM/DMの資源配布機能を利用すると，メインフレームからマップを一元管理し，それぞれの端末にマップを自動的に配布できます。運用形態に応じて，すべての端末のマップを一斉に更新したり，各端末の起動時または終了時にマップを更新したりすることもできます。マップのバージョンによる差分管理もできます。

NETM/DMの利用方法については，マニュアル「統合ネットワーク管理システム／ソフトウェア配布管理支援 NETM/DM 解説」を参照してください。

4.4.5　AP実行時の外字の扱い

メインフレームとPCとでは文字コードが異なるため，メインフレームとPCの間でやり取りされるデータの文字コードは，XMAP3で変換します。文字コードの変換については，「付録B.2　文字コードの違い」を参照してください。ただし，データに含まれる外字については，外字の運用形態によって文字コードの変換方法が異なります。

＜この項の構成＞

(1)　標準の外字用コードの対応に従う場合

(2)　シフトJISとKEISの外字マッピングテーブルをカスタマイズした場合

(3)　XMAP3外字機能を使用する場合

(1)　標準の外字用コードの対応に従う場合

XMAP3でKEISとシフトJISの外字コードを変換します。外字コードの対応については，「付録B.3　外字用コードの割り当て」を参照してください。

(2)　シフトJISとKEISの外字マッピングテーブルをカスタマイズした場合

コード変換ランタイム，日立コード変換 - Client Runtime，または日立コード変換 - Server Runtimeがインストールされている場合，XMAP3では外字マッピングテーブルに基づいて外字の文字コードを変換します。外字マッピングテーブルは「コード変換ランタイムのインストールフォルダ¥TABLE」，「日立コード変換 - Client Runtimeのインストールフォルダ¥TABLE」，または「日立コード変換 - Server Runtimeのインストールフォルダ¥TABLE」に「GJISKEI.TBL」という名前でコピーしておいてください。

(3)　XMAP3外字機能を使用する場合

コード変換ランタイムがインストールされている場合，XMAP3では外字マッピングテーブルに基づいて外字の文字コードを変換します。

また，XMAP3外字機能を使用する場合，文字コードにはUnicodeを使用します。PC上でUnicodeの外字を入力するためには，VJE-Delta for Unicode/XKPを使用してください。ただし，内字の入力はほかの日本語入力システムでも可能です。

UnicodeとKEISの外字マッピングテーブルをカスタマイズしている場合は，「コード変換ランタイムのインストールフォルダ¥TABLE」に外字マッピングテーブル「GUNIKEI.TBL」をコピーしておいてください。

4.5　画面・帳票作成時のメッセージ

画面・帳票の作成時，ドローやユティリティでマップを生成するときに，次に示す定義がある場合，エラーメッセージを出力します。

マップの生成時にオブジェクトを破棄，または設定内容を変更しているもの。

エラーが発生した場合でも，パネル定義文は出力されます。

＜この節の構成＞

(1)　エラーファイルの形式

(2)　出力するメッセージの詳細

(3)　メッセージの詳細

(1)　エラーファイルの形式

エラーファイルのファイル名は，「マップ定義ファイル名.ERR」です。エラーファイルは，マップファイルの出力先に出力されます。

(2)　出力するメッセージの詳細

出力するメッセージの形式を次に示します。

［メッセージID］

［位置情報］［メッセージテキスト］

(a)　メッセージID：X3EHnnn-y

X3EH

パネル定義文生成時のメッセージであることを示します。

nnn

メッセージ通番を示します。

y

メッセージの種類を示します。出力されるメッセージの種類を次に示します。

I：警告メッセージ
マップの生成時にオブジェクトを破棄，または設定内容を変更しているもの。

(b)　位置情報

メッセージ出力対象のオブジェクトのドロー上の定義位置を示します。なお，レイアウト全体に関するメッセージなど，位置情報を持たない場合は出力しません。

出力例を次に示します（xxxxxは5けたの数字を示します）。

フレーム外の場合
［縦xxxxxます，横xxxxxます］

フレーム内の場合
フレーム名［縦xxxxxます，横xxxxxます］

(c)　メッセージテキストの詳細

メッセージテキストについて説明します。

（S）エクスポートの処理
メッセージを出力したあとの主な処理を示します。

（P）プログラマの処置
メッセージを受け取ったプログラマが取るべき処置を示します。

(3)　メッセージの詳細

個々のメッセージについて説明します。なお，ここで記述しているのは画面・帳票作成時に出力されるメッセージだけです。XMAP3全体に共通のメッセージについては，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

X3EH205-I

［位置情報］　｛予約フィールド｜予約テキスト｜入出力フィールドの下位項目｜入力フィールドの下位項目｜出力フィールドの下位項目｜入出力テキストの下位項目｜入力テキストの下位項目｜出力テキストの下位項目｝を破棄しました

予約フィールドまたは予約テキストを指定している。

使用目的が日本語で，さらにデータ型として「文字（XX）」を指定した入力／出力／入出力フィールドまたはテキストに，下位項目を指定している。

（S）指定されたオブジェクトを破棄して，マップを生成します。

（P）該当するオブジェクトを指定しないでマップ定義ファイルを再作成したあと，画面・帳票定義の保存を再実行してください。

X3EH207-I

画面属性の次画面指定を破棄しました

GUI画面，またはCUI画面の画面属性で次画面を指定している。

（S）指定された画面属性を破棄して，マップを生成します。

（P）該当する画面属性を指定しないマップ定義ファイルを再作成したあと，画面・帳票定義の保存を再実行してください。

5.　VOS3でのAP作成と実行

この章では，VOS3とPCの分散処理の仕組みについて，またAP作成の注意事項について説明します。VOS3上でAPを作成するときの参考にしてください。

＜この章の構成＞

5.1　分散処理の仕組み

5.2　VOS3側のインタフェース

5.3　PC側のインタフェース

5.4　AP作成時の注意事項

5.1　分散処理の仕組み

メインフレームとPCに処理を分散する場合，メインフレームのAPは，XDM/DCCM3などによりPCと通信して，PCの画面・帳票の入出力を実行します。しかし，PC側のXMAP3には，XDM/DCCM3またはTIOP3と直接通信する機能はありません。そこで，メインフレームとの通信を行い，XMAP3を使用してPCの画面・帳票の入出力を処理する画面管理プログラム（ミドルプログラム）の作成が必要になります。なお，画面管理プログラムのソースを，サンプルとして提供しています。詳細は，「6. PCでの画面管理プログラムの利用と作成」を参照してください。

図5-1　メインフレームとPCの分散処理の仕組み

作成するメインフレームのAPに対して，最適な通信方法や処理形態，および注意事項を，次の場合に分けて説明します。

MPPやBMPのAPを作成したい場合

TSS端末と通信したい場合

MPPやBMPのAPを作成して通信したい場合

MPPまたはBMPのAPを作成して通信したい場合には，メインフレーム側にXDM/DCCM3を使用します。

ここでは，XDM/DCCM3を使用するときの通信方法，および注意事項について説明します。

XDM/DCCM3を使用するときの通信方法

メインフレームとPCとのデータの送受信には，XDM/DCCM3の次のどちらかの機能を使用します。

拡張ホストアクセス機能での通信
拡張ホストアクセス機能はMPPのAPで使用できます。拡張ホストアクセス機能を使用する場合は，転送する論理マップのデータの長さによって，APの作成方法が異なります。一度に転送したい論理マップのデータの長さが2,920バイトを超える場合は，論理マップのデータを分割し，複数回の送信によってメインフレームへ転送することが必要です。
一度に転送したい論理マップのデータの長さが2,920バイト以下の場合については，「5.1.1　XDM/DCCM3での拡張ホストアクセス（論理マップ長≦2,920バイトの場合）」を参照してください。一度に転送したい論理マップのデータの長さが2,920を超える場合については，「5.1.2　XDM/DCCM3での拡張ホストアクセス（論理マップ長＞2,920バイトの場合）」を参照してください。
なお，TP1/Client/Pを使用する場合は，2,920バイトを超える送信データを一度で送信できます。

TCP/IPプロトコルでのTP1/Client/Pとの通信
MPPの場合については，「5.1.3　XDM/DCCM3とTP1/Client/Pによる連携（MPP）」を参照してください。BMPの場合については，「5.1.4　XDM/DCCM3とTP1/Client/Pによる連携（BMP）」を参照してください。なお，BMPの場合で，メインフレームとPCとのデータの送受信にRPCを使用するときには，ユーザ空間起動時の制御文に「TYPE　MESSAGE」の指定が必要です。
XDM/DCCM3を使用したメインフレーム上のAPの例を，「付録B.4(1)　メインフレーム上のAPの例」に掲載しています。必要に応じて参照してください。

注意事項

画面とは別の端末への帳票出力
TP1/Client/P使用時には，分岐メッセージを使用して，画面とは別のプリンタ端末に帳票を出力できます。

メッセージ編集方法
メッセージ編集方法はXMAPモードを指定してください。

TSS端末と通信したい場合

TSS端末と通信したいときは，通信プログラムにTIOP3を選択します。詳細については，「5.1.5　TIOP3での拡張ホストアクセス」を参照してください。

＜この節の構成＞

5.1.1　XDM/DCCM3での拡張ホストアクセス（論理マップ長≦2,920バイトの場合）

5.1.2　XDM/DCCM3での拡張ホストアクセス（論理マップ長＞2,920バイトの場合）

5.1.3　XDM/DCCM3とTP1/Client/Pによる連携（MPP）

5.1.4　XDM/DCCM3とTP1/Client/Pによる連携（BMP）

5.1.5　TIOP3での拡張ホストアクセス

5.1.1　XDM/DCCM3での拡張ホストアクセス（論理マップ長≦2,920バイトの場合）

XDM/DCCM3を使用したオンライン環境での拡張ホストアクセスによって，メインフレームのAPとPCの画面管理プログラムが連携する仕組みを次の図に示します。

なお，PC側の画面管理プログラムとして，提供されているサンプル「ONLNPROC.C」，「ONLNPRC2.C」，「ONLNPRC2.CBL」を使用していることを前提とします。

また，ここで扱う論理マップデータは2,920バイト以下となります。

図5-2　XDM/DCCM3環境でのAPと画面管理プログラムの連携（論理マップ長≦2,920バイトの場合）

1 開始

PCでは，CommuniNet Extensionを使用して，トランザクションをメインフレームに送信します。詳細については，マニュアル「CommuniNet Extension（Windows NT，Windows 95用）」またはマニュアル「CommuniNet Extension Version 3」を参照してください。

メインフレームでは，トランザクションを受け取ったAPが起動します。

2 トランザクションの受信

メインフレームAPは，次のようにして，PCからのトランザクションを受信します。

RECEIVE 通信記述名 FIRST SEGMENT FROM メッセージエリア

メインフレームAPが受信するメッセージは次のような形式です。

3 メインフレームAPからのオープン命令

メインフレームAPは，PCから受信したメッセージに基づいて，仮想端末を起動するためのオープン命令を発行します。

マップ名称には'%MMC1R'を指定し，問い合わせ応答を受信するようにします。

ユーザデータに，要求種別（オープン命令はX'10'）など必要な情報を設定します。

次のようにして，オープン命令をPCに送信します。

SEND 通信記述名 FROM メッセージエリア WITH EMI.

メインフレームAPから送信するメッセージは次のような形式です。

4 PCのオープン命令受信

PCでは，メインフレームAPからのオープン命令によって，画面管理プログラムが起動します。

画面管理プログラムはメインフレームAPからのオープン命令を受信し，XMAP3にオープン要求を発行して仮想端末を開きます。

メインフレームAPは，仮想端末が起動されたら，画面管理プログラムからユーザデータを受信します。
メインフレームAPが受信するメッセージは次のような形式です。

5 メインフレームAPからの入出力命令

●画面入出力の場合

メインフレームAPは，「2 トランザクションの受信」に挙げたRECEIVE文でメッセージを受信して，オープン処理の完了を確認します。

メインフレームAPは，PCへ送信する出力論理マップを編集します。最初の入出力命令ならば，初期画面の出力論理マップを編集します。また，要求種別にX'12'を設定し，マップ名称に'%MMC1R'を設定します。

「3 メインフレームAPからのオープン命令」に挙げたSEND文でPCにメッセージを送信します。メインフレームAPから送信するメッセージは次のような形式です。

●帳票出力の場合

メインフレームAPは，「2 トランザクションの受信」に挙げたRECEIVE文でメッセージを受信して，オープン処理の完了を確認します。

PCへ送信する出力論理マップを編集します。また，要求種別にX'13'を設定し，マップ名称に'%MMC1R'を設定します。

「3 メインフレームAPからのオープン命令」に挙げたSEND文でPCにメッセージを送信します。メインフレームAPから送信するメッセージは次のような形式です。

6 PCでの入出力処理

●画面入出力の場合

画面管理プログラムがメインフレームからのメッセージを受信し，XMAP3への画面の入出力要求を発行します。

ユーザは，表示された画面でデータを編集します。
画面でデータを編集した場合，メインフレームAPは，XMAP3から入力されたユーザデータを，画面管理プログラムを経由して受信します。メインフレームAPが受信するメッセージは次のような形式です。

メインフレームAPは，RECEIVE文でメッセージを受信して，論理マップへ取り込みます。

●帳票出力の場合

画面管理プログラムがメインフレームからのメッセージを受信し，XMAP3に帳票の出力要求を発行し，プリンタに帳票を出力します。

メインフレームAPは，帳票出力が終了すると，ユーザデータを画面管理プログラムを経由して受信します。メインフレームAPが受信するメッセージは次のような形式です。

メインフレームでは，RECEIVE文でメッセージを受信して，論理マップへ取り込みます。

業務終了まで，「5 メインフレームAPからの入出力命令」および「6 PCでの入出力処理」を繰り返します。

PC側で業務の終了を選択すると，入力論理マップのINCが設定されます。このメッセージを受信したメインフレームでは，クローズ命令を発行して業務終了の処理を行います。

7 クローズ命令および終了命令

要求種別にX'11'を，マップ名称には'%MMC1R'を設定します。
PCにクローズ命令を送信します。メインフレームAPから送信されるメッセージは次のような形式です。

PCでは，クローズ命令を受信した画面管理プログラムからXMAP3にクローズ要求が発行され，仮想端末が閉じられます。

仮想端末が閉じられると，メインフレームAPは画面管理プログラムを経由して次のような形式のメッセージを受信します。

このメッセージを受信したメインフレームAPでは，要求種別にはX'1F'を，マップ名称には'%MMC1S'を設定して，終了命令を送信します。
メインフレームAPから送信されるメッセージは次のような形式です。

メインフレームAPは，終了命令を送信するとともに処理を終了します。

PCでは，終了命令を受信して，画面管理プログラムが処理を終了します。

メインフレームとPCの間でやり取りされる送受信メッセージについては，「5.2.1　XDM/DCCM3でのインタフェース（CommuniNet使用時）」を参照してください。

APの命令については，VOS3のマニュアル「COBOL85 言語」およびマニュアル「データマネジメントシステム XDM E2系 プログラム作成の手引（XDM/BASE・DCCM3・TM2）」を参照してください。

画面管理プログラムの，メインフレームと送受信を行う関数については，「5.3　PC側のインタフェース」および次のどちらかのマニュアルを参照してください。

マニュアル「CommuniNet Extension（Windows NT，Windows 95用）」

マニュアル「CommuniNet Extension Version 3」

画面管理プログラムからXMAP3に要求を伝える関数については，「5.3　PC側のインタフェース」を参照してください。

XDM/DCCM3のオンライン環境で，拡張ホストアクセス機能を利用して送受信メッセージの内容をメインフレームとPCとでやり取りするとき，SEND文で指定するマップ名称（MAP-NAME句）は'%MMC1R'を指定します。'%MMC1R'は画面の入出力命令など，PCとのデータ送受信する場合に指定してください。

なお，'%MMC1S'のマップ名称は終了時に指定します。

ただし，XMAP3に添付されているサンプルの画面管理プログラムを使用するときは，帳票出力の場合でも，マップ名称には'%MMC1R'を指定してください。

5.1.2　XDM/DCCM3での拡張ホストアクセス（論理マップ長＞2,920バイトの場合）

CommuniNetでは，一度に転送できる送信データの最大長は3,000バイトとなっています。ただし，論理マップのデータ転送時には，トランザクションコードや通信論理マップなど80バイト分のデータが付加されるため，一度に転送できる実質的な論理マップのデータ長は2,920バイト以下となります。

2,920バイトを超える長さの論理マップデータを転送したい場合は2,920バイト以下のデータ長に分割し，複数回のデータ送信によって転送するようにしてください。

2,920バイトを超えるデータをやり取りする場合は，継続入力および継続出力の二つの命令を使用してデータを分割します。1回の継続入力命令または継続出力命令で，データが2,920バイトずつ転送されます。

＜この項の構成＞

(1)　利用方法

(2)　論理マップの形式

(3)　メインフレーム用APのコーディング例

(1)　利用方法

XDM/DCCM3と継続出力命令を併用したオンライン環境での拡張ホストアクセスによって，メインフレームのAPとPCの画面管理プログラムが連携する仕組みを説明します。

(a)　メインフレームからデータを送信する場合

継続出力命令を利用してメインフレームからPCにデータを送信する過程を次の図に示します。

図5-3　継続出力命令を利用したXDM/DCCM3環境でのAPと画面管理プログラムの連携（論理マップ長＞2,920バイトの場合）

メインフレーム上のAPは継続出力命令を繰り返し，論理マップのデータを2,920バイトずつPCに転送します。

送られたデータはPC上のバッファに格納されます。

すべてのデータを転送したあとに，メインフレームから出力命令または入出力命令を送信して，バッファ内のデータをXMAP3のマッピングライブラリに送ります。

なお，転送する論理マップは，1回目の送信と2回目およびそれ以降の送信とでは形式が異なります。詳細については「5.1.2(2)　論理マップの形式」を参照してください。

(b)　PCからのデータを受信する場合

継続入力命令を利用して，PCからのデータをメインフレームで受信する過程を次の図に示します。

図5-4　継続入力命令を利用したXDM/DCCM3環境でのAPと画面管理プログラムの連携（論理マップ長＞2,920バイトの場合）

メインフレーム上のAPが入出力命令を送り，PCからのデータを受信し始めます。

最初のデータが，継続入力命令によってPCからメインフレームに送られます。メインフレーム上のAPは，一時記憶領域にデータを格納します。

メインフレーム上のAPは，すべてのデータを受信するまで，繰り返し継続入力命令を送信します。データは一時記憶領域に格納されます。

PCからメインフレームへのデータの送信が終了したら，メインフレームのAPはクローズ命令を発行します。

なお，転送する論理マップは，1回目の送信と2回目およびそれ以降の送信とでは形式が異なります。詳細については「5.1.2(2)　論理マップの形式」を参照してください。

(c)　送信と受信を組み合わせる場合

まず，メインフレーム上のAPから画面管理プログラムに継続出力命令を繰り返し送信します。そして，最後に送信するデータは出力命令ではなく入出力命令で送信し，PCからのデータを受信します。

次に，メインフレーム上のAPは継続入力命令を繰り返します。すべてのデータの転送が終了したら，APからクローズ命令を送信します。

(2)　論理マップの形式

2,920バイトを超えるデータを分割して送受信する場合，1回目に送信するデータと2回目以降に送信するデータとでは形式が異なります。それぞれの論理マップの形式を次の図に示します。

図5-5　データ分割時の論理マップの形式

(3)　メインフレーム用APのコーディング例

(a)　CD句

継続問い合わせ処理の例を示します。

一時記憶受け渡しの例を示します。

(b)　実行部

5.1.3　XDM/DCCM3とTP1/Client/Pによる連携（MPP）

XDM/DCCM3を使用したオンライン環境でのTP1/Client/PによるTCP/IP通信によって，VOS3上のAPとPC上の画面管理プログラムが連携する仕組みを次の図に示します。

なお，PC側のMPP用画面管理プログラムとして，提供されているサンプル「TPCLPROC.C」を使用していることを前提とします。「TPCLPROC.C」は固定長（2,920バイト）のデータをやり取りするので，送受信メッセージの長さが2,920バイト未満の場合，データの末尾に空き領域が発生します。ただし，この空き領域はプログラムでは使用しないので，以降の説明には記載しません。

図5-6　XDM/DCCM3，TP1/Client/P環境でのAPと画面管理プログラムの連携（MPP）

1 開始

トランザクションをメインフレームに送信します。トランザクション名は，画面管理プログラムで指定しておきます。

メインフレームでは，トランザクションを受け取ったAPが起動します。

2 トランザクションの受信

メインフレームAPは，次のようにして，PCからのトランザクションを受信します。

RECEIVE 通信記述名 FIRST SEGMENT FROM メッセージエリア

メインフレームAPが受信するメッセージは次のような形式です。

3 メインフレームAPからのオープン命令

メインフレームAPは，PCから受信したデータに基づいて，仮想端末を起動するためのオープン命令を発行します。

ユーザデータに，要求種別（オープン命令はX'10'）など必要な情報を設定します。

次のようにして，メインフレームAPからPCにオープン命令を送信します。

SEND 通信記述名 FROM メッセージエリア WITH EMI.

メインフレームAPから送信するメッセージは次のような形式です。

4 PCのオープン命令受信

PCでは，メインフレームAPからのオープン命令によって，画面管理プログラムが起動します。画面管理プログラムはオープン命令を受信し，XMAP3にオープン要求を発行して仮想端末を開きます。

仮想端末が起動されたら，メインフレームAPは画面管理プログラムからユーザデータを受信します。メインフレームAPが受信するメッセージは次のような形式です。

5 メインフレームAPからの入出力命令

●画面入出力の場合

メインフレームAPは，「2 トランザクションの受信」に挙げたRECEIVE文でメッセージを受信して，オープン処理の完了を確認します。

PCへ送信する出力論理マップを編集します。最初の入出力命令ならば，初期画面の出力論理マップを編集します。また，要求種別にX'12'を設定し，マップ名称に'%MMC1R'を設定します。

「3 メインフレームAPからのオープン命令」に挙げたSEND文でメッセージをPCに送信します。メインフレームAPから送信するメッセージは次のような形式です。

●帳票出力の場合

メインフレームAPは，「2 トランザクションの受信」に挙げたRECEIVE文でメッセージを受信して，オープン処理の完了を確認します。

PCへ送信する出力論理マップを編集します。また，要求種別にX'13'を設定し，マップ名称に'%MMC1R'を設定します。

「3 メインフレームAPからのオープン命令」に挙げたSEND文でPCにメッセージをPCに送信します。メインフレームAPから送信するメッセージは次のような形式です。

6 PCでの入出力処理

●画面入出力の場合

画面管理プログラムがメインフレームAPからのメッセージを受信し，XMAP3への画面の入出力要求を発行します。
ユーザは，表示された画面でデータを編集します。

画面でデータを編集した場合，メインフレームAPは，XMAP3から入力されたユーザデータを，画面管理プログラムを経由して受信します。メインフレームAPが受信するメッセージは次のような形式です。

メインフレームAPは，RECEIVE文でメッセージを受信して，論理マップへ取り込みます。

●帳票出力の場合

画面管理プログラムがメインフレームAPからのメッセージを受信し，XMAP3に帳票の出力要求を発行し，プリンタに帳票を出力します。

メインフレームAPは，帳票出力が終了すると，ユーザデータを画面管理プログラムを経由して受信します。メインフレームAPが受信するメッセージは次のような形式です。

メインフレームAPは，RECEIVE文でメッセージを受信して，論理マップへ取り込みます。

業務終了まで，「5 メインフレームAPからの入出力命令」および「6 PCでの入出力処理」を繰り返します。

PC側で業務の終了を選択すると，入力論理マップのINCが設定されます。このメッセージを受信したメインフレームAPでは，クローズ命令を発行して業務終了の処理を行います。

7 クローズ命令および終了命令

要求種別にX'11'を，マップ名称には'%MMC1R'を設定します。
PCにクローズ命令を送信します。メインフレームAPから送信されるメッセージは次のような形式です。

PCでは，クローズ命令を受信した画面管理プログラムからXMAP3にクローズ要求が発行され，仮想端末が閉じられます。

仮想端末が閉じられると，メインフレームAPは画面管理プログラムを経由して次のような形式のメッセージを受信します。

このメッセージを受信したメインフレームAPは，要求種別にはX'1F'を設定して，終了命令を送信します。メインフレームAPから送信されるメッセージは次のような形式です。

メインフレームAPは，終了命令を送信するとともに処理を終了します。
PCでは，終了命令を受信して，画面管理プログラムが処理を終了します。

メインフレームとPCの間でやり取りされる送受信メッセージについては，「5.2.2　XDM/DCCM3でのインタフェース（TP1/Client/P使用時）」を参照してください。

APの命令については，VOS3のマニュアル「COBOL85 言語」およびマニュアル「データマネジメントシステム XDM E2系 プログラム作成の手引（XDM/BASE・DCCM3・TM2）」を参照してください。

画面管理プログラムの，メインフレームと送受信を行う関数については，「5.3　PC側のインタフェース」および次に示すOpenTP1のマニュアルのどれかを参照してください。

マニュアル「OpenTP1クライアント使用の手引」

マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」

マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/J編」

画面管理プログラムからXMAP3に要求を伝える関数については，「5.3　PC側のインタフェース」を参照してください。

5.1.4　XDM/DCCM3とTP1/Client/Pによる連携（BMP）

XDM/DCCM3とTP1/Client/Pを組み合わせて，BMPによる分岐メッセージを使用した処理ができます。このとき，メインフレームのAPから送られるデータはDCCM3/TCPを経由してPCの画面管理プログラムに送られるのに対して，PC上の画面管理プログラムがメインフレームに送信する送達確認メッセージは，DCCM3/TCPが受信し，APには何も通知しません。したがって，メインフレームのAPでは，送信後にPCからの受信を待つ必要がありません。

＜この項の構成＞

(1)　BMPの処理の仕組み

(2)　MPPとの適用範囲の違い

(1)　BMPの処理の仕組み

VOS3上のAPとPC上の画面管理プログラムが連携してBMPの処理をする仕組みを次の図に示します。

なお，PC側のBMP用画面管理プログラムとして，提供されているサンプル「TPCLPRC2.C」を使用していることを前提とします。

図5-7　XDM/DCCM3，TP1/Client/P環境でのAPと画面管理プログラムの連携（BMP）

1 開始

PCでは，画面管理プログラムを起動して，メインフレームからの命令を待ちます。

メインフレームでは，オペレータのコマンド実行，または定時起動によって，APを起動します。

2 メインフレームAPからのオープン命令

メインフレームAPは，仮想端末を起動するために，PCにオープン命令を送信します。

通信論理マップに，要求種別（オープン命令はX'10'）を設定します。

次のようにして，オープン命令をPCに送信します。

SEND 通信記述名 FROM メッセージエリア WITH EMI.

メインフレームAPから送信するメッセージは次のような形式です。

3 PCのオープン命令受信

画面管理プログラムはメインフレームAPからのオープン命令を受信し，XMAP3にオープン要求を発行して仮想端末を開きます。DCCM3/TCPの送達確認機能によって，メインフレームAPから送信したメッセージをDCCM3/TCPが自動的に書き換えます。したがって，画面管理プログラムがメインフレームAPから受信するメッセージは，次のような形式になります。

仮想端末が起動されたら，画面管理プログラムからメインフレームに送達確認メッセージが送信されます。
PCから送信する送達確認メッセージの内容は，受信時に受け取ったメッセージの長さだけなので，次のような形式になります。

メインフレームでは，PCから送信された送達確認メッセージをDCCM3/TCPが受信します。メインフレームAPには何も通知しません。

4 メインフレームAPからの出力命令

帳票を印刷するために，出力命令を発行します。

PCへ送信する出力論理マップを編集し，要求種別とマップ名称を設定します。
要求種別にX'13'を設定します。

「2メインフレームAPからのオープン命令」に挙げたSEND文でPCに出力命令を送信します。メインフレームAPから送信するメッセージは次のような形式です。

5 PCでの出力処理

画面管理プログラムはメインフレームAPからの出力命令を受信し，XMAP3に出力要求を発行します。DCCM3/TCPの送達確認機能によって，メインフレームAPから送信したメッセージをDCCM3/TCPが自動的に書き換えます。したがって，画面管理プログラムがメインフレームAPから受信するメッセージは，次のような形式になります。

プリンタへ帳票を出力したら，画面管理プログラムからメインフレームに送達確認メッセージが送信されます。PCから送信する送達確認メッセージの内容は，受信時に受け取ったメッセージの長さだけなので，次のような形式になります。

メインフレームでは，PCから送信された送達確認メッセージをDCCM3/TCPが受信します。メインフレームAPには何も通知しません。

業務終了まで，「4 メインフレームAPからの出力命令」および「5 PCでの出力処理」を繰り返します。

メインフレームAPは，出力命令をすべて発行したら，クローズ命令を発行して業務終了の処理を行います。

6 メインフレームAPからのクローズ命令

仮想端末を終了するために，PCにクローズ命令を送信します。要求種別にX'11'を設定します。

メインフレームから送信するメッセージは次のような形式です。

7 PCでのクローズ処理

画面管理プログラムはメインフレームAPからのクローズ命令を受信し，XMAP3にクローズ要求を発行します。DCCM3/TCPの送達確認機能によって，メインフレームAPから送信したメッセージをDCCM3/TCPが自動的に書き換えます。したがって，画面管理プログラムがメインフレームAPから受信するメッセージは，次のような形式になります。

画面管理プログラムからXMAP3にクローズ要求が発行され，仮想端末が閉じられます。
仮想端末が閉じられると，画面管理プログラムは送達確認メッセージをメインフレームに送信します。PCから送信する送達確認メッセージの内容は，受信時に受け取ったメッセージの長さだけなので，次のような形式になります。

メインフレームでは，PCから送信された送達確認メッセージをDCCM3/TCPが受信します。メインフレームAPには何も通知しません。

8 メインフレームAPからの終了命令

メインフレームAPは，画面管理プログラムを終了するために，PCに終了命令を送信します。要求種別にX'1F'を設定します。

メインフレームAPから送信するメッセージは次のような形式です。

9 PCでの終了処理

画面管理プログラムはメインフレームAPからの終了命令を受信します。DCCM3/TCPの送達確認機能によって，メインフレームAPから送信したメッセージをDCCM3/TCPが自動的に書き換えます。したがって，画面管理プログラムがメインフレームAPから受信するメッセージは，次のような形式になります。

画面管理プログラムから，送達確認メッセージをメインフレームに送信します。PCから送信する送達確認メッセージの内容は，受信時に受け取ったメッセージの長さだけなので，次のような形式になります。

メインフレームでは，PCから送信された送達確認メッセージをDCCM3/TCPが受信します。メインフレームAPには何も通知しません。

PCでは，画面管理プログラムが処理を終了します。

メインフレームとPCの間でやり取りされる送受信メッセージについては，「5.2.2　XDM/DCCM3でのインタフェース（TP1/Client/P使用時）」を参照してください。

APの命令については，VOS3のマニュアル「COBOL85 言語」およびマニュアル「データマネジメントシステム XDM E2系 プログラム作成の手引（XDM/BASE・DCCM3・TM2）」を参照してください。

画面管理プログラムの，メインフレームと送受信を行う関数については，「5.3　PC側のインタフェース」および次に示すOpenTP1のマニュアルのどれかを参照してください。

マニュアル「OpenTP1クライアント使用の手引」

マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」

マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/J編」

画面管理プログラムからXMAP3に要求を伝える関数については，「5.3　PC側のインタフェース」を参照してください。

(2)　MPPとの適用範囲の違い

MPPとBMPの適用範囲を次の表に示します。

表5-1　MPPとBMPの適用範囲の違い

種別
適用範囲

MPP
・対話型オンラインシステムで，XMAP3の機能を利用する
・T-560/20によるオンライン処理の代替として利用する

BMP
多数の端末への一斉通知など，XDM/DCCM3の分岐メッセージを使用したシステムで，XMAP3の帳票機能を利用する

なお，TP1/Client/Pを使用する場合，MPP用の画面管理プログラムと，BMP用の画面管理プログラムとは，それぞれ異なるポート番号を割り当てることで，同一のPC上で実行できます。したがって，MPPとBMPとを組み合わせたシステムを構成することもできます。

5.1.5　TIOP3での拡張ホストアクセス

TIOP3を使用した対話環境での拡張ホストアクセスによって，VOS3上のAPとPC上の画面管理プログラムが連携する仕組みを次の図に示します。なお，CommuniNetはあらかじめ起動させておきます。

また，前提条件として，TIOP3で使用するメインフレーム上の通信管理プログラムには，「XMAP3インストールフォルダ¥SAMPLES¥C」に提供されている「HSMHPROC」を使用するものとします。

図5-8　対話環境でのAPと画面管理プログラムの連携

1 オープン命令（メインフレームからPCへ）

メインフレームAPからPCに対して，オープン命令を送信します。命令を送るCALL文の形式を次に示します。

CALL 'MHOPEN' USING 通信論理マップ

PCでは，CommuniNetでオープン命令を受信して，画面管理プログラムが起動します。

画面管理プログラムからXMAP3にオープン要求を発行して，仮想端末をオープンします。

2 入出力命令

メインフレームAPは，オープン命令を送信したあとに，PCの画面管理プログラムに対して入出力命令を送信します。命令を送るCALL文の形式を次に示します。

CALL 'MHTRANS' USING 通信論理マップ　出力論理マップ　入力論理マップ

また，帳票を出力する場合は，次のようなCALL文を使用します。

CALL 'MHSEND' USING 通信論理マップ　出力論理マップ

PCでは，画面管理プログラムから，XMAP3に入出力要求を送ります。XMAP3で画面を入出力するか，または帳票を出力します。

XMAP3の仮想端末から画面管理プログラムを経由して，ユーザデータをメインフレームに送信します。

メインフレーム上のAPでは，CALL文の返り値としてデータを受信し，業務処理を行います。

業務終了まで，2の各手順を繰り返します。

3 クローズ命令

画面の送受信または帳票の送信がすべて終了したら，メインフレームAPから画面管理プログラムに仮想端末のクローズ命令を送信します。命令を送るCALL文の形式を次に示します。

CALL 'MHCLOSE' USING 通信論理マップ

メインフレームAPは，クローズ命令を送信して処理を終了します。

画面管理プログラムは，仮想端末にクローズ要求を発行し，処理を終了します。

メインフレームとPCの間でやり取りされる，通信論理マップと入力および出力論理マップについては，「5.2.3　TIOP3でのインタフェース」を参照してください。

APの命令については，VOS3のマニュアル「COBOL85 言語」を参照してください。

業務に応じて「HSMHPROC」を変更する場合は，マニュアル「TSS端末入出力プログラム TIOP3 使用の手引」を参照してください。

画面管理プログラムの送受信の関数については，マニュアル「CommuniNet Extension（Windows NT，Windows 95用）」またはマニュアル「CommuniNet Extension Version 3」を参照してください。

画面管理プログラムからXMAP3に要求を伝える関数については，「5.3　PC側のインタフェース」を参照してください。

5.2　VOS3側のインタフェース

＜この節の構成＞

5.2.1　XDM/DCCM3でのインタフェース（CommuniNet使用時）

5.2.2　XDM/DCCM3でのインタフェース（TP1/Client/P使用時）

5.2.3　TIOP3でのインタフェース

5.2.1　XDM/DCCM3でのインタフェース（CommuniNet使用時）

＜この項の構成＞

(1)　論理マップの取り込み

(2)　メッセージテーブルの形式

(3)　送受信メッセージとAPの連携

(1)　論理マップの取り込み

VOS3とPCに処理を分散する環境では，VOS3とPC間で論理マップのデータをやり取りします。このとき論理マップは，COPY文でVOS3のAPに取り込まれます。COPY文は，APのWORKING-STORAGE SECTIONまたはLINKAGE SECTIONに指定します。ただし，論理マップ中に定数を展開させている場合は，LINKAGE SECTIONには取り込めません。

（例）

(2)　メッセージテーブルの形式

分散処理をするため，メッセージテーブル，入力論理マップおよび出力論理マップをメインフレーム上のAPに取り込みます。入力または出力論理マップのデータ長が2,920バイト以下のときのメッセージテーブルは「XMAP3インストールフォルダ¥INCLUDE¥X3TRNTBL」です。また，入力または出力論理マップのデータ長が2,920バイトを超えるときのメッセージテーブルは「XMAP3インストールフォルダ¥INCLUDE¥X3TRNTB2」です。

メッセージテーブルの形式を表5-2および表5-3に示します。

表5-2　受信メッセージテーブルの形式

領域
エリア名称
長さ
（位置）
データ形式
データ内容

ヘッダ
XMAP-RECV-LL
2(0)
S9(4)COMP
受信テーブル長

XMAP-RECV-RR
2(2)
S9(4)COMP
予備

XMAP-RECV-TRNCD
8(4)
X(8)
トランザクションコード

XMAP-RECV-SPACE
1(12)
X
予備

XMAP-RECV-LL1
2(13)
S9(4)COMP
予備

XMAP-RECV-LL2
2(15)
S9(4)COMP
通信データ長

ユーザ
データ
種別
XMAP-RECV-TRN
8(17)
X(8)
トランザクションコード

XMAP-RECV-REQ
4(25)
X(4)
要求種別

通信論理マップ
XMAP-RECV-
MHLNG
2(29)
S9(4)COMP
通信論理マップ長

XMAP-RECV-RSV1
2(31)
S9(4)COMP
予備

XMAP-RECV-RTN
2(33)
9(4)COMP
リターンコード

XMAP-RECV-RSN
2(35)
9(4)COMP
リターンコード詳細

XMAP-RECV-
TNAME
8(37)
X(8)
仮想端末名称

XMAP-RECV-
PMAPNAME
8(45)
X(8)
物理マップ名称をEBCDIKコードでセット

XMAP-RECV-
INLNG
2(53)
S9(4)COMP
入力論理マップ長の最大値

XMAP-RECV-OPT
1(55)
X
マッピングオプション

XMAP-RECV-
DCODE
1(56)
X
データ有無コード

XMAP-RECV-RSV2
36(57)
X(36)
予備
(00)₁₆でヌルクリア

入力論理マップ
XMAP-RECV-MAPS
2(93)
S9(4)COMP
入力論理マップ長

XMAP-RECV-MAP0
2(95)
S9(4)COMP
予備

XMAP-RECV-MAPK
0～2,920
(97)
X
入力論理データ

表5-3　送信メッセージテーブルの形式

部分
エリア名称
長さ
（位置）
データ形式
データ内容

ヘッダ
XMAP-SEND-LL
2(0)
S9(4)COMP
送信テーブル長

XMAP-SEND-RR
2(2)
S9(4)COMP
予備

XMAP-SEND-LL1
2(4)
S9(4)COMP
AP長

XMAP-SEND-UAP
8(6)
X(8)
AP名

XMAP-SEND-LL2
2(14)
S9(4)COMP
通信データ長

ユーザ
データ
種別
XMAP-SEND-TRN
8(16)
X(8)
トランザクションコード

XMAP-SEND-REQ
4(24)
X(4)
要求種別

通信論理マップ
XMAP-SEND-
MHLNG
2(28)
S9(4)COMP
通信論理マップ長

XMAP-SEND-RSV1
2(30)
S9(4)COMP
予備

XMAP-SEND-RTN
2(32)
9(4)COMP
リターンコード

XMAP-SEND-RSN
2(34)
9(4)COMP
リターンコード詳細

XMAP-SEND-
TNAME
8(36)
X(8)
仮想端末名称

XMAP-SEND-
PMAPNAME
8(44)
X(8)
物理マップ名称をEBCDIKコードでセット

XMAP-SEND-
INLNG
2(52)
S9(4)COMP
入力論理マップ長の最大値

XMAP-SEND-OPT
1(54)
X
マッピングオプション

XMAP-SEND-
DCODE
1(55)
X
データ有無コード

XMAP-SEND-RSV2
36(56)
X(36)
予備
(00)₁₆でヌルクリア

出力論理マップ
XMAP-SEND-MAPL
2(92)
S9(4)COMP
出力論理マップ長

XMAP-SEND-MAPZ
2(94)
S9(4)COMP
予備

XMAP-SEND-MAPG
0～2,920
(96)
X
出力論理データ

(3)　送受信メッセージとAPの連携

メインフレームとPCに処理を分散する環境では，メインフレーム側からPC側へ，どのようにして入出力命令が渡されているのかを，命令発行順序を示して説明します。

命令発行時に使用するSEND文およびRECEIVE文の形式については，マニュアル「データマネジメントシステム XDM E2系 プログラム作成の手引（XDM/BASE・DCCM3・TM2）」を参照してください。

(a)　メインフレームからPC上の画面・帳票に対する送受信命令

オープン命令：SEND文でPCにオープン命令を出す。

出力命令：SEND文で送信メッセージテーブルを使用して，PCに表示命令を出す。

入力命令：RECEIVE文で受信メッセージテーブルを使用して，PCからデータを受信する。出力および入力するデータ数だけ，2.と3.の処理を繰り返す。

クローズ命令：SEND文でPCにクローズ命令を出す。

終了命令：SEND文でPCに終了命令を出す。

(b)　各命令と送受信メッセージの関連

それぞれの命令発行時とメッセージテーブルの設定値の関連を表5-4，表5-5，表5-6および表5-7に示します。

表5-4　オープン命令発行時の送信メッセージの設定値

部分
データ項目名
指定内容

ヘッダ
送信テーブル長
92とする。

予備
(0000)₁₆とする。

AP長
10とする。

AP名
PC側の画面管理プログラムのEXE名称をセットする。

通信データ長
78とする。

ユーザ
データ
種別
トランザクションコード
次に起動するトランザクション名。

要求種別
(10000001)₁₆とする（オープン要求）。

通信論理マップ
通信論理マップ長
64とする。

予備
(0000)₁₆とする。

リターンコード
(0000)₁₆とする。

詳細コード
(0000)₁₆とする。

仮想端末名称
X3MWHOSTに指定した仮想端末名称を指定する。※

物理マップ名
(00)₁₆でヌルクリアする。

入力論理マップ長の最大値
(0000)₁₆とする。

マッピングオプション
(00)₁₆とする。

データ有無コード
データ有無コードを指定する。

予備
(00)₁₆でヌルクリアする。

注※

仮想端末の画面をオープンするときに，出力先が一つだけならば，指定を省略できます。指定を省略する場合，(40)₁₆で8バイトクリアしてください。

表5-5　クローズ命令発行時の送信メッセージの設定値

部分
データ項目名
指定内容

ヘッダ
送信テーブル長
92とする。

予備
(0000)₁₆とする。

AP長
10とする。

AP名
PC側の画面管理プログラムのEXE名称をセットする。

通信データ長
78とする。

ユーザ
データ
種別
トランザクションコード
次に起動するトランザクション名。

要求種別
(11000001)₁₆とする（クローズ要求）。

通信論理マップ
通信論理マップ長
64とする。

予備
(0000)₁₆とする。

リターンコード
(0000)₁₆とする。

詳細コード
(0000)₁₆とする。

仮想端末名称
X3MWHOSTに指定した仮想端末名称を指定する。※

物理マップ名
設定しない。

入力論理マップ長の最大値
設定しない。

マッピングオプション
設定しない。

データ有無コード
設定しない。

予備
(00)₁₆でヌルクリアする。

注※

クローズする仮想端末名称を指定します。対応するオープン命令を発行したときと同じ仮想端末名称を指定してください。

表5-6　入力命令発行時の通信論理マップ部と入力論理マップ部の設定値（受信メッセージテーブルを使用）

論理マップ名 | データ項目名 | 指定内容
通信論理マップ | 通信論理マップ長 | 何も設定しない。
予備
リターンコード
詳細コード
仮想端末名称
物理マップ名
入力論理マップ長の最大値
マッピングオプション
データ有無コード
予備
入力論理マップ | XMAP3が設定するので，設定する必要はない。受信後参照する場合は入力論理マップにコピーすること。

入力命令では，受信テーブルのアドレスを渡します。指定内容は，入力された時点で，すでに指定されています。

表5-7　出力命令発行時の通信論理マップ部と出力論理マップ部の設定値（送信メッセージテーブルを使用）

論理マップ名
データ項目名
指定内容

通信論理マップ
送信テーブル長
92＋出力論理データ長 をセットする。

予備
(0000)₁₆とする。

AP長
10とする。

AP名
PC側の画面管理プログラムのEXE名称をセットする。

通信データ長
78＋出力論理データ長をセットする。

トランザクションコード
次に起動するトランザクション名。

要求種別
(12000003)₁₆とする。

通信論理マップ長
64とする。

予備
(0000)₁₆とする。

リターンコード
(0000)₁₆とする。

詳細コード
(0000)₁₆とする。

仮想端末名称
X3MWHOSTに指定した仮想端末名称を指定する。※¹

物理マップ名
EBCDIKコードで入出力する物理マップ名を，デバイスIDを付けて，左詰めで指定する。残りは(40)₁₆とする。

入力論理マップ長の最大値
使用する入力論理マップの長さの最大値を指定する。

マッピングオプション
スペースまたは'0'：マージ※2
'2'：論理マップだけ※3
'3'：物理マップだけ※4
指定しない場合は(00)₁₆でヌルクリアする。

データ有無コード
設定しない。

予備
(0000)₁₆とする。

出力論理マップ
論理マップ長
出力論理マップ長を指定する。

予備
(0000)₁₆とする。

出力論理データ
出力論理データを設定する。

注※1

出力先の仮想端末名称を指定します。対応するオープン命令を発行したときと同じ仮想端末名称を指定してください。

注※2

論理項目，または制御項目に指定したデータを使用して画面を表示します。ただし，表示属性の変更指示をしない項目の属性は，画面定義時に指定した表示属性となります。

注※3

論理項目，または制御項目に指定したデータを使用して画面を表示します。ただし，表示属性の変更指示をしない項目の属性は，前画面の表示属性となります。また，データの指定がない項目は，前画面のデータをそのまま表示します。

注※4

論理項目，または制御項目に指定したデータを無視して，画面定義時の情報だけで画面を表示します。

5.2.2　XDM/DCCM3でのインタフェース（TP1/Client/P使用時）

＜この項の構成＞

(1)　論理マップの取り込み

(2)　メッセージテーブルの形式

(3)　送受信メッセージとAPの連携

(1)　論理マップの取り込み

VOS3とPCに処理を分散する環境では，VOS3とPC間で論理マップのデータをやり取りします。このとき論理マップは，COPY文でVOS3のAPに取り込まれます。COPY文は，APのWORKING-STORAGE SECTIONまたはLINKAGE SECTIONに指定します。ただし，論理マップ中に定数を展開させている場合は，LINKAGE SECTIONには取り込めません。

（例）

(2)　メッセージテーブルの形式

分散処理をするため，メッセージテーブル，入力論理マップおよび出力論理マップをメインフレーム上のAPに取り込みます。MPPの処理を行うときのメッセージテーブルは「XMAP3インストールフォルダ¥INCLUDE¥X3TCPTB2」です。

メッセージテーブルの形式を表5-8および表5-9に示します。

表5-8　受信メッセージテーブルの形式

部分
エリア名称
長さ
（位置）
データ形式
データ内容

ヘッダ
XMAP-RECV-LL
2(0)
S9(4)COMP
受信テーブル長

XMAP-RECV-RR
2(2)
S9(4)COMP
予備

ユーザ
データ
種別
XMAP-RECV-TRN
8(4)
X(8)
トランザクションコード

XMAP-RECV-REQ
4(12)
X(4)
要求種別

通信論理マップ
XMAP-RECV-
MHLNG
2(16)
S9(4)COMP
通信論理マップ長

XMAP-RECV-RSV1
2(18)
S9(4)COMP
予備

XMAP-RECV-RTN
2(20)
9(4)COMP
リターンコード

XMAP-RECV-RSN
2(22)
9(4)COMP
リターンコード詳細

XMAP-RECV-
TNAME
8(24)
X(8)
仮想端末名称

XMAP-RECV-
PMAPNAME
8(32)
X(8)
物理マップ名称をEBCDIKコードでセット

XMAP-RECV-
INLNG
2(40)
S9(4)COMP
入力論理マップ長の最大値

XMAP-RECV-OPT
1(42)
X
マッピングオプション

XMAP-RECV-
DCODE
1(43)
X
データ有無コード

XMAP-RECV-RSV2
36(44)
X(36)
予備
(00)₁₆でヌルクリア

入力論理マップ
XMAP-RECV-MAPS
2(80)
S9(4)COMP
入力論理マップ長

XMAP-RECV-MAP0
2(82)
S9(4)COMP
予備

XMAP-RECV-MAPK
0～31,916
(84)
X(31916)
入力論理データ

表5-9　送信メッセージテーブルの形式

部分
エリア名称
長さ
（位置）
データ形式
データ内容

ヘッダ
XMAP-SEND-LL
2(0)
S9(4)COMP
送信テーブル長

XMAP-SEND-RR
2(2)
S9(4)COMP
予備

ユーザ
データ
種別
XMAP-SEND-TRN
8(4)
X(8)
トランザクションコード

XMAP-SEND-REQ
4(12)
X(4)
要求種別

通信論理マップ
XMAP-SEND-
MHLNG
2(16)
S9(4)COMP
通信論理マップ長

XMAP-SEND-RSV1
2(18)
S9(4)COMP
予備

XMAP-SEND-RTN
2(20)
9(4)COMP
リターンコード

XMAP-SEND-RSN
2(22)
9(4)COMP
リターンコード詳細

XMAP-SEND-
TNAME
8(24)
X(8)
仮想端末名称

XMAP-SEND-
PMAPNAME
8(32)
X(8)
物理マップ名称をEBCDIKコードでセット

XMAP-SEND-
INLNG
2(40)
S9(4)COMP
入力論理マップ長の最大値

XMAP-SEND-OPT
1(42)
X
マッピングオプション

XMAP-SEND-
DCODE
1(43)
X
データ有無コード

XMAP-SEND-RSV2
36(44)
X(36)
予備
(00)₁₆でヌルクリア

出力論理マップ
XMAP-SEND-MAPL
2(80)
S9(4)COMP
出力論理マップ長

XMAP-SEND-MAPZ
2(82)
S9(4)COMP
予備

XMAP-SEND-MAPG
0～31,916
(84)
X(31916)
出力論理データ

(3)　送受信メッセージとAPの連携

メインフレームとPCに処理を分散する環境では，メインフレーム側からPC側へ，どのようにして入出力命令が渡されているのかを，命令発行順序を示して説明します。

命令発行時に使用するSEND文およびRECEIVE文の形式については，マニュアル「データマネジメントシステム XDM E2系 プログラム作成の手引 （XDM/BASE・DCCM3・TM2）」を参照してください。

(a)　メインフレームからPC上の画面・帳票に対する送受信命令（MPPの処理）

オープン命令：SEND文でPCにオープン命令を出す。

出力命令：SEND文で送信メッセージテーブルを使用して，PCに表示命令を出す。

入力命令：RECEIVE文で受信メッセージテーブルを使用して，PCからデータを受信する。出力および入力するデータ数だけ，2.と3.の処理を繰り返す。

クローズ命令：SEND文でPCにクローズ命令を出す。

終了命令：SEND文でPCに終了命令を出す。

(b)　メインフレームからPC上の帳票に対する送信命令（BMPの処理）

オープン命令：SEND文でPCにオープン命令を出す。

出力命令：SEND文で送信メッセージテーブルを使用して，PCに表示命令を出す。

クローズ命令：SEND文でPCにクローズ命令を出す。

終了命令：SEND文でPCに終了命令を出す。

(c)　各命令と通信論理マップの関連

それぞれの命令発行時と送受信メッセージの設定値の関連を表5-10，表5-11，表5-12および表5-13に示します。

表5-10　オープン命令発行時の送信メッセージの設定値

データ項目名
指定内容

ヘッダ
送信テーブル長
3004（または画面管理プログラムで指定した長さ+4）とする。

予備
(0000)₁₆とする。

ユーザ
データ
種別
トランザクションコード
次に起動するトランザクション名。

要求種別
(10000001)₁₆とする（オープン要求）。

通信論理マップ
通信論理マップ長
64とする。

予備
(0000)₁₆とする。

リターンコード
(0000)₁₆とする。

詳細コード
(0000)₁₆とする。

仮想端末名称
X3MWHOSTに指定した仮想端末名称を指定する。※

物理マップ名
(00)₁₆でヌルクリアする。

入力論理マップ長の最大値
(0000)₁₆とする。

マッピングオプション
(00)₁₆とする。

データ有無コード
データ有無コードを指定する。

予備
(00)₁₆でヌルクリアする。

出力論理マップ
論理マップ長
出力論理マップ長を指定する。

予備
(0000)₁₆とする。

出力論理データ
出力論理データを設定する。

注※

仮想端末の画面をオープンするときに，出力先が一つだけならば，指定を省略できます。指定を省略する場合，(40)₁₆で8バイトクリアしてください。

表5-11　クローズ命令発行時の送信メッセージの設定値

データ項目名
指定内容

ヘッダ
送信テーブル長
3004（または画面管理プログラムで指定した長さ+4）とする。

予備
(0000)₁₆とする。

ユーザ
データ
種別
トランザクションコード
次に起動するトランザクション名。

要求種別
(11000001)₁₆とする（クローズ要求）。

通信論理マップ
通信論理マップ長
64とする。

予備
(0000)₁₆とする。

リターンコード
(0000)₁₆とする。

詳細コード
(0000)₁₆とする。

仮想端末名称
X3MWHOSTに指定した仮想端末名称を指定する。※

物理マップ名
設定しない。

入力論理マップ長の最大値
設定しない。

マッピングオプション
設定しない。

データ有無コード
設定しない。

予備
(00)₁₆でヌルクリアする。

出力論理マップ
論理マップ長
出力論理マップ長を指定する。

予備
(0000)₁₆とする。

出力論理データ
出力論理データを設定する。

注※

クローズする仮想端末名称を指定します。対応するオープン命令を発行したときと同じ仮想端末名称を指定してください。

表5-12　入力命令発行時の通信論理マップ部と入力論理マップ部の設定値（受信メッセージテーブルを使用）

論理マップ名 | データ項目名 | 指定内容
通信論理マップ | 通信論理マップ長 | 何も設定しない。
予備
リターンコード
詳細コード
仮想端末名称
物理マップ名
入力論理マップ長の最大値
マッピングオプション
データ有無コード
予備
入力論理マップ | XMAP3によって設定されるので，明示的に設定する必要はない。受信後参照する場合は入力論理マップにコピーすること。

入力命令では，受信テーブルのアドレスを渡します。指定内容は，入力された時点で，すでに指定されています。

表5-13　出力命令発行時の通信論理マップ部と出力論理マップ部の設定値（送信メッセージテーブルを使用）

論理マップ名
データ項目名
指定内容

通信論理マップ
送信テーブル長
3004（または画面管理プログラムで指定した長さ+4）＋出力論理データ長 をセットする。

予備
(0000)₁₆とする。

トランザクションコード
次に起動するトランザクション名。

要求種別
(12000003)₁₆とする。

通信論理マップ長
64とする。

予備
(0000)₁₆とする。

リターンコード
(0000)₁₆とする。

詳細コード
(0000)₁₆とする。

仮想端末名称
X3MWHOSTに指定した仮想端末名称を指定する。※¹

物理マップ名
EBCDIKコードで入出力する物理マップ名を，デバイスIDを付けて，左詰めで指定する。残りは(40)₁₆とする。

入力論理マップ長の最大値
使用する入力論理マップの長さの最大値を指定する。

マッピングオプション
スペースまたは'0'：マージ※2
'2'：論理マップだけ※3
'3'：物理マップだけ※4
指定しない場合は(00)₁₆でヌルクリアする。

データ有無コード
設定しない。

予備
(0000)₁₆とする。

出力論理マップ
論理マップ長
出力論理マップ長を指定する。

予備
(0000)₁₆とする。

出力論理データ
出力論理データを設定する。

注※1

出力先の仮想端末名称を指定します。対応するオープン命令を発行したときと同じ仮想端末名称を指定してください。

注※2

論理項目，または制御項目に指定したデータを使用して画面を表示します。ただし，表示属性の変更指示をしない項目の属性は，画面定義時に指定した表示属性となります。

注※3

論理項目，または制御項目に指定したデータを使用して画面を表示します。ただし，表示属性の変更指示をしない項目の属性は，前画面の表示属性となります。また，データの指定がない項目は，前画面のデータをそのまま表示します。

注※4

論理項目，または制御項目に指定したデータを無視して，画面定義時の情報だけで画面を表示します。

5.2.3　TIOP3でのインタフェース

＜この項の構成＞

(1)　論理マップの取り込み

(2)　通信論理マップ

(3)　メッセージとAPの連携

(1)　論理マップの取り込み

VOS3とPCに処理を分散する環境では，VOS3とPC間で論理マップのデータをやり取りします。このとき論理マップは，COPY文でVOS3のAPに取り込まれます。COPY文は，APのWORKING-STORAGE SECTIONまたはLINKAGE SECTIONに指定します。ただし，論理マップ中に定数を展開させている場合は，LINKAGE SECTIONには取り込めません。

（例）

(2)　通信論理マップ

分散処理をするため，通信論理マップ，入力論理マップおよび出力論理マップをメインフレーム上のAPに取り込みます。通信論理マップは「XMAP3インストールフォルダ¥INCLUDE¥X3HOSTBL」として提供されています。

通信論理マップの形式を次の表に示します。

表5-14　通信論理マップの形式（TIOP3用）

エリア名称
長さ（位置）
データ形式
データ内容

XMAP-CD-MHLNG
2(0)
S9(4)COMP
通信論理マップ長

XMAP-CD-RSV1
2(2)
S9(4)COMP
予備

XMAP-CD-RTN
2(4)
9(4)COMP
リターンコード

XMAP-CD-RSN
2(6)
9(4)COMP
リターンコード詳細

XMAP-CD-TNAME
8(8)
X(8)
仮想端末名称

XMAP-CD-PMAPNAME
8(16)
X(8)
物理マップ名称をEBCDIKコードでセット

XMAP-CD-INLNG
2(24)
S9(4)COMP
入力論理マップ長の最大値

XMAP-CD-OPT
1(26)
X
マッピングオプション

XMAP-CD-DCODE
1(27)
X
データ有無コード

XMAP-CD-RSV2
36(28)
X(36)
予備
(00)₁₆でヌルクリア

注

通信論理マップ用定数の場合，エリア名称の「CD」の部分が「CDT」になります。

(3)　メッセージとAPの連携

メインフレームとPCに処理を分散する環境では，メインフレーム側からPC側へ，どのようにして入出力命令が渡されているのかを，命令発行順序を示して説明します。

なお，メインフレーム側の通信管理プログラムとして，PC上の「XMAP3インストールフォルダ¥SAMPLE¥C¥HSMHPROC」をメインフレーム上に転送して使用するものとします。

(a)　メインフレームからPC上の画面に対する送受信命令

オープン命令：メインフレーム上のAPから'MHOPEN'を呼び出して，PCにオープン命令を出す。

入出力命令：メインフレーム上のAPから'MHTRANS'を呼び出して，PCに表示命令を出し，さらにPCからデータを受信する。出力および入力するデータ数だけ，呼び出しを繰り返す。

クローズ命令：メインフレーム上のAPから'MHCLOSE'を呼び出して，PCにクローズ命令を出す。

(b)　メインフレームからPC上の帳票に対する送信命令

オープン命令：メインフレーム上のAPから'MHOPEN'を呼び出して，PCにオープン命令を出す。

出力命令：メインフレーム上のAPから'MHSEND'を呼び出して，PCに帳票印刷命令を出す。出力するデータ数だけ，呼び出しを繰り返す。

クローズ命令：メインフレーム上のAPから'MHCLOSE'を呼び出して，PCにクローズ命令を出す。

(c)　命令の呼び出し形式

メインフレーム上のAPからそれぞれの命令を呼び出すときのCALL文の形式を次に示します。

オープン命令

CALL 'MHOPEN' USING 通信論理マップ

入出力命令

CALL 'MHTRANS' USING 通信論理マップ　出力論理マップ　入力論理マップ

出力命令

CALL 'MHSEND' USING 通信論理マップ　出力論理マップ

クローズ命令

CALL 'MHCLOSE' USING 通信論理マップ

(d)　各命令と通信論理マップの関連

それぞれの命令発行時と通信論理マップの設定値の関連を表5-15，表5-16，表5-17および表5-18に示します。

表5-15　オープン命令発行時の通信論理マップと入力／出力論理マップの設定値（対話環境の場合）

データ項目名 | 指定内容
通信論理マップ長 | 64とする。
予備 | (0000)₁₆とする。
リターンコード | (0000)₁₆とする。
詳細コード | (0000)₁₆とする。
仮想端末名称 | X3MWHOSTに指定した仮想端末名称を指定する。※
物理マップ名 | (00)₁₆でヌルクリアする。
入力論理マップ長の最大値 | (0000)₁₆とする。
マッピングオプション | (00)₁₆とする。
データ有無コード | データ有無コードを指定する。
予備 | (00)₁₆でヌルクリアする。

注※

仮想端末の画面をオープンするときに，出力先が一つだけならば，指定を省略できます。指定を省略する場合，(40)₁₆で8バイトクリアしてください。

表5-16　入出力命令発行時の通信論理マップと入力／出力論理マップの設定値（対話環境の場合）

論理マップ名
データ項目名
指定内容

通信論理マップ
通信論理マップ長
64とする。

予備
(0000)₁₆とする。

リターンコード
(0000)₁₆とする。

詳細コード
(0000)₁₆とする。

仮想端末名称
X3MWHOSTに指定した仮想端末名称を指定する。※¹

物理マップ名
EBCDIKコードで入出力する物理マップ名を，デバイスIDを付けて，左詰めで指定する。残りは空白とする。

入力論理マップ長の最大値
入力論理マップの長さの最大値を指定する。

マッピングオプション
スペースまたは'0'：マージ※2
'2'：論理マップだけ※3
'3'：物理マップだけ※4
指定しない場合は(00)₁₆でヌルクリアする。

データ有無コード
設定しない。

予備
(0000)₁₆とする。

出力論理マップ
論理マップ長
出力論理マップ長を指定する。

予備
(0000)₁₆とする。

出力論理データ
出力論理データを設定する。

入力論理マップ
XMAP3が設定するので，設定する必要はない。受信後参照する場合は入力論理マップにコピーすること。

注※1

入出力先の仮想端末名称を指定します。対応するオープン命令を発行したときと同じ仮想端末名称を指定してください。

注※2

論理項目，または制御項目に指定したデータを使って画面を表示します。ただし，表示属性の変更指示をしない項目の属性は，画面定義時に指定した表示属性となります。

注※3

論理項目，または制御項目に指定したデータを使って画面を表示します。ただし，表示属性の変更指示をしない項目の属性は，前画面の表示属性となります。また，データの指定がない項目は，前画面のデータをそのまま表示します。

注※4

論理項目，または制御項目に指定したデータを無視して，画面定義時の情報だけで画面を表示します。

表5-17　出力命令発行時の通信論理マップの設定値

論理マップ名 | データ項目名 | 指定内容
通信論理マップ | 通信論理マップ長 | 何も設定しない。
予備
リターンコード
詳細コード
仮想端末名称
物理マップ名
入力論理マップ長の最大値
マッピングオプション
データ有無コード
予備
出力論理マップ | 論理マップ長 | 出力論理マップ長を指定する。
予備 | (0000)₁₆とする。
出力論理データ | 出力論理データを設定する。

表5-18　クローズ命令発行時の通信論理マップの設定値（対話環境の場合）

データ項目名 | 指定内容
通信論理マップ長 | 64とする。
予備 | (0000)₁₆とする。
リターンコード | (0000)₁₆とする。
詳細コード | (0000)₁₆とする。
仮想端末名称 | X3MWHOSTに指定した仮想端末名称を指定する。※
物理マップ名 | 設定しない。
入力論理マップ長の最大値 | 設定しない。
マッピングオプション | 設定しない。
データ有無コード | 設定しない。
予備 | (00)₁₆でヌルクリアする。

注※

クローズする仮想端末名称を指定します。対応するオープン命令を発行したときと同じ仮想端末名称を指定してください。

5.3　PC側のインタフェース

＜この節の構成＞

5.3.1　画面管理プログラム

5.3.2　メインフレームからの命令とPC側の処理

5.3.1　画面管理プログラム

メインフレームから送信された命令は，送受信メッセージ中の要求種別を通じてPC上の画面管理プログラムへ渡されます。渡される論理マップのデータはメインフレームのコードで記述されていますが，これらはXMAP3で変換されるので，PC用のコードに変換する必要はありません。

PC側の画面管理プログラムは，送受信データの要求種別に設定された命令を，要求としてXMAP3に渡します。また，画面管理プログラムは，画面での入力結果などをメインフレームに送信するときにも使用します。

標準的な画面管理プログラムは「XMAP3インストールフォルダ¥SAMPLES¥C」のフォルダに，ソースプログラムの形で添付されています。必要に応じてカスタマイズして利用してください。標準のままで利用する場合は，変更する必要はなく，コンパイルだけ実行してください。画面管理プログラムについては，「6. PCでの画面管理プログラムの利用と作成」を参照してください。

なお，XMAP3が提供するAPインタフェース（ライブラリ）は，マルチスレッドで動作する画面管理プログラムからの実行に対応していません。

5.3.2　メインフレームからの命令とPC側の処理

メインフレーム上のAPから送信された入出力命令を，画面管理プログラムが受信して，XMAP3に要求を発行し，結果をメインフレームに送信する過程を次の図に示します。なお，次の図の前提条件として，画面管理プログラムはC言語で作成するものとします。

図5-9　APの命令と画面管理プログラム

＜この項の構成＞

(1)　メインフレームAPと画面管理プログラムとのインタフェース

(2)　画面管理プログラムからXMAP3への要求

(3)　処理要求関数の形式

(1)　メインフレームAPと画面管理プログラムとのインタフェース

(a)　CommuniNet Extensionを使用する場合

メインフレームAPとデータをやり取りするために，画面管理プログラム（C言語）で使用するCommuniNet Extensionの関数については，マニュアル「CommuniNet Extension（Windows NT,Windows 95用）」，またはマニュアル「CommuniNet Extension Version 3」を参照してください。画面管理プログラムをCOBOLで作成する場合については，マニュアル「COBOL拡張ライブラリ」を参照してください。

(b)　TP1/Client/Pを使用する場合

メインフレームAPとデータをやり取りするために，画面管理プログラムで使用するTP1/Client/Pの関数については，次に示すマニュアルのどちらかを参照してください。

マニュアル「OpenTP1クライアント使用の手引」

マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」

(2)　画面管理プログラムからXMAP3への要求

(a)　メインフレームからの入出力命令とPC側の入出力処理（画面送受信）

画面を送受信するときに，画面管理プログラムがXMAP3に対して送る要求を説明します。

オープン要求（jsvwhopn）メインフレームからのオープン命令を受けて，jsvwhopnで仮想端末をオープンさせる。扱う仮想端末ごとにオープンする。一つの画面管理プログラム（プロセス）内で同時にオープンできる端末数の上限は15個です。

入出力要求（jsvwhtrn）メインフレームからの出力命令を受けて，jsvwhtrnで画面への表示および入力を行う。入出力するデータ数だけ，処理を繰り返す。

クローズ要求（jsvwhcls）メインフレームからのクローズ命令を受けて，jsvwhclsで仮想端末をクローズさせる。扱う仮想端末ごとにクローズする。

(b)　メインフレームからの入出力命令とPC側の入出力処理（帳票送信）

帳票を送信するときに，画面管理プログラムがXMAP3に対して送る要求を説明します。

オープン要求（jsvwhopn）メインフレームからのオープン命令を受けて，jsvwhopnで仮想端末をオープンさせる。扱う仮想端末ごとにオープンする。一つの画面管理プログラム（プロセス）内で同時にオープンできる端末数の上限は15個です。

出力要求（jsvwhsnd）メインフレームからの出力命令を受けて，jsvwhsndで帳票印刷を行う。出力するデータ数だけ，処理を繰り返す。

クローズ要求（jsvwhcls）メインフレームからのクローズ命令を受けて，jsvwhclsで仮想端末をクローズさせる。扱う仮想端末ごとにクローズする。

(3)　処理要求関数の形式

オープン要求（jsvwhopn）

メインフレーム側からのオープン命令を受けて，仮想端末をオープンさせます。このとき，メインフレーム側の画面管理プログラムから渡された通信論理マップを引数として指定します。

形式

long jsvwhopn (char* 通信論理マップアドレス)

画面の入出力要求（jsvwhtrn）

メインフレーム側からの入出力命令を受けて，画面に対して表示や入力を行います。このとき，メインフレーム側の通信論理マップ，入力論理マップおよび出力論理マップを引数として指定します。

形式

long jsvwhtrn (char* 通信論理マップアドレス,
              char* 出力論理マップアドレス,
              char* 入力論理マップアドレス)

帳票の出力要求（jsvwhsnd）

メインフレーム側からの出力命令を受けて，仮想端末を使用して帳票印刷を行います。このとき，メインフレーム側の通信論理マップおよび出力論理マップを引数として指定します。

形式

long jsvwhsnd (char* 通信論理マップアドレス,
              char* 出力論理マップアドレス)

クローズ要求（jsvwhcls）

メインフレーム側からのクローズ命令を受けて，仮想端末をクローズさせます。このとき，メインフレーム側の画面管理プログラムから渡された通信論理マップを引数として指定します。

形式

long jsvwhcls (char* 通信論理マップアドレス)

5.4　AP作成時の注意事項

メインフレームでAPを作成する場合，または既存のメインフレーム用APを流用する場合は，次の点に注意してください。

＜この節の構成＞

5.4.1　論理マップの項目名

5.4.2　変更属性定義

5.4.3　16進指定（DFC）の動的変更

5.4.4　XDM/DCCM3の機能を代替する

5.4.5　既存APの流用

5.4.1　論理マップの項目名

XMAP3で定義した論理マップは，次のような形式になります。

入力項目

マップ名-項目の名称I

出力項目

マップ名-項目の名称O

新しくAPを作成する場合，プログラム中の論理マップの項目名を，上に示した形式に一致させてください。また，メインフレームで利用していたCOBOLのAPを流用する場合，論理マップの項目名が上に示した形式に一致しているかどうかを確認してください。一致していない場合，マップファイルまたはAPを修正してください。

5.4.2　変更属性定義

テキスト・フィールドの変更属性定義，ボタン・リスト・メニューの変更属性定義，およびウィンドウ表示制御の変更属性定義は，XMAP3のドローセットアップから，表示属性の動的変更ダイアログで設定できます。

5.4.3　16進指定（DFC）の動的変更

16進指定（DFC）の動的変更はXMAP3からは設定できません。APで動的変更が必要な場合は，修飾名を動的変更領域に設定してください。なお，XMAP3では，ドローセットアップでの設定に応じて動的変更テーブルが自動的に生成されます。

動的変更を元に戻すときは，APからデータ有無コードを動的変更領域に設定してください。

5.4.4　XDM/DCCM3の機能を代替する

XDM/DCCM3の機能で，XMAP3では使用できないものがあります。そのため，メインフレーム上のAPまたはPC上の画面管理プログラムで同等の機能を実現する必要があります。

XDM/DCCM3の機能でXMAP3では利用できないものについて，APまたは画面管理プログラムで代替する方法を説明します。

＜この項の構成＞

(1)　XMAPCTRL文の機能

(2)　マッピングオプション

(1)　XMAPCTRL文の機能

(a)　入力論理マップのクリア文字

XDM/DCCM3のXMAPCTRL文では，PADCHRオペランドで入力論理マップのクリア文字を指定しますが，XMAP3ではこの機能をそのまま利用することはできません。マップを再定義するか，または画面管理プログラムを変更してください。画面管理プログラムを変更する方法については，「6. PCでの画面管理プログラムの利用と作成」を参照してください。

(b)　データ有無コード

通信論理マップ内の「データ有無コード」の項目で設定します。通信論理マップについては，「5.2　VOS3側のインタフェース」を参照してください。

(c)　リテラルキー

マップのPFキーを指定して，画面制御を作り直してください。

(2)　マッピングオプション

XDM/DCCM3では，マッピングオプションは自動的に指定されますが，XMAP3でPCと処理を分散する場合，メインフレーム上のAPで指定する必要があります。

マッピングオプションは，通信論理マップで指定します。エリア名称を次に示します。

受信メッセージテーブルの場合：XMAP-RECV-OPT

送信メッセージテーブルの場合：XMAP-SEND-OPT

また，マッピングオプションに指定する内容は次のとおりです。

スペースまたは'0'を指定した場合

論理項目，または制御項目に指定したデータを使って画面を表示します。ただし，表示属性の変更指示をしない項目の属性は，画面定義時に指定した表示属性となります。

'2'を指定した場合

論理項目，または制御項目に指定したデータを使って画面を表示します。ただし，表示属性の変更指示をしない項目の属性は，前画面の表示属性となります。

'3'を指定した場合

論理項目，または制御項目に指定したデータを無視して，画面定義時の情報だけで画面を表示します。

5.4.5　既存APの流用

T-560/20端末の画面や帳票に対し，MPPで入出力を実行する既存APを流用したいときは，次のような方法で流用できます。

画面出力，および帳票出力ともにXMAP3のメインフレーム・PC連携機能で出力するように移行する。

画面はCommuniNetのビデオステーションへ出力し，帳票はメインフレーム・PC連携機能で出力するように移行する。

ただし，どちらの方法でも分岐メッセージによる帳票出力ができないため，帳票を出力するAPを新たに作成する必要があります。

以下に，帳票だけ拡張ホストアクセスによる，メインフレーム・PC連携機能を利用した場合のプログラム変更例を示します。

CommuniNetで画面出力用と帳票出力用の画面端末をそれぞれ定義しておき，あらかじめ，同一PC上でそれらを起動しておきます。

分岐メッセージとして帳票を出力していたSEND文を，帳票出力用の画面端末定義に出力するようAPを変更します。
このとき，SEND文の形式や内容を「5.1.1　XDM/DCCM3での拡張ホストアクセス（論理マップ長≦2,920バイトの場合）」の図5-2で示した，「3 メインフレームAPからのオープン命令」の内容と同じようにします。

以下の処理を順次，実行するAPを作成します。

帳票の出力処理

帳票のクローズ処理

帳票出力の終了処理

T-560/20端末の画面や帳票に対し，MPPで入出力を実行する既存APを流用する仕組みを次の図に示します。

図5-10　既存AP流用時の処理内容の修正概要

6.　PCでの画面管理プログラムの利用と作成

PC上の画面管理プログラムは，メインフレーム上のAPとPC上のXMAP3との通信を中継します。この章では，画面管理プログラムの変更方法，およびコンパイル方法について説明します。

＜この章の構成＞

6.1　サンプルプログラム

6.2　利用形態に応じた変更

6.3　コンパイルから実行まで

6.1　サンプルプログラム

XMAP3では，次に示すフォルダに画面管理プログラムのサンプルが収められています。

C言語のサンプル：XMAP3インストールフォルダ¥SAMPLES¥C

COBOLのサンプル：XMAP3インストールフォルダ¥SAMPLES¥COBOL

それぞれのサンプルについて説明します。それぞれのサンプルのフローチャートについては，「付録B.4(2)　PC上の画面管理プログラムの例」を参照してください。

＜この節の構成＞

6.1.1　XDM/DCCM3で2,920バイト以内のデータをやり取りする（拡張ホストアクセス）

6.1.2　XDM/DCCM3で2,920バイトを超えるデータをやり取りする（拡張ホストアクセス）

6.1.3　TP1/Client/PによるMPPの処理

6.1.4　TP1/Client/PによるBMPの処理

6.1.5　対話処理

6.1.6　COBOLによる画面管理プログラム

6.1.1　XDM/DCCM3で2,920バイト以内のデータをやり取りする（拡張ホストアクセス）

XDM/DCCM3で拡張ホストアクセスを使用して，2,920バイト以内のデータをやり取りするサンプルです。

＜この項の構成＞

(1)　ファイル名

(2)　処理の概要

(1)　ファイル名

ONLNPROC.Cです。

(2)　処理の概要

ONLNPROC.Cが行う処理の概要について説明します。

開始
ウィンドウハンドルを取得して，ホストアクセス機能を開始します。

拡張ホストアクセス
メインフレームからデータを受信してから，入力論理マップの初期化をします。
次に，メインフレームからの命令に応じて，次のどれかの処理をします。

仮想端末のオープン要求

仮想端末のクローズ要求

仮想端末の入出力要求

仮想端末の出力要求

必要に応じて，結果をメインフレームに送信します。
業務がすべて終了するまで，2.を繰り返します。

終了
拡張ホストアクセス機能を終了します。

6.1.2　XDM/DCCM3で2,920バイトを超えるデータをやり取りする（拡張ホストアクセス）

XDM/DCCM3で拡張ホストアクセスを使用して，2,920バイトを超えるデータをやり取りするサンプルです。

2,920バイトを超えるデータをやり取りする場合は，継続入力および継続出力の二つの命令を使用します。一回の継続入力命令または継続出力命令で，データが2,920バイトずつ転送されます。

＜この項の構成＞

(1)　ファイル名

(2)　処理の概要

(3)　利用方法

(1)　ファイル名

ONLNPRC2.Cです。

(2)　処理の概要

ONLNPRC2.Cが行う処理の概要について説明します。

開始
ウィンドウハンドルを取得して，拡張ホストアクセス機能を開始します。

拡張ホストアクセス
メインフレームからデータを受信します。
次に，メインフレームからの命令に応じて，次のどれかの処理をします。

仮想端末のオープン要求

仮想端末のクローズ要求

仮想端末の入出力要求（入出力の前に，入力論理マップを初期化します）

仮想端末の出力要求

仮想端末の継続出力要求

仮想端末の継続入力要求

必要に応じて，結果をメインフレームに送信します。
業務がすべて終了するまで，2.を繰り返します。

終了
拡張ホストアクセス機能を終了します。

(3)　利用方法

(a)　メインフレームからPCにデータを出力する場合

メインフレーム上のAPは継続出力命令を繰り返し，論理マップのデータを2,920バイトずつPCに転送します。最後に残ったデータは，出力命令または入出力命令でPCに転送されます。

(b)　PCからメインフレームにデータを入力する場合

最初のデータは入出力命令によってPCからメインフレームに転送されます。次に，メインフレーム上のAPから継続入力命令が送られます。

メインフレーム上のAPは，すべてのデータを受信するまで繰り返し継続入力命令を送信します。PCからメインフレームへのデータの送信が終了したら，メインフレームのAPはクローズ命令を発行します。

(c)　入出力を組み合わせる場合

まず，メインフレーム上のAPは画面管理プログラムに対して継続出力命令を繰り返し送信し，最後に入出力命令を送信します。

次に，メインフレーム上のAPは継続入力命令を繰り返します。すべてのデータの転送が終了したら，APからクローズ命令を送信します。

6.1.3　TP1/Client/PによるMPPの処理

XDM/DCCM3使用時には，画面管理プログラムとメインフレームとの通信にTP1/Client/Pを利用できます。

この場合，一度に転送できる論理マップのデータは最大2Gバイトになります。したがって，継続入出力命令を使用しないで，メインフレームとPCの間で，2,920バイトを超えるデータを転送できます。ただし，提供しているサンプルでは，一度に転送できる論理マップのデータは31,916バイトに固定されています。

＜この項の構成＞

(1)　ファイル名

(2)　処理の順序

(1)　ファイル名

TPCLPROC.Cです。

(2)　処理の順序

TPCLPROC.Cが行う処理の概要について説明します。

開始
次の順序でTCP/IP通信を開始します。

クライアントの認証を実行します。

TP1/Client/Pをオープンします。

メインフレーム上のAPを起動します。

データの送受信
メインフレームからデータを受信します。
次に，メインフレームからの命令に応じて，次のどれかの処理をします。

仮想端末のオープン要求

仮想端末のクローズ要求

仮想端末の入出力要求（入出力の前に，入力論理マップを初期化します）

仮想端末の出力要求

必要に応じて，結果をメインフレームに送信します。
業務がすべて終了するまで，2.を繰り返します。

終了
TCP/IP通信を終了します。

TP1/Client/Pをクローズします。

クライアントの認証を解除します。

6.1.4　TP1/Client/PによるBMPの処理

XDM/DCCM3使用時に，PC上でTP1/Client/Pを使用して，BMPによる分岐メッセージを使用した処理ができます。

この場合，一度に転送できる論理マップのデータは最大2Gバイトになります。したがって，継続入出力命令を使用しないで，メインフレームとPCの間で2,920バイトを超えるデータを転送できます。ただし，提供しているサンプルでは，一度に転送できる論理マップのデータは2,920バイトに固定されています。

＜この項の構成＞

(1)　ファイル名

(2)　処理の順序

(1)　ファイル名

TPCLPRC2.Cです。

(2)　処理の順序

TPCLPRC2.Cが行う処理の概要について説明します。

開始
次の順序でTCP/IP通信を開始します。

クライアントの認証を実行します。

TP1/Client/Pをオープンします。

メインフレーム上のAPからデータが送信されるのを待ちます。

データの送受信
メインフレームからデータを受信します。
次に，メインフレームからの命令に応じて，次のどれかの処理をします。

仮想端末のオープン要求

仮想端末のクローズ要求

仮想端末の出力要求

処理を終えたら，送達確認メッセージをメインフレームに送信します。
業務がすべて終了するまで，2.を繰り返します。

終了
メインフレームからの終了要求に対して，送達確認メッセージを送信します。
TCP/IP通信を終了します。

TP1/Client/Pをクローズします。

クライアントの認証を解除します。

6.1.5　対話処理

TIOP3を使用して対話処理をする場合の標準的なサンプルです。

＜この項の構成＞

(1)　ファイル名

(2)　処理の概要

(1)　ファイル名

TSSPROC.Cです。

注意

メインフレーム側の通信管理プログラムに，提供されているHSMHPROCを使用する場合，TSSPROC.Cをコンパイルした後のプログラム名は，「PCMHPROC.EXE」にしてください。

(2)　処理の概要

TSSPROC.Cが行う処理の概要について説明します。

開始
ウィンドウハンドルを取得して，ホストアクセス機能を開始します。

拡張ホストアクセス
メインフレームからデータを受信します。
次に，メインフレームからの命令に応じて，次のどれかの処理をします。

仮想端末のオープン要求

仮想端末のクローズ要求

仮想端末の入出力要求

仮想端末の出力要求

必要に応じて，結果をメインフレームに送信します。
業務がすべて終了するまで，2.を繰り返します。

終了
拡張ホストアクセス機能を終了します。

6.1.6　COBOLによる画面管理プログラム

画面管理プログラムをCOBOLで作成することもできます。この場合，COBOL85が必要です。また，このサンプルではCommuniNet Extension制御機能を利用するため，COBOL拡張ライブラリが必要です。

＜この項の構成＞

(1)　ファイル名

(2)　処理の概要

(3)　コンパイルとリンケージ

(1)　ファイル名

ONLNPRC2.CBLです。

(2)　処理の概要

プログラムの内容は，ONLNPRC2.Cと同じものです。継続入力および継続出力については，「6.1.2　XDM/DCCM3で2,920バイトを超えるデータをやり取りする（拡張ホストアクセス）」を参照してください。

開始
ウィンドウハンドルを取得して，拡張ホストアクセス機能を開始します。

拡張ホストアクセス
メインフレームからデータを受信します。
次に，メインフレームからの命令に応じて，次のどれかの処理をします。

仮想端末のオープン要求

仮想端末のクローズ要求

仮想端末の入出力要求（入出力の前に，入力論理マップを初期化します）

仮想端末の出力要求

仮想端末の継続出力要求

仮想端末の継続入力要求

必要に応じて，結果をメインフレームに送信します。
業務がすべて終了するまで，2.を繰り返します。

終了
拡張ホストアクセス機能を終了します。

(3)　コンパイルとリンケージ

COBOL拡張ライブラリのCommuniNet Extension制御機能を利用するので，実行形式のプログラムを作成するにはコンパイルのほかにリンケージ処理が必要です。

(a)　必要なファイル

コンパイルおよびリンケージに必要なファイルを次に示します。

COPYファイル

COBOL拡張ライブラリのバージョンが02-00，またはそれ以降の場合

EXCNEX32.CBL：COBOL拡張ライブラリで提供

EXHA32.CBL：COBOL拡張ライブラリで提供

COBOL拡張ライブラリのバージョンが02-00より前の場合

EXCNEX32.CPY：COBOL拡張ライブラリで提供

EXHA32.CPY：COBOL拡張ライブラリで提供

インポートライブラリ

次に示すライブラリを，COBOL85の開発マネージャを使って実行ファイルの直下に取り込んでください。

COBOL85 Version7またはCOBOL85 Version6の場合
XMAP3インストール先¥LIB¥X3MWHD32.LIB：XMAP3で提供

COBOL85 Version5.0の場合
XMAP3インストール先¥LIB¥V3Compatible¥X3MWHD32.LIB：XMAP3で提供

EXCNEX32.LIB：COBOL拡張ライブラリで提供

EXHA32.LIB：CommuniNet Extensionで提供

(b)　環境変数の設定（COBOL拡張ライブラリのバージョンが02-00より前の場合）

COBOL拡張ライブラリのバージョンが02-00より前の場合，使用するCOPYファイルの拡張子が「.CPY」となっているので，環境変数CBLFIXを設定する必要があります。

環境変数を設定するには，COBOL85の開発マネージャから，次のように操作してください。

COBOL85 Version7またはCOBOL85 Version6の場合

［プロジェクト］-［プロジェクトの設定...］コマンドを選択する。
プロジェクト設定ダイアログが表示されます。

プロジェクト設定ダイアログの「環境変数」タブを選択し，［CBLFIX］ボタンをクリックする。
環境変数の設定ダイアログが表示されます。

環境変数の設定ダイアログの値に'.cpy'を指定して［追加］ボタンをクリックし，［OK］ボタンをクリックする。

プロジェクト設定ダイアログの［OK］ボタンをクリックする。

COBOL85 Version5.0の場合

［オプション］-［コンパイラ...］コマンドを選択する。
コンパイラオプションダイアログが表示されます。

コンパイラオプションダイアログの［環境変数設定...］ボタンをクリックする。
環境設定ダイアログが表示されます。

変数に'CBLFIX'，値に'.cpy'を指定して［設定...］ボタンをクリックする。

［OK］ボタンをクリックして環境設定ダイアログを閉じ，コンパイラオプションダイアログの［OK］ボタンをクリックする。

(c)　コンパイル時のオプション

コンパイル時は，COBOL85のコンパイルオプションで-Cpを指定して，CBWファイルを作成します。このとき，CBWファイルには次に示す外部関数名を記述してください。

jsvwhopn

jsvwhcls

jsvwhtrn

jsvwhsnd

EXCNEX

さらに，コンパイルオプションとして-Bb（2進数をビッグエンディアンで処理）を必ず指定してください。

また，サンプルを修正した場合，修正内容によっては次に示すコンパイルオプションの指定が必要になります。

-X5（COMP-5を使用可能とする）

-Vx（2進数の拡張）

-B1（1バイトの2進数を使用可能にする）

コンパイルおよびリンケージの手順については，マニュアル「COBOL85ユーザーズガイド」およびマニュアル「COBOL拡張ライブラリ」を参照してください。

6.2　利用形態に応じた変更

＜この節の構成＞

6.2.1　仮想端末名およびマップ名を設定する

6.2.2　入力論理マップのクリア文字を指定する

6.2.3　トランザクションコード

6.2.4　TP1/Client/Pを使って2,920バイトを超えるデータをやり取りする

6.2.5　TP1/Client/Pを使って可変長のデータをやり取りする

6.2.6　TP1/Client/Pを使ったMPPの処理でトランザクションを変更する

6.2.7　CommuniNetの端末名称を変更する

6.2.8　画面管理プログラムにメインフレームAPの処理を分散する

6.2.1　仮想端末名およびマップ名を設定する

画面管理プログラムに，仮想端末名称およびマップ名などを設定するコードを追加してください。通信論理マップの「仮想端末名称」および「物理マップ名」はEBCDIKコードで設定します。

6.2.2　入力論理マップのクリア文字を指定する

入力論理マップを初期化するときのクリア文字は，画面管理プログラムで設定してください。なお，文字コードはASCIIコードではなくEBCDIKコードで指定してください。

XMAP3で提供しているサンプルでの，入力論理マップのクリア文字の指定方法を次に示します。

C言語のサンプル（ONLNPROC.C，ONLNPRC2.C，TPCLPROC.C）の場合

「0x00」の部分が，クリア文字のEBCDIKコードです。これを，例えば「0x40」に変更すると，入力論理マップがスペースでクリアされます。

COBOLのサンプル（ONLNPRC2.CBL）の場合

「X'00'」の部分が，クリア文字のEBCDIKコードです。これを，例えば「X'40'」に変更すると，入力論理マップがスペースでクリアされます。

6.2.3　トランザクションコード

トランザクションコードによって，PCからメインフレーム上のAPを起動する形態で運用する場合，トランザクションコードは画面の隠しフィールドに定義します。隠しフィールドに定義したトランザクションコードをメインフレームに送るには，転送するデータの形式をXMAP3の環境に合わせるために，画面管理プログラムを変更してください。データ領域の先頭に，トランザクションコードの内容を設定します。

トランザクションコードを利用する場合の，PCからメインフレームへ転送するデータの形式を次の図に示します。

図6-1　PCから転送するデータの形式

6.2.4　TP1/Client/Pを使って2,920バイトを超えるデータをやり取りする

TP1/Client/PでMPPの処理をするためのサンプル（TPCLPROC.C）を使用する場合，PCとメインフレームの間で送受信される論理マップの大きさは次のようになっています。

メインフレームからPCへ送信する場合：31,916バイトに固定

PCからメインフレームへ送信する場合：任意

メインフレームからPCへ送信する場合の論理マップの大きさを変えたい場合は，サンプルの次に示す個所を変更してください。

6.2.5　TP1/Client/Pを使って可変長のデータをやり取りする

TP1/Client/Pの画面管理プログラム（TPCLPROC.C，TPCLPRC2.C）の送信メッセージ長は，ソースを変更しない場合，それぞれ31,916バイト，2,920バイト固定です。

送信メッセージを可変長にする場合は，サンプルの次に示す個所を変更して，論理マップサイズを送信メッセージの最大の長さにしてください。

また，dc_clt_receive関数で送信メッセージを受け取る部分を，次のように変更します。

送信メッセージ長の領域だけをdc_clt_receive関数で受け取ります。

受け取った送信メッセージ長をリトルエンディアンに変換し，送信メッセージ長の領域分を差し引きます。

dc_clt_receive関数のパラメタの送信メッセージ長を設定し，送信メッセージを受け取るように変更してください。

TPCLPROC.Cの場合，先頭に送信メッセージ長の領域を付加するように，XDM/DCCM3の設定を変更してください。

6.2.6　TP1/Client/Pを使ったMPPの処理でトランザクションを変更する

TP1/Client/PでMPPの処理をするためのサンプル（TPCLPROC.C）では，トランザクション起動を画面管理プログラムの起動時に行います。このとき，起動時のトランザクションコードはTCT401を前提としています。

TCT401以外のトランザクションコードに変更するには，サンプルの以下の個所を変更してください。使用する文字コードはEBCDIKです。

6.2.7　CommuniNetの端末名称を変更する

XMAP3で提供しているサンプルプログラムでは，CommuniNetの端末名称を画面管理プログラムで設定し，「オンライン端末」という名称を前提にしています。CommuniNetの端末名称を「オンライン端末」以外の名称にするには，サンプルプログラムを修正する必要があります。

XMAP3で提供しているサンプルプログラムでの，CommuniNetの端末名称の指定個所を次に示します。

C言語のサンプル（ONLNPROC.C，ONLNPRC2.C）の場合

CommuniNetの端末名称を「オンライン端末」以外にする場合，上記の"オンライン端末"の部分をCommuniNetの端末名称と同じ名称に変更してください。

COBOLのサンプル（ONLNPRC2.CBL）の場合

CommuniNetの端末名称を「オンライン端末」以外にする場合，上記の"オンライン端末"の部分をCommuniNetの端末名称と同じ名称に変更してください。

6.2.8　画面管理プログラムにメインフレームAPの処理を分散する

画面表示やPC上のAPの呼び出しを，メインフレーム上のAPではなく画面管理プログラムで処理できます。これによって，すべてをメインフレーム上のAPから処理する場合に比べて，メインフレームとPCとでやり取りされるデータの量が減少するので，処理の効率を上げることができます。

画面管理プログラムは，メインフレームのAPとの間で送受信される入出力論理マップの内容をそのままXMAP3に渡しています。この入出力論理マップには，メインフレーム用のコードである，EBCDIKコードおよびKEIS'83コードでデータが格納されています。

画面管理プログラムにAP処理を分散し，入出力論理マップ中のデータを参照または更新するためには，EBCDIKコードおよびKEIS'83コードを使用する必要があります。画面管理プログラムをC言語で作成している場合は，入出力論理データを扱う構造体を，COBOL用の論理マップを参考にして作成してください。

画面管理プログラムから，メインフレームのAPからの命令とは別に画面を表示させる場合は，jsvwhtrn関数を使用します。画面管理プログラムをCOBOLで作成する場合は，「CALL "jsvwhtrn"」としてください。

画面管理プログラムにメインフレームのAPの処理を分散するケースについて説明します。

＜この項の構成＞

(1)　ポップアップメニューを表示する

(2)　メニュー画面を表示する

(3)　二次ウィンドウを表示する

(4)　PC上のほかのAPを呼び出す

(5)　Windowsのヘルプ機能を呼び出す

(1)　ポップアップメニューを表示する

マスタファイルなどからデータを取り出し，可変ポップアップのメニュー内容の変更処理を分散します。

PC上に可変ポップアップメニュー用論理項目と同じ形式と大きさで，内容がEBCDIKコードおよびKEIS'83コードで格納されたメニューファイルを準備します。

画面管理プログラムでは，次の処理を行います。

画面を表示する前に，出力論理マップの，可変ポップアップメニュー用データが格納されている領域の内容を，メニューファイルの内容に書き換えます。

画面を表示します。

(2)　メニュー画面を表示する

仮想端末のオープン要求のあとに表示するメニュー画面の表示処理を分散します。

メニュー画面をXMAP3で定義します。このとき，生成したマップはメインフレームに転送しません。

画面管理プログラムでは，次の処理を行います。

メインフレームのAPから受け取った仮想端末のオープン要求を処理します。

メニュー画面を表示します。

メニュー画面から入力された入力論理マップ中の，イベント通知コードが格納されている位置から，長さ分の内容をEBCDIKコードで判定します。

3.で判定した内容から，メインフレームのAPに送信するトランザクションコードを決定します。

トランザクションコードを受信メッセージテーブルに格納し，メインフレームに送信します。

(3)　二次ウィンドウを表示する

一次ウィンドウから入力されたイベント通知コードを判定して，操作の補助を目的として二次ウィンドウを表示させる処理を分散します。

二次ウィンドウをXMAP3で定義します。このとき，生成したマップはメインフレームに転送しません。

画面管理プログラムでは，次の処理を行います。

一次ウィンドウから入力された入力論理マップ中の，イベント通知コードが格納されている位置から，長さ分の内容をEBCDIKコードで判定します。

二次ウィンドウの表示を指示するイベント通知コードであれば，二次ウィンドウを表示します。

二次ウィンドウを表示するときに使用する出力論理マップは，EBCDIKコードおよびKEIS'83コードでデータを格納します。また，二次ウィンドウからの入力データもEBCDIKコードおよびKEIS'83コードで格納されています。そのため，画面管理プログラムから表示させる二次ウィンドウは，論理データを極力使用しないものにしてください。

(4)　PC上のほかのAPを呼び出す

一次ウィンドウから入力されたイベント通知コードを判定して，PC上のAPを起動する処理を分散します。

画面管理プログラムで，次の処理を行います。

一次ウィンドウから入力された入力論理マップ中の，イベント通知コードが格納されている位置から，長さ分の内容をEBCDIKコードで判定します。

APの起動を指示するイベント通知コードであれば，該当するAPを起動します。

(5)　Windowsのヘルプ機能を呼び出す

一次ウィンドウから入力されたイベント通知コードを判定して，Windowsのヘルプを呼び出す処理を分散します。

画面管理プログラムで，次の処理を行います。

一次ウィンドウから入力された入力論理マップ中の，イベント通知コードが格納されている位置から，長さ分の内容をEBCDIKコードで判定します。

ヘルプの呼び出しを指示するイベント通知コードであれば，WindowsAPIのWinHelpを呼び出してください。

画面管理プログラムをCOBOLで作成している場合には，WINHELP.EXEの引数としてヘルプファイル名を指定してください。COBOLでのコーディング例を次に示します。

（例）

6.3　コンパイルから実行まで

PC上で使用する画面管理プログラム（C言語）のコンパイルおよびリンケージの仕組みについて説明します。具体的な操作方法については，コンパイラとして使用するVisual C++のコンパイラのマニュアルを参照してください。

なお，COBOLで作成した画面管理プログラムのコンパイルおよびリンケージの仕組みについては，「6.1.6　COBOLによる画面管理プログラム」を参照してください。

また，TIOP3を使用するときに，メインフレーム側の通信管理プログラムとしてXMAP3で提供されているHSMHPROCを使用する場合は，必ずPC側の画面管理プログラムの名称を「PCMHPROC.EXE」としてください。

＜この節の構成＞

6.3.1　画面管理プログラムのコンパイルとリンケージ

6.3.2　画面管理プログラムの実行

6.3.1　画面管理プログラムのコンパイルとリンケージ

画面管理プログラムは，Visual C++のコンパイラを使用してコンパイルおよびリンケージをします。実行可能ファイルを作成するまでの概要を次の図に示します。リンケージするときには，メインフレーム接続インタフェースライブラリ，および拡張ホストアクセスライブラリをリンクします。

図6-2　実行可能ファイルを作成するまでの概要

画面管理プログラムのソースプログラムをコンパイルおよびリンケージする場合の，操作方法や指定するオプションについては，Visual C++のコンパイラのマニュアルを参照してください。コンパイルとリンケージ時に必要なパラメタを次に示します。

CommuniNetを使用する場合

次に示すライブラリおよびヘッダをプロジェクトに追加してください。

Visual C++ 6.0またはVisual C++.NETの場合
XMAP3インストール先¥LIB¥X3MWHD32.LIB：XMAP3のメインフレーム接続用ライブラリ

Visual C++ 5.0の場合
XMAP3インストール先¥LIB¥V3Compatible¥X3MWHD32.LIB：XMAP3のメインフレーム接続用ライブラリ

EXHA32.LIB：CommuniNet Extensionの拡張ホストアクセスライブラリ

EXHA32.H：CommuniNet Extensionの拡張機能関数のヘッダファイル

TP1/Client/Pを使用する場合

次に示すライブラリおよびヘッダをプロジェクトに追加してください。

Visual C++ 6.0またはVisual C++.NETの場合
XMAP3インストール先¥LIB¥X3MWHD32.LIB：XMAP3のメインフレーム接続用ライブラリ

Visual C++ 5.0の場合
XMAP3インストール先¥LIB¥V3Compatible¥X3MWHD32.LIB：XMAP3のメインフレーム接続用ライブラリ

CLTW32.LIB：TP1/Client/Pのライブラリ

DCVRPC.H：TP1/Client/Pのヘッダファイル

DCVCLT.H：TP1/Client/Pのヘッダファイル

Visual C++でプロジェクトワークスペースを作成するときは，種類には必ず「Application」を指定してください。「Console Application」を指定すると，コンパイル時に外部シンボル「_main」が未解決エラーになります。

また，Visual C++.NETでプロジェクトファイルを作成するときは，アプリケーションの種類に「Windowsアプリケーション」を指定してください。「コンソールアプリケーション」を指定すると，コンパイル時に外部シンボル「_main」が未解決エラーになります。

なお，XMAP3の関数はC言語用に作成されているため，「extern "C"」で関数宣言してください。

6.3.2　画面管理プログラムの実行

コンパイルおよびリンケージをした画面管理プログラムは，環境変数PATHに指定されているフォルダに置いてください。

画面管理プログラムを実行させるには，PC上であらかじめ画面管理プログラムを起動してメインフレームからのデータを待つ方法と，メインフレームからPC上の画面管理プログラムを起動させる方法の二つがあります。

メインフレームのAPから画面管理プログラムを起動させる場合は，送信メッセージのAP名の項目に，画面管理プログラムの名称（ファイル名.EXE）を指定してください。

7.　トラブルシューティング

この章では，VOS3とPCに処理を分散する環境でのトラブルとその対処方法について説明します。

マニュアル「XMAP3 開発・実行ガイド」も参照してください。

＜この章の構成＞

7.1　回線接続時のトラブルと対処方法

7.2　画面・帳票出力時のトラブルと対処方法

7.3　XDM/DCCM3使用時のトラブルと対処方法

7.4　画面管理プログラムのトラブルと対処方法

7.5　CommuniNet Extension使用時のトラブルと対処方法

7.1　回線接続時のトラブルと対処方法

CommuniNet使用時の回線接続に関するトラブルについて，その対処方法を説明します。

TP1/Client/Pを使用している場合は，CLTDUMPコマンドでトレースを採取して，トラブルの内容を調査してください。詳細については，次に示すマニュアルのどちらかを参照してください。

マニュアル「OpenTP1クライアント使用の手引」

マニュアル「OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編」

「回線接続エラー」が発生する。

IPアドレスまたはゲートウェイアドレスが誤っています。

コントロールパネルの「ネットワーク」で，「TCP/IP（プロトコル）」を選び，IPアドレスとゲートウェイアドレスを正しく設定してください。

「AP識別子とメインフレーム名の設定に誤りがあります」というメッセージが表示される。

CommuniNetで設定したメインフレーム名が誤っています。

CommuniNetの環境設定ユティリティで［通信情報］の［接続先サーバ名］を正しく設定してください。

7.2　画面・帳票出力時のトラブルと対処方法

画面表示および帳票印刷をしたときのトラブルについて，その対処方法を説明します。

画面・帳票が出力できない。

通信論理マップの内容を記述する文字コードに，シフトJISが使用されています。

通信論理マップは，EBCDIKおよびKEISコードを使用して記述してください。

画面・帳票に文字化けが生じる。

通信論理マップの内容を記述する文字コードに，シフトJISが使用されています。

通信論理マップは，EBCDIKおよびKEISコードを使用して記述してください。

XMAP3でオープンエラーが出る。

マップがリトルエンディアンで作成されているか，またはPC側でパラメタ長を設定しているためにパラメタの長さが不正に解釈されている可能性があります。

パラメタ長が正しく設定されているかどうか見直してください。

7.3　XDM/DCCM3使用時のトラブルと対処方法

XDM/DCCM3使用時に固有のトラブルについて，その対処方法を説明します。

MODATTR文でデータ有無コードを設定してもマッピングに反映されない。

XMAP3では，マッピングオプションはAPで設定する必要があります。通信論理マップのマッピングオプションの項目で設定してください。

可変項目のデータ有無コードを設定しても反映されない。

XMAP3では，マッピングオプションはAPで設定する必要があります。通信論理マップのマッピングオプションの項目で設定してください。

AP終了後，ログイン画面がKBロック状態になっていて，キー入力できない。

取り消しキーが押されていない可能性があります。対処方法としては，次の二つがあります。

PCのキーボードから取り消しキー（［Ctrl］+［R］キー）を押す。

画面管理プログラムで，EXClose関数を発行する前にNHSimulateKey関数を発行して，取り消しキー（NHSIM_KEY_RESETパラメタ）を押すのと同じ状態にする。

7.4　画面管理プログラムのトラブルと対処方法

画面管理プログラムに関連するトラブルについて，その対処方法を説明します。

画面管理プログラムのコンパイル時に，リンケージエラーが発生する。

画面管理プログラムのコンパイルで，プロジェクトワークスペースを作成するときに，「Application」を指定してください。「Console Application」を指定すると，外部シンボル"_main"は未解決エラーになります。

jsvwhtrn関数を呼び出すと，画面管理プログラムが異常終了してしまう。

オープンが成功している場合は，通信論理マップ中の出力論理マップ長に，実際より小さい値が指定されている可能性があります。通信論理マップ中の出力論理マップ長の値を確認してください。

jsvwhtrn関数を呼び出すと，入力論理マップ長エラーが発生する。

通信論理マップ中の，入力論理マップ長の最大値を見直してください。通常は，X'7FFF'と設定すれば問題ありません。

7.5　CommuniNet Extension使用時のトラブルと対処方法

XDM/DCCM3でCommuniNet Extensionの画面管理プログラムを使用している場合は，「付録B.5　CommuniNet Extensionを使用したメインフレーム・PC連携機能でのトラブルと対処方法」を参照してください。

8.　VOS1-PC分散システムの環境設定

この章では，VOS1とPCに処理を分散して運用する場合の，開発環境および実行環境の設定方法について説明します。

＜この章の構成＞

8.1　開発環境の設定

8.2　実行環境の設定

8.1　開発環境の設定

XMAP3の開発環境を，メインフレーム用とPCで分散して処理するための画面・帳票を定義する環境に設定します。開発環境のセットアップについては，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

次に示すターゲット環境の設定は，必ず実行してください。

＜この節の構成＞

(1)　ターゲット環境の設定

(2)　動的変更テーブルの更新

(1)　ターゲット環境の設定

XMAP3のドローセットアップを起動させます。セットアップダイアログの［運用管理者用の設定］ボタンを選択して，運用管理者用の設定を活性状態にしてください。

セットアップダイアログの［ターゲットの設定...］ボタンをクリックしてください。ターゲット環境の設定ダイアログが表示されます。

「メインフレーム-PC分散用の画面・帳票開発」を選択して［OK］ボタンをクリックしてください。メインフレームとPCで処理を分散するためのマップを生成する開発環境になります。

注意

ドローセットアップを起動しているときは，XMAP3のほかの機能を起動させないでください。

(2)　動的変更テーブルの更新

Windows／UNIXとメインフレームではデータ有無コードに違いがあるので，ターゲット環境を変更すると，動的変更テーブルの更新が必要になることがあります。また，ドローセットアップで修飾名を変更した場合も，動的変更テーブルが更新されます。

この場合，ドローセットアップで設定を保存するときにX3MODTBLの更新ダイアログが表示されます。

ファイル名や出力先を変更する場合は，［参照...］ボタンをクリックして指定してください。

［OK］ボタンをクリックすると，動的変更テーブルにデータ有無コードが書き込まれます。上書きする場合は，日付確認のメッセージが表示されます。［OK］ボタンをクリックすると，新しい動的変更テーブルが生成され，上書き前の動的変更テーブルはX3MODBAK.CBL，X3MODBAK.Hとして保存されます。

なお，「X3MODTBL.H」はC言語用の動的変更テーブルです。メインフレーム－PC分散用のマップを生成する場合は使用しません。

更新後の動的変更テーブルの先頭部分は次のようになります。

ドローセットアップでのターゲット環境とデータ有無コードの関係を次の表に示します。

表8-1　ターゲット環境の設定とデータ有無コードの関係

ターゲット環境の設定 | データ有無コード
VOS3用の画面・帳票開発 | X'3F'
VOS1用の画面・帳票開発 | X'3F'
VOSK用の画面・帳票開発 | X'3F'
メインフレーム－PC分散用の画面・帳票開発 | X'3F'
AIX（文字コード：シフトJIS）用の画面・帳票開発 | X"1F"
AIX（文字コード：EUC）用の画面・帳票開発 | X"1F"
HP-UX（文字コード：シフトJIS）用の画面・帳票開発 | X"1F"
Solaris（文字コード：シフトJIS）用の画面・帳票開発 | X"1F"
Solaris（文字コード：EUC）用の画面・帳票開発 | X"1F"
Linux（文字コード：EUC）用の画面・帳票開発 | X"1F"
Windows用の画面・帳票開発 | X"1F"

アプリケーションでほかの値のデータ有無コードを使用する場合は，動的変更テーブルを修正してください。

8.2　実行環境の設定

実行環境の設定のうち，注意が必要なものについて説明します。設定については，次のマニュアルを参照してください。

マニュアル「XMAP3 開発・実行ガイド」

マニュアル「CommuniNet（Windows NT，Windows 95用）」またはマニュアル「CommuniNet Version 3（Windows NT，Windows 95用）」

＜この節の構成＞

8.2.1　DCCM3やGCASTの設定

8.2.2　仮想端末名称の設定

8.2.3　TCP/IPの設定

8.2.4　CommuniNetの設定

8.2.5　マップパスの設定

8.2.6　プリンタの設定

8.2.7　外字の設定

8.2.1　DCCM3やGCASTの設定

メインフレームとPCとのやり取りには，DCCM3の拡張ホストアクセス機能，またはBCF/GCASTを使用します。

DCCM3の拡張ホストアクセス機能については，マニュアル「データコミュニケーションマネジメントシステム DCCM3 解説」を参照してください。

また，BCF/GCASTを使用する場合，マニュアル「GUIシステム構築支援 BCF/GCAST」を参照してください。

8.2.2　仮想端末名称の設定

XMAP3の仮想端末名称の設定には，表示・印刷セットアップまたはC/Sセットアップを使用します。詳細については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

DCCM3を利用する場合，DCCM3の仮想端末名称とXMAP3の仮想端末名称はそれぞれ異なる名称を指定できます。

メインフレームからデータを転送するとき，通信論理マップに指定する仮想端末名称には，XMAP3で定義した名称を指定してください。

図8-1　APと仮想端末名称の関係

また，BCF/GCASTを利用する場合，BCF/GCASTで定義するLN名とXMAP3で定義する仮想端末名称はそれぞれ異なる名称を指定できます。

8.2.3　TCP/IPの設定

コントロールパネルの「ネットワーク」で，「ネットワークの設定」タブの「TCP/IP」を選択し，［プロパティ］ボタンをクリックしてIPアドレスを設定してください。ゲートウェイを使用する場合は，ゲートウェイアドレスも設定します。

8.2.4　CommuniNetの設定

環境設定ユティリティを起動して，メニューの「オプション」から「通信情報」を選択します。項目設定欄の［通信情報］を選択して，以下の情報を設定してください。

接続するメインフレームのサーバ名称，またはIPアドレス

メインフレーム名称

AP識別子

また，CommuniNetの端末名称とXMAP3の仮想端末名称は，それぞれ異なる名称を指定できます。画面管理プログラムのサンプルを使用する場合は，CommuniNetの端末名称を「オンライン端末」にしてください。

8.2.5　マップパスの設定

表示・印刷セットアップを起動して，「アプリケーション1」タブを選びます。「マップ」に物理マップを格納したフォルダを設定してください。

8.2.6　プリンタの設定

プリンタの設定については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。なお，帳票印刷ができるのは，メインフレームの通信制御にDCCM3を使用している場合だけです。

＜この項の構成＞

(1)　プリンタのリカバリ

(2)　印刷性能を向上させるためのXMAP3の設定

(1)　プリンタのリカバリ

プリンタ出力は，スプールに蓄積されるようになっています。そのため，印刷時にエラーが起きてもメインフレームには伝えられません。

また，Windows NT，Windows 2000，Windows XP，およびWindows Server 2003では，PDLスルー印刷の場合には拡張プリンタマネージャ，GDI印刷の場合にはJP1/NPSを使用してプリンタのリカバリができます。

(2)　印刷性能を向上させるためのXMAP3の設定

印字に時間が掛かるなど，プリンタの印刷性能が問題となる場合は，表示・印刷セットアップの「プリンタ」タブで，スプール書き出し単位を「アプリケーション毎」に設定してください。表示・印刷セットアップについては，マニュアル「XMAP3 開発・実行ガイド」を参照してください。メインフレーム側のAPから帳票の出力命令が出された時点では印刷しないで，PC側でクローズ命令を受信してから印刷するようになるので，APの処理速度を向上できます。

8.2.7　外字の設定

＜この項の構成＞

(1)　既存の外字の割り当てを使用する場合

(2)　外字マッピングファイルをカスタマイズする場合

(3)　XMAP3外字機能を使用する場合

(1)　既存の外字の割り当てを使用する場合

(a)　概要

PCのシフトJISとメインフレームのKEISとでは，外字コードはそれぞれ異なる領域に割り当てられています。メインフレームとPCとでデータをやり取りするとき，外字コードはXMAP3がそれぞれ対応するコードに置き換えます。シフトJISとKEISとの，外字に使う文字コードの対応については，「付録B.3　外字用コードの割り当て」を参照してください。

(b)　必要な作業

Windowsに付属の外字エディタなどを使用して，外字を定義してください。定義した外字は，実行環境に配布してください。

(2)　外字マッピングファイルをカスタマイズする場合

(a)　概要

PCのシフトJISとメインフレームのKEISとの変換はXMAP3が行います。外字部分のコード変換について，シフトJISとKEISの対応を変更したい場合は，コード変換SDK，または日立コード変換 - Development Kitを使用して外字マッピングファイルをカスタマイズしてください。

実行環境には，コード変換ランタイム，日立コード変換 - Client Runtime，または日立コード変換 - Server Runtimeをインストールしてください。また，カスタマイズされた外字マッピングファイルを実行環境に配布してください。これで，メインフレームとPCとの間でやり取りされるデータとして，KEISコードで(81A1)₁₆～(94FE)₁₆の範囲以外の外字を使用できます。

(b)　必要な作業

外字マッピングファイルのカスタマイズに必要な作業について説明します。

外字の作成
Windowsに付属の外字エディタを使用して，外字を定義してください。定義した外字は，実行環境に配布してください。

シフトJISとKEISの対応を定義する
開発環境で，コード変換SDK，または日立コード変換 - Development Kitを使用して，外字マッピングファイル（GJISKEI.TBL）をカスタマイズします。
コード変換SDKを使用する場合
コード変換SDKのコードマッピングユティリティを使用して，外字マッピングファイル（GJISKEI.TBL）をカスタマイズします。
コードマッピングユティリティの操作方法については，マニュアル「コード変換ユーザーズガイド」を参照してください。
日立コード変換 - Development Kitを使用する場合
日立コード変換 - Development Kitのコードマッピングユティリティ，またはコマンドユティリティを使用して，外字マッピングファイル（GJISKEI.TBL）をカスタマイズします。
コードマッピングユティリティ，およびコマンドユティリティの操作方法については，マニュアル「日立コード変換ユーザーズガイド」を参照してください。

外字マッピングファイルの配布
実行環境に外字マッピングファイルを配布します。
コード変換SDKを使用する場合
2.でカスタマイズした外字マッピングファイル（GJISKEI.TBL）を，「コード変換ランタイムインストールフォルダ¥TABLE」の下にコピーしてください。コード変換ランタイムがインストールされている場合，XMAP3では配布された外字マッピングファイルに従って外字コードを変換します。
日立コード変換 - Development Kitを使用する場合
2.でカスタマイズした外字マッピングファイル（GJISKEI.TBL）を，「日立コード変換 - Client Runtimeインストールフォルダ¥TABLE」，または「日立コード変換 - Server Runtimeインストールフォルダ¥TABLE」の下にコピーしてください。日立コード変換 - Client Runtime，または日立コード変換 - Server Runtimeがインストールされている場合，XMAP3では配布された外字マッピングファイルに従って外字コードを変換します。

(3)　XMAP3外字機能を使用する場合

(a)　概要

シフトJISで使用できる外字は1,880字までですが，画面・帳票に出力する文字コードにUnicodeを使用することで，メインフレームとPCとの間でやり取りするデータとして，6,400字までのUnicodeの外字を使用できます。ただし，画面・帳票への出力にUnicodeを使用できるのは，OSがWindows NT，Windows 2000，Windows XP，またはWindows Server 2003の場合だけです。

メインフレームから受信した，KEISの外字コードは，XMAP3からコード変換ランタイム，コード変換SDK，日立コード変換 - Client Runtime，または日立コード変換 - Server Runtimeを使ってUnicodeに変換します。Unicodeを画面に表示，または帳票に出力するときは，KanjiLink XKPを経由します。

実行時の，メインフレームとPCの間でやり取りされるデータおよび表示・印刷されるデータの文字コードの遷移について，また開発時に準備が必要なファイルについて，次の図に示します。なお，画面プログラムおよびメインフレームのAPについては，特別な処理は必要ありません。

図8-2　文字コードの遷移

また，必要な作業について次に説明します。

(b)　必要な作業

外字の用意
開発環境，実行環境のそれぞれに，使用する外字のフォントを用意してください。発注・購入しない場合は，市販のアウトラインフォントエディタを使用して，外字を作成してください。なお，必ずTrueTypeフォントを用意してください。
KEIS'83拡張文字セット3を使用する場合，次のフォントを使用できます。

メーカ固有漢字セット（日立KEIS83拡張3）

文字情報を記述したファイルの作成
開発環境で，KanjiLink XKPに登録する文字情報を記述したファイルを作成してください。作成したファイルは，実行環境に配布してください。

外字セットの作成とUnicodeの割り当て
実行環境で，KanjiLink XKPの管理ツールを使用して，2.で作成したファイルから外字セットを作成してください。また，外字セットをUnicodeのどの領域に割り当てるかを決定してください。

UnicodeとKEISの対応を割り当てる
コード変換SDK，コード変換ランタイム，日立コード変換 - Client Runtime，または日立コード変換 - Server Runtimeをインストールした状態では，標準値の外字マッピングファイルを使用します。UnicodeとKEISの，外字に使う文字コードの対応については，「付録B.3　外字用コードの割り当て」を参照してください。
UnicodeとKEISの対応をカスタマイズする場合は，開発環境でコード変換SDK，または日立コード変換 - Development Kitのコードマッピングユティリティを使用して，外字マッピングファイル（GUNIKEI.TBL）をカスタマイズしてください。
コード変換SDKを使用する場合
カスタマイズした外字マッピングファイルは，実行環境の「コード変換ランタイムインストールフォルダ¥TABLE」の下にコピーしてください。
コードマッピングユティリティの操作方法については，マニュアル「コード変換ユーザーズガイド」を参照してください。
日立コード変換 - Development Kitを使用する場合
カスタマイズした外字マッピングファイルは，実行環境の「日立コード変換 - Client Runtimeインストールフォルダ¥TABLE」，または「日立コード変換 - Server Runtimeインストールフォルダ¥TABLE」の下にコピーしてください。
コードマッピングユティリティの操作方法については，マニュアル「日立コード変換ユーザーズガイド」を参照してください。

なお，画面で外字を入力する場合は，実行環境にVJE-Delta for Unicode/XKPをインストールしてください。

(c)　制限事項

次に示す機能については，Unicodeの外字は使用できません。

固定項目でのUnicode外字の使用

タイトルバーおよびメニューバーでのUnicode外字表示

PDLスルー印刷モードのうち，LIPS II+でのUnicode外字出力

Windowsのプリンタマネージャにスプールする文書名でのUnicode外字の使用

印刷ダイアログでのUnicode外字表示

9.　VOS1-PC分散システムのAP開発から運用まで

この章では，VOS1とPCに処理を分散するシステムでの，マップの定義から運用までの手順について説明します。

＜この章の構成＞

9.1　画面・マップ帳票定義前の準備

9.2　画面・マップ帳票の定義

9.3　マップ生成とファイル転送

9.4　APの作成と実行

9.5　画面・帳票作成時のメッセージ

9.1　画面・マップ帳票定義前の準備

＜この節の構成＞

9.1.1　フォルダを作成する

9.1.2　定義環境の設定

9.1.1　フォルダを作成する

画面・マップ帳票の定義後に生成するマップを格納するためのフォルダが必要です。XMAP3インストール時には，XMAP3インストールフォルダに「¥USER¥MAPS」のフォルダが作成されます。これとは別のフォルダに格納したい場合，フォルダの名称や場所は任意に設定してください。

生成したファイルは，XMAP3インストールフォルダ以外のフォルダで管理することをお勧めします。なお，XMAP3インストールフォルダ¥TEMPの下に格納すると，正常に動作しませんので注意してください。

また，マップファイルを格納するフォルダにロングパス名を使用している場合，IFITによるマップファイルの転送ができないことがあります。フォルダ名にはロングパス名を使用しないことをお勧めします。

9.1.2　定義環境の設定

XMAP3のセットアップ機能を用いて，画面・帳票定義の環境を設定します。

環境設定については，「8. VOS1-PC分散システムの環境設定」を参照してください。

9.2　画面・マップ帳票の定義

画面・マップ帳票は，XMAP3のドローで定義します。定義環境については，マニュアル「XMAP3 プログラミングガイド 画面編」およびマニュアル「XMAP3 プログラミングガイド 帳票編」を参照してください。

また，インポート機能を利用して，メインフレームでのマップ定義をPC用のマップ定義に変換できます。インポート機能については，「17. メインフレームの画面・帳票をPCへ移行する」を参照してください。ただし，一部の機能については変換に制限があります。メインフレームのXMAPとPCのXMAP3の機能差については，「付録B　メインフレームとの処理分散」を参照してください。

なお，XMAP3外字機能で1,880字を超える外字を使用する場合でも，ドローで使用できる外字は，シフトJISコードで使用できる1,880字だけです。つまり，固定テキストなどの項目に，標準以外の外字を表示させることはできません。

＜この節の構成＞

9.2.1　トランザクションコードを設定する

9.2.2　「日本語」項目の定義

9.2.3　下位項目の定義

9.2.4　EAGLE2・KCORALのプログラムを利用する

9.2.5　SEWB3の画面・帳票定義を利用する

9.2.1　トランザクションコードを設定する

画面を定義するときに，DCCM3などで使用するトランザクションコードを定義するためには，隠しフィールドを定義してください。

ただし，XMAP3のドローで定義できる隠しフィールドの大きさは，入力論理マップの先頭8バイト分までです。

9.2.2　「日本語」項目の定義

使用目的を「日本語」，データ型を「文字」と設定した場合，生成される論理項目のデータ長は，メインフレームで利用するコードを意識して，通常は「物理長の約3倍」の長さになります。

論理項目のデータ長を，アプリケーションで利用する文字列（物理長の3倍以下の長さ）に合わせて調整できます。ドローのダイアログで「データ長を変更する」ボタンをオンにして，調整します。

9.2.3　下位項目の定義

使用目的を「日本語」，データ型を「文字」と設定したフィールドで，下位項目を使用する場合，ドローのダイアログにで「データ長を変更する」ボタンをオンにしてください。「データ長を変更する」ボタンがオフの場合，下位項目を定義しても，生成された論理マップには反映されません。

なお，使用目的を「日本語」，データ型を「文字」に設定するのは，パネル定義文のLOGFLD文でCODEオペランドにN（混在），LNGオペランドのピクチャにCを指定した場合に相当します。

9.2.4　EAGLE2・KCORALのプログラムを利用する

EAGLE2およびKCORALの画面・帳票をXMAP3に移行する場合に，注意が必要な点を説明します。

EAGLE2およびKCORALで生成されるメインフレームのXMAP2 E2のマップ定義文は，XMAP3には流用できません。XMAP3で画面・マップ帳票を作り直してください。

プログラムだけを流用し，画面・マップ帳票をXMAP3で作り直す場合は，次に説明する点を変更してください。

論理マップの形式

論理マップの形式は，ターゲット「Windows用の画面・帳票開発」のビックエンディアンと同じになります。詳細については，マニュアル「XMAP3 プログラミングガイド 画面編」，マニュアル「XMAP3 プログラミングガイド 帳票編」を参照してください。

論理マップの項目名

XMAP3では，論理マップの項目名は，次のような形式になります。

入力項目

マップ名-項目の名称I

出力項目

マップ名-項目の名称O

したがって，XMAP3で生成した論理マップの項目名を，元のソースに合わせて修正してください。

また，KCORALは拡張ホストアクセス機能に対応していないので，KCORALのソースを修正してメインフレーム-PC分散処理に使用することはできません。KCORALでCOBOLのソースを生成し，生成されたソースを修正してから利用してください。

混在項目の論理長

混在項目の論理長は，メインフレームとPCとの文字コードが異なるので，XMAP3の自動調整を利用する場合は，次の式で計算してください。

論理長＝桁（項目長）×7÷3＋3

ただし，ドローのダイアログで「データ長を変更する」ボタンをオンにしている場合は，ダイアログで指定したデータ長となります。

EAGLE2およびKCORALについては，次のマニュアルを参照してください。

EAGLE2：

マニュアル「EAGLE2」

KCORAL：

マニュアル「漢字CORAL KCORAL 操作」

マニュアル「漢字CORAL KCORAL 文法」

9.2.5　SEWB3の画面・帳票定義を利用する

既存のSEWB3の画面・帳票シートを流用してメインフレームとPCで処理を分散するためのマップを作成したい場合，PCのXMAP3でインポート機能を利用します。

この場合，SEWB3で画面・帳票シートからパネル定義文を生成し，そのパネル定義文をインポート機能でXMAP3のマップ定義に変換します。インポート機能については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

また，SEWB3で生成したパネル定義文からメインフレームとPCで処理を分散するためのマップを生成する場合，メインフレームとPCとの文字コードが異なるため注意が必要です。文字コードの差異に伴なう，メインフレーム上での論理長は，XMAP3の自動調整を利用する場合，次の計算式によって算出できます。

論理長＝桁（項目長）×7÷3＋3

ただし，インポート後に，ドローのダイアログで「データ長を変更する」ボタンをオンにすると，論理長を自由に変更できます。

9.3　マップ生成とファイル転送

＜この節の構成＞

9.3.1　マップを生成する

9.3.2　マップファイルの転送

9.3.1　マップを生成する

ドローが作成するマップファイルは，そのまま分散処理に利用できますが，複数の画面・帳票のマップ生成を一括して実行したい場合はユティリティのマップ生成機能を利用します。

ユティリティメインダイアログで「マップ生成」を選択し，［実行］ボタンをクリックします。

マップ生成ダイアログが表示されます。

「ファイルの選択」の［参照...］ボタンをクリックします。
ファイルの選択ダイアログが表示されます。入力となるファイルの種類と，マップ生成したいファイルのファイル名を選択し，［開く］ボタンをクリックします。選択したファイルが，選択状態でリストボックスに表示されます。なお，リスト中のファイルの選択状態を解除すると，マップ生成の対象外にできます。

マップ生成ダイアログに「ファイルの出力先」を指定します。
次に示すファイルの出力先を指定します。
・物理マップ出力先
・論理マップ出力先
・結果リストファイル出力先
すべてのファイルの出力先を同じにする場合は，「全ての出力先」をチェックしてください。
各種ファイルの出力先などを変更する場合は，「ファイルの出力先」の［参照...］ボタンをクリックして設定してください。

各種オプションを設定する場合は，［環境設定...］ボタンをクリックします。
環境設定ダイアログが表示されます。環境設定については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。
必要な項目を設定して［OK］ボタンをクリックすると，マップ生成ダイアログに戻ります。

［生成］ボタンをクリックします。
マップ生成機能が実行されます。実行後，マップ生成ダイアログに戻ります。生成されるファイルを次に示します。
・入力論理マップ（xxxI.CBL）
・出力論理マップ（xxxO.CBL）
・物理マップ（xxx.PMP）
また，ユティリティのマップ生成機能で，マップ生成ができなかった場合，XMAP3は生成結果エラーファイル（.ERR）にエラーメッセージを出力します。エラーメッセージの内容から問題の原因を推定し，誤りを訂正してください。各種エラーメッセージに対する誤りの訂正方法については，「9.5　画面・帳票作成時のメッセージ」を参照してください。

マップ生成によって出力された結果リストファイルを表示したい場合には，［エディタ起動...］ボタンをクリックします。
エディタが起動されます。このとき使用するエディタを変更したい場合は，［環境設定...］ボタンをクリックして，環境設定ダイアログで設定してください。

注意事項

マップ生成の結果リストは，起動ごとに同じファイル名になるので，結果を別ファイルとして保存したい場合は，結果リストの表示時に別名で保存してください。

9.3.2　マップファイルの転送

XMAP3で作成したマップのうち，入力論理マップと出力論理マップをメインフレームに転送します。さらに，XMAP3で提供されているメッセージテーブルもメインフレームに転送します。メッセージテーブルは，「XMAP3インストールフォルダ¥INCLUDE」のフォルダに，次の二つが提供されています。VOS1の通信制御に応じて，どちらかを使用してください。

X3TRNTBL：VOS1でDCCM3を使用する場合

X3HOSTBL：VOS1でBCF/GCASTを使用する場合

なお，メインフレーム上のAPで動的変更を利用する場合は，ドローセットアップで生成された動的変更テーブル（X3MODTBL.CBL）もメインフレームに転送してください。

マップを転送するには，PCからCommuniNetを起動してメインフレームに接続し，IFITを使用します。IFITについては，マニュアル「ワークステーション操作 －パネル編－」，またはマニュアル「ワークステーション操作 －コマンド編－」を参照してください。

(a)　メインフレーム上の出力ファイルの属性

メインフレーム上に出力するファイルは次に示す属性にしてください。

レコード形式は固定長

レコード長は80バイト

データコードはDATA

(b)　CommuniNetの環境を設定する

CommuniNetの環境設定ユティリティを起動します。「端末名称」は転送するファイルの置かれている端末を選択して，「設定項目」の「ファイル転送」をダブルクリックします。ファイル転送の設定ダイアログが表示されるので，「コード変換」を「あり」にして，［OK］ボタンをクリックします。

(c)　IFITのメニュー画面を使用して転送する場合

IFITのメニュー画面を使用して転送する手順を次に示します。

ファイル伝送機能の呼び出し

マスタメニューの項目5「OA業務実行」を選択します。

OA業務実行メニューの項目5「パソコンファイル伝送」を選択します。

対話型ファイル伝送メニューの項目1「LIMEファイルのファイル伝送」を選択します。

転送するファイルの設定
「ホスト側ファイル情報」の項に，メインフレーム上に出力するファイル名などを指定します。このとき，PC上のファイルに付いていた拡張子は付けないでください。なお，レコード形式は「1:F」を選択し，レコード長は80バイトにしてください。「ワークステーション側ファイル情報」の項に，PCから転送するファイル名を完全なパス名で指定してください。

(d)　@@IFITコマンドを使用して転送する場合

@@IFITコマンドを使用した転送の形式は，次のとおりです。

コマンド
オペランド

@@IFIT
△FTYPE=LIME
,WSF='PCから転送するファイル名'
,RL=80
,TRN=WH
,FILE=メインフレーム上に出力するLIMEファイル名
,LIBRARY=メインフレーム上に出力するLIMEライブラリ名
,DC=DATA
,MEMBER=メインフレーム上に出力するメンバ名

9.4　APの作成と実行

＜この節の構成＞

9.4.1　APの作成

9.4.2　AP実行時のVOS1側の動作

9.4.3　AP実行時のPC側の動作（DCCM3を使用する場合）

9.4.4　AP実行時のPC側の動作（BCF/GCASTを使用する場合）

9.4.5　JP1/NETM/DMを利用したマップの配布

9.4.6　AP実行時の外字の扱い

9.4.1　APの作成

メインフレーム上のAPには，PCから転送した入力論理マップ，出力論理マップ，およびメッセージテーブルを取り込んでください。

また，メインフレーム上のAPで動的変更を行う場合は，さらに動的変更テーブル（X3MODTBL.CBL）も取り込んでください。なお，メインフレーム側に転送する場合は論理マップと同じ形式で転送してください。動的変更テーブルを更新した場合は，再度取り込む必要があります。動的変更テーブルが更新されるケースについては，「8.1　開発環境の設定」を参照してください。

分散システム用のAPを作成するときの注意事項については，「10. VOS1でのAP作成と実行」を参照してください。

9.4.2　AP実行時のVOS1側の動作

メインフレーム上のAPから，PC上の画面・マップ帳票入出力処理に論理マップのデータを転送するときは，拡張ホストアクセス機能を使用します。なお，VOS1側から転送される論理マップのデータは，EBCDIK/KEISのコードのまま利用できます。

9.4.3　AP実行時のPC側の動作（DCCM3を使用する場合）

メインフレームからの要求で画面管理プログラムが起動し，画面管理プログラムがXMAP3を呼び出します。XMAP3は，物理マップおよび論理マップを基にして，画面・マップ帳票への入出力を行います。

XMAP3では，PC上の画面管理プログラムのサンプルが，「XMAP3インストールフォルダ¥SAMPLES¥C」のフォルダに，ソースプログラムの形で添付されています。

画面管理プログラムは，必要に応じてカスタマイズして利用してください。標準のままで利用する場合は，変更する必要はありませんが，コンパイルは必要になります。

標準の画面管理プログラムにカスタマイズが必要となる場合の例を次に示します。カスタマイズすることで，GUI画面をより使いやすいものにできます。

（例）

メニュー画面を，メインフレーム側のAPを使用しないで出したい場合

ヘルプをメインフレーム側のAPを使用しないで出したい場合

サンプルプログラム，変更の方法，およびコンパイルの方法については，「11. PCでの画面管理プログラムの利用と作成」を参照してください。

9.4.4　AP実行時のPC側の動作（BCF/GCASTを使用する場合）

メインフレームからの要求は，PC上のGCASTを経由してXMAP3に送られます。XMAP3は，物理マップおよび論理マップを基にして，画面への入出力を行います。

9.4.5　JP1/NETM/DMを利用したマップの配布

端末の台数が多い場合，または頻繁にマップが変更される場合，すべての端末にマップを配布する作業は煩雑になります。

そこで，マップの配布にJP1/NETM/DMを利用できます。JP1/NETM/DMの資源配布機能を利用すると，メインフレームからマップを一元管理し，それぞれの端末にマップを自動的に配布できます。運用形態に応じて，すべての端末のマップを一斉に更新したり，各端末の起動時または終了時にマップを更新したりすることもできます。マップのバージョンによる差分管理もできます。

JP1/NETM/DMの利用方法については，マニュアル「JP1/NETM/DM システム運用」またはマニュアル「JP1/NETM/DM 運用ガイド」を参照してください。

9.4.6　AP実行時の外字の扱い

メインフレームとPCとでは文字コードが異なるため，メインフレームとPCの間でやり取りされるデータの文字コードは，XMAP3で変換します。文字コードの変換については，「付録B.2　文字コードの違い」を参照してください。ただし，データに含まれる外字については，外字の運用形態によって文字コードの変換方法が異なります。

＜この項の構成＞

(1)　標準の外字用コードの対応に従う場合

(2)　シフトJISとKEISの外字マッピングテーブルをカスタマイズした場合

(3)　XMAP3外字機能を使用する場合

(1)　標準の外字用コードの対応に従う場合

XMAP3でKEISとシフトJISの外字コードを変換します。外字コードの対応については，「付録B.3　外字用コードの割り当て」を参照してください。

(2)　シフトJISとKEISの外字マッピングテーブルをカスタマイズした場合

コード変換ランタイム，日立コード変換 - Client Runtime，または日立コード変換 - Server Runtimeがインストールされている場合，XMAP3では外字マッピングテーブルに基づいて外字の文字コードを変換します。外字マッピングテーブルは「コード変換ランタイムのインストールフォルダ¥TABLE」，「日立コード変換 - Client Runtimeのインストールフォルダ¥TABLE」，または「日立コード変換 - Server Runtimeのインストールフォルダ¥TABLE」に「GJISKEI.TBL」という名前でコピーしておいてください。

(3)　XMAP3外字機能を使用する場合

コード変換ランタイムがインストールされている場合，XMAP3では外字マッピングテーブルに基づいて外字の文字コードを変換します。

また，XMAP3外字機能を使用する場合，文字コードにはUnicodeを使用します。PC上でUnicodeの外字を入力するためには，VJE-Delta for Unicode/XKPを使用してください。ただし，内字の入力はほかの日本語入力システムでもできます。

UnicodeとKEISの外字マッピングテーブルをカスタマイズしている場合は，「コード変換ランタイムのインストールフォルダ¥TABLE」に外字マッピングテーブル「GUNIKEI.TBL」をコピーしておいてください。

9.5　画面・帳票作成時のメッセージ

画面・帳票の作成時，ドローやユティリティでマップを生成するときに，次に示す定義がある場合，エラーメッセージを出力します。

マップの生成時にオブジェクトを破棄，または設定内容を変更しているもの。

エラーが発生した場合でも，パネル定義文は出力されます。

＜この節の構成＞

(1)　エラーファイルの形式

(2)　出力するメッセージの詳細

(3)　メッセージの詳細

(1)　エラーファイルの形式

エラーファイルのファイル名は，「マップ定義ファイル名.ERR」です。エラーファイルは，マップファイルの出力先に出力されます。

(2)　出力するメッセージの詳細

出力するメッセージの形式を次に示します。

［メッセージID］

［位置情報］［メッセージテキスト］

(a)　メッセージID：X3EHnnn-y

X3EH

パネル定義文生成時のメッセージであることを示します。

nnn

メッセージ通番を示します。

y

メッセージの種類を示します。出力されるメッセージの種類を次に示します。

I：警告メッセージ
マップの生成時にオブジェクトを破棄，または設定内容を変更しているもの。

(b)　位置情報

メッセージ出力対象のオブジェクトのドロー上の定義位置を示します。なお，レイアウト全体に関するメッセージなど，位置情報を持たない場合は出力しません。

出力例を次に示します（xxxxxは5けたの数字を示します）。

フレーム外の場合
［縦xxxxxます，横xxxxxます］

フレーム内の場合
フレーム名［縦xxxxxます，横xxxxxます］

(c)　メッセージテキストの詳細

メッセージテキストについて説明します。

（S）エクスポートの処理
メッセージを出力したあとの主な処理を示します。

（P）プログラマの処置
メッセージを受け取ったプログラマが取るべき処置を示します。

(3)　メッセージの詳細

個々のメッセージについて説明します。なお，ここで記述しているのは画面・帳票作成時に出力されるメッセージだけです。XMAP3全体に共通のメッセージについては，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

X3EH205-I

［位置情報］　｛予約フィールド｜予約テキスト｜入出力フィールドの下位項目｜入力フィールドの下位項目｜出力フィールドの下位項目｜入出力テキストの下位項目｜入力テキストの下位項目｜出力テキストの下位項目｝を破棄しました

予約フィールドまたは予約テキストを指定している。

使用目的が日本語で，さらにデータ型として「文字（XX）」を指定した入力／出力／入出力フィールドまたはテキストに，下位項目を指定している。

（S）指定されたオブジェクトを破棄して，マップを生成します。

（P）該当するオブジェクトを指定しないでマップ定義ファイルを再作成したあと，画面・帳票定義の保存を再実行してください。

X3EH207-I

画面属性の次画面指定を破棄しました

GUI画面，またはCUI画面の画面属性で次画面を指定している。

（S）指定された画面属性を破棄して，マップを生成します。

（P）該当する画面属性を指定しないマップ定義ファイルを再作成したあと，画面・帳票定義の保存を再実行してください。

10.　VOS1でのAP作成と実行

この章では，VOS1とPCの分散処理の仕組みについて，またAP作成の注意事項について説明します。VOS1上でAPを作成するときの参考にしてください。

＜この章の構成＞

10.1　分散処理の仕組み

10.2　VOS1側のインタフェース

10.3　PC側のインタフェース

10.4　AP作成時の注意事項

10.1　分散処理の仕組み

メインフレームとPCに処理を分散する場合，メインフレームのAPは，DCCM3などでPCと通信して，PCの画面・帳票の入出力を実行します。しかし，PC側のXMAP3には，DCCM3などと直接通信する機能はありません。そこで，メインフレームとの通信を行い，XMAP3を使用してPCの画面・帳票の入出力を処理する画面管理プログラム（ミドルプログラム）の作成が必要になります。なお，画面管理プログラムのソースを，サンプルとして提供しています。詳細は，「11. PCでの画面管理プログラムの利用と作成」を参照してください。

ただし，メインフレームとPCとの通信にBCF/GCASTを使用する場合は，画面管理プログラムの代わりに，GCASTを使用します。

図10-1　メインフレームとPCの分散処理の仕組み

画面管理プログラムを使用する場合
メインフレームのAPは，画面管理プログラムと通信して，PCの画面・帳票の入出力を画面管理プログラムに命令します。画面管理プログラムは，メインフレームのAPの命令に応じて，XMAP3に要求を発行して画面・帳票の入出力を実行します。
画面管理プログラムでは，メインフレームとPCのデータの送受信に，拡張ホストアクセス機能を使用します。なお，「命令」はメインフレームとPCの間の送受信命令を，「要求」はPC上の画面管理プログラムがXMAP3に対して行う制御を指しています。
メインフレームとPCとのデータの送受信には，DCCM3の拡張ホストアクセス機能を使用します。拡張ホストアクセス機能はMPPのAPで使用できます。
拡張ホストアクセス機能を使用する場合は，転送する論理マップのデータの長さによって，APの作成方法が異なります。一度に転送したい論理マップのデータの長さが2,920を超える場合は，論理マップのデータを分割し，複数回の送信によってメインフレームへ転送することが必要です。
一度に転送したい論理マップのデータの長さが2,920バイト以下の場合については，「10.1.1　DCCM3での拡張ホストアクセス（論理マップ長≦2,920バイトの場合）」を参照してください。一度に転送したい論理マップのデータの長さが2,920を超える場合については，「10.1.2　DCCM3での拡張ホストアクセス（論理マップ長＞2,920バイトの場合）」を参照してください。

注意事項
メッセージ編集方法はXMAPモードを指定してください。

GCASTを使用する場合
メインフレームのAPは，PCのGCASTと通信して，画面の入出力を命令します。GCASTは，メインフレームのAPの命令に応じて，インタフェース機能を呼び出して画面の入出力を実行します。

また，VOS1とDCCM3を使用したメインフレーム上のAPの例を「付録B.4(1)　メインフレーム上のAPの例」に掲載しています。必要に応じて参照してください。

＜この節の構成＞

10.1.1　DCCM3での拡張ホストアクセス（論理マップ長≦2,920バイトの場合）

10.1.2　DCCM3での拡張ホストアクセス（論理マップ長＞2,920バイトの場合）

10.1.3　BCF/GCASTでの拡張ホストアクセス

10.1.1　DCCM3での拡張ホストアクセス（論理マップ長≦2,920バイトの場合）

DCCM3を使用したオンライン環境での拡張ホストアクセスによって，VOS1上のAPとPC上の画面管理プログラムが連携する仕組みを次の図に示します。

なお，PC側の画面管理プログラムとして，提供されているサンプル「ONLNPROC.C」，「ONLNPRC2.C」，「ONLNPRC2.CBL」を使用していることを前提とします。

図10-2　DCCM3環境でのAPと画面管理プログラムの連携

1 開始

PCでは，CommuniNet Extensionを使用して，トランザクションをメインフレームに送信します。詳細については，マニュアル「CommuniNet Extension（Windows NT，Windows 95用）」またはマニュアル「CommuniNet Extension Version 3」を参照してください。

メインフレームでは，トランザクションを受け取ったAPが起動します。

2 トランザクションの受信

メインフレームAPは，次のようにして，PCからのトランザクションを受信します。

RECEIVE 通信記述名 FIRST SEGMENT FROM メッセージエリア

メインフレームAPが受信するメッセージは次のような形式です。

3 メインフレームAPからのオープン命令

メインフレームAPは，PCから受信したメッセージに基づいて，仮想端末を起動するためのオープン命令を発行します。

マップ名称には'%MMC1R'を指定し，問い合わせ応答を受信するようにします。

ユーザデータに，要求種別（オープン命令はX'10'）など必要な情報を設定します。

次のようにして，オープン命令をPCに送信します。

SEND 通信記述名 FROM メッセージエリア WITH EMI.

メインフレームAPから送信するメッセージは次のような形式です。

4 PCのオープン命令受信

PCでは，メインフレームAPからのオープン命令によって，画面管理プログラムが起動します。

画面管理プログラムはメインフレームAPからのオープン命令を受信し，XMAP3にオープン要求を発行して仮想端末を開きます。

メインフレームAPは，仮想端末が起動されたら，画面管理プログラムからユーザデータを受信します。
メインフレームAPが受信するメッセージは次のような形式です。

5 メインフレームAPからの入出力命令

●画面入出力の場合

メインフレームAPは，「2 トランザクションの受信」に挙げたRECEIVE文でメッセージを受信して，オープン処理の完了を確認します。

メインフレームAPは，PCへ送信する出力論理マップを編集します。最初の入出力命令ならば，初期画面の出力論理マップを編集します。また，要求種別にX'12'を設定し，マップ名称に'%MMC1R'を設定します。

「3 メインフレームAPからのオープン命令」に挙げたSEND文でPCにメッセージを送信します。メインフレームAPから送信するメッセージは次のような形式です。

●帳票出力の場合

メインフレームAPは，「2 トランザクションの受信」に挙げたRECEIVE文でメッセージを受信して，オープン処理の完了を確認します。

PCへ送信する出力論理マップを編集します。また，要求種別にX'13'を設定し，マップ名称に'%MMC1R'を設定します。

「3 メインフレームAPからのオープン命令」に挙げたSEND文でPCにメッセージを送信します。メインフレームAPから送信するメッセージは次のような形式です。

6 PCでの入出力処理

●画面入出力の場合

画面管理プログラムがメインフレームからのメッセージを受信し，XMAP3への画面の入出力要求を発行します。

ユーザは，表示された画面でデータを編集します。
画面でデータを編集した場合，メインフレームAPは，XMAP3から入力されたユーザデータを，画面管理プログラムを経由して受信します。メインフレームAPが受信するメッセージは次のような形式です。

メインフレームAPは，RECEIVE文でメッセージを受信して，論理マップへ取り込みます。

●帳票出力の場合

画面管理プログラムがメインフレームからのメッセージを受信し，XMAP3に帳票の出力要求を発行し，プリンタに帳票を出力します。

メインフレームAPは，帳票出力が終了すると，ユーザデータを画面管理プログラムを経由して受信します。メインフレームAPが受信するメッセージは次のような形式です。

メインフレームでは，RECEIVE文でメッセージを受信して，論理マップへ取り込みます。

業務終了まで，「5 メインフレームAPからの入出力命令」および「6 PCでの入出力処理」を繰り返します。

PC側で業務の終了を選択すると，入力論理マップのINCが設定されます。このメッセージを受信したメインフレームでは，クローズ命令を発行して業務終了の処理を行います。

7 クローズ命令および終了命令

要求種別にX'11'を，マップ名称には'%MMC1R'を設定します。
PCにクローズ命令を送信します。メインフレームAPから送信されるメッセージは次のような形式です。

PCでは，クローズ命令を受信した画面管理プログラムからXMAP3にクローズ要求が発行され，仮想端末が閉じられます。

仮想端末が閉じられると，メインフレームAPは画面管理プログラムを経由して次のような形式のメッセージを受信します。

このメッセージを受信したメインフレームAPでは，要求種別にはX'1F'を，マップ名称には'%MMC1S'を設定して，終了命令を送信します。
メインフレームAPから送信されるメッセージは次のような形式です。

メインフレームAPは，終了命令を送信するとともに処理を終了します。

PCでは，終了命令を受信して，画面管理プログラムが処理を終了します。

メインフレームとPCの間でやり取りされる送受信メッセージについては，「10.2.1　DCCM3使用時のインタフェース」を参照してください。

APの命令については，VOS1のマニュアル「COBOL85 言語」およびマニュアル「データコミュニケーションマネジメントシステムDCCM3プログラミングの手引」を参照してください。

画面管理プログラムの，メインフレームと送受信を行う関数については，「10.3　PC側のインタフェース」および次のどちらかのマニュアルを参照してください。

マニュアル「CommuniNet Extension（Windows NT，Windows 95用）」

マニュアル「CommuniNet Extension Version 3」

画面管理プログラムからXMAP3に要求を伝える関数については，「10.3　PC側のインタフェース」を参照してください。

DCCM3のオンライン環境で，拡張ホストアクセス機能を利用して送受信メッセージの内容をメインフレームとPCとでやり取りするとき，SEND文で指定するマップ名称（MAP-NAME句）は'%MMC1R'を指定します。'%MMC1R'は画面の入出力命令など，PCとのデータ送受信する場合に指定してください。

なお，'%MMC1S'のマップ名称は指定できません。

ただし，XMAP3に添付されているサンプルの画面管理プログラムを使用するときは，帳票出力の場合でも，マップ名称には'%MMC1R'を指定してください。

10.1.2　DCCM3での拡張ホストアクセス（論理マップ長＞2,920バイトの場合）

CommuniNetでは，一度に転送できる送信データの最大長は3,000バイトとなっています。ただし，論理マップのデータ転送時には，トランザクションコードや通信論理マップなど80バイト分のデータが付加されるため，一度に転送できる実質的な論理マップのデータ長は2,920バイト以下となります。

2,920バイトを超える長さの論理マップデータを転送したい場合は2,920バイト以下のデータ長に分割し，複数回のデータ送信によって転送するようにしてください。

2,920バイトを超えるデータをやり取りする場合は，継続入力および継続出力の二つの命令を使用します。一回の継続入力命令または継続出力命令で，データが2,920バイトずつ転送されます。

なお，PC側の画面管理プログラムとして提供されている，サンプル「ONLNPRC2.C」，「ONLNPRC2.CBL」を使用していることが前提です。

また，通信制御にBCF/GCASTを使用する場合，継続入出力の処理はBCF/GCASTで処理されるので，2,920バイト以下のデータと同様にして処理できるので，特別な処理は必要ありません。

＜この項の構成＞

(1)　利用方法

(2)　論理マップの形式

(3)　メインフレーム用APのコーディング例

(1)　利用方法

DCCM3と継続出力命令を併用したオンライン環境での拡張ホストアクセスによって，メインフレームのAPとPCの画面管理プログラムが連携する仕組みを説明します。

(a)　メインフレームからデータを送信する場合

継続出力命令を利用して，メインフレームからPCにデータを送信する過程を次の図に示します。

図10-3　継続出力命令を利用したDCCM3環境でのAPと画面管理プログラムの連携（論理マップ長＞2,920バイトの場合）

メインフレーム上のAPは継続出力命令を繰り返し，論理マップのデータを2,920バイトずつPCに転送します。

送られたデータはPC上のバッファに格納されます。

すべてのデータを転送した後に，メインフレームから出力命令または入力命令を送信して，バッファ内のデータをXMAP3のマッピングライブラリに送ります。

なお，転送する論理マップは，1回目の送信と2回目およびそれ以降の送信とでは形式が異なります。詳細については「10.1.2(2)　論理マップの形式」を参照してください。

(b)　PCからのデータを受信する場合

継続入力命令を利用して，PCからのデータをメインフレームで受信する過程を次の図に示します。

図10-4　継続入力命令を利用したDCCM3環境でのAPと画面管理プログラムの連携（論理マップ長＞2,920バイトの場合）

メインフレーム上のAPが入出力命令を送り，PCからのデータを受信し始めます。

最初のデータが，継続入力命令によってPCからメインフレームに送られます。メインフレーム上のAPは，一時記憶領域にデータを格納します。

メインフレーム上のAPは，すべてのデータを受信するまで，繰り返し継続入力命令を送信します。データは一時記憶領域に格納されます。

PCからメインフレームへのデータの送信が終了したら，メインフレームのAPはクローズ命令を発行します。

なお，転送する論理マップは，1回目の送信と2回目およびそれ以降の送信とでは形式が異なります。詳細については「10.1.2(2)　論理マップの形式」を参照してください。

(c)　送信と受信を組み合わせる場合

まず，メインフレーム上のAPから画面管理プログラムに継続出力命令を繰り返し送信します。そして，最後に送信するデータは出力命令ではなく入出力命令で送信し，PCからのデータを受信します。

次に，メインフレーム上のAPは継続入力命令を繰り返します。すべてのデータの転送が終了したら，APからクローズ命令を送信します。

(2)　論理マップの形式

2,920バイトを超えるデータを分割して送受信する場合，1回目に送信するデータと2回目以降に送信するデータとでは形式が異なります。それぞれの論理マップの形式を次の図に示します。

図10-5　データ分割時の論理マップの形式

(3)　メインフレーム用APのコーディング例

(a)　CD句

継続問い合わせ処理の例を示します。

一時記憶受け渡しの例を示します。

(b)　実行部

10.1.3　BCF/GCASTでの拡張ホストアクセス

＜この項の構成＞

(1)　APとGCASTの連携

(2)　GCASTでの論理マップ長

(1)　APとGCASTの連携

BCF/GCASTのインタフェース機能を使用した対話環境での拡張ホストアクセスによって，VOS1上のAPとGCASTが連携する仕組みを次の図に示します。

図10-6　対話環境でのAPとGCASTの連携

JGUOPENモジュールの呼び出し

メインフレームAPからPCに対して，CALL文でJGUOPENモジュールを呼び出します。

PCでは，XMAP3の仮想端末が開かれます。

JGUTRANSモジュールの呼び出し

メインフレームAPは，JGUOPENモジュールを呼び出したあと，APからJGUTRANSモジュールを呼び出します。

JGUTRANSモジュールの呼び出しを受けて，PCでは，XMAP3で画面を入出力します。

XMAP3の仮想端末からGCASTを経由して，ユーザデータをメインフレームに送信します。

メインフレームAPでは，データを受信し，処理します。

業務終了まで，2.の各手順を繰り返します。

JGUCLOSEモジュールの呼び出し

画面の送受信がすべて終了したら，メインフレームAPから，JGUCLOSEモジュールを呼び出します。

PC上のGCASTでは，XMAP3の仮想端末を終了します。

BCF/GCASTのインタフェース機能については，マニュアル「GUIシステム構築支援 BCF/GCAST」を参照してください。

(2)　GCASTでの論理マップ長

画面の論理マップが2,930バイトより大きい場合，メインフレームAPからの1回の画面出力に対して，メインフレームとPCのGCAST間で2,930バイトごとに分割して複数回の通信が行われます。このため，画面表示の性能が低下することがあるので，1画面分の論理マップを2,930バイト以下にすることをお勧めします。

メインフレームAPがJGUTRANSモジュールを呼び出したあとに2,930バイトより大きい論理マップを送信した場合に，画面データが分割される仕組みを次の図に示します。

図10-7　画面データが分割される仕組み（画面データが4,500バイトの場合）

3,000バイト送信

メインフレームAPは，4,500バイトの画面データを送信します。

メインフレームのGCASTは，メインフレームAPが送信した4,500バイトの画面データを，一度に送信できるデータ量の3,000バイトと残りの1,500バイトに分割します。

メインフレームのGCASTは，PCのGCASTに対して，3,000バイトの画面データを送信します。

1,500バイト送信

メインフレームのGCASTは，PCのGCASTに対して，残りの1,500バイトの画面データを送信します。

PCは，メインフレームからすべての画面データを受信したあと画面を表示します。

3,000バイト返信

PCは，4,500バイトの画面データを返信します。

PCのGCASTは，PCが返信した4,500バイトの画面データを，一度に返信できるデータ量の3,000バイトと残りの1,500バイトに分割します。

PCのGCASTは，メインフレームのGCASTに対して，3,000バイトの画面データを返信します。

1,500バイト返信

PCのGCASTは，メインフレームのGCASTに対して，残りの1,500バイトの画面データを送信します。

メインフレームのGCASTは，メインフレームAPに対して4,500バイトの画面データを返信します。

10.2　VOS1側のインタフェース

＜この節の構成＞

10.2.1　DCCM3使用時のインタフェース

10.2.2　BCF/GCASTでのインタフェース

10.2.1　DCCM3使用時のインタフェース

＜この項の構成＞

(1)　論理マップの取り込み

(2)　メッセージテーブルの形式

(3)　通信論理マップとAPの連携

(1)　論理マップの取り込み

VOS1とPCに処理を分散する環境では，VOS1とPC間で論理マップのデータをやり取りします。このとき論理マップは，COPY文でVOS1のAPに取り込まれます。COPY文は，APのWORKING-STORAGE SECTIONまたはLINKAGE SECTIONに指定します。ただし，論理マップ中に定数を展開させている場合は，LINKAGE SECTIONには取り込めません。

（例）

(2)　メッセージテーブルの形式

分散処理をするため，メッセージテーブル，入力論理マップおよび出力論理マップをメインフレーム上のAPに取り込みます。入力または出力論理マップのデータ長が2,920バイト以下のときの通信論理マップは「XMAP3インストールフォルダ¥INCLUDE¥X3TRNTBL」です。また，入力または出力論理マップのデータ長が2,920バイトを超えるときの通信論理マップは「XMAP3インストールフォルダ¥INCLUDE¥X3TRNTB2」です。

通信論理マップの形式を表10-1および表10-2に示します。

表10-1　受信メッセージテーブルの形式

領域
エリア名称
長さ
（位置）
データ形式
データ内容

ヘッダ
XMAP-RECV-LL
2(0)
S9(4)COMP
受信テーブル長

XMAP-RECV-RR
2(2)
S9(4)COMP
予備

XMAP-RECV-TRNCD
8(4)
X(8)
トランザクションコード

XMAP-RECV-SPACE
1(12)
X
予備

XMAP-RECV-LL1
2(13)
S9(4)COMP
予備

XMAP-RECV-LL2
2(15)
S9(4)COMP
通信データ長

ユーザ
データ
種別
XMAP-RECV-TRN
8(17)
X(8)
トランザクションコード

XMAP-RECV-REQ
4(25)
X(4)
要求種別

通信
論理
マップ
XMAP-RECV-
MHLNG
2(29)
S9(4)COMP
通信論理マップ長

XMAP-RECV-RSV1
2(31)
S9(4)COMP
予備

XMAP-RECV-RTN
2(33)
9(4)COMP
リターンコード

XMAP-RECV-RSN
2(35)
9(4)COMP
リターンコード詳細

XMAP-RECV-
TNAME
8(37)
X(8)
仮想端末名称

XMAP-RECV-
PMAPNAME
8(45)
X(8)
物理マップ名称をEBCDIKコードでセット

XMAP-RECV-
INLNG
2(53)
S9(4)COMP
入力論理マップ長の最大値

XMAP-RECV-OPT
1(55)
X
マッピングオプション

XMAP-RECV-
DCODE
1(56)
X
データ有無コード

XMAP-RECV-RSV2
36(57)
X(36)
予備
(00)₁₆でヌルクリア

入力
論理
マップ
XMAP-RECV-MAPS
2(93)
S9(4)COMP
入力論理マップ長

XMAP-RECV-MAP0
2(95)
S9(4)COMP
予備

XMAP-RECV-MAPK
0～2,920
(97)
X
入力論理データ

表10-2　送信メッセージテーブルの形式

部分
エリア名称
長さ
（位置）
データ形式
データ内容

ヘッダ
XMAP-SEND-LL
2(0)
S9(4)COMP
送信テーブル長

XMAP-SEND-RR
2(2)
S9(4)COMP
予備

XMAP-SEND-LL1
2(4)
S9(4)COMP
AP長

XMAP-SEND-UAP
8(6)
X(8)
AP名

XMAP-SEND-LL2
2(14)
S9(4)COMP
通信データ長

ユーザ
データ
種別
XMAP-SEND-TRN
8(16)
X(8)
トランザクションコード

XMAP-SEND-REQ
4(24)
X(4)
要求種別

通信
論理
マップ
XMAP-SEND-
MHLNG
2(28)
S9(4)COMP
通信論理マップ長

XMAP-SEND-RSV1
2(30)
S9(4)COMP
予備

XMAP-SEND-RTN
2(32)
9(4)COMP
リターンコード

XMAP-SEND-RSN
2(34)
9(4)COMP
リターンコード詳細

XMAP-SEND-
TNAME
8(36)
X(8)
仮想端末名称

XMAP-SEND-
PMAPNAME
8(44)
X(8)
物理マップ名称をEBCDIKコードでセット

XMAP-SEND-
INLNG
2(52)
S9(4)COMP
入力論理マップ長の最大値

XMAP-SEND-OPT
1(54)
X
マッピングオプション

XMAP-SEND-
DCODE
1(55)
X
データ有無コード

XMAP-SEND-RSV2
36(56)
X(36)
予備
(00)₁₆でヌルクリア

出力
論理
マップ
XMAP-SEND-MAPL
2(92)
S9(4)COMP
出力論理マップ長

XMAP-SEND-MAPZ
2(94)
S9(4)COMP
予備

XMAP-SEND-MAPG
0～2,920
(96)
X
出力論理データ

(3)　通信論理マップとAPの連携

メインフレームとPCに処理を分散する環境では，メインフレーム側からPC側へ，どのようにして入出力命令が渡されているのかを，命令発行順序を示して説明します。

命令発行時に使用するSEND文およびRECEIVE文の形式については，マニュアル「データコミュニケーションマネジメントシステム DCCM3 プログラミングの手引」を参照してください。

(a)　メインフレームからPC上の画面・帳票に対する送受信命令

オープン命令：SEND文でPCにオープン命令を出す。

出力命令：SEND文で送信メッセージテーブルを使用して，PCに表示命令を出す。

入力命令：RECEIVE文で受信メッセージテーブルを使用して，PCからデータを受信する。出力および入力するデータ数だけ，2.と3.の処理を繰り返す。

クローズ命令：SEND文でPCにクローズ命令を出す。

(b)　各命令と送受信メッセージの関連

それぞれの命令発行時とメッセージテーブルの設定値の関連を次の表に示します。

表10-3　オープン命令発行時の送信メッセージの設定値

部分
データ項目名
指定内容

ヘッダ
送信テーブル長
92とする。

予備
(0000)₁₆とする。

AP長
10とする。

AP名
PC側の画面管理プログラムのEXE名称をセットする。

通信データ長
78とする。

ユーザ
データ
種別
トランザクションコード
次に起動するトランザクション名。

要求種別
(10000001)₁₆とする（オープン要求）。

通信
論理
マップ
通信論理マップ長
64とする。

予備
(0000)₁₆とする。

リターンコード
(0000)₁₆とする。

詳細コード
(0000)₁₆とする。

仮想端末名称
X3MWHOSTに指定した仮想端末名称を指定する。※

物理マップ名
(00)₁₆でヌルクリアする。

入力論理マップ長の最大値
(0000)₁₆とする。

マッピングオプション
(00)₁₆とする。

データ有無コード
データ有無コードを指定する。

予備
(00)₁₆でヌルクリアする。

注※

仮想端末の画面をオープンするときに，出力先が一つだけならば，指定を省略できます。指定を省略する場合，(40)₁₆で8バイトクリアしてください。

表10-4　クローズ命令発行時の送信メッセージの設定値

部分
データ項目名
指定内容

ヘッダ
送信テーブル長
92とする。

予備
(0000)₁₆とする。

AP長
10とする。

AP名
PC側の画面管理プログラムのEXE名称をセットする。

通信データ長
78とする。

ユーザ
データ
種別
トランザクションコード
次に起動するトランザクション名。

要求種別
(11000001)₁₆とする（クローズ要求）。

通信
論理
マップ
通信論理マップ長
64とする。

予備
(0000)₁₆とする。

リターンコード
(0000)₁₆とする。

詳細コード
(0000)₁₆とする。

仮想端末名称
X3MWHOSTに指定した仮想端末名称を指定する。※

物理マップ名
設定しない。

入力論理マップ長の最大値
設定しない。

マッピングオプション
設定しない。

データ有無コード
設定しない。

予備
(00)₁₆でヌルクリアする。

注※

クローズする仮想端末名称を指定します。対応するオープン命令発行時と同じ仮想端末名称を指定してください。

表10-5　入力命令発行時の通信論理マップ部と入力論理マップ部の設定値（受信メッセージテーブルを使用）

論理マップ名 | データ項目名 | 指定内容
通信論理マップ | 通信論理マップ長 | 何も設定しない。
予備
リターンコード
詳細コード
仮想端末名称
物理マップ名
入力論理マップ長の最大値
マッピングオプション
データ有無コード
予備
入力論理マップ | XMAP3が設定するので，設定する必要はない。受信後参照する場合は入力論理マップにコピーすること。

入力命令では，受信テーブルのアドレスを渡します。指定内容は，入力された時点で，すでに指定されています。

表10-6　出力命令発行時の通信論理マップ部と出力論理マップ部の設定値（送信メッセージテーブルを使用）

論理マップ名
データ項目名
指定内容

通信論理マップ
送信テーブル長
92＋出力論理データ長 をセットする。

予備
(0000)₁₆とする。

AP長
10とする。

AP名
PC側の画面管理プログラムのEXE名称をセットする。

通信データ長
78＋出力論理データ長をセットする。

トランザクションコード
次に起動するトランザクション名。

要求種別
(12000003)₁₆とする。

通信論理マップ長
64とする。

予備
(0000)₁₆とする。

リターンコード
(0000)₁₆とする。

詳細コード
(0000)₁₆とする。

仮想端末名称
X3MWHOSTに指定した仮想端末名称を指定する。
※¹

物理マップ名
EBCDIKコードで入出力する物理マップ名を，デバイスIDを付けて，左詰めで指定する。残りは(40)₁₆とする。

入力論理マップ長の最大値
使用する入力論理マップの長さの最大値を指定する。

マッピングオプション
スペースまたは'0'：マージ※2
'2'：論理マップだけ※3
'3'：物理マップだけ※4
指定しない場合は(00)₁₆でヌルクリアする。

データ有無コード
設定しない。

予備
(0000)₁₆とする。

出力論理マップ
論理マップ長
出力論理マップ長を指定する。

予備
(0000)₁₆とする。

出力論理データ
出力論理データを設定する。

注※1

出力先の仮想端末名称を指定します。対応するオープン命令発行時と同じ仮想端末名称を指定してください。

注※2

論理項目，または制御項目に指定したデータを使用して画面を表示します。ただし，表示属性の変更指示をしない項目の属性は，画面定義時に指定した表示属性となります。

注※3

論理項目，または制御項目に指定したデータを使用して画面を表示します。ただし，表示属性の変更指示をしない項目の属性は，前画面の表示属性となります。また，データの指定がない項目は，前画面のデータをそのまま表示します。

注※4

論理項目，または制御項目に指定したデータを無視して，画面定義時の情報だけで画面を表示します。

10.2.2　BCF/GCASTでのインタフェース

＜この項の構成＞

(1)　論理マップの取り込み

(2)　通信論理マップ

(3)　通信論理マップとAPの連携

(1)　論理マップの取り込み

VOS1とPCに処理を分散する環境では，VOS1とPC間で論理マップのデータをやり取りします。このとき論理マップは，COPY文でVOS1のAPに取り込まれます。COPY文は，APのWORKING-STORAGE SECTIONまたはLINKAGE SECTIONに指定します。ただし，論理マップ中に定数を展開させている場合は，LINKAGE SECTIONには取り込めません。

（例）

(2)　通信論理マップ

分散処理をするため，通信論理マップをメインフレーム上のAPに取り込みます。通信論理マップは「XMAP3 インストールフォルダ¥INCLUDE¥X3HOSTBL」として提供されています。

通信論理マップの形式を次の表に示します。

表10-7　通信論理マップの形式（BCF/GCAST用）

エリア名称
長さ
（位置）
データ形式
データ内容

XMAP-CD-MHLNG
2(0)
S9(4)COMP
通信論理マップ長

XMAP-CD-RSV1
2(2)
S9(4)COMP
予備

XMAP-CD-RTN
2(4)
9(4)COMP
リターンコード

XMAP-CD-RSN
2(6)
9(4)COMP
リターンコード詳細

XMAP-CD-TNAME
8(8)
X(8)
仮想端末名称

XMAP-CD-PMAPNAME
8(16)
X(8)
物理マップ名称をEBCDIKコードでセット

XMAP-CD-INLNG
2(24)
S9(4)COMP
入力論理マップ長の最大値

XMAP-CD-OPT
1(26)
X
マッピングオプション

XMAP-CD-DCODE
1(27)
X
データ有無コード

XMAP-CD-RSV2
36(28)
X(36)
予備(00)₁₆でヌルクリア

注

通信論理マップ用定数の場合，エリア名称の「CD」の部分が「CDT」になります。

(3)　通信論理マップとAPの連携

メインフレームとPCに処理を分散する環境では，メインフレーム側からPC側へ，どのようにして入出力命令が渡されているのかを，インタフェース機能の実行順序を示して説明します。

インタフェース機能発行時に使用するCALL文の形式については，マニュアル「GUIシステム構築支援 BCF/GCAST」を参照してください。

(a)　メインフレームからPCに対する送受信命令

OPENインタフェース機能：PCにオープン命令を出す。

TRANSCEIVEインタフェース機能：PCに表示命令を出し，PCからデータを受信する。出力および入力するデータ数だけ処理を繰り返す。

CLOSEインタフェース機能：PCにクローズ命令を出す。

(b)　各インタフェース機能と通信論理マップの関連

それぞれのインタフェース機能実行時と通信論理マップの設定値の関連を次の表に示します。

表10-8　OPENインタフェース機能実行時の通信論理マップの設定値

データ項目名 | 指定内容
通信論理マップ長 | 64とする。
予備 | (0000)₁₆とする。
リターンコード | (0000)₁₆とする。
詳細コード | (0000)₁₆とする。
仮想端末名称 | X3MWHOSTに指定した仮想端末名称を指定する。※
物理マップ名 | (00)₁₆でヌルクリアする。
入力論理マップ長の最大値 | (0000)₁₆とする。
マッピングオプション | (00)₁₆とする。
データ有無コード | データ有無コードを指定する。
予備 | (00)₁₆でヌルクリアする。

注※

仮想端末の画面をオープンするときに，出力先が一つだけならば，指定を省略できます。指定を省略する場合，(40)₁₆で8バイトクリアしてください。

表10-9　TRANSCEIVEインタフェース機能実行時の通信論理マップ設定値

論理マップ名
データ項目名
指定内容

通信論理マップ
通信論理マップ長
64とする。

予備
(0000)₁₆とする。

リターンコード
(0000)₁₆とする。

詳細コード
(0000)₁₆とする。

仮想端末名称
X3MWHOSTに指定した仮想端末名称を指定する。※¹

物理マップ名
EBCDIKコードで入出力する物理マップ名を，デバイスIDを付けて，左詰めで指定する。残りは空白とする。

入力論理マップ長の最大値
入力論理マップの長さの最大値を指定する。

マッピングオプション
スペースまたは'0'：マージ※2
'2'：論理マップだけ※3
'3'：物理マップだけ※4
指定しない場合は(00)₁₆でヌルクリアする。

データ有無コード
設定しない。

予備
(0000)₁₆とする。

出力論理マップ
論理マップ長
出力論理マップ長を指定する。

予備
(0000)₁₆とする。

出力論理データ
出力論理データを設定する。

入力論理マップ
XMAP3によって設定されるので，明示的に設定する必要はない。受信後参照する場合は入力論理マップにコピーすること。

注※1

入出力先の仮想端末名称を指定します。対応するオープン命令発行時と同じ仮想端末名称を指定してください。

注※2

論理項目，または制御項目に指定したデータを使って画面を表示します。ただし，表示属性の変更指示をしない項目の属性は，画面定義時に指定した表示属性となります。

注※3

論理項目，または制御項目に指定したデータを使って画面を表示します。ただし，表示属性の変更指示をしない項目の属性は，前画面の表示属性となります。また，データの指定がない項目は，前画面のデータをそのまま表示します。

注※4

論理項目，または制御項目に指定したデータを無視して，画面定義時の情報だけで画面を表示します。

表10-10　CLOSEインタフェース機能実行時の通信論理マップの設定値

データ項目名 | 指定内容
通信論理マップ長 | 64とする。
予備 | (0000)₁₆とする。
リターンコード | (0000)₁₆とする。
詳細コード | (0000)₁₆とする。
仮想端末名称 | X3MWHOSTに指定した仮想端末名称を指定する。※
物理マップ名 | 設定しない。
入力論理マップ長の最大値 | 設定しない。
マッピングオプション | 設定しない。
データ有無コード | 設定しない。
予備 | (00)₁₆でヌルクリアする。

注※

クローズする仮想端末名称を指定します。対応するオープン命令発行時と同じ仮想端末名称を指定してください。

10.3　PC側のインタフェース

オンライン環境で利用する場合，PC側には画面管理プログラムが必要になります。

対話環境で利用する場合，画面管理プログラムの代わりにPC用のGCASTを使用するので，画面管理プログラムは不要です。

＜この節の構成＞

10.3.1　画面管理プログラム

10.3.2　メインフレームからの命令とPC側の処理

10.3.1　画面管理プログラム

メインフレームから送信された命令は，送受信データ中の要求種別を通じてPC上の画面管理プログラムへ渡されます。渡される論理マップのデータはメインフレームのコードで記述されていますが，これらはXMAP3で変換されるので，PC用のコードに変換する必要はありません。

PC側の画面管理プログラムは，送受信データの要求種別に設定された命令を，要求としてXMAP3に渡します。また，画面管理プログラムは，画面での入力結果などをメインフレームに送信するときにも使用します。

標準的な画面管理プログラムは「XMAP3インストールフォルダ¥SAMPLES¥C」のフォルダに，ソースプログラムの形で添付されています。必要に応じてカスタマイズして利用してください。標準のままで利用する場合は，変更する必要はなく，コンパイルだけ行ってください。画面管理プログラムについては，「11. PCでの画面管理プログラムの利用と作成」を参照してください。

なお，XMAP3が提供するAPインタフェース（ライブラリ）は，マルチスレッドで動作する画面管理プログラムからの実行に対応していません。

10.3.2　メインフレームからの命令とPC側の処理

メインフレーム上のAPから送信された入出力命令を，画面管理プログラムが受信して，XMAP3に要求を発行し，結果をメインフレームに送信する過程を次の図に示します。なお，次の図の前提条件として，画面管理プログラムはC言語で作成するものとします。

図10-8　APの命令と画面管理プログラム

＜この項の構成＞

(1)　画面管理プログラムからXMAP3への要求

(2)　処理要求関数の形式

(1)　画面管理プログラムからXMAP3への要求

(a)　メインフレームからの入出力命令とPC側の入出力処理（画面送受信）

画面を送受信するときに，画面管理プログラムがXMAP3に対して送る要求を説明します。

オープン要求（jsvwhopn）メインフレームからのオープン命令を受けて，jsvwhopnで仮想端末をオープンさせる。扱う仮想端末ごとにオープンする。一つの画面管理プログラム（プロセス）内で同時にオープンできる端末数の上限は15個です。

入出力要求（jsvwhtrn）メインフレームからの出力命令を受けて，jsvwhtrnで画面への表示および入力を行う。入出力するデータ数だけ，処理を繰り返す。

クローズ要求（jsvwhcls）メインフレームからのクローズ命令を受けて，jsvwhclsで仮想端末をクローズさせる。扱う仮想端末ごとにクローズする。

(b)　メインフレームからの入出力命令とPC側の入出力処理（帳票送信）

帳票を送信するときに，画面管理プログラムがXMAP3に対して送る要求を説明します。

オープン要求（jsvwhopn）メインフレームからのオープン命令を受けて，jsvwhopnで仮想端末をオープンさせる。扱う仮想端末ごとにオープンする。一つの画面管理プログラム（プロセス）内で同時にオープンできる端末数の上限は15個です。

出力要求（jsvwhsnd）メインフレームからの出力命令を受けて，jsvwhsndで帳票印刷を行う。出力するデータ数だけ，処理を繰り返す。

クローズ要求（jsvwhcls）メインフレームからのクローズ命令を受けて，jsvwhclsで仮想端末をクローズさせる。扱う仮想端末ごとにクローズする。

(2)　処理要求関数の形式

オープン要求(jsvwhopn)

メインフレーム側からのオープン命令を受けて，仮想端末をオープンさせます。このとき，メインフレーム側の画面管理プログラムから渡された通信論理マップを引数として指定します。

形式

long jsvwhopn (char* 通信論理マップアドレス)

画面の入出力要求(jsvwhtrn)

メインフレーム側からの入出力命令を受けて，画面に対して表示や入力を行います。このとき，メインフレーム側の通信論理マップ，入力論理マップおよび出力論理マップを引数として指定します。

形式

long jsvwhtrn (char* 通信論理マップアドレス,
              char* 出力論理マップアドレス,
              char* 入力論理マップアドレス)

帳票の出力要求(jsvwhsnd)

メインフレーム側からの出力命令を受けて，仮想端末を使用して帳票印刷を行います。このとき，メインフレーム側の通信論理マップおよび出力論理マップを引数として指定します。

形式

long jsvwhsnd (char* 通信論理マップアドレス,
              char* 出力論理マップアドレス)

クローズ要求(jsvwhcls)

メインフレーム側からのクローズ命令を受けて，仮想端末をクローズさせます。このとき，メインフレーム側の画面管理プログラムから渡された通信論理マップを引数として指定します。

形式

long jsvwhcls (char* 通信論理マップアドレス)

10.4　AP作成時の注意事項

メインフレームでAPを作成する場合，または既存のメインフレーム用APを流用する場合は，次の点に注意してください。

＜この節の構成＞

10.4.1　論理マップの項目名

10.4.2　変更属性定義

10.4.3　16進指定（DFC）の動的変更

10.4.4　DCCM3の機能を代替する

10.4.1　論理マップの項目名

XMAP3で定義した論理マップは，次のような形式になります。

入力項目

マップ名-項目の名称I

出力項目

マップ名-項目の名称O

新しくAPを作成する場合，プログラム中の論理マップの項目名を，上に示した形式に一致させてください。また，メインフレームで利用していたCOBOLのAPを流用する場合，論理マップの項目名が上に示した形式に一致しているかどうかを確認してください。一致していない場合，マップファイルまたはAPを修正してください。

10.4.2　変更属性定義

テキスト・フィールドの変更属性定義，ボタン・リスト・メニューの変更属性定義，およびウィンドウ表示制御の変更属性定義は，XMAP3のドローセットアップの表示属性の動的変更ダイアログで設定できます。

10.4.3　16進指定（DFC）の動的変更

16進指定（DFC）の動的変更はXMAP3からは設定できません。APで動的変更が必要な場合は，修飾名を動的変更領域に設定してください。なお，XMAP3では，ドローセットアップでの設定に応じて動的変更テーブルが自動的に生成されます。

動的変更を元に戻すときは，APからデータ有無コードを動的変更領域に設定してください。

10.4.4　DCCM3の機能を代替する

DCCM3の機能で，XMAP3では使用できないものがあります。そのため，メインフレーム上のAPまたはPC上の画面管理プログラムで同等の機能を実現する必要があります。

DCCM3の機能でXMAP3では利用できないものについて，APまたは画面管理プログラムで代替する方法を説明します。

＜この項の構成＞

(1)　XMAPCTRL文の機能

(2)　マッピングオプション

(1)　XMAPCTRL文の機能

(a)　入力論理マップのクリア文字

DCCM3のXMAPCTRL文では，PADCHRオペランドで入力論理マップのクリア文字を指定しますが，XMAP3ではこの機能をそのまま利用することはできません。マップを再定義するか，または画面管理プログラムを変更してください。画面管理プログラムを変更する方法については，「11. PCでの画面管理プログラムの利用と作成」を参照してください。

(b)　データ有無コード

通信論理マップ内の「データ有無コード」の項目で設定します。通信論理マップについては，「10.2　VOS1側のインタフェース」を参照してください。

(c)　リテラルキー

マップのPFキーを指定して，画面制御を作り直してください。

(2)　マッピングオプション

DCCM3では，マッピングオプションは自動的に指定されますが，XMAP3でPCと処理を分散する場合，メインフレーム上のAPで指定する必要があります。

マッピングオプションは，通信論理マップで指定します。エリア名称を次に示します。

受信メッセージテーブルの場合：XMAP-RECV-OPT

送信メッセージテーブルの場合：XMAP-SEND-OPT

また，マッピングオプションに指定する内容は次のとおりです。

スペースまたは'0'を指定した場合

論理項目，または制御項目に指定したデータを使って画面を表示します。ただし，表示属性の変更指示をしない項目の属性は，画面定義時に指定した表示属性となります。

'2'を指定した場合

論理項目，または制御項目に指定したデータを使って画面を表示します。ただし，表示属性の変更指示をしない項目の属性は，前画面の表示属性となります。

'3'を指定した場合

論理項目，または制御項目に指定したデータを無視して，画面定義時の情報だけで画面を表示します。

11.　PCでの画面管理プログラムの利用と作成

通信制御にDCCM3を使用する場合，PC上には画面管理プログラムが必要です。画面管理プログラムは，メインフレーム上のAPとPC上のXMAP3との通信を中継します。この章では，画面管理プログラムの変更方法，およびコンパイル方法について説明します。

なお，通信制御にBCF/GCASTを使用するときは，PC用のGCASTがメインフレーム上のAPとXMAP3の通信を中継するので，画面管理プログラムは必要ありません。

＜この章の構成＞

11.1　サンプルプログラム

11.2　利用形態に応じた変更

11.3　コンパイルから実行まで

11.1　サンプルプログラム

XMAP3では，次に示すフォルダに画面管理プログラムのサンプルが収められています。対話処理の場合は，GCASTを使用するので，画面管理プログラムは必要ありません。

C言語のサンプル：XMAP3インストールフォルダ¥SAMPLES¥C

COBOLのサンプル：XMAP3インストールフォルダ¥SAMPLES¥COBOL

それぞれのサンプルについて説明します。

なお，それぞれのサンプルのフローチャートについては，「付録B.4(2)　PC上の画面管理プログラムの例」を参照してください。

＜この節の構成＞

11.1.1　DCCM3で2,920バイト以内のデータをやり取りする（拡張ホストアクセス）

11.1.2　DCCM3で2,920バイトを超えるデータをやり取りする（拡張ホストアクセス）

11.1.3　COBOLによる画面管理プログラム

11.1.1　DCCM3で2,920バイト以内のデータをやり取りする（拡張ホストアクセス）

DCCM3で拡張ホストアクセスを使用して，2,920バイト以内のデータをやり取りするサンプルです。

＜この項の構成＞

(1)　ファイル名

(2)　処理の概要

(1)　ファイル名

ONLNPROC.Cです。

(2)　処理の概要

ONLNPROC.Cが行う処理の概要について説明します。

開始
ウィンドウハンドルを取得して，拡張ホストアクセス機能を開始します。

拡張ホストアクセス
メインフレームからデータを受信してから，入力論理マップの初期化をします。
次に，メインフレームからの命令に応じて，次のどれかの処理をします。

仮想端末のオープン要求

仮想端末のクローズ要求

仮想端末の入出力要求

仮想端末の出力要求

必要に応じて，結果をメインフレームに送信します。
業務がすべて終了するまで，2.を繰り返します。

終了
拡張ホストアクセス機能を終了します。

11.1.2　DCCM3で2,920バイトを超えるデータをやり取りする（拡張ホストアクセス）

DCCM3で拡張ホストアクセスを使用して，2,920バイトを超えるデータをやり取りするサンプルです。

2,920バイトを超えるデータをやり取りする場合は，継続入力および継続出力の二つの命令を使用します。一回の継続入力命令または継続出力命令で，データが2,920バイトずつ転送されます。

＜この項の構成＞

(1)　ファイル名

(2)　処理の概要

(3)　利用方法

(1)　ファイル名

ONLNPRC2.Cです。

(2)　処理の概要

開始
ウィンドウハンドルを取得して，拡張ホストアクセス機能を開始します。

拡張ホストアクセス
メインフレームからデータを受信します。
次に，メインフレームからの命令に応じて，次のどれかの処理をします。

仮想端末のオープン要求

仮想端末のクローズ要求

仮想端末の入出力要求（入出力の前に，入力論理マップを初期化します）

仮想端末の出力要求

仮想端末の継続出力要求

仮想端末の継続入力要求

必要に応じて，結果をメインフレームに送信します。
業務がすべて終了するまで，2.を繰り返します。

終了
拡張ホストアクセス機能を終了します。

(3)　利用方法

(a)　メインフレームからPCにデータを出力する場合

メインフレーム上のAPは継続出力命令を繰り返し，論理マップのデータを2,920バイトずつPCに転送します。最後に残ったデータは，出力命令または入出力命令でPCに転送されます。

(b)　PCからメインフレームにデータを入力する場合

最初のデータは入出力命令によってPCからメインフレームに転送されます。次に，メインフレーム上のAPから継続入力命令が送られます。

メインフレーム上のAPは，すべてのデータを受信するまで繰り返し継続入力命令を送信します。PCからメインフレームへのデータの送信が終了したら，メインフレームのAPはクローズ命令を発行します。

(c)　入出力を組み合わせる場合

まず，メインフレーム上のAPは画面管理プログラムに対して継続出力命令を繰り返し送信し，最後に入出力命令を送信します。

次に，メインフレーム上のAPは継続入力命令を繰り返します。すべてのデータの転送が終了したら，APからクローズ命令を送信します。

11.1.3　COBOLによる画面管理プログラム

画面管理プログラムをCOBOLで作成することもできます。この場合，COBOL85が必要です。また，このサンプルではCommuniNet Extension制御機能を利用するため，COBOL拡張ライブラリが必要です。

＜この項の構成＞

(1)　ファイル名

(2)　処理の概要

(3)　コンパイルとリンケージ

(1)　ファイル名

ONLNPRC2.CBLです。

(2)　処理の概要

プログラムの内容は，ONLNPRC2.Cと同じものです。継続入力および継続出力については，「11.1.2　DCCM3で2,920バイトを超えるデータをやり取りする（拡張ホストアクセス）」を参照してください。

開始
ウィンドウハンドルを取得して，拡張ホストアクセス機能を開始します。

拡張ホストアクセス
メインフレームからデータを受信します。
次に，メインフレームからの命令に応じて，次のどれかの処理をします。

仮想端末のオープン要求

仮想端末のクローズ要求

仮想端末の入出力要求（入出力の前に，入力論理マップを初期化します）

仮想端末の出力要求

仮想端末の継続出力要求

仮想端末の継続入力要求

必要に応じて，結果をメインフレームに送信します。
業務がすべて終了するまで，2.を繰り返します。

終了
拡張ホストアクセス機能を終了します。

(3)　コンパイルとリンケージ

COBOL拡張ライブラリのCommuniNet Extension制御機能を利用するので，実行形式のプログラムを作成するにはコンパイルのほかにリンケージ処理が必要です。

(a)　必要なファイル

コンパイルおよびリンケージに必要なファイルを次に示します。

COPYファイル

COBOL拡張ライブラリのバージョンが02-00，またはそれ以降の場合

EXCNEX32.CBL：COBOL拡張ライブラリで提供

EXHA32.CBL：COBOL拡張ライブラリで提供

COBOL拡張ライブラリのバージョンが02-00より前の場合

EXCNEX32.CPY：COBOL拡張ライブラリで提供

EXHA32.CPY：COBOL拡張ライブラリで提供

インポートライブラリ

次に示すライブラリを，COBOL85の開発マネージャを使って実行ファイルの直下に取り込んでください。

COBOL85 Version7またはCOBOL85 Version6の場合
XMAP3インストール先¥LIB¥X3MWHD32.LIB：XMAP3で提供

COBOL85 Version5.0の場合
XMAP3インストール先¥LIB¥V3Compatible¥X3MWHD32.LIB：XMAP3で提供

EXCNEX32.LIB：COBOL拡張ライブラリで提供

EXHA32.LIB：CommuniNet Extensionで提供

(b)　環境変数の設定（COBOL拡張ライブラリのバージョンが02-00より前の場合）

COBOL拡張ライブラリのバージョンが02-00より前の場合，使用するCOPYファイルの拡張子が「.CPY」となっているので，環境変数CBLFIXを設定する必要があります。

環境変数を設定するには，COBOL85の開発マネージャから，次のように操作してください。

COBOL85 Version7またはCOBOL85 Version6の場合

［プロジェクト］-［プロジェクトの設定...］コマンドを選択する。
プロジェクト設定ダイアログが表示されます。

プロジェクト設定ダイアログの「環境変数」タブを選択し，［CBLFIX］ボタンをクリックする。
環境変数の設定ダイアログが表示されます。

環境変数の設定ダイアログの値に'.cpy'を指定して［追加］ボタンをクリックし，［OK］ボタンをクリックする。

プロジェクト設定ダイアログの［OK］ボタンをクリックする。

COBOL85 Version5.0の場合

［オプション］-［コンパイラ...］コマンドを選択する。
コンパイラオプションダイアログが表示されます。

コンパイラオプションダイアログの［環境変数設定...］ボタンをクリックする。
環境設定ダイアログが表示されます。

変数に'CBLFIX'，値に'.cpy'を指定して［設定...］ボタンをクリックする。

［OK］ボタンをクリックして環境設定ダイアログを閉じ，コンパイラオプションダイアログの［OK］ボタンをクリックする。

(c)　コンパイル時のオプション

コンパイル時は，COBOL85のコンパイルオプションで-Cpを指定して，CBWファイルを作成します。このとき，CBWファイルには次に示す外部関数名を記述してください。

jsvwhopn

jsvwhcls

jsvwhtrn

jsvwhsnd

EXCNEX

さらに，コンパイルオプションとして-Bb（2進数をビッグエンディアンで処理）を必ず指定してください。

また，サンプルを修正した場合，修正内容によっては次に示すコンパイルオプションの指定が必要になります。

-X5（COMP-5を使用可能とする）

-Vx（2進数の拡張）

-B1（1バイトの2進数を使用可能にする）

コンパイルおよびリンケージの手順については，マニュアル「COBOL85ユーザーズガイド」およびマニュアル「COBOL拡張ライブラリ」を参照してください。

11.2　利用形態に応じた変更

＜この節の構成＞

11.2.1　仮想端末名およびマップ名を設定する

11.2.2　入力論理マップのクリア文字を指定する

11.2.3　トランザクションコード

11.2.4　CommuniNetの端末名称を変更する

11.2.5　画面管理プログラムにメインフレームAPの処理を分散する

11.2.1　仮想端末名およびマップ名を設定する

画面管理プログラムに，仮想端末名称およびマップ名などを設定するコードを追加してください。通信論理マップの「仮想端末名称」および「物理マップ名」はEBCDIKコードで設定します。

11.2.2　入力論理マップのクリア文字を指定する

入力論理マップを初期化するときのクリア文字は，画面管理プログラムで設定してください。なお，文字コードはASCIIコードではなくEBCDIKコードで指定してください。

XMAP3で提供しているサンプルでの，入力論理マップのクリア文字の指定方法を次に示します。

C言語のサンプル（ONLNPROC.C，ONLNPRC2.C）の場合

「0x00」の部分が，クリア文字のEBCDIKコードです。これを，例えば「0x40」に変更すると，入力論理マップがスペースでクリアされます。

COBOLのサンプル（ONLNPRC2.CBL）の場合

「X'00'」の部分が，クリア文字のEBCDIKコードです。これを，例えば「X'40'」に変更すると，入力論理マップがスペースでクリアされます。

11.2.3　トランザクションコード

トランザクションコードによって，PCからメインフレーム上のAPを起動する形態で運用する場合，トランザクションコードは画面の隠しフィールドに定義します。隠しフィールドに定義したトランザクションコードをメインフレームに送るには，転送するデータの形式をXMAP3の環境に合わせるために，画面管理プログラムを変更してください。データ領域の先頭に，トランザクションコードの内容を設定します。

トランザクションコードを利用する場合の，PCからメインフレームへ転送するデータの形式を次の図に示します。

図11-1　PCから転送するデータの形式

11.2.4　CommuniNetの端末名称を変更する

XMAP3で提供しているサンプルプログラムでは，CommuniNetの端末名称を画面管理プログラムで設定し，「オンライン端末」という名称を前提にしています。CommuniNetの端末名称を「オンライン端末」以外の名称にするには，サンプルプログラムを修正する必要があります。

XMAP3で提供しているサンプルプログラムでの，CommuniNetの端末名称の指定個所を次に示します。

C言語のサンプル（ONLNPROC.C，ONLNPRC2.C）の場合

CommuniNetの端末名称を「オンライン端末」以外にする場合，上記の"オンライン端末"の部分をCommuniNetの端末名称と同じ名称に変更してください。

COBOLのサンプル（ONLNPRC2.CBL）の場合

CommuniNetの端末名称を「オンライン端末」以外にする場合，上記の"オンライン端末"の部分をCommuniNetの端末名称と同じ名称に変更してください。

11.2.5　画面管理プログラムにメインフレームAPの処理を分散する

画面表示やPC上のAPの呼び出しを，メインフレーム上のAPではなく画面管理プログラムで処理できます。これによって，すべてをメインフレーム上のAPから処理する場合に比べて，メインフレームとPCとでやり取りされるデータの量が減少するので，処理の効率を上げることができます。

画面管理プログラムは，メインフレームのAPとの間で送受信される入出力論理マップの内容をそのままXMAP3に渡しています。この入出力論理マップには，メインフレーム用のコードである，EBCDIKコードおよびKEIS'83コードでデータが格納されています。

画面管理プログラムにAP処理を分散し，入出力論理マップ中のデータを参照または更新するためには，EBCDIKコードおよびKEIS'83コードを使用する必要があります。画面管理プログラムをC言語で作成している場合は，入出力論理データを扱う構造体を，COBOL用の論理マップを参考にして作成してください。

画面管理プログラムから，メインフレームのAPからの命令とは別に画面を表示させる場合は，jsvwhtrn関数を使用します。画面管理プログラムをCOBOLで作成する場合は，「CALL "jsvwhtrn"」としてください。

画面管理プログラムにメインフレームのAPの処理を分散するケースについて説明します。

＜この項の構成＞

(1)　ポップアップメニューを表示する

(2)　メニュー画面を表示する

(3)　二次ウィンドウを表示する

(4)　PC上のほかのAPを呼び出す

(5)　Windowsのヘルプ機能を呼び出す

(1)　ポップアップメニューを表示する

マスタファイルなどからデータを取り出し，可変ポップアップのメニュー内容の変更処理を分散します。

PC上に可変ポップアップメニュー用論理項目と同じ形式と大きさで，内容がEBCDIKコードおよびKEIS'83コードで格納されたメニューファイルを準備します。

画面管理プログラムでは，次の処理を行います。

画面を表示する前に，出力論理マップの，可変ポップアップメニュー用データが格納されている領域の内容を，メニューファイルの内容に書き換えます。

画面を表示します。

(2)　メニュー画面を表示する

仮想端末のオープン要求のあとに表示するメニュー画面の表示処理を分散します。

メニュー画面をXMAP3で定義します。このとき，生成したマップはメインフレームに転送しません。

画面管理プログラムでは，次の処理を行います。

メインフレームのAPから受け取った仮想端末のオープン要求を処理します。

メニュー画面を表示します。

メニュー画面から入力された入力論理マップ中の，イベント通知コードが格納されている位置から，長さ分の内容をEBCDIKコードで判定します。

3.で判定した内容から，メインフレームのAPに送信するトランザクションコードを決定します。

トランザクションコードを受信メッセージテーブルに格納し，メインフレームに送信します。

(3)　二次ウィンドウを表示する

一次ウィンドウから入力されたイベント通知コードを判定して，操作の補助を目的として二次ウィンドウを表示させる処理を分散します。

二次ウィンドウをXMAP3で定義します。このとき，生成したマップはメインフレームに転送しません。

画面管理プログラムでは，次の処理を行います。

一次ウィンドウから入力された入力論理マップ中の，イベント通知コードが格納されている位置から，長さ分の内容をEBCDIKコードで判定します。

二次ウィンドウの表示を指示するイベント通知コードであれば，二次ウィンドウを表示します。

二次ウィンドウを表示するときに使用する出力論理マップは，EBCDIKコードおよびKEIS'83コードでデータを格納します。また，二次ウィンドウからの入力データもEBCDIKコードおよびKEIS'83コードで格納されています。そのため，画面管理プログラムから表示させる二次ウィンドウは，論理データを極力使用しないものにしてください。

(4)　PC上のほかのAPを呼び出す

一次ウィンドウから入力されたイベント通知コードを判定して，PC上のAPを起動する処理を分散します。

画面管理プログラムで，次の処理を行います。

一次ウィンドウから入力された入力論理マップ中の，イベント通知コードが格納されている位置から，長さ分の内容をEBCDIKコードで判定します。

APの起動を指示するイベント通知コードであれば，該当するAPを起動します。

(5)　Windowsのヘルプ機能を呼び出す

一次ウィンドウから入力されたイベント通知コードを判定して，Windowsのヘルプを呼び出す処理を分散します。

画面管理プログラムで，次の処理を行います。

一次ウィンドウから入力された入力論理マップ中の，イベント通知コードが格納されている位置から，長さ分の内容をEBCDIKコードで判定します。

ヘルプの呼び出しを指示するイベント通知コードであれば，WindowsAPIのWinHelpを呼び出してください。

画面管理プログラムをCOBOLで作成している場合には，WINHELP.EXEの引数としてヘルプファイル名を指定してください。COBOLでのコーディング例を次に示します。

（例）

11.3　コンパイルから実行まで

PC上で使用する画面管理プログラム（C言語）のコンパイルおよびリンケージの仕組みについて説明します。具体的な操作方法については，コンパイラとして使用するVisual C++のコンパイラのマニュアルを参照してください。

COBOLで作成した画面管理プログラムのコンパイルおよびリンケージの仕組みについては，「11.1.3　COBOLによる画面管理プログラム」を参照してください。

＜この節の構成＞

11.3.1　画面管理プログラムのコンパイルとリンケージ

11.3.2　画面管理プログラムの実行

11.3.1　画面管理プログラムのコンパイルとリンケージ

画面管理プログラムは，Visual C++のコンパイラを使用してコンパイルおよびリンケージをします。実行可能ファイルを作成するまでの概要を次の図に示します。リンケージするときには，メインフレーム接続インタフェースライブラリ，および拡張ホストアクセスライブラリをリンクします。

図11-2　実行可能ファイルを作成するまでの概要

画面管理プログラムのソースプログラムをコンパイルおよびリンケージする場合の，操作方法や指定するオプションについては，Visual C++のコンパイラのマニュアルを参照してください。コンパイルとリンケージ時に必要なパラメタを次に示します。

取り込むライブラリ

次に示すライブラリをプロジェクトに追加してください。

Visual C++ 6.0またはVisual C++.NETの場合
XMAP3インストール先¥LIB¥X3MWHD32.LIB：XMAP3のメインフレーム接続用ライブラリ

Visual C++ 5.0の場合
XMAP3インストール先¥LIB¥V3Compatible¥X3MWHD32.LIB：XMAP3のメインフレーム接続用ライブラリ

EXHA32.LIB：CommuniNet Extensionの拡張ホストアクセスライブラリ

必要なヘッダ

EXHA32.H：CommuniNet Extensionの拡張機能関数のヘッダファイル

Visual C++でプロジェクトワークスペースを作成するときは，種類には必ず「Application」を指定してください。「Console Application」を指定すると，コンパイル時に外部シンボル「_main」が未解決エラーになります。

また，Visual C++.NETでプロジェクトファイルを作成するときは，アプリケーションの種類に「Windowsアプリケーション」を指定してください。「コンソールアプリケーション」を指定すると，コンパイル時に外部シンボル「_main」が未解決エラーになります。

なお，XMAP3の関数はC言語用に作成されているため，「extern "C"」で関数宣言してください。

11.3.2　画面管理プログラムの実行

コンパイルおよびリンケージをした画面管理プログラムは，環境変数PATHに指定されているフォルダに置いてください。

画面管理プログラムを実行させるには，PC上であらかじめ画面管理プログラムを起動してメインフレームからのデータを待つ方法と，メインフレームからPC上の画面管理プログラムを起動させる方法の二つがあります。

メインフレームのAPから画面管理プログラムを起動させる場合は，送信メッセージのAP名の項目に，画面管理プログラムの名称（ファイル名.EXE）を指定してください。

12.　トラブルシューティング

この章では，VOS1とPCに処理を分散する環境でのトラブルとその対処方法について説明します。

マニュアル「XMAP3 開発・実行ガイド」も参照してください。

＜この章の構成＞

12.1　回線接続時のトラブルと対処方法

12.2　画面・帳票出力時のトラブルと対処方法

12.3　DCCM3使用時のトラブルと対処方法

12.4　画面管理プログラムのトラブルと対処方法

12.5　CommuniNet Extension使用時のトラブルと対処方法

12.1　回線接続時のトラブルと対処方法

回線接続に関するトラブルについて，その対処方法を説明します。

「回線接続エラー」が発生する。

IPアドレスまたはゲートウェイアドレスが誤っています。

コントロールパネルの「ネットワーク」で，「TCP/IP（プロトコル）」を選び，IPアドレスとゲートウェイアドレスを正しく設定してください。

「AP識別子とメインフレーム名の設定に誤りがあります」というメッセージが表示される。

CommuniNetで設定したメインフレーム名が誤っています。

CommuniNetの環境設定ユティリティで［通信情報］の［接続先サーバ名］を正しく設定してください。

12.2　画面・帳票出力時のトラブルと対処方法

画面表示および帳票印刷をしたときのトラブルについて，その対処方法を説明します。

画面・帳票が出力できない。

通信論理マップを記述する文字コードに，シフトJISが使用されています。

通信論理マップは，EBCDIKおよびKEISコードを使用して記述してください。

画面・帳票に文字化けが生じる。

通信論理マップの内容を記述する文字コードに，シフトJISが使用されています。

通信論理マップは，EBCDIKおよびKEISコードを使用して記述してください。

XMAP3でオープンエラーが出る。

マップがリトルエンディアンで作成されているか，またはPC側でパラメタ長を設定しているためにパラメタの長さが不正に解釈されている可能性があります。

パラメタ長が正しく設定されているかどうか見直してください。

12.3　DCCM3使用時のトラブルと対処方法

DCCM3使用時に固有のトラブルについて，その対処方法を説明します。

MODATTR文でデータ有無コードを設定してもマッピングに反映されない。

XMAP3では，マッピングオプションはAPで設定する必要があります。通信論理マップのマッピングオプションの項目で設定してください。

可変項目のデータ有無コードを設定しても反映されない。

XMAP3では，マッピングオプションはAPで設定する必要があります。通信論理マップのマッピングオプションの項目で設定してください。

AP終了後，ログイン画面がKBロック状態になっていて，キー入力できない。

取り消しキーが押されていない可能性があります。対処方法としては，次の二つがあります。

PCのキーボードから取り消しキー（［Ctrl］+［R］キー）を押す。

画面管理プログラムで，EXClose関数を発行する前にNHSimulateKey関数を発行して，取り消しキー（NHSIM_KEY_RESETパラメタ）を押すのと同じ状態にする。

12.4　画面管理プログラムのトラブルと対処方法

画面管理プログラムに関連するトラブルについて，その対処方法を説明します。

画面管理プログラムのコンパイル時に，リンケージエラーが発生する。

画面管理プログラムのコンパイルで，プロジェクトワークスペースを作成するときに，「Application」を指定してください。「Console Application」を指定すると，外部シンボル「_main」は未解決エラーになります。

jsvwhtrn関数を呼び出すと，画面管理プログラムが異常終了してしまう。

オープンが成功している場合は，通信論理マップ中の出力論理マップ長に，実際より小さい値が指定されている可能性があります。通信論理マップ中の出力論理マップ長の値を確認してください。

jsvwhtrn関数を呼び出すと，入力論理マップ長エラーが発生する。

通信論理マップ中の，入力論理マップ長の最大値を見直してください。通常は，X'7FFF'と設定すれば問題ありません。

12.5　CommuniNet Extension使用時のトラブルと対処方法

DCCM3でCommuniNet Extensionの画面管理プログラムを使用している場合，またはBCF/GCASTを使用している場合は，「付録B.5　CommuniNet Extensionを使用したメインフレーム・PC連携機能でのトラブルと対処方法」を参照してください。

13.　VOSK-PC分散システムの環境設定

この章では，VOSKとPCに処理を分散して運用する場合の，開発環境および実行環境の設定方法について説明します。

＜この章の構成＞

13.1　開発環境の設定

13.2　実行環境の設定

13.1　開発環境の設定

XMAP3の開発環境を，メインフレーム用とPCで分散して処理するための画面を定義する環境に設定します。開発環境のセットアップについては，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

次に示すターゲット環境の設定は，必ず実行してください。

＜この節の構成＞

(1)　ターゲット環境の設定

(2)　動的変更テーブルの更新

(1)　ターゲット環境の設定

XMAP3のドローセットアップを起動させます。セットアップダイアログの［運用管理者用の設定］ボタンを選択して，運用管理者用の設定を活性状態にしてください。

セットアップダイアログの［ターゲットの設定...］ボタンをクリックしてください。ターゲット環境の設定ダイアログが表示されます。

「メインフレーム-PC分散用の画面・帳票開発」を選択して［OK］ボタンをクリックしてください。メインフレームとPCで処理を分散するためのマップを生成する開発環境になります。

注意

ドローセットアップを起動しているときは，XMAP3のほかの機能を起動させないでください。

(2)　動的変更テーブルの更新

Windows／UNIXとメインフレームではデータ有無コードに違いがあるので，ターゲット環境を変更すると，動的変更テーブルの更新が必要になることがあります。また，ドローセットアップで修飾名を変更した場合も，動的変更テーブルが更新されます。

この場合，ドローセットアップで設定を保存するときにX3MODTBLの更新ダイアログが表示されます。

ファイル名や出力先を変更する場合は，［参照...］ボタンをクリックして指定してください。

［OK］ボタンをクリックすると，動的変更テーブルにデータ有無コードが書き込まれます。上書きする場合は，日付確認のメッセージが表示されます。［OK］ボタンをクリックすると，新しい動的変更テーブルが生成され，上書き前の動的変更テーブルはX3MODBAK.CBL，X3MODBAK.Hとして保存されます。

なお，「X3MODTBL.H」はC言語用の動的変更テーブルです。メインフレーム－PC分散用のマップを生成する場合は使用しません。

更新後の動的変更テーブルの先頭部分は次のようになります。

ドローセットアップでのターゲット環境とデータ有無コードの関係を次の表に示します。

表13-1　ターゲット環境の設定とデータ有無コードの関係

ターゲット環境の設定 | データ有無コード
VOS3用の画面・帳票開発 | X'3F'
VOS1用の画面・帳票開発 | X'3F'
VOSK用の画面・帳票開発 | X'3F'
メインフレーム－PC分散用の画面・帳票開発 | X'3F'
AIX（文字コード：シフトJIS）用の画面・帳票開発 | X"1F"
AIX（文字コード：EUC）用の画面・帳票開発 | X"1F"
HP-UX（文字コード：シフトJIS）用の画面・帳票開発 | X"1F"
Solaris（文字コード：シフトJIS）用の画面・帳票開発 | X"1F"
Solaris（文字コード：EUC）用の画面・帳票開発 | X"1F"
Linux（文字コード：EUC）用の画面・帳票開発 | X"1F"
Windows用の画面・帳票開発 | X"1F"

アプリケーションでほかの値のデータ有無コードを使用する場合は，動的変更テーブルを修正してください。

13.2　実行環境の設定

実行環境の設定のうち，注意が必要なものについて説明します。設定については，次のマニュアルを参照してください。

マニュアル「XMAP3 開発・実行ガイド」

マニュアル「CommuniNet （Windows NT，Windows 95用）」またはマニュアル「CommuniNet Version 3 （Windows NT，Windows 95用）」

マニュアル「GUIシステム構築支援 OSCF/GCAST」

＜この節の構成＞

13.2.1　仮想端末名称の設定

13.2.2　TCP/IPの設定

13.2.3　CommuniNetの設定

13.2.4　マップパスの設定

13.2.5　外字の設定

13.2.1　仮想端末名称の設定

XMAP3の仮想端末名称の設定には，表示・印刷セットアップまたはC/Sセットアップを使用します。詳細については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

また，OSCF/GCASTで定義する通信エンティティ名とXMAP3で定義する仮想端末名称を一致させてください。

13.2.2　TCP/IPの設定

コントロールパネルの「ネットワーク」で，「ネットワークの設定」タブの「TCP/IP」を選択し，［プロパティ］ボタンをクリックしてIPアドレスを設定してください。ゲートウェイを使用する場合は，ゲートウェイアドレスも設定します。

13.2.3　CommuniNetの設定

環境設定ユティリティを起動して，メニューの「オプション」から「通信情報」を選択します。項目設定欄の［通信情報］を選択して，以下の情報を設定してください。

接続するメインフレームのサーバ名称，またはIPアドレス

メインフレーム名称

AP識別子

13.2.4　マップパスの設定

表示・印刷セットアップを起動して，「アプリケーション1」タブを選びます。「マップ」に物理マップを格納したフォルダを設定してください。

13.2.5　外字の設定

＜この項の構成＞

(1)　既存の外字の割り当てを使用する場合

(2)　外字マッピングファイルをカスタマイズする場合

(3)　XMAP3外字機能を使用する場合

(1)　既存の外字の割り当てを使用する場合

(a)　概要

PCのシフトJISとメインフレームのKEISとでは，外字コードはそれぞれ異なる領域に割り当てられています。メインフレームとPCとでデータをやり取りするとき，外字コードはXMAP3がそれぞれ対応するコードに置き換えます。シフトJISとKEISとの，外字に使う文字コードの対応については，「付録B.3　外字用コードの割り当て」を参照してください。

(b)　必要な作業

Windowsに付属の外字エディタなどを使用して，外字を定義してください。定義した外字は，実行環境に配布してください。

(2)　外字マッピングファイルをカスタマイズする場合

(a)　概要

PCのシフトJISとメインフレームのKEISとの変換はXMAP3が行います。外字部分のコード変換について，シフトJISとKEISの対応を変更したい場合は，コード変換SDK，または日立コード変換 - Development Kitを使用して外字マッピングファイルをカスタマイズしてください。

実行環境には，コード変換ランタイム，日立コード変換 - Client Runtime，または日立コード変換 - Server Runtimeをインストールしてください。また，カスタマイズされた外字マッピングファイルを実行環境に配布してください。これで，メインフレームとPCとの間でやり取りされるデータとして，KEISコードで(81A1)₁₆～(94FE)₁₆の範囲以外の外字を使用できます。

(b)　必要な作業

外字マッピングファイルのカスタマイズに必要な作業について説明します。

外字の作成
Windowsに付属の外字エディタを使用して，外字を定義してください。定義した外字は，実行環境に配布してください。

シフトJISとKEISの対応を定義する
開発環境で，コード変換SDK，または日立コード変換 - Development Kit外字マッピングファイル（GJISKEI.TBL）をカスタマイズします。
コード変換SDKを使用する場合
コード変換SDKのコードマッピングユティリティを使用して，外字マッピングファイル（GJISKEI.TBL）をカスタマイズします。
コードマッピングユティリティの操作方法については，マニュアル「コード変換ユーザーズガイド」を参照してください。
日立コード変換 - Development Kitを使用する場合
日立コード変換 - Development Kitのコードマッピングユティリティ，またはコマンドユティリティを使用して，外字マッピングファイル（GJISKEI.TBL）をカスタマイズします。
コードマッピングユティリティ，およびコマンドユティリティの操作方法については，マニュアル「日立コード変換ユーザーズガイド」を参照してください。

外字マッピングファイルの配布
実行環境に外字マッピングファイルを配布します。
コード変換SDKを使用する場合
2.でカスタマイズした外字マッピングファイル（GJISKEI.TBL）を，「コード変換ランタイムインストールフォルダ¥TABLE」の下にコピーしてください。コード変換ランタイムがインストールされている場合，XMAP3では配布された外字マッピングファイルに従って外字コードを変換します。
日立コード変換 - Development Kitを使用する場合
2.でカスタマイズした外字マッピングファイル（GJISKEI.TBL）を，「日立コード変換 - Client Runtimeインストールフォルダ¥TABLE」，または「日立コード変換 - Server Runtimeインストールフォルダ¥TABLE」の下にコピーしてください。日立コード変換 - Client Runtime，または日立コード変換 - Server Runtimeがインストールされている場合，XMAP3では配布された外字マッピングファイルに従って外字コードを変換します。

(3)　XMAP3外字機能を使用する場合

(a)　概要

シフトJISで使用できる外字は1,880字までですが，画面に出力する文字コードにUnicodeを使用することで，メインフレームとPCとの間でやり取りするデータとして，6,400字までのUnicodeの外字を使用できます。ただし，画面への出力にUnicodeを使用できるのは，OSがWindows NT，Windows 2000，Windows XP，またはWindows Server 2003の場合だけです。

メインフレームから受信した，KEISの外字コードは，XMAP3からコード変換ランタイム，コード変換SDK，日立コード変換 - Client Runtime，または日立コード変換 - Server Runtimeを使ってUnicodeに変換します。Unicodeを画面に表示するときは，KanjiLink XKPを経由します。

実行時の，メインフレームとPCの間でやり取りされるデータおよび表示されるデータの文字コードの遷移について，また開発時に準備が必要なファイルについて次の図に示します。なお，メインフレームのAPについては，特別な処理は必要ありません。

図13-1　文字コードの遷移

また，必要な作業について次に説明します。

(b)　必要な作業

外字の用意
開発環境，実行環境のそれぞれに，使用する外字のフォントを用意してください。発注・購入しない場合は，市販のアウトラインフォントエディタを使用して，外字を作成してください。なお，必ずTrueTypeフォントを用意してください。
KEIS'83拡張文字セット3を使用する場合，次のフォントを使用できます。

メーカ固有漢字セット（日立KEIS83拡張3）

文字情報を記述したファイルの作成
開発環境で，KanjiLink XKPに登録する文字情報を記述したファイルを作成してください。作成したファイルは，実行環境に配布してください。

外字セットの作成とUnicodeの割り当て
実行環境で，KanjiLink XKPの管理ツールを使用して，2.で作成したファイルから外字セットを作成してください。また，外字セットをUnicodeのどの領域に割り当てるかを決定してください。

UnicodeとKEISの対応を割り当てる
コード変換SDK，コード変換ランタイム，日立コード変換 - Client Runtime，または日立コード変換 - Server Runtimeをインストールした状態では，標準値の外字マッピングファイルを使用します。UnicodeとKEISの，外字に使う文字コードの対応については，「付録B.3　外字用コードの割り当て」を参照してください。
UnicodeとKEISの対応をカスタマイズする場合は，開発環境でコード変換SDK，または日立コード変換 - Development Kitのコードマッピングユティリティを使用して，外字マッピングファイル（GUNIKEI.TBL）をカスタマイズしてください。
コード変換SDKを使用する場合
カスタマイズした外字マッピングファイルは，実行環境の「コード変換ランタイムインストールフォルダ¥TABLE」の下にコピーしてください。
コードマッピングユティリティの操作方法については，マニュアル「コード変換ユーザーズガイド」を参照してください。
日立コード変換 - Development Kitを使用する場合
カスタマイズした外字マッピングファイルは，実行環境の「日立コード変換 - Client Runtimeインストールフォルダ¥TABLE」，または「日立コード変換 - Server Runtimeインストールフォルダ¥TABLE」の下にコピーしてください。
コードマッピングユティリティの操作方法については，マニュアル「日立コード変換ユーザーズガイド」を参照してください。

なお，画面で外字を入力する場合は，実行環境にVJE-Delta for Unicode/XKPをインストールしてください。

(c)　制限事項

次に示す機能については，Unicodeの外字は使用できません。

固定項目でのUnicode外字の使用

タイトルバーおよびメニューバーでのUnicode外字表示

14.　VOSK-PC分散システムのAP開発から運用まで

この章では，VOSKとPCに処理を分散するシステムでの，マップの定義から運用までの手順について説明します。

＜この章の構成＞

14.1　画面定義前の準備

14.2　画面の定義

14.3　マップ生成とファイル転送

14.4　APの作成と実行

14.5　画面・帳票作成時のメッセージ

14.1　画面定義前の準備

＜この節の構成＞

14.1.1　フォルダを作成する

14.1.2　定義環境の設定

14.1.1　フォルダを作成する

画面・帳票の定義後に生成するマップを格納するためのフォルダが必要です。XMAP3インストール時には，XMAP3インストールフォルダに「¥USER¥MAPS」のフォルダが作成されます。これとは別のフォルダに格納したい場合，フォルダの名称や場所は任意に設定してください。

生成したファイルは，XMAP3インストールフォルダ以外のフォルダで管理することをお勧めします。なお，「XMAP3インストールフォルダ¥TEMP」の下に格納すると，正常に動作しませんので注意してください。

また，マップファイルを格納するフォルダにロングパス名を使用している場合，IFITによるマップファイルの転送ができないことがあります。フォルダ名にはロングパス名を使用しないことをお勧めします。

14.1.2　定義環境の設定

XMAP3のセットアップ機能を用いて，画面・帳票定義の環境を設定します。

環境設定については，「13. VOSK-PC分散システムの環境設定」を参照してください。

14.2　画面の定義

画面は，XMAP3のドローで定義します。定義環境については，マニュアル「XMAP3 プログラミングガイド 画面編」を参照してください。

また，インポート機能を利用して，メインフレームでのマップ定義をPC用のマップ定義に変換できます。インポート機能については，「17. メインフレームの画面・帳票をPCへ移行する」を参照してください。ただし，一部の機能については変換に制限があります。メインフレームのXMAPとPCのXMAP3の機能差については，「付録B　メインフレームとの処理分散」を参照してください。

なお，XMAP3外字機能で1,880字を超える外字を使用する場合でも，ドローで使用できる外字は，シフトJISコードでも使用できる1,880字だけです。つまり，固定テキストなどの項目に，標準以外の外字を表示させることはできません。

＜この節の構成＞

14.2.1　「日本語」項目の定義

14.2.2　下位項目の定義

14.2.3　EAGLE/4GLのプログラムを移行する

14.2.1　「日本語」項目の定義

使用目的を「日本語」，データ型を「文字」と設定した場合，生成される論理項目のデータ長は，メインフレームで利用するコードを意識して，通常は「物理長の約3倍」の長さになります。

論理項目のデータ長を，アプリケーションで利用する文字列（物理長の3倍以下の長さ）に合わせて調整できます。ドローのダイアログで「データ長を変更する」ボタンをオンにして，調整します。

14.2.2　下位項目の定義

使用目的を「日本語」，データ型を「文字」と設定したフィールドで，下位項目を使用する場合，ドローのダイアログで「データ長を変更する」ボタンをオンにしてください。「データ長を変更する」ボタンがオフの場合，下位項目を定義しても，生成された論理マップには反映されません。

なお，使用目的を「日本語」，データ型を「文字」に設定するのは，パネル定義文のLOGFLD文でCODEオペランドにN（混在），LNGオペランドのピクチャにCを指定した場合に相当します。

14.2.3　EAGLE/4GLのプログラムを移行する

EAGLE/4GLの画面定義をXMAP3に移行する場合に，注意が必要な点を説明します。

EAGLE/4GLで生成されるマップ定義文は，XMAP3には流用できません。

プログラムだけを流用し，画面をXMAP3で作り直す場合は，次に説明する点を変更してください。

論理マップの形式

論理マップの形式は，ターゲット「Windows用の画面・帳票開発」のビックエンディアンと同じになります。詳細については，マニュアル「XMAP3 プログラミングガイド 画面編」，マニュアル「XMAP3 プログラミングガイド 帳票編」を参照してください。

論理マップの項目名

XMAP3では，論理マップの項目名は，次のような形式になります。

入力項目

マップ名-項目の名称I

出力項目

マップ名-項目の名称O

したがって，XMAP3で生成した論理マップの項目名を，EAGLE/4GLのソースに合わせて修正してください。

混在項目の論理長

混在項目の論理長は，メインフレームとPCとの文字コードが異なるので，XMAP3の自動調整を利用する場合は，次の式で計算してください。

論理長＝桁（項目長）×7÷3＋3

ただし，ドローのダイアログで「データ長を変更する」ボタンをオンにしている場合は，ダイアログで指定したデータ長となります。

EAGLE/4GLについては，マニュアル「EAGLE/4GL 文法」およびマニュアル「EAGLE/4GLによる業務開発」を参照してください。

14.3　マップ生成とファイル転送

＜この節の構成＞

14.3.1　マップを生成する

14.3.2　マップファイルの転送

14.3.1　マップを生成する

ドローが作成するマップファイルは，そのまま分散処理に利用できますが，複数の画面・帳票のマップ生成を一括して実行したい場合はユティリティのマップ生成機能を利用します。

ユティリティメインダイアログで「マップ生成」を選択し，［実行］ボタンをクリックします。

マップ生成ダイアログが表示されます。

「ファイルの選択」の［参照...］ボタンをクリックします。
ファイルの選択ダイアログが表示されます。入力となるファイルの種類と，マップ生成したいファイルのファイル名を選択し，［開く］ボタンをクリックします。選択したファイルが，選択状態でリストボックスに表示されます。なお，リスト中のファイルの選択状態を解除すると，マップ生成の対象外にできます。

マップ生成ダイアログに「ファイルの出力先」を指定します。
次に示すファイルの出力先を指定します。
・物理マップ出力先
・論理マップ出力先
・結果リストファイル出力先
すべてのファイルの出力先を同じにする場合は，「全ての出力先」をチェックしてください。
各種ファイルの出力先などを変更する場合は，「ファイルの出力先」の［参照...］ボタンをクリックして設定してください。

各種オプションを設定する場合は，［環境設定...］ボタンをクリックします。
環境設定ダイアログが表示されます。環境設定については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。
必要な項目を設定して［OK］ボタンをクリックすると，マップ生成ダイアログに戻ります。

［生成］ボタンをクリックします。
マップ生成機能が実行されます。実行後，マップ生成ダイアログに戻ります。生成されるファイルを次に示します。
・入力論理マップ（xxxI.CBL）
・出力論理マップ（xxxO.CBL）
・物理マップ（xxx.PMP）
また，ユティリティのマップ生成機能で，マップ生成ができなかった場合，XMAP3は生成結果エラーファイル（.ERR）にエラーメッセージを出力します。エラーメッセージの内容から問題の原因を推定し，誤りを訂正してください。各種エラーメッセージに対する誤りの訂正方法については，「14.5　画面・帳票作成時のメッセージ」を参照してください。

マップ生成によって出力された結果リストファイルを表示したい場合には，［エディタ起動...］ボタンをクリックします。
エディタが起動されます。このとき使用するエディタを変更したい場合は，［環境設定...］ボタンをクリックして，環境設定ダイアログで設定してください。

注意事項

マップ生成の結果リストは，起動ごとに同じファイル名になるので，結果を別ファイルとして保存したい場合は，結果リストの表示時に別名で保存してください。

14.3.2　マップファイルの転送

XMAP3で作成したマップのうち，入力論理マップと出力論理マップをメインフレームに転送します。さらに，XMAP3で提供されている通信論理マップもメインフレームに転送します。通信論理マップは，「XMAP3インストールフォルダ¥INCLUDE¥X3HOSTBL」として提供されています。

なお，メインフレーム上のAPで動的変更を利用する場合は，ドローセットアップで生成された動的変更テーブル（X.MODTBL.CBL）もメインフレームに転送してください。

「XMAP3インストールフォルダ¥INCLUDE¥X3HOSTBL」は，PC上のCommuniNetでIFITを使用してVOSKへ転送します。IFITについては，マニュアル「コマンド」，またはマニュアル「パネル」を参照してください。

(a)　メインフレーム上の出力ファイルの属性

メインフレーム上に出力するファイルは次に示す属性にしてください。

レコード形式は固定長

レコード長は80バイト

ファイルタイプはMAP

(b)　CommuniNetの環境を設定する

CommuniNetの環境設定ユティリティを起動します。「端末名称」は転送するファイルの置かれている端末を選択して，「設定項目」の「ファイル転送」をダブルクリックします。ファイル転送の設定ダイアログが表示されるので，「コード変換」を「あり」にして，［OK］ボタンをクリックします。

(c)　IFITのメニュー画面を使用して転送する場合

IFITのメニュー画面を使用して転送する手順を説明します。

ファイル転送機能の呼び出し

操作マスタメニューの項目3「ファイル操作」を選択します。

ファイル操作メニューの項目9「ファイルの伝送」を選択します。

ファイル伝送メニューの項目9「WSとのファイル転送」を選択します。

転送するファイルの設定

「入力ファイル名」の項に，PCから転送するファイル名を指定します。

「出力ファイル名」の項に，メインフレーム上に出力するファイル名を指定します。このとき，PC上のファイルに付いていた拡張子は付けないでください。

「レコード末尾の埋字」として「16#40」を指定してください。

(d)　IFITコマンドを使用して転送する場合

IFITコマンドを使用した転送の形式は，次のとおりです。

コマンド
オペランド

IFIT
,IN=PCから転送するファイル名
,OUT=メインフレーム上に出力するファイル名
,PADDING=16#40

14.4　APの作成と実行

＜この節の構成＞

14.4.1　APの作成

14.4.2　AP実行時のVOSK側の動作

14.4.3　AP実行時のPC側の動作

14.4.4　AP実行時の外字の扱い

14.4.1　APの作成

メインフレーム上のAPには，PCから転送した入力論理マップ，出力論理マップ，および通信論理マップを取り込んでください。

また，メインフレーム上のAPで動的変更を行う場合は，さらに動的変更テーブル（X3MODTBL.CBL）も取り込んでください。なお，メインフレーム側に転送する場合は論理マップと同じ形式で転送してください。動的変更テーブルを更新した場合は，再度取り込む必要があります。動的変更テーブルが更新されるケースについては，「13.1　開発環境の設定」を参照してください。

分散システム用のAPを作成するときの注意事項については，「15. VOSKでのAP作成と実行」を参照してください。

14.4.2　AP実行時のVOSK側の動作

メインフレーム上のAPから，PC上の画面・帳票入出力処理に論理マップのデータを転送するときは，拡張ホストアクセス機能を使用します。なお，VOSK側から転送される論理マップのデータは，KEISコードのまま利用できます。

14.4.3　AP実行時のPC側の動作

メインフレームからの要求は，PC上のGCASTを経由してXMAP3に送られます。XMAP3は，物理マップおよび論理マップを基にして，画面・帳票への入出力を行います。

14.4.4　AP実行時の外字の扱い

メインフレームとPCとでは文字コードが異なるため，メインフレームとPCの間でやり取りされるデータの文字コードは，XMAP3で変換します。文字コードの変換については，「付録B.2　文字コードの違い」を参照してください。ただし，データに含まれる外字については，外字の運用形態によって文字コードの変換方法が異なります。

＜この項の構成＞

(1)　標準の外字用コードの対応に従う場合

(2)　シフトJISとKEISの外字マッピングテーブルをカスタマイズした場合

(3)　XMAP3外字機能を使用する場合

(1)　標準の外字用コードの対応に従う場合

XMAP3でKEISとシフトJISの外字コードを変換します。外字コードの対応については，「付録B.3　外字用コードの割り当て」を参照してください。

(2)　シフトJISとKEISの外字マッピングテーブルをカスタマイズした場合

コード変換ランタイム，日立コード変換 - Client Runtime，または日立コード変換 - Server Runtimeがインストールされている場合，XMAP3では外字マッピングテーブルに基づいて外字の文字コードを変換します。外字マッピングテーブルは「コード変換ランタイムのインストールフォルダ¥TABLE」，「日立コード変換 - Client Runtimeのインストールフォルダ¥TABLE」，または「日立コード変換 - Server Runtimeのインストールフォルダ¥TABLE」に「GJISKEI.TBL」という名前でコピーしておいてください。

(3)　XMAP3外字機能を使用する場合

コード変換ランタイムがインストールされている場合，XMAP3では外字マッピングテーブルに基づいて外字の文字コードを変換します。

また，XMAP3外字機能を使用する場合，文字コードにはUnicodeを使用します。PC上でUnicodeの外字を入力するためには，VJE-Delta for Unicode/XKPを使用してください。ただし，内字の入力はほかの日本語入力システムでも可能です。

UnicodeとKEISの外字マッピングテーブルをカスタマイズしている場合は，「コード変換ランタイムのインストールフォルダ¥TABLE」に外字マッピングテーブル「GUNIKEI.TBL」をコピーしておいてください。

14.5　画面・帳票作成時のメッセージ

画面・帳票の作成時，ドローやユティリティでマップを生成するときに，次に示す定義がある場合，エラーメッセージを出力します。

マップの生成時にオブジェクトを破棄，または設定内容を変更しているもの。

エラーが発生した場合でも，パネル定義文は出力されます。

＜この節の構成＞

(1)　エラーファイルの形式

(2)　出力するメッセージの詳細

(3)　メッセージの詳細

(1)　エラーファイルの形式

エラーファイルのファイル名は，「マップ定義ファイル名.ERR」です。エラーファイルは，マップファイルの出力先に出力されます。

(2)　出力するメッセージの詳細

出力するメッセージの形式を次に示します。

［メッセージID］

［位置情報］［メッセージテキスト］

(a)　メッセージID：X3EHnnn-y

X3EH

パネル定義文生成時のメッセージであることを示します。

nnn

メッセージ通番を示します。

y

メッセージの種類を示します。出力されるメッセージの種類を次に示します。

I：警告メッセージ
マップの生成時にオブジェクトを破棄，または設定内容を変更しているもの。

(b)　位置情報

メッセージ出力対象のオブジェクトのドロー上の定義位置を示します。なお，レイアウト全体に関するメッセージなど，位置情報を持たない場合は出力しません。

出力例を次に示します（xxxxxは5けたの数字を示します）。

フレーム外の場合
［縦xxxxxます，横xxxxxます］

フレーム内の場合
フレーム名［縦xxxxxます，横xxxxxます］

(c)　メッセージテキストの詳細

メッセージテキストについて説明します。

（S）エクスポートの処理
メッセージを出力した後の主な処理を示します。

（P）プログラマの処置
メッセージを受け取ったプログラマが取るべき処置を示します。

(3)　メッセージの詳細

個々のメッセージについて説明します。なお，ここで記述しているのは画面・帳票作成時に出力されるメッセージだけです。XMAP3全体に共通のメッセージについては，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

X3EH205-I

［位置情報］　｛予約フィールド｜予約テキスト｜入出力フィールドの下位項目｜入力フィールドの下位項目｜出力フィールドの下位項目｜入出力テキストの下位項目｜入力テキストの下位項目｜出力テキストの下位項目｝を破棄しました

予約フィールドまたは予約テキストを指定している。

使用目的が日本語で，さらにデータ型として「文字（XX）」を指定した入力／出力／入出力フィールドまたはテキストに，下位項目を指定している。

（S）指定されたオブジェクトを破棄して，マップを生成します。

（P）該当するオブジェクトを指定しないでマップ定義ファイルを再作成したあと，画面・帳票定義の保存を再実行してください。

X3EH207-I

画面属性の次画面指定を破棄しました

GUI画面，またはCUI画面の画面属性で次画面を指定している。

（S）指定された画面属性を破棄して，マップを生成します。

（P）該当する画面属性を指定しないマップ定義ファイルを再作成したあと，画面・帳票定義の保存を再実行してください。

15.　VOSKでのAP作成と実行

この章では，VOSKとPCの分散処理の仕組みについて，またAP作成の注意事項について説明します。VOSK上でAPを作成するときの参考にしてください。

＜この章の構成＞

15.1　VOSKとGCASTのインタフェース

15.2　AP作成時の注意事項

15.1　VOSKとGCASTのインタフェース

VOSKのAPとPC上のXMAP3に処理を分散する場合は，データの送受信にOSCF/GCASTを使用します。

＜この節の構成＞

15.1.1　OSCF/GCASTでの拡張ホストアクセス

15.1.2　対話環境でのインタフェース

15.1.1　OSCF/GCASTでの拡張ホストアクセス

＜この項の構成＞

(1)　APとGCASTの連携

(2)　GCASTでの論理マップ長

(1)　APとGCASTの連携

OSCF/GCASTのインタフェース機能を使用した対話環境での拡張ホストアクセス機能によって，VOSK上のAPとGCASTが連携する仕組みを次の図に示します。

図15-1　対話環境でのAPとGCASTの連携

JGUOPENモジュールの呼び出し

メインフレームAPからPCに対して，CALL文でJGUOPENモジュールを呼び出します。

PCでは，XMAP3の仮想端末が開かれます。

JGUTRANSモジュールの呼び出し

メインフレームAPは，JGUOPENモジュールを呼び出したあと，APからJGUTRANSモジュールを呼び出します。

JGUTRANSモジュールの呼び出しを受けて，PCでは，XMAP3で画面の入出力を行います。

XMAP3の仮想端末からGCASTを経由して，ユーザデータをメインフレームに送信します。

メインフレームAPでは，データを受信し，処理します。

業務終了まで，2.の各手順を繰り返します。

JGUCLOSEモジュールの呼び出し

画面の送受信がすべて終了したら，メインフレームAPから，JGUCLOSEモジュールを呼び出します。

PC上のGCASTでは，XMAP3の仮想端末を終了します。

GCASTのインタフェース機能については，マニュアル「GUIシステム構築支援 OSCF/GCAST」を参照してください。

(2)　GCASTでの論理マップ長

画面の論理マップが2,930バイトより大きい場合，メインフレームAPからの1回の画面出力に対して，メインフレームとPCのGCAST間で2,930バイトごとに分割して複数回の通信が行われます。このため，画面表示の性能が低下することがあるので，1画面分の論理マップを2,930バイト以下にすることをお勧めします。

メインフレームAPがJGUTRANSモジュールを呼び出したあとに2,930バイトより大きい論理マップを送信した場合に，画面データが分割される仕組みを次の図に示します。

図15-2　画面データが分割される仕組み（画面データが4,500バイトの場合）

3,000バイト送信

メインフレームAPは，4,500バイトの画面データを送信します。

メインフレームのGCASTは，メインフレームAPが送信した4,500バイトの画面データを，一度に送信できるデータ量の3,000バイトと残りの1,500バイトに分割します。

メインフレームのGCASTは，PCのGCASTに対して，3,000バイトの画面データを送信します。

1,500バイト送信

メインフレームのGCASTは，PCのGCASTに対して，残りの1,500バイトの画面データを送信します。

PCは，メインフレームからすべての画面データを受信したあと画面を表示します。

3,000バイト返信

PCは，4,500バイトの画面データを返信します。

PCのGCASTは，PCが返信した4,500バイトの画面データを，一度に返信できるデータ量の3,000バイトと残りの1,500バイトに分割します。

PCのGCASTは，メインフレームのGCASTに対して，3,000バイトの画面データを返信します。

1,500バイト返信

PCのGCASTは，メインフレームのGCASTに対して，残りの1,500バイトの画面データを送信します。

メインフレームのGCASTは，メインフレームAPに対して4,500バイトの画面データを返信します。

15.1.2　対話環境でのインタフェース

＜この項の構成＞

(1)　論理マップの取り込み

(2)　通信論理マップ

(3)　通信論理マップとAPの連携

(1)　論理マップの取り込み

VOSKとPCに処理を分散する環境では，VOSKとPC間で論理マップのデータをやり取りします。このとき論理マップは，COPY文でVOSKのAPに取り込まれます。COPY文は，APのWORKING-STORAGE SECTIONまたはLINKAGE SECTIONに指定します。ただし，論理マップ中に定数を展開させている場合は，LINKAGE SECTIONには取り込めません。

（例）

(2)　通信論理マップ

分散処理をするため，通信論理マップをメインフレーム上のAPに取り込みます。通信論理マップは「XMAP3インストールフォルダ¥INCLUDE¥X3HOSTBL」として提供されています。

通信論理マップの形式を次の表に示します。

表15-1　通信論理マップの形式

エリア名称
長さ
（位置）
データ形式
データ内容

XMAP-CD-MHLNG
2(0)
S9(4)COMP
通信論理マップ長

XMAP-CD-RSV1
2(2)
S9(4)COMP
予備

XMAP-CD-RTN
2(4)
9(4)COMP
リターンコード

XMAP-CD-RSN
2(6)
9(4)COMP
リターンコード詳細

XMAP-CD-TNAME
8(8)
X(8)
仮想端末名称

XMAP-CD-PMAPNAME
8(16)
X(8)
物理マップ名称をEBCDIKコードでセット

XMAP-CD-INLNG
2(24)
S9(4)COMP
入力論理マップ長の最大値

XMAP-CD-OPT
1(26)
X
マッピングオプション

XMAP-CD-DCODE
1(27)
X
データ有無コード

XMAP-CD-RSV2
36(28)
X(36)
予備
(00)₁₆でヌルクリア

注

通信論理マップ用定数の場合，エリア名称の「CD」の部分が「CDT」になります。

(3)　通信論理マップとAPの連携

メインフレームとPCに処理を分散する環境では，メインフレーム側からPC側へ，どのようにして入出力命令が渡されているのかを，インタフェース機能の実行順序を示して説明します。

インタフェース機能発行時に使用するCALL文の形式については，マニュアル「GUIシステム構築支援 OSCF/GCAST」を参照してください。

(a)　メインフレームからPCに対する送受信命令

OPENインタフェース機能：PCにオープン命令を出す。

TRANSCEIVEインタフェース機能：PCにデータを送信し，PCの画面で編集されたデータを受信する。出力および入力するデータ数だけ，処理を繰り返す。

CLOSEインタフェース機能：PCにクローズ命令を出す。

(b)　各命令と通信論理マップの関連

それぞれの命令発行時と通信論理マップの設定値の関連を表15-2，表15-3および表15-4に示します。

表15-2　OPENインタフェース機能発行時の通信論理マップの設定値

データ項目名 | 指定内容
通信論理マップ長 | 64とする。
予備 | (0000)₁₆とする。
リターンコード | (0000)₁₆とする。
詳細コード | (0000)₁₆とする。
仮想端末名称 | X3MWHOSTに指定した仮想端末名称を指定する。※
物理マップ名 | (00)₁₆でヌルクリアする。
入力論理マップ長の最大値 | (0000)₁₆とする。
マッピングオプション | (00)₁₆とする。
データ有無コード | データ有無コードを指定する。
予備 | (00)₁₆でヌルクリアする。

注※

仮想端末の画面をオープンするときに，出力先が一つだけならば，指定を省略できます。指定を省略する場合，(40)₁₆で8バイトクリアしてください。

表15-3　TRANSCEIVEインタフェース機能発行時の通信論理マップ設定値

論理マップ名
データ項目名
指定内容

通信論理マップ
通信論理マップ長
64とする。

予備
(0000)₁₆とする。

リターンコード
(0000)₁₆とする。

詳細コード
(0000)₁₆とする。

仮想端末名称
X3MWHOSTに指定した仮想端末名称を指定する。※¹

物理マップ名
EBCDIKコードで入出力する物理マップ名を，デバイスIDを付けて，左詰めで指定する。残りは空白とする。

入力論理マップ長の最大値
入力論理マップの長さの最大値を指定する。

マッピングオプション
スペースまたは'0'：マージ※2
'2'：論理マップだけ※3
'3'：物理マップだけ※4
指定しない場合は(00)₁₆でヌルクリアする。

データ有無コード
設定しない。

予備
(0000)₁₆とする。

出力論理マップ
論理マップ長
出力論理マップ長を指定する。

予備
(0000)₁₆とする。

出力論理データ
出力論理データを設定する。

入力論理マップ
XMAP3によって設定されるので，明示的に設定する必要はない。受信後参照する場合は入力論理マップにコピーすること。

注※1

入出力先の仮想端末名称を指定します。対応するオープン命令発行時と同じ仮想端末名称を指定してください。

注※2

論理項目，または制御項目に指定したデータを使って画面を表示します。ただし，表示属性の変更指示をしない項目の属性は，画面定義時に指定した表示属性となります。

注※3

論理項目，または制御項目に指定したデータを使って画面を表示します。ただし，表示属性の変更指示をしない項目の属性は，前画面の表示属性となります。また，データの指定がない項目は，前画面のデータをそのまま表示します。

注※4

論理項目，または制御項目に指定したデータを無視して，画面定義時の情報だけで画面を表示します。

表15-4　CLOSEインタフェース機能発行時の通信論理マップの設定値

データ項目名 | 指定内容
通信論理マップ長 | 64とする。
予備 | (0000)₁₆とする。
リターンコード | (0000)₁₆とする。
詳細コード | (0000)₁₆とする。
仮想端末名称 | X3MWHOSTに指定した仮想端末名称を指定する。※
物理マップ名 | 設定しない。
入力論理マップ長の最大値 | 設定しない。
マッピングオプション | 設定しない。
データ有無コード | 設定しない。
予備 | (00)₁₆でヌルクリアする。

注※

クローズする仮想端末名称を指定します。対応するオープン命令発行時と同じ仮想端末名称を指定してください。

15.2　AP作成時の注意事項

メインフレームでAPを作成する場合，または既存のメインフレーム用APを流用する場合は，次の点に注意してください。

＜この節の構成＞

15.2.1　論理マップの項目名

15.2.2　論理マップの長さ

15.2.3　変更属性定義

15.2.4　16進指定（DFC）の動的変更

15.2.5　仮想端末名称の割り当て方法

15.2.1　論理マップの項目名

XMAP3で定義した論理マップは，次のような形式になります。

入力項目

マップ名-項目の名称I

出力項目

マップ名-項目の名称O

新しくAPを作成する場合，プログラム中の論理マップの項目名を，上に示した形式に一致させてください。また，メインフレームで利用していたCOBOLのAPを流用する場合，論理マップの項目名が上に示した形式に一致しているかどうかを確認してください。一致していない場合，論理マップまたはAPを修正してください。

15.2.2　論理マップの長さ

メインフレームとPCの間で，一度に通信できるデータの大きさは2,930バイトまでです。したがって，画面の論理マップが2,930バイトより大きい場合，メインフレームAPからの1回の画面出力に対して複数の通信が行われますので，画面表示性能が低下することがあります。1画面分の論理マップを2,930バイト以下にすることをお勧めします。

15.2.3　変更属性定義

テキスト・フィールドの変更属性定義，ボタン・リスト・メニューの変更属性定義，およびウィンドウ表示制御の変更属性定義は，XMAP3のドローセットアップの表示属性の動的変更ダイアログで設定できます。

15.2.4　16進指定（DFC）の動的変更

16進指定（DFC）の動的変更はXMAP3からは設定できません。APで動的変更が必要な場合は，修飾名を動的変更領域に設定してください。なお，XMAP3では，ドローセットアップでの設定に応じて動的変更テーブルが自動的に生成されます。

動的変更を元に戻すときは，APからデータ有無コードを動的変更領域に設定してください。

15.2.5　仮想端末名称の割り当て方法

OSCF/GCASTで定義する通信エンティティ名は，各端末ごとに重複しない名称を割り当てる必要があります。通信エンティティ名とXMAP3の仮想端末名称を同一にすると，APから通信エンティティ名を取得し，仮想端末名称として利用できます。これによって，端末数分のAPを用意することなく開発効率が向上します。

通信エンティティ名をAPから取得するには，&#WSコマンド変数の値を参照します。

&#WSコマンド変数については，マニュアル「コマンド」を参照してください。

16.　トラブルシューティング

この章では，VOSKとPCに処理を分散する環境でのトラブルとその対処方法について説明します。

マニュアル「XMAP3 開発・実行ガイド」も参照してください。

＜この章の構成＞

16.1　回線接続時のトラブルと対処方法

16.2　画面出力時のトラブルと対処方法

16.3　CommuniNet Extension使用時のトラブルと対処方法

16.1　回線接続時のトラブルと対処方法

回線接続に関するトラブルについて，その対処方法を説明します。

「回線接続エラー」が発生する。

IPアドレスまたはゲートウェイアドレスが誤っています。

コントロールパネルの「ネットワーク」で，「TCP/IP（プロトコル）」を選び，IPアドレスとゲートウェイアドレスを正しく設定してください。

「AP識別子とメインフレーム名の設定に誤りがあります」というメッセージが表示される。

CommuniNetで設定したメインフレーム名が誤っています。

CommuniNetの環境設定ユティリティで［通信情報］の［接続先サーバ名］を正しく設定してください。

16.2　画面出力時のトラブルと対処方法

画面表示のトラブルについて，その対処方法を説明します。

画面が出力できない。

通信論理マップの内容を記述する文字コードに，シフトJISが使用されています。通信論理マップは，EBCDIKおよびKEISコードを使用して記述してください。

または，XMAP3で定義した仮想端末名称とGCASTで定義した仮想端末名称が一致していません。それぞれの仮想端末名称を一致させてください。

画面に文字化けが生じる。

通信論理マップの内容を記述する文字コードに，シフトJISが使用されています。

通信論理マップは，EBCDIKおよびKEISコードを使用して記述してください。

XMAP3でオープンエラーが出る。

マップがリトルエンディアンで作成されているか，またはPC側でパラメタ長を設定しているためにパラメタの長さが不正に解釈されている可能性があります。

パラメタ長が正しく設定されているかどうか見直してください。

16.3　CommuniNet Extension使用時のトラブルと対処方法

CommuniNet Extension使用時のトラブルと対処方法については，「付録B.5　CommuniNet Extensionを使用したメインフレーム・PC連携機能でのトラブルと対処方法」を参照してください。

17.　メインフレームの画面・帳票をPCへ移行する

この章では，メインフレームの画面・帳票をPC用に変換するためのインポート機能について説明します。PC用に変換した画面・帳票は，PC上で自由に編集できます。

＜この章の構成＞

17.1　画面・帳票を変換する手順

17.2　パネル定義文をPCに転送する

17.3　パネル定義文の編集

17.4　ドローセットアップでの指定

17.5　ファイルの変換

17.6　ドローによる編集

17.1　画面・帳票を変換する手順

＜この節の構成＞

17.1.1　定義を修正する

17.1.1　定義を修正する

画面・帳票定義には，インポート機能ではそのまま変換されない機能があります。そのため，定義を修正したり，定義し直す必要があります。

インポート機能では変換しない定義およびそのままの形では変換されない定義について次の表に示します。また，変換できる範囲については，「付録C.1　インポート機能で変換できる画面・帳票の機能範囲」を参照してください。

表17-1　メインフレームとPCとで違いが生じる定義

種別
メインフレームでの定義
ユーザの対応

共通
560/20 DS2，HT-2311，HT-5344以外のデバイス指定
パネル定義文修正

COBOL以外の言語で使用するパネル定義文
パネル定義文修正

16進数による指定※¹
パネル定義文修正

16進DFC
ドローセットアップ
（パラメタ設定）

論理項目の展開順序※²
ドロー

マップ名称のない論理項目
ドローおよび
ドローセットアップ

従論理項目の繰り返し※³
－

物理フレームのない論理フレーム
－

画面
ページング（複数のLOGSEG文，PHSEG文）
パネル定義文修正

論理マップ属性（LOGSEG文のREDEF以外のオペランド，PHSEG文のNULLオペランド，およびCTLFLD文）
ドローセットアップ

CTLFLD文によるカーソル指定
ドローセットアップ
（10進指定はなし）

表示属性の動的変更※⁴
（MODCTLおよびMODATTR）
ドローセットアップ

イベント通知コード
（PHSEG文のINCオペランド）
ドローセットアップ

隠しフィールド（LOGFLD文のPOSオペランドにDUMMYを指定）
ドローによる編集

帳票
PHSEG文でCSCFオペランドを指定していない帳票※⁵
－

論理マップ属性（LOGSEG文のREDEF以外のオペランド，およびCTLFLD文）
ドローセットアップ

CTLFLD文によるコピー枚数の動的変更※⁴のデータ名
ドローセットアップ

ページプリンタ帳票のけい線のDFC
パネル定義文修正
またはドロー

書式
タイプ1/2/R書式
－※⁶

（凡例）

パネル定義文修正：インポート機能で変換する前に，パネル定義文の内容を修正する。「17.3　パネル定義文の編集」を参照のこと。

ドローセットアップ：インポート機能で変換する前に，ドローセットアップで指定する。「17.4　ドローセットアップでの指定」を参照のこと。システムで統一した設定となる。

ドロー：インポート機能で変換したあとのマップ定義ファイルを，ドローを利用して編集する。「17.6　ドローによる編集」を参照のこと。

－：ユーザによる対応はなし。

注※1

VARFLD文，CNSFLD文，およびLOGFLD文のVALオペランドでのNX指定（16進数によるKEISコード直接指定）は変換できるので，修正の必要はありません。

注※2

インポート機能の変換オプションを利用して，論理項目順に論理マップを展開できますが，論理項目の展開順序は，ドロー機能の「データ名編集」ダイアログで編集できる範囲となります。CTLFLD文のTYPEオペランドでのATTR指定位置で論理項目を展開する場合や，展開順序を変更する場合は，ドロー機能の「データ名編集」ダイアログで編集してください。

注※3

XMAP3では，従論理項目の繰り返しを定義できません。インポート機能では，従論理項目の長さを（繰り返し回数）×（項目長）として変換します。

注※4

パネル定義文中にある動的変更属性の有無についてはインポートされますが，動的変更属性の内容は「17.4.3　項目の表示属性動的変更」に示す適用オブジェクトグループの内容となります。

また，ドローセットアップで修飾名をすべて削除，または適用外としている場合，動的変更属性を設定できません。したがって，このような設定環境で，動的変更属性を定義したパネル定義文をインポートしても「動的変更なし」としてインポートされます。

注※5

PHSEG文のCSCFオペランドを指定していない場合，次の値を指定したものとして変換します。

・基準字間値：0I

・基準文字サイズ：9ポイント

文字サイズはメインフレーム用のパネル定義文では指定できませんが，XMAP3では上記の値を使用します。

注※6

タイプ1/2/R書式定義をPC用に変換できます。詳しくは，「18. メインフレームのタイプ1/2/R書式をPCへ移行する」を参照してください。

17.2　パネル定義文をPCに転送する

変換対象となるメインフレーム用のパネル定義文を，PC上に転送します。

＜この節の構成＞

17.2.1　VOS3からPCへの転送

17.2.2　VOS1からPCへの転送

17.2.3　VOSKからPCへの転送

17.2.4　転送時の注意事項

17.2.5　変換オプションの設定

17.2.1　VOS3からPCへの転送

IFITについては，マニュアル「ファイル伝送プログラムIFIT-TSS E2」を参照してください。転送するPCでは，CommuniNetを使用します。

(a)　CommuniNetの環境を設定する

CommuniNetの環境設定ユティリティを起動します。「端末名称」はファイルを受信する端末を選択して，「設定項目」の「ファイル転送」をダブルクリックします。ファイル転送の設定ダイアログが表示されるので，「コード変換」を「あり」にして，［OK］ボタンをクリックします。

(b)　IFITのメニュー画面を使用して転送する場合

ファイル伝送機能の呼び出し
IFITコマンドを実行して，ファイル伝送機能の画面を呼び出します。

転送するファイルの設定

「FUNCTION NO.」は1（HOST->TERMINAL）を選択してください。

「HOST DATA SET NAME」には，メインフレーム上のデータセット名を指定してください。

「TERMINAL FILE NAME」の項に，PCで受け取るファイル名を完全なパス名で指定します。なお，拡張子は必ず「.XMP」としてください。

(c)　IFITコマンドを使用して転送する場合

IFITコマンドを使用した転送の形式は，次のとおりです。

コマンド
オペランド

IFIT
△'メインフレーム上のデータセット名'
△PC上のファイル名
△INPUT(HOST)△OUTPUT(TERMINAL)

17.2.2　VOS1からPCへの転送

IFITについては，マニュアル「ワークステーション操作 －パネル編－」，またはマニュアル「ワークステーション操作 －コマンド編－」を参照してください。

(a)　CommuniNetの環境を設定する

CommuniNetの環境設定ユティリティを起動します。「端末名称」はファイルを受信する端末を選択して，「設定項目」の「ファイル転送」をダブルクリックします。ファイル転送の設定ダイアログが表示されるので，「コード変換」を「あり」にして，［OK］ボタンをクリックします。

(b)　IFITのメニュー画面を使用して転送する場合

IFITのメニュー画面を使用して転送する手順を次に示します。

ファイル伝送機能の呼び出し

マスタメニューの項目5「OA業務実行」を選択します。

OA業務実行メニューの項目5「パソコンファイル伝送」を選択します。

対話型ファイル伝送メニューの項目1「LIMEファイルのファイル伝送」を選択します。

転送するファイルの設定
「メインフレーム側ファイル情報」の項に，メインフレームから転送するファイル名などを指定します。また，「ワークステーション側ファイル情報」の項に，PCで受信するファイル名を完全なパス名で指定してください。なお，拡張子は必ず「.XMP」としてください。

(c)　@@IFITコマンドを使用して転送する場合

@@IFITコマンドを使用した転送の形式は，次のとおりです。

コマンド
オペランド

@@IFIT
△FTYPE=LIME
,WSF='PC上のファイル名'
,FILE=メインフレーム上のLIMEファイル名
,LIBRARY=メインフレーム上のLIMEライブラリ名
,MEMBER=メインフレーム上のLIMEメンバ名
,DC=DATA

17.2.3　VOSKからPCへの転送

IFITについては，マニュアル「コマンド」，またはマニュアル「パネル」を参照してください。

(a)　CommuniNetの環境を設定する

CommuniNetの環境設定ユティリティを起動します。「端末名称」はファイルを受信する端末を選択して，「設定項目」の「ファイル転送」をダブルクリックします。ファイル転送の設定ダイアログが表示されるので，「コード変換」を「あり」にして，［OK］ボタンをクリックします。

(b)　IFITのメニュー画面を使用して転送する場合

IFITのメニュー画面を使用して転送する手順を説明します。

ファイル転送機能の呼び出し

操作マスタメニューの項目3「ファイル操作」を選択します。

ファイル操作メニューの項目9「ファイルの伝送」を選択します。

ファイル伝送メニューの項目9「WSとのファイル転送」を選択します。

転送するファイルの設定

「入力ファイル名」の項に，メインフレームから転送するファイル名を指定します。

「出力ファイル名」の項に，PC上に出力するファイル名を指定します。このとき，拡張子は必ず「.XMP」としてください。

(c)　IFITコマンドを使用して転送する場合

IFITコマンドを使用した転送の形式は，次のとおりです。

コマンド
オペランド

IFIT
,IN=メインフレームから転送するファイル名
,OUT=PC上に出力するファイル名

17.2.4　転送時の注意事項

パネル定義文をPCに転送するときに注意が必要な点について説明します。

＜この項の構成＞

(1)　メインフレームから転送したパネル定義文に漢字が含まれる場合

(2)　パネル定義文に外字が含まれる場合

(3)　NAMEオペランドの接頭語がマップ名と同じ場合

(1)　メインフレームから転送したパネル定義文に漢字が含まれる場合

パネル定義文中に漢字が含まれる場合，文字コードがKEISからシフトJISに変換され，全角開始・全角終了コード（X'0A42'，X'0A41'）が取り除かれます。したがって，1行の長さが変わるので，次の場合は注意が必要です。

(a)　パネル定義文に行番号が付いている場合

漢字を含むパネル定義文に73カラム以降の行番号を付けて転送すると，次の図に示すように行番号が72カラム以内に入るので，インポート機能による変換時にエラーとなります。

図17-1　行番号を含む場合

したがって，漢字を含むパネル定義文ファイルは行番号を付けないで転送してください。

(b)　漢字を含む行が継続する場合

漢字のある行が継続する場合，次の図に示すように，行末の位置が変わります。

図17-2　漢字のある行が継続する場合

この場合は，PCに転送したあとで修正するか，インポート機能の変換オプションを設定してください。変換オプションの設定方法は，「17.2.5　変換オプションの設定」を参照してください。

(2)　パネル定義文に外字が含まれる場合

パネル定義文中で外字を16進漢字定数ではなく直接定数で指定している場合，文字コードがKEISからシフトJISに変換されます。

標準の状態では，KEISの外字のうちシフトJISに正しく変換されるのは1,880字までで，文字コードの対応はあらかじめ決められています。KEISの外字用コードとシフトJISの外字用コードとの対応については，「付録B.3　外字用コードの割り当て」を参照してください。

対応するシフトJISコードを持たない外字については，ドローで編集するときに適切な文字に置き換えてください。

(a)　外字マッピングファイルをカスタマイズしている場合

コード変換SDKまたは日立コード変換 - Development Kitを使用して，シフトJISとKEISの外字マッピングファイルをカスタマイズしている場合，CommuniNetの文字コードのマッピングも同様にカスタマイズしてください。

CommuniNetの文字コードのマッピングを変更するには，CommuniNetのコードマッピングユティリティを使用してください。

(b)　XMAP3外字機能を使用している場合

UnicodeとKEISの外字マッピングファイルは文字コードの変換には影響しません。

(3)　NAMEオペランドの接頭語がマップ名と同じ場合

ドローセットアップの［ドローの設定］で，接頭語を付加するように設定している場合，パネル定義文をインポート機能で変換する時に，接頭語が二重に付加されてしまいます。これを避けるために，インポート機能の変換オプションを設定してください。変換オプションの設定方法は，「17.2.5　変換オプションの設定」を参照してください。

17.2.5　変換オプションの設定

「17.2.4(1)(b)　漢字を含む行が継続する場合」または「17.2.4(3)　NAMEオペランドの接頭語がマップ名と同じ場合」に示したパネル定義文を変換する場合，インポート機能による変換を補正するために，変換オプションを設定してください。

インポート機能の変換オプションを設定するには，ユティリティを使用します。なお，オプションの設定は運用管理者が行ってください。

ユティリティメインダイアログで「インポート」を選択し，「詳細」で「端末画面・帳票」を選択して［実行］ボタンをクリックします。

パネル定義文からPCマップ定義変換ダイアログが表示されます。

［設定...］ボタンをクリックします。
オプション設定ダイアログが表示されます。

「17.2.4(1)(b)　漢字を含む行が継続する場合」に示したパネル定義文をそのまま使用する場合，「メインフレームから転送したパネル定義文を使用する」をチェックしてください。

「17.2.4(3)　NAMEオペランドの接頭語がマップ名と同じ場合」に示したパネル定義文を使用する場合，「NAMEオペランドに（マップ名-）の接頭語を使用している」をチェックしてください。

ドロー機能でマップ生成をする場合，「論理／制御項目順（ユーザ定義順）」で論理マップを展開するマップ定義ファイルを生成するときは，「論理セグメント文群の論理／制御項目順の論理マップを使用する（メインフレームのみ）」をチェックしてください。
ドローセットアップ機能の「論理マップ属性」ダイアログの「定義した位置の昇順に生成」の設定値に関係なく，「ユーザ定義順」のマップ定義ファイルが生成されます。
チェックしない場合は，「位置順」で生成されます。
なお，インポート後に「ドローセットアップ反映」をしても，マップ定義ファイルの定義順は「ユーザ定義順」のまま変更されません。
論理項目の展開順序は，ドロー機能の「データ名編集」ダイアログで編集できる範囲となります。CTLFLD文のTYPEオペランドでのATTR指定位置で論理項目を展開する場合や，展開順序を変更する場合は，ドロー機能の「データ名編集」ダイアログで編集してください。
パネル定義文の論理項目の指定で同じデータ名称を使用している場合，このオプション設定は無効となります。

［OK］ボタンをクリックします。
設定内容を登録して，ダイアログを閉じます。

17.3　パネル定義文の編集

＜この節の構成＞

17.3.1　デバイス名のPCでの対応

17.3.2　画面・帳票の構成要素の定義

17.3.1　デバイス名のPCでの対応

インポート機能を使用する場合，PCのXMAP3では利用できない機能については，変換時に無視されます。そのため，パネル定義文の修正が必要になることがあります。

それぞれのデバイスが，PC上でどのような画面・帳票に変換されるかを次の表に示します。

表17-2　デバイスとPCでの定義対象との関連

デバイス
PCでの定義対象

5425,D2※1または4451,D2※1
ディスプレイCUI画面

5344※1
シリアルインパクト けい線 帳票（連続紙）　または
シリアルインパクト けい線 帳票（カット紙）※²

2311※1
ページプリンタ 網掛け帳票

タイプ1/2/R
書式オーバレイ※³

注※1

これらのデバイスは画面・帳票です。これらのデバイスに対応したパネル定義文の構成要素の定義については，「17.3.2　画面・帳票の構成要素の定義」を参照してください。

注※2

PHSEG文のEJECTオペランドに，PICKUP，STACKER，またはRETAINが指定された場合はカット紙，それ以外の場合は連続紙として変換されます。

注※3

これらのデバイス用の定義をPC用に変換する方法については，「18. メインフレームのタイプ1/2/R書式をPCへ移行する」を参照してください。

17.3.2　画面・帳票の構成要素の定義

PCで扱えるようにパネル定義文を変更する必要がある定義について説明します。必要に応じて，パネル定義文だけでなく，APのソースも修正してください。

変換できる機能については，「付録C.1　インポート機能で変換できる画面・帳票の機能範囲」を参照してください。

＜この項の構成＞

(1)　言語種別

(2)　16進数による指定

(3)　ページング

(4)　ページプリンタ帳票のけい線のDFC

(1)　言語種別

インポート機能で変換できるのは，COBOL用のパネル定義文だけです。それ以外の言語用のパネル定義文の場合，変換時にPANEL文のLANGオペランドがC（COBOL）に変更されます。

ただし，データ名は変換しないので，あらかじめCOBOLで使用できるデータ名に変更しておいてください。

(2)　16進数による指定

インポート機能では16進数による指定は変換できません。数値または文字列に変更してください。ただし，次に示す指定については変換できるので，修正する必要はありません。

CNSFLD文

VALオペランドでのNX指定（16進数によるKEISコード直接指定）

VALオペランドでのX指定（16進数による定数直接指定）

LOGFLD文

VALオペランドでのNX指定（16進数によるKEISコード直接指定）

VALオペランドでのX指定（16進数による定数直接指定）

FILLオペランドでのX指定（16進数による定数直接指定）

(3)　ページング

XMAP3はページングに対応していないため，インポート機能でも複数のLOGSEG文およびPHSEG文を含むパネル定義文を変換することはできません。一画面（一組の論理セグメントと物理セグメント）につき一つのパネル定義文になるように，ファイルを分割してください。

(4)　ページプリンタ帳票のけい線のDFC

インポート機能では帳票はすべて「占有」として変換されます。したがって，PHSEG文のCNTRLオペランドにFULLを指定した場合，けい線の開始位置とフィールドの配置とが重なることがあります。この場合，「パネル定義文ファイル名.ERR」にエラーメッセージが出力されますが，マップ定義ファイルは生成されます。ただし，重なったオブジェクトのうち，変換されるのはパネル定義文中で最初に定義された要素だけで，それ以降のものはエラーとなり変換されません。

けい線の開始位置とフィールドが重なって，どちらかが変換されない場合を次の図に示します。

図17-3　けい線とフィールドが重なる定義例

このような場合は，パネル定義文を修正して位置を変更してください。または，変換されたファイルをドローで編集して，変換されなかったオブジェクトを定義し直してください。

17.4　ドローセットアップでの指定

XMAP3では，開発する画面・帳票のアプリケーションとのインタフェースを統一するため，項目の制御情報や論理マップ属性の内容を統一するようになっています。

次に示す内容については，インポート機能での変換時に，パネル定義文の内容をPCでの設定に置き換えます。したがって，変換を実行する前に，個々のパネル定義文の内容から，統一した設定を決めてください。決定した内容は，ドローセットアップで設定します。

画面

イベント通知コード（PHSEG文のINCに相当）

動的変更情報（MODCTL／MODATTRに相当）※

制御項目属性（CTLFLD文に相当）

論理マップ属性（LOGSEG文のCLEAR／CODERR／LITRL／GENRTに相当）

帳票

制御項目属性（CTLFLD文に相当）

論理マップ属性（LOGSEG文のLITRL／GENRTに相当）

また，論理項目名についても統一されるため，アプリケーションプログラムの変更が必要になる場合があります。

ドローセットアップの操作手順については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

注※

パネル定義文中にある動的変更属性の有無についてはインポートされますが，動的変更属性の内容は「17.4.3　項目の表示属性動的変更」に示す適用オブジェクトグループの内容となります。

また，ドローセットアップで修飾名をすべて削除，または適用外としている場合，動的変更属性を設定できません。したがって，このような設定環境で，動的変更属性を定義したパネル定義文をインポートしても，「動的変更なし」としてインポートされます。

なお，カーソル制御やフォーカス制御は，ドロー上で動的変更の有無を指定できないため，パネル定義文での指定に関係なくドローセットアップの設定が有効となります。

＜この節の構成＞

17.4.1　イベント通知コード

17.4.2　画面の表示属性動的変更

17.4.3　項目の表示属性動的変更

17.4.4　制御項目属性

17.4.5　論理マップ属性

17.4.1　イベント通知コード

CTLFLD文（TYPE=INC）とPHSEG文（INCオペランド）の内容は，イベント通知コードダイアログで設定します。パネル定義文でイベント通知コードを指定していても，その指定内容はインポートされず，ドローセットアップでの設定が有効となります

ドローセットアップでイベント通知コードを設定する手順を説明します。

イベント通知コードダイアログを表示させます。

CTLFLD文の内容を設定します。
［通知コードのデータ名］にNAMEオペランドの内容を，［通知コードの長さ］にLNGオペランドの内容を指定します。

PHSEG文のINCオペランドの内容を設定します。
［確定キーを押した時］または［プッシュボタンなどを押した時］でINC種別を選択し，下部の変更欄にINC定数の内容を指定します。

イベント通知コードとドローセットアップとの対応を次の表に示します。

表17-3　イベント通知コードとの対応

パネル定義文
ドローセットアップ

文
オペランド
パラメタ
設定個所
設定内容

CTLFLD
（TYPE=
INC）
NAME
名称
イベント通知コード
通知コードのデータ名

LNG
長さ
通知コードの長さ

PHSEG
INC
（INC種別）
PF1～24
確定キーを押した時
ファンクション
1～24

ENTER
送信

BREAK
割り込み

SCRN
スクリーン表示

PA1～3
PA1キー～PA3キー

PF25～96
（指定できない）
－

PEN
－

*OTHER
－

INC
（INC定数）
文字列
変更欄
通知コード

（凡例）

－：該当なし。

17.4.2　画面の表示属性動的変更

CTLFLD文（TYPE=CNTRL）とPHSEG文（MODCTLオペランド）の内容は，表示属性の動的変更ダイアログで設定します。

また，それぞれの修飾名は，修飾名の設定ダイアログで設定します。

CUI画面の表示属性とドローセットアップの対応を次の表に示します。

表17-4　表示属性との対応（CUI画面）

パネル定義文
ドローセットアップ

文
オペランド
パラメタ
設定個所
設定内容

ダイアログ名
項目名

CTLFLD
（TYPE=
CNTRL）
NAME
名称
表示属性の動的変更
（データ名タブ）
ウィンドウ属性の動的変更
名称

LNG
長さ
修飾名の設定
修飾名長※
長さ

PHSEG
MODCTL
修飾名
修飾名の設定
修飾名※
修飾名

ERASE
表示属性の
動的変更
（ウィンドウ
属性タブ）
表示形態
全面書換

WRITE
一部上書

ERWRT
自動

FRKB
キーボードロック状態を解除する
チェックする

NOFR
チェックしない

ALRM
ウィンドウを表示した時にアラームを鳴らす
チェックする

NOALRM
チェックしない

RESTF
入力フィールドの扱い
入力データをAPに返す

ERUNP
入力データを消去する

IGNRTF
入力データを変更しない

PRINT
（指定できない）
－
－

PRCTL
－
－

（凡例）

－：該当なし。

注※

修飾名の設定ダイアログの「動的変更の種別」で，「ウィンドウ属性」を選んでから設定してください。

なお，次の表に示す定義内容がある場合，動的変更属性ありとしてインポートされます。

表17-5　画面表示属性の動的変更ありとみなされるパネル定義文（CUI画面）

オブジェクト
定義必須の文やオペランド※
制御項目名

ウィンドウ属性
CTLFLD TYPE=CNTRL
PHSEG MODCTL=パラメタ
ドローセットアップで指定した名称

&C1 MODCTL PARM=パラメタ
CTLFLD TYPE=CNTRL
PHSEG MODCTL=&C1

注※

表のセル単位に記述されているパネル定義文は，すべて定義されている必要があります。

17.4.3　項目の表示属性動的変更

可変項目（VARFLD文）の表示属性動的変更（定義文のMODATTRオペランド）を設定する方法を説明します。

＜この項の構成＞

(1)　設定の手順

(2)　設定する内容

(1)　設定の手順

具体的な指定内容は，「(2)　設定する内容」を参照してください。

表示属性の動的変更ダイアログを表示させる

それぞれの分類に相当するタブを選択する

表示属性動的変更の内容を設定する

キャラクタコントロールの場合

オペランドの設定内容に応じて［適用オブジェクトグループ］を選択してから，［更新］ボタンをクリックします。

表示属性の動的変更の更新ダイアログが表示されるので，以降に示す表に従って内容を設定します。

設定したら［OK］ボタンをクリックして，表示属性の動的変更ダイアログに戻ります。

［OK］ボタンをクリックする
設定内容が登録されて，ダイアログが閉じます。

(2)　設定する内容

各ダイアログで設定する内容を説明します。

キャラクタコントロールの適用オブジェクトグループについて次の表に示します。

表17-6　パネル定義文と適用オブジェクトグループの対応（CUI画面）

パネル定義文
適用オブジェクトグループ

文
オペランド
パラメタ

LOGFLD文
（TYPE=INOUTまたはINを指定）
LNGのピクチャ指定
Eまたは9
数字系キーエントリ

CODE
KまたはN
日本語系キーエントリ

VARFLD文
（LOGFLD文で
TYPE=INOUT
またはINを指定）
ATTR
NUMまたはPIC
数字系キーエントリ

KEIS
日本語系キーエントリ

KANA
カナ系キーエントリ

ALPH
英数系キーエントリ

MCR
－
英数系キーエントリ

VARFLD文
（LOGFLD文で
TYPE=OUTを指定）
－
－
ラベル

（凡例）

－：該当なし。

項目の表示属性動的変更と，ドローセットアップの対応について次の表に示します。

表17-7　項目の表示属性動的変更との対応（CUI画面）

パネル定義文
ドローセットアップ

文
オペランド
パラメタ
ダイアログ
個所
設定内容

CTLFLD（TYPE=ATTR）
LNG
長さ
修飾名の設定
修飾名長
（長さ）

NAME
データ名
修飾名の設定
データ名
（データ名）

VARFLD
MODATTR
修飾名
修飾名の設定
修飾名
（修飾名）

WHITE
表示属性の動的変更の更新
文字色
白

RED
赤

GREEN
緑

BLUE
青

MAGENTA
紫

CYANIC
空

YELLOW
黄

TRANS
入力済み
返す

NOTRANS
返さない

REVERSE
反転表示
反転あり

NOREV
反転なし

AUTOATN
自動入力
渡す

NOAUTO
渡さない

MENTER
入力必須
エラーにする

NOMENTER
エラーにしない

MCHECK
詳細目的
モジュラスチェックあり

NOMCHECK
モジュラスチェックなし

SKIP
遷移条件
自動スキップ

RJUST
手動スキップ・右寄せ

MFILL
手動スキップ・全桁必須

OVF
手動スキップ

DARK
非表示属性
文字だけ非表示

PROT
入力可否
入力不可

NOPROT
入力可能

BLINK
（指定でき
ない）
－
－

NOBLINK

PRINT

NOPRINT

（凡例）

－：該当なし。

なお，次の表に示す定義内容がある場合，動的変更属性ありとしてインポートされます。

表17-8　項目の表示属性の動的変更ありとみなされるパネル定義文（CUI画面）

オブジェクト
定義必須の文やオペランド※¹
制御項目名

可変フィールド
（出力，入出力を含む）※²
CTLFLD TYPE=ATTR
VARFLD CTLFLD=上記CTLFLD名，
MODATTR=パラメタ
LOGFLD文のNAMEオペランドと同じ名称

出力専用の場合，「APが渡す項目のデータ名」と同じになる。

入力，および入出力の場合，「APが受け取る項目のデータ名」と同じになる。

&A1 MODATTR PARM=パラメタ
CTLFLD TYPE=ATTR
VARFLD CTLFLD=上記CTLFLD名，
MODATTR=&A1

注※1

表のセル単位に記述されているパネル定義文は，すべて定義されている必要があります。

注※2

16進数による直接指定の動的変更（CTLFLD TYPE=(ATTR,X)）の場合，動的変更なしとしてインポートされます。

また，それぞれの修飾名は，修飾名の設定ダイアログで設定します。

17.4.4　制御項目属性

制御項目属性は，CTLFLD文（TYPE=INC,ATTR,(LNG,X)以外）の内容に相当します。CUI画面の場合はカーソルダイアログで，帳票の場合はコピー枚数動的変更のデータ名ダイアログで設定します。

＜この項の構成＞

(1)　CUI画面の制御項目属性

(2)　帳票の制御項目属性

(1)　CUI画面の制御項目属性

CUI画面の制御項目属性は，カーソルダイアログで設定します。

CUI画面の制御項目属性とドローセットアップとの対応について次の表に示します。

表17-9　制御項目属性との対応（CUI画面）

パネル定義文
設定個所

文
オペランド
パラメタ

CTLFLD
（TYPE=OUTCURS,L）
NAME
名称
出力データ名※¹

CTLFLD
（TYPE=OUTCURS,X）
NAME
名称
出力データ名※²

CTLFLD
（TYPE=INCURS,X）
NAME
名称
入力データ名※²

注※1

「論理カーソル」を選択してから設定してください。

注※2

「行列（2進）カーソル」を選択してから設定してください。

(2)　帳票の制御項目属性

帳票の制御項目属性は，コピー枚数動的変更のデータ名ダイアログで設定します。なお，設定する時は，ダイアログの「アプリケーションでの印刷枚数指定領域の生成」をチェックしてください。

帳票の制御項目属性とドローセットアップとの対応について次の表に示します。

表17-10　制御項目属性との対応（帳票）

パネル定義文
設定する個所

文
オペランド
パラメタ

CTLFLD
（TYPE=COPIES,X）
NAME
名称
データ名

網掛け帳票およびグラフィック帳票のコピー枚数属性は，動的変更属性ありでインポートされます。

17.4.5　論理マップ属性

論理マップ属性は，LOGSEG文（CLEARオペランド，CODERRオペランド，LITRLオペランド，GENRTオペランド），CTLFLD文（TYPE=(LNG,X)），PHSEG文（NULLオペランド）の内容です。ドローセットアップの論理マップ属性ダイアログで設定します。

論理マップ属性とドローセットアップとの対応を表17-11および表17-12に示します。

表17-11　論理マップ属性との対応（CUI画面）

パネル定義文 | ドローセットアップ
文 | オペランド | パラメタ | ダイアログの設定個所 | 設定内容
LOGSEG | CLEAR | NO | 初期クリア文字 | なし
FILL | 埋字
LOW | LOW（X'00'）
HIGH | HIGH（X'FF'）
SPACE | スペース
ZERO | ゼロ
CODERR | NO | エラー通知文字 | なし
FILL | 埋字
LOW | LOW（X'00'）
HIGH | HIGH（X'FF'）
SPACE | スペース
ZERO | ゼロ
LITRL | SEP | 定数部の別ファイル出力 | （チェックする）
NOSEP | （チェックしない）
上記以外 | （指定できない） | －
GENRT | SEG | 定数部への論理マップ長出力 | （チェックする）
NOSEG | （チェックしない）
上記以外 | （指定できない） | －
PHSEG | NULL | NO | データ消去通知文字 | なし
FILL | 埋字
LOW | LOW（X'00'）
HIGH | HIGH（X'FF'）
SPACE | スペース

（凡例）

－：該当なし。

表17-12　論理マップ属性との対応（帳票）

パネル定義文 | ドローセットアップ
文 | オペランド | パラメタ | 設定個所 | 設定内容
LOGSEG | LITRL | SEP | 定数部の別ファイル出力 | （チェックする）
NOSEP | （チェックしない）
上記以外 | （指定できない） | －
GENRT | SEG | 定数部への論理マップ長出力 | （チェックする）
NOSEG | （チェックしない）
上記以外 | （指定できない） | －

（凡例）

－：該当なし。

17.5　ファイルの変換

＜この節の構成＞

17.5.1　インポート機能の操作

17.5.2　変換時のメッセージ

17.5.1　インポート機能の操作

インポート機能を呼び出すには，ユティリティを起動して，ユティリティメインダイアログで，［インポート］を選択してください。

インポート機能を呼び出します。
ユティリティメインダイアログで［インポート］を選択し，［詳細］で「端末画面・帳票」が選択されていることを確認して［実行］ボタンをクリックしてください。

パネル定義文からPCマップ定義変換ダイアログが表示されます。

変換元ファイルを選択します。
［変換元ファイルの選択］の［参照...］ボタンをクリックします。ファイルを選択するダイアログが表示されるので，変換元のファイルを選択してください。
なお，選択できるファイルは，拡張子が「.XMP」または「.XMAP」のものだけです。

変換ファイルの出力先を指定します。
［変換ファイルの出力先］の［参照...］ボタンをクリックして，PC用に変換されたマップ定義ファイルを出力するフォルダを選択してください。
変換されたファイルは，「変換元のパネル定義文のPANEL文に指定されたパネル名.IMP」というファイル名で出力されます。そのため，変換元のメインフレーム用パネル定義文の名称と一致しない場合があります。

ファイルを変換します。
［変換］ボタンをクリックして，ファイルの変換を開始します。

17.5.2　変換時のメッセージ

変換結果のメッセージは，出力先のフォルダの「X3UNMP01.TXT」に出力されます。出力されるメッセージを次の表に示します。

表17-13　変換時のメッセージとその意味

出力されるメッセージの内容
意味

（変換元ファイル）を（変換されたファイル）に変換しました。
正常に変換できました。

（変換元ファイル）を（変換されたファイル）に変換しました。
オペランド・定義文の一部に文法エラーがあったので無視しました。
詳細は（PCマップ定義ファイル名.ERR）をご覧ください。
変換できましたが，文法エラーがありました。

オペランド・定義文の一部に文法エラーがあったので（変換元ファイル）を変換できませんでした。
詳細は（PCマップファイル名.ERR）をご覧ください。
文法エラーのため変換できませんでした。

（変換元ファイル）に重大なエラーがあったので処理を中止しました。
システムエラーが発生しました。

（変換元ファイル）は未サポートデバイス，または不正なパネル定義文であるため変換できません。
変換できないファイルが指定されたため，変換できませんでした。

定義文エラーが発生した場合，出力先の「PCマップ定義ファイル名.ERR」にエラーメッセージが出力されます。エラーメッセージの内容は，PC用のマップ生成時のエラーメッセージと同じです。詳細については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

また，画面・帳票のインポートの場合，変換ファイルの出力先フォルダの「X3UNMP01.TXT」に次のようなメッセージが出力されると，マップ定義ファイルへの変換ができません。

「オペランド・定義文の一部に文法エラーがあったので（変換元ファイル）を変換できませんでした。詳細は（PCマップ定義ファイル名.ERR）をご覧ください。」

「（変換元ファイル）に重大なエラーがあったので処理を中止しました。」

「（変換元ファイル）は未サポートデバイス，または不正なパネル定義文であるため変換できません。」

これらのメッセージが出力された場合の対処方法を次に説明します。

＜この項の構成＞

(1)　「オペランド・定義文の一部に文法エラーがあったので（変換元ファイル）を変換できませんでした」の場合

(2)　「（変換元ファイル）に重大なエラーがあったので処理を中止しました。」の場合

(3)　「未サポートデバイス，または不正なパネル定義文である可能性があります。PCのエディタ等で，パネル定義文を開いて内容を確認してください。」の場合

(1)　「オペランド・定義文の一部に文法エラーがあったので（変換元ファイル）を変換できませんでした」の場合

(a)　調査方法

次の方法で，原因を調査してください。

「PCマップ定義ファイル名.ERR」ファイルに出力されるエラーメッセージを確認してください。

インポートのオプション指定で，「メインフレームから転送したパネル定義文を使用する」オプションがオンであることを確認してください。

インポートするパネル定義文がメインフレームのXMAPでコンパイルして，正常に終了するか調査してください。

パネル定義文に次に示す指定があった場合，文法エラーでマップ定義ファイルに変換できません。PCのエディタなどで確認してください。

MODCTL文で16進修飾名指定

PHSEG文のMODCTLオペランドで16進修飾名指定

PHSEG文のDMYFLDオペランドで16進指定

(b)　対処方法

次の方法で，対処してください。

「PCマップ定義ファイル名.ERR」ファイルに出力されるエラーメッセージの対処方法を実施してください。

インポートのオプション指定で，「メインフレームから転送したパネル定義文を使用する」オプションをオンにして再度インポートしてください。

メインフレームのXMAPでコンパイルしてエラーになる場合は，正常になるよう修正してください。

パネル定義文に次の指定があった場合，以下のようにしてください。

MODCTL文で16進修飾名指定

MODCTL文，およびPHSEG文のMODCTLオペランドを削除してください。

PHSEG文のMODCTLオペランドで16進修飾名指定

PHSEG文のMODCTLオペランドを削除してください。

PHSEG文のDMYFLDオペランドで16進指定

PHSEG文のDMYFLDオペランドを削除してください。

(2)　「（変換元ファイル）に重大なエラーがあったので処理を中止しました。」の場合

(a)　調査方法

次の方法で，原因を調査してください。

PCのメモリやディスク容量は，XMAP3が動作する条件を満たしているか確認してください。

インポート実行中に，ほかのプログラムが動作していないか確認してください。

出力先の媒体（フロッピーディスクやMOなど）が，書き込み禁止状態になっていないか確認してください。

出力先の媒体は，正常に読み書きできるか確認してください。

出力先のフォルダに対して，書き込み権限があるか確認してください。

(b)　対処方法

PCのメモリやディスク容量が，XMAP3が動作するには不足している場合は，PCのメモリやディスクを増設し，XMAP3を動作可能にしてください。XMAP3が動作するために必要なPCのメモリやディスク容量については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

インポート実行中にほかのプログラムが動作していた場合，一時的にメモリ不足が発生します。この場合は，ほかのプログラムを終了すると動作することがあります。

出力先の媒体が書き込み禁止状態の場合は，書き込みできる状態にしてください。

出力先の媒体が正常に読み書きできない場合は，ほかの媒体に交換してください。

出力先のフォルダに書き込む権限がない場合は，出力先のフォルダのアクセス権限を変えるか，書き込み権限があるフォルダを出力先に指定してください。

対処しても問題が解決しない場合は，XMAP3のプログラムやレジストリが破壊されていることが考えられます。XMAP3を再インストールしてから，インポートを実行してください。

(3)　「未サポートデバイス，または不正なパネル定義文である可能性があります。PCのエディタ等で，パネル定義文を開いて内容を確認してください。」の場合

(a)　調査方法

未サポートデバイス，または不正なパネル定義文ファイルである可能性があります。PCのエディタ等で，パネル定義文を開いて内容を確認してください。

(b)　対処方法

PHSEG文のDEVオペランドの指定をインポートでサポートしているデバイスに変更してください。

また，メインフレームからPCの転送時に，誤ってEBCDIKやKEISコードのまま転送してしまった場合もこのエラーになります。必ず，JIS8，またはシフトJISコードに変換してください。

17.6　ドローによる編集

PC用に変換されたマップ定義ファイルは，ドローで編集できます。

なお，XMAP3外字機能で1,880字を超える外字を使用する場合でも，ドローで使用できる外字は，シフトJISコードでも使用できる1,880字だけです。つまり，固定テキストなどの項目に，標準以外の外字を表示させることはできません。

また，一部の機能はインポート機能では変換されないので，ドローを使って定義し直す必要があります。

ここでは，再定義が必要になる場合について説明します。

＜この節の構成＞

17.6.1　隠しフィールド

17.6.2　論理項目

17.6.3　フレームと重なるオブジェクト

17.6.4　けい線と重なるフィールド

17.6.5　省略時仮定値の漢字定数

17.6.1　隠しフィールド

隠しフィールド（VARFLD文で，POSオペランドにDUMMYを指定した場合）はインポート機能では変換されません。定義する場合は，ドローの［属性］-［画面属性］コマンドを選択して開かれる，画面属性ダイアログで定義し直してください。

17.6.2　論理項目

＜この項の構成＞

(1)　論理項目長

(2)　展開順序

(3)　ピクチャ文字

(1)　論理項目長

論理項目の長さが項目長よりも長い場合，項目長と同じ長さに変換されます。その場合に，従論理項目が切り捨てられることがあります。項目長よりも長い論理項目については，ドローで確認し，必要に応じて定義し直してください。

(2)　展開順序

論理項目は，配置されている位置の順序（左上から右下へ）または論理／制御項目の順序に従って展開されます。展開順序を修正する場合は，ドローの「属性」メニューの「データ名」を選択して変更してください。

(3)　ピクチャ文字

従論理項目のピクチャ文字列は変換されません。ドローで定義し直してください。

17.6.3　フレームと重なるオブジェクト

XMAP3のドローでは，フレームの領域に単独の項目（固定項目，フレーム外の可変項目，予約項目）やほかのフレームを重ねて配置できません。したがって，このようなフレームとオブジェクトが重なっているパネル定義文をインポートしたとき，次のように変換されます。

固定項目や予約項目が繰り返されているフレームの二つ目以降の領域に，単独の項目が重なっている場合
フレームの繰り返し回数を無視して，繰り返しのないフレームに変換されます。

固定項目や予約項目が繰り返されているフレームの一つ目の領域に，単独の項目が重なっている場合
フレームサイズを調整して重なりを回避します。
ただし，重なったフレーム内に繰り返された可変項目が2個以上の場合，またはサイズを調整しても重なりが回避できない場合は，単独の項目を削除します。

繰り返された可変項目の二つ目以降が，フレームの領域と重なっている場合
可変項目の繰り返し回数を無視して，繰り返しのない可変項目に変換されます。

繰り返された可変項目の一つ目，または繰り返しのない可変項目が，繰り返されたフレームの二つ目の領域と重なっている場合
フレームの繰り返し回数を無視して，繰り返しのないフレームに変換されます。

繰り返された可変項目の一つ目，または繰り返しのない可変項目が，繰り返されたフレームの一つ目の領域と重なっている場合
フレームサイズを調整して重なりを回避します。
ただし，重なったフレーム内に繰り返された可変項目が2個以上の場合，またはサイズを調整しても重なりが回避できない場合は，可変項目を削除します。

繰り返されたフレームの二つ目以降の領域が，ほかのフレーム領域と重なっている場合
フレームの繰り返し回数を無視して，繰り返しのないフレームに変換されます。

繰り返されたフレームの一つ目の領域が，ほかの繰り返されたフレームの一つ目の領域と重なっている場合
フレームサイズを調整して重なりを回避します。どちらかのフレーム内に繰り返された可変項目が2個以上の場合，またはフレームサイズを調整しても重なりが回避できない場合は，重なったフレームを削除します。

17.6.4　けい線と重なるフィールド

ページプリンタ帳票はすべて「占有」として変換されます。そのため，メインフレームでは非占有として定義した帳票では，次に示す場合，重なったオブジェクトのどちらかが変換されません。

横けい線の開始位置または終了位置とフィールドが重なる場合

縦けい線とフィールドが重なる場合

このような場合は，変換されなかったオブジェクトをドローで定義し直してください。けい線とフィールドが重なる場合の対処については，「17.3.2(4)　ページプリンタ帳票のけい線のDFC」を参照してください。

17.6.5　省略時仮定値の漢字定数

ユティリティのインポート機能では，パネル定義文の省略時仮定値（LOGFLD文のVALオペランド）に半角の空白（X'40'）を含む漢字定数を指定している場合，その半角の空白を英数定数（C）に変換します。その結果，省略時仮定値が全角・半角混在となり，マップ生成時に初期値が正しく反映されないことがあります。この場合，インポート機能でPC用のマップに変換したあとで，ドローを使って該当個所を全角空白などに変更してください。また，APで省略時仮定値を意識した処理をしている場合，ドローの変更に従って，処理を見直してください。

18.　メインフレームのタイプ1/2/R書式をPCへ移行する

この章では，メインフレームで使用していたタイプ1/2/R書式の記述文をPC用の書式定義ファイルに変換するためのインポート機能について説明します。PC用に変換した書式定義ファイルは，PC上で自由に編集できます。

＜この章の構成＞

18.1　開発環境の準備

18.2　記述文ファイルをPCに転送する

18.3　記述文ファイルをPC用に変換する

18.4　ドローによる編集

18.5　タイプ1/2/R書式インポート時のメッセージ

18.1　開発環境の準備

PC上で書式オーバレイ（メインフレーム用のタイプ1/2/R書式）を定義する前に，記述文格納用フォルダの用意や，定義環境の用意をします。

＜この節の構成＞

18.1.1　フォルダを作成する

18.1.2　実行環境の設定

18.1.1　フォルダを作成する

書式オーバレイの定義後に生成する記述文を格納するためのフォルダが必要です。XMAP3インストール時には，XMAP3インストールフォルダに「¥USER¥MAPS」のフォルダが作成されます。これとは別のフォルダに格納したい場合，フォルダの名称や場所は任意に設定してください。

生成したファイルは，XMAP3インストールフォルダ以外のフォルダで管理することをお勧めします。なお，XMAP3インストールフォルダ¥TEMPの下に格納すると，正常に動作しませんので注意してください。

18.1.2　実行環境の設定

定義した書式の印刷テストをするためには，PC上の実行環境を設定する必要があります。実行環境の設定については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

18.2　記述文ファイルをPCに転送する

変換するメインフレーム上の記述文ファイルを，PC上に転送します。部品を使用する場合は，部品ファイルもPCに転送します。

PCに転送するファイルは，メインフレーム上で正しくタイプ1/2/R書式を生成できることを確認してください。

＜この節の構成＞

18.2.1　VOS3からPCへの転送

18.2.2　VOS1からPCへの転送

18.2.3　VOSKからPCへの転送

18.2.4　転送時の注意事項

18.2.1　VOS3からPCへの転送

PCではCommuniNetを，メインフレームではIFITを使用します。IFITについては，マニュアル「ファイル伝送プログラムIFIT-TSS E2」を参照してください。

＜この項の構成＞

(1)　CommuniNetの環境を設定する

(2)　IFITのメニュー画面を使用して転送する場合

(3)　IFITコマンドを使用して転送する場合

(1)　CommuniNetの環境を設定する

CommuniNetの環境設定ユティリティを起動します。「端末名称」はファイルを受信する端末を選択して，「設定項目」の「ファイル転送」をダブルクリックします。ファイル転送の設定ダイアログが表示されるので，「コード変換」を「あり」にして，［OK］ボタンをクリックします。

(2)　IFITのメニュー画面を使用して転送する場合

ファイル伝送機能の呼び出し
IFITコマンドを実行して，ファイル伝送機能の画面を呼び出します。

転送するファイルの設定

「FUNCTION NO.」は1（HOST->TERMINAL）を選択してください。

「HOST DATA SET NAME」には，メインフレーム上のデータセット名を指定してください。

「TERMINAL FILE NAME」の項に，PCで受け取るファイル名を完全なパス名で指定します。なお，記述文ファイルの拡張子は「.FOG」，部品ファイルの拡張子は「.FGH」としてください。

(3)　IFITコマンドを使用して転送する場合

IFITコマンドを使用した転送の形式は，次のとおりです。

コマンド
オペランド

IFIT
△'メインフレーム上のデータセット名'
△PC上のファイル名
△INPUT(HOST)△OUTPUT(TERMINAL)

18.2.2　VOS1からPCへの転送

PCではCommuniNetを，メインフレームではIFITを使用します。IFITについては，マニュアル「ワークステーション操作 －パネル編－」，またはマニュアル「ワークステーション操作 －コマンド編－」を参照してください。

＜この項の構成＞

(1)　CommuniNetの環境を設定する

(2)　IFITのメニュー画面を使用して転送する場合

(3)　@@IFITコマンドを使用して転送する場合

(1)　CommuniNetの環境を設定する

CommuniNetの環境設定ユティリティを起動します。「端末名称」は転送するファイルの置かれている端末を選択して，「設定項目」の「ファイル転送」をダブルクリックします。ファイル転送の設定ダイアログが表示されるので，「コード変換」を「あり」にして，［OK］ボタンをクリックします。

(2)　IFITのメニュー画面を使用して転送する場合

IFITのメニュー画面を使用して転送する手順を次に示します。

ファイル伝送機能の呼び出し

マスタメニューの項目5「OA業務実行」を選択します。

OA業務実行メニューの項目5「パソコンファイル伝送」を選択します。

対話型ファイル伝送メニューの項目1「LIMEファイルのファイル伝送」を選択します。

転送するファイルの設定
「ホスト側ファイル情報」の項に，メインフレームから転送するファイル名などを指定します。また，「ワークステーション側ファイル情報」の項に，PCで受信するファイル名を完全なパス名で指定してください。なお，記述文ファイルの拡張子は「.FOG」，部品ファイルの拡張子は「.FGH」としてください。

(3)　@@IFITコマンドを使用して転送する場合

@@IFITコマンドを使用した転送の形式は，次のとおりです。

コマンド
オペランド

@@IFIT
△FTYPE=LIME
,WSF='PC上のファイル名'
,FILE=メインフレーム上のLIMEファイル名
,LIBRARY=メインフレーム上のLIMEライブラリ名
,MEMBER=メインフレーム上のLIMEメンバ名
,DC=DATA

18.2.3　VOSKからPCへの転送

PCではCommuniNetを，メインフレームではIFITを使用します。IFITについては，マニュアル「コマンド」，またはマニュアル「パネル」を参照してください。

＜この項の構成＞

(1)　CommuniNetの環境を設定する

(2)　IFITのメニュー画面を使用して転送する場合

(3)　IFITコマンドを使用して転送する場合

(1)　CommuniNetの環境を設定する

CommuniNetの環境設定ユティリティを起動します。「端末名称」は転送するファイルの置かれている端末を選択して，「設定項目」の「ファイル転送」をダブルクリックします。ファイル転送の設定ダイアログが表示されるので，「コード変換」を「あり」にして，［OK］ボタンをクリックします。

(2)　IFITのメニュー画面を使用して転送する場合

IFITのメニュー画面を使用して転送する手順を説明します。

ファイル転送機能の呼び出し

操作マスタメニューの項目3「ファイル操作」を選択します。

ファイル操作メニューの項目9「ファイルの伝送」を選択します。

ファイル伝送メニューの項目9「WSとのファイル転送」を選択します。

転送するファイルの設定

「入力ファイル名」の項に，メインフレームから転送するファイル名を指定します。

「出力ファイル名」の項に，PC上に出力するファイル名を指定します。なお，記述文ファイルの拡張子は「.FOG」，部品ファイルの拡張子は「.FGH」としてください。

(3)　IFITコマンドを使用して転送する場合

IFITコマンドを使用した転送の形式は，次のとおりです。

コマンド
オペランド

IFIT
,IN=メインフレームから転送するファイル名
,OUT=PC上に出力するファイル名

18.2.4　転送時の注意事項

記述文ファイルをメインフレームからPCに転送するときに注意が必要な点について説明します。

記述文中で外字を直接定数で指定している場合，文字コードがKEISからシフトJISに変換されます。

標準の状態では，KEISの外字のうちシフトJISに正しく変換されるのは1,880字までで，文字コードの対応はあらかじめ決められています。KEISの外字用コードとシフトJISの外字用コードとの対応については，「付録B.2(4)　ベンダ固有文字についての注意事項」を参照してください。

対応するシフトJISコードを持たない外字については，ドローで編集するときに適切な文字に置き換えてください。

＜この項の構成＞

(1)　外字マッピングファイルをカスタマイズしている場合

(2)　XMAP3外字機能を使用している場合

(1)　外字マッピングファイルをカスタマイズしている場合

コード変換SDKまたは日立コード変換 - Development Kitを使用して，シフトJISとKEISの外字マッピングファイルをカスタマイズしている場合，CommuniNetの文字コードのマッピングも同様にカスタマイズしてください。

CommuniNetの文字コードのマッピングを変更するには，CommuniNetのコードマッピングユティリティを使用してください。

(2)　XMAP3外字機能を使用している場合

UnicodeとKEISの外字マッピングファイルは文字コードの変換には影響しません。

18.3　記述文ファイルをPC用に変換する

＜この節の構成＞

18.3.1　文字属性名の決定

18.3.2　記述文ファイルの変換

18.3.1　文字属性名の決定

タイプ1/2/R書式では，文字を「文字属性名」で指定します。あらかじめ，使用する文字と，それに対応する文字属性名を決定します。文字属性名については，マニュアル「書式オーバレイゼネレータ FOG2 E2」を参照してください。

XMAP3では，「文字属性名」を記述文ファイルの生成前に設定する必要があります。

文字属性名を設定するには，ユティリティを使用します。なお，文字属性名の設定は運用管理者が行ってください。

ドローセットアップを起動し，ターゲット環境が正しく設定されていることを確認します。

ユティリティメインダイアログで「インポート」を選択し，「詳細」で「タイプ1/2/R書式」を選択して［実行］ボタンをクリックします。

書式記述文からPC書式定義変換ダイアログが表示されます。

［設定...］ボタンをクリックします。
オプション設定ダイアログが表示されます。

「文字属性名設定」タブを表示させます。

［標準値変更...］ボタンをクリックします。
標準値変更ダイアログが表示されます。

標準値が表示されているので，必要に応じて変更して［OK］ボタンをクリックします。

オプション設定ダイアログに戻ります。

文字属性名を追加する場合は［追加...］ボタンをクリックします。変更する場合は変更したい文字属性名を選択し，［変更...］ボタンをクリックします。
文字属性名の追加／変更ダイアログが表示されます。

次に示す項目を設定してから，［OK］ボタンをクリックします。

文字属性名

書体

文字サイズ

種別

なお，このダイアログで登録した文字属性名は，標準の文字属性名よりも優先されます。また，同じ文字属性名を複数個設定した場合は，先に設定した文字属性名が優先されます。
必要に応じて，7.と8.の手順を繰り返してください。

オプション設定ダイアログで［OK］ボタンをクリックして，文字属性名の設定を保存します。

18.3.2　記述文ファイルの変換

記述文ファイルを変換するには，ユティリティを使用します。なお，記述文ファイルの変換は運用管理者が行ってください。

インポート機能を設定します。
XMAP3のユティリティを起動させてください。ユティリティメインダイアログで，「インポート」を選択し，「詳細」で「タイプ1/2/R書式」を選択して［実行］ボタンをクリックします。

書式記述文からPC書式定義変換ダイアログが表示されます。［設定...］ボタンをクリックしてください。

オプション設定ダイアログが表示されるので，「書式インポート」タブをクリックしてください。

インポートする書式で部品ファイルが使われている場合は，「部品ファイルを使用する」を選んでから［参照...］をクリックして，PCに転送した部品ファイルの格納場所を指定してください。
また，「入力元ターゲット」には，対象となる書式を使用していたプラットホームに応じて選択してください。
部品ファイルと入力元ターゲットを設定したら，［OK］をクリックしてください。ユティリティメインダイアログに戻ります。

インポート機能を呼び出します。
ユティリティメインダイアログで，［実行］をクリックしてください。書式記述文からPC書式定義変換ダイアログが表示されます。

変換元ファイルを選択します。
「変換元ファイルの選択」の［参照...］ボタンをクリックします。ファイルを選択するダイアログが表示されるので，変換元のファイルを選択してください。
なお，選択できるファイルは，拡張子が「.FOG」および「.FOG2」のものだけです。

変換ファイルの出力先を指定します。
「変換ファイルの出力先」の［参照...］ボタンをクリックして，PC用に変換された書式定義ファイルを出力するフォルダを選択してください。

ファイルを変換します。
［変換］ボタンをクリックして，ファイルの変換を開始します。変換されたファイルは，「変換元の記述文ファイルのFORMS文に指定された書式名.IFM」というファイル名で出力されます。そのため，変換元の記述文ファイルの名称と一致しない場合があります。
インスポート機能では変換時にエラーが発生した場合，エラーメッセージを，「変換ファイルの出力先」に指定したフォルダに「変換元の記述文ファイル名.ERR」として出力します。エラーメッセージについては，「18.5　タイプ1/2/R書式インポート時のメッセージ」を参照してください。
変換時にエラーが発生したかどうか知るために，「変換ファイルの出力先」に指定したフォルダに出力される，メッセージファイル「X3UNFM01.TXT」を必ず確認してください。

18.4　ドローによる編集

PC用に変換された書式定義ファイルはドローで編集できます。ここでは，インポート機能で記述文ファイルを書式定義ファイルに変換するときに，定義がどのように変換されるかを説明します。インポート機能で変換できる記述文の範囲については，「付録C.3　インポート機能で変換できる記述文の機能範囲」を参照してください。

FOG2 E2のタイプ1/2/R書式と，PCのXMAP3の書式オーバレイとでは，使用できる機能の範囲が異なります。したがって，PCでは指定できない機能については，変換時に別の機能に置き換えられます。また，PCよりも細かく値を指定できる機能については，変換時に値をPCで扱える範囲に集約します。

このため，次の図に示すように，記述文ファイルをインポートして，さらにエクスポートした場合，元の記述文ファイルとPCで生成した記述文ファイルとでは，内容が異なる場合があります。

図18-1　インポートとエクスポートによる記述文の変更

次に，それぞれの定義について，変換の内容を説明します。

＜この節の構成＞

18.4.1　位置・長さの単位

18.4.2　書式定義ファイル名

18.4.3　部品

18.4.4　用紙の種別

18.4.5　レイアウト

18.4.6　線種と太さ

18.4.7　角の丸め

18.4.8　円と円弧

18.4.9　文字列の字間値

18.4.10　文字属性名の関連づけ

18.4.11　繰り返し

18.4.12　ドットパターン

18.4.13　網掛け種別

18.4.1　位置・長さの単位

FOG2 E2では，位置や長さをドット単位で扱っています。インポート時には，1ドット＝240dpiになるように変換します。

18.4.2　書式定義ファイル名

インポート時に生成する書式定義ファイルの名称は，FORMS文の書式名1を使用します。ただし，インポートする記述文がVOS3用のもので，FORMS文に書式名2が指定されている場合は，書式名2を優先します。

したがって，記述文ファイルの名称と，インポート機能で生成される書式定義ファイルの名称は，一致しない場合があります。書式定義ファイル名と記述文ファイル名の対応は，メッセージファイルに出力します。

また，エクスポート時にFORMS文に展開する書式名は，書式定義ファイルの名称に使用した書式名を使用します。

書式名の指定と書式定義ファイル名の関係を次の表に示します。

表18-1　書式名と書式定義ファイル名の関係

書式名の指定 | インポート時に出力する書式定義ファイルの名称
書式名1だけ | 書式名1.IFM
書式名2だけ※¹ | 書式名2.IFM※²
両方あり※¹ | 書式名2.IFM※²
文法エラー | E000.IFM

注※1

書式名2が指定されているのは，VOS3用の記述文だけです。

注※2

書式名2をファイル名に使用できない場合は，「書式名1.IFM」になります。

書式名が文法エラーになった場合は，書式定義ファイル名を「E000.IFM」とします。書式名が文法エラーになる場合について説明します。

＜この項の構成＞

(1)　メインフレームでもエラーとなる場合

(2)　メインフレームでは正常に処理されるが，PCでエラーになる場合

(1)　メインフレームでもエラーとなる場合

次の場合は，メインフレームでも文法エラーとなります。

書式名1の先頭が数字の場合

書式名に，使用できない文字が含まれている場合

名称が5文字以上の場合

書式名1および書式名2の両方を省略した場合

(2)　メインフレームでは正常に処理されるが，PCでエラーになる場合

次の場合は，インポート時にエラーが発生して処理を中断します。これらについては，メインフレームでは正常に処理されますが，PCではエラーになります。

書式名2の先頭が数字の場合

書式名に@，¥，#が含まれている場合

18.4.3　部品

部品を使用している場合，部品はインポート時に書式に取り込まれて，一つの書式定義ファイルに統合されます。

エクスポート時は，一つの書式定義ファイルから一つの記述文ファイルだけを生成します。部品ファイルは生成しません。したがって，インポート前の記述文で部品を使用している場合，エクスポートでは元の記述文に部品が取り込まれた形の記述文を生成します。

XMAP3での部品の扱いを次の図に示します。

図18-2　XMAP3での部品の扱い

18.4.4　用紙の種別

用紙の種別は，次に示す領域をカバーできる，最小の用紙を仮定します。

縦方向：

定義領域の縦の大きさ+上下各5mmのハードマージン（計10mm，94ドット）

横方向：

定義領域の横の大きさ＋左右各5mmのハードマージン（計10mm，94ドット）

定義領域の大きさと用紙サイズの関係を次の表に示します。

表18-2　定義領域の大きさと用紙サイズ

縦の大きさ※
（ドット）
横の大きさ※
（ドット）
インポート後の用紙種別

1,890ドット
1,304ドット
A5縦

1,304ドット
1,890ドット
A5横

2,334ドット
1,625ドット
B5縦

1,625ドット
2,334ドット
B5横

2,712ドット
1,890ドット
A4縦

1,890ドット
2,712ドット
A4横

3,345ドット
2,334ドット
B4縦

2,334ドット
3,345ドット
B4横

3,874ドット
2,712ドット
A3縦

2,712ドット
3,874ドット
A3横

注※

縦の大きさおよび横の大きさにそれぞれ94ドットを加えた値が，用紙の大きさになります。

18.4.5　レイアウト

＜この項の構成＞

(1)　ます目設定

(2)　行の間隔

(3)　文字サイズ・文字間隔

(4)　定義領域の違い

(1)　ます目設定

インポートした書式のます目設定は，ドローでは「自由な設定」になります。

(2)　行の間隔

行間隔は，FORMS文の基本ます目の縦サイズを基に決定します。

インポート時に値が集約されるので，エクスポートした記述文をメインフレームで使用する場合，行データ（FCB）の変更が必要になる場合があります。

基本ます目と行間隔の関係を表18-3と表18-4に示します。

表18-3　基本ます目と行間隔の関係（LPI指定時）

基本ます目の縦サイズ | インポート後の行間隔
3/4LPI（320ドット） | 3LPI
3/2LPI（160ドット） | 3LPI
3LPI（80ドット） | 3LPI
4LPI（60ドット） | 4LPI
6LPI（40ドット） | 6LPI
6.7LPI（36ドット） | 6LPI
8LPI（30ドット） | 8LPI
10LPI（24ドット） | 10LPI
12LPI（20ドット） | 12LPI
24LPI（10ドット） | 12LPI※

注※

「書式の縦サイズ＞行間隔×127」の場合，40ドット（6LPI）に変換します。

表18-4　基本ます目と行間隔の関係（任意ドット指定時）

基本ます目の縦サイズ | インポート後の行間隔
61ドット以上 | 3LPI
41～60ドット | 4LPI
31～40ドット | 6LPI
25～30ドット | 8LPI
21～24ドット | 10LPI
1～20ドット | 12LPI※

注※

「書式の縦サイズ＞行間隔×127」の場合，40ドット（6LPI）に変換します。

(3)　文字サイズ・文字間隔

ます目の横サイズは，帳票設計時のスケール表示の単位となるので，できるだけ記述文での指定値の約数または倍数になるように変換します。

文字サイズと文字間隔の変換規則について，使用頻度の高い範囲と，それ以外とに分けて説明します。

(a)　使用頻度の高い範囲

使用頻度の高い範囲での変換規則を次の表に示します。

表18-5　文字サイズと文字間隔（使用頻度の高い範囲）

基本ます目の横サイズ
（インポート前）
インポート後の行間隔と文字サイズ・文字間隔

12LPI
10LPI，8LPI
6LPI，4/3LPI

12ドット
（7ポイント半角）
（5ポイント，
3ポイント）
13ドット※
（7ポイント，
0ポイント）
12ドット※
（7ポイント，
0ポイント）
12ドット※

16ドット
（9ポイント半角，15CPI）
（5ポイント，
5ポイント）
16ドット
（5ポイント，
5ポイント）
16ドット
（9ポイント，
0ポイント）
16ドット

18ドット
（13.3CPI）
（5ポイント，
7ポイント）
19ドット
（7ポイント，
4ポイント）
18ドット
（9ポイント，
1ポイント）
18ドット

20ドット
（12ポイント半角，12CPI）
（5ポイント，
1ポイント）
10ドット※
（7ポイント，
5ポイント）
20ドット
（12ポイント，
0ポイント）
20ドット

24ドット
（14ポイント半角，10CPI）
（5ポイント，
0ポイント）
8ドット※
（7ポイント，
0ポイント）
12ドット※
（9ポイント，
5ポイント）
24ドット

32ドット
（9ポイント全角）
（5ポイント，
5ポイント）
16ドット
（5ポイント，
5ポイント）
16ドット
（9ポイント，
0ポイント）
16ドット

40ドット
（12ポイント全角）
（5ポイント，
0ポイント）
8ドット※
（7ポイント，
5ポイント）
20ドット
（12ポイント，
0ポイント）
20ドット

48ドット
（14ポイント全角）
（5ポイント，
5ポイント）
16ドット
（7ポイント，
0ポイント）
12ドット※
（9ポイント，
5ポイント）
24ドット

注※

文字サイズが小さいので，インポート時に項目が欠落することがあります。

したがって，書式サイズ＞文字サイズ×255の場合，この表の値ではなく次に示す値に変換します。

・12LPIの場合：5ポイント，5ポイント（16ドット）

・12LPI以外の場合：7ポイント，7ポイント（23ドット）

メインフレーム，およびPCで，データを含む書式を差異なく印刷できる範囲
インポート前の記述文でのます目の横サイズが12ドット，16ドット，20ドット，または24ドットの場合，次に示す条件を満たしていれば，メインフレーム，およびPCでの書式印刷に差異は生じません。

ます目の横サイズが12ドット（7ポイント半角）の場合：

書式の横サイズが3,060ドット以内

ます目の横サイズが16ドット（9ポイント半角）の場合：

ます目の縦サイズが80ドット，60ドット，または40ドット

ます目の横サイズが24ドット（10CPI）の場合：

ます目の縦サイズが80ドット，60ドット，または40ドット

ます目の横サイズが20ドット（12ポイント半角）の場合：

ます目の縦サイズが80ドット，60ドット，または40ドット

これらの条件に当てはまらない場合は，3.を参照してください。

基本ます目の大きさが半分になる場合
ます目の横サイズが32ドット，40ドット，または48ドットで使用していた場合，インポート時に書式のます目の横サイズが半分になります。
したがって，メインフレームにエクスポートした場合，メインフレームでの行データ（FCB）の指定によっては，エクスポート後の書式がインポート前とは同じように印刷されないことがあります。

PCで印刷する場合に文字サイズが変わる場合
1.および2.以外の文字サイズを使用している場合，エクスポートした書式は，インポート前と異なる文字サイズで印刷されます。ドロー機能で文字サイズを変更すれば，インポート前と同じ文字サイズで印刷できます。ただし，XMAP3では13.3CPIに設定できないため，インポート前の書式の文字サイズが13.3CPIだった場合，文字間隔は変更されます。

(b)　そのほかの場合

(a)に示した範囲以外の，一般的な変換規則を次の表に示します。

表18-6　文字サイズと文字間隔（使用頻度の高い範囲以外の場合）

基本ます目の横サイズ
（インポート前）
インポート後の行間隔と文字サイズ・文字間隔

12LPI
10LPI，8LPI
6LPI，4/3LPI

8ドット以下
（5ポイント，0I）
8ドット※
（5ポイント，0I）
8ドット※
（5ポイント，0I）
8ドット※

9～11ドット
（5ポイント，3I）
13ドット※
（7ポイント，0I）
12ドット※
（7ポイント，0I）
12ドット※

13～15ドット
（5ポイント，5I）
16ドット
（5ポイント，5I）
16ドット
（9ポイント，0I）
16ドット

17ドット
（5ポイント，7I）
19ドット
（7ポイント，4I）
18ドット
（9ポイント，1I）
18ドット

19ドット
（5ポイント，1I）
10ドット※
（7ポイント，5I）
20ドット
（12ポイント，0I）
20ドット

21～23ドット
（5ポイント，0I）
8ドット※
（7ポイント，0I）
12ドット※
（9ポイント，5I）
24ドット

25～31ドット
（5ポイント，5I）
16ドット
（5ポイント，5I）
16ドット
（9ポイント，0I）
16ドット

33～39ドット
（5ポイント，1I）
10ドット※
（7ポイント，5I）
20ドット
（12ポイント，0I）
20ドット

41～47ドット
（5ポイント，5I）
16ドット
（7ポイント，0I）
12ドット※
（9ポイント，5I）
24ドット

49ドット以上
（5ポイント，5I）
16ドット
（7ポイント，0I）
12ドット※
（9ポイント，5I）
24ドット

注※

文字サイズが小さいので，インポート時に項目が欠落することがあります。

したがって，書式サイズ＞文字サイズ×255の場合，この表の値ではなく次に示す値に変換します。

・12LPIの場合：5ポイント，5ポイント（16ドット）

・12LPI以外の場合：7ポイント，7ポイント（23ドット）

(4)　定義領域の違い

開始位置または終了位置がXMAP3の定義領域を超えている項目は，インポート機能での変換時にすべて削除されます。定義領域の範囲を次の表に示します。

表18-7　定義領域の範囲

方向 | ます目指定 | ドット指定
行 | 127行まで | 5,461ドットまで
列 | 255列まで | 5,461ドットまで

18.4.6　線種と太さ

＜この項の構成＞

(1)　線の種別

(2)　線の太さ

(3)　斜線（ELINE文）で引かれる線が垂直または平行の場合

(4)　線（RLINE文など）の肉付け方法

(1)　線の種別

RLINE文などで指定する線種は，次の表に示す規則に従って変換します。

表18-8　線種の変換規則

指定値 | 説明 | インポート後の線種
1 | 実線 | 実線
2 | 8ドット点線 | 点線
3 | 16ドット点線 | 破線
4 | 4ドット点線 | 点線
5 | 12ドット点線 | 破線
6 | 8ドット一点鎖線 | 一点鎖線
7 | 20ドット1点鎖線 | 一点鎖線
8 | 二点鎖線 | 二点鎖線
9 | 1ドット点線 | 点線

(2)　線の太さ

RLINE文などで指定する線の太さは，次の表に示す規則に従って変換します。

表18-9　線の太さの変換規則

指定値 | インポート後の太さ
1ドット | 細線
2ドット | 細線
3ドット | 中線
4ドット | 中線
5ドット | 太線
6ドット | 太線
7ドット | 極太線
8ドット以上 | 極太線

(3)　斜線（ELINE文）で引かれる線が垂直または平行の場合

斜線（ELINE文）で引かれる線が垂直または平行の場合，インポート時に斜線ではなく，縦けい線または横けい線として変換されます。

(4)　線（RLINE文など）の肉付け方法

FOG2 E2とXMAP3とでは，縦けい線を描画するときの肉付け方法が異なります。縦けい線に対する肉付け方法の違いを次の図に示します。

図18-3　縦けい線に対する肉付け方法

このため，インポート時に，線の位置を次のように変更します。

　　　　開始列位置＝「記述文での開始列位置＋太さによる値」
　　　　開始行位置＝変更なし

太さによる値は次のとおりです。

細線：0，中線：1，太線：2，極太線：3

ただし，エクスポート時には，FOG2 E2の肉付け方法に合わせて，位置を補正して記述文を出力します。したがって，ドローで位置を変更しないかぎり，元の記述文とエクスポートした記述文とでは，線の位置は同じになります。

18.4.7　角の丸め

＜この項の構成＞

(1)　矩形・網掛けのコーナ半径

(1)　矩形・網掛けのコーナ半径

BOX文などで指定するコーナ半径は，次の表に示す規則に従って変換されます。コーナ半径が12ドットの場合，インポート時に「小」に変換されるので，8ドットの場合と同じ大きさになります。

表18-10　コーナ半径の変換規則

指定値 | 説明 | インポート後の半径
1 | 8ドット | 小
2 | 12ドット | 小
3 | 16ドット | 標準
4 | 20ドット | 大

18.4.8　円と円弧

＜この項の構成＞

(1)　円の位置とサイズ

(2)　円弧の位置・角度・サイズ

(1)　円の位置とサイズ

円の位置とサイズの指定方法は，FOG2 E2とPCのXMAP3とで異なります。それぞれの場合の指定方法を次の図に示します。

図18-4　円の位置とサイズの指定方法

したがって，インポートでの変換時に，円の位置とサイズは次のように変換されます。

行位置＝中心行位置－半径

列位置＝中心列位置－半径

サイズ＝半径×2

ただし，エクスポート時には，円の中心位置と半径を算出して変換します。したがって，ドローで位置を変更しないかぎり，インポート前とエクスポート後とで円の位置が異なることはありません。

(2)　円弧の位置・角度・サイズ

円弧の位置とサイズの指定方法は，FOG2 E2と，PCのXMAP3とでは異なります。指定方法を次の図に示します。

図18-5　円弧の位置とサイズの指定方法の違い

このため，インポート時に，記述文に指定した中心位置，半径，開始角度，および終了角度から，開始位置と終了位置を算出して変換します。

ただし，エクスポート時には，開始位置と終了位置から円弧の中心位置，半径，開始角度，および終了角度を算出して，できるだけインポート前と同じ位置になるように変換します。したがって，ドローで位置を変更しないかぎり，インポート前とエクスポート後とで円弧の位置が大きく異なることはありません。

また，メインフレームでは円弧の角度を自由に指定できますが，PCで指定できるのは，小（30度），中（60度），または大（90度）だけです。したがって，それ以外の大きさの角度を持つ円弧をPCにインポートした場合は，近い大きさの角度に変更されるか，または複数の円弧の組み合わせに変更されます。

円弧の変更規則を次に示します。

角度が90度以下の場合

1～30度の場合，小（30度）として作成

31～60度の場合，中（60度）として作成

61～90度の場合，大（90度）として作成

角度が90度より大きい場合

90度の円弧の組み合わせで作成できる部分を作成

残った部分が1～30度の場合，残りを小（30度）として作成
残った部分が31～60度の場合，残りを中（60度）として作成
残った部分が61～89度の場合，残りを大（90度）として作成

円弧の内角の大きさとインポート後の曲率との関係を次の表に示します。

表18-11　円弧の内角の大きさと曲率との関係

作成する内角の大きさ | インポート後の円弧の角度
1～29度 | 小
30度 | 小
31～59度 | 中
60度 | 中
61～89度 | 大
90度 | 大

したがって，円弧はインポート時に複数に分割される場合があります。分割される例を次の図に示します。

図18-6　インポート時の円弧の変換

18.4.9　文字列の字間値

文字列の字間値は，次の表に示す規則に従って変換します。字間値が次の表の範囲内の場合，インポート前とエクスポート後とで字間値が異なることはありません。

表18-12　文字項目の字間値

文字種類 | 字間値 | インポート後の字間値
半角文字 | 0ドット | 0I
2ドット | 1I
3ドット | 2I
5ドット | 3I
6ドット | 4I
8ドット | 5I
9ドット | 6I
11ドット | 7I
全角文字 | 0ドット | 0I
4ドット | 1I
6ドット | 2I
10ドット | 3I
12ドット | 4I
16ドット | 5I
18ドット | 6I
22ドット | 7I

インポートする記述文の字間値がこの範囲に当てはまらない場合は，次の図に示すように，1文字ずつ単独のオブジェクトに変換し，元の字間値に応じてそれぞれの位置を設定します。

図18-7　1文字ずつ単独の項目に変換する場合

18.4.10　文字属性名の関連づけ

＜この項の構成＞

(1)　文字の関連づけ

(2)　CHAR文での文字属性が関連づけられていない場合

(3)　均等文字配置，両端ぞろえ文字配置（ADJUST文，LAY文）での文字属性が関連づけられていない場合

(1)　文字の関連づけ

ユーザが登録した文字属性名の関連づけが優先されます。ユーザが登録した文字属性名と関連づけられない場合は，標準提供の文字属性名と関連づけるようにします。

(2)　CHAR文での文字属性が関連づけられていない場合

書体には明朝，大きさは9ポイントとして変換されます。

(3)　均等文字配置，両端ぞろえ文字配置（ADJUST文，LAY文）での文字属性が関連づけられていない場合

縦のボディサイズの値によって，次の表に示すように文字属性を決定します。

表18-13　ボディサイズによる文字属性の決定

縦ボディサイズ | 書体 | 大きさ
1～23 | 明朝 | 5ポイント
24～31 | 明朝 | 7ポイント
32～39 | 明朝 | 9ポイント
40～47 | 明朝 | 12ポイント
48以上 | 明朝 | 14ポイント

18.4.11　繰り返し

FOG2 E2の繰り返し定義は，インポート時に，繰り返し回数分のオブジェクトに分割された形で変換されます。

18.4.12　ドットパターン

ドットパターンによるグラフィックは，インポート時に固定グラフィックに変換されます。ただし，任意の網掛けについては，「18.4.13　網掛け種別」を参照してください。

18.4.13　網掛け種別

網掛け種別は，表18-14および表18-15に示す規則に従って変換されます。

表18-14　網掛け種別の変換規則

記述文の
指定値
説明
インポート後の網掛け種別

1
ユーザ任意
表18-15参照

4
濃い
濃い網掛け

6
中間
標準網掛け

8
薄い
薄い網掛け

表18-15　網掛け種別の変換規則（ユーザ任意指定の場合）

パターン | 決定する種別 | パターン | 決定する種別
[図データ]　 | 標準右下 | [図データ]　 | 標準左下
[図データ]　 | 標準縦線 | [図データ]　 | 標準横線
[図データ]　 | 標準格子 | 8×8の範囲に21個以下の点 | 薄い網掛け
8×8の範囲に42個以下の点 | 標準網掛け | 8×8の範囲に43個以下の点 | 濃い網掛け

したがって，記述文でユーザ任意の網掛けを使用していたときに，PCにインポートした後も同じ網掛けに変換されるのは，標準右下，標準左下，標準縦線，標準横線，および標準格子の場合だけです。

18.5　タイプ1/2/R書式インポート時のメッセージ

インポート機能でタイプ1/2/R書式の記述文ファイルから書式定義ファイルを生成するときに，次に示す定義がある場合，エラーメッセージを出力します。

生成された記述文を使ってメインフレームでタイプ1/2/R書式を生成すると，解析時にエラーとなるもの。

インポート時にオブジェクトを破棄，または設定内容を変更しているもの。

エラーが発生した場合でも，書式定義ファイルは出力されます。

＜この節の構成＞

(1)　エラーファイルの形式

(2)　出力するメッセージの詳細

(3)　メッセージの詳細

(1)　エラーファイルの形式

エラーファイルのファイル名は，「変換元の記述文ファイル名.ERR」です。エラーファイルは，書式インポートダイアログで設定した記述文ファイルの出力先に出力されます。変換時にエラーが発生したかどうかを知るために，「変換ファイルの出力先」に指定したフォルダに出力されるメッセージファイル「X3UNFM01.TXT」を必ず確認してください。

(2)　出力するメッセージの詳細

出力するメッセージの形式を次に示します。

［メッセージID］

［メッセージテキスト］

(a)　メッセージID　：　X3IFnnn-I

X3IF

タイプ1/2/R書式インポート時のメッセージであることを示します。

nnn

メッセージ通番を示します。

I

通知メッセージを示します（記述文解析時にエラーとなったので，記述文の修正が必要なもの）。

(b)　メッセージテキストの詳細

メッセージテキストについて説明します。

（S）インポートの処理

メッセージを出力したあとの主な処理を示します。

（P）プログラマの処置

メッセージを受け取ったプログラマが取るべき処置を示します。

(3)　メッセージの詳細

個々のメッセージについて説明します。なお，ここに掲載しているのは，タイプ1/2/R書式のインポート機能に固有のメッセージだけです。XMAP3全体に共通のメッセージについては，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

X3IF201-I

［記述文名］：［オペランド名］のサブフィールド指定数に誤りがあります

記述文名で示す記述文の該当オペランド名で示すオペランドのサブフィールド指定数に誤りがある。

（S）この記述がSEGMENT文の場合，この記述文を含めて，以下に続く記述文中のSGEND文までを無視し，処理を続行します。他記述文の場合，この記述文を無視し，処理を続行します。

（P）該当オペランドのサブフィールド指定数を調べ，誤りを直し再実行します。

X3IF202-I

［記述文名］：［オペランド名］を指定していません

記述文名で示す記述文の該当オペランド名で示すオペランドが指定されていない。

（S）この記述がSEGMENT文の場合，この記述文を含めて，以下に続く記述文中のSGEND文までを無視し，処理を続行する。他記述文の場合，この記述文を無視し，処理を続行します。

（P）該当オペランドのサブフィールド指定数を調べ，誤りを直し再実行します。

X3IF203-I

［記述文名］：｛ます目大｜X長｜Y長｝に誤りがあります

記述文名で示す記述文において，ます目大，X長，またはY長の指定に誤りがある。

（S）この記述がFORMS文の場合，標準値を仮定するため，結果は保証できません。

また，SEGMENT文の場合，この記述文を含めて，以下に続く記述文中のSGEND文までを無視し，処理を続行します。

（P）この記述文のます目大，X長，Y長オペランドを調べ，誤りを直し再実行します。

X3IF204-I

［記述文名］：名前フィールドに誤りがあります

記述文名で示す記述文の名前フィールドの指定に誤りがある。

（S）この記述がFORMS文の場合，タイプ1/2/R書式ファイル名として（E000）の4桁を仮定し，処理を続行します。SEGMENT文の場合，この記述文を含めて，以下に続く記述文中のSGEND文までを無視し，処理を続行します。他記述文の場合，この記述文を無視し，処理を続行します。

（P）この記述文の名前フィールドを調べ，誤りを直し再実行します。

X3IF205-I

［記述文名］：INCLUDE文，SEGMENT文，SGEND文が対応していません

セグメントの指定が正しくない。原因としては次のことが考えられる。

INCLUDE文，SEGMENT文，SGEND文の対応がとれていない。

INCLUDE文の直後に，SEGMENT文が指定されていない。

（S）この記述がSGEND文の場合，前INCLUDE文，およびこの記述文を無視し，処理を続行します。SEGMENT文の場合，この記述文を含めて，以下に続く記述文中のSGEND文までを無視し，処理を続行します。他記述文の場合，この記述文を無視し，処理を続行します。

（P）この記述文と前後記述文の関係を調べ，誤りを直し再実行します。

X3IF206-I

［記述文名］：標準FORMS文を仮定しました

記述文名で示す記述文の該当オペランド名で示すオペランドが指定されていない。

（S）この記述がSEGMENT文の場合，この記述文を含めて，以下に続く記述文中のSGEND文までを無視し，処理を続行します。他記述文の場合，この記述文を無視し，処理を続行します。

（P）該当オペランドのサブフィールド指定数を調べ，誤りを直し再実行します。

X3IF207-I

［記述文名］：｛ます目大｜X位置｜Y位置｜X長｜Y長｝がFORMS文で指定した領域を超えています

記述文名に示す記述文において，ます目大，X位置，Y位置，X長，またはY長が定義書式長を超えている。

（S）SEGMENT文を含めて，以下に続く記述文中のSGEND文までを無視し，処理を続行します。他記述文の場合，この記述文を無視し，処理を続行します。

（P）SEGMENT文のます目大オペランドを調べ，誤りを直し再実行します。

X3IF208-I

［記述文名］：｛X位置｜Y位置｜長さ｜X長｜Y長｜半径｜線の太さ｜繰り返し指定｝がFORMS/SEGMENT文で指定した領域を超えています

記述文名に示す記述文のX位置，Y位置，長さ，X長，Y長，半径，線の太さ，または繰り返し指定に誤りがある。また，インポート実行時に，XMAP3の定義領域を超えた。

（S）この記述文を無視し，処理を続行します。

（P）この記述文のX位置，Y位置，長さ，X長，Y長，半径，線の太さ，または繰り返し指定を調べ，誤りを直し再実行します。

X3IF209-I

［記述文名］：｛線種別｜長さ｜X長｜Y長｜線の太さ｜線の向き｜繰り返し向き｜繰り返し回数｜半径｜角度｜コーナ形式｜コーナ半径｝に誤りがあります

記述文名に示す記述文のオペランドの指定に誤りがある。

（S）この記述文を無視し，処理を続行します。

（P）この記述文のオペランドを調べ，誤りを直し再実行します。

X3IF210-I

FRMEND：SEGMENT文の入子に誤りがあります

SEGMENT文とSGEND文の指定数が一致しない。

（S）指定数誤りを無視し，処理を続行します。

（P）SEGMENT記述文と，SGEND記述文の各記述文指定数を調べ，不一致を直し再実行します。

X3IF211-I

FORMS：LISTオペランドに誤りがあります

FORMS文のLISTオペランドの指定に誤りがある。

（S）この記述文のLISTオペランドを無視し，処理を続行します。

（P）この記述文のLISTオペランドを調べ，誤りを直し再実行します。

X3IF213-I

FORMS：FORMS文はすでに指定してあります

書式記述文群の先頭に，FORMS文が記述されていない。または，一書式記述文群内にFORMS文が2度以上現れた。

（S）この記述文を無視し，処理を続行します。

（P）この記述文の指定数，または指定位置を調べ，誤りを直し再実行します。

X3IF214-I

INCLUDE：SEGMENT文の入子が1を超えています

セグメントのネストが，許容値（1）を超えている。

（S）この記述文で入力したセグメントの終了であるSGEND文までを無視し，処理を続行します。

（P）記述文のネストを調べ，ネストを1以下にし，再実行します。

X3IF215-I

INCLUDE：セグメント名に誤りがあります

INCLUDE文のセグメント名に誤りがある。

（S）この記述文を無視し，処理を続行します。

（P）この記述文のセグメント名オペランドを調べ，誤りを直し再実行します。

X3IF217-I

SEGMENT：セグメント名がINCLUDE文と一致していません

SEGMENT文の名前で指定しているセグメント名と，前INCLUDE文で指定しているセグメント名が一致しない。

（S）この記述文を含めて，以下に続く記述文中のSGEND文まで無視し，処理を続行します。

（P）この記述文の名前を調べ，誤りを直し再実行します。

X3IF219-I

SGEND：セグメント名に誤りがあります

SGEND文のセグメント名に誤りがある。

（S）この記述文を無視し，処理を続行します。

（P）この記述文のセグメント名オペランドを調べ，誤りを直し再実行します。

X3IF220-I

SGEND：SGEND文に対応するSEGMENT文がありません

SGEND文に指定したセグメント名に対応するSEGMENT文が存在しない。

（S）この記述文を無視し，処理を続行します。

（P）この記述文のセグメント名オペランドを調べ，誤りを直し再実行します。

X3IF221-I

SGEND：［セグメント名］SGEND文を仮定しました

SGEND文で指定されているセグメント名のネストが，現在処理中であるセグメントのネストに一致しない。

（S）セグメント名で示すSGEND文を仮定し，処理を続行します。

（P）仮定されたSGEND文を調べ，セグメントの指定を直し再実行します。

X3IF222-I

SGEND：エラーが発生したため ｛この｜セグメント名｝セグメントを無視しました

このメッセージの前に表示されているエラーのため，セグメント名または，この（セグメント名が不明）で指定されたセグメントの一部または全部を無視した。このセグメントの結果は保証できない。

（S）次の記述文の処理します。

（P）エラーの内容を解析し，誤りを直し，再実行します。

X3IF226-I

GRAPHIC：GRAPHIC文が384を超えています

384を超える相違なるドットデータ名指定のGRAPHIC文を指定している。

（S）この記述文を無視し処理を続行します。

（P）無視されたGRAPHIC文を調べ，相違なるドットデータ名指定のGRAPHIC文を384以下にして，再実行します。

X3IF227-I

GRAPHIC：ドットデータ名に誤りがあります

GRAPHIC文のドットデータ名に誤りがある。

（S）この記述文を無視し処理を続行します。

（P）この記述文のドットデータ名オペランドを調べ，誤りを直し再実行します。

X3IF229-I

GRAPHIC：必要なオペランドを指定していません

GRAPHIC文において，必須オペランドの指定がない。

（S）この記述文を無視し処理を続行します。

（P）この記述文必須オペランドを調べ，必須オペランドを記入し再実行します。

X3IF230-I

DOT：DOT文とGRAPHIC文が対応していません

DOT文のドットデータ名に誤りがある。

（S）この記述文を無視し，処理を続行します。

（P）この記述文の名前オペランドまたは記述順序を調べ，誤りを直し再実行します。

X3IF231-I

DOT：｛X位置｜Y位置｜ドット列｝がGRAPHIC文の領域を超えています

DOT文のX位置，Y位置，またはドット列がGRAPHIC文で定義したドットパターン領域を超えている。

（S）この記述文を無視し，処理を続行します。

（P）この記述文のX位置，Y位置またはドット列を調べ，誤りを直し再実行します。

X3IF232-I

［記述文名］：｛X長｜Y長｜ドット列｜図形変換種別｜繰り返し回数｜網掛け種別｜繰り返し向き｜コーナ形式｜コーナ半径｝に誤りがあります

記述文名に示す記述文のX長，Y長，ドット列，図形変換種別，繰り返し回数，コーナ形式またはコーナ半径の指定に誤りがある。

（S）この記述文を無視し，処理を続行します。

（P）この記述文のオペランドを調べ，誤りを直し再実行します。

X3IF233-I

DOT：ドット列をアポストロフィで囲んでいません

DOT文において，ドット列がアポストロフィで囲まれていない。または，ドット列が255を超えて指定されている。

（S）この記述文を無視し，処理を続行します。

（P）この記述文のドット列オペランドを調べ，誤りを直し再実行します。

X3IF234-I

［記述文名］：｛X位置｜Y位置｜X長｜Y長｜文字数｜繰り返し指定｝がFORMS/SEGMENT文で指定した領域を超えています

記述文名に示す記述文のX位置，Y位置，X長，Y長，文字数，繰り返し指定に誤りがある。また，インポート実行時に，XMAP3の定義領域を超えた。

（S）この記述文を無視し，処理を続行します。

（P）この記述文のX位置，Y位置，X長，Y長，文字数，繰り返し指定を調べ，誤りを直し再実行します。

X3IF236-I

［記述文名］：文字データ名に誤りがあります

記述文名で示す記述文において，文字データ名オペランドの指定に誤りがある。

（S）この記述文を無視し，処理を続行します。

（P）この記述文の文字データ名オペランドを調べ，誤りを直し再実行します。

X3IF237-I

［記述文名］：文字符号の数が50を超えています

NXCODE文で，文字符号の指定数が51以上である。

（S）この記述文を無視し，処理を続行します。

（P）この記述文の文字符号の指定数を50以下にし，再実行します。

X3IF238-I

［記述文名］：CODEオペランドの［n］番目のパラメタに誤りがあります

NXCODE文のn番目の文字符号が不当である。文字符号の指定数が51以上である。

（S）文字符号が不当なものを含め，以下に続く全文字符号を無視し，処理を続行します。

（P）この記述文のn番目の文字符号を調べ，誤りを直し再実行します。

X3IF239-I

［記述文名］：線の太さが｛X長｜Y長｜半径｝を超えています

記述文名で示す記述文において，線の太さ指定に誤りがある。

（S）この記述文を無視し，処理を続行します。

（P）この記述文の文字データ名オペランドを調べ，誤りを直し再実行します。

X3IF240-I

［記述文名］：ます目大の指定値が｛X長｜Y長｝を超えています

記述文名で示す記述文において，ます目大オペランドで指定された1列ドット数または1行ドット数がX長もしくはY長オペランドで指定した長さを超えている。

（S）この記述文の指定が正しいものとして，処理を続行します。

X3IF241-I

［記述文名］：CODE文が384を超えています

異なる文字データ名数が384を超えている。

（S）この記述文を無視し，処理を続行します。

（P）この記述文を調べ，異なる文字データ名の各種CODE文の総数を384以下にして，再実行します。

X3IF242-I

［記述文名］：GRAPHIC文とCODE文が384を超えています

異なるドットデータ名のGRAPHIC文と，異なる文字データ名の各種CODE文の合計数が384を超えている

（S）この記述文を無視し，処理を続行します。

（P）この記述文を調べ，記述文の合計数が384以下になるようにして，再実行します。

X3IF248-I

［記述文名］：CODE文の文字列が｛ADJUST｜LAY｝文で指定した領域を超えています

この記述文において，指定した文字が，配置指定領域に収まらない。

（S）この記述文を無視し，処理を続行します。

（P）この記述文のX長，Y長，横ボディサイズ，縦ボディサイズ，文字数，文字並びオペランドの関係を調べ，配置指定領域に収まるように直し再実行します。

X3IF249-I

GRAPHIC：｛X位置｜Y位置｜X長｜Y長｜繰り返し指定｝がFORMS/SEGMENT文で指定した領域を超えています

GRAPHIC文のX位置，Y位置，X長，Y長または繰り返し指定に誤りがある。

（S）この記述文を無視し，処理を続行します。

（P）この記述文の繰り返し回数または繰り返し間隔オペランドを調べ，誤りを直し再実行します。

X3IF251-I

［記述文名］：｛X長｜Y長｜文字列｜文字属性｜文字属性1｜文字属性2｜文字サイズ｜文字並び｜繰り返し向き｜ボディサイズ｜文字数｜繰り返し回数｜種別｝に誤りがあります

記述文名で示す記述文において，X長，Y長，文字列，文字属性，文字属性1／2，文字サイズ，文字並び，繰り返し向き，ボディサイズ，文字数，繰り返し回数または種別が不当である。

（S）この記述文を無視し，処理を続行します。

（P）この記述文の文字列オペランドを調べ，誤りを直し再実行します。

X3IF252-I

［記述文名］：文字列をアポストロフィで囲んでいません

記述文名で示す記述文において，文字列がアポストロフィで囲まれていない。

（S）この記述文を無視し，処理を続行します。

（P）この記述文の文字列オペランドを調べ，文字列をアポストロフィで囲み再実行します。

X3IF254-I

GRAPHIC：｛網掛け種別｜X長，Y長｝，図形変換種別が対応していません

GRAPHIC文において，X長，Y長，図形変換種別の関係に誤りがある。

（S）この記述文を無視し，処理を続行します。

（P）図形変換種別オペランド，ドットパターン領域の指定を調べ，誤りを直し再実行します。

X3IF257-I

BOX：コーナ半径が｛X長｜Y長｝を超えています

BOX文のコーナ半径がX長またはY長を超えている。
コーナ半径は，「コーナ半径×2＜X長またはY長」の範囲内。

（S）この記述文を無視し，処理を続行します。

（P）この記述文のX長，Y長とコーナ半径を調べ，誤りを直し再実行します。

X3IF264-I

CHSIZE：CHSIZE文が32を超えています

1書式内に，32枚を超えるCHSIZE文を指定している。

（S）この記述文を無視し，処理を続行します。

（P）無視されたCHSIZE文を調べ，CHSIZE文を32以下にして再実行します。

X3IF266-I

［記述文名］： 記述文の位置に誤りがあります

記述文名で示す記述文が，記述文群中の不当な位置に置かれている。

（S）この記述文を無視し，処理を続行します。

（P）この記述文の位置を調べ，適切な位置に配置し直し再実行します。

X3IF270-I

GRAPHIC：コーナ半径が｛X長｜Y長｝を超えています

GRAPHIC文のコーナ半径が，X長またはY長を超えている。
コーナ半径は，「コーナ半径×2＜X長またはY長」の範囲内。

（S）この記述文を無視し，処理を続行します。

（P）この記述文のX長，Y長とコーナ半径を調べ，誤りを直し再実行します。

X3IF280-I

記述文の形式に誤りがあります

記述文に構文エラーがある。

（S）この記述文を無視し，処理を続行します。

（P）この記述文を調べ，誤りを直し再実行します。

X3IF281-I

［記述文名］は指定できません

記述文名で示す記述文は，タイプ1/2/R書式の記述文でない。

（S）この記述文を無視し，処理を続行します。

（P）この記述文を調べ，誤りを直し再実行します。

X3IF282-I

［セグメント名］セグメントが見つかりません

セグメント名で示す部品（セグメント）が部品ファイルにない。

（S）このセグメントを無視し，処理を続行します。

（P）部品ファイルを調べ，該当する部品があるかどうか調べます。

X3IF283-I

［記述文名］継続欄に誤りがあります

継続カードの指定に誤りがある。

（S）この記述文を無視し，処理を続行します。

（P）継続カードを調べ，誤りを直し再実行します。

X3IF284-I

［記述文名］：［オペランド名］オペランドのパラメタに誤りがあります

記述文名で示す記述文のオペランド名で示すオペランドに不当なパラメタが指定されている。

（S）この記述文を無視し，処理を続行します。

（P）該当オペランドを調べ，誤りを直し再実行します。

X3IF285-I

［記述文名］：［オペランド名］オペランドの区切りに誤りがあります

記述文名で示す記述文のオペランド名で示すオペランドに不当なパラメタが指定されている。

（S）この記述文を無視し，処理を続行します。

（P）該当オペランドを調べ，誤りを直し再実行します。

X3IF286-I

［記述文名］：［オペランド名］オペランドの括弧のつり合いがとれていません

記述文名で示す記述文の該当オペランドで示すオペランドの左括弧と右括弧の数が一致しない。

（S）この記述文を無視し，処理を続行します。

（P）この記述文を調べ，誤りを直し再実行します。

X3IF287-I

［記述文名］：［カラム番号］カラムに不当な文字があります

記述文名で示す記述文のカラム番号で示すカラムに不当な文字がある。

（S）この記述文を無視し，処理を続行します。

（P）この記述文を調べ，誤りを直し再実行します。

X3IF288-I

［記述文名］：［キーワード名］キーワードが重複しています

処理中の記述文において，キーワード名で示すキーワードが重複指定された。

（S）この記述文を無視し，処理を続行します。

（P）この記述文を調べ，誤りを直し再実行します。

X3IF309-I

記述文がありません

記述文が何も指定されていない。

（S）インポートの処理を終了します。

（P）この記述文を調べ，誤りを直し再実行します。

X3IF349-I

実行するための記憶領域が不足しました

タイプ1/2/R書式記述文を実行するために必要な作業領域が不足した。

（S）インポートの処理を終了します。

（P）使用可能な記憶域を拡大して再実行します。

X3IF501-I

［記述文名］：文字属性名が見つかりません。書体＝書体，ポイント＝ポイントを仮定します

記述文名に示す記述文に指定した文字属性が関連づけられていないため，プログラムで仮定する。書体，ポイント，拡大はプログラムで仮定した値を出力する。

（S）記述文的にはエラーではありませんが，仮定した値で変換します。

X3IF502-I

FORMS文で指定したます目の大きさまたは書式の大きさを{縦ます目サイズ：n|横ます目サイズ：n|X長：n|Y長：n}に変更しました

FORMS文で指定したます目の大きさ，または書式の大きさをそのまま変換できないため，nで示す値に変更した。

（S）この記述文の指定が正しいものとして処理を続行します。

X3IF503-I

［記述文名］：ECODE文とNCODE文に同じ文字データ名 は指定できません

記述文名に示す文字データ名は，すでにほかの記述文で指定しているため，指定できない。

ECODE文の文字データ名がすでにNCODE文で指定されている。

NCODE文の文字データ名がすでにECODE文で指定されている。

（S）この記述文を無視し，処理を続行します。

（P）この記述文を調べ，誤りを直し再実行します。

X3IF504-I

FORMS：書式名2の先頭が数字または書式名に@，#または¥が含まれています

FORMS文の書式名にPCで使用できない文字が指定された。

（S）インポート処理を中止します。

（P）この記述文の書式名を調べ，誤りを直し再実行します。

X3IF505-I

文字列が定義領域を超えたため削除しました

文字列が定義領域に収まらない。

（S）指定した文字列がすべて収まらない場合は，文字列を無視し，処理を続行します。

（P）この記述文を調べ，誤りを直し再実行します。

X3IF506-I

エクスポート時のデータ名がn個となり，384個を超えてしまいます

そのままエクスポートすると，データ名が384個を超えてしまうので，書式生成時にエラーになる。

（S）この記述文の指定が正しいものとして，処理を続行します。

（P）データ名の数が減るように，ドローで修正します。

19.　メインフレーム用の画面・帳票をPCで定義する

この章では，メインフレーム用のパネル定義文をPC上で開発し，メインフレームに転送するまでの手順について説明します。

＜この章の構成＞

19.1　メインフレーム向け開発環境の準備

19.2　メインフレーム用の画面・帳票の定義

19.3　テスト支援機能

19.4　パネル定義文の生成

19.5　パネル定義文の転送

19.6　メインフレーム用APの作成・流用の注意事項

19.7　画面・帳票エクスポート時のメッセージ（T-560/20用）

19.1　メインフレーム向け開発環境の準備

画面・帳票を定義する前に，パネル定義文格納用フォルダの用意や，定義環境の用意をします。

＜この節の構成＞

19.1.1　フォルダを作成する

19.1.2　開発環境の設定

19.1.3　実行環境の設定

19.1.4　外字の扱い方

19.1.1　フォルダを作成する

XMAP3インストール時には，XMAP3インストールフォルダに「¥USER¥MAPS」のフォルダが作成されます。これとは別のフォルダに格納したい場合，フォルダの名称や場所は任意に設定してください。

生成したファイルは，XMAP3インストールフォルダ以外のフォルダで管理することをお勧めします。なお，「XMAP3インストールフォルダ¥TEMP」の下に格納すると，正常に動作しませんので注意してください。

また，マップファイルを格納するフォルダにロングパス名を使用している場合，IFITによるマップファイルの転送ができないことがあります。フォルダ名にはロングパス名を使用しないことをお勧めします。

19.1.2　開発環境の設定

XMAP3の開発環境を，メインフレーム用の画面・帳票を定義する環境に設定します。開発環境のセットアップについては，マニュアル「XMAP3 開発・実行ガイド」を参照してください。次に示すターゲット環境の設定は，必ず実行してください。

＜この項の構成＞

(1)　ターゲット環境の設定

(2)　動的変更テーブルの更新

(1)　ターゲット環境の設定

XMAP3のドローセットアップを起動させます。セットアップダイアログの［運用管理者用の設定］ボタンを選択して，運用管理者用の設定を活性状態にしてください。

セットアップダイアログの［ターゲットの設定...］ボタンをクリックしてください。ターゲット環境の設定ダイアログが表示されます。

分散開発の対象に応じたターゲット環境を選択してください。ターゲット環境の選択基準を次に示します。

ターゲット環境に応じて，次の項目を選択してください。

VOS3で使用する画面・帳票を定義する場合：
「VOS3用の画面・帳票開発」

VOS1で使用する画面・帳票を定義する場合：
「VOS1用の画面・帳票開発」

VOSKで使用する画面・帳票を定義する場合：
「VOSK用の画面・帳票開発」

ターゲット環境を選択したら［OK］ボタンをクリックしてください。メインフレームで運用する画面・帳票を，PCで生成するための開発環境になります。

注意

ドローセットアップを起動しているときは，XMAP3のほかの機能を起動させないでください。

(2)　動的変更テーブルの更新

Windowsとメインフレームではデータ有無コードに違いがあるので，ターゲット環境を変更すると，動的変更テーブルの更新が必要になることがあります。また，ドローセットアップで修飾名を修飾名を変更した場合も，動的変更テーブルが更新されます。

この場合，ドローセットアップで設定を保存するときにX3MODTBLの更新ダイアログが表示されます。

ファイル名や出力先を変更する場合は，［参照...］ボタンをクリックして指定してください。

［OK］ボタンをクリックすると，動的変更テーブルにデータ有無コードが書き込まれます。上書きする場合は，日付確認のメッセージが表示されます。［OK］ボタンをクリックすると，新しい動的変更テーブルが生成され，上書き前の動的変更テーブルはX3MODBAK.CBL，X3MODBAK.Hとして保存されます。なお，「X3MODTBL.H」はC言語用の動的変更テーブルです。メインフレーム用のパネル定義文を生成する場合は使用しません。

更新後の動的変更テーブルの先頭部分は次のようになります。

ドローセットアップでのターゲット環境とデータ有無コードの関係を次の表に示します。

表19-1　ターゲット環境の設定とデータ有無コードの関係

ターゲット環境の設定 | データ有無コード
VOS3用の画面・帳票開発 | X'3F'
VOS1用の画面・帳票開発 | X'3F'
VOSK用の画面・帳票開発 | X'3F'

アプリケーションでほかの値のデータ有無コードを使用する場合は，動的変更テーブルを修正してください。

19.1.3　実行環境の設定

メインフレーム用に定義した画面・帳票の表示テストまたは印刷テストをするためには，PC上の実行環境を設定する必要があります。実行環境の設定については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

19.1.4　外字の扱い方

メインフレームで利用できる外字の数は，KEISコードの外字にあたる3,008文字ですが，PC上で利用できる外字は，シフトJISコードの外字のうち，機種依存文字を除いた1,880文字だけが使用できます。メインフレーム上のAPで1,880文字を超える数の外字が必要な場合は，メインフレーム上で改めて定義してください。

また，PC上のマップで外字を利用するには，Windowsに付属の外字エディタで定義して，システム中の各PCに配布してください。

外字に使用できる文字コードについては，「付録B.3　外字用コードの割り当て」を参照してください。

パネル定義文をPCからメインフレームに転送するときに，文字コードがシフトJISからKEISに変換されます。外字の運用形態によって必要となる注意事項について説明します。

＜この項の構成＞

(1)　外字マッピングファイルをカスタマイズしている場合

(2)　XMAP3外字機能を使用している場合

(1)　外字マッピングファイルをカスタマイズしている場合

コード変換SDKまたは日立コード変換 - Development Kitを使用して，シフトJISとKEISの外字マッピングファイルをカスタマイズしている場合，CommuniNetの文字コードのマッピングも同様にカスタマイズしてください。

CommuniNetの文字コードのマッピングを変更するには，CommuniNetのコードマッピングユティリティを使用してください。

(2)　XMAP3外字機能を使用している場合

UnicodeとKEISの外字マッピングファイルは文字コードの変換には影響しません。

19.2　メインフレーム用の画面・帳票の定義

PCの対話定義環境については，マニュアル「XMAP3 プログラミングガイド 画面編」およびマニュアル「XMAP3 プログラミングガイド 帳票編」を参照してください。

また，インポート機能を利用して，メインフレームでのマップ定義をPC用のマップ定義に変換できます。インポート機能については，「17. メインフレームの画面・帳票をPCへ移行する」を参照してください。ただし，一部の機能については変換に制限があります。メインフレームのXMAPとPCのXMAP3との機能差については，「付録B　メインフレームとの処理分散」を参照してください。

＜この節の構成＞

19.2.1　画面の定義

19.2.2　シリアルプリンタ（HT-5344）用帳票の定義

19.2.3　ページプリンタ（HT-2311）用帳票の定義

19.2.1　画面の定義

画面は，XMAP3のドローで定義します。メインフレーム用に定義できる画面は，CUI画面だけです。また，マップの構成要素には，メインフレームのXMAPでは定義できても，PCのXMAP3では定義できないものがあります。詳細については「付録D.1　エクスポート機能で変換できるCUI画面の機能範囲」を参照してください。

＜この項の構成＞

(1)　トランザクションコードの定義

(2)　下位項目の定義

(3)　共用項目

(4)　ページング

(5)　1,880文字を超える外字

(6)　ピクチャ文字

(7)　拡大項目の定義

(8)　複数行項目の定義

(9)　混在項目

(1)　トランザクションコードの定義

オンライン環境で使用するトランザクションコードを定義するためには，隠しフィールドを定義してください。

ただし，XMAP3のドローで定義できる隠しフィールドの大きさは，入力論理マップの先頭8バイト分までです。9バイト以上の大きさが必要な場合は次のようにしてください。

隠しフィールドの代わりに，適当な入力フィールドを定義します。画面を定義したら，XMAP3でパネル定義文を生成します。パネル定義文で，定義した入力フィールドの部分を，隠しフィールドの定義に修正します。

修正後の例を次に示します。下線の個所が修正した部分です。

(2)　下位項目の定義

フィールドの使用目的を「日本語」，データ型を「文字型（XX）」と設定した場合，エクスポート機能で変換したパネル定義文では，下位項目の長さはドローで定義したとおりに出力されます。エクスポート機能で変換したあとで，実際に使用する長さに合わせてパネル定義文を修正してください。

(3)　共用項目

共用項目を定義したい場合は，ドローでは出力フィールドとして定義してください。生成したパネル定義文の該当する出力フィールドの部分を，共用項目の形式に修正してください。

(4)　ページング

ページングを定義したい場合，1画面ずつ作成し，それぞれパネル定義文を生成してください。そして，ページングされる画面のパネル定義文を一つのファイルにまとめます。

(5)　1,880文字を超える外字

PCで直接扱える外字は1,880文字までなので，ドローで定義するときには，1,880文字に収まらない外字を，出力テキストなどに使用しない漢字または記号に置き換えて定義してください。生成されたパネル定義文を転送したあとで，定義時に使った文字を使用する外字に置き換えてください。

なお，XMAP3外字機能で1,880字を超える外字を使用する場合でも，ドローで使用できる外字は，シフトJISコードで使用できる1,880字だけです。つまり，固定テキストなどの項目に，標準以外の外字を表示させることはできません。

(6)　ピクチャ文字

数字編集文字列中に「/」が含まれている場合，エクスポート機能でパネル定義文を生成するときには，数字型ではなく文字型として変換されます。変換例を示します。

(7)　拡大項目の定義

メインフレームでは，長体または倍角の項目を配置した行の前後の行を使って，長体または倍角を配置することはできません。ドローでは定義できますが，このような定義は行わないようにしてください。

(8)　複数行項目の定義

メインフレームでは，80列から2バイトコードの文字を表示すると，その文字が複数行にわたって，表示不正となる場合があります。2バイトコードの文字が80列から始まるような項目の定義は行わないようにしてください。

(9)　混在項目

埋字，および拡大の指定はできません。指定しても，生成されるパネル定義文には反映されません。また，論理項目長は次のとおりです。

「データ長を変更する」ボタンがオンの場合：ダイアログで指定したデータ長

「データ長を変更する」ボタンがオフの場合：桁（項目長）×7÷3＋3

19.2.2　シリアルプリンタ（HT-5344）用帳票の定義

帳票は，XMAP3のドローで定義します。

ただし，マップの構成要素には，メインフレームのXMAPでは定義できても，XMAP3では定義できないものがあります。詳しくは，「付録D.2(1)　けい線帳票で生成できるパネル定義文の範囲」を参照してください。主な注意事項を次に示します。

＜この項の構成＞

(1)　下位項目の定義

(2)　混在項目

(3)　固定項目・可変項目

(4)　ページング

(5)　パネル定義文に反映されない指定

(6)　1,880文字を超える外字

(7)　ピクチャ文字

(8)　出力フィールド

(1)　下位項目の定義

フィールドの使用目的を「日本語」，データ型を「文字型（XX）」と設定した場合，エクスポート機能で変換したパネル定義文では，下位項目の長さはドローで定義したとおりに出力されます。エクスポート機能で変換したあとで，実際に使用する長さに合わせてパネル定義文を修正してください。

(2)　混在項目

埋字，および文字の拡大の指定はできません。指定しても，生成されるパネル定義文には反映されません。

また，論理項目長は次のとおりです。

「データ長を変更する」ボタンがオンの場合：ダイアログで指定したデータ長

「データ長を変更する」ボタンがオフの場合：桁（項目長）×7÷3＋3

(3)　固定項目・可変項目

シリアルプリンタ（HT-5344）用の帳票定義では，DFCが占有されます。したがって，固定項目および可変項目を定義する場合，ドロー上では間隔をあけずに定義できますが，必ず間隔を空けてください。

また，定義した項目はすべて1バイト右にずれるので，右端に定義した項目が帳票からはみ出すことがあります。

(4)　ページング

ページングを定義したい場合，帳票1枚分ずつ作成し，それぞれパネル定義文を生成してください。そして，ページングされる帳票のパネル定義文を一つのファイルにまとめます。

(5)　パネル定義文に反映されない指定

ドロー上で指定しても，生成されるパネル定義文には反映されない例を次に示します。

帳票属性ダイアログのます目設定でCPI/LPIを指定，または行の間隔を指定

帳票属性ダイアログの文字の間隔で0ポイント，2ポイント，4ポイント以外を指定

けい線の線の太さの指定

項目ごとの字間値

(6)　1,880文字を超える外字

PCで直接扱える外字は1,880文字までなので，ドローで定義するときには，1,880文字に収まらない外字を，出力テキストなどに使用しない漢字または記号に置き換えて定義してください。生成されたパネル定義文を転送したあとで，定義時に使った文字を使用する外字に置き換えてください。

なお，XMAP3外字機能で1,880字を超える外字を使用する場合でも，ドローで使用できる外字は，シフトJISコードでも使用できる1,880字だけです。つまり，固定テキストなどの項目に，標準以外の外字を表示させることはできません。

(7)　ピクチャ文字

数字編集文字列中に「/」が含まれている場合，エクスポート機能でパネル定義文を生成するときには，数字型ではなく文字型として変換されます。変換例を示します。

(8)　出力フィールド

XMAP3でメインフレーム用のパネル定義文を生成した場合，次に示す条件をすべて満たした出力フィールドはパネル定義文に反映されません。

画面・帳票の種類：グラフィック帳票以外の画面・帳票

フィールド反復：横方向

文字の拡大：平体，または倍角

したがって，このような出力フィールドを定義した画面・マップ帳票は使用しないでください。

19.2.3　ページプリンタ（HT-2311）用帳票の定義

帳票は，XMAP3のドローで定義します。

ただし，マップの構成要素には，メインフレームのXMAPでは定義できても，XMAP3では定義できないものがあります。詳しくは，「付録D.3　エクスポート機能で変換できる網掛け帳票の機能範囲」を参照してください。主な注意事項を次に示します。

＜この項の構成＞

(1)　下位項目の定義

(2)　混在項目

(3)　用紙サイズ・ます目サイズ

(4)　ページング

(5)　1,880文字を超える外字

(6)　ピクチャ文字

(7)　出力フィールド

(1)　下位項目の定義

フィールドの使用目的を「日本語」，データ型を「文字型（XX）」と設定した場合，エクスポート機能で変換したパネル定義文では，下位項目の長さはドローで定義したとおりに出力されます。エクスポート機能で変換したあとで，実際に使用する長さに合わせてパネル定義文を修正してください。

(2)　混在項目

埋字，および文字の拡大の指定はできません。指定しても，生成されるパネル定義文には反映されません。

また，論理項目長は次のとおりです。

「データ長を変更する」ボタンがオンの場合：ダイアログで指定したデータ長

「データ長を変更する」ボタンがオフの場合：桁（項目長）×7÷3＋3

(3)　用紙サイズ・ます目サイズ

帳票属性ダイアログのます目設定で，CPI/LPIを指定しても，生成されるパネル定義文にCPIは反映されません。

帳票属性ダイアログのます目設定で15CPI/8LPIを指定，または行の間隔で8LPIを指定した場合，パネル定義文では6LPIになります。

項目ごとの字間値は，生成されるパネル定義文には反映されません。

(4)　ページング

ページングを定義したい場合，帳票1枚分ずつ作成し，それぞれパネル定義文を生成してください。そして，ページングされる帳票のパネル定義文を一つのファイルにまとめます。

(5)　1,880文字を超える外字

PCで直接扱える外字は1,880文字までなので，ドローで定義するときには，1,880文字に収まらない外字を，出力テキストなどに使用しない漢字または記号に置き換えて定義してください。生成されたパネル定義文を転送したあとで，定義時に使った文字を使用する外字に置き換えてください。

なお，XMAP3外字機能で1,880字を超える外字を使用する場合でも，ドローで使用できる外字は，シフトJISコードでも使用できる1,880字だけです。つまり，固定テキストなどの項目に，標準以外の外字を表示させることはできません。

(6)　ピクチャ文字

数字編集文字列中に「/」が含まれている場合，エクスポート機能でパネル定義文を生成するときには，数字型ではなく文字型として変換されます。変換例を示します。

(7)　出力フィールド

XMAP3でメインフレーム用のパネル定義文を生成した場合，次に示す条件をすべて満たした出力フィールドはパネル定義文に反映されません。

画面・帳票の種類：グラフィック帳票以外の画面・帳票

フィールド反復：横方向

文字の拡大：平体，または倍角

したがって，このような出力フィールドを定義した画面・マップ帳票は使用しないでください。

19.3　テスト支援機能

XMAP3では，メインフレーム用の画面・帳票を定義したあとで，PC上で画面表示・帳票印刷のテストができます。ただし，メインフレームとPCとでは表示や印刷の機能が異なるため，PCでのテスト結果とメインフレームでの出力結果が異なる場合があります。ここでは，メインフレームとPCの出力機能の違いについて，注意が必要な点を説明します。

なお，PC上でテスト支援機能を利用するためには，あらかじめXMAP3の実行環境を設定しておいてください。

テスト支援機能を使用する場合はいったんターゲット環境を「PC用の画面・帳票開発」に設定し，マップファイルを出力する必要があります。ドローによるテスト表示・印刷時には，エクスポート時に発生するメッセージも画面表示されるため，効率良く画面・帳票を開発できます。

XMAP3の実行環境の設定方法およびテスト支援機能の利用方法については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

＜この節の構成＞

19.3.1　シリアルプリンタ（HT-5344）の場合

19.3.2　ページプリンタ（HT-2311）の場合

19.3.1　シリアルプリンタ（HT-5344）の場合

＜この項の構成＞

(1)　プレプリント用紙に印刷する場合

(2)　帳票の大きさ

(3)　字体

(4)　けい線

(1)　プレプリント用紙に印刷する場合

メインフレーム用のプリンタとPC用のプリンタとでは，dpiの数値が違います。また，帳票のパネル定義文では，mm単位ではなくドット単位でマージンを指定するので，印刷したときのマージンの大きさはメインフレームとPCとで異なります。したがって，帳票の一部分があらかじめ印刷されている用紙（プレプリント用紙）に印刷する場合，PC上のテスト印刷ではあらかじめ印刷された枠の中に収まるように印字できても，メインフレーム上で印刷したときには印字結果が枠からずれてしまうことがあります。

(2)　帳票の大きさ

メインフレーム用のプリンタとPC用のプリンタでは，dpiの数値が異なるので，印刷したときの帳票の大きさが異なります。

(3)　字体

メインフレーム用のプリンタとPC用のプリンタとでは，印刷される文字の字体や太さが異なります。

(4)　けい線

メインフレーム用のプリンタとPC用のプリンタとではdpiの数値が異なるので，印刷されるけい線の太さが異なります。

また，メインフレーム用のプリンタでは，縦のけい線のすべてが，占有するますの右端または中央に出力されます。さらに，帳票全体の右端にけい線がある場合，印刷されないことがあります。

19.3.2　ページプリンタ（HT-2311）の場合

＜この項の構成＞

(1)　プレプリント用紙に印刷する場合

(2)　帳票の大きさ

(3)　文字・けい線の太さ

(4)　網掛け・破線

(1)　プレプリント用紙に印刷する場合

メインフレーム用のプリンタとPC用のプリンタとでは，dpiの数値が違います。また，帳票のパネル定義文では，mm単位ではなくドット単位でマージンを指定するので，印刷したときのマージンの大きさはメインフレームとPCとで異なります。したがって，帳票の一部分があらかじめ印刷されている用紙（プレプリント用紙）に印刷する場合，PC上のテスト印刷ではあらかじめ印刷された枠の中に収まるように印字できても，メインフレーム上で印刷したときには印字結果が枠からずれてしまうことがあります。

メインフレーム上でプレプリント用紙に正しく印刷するためには，メインフレーム側でプリンタの設定を変更して，マージンを微調整してください。

(2)　帳票の大きさ

メインフレーム用のプリンタとPC用のプリンタでは，dpiの数値が異なるので，印刷したときの帳票の大きさが異なります。

(3)　文字・けい線の太さ

メインフレーム用のプリンタとPC用のプリンタでは，dpiの数値が異なるので，印刷したときの文字・けい線の太さが異なります。

(4)　網掛け・破線

メインフレーム用のプリンタとPC用のプリンタでは，網掛けの濃さや破線の点の間隔が異なります。

19.4　パネル定義文の生成

ドローが作成するパネル定義文は，そのままメインフレームに転送して利用できますが，複数の画面・帳票のパネル定義文生成を一括して実行したい場合はユティリティのエクスポート機能を利用します。

ドローで作成したマップ定義ファイルから，パネル定義文を生成する手順を説明します。パネル定義文の生成には，エクスポート機能を利用します。

ドローセットアップを起動し，ターゲット環境が正しく設定されていることを確認します。

XMAP3のユティリティメインダイアログで「エクスポート」を選択し，［実行］ボタンをクリックします。

エクスポートダイアログが表示されます。

「ファイルの選択」の［参照...］ボタンをクリックして，パネル定義文を生成するためのマップ定義ファイルを指定します。
選択されたファイルがリストボックスに表示されます。

「ファイルの出力先」の［参照...］ボタンをクリックして，パネル定義文の出力先を指定します。

［変換］ボタンをクリックして，エクスポート機能を実行します。
生成されるファイルは，パネル定義文ファイル（拡張子は.XMP）です。エクスポート機能では変換できない種類のマップ定義ファイルを選択した場合，変換は行わずにリターンコードとして-4を返します。ダイアログには「RC<-4>」と表示されます。また，エラーメッセージが「マップ定義ファイル名.ERR」に出力されます。

なお，リストボックスに表示されているファイルをクリックして選択状態を解除することで，エクスポート対象外にできます。

19.5　パネル定義文の転送

生成したパネル定義文をメインフレームに転送する手順について，メインフレーム側のOS別に説明します。動的変更を利用する場合は，ドローセットアップで生成した動的変更テーブルもメインフレームに転送してください。

＜この節の構成＞

19.5.1　パネル定義文をVOS3に転送する

19.5.2　パネル定義文をVOS1に転送する

19.5.3　パネル定義文をVOSKに転送する

19.5.1　パネル定義文をVOS3に転送する

XMAP3で生成したパネル定義文は，PC上のCommuniNetでIFITを使用してVOS3へ転送します。IFITについては，マニュアル「ファイル伝送プログラムIFIT-TSS E2」を参照してください。

(a)　メインフレーム上の出力ファイルの属性

メインフレーム上に出力するファイルは次に示す属性にしてください。

レコード形式は固定長

レコード長は80バイト

(b)　CommuniNetの環境を設定する

CommuniNetの環境設定ユティリティを起動します。「端末名称」は転送するファイルの置かれている端末を選択して，「設定項目」の「ファイル転送」をダブルクリックします。ファイル転送の設定ダイアログが表示されるので，「コード変換」を「あり」にして，［OK］ボタンをクリックします。

(c)　IFITのメニュー画面を使用して転送する場合

ファイル伝送機能の呼び出し
IFITコマンドを実行して，ファイル伝送機能の画面を呼び出します。

転送するファイルの設定

「FUNCTION NO.」は2（TERMINAL->HOST）を選択してください。

「HOST DATA SET NAME」の項に，メインフレーム上に出力するファイル名などを指定します。このとき，PC上のファイルに付いていた拡張子は付けないでください。

「TERMINAL FILE NAME」の項に，PCから転送するファイル名を完全なパス名で指定します。

(d)　IFITコマンドを使用して転送する場合

IFITコマンドを使用した転送の形式は，次のとおりです。

コマンド
オペランド

IFIT
△'メインフレーム上に出力するファイル名'
△PCから転送するファイル名
△INPUT(TERMINAL)

19.5.2　パネル定義文をVOS1に転送する

XMAP3で生成したパネル定義文は，PC上のCommuniNetからIFITを使用してVOS1へ転送します。IFITについては，マニュアル「ワークステーション操作 －パネル編－」，またはマニュアル「ワークステーション操作 －コマンド編－」を参照してください。

(a)　メインフレーム上の出力ファイルの属性

メインフレーム上に出力するファイルは次に示す属性にしてください。

レコード形式は固定長

レコード長は80バイト

データコードはDATA

(b)　CommuniNetの環境を設定する

CommuniNetの環境設定ユティリティを起動します。「端末名称」は転送するファイルの置かれている端末を選択して，「設定項目」の「ファイル転送」をダブルクリックします。ファイル転送の設定ダイアログが表示されるので，「コード変換」を「あり」にして，［OK］ボタンをクリックします。

(c)　IFITのメニュー画面を使用して転送する場合

IFITのメニュー画面を使用して転送する手順を次に示します。

ファイル伝送機能の呼び出し

マスタメニューの項目5「OA業務実行」を選択します。

OA業務実行メニューの項目5「パソコンファイル伝送」を選択します。

対話型ファイル伝送メニューの項目1「LIMEファイルのファイル伝送」を選択します。

転送するファイルの設定
「ホスト側ファイル情報」の項に，メインフレーム上に出力するファイル名などを指定します。このとき，PC上のファイルに付いていた拡張子は付けないでください。なお，レコード形式は「1:F」を選択し，レコード長は80バイトにしてください。「ワークステーション側ファイル情報」の項に，PCから転送するファイル名を完全なパス名で指定してください。

(d)　@@IFITコマンドを使用して転送する場合

@@IFITコマンドを使用した転送の形式は，次のとおりです。

コマンド
オペランド

@@IFIT
△FTYPE=LIME
,WSF='PCから転送するファイル名'
,RL=80
,TRN=WH
,FILE=メインフレーム上に出力するLIMEファイル名
,LIBRARY=メインフレーム上に出力するLIMEライブラリ名
,DC=DATA
,MEMBER=メインフレーム上に出力するメンバ名

19.5.3　パネル定義文をVOSKに転送する

XMAP3で生成したパネル定義文は，PC上のCommuniNetからIFITを使用してVOSKへ転送します。IFITについては，マニュアル「コマンド」，またはマニュアル「パネル」を参照してください。

(a)　メインフレーム上の出力ファイルの属性

メインフレーム上に出力するファイルは次に示す属性にしてください。

レコード形式は固定長

レコード長は80バイト

ファイルタイプはMAP

(b)　CommuniNetの環境を設定する

CommuniNetの環境設定ユティリティを起動します。「端末名称」は転送するファイルの置かれている端末を選択して，「設定項目」の「ファイル転送」をダブルクリックします。ファイル転送の設定ダイアログが表示されるので，「コード変換」を「あり」にして，［OK］ボタンをクリックします。

(c)　IFITのメニュー画面を使用して転送する場合

IFITのメニュー画面を使用して転送する手順を説明します。

ファイル転送機能の呼び出し

操作マスタメニューの項目3「ファイル操作」を選択します。

ファイル操作メニューの項目9「ファイルの伝送」を選択します。

ファイル伝送メニューの項目9「WSとのファイル転送」を選択します。

転送するファイルの設定

「入力ファイル名」の項に，PCから転送するファイル名を指定します。

「出力ファイル名」の項に，メインフレーム上に出力するファイル名を指定します。このとき，PC上のファイルに付いていた拡張子は付けないでください。

「レコード末尾の埋字」として「16#40」を指定してください。

(d)　IFITコマンドを使用して転送する場合

IFITコマンドを使用した転送の形式は，次のとおりです。

コマンド
オペランド

IFIT
,IN=PCから転送するファイル名
,OUT=メインフレーム上に出力するファイル名
,PADDING=16#40

19.6　メインフレーム用APの作成・流用の注意事項

メインフレームでAPを作成する場合，または既存のメインフレーム用APを流用する場合は，次の点に注意してください。

＜この節の構成＞

19.6.1　論理マップの項目名

19.6.2　変更属性定義

19.6.3　16進指定（DFC）の動的変更

19.6.1　論理マップの項目名

メインフレームに転送したパネル定義文から，メインフレーム用のXMAPを使用して物理マップと論理マップを生成します。画面のパネル定義文からは入力論理マップと出力論理マップが，帳票のパネル定義文からは出力論理マップが生成されます。

XMAP3で定義したパネル定義文から生成された論理マップは，次のような形式になります。

入力項目

マップ名-項目の名称I

出力項目

マップ名-項目の名称O

新しくAPを作成する場合，プログラム中の論理マップの項目名を，上に示した形式に一致させてください。また，メインフレームで利用していたCOBOLのAPを流用する場合，論理マップの項目名が上に示した形式に一致しているかどうかを確認してください。一致していない場合，パネル定義文またはAPを修正してください。

19.6.2　変更属性定義

フィールドの変更属性定義およびウィンドウ表示制御の変更属性定義は，XMAP3の開発環境セットアップから，対話定義の初期情報の設定ダイアログで設定できます。

19.6.3　16進指定（DFC）の動的変更

16進指定（DFC）の動的変更はXMAP3からは設定できません。APで動的変更が必要な場合は，修飾名を動的変更領域に設定してください。なお，XMAP3では，ドローセットアップでの設定に応じて動的変更テーブルが自動的に生成されます。

動的変更を元に戻すときは，APからデータ有無コードを動的変更領域に設定してください。

19.7　画面・帳票エクスポート時のメッセージ（T-560/20用）

エクスポート機能で，T-560/20用に作成したマップ定義ファイルからパネル定義文を生成するときに，次に示す定義がある場合，エラーメッセージを出力します。

生成されたパネル定義文をメインフレームで運用すると，解析時にエラーとなるもの。

エクスポート時にオブジェクトを破棄，または設定内容を変更しているもの。

エラーが発生した場合でも，パネル定義文は出力されます。

＜この節の構成＞

(1)　エラーファイルの形式

(2)　出力するメッセージの詳細

(3)　メッセージの詳細

(4)　そのほかのエラーメッセージ

(1)　エラーファイルの形式

エラーファイルのファイル名は，「マップ定義ファイル名.ERR」です。エラーファイルは，エクスポートダイアログで設定したパネル定義文ファイルの出力先に出力されます。

(2)　出力するメッセージの詳細

出力するメッセージの形式を次に示します。

［メッセージID］

［位置情報］［メッセージテキスト］

(a)　メッセージID：X3EHnnn-y

X3EH

メインフレームエクスポート時のメッセージであることを示します。

nnn

メッセージ通番を示します。

y

メッセージの種類を示します。出力されるメッセージの種類を次に示します。

W：異常メッセージ
メインフレームで解析時にエラーとなるので，ドローでの再定義が必要なもの。

I：警告メッセージ
メインフレームで解析時にエラーとならないので，ドローでの再定義が不要なもの。

(b)　位置情報

メッセージ出力対象のオブジェクトのドロー上の定義位置を示します。なお，レイアウト全体に関するメッセージなど，位置情報を持たない場合は出力しません。

出力例を次に示します（xxxxxは5けたの数字を示します）。

フレーム外の場合
［縦xxxxxます，横xxxxxます］

フレーム内の場合
フレーム名［縦xxxxxます，横xxxxxます］

(c)　メッセージテキストの詳細

メッセージテキストについて説明します。

（S）エクスポートの処理
メッセージを出力したあとの主な処理を示します。

（P）プログラマの処置
メッセージを受け取ったプログラマが取るべき処置を示します。

(3)　メッセージの詳細

個々のメッセージについて説明します。なお，ここで記述しているのはT560/20用に作成したマップ定義ファイルのエクスポート機能に固有のメッセージだけです。XMAP3全体に共通のメッセージについては，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

X3EH901-W

［位置情報］｛出力フィールド｜出力フィールドの下位項目｜入力フィールド｜入力フィールドの下位項目｜入出力フィールド｜入出力フィールドの下位項目｜フレーム｝のデータ名の長さは，メインフレームXMAPの制限を超えています

フィールド，フィールドの下位項目またはフレームのデータ名の長さがメインフレームXMAPの制限値（28バイト）を超えている。

（S）指定されたデータ名でパネル定義文を生成します。

（P）データ名の長さを短くして，マップ定義ファイルを再作成したあと，エクスポートを再実行します。

X3EH902-W

｛隠しフィールド｜再定義名｜入力カーソル｜出力カーソル｜通知コード｝のデータ名の長さは，メインフレームXMAPの制限を超えています

隠しフィールド，再定義名，入力カーソル，出力カーソル，通知コードのどれかのデータ名の長さがメインフレームXMAPの制限値（28バイト）を超えている。

（S）指定されたデータ名でパネル定義文を生成します。

（P）データ名の長さを短くして，マップ定義ファイルを再作成したあと，エクスポートを再実行します。

X3EH903-W

けい線の配置方法をます目の中央に変換したため，メインフレームXMAPでけい線と項目が重なる可能性があります

けい線帳票で，帳票属性の「けい線の配置方法」に「ます目に沿って引く」を指定している。

（S）「けい線の配置方法」の設定値を「ます目の中央」に変換してパネル定義文を生成します。

（P）けい線の配置方法の設定を変更して，マップ定義ファイルを再作成したあと，エクスポートを再実行します。

X3EH201-I

｛左｜上｝マージンを36.1mmに変換しました

網掛け帳票の帳票属性の左マージンまたは上マージンに，36.2mm以上を指定している。

（S）指定された対象属性を変換結果で示す値に変換して，パネル定義文を生成します。

（P）対象属性を変換結果で示す値に変換して，マップ定義ファイルを再作成したあと，エクスポートを再実行します。

X3EH203-I

［位置情報］｛¹｛入出力｜出力｝フィールドのデータ型を「文字（XX）」｜²｛入出力｜出力｝フィールドの下位項目のデータ型を「文字（XX）」｜³｛入出力｜出力｝フィールドの埋字を「埋めない」｜⁴入出力フィールドの数字編集の入力チェックを数字の入力チェック｜⁵出力フィールドの拡大属性を標準｜⁶｛固定フィールド｜出力フィールド｜予約フィールド｝の｛文字サイズ｜文字の間隔｝を標準｜⁷出力OCRの書体属性を標準｜⁸けい線の線の種類を実線｜⁸けい線の線の太さを中｝に変換しました

次の指定をしている場合に出力される（項番と上記メッセージ内の上付き数字が対応してメッセージが出力される）。

出力フィールドのデータ型に「/」ありの数字編集文字列を指定している。または，入出力フィールドのデータ型に「その他ピクチャ」を指定し，出力用ピクチャに「/」ありの数字編集文字列を指定している。

出力フィールドの下位項目のデータ型に「/」ありの数字編集文字列を指定している。または，入出力フィールドのAPが渡す項目の下位項目のデータ型に「/」ありの数字編集文字列を指定している。または，使用目的が「日本語」でデータ型が「文字（XX）」の入出力，出力フィールドの下位項目のデータ型に数字編集文字列を指定している。

使用目的が「日本語」でかつデータ型が文字（XX）の入出力，出力フィールドの埋字に「埋字なし」以外を指定している。

入出力フィールドの使用目的が「数字」でかつデータ型に「文字（XX）」以外を指定している。

出力フィールドの使用目的が「日本語」でかつデータ型が「文字（XX）」の文字の拡大に「標準」以外を指定している。

けい線帳票で固定フィールド，出力フィールドまたは，予約フィールドの文字の間隔に「標準」以外を指定している。または，網掛け帳票で固定フィールド，出力フィールドまたは，予約フィールドの文字サイズに「7ポイント」を指定している。

けい線帳票で出力OCRを指定している。

けい線帳票でけい線の線の種類に破線または，線の太さに細を指定している。

（S）指定された対象属性を変換結果で示す値に変換して，パネル定義文を生成します。

（P）オブジェクトの対象属性を変換結果で示す値に変換して，マップ定義ファイルを再作成したあとで，エクスポートを再実行します。

X3EH206-I

帳票属性の｛¹行の間隔｜²文字の間隔｜³文字サイズ｝を標準に変換しました

次の指定をしている場合に出力される（項番と上記メッセージ内の上付き数字が対応してメッセージが出力される）。

けい線帳票または網掛け帳票の帳票属性でます目設定に「自由な設定」を指定し，行の間隔に「8LPI」を指定している。

けい線帳票の帳票属性でます目設定に「自由な設定」を指定し，文字の間隔に「0ポイント」「2ポイント」「4ポイント」以外を指定している。

網掛け帳票の帳票属性でます目設定に「自由な設定」を指定し，文字サイズに「7ポイント」を指定している。

（S）指定された帳票属性を変換結果で示す値に変換し，パネル定義文を生成します。

（P）該当するオブジェクトの属性を指定しないマップ定義ファイルを再作成したあと，エクスポートを再実行します。

X3EH207-I

帳票属性の｛¹ます目設定｜²文字間隔｜³印刷ドキュメント名｜⁴印刷ドキュメント名をAPで変更する指定｝を破棄しました

次の指定をしている場合に出力される（項番と上記メッセージ内の上付き数字が対応してメッセージが出力される）。

けい線帳票の帳票属性でます目設定に「自由な設定」以外を指定した場合，ます目設定は破棄される。

網掛け帳票の帳票属性でます目設定に「自由な設定」以外を指定した場合，文字間隔が破棄される。ただし，行の間隔は6LPI固定となる

帳票属性で印刷ドキュメント名を指定している。

帳票属性で「印刷ドキュメント名をAPで変更する」の項目を選択している。

（S）指定された帳票属性を破棄して，パネル定義文を生成します。

（P）該当する帳票属性を指定しないマップ定義ファイルを再作成したあと，エクスポートを再実行します。

(4)　そのほかのエラーメッセージ

エクスポート機能やマップ生成機能を実行したとき，エラーの内容に応じて次に示すメッセージが出力されます。

この定義ファイルは，現在のターゲットでは指定できません。

CUI画面，けい線帳票，および網掛け帳票以外のマップ定義ファイルを，メインフレーム用の画面・帳票としてエクスポートしようとした。

グラフィック帳票以外のマップ定義ファイルを，メインフレーム用のタイプ3書式としてエクスポートしようとした。

対策

コンバート機能などを使って，正しい画面・帳票の種類に変換したあと，再度エクスポートを実行してください。

この定義ファイルは，言語種別がCOBOL以外のため指定できません。

言語種別が「COBOL」以外のマップ定義ファイルを，メインフレーム用の画面・帳票，またはタイプ3書式としてエクスポートしようとした。

ターゲット環境が「メインフレーム-PC分散用の画面・帳票開発」のとき，言語種別がCOBOL以外のマップ定義ファイルに対してマップ生成を実行した。

対策

コンバート機能などを使って，言語種別を「COBOL」に変換してから再度エクスポートやマップ生成を実行してください。

ドローセットアップでマップ名の長さを7文字に設定して作成した定義ファイルは指定できません。

ドローセットアップで「マップ名の長さ」を「7文字」に設定したマップ定義ファイルを，メインフレーム用の画面・帳票，またはタイプ3書式としてエクスポートしようとした。

ターゲット環境が「メインフレーム-PC分散用の画面・帳票開発」のとき，ドローセットアップで「マップ名の長さ」を「7文字」に設定したマップ定義ファイルに対してマップ生成を実行した。

対策

ドローセットアップで「マップ名の長さ」を「6文字」に設定し直して，再度，マップ定義ファイルを作成してから，エクスポートやマップ生成をしてください。

20.　メインフレーム用のタイプ3書式をPCで定義する

この章では，メインフレームで使用するためのタイプ3書式をPC上で定義し，メインフレームに転送するまでの手順について説明します。

＜この章の構成＞

20.1　開発環境の準備

20.2　定義内容の決定

20.3　ドローによるタイプ3書式の定義

20.4　パネル定義文ファイルの生成

20.5　パネル定義文ファイルの転送

20.6　メインフレームでの注意事項

20.7　タイプ3書式エクスポート時のメッセージ

20.1　開発環境の準備

タイプ3書式を定義する前に，パネル定義文格納用フォルダの用意や，定義環境の用意をします。

＜この節の構成＞

20.1.1　フォルダを作成する

20.1.2　開発環境の設定

20.1.3　実行環境の設定

20.1.4　外字の扱い方

20.1.1　フォルダを作成する

タイプ3書式の定義後に生成するパネル定義文を格納するためのフォルダが必要です。XMAP3インストール時には，XMAP3インストールフォルダに「¥USER¥MAPS」のフォルダが作成されます。これとは別のフォルダに格納したい場合，フォルダの名称や場所は任意に設定してください。

生成したファイルは，XMAP3インストールフォルダ以外のフォルダで管理することをお勧めします。なお，「XMAP3インストールフォルダ¥TEMP」の下に格納すると，正常に動作しませんので注意してください。

また，マップファイルを格納するフォルダにロングパス名を使用している場合，IFITによるマップファイルの転送ができないことがあります。フォルダ名にはロングパス名を使用しないことをお勧めします。

20.1.2　開発環境の設定

XMAP3の開発環境を，メインフレーム用のタイプ3書式を定義するための環境に設定します。開発環境のセットアップについては，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

＜この項の構成＞

(1)　ターゲット環境の設定

(1)　ターゲット環境の設定

XMAP3のドローセットアップを起動させます。セットアップダイアログの［運用管理者用の設定］ボタンを選択して，運用管理者用の設定を活性状態にしてください。

セットアップダイアログの［ターゲットの設定...］ボタンをクリックしてください。ターゲット環境の設定ダイアログが表示されます。

分散開発の対象に応じたターゲット環境を選択してください。ターゲット環境の選択基準を次に示します。

ターゲット環境に応じて，次の項目を選択してください。

VOS3で使用するタイプ3書式を定義する場合：

「VOS3用の画面・帳票開発」

VOS1で使用するタイプ3書式を定義する場合：

「VOS1用の画面・帳票開発」

VOSKで使用するタイプ3書式を定義する場合：

「VOSK用の画面・帳票開発」

ターゲット環境を選択したら［OK］ボタンをクリックしてください。メインフレームで運用するタイプ3書式のパネル定義文を，PCで生成するための開発環境になります。

注意

ドローセットアップ機能を起動させているときは，XMAP3のほかの機能を起動させないでください。

20.1.3　実行環境の設定

定義した書式の印刷テストをするためには，PC上の実行環境を設定する必要があります。実行環境の設定については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

20.1.4　外字の扱い方

PC上でタイプ3書式を定義するときに外字を利用するには，Windowsに付属の外字エディタで定義してください。

パネル定義文をPCからメインフレームに転送するときに，文字コードがシフトJISからKEISに変換されます。外字の運用形態によって必要となる注意事項について説明します。

外字の運用形態については，ターゲット環境に応じて「1.2.2(6)　外字の運用に必要なソフトウェア」，「1.3.2(7)　外字の運用に必要なソフトウェア」，または「1.4.2(6)　外字の運用に必要なソフトウェア」をそれぞれ参照してください。

＜この項の構成＞

(1)　外字マッピングファイルをカスタマイズしている場合

(2)　XMAP3外字機能を使用している場合

(1)　外字マッピングファイルをカスタマイズしている場合

コード変換SDKまたは日立コード変換 - Development Kitを使用して，シフトJISとKEISの外字マッピングファイルをカスタマイズしている場合，CommuniNetの文字コードのマッピングも同様にカスタマイズしてください。

CommuniNetの文字コードのマッピングを変更するには，CommuniNetのコードマッピングユティリティを使用してください。

(2)　XMAP3外字機能を使用している場合

UnicodeとKEISの外字マッピングファイルは文字コードの変換には影響しません。

20.2　定義内容の決定

＜この節の構成＞

20.2.1　レイアウト領域

20.2.2　配置する項目

20.2.1　レイアウト領域

実際の運用では，印刷時の用紙制御はPAGECモジュールによって行われます。また，タイプ3書式は，PAGECモジュールで指定された論理ページ内に印刷されます。

そのため，ドローのレイアウト領域は，PAGECモジュールで指定した論理ページサイズに合わせる必要があります。PAGECモジュールの論理ページサイズを調べ，ドローのレイアウト領域の大きさを求めます。なお，PAGECモジュールについては，次のマニュアルを参照してください。

OSがVOS3の場合：マニュアル「漢字処理ユティリティ KAPS E3」

OSがVOS1の場合：マニュアル「漢字処理ユティリティ KAPS」

OSがVOSKの場合：マニュアル「漢字処理」

＜この項の構成＞

(1)　レイアウト領域の大きさの例

(2)　ドローで指定する給紙サイズを決定する

(3)　レイアウトのます目を決定する

(4)　ユーザ用レイアウトパターン

(1)　レイアウト領域の大きさの例

以下に，ドローのレイアウト領域の大きさを求める例を示します。図中の網掛け部分をドローのレイアウト領域の大きさとします。

（例1）

連続紙（横304.8mm=12インチ，縦215.9mm=8.5インチ）に，論理ページの位置を上・左マージン720※（12.7mm=1/2インチ相当），論理ページサイズ（10,800※×15,840※）で印刷するためのPAGECモジュールを使用する場合

注※

単位は0.0176mm（1/1,440インチ）

＜PAGECから求められるドローのレイアウト領域の最大値＞

レイアウトの横サイズ：2,640ドット・・・論理ページの横サイズ

レイアウトの縦サイズ：1,800ドット・・・論理ページの縦サイズ

（例2）

カット紙（A4横）に，論理ページの位置を上・左マージン510※（9mm相当），論理ページサイズ（10,800※×12,672※）で印刷するためのPAGECモジュールを使用する場合

注※

単位は0.0176mm（1/1,440インチ）

＜PAGECから求められるドローのレイアウト領域の最大値＞

レイアウトの横サイズ：2,112ドット・・・論理ページの横サイズ

レイアウトの縦サイズ：1,800ドット・・・論理ページの縦サイズ

(2)　ドローで指定する給紙サイズを決定する

ドローで指定する給紙サイズは，実際の運用に影響しませんが，プレビューやテスト印刷で定義内容を確認するために必要です。

指定する給紙サイズは，印刷可能領域として決定したレイアウト領域よりも大きいものにします。どの印字可能領域よりも大きいレイアウト領域を指定する場合は，「フリー」を指定し，定義内容の確認はドローの縮小表示で行ってください。

連続紙の場合，次の表を参考に決定してください。例1で指定するドローの給紙サイズは「A4横」になります。

カット紙の場合，運用で使用する用紙サイズ，印刷向きを使用します。例2の場合，ドローで指定する給紙サイズは「A4横」になります。

表20-1　連続紙のサイズと印字可能領域

給紙サイズ | 最大の印字可能領域※（縦ドット×横ドット）
A3縦 | 3,874 × 2,712
A3横 | 2,712 × 3,874
A4縦 | 2,712 × 1,890
A4横 | 1,890 × 2,712
A5縦 | 1,890 × 1,304
A5横 | 1,304 × 1,890
B4縦 | 3,345 × 2,334
B4横 | 2,334 × 3,345
B5縦 | 2,334 × 1,625
B5横 | 1,625 × 2,334

注※

上マージン，左マージンともに最小（5mm）の場合の値です。マージンを大きくすると，それに伴って印字可能領域は小さくなります。

(3)　レイアウトのます目を決定する

定義するタイプ3書式のイメージに合ったます目を決定します。ます目は，ドローで定義するときの項目位置や範囲の単位として利用します。また，固定フィールドおよび出力フィールドの，「文字サイズ」および「文字の間隔」の標準値になります。ます目として指定できる範囲は，「付録D.4(2)　ドローで指定できるます目の範囲」を参照してください。

例えば，例1で求められたレイアウト領域に，行間隔6LPI，文字サイズ9ポイント，文字の間隔0ポイントのます目で定義する場合，45行，132列のます目ができます。

なお，CPI指定はパネル定義文生成時に文字サイズと文字間隔の組み合わせに変換され，定義時の内容と実際の印刷結果が異なってしまいますので，指定しないでください。文字サイズと文字間隔の組み合わせを次の表に示します。

表20-2　文字サイズと文字間隔の組み合わせ

指定するCPI
（列のドット数）
変換に使用する組み合わせ
変換後の列
のドット数

文字サイズ（ドット数）
文字の間隔（ドット数）

10CPI(24)
9ポイント(16)
5ポイント(8)
24

12CPI(20)
9ポイント(16)
2ポイント(3)
19※

15CPI(16)
7ポイント(12)
2ポイント(3)
15※

注※

定義時と変換後でドット数が変わります。

(4)　ユーザ用レイアウトパターン

決定した内容と同じ情報を持つパターンがXMAP3の標準レイアウトパターンにない場合，決定した内容を「ユーザ用レイアウトパターン」として登録して，帳票定義のひな形として使用できます。この場合，毎回の設定がなくなるため，定義の効率と精度を向上させることができます。XMAP3の標準レイアウトパターンの内容は，「付録D.4(3)　標準提供しているレイアウトパターンの内容」を参照してください。

ユーザ用のレイアウトパターンは，ターゲット環境の種類に関係なく，32個まで登録できます。

20.2.2　配置する項目

XMAP3のメインフレーム連携機能では，メインフレームのタイプ3書式が持つ機能を完全にはサポートしていません。したがって，帳票のレイアウト設計には，サポート範囲を考慮する必要があります。サポート範囲については「付録D.4(1)　生成できるパネル定義文の範囲」を参照してください。

20.3　ドローによるタイプ3書式の定義

タイプ3書式は，XMAP3のドローで定義します。PCの対話定義環境については，マニュアル「XMAP3 プログラミングガイド 帳票編」を参照してください。

ただし，マップの構成要素には，メインフレームのXMAPでは定義できても，XMAP3では定義できないものがあります。詳しくは「付録D.4(1)　生成できるパネル定義文の範囲」を参照してください。主な注意事項について次に説明します。

＜この節の構成＞

20.3.1　タイプ3書式の定義の手順

20.3.2　タイプ3書式定義時の注意事項

20.3.1　タイプ3書式の定義の手順

タイプ3書式定義の概要を次に示します。

ドローを起動し，定義対象を選択する。
定義対象として「ページプリンタ グラフィック帳票」を選択します。
言語種別は「COBOL」に設定されます。

定義する帳票イメージに対応するレイアウトパターンを選択し，レイアウトを新規作成する。
ユーザ用レイアウトパターンを使用しない場合は，レイアウト領域の大きさなどをグラフィック帳票属性ダイアログで設定する必要があります。

タイプ3書式を定義する。
［表示］-［ます目配置］コマンドをチェックすると，行間隔，列間隔で補正されたレイアウトができます。

マップ定義ファイルを保存する。
ドローでファイルの保存を行うと，マップ定義ファイルと各種マップファイルを出力します。このマップファイルはパネル定義文生成時には使用しません。マップ定義ファイルだけを保存する場合は，［ファイル］-［マップ定義ファイルだけの保存］コマンドを選択してください。

20.3.2　タイプ3書式定義時の注意事項

＜この項の構成＞

(1)　1,880文字を超える外字

(2)　言語種別の設定

(3)　ドローで定義できるオブジェクト

(4)　ドローでの定義が有効とならない属性

(5)　データ名の長さ

(6)　半角・全角混在項目，漢字専用項目の配置

(7)　下位項目の定義

(8)　予約項目

(9)　ピクチャ文字

(1)　1,880文字を超える外字

PCで直接扱える外字は1,880文字までなので，ドローで定義するときには，1,880文字に収まらない外字を，出力テキストなどに使用しない漢字または記号に置き換えて定義してください。生成されたパネル定義文を転送したあとで，定義時に使った文字を使用する外字に置き換えてください。

(2)　言語種別の設定

言語種別は「COBOL」に設定されます。「C」で作成したマップ定義ファイルは，エクスポート時にエラーとなります。「C」で作成したタイプ3書式は，ユティリティのコンバータで「COBOL」に変換してからエクスポートしてください。

(3)　ドローで定義できるオブジェクト

ドローで定義できるオブジェクトの中には，タイプ3書式に使用できないものがあります。それらのオブジェクトはエクスポート時に破棄されます。

タイプ3書式に定義できるオブジェクトについては，「付録D.4(4)　生成するパネル定義文の内容とドローとの関係（オブジェクト）」を参照してください。

(4)　ドローでの定義が有効とならない属性

ドローがサポートしているオブジェクト属性の中には，タイプ3書式で指定できないものがあります。それらの属性はエクスポート時に破棄されるか，ほかの属性に変換されます。ドローでの指定がどのように扱われるかは，「付録D.4(5)　生成するパネル定義文の内容とドローとの関係（属性）」を参照してください。

(5)　データ名の長さ

出力フィールドや出力OCRなどに指定するデータ名は，論理項目名となります。論理項目名は，次の規則で展開します。

XXXXXXXデータ名Y

XXXXXXXは，「マップ定義ファイル名-」です。

Yは，付加される1バイトのIDです。

例えば，マップ定義ファイル名が「MAP001」でデータ名が「FIELD01-」の場合，展開する論理項目名は，「MAP001-FIELD01-O」となります。

ドローでは，論理項目名の長さ（XX～Yまでの長さ）を30バイトまで指定できます。しかし，メインフレームでは制御コードを含め28バイトです。28バイトを超えるような論理項目名を指定すると，タイプ3書式の生成時にエラーとなります。データ名は，28バイトの範囲になるように考慮してください。

(6)　半角・全角混在項目，漢字専用項目の配置

出力フィールドで，半角・全角混在項目を定義する場合は，使用目的を「日本語」に，データ型を「文字（XX）」にします。また，漢字専用項目を定義する場合は，使用目的を「日本語」に，データ型を「漢字（NN）」にします。

また，半角・全角混在項目の場合，論理項目長は次のとおりです。

「データ長を変更する」ボタンがオンの場合：ダイアログで指定したデータ長

「データ長を変更する」ボタンがオフの場合：桁（項目長）×7÷3＋3

(7)　下位項目の定義

フィールドの使用目的を「日本語」，データ型を「文字型（XX）」と設定した場合，エクスポート機能で変換したパネル定義文では，下位項目の長さはドローで定義したとおりに出力されます。エクスポート機能で変換したあとで，実際に使用する長さに合わせてパネル定義文を修正してください。

(8)　予約項目

予約項目を定義したい場合は，ドローでは固定フィールドとして定義してください。生成したパネル定義文の該当する固定フィールドの部分を，予約項目の形式に修正してください。

(9)　ピクチャ文字

数字編集文字列中に「/」が含まれている場合，エクスポート機能でパネル定義文を生成するときには，数字型ではなく文字型として変換されます。変換例を示します。

20.4　パネル定義文ファイルの生成

ドローが作成するパネル定義文は，そのままメインフレームに転送して利用できますが，複数の画面・帳票のパネル定義文生成を一括して実行したい場合はユティリティのエクスポート機能を利用します。

ドローで作成したマップ定義ファイルから，パネル定義文を生成する手順を説明します。パネル定義文の生成には，エクスポート機能を利用します。

ドローセットアップを起動し，ターゲットが「VOS3用の画面・帳票開発」，「VOS1用の画面・帳票開発」，または「VOSK用の画面・帳票開発」になっていることを確認します。

ユティリティメインダイアログで「エクスポート」を選択し，「詳細」で「タイプ3書式」を選択して［実行］ボタンをクリックします。

書式エクスポートダイアログが表示されます。

「ファイルの出力先」の［参照...］ボタンをクリックして，パネル定義文の出力先を指定します。

「ファイルの選択」の［参照...］ボタンをクリックして，パネル定義文を生成するためのマップ定義ファイルを指定します。
選択されたファイルがリストボックスに表示されます。

［変換］ボタンをクリックして，エクスポート機能を実行します。
生成されるファイルは，パネル定義文ファイル（拡張子は.XMP）です。エクスポート機能では変換時にエラーが発生した場合，ダイアログには「異常」または「警告」と表示されます。また，エラーメッセージを「マップ定義ファイル名.ERR」に出力します。エラーメッセージについては，「20.7　タイプ3書式エクスポート時のメッセージ」を参照してください。

なお，リストボックスに表示されているファイルをクリックして選択状態を解除することで，エクスポート対象外にできます。

20.5　パネル定義文ファイルの転送

生成したパネル定義文ファイルをメインフレームに転送する手順について，メインフレーム側のOS別に説明します。

＜この節の構成＞

20.5.1　VOS3にパネル定義文ファイルを転送する

20.5.2　VOS1にパネル定義文ファイルを転送する

20.5.3　VOSKにパネル定義文ファイルを転送する

20.5.1　VOS3にパネル定義文ファイルを転送する

XMAP3で生成したパネル定義文ファイルは，PC上のCommuniNetでIFITを使用してVOS3へ転送します。IFITについては，マニュアル「ファイル伝送プログラムIFIT-TSS E2」を参照してください。

(a)　メインフレーム上の出力ファイルの属性

メインフレーム上に出力するファイルは次に示す属性にしてください。

レコード形式は固定長

レコード長は80バイト

(b)　CommuniNetの環境を設定する

CommuniNetの環境設定ユティリティを起動します。「端末名称」は転送するファイルの置かれている端末を選択して，「設定項目」の「ファイル転送」をダブルクリックします。ファイル転送の設定ダイアログが表示されるので，「コード変換」を「あり」にして，［OK］ボタンをクリックします。

(c)　IFITのメニュー画面を使用して転送する場合

ファイル伝送機能の呼び出し
IFITコマンドを実行して，ファイル伝送機能の画面を呼び出します。

転送するファイルの設定

「FUNCTION NO.」は2（TERMINAL->HOST）を選択してください。

「HOST DATA SET NAME」の項に，メインフレーム上に出力するファイル名などを指定します。このとき，PC上のファイルに付いていた拡張子は付けないでください。

「TERMINAL FILE NAME」の項に，PCから転送するファイル名を完全なパス名で指定します。

(d)　IFITコマンドを使用して転送する場合

IFITコマンドを使用した転送の形式は，次のとおりです。

コマンド
オペランド

IFIT
△'メインフレーム上に出力するファイル名'
△PCから転送するファイル名
△INPUT(TERMINAL)

20.5.2　VOS1にパネル定義文ファイルを転送する

XMAP3で生成したパネル定義文ファイルは，PC上のCommuniNetからIFITを使用してVOS1へ転送します。IFITについては，マニュアル「ワークステーション操作 －パネル編－」，またはマニュアル「ワークステーション操作 －コマンド編－」を参照してください。

(a)　メインフレーム上の出力ファイルの属性

メインフレーム上に出力するファイルは次に示す属性にしてください。

レコード形式は固定長

レコード長は80バイト

データコードはDATA

(b)　CommuniNetの環境を設定する

CommuniNetの環境設定ユティリティを起動します。「端末名称」は転送するファイルの置かれている端末を選択して，「設定項目」の「ファイル転送」をダブルクリックします。ファイル転送の設定ダイアログが表示されるので，「コード変換」を「あり」にして，［OK］ボタンをクリックします。

(c)　IFITのメニュー画面を使用して転送する場合

IFITのメニュー画面を使用して転送する手順を次に示します。

ファイル伝送機能の呼び出し

マスタメニューの項目5「OA業務実行」を選択します。

OA業務実行メニューの項目5「パソコンファイル伝送」を選択します。

対話型ファイル伝送メニューの項目1「LIMEファイルのファイル伝送」を選択します。

転送するファイルの設定
「ホスト側ファイル情報」の項に，メインフレーム上に出力するファイル名などを指定します。このとき，PC上のファイルに付いていた拡張子は付けないでください。なお，レコード形式は「1:F」を選択し，レコード長は80バイトにしてください。「ワークステーション側ファイル情報」の項に，PCから転送するファイル名を完全なパス名で指定してください。

(d)　@@IFITコマンドを使用して転送する場合

@@IFITコマンドを使用した転送の形式は，次のとおりです。

コマンド
オペランド

@@IFIT
△FTYPE=LIME
,WSF='PCから転送するファイル名'
,RL=80
,TRN=WH
,FILE=メインフレーム上に出力するLIMEファイル名
,LIBRARY=メインフレーム上に出力するLIMEライブラリ名
,DC=DATA
,MEMBER=メインフレーム上に出力するメンバ名

20.5.3　VOSKにパネル定義文ファイルを転送する

XMAP3で生成したパネル定義文ファイルは，PC上のCommuniNetからIFITを使用してVOSKへ転送します。IFITについては，マニュアル「コマンド」，またはマニュアル「パネル」を参照してください。

(a)　メインフレーム上の出力ファイルの属性

メインフレーム上に出力するファイルは次に示す属性にしてください。

レコード形式は固定長

レコード長は80バイト

ファイルタイプはMAP

(b)　CommuniNetの環境を設定する

CommuniNetの環境設定ユティリティを起動します。「端末名称」は転送するファイルの置かれている端末を選択して，「設定項目」の「ファイル転送」をダブルクリックします。ファイル転送の設定ダイアログが表示されるので，「コード変換」を「あり」にして，［OK］ボタンをクリックします。

(c)　IFITのメニュー画面を使用して転送する場合

IFITのメニュー画面を使用して転送する手順を説明します。

ファイル転送機能の呼び出し

操作マスタメニューの項目3「ファイル操作」を選択します。

ファイル操作メニューの項目9「ファイルの伝送」を選択します。

ファイル伝送メニューの項目9「WSとのファイル転送」を選択します。

転送するファイルの設定

「入力ファイル名」の項に，PCから転送するファイル名を指定します。

「出力ファイル名」の項に，メインフレーム上に出力するファイル名を指定します。このとき，PC上のファイルに付いていた拡張子は付けないでください。

「レコード末尾の埋字」として「16#40」を指定してください。

(d)　IFITコマンドを使用して転送する場合

IFITコマンドを使用した転送の形式は，次のとおりです。

コマンド
オペランド

IFIT
,IN=PCから転送するファイル名
,OUT=メインフレーム上に出力するファイル名
,PADDING=16#40

20.6　メインフレームでの注意事項

PCでのエラーチェックでは，メインフレームでタイプ3書式を作成するときの制限値を意識しません。そのため，メインフレームでタイプ3書式を作成する際にエラーとなる場合があります。メインフレームで制限値を超えるエラーとなった場合は，次の表に示す対処を行ってください。

表20-3　制限値を超えるエラーへの対処

制限を超えたもの
制限値を超えたときの対処

プレロードマップ長
定義しているオブジェクトを削除します。このとき，半角・全角を混在させた固定フィールドを削除すると効果的です。

論理項目長
出力フィールドを削除するか，出力フィールドのデータ長を短くします。
このとき，使用目的が「日本語」でデータ型が「文字（XX）」の出力フィールドを対象とすると効果的です。

最大メッセージ長

20.7　タイプ3書式エクスポート時のメッセージ

エクスポート機能でタイプ3書式のマップ定義ファイルからパネル定義文ファイルを生成するときに，次に示す定義がある場合，エラーメッセージを出力します。

生成されたパネル定義文を使ってメインフレームでマップ生成すると，解析時にエラーとなるもの。

エクスポート時にオブジェクトを破棄，または設定内容を変更しているもの。

エラーが発生した場合でも，パネル定義文ファイルは出力されます。

＜この節の構成＞

(1)　エラーファイルの形式

(2)　出力するメッセージの詳細

(3)　メッセージの詳細

(1)　エラーファイルの形式

エラーファイルのファイル名は，「マップ定義ファイル名.ERR」です。エラーファイルは，書式エクスポートダイアログで設定したパネル定義文ファイルの出力先に出力されます。

(2)　出力するメッセージの詳細

出力するメッセージの形式を次に示します。

［メッセージID］

［位置情報］［メッセージテキスト］

(a)　メッセージID　：　X3EHnnn-y

X3EH

タイプ3書式エクスポート時のメッセージであることを示します。

nnn

メッセージ通番を示します。

y

メッセージの種類を示します。出力されるメッセージの種類を次に示します。

W：異常メッセージ
メインフレームで解析時にエラーとなるので，ドローでの再定義が必要なもの。

I：警告メッセージ
メインフレームで解析時にエラーとならないので，ドローでの再定義が不要なもの。

(b)　位置情報

メッセージ出力対象のオブジェクトのドロー上の定義位置を示します。なお，レイアウト全体に関するメッセージなど，位置情報を持たない場合は出力しません。

出力例を次に示します（xxxxxは5けたの数字を示します）。

ドローでの「グリッド種別」が「ます目」の場合
［縦xxxxxます，横xxxxxます］

ドローでの「グリッド種別」が「ミリ」の場合
［縦xxxxx mm，横xxxxx mm］

ドローでの「グリッド種別」が「ドット」の場合
［縦xxxxxドット，横xxxxxドット］

(c)　メッセージテキストの詳細

メッセージテキストについて説明します。

（S）エクスポートの処理

メッセージを出力したあとの主な処理を示します。

（P）プログラマの処置

メッセージを受け取ったプログラマが取るべき処置を示します。

(3)　メッセージの詳細

個々のメッセージについて説明します。なお，ここに掲載しているのは，タイプ3書式のエクスポート機能に固有のメッセージだけです。XMAP3全体に共通のメッセージについては，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

X3EH901-W

［位置情報］　｛出力フィールド｜出力フィールドの下位項目｜出力バーコード｜出力バーコードの下位項目｜フレーム｝のデータ名の長さは，メインフレームXMAPの制限を超えています

出力フィールドダイアログ，出力フィールドダイアログの下位項目，出力バーコード，出力バーコードの下位項目，または，フレームダイアログで指定したデータ名の長さが，メインフレームXMAPでの制限値（28バイト）を超えている。

（S）パネル定義文を生成します。

（P）データ名の長さを短くして，マップ定義ファイルを再作成したあと，エクスポートを再実行します。

X3EH902-W

［位置情報］　再定義名のデータ名の長さは，メインフレームXMAPの制限を超えています

論理マップ再定義名ダイアログで指定したデータ名の長さが，メインフレームXMAPでの制限値（28バイト）を超えている。

（S）パネル定義文を生成します。

（P）データ名の長さを短くして，マップ定義ファイルを再作成したあと，エクスポートを再実行します。

X3EH201-I

｛｛左|上｝マージンを36mm｜印刷部数を1｝に変換しました

［対象属性］を［変換結果］に変換した。
該当するのは，以下のとおり。

帳票属性の左マージンまたは上マージンに，37mm以上を指定している。

帳票属性の印刷部数に，2以上を指定している。

（S）指定された対象属性を変換結果で示す値に変換して，パネル定義文を生成します。

（P）対象属性を変換結果で示す値に変更して，マップ定義ファイルを再作成したあと，エクスポートを再実行します。

X3EH202-I

ます目設定のCPI指定を文字サイズ＆文字間隔指定に変換しました

帳票属性ダイアログで指定したます目設定のCPI指定を，文字サイズ＆文字間隔指定に変換した。

（S）指定されたCPIを文字サイズ＆文字間隔に変換して，パネル定義文を生成します。変換規則はを次に示します。

10CPI　→　9ポイント5ポイント

12CPI　→　9ポイント2ポイント

15CPI　→　7ポイント2ポイント

（P）帳票属性のます目のCPIを文字サイズ＆文字間隔に変更して，マップ定義ファイルを再作成したあと，エクスポートを再実行します。

X3EH203-I

［位置情報］　｛｛固定｜出力｝フィールドの書体属性を標準｜｛固定｜出力｝フィールドの強調属性を標準｜｛固定｜出力｝フィールドの網掛け属性を網掛けなし｜｛固定｜出力｝フィールドの文字サイズを標準｜出力フィールドのデータ型を文字（XX）｜出力フィールドの埋字を｛スペース｜埋めない｝｜出力フィールドの下位項目のデータ型を文字（XX）｜｛けい線｜矩形｜円｝の線の種類を実線｜円の網掛け属性を網掛けなし｝に変換しました

［オブジェクト］の［対象属性］を［変換結果］に変換した。
次の指定をしている場合に該当する。

文字サイズが5ポイントまたは7ポイントの固定フィールドまたは出力フィールドの書体属性に，ゴシックを指定している。

固定フィールドまたは出力フィールドの強調属性に，「太字」「斜体」または「太字＆斜体」を指定している。

固定フィールドまたは出力フィールドの網掛け属性に，「標準」以外の属性を指定している。

固定フィールドまたは出力フィールドの文字サイズに，「14ポイント」を指定している（ただし，出力ターゲットが「VOS1」の場合だけ）。

出力フィールドのデータ型に，'／'ありを指定している。

出力フィールドの埋字に，LOWまたはHIGHを指定している。

使用目的が日本語でかつデータ型が文字（XX）の出力フィールドの埋字に埋字なし以外を指定している。

出力フィールドの下位項目のデータ型に，'／'ありを指定している。

けい線，矩形または円の線の種類に，二重線または見えない線を指定している。

円の網掛け属性に，濃いまたは薄いなどの標準以外の属性を指定している。

（S）指定された対象属性を変換結果で示す値に変換して，パネル定義文を生成します。

（P）オブジェクトの対象属性を変換結果で示す値に変更して，マップ定義ファイルを再作成したあと，エクスポートを再実行します。

X3EH204-I

［位置情報］　網掛けの網掛け種別を｛薄い｜標準｜濃い｝に変換しました

網掛けの網掛け種別のうち，「濃い」，「標準」または「薄い」以外のものを，｛薄い｜標準｜濃い｝に変換した。

（S）指定された網掛け種別を「薄い」「標準」または「濃い」に変換して，パネル定義文を生成します。変換規則は以下のとおり。

極薄　→　薄い

極濃　→　濃い

薄い格子／薄い右下／薄い左下／薄い縦線／薄い横線　→　薄い

標準格子／標準右下／標準左下／標準縦線／標準横線　→　標準

（P）網掛け種別を「薄い」「標準」，または「濃い」に変更して，マップ定義ファイルを再作成したあと，エクスポートを再実行します。

X3EH205-I

［位置情報］　｛出力フィールドの初期値｜出力フィールドの動的変更｜出力フィールドの文字色｜固定フィールドの文字色｜出力OCRの文字色｜出力日付フィールド｜出力時刻フィールド｜けい線の動的変更｜円｜円弧｜｛矩形｜網掛け｝の丸め半径｜出力バーコード｜連結出力バーコード｜固定グラフィック｜出力グラフィック｜予約フィールド｝を破棄しました

［オブジェクト］または［オブジェクトの属性］を破棄した。次のオブジェクトが破棄の対象になる。

出力フィールドの初期値で，ALLLOW指定

出力フィールドの動的変更

出力フィールドの文字色

固定フィールドの文字色

出力OCRの文字色

出力日付フィールド

出力時刻フィールド

けい線の動的変更

円（ただし，出力ターゲットが「VOS1」の場合だけ）

円弧（ただし，出力ターゲットが「VOS1」の場合だけ）

矩形の丸め半径（ただし，出力ターゲットが「VOS1」の場合だけ）

網掛けの丸め半径（ただし，出力ターゲットが「VOS1」の場合だけ）

出力バーコード

連結出力バーコード

固定グラフィック

出力グラフィック

予約フィールド

（S）指定されたオブジェクト，またはオブジェクトの属性を破棄して，パネル定義文を生成します。

（P）該当するオブジェクト，またはオブジェクトの属性を指定しないでマップ定義ファイルを作り直し，エクスポートを再実行します。

X3EH207-I

帳票属性の｛印刷部数をAPで変更する指定｜印刷ドキュメント名｜印刷ドキュメント名をAPで変更する指定｝を破棄しました

グラフィック帳票の帳票属性で，次の内容が設定されていたため，設定内容を破棄した。

「印刷部数をAPで変更する」の指定

印刷ドキュメント名

「印刷ドキュメント名をAPで変更する」の指定

（S）指定された帳票属性を破棄して，パネル定義文を生成します。

（P）帳票属性で，該当する項目を指定しないマップ定義ファイルを再作成したあと，エクスポートを再実行します。

21.　メインフレーム用のタイプ1/2/R書式をPCで定義する

この章では，メインフレームで使用するためのタイプ1/2/R書式をPC上で定義し，メインフレームに転送するまでの手順について説明します。

＜この章の構成＞

21.1　開発環境の準備

21.2　定義内容の決定

21.3　ドローによる書式オーバレイの定義

21.4　記述文ファイルの生成

21.5　記述文ファイルの転送

21.6　タイプ1/2/R書式エクスポート時のメッセージ

21.1　開発環境の準備

タイプ1/2/R書式（XMAP3では書式オーバレイ）を定義する前に，記述文格納用フォルダの用意や，定義環境の用意をします。

＜この節の構成＞

21.1.1　フォルダを作成する

21.1.2　開発環境の設定

21.1.3　実行環境の設定

21.1.4　外字の扱い方

21.1.1　フォルダを作成する

書式オーバレイの定義後に生成する記述文を格納するためのフォルダが必要です。XMAP3インストール時には，XMAP3インストールフォルダに「¥USER¥MAPS」のフォルダが作成されます。これとは別のフォルダに格納したい場合，フォルダの名称や場所は任意に設定してください。

生成したファイルは，XMAP3インストールフォルダ以外のフォルダで管理することをお勧めします。なお，「XMAP3インストールフォルダ¥TEMP」の下に格納すると，正常に動作しませんので注意してください。

21.1.2　開発環境の設定

XMAP3の開発環境を，タイプ1/2/R書式を定義するための環境に設定します。開発環境のセットアップについては，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

次に示すターゲット環境の設定は，必ず実行してください。

＜この項の構成＞

(1)　ターゲット環境の設定

(1)　ターゲット環境の設定

XMAP3のドローセットアップを起動させます。セットアップダイアログの［運用管理者用の設定］ボタンを選択して，運用管理者用の設定を活性状態にしてください。

セットアップダイアログの［ターゲットの設定...］ボタンをクリックしてください。ターゲット環境の設定ダイアログが表示されます。

分散開発の対象に応じたターゲット環境を選択してください。ターゲット環境の選択基準を次に示します。

ターゲット環境に応じて，次の項目を選択してください。

VOS3で使用するタイプ1/2/R書式を定義する場合：
「VOS3用の画面・帳票開発」

VOS1で使用するタイプ1/2/R書式を定義する場合：
「VOS1用の画面・帳票開発」

VOSKで使用するタイプ1/2/R書式を定義する場合：
「VOSK用の画面・帳票開発」

ターゲット環境を選択したら［OK］ボタンをクリックしてください。メインフレームで運用するタイプ1/2/R書式を，PCで生成するための開発環境になります。

注意

ドローセットアップ機能を起動させているときは，XMAP3のほかの機能を起動させないでください。

21.1.3　実行環境の設定

定義した書式の印刷テストをするためには，PC上の実行環境を設定する必要があります。実行環境の設定については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

21.1.4　外字の扱い方

PC上で書式オーバレイを定義するときに外字を利用するには，Windowsに付属の外字エディタで定義してください。

メインフレーム用のタイプ1/2/R書式を定義する場合，記述文をPCからメインフレームに転送するときに，文字コードがシフトJISからKEISに変換されます。

外字の運用形態については，ターゲット環境に応じて「1.2.2(6)　外字の運用に必要なソフトウェア」，「1.3.2(7)　外字の運用に必要なソフトウェア」，または「1.4.2(6)　外字の運用に必要なソフトウェア」をそれぞれ参照してください。

＜この項の構成＞

(1)　外字マッピングファイルをカスタマイズしている場合

(2)　XMAP3外字機能を使用している場合

(1)　外字マッピングファイルをカスタマイズしている場合

コード変換SDKまたは日立コード変換 - Development Kitを使用して，シフトJISとKEISの外字マッピングファイルをカスタマイズしている場合，CommuniNetの文字コードのマッピングも同様にカスタマイズしてください。

CommuniNetの文字コードのマッピングを変更するには，CommuniNetのコードマッピングユティリティを使用してください。

(2)　XMAP3外字機能を使用している場合

UnicodeとKEISの外字マッピングファイルは文字コードの変換には影響しません。

21.2　定義内容の決定

＜この節の構成＞

21.2.1　レイアウト領域

21.2.2　タイプ1/2/R書式に定義する内容を決定する

21.2.3　文字属性名の決定

21.2.1　レイアウト領域

印刷時の用紙制御は，FCBイメージまたはPAGECモジュールによって行われます。

タイプ1/2/R書式は，FCBイメージで指定した印刷領域，またはPAGECモジュールで指定した論理ページ内に印刷されます。

そのため，ドローのレイアウト領域は，FCBイメージ，またはPAGECモジュールで指定した印刷領域（PAGECの場合は論理ページサイズ）に合わせる必要があります。FCBイメージの印刷領域，またはPAGECモジュールの論理ページサイズから用紙の印刷領域を調べ，ドローのレイアウト領域の大きさを求めます。なお，FCBイメージ，およびPAGECモジュールについては，次のマニュアルを参照してください。

OSがVOS3の場合：マニュアル「漢字処理ユティリティ KAPS E3」

OSがVOS1の場合：マニュアル「漢字処理ユティリティ KAPS」

OSがVOSKの場合：マニュアル「漢字処理」

＜この項の構成＞

(1)　レイアウト領域の大きさの例

(2)　ドローで指定する給紙サイズを決定する

(3)　レイアウトのます目を決定する

(4)　ユーザ用レイアウトパターン

(1)　レイアウト領域の大きさの例

以下に，ドローのレイアウト領域の大きさを求める例を示します。図中の網掛け部分をドローのレイアウト領域の大きさとします。

（例1）

連続紙（横304.8mm=12インチ，縦215.9mm=8.5インチ）に，上下左右の印刷禁止領域12.7mm=1/2インチ相当で印刷するためFCBイメージを使用する場合

＜FCBから求められるドローのレイアウト領域の最大値＞

レイアウトの横サイズ：2,640ドット・・・印刷領域の横サイズ

レイアウトの縦サイズ：1,800ドット・・・印刷領域の縦サイズ

（例2）

カット紙（A4横）に，上・左マージン9mmで印刷するためFCBイメージを使用する場合

＜FCBから求められるドローのレイアウト領域の最大値＞

レイアウトの横サイズ：2,674ドット・・・印刷領域の横サイズ

レイアウトの縦サイズ：1,851ドット・・・印刷領域の縦サイズ

（例3）

連続紙（横304.8mm=12インチ，縦215.9mm=8.5インチ）に，論理ページの位置を上・左マージン720※（12.7mm=1/2インチ相当），論理ページサイズ（10,800※×15,840※）で印刷するためのPAGECモジュールを使用する場合

注※

単位は0.0176mm（1/1,440インチ）

＜PAGECから求められるドローのレイアウト領域の最大値＞

レイアウトの横サイズ：2,640ドット・・・論理ページの横サイズ

レイアウトの縦サイズ：1,800ドット・・・論理ページの縦サイズ

（例4）

カット紙（A4横）に，論理ページの位置を上・左マージン510※（9mm相当），論理ページサイズ（10,800※×12,672※）で印刷するためのPAGECモジュールを使用する場合

注※

単位は0.0176mm（1/1,440インチ）

＜PAGECから求められるドローのレイアウト領域の最大値＞

レイアウトの横サイズ：2,112ドット・・・論理ページの横サイズ

レイアウトの縦サイズ：1,800ドット・・・論理ページの縦サイズ

(2)　ドローで指定する給紙サイズを決定する

ドローで指定する給紙サイズは，実際の運用に影響しませんが，プレビューやテスト印刷で定義内容を確認するために必要です。

指定する給紙サイズは，印刷可能領域が決定したレイアウト領域よりも大きいものにします。どの印字可能領域よりも大きいレイアウト領域を指定する場合は，「A3」を選択し，定義内容の確認はドローの縮小表示で行ってください。

カット紙の場合，運用で使用する用紙サイズ，印刷向きを使用します。(1)の例2で指定するドローの給紙サイズは「A4横」になります。

連続紙の場合，次の表を参考に決定してください。(1)の例1で指定するドローの給紙サイズは「A4横」になります。

表21-1　印字可能領域と給紙サイズの関係（連続紙の場合）

給紙サイズ | 最大の印字可能領域※（縦ドット×横ドット）
A3縦 | 3,874 × 2,712
A3横 | 2,712 × 3,874
A4縦 | 2,712 × 1,890
A4横 | 1,890 × 2,712
A5縦 | 1,890 × 1,304
A5横 | 1,304 × 1,890
B4縦 | 3,345 × 2,334
B4横 | 2,334 × 3,345
B5縦 | 2,334 × 1,625
B5横 | 1,625 × 2,334

注※

上マージン，左マージンともに最小（5mm）の場合の値です。マージンを大きくすると，それに伴って印字可能領域は小さくなります。

(3)　レイアウトのます目を決定する

定義するタイプ1/2/R書式のイメージに合ったます目を決定します。ます目は，ドローで定義するときの項目位置や範囲の単位として利用します，また，固定フィールドの「文字サイズ」，および「文字の間隔」の標準値になります。ます目として指定できる範囲は，「付録D.5(2)　ドローで指定できるます目の範囲」を参照してください。

ます目は，FCBイメージやPAGECモジュールと合わせることで，運用時のずれをなくすことができます。

例えば，(1)の例1で求められたレイアウト領域に，行間隔6LPI，文字サイズ9ポイント，文字の間隔0ポイントのます目で定義する場合，45行，165列のます目ができます。

(4)　ユーザ用レイアウトパターン

決定した内容と同じ情報を持つパターンがXMAP3の標準レイアウトパターンにない場合，決定した内容を「ユーザ用レイアウトパターン」として登録すると，帳票定義のひな形として使用できます。この場合，毎回の設定がなくなるため，定義の効率と精度を向上させることができます。XMAP3の標準レイアウトパターンの内容は，「付録D.5(3)　標準提供しているレイアウトパターンの内容」を参照してください。

ユーザ用のレイアウトパターンは，ターゲット環境に関係なく，32個まで登録できます。

21.2.2　タイプ1/2/R書式に定義する内容を決定する

XMAP3は，メインフレームのタイプ1/2/R書式が持つ機能を，完全にはサポートしていません。したがって，タイプ1/2/R書式のレイアウトを設計するには，サポート範囲を考慮する必要があります。サポート範囲については「付録D.5(1)　生成できる記述文の範囲」を参照してください。

21.2.3　文字属性名の決定

タイプ1/2/R書式では，文字を「文字属性名」で指定します。あらかじめ，使用する文字と，それに対応する文字属性名を決定します。文字属性名については，マニュアル「書式オーバレイゼネレータ FOG2 E2」を参照してください。

XMAP3では，「文字属性名」を記述文ファイルの生成前に設定する必要があります。

文字属性名を設定するには，ユティリティを使用します。なお，文字属性名の設定は運用管理者が行ってください。

ドローセットアップを起動し，ターゲット環境が正しく設定されていることを確認します。

ユティリティメインダイアログで「エクスポート」を選択し，「詳細」で「タイプ1/2/R書式」を選択して［実行］ボタンをクリックします。

書式記述文エクスポートダイアログが表示されます。［設定...］ボタンをクリックしてください。

オプション設定ダイアログが表示されます。

「文字属性名設定」タブを表示させます。

［標準値変更...］ボタンをクリックします。標準値変更ダイアログが表示されます。

標準値が表示されているので，必要に応じて変更して［OK］ボタンをクリックします。

オプション設定ダイアログに戻ります。

文字属性名を追加する場合は［追加...］ボタンをクリックします。変更する場合は変更したい文字属性名を選択し，［変更...］ボタンをクリックします。

文字属性名の追加／変更ダイアログが表示されます。

次に示す項目を設定してから，［OK］ボタンをクリックします。

文字属性名

書体

文字サイズ

種別

なお，このダイアログで登録した文字属性名は，標準の文字属性名よりも優先されます。また，同じ文字属性名を複数個設定した場合は，先に設定した文字属性名の方が優先されます。
必要に応じて，5.と6.の手順を繰り返してください。

オプション設定ダイアログで［OK］ボタンをクリックして，文字属性名の設定を保存します。

21.3　ドローによる書式オーバレイの定義

タイプ1/2/R書式（PC上では書式オーバレイ）は，XMAP3のドローで定義します。

PCの対話定義環境については，マニュアル「XMAP3 プログラミングガイド 帳票編」を参照してください。

ただし，タイプ1/2/R書式の構成要素には，メインフレームでは定義できても，PCのXMAP3では定義できないものがあります。詳しくは「付録D.5(1)　生成できる記述文の範囲」を参照してください。主な注意事項を次に示します。

＜この節の構成＞

21.3.1　タイプ1/2/R書式の定義の手順

21.3.2　タイプ1/2/R書式定義時の注意事項

21.3.1　タイプ1/2/R書式の定義の手順

タイプ1/2/R書式定義の概要に従って，ドローでの定義手順を次に示します。

ドローを起動し，定義対象を選ぶ。
新規作成ダイアログの「定義対象の選択」で「ページプリンタ 書式オーバレイ」を選択します。

使用する帳票イメージに対応するレイアウトパターンを選択し，レイアウトを新規作成する。
ユーザ用レイアウトパターンを使用しない場合は，レイアウト領域の大きさなどを書式属性ダイアログで設定する必要があります。

書式オーバレイを定義する。
［表示］-［ます目配置］コマンドをチェックすると，行間隔，列間隔で補正されたレイアウトができます。

書式定義ファイルを保存する。
書式定義ファイルに名称を付けて保存します。書式定義ファイルの名称の先頭4文字は，エクスポート時に記述文ファイルの名称として使用します。このため，書式定義ファイルの名称は，先頭4文字がユニークになるようにしてください。
ドローでファイルの保存を行うと，書式定義ファイルと各種書式ファイルを出力します。この書式ファイルは記述文生成時には使用しません。書式定義ファイルだけを保存する場合は，［ファイル］-［書式定義ファイルだけの保存］コマンドを選択してください。

21.3.2　タイプ1/2/R書式定義時の注意事項

＜この項の構成＞

(1)　1,880文字を超える外字

(2)　ドローでの指定が有効とならない属性

(3)　固定グラフィック

(4)　コーナ付きの矩形，網掛け

(5)　円弧の配置

(6)　書式定義ファイルの名称

(1)　1,880文字を超える外字

PCで直接扱える外字は1,880文字までなので，ドローで定義するときには，1,880文字に収まらない外字を，出力テキストなどに使用しない漢字または記号に置き換えて定義してください。生成された記述文をメインフレームに転送したあとで，定義時に使った文字を使用する外字に置き換えてください。

(2)　ドローでの指定が有効とならない属性

ドローがサポートしているオブジェクト属性の中には，タイプ1/2/R書式で指定できないものがあります。それらの機能は記述文生成時に無視されるか，ほかの属性に変換されます。ドローでの指定がどのように扱われるかについては，「付録D.5(4)　生成する記述文の内容とドローとの関係」を参照してください。

(3)　固定グラフィック

固定グラフィックとして指定するファイルは，白黒のビットマップにしてください。色付きのビットマップは，XMAP3が白黒に変換しますが，定義時より見づらくなったり，印刷されないことがあります。

固定グラフィックの属性として，「領域の大きさに合わせる」を指定しないでください。指定した場合でもこの属性は無視され，実際の大きさで記述文展開されます。そのため，固定グラフィックの領域よりも大きいビットマップを指定していると，レイアウト領域を超えることがあります。固定グラフィックがレイアウト領域からはみ出るような場合，エクスポート時にエラーファイルにメッセージを出力します。記述文はそのまま生成されますが，ドローでの修正が必要です。

(4)　コーナ付きの矩形，網掛け

コーナ付きの矩形または網掛けを定義する場合，コーナ半径の大きさが，定義する矩形または網掛けよりも小さくなければなりません。コーナ半径の大きさが，矩形または網掛けよりも大きい場合，エクスポート時にエラーファイルにメッセージを出力します。記述文はそのまま生成されますが，ドローでの修正が必要です。コーナ付きの矩形または網掛けを指定する場合は，次の表に示す値を参考にし，定義する大きさに注意してください。

表21-2　コーナの大きさの指定と記述文の展開

ドローで指定するコーナの大きさ | 記述文展開上の大きさ
小 | 8ドット
中 | 16ドット
大 | 20ドット

(5)　円弧の配置

タイプ1/2/R書式では，円弧を含む円が定義範囲に入っていなければなりません。しかしドローでは，円弧で引かれる線，および中心点が定義範囲に入っていれば定義できます（円弧を含む円がレイアウト領域内に入っていなくてもよい）。このような円弧は，メインフレームでタイプ1/2/R書式を作成する際にエラーとなります。ドロー上で円弧を配置するときには，円弧を含む円がレイアウト領域に入るようにしてください。なお，円弧を含む円がレイアウト領域からはみ出る場合，エクスポート時にエラーファイルにメッセージを出力します。記述文ファイルはそのまま生成されますが，ドローでの修正が必要です。

(6)　書式定義ファイルの名称

生成する記述文ファイルのFORMS文に展開される書式名（「書式名1」または「書式名2」）は，書式定義ファイル（拡張子は.ifm）のファイル名の先頭4文字を使用します。そのため，書式定義ファイルが複数ある場合，ファイル名の先頭4文字が同じにならないようにしてください。

先頭の4文字が同じファイルが複数存在する場合，エクスポート時に記述文ファイルが上書きされますので注意してください。

21.4　記述文ファイルの生成

ドローで作成した書式定義ファイルから，記述文を生成する手順を説明します。記述文の生成には，エクスポート機能を利用します。

ドローセットアップを起動し，ターゲット環境が正しく設定されていることを確認します。

ユティリティメインダイアログで「エクスポート」を選択し，「詳細」で「タイプ1/2/R書式」を選択して［実行］ボタンをクリックします。

書式記述文エクスポートダイアログが表示されます。

「ファイルの出力先」の［参照...］ボタンをクリックして，記述文の出力先を指定します。

「ファイルの選択」の［参照...］ボタンをクリックして，記述文を生成するための書式定義ファイルを指定します。
選択されたファイルがリストボックスに表示されます。

［変換］ボタンをクリックして，エクスポート機能を実行します。
生成されるファイルは，記述文ファイル（拡張子は.FOG）です。エクスポート機能では変換時にエラーが発生した場合，ダイアログには「異常」または「警告」と表示されます。また，エラーメッセージを，「ファイルの出力先」に指定したフォルダに「書式定義ファイル名.ERR」というファイル名で出力します。

リストボックスに表示されているファイルをクリックして選択状態を解除すると，エクスポート対象外にできます。

21.5　記述文ファイルの転送

生成した記述文ファイルを転送する手順について説明します。

＜この節の構成＞

21.5.1　VOS3に記述文ファイルを転送する

21.5.2　VOS1に記述文ファイルを転送する

21.5.3　VOSKに記述文ファイルを転送する

21.5.1　VOS3に記述文ファイルを転送する

XMAP3で生成した記述文ファイルは，PC上のCommuniNetでIFITを使用してVOS3へ転送します。IFITについては，マニュアル「ファイル伝送プログラムIFIT-TSS E2」を参照してください。

(a)　メインフレーム上の出力ファイルの属性

メインフレーム上に出力するファイルは次に示す属性にしてください。

レコード形式は固定長

レコード長は80バイト

(b)　CommuniNetの環境を設定する

CommuniNetの環境設定ユティリティを起動します。「端末名称」は転送するファイルの置かれている端末を選択して，「設定項目」の「ファイル転送」をダブルクリックします。ファイル転送の設定ダイアログが表示されるので，「コード変換」を「あり」にして，［OK］ボタンをクリックします。

(c)　IFITのメニュー画面を使用して転送する場合

ファイル伝送機能の呼び出し
IFITコマンドを実行して，ファイル伝送機能の画面を呼び出します。

転送するファイルの設定

「FUNCTION NO.」は2（TERMINAL->HOST）を選択してください。

「HOST DATA SET NAME」の項に，メインフレーム上に出力するファイル名などを指定します。このとき，PC上のファイルに付いていた拡張子は付けないでください。

「TERMINAL FILE NAME」の項に，PCから転送するファイル名を完全なパス名で指定します。

(d)　IFITコマンドを使用して転送する場合

IFITコマンドを使用した転送の形式は，次のとおりです。

コマンド
オペランド

IFIT
△'メインフレーム上に出力するファイル名'
△PCから転送するファイル名
△INPUT(TERMINAL)

21.5.2　VOS1に記述文ファイルを転送する

XMAP3で生成した記述文ファイルは，PC上のCommuniNetからIFITを使用してVOS1へ転送します。IFITについては，マニュアル「ワークステーション操作 －パネル編－」，またはマニュアル「ワークステーション操作 －コマンド編－」を参照してください。

(a)　メインフレーム上の出力ファイルの属性

メインフレーム上に出力するファイルは次に示す属性にしてください。

レコード形式は固定長

レコード長は80バイト

データコードはDATA

(b)　CommuniNetの環境を設定する

CommuniNetの環境設定ユティリティを起動します。「端末名称」は転送するファイルの置かれている端末を選択して，「設定項目」の「ファイル転送」をダブルクリックします。ファイル転送の設定ダイアログが表示されるので，「コード変換」を「あり」にして，［OK］ボタンをクリックします。

(c)　IFITのメニュー画面を使用して転送する場合

IFITのメニュー画面を使用して転送する手順を次に示します。

ファイル伝送機能の呼び出し

マスタメニューの項目5「OA業務実行」を選択します。

OA業務実行メニューの項目5「パソコンファイル伝送」を選択します。

対話型ファイル伝送メニューの項目1「LIMEファイルのファイル伝送」を選択します。

転送するファイルの設定
「ホスト側ファイル情報」の項に，メインフレーム上に出力するファイル名などを指定します。このとき，PC上のファイルに付いていた拡張子は付けないでください。なお，レコード形式は「1:F」を選択し，レコード長は80バイトにしてください。「ワークステーション側ファイル情報」の項に，PCから転送するファイル名を完全なパス名で指定してください。

(d)　@@IFITコマンドを使用して転送する場合

@@IFITコマンドを使用した転送の形式は，次のとおりです。

コマンド
オペランド

@@IFIT
△FTYPE=LIME
,WSF='PCから転送するファイル名'
,RL=80
,TRN=WH
,FILE=メインフレーム上に出力するLIMEファイル名
,LIBRARY=メインフレーム上に出力するLIMEライブラリ名
,DC=DATA
,MEMBER=メインフレーム上に出力するメンバ名

21.5.3　VOSKに記述文ファイルを転送する

XMAP3で生成した記述文ファイルは，PC上のCommuniNetからIFITを使用してVOSKへ転送します。IFITについては，マニュアル「コマンド」，またはマニュアル「パネル」を参照してください。

(a)　メインフレーム上の出力ファイルの属性

メインフレーム上に出力するファイルは次に示す属性にしてください。

レコード形式は固定長

レコード長は80バイト

ファイルタイプはFOG2

(b)　CommuniNetの環境を設定する

CommuniNetの環境設定ユティリティを起動します。「端末名称」は転送するファイルの置かれている端末を選択して，「設定項目」の「ファイル転送」をダブルクリックします。ファイル転送の設定ダイアログが表示されるので，「コード変換」を「あり」にして，［OK］ボタンをクリックします。

(c)　IFITのメニュー画面を使用して転送する場合

IFITのメニュー画面を使用して転送する手順を説明します。

ファイル転送機能の呼び出し

操作マスタメニューの項目3「ファイル操作」を選択します。

ファイル操作メニューの項目9「ファイルの伝送」を選択します。

ファイル伝送メニューの項目9「WSとのファイル転送」を選択します。

転送するファイルの設定

「入力ファイル名」の項に，PCから転送するファイル名を指定します。

「出力ファイル名」の項に，メインフレーム上に出力するファイル名を指定します。このとき，PC上のファイルに付いていた拡張子は付けないでください。

「レコード末尾の埋字」として「16#40」を指定してください。

(d)　IFITコマンドを使用して転送する場合

IFITコマンドを使用した転送の形式は，次のとおりです。

コマンド
オペランド

IFIT
,IN=PCから転送するファイル名
,OUT=メインフレーム上に出力するファイル名
,PADDING=16#40

21.6　タイプ1/2/R書式エクスポート時のメッセージ

エクスポート機能で書式オーバレイの書式定義ファイルから記述文ファイルを生成するときに，次に示す定義がある場合，エラーメッセージを出力します。

生成された記述文を使ってメインフレームでタイプ1/2/R書式を生成すると，解析時にエラーとなるもの。

エクスポート時にオブジェクトを破棄，または設定内容を変更しているもの。

エラーが発生した場合でも，記述文ファイルは出力されます。

＜この節の構成＞

(1)　エラーファイルの形式

(2)　出力するメッセージの詳細

(3)　メッセージの詳細

(1)　エラーファイルの形式

エラーファイルのファイル名は，「書式定義ファイル名.ERR」です。エラーファイルは，書式エクスポートダイアログで設定した記述文ファイルの出力先に出力されます。

(2)　出力するメッセージの詳細

出力するメッセージの形式を次に示します。

［メッセージID］

［位置情報］　［メッセージテキスト］

(a)　メッセージID　：　X3EFnnn-y

X3EF

タイプ1/2/R書式エクスポート時のメッセージであることを示します。

nnn

メッセージ通番を示します。

y

メッセージの種類を示します。出力されるメッセージの種類を次に示します。

W：異常メッセージ
メインフレームで解析時にエラーとなるので，ドローでの再定義が必要なもの。

I：警告メッセージ
メインフレームで解析時にエラーとならないので，ドローでの再定義が不要なもの。

(b)　位置情報

メッセージ出力対象のオブジェクトのドロー上の定義位置を示します。なお，レイアウト全体に関するメッセージなど，位置情報を持たない場合は出力しません。

出力例を次に示します（xxxxxは5けたの数字を示します）。

ドローでの「グリッド種別」が「ます目」の場合
［縦xxxxxます，横xxxxxます］

ドローでの「グリッド種別」が「ミリ」の場合
［縦xxxxx mm，横xxxxx mm］

ドローでの「グリッド種別」が「ドット」の場合
［縦xxxxxドット，横xxxxxドット］

(c)　メッセージテキストの詳細

メッセージテキストについて説明します。

（S）エクスポートの処理

メッセージを出力したあとの主な処理を示します。

（P）プログラマの処置

メッセージを受け取ったプログラマが取るべき処置を示します。

(3)　メッセージの詳細

個々のメッセージについて説明します。なお，ここに掲載しているのは，タイプ1/2/R書式のエクスポート機能に固有のメッセージだけです。XMAP3全体に共通のメッセージについては，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

X3EF901-W

レイアウト領域の横サイズが制限値（48ドット以上4095ドット以下）を超えています

帳票属性ダイアログで指定したレイアウトの横サイズが，タイプ1/2/R書式での制限値を超えている。

（S）書式記述文を生成します。

（P）書式オーバレイゼネレータのバージョンによって，レイアウトの横サイズの制限値は異なります。

作成された書式記述文のX長の値が，使用する書式オーバレイゼネレータの制限値内であれば，エラーを無視してそのまま使用できます。制限値外であれば，制限値に収まるようにレイアウトの横サイズを修正して，書式定義ファイルを再作成します。

その後，エクスポートを再実行します。

X3EF902-W

文字データ名及びドットデータ名が制限値（384個）を超えています

記述文中に展開した文字データ名およびドットデータ名が，タイプ1/2/R書式での制限値を超えている。

（S）書式記述文を生成する。

（P）タイプ1/2/R書式では，データ名（文字データ名とドットデータ名）の種類が384個以内でなければなりません。記述文生成では，基本的に一つの固定フィールド，固定グラフィックに対して，一つのデータ名を割り当てます。しかし定義の内容によっては複数個のデータ名を割り当てる場合があります。

次に示す内容で定義を見直してください。

見直し内容
記述文生成時の動作
対策方法

半角文字と全角文字を混在させた固定フィールドがないか
半角文字と全角文字を混在させて指定した場合，それぞれを独立した項目として展開し，それぞれにデータ名を割り振る。
どちらかの文字に統一する。

左寄せ以外の桁寄せを指定した固定フィールドに，全角文字を指定していないか
ドローの桁寄せは，文字の間に半角空白を埋めて表現している。半角空白は半角とみなされるため，半角，全角の混在と同じように分割する。
全角文字列を桁寄せしたい場合は，左寄せにして，全角の空白で埋める。

大きい固定グラフィックがないか
固定グラフィックは253×253（ピクセル）までを一つとして作成する。253×253を超える場合，分割し，それぞれにデータ名を割り振る。
固定グラフィックは
253×253以内になるように変更する。

上記に従って見直してもエラーになる場合は，固定フィールドを削除してください。

X3EF903-W

［位置情報］　円弧を含む円全体が印刷領域からはみ出しています

円弧を含む円全体がレイアウト領域からはみ出している。

（S）書式記述文を生成します。

（P）円弧を含む円全体がレイアウト領域に収まるように位置を変更するか，または円全体の大きさを小さくして，書式定義ファイルを再作成したあと，エクスポートを再実行します。

X3EF904-W

［位置情報］　矩形のコーナ半径が横サイズ又は縦サイズを超えています

矩形のコーナ半径が，矩形の横サイズまたは縦サイズを超えている。

（S）書式記述文を生成します。

（P）矩形のコーナ半径を小さくするか，または矩形の横サイズまたは縦サイズを大きくして，書式定義ファイルを再作成したあと，エクスポートを再実行します。

X3EF905-W

［位置情報］　網掛けのコーナ半径が横サイズ又は縦サイズを超えています

網掛けのコーナ半径が，網掛けの横サイズまたは縦サイズを超えている。

（S）書式記述文を生成します。

（P）網掛けのコーナ半径を小さくするか，または網掛けの横サイズまたは縦サイズを大きくして，書式定義ファイルを再作成したあと，エクスポートを再実行します。

X3EF906-W

［位置情報］　固定グラフィックが印刷領域からはみ出しています

固定グラフィックのダイアログで「領域に合わせて表示」を指定して，さらにレイアウト領域の右端または下端に配置している。

（S）書式記述文を生成します。

（P）固定グラフィックのダイアログで「領域に合わせて表示」を解除し，レイアウト領域内に収まるように配置し直します。その後，書式定義ファイルを再作成し，エクスポートを再実行します。

X3EF201-I

［位置情報］　｛固定フィールドの拡大属性を標準｜固定フィールドの強調属性を標準｜固定フィールドの網掛け属性を網掛けなし｜けい線の線の種類を実線｜矩形の線の種類を実線｜円の線の太さを細線｜円弧の線の太さを細線｜円の線の種類を実線｜円の網掛け属性を網掛けなし｜固定グラフィックの枠付きを枠なし｝に変換しました

［オブジェクト］の［対象属性］を［変換結果］に変換した。
該当するのは，以下のとおり。

固定フィールドの拡大属性に，縦拡大または横拡大または倍角を指定している。

固定フィールドの強調属性に，太字または斜体または太字＆斜体を指定している。

固定フィールドの網掛け属性に，濃いまたは薄いなどの標準以外の属性を指定している。

けい線または矩形の線の種類に，二重線を指定している

円または円弧の線の太さに，中線または太線または極太を指定している。

円の線の種類に，二重線を指定している

円の網掛け属性に，濃いまたは薄いなどの標準以外の属性を指定している。

固定グラフィックの枠付きに，枠ありを指定している。

（S）指定された対象属性を変換結果で示す値に変換し，書式記述文を生成します。

（P）オブジェクトの対象属性を変換結果で示す値に変更し，書式定義ファイルを再作成したあと，エクスポートを再実行します。

X3EF202-I

［位置情報］　固定グラフィックを破棄しました

固定グラフィックのうち，種別にビットマップファイル以外（Windowsメタファイル（.wmf），拡張メタファイル（.emf））が指定されたので，固定グラフィックを破棄した。

（S）指定されたオブジェクトを破棄し，書式記述文を生成します。

（P）該当するオブジェクトを指定しないで書式定義ファイルを再作成し，エクスポートを再実行します。

付録

＜この付録の構成＞

付録A　メインフレームとPCとの用語の対応

付録B　メインフレームとの処理分散

付録C　メインフレーム資産の移行

付録D　メインフレーム資産の開発

付録E　用語解説

付録A　メインフレームとPCとの用語の対応

メインフレームのXMAPとPCのXMAP3とでは，用語が一部異なっています。メインフレームとPCの用語の違いのうち主なものを次の表に示します。

表A-1　メインフレームとPCの用語の違い

メインフレームのXMAP | PCのXMAP3
固定項目 | 固定フィールド
可変項目（出力項目） | 出力フィールド
可変項目（入力項目） | 入出力フィールド
可変項目（入出力項目） | 入出力フィールド
囲みけい線 | 矩形
角の丸め | ラウンドコーナ
字間値 | 文字の間隔
インタラプトコード | イベント通知コード
パネル制御情報 | 論理マップ制御
表示動作 | ERASE | 表示形態 | 全面書換
WRITE | 一部上書
ERWRT | 自動
入力フィールド | RESTF | 入力フィールドの扱い | 入力データをAPに返す
ERUNP | 入力データを消去する
IGNRTF | 入力データを変更しない
DFC | 表示属性
論理チェック | SKIP（自動スキップ） | 遷移条件 | 自動スキップ
OVF（桁あふれチェック） | 手動スキップ
MFILL（全桁入力） | 手動・全桁必須
RJUST（右寄せ） | 手動・右寄せ
転送 | 入力済
自動入力 | 自動送信
ベル（プリンタ） | アラーム
非表示 | 文字だけ非表示
リバース | 反転表示
入力チェック | PROT（保護） | 表示方法と使用目的 | 入力不可
NUM（数字または数値） | 数字
CHAR（文字記号） | 日本語
KANA（かたかな） | カナ
ALPH（英数（チェック有）） | 英数
KEIS（漢字（チェック有）） | 日本語
従論理項目 | 下位項目
省略時仮定値 | 初期値
初期値 | （対応なし）
混在項目 | 使用目的が「日本語」でデータ型が「文字」
共用項目 | 使用目的が「日本語」でデータ型が「漢字」
予約項目 | 予約フィールド
論理項目名 | データ名
デリミタ線 | （対応なし）※
次表示マップ | 次画面

（凡例）

（対応なし）：PCのXMAP3では，該当する機能または概念が存在しない。

注※

PCのXMAP3でのデリミタ線はけい線の並びです。CNSFLD文やVARFLD文のDLMオペランドではありません。

付録B　メインフレームとの処理分散

＜この節の構成＞

付録B.1　リターンコード

付録B.2　文字コードの違い

付録B.3　外字用コードの割り当て

付録B.4　プログラム例

付録B.5　CommuniNet Extensionを使用したメインフレーム・PC連携機能でのトラブルと対処方法

付録B.1　リターンコード

メインフレームとPCに処理を分散する環境では，関数の戻り値として，処理結果を示すリターンコードを返します。また，リターンコードの詳細として通信論理マップのリターンコード詳細エリアにリターン情報を格納し，通信論理マップに返します。リターンコードとその意味を次の表に示します。

表B-1　リターンコードと意味

リターンコード | 意味
0 | 正常終了。
4 | 異常終了（画面送受信はできたが，送受信内容にエラーがある）。
8 | 異常終了（画面送受信ができなかった）。
12 | 通信論理マップ不正（エリアアドレス，またはエリア中の設定値が不正）。

リターンコードが「8」の場合は，エラーの詳細コードが，通信論理マップのリターンコード詳細エリアに設定されます。リターンコードが「4」または「12」の場合は，通信論理マップに詳細コードは設定されません。

メインフレーム連携利用時に発生する詳細コードには，メインフレーム連携固有の詳細コード，画面表示と帳票印刷それぞれで発生する詳細コード，および画面表示と帳票印刷で共通する詳細コードがあります。メインフレーム連携固有の詳細コードの内容と対策について次の表に示します。

画面表示で発生する詳細コード，および共通の詳細コードの内容と対策についてはマニュアル「XMAP3 プログラミングガイド 画面編」を，帳票印刷で発生する詳細コードおよび共通の詳細コードの内容と対策についてはマニュアル「XMAP3 プログラミングガイド 帳票編」を参照してください。

表B-2　詳細コードのエラー内容と対策

詳細コード
エラー内容と対策

16進
10進

(7000)₁₆
28672
仮想端末がオープンされていない。
（S）処理を終了する。
（P）メインフレーム上のAPから，オープン要求を発行する。

(7001)₁₆
28673
オープンできる仮想端末の最大数を超えた。
（S）処理を終了する。
（P）PCに対してのオープン処理が15を超えている。不要なオープン処理が出ていないか確認して，不要なものはクローズし，再実行する。

(7002)₁₆
28674
すでにオープンされている仮想端末に対してオープン要求をした。
（S）処理を終了する。
（P）オープン要求した仮想端末名が正しいか確認して，再実行する。

（凡例）

（S）：システムの処理。

（P）：プログラマの処理。

付録B.2　文字コードの違い

メインフレームとPCでは使用する文字コードが異なります。PCはシフトJISを使用していますが，メインフレームでは2バイトコードとしてKEIS'83または，KEIS'78，1バイトコードとしてEBCDIKまたは，EBCDICを使用しています。

文字コードはXMAP3が変換しますが，2バイトコードとしてKEIS'83，1バイトコードとしてEBCDIKを前提としています。また，EBCDIKには英小文字はありませんが，「付録B.2(1)(a)　EBCDIKからシフトJISへの変換」，および「付録B.2(1)(b)　シフトJISからEBCDIKへの変換」で示すように，EBCDIKの空き領域を英小文字として使用しています。

EBCDICを使用して英小文字を使用する場合，「付録B.2(1)(a)　EBCDIKからシフトJISへの変換」，および「付録B.2(1)(b)　シフトJISからEBCDIKへの変換」で示すように，EBCDICの英小文字とコードが合わず，表示・印刷すると文字化けし，画面入力した英小文字がメインフレームで正しく認識できません。

したがって，英小文字を使用する場合は，出力論理マップや入力論理マップのデータを「付録B.2(1)(a)　EBCDIKからシフトJISへの変換」，および「付録B.2(1)(b)　シフトJISからEBCDIKへの変換」に示す範囲で使用してください。

GUI画面のフィールドボックスで，改行入力属性を指定したフィールドを使用する場合，「付録B.2(1)(e)　改行を操作するためのメインフレームコード」で示すように，改行コードは(15)₁₆を使用します。

KEIS'78を使用してKEIS'83とコードの異なる文字を使用している場合，表示・印刷すると文字化けし，画面入力した文字がメインフレームで正しく認識できません。

したがって，表B-3に示す，コードの異なる文字を使用する場合は，出力論理マップ，入力論理マップのデータKEIS'83の該当コードとして使用してください。

＜この項の構成＞

(1)　1バイト文字の変換

(2)　漢字コードの違い

(3)　けい線コードの違い

(4)　ベンダ固有文字についての注意事項

(1)　1バイト文字の変換

メインフレームとPCに処理を分散する場合，シフトJISとEBCDIKとの文字コードの違いはXMAP3が変換します。文字コード変換の表を次に示します。

(a)　EBCDIKからシフトJISへの変換

（例）

EBCDIKコードでの「A」（コードは(C1)₁₆）は，シフトJISでは(41)₁₆に変換されます。

(b)　シフトJISからEBCDIKへの変換

（例）

シフトJISコードでの「1」（コードは(31)₁₆）は，EBCDIKでは(F1)₁₆に変換されます。

(c)　EBCDICの英小文字からシフトJISへの変換

EBCDICの英小文字を指定した場合，表示・印刷時に出力される文字を次の表に示します。

（例）

EBCDICコードでの「a」（コードは(81)₁₆）は，シフトJISでは半角の「ア」（コードは(B1)₁₆）に変換されます。

(d)　英小文字を操作するためのメインフレームコード

表示・印刷時に英小文字を操作するためのメインフレームコードを以下の表に示します。

出力文字シフトJIS | コード |  | 出力文字シフトJIS | コード |  | 出力文字シフトJIS | コード |  | 出力文字シフトJIS | コード
a(61) | (59) |  | h(68) | (68) |  | o(6F) | (75) |  | v(76) | (9C)
b(62) | (62) |  | i(69) | (69) |  | p(70) | (76) |  | w(77) | (A0)
c(63) | (63) |  | j(6A) | (70) |  | q(71) | (77) |  | x(78) | (AB)
d(64) | (64) |  | k(6B) | (71) |  | r(72) | (78) |  | y(79) | (B0)
e(65) | (65) |  | l(6C) | (72) |  | s(73) | (80) |  | z(7A) | (B1)
f(66) | (66) |  | m(6D) | (73) |  | t(74) | (8B) |
g(67) | (67) |  | n(6E) | (74) |  | u(75) | (9B)

（例）

シフトJISでの「a」（コードは(61)₁₆）を操作するには，EBCDIC／EBCDIKコードの(59)₁₆を使用します。

(e)　改行を操作するためのメインフレームコード

GUI画面のフィールドボックスに定義した，改行入力属性を指定したフィールドで，改行を操作するためのメインフレームコードは(15)₁₆です。

メインフレームでは，2バイトコード中の改行コード（(15)₁₆）に，シフトコード（(0A41)₁₆，(0A42)₁₆）を必要としませんが，XMAP3では画面入力時，改行コード（(15)₁₆）の後ろが2バイトコードの場合，改行コード（(15)₁₆）と2バイトコードの間にシフトコード（(0A42)₁₆）を付加して入力論理マップに格納します。これによって，改行コード（(15)₁₆）の後半を抜き取った場合でも2バイトシフトコードとしてそのまま扱うことができます。

なお，画面出力時の出力論理マップには，2バイトコード中の改行コード（(15)₁₆）にシフトコードを付加する必要はありません。

(2)　漢字コードの違い

KEIS'83とKEIS'78の漢字コードの違いを次の表に示します。

表B-3　文字コードの対応

文字 | KEIS'83 | KEIS'78 |  | 文字 | KEIS'83 | KEIS'78
鰺 | F2CD | B0B3 |  | 鯵 | B0B3 | F2CD
鶯 | F2F4 | B2A9 |  | 鴬 | B2A9 | F2F4
蠣 | E9DA | B3C2 |  | 蛎 | B3C2 | E9DA
攪 | D9F8 | B3C9 |  | 撹 | B3C9 | D9F8
竈 | E3DE | B3F6 |  | 竃 | B3F6 | E3DE
灌 | DEF5 | B4C3 |  | 潅 | B4C3 | DEF5
諫 | EBDD | B4D2 |  | 諌 | B4D2 | EBDD
頸 | F0F4 | B7DB |  | 頚 | B7DB | F0F4
礦 | E2E8 | B9DC |  | 砿 | B9DC | E2E8
蘂 | E9A2 | BCC9 |  | 蕊 | BCC9 | E9A2
靱 | F0D7 | BFD9 |  | 靭 | BFD9 | F0D7
賤 | ECCD | C1A8 |  | 賎 | C1A8 | ECCD
壺 | D4E4 | C4DB |  | 壷 | C4DB | D4E4
礪 | E2EA | C5D7 |  | 砺 | C5D7 | E2EA
檮 | DBED | C5EE |  | 梼 | C5EE | DBED
濤 | DEB9 | C5F3 |  | 涛 | C5F3 | DEB9
邇 | EDEE | C6F6 |  | 迩 | C6F6 | EDEE
蠅 | EAA4 | C7E8 |  | 蝿 | C7E8 | EAA4
檜 | DBD8 | C9B0 |  | 桧 | C9B0 | DBD8
儘 | D0D6 | CBF9 |  | 侭 | CBF9 | D0D6
籠 | E4C6 | CFB6 |  | 篭 | CFB6 | E4C6
藪 | E9AE | CCF9 |  | 薮 | CCF9 | E9AE
堯 | F4A1 | 5CC3 |  | 槇 | F4A2 | 61FC
遙 | F4A3 | 6BA2 |  | 瑤 | F4A4 | 65A7
⊂ | A2BE | A2BF |  | ⊃ | A2BF | A2BE

(3)　けい線コードの違い

KEIS'83とKEIS'78のけい線コードの違いを次の表に示します。

表B-4　けい線コードの対応

KEIS'83 | KEIS'78 |  | KEIS'83 | KEIS'78
けい線 | コード | コード | けい線 |  | けい線 | コード | コード | けい線
┌ | A8A3 | AFA1 | ┌ |  | ┬ | A8A8 | AFB3 | ┬
┌ | A8AE | AFA2 | ┌ |  | ┬ | A8B3 | AFB4 | ┬
┌ | A8AE | AFA3※¹ | ┏※1 |  | ┬ | A8B3 | AFB5※¹ | ┳※1
┐ | A8A4 | AFA4 | ┐ |  | ┴ | A8AA | AFB6 | ┴
┐ | A8AF | AFA5 | ┐ |  | ┴ | A8B5 | AFB7 | ┴
┐ | A8AF | AFA6※¹ | ┓※1 |  | ┴ | A8B5 | AFB8※¹ | ┻※1
└ | A8A6 | AFA7 | └ |  | ┼ | A8AB | AFB9 | ┼
└ | A8B1 | AFA8 | └ |  | ┼ | A8B6 | AFBA | ┼
└ | A8B1 | AFA9※¹ | ┗※1 |  | ┼ | A8B6 | AFBB※¹ | ╋※1
┘ | A8A5 | AFAA | ┘ |  | ─ | A8A1 | AFBC | ─
┘ | A8B0 | AFAB | ┘ |  | ─ | A8AC | AFBD | ─
┘ | A8B0 | AFAC※¹ | ┛※1 |  | ─ | A8AC | AFBE※¹ | ━※1
├ | A8A7 | AFAD | ├ |  | │ | A8A2 | AFBF | │
├ | A8B2 | AFAE | ├ |  | │ | A8AD | AFC0 | │
├ | A8B2 | AFAF※¹ | ┣※1 |  | │ | A8AD | AFC1※¹ | ┃※1
┤ | A8A9 | AFB0 | ┤ |  | │ | A8AD | AFC2※¹ | ※1※2
┤ | A8B4 | AFB1 | ┤ |  | │ | A8AD | AFC3※¹ | ※1※3
┤ | A8B4 | AFB2※¹ | ┫※1 |  | │ | A8AD | AFC4※¹ | ※1※4

注※1

KEIS'83を使用している場合でも，オンデマンド外字処理を使用すれば，表示および印刷ができます。

注※2

細い縦の破線「[図データ]」です。

注※3

縦の破線「[図データ]」です。

注※4

太い縦の破線「[図データ]」です。

(4)　ベンダ固有文字についての注意事項

XMAP3では，XMAP3外字機能，コード変換SDK，コード変換ランタイム，日立コード変換 - Server Runtime，または日立コード変換 - Client Runtimeと併用した場合，PCで使用できるシフトJISのベンダ固有文字が変わりますので，注意してください。

なお，ベンダ固有文字はPC環境に依存するため使用できなくなることがありますので，ベンダ固有文字は極力使用しないことをお勧めします。この場合，ベンダ固有文字はWindowsで定義できるシフトJIS外字※¹に置き換える，または日立コード変換※2で文字コードを変換して使用してください。

注※1

Windowsで定義できるシフトJISの外字領域は，(F040)₁₆～(F9FC)₁₆です。ただし，コードの第2バイトは，(xx40)₁₆～(xx7E)₁₆，および(xx80)₁₆～(xxFC)₁₆の範囲です。

注※2

日立コード変換 - Development Kitのバージョンによっては，ベンダ固有文字を利用できます。詳細は，マニュアル「日立コード変換ユーザーズガイド」を参照してください。

日立コード変換 - Development Kitでベンダ固有文字をカスタマイズする場合，必ずユーザがカスタマイズしたユーザマッピングファイルを利用してください。日立コード変換 - Development Kitに含まれるGJISKEI.TBL（シフトJISとKEISのユーザマッピングファイル）の初期値には，シフトJISのベンダ固有文字とKEIS拡張文字セット3のマッピング情報は定義されていません。

ただし，XMAP3帳票環境セットアップで，印刷モードにPDLスルー，日立ESC/Pを選択している場合，XMAP3での帳票印刷時，ベンダ固有文字はプリンタ内蔵フォントに依存します。

なお，ベンダ固有文字は，コード変換SDK，コード変換ランタイム，日立コード変換 - Server Runtime，または日立コード変換 - Client Runtimeを併用した環境によって使用できる範囲が異なります。

表B-5　ベンダ固有文字の利用について

ベンダ固有文字の
コードの範囲※1
コード変換製品なし
コード変換製品あり

XMAP3外字機能
なし
XMAP3外字機能
あり

Windows特殊文字
(8740)₁₆～(879C)₁₆
XMAP3内部で変換する。※2
＜コード変換＞KEIS ⇔シフトJIS
XMAP3がコード変換を利用して変換する。※3
＜コード変換＞KEIS ⇔シフトJIS
XMAP3がコード変換を利用して変換する。※3※4
＜コード変換＞KEIS ⇔ Unicode

NEC選定IBM拡張文字(ED40)₁₆～(EEFC)₁₆

IBM選択文字(FA40)₁₆～(FC4B)₁₆

（凡例）

コード変換製品なし：コード変換製品を併用しない場合。

コード変換製品あり：コード変換SDK，コード変換ランタイム，日立コード変換 - Server Runtime，または日立コード変換 - Client Runtimeを併用した場合。

注※1

コードの範囲はシフトJISコードの範囲を示します。なお，すべてのベンダ固有文字のコード範囲は次のとおりです。

・第1バイト：(81xx)₁₆～(9Fxx)₁₆，および(E0xx)₁₆～(FCxx)₁₆

・第2バイト：(xx40)₁₆～(xx7E)₁₆，および(xx80)₁₆～(xxFC)₁₆

注※2

PCの環境によって，変換した文字コードに異なる文字が割り当てられている場合があります。ベンダ固有文字は，外字領域に作成，登録して使用することをお勧めします。

注※3

コード変換SDKまたはコード変換ランタイムでは，NEC選定IBM拡張文字，およびIBM選択文字はサポートされていません。NEC選定IBM拡張文字およびIBM選択文字を使用する場合は，外字領域に作成，登録して使用ください。

日立コード変換 - Server Runtimeまたは日立コード変換 - Client Runtimeのバージョンによってはベンダ固有文字がサポートされています。この場合，ベンダ固有文字をKEISコードの内字領域または拡張文字セット3領域のどちらに割り当てるかを，日立コード変換のユーザマッピング機能で選択する必要があります。割り当てるKEISコードごとの注意事項を次に示します。

KEISの内字領域を使用する場合

NEC選定IBM拡張文字およびIBM選択文字は利用できません。

KEISの拡張文字セット3領域を使用する場合

この領域は初期状態では外字領域としてマッピングされています。

すでに外字として利用している場合には注意が必要です。

ベンダ固有文字をマッピングできる日立コード変換 - Server Runtimeまたは日立コード変換 - Client Runtimeのバージョン，および設定方法については，マニュアル「日立コード変換ユーザーズガイド」を参照してください。

注※4

PDFファイル出力では，コード変換製品のサポート範囲によってはIBM選択文字およびNEC選定IBM拡張文字は利用できません。PDFファイル出力時には，「表B-5　ベンダ固有文字の利用について」に示す文字コード変換に加えて「Unicode⇔シフトJIS」のコードを変換しますので，コード変換製品での「Unicode⇔シフトJIS」のコードマッピングのサポート範囲をご確認ください。

付録B.3　外字用コードの割り当て

メインフレーム，およびPC上で使用できる外字の字数を次の表に示します。

表B-6　使用できる外字の字数（メインフレーム，PC）

プラットホーム
文字コード
使用できる
外字の字数
備考

メインフレーム
KEIS
9,024
拡張文字セット3および保留領域を含む

PC
シフトJIS
1,880
機種依存文字を除いた字数

Unicode
6,400
Windows NT， Windows 2000，Windows XP，およびWindows Server 2003だけで使用できる

KEISとシフトJISの外字用コードの対応を次の表に示します。

表B-7　KEISとシフトJISの外字用コードの対応

項番 | メインフレームの外字用コード（KEIS） | PCの外字用コード（シフトJIS）
1 | 81A1～81DF | F040～F07E
2 | 81E0～81FE | F080～F09E
3 | 82A1～82FE | F09F～F0FC
4 | 83A1～83DF | F140～F17E
5 | 83E0～83FE | F180～F19E
6 | 84A1～84FE | F19F～F1FC
7 | 85A1～85DF | F240～F27E
8 | 85E0～85FE | F280～F29E
9 | 86A1～86FE | F29F～F2FC
10 | 87A1～87DF | F340～F37E
11 | 87E0～87FE | F380～F39E
12 | 88A1～88FE | F39F～F3FC
13 | 89A1～89DF | F440～F47E
14 | 89E0～89FE | F480～F49E
15 | 8AA1～8AFE | F49F～F4FC
16 | 8BA1～8BDF | F540～F57E
17 | 8BE0～8BFE | F580～F59E
18 | 8CA1～8CFE | F59F～F5FC
19 | 8DA1～8DDF | F640～F67E
20 | 8DE0～8DFE | F680～F69E
21 | 8EA1～8EFE | F69F～F6FC
22 | 8FA1～8FDE | F740～F77E
23 | 8FE0～8FFE | F780～F79E
24 | 90A1～90FE | F79F～F7FC
25 | 91A1～91DF | F840～F87E
26 | 91E0～91FE | F880～F89E
27 | 92A1～92FE | F89F～F8FC
28 | 93A1～93DF | F940～F97E
29 | 93E0～93FE | F980～F99E
30 | 94A1～94FE | F99F～F9FC
| 上記以外の外字コード | 下記参照※

注※

KEIS'83コードで(91A1)₁₆～(94FE)₁₆の範囲外にある外字を，PCの外字コードに対応させて使用する場合は，コード変換SDK，または日立コード変換 - Development Kitを使用して，外字マッピングファイルをカスタマイズしてください。

コード変換ランタイム，コード変換SDK，日立コード変換 - Server Runtime，または日立コード変換 - Client Runtimeをインストールした状態では，標準値の外字マッピングファイルを使用します。標準値での，KEISとUnicodeの外字に使われる文字コードの対応を次の表に示します。

表B-8　KEISとUnicodeの外字用コードの対応

項番 | メインフレームの外字用コード（KEIS） | PCの外字用コード（Unicode）
1 | 41A1～4FFE | E000～E581
2 | 50A1～5FFE | E582～EB61
3 | 60A1～6FFE | EB62～F141
4 | 70A1～7FFE | F142～F721
5 | 80A1～85FE | F722～F8FF
| 上記以外の外字コード | 下記参照※

注※

KEIS'83コードで(41A1)₁₆～(85FE)₁₆の範囲外にある外字を使用する場合は，外字マッピングファイルをカスタマイズしてください。

外字マッピングファイルのカスタマイズについては，次の個所を参照してください。

メインフレームのOSがVOS3の場合：「3.2.7　外字の設定」

メインフレームのOSがVOS1の場合：「8.2.7　外字の設定」

メインフレームのOSがVOSKの場合：「13.2.5　外字の設定」

コード変換SDKの使用方法については，マニュアル「コード変換ユーザーズガイド」を参照してください。日立コード変換 - Development Kitの使用方法については，マニュアル「日立コード変換ユーザーズガイド」を参照してください。

付録B.4　プログラム例

＜この項の構成＞

(1)　メインフレーム上のAPの例

(2)　PC上の画面管理プログラムの例

(1)　メインフレーム上のAPの例

PC上のGUI画面を使用して，メインフレーム上のAPを実行する場合のユーザ業務例（XDM/DCCM3オンライン，またはDCCM3オンライン），およびメインフレーム上のAPと，PC上の画面管理プログラムとのインタフェースについて説明します。

ここで前提とするシステムは，メインフレームのOSをVOS3またはVOS1とし，メインフレーム上のAPとPCは1対1になる構成とします。メインフレームとPCとの通信は拡張ホストアクセスを利用し，PC側で使用する画面管理プログラムは「ONLNPROC.C」です。

(a)　業務の流れ

GUI画面を使用したユーザ業務例として，受注データ処理，および受注伝票発行業務処理を想定します。ここでは，受注伝票発行業務画面を使用した受注データの修正について，作業の流れとインタフェースの仕組みおよび画面管理プログラムのコーディング例を示します。

画面および作業の遷移を次の図に示します。

図B-1　GUI画面を使用した受注伝票発行業務例

受注伝票発行業務画面の受注データ修正の処理の流れを次に示します。

ユーザは，PC上のCommuniNet端末を起動しメインフレームへログインして，メインフレームのXDM/DCCM3と接続します。その後，起動したいトランザクション名を指定して，受注伝票発行業務のAPを起動させます。

「受注伝票発行業務画面」が表示されます。プッシュボタンを押して，業務を選択します。

「受注伝票発行業務画面」で「受注データ修正」をクリックすると，「受注データ修正：ヘッダ画面（一次ウィンドウ）」が表示されます。伝票番号の欄に「D0012345」を入力すると自動送信され，対応する顧客名，顧客コード，担当者名，担当者コード，および支店コードが表示されます。

「受注データ修正：ヘッダ画面」のメニューバー「アクション」のプルダウンメニュー「明細表示」を選択すると，「受注データ修正：明細画面」が表示されます。「受注データ修正：明細画面」では，全受注データを更新します。

「受注データ修正画面」のメニューバー「アクション」のプルダウンメニュー「印刷」を選択すると，受注伝票の帳票が印刷されます。

(b)　受注伝票発行業務プログラム（仮想端末のオープン）

フローチャート

仮想端末をオープンする受注伝票発行業務プログラムのフローチャートを次に示します。

コーディング

仮想端末をオープンする受注伝票発行業務プログラムのコーディングを次に示します。

*********************************************************
*    受注伝票発行業務プログラム                        
*                                                      
* （ディスプレイ仮想端末オープン）                      
*********************************************************
IDENTIFICATION    DIVISION.
PROGRAM-ID.       UP01.

ENVIRONMENT       DIVISION.

DATA              DIVISION.
WORKING-STORAGE   SECTION.

*  送受信用メッセージテーブル
    COPY             X3TRNTBL.

*  トランザクションコード＆要求種別
    COPY             UPTBL.

*  通信節
COMMUNICATION  SECTION.
CD  MSG  FOR  I-O
    MAP  NAME  IS  MAP-NAME
    STATUS  KEY  IS  ERR-CODE.

*********************************************************
PROCEDURE          DIVISION.
*********************************************************
*  受信
*********************************************************
* メッセージ受信         SECTION.
*********************************************************
 RECEIVE  MSG  FIRST  SEGMENT  INTO  XMAP-RECV.

*  業務開始
  MOVE  '00000'    TO  ERR-CODE
  MOVE  '%MMC1R  ' TO  MAP-NAME

*  メッセージ設定
  MOVE  2920       TO  XMAP-SEND-MAPL
  MOVE  XMAP-SENDT TO  XMAP-SEND
  MOVE  UAPNAME    TO  XMAP-SEND-UAP
  MOVE  TRNCODE1   TO  XMAP-SEND-TRN
  MOVE  REQ-OPEN   TO  XMAP-SEND-REQ
  MOVE  DSPTERM    TO  XMAP-SEND-TNAME
  MOVE  ALL X'00'  TO  XMAP-SEND-PMAPNAME
  MOVE  +0         TO  XMAP-SEND-INLNG

*  送信
*********************************************************
メッセージ送信         SECTION .
*********************************************************
  SEND  MSG  FROM  XMAP-SEND  WITH  EMI.

  GOBACK.

(c)　受注伝票発行業務プログラム（メニュー画面表示）

フローチャート

メニュー画面を表示する受注伝票発行業務プログラムのフローチャートを次に示します。

コーディング

メニュー画面を表示する受注伝票発行業務プログラムのコーディングを次に示します。

*********************************************************
*   受注伝票発行業務プログラム                          
*                                                      
*  （メニュー画面表示）                                
*********************************************************
IDENTIFICATION    DIVISION.
PROGRAM-ID.       UP12.

ENVIRONMENT       DIVISION.

DATA              DIVISION.
WORKING-STORAGE   SECTION.

*  論理マップ
    COPY             MAPG01O.
    COPY             MAPG01I.

*  送受信用メッセージテーブル
    COPY             X3TRNTBL.

*  動的変更テーブル
    COPY             X3MODTBL.

*  トランザクションコード＆要求種別
    COPY             UPTBL.

*  通信節
COMMUNICATION  SECTION.
CD  MSG  FOR  I-O
    MAP  NAME  IS  MAP-NAME
    STATUS  KEY  IS  ERR-CODE.

*********************************************************
PROCEDURE          DIVISION.
*********************************************************
*  受信
 RECEIVE  MSG  FIRST  SEGMENT  INTO  XMAP-RECV.

*********************************************************
  ユーザ業務処理部
*********************************************************
*  業務開始
  MOVE  '00000'    TO  ERR-CODE
  MOVE  '%MMC1R  ' TO  MAP-NAME

  MOVE  ALL X'3F'  TO  MAPG01G
  MOVE  XMAP-CNTRL1 TO MAPG01-CNTRLO

*  メッセージ設定
  MOVE  2920       TO  XMAP-SEND-MAPL
  MOVE  XMAP-SENDT TO  XMAP-SEND
  MOVE  UAPNAME    TO  XMAP-SEND-UAP
  MOVE  TRNCODE3   TO  XMAP-SEND-TRN
  MOVE  REQ-TRAN   TO  XMAP-SEND-REQ
  MOVE  DSPTERM    TO  XMAP-SEND-TNAME
  MOVE  'MAPG01ND' TO  XMAP-SEND-PMAPNAME
  MOVE  MAPG01S    TO  XMAP-SEND-INLNG
  COMPUTE  XMAP-SEND-MAPL = MAPG01L - 4
  MOVE  MAPG01O    TO  XMAP-SEND-MAPO

*  送信
  COMPUTE  XMAP-SEND-LL2 = XMAP-SEND-LL2 + XMAP-SEND-MAPL
  COMPUTE  XMAP-SEND-LL  = XMAP-SEND-LL  + XMAP-SEND-MAPL
  SEND  MSG  FROM  XMAP-SEND  WITH  EMI.

  GOBACK.

(d)　受注伝票発行業務プログラム（仮想端末クローズ）

フローチャート

仮想端末をクローズする受注伝票発行業務プログラムのフローチャートを次に示します。

コーディング

仮想端末をクローズする受注伝票発行業務プログラムのコーディングを次に示します。

*********************************************************
*    受注伝票発行業務プログラム                        
*                                                      
*  （ディスプレイ仮想端末クローズ）                    
*********************************************************
IDENTIFICATION    DIVISION.
PROGRAM-ID.       UP20.

ENVIRONMENT       DIVISION.

DATA              DIVISION.
WORKING-STORAGE   SECTION.

*  送受信用メッセージテーブル
    COPY             X3TRNTBL.

*  トランザクションコード＆要求種別
    COPY             UPTBL.
*  通信節
COMMUNICATION  SECTION.
CD  MSG  FOR  I-O
MAP  NAME  IS  MAP-NAME
STATUS  KEY  IS  ERR-CODE.
*********************************************************
PROCEDURE          DIVISION.
*********************************************************

*  受信
*********************************************************
メッセージ受信         SECTION.
*********************************************************
 RECEIVE  MSG  FIRST  SEGMENT  INTO  XMAP-RECV.

*  業務開始
  MOVE  '00000'    TO  ERR-CODE
  MOVE  '%MMC1R  ' TO  MAP-NAME

*  メッセージ設定
  MOVE  2920       TO  XMAP-SEND-MAPL
  MOVE  XMAP-SENDT TO  XMAP-SEND
  MOVE  UAPNAME    TO  XMAP-SEND-UAP
  MOVE  TRNCODE8   TO  XMAP-SEND-TRN
  MOVE  REQ-CLOS   TO  XMAP-SEND-REQ
  MOVE  DSPTERM    TO  XMAP-SEND-TNAME
  MOVE  ALL X'00'  TO  XMAP-SEND-PMAPNAME
  MOVE  +0         TO  XMAP-SEND-INLNG

*  送信
*********************************************************
メッセージ送信         SECTION.
*********************************************************
  SEND  MSG  FROM  XMAP-SEND  WITH  EMI .

  GOBACK.

(e)　受注伝票発行業務プログラム（業務終了）

フローチャート

受注伝票発行業務プログラムの業務終了部分のフローチャートを次に示します。

コーディング

受注伝票発行業務プログラムの業務終了部分のフローチャートを次に示します。

*********************************************************
*    受注伝票発行業務プログラム
*                              
*  （業務終了）                                      
*********************************************************
IDENTIFICATION    DIVISION.
PROGRAM-ID.       UP21.

ENVIRONMENT       DIVISION.

DATA              DIVISION.
WORKING-STORAGE   SECTION.

*  送受信用メッセージテーブル
    COPY             X3TRNTBL.

*  トランザクションコード＆要求種別
    COPY             UPTBL.
*  通信節
COMMUNICATION  SECTION.
CD  MSG  FOR  I-O
    MAP  NAME  IS  MAP-NAME
    STATUS  KEY  IS  ERR-CODE.

*********************************************************
PROCEDURE          DIVISION.
*********************************************************
*  受信
*********************************************************
メッセージ受信         SECTION.
*********************************************************
 RECEIVE  MSG  FIRST  SEGMENT  INTO  XMAP-RECV.

*  業務開始
  MOVE  '00000'    TO  ERR-CODE
  MOVE  '%MMC1S  ' TO  MAP-NAME

*  メッセージ設定
  MOVE  2920       TO  XMAP-SEND-MAPL
  MOVE  XMAP-SENDT TO  XMAP-SEND
  MOVE  UAPNAME    TO  XMAP-SEND-UAP
  MOVE  REQ-END    TO  XMAP-SEND-REQ

*  送信
*********************************************************
メッセージ送信         SECTION.
*********************************************************
  MOVE  +14        TO  XMAP-SEND-LL2
  MOVE  XMAP-SEND-LL = XMAP-SEND-LL1 + XMAP-SEND-LL2 + 4
  SEND  MSG  FROM  XMAP-SEND  WITH  EMI.

  GOBACK.

(2)　PC上の画面管理プログラムの例

(a)　拡張ホストアクセスで2,920バイト以内のデータをやり取りする

標準的なオンライン処理を行う画面管理プログラムのサンプル「ONLNPROC.C」について説明します。

概要

XDM/DCCM3またはDCCM3を使用するメインフレーム上のAPと，PC上のXMAP3との間の論理マップデータのやり取りを中継します。なお，「ONLNPROC.C」で一度に転送できるデータは，2,920バイトまでです。

フローチャート

「ONLNPROC.C」のフローチャートを次に示します。

(b)　拡張ホストアクセスで2,920バイトを超えるデータをやり取りする

2,920バイトを超えるデータをやり取りするための画面管理プログラムのサンプル「ONLNPRC2.C」について説明します。

概要

XDM/DCCM3またはDCCM3を使用するメインフレーム上のAPと，PC上のXMAP3との間の論理マップデータのやり取りを中継します。なお，2,920バイトを超えるデータを転送するときは，継続入力命令または継続出力命令を使用して，2,920バイトずつに区切って転送し，最後に残った部分を入出力命令または出力命令で転送します。

フローチャート

「ONLNPRC2.C」のフローチャートを次に示します。

(c)　対話処理

対話処理を行うための画面管理プログラムのサンプル「TSSPROC.C」について説明します。

概要

TIOP3を使用するメインフレーム上のAPと，PC上のXMAP3との間の論理マップデータのやり取りを中継します。なお，「TSSPROC.C」で一度に転送できる論理マップのデータは2,920バイトまでです。

フローチャート

「TSSPROC.C」のフローチャートを次に示します。

(d)　TP1/ClientによるMPPの処理

TP1/Client/Pと連携する画面管理プログラムのサンプル「TPCLPROC.C」について説明します。

概要

XDM/DCCM3を使用するメインフレーム上のAPと，PC上のXMAP3との間の論理マップデータのやり取りを中継します。なお，TP1/Client/Pを使用する場合，一度に2GBまでのデータを転送できるので，継続入出力などの処理は必要ありません。

フローチャート

「TPCLPROC.C」のフローチャートを次に示します。

(e)　TP1/ClientによるBMPの処理

TP1/Client/Pと連携する画面管理プログラムのサンプル「TPCLPRC2.C」について説明します。

概要

DCCM3/TCPを使用するメインフレーム上のAPから，PC上のXMAP3への論理マップデータの送信を中継します。なお，TP1/Client/Pを使用する場合，PCからメインフレームには送達確認メッセージだけを送信します。

フローチャート

「TPCLPRC2.C」のフローチャートを次に示します。

(f)　COBOLによる画面管理プログラム

COBOLで作成した画面管理プログラムのサンプル「ONLNPRC2.CBL」について説明します。

概要

XDM/DCCM3またはDCCM3を使用するメインフレーム上のAPと，PC上のXMAP3との間の論理マップデータのやり取りを中継します。なお，2,920バイトを超えるデータを転送するときは，継続入力命令または継続出力命令を使用して，2,920バイトずつに区切って転送し，最後に残った部分を入出力命令または出力命令で転送します。

フローチャート

「ONLNPRC2.CBL」のフローチャートを次に示します。

付録B.5　CommuniNet Extensionを使用したメインフレーム・PC連携機能でのトラブルと対処方法

CommuniNet Extensionを使用したメインフレーム-PC分散機能で，XDM/DCCM3やDCCM3の画面管理プログラム，またはBCF/GCASTやBCF/GCASTが正常に動作しない場合，以下の手順に従って原因を調査してください。

＜この項の構成＞

(1)　PCの実行環境や開発環境，メインフレームのAPについて調査する

(2)　CommuniNet Extensionのメインフレームアクセスモニタ機能でログを採取する

(3)　XMAP3のロギング支援機能でログを採取する

(1)　PCの実行環境や開発環境，メインフレームのAPについて調査する

PCの実行環境や開発環境の設定誤りや，メインフレームのAPの単純なコーディング誤りなど障害原因となるものを，次の表を基にしてチェックしてください。

表B-9　障害原因チェックリスト

項番
調査対象
チェック項目
対処方法
備考

1
PCの実行環境の調査
画面管理プログラムを実行するPCにインストールされたCommuniNetのバージョンはCommuniNet Extensionが前提とするバージョンと一致しているか。
CommuniNetのヘルプ，またはマニュアルを参照してCommuniNet Extensionが前提とするCommuniNetをインストールしてください。
－

2
メインフレームのAPで指定したマップが以下のフォルダに存在しているか。

「表示・印刷セットアップ」の「アプリケーション1」タブの「マップ」情報で，「任意のフォルダ」を指定した場合，その指定フォルダ

画面管理プログラムが格納されたフォルダ（XDM/DCCM3，またはDCCM3の場合）

Path環境変数※1に指定されたフォルダ

左記のフォルダのどれかにマップをコピーしてください。

3
CommuniNetの端末名称が，画面管理プログラムで定義されたCommuniNetの端末名称（EXOpen関数の第2引数）と一致しているか。※2
CommuniNetの端末名称を画面管理プログラムで定義しているCommuniNetの端末名称と一致させてください。
DCCM

4
画面管理プログラムの存在するフォルダが，Path環境変数※1に指定しているか。
画面管理プログラムの存在するフォルダをPath環境変数に指定してください。※3
DCCM

5
PCの開発環境の調査
「ドローセットアップ」のターゲット環境が「メインフレーム－PC分散用の画面・帳票開発」になっているか。さらにその環境で，ユティリティを用いてマップを生成しているか。
「ドローセットアップ」のターゲット環境に「メインフレーム－PC分散用の画面・帳票開発」を指定してください。また，ユティリティの「マップ生成」でマップを再生成してください。
マップを再生成すると論理マップが変更される場合は，PCからメインフレームへ論理マップを転送し，メインフレームのAPを再コンパイルしてください。
－

6
画面管理プログラムをコンパイルするとき，ヘッダやlibを取り込んだCommuniNet Extensionのバージョンと，画面管理プログラムを実行するPCのCommuniNet Extensionのバージョンは一致しているか。
CommuniNet Extensionのバージョンを一致させてください。
DCCM

7
メインフレーム側のAPの処理が，2,920バイトを超える論理マップ長を前提としている場合，画面管理プログラムとしてXMAP3が提供しているサンプルONLNPRC2.C，またはONLNPRC2.CBLを使用しているか。
または，メッセージの分割を意識した画面管理プログラムを使用しているか。
ONLNPRC2.C，またはONLNPRC2.CBLを使用して画面管理プログラムを作成してください。
または，メッセージの分割を意識した画面管理プログラムを作成してください。
DCCM

8
メインフレームのAPの調査
メインフレームのAPで指定している通信論理マップ中の物理マップ名称（PMAPNAME）は，出力しようとしている画面・帳票の物理マップ名称と一致しているか。
メインフレームのAPで正しい物理マップ名称を指定してください。
－

9
メインフレームのAPで指定している通信論理マップの最大入力論理マップ長（INLNG）の値が，実際の入力論理マップ長以上になっているか。
メインフレームのAPで指定した通信論理マップの最大入力論理マップ長の値を，実際の入力論理マップ長以上にしてください。

10
メインフレームのAPで指定しているXMAP3の仮想端末名称（TNAME）は，「XMAP3インストールフォルダ¥etc¥X3MWHOST」で指定されているものと一致しているか。
メインフレームのAPを修正するか，または，「XMAP3インストールフォルダ¥etc¥X3MWHOST」を修正してください。

11
メインフレームAPをコンパイルしたときに使用した論理マップと，PCのマップ生成時に作成される論理マップは同じか。
PCからメインフレームに論理マップを転送して，メインフレームのAPを再コンパイルしてください。

12
メインフレームからPCへの送信メッセージのAP名と，PCにある画面管理プログラム名称（拡張子の'.EXE'の前の部分）が一致しているか。
AP名と画面管理プログラム名称を一致させてください。
DCCM

13
VOSKのOCSF/GCASTの場合，通信エンティティ名とXMAP3の仮想端末名称（TNAME）は一致しているか。
通信エンティティ名とXMAP3の仮想端末名称を一致させてください。
GCAST

（凡例）

－：なし。

注

備考欄に「DCCM」とあるチェック項目は，XDM/DCCM3，またはDCCM3を使用しているときにだけチェックする内容です。

また，「GCAST」とあるチェック項目は，BCF/GCAST，またはBCF/GCASTを使用しているときにだけチェックする内容です。

注※1

Path環境変数の値はそれぞれ次に示す個所を確認してください。

・Windows NT，Windows 2000，Windows XP，およびWindows Server 2003の場合は，コントロールパネルの「システム」の「環境」を確認してください。

・Windows 95，Windows 98，Windows Meの場合は，AUTOEXEC.BATの内容を確認してください。

注※2

XMAP3が提供しているサンプル上は「オンライン端末」となっています。

注※3

Windows 95，Windows 98，Windows Meの場合，Path環境変数の指定後，OSの再起動が必要です。

表B-9で示したチェック項目がすべて問題なしでも正常に動作しない場合，DCCM3の場合は「付録B.5(2)　CommuniNet Extensionのメインフレームアクセスモニタ機能でログを採取する」を，GCASTの場合は「付録B.5(3)　XMAP3のロギング支援機能でログを採取する」を参照してください。

(2)　CommuniNet Extensionのメインフレームアクセスモニタ機能でログを採取する

CommuniNet Extensionのメインフレームアクセスモニタ機能を利用し，障害に関するログを採取します。このログの内容を基にして，どこまで処理が進んでいるか調査してください。

CommuniNet Extensionのメインフレームアクセスモニタの利用方法
メインフレームアクセスモニタを起動後，［オプション］-［モニタする項目をリターン値で指定...］を選択し，「すべてのリターン値をモニタする」を指定してください。その後，［モニタ］-［端末の選択...］を選択し，CommuniNetの端末名称を指定してログを取得してください。

(a)　画面管理プログラムが起動されていない

プログラム動作時に以下の表示が出力されない場合，画面管理プログラムは起動されていません。

　　　Call : EXOpen_()

画面管理プログラムが起動されない原因として，最初に起動されるトランザクションコードが登録されていないなど，XDM/DCCM3やDCCM3のシステム定義の誤りが考えられます。このような場合は，XDM/DCCM3，またはDCCM3のシステム定義の以下のパラメタを見直してください。

UAP環境定義（UAPGROUP文，UAP文）

トランザクション定義（TRANDEFINE文，DEFAULT文，TRANGROUP文，TRAN文）

また，表B-9の項番3と項番10を再確認してください。

(b)　CommuniNet Extensionの関数でエラー

次に示す表示で，リターンコードにEXHA_RT_SUCCSESS（正常終了）以外の内容が表示されている場合，CommuniNet Extensionの関数でエラーとなっています。

正常終了の場合の例

Return(EXOpen) : EXHA_RT_SUCCSESS（正常終了）

エラーの場合の例

Return(EXOpen) : EXHA_RT_ABNORMAL（1：オンライン異常）

上記で，「Return(～)」の括弧内は関数名を示します。また，コロン（:）のあとに続く文字列はリターンコードを示します。

CommuniNet Extensionの関数でエラーになる場合，CommuniNetのセットアップが不正なため，メインフレームと接続できないなどの原因が考えられます。このような場合は，リターンコードの情報を基にCommuniNet Extensionのマニュアルやヘルプを参照してエラーを解決してください。

メインフレームアクセスモニタ機能を利用しても原因が特定できない場合は，「付録B.5(3)　XMAP3のロギング支援機能でログを採取する」を参照してください。

(3)　XMAP3のロギング支援機能でログを採取する

XMAP3のロギング支援機能を利用し，障害に関するログを採取します。このログの内容を基にして，どこまで処理が進んでいるか調査してください。

XMAP3のロギング支援の使用方法については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

(a)　XMAP3が実行されていない

ログビューアダイアログの「マップ毎情報」タブ，「仮想端末毎情報」タブ，および「個別情報」タブに何も表示されない場合，XMAP3は実行されていません。表B-9の項番9を再確認してください。XDM/DCCM3，またはDCCM3を使用している場合は，表B-9の項番3も再確認してください。

また，メインフレームのAPからOPEN要求以外の要求が，最初に送信されたことが考えられます。あわせて，メインフレームのAPも調査してください。

(b)　論理マップ長の不正などによるXMAP3のエラーが発生している

ログビューアダイアログの「個別情報」タブで，「要求種別」にOpenだけ表示され，「エラーログ」に何も表示されない場合は，論理マップ長の不正などによるXMAP3のエラーが発生していると考えられます。論理マップ長の不正がないかどうか，メインフレームのAPを調査してください。

また，表B-9の項番5を再確認してください。XDM/DCCM3，またはDCCM3を使用している場合は，表B-9の項番6も再確認してください。

(c)　エラーログにエラー情報が採取されている

ログビューアダイアログの「エラーログ」タブにエラーのログ情報が表示されている場合は，「詳細コード2」に表示されている詳細コードを基にエラー原因を調査してください。

(d)　論理マップの内容が不正

画面表示や帳票出力に不正があり，ログビューアダイアログの情報が次のような場合は，論理マップの内容が不正となっていることが考えられます。

ログビューアダイアログの「個別情報」タブで，「要求種別」にOpen，Send，Receive，Closeなどが表示されている。

ログビューアダイアログの「エラーログ」タブには何も表示されていない。

XDM/DCCM3，またはDCCM3を使用している場合，論理マップの内容が不正となる原因としては，メインフレームAPの論理マップの設定誤りが考えられます。また，ほかにも不正な発行シークエンス※が原因になっていることも考えられます。

これらの点に留意してメインフレームのAPを調査してください。

注※

不正な発行シークエンスの例として次のようなものがあります。

メインフレームのAPが，出力要求後，または入出力要求後に継続出力要求のメッセージを送信するような発行シークエンス

メインフレームのAPが，継続入力要求後に入出力要求メッセージを送信するような発行シークエンス

なお，論理マップの内容は，次の手順で参照できます。

論理マップの内容を参照する

出力論理マップを参照する
ログビューアダイアログの「個別情報」タブで，「要求種別」がSendのログ通番をダブルクリックします。

入力論理マップを参照する
ログビューアダイアログの「個別情報」タブで，Receiveのログ通番をダブルクリックします。

上記の操作を実行して表示されたウィンドウのうち，「XL（関連通番）.lg」のウィンドウを参照します。そのウィンドウ内で，(00000010)₁₆のロケーション以降に論理マップの内容が表示されます。

なお，メインフレーム-PC分散処理の場合，論理マップの内容はEBCDIK，またはKEISコードでデータが格納されています。しかし，「XL（関連通番）.lg」ウィンドウ内の右部分にある文字表示はJISコードを基にした表示となります。したがって，ウィンドウ内の文字表示部分では，正しい文字が表示されない点に注意してください。

付録C　メインフレーム資産の移行

＜この節の構成＞

付録C.1　インポート機能で変換できる画面・帳票の機能範囲

付録C.2　CUI画面からGUI画面への移行

付録C.3　インポート機能で変換できる記述文の機能範囲

付録C.4　インポートした記述文の内容とドローとの関係

付録C.1　インポート機能で変換できる画面・帳票の機能範囲

インポート機能でメインフレーム用のパネル定義文をPC上に取り込むとき，変換できる機能範囲を画面・帳票の種類別に説明します。

＜この項の構成＞

(1)　CUI画面のパネル定義文

(2)　シリアルプリンタ帳票のパネル定義文

(3)　ページプリンタ帳票のパネル定義文

(1)　CUI画面のパネル定義文

インポート機能でCUI画面を取り込むときに変換できる範囲を次の表に示します。

表C-1　CUI画面のパネル定義文の変換できる範囲

機能
文
オペランド※
変換
備考

パネル定義
PANEL
LANG
○
COBOL固定

NEXT
○
－

USAGE
×

PNLEND

○

記号パラメタ定義
CNTRL
PARM
×
－

MODCTL
PARM
×
ドローセットアップで指定

ATTR
PARM
×
－

MODATTR
PARM
×
ドローセットアップで指定

論理マップ定義
LOGSEG
REDEF
○
－

CLEAR
×
ドローセットアップで指定

CODERR
×

LITRL
×
－

GENRT
×

AREA
×

LOGSEND

○

パネル制御
CTLFLD
TYPE
○
－

LNG
×
ドローセットアップで指定

NAME
×

カーソル制御
CTLFLD
TYPE
×
ドローセットアップで指定
（10進指定はなし）

LNG
×

NAME
×

INC制御
CTLFLD
TYPE
×
ドローセットアップで指定

LNG
×

NAME
×

FILL
×

JUST
×

フィールド制御
CTLFLD
TYPE
○
－

LNG
×
ドローセットアップで指定

NAME
×
LOGFLD文のNAMEオペランドに指定した名称，またはLOGFLD文の名称に置き換えられる（入力，および入出力の場合は入力のLOGFLD文，出力専用の場合は出力のLOGFLD文）。

REPEAT
○
－

論理フレーム
LOGFRM
REPEAT
○
物理フレームがないものは変換できない

NAME
○

LOGFEND

○

主論理フィールド
LOGFLD
LNG
○
－

NAME
○

PIC
○

TYPE
○

CODE
○

JUST
○

FILL
○

VAL
○

REPEAT
○

LEVEL
○

従論理フィールド
LOGFLD
LNG
○
－

LEVEL＝2
○

NAME
○

PIC
×

REPEAT
○

物理マップ定義
PHSEG
DEV
○
「5425,D2」または「4451,D2」

PHPNL
×
－

CURS
○
行，列カーソル指定は破棄

INC
○
INC種別の指定がないものは「使用しない」になる。
ただし，イベント通知コードはドローセットアップで指定

CNTRL
○
－

MODCTL
×
ドローセットアップで指定

NULL
×

POS
○
－

SIZE
○

FORM
○
「SCRN」固定

DMYFLD
×
－

PHSEND

○

けい線
RLINE
POS
○
－

DIRECT
○

LNG
○

ASG
×

固定項目
CNSFLD
POS
○
－

VAL
○

LNG
○

ATTR
○
16進の指定は変換できない

ASG
×
－

予約項目
RSVFLD
POS
○
－

LNG
○

ATTR
○

ASG
×

物理フレーム
PHFRM
POS
○
－

SIZE
○

LOGFRM
○

LAY
○

PHFEND

○

可変項目
VARFLD
POS
○
隠しフィールド（DUMMY）は変換できない

LOGFLD
○
－

MCR
○

CTLFLD
○

LNG
○

ATTR
○
16進の指定は変換できない

MODATTR
×
ドローセットアップで指定

PEN
×
－

VAL
×

LAY
○

ASG
×

（凡例）

○：インポート機能で変換できる。

×：インポート機能で変換できない。ドローセットアップでの指定はシステム共通となる。

－：なし。

注※

オペランドがない文の場合，この欄は空白です。

(2)　シリアルプリンタ帳票のパネル定義文

インポート機能でシリアルプリンタ帳票を取り込むときに変換できる範囲を次の表に示します。

表C-2　シリアルプリンタ帳票のパネル定義文の変換できる範囲

機能 | 文 | オペランド※ | 変換 | 備考
パネル定義 | PANEL | LANG | ○ | COBOL固定
NEXT | × | －
USAGE | ×
PNLEND |  | ○
記号パラメタ定義 | CNTRL | PARM | × | ドローセットアップで指定
ATTR | PARM | × | －
論理マップ定義 | LOGSEG | REDEF | ○ | －
LITRL | × | ドローセットアップで指定
GENRT | ×
AREA | × | －
LOGSEND |  | ○
論理フレーム | LOGFRM | REPEAT | ○ | 物理フレームがないものは変換できない
NAME | ○
LOGFEND |  | ○
主論理フィールド | LOGFLD | LNG | ○ | －
NAME | ○
PIC | ○
TYPE | ○
CODE | ○
JUST | ○
FILL | ○
VAL | ○
REPEAT | ○
LEVEL | ○
従論理フィールド | LOGFLD | LNG | ○ | －
LEVEL＝2 | ○
NAME | ○
PIC | ×
REPEAT | ○
物理マップ定義 | PHSEG | DEV | ○ | 5344に固定
PHPNL | × | －
CNTRL | ○
EJECT | ○
POS | ○
SIZE | ○
LP | ×
COPIES | ×
CSCF | ○ | 指定しなかった場合，基準字間値を「0I」とする
PHSEND |  | ○ | －
けい線 | RLINE | POS | ○ | －
DIRECT | ○
LNG | ○
STYLE | ×
ボックスけい線 | BOX | POS | × | －
SIZE | ×
CORNER | ×
STYLE | ×
網掛け | TONE | POS | × | －
SIZE | ×
ATTR | ×
CORNER | ×
固定フィールド | CNSFLD | POS | ○ | －
VAL | ○
LNG | ○
ATTR | ○ | 16進の指定は変換できない
予約フィールド | RSVFLD | POS | ○ | －
LNG | ○
ATTR | ○
物理フレーム | PHFRM | POS | ○ | －
SIZE | ○
LOGFRM | ○
LAY | ○
PHFEND |  | ○
可変フィールド | VARFLD | POS | ○ | －
LOGFLD | ○
LNG | ○
ATTR | ○ | 16進の指定は変換できない
VAL | × | －
LAY | ○
文書領域 | PHDCM | POS | × | －
SIZE | ×
PHDEND |  | ×

（凡例）

○：インポート機能で変換できる。

×：インポート機能で変換できない。ドローセットアップでの指定はシステム共通となる。

－：なし。

注※

オペランドがない文の場合，この欄は空白です。

(3)　ページプリンタ帳票のパネル定義文

インポート機能でページプリンタ帳票を取り込むときに変換できる範囲を次の表に示します。

表C-3　ページプリンタ帳票のパネル定義文の変換できる範囲

機能 | 文 | オペランド※ | 変換 | 備考
パネル定義 | PANEL | LANG | ○ | COBOL固定
NEXT | × | －
USAGE | ×
PNLEND |  | ○
記号パラメタ定義 | CNTRL | PARM | × | ドローセットアップで指定
ATTR | PARM | × | －
論理マップ定義 | LOGSEG | REDEF | ○ | －
LITRL | ×
GENRT | ×
AREA | ×
LOGSEND |  | ○
印刷部数制御 | CTLFLD | TYPE | ○ | －
LNG | × | ドローセットアップで指定
NAME | ×
論理フレーム | LOGFRM | REPEAT | ○ | 物理フレームがないものは変換できない
NAME | ○
LOGFEND |  | ○
主論理フィールド | LOGFLD | LNG | ○ | －
NAME | ○
PIC | ○
TYPE | ○
CODE | ○
JUST | ○
FILL | ○
VAL | ○
REPEAT | ○
LEVEL | ○ | 「1」固定
従論理フィールド | LOGFLD | LNG | ○ | －
LEVEL＝2 | ○
NAME | ○
PIC | ○
REPEAT | ○
物理マップ定義 | PHSEG | DEV | ○ | 2311に固定
PHPNL | × | －
CNTRL | ○ | 「FULL」指定は変換されない
POS | ○ | －
SIZE | ○
LP | ○
COPIES | ○
MARGIN | ○
FORM | ○
CSCF | ○ | 指定しなかった場合，基準字間値を「0I」とする
PHSEND |  | ○ | －
けい線 | RLINE | POS | ○ | －
DIRECT | ○
LNG | ○
STYLE | ○
ボックスけい線 | BOX | POS | ○ | －
SIZE | ○
CORNER | ○
STYLE | ○
網掛け | TONE | POS | ○ | －
SIZE | ○
ATTR | ○
CORNER | ○
固定フィールド | CNSFLD | POS | ○ | －
VAL | ○
LNG | ○
ATTR | ○ | 16進は変換できない
予約フィールド | RSVFLD | POS | ○ | －
LNG | ○
ATTR | ○
物理フレーム | PHFRM | POS | ○ | －
SIZE | ○
LOGFRM | ○
LAY | ○
PHFEND |  | ○
可変フィールド | VARFLD | POS | ○ | －
LOGFLD | ○
LNG | ○
ATTR | ○ | 16進は変換できない
VAL | × | －
LAY | ○
文書領域 | PHDCM | POS | × | －
SIZE | ×
PHDEND |  | ×
書式 | OVERLAY | NAME | × | －
GRAPHIC |  | ×
GRPHEND |  | ×
AREA | POS | ×
SIZE | ×
REM | ×

（凡例）

○：インポート機能で変換できる。

×：インポート機能で変換できない。ドローセットアップでの指定はシステム共通となる。

－：なし。

注※

オペランドがない文の場合，この欄は空白です。

付録C.2　CUI画面からGUI画面への移行

メインフレーム上での画面は文字ベースのCUIとして運用されますが，分散処理で画面の入出力部分をPCに移行する際に，GUIに変更できます。

CUIからGUIへの移行には，次の3とおりの方法があります。

CUI画面のオブジェクトをGUI画面内のフィールドボックスに展開する

CUI画面のオブジェクトをそのままGUI画面の該当するオブジェクトに置き換える

GUI特有の機能を利用した画面に変更する

CUI画面とGUI画面とでは物理マップ名の形式が異なるので，どちらの方法を用いる場合も，COBOLソースプログラム内の物理マップ名の変更が必要になります。CUI画面の物理マップ名の末尾にあるID「NC」を，GUI画面では「ND」に変更してください。

（例）

マップ名が「MAP001」の場合

CUIでの「MAP001NC」　→　GUIでは「MAP001ND」

＜この項の構成＞

(1)　フィールドボックスへの移行

(2)　画面操作を変更せずにGUIオブジェクトに置き換える

(3)　GUI特有の機能を利用する

(1)　フィールドボックスへの移行

CUI画面を単純にGUI画面のフィールドボックスに展開できます。この場合，画面操作は移行前のCUI画面と同じで，画面表示も表示色とウィンドウのタイトルバーを除けば同じです。

CUI画面をGUI画面のフィールドボックスに展開するために，コンバート機能を利用できます。コンバート機能については，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

(2)　画面操作を変更せずにGUIオブジェクトに置き換える

(a)　画面定義の変更点

CUI画面を，操作を変えずにそのままGUI画面に変更する場合は，CUI画面上の項目をGUI画面定義に対応したものに置き換えます。

CUIからGUIへの変更項目を次の表に示します。

表C-4　CUIからGUIへの置き換え項目

CUI画面定義でのオブジェクト | GUI画面定義でのオブジェクト
タイトル（固定項目） | タイトルバー
けい線による表 | フィールドボックス
固定項目 | 固定テキスト
出力項目 | 出力テキスト
入力項目 | 入力テキスト
予約項目 | 予約テキスト
入出力項目 | 入出力テキスト
PFキーガイダンス | プッシュボタンまたはメニュー
けい線 | セパレータ※

注※

表のような形式の場合は，フィールドボックスに置き換えてください。

(b)　画面操作を変更せずにGUI特有の機能を追加する

画面で，次に示すような操作がある場合，画面操作を変更せずにGUI機能を付け加えることができます。

PFキーを押すと，別画面が表示される場合

使用するPFキーに対し，それぞれプッシュボタンまたはメニューバー上の選択項目を割り当てると，プッシュボタンの操作でPFキー操作と同様の処理ができます。

あるキー操作に対して，ヘルプ画面を別画面として表示している場合

該当するヘルプ画面を二次ウィンドウとして表示できます。

選択肢の数が限られているデータ（性別など）を入力する場合

入力の補助機能として，入力テキストに対してポップアップメニューを付加できます。ただし，自動的にポップアップ表示されるように定義すると，CUI画面とはキー操作が変わってしまいます。操作を変更しないためには，メニュー選択やプッシュボタン選択で表示されるように定義してください。

(c)　移行するときの注意事項

CUI画面の項目をGUI画面の対応する項目に置き換えた場合，GUIでの項目の方が画面上に占める領域は大きくなります。特に入力テキストには必ず枠線が付加されるので，入力テキストを上下に隣接させることができません。ウィンドウサイズを大きくするか，CUI項目としてフィールドボックスに移行してください。

フィールドボックスの入力可変項目では，保護状態にすると，その項目にはカーソルが移動しません。項目が保護状態のときのカーソル移動順序を前提にした業務では，従来とは操作が変化します。

(3)　GUI特有の機能を利用する

GUI特有の機能を利用すると，マウスやアクセスキー入力によって，キーボードからの入力を少なくし，入力ミスを減らすことができます。

GUI特有の機能を利用した変更の例を次の表に示します。

表C-5　GUIの機能を利用した変更の例

CUI画面での入力項目の例 | GUIへの変更例
一つだけ選ぶ項目で，選択肢が数個のもの | ラジオボタン，コンボボックス
一つだけ選ぶ項目で，選択肢が10個を超えるもの | 単一選択リストボックス
複数を選ぶ項目で，選択肢が数個のもの | チェックボタン
複数を選ぶ項目で，選択肢が10個を超えるもの | 複数選択リストボックス

CUI画面では入力項目が1画面内に収まらずに継続入力となっていた項目も，スクロールバーが付いたフィールドボックスを利用して1画面に収めることができます。

さらに，グループボックスを利用すれば，画面上でのフォーカス位置移動の順序を制御できます。

また，複数のウィンドウを同時に表示できるので，必要な情報を参照しながら作業したり，データを見やすくしたりできます。

付録C.3　インポート機能で変換できる記述文の機能範囲

メインフレームの記述文からインポート機能を使ってXMAP3の書式定義ファイルに変換できる範囲，および書式定義ファイルからエクスポート機能を使って生成できる記述文の範囲を次の表に示します。変換については，「18.4　ドローによる編集」を参照してください。

表C-6　変換できる記述文

オペレーション | インポート | エクスポート | 備考
FORMS | ○ | ○ | －
FRMEND | ○ | ○ | －
SECTOR | ● | × | －
OPTION | ● | ○※ | ※：ターゲットがメインフレームの場合
SEGMENT | ○ | × | セグメント数は1個
SGEND | ○ | × | －
INCLUDE | ○ | × | －
RLINE | ○ | ○ | －
ELINE | ○ | ○ | －
CIRCLE | ○ | ○ | －
ARC | ○ | ○ | －
CHAR | ○ | ○ | －
NXCODE | ○※ | × | ※：NCODEになる
NCODE | ○ | ○ | －
NNCODE | × | × | －
NACODE | × | × | －
NKCODE | × | × | －
NHCODE | × | × | －
CHSIZE | ○※ | × | ※：文字サイズは無視する
GRAPHIC | ○ | ○ | －
DOT | ○ | ○ | －
BOX | ○ | ○ | －
LAY | ○※ | × | ※：ベタ（CHAR）になる
ADJUST | ○ | ×※ | ※：ベタ（CHAR）になる
CONST | × | × | －
ECODE | ○ | ○ | －
CHARC | × | × | －
LINE（移行用記述文） | ○ | × | －
CODE（移行用記述文） | ○ | × | －
コメント | ● | × | －
END※ | ● | × | ※：VOS1だけ指定可能
INCLUDE文とSEGMENT文のネスト | × | × | －
部品ファイル | ○※ | × | ※：部品でなくなる
ユーザ定義拡張記述文 | × | × | －
マクロ拡張記述文※ | × | × | ※：VOS3だけ指定可能
MAINT用制御文（CATALS文）※ | × | × | ※：VOS1だけ指定可能
セグメント定義開始文（MACRO文）※ | × | × | ※：VOS1だけ指定可能
セグメント定義終了文（MEND文／BKEND文）※ | × | × | ※：VOS1だけ指定可能

（凡例）

インポート機能

　○：有効。

　●：内容を破棄。

　×：エラー。

エクスポート機能

　○：生成する。

　×：生成しない。

備考

　－：なし。

表C-7　変換できる記述文（オペランド）

オペレーション
オペランド
インポート
エクスポート
備考

FORMS
書式名1
○
○
－

ます目大
○
○

X長
○
○

Y長
○
○

LIST
●
×

書式名2
○※
○※
※：書式名2を優先する
エクスポートはVOS3用だけ可能

FRMEND
名前
●
×
－

SECTOR
名前
●
×
－

X長
●
×

X長
●
×

X長
●
×

X長
●
×

Y長
●
×

OPTION
名前
●
×
－

DEPTH
●
×

RG
●
○※
※：5ポイント以外のものを展開

SEGMENT
名前
○
×
－

ます目大
○
×

X長
○
×

Y長
○
×

SGEND
名前
●
×

セグメント名
○
×

INCLUDE
名前
●
×

X位置
○
×

Y位置
○
×

セグメント名
○
×

RLINE
名前
●
×

開始X位置
○
○

開始Y位置
○
○

長さ
○
○

線種
○※
○
※：集約される

線の太さ
○※
○
※：集約される

繰り返し間隔
○※
×
※：回数分に分割される

繰り返し回数
○※
×
※：回数分に分割される

繰り返し向き
○※
×
※：回数分に分割される

ELINE
名前
●
×
－

開始X位置
○
○

開始Y位置
○
○

終了X位置
○
○

終了Y位置
○
○

線種
○※
○
※：集約される

線の太さ
○※
○
※：集約される

繰り返し間隔
○※
×
※：回数分に分割される

繰り返し回数
○※
×
※：回数分に分割される

繰り返し向き
○※
×
※：回数分に分割される

CIRCLE
名前
●
×
－

X位置
○
○

Y位置
○
○

半径
○
○

線種
○※
○
※：集約される

線の太さ
○※
×
※：集約される

繰り返し間隔
○※
×
※：回数分に分割される

繰り返し回数
○※
×
※：回数分に分割される

繰り返し向き
○※
×
※：回数分に分割される

ARC
名前
●
×
－

X位置
○
○

Y位置
○
○

半径
○
○

角度
○※
○
※：30度の倍数に集約される

線種
○※
○
※：集約される

線の太さ
○※
×
※：集約される

繰り返し間隔
○※
×
※：回数分に分割される

繰り返し回数
○※
×
※：回数分に分割される

繰り返し向き
○※
×
※：回数分に分割される

CHAR
名前
●
×
－

X位置
○
○

Y位置
○
○

文字属性
○
○

文字間隔
○
○

文字数
○
○

文字の並び
○
×

文字データ名
○
○※
※：XMAP3が自動生成する

繰り返し間隔
○※
×
※：回数分に分割される

繰り返し回数
○※
×
※：回数分に分割される

繰り返し向き
○※
×
※：回数分に分割される

NXCODE
名前
○
×
－

文字符号，…
○
×
KEISコードだけ
EBCDIKコードは無視

NCODE
名前
○
○※
※：XMAP3が自動生成する

漢字文字列
○
○
－

NNCODE
名前
×
×
－

文字列
×
×

順序番号
×
×

NACODE
名前
×
×
－

文字列
×
×

NKCODE
名前
×
×
－

文字列
×
×

NHCODE
名前
×
×
－

文字列
×
×

CHSIZE
名前
○
×
－

文字属性1
○※
×
※：外付けの情報にこの文字属性が設定されていない場合は，標準属性で14ポイントとして扱う
また，設定されている場合はその属性に従う

文字属性2
○
×
－

文字サイズ
●※
×
※：無視する

種別
●※
×
※：無視する

GRAPHIC
名前
●
×
－

X位置
○
○

Y位置
○
○

X長
○
○

Y長
○
○

網掛け種別
○※
○
※：集約される

ドットデータ名
○
○※
※：XMAP3が自動生成する

繰り返し間隔
○※
×
※：回数分に分割される

繰り返し回数
○※
×
※：回数分に分割される

繰り返し向き
○※
×
※：回数分に分割される

図形変換種別
○
×
－

コーナ形式
○
○

コーナ半径
○※
○
※：集約される

DOT
名前
○
○※
※：XMAP3が自動生成する

X位置
○
○
－

Y位置
○
○

ドット列
○
○

BOX
名前
●
×
－

X位置
○
○

Y位置
○
○

X長
○
○

Y長
○
○

線種
○
○

線の太さ
○※
○
※：集約される

繰り返し間隔
○※
○
※：集約される

繰り返し回数
○※
×
※：回数分に分割される

繰り返し向き
○※
×
※：回数分に分割される

コーナ形式
○
○
－

コーナ半径
○※
○
※：集約される

LAY
名前
●
×
－

X位置
○
×

Y位置
○
×

X長
○
×

Y長
○
×

文字属性
○
×

横ボディサイズ
○
×

縦ボディサイズ
○
×

文字数
○
×

文字の並び
○
×

文字データ名
○
×

繰り返し間隔
○※
×
※：回数分に分割される

繰り返し回数
○※
×
※：回数分に分割される

繰り返し向き
○※
×
※：回数分に分割される

ADJUST
名前
●
×
－

X位置
○
×

Y位置
○
×

X長
○
×

Y長
○
×

文字属性
○
×

横ボディサイズ
○
×

縦ボディサイズ
○
×

文字数
○
×

文字の並び
○
×

文字データ名
○
×

繰り返し間隔
○※
×
※：回数分に分割される

繰り返し回数
○※
×
※：回数分に分割される

繰り返し向き
○※
×
※：回数分に分割される

CONST
名前
×
×
－

カナ漢字変換種別
×
×

文字列
×
×

順序番号
×
×

ECODE
名前
○
○※
※：XMAP3が自動生成する

半角文字列
○
○
－

CHARC
名前
×
×
－

X位置
×
×

Y位置
×
×

文字属性
×
×

文字間隔
×
×

文字数
×
×

文字の並び
×
×

変換種別
×
×

文字列
×
×

順序番号
×
×

繰り返し間隔
×
×

繰り返し回数
×
×

繰り返し向き
×
×

LINE（移行用記述文）
名前
●
×
－

開始X位置
○
×

開始Y位置
○
×

長さ
○
×

線種
○※
×
※：集約される

線の太さ
○※
×
※：集約される

繰り返し間隔
○※
×
※：回数分に分割される

繰り返し回数
○※
×
※：回数分に分割される

繰り返し向き
○※
×
※：回数分に分割される

CODE（移行用記述文）
名前
○
×
－

文字符号
○
×

INCLUDE文とSEGMENT文のネスト
MAX16
×
×
－

（凡例）

インポート機能

○：有効。

●：内容を破棄。

×：エラー。

エクスポート機能

○：生成する。

×：生成しない。

備考

－：なし。

付録C.4　インポートした記述文の内容とドローとの関係

インポート機能で記述文ファイルを変換したときに，それぞれの記述文の内容が，ドローにどのように反映されるかを説明します。また，変換規則については，「18.4　ドローによる編集」を参照してください。

＜この項の構成＞

(1)　書式属性ダイアログ

(2)　固定フィールドダイアログ

(3)　縦けい線ダイアログ

(4)　横けい線ダイアログ

(5)　斜めけい線ダイアログ

(6)　矩形ダイアログ

(7)　円ダイアログ

(8)　円弧ダイアログ

(9)　網掛けダイアログ

(10)　固定グラフィックダイアログ

(11)　記述文の内容とドロー上に展開される設定値

(1)　書式属性ダイアログ

FORMS文の設定内容が反映されます。

項番 | 記述文での設定値 | ドローでの格納場所 | ドローでの設定値
1 | － | 上マージン | 「5mm」
2 | － | 左マージン | 「5mm」
3 | Y長 | ます（行） | 指定内容による
4 | X長 | ます（列） | 指定内容による
5 | － | 単位の選択 | 「ドット」
6 | X・Y長 | 給紙サイズ | 指定内容による
7 | － | コメントの記述 | －
8 | － | 印刷ドキュメント名 | －
9 | － | ます目設定 | 「自由な設定」
10 | ます目（縦サイズ） | 行の間隔 | 指定内容による
11 | ます目（横サイズ） | 文字の間隔 | 指定内容による
12 | ます目（横サイズ） | 文字サイズ | 指定内容による

（凡例）

－：該当する設定値がない。

「　」：ドローのダイアログで表示される設定内容を表す。

(2)　固定フィールドダイアログ

CHAR文，LAY文，およびADJUST文の設定内容が反映されます。

項番 | 記述文での設定値 | ドローでの格納場所 | ドローでの設定値
1 | 文字属性 | 文字の拡大 | 指定内容による
2 | 文字属性 | 文字の書体 | 指定内容による
3 | 文字属性 | 文字サイズ | 指定内容による
4 | － | 文字の強調 | 「標準」
5 | 文字間隔／ボディサイズ | 文字の間隔 | 指定内容による
6 | － | 網掛け | 「なし」
7 | － | テキスト | 指定内容による
8 | － | テキスト揃え | 「左」

（凡例）

－：該当する設定値がない。

「　」：ドローのダイアログで表示される設定内容を表す。

(3)　縦けい線ダイアログ

RLINE（LINE）文，および縦線の場合のELINE文の設定内容が反映されます。

項番 | 記述文での設定値 | ドローでの格納場所 | ドローでの設定値 | 備考
1 | 線種別 | 線の種類 | 指定内容による | 付録C.4(11)(a)を参照
2 | 線の太さ | 線の太さ | 指定内容による | 付録C.4(11)(b)を参照
3 | － | 線の位置 | 「左」 | なし
4 | 線の向き（V） | － | －

（凡例）

－：該当する設定値がない。

「　」：ドローのダイアログで表示される設定内容を表す。

(4)　横けい線ダイアログ

RLINE（LINE）文，および横線の場合のELINE文の設定内容が反映されます。

項番 | 記述文での設定値 | ドローでの格納場所 | ドローでの設定値 | 備考
1 | 線種別 | 線の種類 | 指定内容による | 付録C.4(11)(a)を参照
2 | 線の太さ | 線の太さ | 指定内容による | 付録C.4(11)(b)を参照
3 | － | 線の位置 | 「下」 | なし
4 | 線の向き（H） | － | －

（凡例）

－：該当する設定値がない。

「　」：ドローのダイアログで表示される設定内容を表す。

(5)　斜めけい線ダイアログ

ELINE文の設定内容が反映されます。

項番 | 記述文での設定値 | ドローでの格納場所 | ドローでの設定値 | 備考
1 | 指定位置 | 向き | 指定内容による | －
2 | 線種別 | 線の種類 | 指定内容による | 付録C.4(11)(a)を参照
3 | 線の太さ | 線の太さ | 指定内容による | 付録C.4(11)(b)を参照

（凡例）

－：なし。

(6)　矩形ダイアログ

BOX文の設定内容が反映されます。

項番 | 記述文での設定値 | ドローでの格納場所 | ドローでの設定値 | 備考
1 | コーナ形式 | 角の丸め | 指定内容による | 付録C.4(11)(c)を参照
2 | － | 種別 | 「枠だけ」 | なし
3 | コーナ半径 | 丸めの半径 | 指定内容による | 付録C.4(11)(d)を参照
4 | 線種別 | 線の種類 | 指定内容による | 付録C.4(11)(a)を参照
5 | コーナ形式 | 丸めの場所 | 指定内容による | 付録C.4(11)(c)を参照
6 | 線の太さ | 線の太さ | 指定内容による | 付録C.4(11)(b)を参照

（凡例）

－：該当する設定値がない。

「　」：ドローのダイアログで表示される設定内容を表す。

(7)　円ダイアログ

CIRCLE文の設定内容が反映されます。

項番 | 記述文での設定値 | ドローでの格納場所 | ドローでの設定値 | 備考
1 | 線種別 | 線の種類 | 指定内容による | 付録C.4(11)(a)を参照
2 | 線の太さ | 線の太さ | 指定内容による | 付録C.4(11)(b)を参照
3 | － | 網掛け | 「なし」 | なし

（凡例）

－：該当する設定値がない。

「　」：ドローのダイアログで表示される設定内容を表す。

(8)　円弧ダイアログ

ARC文の設定内容が反映されます。

項番 | 記述文での設定値 | ドローでの格納場所 | ドローでの設定値 | 備考
1 | 角度 | 角度 | 指定内容による | 付録C.4(11)(e)を参照
2 | 線種別 | 線の種類 | 指定内容による | 付録C.4(11)(a)を参照
3 | 線の太さ | 線の太さ | 指定内容による | 付録C.4(11)(b)を参照

(9)　網掛けダイアログ

GRAPHIC文の設定内容が反映されます。

項番 | 記述文での設定値 | ドローでの格納場所 | ドローでの設定値 | 備考
1 | コーナ形式 | 角の丸め | 指定内容による | 付録C.4(11)(c)を参照
2 | － | 種別 | 「枠だけ」 | なし
3 | コーナ半径 | 丸めの半径 | 指定内容による | 付録C.4(11)(d)を参照
4 | ドットパターン | 網掛け | 指定内容による | 付録C.4(11)(f)を参照
5 | コーナ形式 | 丸めの場所 | 指定内容による | 付録C.4(11)(c)を参照
6 | 線種別 | 線の種類 | 指定内容による | 付録C.4(11)(a)を参照
7 | 線の太さ | 線の太さ | 指定内容による | 付録C.4(11)(b)を参照

（凡例）

－：該当する設定値がない。

「　」：ドローのダイアログで表示される設定内容を表す。

(10)　固定グラフィックダイアログ

網掛け以外のDOT文の設定内容が反映されます。

項番 | 記述文での設定値 | ドローでの格納場所 | ドローでの設定値 | 備考
1 | ドット列 | 領域に合わせて表示する | 指定なし | 指定された大きさで展開
2 | － | 枠付き | 「なし」 | なし

（凡例）

－：該当する設定値がない。

「　」：ドローのダイアログで表示される設定内容を表す。

(11)　記述文の内容とドロー上に展開される設定値

インポート機能で記述文ファイルを変換したときに，記述文の内容によってドローのダイアログの項目値がどのように設定されるかを次に示します。

(a)　線種別

線種別は，次に示す規則に従って決定します。

記述文での指定 | ドローで展開される値
1 | 実線
3，5 | 破線
6，7 | 一点鎖線
8 | 二点鎖線
2，4，9 | 点線

注

ドロー上の見え方と実際の印刷結果は異なります。

(b)　線の太さ

線の太さは，次に示す規則に従って決定します。

記述文での指定 | ドローで展開される値
1，2 | 細
3，4 | 中
5，6 | 太
7以上 | 極太

(c)　角の丸め／丸めの場所

角の丸め／丸めの場所は，次に示す規則に従い決定します。

記述文での指定 | ドローで展開される値
ARC | 全て丸める／不活性
LT | 任意の位置／左上
RT | 任意の位置／右上
LD | 任意の位置／左下
RD | 任意の位置／右下
指定なし | 丸めなし／不活性

注

ドロー上の見え方と実際の印刷結果は異なります。

(d)　丸め半径

丸め半径は，次に示す規則に従い決定します。

記述文での指定 | ドローで展開される値
1・2 | 小
3 | 標準
4 | 大

注

ドロー上の見え方と実際の印刷結果は異なります。

(e)　角度

角度は，次に示す規則に従い決定します。

記述文での指定 | ドローで展開される値
30度 | 小
60度 | 中
90度 | 大

(f)　網掛け種別

網掛け種別は次に示す規則に従い決定します。

記述文での指定
ドローで展開される値
備考

8

薄い網掛け
8×8に2ドット

6

標準網掛け
6×6に2ドット

4

濃い網掛け
4×4に2ドット

1，RDWN
RDWN  DOT (,0),(,0), '*'
RDWN  DOT (,1),(,1), '*'
RDWN  DOT (,2),(,2), '*'
RDWN  DOT (,3),(,3), '*'
RDWN  DOT (,4),(,4), '*'
RDWN  DOT (,5),(,5), '*'
RDWN  DOT (,6),(,6), '*'
RDWN  DOT (,7),(,7), '*'

標準右下
[図データ]　

1，RUP
RUP  DOT (,7),(,0), '*'
RUP  DOT (,6),(,1), '*'
RUP  DOT (,5),(,2), '*'
RUP  DOT (,4),(,3), '*'
RUP  DOT (,3),(,4), '*'
RUP  DOT (,2),(,5), '*'
RUP  DOT (,1),(,6), '*'
RUP  DOT (,0),(,7), '*'

標準左下
[図データ]　

1，MESH
MESH  DOT (,0),(,0), '*'
MESH  DOT (,1),(,1), '*     *'
MESH  DOT (,2),(,2), '*   *'
MESH  DOT (,3),(,3), '* *'
MESH  DOT (,4),(,4), '*'
MESH  DOT (,3),(,5), '* *'
MESH  DOT (,2),(,6), '*   *'
MESH  DOT (,1),(,7), '*     *'

標準格子
[図データ]　

1，HRZN
HRZN  DOT (,0),(,3), '********'

標準横線
[図データ]　

1，VERT
VERT  DOT (,3),(,0), '*'
VERT  DOT (,3),(,1), '*'
VERT  DOT (,3),(,2), '*'
VERT  DOT (,3),(,3), '*'
VERT  DOT (,3),(,4), '*'
VERT  DOT (,3),(,5), '*'
VERT  DOT (,3),(,6), '*'
VERT  DOT (,3),(,7), '*'

標準縦線
[図データ]　

注

ドロー上の見え方と実際の印刷結果は異なります。

付録D　メインフレーム資産の開発

メインフレーム用の画面・帳票がサポートしている機能の中で，XMAP3がサポートする範囲と，ドローで定義するときに有効となる機能の範囲について説明します。

＜この節の構成＞

付録D.1　エクスポート機能で変換できるCUI画面の機能範囲

付録D.2　エクスポート機能で変換できるけい線帳票の機能範囲

付録D.3　エクスポート機能で変換できる網掛け帳票の機能範囲

付録D.4　エクスポート機能で変換できるタイプ3書式の機能範囲

付録D.5　エクスポート機能で変換できるタイプ1/2/R書式の機能範囲

付録D.1　エクスポート機能で変換できるCUI画面の機能範囲

＜この項の構成＞

(1)　CUI画面で生成できるパネル定義文の範囲

(2)　CUI画面から生成されるパネル定義文とドローセットアップの関係

(3)　生成するパネル定義文とドローの関係（オブジェクト）

(4)　生成するパネル定義文とドローの関係（属性）

(1)　CUI画面で生成できるパネル定義文の範囲

(a)　パネル定義文

XMAP3のエクスポート機能で生成できるパネル定義文の範囲を次の表に示します。

表D-1　生成できるパネル定義文

機能 | 文 | 生成 | 備考
パネル定義 | PANEL | ○ | －
PNLEND | ○ | －
記号パラメタ定義 | CNTRL | × | －
MODCTL | ○ | －
ATTR | × | －
MODATTR | × | －
論理マップ定義 | LOGSEG | ○ | －
LOGSEND | ○ | －
パネル制御 | CTLFLD | ○ | －
カーソル制御 | CTLFLD | ○ | －
INC制御 | CTLFLD | ○ | －
フィールド制御 | CTLFLD | ○ | －
論理フレーム | LOGFRM | ○ | －
LOGFEND | ○ | －
主論理フィールド | LOGFLD | ○ | －
従論理フィールド | LOGFLD | ○ | －
物理マップ定義 | PHSEG | ○ | －
PHSEND | ○ | －
けい線 | RLINE | ○ | －
固定項目 | CNSFLD | ○ | －
予約項目 | RSVFLD | ○ | －
物理フレーム | PHFRM | ○ | －
PHFEND | ○ | －
可変項目 | VARFLD | ○ | －

（凡例）

○：生成する。

×：生成しない。

－：なし。

(b)　オペランド

XMAP3のエクスポート機能で生成できるパネル定義文について，生成できるオペランドの範囲を次の表に示します。

表D-2　生成できるオペランドの範囲（パネル定義文）

機能 | 文 | オペランド | 生成 | 備考
パネル定義 | PANEL | マップ名 | ○ | －
LANG | ○ | C（COBOL）固定
USAGE | ○ | －
PNLEND | 名前 | ×
記号パラメタ定義 | MODCTL | 名前 | ○ | －
PARM | ○
論理マップ定義 | LOGSEG | 論理セグメント名 | ○ | －
BASE | ×
REDEF | ○
LITRL | ○
GENRT | ○
AREA | ×
LOGSEND | 名前 | ×
パネル制御 | CTLFLD | 名前 | ○ | －
TYPE | ○
LNG | ○
NAME | ○
COMM | ×
カーソル制御 | CTLFLD | 名前 | ○ | －
TYPE | ○
LNG | ○
NAME | ○
COMM | ×
INC制御 | CTLFLD | 名前 | ○ | －
TYPE | ○
LNG | ○
NAME | ○
JUST | ×
FILL | ×
COMM | ×
フィールド制御 | CTLFLD | 名前 | ○ | －
TYPE | ○
LNG | ○
NAME | ○
REPEAT | ○
COMM | ×
論理フレーム | LOGFRM | 名前 | ○ | －
NAME | ○
REPEAT | ○
LOGFEND | 名前 | ×
主論理フィールド | LOGFLD | 名前 | ○ | －
LNG | ○
NAME | ○
PIC | ○
CODE | ○
TYPE | ○
REPEAT | ○
JUST | ○
FILL | ○
VAL | ○
LEVEL | ○ | 1固定
COMM | × | －
従論理フィールド | LOGFLD | 名前 | ○ | －
LNG | ○
NAME | ○
PIC | ○
TYPE | ○
REPEAT | ○
LEVEL | ○ | 2固定
COMM | × | －
物理マップ定義 | PHSEG | 名前 | × | －
POS | ○ | (1,1)固定
SIZE | ○ | (24,80)固定
DEV | ○ | (5425.D2)固定
CNTRL | ○ | UNOCCUPY,SZ1920は必ず出力
FORM | ○ | SCRN固定
INC | ○ | －
CURS | ○ | 入出力項目がない場合，*NOCURSを，入出力項目があって，初期カーソルの指定がない場合，画面上左上のフィールドを初期カーソルとして展開
PHSEND | 名前 | × | －
けい線 | RLINE | 名前 | × | －
POS | ○
LNG | ○
DIRECT | ○
固定項目 | CNSFLD | 名前 | × | －
POS | ○
VAL | ○
ATTR | ○
予約項目 | RSVFLD | 名前 | ○ | －
POS | ○
LNG | ○
ATTR | ○
物理フレーム | PHFRM | 名前 | × | －
POS | ○
SIZE | ○
LOGFRM | ○
LAY | ○
PHFEND | 名前 | ×
可変項目 | VARFLD | 名前 | ○ | －
POS | ○
LOGFLD | ○
LNG | ○
ATTR | ○
VAL | ×

（凡例）

○：生成する。

×：生成しない。

－：なし。

(2)　CUI画面から生成されるパネル定義文とドローセットアップの関係

ドローセットアップで指定できる属性の中で，生成する定義文に反映するもの，反映しないものを示します。また，生成時に変換されるものは，その変換規則を示します。

(a)　論理マップ属性ダイアログ

項番 | ドローセットアップでの設定値 | 定義文生成時 | 備考
1 | 初期クリア文字 | ○ | －
2 | データ消去通知文字 | ○ | －
3 | エラー通知文字 | ○ | －
4 | 入力データ長格納領域の生成 | ○ | －
5 | 定数部の別ファイル出力 | ○ | －
6 | 定数部への論理マップ長出力 | ○ | －
7 | 定義した位置の昇順に生成 | ○ | －
8 | 接頭語を付加する | ○ | －
9 | 論理マップ可変部の集団項目化 | × | －

（凡例）

○：反映する。

×：反映しない。

－：なし。

(b)　イベント通知コードダイアログ

項番 | ドローセットアップでの設定値 | 定義文生成時 | 備考
1 | 通知コードのデータ名 | ○ | －
2 | 通知コードの長さ | ○ | －
3 | 通知コード | ○ | －

（凡例）

○：反映する。

－：なし。

(c)　カーソルダイアログ

項番 | ドローセットアップでの設定値 | 定義文生成時 | 備考
1 | 論理カーソル | ○ | 出力カーソルは論理カーソル，入力カーソルは，行列（2進）カーソルとして展開する
2 | 行列（2進）カーソル | ○ | －
3 | 入力データ名 | ○
4 | 出力データ名 | ○

（凡例）

○：反映する。

－：なし。

(d)　動的変更属性ダイアログ－キャラクタコントロールタブ

項番 | ドローセットアップでの設定値 | 定義文生成時 | 備考
1 | 入力可否 | ○ | 「入力不可」はPROTとして展開する
2 | 非表示属性 | ○ | 「文字だけ非表示」はDARKとして展開する
3 | 遷移条件 | ○ | －
4 | 詳細目的 | ○
5 | 反転表示 | ○
6 | 文字色 | ○ | 非表示属性が「文字だけ非表示」の場合，無視する
7 | 入力済み | ○ | －
8 | 自動送信 | ○
9 | 入力必須 | ○

（凡例）

○：反映する。

－：なし。

(e)　動的変更属性ダイアログ－ウィンドウ属性タブ

項番 | ドローセットアップでの設定値 | 定義文生成時 | 備考
1 | 表示形態 | ○ | －
2 | 入力フィールドの扱い | ○ | －
3 | キーボードロック状態を解除する | ○ | －
4 | ウィンドウを表示した時にアラームを鳴らす | ○ | －

（凡例）

○：反映する。

－：なし。

(f)　動的変更属性ダイアログ－データ名タブ

項番 | ドローセットアップでの設定値 | 定義文生成時 | 備考
1 | ウィンドウ属性の動的変更 | ○ | －

（凡例）

○：反映する。

－：なし。

(g)　修飾名の設定ダイアログ

項番 | ドローセットアップでの設定値 | 定義文生成時 | 備考
1 | 修飾名 | ○ | －
2 | データ名 | × | －
3 | 修飾名長 | ○ | －
4 | C言語のデータ名を小文字に変換する | × | －
5 | コメント | × | －

（凡例）

○：反映する。

×：反映しない。

－：なし。

(3)　生成するパネル定義文とドローの関係（オブジェクト）

ドローで定義できるオブジェクトの中で，パネル定義文として生成するもの，しないものを表に示します。表中のボタンは，ドローのレイアウト画面上のツールボックスに表示されるボタンです。

オブジェクト | ボタン | 生成 | 備考
固定フィールド（英数） | [図データ]　 | ○ | －
固定フィールド（日本語） | [図データ]　 | ○
出力フィールド（数字） | [図データ]　 | ○
出力フィールド（日本語） | [図データ]　 | ○
出力フィールド（英数） | [図データ]　 | ○
予約フィールド | [図データ]　 | ○
入出力フィールド（数字） | [図データ]　 | ○
入出力フィールド（日本語） | [図データ]　 | ○
入出力フィールド（カナ） | [図データ]　 | ○
入出力フィールド（英数） | [図データ]　 | ○
フレーム（縦繰り返し） | [図データ]　 | ○
フレーム（横繰り返し） | [図データ]　 | ○
表けい線（見出しなし） | [図データ]　 | ○
表けい線（見出しあり） | [図データ]　 | ○
横けい線の繰り返し（2行間隔） | [図データ]　 | ○
横けい線の繰り返し（1行間隔） | [図データ]　 | ○
横けい線の繰り返し（自動間隔） | [図データ]　 | ○
縦けい線の繰り返し（自動間隔） | [図データ]　 | ○
縦／横けい線 | [図データ]　 | ○
矩形 | [図データ]　 | ○ | けい線として展開する

（凡例）

○：生成する。

－：なし。

(4)　生成するパネル定義文とドローの関係（属性）

ドローで指定できる属性の中で，生成する定義文に反映するもの，反映しないものを示します。また，生成時に変換されるものは，その変換規則を示します。

(a)　画面属性ダイアログ

項番
ドローでの設定値
定義文生成時
備考

1
画面に対するコメントの記述
×
－

2
イベント通知コード
○

3
表示形態
○
「自動」／「全面書換」の場合，
PANEL文のUSAGEオペランドにSGLを合わせて展開する

4
入力フィールドの扱い
○
－

5
動的変更
○

6
隠しフィールド
○

7
再定義名
○

8
キーボードのロック状態を解除する
○

9
ウィンドウを表示した時にアラームを鳴らす
○

10
モジュラス　アルゴリズム
○

11
次画面
○

（凡例）

○：反映する。

×：反映しない。

－：なし。

(b)　固定フィールドダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 文字色 | ○ | 表示方法が「文字だけ非表示」の場合無視する
2 | 文字の拡大 | ○ | －
3 | 表示方法 | ○ | 「文字だけ非表示」の場合，文字色としてDARKを展開する
4 | テキスト揃え | ○ | －
5 | 反転表示する | ○
6 | テキスト | ○

（凡例）

○：反映する。

－：なし。

(c)　出力フィールドダイアログ

項番
ドローでの設定値
定義文生成時
備考

1
文字色
○
表示方法が「文字だけ非表示」の場合無視する

2
文字の拡大
○
使用目的が「日本語」でデータ型が「文字（XX）」の場合，「標準」に変換する

3
使用目的
○
－

4
表示方法
○
「文字だけ非表示」の場合，文字色としてDARKを展開する

5
反転表示する
○
－

6
フィールド反復
○

7
コメントの記述
×

8
APが渡す項目のデータ名
○

9
APが渡す項目の桁
○

使用目的が「日本語」，データ型が「文字（XX）」で，「データ長を変更する」ボタンがオフの場合に設定できる

展開される論理項目の長さは「桁×7÷3＋3」に変換する

10
APが渡す項目のデータ長
○

使用目的が「日本語」，データ型が「文字（XX）」で，「データ長を変更する」ボタンがオンの場合に設定できる

指定した長さで展開する

11
APが渡す項目のデータ型
○
「/」を含む数字編集文字列を指定した場合，「文字（XX）」に変換する

12
APが渡す項目の桁寄せ
○
－

13
APが渡す項目の埋字
○
使用目的が「日本語」，データ型が「文字（XX）」の場合，「埋めない」になる

14
APが渡す項目の下位項目
○
(h)を参照

15
APが渡す項目の初期値
○
初期値の指定は，省略時仮定値として生成する

16
動的変更
○
－

（凡例）

○：反映する。

×：反映しない。

－：なし。

(d)　予約フィールドダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 桁数 | ○ | －
2 | 予約項目名 | ○
3 | 文字色 | ○ | 表示方法が「文字だけ非表示」の場合無視する
4 | 表示方法 | ○ | 「文字だけ非表示」の場合，文字色としてDARKを展開する
5 | 反転表示する | ○ | －
6 | コメントの記述 | ×

（凡例）

○：反映する。

×：反映しない。

－：なし。

(e)　入出力フィールドダイアログ

項番
ドローでの設定値
定義文生成時
備考

1
文字色
○
表示方法が「文字だけ非表示」の場合無視する

2
使用目的
○
－

3
表示方法
○

「文字だけ非表示」の場合，文字色としてDARKを展開する

「入力不可」の場合，PROTを展開する

4
遷移条件
○
－

5
コメントの記述
×

6
反転表示する
○

7
カーソル設定
○

8
入力済み
○

9
自動送信
○

10
入力必須
○

11
モジュラスチェックを行う
○

12
フィールド反復
○

13
APが受け取る項目のデータ名
○

14
APが受け取る項目の桁
○

使用目的が「日本語」，データ型が「文字（XX）」で，「データ長を変更する」ボタンがオフの場合に設定できる

展開される論理項目の長さは「桁×7÷3＋3」に変換する

15
APが受け取る項目のデータ長
○

使用目的が「日本語」，データ型が「文字（XX）」で，「データ長を変更する」ボタンがオンの場合に設定できる

指定した長さで展開する

16
APが受け取る項目のデータ型
○
「/」を含む数字編集文字列を指定した場合，「文字（XX）」に変換する

17
APが受け取る項目の桁寄せ
○
－

18
APが受け取る項目の埋字
○
使用目的が「日本語」でデータ型が「文字（XX）」の場合，「埋めない」になる

19
APが受け取る項目の初期値
○
初期値の指定は，省略時仮定値として生成する

20
APからデータを表示する
○
－

21
APが渡す項目の下位項目
○
(h)を参照

22
APが渡す項目のデータ名
○
－

23
APが渡す項目の桁
○

使用目的が「日本語」，データ型が「文字（XX）」で，「データ長を変更する」ボタンがオフの場合に設定できる

展開される論理項目の長さは「桁×7÷3＋3」に変換する

24
APが渡す項目のデータ長
○

使用目的が「日本語」，データ型が「文字（XX）」で，「データ長を変更する」ボタンがオンの場合に設定できる

指定した長さで展開する

25
APが渡す項目のデータ型
○
「/」を含む数字編集文字列を指定した場合，「文字（XX）」に変換する

26
APが渡す項目の桁寄せ
○
－

27
APが渡す項目の埋字
○
使用目的が「日本語」でデータ型が「文字（XX）」の場合，「埋めない」になる

28
APが渡す項目の下位項目
○
(h)を参照

29
APが渡す項目の初期値
○
初期値の指定は，省略時仮定値として生成する

30
動的変更
○
－

（凡例）

○：反映する。

×：反映しない。

－：なし。

(f)　フレームダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | APが渡す項目のデータ名 | ○ | －

（凡例）

－：なし。

(g)　横けい線ダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 線の位置 | ○ | －

（凡例）

○：反映する。

－：なし。

(h)　下位項目ダイアログ

項番
ドローでの設定値
定義文生成時
備考

1
下位項目のデータ名
○
－

2
下位項目の桁
○

3
下位項目のデータ長
○

4
下位項目のデータ型
○

「/」付きの場合，「文字（XX）」に変換する

上位項目が使用目的「日本語」でデータ型「文字（XX）」の場合，数字編集を「文字（XX）」に変換する

（凡例）

○：反映する。

－：なし。

付録D.2　エクスポート機能で変換できるけい線帳票の機能範囲

＜この項の構成＞

(1)　けい線帳票で生成できるパネル定義文の範囲

(2)　けい線帳票から生成されるパネル定義文とドローセットアップの関係

(3)　生成するパネル定義文とドローの関係（オブジェクト）

(4)　生成するパネル定義文とドローの関係（属性）

(1)　けい線帳票で生成できるパネル定義文の範囲

(a)　パネル定義文

生成できるパネル定義文の範囲を次の表に示します。

表D-3　生成できるパネル定義文

機能 | 文 | 生成 | 備考
パネル定義 | PANEL | ○ | －
PNLEND | ○ | －
記号パラメタ定義 | CNTRL | × | －
ATTR | × | －
論理マップ定義 | LOGSEG | ○ | －
LOGSEND | ○ | －
論理フレーム | LOGFRM | ○ | －
LOGFEND | ○ | －
主論理フィールド | LOGFLD | ○ | －
従論理フィールド | LOGFLD | ○ | －
物理マップ定義 | PHSEG | ○ | －
PHSEND | ○ | －
けい線 | RLINE | ○ | －
固定項目 | CNSFLD | ○ | －
予約項目 | RSVFLD | ○ | －
物理フレーム | PHFRM | ○ | －
PHFEND | ○ | －
可変項目 | VARFLD | ○ | －

（凡例）

○：生成する。

×：生成しない。

－：なし。

(b)　オペランド

生成できるパネル定義文について，生成できるオペランドの範囲を次の表に示します。

表D-4　生成できるオペランドの範囲（パネル定義文）

機能 | 文 | オペランド | 生成 | 備考
パネル定義 | PANEL | マップ名 | ○ | －
LANG | ○ | C（COBOL）固定
USAGE | ○ | －
PNLEND | 名前 | ×
論理マップ定義 | LOGSEG | 論理セグメント名 | ○ | －
BASE | ×
REDEF | ○
LITRL | ○
GENRT | ○
AREA | ×
LOGSEND | 名前 | ×
論理フレーム | LOGFRM | 名前 | ○ | －
NAME | ○
REPEAT | ○
LOGFEND | 名前 | ×
主論理フィールド | LOGFLD | 名前 | ○ | －
LNG | ○
NAME | ○
PIC | ○
CODE | ○
TYPE | ○
REPEAT | ○
JUST | ○
FILL | ○
VAL | ○
LEVEL | ○ | 1固定
COMM | × | －
従論理フィールド | LOGFLD | 名前 | ○ | －
LNG | ○
NAME | ○
PIC | ○
TYPE | ○
REPEAT | ×
LEVEL | ○ | 2固定
COMM | × | －
物理マップ定義 | PHSEG | 名前 | × | －
POS | ○
SIZE | ○
DEV | ○ | (5344)固定
CNTRL | ○ | －
EJECT | ○
FORM | ×
PHSEND | 名前 | ×
けい線 | RLINE | 名前 | × | －
POS | ○
LNG | ○
DIRECT | ○
固定項目 | CNSFLD | 名前 | × | －
POS | ○
VAL | ○
ATTR | ○
予約項目 | RSVFLD | 名前 | ○ | －
POS | ○
LNG | ○
ATTR | ○
物理フレーム | PHFRM | 名前 | × | －
POS | ○
SIZE | ○
LOGFRM | ○
LAY | ○
PHFEND | 名前 | ×
可変項目 | VARFLD | 名前 | ○ | －
POS | ○
LOGFLD | ○
LNG | ○
ATTR | ○
VAL | ×

（凡例）

○：生成する。

×：生成しない。

－：なし。

(2)　けい線帳票から生成されるパネル定義文とドローセットアップの関係

ドローセットアップで指定できる属性の中で，生成する定義文に反映するもの，反映しないものを示します。また，生成時に変換されるものは，その変換規則を示します。

(a)　論理マップ属性ダイアログ

項番 | ドローセットアップでの設定値 | 定義文生成時 | 備考
1 | 定数部の別ファイル出力 | ○ | －
2 | 定数部への論理マップ長出力 | ○ | －
3 | 定義した位置の昇順に生成 | ○ | －
4 | 接頭語を付加する | ○ | －
5 | 論理マップ可変部の集団項目化 | × | －

（凡例）

○：反映する。

×：反映しない。

－：なし。

(3)　生成するパネル定義文とドローの関係（オブジェクト）

ドローで定義できるオブジェクトの中で，パネル定義文として生成するもの，しないものを表に示します。表中のボタンは，ドローのレイアウト画面上のツールボックスに表示されるボタンです。

オブジェクト | ボタン | 生成 | 備考
固定フィールド（英数） | [図データ]　 | ○ | －
固定フィールド（日本語） | [図データ]　 | ○
出力フィールド（数字） | [図データ]　 | ○
出力フィールド（日本語） | [図データ]　 | ○
出力フィールド（英数） | [図データ]　 | ○
予約フィールド | [図データ]　 | ○
フレーム（縦繰り返し） | [図データ]　 | ○
フレーム（横繰り返し） | [図データ]　 | ○
表けい線（見出しなし） | [図データ]　 | ○
表けい線（見出しあり） | [図データ]　 | ○
横けい線の繰り返し（2行間隔） | [図データ]　 | ○
横けい線の繰り返し（1行間隔） | [図データ]　 | ○
横けい線の繰り返し（自動間隔） | [図データ]　 | ○
縦けい線の繰り返し（自動間隔） | [図データ]　 | ○
縦／横けい線 | [図データ]　 | ○
矩形 | [図データ]　 | ○ | けい線として展開する
出力OCR | [図データ]　 | × | 出力フィールド（英数）として生成しますが，使用しないでください。

（凡例）

○：生成する。

×：生成しない。

－：なし。

(4)　生成するパネル定義文とドローの関係（属性）

ドローで指定できる属性の中で，生成する定義文に反映するもの，反映しないものを示します。また，生成時に変換されるものは，その変換規則を示します。

(a)　けい線帳票属性（連続紙）ダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 上オフセット | ○ | －
2 | 左オフセット | ○
3 | レイアウト領域の縦サイズ | ○
4 | レイアウト領域の横サイズ | ○
5 | 印刷動作 | ○
6 | コメントの記述 | ×
7 | 再定義名 | ○
8 | 印刷ドキュメント名 | ×
9 | けい線の配置方法の選択 | ○ | 「ます目に沿って引く」は「ます目の中央に引く」に変換する
10 | ます目設定 | ○ | 「自由な設定」以外は行の間隔「6LPI」，文字の間隔「0ポイント」に変換する
11 | 行の間隔 | ○ | 「8LPI」は「6LPI」に変換する
12 | 文字の間隔 | ○ | 「0ポイント」，「2ポイント」，「4ポイント」以外は「0ポイント」に変換する

（凡例）

○：反映する。

×：反映しない。

－：なし。

(b)　けい線帳票属性（カット紙）ダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 上オフセット | ○ | －
2 | 左オフセット | ○
3 | レイアウト領域の縦サイズ | ○
4 | レイアウト領域の横サイズ | ○
5 | 排出先 | ○
6 | コメントの記述 | ×
7 | 再定義名 | ○
8 | 印刷ドキュメント名 | ×
9 | けい線の配置方法の選択 | ○ | 「ます目に沿って引く」は「ます目の中央に引く」に変換する
10 | ます目設定 | ○ | 「自由な設定」以外は行の間隔「6LPI」，文字の間隔「0ポイント」に変換する
11 | 行の間隔 | ○ | 「8LPI」は「6LPI」に変換する
12 | 文字の間隔 | ○ | 「0ポイント」，「2ポイント」，「4ポイント」以外は「0ポイント」に変換する

（凡例）

○：反映する。

×：反映しない。

－：なし。

(c)　固定フィールドダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 文字の拡大 | ○ | －
2 | 文字の間隔 | ○ | 「標準」に変換する
3 | テキスト揃え | ○ | －
4 | テキスト | ○

（凡例）

○：反映する。

－：なし。

(d)　出力フィールドダイアログ

項番
ドローでの設定値
定義文生成時
備考

1
使用目的
○
－

2
文字の拡大
○
使用目的が「日本語」でデータ型が「文字（XX）」の場合，「標準」に変換する

3
文字の間隔
○
「標準」に変換する

4
フィールド反復
○
－

5
コメントの記述
×

6
APが渡す項目のデータ名
○

7
APが渡す項目の桁
○

使用目的が「日本語」，データ型が「文字（XX）」で，「データ長を変更する」ボタンがオフの場合に設定できる

展開される論理項目の長さは「桁×7÷3＋3」に変換する

8
APが渡す項目のデータ長
○

使用目的が「日本語」，データ型が「文字（XX）」で，「データ長を変更する」ボタンがオンの場合に設定できる

指定した長さで展開する

9
APが渡す項目のデータ型
○
「/」を含む数字編集文字列を指定した場合，「文字（XX）」に変換する

10
APが渡す項目の桁寄せ
○
－

11
APが渡す項目の埋字
○
使用目的が「日本語」でデータ型が「文字（XX）」の場合，「埋めない」になる

12
APが渡す項目の下位項目
○
(j)を参照

13
APが渡す項目の初期値
○
初期値の指定は，省略時仮定値として生成する

（凡例）

○：反映する。

×：反映しない。

－：なし。

(e)　予約フィールドダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 桁数 | ○ | －
2 | 予約項目名 | ○
3 | 文字の間隔 | ○ | 「標準」に変換する
4 | コメントの記述 | × | －

（凡例）

○：反映する。

×：反映しない。

－：なし。

(f)　フレームダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | APが渡す項目のデータ名 | ○ | －

（凡例）

○：反映する。

－：なし。

(g)　横けい線ダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 線の位置 | ○ | －
2 | 線の種類 | ○ | 「破線」は「実線」に変換する
3 | 線の太さ | ○ | 「細線」は「中線」に変換する

（凡例）

○：反映する。

－：なし。

(h)　縦けい線ダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 線の種類 | ○ | 「破線」は「実線」に変換する
2 | 線の太さ | ○ | 「細線」は「中線」に変換する

（凡例）

○：反映する。

(i)　矩形ダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 線の種類 | ○ | 「破線」は「実線」に変換する
2 | 線の太さ | ○ | 「細線」は「中線」に変換する

（凡例）

○：反映する。

(j)　下位項目ダイアログ

項番
ドローでの設定値
定義文生成時
備考

1
下位項目のデータ名
○
－

2
下位項目の桁
○

3
下位項目のデータ長
○

4
下位項目のデータ型
○

「/」付きの場合，「文字（XX）」に変換する

上位項目が使用目的「日本語」でデータ型「文字（XX）」の場合，数字編集を「文字（XX）」に変換する

（凡例）

○：反映する。

－：なし。

付録D.3　エクスポート機能で変換できる網掛け帳票の機能範囲

＜この項の構成＞

(1)　網掛け帳票で生成できるパネル定義文の範囲

(2)　網掛け帳票から生成されるパネル定義文とドローセットアップの関係

(3)　生成するパネル定義文とドローの関係（オブジェクト）

(4)　生成するパネル定義文とドローの関係（属性）

(1)　網掛け帳票で生成できるパネル定義文の範囲

(a)　パネル定義文

生成できるパネル定義文の範囲を次の表に示します。

表D-5　生成できるパネル定義文

機能 | 文 | 生成 | 備考
パネル定義 | PANEL | ○ | －
PNLEND | ○ | －
記号パラメタ定義 | ATTR | × | －
論理マップ定義 | LOGSEG | ○ | －
LOGSEND | ○ | －
コピー枚数制御 | CTLFLD | ○ | －
論理フレーム | LOGFRM | ○ | －
LOGFEND | ○ | －
主論理フィールド | LOGFLD | ○ | －
従論理フィールド | LOGFLD | ○ | －
物理マップ定義 | PHSEG | ○ | －
PHSEND | ○ | －
けい線 | RLINE | ○ | －
矩形 | BOX | ○ | －
網掛け | TONE | ○ | －
固定項目 | CNSFLD | ○ | －
予約項目 | RSVFLD | ○ | －
物理フレーム | PHFRM | ○ | －
PHFEND | ○ | －
可変項目 | VARFLD | ○ | －

（凡例）

○：生成する。

×：生成しない。

－：なし。

(b)　オペランド

生成できるパネル定義文について，生成できるオペランドの範囲を次の表に示します。

表D-6　生成できるオペランドの範囲（パネル定義文）

機能 | 文 | オペランド | 生成 | 備考
パネル定義 | PANEL | マップ名 | ○ | －
LANG | ○ | C（COBOL）固定
USAGE | ○ | －
PNLEND | 名前 | ×
論理マップ定義 | LOGSEG | 論理セグメント名 | ○ | －
BASE | ×
REDEF | ○
LITRL | ○
GENRT | ○
AREA | ×
LOGSEND | 名前 | ×
コピー枚数制御 | CTLFLD | 名前 | ○ | －
TYPE | ○ | (COPIES,X)固定
LNG | ○ | 2固定
NAME | ○ | －
論理フレーム | LOGFRM | 名前 | ○ | －
NAME | ○
REPEAT | ○
LOGFEND | 名前 | ×
主論理フィールド | LOGFLD | 名前 | ○ | －
LNG | ○
NAME | ○
PIC | ○
CODE | ○
TYPE | ○
REPEAT | ○
JUST | ○
FILL | ○
VAL | ○
LEVEL | ○ | 1固定
COMM | × | －
従論理フィールド | LOGFLD | 名前 | ○ | －
LNG | ○
NAME | ○
PIC | ○
TYPE | ○
REPEAT | ×
LEVEL | ○ | 2固定
COMM | × | －
物理マップ定義 | PHSEG | 名前 | × | －
POS | ○
SIZE | ○
DEV | ○ | (2311)固定
COPIES | ○ | －
MARGIN | ○
LP | ○
CSCF | ○
FORM | ○
PHSEND | 名前 | ×
けい線 | RLINE | 名前 | × | －
POS | ○
LNG | ○
DIRECT | ○
STYLE | ○
矩形 | BOX | 名前 | × | －
POS | ○
SIZE | ○
STYLE | ○
CORNER | ○
網掛け | TONE | 名前 | × | －
POS | ○
SIZE | ○
CORNER | ○
ATTR | ○
固定項目 | CNSFLD | 名前 | × | －
POS | ○
VAL | ○
ATTR | ○
予約項目 | RSVFLD | 名前 | ○ | －
POS | ○
LNG | ○
ATTR | ○
物理フレーム | PHFRM | 名前 | × | －
POS | ○
SIZE | ○
LOGFRM | ○
LAY | ○
PHFEND | 名前 | ×
可変項目 | VARFLD | 名前 | ○ | －
POS | ○
LOGFLD | ○
LNG | ○
ATTR | ○
VAL | ×

（凡例）

○：生成する。

×：生成しない。

－：なし。

(2)　網掛け帳票から生成されるパネル定義文とドローセットアップの関係

ドローセットアップで指定できる属性の中で，生成する定義文に反映するもの，反映しないものを示します。また，生成時に変換されるものは，その変換規則を示します。

(a)　論理マップ属性ダイアログ

項番 | ドローセットアップでの設定値 | 定義文生成時 | 備考
1 | 定数部の別ファイル出力 | ○ | －
2 | 定数部への論理マップ長出力 | ○ | －
3 | 定義した位置の昇順に生成 | ○ | －
4 | 接頭語を付加する | ○ | －
5 | 論理マップ可変部の集団項目化 | × | －

（凡例）

○：反映する。

×：反映しない。

－：なし。

(b)　コピー枚数動的変更のデータ名

項番 | ドローセットアップでの設定値 | 定義文生成時 | 備考
1 | アプリケーションでの印刷枚数指定領域の生成 | ○ | －
2 | データ名 | ○ | －

（凡例）

○：反映する。

－：なし。

(3)　生成するパネル定義文とドローの関係（オブジェクト）

ドローで定義できるオブジェクトの中で，パネル定義文として生成するもの，しないものを表に示します。表中のボタンは，ドローのレイアウト画面上のツールボックスに表示されるボタンです。

オブジェクト | ボタン | 生成 | 備考
固定フィールド（英数） | [図データ]　 | ○ | －
固定フィールド（日本語） | [図データ]　 | ○ | －
出力フィールド（数字） | [図データ]　 | ○ | －
出力フィールド（日本語） | [図データ]　 | ○ | －
出力フィールド（英数） | [図データ]　 | ○ | －
予約フィールド | [図データ]　 | ○ | －
フレーム（縦繰り返し） | [図データ]　 | ○ | －
フレーム（横繰り返し） | [図データ]　 | ○ | －
表けい線（見出しなし） | [図データ]　 | ○ | －
表けい線（見出しあり） | [図データ]　 | ○ | －
横けい線の繰り返し（2行間隔） | [図データ]　 | ○ | －
横けい線の繰り返し（1行間隔） | [図データ]　 | ○ | －
横けい線の繰り返し（自動間隔） | [図データ]　 | ○ | －
縦けい線の繰り返し（自動間隔） | [図データ]　 | ○ | －
縦／横けい線 | [図データ]　 | ○ | －
矩形 | [図データ]　 | ○ | －
矩形（ラウンドコーナ） | [図データ]　 | ○ | －
網掛け | [図データ]　 | ○ | －
網掛けの繰り返し（1行間隔） | [図データ]　 | ○ | －
網掛け（ラウンドコーナ） | [図データ]　 | ○ | －

（凡例）

○：生成する。

－：なし。

(4)　生成するパネル定義文とドローの関係（属性）

ドローで指定できる属性の中で，生成する定義文に反映するもの，反映しないものを示します。また，生成時に変換されるものは，その変換規則を示します。

(a)　網掛け帳票属性ダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 上マージン | ○ | 36.2mm以上の場合，36.1mmに変換する
2 | 左マージン | ○ | 36.2mm以上の場合，36.1mmに変換する
3 | 上オフセット | ○ | －
4 | 左オフセット | ○
5 | レイアウト領域の縦サイズ | ○
6 | レイアウト領域の横サイズ | ○
7 | 給紙サイズ | ○
8 | 印刷部数 | ○
9 | 印刷部数をAPで変更する | ○
10 | コメントの記述 | ×
11 | 再定義名 | ○
12 | 印刷ドキュメント名 | ×
13 | ます目設定 | ○ | 「自由な設定」以外は行の間隔「6LPI」，文字の間隔「0ポイント」に変換する
14 | 行の間隔 | ○ | －
15 | 文字の間隔 | ○
16 | 文字サイズ | ○ | 「7ポイント」は「9ポイント」に変換する

（凡例）

○：反映する。

×：反映しない。

－：なし。

(b)　固定フィールドダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 文字の拡大 | ○ | －
2 | 文字の間隔 | ○
3 | 文字サイズ | ○ | 「7ポイント」は「標準」に変換する
4 | テキスト揃え | ○ | －
5 | テキスト | ○

（凡例）

○：反映する。

－：なし。

(c)　出力フィールドダイアログ

項番
ドローでの設定値
定義文生成時
備考

1
使用目的
○
－

2
文字の拡大
○
使用目的が「日本語」でデータ型が「文字（XX）」の場合，「標準」に変換する

3
文字サイズ
○
「7ポイント」は「標準」に変換する

4
文字の間隔
○
－

5
フィールド反復
○

6
コメントの記述
×

7
APが渡す項目のデータ名
○

8
APが渡す項目の桁
○

使用目的が「日本語」，データ型が「文字（XX）」で，「データ長を変更する」ボタンがオフの場合に設定できる

展開される論理項目の長さは「桁×7÷3＋3」に変換する

9
APが渡す項目のデータ長
○

使用目的が「日本語」，データ型が「文字（XX）」で，「データ長を変更する」ボタンがオンの場合に設定できる

指定した長さで展開する

10
APが渡す項目のデータ型
○
「/」を含む数字編集文字列を指定した場合，「文字（XX）」に変換する

11
APが渡す項目の桁寄せ
○
－

12
APが渡す項目の埋字
○
使用目的が「日本語」でデータ型が「文字（XX）」の場合，「埋めない」になる

13
APが渡す項目の下位項目
○
(j)を参照

14
APが渡す項目の初期値
○
初期値の指定は，省略時仮定値として生成する

（凡例）

○：反映する。

×：反映しない。

－：なし。

(d)　予約フィールドダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 桁数 | ○ | －
2 | 予約項目名 | ○
3 | 文字の間隔 | ○
4 | 文字サイズ | ○ | 「7ポイント」は「標準」に変換する
5 | コメントの記述 | × | －

（凡例）

○：反映する。

×：反映しない。

－：なし。

(e)　フレームダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | APが渡す項目のデータ名 | ○ | －

（凡例）

○：反映する。

－：なし。

(f)　横けい線ダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 線の位置 | ○ | －
2 | 線の種類 | ○ | －
3 | 線の太さ | ○ | －

（凡例）

○：反映する。

－：なし。

(g)　縦けい線ダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 線の種類 | ○ | －
2 | 線の太さ | ○ | －

（凡例）

○：反映する。

－：なし。

(h)　矩形ダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 角の丸め | ○ | －
2 | 丸め場所 | ○ | －
3 | 線の種類 | ○ | －
4 | 線の太さ | ○ | －

（凡例）

○：反映する。

－：なし。

(i)　網掛けダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 角の丸め | ○ | －
2 | 丸め場所 | ○
3 | 網掛けの濃さ | ○
4 | 枠付き | ○ | 枠は矩形として展開する
5 | 線の種類 | ○ | －
6 | 線の太さ | ○

（凡例）

○：反映する。

－：なし。

(j)　下位項目ダイアログ

項番
ドローでの設定値
定義文生成時
備考

1
下位項目のデータ名
○
－

2
下位項目の桁
○

3
下位項目のデータ長
○

4
下位項目のデータ型
○

「/」付きの場合，「文字（XX）」に変換する

上位項目が使用目的「日本語」でデータ型「文字（XX）」の場合，数字編集を「文字（XX）」に変換する

（凡例）

○：反映する。

－：なし。

付録D.4　エクスポート機能で変換できるタイプ3書式の機能範囲

メインフレーム用のタイプ3書式がサポートしている機能の中で，XMAP3がサポートする範囲と，ドローで定義するときに有効となる機能の範囲について説明します。

＜この項の構成＞

(1)　生成できるパネル定義文の範囲

(2)　ドローで指定できるます目の範囲

(3)　標準提供しているレイアウトパターンの内容

(4)　生成するパネル定義文の内容とドローとの関係（オブジェクト）

(5)　生成するパネル定義文の内容とドローとの関係（属性）

(1)　生成できるパネル定義文の範囲

(a)　パネル定義文

XMAP3のエクスポート機能で生成できるパネル定義文の範囲を次の表に示します。

表D-7　生成できるパネル定義文

パネル定義文 | 生成 | 備考
PANEL | ○ | －
PNLEND | ○
LOGSEG | ○
LOGSEND | ○
LOGFLD（主論理項目） | ○
LOGFLD（従論理項目） | ○ | 主論理項目がKEIS専用項目の場合は生成しない
PHSEG | ○ | －
PHSEND | ○
RLINE | ○
ELINE | ○
BOX | ○
CIRCLE | ○ | ターゲット環境がVOS1の場合は定義文を生成しない
ARC | ○ | ターゲット環境がVOS1の場合は定義文を生成しない
TONE | ○ | －
CNSFLD | ○
VARFLD | ○
VARBCD | ○ | ターゲット環境がVOS1の場合は定義文を生成しない
CNTRL | × | －
ATTR | ×
UINF | ×
LOGFRM | ○
LOGFEND | ○
RDFBOX | ×
RDFEND | ×
RSVFLD | ×
PHFRM | ○
PHFEND | ○
CNSBCD | ○ | ターゲット環境がVOS1の場合は定義文を生成しない
RASTER | × | －
RSTEND | ×
DOT | ×
GRAPHIC | ×
GRPHEND | ×
AREA | ×
SPACE | ×
EJECT | ×

（凡例）

○：生成する。

×：生成しない。

－：なし。

(b)　オペランド

XMAP3のエクスポート機能で生成できるパネル定義文について，生成できるオペランドの範囲を次の表に示します。

表D-8　生成できるオペランドの範囲（パネル定義文）

パネル定義文 | オペランド | 生成 | 備考
PANEL | マップ名 | ○ | －
LANG | ○ | COBOLだけ
PNLEND | 名前 | × | －
LOGSEG | 論理セグメント名 | ○
BASE | ×
REDEF | ○
LITRL | ○
GENRT | ○ | ターゲット環境がVOS3の場合，STRUCTまたはNOSTRUCTを生成する
AREA | × | －
LOGSEND | 名前 | × | －
LOGFRM | 名前 | ○ | －
REPEAT | ○
NAME | ○
LOGFEND | 名前 | × | －
LOGFLD（主論理項目） | 名前 | ○ | －
LNG | ○
NAME | ○
PIC | ○
CODE | ○
TYPE | ○
REPEAT | ○
JUST | ○
FILL | ○ | 16進数字指定および16進漢字定数指定は生成しない
VAL | ○ | 16進数字指定および16進漢字定数指定は生成しない
LEVEL | ○ | 1固定
COMM | × | －
LOGFLD（従論理項目） | 名前 | ○ | －
LNG | ○
NAME | ○
PIC | ○
TYPE | ○
REPEAT | ×
LEVEL | ○ | 2固定
COMM | × | －
PHSEG | 名前 | × | －
DEV | ○ | (XPRT,H3)固定
CNTRL | × | －
CP | ○
CSCF | ○ | 字ピッチは生成しない
UNIT | ○ | UNIT=1,440U固定
POS | ○ | 0固定
SIZE | ○ | 1固定
FORM | ○ | －
MARGIN | ○
COPIES | ×
LP | ○ | 行ピッチは生成しない
PHSEND | 名前 | × | －
RLINE | 名前 | × | －
POS | ○
DIRECT | ○
LNG | ○
STYLE | ○
ELINE | 名前 | × | －
POS | ○
DIRECT | ○
SIZE | ○
STYLE | ○
BOX | 名前 | × | －
POS | ○
SIZE | ○
CORNER | ○
STYLE | ○
CIRCLE | 名前 | × | －
POS | ○
SIZE | ○
STYLE | ○
ARC | 名前 | × | －
STPOS | ○
ENPOS | ○
STYLE | ○
CURVE | ○
TONE | 名前 | × | －
POS | ○
SIZE | ○
CORNER | ○
ATTR | ○
CNSFLD | 名前 | × | －
POS | ○
VAL | ○
ATTR | ○
LNG | ○
DLM | ×
UINF | ×
CNSBCD | 名前 | × | －
POS | ○
SIZE | ○
TYPE | ○
BCDATTR | ○
VAL | ○
PHFRM | 名前 | × | －
POS | ○
SIZE | ○
LOGFRM | ○
LAY | ○
PHFEND | 名前 | × | －
VARFLD | 名前 | × | －
POS | ○
LOGFLD | ○
ATTR | ○
VAL | ×
LNG | ○
LAY | ○
DLM | ×
UINF | ×
VARBCD | 名前 | × | －
POS | ○
SIZE | ○
LOGFLD | ○
TYPE | ○
BCDATTR | ○
VAL | ×
LAY | ○

（凡例）

○：生成する。

×：生成しない。

－：なし。

(2)　ドローで指定できるます目の範囲

(a)　行間隔と指定できる最大行数

行間隔と指定できる最大行数，および組み合わせられる文字サイズについて次の表に示します。

表D-9　行間隔と最大行数

行間隔（ドット数） | 最大行数（ドット数） | 組み合わせられる文字サイズ※
3LPI（80） | 68ます（5,440） | すべての文字サイズ
4LPI（60） | 91ます（5,460） | すべての文字サイズ
6LPI（40） | 127ます（5,080） | すべての文字サイズ
8LPI（30） | 127ます（3,810） | 5ポイント，7ポイント，15CPI
10LPI（24） | 127ます（3,048） | 5ポイント，7ポイント
12LPI（20） | 127ます（2,540） | 5ポイント

注※

組み合わせられる文字サイズは，用紙の標準属性としての文字サイズです。配置するフィールドの文字サイズは，それぞれ変更できます。

(b)　文字サイズ，文字の間隔と指定できる最大列数

それぞれの文字サイズについて，指定できる文字の間隔と最大列数を次の表に示します。

表D-10　文字サイズ，文字の間隔，最大列数

文字サイズ（ドット数） | 文字の間隔（ドット数） | 決定する列間隔 | 最大列数（ドット数）
5ポイント（8） | 0ポイント（0） | 8ドット | 255ます（2,040）
1ポイント（2） | 10ドット | 255ます（2,550）
2ポイント（3） | 11ドット | 255ます（2,805）
3ポイント（5） | 13ドット | 255ます（3,315）
4ポイント（6） | 14ドット | 255ます（3,570）
5ポイント（8） | 16ドット | 255ます（4,080）
6ポイント（9） | 17ドット | 255ます（4,335）
7ポイント（11） | 19ドット | 255ます（4,845）
7ポイント（12） | 0ポイント（0） | 12ドット | 255ます（3,060）
1ポイント（2） | 14ドット | 255ます（3,570）
2ポイント（3） | 15ドット | 255ます（3,825）
3ポイント（5） | 17ドット | 255ます（4,335）
4ポイント（6） | 18ドット | 255ます（4,590）
5ポイント（8） | 20ドット | 255ます（5,100）
6ポイント（9） | 21ドット | 255ます（5,355）
7ポイント（11） | 23ドット | 237ます（5,451）
9ポイント（16） | 0ポイント（0） | 16ドット | 255ます（4,080）
1ポイント（2） | 18ドット | 255ます（4,590）
2ポイント（3） | 19ドット | 255ます（4,845）
3ポイント（5） | 21ドット | 255ます（5,355）
4ポイント（6） | 22ドット | 248ます（5,456）
5ポイント（8） | 24ドット | 227ます（5,448）
6ポイント（9） | 25ドット | 218ます（5,450）
7ポイント（11） | 27ドット | 202ます（5,454）
12ポイント（20） | 0ポイント（0） | 20ドット | 255ます（5,100）
1ポイント（2） | 22ドット | 248ます（5,456）
2ポイント（3） | 23ドット | 237ます（5,451）
3ポイント（5） | 25ドット | 218ます（5,450）
4ポイント（6） | 26ドット | 210ます（5,460）
5ポイント（8） | 28ドット | 195ます（5,460）
6ポイント（9） | 29ドット | 188ます（5,452）
7ポイント（11） | 31ドット | 176ます（5,456）

(c)　列間隔と指定できる最大列数

列間隔をCPI指定した場合の，指定できる最大列数と文字サイズを次の表に示します。

表D-11　列間隔と最大列数

列間隔（ドット数） | 最大列数（ドット数） | 仮定する文字サイズ | 備考
10CPI（24） | 227ます（5,448） | 9ポイント | 6LPIとの組み合わせ
12CPI（20） | 255ます（5,100） | 9ポイント | 6LPIとの組み合わせ
15CPI（16） | 255ます（4,080） | 7ポイント | 6LPI，8LPIとの組み合わせだけ

注

CPI指定は，パネル定義文生成時に，文字サイズと文字間隔の組み合わせに変換され，定義時の内容と実際の印刷結果が異なってしまいますので，列間隔として，CPI指定は使用しないでください。

また，CPI指定を行うと，定義するフィールド単位に文字サイズ，文字の間隔を変更できません。フィールド単位に文字サイズを変更する場合は，文字サイズ，文字の間隔を組み合わせてください。例を次の表に示します。

表D-12　文字サイズと文字間隔の組み合わせの例

使用したい列間隔 | 指定する文字サイズ | 指定する文字の間隔
10CPI（24） | 9ポイント（16ドット） | 5ポイント
12CPI（20） | 7ポイント（12ドット） | 5ポイント
15CPI（16） | 9ポイント（16ドット） | 0ポイント

(3)　標準提供しているレイアウトパターンの内容

ページプリンタグラフィック帳票で標準提供しているレイアウトパターンの内容を次の表に示します。

表D-13　標準提供レイアウトパターン（ページプリンタグラフィック帳票）

パターン名称 | 行数（ドット数） | 列数（ドット数）
A4縦9ポイント文字，5ポイント間隔（10CPI），6LPI | 66ます（2,640） | 76 ます（1,824）
A4縦9ポイント文字，0ポイント間隔（15CPI），6LPI | 66ます（2,640） | 115ます（1,840）
A4縦7ポイント文字，2ポイント間隔（15CPI），8LPI | 88ます（2,640） | 123ます（1,845）
A4横9ポイント文字，5ポイント間隔（10CPI），6LPI | 46ます（1,840） | 111ます（2,264）
A4横9ポイント文字，0ポイント間隔（15CPI），6LPI | 46ます（1,840） | 166ます（2,656）
A4横7ポイント文字，2ポイント間隔（15CPI），8LPI | 61ます（1,830） | 177ます（2,655）
B4縦9ポイント文字，5ポイント間隔（10CPI），6LPI | 82ます（3,280） | 95ます（2,280）
B4縦9ポイント文字，0ポイント間隔（15CPI），6LPI | 82ます（3,280） | 143ます（2,288）
B4縦7ポイント文字，2ポイント間隔（15CPI），8LPI | 110ます（3,300） | 152ます（2,280）
B4横9ポイント文字，5ポイント間隔（10CPI），6LPI | 57ます（2,280） | 137ます（3,288）
B4横9ポイント文字，0ポイント間隔（15CPI），6LPI | 57ます（2,280） | 206ます（3,296）
B4横7ポイント文字，2ポイント間隔（15CPI），8LPI | 76ます（2,280） | 220ます（3,300）

(4)　生成するパネル定義文の内容とドローとの関係（オブジェクト）

ドローで定義できるオブジェクトの中で，パネル定義文として生成するもの，しないものを次の表に示します。次の表のボタンは，ドローのレイアウト画面上のツールボックスに表示されるボタンです。

表D-14　パネル定義文を生成するオブジェクト

オブジェクト
ボタン
生成
備考

固定フィールド（英数）
[図データ]　
○
－

固定フィールド（日本語）
[図データ]　
○

出力フィールド（数字）
[図データ]　
○

出力フィールド（日本語）
[図データ]　
○

出力フィールド（英数）
[図データ]　
○

出力日付フィールド
[図データ]　
×

出力時刻フィールド
[図データ]　
×

予約フィールド
[図データ]　
×

フレーム（縦繰り返し）
[図データ]　
○

フレーム（横繰り返し）
[図データ]　
○

デリミタ線
[図データ]　
○

表けい線の枠（見出しなし）
[図データ]　
○

表けい線の枠（見出しあり）
[図データ]　
○

横けい線の繰り返し（2行間隔）
[図データ]　
○

横けい線の繰り返し（1行間隔）
[図データ]　
○

横けい線の繰り返し（自動間隔）
[図データ]　
○

縦けい線の繰り返し（自動間隔）
[図データ]　
○

縦（左）／横（上）けい線
[図データ]　
○

縦（中央）／横（中央）けい線
[図データ]　
○

縦（右）／横（下）けい線
[図データ]　
○

斜めけい線
[図データ]　
○

矩形
[図データ]　
○

矩形（ラウンドコーナ）
[図データ]　
○

円（実線）
[図データ]　
○
ターゲット環境がVOS1の場合は定義しないこと

円（点線）
[図データ]　
○
ターゲット環境がVOS1の場合は定義しないこと

円弧（実線・角度大）
[図データ]　
○
ターゲット環境がVOS1の場合は定義しないこと

円弧（実線・角度中）
[図データ]　
○
ターゲット環境がVOS1の場合は定義しないこと

円弧（実線・角度小）
[図データ]　
○
ターゲット環境がVOS1の場合は定義しないこと

円弧（点線・角度大）
[図データ]　
○
ターゲット環境がVOS1の場合は定義しないこと

円弧（点線・角度中）
[図データ]　
○
ターゲット環境がVOS1の場合は定義しないこと

円弧（点線・角度小）
[図データ]　
○
ターゲット環境がVOS1の場合は定義しないこと

網掛け
[図データ]　
○
－

網掛けの繰り返し（1行間隔）
[図データ]　
○

網掛け（ラウンドコーナ）
[図データ]　
○

出力バーコード
[図データ]　
○
ターゲット環境がVOS1の場合は定義しないこと
ターゲット環境がVOSKの場合は，CODE39，JAN8，JAN13だけ展開する

固定バーコード
[図データ]　
○
ターゲット環境がVOS1の場合は定義しないこと
ターゲット環境がVOSKの場合は，CODE39，JAN8，JAN13だけ展開する

連結出力バーコード
[図データ]　
×
－

固定グラフィック
[図データ]　
×

出力グラフィック
[図データ]　
×

出力OCR
[図データ]　
○

（凡例）

○：生成する。

×：生成しない。

－：なし。

(5)　生成するパネル定義文の内容とドローとの関係（属性）

ドローで指定できる属性の中で，生成する定義文に反映するもの，反映しないものを示します。また，生成時に変換されるものは，その変換規則を示します。

(a)　グラフィック帳票属性ダイアログ

項番
ドローでの設定値
定義文生成時
備考

1
上マージン
○
36mmを超える値は36mmに変換する

2
上オフセット
○
－

3
左マージン
○
36mmを超える値は36mmに変換する

4
左オフセット
○
－

5
レイアウト領域の縦サイズ
○

6
レイアウト領域の横サイズ
○

7
単位の選択
×

8
給紙サイズ
○

9
印刷部数
×

10
印刷部数をAPで変更する
×

11
コメントの記述
×

12
再定義名
○

13
印刷ドキュメント名
×

14
ます目設定
○
CPIは文字サイズ，文字の間隔に変換する
10CPI：9ポイント＋5ポイント
12CPI：9ポイント＋2ポイント
15CPI：7ポイント＋2ポイント

15
行の間隔
○
－

16
文字の間隔
○

17
文字サイズ
○

（凡例）

○：反映する。

×：反映しない。

－：なし。

(b)　固定フィールドダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 文字の拡大 | ○ | －
2 | 文字の書体 | ○ | 文字サイズが5ポイント，7ポイントの場合，ゴシックを指定しても「標準」に変換する
3 | 文字サイズ | ○ | ターゲット環境がVOS1の場合，14ポイントは「標準」に変換する
4 | 文字の強調 | × | －
5 | 文字の間隔 | ○
6 | 文字色 | ×
7 | 網掛け | ×
8 | テキスト | ○
9 | テキスト揃え | ○

（凡例）

○：反映する。

×：反映しない。

－：なし。

(c)　フレームダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | データ名 | ○ | －

（凡例）

○：反映する。

－：なし。

(d)　出力フィールドダイアログ

項番
ドローでの設定値
定義文生成時
備考

1
使用目的
○
－

2
文字サイズ
○
ターゲット環境がVOS1の場合，14ポイントは「標準」に変換する

3
文字の書体
○
文字サイズが5ポイント，7ポイントの場合，ゴシックを指定しても「標準」に変換する

4
文字の拡大
○
ターゲット環境がVOS1またはVOSKで，使用目的が「日本語」でデータ型が「文字（XX）」の場合，「標準」に変換する

5
文字の間隔
○
－

6
文字の強調
×

7
網掛け
×

8
文字色
×

9
コメント記述
×

10
フィールド反復
○

11
APが渡す項目のデータ名
○

12
APが渡す項目の桁
○

使用目的が「日本語」，データ型が「文字（XX）」で，「データ長を変更する」ボタンがオフの場合に設定できる

展開される論理項目の長さは「桁×7÷3+3」に変換する

13
APが渡す項目のデータ長
○

使用目的が「日本語」，データ型が「文字（XX）」で，「データ長を変更する」ボタンがオンの場合に設定できる

指定した長さで展開する

14
APが渡す項目のデータ型
○
「/」を含む数字編集文字列を指定した場合，「文字（XX）」に変換する

15
APが渡す項目の桁寄せ
○
－

16
APが渡す項目の埋字
○

LOW，HIGHの場合，「埋字しない」になる

使用目的が「日本語」でデータ型が「文字（XX）」の場合，「埋字しない」になる

17
APが渡す項目の初期値
○

初期値の指定は，省略時仮定値として生成する

LOW（X'00'）クリアは指定なしになる

18
APが渡す項目の下位項目
○
(o)下位項目ダイアログを参照

19
動的変更
×
－

（凡例）

○：反映する。

×：反映しない。

－：なし。

(e)　縦けい線ダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 線の種類 | ○ | 二重線，見えない線は実線に変換する
2 | 線の太さ | ○ | －
3 | 線の位置 | ○
4 | 動的変更 | ×
5 | 制御項目データ名 | ×

（凡例）

○：反映する。

×：反映しない。

－：なし。

(f)　横けい線ダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 線の種類 | ○ | 二重線，見えない線は実線に変換する
2 | 線の太さ | ○ | －
3 | 線の位置 | ○
4 | 動的変更 | ×
5 | 制御項目データ名 | ×

（凡例）

○：反映する。

×：反映しない。

－：なし。

(g)　斜めけい線ダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 向き | ○ | －
2 | 線の種類 | ○ | －
3 | 線の太さ | ○ | －

（凡例）

○：反映する。

－：なし。

(h)　矩形ダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 角の丸め | ○ | －
2 | 種別 | ○
3 | 丸めの半径 | ○ | VOS1で使用する場合は，「標準」に変換する
4 | 線の種類 | ○ | 二重線は実線に変換する
5 | 丸めの場所 | ○ | －
6 | 線の太さ | ○

（凡例）

○：反映する。

－：なし。

(i)　円ダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 線の種類 | ○ | 二重線は実線に変換する
2 | 線の太さ | ○ | －
3 | 網掛け | ×

（凡例）

○：反映する。

×：反映しない。

－：なし。

(j)　円弧ダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 角度 | ○ | －
2 | 線の種類 | ○ | －
3 | 線の太さ | ○ | －

（凡例）

○：反映する。

－：なし。

(k)　網掛けダイアログ

項番 | ドローでの設定値 | 定義文生成時 | 備考
1 | 角の丸め | ○ | －
2 | 種別 | ○
3 | 丸めの半径 | ○ | ターゲット環境がVOS1の場合は，「標準」に変換する
4 | 網掛け | ○ | 薄い網掛け，標準網掛け，濃い網掛け以外の網掛けは，それぞれの濃さに応じて変換する
5 | 丸めの場所 | ○ | －
6 | 線の種類 | ○ | 二重線は実線に変換する
7 | 線の太さ | ○ | －

（凡例）

○：反映する。

－：なし。

(l)　出力バーコードダイアログ

項番
ドローでの設定値
定義文生成時
備考

1
ます（縦）
○
－

2
ます（横）
○

3
ます（行）
○

4
ます（列）
○

5
バーコード種類
○
出力先ターゲットによって，展開できる種類が異なる

VOS3：すべて展開する

VOS1：すべて展開しない

VOSK：JAN8，JAN13，およびCODE39だけ展開する

6
データ文字を印刷する
○
－

7
バーコードの反復
○

8
コメントの記述
×

9
APが渡す項目のデータ名
○

10
APが渡す項目のデータ長
○

11
APが渡す項目の下位項目
○

（凡例）

○：反映する。

×：反映しない。

－：なし。

(m)　固定バーコードダイアログ

項番
ドローでの設定値
定義文生成時
備考

1
ます（縦）
○
－

2
ます（横）
○

3
ます（行）
○

4
ます（列）
○

5
バーコード種類
○
出力先ターゲットによって，展開できる種類が異なる

VOS3：すべて展開する

VOS1：すべて展開しない

VOSK：JAN8，JAN13，およびCODE39だけ展開する

6
データ文字を印刷する
○
－

7
コメントの記述
×

8
バーコード値
○

（凡例）

○：反映する。

×：反映しない。

－：なし。

(n)　出力OCRダイアログ

項番
ドローでの設定値
定義文生成時
備考

1
文字の間隔
○
－

2
文字色
×

3
フィールド反復
○

4
コメントの記述
×

5
APが渡す項目のデータ名
○

6
APが渡す項目のデータ長
○

7
APが渡す項目のデータ型
○
「/」の入った数字編集文字列を指定した場合，「文字（XX）」に変換する

8
APが渡す項目の桁寄せ
○
－

9
APが渡す項目の埋字
○
LOW，HIGHを指定した場合，「埋字しない」に変換する

10
APが渡す項目の初期値
○

初期値は省略時仮定値として生成する

LOW（X'00'）クリアを指定した場合，「指定なし」に変換する

11
APが渡す項目の下位項目
○
(o)下位項目ダイアログを参照

（凡例）

○：反映する。

×：反映しない。

－：なし。

(o)　下位項目ダイアログ

項番
ドローでの設定値
定義文生成時
備考

1
下位項目のデータ名
○
－

2
下位項目の桁
○

3
下位項目のデータ長
○

4
下位項目のデータ型
○

「/」の入った数字編集文字列を指定した場合，「文字（XX）」に変換する

上位項目が，使用目的が「日本語」でデータ型が「文字（XX）」の場合，「文字（XX）」に変換する

（凡例）

○：反映する。

－：なし。

付録D.5　エクスポート機能で変換できるタイプ1/2/R書式の機能範囲

メインフレームで使用するタイプ1/2/R書式の記述文生成時，およびドローでの定義時に使用できる機能の範囲について説明します。

＜この項の構成＞

(1)　生成できる記述文の範囲

(2)　ドローで指定できるます目の範囲

(3)　標準提供しているレイアウトパターンの内容

(4)　生成する記述文の内容とドローとの関係

(5)　ドロー上の設定値と記述文へ展開される値

(1)　生成できる記述文の範囲

(a)　記述文

XMAP3のエクスポート機能で生成できる記述文の範囲を次の表に示します。

表D-15　生成できる記述文

記述文 | 生成 | 備考
FORMS | ○ | －
FRMEND | ○
OPTION | ○ | ターゲット環境がVOS3，VOS1，およびVOSKの場合に生成する
RLINE | ○ | －
ELINE | ○
CIRCLE | ○
ARC | ○
BOX | ○
CHAR | ○
NCODE | ○
ECODE | ○
GRAPHIC | ○
DOT | ○
SECTOR | ×
SEGMENT | ×
SGEND | ×
INCLUDE | ×
NXCODE | ×
NNCODE | ×
NACODE | ×
NKCODE | ×
NHCODE | ×
CHSIZE | ×
LAY | ×
ADJUST | × | －
CONST | ×
CHARC | ×
LINE | ×
CODE | ×
コメント | ×
END | ×
部品ファイル | ×

（凡例）

○：生成する。

×：生成しない。

－：なし。

(b)　生成するオペランド

XMAP3のエクスポート機能で生成できる記述文について，生成できるオペランドの範囲を次の表に示します。

表D-16　生成できるオペランドの範囲（記述文）

記述文 | オペランド | 生成 | 備考
FORMS | 書式名1 | ○ | ターゲット環境がVOS3の場合は生成しない
ます目大 | ○ | －
X長 | ○
Y長 | ○
LIST | ×
書式名2 | ○ | ターゲット環境がVOS3の場合だけ生成する
FRMEND | 名前 | × | －
OPTION | 名前 | × | －
DEPTH | ×
RG | ○ | 5ポイント以外のものを生成する
RLINE | 名前 | × | －
開始X位置 | ○
開始Y位置 | ○
長さ | ○
線種 | ○
線の太さ | ○
繰り返し間隔 | ×
繰り返し回数 | ×
繰り返し向き | ×
ELINE | 名前 | × | －
開始X位置 | ○
開始Y位置 | ○
終了X位置 | ○
終了Y位置 | ○
線種 | ○
線の太さ | ○
繰り返し間隔 | ×
繰り返し回数 | ×
繰り返し向き | ×
CIRCLE | 名前 | × | －
X位置 | ○
Y位置 | ○
半径 | ○
線種 | ○
線の太さ | ×
繰り返し間隔 | ×
繰り返し回数 | ×
繰り返し向き | ×
ARC | 名前 | × | －
X位置 | ○
Y位置 | ○
半径 | ○
角度 | ○
線種 | ○
線の太さ | ×
繰り返し間隔 | ×
繰り返し回数 | ×
繰り返し向き | ×
CHAR | 名前 | × | －
X位置 | ○
Y位置 | ○
文字属性 | ○
文字間隔 | ○
文字数 | ○
文字の並び | ×
文字データ名 | ○
繰り返し間隔 | ×
繰り返し回数 | ×
繰り返し向き | ×
NCODE | 名前 | ○ | －
漢字文字列 | ○
ECODE | 名前 | ○ | －
半角文字列 | ○
GRAPHIC | 名前 | × | －
X位置 | ○
Y位置 | ○
X長 | ○
Y長 | ○
網掛け種別 | ○
ドットデータ名 | ○
繰り返し間隔 | ×
繰り返し回数 | ×
繰り返し向き | ×
図形変換種別 | ×
コーナ形式 | ○
コーナ半径 | ○
DOT | 名前 | ○ | －
X位置 | ○
Y位置 | ○
ドット列 | ○
BOX | 名前 | × | －
X位置 | ○
Y位置 | ○
X長 | ○
Y長 | ○
線種 | ○
線の太さ | ○
繰り返し間隔 | ×
繰り返し回数 | ×
繰り返し向き | ×
コーナ形式 | ○
コーナ半径 | ○

（凡例）

○：生成する。

×：生成しない。

－：なし。

(2)　ドローで指定できるます目の範囲

(a)　行間隔と指定可能な最大行数

行間隔と指定できる最大行数，および組み合わせられる文字サイズについて次の表に示します。

表D-17　行間隔と最大行数

行間隔
（ドット数）
最大行数
（ドット数）
組み合わせられる文字サイズ※

3LPI（80）
68ます（5,440）
すべての文字サイズ

4LPI（60）
91ます（5,460）
すべての文字サイズ

6LPI（40）
127ます（5,080）
すべての文字サイズ

8LPI（30）
127ます（3,810）
5ポイント，7ポイント，15CPI

10LPI（24）
127ます（3,048）
5ポイント，7ポイント

12LPI（20）
127ます（2,540）
5ポイント

注※

組み合わせられる文字サイズは，用紙の標準属性としての文字サイズです。配置するフィールドの文字サイズは，それぞれ変更できます。

(b)　文字サイズ，文字の間隔と指定可能な最大列数

それぞれの文字サイズについて，指定できる文字の間隔と最大列数を次の表に示します。

表D-18　文字サイズ，文字の間隔，最大列数

文字サイズ
（ドット数）
文字の間隔
（ドット数）
決定する
列間隔
最大列数
（ドット数）

5ポイント（8）
0ポイント（0）
8ドット
255ます（2,040）

1ポイント（2）
10ドット
255ます（2,550）

2ポイント（3）
11ドット
255ます（2,805）

3ポイント（5）
13ドット
255ます（3,315）

4ポイント（6）
14ドット
255ます（3,570）

5ポイント（8）
16ドット
255ます（4,080）

6ポイント（9）
17ドット
255ます（4,335）

7ポイント（11）
19ドット
255ます（4,845）

7ポイント（12）
0ポイント（0）
12ドット
255ます（3,060）

1ポイント（2）
14ドット
255ます（3,570）

2ポイント（3）
15ドット
255ます（3,825）

3ポイント（5）
17ドット
255ます（4,335）

4ポイント（6）
18ドット
255ます（4,590）

5ポイント（8）
20ドット
255ます（5,100）

6ポイント（9）
21ドット
255ます（5,355）

7ポイント（11）
23ドット
237ます（5,451）

9ポイント（16）
0ポイント（0）
16ドット
255ます（4,080）

1ポイント（2）
18ドット
255ます（4,590）

2ポイント（3）
19ドット
255ます（4,845）

3ポイント（5）
21ドット
255ます（5,355）

4ポイント（6）
22ドット
248ます（5,456）

5ポイント（8）
24ドット
227ます（5,448）

6ポイント（9）
25ドット
218ます（5,450）

7ポイント（11）
27ドット
202ます（5,454）

12ポイント（20）
0ポイント（0）
20ドット
255ます（5,100）

1ポイント（2）
22ドット
248ます（5,456）

2ポイント（3）
23ドット
237ます（5,451）

3ポイント（5）
25ドット
218ます（5,450）

4ポイント（6）
26ドット
210ます（5,460）

5ポイント（8）
28ドット
195ます（5,460）

6ポイント（9）
29ドット
188ます（5,452）

7ポイント（11）
31ドット
176ます（5,456）

(c)　列間隔と指定可能な最大列数

列間隔をCPI指定した場合の，指定できる最大列数と文字サイズを次の表に示します。

表D-19　列間隔と最大列数

列間隔
（ドット数）
最大列数
（ドット数）
仮定する
文字サイズ
文字の間隔
（ドット数）
備考

10CPI（24）
227ます（5,448）
9ポイント
8
6LPIとの組み合わせ

12CPI（20）
255ます（5,100）
9ポイント
4
6LPIとの組み合わせ

15CPI（16）
255ます（4,080）
7ポイント
4
6LPI，8LPIとの組み合わせだけ

注

また，CPI指定を行うと，定義するフィールド単位に文字サイズ，文字の間隔を変更できません。フィールド単位に文字サイズを変更する場合は，文字サイズ，文字の間隔を組み合わせてください。例を次の表に示します。

表D-20　文字サイズと文字間隔の組み合わせの例

使用したい列間隔 | 指定する文字サイズ | 指定する文字の間隔
10CPI（24ドット） | 9ポイント（16ドット） | 5ポイント（8ドット）
12CPI（20ドット） | 7ポイント（12ドット） | 5ポイント（8ドット）
15CPI（16ドット） | 9ポイント（16ドット） | 0ポイント（0ドット）

(3)　標準提供しているレイアウトパターンの内容

書式オーバレイで標準提供しているレイアウトパターンの内容を次の表に示します。

表D-21　標準提供レイアウトパターン（書式オーバレイ）

パターン名称
行数
（ドット数）
列数
（ドット数）

A4縦 9ポイント文字，5ポイント間隔（10CPI），6LPI
66（2,640）
76（1,824）

A4縦 9ポイント文字，2ポイント間隔（12CPI），6LPI
66（2,640）
97（1,843）

A4縦 7ポイント文字，5ポイント間隔（12CPI），6LPI
66（2,640）
92（1,840）

A4縦 9ポイント文字，0ポイント間隔（15CPI），6LPI
66（2,640）
115（1,840）

A4縦 7ポイント文字，2ポイント間隔（15CPI），8LPI
88（2,640）
123（1,845）

A4縦 7ポイント文字，4ポイント間隔，8LPI
88（2,640）
102（1,836）

A4縦 7ポイント文字，0ポイント間隔，6LPI
66（2,640）
153（1,836）

A4縦 7ポイント文字，0ポイント間隔，8LPI
88（2,640）
153（1,836）

A4横 9ポイント文字，5ポイント間隔（10CPI），6LPI
46（1,840）
111（2,664）

A4横 9ポイント文字，2ポイント間隔（12CPI），6LPI
46（1,840）
140（2,660）

A4横 7ポイント文字，5ポイント間隔（12CPI），6LPI
46（1,840）
133（2,660）

A4横 9ポイント文字，0ポイント間隔（15CPI），6LPI
46（1,840）
166（2,656）

A4横 7ポイント文字，2ポイント間隔（15CPI），8LPI
61（1,830）
178（2,670）

A4横 7ポイント文字，4ポイント間隔，8LPI
61（1,830）
148（2,664）

A4横 7ポイント文字，0ポイント間隔，6LPI
46（1,840）
222（2,664）

A4横 7ポイント文字，0ポイント間隔，8LPI
61（1,830）
222（2,664）

B4縦 9ポイント文字，5ポイント間隔（10CPI），6LPI
82（3,280）
95（2,280）

B4縦 9ポイント文字，2ポイント間隔（12CPI），6LPI
82（3,280）
120（2,280）

B4縦 7ポイント文字，5ポイント間隔（12CPI），6LPI
82（3,280）
114（2,280）

B4縦 9ポイント文字，0ポイント間隔（15CPI），6LPI
82（3,280）
143（2,288）

B4縦 7ポイント文字，2ポイント間隔（15CPI），8LPI
110（3,300）
152（2,280）

B4縦 7ポイント文字，4ポイント間隔，8LPI
110（3,300）
127（2,286）

B4縦 7ポイント文字，0ポイント間隔，6LPI
82（3,280）
190（2,280）

B4縦 7ポイント文字，0ポイント間隔，8LPI
110（3,300）
190（2,280）

B4横 9ポイント文字，5ポイント間隔（10CPI），6LPI
57（2,280）
137（3,288）

B4横 9ポイント文字，2ポイント間隔（12CPI），6LPI
57（2,280）
173（3,287）

B4横 7ポイント文字，5ポイント間隔（12CPI），6LPI
57（2,280）
165（3,300）

B4横 9ポイント文字，0ポイント間隔（15CPI），6LPI
57（2,280）
206（3,296）

B4横 7ポイント文字，2ポイント間隔（15CPI），8LPI
76（2,280）
220（3,300）

B4横 7ポイント文字，4ポイント間隔，8LPI
76（2,280）
183（3,294）

B4横 7ポイント文字，0ポイント間隔，6LPI
57（2,280）
255（3,060）

B4横 7ポイント文字，0ポイント間隔，8LPI
76（2,280）
255（3,060）

A5縦 9ポイント文字，5ポイント間隔（10CPI），6LPI
46（1,840）
52（1,248）

A5縦 9ポイント文字，2ポイント間隔（12CPI），6LPI
46（1,840）
66（1,254）

A5縦 7ポイント文字，5ポイント間隔（12CPI），6LPI
46（1,840）
63（1,260）

A5縦 9ポイント文字，0ポイント間隔（15CPI），6LPI
46（1,840）
78（1,248）

A5縦 7ポイント文字，2ポイント間隔（15CPI），8LPI
61（1,830）
84（1,260）

A5縦 7ポイント文字，4ポイント間隔，8LPI
61（1,830）
70（1,260）

A5縦 7ポイント文字，0ポイント間隔，6LPI
46（1,840）
105（1,260）

A5縦 7ポイント文字，0ポイント間隔，8LPI
61（1,830）
105（1,260）

A5横 9ポイント文字，5ポイント間隔（10CPI），6LPI
31（1,240）
76（1,824）

A5横 9ポイント文字，2ポイント間隔（12CPI），6LPI
31（1,240）
97（1,843）

A5横 7ポイント文字，5ポイント間隔（12CPI），6LPI
31（1,240）
92（1,840）

A5横 9ポイント文字，0ポイント間隔（15CPI），6LPI
31（1,240）
115（1,840）

A5横 7ポイント文字，2ポイント間隔（15CPI），8LPI
42（1,260）
123（1,845）

A5横 7ポイント文字，4ポイント間隔，8LPI
42（1,260）
102（1,836）

A5横 7ポイント文字，0ポイント間隔，6LPI
31（1,240）
153（1,836）

A5横 7ポイント文字，0ポイント間隔，8LPI
42（1,260）
153（1,836）

B5縦 9ポイント文字，5ポイント間隔（10CPI），6LPI
57（2,280）
65（1,560）

B5縦 9ポイント文字，2ポイント間隔（12CPI），6LPI
57（2,280）
83（1,577）

B5縦 7ポイント文字，5ポイント間隔（12CPI），6LPI
57（2,280）
79（1,580）

B5縦 9ポイント文字，0ポイント間隔（15CPI），6LPI
57（2,280）
98（1,568）

B5縦 7ポイント文字，2ポイント間隔（15CPI），8LPI
76（2,280）
105（1,575）

B5縦 7ポイント文字，4ポイント間隔，8LPI
76（2,280）
87（1,566）

B5縦 7ポイント文字，0ポイント間隔，6LPI
57（2,280）
131（1,572）

B5縦 7ポイント文字，0ポイント間隔，8LPI
76（2,280）
131（1,572）

B5横 9ポイント文字，5ポイント間隔（10CPI），6LPI
39（1,560）
95（2,280）

B5横 9ポイント文字，2ポイント間隔（12CPI），6LPI
39（1,560）
120（2,280）

B5横 7ポイント文字，5ポイント間隔（12CPI），6LPI
39（1,560）
114（2,280）

B5横 9ポイント文字，0ポイント間隔（15CPI），6LPI
39（1,560）
143（2,288）

B5横 7ポイント文字，2ポイント間隔（15CPI），8LPI
52（1,560）
152（2,280）

B5横 7ポイント文字，4ポイント間隔，8LPI
52（1,560）
127（2,286）

B5横 7ポイント文字，0ポイント間隔，6LPI
39（1,560）
190（2,280）

B5横 7ポイント文字，0ポイント間隔，8LPI
52（1,560）
190（2,280）

A3縦 9ポイント文字，5ポイント間隔（10CPI），6LPI
95（3,800）
111（2,664）

A3縦 9ポイント文字，2ポイント間隔（12CPI），6LPI
95（3,800）
140（2,660）

A3縦 7ポイント文字，5ポイント間隔（12CPI），6LPI
95（3,800）
133（2,660）

A3縦 9ポイント文字，0ポイント間隔（15CPI），6LPI
95（3,800）
166（2,656）

A3縦 7ポイント文字，2ポイント間隔（15CPI），8LPI
121（3,630）
177（2,655）

A3縦2 7ポイント文字，2ポイント間隔（15CPI），8LPI
127（3,810）
177（2,655）

A3縦 7ポイント文字，4ポイント間隔，8LPI
121（3,630）
148（2,664）

A3縦2 7ポイント文字，4ポイント間隔，8LPI
127（3,810）
148（2,664）

A3縦 7ポイント文字，0ポイント間隔，6LPI
95（3,800）
222（2,664）

A3縦 7ポイント文字，0ポイント間隔，8LPI
121（3,630）
222（2,664）

A3縦2 7ポイント文字，0ポイント間隔，8LPI
127（3,810）
222（2,664）

A3横 9ポイント文字，5ポイント間隔（10CPI），6LPI
66（2,640）
159（3,816）

A3横 9ポイント文字，2ポイント間隔（12CPI），6LPI
66（2,640）
201（3,819）

A3横 7ポイント文字，5ポイント間隔（12CPI），6LPI
66（2,640）
191（3,820）

A3横 9ポイント文字，0ポイント間隔（15CPI），6LPI
66（2,640）
239（3,824）

A3横 7ポイント文字，2ポイント間隔（15CPI），8LPI
88（2,640）
255（3,825）

A3横 7ポイント文字，4ポイント間隔，8LPI
88（2,640）
212（3,816）

A3横 7ポイント文字，0ポイント間隔，6LPI
66（2,640）
255（3,060）

A3横 7ポイント文字，0ポイント間隔，8LPI
88（2,640）
255（3,060）

(4)　生成する記述文の内容とドローとの関係

ドローで定義できるオブジェクトは，すべて記述文として作成しますが，個々のオブジェクトの属性には，生成時に反映されないものがあります。

ここでは，ドローで指定できる属性の中で，生成する記述文に反映するもの，反映しないものを示します。また，生成時に変換されるものは，その変換規則を示します。

PC上でのテスト印刷では，記述文生成時に反映されない属性が有効となります。テスト印刷で内容を確認する場合は，定義時に該当属性を指定しないでください。

(a)　書式属性ダイアログ

項番 | ドローでの設定値 | 記述文生成時 | 備考
1 | 上マージン | × | －
2 | 左マージン | × | －
3 | レイアウト領域の縦サイズ | ○ | －
4 | レイアウト領域の横サイズ | ○ | －
5 | 単位の選択 | × | －
6 | 給紙サイズ | × | －
7 | コメントの記述 | × | －
8 | 印刷ドキュメント名 | × | －
9 | ます目設定 | ○ | －
10 | 行の間隔 | ○ | －
11 | 文字の間隔 | ○ | －
12 | 文字サイズ | ○ | －

（凡例）

○：反映する。

×：反映しない。

－：なし。

(b)　固定フィールドダイアログ

項番 | ドローでの設定値 | 記述文生成時 | 備考
1 | 文字の拡大 | × | 「標準」として扱う
2 | 文字の書体 | ○ | －
3 | 文字サイズ | ○
4 | 文字の強調 | × | 「標準」として扱う
5 | 文字の間隔 | ○ | －
6 | 網掛け | × | 「なし」として扱う
7 | テキスト | ○ | －
8 | テキスト揃え | ○

（凡例）

○：反映する。

×：反映しない。

－：なし。

(c)　縦けい線ダイアログ

項番 | ドローでの設定値 | 記述文生成時 | 備考
1 | 線の種類 | ○ | 付録D.5(5)(a)を参照
2 | 線の太さ | ○ | 付録D.5(5)(b)を参照
3 | 線の位置 | ○ | －

（凡例）

○：反映する。

－：なし。

(d)　横けい線ダイアログ

項番 | ドローでの設定値 | 記述文生成時 | 備考
1 | 線の種類 | ○ | 付録D.5(5)(a)を参照
2 | 線の太さ | ○ | 付録D.5(5)(b)を参照
3 | 線の位置 | ○ | －

（凡例）

○：反映する。

－：なし。

(e)　斜めけい線ダイアログ

項番 | ドローでの設定値 | 記述文生成時 | 備考
1 | 向き | ○ | －
2 | 線の種類 | ○ | 付録D.5(5)(a)を参照
3 | 線の太さ | ○ | 付録D.5(5)(b)を参照

（凡例）

○：反映する。

－：なし。

(f)　矩形ダイアログ

項番 | ドローでの設定値 | 記述文生成時 | 備考
1 | 角の丸め | ○ | －
2 | 種別 | ○
3 | 丸めの半径 | ○ | 付録D.5(5)(c)を参照
4 | 線の種類 | ○ | 付録D.5(5)(a)を参照
5 | 丸めの場所 | ○ | －
6 | 線の太さ | ○ | 付録D.5(5)(b)を参照

（凡例）

○：反映する。

－：なし。

(g)　円ダイアログ

項番 | ドローでの設定値 | 記述文生成時 | 備考
1 | 線の種類 | ○ | 付録D.5(5)(a)を参照
2 | 線の太さ | × | 「細」として扱う
3 | 網掛け | × | 「網掛けなし」として扱う

（凡例）

○：反映する。

×：反映しない。

(h)　円弧ダイアログ

項番 | ドローでの設定値 | 記述文生成時 | 備考
1 | 角度 | ○ | 小，中，大は，それぞれ30度，60度，90度に相当する
2 | 線の種類 | ○ | 付録D.5(5)(a)を参照
3 | 線の太さ | × | 「細」として扱う

（凡例）

○：反映する。

×：反映しない。

(i)　網掛けダイアログ

項番 | ドローでの設定値 | 記述文生成時 | 備考
1 | 角の丸め | ○ | －
2 | 種別 | ○
3 | 丸めの半径 | ○ | 付録D.5(5)(c)を参照
4 | 網掛け | ○ | 付録D.5(5)(d)を参照
5 | 丸めの場所 | ○ | －
6 | 線の種類 | ○ | 付録D.5(5)(a)を参照
7 | 線の太さ | ○ | 付録D.5(5)(b)を参照

（凡例）

○：反映する。

－：なし。

(j)　固定グラフィックダイアログ

項番 | ドローでの設定値 | 記述文生成時 | 備考
1 | 領域に合わせて表示する | × | 領域の大きさをビットマップファイルより小さくしている場合，生成する記述文がエラーとなる場合がある
2 | 枠付き | × | －

（凡例）

×：反映しない。

－：なし。

(5)　ドロー上の設定値と記述文へ展開される値

ドローに設定した属性値がどのような値で記述文に展開されるか，その内容を次に示します。

(a)　線の種類

線種は，次に示す規則に従って決定します。

ドローでの指定 | 記述文に展開する値 | 備考
実線 | 1 | 実線
破線 | 5 | 8ドット点線
一点鎖線 | 6 | 8ドット一点鎖線
二点鎖線 | 8 | 二点鎖線
点線 | 9 | 1ドット点線
二重線 | 1 | 実線が1本

注

ドロー上の見え方と実際の印刷結果は異なります。

(b)　線の太さ

線の太さは，次に示す規則に従って決定します。

ドローでの指定 | 記述文に展開する値
細 | 1
中 | 3
太 | 5
極太 | 7

(c)　丸め半径

丸め半径は，次に示す規則に従って決定します。

ドローでの指定 | 記述文に展開する値
小 | 1
標準 | 3
大 | 4

注

ドロー上の見え方と実際の印刷結果は異なります。

(d)　網掛け種別

網掛け種別は次に示す規則に従い決定します。

ドローでの指定値
記述文に展開する値
備考

極薄網掛け
薄い網掛け

8

8×8に2ドット

標準網掛け

6

6×6に2ドット

濃い網掛け
極濃網掛け

4

4×4に2ドット

薄い右下
標準右下

1，RDWN
RDWN  DOT (,0),(,0), '*'
RDWN  DOT (,1),(,1), '*'
RDWN  DOT (,2),(,2), '*'
RDWN  DOT (,3),(,3), '*'
RDWN  DOT (,4),(,4), '*'
RDWN  DOT (,5),(,5), '*'
RDWN  DOT (,6),(,6), '*'
RDWN  DOT (,7),(,7), '*'

薄い左下
標準左下

1，RUP
RUP  DOT (,7),(,0), '*'
RUP  DOT (,6),(,1), '*'
RUP  DOT (,5),(,2), '*'
RUP  DOT (,4),(,3), '*'
RUP  DOT (,3),(,4), '*'
RUP  DOT (,2),(,5), '*'
RUP  DOT (,1),(,6), '*'
RUP  DOT (,0),(,7), '*'

薄い格子
標準格子

1，MESH
MESH  DOT (,0),(,0), '*'
MESH  DOT (,1),(,1), '*     *'
MESH  DOT (,2),(,2), '*   *'
MESH  DOT (,3),(,3), '* *'
MESH  DOT (,4),(,4), '*'
MESH  DOT (,3),(,5), '* *'
MESH  DOT (,2),(,6), '*   *'
MESH  DOT (,1),(,7), '*     *'

薄い横線
標準横線

1，HRZN
HRZN  DOT (,0),(,3), '********'

薄い縦線
標準縦線

1，VERT
VERT  DOT (,3),(,0), '*'
VERT  DOT (,3),(,1), '*'
VERT  DOT (,3),(,2), '*'
VERT  DOT (,3),(,3), '*'
VERT  DOT (,3),(,4), '*'
VERT  DOT (,3),(,5), '*'
VERT  DOT (,3),(,6), '*'
VERT  DOT (,3),(,7), '*'

注

ドロー上の見え方と実際の印刷結果が異なります。

付録E　用語解説

（英字）

AP（Application Program）

メインフレーム上に置かれる，業務用のプログラムです。

BMP（Batched Message Processing Program）

バッチメッセージ処理プログラムの略称です。センタオペレータによって起動されるプログラムです。

C/Sシステム（Client / Server System）

クライアントとサーバで処理を分散する業務形態です。

一つの処理をネットワーク上のクライアントとサーバで分担する機器構成モデル，または処理方式です。

CLOSEインタフェース機能

仮想端末の使用を終了するGCASTのインタフェース機能です。

CPI（Characters Per Inch）

字ピッチのことです。25.4mm（1インチ）当たりの文字数で示される数値です。

CUI（Character User Interface）

ユーザとの対話に，主に文字を使用する方式です。画面への出力も，ユーザからの入力も，基本的に文字だけを使用します。

dpi（dots per inch）

プリンタの印刷精度を示す数値で，25.4mm（1インチ）当たりのドット数を指します。この数値が大きいプリンタほど，精密な印刷ができます。

EUC（Extended UNIX Code）

ターゲットが「AIX」，「Linux」，「Solaris」の場合に使用する文字コードです。

GUI（Graphical User Interface）

ユーザとの対話に，文字以外にチェックボタンやポップアップメニューなどを活用する方式です。画面への出力には画像を利用でき，ユーザからの入力も，キーボードだけでなくマウスを利用できます。

HNA（Hitachi Network Architecture）

日立ネットワークアーキテクチャの略称です。日立製作所独自の，標準化されたユーザインタフェースとネットワーク管理方法を提供する通信システム体系です。

LANアダプタ

メインフレームとLANとを接続し，TCP/IPによるメインフレームとLANとの通信を可能にするための内蔵型のLAN制御機構です。

LIC（LAN Interface Control）

メインフレームとLANとを接続し，TCP/IPによるメインフレームとLANとの通信を可能にするための機器です。

MPP（Message Processing Program）

メッセージ処理プログラムの略称です。オンライン端末によって起動されるプログラムです。

OPENインタフェース機能

仮想端末の使用を開始するGCASTのインタフェース機能です。

PDL（Page Description Language）

ページ記述言語の略で，プリンタが持つ固有の印刷データ形式です。プリンタ制御言語の一つです。

RPC（Remote Procedure Call）

C/Sシステムで，APを実行するプロセス間で通信する機能です。OpenTP1を利用するAPは，ほかのシステムのAPとRPCで通信します。RPCを使用するときは，通信先がC/SシステムのどのノードにあるAPかを意識する必要がありません。

XMAP3でTP1/Client/Pを利用する場合，PC上の画面管理プログラムとメインフレームのAPとのやり取りにRPCを使用できます。

TRANSCEIVEインタフェース機能

PC上の画面の入出力やマッピングオプションの変更などを処理するGCASTのインタフェース機能です。

（ア行）

インタフェース機能

VOS1でBCF/GCASTを，またはVOSKでOSCF/GCASTを使用する場合の，メインフレームからPCに対して発行される処理要求です。OPENインタフェース機能，TRANSCEIVEインタフェース機能，CLOSEインタフェース機能の3種類があります。メインフレームで実行されたインタフェース機能は，PC上のGCASTで処理されます。

インポート機能

ユティリティの機能の一つで，メインフレーム用のパネル定義文をPC用のマップ定義ファイルに変換できます。

エクスポート機能

ユティリティの機能の一つで，PC用のマップ定義ファイルから，メインフレームで利用するためのパネル定義文を生成できます。利用する場合は，あらかじめターゲット環境を設定してください。

オープン命令

メインフレーム上のAPから，PC上の画面管理プログラムに送信される命令です。この命令を受け取った画面管理プログラムでは，XMAP3にオープン要求を発行して，XMAP3の仮想端末をオープンします。

オープン要求

PC上で，画面管理プログラムからXMAP3に対して発行される命令です。この命令を受け取ったXMAP3では，仮想端末をオープンして入出力処理を開始します。

（カ行）

隠しフィールド

画面に表示されないフィールドで，画面の入力時に，指定された定数をメインフレーム上のAPに伝える機能があります。DCCM3やOpenTP1などで使用するトランザクションコードを定義するために使用します。

拡張ホストアクセス

メインフレーム上のAPからPC上のAPを起動したり，メインフレーム上のAPとPC上のAPとの間でデータを交換したりするための機能です。

画面管理プログラム

メインフレーム上のAPとXMAP3とのデータのやり取りを中継する，PC上のプログラムです。メインフレーム上のAPからの命令に応じてXMAP3に要求を発行し，XMAP3からの出力をメインフレームに送信します。

クローズ命令

メインフレーム上のAPから，PC上の画面管理プログラムに送信される命令です。この命令を受け取った画面管理プログラムでは，XMAP3にクローズ要求を発行して，XMAP3の仮想端末をクローズします。

クローズ要求

PC上で，画面管理プログラムからXMAP3に対して発行される命令です。この命令を受け取ったXMAP3では，仮想端末をクローズして入出力処理を終了します。

（サ行）

受信メッセージテーブル

オンライン環境の通信論理マップで，PCからデータを受信するための部分です。メインフレーム上のAPの入力命令で使用します。

出力命令

オンライン環境で，メインフレーム上のAPからPC上の画面管理プログラムに送信される命令です。この命令を受け取った画面管理プログラムでは，XMAP3に出力要求，または入出力要求を発行して，画面の入出力または帳票の出力を行います。

出力要求

PC上で，画面管理プログラムからXMAP3に対して発行される命令です。この命令を受け取ったXMAP3では，帳票の出力処理を行います。

スタンドアロン構成

このマニュアルでは，LAN上のPCが，ゲートウェイなどを経由せず，それぞれ個別にメインフレームにアクセスするシステム構成を指します。

送信メッセージテーブル

オンライン環境の通信論理マップで，PCへデータを送信するための部分です。メインフレーム上のAPのオープン命令，出力命令，およびクローズ命令で使用します。

（タ行）

ターゲット環境

XMAP3で画面・帳票を定義するときに選択する環境です。定義した画面・帳票を運用する環境に応じて，次の11種類が用意されています。

VOS3用の画面・帳票開発

VOS1用の画面・帳票開発

VOSK用の画面・帳票開発

メインフレーム-PC分散用の画面・帳票開発

AIX（文字コード：シフトJIS）用の画面・帳票開発

AIX（文字コード：EUC）用の画面・帳票開発

HP-UX（文字コード：シフトJIS）用の画面・帳票開発

Solaris（文字コード：シフトJIS）用の画面・帳票開発

Solaris（文字コード：EUC）用の画面・帳票開発

Linux（文字コード：EUC）用の画面・帳票開発

Windows用の画面・帳票開発

通信論理マップ

メインフレームとPCの間でやり取りされるデータを扱うマップです。メインフレームとPCの間では，通信論理マップのデータをやり取りします。

（ナ行）

入出力命令

対話環境で，メインフレーム上のAPからPC上の画面管理プログラムに送信される命令です。この命令を受け取った画面管理プログラムでは，XMAP3に出力要求，または入出力要求を発行して，画面・帳票の入出力処理を行い，結果をメインフレーム上のAPに送信します。APでは結果を受信します。

入出力要求

PC上で，画面管理プログラムからXMAP3に対して発行される命令です。この命令を受け取ったXMAP3では，画面の入出力処理を行います。編集されたデータは，画面管理プログラムからメインフレーム上のAPに送信されます。

入力命令

オンライン環境で，メインフレーム上のAPがPC上の画面管理プログラムからデータを受信する命令です。

（ハ行）

パネル定義文

メインフレームのXMAPでマップ生成するための定義文ファイルです。ユティリティの「インポート」でパネル定義文からPC用のマップ定義ファイルに変換できます。また，「エクスポート」でマップ定義ファイルからパネル定義文を生成することもできます。

プレロードマップ

タイプ3書式としてオブジェクトの位置などを決めるマップです。メインフレームのXMAP2/FOGで作成されます。

分散処理

画面・帳票の入出力部分をPCに，データの処理をメインフレームに分散する処理のことです。メインフレームだけで運用する場合に比べ，メインフレームの負荷を軽くできます。

（マ行）

マップサーバ

PC側がC/Sシステム構成のとき，メインフレームとの通信および物理マップを受け持つサーバです。クライアント機は画面・帳票の入出力だけを行います。メインフレーム側のOSがVOS1またはVOSKで，通信制御がGCASTの場合だけ使用できます。

命令

メインフレーム上のAPからPC上の画面管理プログラムに対して送信される指示を指します。

（ヤ行）

要求

PC上で，画面管理プログラムからXMAP3に対して行われる制御を指します。

索引

[記号]
[数字]
[Ａ][Ｂ][Ｃ][Ｄ][Ｅ][Ｆ][Ｇ][Ｈ][Ｉ][Ｊ][Ｋ][Ｌ][Ｍ][Ｎ][Ｏ][Ｐ][Ｒ][Ｓ][Ｔ][Ｕ][Ｖ][Ｗ][Ｘ]
[ア行][カ行][サ行][タ行][ナ行][ハ行][マ行][ヤ行][ラ行]

(記号)

&#WSコマンド変数

(数字)

1,880字を超える外字を使用する

1,880字を超える外字を使用する

1,880字を超える外字を使用する

1,880文字を超える外字

1,880文字を超える外字

1,880文字を超える外字

1,880文字を超える外字

16進指定（DFC）の動的変更

16進指定（DFC）の動的変更

16進指定（DFC）の動的変更

16進指定（DFC）の動的変更

16進数による指定

(英字)

(Ａ)

AP

AP作成時の注意事項

AP作成時の注意事項

(Ｂ)

BCF/GCASTでのインタフェース

BCF/GCASTでの拡張ホストアクセス

BMP

BMP

(Ｃ)

C/S560 HNA-Gateway

C/S560 HNA-Gateway

C/S560 HNA-Gateway

C/Sシステム

CLOSEインタフェース機能

CLOSEインタフェース機能

CLOSEインタフェース機能

COBOL拡張ライブラリ

COBOL拡張ライブラリ

COBOLによる画面管理プログラム

COBOLによる画面管理プログラム

CommuniNetゲートウェイ

CommuniNetゲートウェイ

CommuniNetゲートウェイ

CommuniNetの設定

CommuniNetの設定

CommuniNetの設定

CPI

CSS560/HNA

CSS560/HNA

CSS560/HNA

CTLFLD文（TYPE=(LNG,X)）

CTLFLD文（TYPE=CNTRL）

CTLFLD文（TYPE=INC,ATTR,(LNG,X)以外）

CTLFLD文（TYPE=INC）

CUI

CUI画面からGUI画面への移行

(Ｄ)

DCCM3使用時のトラブル

DCCM3で2,920バイト以内のデータをやり取りする（拡張ホストアクセス）

DCCM3で2,920バイトを超えるデータをやり取りする（拡張ホストアクセス）

DCCM3での拡張ホストアクセス（論理マップ長＞2,920バイトの場合）

DCCM3での拡張ホストアクセス（論理マップ長≦2,920バイトの場合）

DCCM3の機能を代替する

DCCM3の設定

dpi

DUMMY

(Ｅ)

EAGLE/4GL

EAGLE2

EAGLE2

EUC

EXCNEX32.CBL

EXCNEX32.CBL

EXCNEX32.CPY

EXCNEX32.CPY

EXCNEX32.LIB

EXCNEX32.LIB

EXHA32.CBL

EXHA32.CBL

EXHA32.CPY

EXHA32.CPY

EXHA32.H

EXHA32.H

EXHA32.LIB

EXHA32.LIB

EXHA32.LIB

EXHA32.LIB

(Ｆ)

FCBイメージ

FCBイメージの印刷領域

FORMS文に展開される書式名

(Ｇ)

GCASTの設定

GUI

GUIへの移行

(Ｈ)

HNA

HSMHPROC

HSMHPROC

(Ｉ)

INCオペランド

(Ｊ)

jsvwhcls

jsvwhcls

jsvwhopn

jsvwhopn

jsvwhsnd

jsvwhsnd

jsvwhtrn

jsvwhtrn

(Ｋ)

KBロック状態

KBロック状態

KCORAL

KCORAL

KEIS'83とKEIS'78の漢字コードの違い

KEIS'83とKEIS'78のけい線コードの違い

(Ｌ)

LANアダプタ

LIC

LOGSEG文（CLEARオペランド，CODERRオペランド，LITRLオペランド，GENRTオペランド）

(Ｍ)

MHCLOSE

MHOPEN

MHSEND

MHTRANS

MPP

MPP

(Ｎ)

NAMEオペランドの接頭語がマップ名と同じ

NETM/DM

NETM/DM

(Ｏ)

ONLNPRC2.C

ONLNPRC2.C

ONLNPRC2.C

ONLNPRC2.CBL

ONLNPRC2.CBL

ONLNPRC2.CBL

ONLNPROC.C

ONLNPROC.C

ONLNPROC.C

OPENインタフェース機能

OPENインタフェース機能

OPENインタフェース機能

OSCF/GCAST

OSCF/GCASTでの拡張ホストアクセス

(Ｐ)

PAGECモジュール

PAGECモジュールの論理ページ

PAGECモジュールの論理ページサイズ

PC側の通信制御に必要なソフトウェア

PC側の入出力処理

PC側の入出力処理

PC上に転送

PDL

PHSEG文（INCオペランド）

PHSEG文（MODCTLオペランド）

PHSEG文（NULLオペランド）

(Ｒ)

RPC

(Ｓ)

SEWB3

SEWB3

(Ｔ)

TCP/IPの設定

TCP/IPの設定

TCP/IPの設定

TIOP3でのインタフェース

TIOP3での拡張ホストアクセス

TP1/Client/P

TP1/Client/PによるBMPの処理

TP1/Client/PによるMPPの処理

TP1/Client/Pを使ったMPPの処理でトランザクションを変更する

TP1/Client/Pを使って2,920バイトを超えるデータをやり取りする

TP1/Client/Pを使って可変長のデータをやり取りする

TPCLPRC2.C

TPCLPROC.C

TRANSCEIVEインタフェース機能

TRANSCEIVEインタフェース機能

TRANSCEIVEインタフェース機能

TSSPROC.C

TSSPROC.C

(Ｕ)

Unicodeの外字

Unicodeの外字

Unicodeの外字

(Ｖ)

VARFLD文

Visual C++

Visual C++

VOS1からPCへの転送

VOS1からPCへの転送

VOS1側のインタフェース

VOS1に記述文ファイルを転送する

VOS1にパネル定義文ファイルを転送する

VOS3からPCへの転送

VOS3からPCへの転送

VOS3側のインタフェース

VOS3に記述文ファイルを転送する

VOS3にパネル定義文ファイルを転送する

VOSKからPCへの転送

VOSKからPCへの転送

VOSKに記述文ファイルを転送する

VOSKにパネル定義文ファイルを転送する

(Ｗ)

WAN経由のゲートウェイ構成

WAN経由のゲートウェイ構成

WAN経由のゲートウェイ構成

(Ｘ)

X3EF201-I

X3EF202-I

X3EF901-W

X3EF902-W

X3EF903-W

X3EF904-W

X3EF905-W

X3EF906-W

X3EH201-I

X3EH201-I

X3EH202-I

X3EH203-I

X3EH203-I

X3EH204-I

X3EH205-I

X3EH205-I

X3EH205-I

X3EH205-I

X3EH206-I

X3EH207-I

X3EH207-I

X3EH207-I

X3EH207-I

X3EH207-I

X3EH901-W

X3EH901-W

X3EH902-W

X3EH902-W

X3EH903-W

X3HOSTBL

X3HOSTBL

X3HOSTBL

X3IF201-I

X3IF202-I

X3IF203-I

X3IF204-I

X3IF205-I

X3IF206-I

X3IF207-I

X3IF208-I

X3IF209-I

X3IF210-I

X3IF211-I

X3IF213-I

X3IF214-I

X3IF215-I

X3IF217-I

X3IF219-I

X3IF220-I

X3IF221-I

X3IF222-I

X3IF226-I

X3IF227-I

X3IF229-I

X3IF230-I

X3IF231-I

X3IF232-I

X3IF233-I

X3IF234-I

X3IF236-I

X3IF237-I

X3IF238-I

X3IF239-I

X3IF240-I

X3IF241-I

X3IF242-I

X3IF248-I

X3IF249-I

X3IF251-I

X3IF252-I

X3IF254-I

X3IF257-I

X3IF264-I

X3IF266-I

X3IF270-I

X3IF280-I

X3IF281-I

X3IF282-I

X3IF283-I

X3IF284-I

X3IF285-I

X3IF286-I

X3IF287-I

X3IF288-I

X3IF309-I

X3IF349-I

X3IF501-I

X3IF502-I

X3IF503-I

X3IF504-I

X3IF505-I

X3IF506-I

X3MWHD32.LIB

X3MWHD32.LIB

X3MWHD32.LIB

X3MWHD32.LIB

X3MWHD32.LIB

X3MWHD32.LIB

X3MWHD32.LIB

X3MWHD32.LIB

X3MWHD32.LIB

X3MWHD32.LIB

X3TCPTB2

X3TRNTB2

X3TRNTB2

X3TRNTBL

X3TRNTBL

X3UNMP01.TXT

XDM/DCCM3使用時のトラブル

XDM/DCCM3で2,920バイト以内のデータをやり取りする（拡張ホストアクセス）

XDM/DCCM3で2,920バイトを超えるデータをやり取りする（拡張ホストアクセス）

XDM/DCCM3でのインタフェース（CommuniNet使用時）

XDM/DCCM3でのインタフェース（TP1/Client/P使用時）

XDM/DCCM3での拡張ホストアクセス（論理マップ長＞2,920バイトの場合）

XDM/DCCM3での拡張ホストアクセス（論理マップ長≦2,920バイトの場合）

XDM/DCCM3の機能を代替する

XDM/DCCM3の設定

XMAP3外字機能

XMAP3外字機能

XMAP3外字機能

XMAP3外字機能

XMAP3外字機能

XMAP3外字機能

XMAP3外字機能

XMAP3外字機能

XMAPCTRL文の機能

XMAPCTRL文の機能

(ア行)

(あ)

網掛け種別

網掛けダイアログ

網掛けダイアログ

網掛けダイアログ

(い)

イベント通知コード

印刷領域

インタフェース機能

インタフェース機能

インタフェース機能

インポート機能

インポート機能

インポート機能で変換できる範囲

インポート機能の操作

インポート機能の操作の流れ

インポート機能の変換オプション

(え)

エクスポート機能

エクスポート機能

エクスポート機能

エクスポート機能

エラーメッセージ

エラーメッセージ

円弧ダイアログ

円弧ダイアログ

円弧ダイアログ

円弧の位置とサイズ

円弧の角度

円ダイアログ

円ダイアログ

円ダイアログ

円の位置とサイズ

(お)

オープンエラー

オープンエラー

オープンエラー

オープン命令

オープン命令

オープン命令

オープン命令

オープン命令

オープン命令

オープン要求

オープン要求

オープン要求

オンライン環境での拡張ホストアクセス

オンライン環境での拡張ホストアクセス

オンライン環境での拡張ホストアクセス

オンライン環境での拡張ホストアクセス

(カ行)

(か)

下位項目

下位項目

下位項目

下位項目

下位項目ダイアログ

下位項目の定義

下位項目の定義

下位項目の定義

外字

外字の扱い方

外字の扱い方

外字の運用

外字の運用

外字の運用

外字の設定

外字の設定

外字の設定

外字マッピングファイルのカスタマイズ

外字マッピングファイルのカスタマイズ

外字マッピングファイルのカスタマイズ

外字用コードの割り当て

外字を直接定数で指定している場合

回線接続エラー

回線接続エラー

回線接続エラー

回線接続に関するトラブル

回線接続に関するトラブル

回線接続に関するトラブル

開発環境の準備

開発環境の準備

開発環境の準備

開発環境の設定

開発環境の設定

開発環境の設定

開発環境の設定

開発環境のソフトウェア構成

隠しフィールド

拡大項目の定義

拡張ホストアクセス

拡張ホストアクセス

仮想端末名称の設定

仮想端末名称の設定

仮想端末名称の設定

角の丸め

可変項目

画面・帳票エクスポート時のメッセージ（T-560/20用）

画面・帳票が出力できない

画面・帳票が出力できない

画面・帳票出力時のトラブル

画面・帳票出力時のトラブルと対処方法

画面・帳票に文字化けが生じる

画面・帳票に文字化けが生じる

画面・マップ帳票で利用できる機能

画面・マップ帳票をPCに移行

画面・マップ帳票を開発

画面が出力できない

画面管理プログラム

画面管理プログラム

画面管理プログラム

画面管理プログラムにメインフレームAPの処理を分散する

画面管理プログラムにメインフレームAPの処理を分散する

画面管理プログラムのコンパイル

画面管理プログラムのコンパイル

画面管理プログラムのサンプル

画面管理プログラムのサンプル

画面管理プログラムの実行

画面管理プログラムの実行

画面管理プログラムのトラブル

画面管理プログラムのトラブル

画面出力時のトラブルと対処方法

画面に文字化けが生じる

画面の移行

画面の入出力要求

画面の入出力要求

画面の表示属性動的変更

画面表示のトラブル

漢字コードの違い

漢字専用項目

漢字を含む行が継続する

漢字を含むパネル定義文

(き)

記述文格納用フォルダ

記述文格納用フォルダ

記述文の内容とドローとの関係

記述文ファイルの生成

記述文ファイルの変換

記述文ファイルをPCに転送する

記述文ファイルをPC用に変換する

記述文ファイルを転送する

記述文ファイルをメインフレームからPCに転送する

記述文を生成する

既存の資産を基にしたタイプ1/2/R書式の定義から運用の流れ

基本ます目と行間隔の関係

給紙サイズ

給紙サイズ

行間隔

共用項目

共用項目

(く)

矩形ダイアログ

矩形ダイアログ

矩形ダイアログ

クライアント機

クライアント機

グラフィック帳票属性ダイアログ

繰り返し定義

クローズ命令

クローズ命令

クローズ命令

クローズ命令

クローズ命令

クローズ命令

クローズ要求

クローズ要求

クローズ要求

(け)

けい線コードの違い

けい線と重なるフィールド

けい線に対する肉付け

けい線のDFC

継続出力命令

継続出力命令

継続出力命令

継続出力命令

継続出力要求

継続出力要求

継続入力命令

継続入力命令

継続入力命令

継続入力命令

継続入力要求

継続入力要求

ゲートウェイ機

ゲートウェイ機

ゲートウェイ機

ゲートウェイ経由のマップサーバ構成

ゲートウェイ経由のマップサーバ構成

ゲートウェイ構成

ゲートウェイ構成

ゲートウェイ構成

言語種別

言語種別

(こ)

項目の表示属性動的変更

固定グラフィックダイアログ

固定グラフィックダイアログ

固定項目

固定バーコードダイアログ

固定フィールドダイアログ

固定フィールドダイアログ

固定フィールドダイアログ

混在項目

混在項目

混在項目

(サ行)

(し)

システム構成

システム構成

システム構成

実行環境の設定

実行環境の設定

実行環境の設定

シフトJISとKEISの外字マッピングテーブルを使用する

シフトJISとKEISの外字マッピングテーブルを使用する

シフトJISとKEISの外字マッピングテーブルを使用する

シフトJISの代わりにUnicodeで表示・印刷を行う

シフトJISの代わりにUnicodeで表示・印刷を行う

シフトJISの代わりにUnicodeで表示・印刷を行う

終了命令

終了命令

終了命令

従論理項目の繰り返し

受信メッセージテーブル

受信メッセージテーブル

受信メッセージテーブル

受信メッセージテーブル

出力OCRダイアログ

出力バーコードダイアログ

出力フィールド

出力フィールド

出力フィールドダイアログ

出力命令

出力命令

出力命令

出力命令

出力命令

出力命令

出力要求

省略時仮定値の漢字定数

書式インポート

書式エクスポート

書式オーバレイの定義

書式属性ダイアログ

書式属性ダイアログ

書式定義ファイルの名称

書式定義ファイルの名称

書式名1

書式名2

処理要求関数の形式

処理要求関数の形式

シリアルプリンタ（HT-5344）用帳票

(す)

数字編集文字列

数字編集文字列

数字編集文字列

数字編集文字列

スタンドアロン構成

スタンドアロン構成

スタンドアロン構成

スタンドアロン構成

スタンドアロン端末

スタンドアロン端末

スタンドアロン端末

(せ)

制御項目属性

制限値を超えるエラー

生成結果エラーファイル

生成結果エラーファイル

生成結果エラーファイル

全角開始・全角終了コード

線種の変換規則

線の太さの変換規則

(そ)

送信メッセージテーブル

送信メッセージテーブル

送信メッセージテーブル

送信メッセージテーブル

ソフトウェア構成

ソフトウェア構成

ソフトウェア構成

(タ行)

(た)

ターゲット環境

ターゲット環境の設定

ターゲット環境の設定

ターゲット環境の設定

ターゲット環境の設定

ターゲット環境の設定

ターゲット環境の設定

タイプ1/2/R書式の移行

タイプ1/2/R書式の定義から運用の流れ

タイプ1/2/R書式をPCに移行

タイプ1/2/R書式を開発

タイプ1/2/R書式を定義する

タイプ1/2/R書式を定義するための環境

タイプ1書式

タイプ2書式

タイプ3書式に定義できるオブジェクト

タイプ3書式の開発

タイプ3書式の定義

タイプ3書式の定義から運用の流れ

タイプ3書式の定義の手順

タイプ3書式を定義する

タイプ3書式を定義するための環境

タイプR書式

対話環境での拡張ホストアクセス

対話環境での拡張ホストアクセス

対話環境での拡張ホストアクセス機能

対話処理

縦けい線ダイアログ

縦けい線ダイアログ

縦けい線ダイアログ

縦けい線に対する肉付け

(ち)

帳票の出力要求

帳票の出力要求

(つ)

通信エンティティ名

通信管理プログラム

通信論理マップ

通信論理マップ

通信論理マップ

通信論理マップの設定値

通信論理マップの設定値

(て)

定義から運用までの流れ

定義から運用までの流れ

定義から運用までの流れ

定義を修正する

データ名の長さ

適用オブジェクトグループ

テスト支援機能

デバイス名のPCでの対応

(と)

動的変更テーブル

動的変更テーブル

動的変更テーブル

動的変更テーブル

ドットパターン

トラブルとその対処方法

トラブルとその対処方法

トラブルとその対処方法

トランザクション

トランザクション

トランザクション

トランザクションコード

トランザクションコード

トランザクションコードの定義

トランザクションコードを設定する

トランザクションコードを設定する

ドローセットアップでの指定

ドローで指定する給紙サイズ

ドローで指定する給紙サイズ

ドローによる編集

(ナ行)

(な)

斜めけい線ダイアログ

斜めけい線ダイアログ

斜めけい線ダイアログ

(に)

「日本語」項目の定義

「日本語」項目の定義

「日本語」項目の定義

入出力命令

入出力命令

入出力要求

入力命令

入力命令

入力命令

入力命令

入力元ターゲット

入力論理マップのクリア文字

入力論理マップのクリア文字

(ハ行)

(は)

パネル定義文

パネル定義文格納用フォルダ

パネル定義文格納用フォルダ

パネル定義文中に漢字が含まれる場合

パネル定義文に行番号が付いている場合

パネル定義文に反映されない指定

パネル定義文の修正

パネル定義文の生成

パネル定義文ファイルの生成

パネル定義文ファイルをメインフレームに転送する

パネル定義文をPCに転送する

パネル定義文をVOS1に転送する

パネル定義文をVOS3に転送する

パネル定義文をVOSKに転送する

パネル定義文を生成する

パネル定義文をメインフレームに転送する

半角・全角混在項目

(ひ)

ピクチャ文字

ピクチャ文字

ピクチャ文字

ピクチャ文字

表示属性の動的変更

標準レイアウトパターン

標準レイアウトパターン

(ふ)

ファイルの変換

複数行項目の定義

部品

プリンタの設定

フレームダイアログ

プレプリント用紙

プレプリント用紙

プレロードマップ

プレロードマップ

プログラム例

分散システムの開発手順

分散システム用のマップの定義から運用までの流れ

分散処理

(へ)

ページプリンタ（HT-2311）用帳票

ページング

ページング

ページング

ページング

ページング

変換オプション

変換結果のメッセージ

変更属性定義

変更属性定義

変更属性定義

変更属性定義

ベンダ固有文字

(マ行)

(ま)

ます目

ます目

ます目サイズ

ます目設定

マッピングオプション

マッピングオプション

マッピング処理をPCで実行

マップサーバ

マップサーバ機

マップサーバ機

マップサーバ構成

マップサーバ構成

マップ生成

マップ生成

マップ生成

マップ帳票

マップ帳票の移行

マップの配布

マップの配布

マップファイルの転送

マップファイルの転送

マップファイルの転送

マップを生成する

マップを生成する

マップを生成する

(め)

命令

メインフレーム

メインフレーム資産の移行

メインフレーム上に必要なソフトウェア

メインフレーム上に必要なソフトウェア

メインフレーム上に必要なソフトウェア

メインフレーム上に必要なソフトウェア

メインフレームとPCとの用語の対応

メインフレームのAPから画面管理プログラムを起動させる

メインフレームのAPから画面管理プログラムを起動させる

メインフレームの画面を定義する

メインフレームのマップ帳票を定義する

メインフレーム向け開発環境の準備

メインフレーム名の設定

メインフレーム名の設定

メインフレーム名の設定

メインフレーム用APの作成・流用

メインフレーム用に定義できる画面・マップ帳票

メインフレーム用に定義できる機能の範囲

メインフレーム用の画面・帳票の定義

メインフレーム用パネル定義文の定義から運用の流れ

メッセージテーブル

メッセージテーブル

メッセージテーブル

メッセージテーブルの設定値

メッセージテーブルの設定値

メッセージの設定値

(も)

文字間隔

文字コードの違い

文字サイズ

文字属性名の関連づけ

文字属性名の決定

文字属性名の決定

文字列の字間値

(ヤ行)

(ゆ)

ユーザ用レイアウトパターン

ユーザ用レイアウトパターン

(よ)

要求

用語の違い

用紙サイズ

横けい線ダイアログ

横けい線ダイアログ

横けい線ダイアログ

予約項目

(ラ行)

(り)

リターンコード

利用できるデバイス

(れ)

レイアウトのます目

レイアウトのます目

レイアウトパターン

レイアウトパターン

レイアウト領域

レイアウト領域

連携機能の特長

(ろ)

論理項目名

論理ページ

論理マップ属性

論理マップの項目名

論理マップの項目名

論理マップの項目名

論理マップの項目名

論理マップの取り込み

論理マップの取り込み

論理マップの取り込み

論理マップの取り込み

論理マップの取り込み

論理マップの長さ

■ 商標類

AIXは，米国における米国International Business Machines Corp.の登録商標です。
BackOfficeは，米国Microsoft Corp.の登録商標です。
ESC/Pは，セイコーエプソン（株）の商標です。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
Itaniumは，アメリカ合衆国および他の国におけるインテル コーポレーションまたはその子会社の登録商標です。
JFIFは，C-Cube Microsystems 社が規定したフォーマットの名称です。
KanjiLinkは，イースト株式会社の登録商標です。
Linuxは，Linus Torvaldsの米国およびその他の国における登録商標あるいは商標です。
LIPSII+は，キヤノン（株）が開発した言語仕様です。
LIPSIIIは，キヤノン（株）が開発した言語仕様です。
Microsoftは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
MS-DOSは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
PA-RISCは，米国Hewlett-Packard Companyの商標です。
Red Hatは，米国およびその他の国でRed Hat,Inc. の登録商標若しくは商標です。
Solarisは，米国Sun Microsystems,Inc. の米国およびその他の国における商標または登録商標です。
TrueTypeは，米国Apple Computer,Inc.の商品名称です。
TurboLinuxの名称及びロゴは，TurboLinux,Inc. の商標です。
UNIXは，X/Open Company Limited が独占的にライセンスしている米国ならびに他の国における登録商標です。
Visual C++は，米国およびその他の国における米国Microsoft Corp.の登録商標です。
VJE-Deltaは，株式会社バックスが開発した日本語入力フロントエンドプロセッサです。
Windowsは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Windows NTは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Windows Serverは，米国およびその他の国における米国Microsoft Corp. の商標です。
メーカ固有漢字セット（日立KEIS83拡張3）は，イースト（株）の製品です。