Magic eBusiness Platform V9Plus for iSeries

インストールガイド

Magic eBusiness Platform V9Plus for iSeries

Magic Platform V9Plus for iSeries
Magic Application Server V9Plus for iSeries‑1‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

目

次

第１章

はじめに ............................................................................................................................................... 4

1.1 このガイドの補足資料 ................................................................................................................................ 4
1.2 本書の概要 .................................................................................................................................................. 4
1.3 表記上の注意事項 ....................................................................................................................................... 5
MAGIC FOR ISERIES 導入手順 ........................................................................................................ 6

第２章

2.1 前提条件と設定例 ....................................................................................................................................... 6
2.2 Magic for iSeriesインストール〜デモアプリケーションセットアップの流れ.......................................... 8
MAGIC ISERIES CLIENT................................................................................................................ 10

第３章

3.1 Magic eDeveloper／Magic Clientのインストール .................................................................................. 10
3.2 クライアントPCのTCP/IP環境の設定 ..................................................................................................... 10
3.3 Magic iSeries Clientのインストール ....................................................................................................... 11
3.4 ホストライブラリ（Host DBA）のインストール.................................................................................... 13
3.5 Magic iSeries Clientのライセンス登録 ................................................................................................... 18
MAGIC ISERIES SERVER ............................................................................................................... 20

第４章

4.1 ユーザー・プロファイルの作成................................................................................................................ 20
4.2 Magic iSeries Serverのインストール ...................................................................................................... 21
4.3 Magic iSeries Server ライセンス登録 .................................................................................................... 23
4.4 TCP/IPドメイン情報の登録 ..................................................................................................................... 24
4.5 TCP/IPホスト・テーブルの登録 .............................................................................................................. 25
デモアプリケーションの設定・実行................................................................................................... 28

第５章

5.1 Magic Webアプリケーション用ファイルとフォルダ............................................................................... 28
5.2 デモアプリケーション用ファイルのコピー ............................................................................................. 29
5.3 MAGIC400.INIの修正 ............................................................................................................................. 30
5.4 メッセージングサーバの設定 ................................................................................................................... 31
5.5 HTTP属性の設定...................................................................................................................................... 32

5.5.1 HTTP構成の設定................................................................................................................................. 34
5.5.2 HTTPサーバの起動 ............................................................................................................................. 39
5.6
5.7
5.8

MRBの起動............................................................................................................................................... 41
Magic iSeries Serverの起動..................................................................................................................... 42
BC_Methodologyの実行 ........................................................................................................................... 44

第６章

導入時のトラブル対応 ........................................................................................................................ 45

6.1 JOBログの参照方法 ................................................................................................................................. 45
6.2 フローモニタの参照方法 .......................................................................................................................... 48
6.3 MRBログとリクエスタログの設定・参照方法 ........................................................................................ 50
第７章

補足 .................................................................................................................................................... 52

7.1 ライセンス管理について .......................................................................................................................... 52
7.2 ホストライブラリインストール環境について.......................................................................................... 53
7.3 ホストライブラリの自動起動について..................................................................................................... 54
7.4 Magic iSeries Serverの動作環境を複数設定する方法について .............................................................. 55
7.5 CCSIDについて ........................................................................................................................................ 61

7.5.1
7.5.2
7.5.3
7.5.4
7.5.5

‑2‑

QCCSID .............................................................................................................................................. 63
MGCLIENTジョブ のCCSID ............................................................................................................ 64
Magic iSeries Server−QCCSIDが5035、939環境でのCCSID ........................................................ 65
Magic iSeries Server−QCCSIDが65535、5026、又は930環境でのCCSID ................................... 66
Magic iSeries Server−インターネット環境のCCSID....................................................................... 67

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

本マニュアルに記載の内容は、将来予告なしに変更することがあります。これらの情報についてMSE（Magic Software Enterprises Ltd.）およびMSJ（Magic Software Japan K.K.）は、いかなる責任も負いません。
本マニュアルの内容につきましては、万全を期して作成していますが、万一誤りや不正確な記述があったとしても、MSE およびMSJ はいかなる責任、債務も負いません。
MSE およびMSJ は、この製品の商業価値や特定の用途に対する適合性の保証を含め、この製品に関する
明示的、あるいは黙示的な保証は一切していません。
本マニュアルに記載のソフトウェアは、製品の使用許諾契約書に記載の条件に同意をされたライセンス所有者に対してのみ供給されるものです。同ライセンスの許可する条件のもとでのみ、使用または複製することが許されます。当該ライセンスが特に許可している場合を除いては、いかなる媒体へも複製することはできません。
ライセンス所有者自身の個人使用目的で行う場合を除き、MSE またはMSJ の書面による事前の許可なし
では、いかなる条件下でも、本マニュアルのいかなる部分も、電子的、機械的、撮影、録音、その他のいかなる手段によっても、コピー、検索システムへの記憶、電送を行うことはできません。
サードパーティ各社商標の引用は、MSE およびMSJ の製品に対するコンパチビリティに関しての情報提供のみを目的としてなされるものです。
本マニュアルにおいて、説明のためにサンプルとして引用されている会社名、製品名、住所、人物は、
特に断り書きのないかぎり、すべて架空のものであり、実在のものについて言及するものではありません。

• Magic はMagic Software Enterprises Ltd. のイスラエルその他の国での商標または登録商標です。
• Magic eDeveloper、Magic Client およびMagic Application Server はMagic Software Japan K.K.の商標です。

• Pervasive.SQL はPervasive Software, Inc. の商標です。
• Microsoft およびFrontPage は、Microsoft Corporation の登録商標です。また、Windows, WindowsNTおよびActiveX はMicrosoft Corporation の商標です。

• Oracle はOracle Corporation の登録商標です。
• OS/400™ 、DB2/400™ 、およびMQ/Series™ は IBM 社の登録商標です。
• EASYCOM™ はAURA Equipments社の登録商標です。
• 一般に、会社名、製品名は各社の商標または登録商標です。
MSE およびMSJ は、本製品の使用またはその使用によってもたらされる結果に関する保証や告知は一切していません。この製品のもたらす結果およびパフォーマンスに関する危険性は、すべてユーザが責任を負うものとします。
この製品を使用した結果、または使用不可能な結果生じた間接的、偶発的、副次的な損害（営利損失、業務中断、業務情報の損失などの損害も含む）に関し、事前に損害の可能性が勧告されていた場合であっても、MSE およびMSJ、その管理者、役員、従業員、代理人は、いかなる場合にも一切責任を負いません。

初版
第二版
第三版

２００４年 ４月２７日
２００５年 ３月３０日
２００５年１０月３１日

マジックソフトウェア・ジャパン株式会社‑3‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

第１章

はじめに

本書は iSeries開発ガイドの補足資料とし、本書では、以下の Magic eBusiness Platform for iSeries 製
品のインストール及び、インターネットデモアプリケーション（ブラウザウクライアント開発手法）のセッ
トアップ方法・動作環境の設定について説明します。
zz

Magic Platform V9Plus for iSeries
Magic Application Server V9Plus for iSeries

本書では、製品名を以下のように省略する場合があります。
製品名
Magic eBusiness Platform V9Plus for iSeries
Magic Platform V9Plus for iSeries
Magic Application Server V9Plus for iSeries

省略製品名
Magic for iSeries
Magic iSeries Client
Magic iSeries Server

また、Magic eDeveloperを理解するには、次に挙げるマニュアルも参照してください。






リファレンス
新機能ガイド開発者ガイドインストールガイド
iSeries開発ガイド

1.1 このガイドの補足資料
Magic eDeveloperのの各マニュアルに加えて、次に挙げるIBM提供マニュアルは、iSeries サーバ環境でのアプリケーションの知識を補足することができます。
AS/400 実行管理の手引
DDS 解説書: 概念
DDS 解説書: 物理ファイルと論理ファイル
DB2 UDB for iSeries データベース・プログラミング
ネットワーキング TCP/IP セットアップ
TCP/IP 構成および解説書
HTTP Server AS/400用概説およびセットアップ【SD88‑5009‑03】【RBAF‑P000‑02】【RZAK‑B000‑00】【RBAF‑O000‑02】【SD88‑5013‑04】【GD88‑5018‑01】

1.2 本書の概要
第２章では、本書で使用するコンピュータの前提条件等の説明をします。
第３章では、Magic iSeries Clientに関するインストール方法、および設定方法を説明します。
第４章では、Magic iSeries Serverに関するインストール方法、および設定方法を説明します。
第５章では、デモアプリーケーションのセットアップ方法、および設定方法を説明します。
第６章では、導入時に発生しやすいトラブルの対応方法について説明します。
第７章では、Magic for iSeries を使用する際の注意事項等について説明します‑4‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

1.3 表記上の注意事項
本書で表記される、記号の意味は以下の通りになります。
記号等

‑5‑

意味

1

△ 記号

2

F4

iSeries（AS/400）エミュレータのファンクションキー番号

3

実行

iSeries（AS/400）エミュレータの実行（Enter）キー

空白（ブランク）

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

Magic for iSeries 導入手順

第２章

Magic iSeries Client および Magic iSeries Server 製品のインストール及び、デモアプリケーション（ブラウザウクライアント開発手法）セットアップまでの流れについて説明します。

2.1 前提条件と設定例
ここでは、製品のインストールと実行の前提条件として必要となるソフトウェアと、本文中の説明で使用する設定例とを説明します。

注意： 本書での設定例はあくまで説明のための例ですので、インストールにあたって
は、実際にインストールするiSeriesやPCの環境に合わせて適宜読み替えてください。
（１）

Magic eBusiness Platform 製品
本書では、以下のバージョンのMagic製品について説明をします。
表2.1 Magic製品とバージョン
1
2
3

（２）

Magic製品
Magic eDeveloper
Magic iSeries Client
Magic iSeries Server

バージョン
V9.4JSP3
V9.4JSP3
V9.4JSP3

iSeries（AS/400）サーバ環境
Magic製品をインストール・利用する前提として、iSeries上に必要となるソフトウェアを以下に
示します。

1
2
3
4

表2.2 iSeries上に必要なソフトウェア（○は必要、‑ は不要なことを表します）
ソフトウェア
説明
Magic iSeries Magic iSeries
Server製品
Client製品
ネットワーク環境 TCP/IP が必須です。
○○
HTTPサーバー
HTTP Server (Powered by Apache) for‑○
iSeriesをサポートしています。
FTPサーバー
インストール時に利用します。
○○
PASE
サーバ製品の実行時に必要です。
‑
○

注意：
z
HTTPサーバは、Magic iSeries Server 製品を使って、MagicでWebアプリケーションサーバ、あるいはWebサービスサーバとして使う場合に必要となります。
z
Client製品 (Magic iSeries Client)では、HTTPサーバは不要です。
z
PASEについては、次ページの「PASE（Portable Application Solutions Environment）について」を参照してください。
本文中では、以下のサーバ設定例で説明をします。
表2.3 iSeriesの環境設定例
設定例

項目
1
2
3
4

OS/Version
システム名
ドメイン名
IPアドレスV5R2MSJIS400
MAGICDEV.CO.JP
10.3.0.33（３） クライアント環境（ＰＣ）
Magic製品をインストール・利用する前提として、クライアントPC上に必要となるソフトウェアを以下に示します。

‑6‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

表2.4 クライアントPC上に必要なソフトウェア（○は必要、‑ は不要なことを表します）
ソフトウェア
説明
Client製品 Server製品
1 ネットワーク環境 TCP/IP が必須です。
○○
2 FTPクライアント
インストール時に利用します。
○(管理者)○
3 ターミナルエミュ iSeries Access for Windows な ど 。 ○(管理者)○
レータ
iSeries上での設定に使います。
注意：z
FTPクライアントおよびターミナルエミュレータは、インストールを行ったり、iSeries 側に
インストールしたMagic製品の構成等を管理する管理者のPCにのみ必要です。一般ユーザがMagic Clientを実行するためには必要ありません。
z
Magic iSeries Serverの動作環境の設定時、英小文字入力が必要な箇所が一部あります。このため、ターミナルエミュレータで英小文字入力が可能な設定に変更してください。(例：エミュレータの構成で、ホストコードページを「939日本語英数小文字拡張」に設定するなど)。
本文中の説明で使用する、クライアントPCの環境設定例を以下に示します。
表2.5 クライアントPC環境設定例

1
2
3

PC
OS/Version
コンピュータ名IPアドレス

概要説明
Windows XP
SAMP
10.3.0.190

参考： PASE（Portable Application Solutions Environment）について
PASEは、IBM社がiSeries用に提供するオプションソフトウェア（ライセンスプログラム 5769SS1、Option 33）で、AIX に類似した実行環境をiSeries上で実現します。
Magic iSeries Serverは、PASE環境で動作しますので、Magic iSeries Server 製品をインストール
するに先立って、PASEがインストールされていることが必要になります。
Magic iSeries Client製品のみをインストールする場合には、PASEは不要です。

図2.1
PASE ライセンスの確認‑7‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

2.2Magic for iSeries インストール〜デモアプリケーションセットアップの流れ
Magic iSeries Client および Magic iSeries Serverのインストール、デモアプリケーションのセットアップ作業の流れを以下に示します。
START① Magic eDeveloper／Magic Clientのインストール

3.1 参照② TCP/IPの環境設定

3.2 参照③ Magic iSeries Clientのインストール

3.3 参照④ ホストライブラリ（Host DBA）のインストール

3.4 参照⑤ Magic iSeries Clientライセンス登録

3.5 参照Magic iSeries Serverもインストールする？

いいえ

Magic iSeries Client製品のインストール

END

はい⑥ ユーザー・プロファイル作成

4.1 参照⑦ Magic iSeries Serverのインストール

4.2 参照⑧ Magic iSeries Server ライセンス登録

4.3 参照⑨ TCP/IP ドメイン情報の変更

4.4 参照⑩ TCP/IP ホスト・テーブル項目の処理

4.5 参照⑪ Magic Webアプリケーション用ファイ
ルとフォルダのコピー

5.1 参照⑫ デモアプリケーションのコピー

5.2 参照⑬ MAGIC400.INIの修正

5.3 参照⑭ メッセージングサーバ(MRB)の設定

5.4 参照Magic iSeries Server
製品のインストール

デモアプリケーションの設定・実行12

図2.2 Magic for iSeriesインストール〜デモアプリケーションセットアップの流れ‑8‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

1

2⑮ HTTP属性の設定

5.5 参照⑯ HTTP構成の設定

5.5.1 参照

⑰ HTTPサーバの起動

5.5.2 参照

⑱ MRBの起動

5.6 参照⑲ Magic iSeries Serverの起動

5.7 参照⑳ デモアプリケーションの実行

5.8 参照END

図2.2 Magic for iSeriesインストール〜デモアプリケーションセットアップの流れ（続き）
注意： インストールのタイプにより、必要なステップが異なります。

‑9‑zMagic iSeries Client 製品のみをインストールする場合には、上図の「START」より「⑤ Magic iSeries
Clientライセンス登録」までのステップを行ってください。

z

Magic iSeries Client製品を利用してMagicアプリケーションを実行する一般ユーザのPCでは、各PCごとに上図の「START」より「③ Magic iSeries Clientのインストール」までのステップを行ってください。

zMagic iSeries Server製品をインストールする場合には、先立って Magic iSeries Client製品をインストールする必要があります。従って、図2.2 の「START」から「⑳ デモアプリケーションの実行」
まで、すべてのステップを行ってください。

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

第３章

Magic iSeries Client

本章では、Magic iSeries Clientのインストール及び動作環境の設定について説明します。
注意：zMagic iSeries Server 製品は、Magic iSeries Client 製品がインストールされていることを前提とします。従って、Magic iSeries Server 製品をご購入になったお客様でも、Magic iSeries Server 製
品のインストールに先立って、本章のステップを必ず実行してください。
z
インストールの途中で、製品CD‑ROMが必要になる場合がありますので、お手元に用意しておいてください。
参考： クライアントPCにMagic Clientをインストールすることなく、iSeries上にホストライブラリのみをインストールすることも可能です。この場合には、3.1〜3.3は省略し、「3.4 ホストライブラリ（Host
DBA）のインストール」に進んでください。

3.1

Magic eDeveloper／Magic Client のインストール
クライアントPC上には、アプリケーションを開発／実行するために、Windows版のMagic eDeveloper (アプリケーション開発時) あるいは Magic Client (アプリケーション実行時) が必要です。
Magic eDeveloper／Magic Clientのインストールの詳細については、各々の製品に付属のインストールマ
ニュアルに詳説されているので、ここでは省略させていただきます。

3.2 クライアント PC の TCP/IP 環境の設定
クライアントPCとiSeriesサーバ間には、ネットワーク環境として TCP/IP が必須であり、インストールに先立って、両者の間で正しく通信できるように、ホスト名の設定をしておく必要があります。
ホスト名の設定は、DNS あるいは HOSTS ファイルにより行います。
DNS を使用していないネットワーク環境では、HOSTS ファイルにホスト名とIPアドレスの対応を正しく定義しておいてください。
表3.1 HOSTSファイル設定例
127.0.0.1
localhost
10.3.0.33
MSJIS400#AS/400
10.3.0.190
SAMP#PC
参考： HOSTSファイルは、以下のディレクトリにあります。
zWindows 98 では、 C:¥Windows¥HOSTSz
Windows 2000/XP では、C:¥Windows¥System32¥Drivers¥etc¥HOSTS
ここで、C:¥Windows というのは、Windows をインストールしたディレクトリで、違うフォルダにインストー
ルした場合には、環境に合わせて読み替えてください。

‑10‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

3.3Magic iSeries Client のインストール（１）「コントロールパネル」→「プログラムの追加と削除」から、Magic eDeveloper／Magic Client を選び、「変更と削除」ボタンを押すと、下図のようなメンテナンス画面が表示されます。

図3.1
メンテナンス
画面（２）「変更(M)」を選択して「次へ(N)」押すと、コンポーネント指定画面が表示されます。

図3.2
コンポーネン
ト指定画面
この中から、「iSeries製品コンポーネント」を、以下のように選択します。
z「Magic for iSeries クライアントコンポーネント」は必ず選択します。
z
ホストライブラリは、管理者が一度だけ、iSeries サーバにインストールします。ホストラ
イブラリをインストールする場合には、iSeriesのOSのバージョンに応じて、どちらか一方だけを選択してください。両方選択することはできません。
¾
iSeries のOSのバージョンがV5R2およびそれ以下の場合には、「Magic for iSeriesホス
トライブラリ」を選択します。
¾
iSeriesのOSのバージョンが V5R3 以上の場合には、「Magic for iSeries ホストライブ
ラリ (i5用)」を選択します。
z
管理者以外の通常のユーザのクライアントPCに Magic for iSeries クライアントコンポー
ネントをインストールする場合には、ホストライブラリを選択しないでください。
（３）「次に(N)」を押すと、iSeries クライアントコンポーネントがインストールされます。
参考： このとき、次のようなダイアログが表示されたら、MagicのインストールCDをCDドライブ(この場合には D: ドライブ)に挿入して、「OK」を押してください。

‑11‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

図3.3
ディスク挿入画面
以上でPCへのiSeriesクライアントコンポーネントのインストールが完了しました。
ステップ（２）でホストライブラリも選択していたら、続けてホストライブラリのインストール
が自動的に始まります。(次ページに続きます)。

‑12‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

3.4 ホストライブラリ（Host DBA）のインストール
3.3より継続して ホストライブラリのインストールが行われます。
参考： クライアントPCにMagic Clientをインストールすることなく、iSeries上にホストライブラリのみをインストールすることができます。製品CD‑ROM中、¥Servers¥iSeries¥HOST ディレクトリに、i5 (i5用
ホストライブラリ)とiSeries (それ以前)というサブディレクトリがありますので、インストールする機種に従って、MgObjTrf.exe を直接起動してください。ホストライブラリインストーラが起動しますので、本節に説明する手順に従ってインストールしてください。
注意：Magic/400 (dbMAGIC V8.2) あるいはMagic Platform for iSeries V9 (V9.3) がすでにインストー
ルされている iSeries マシンに、V9Plus 用のホストライブラリをインストールする場合には、注意が必要です。次ページの「Magic/400 V8、Magic Platform for iSeries V9 と共存させる場合」の項を参照してください。
準備:z
ホストライブラリをインストールする際、インストーラでホストライブラリ名を指定します。デフォ
ルトでは MAGIC400 となりますが、別の名前のライブラリとすることも可能です。
z
ホストライブラリのインストールは、QSECOFR アカウントで行います。QSECOFR アカウントのパスワー
ドをシステム管理者より聞いておいてください。
z
以下の説明では、次の環境を仮定して説明します。別の名前のライブラリにインストールした場合には、適宜置き換えてお読みください。
表3.2 インストール環境例
項目名
設定例

（１）

1

ホストライブラリ名

MAGIC400 (デフォルト)2

iSeriesホスト名

MSJIS400

下図のようなダイアログが表示されます。

図3.4 Transfer
Process 入力画面（２）

以下のようにインストールパラメータを入力し、[Install]ボタンをクリックします。
表3.3 TransferProcess設定値
項目名
意味
入力値例
ホストライブラリ名
1 iSeries Destination Library
MAGIC400
2
3
4

‑13‑

iSeries System
User ID
Psssword

iSeries ホスト名
ログオンアカウント名
パスワード

MSJIS400QSECOFR (固定)(QSECOFRのパスワード)

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

（３）インストールの間､進行状況を示すメッセージが表示されインストール終了後、次のダイアログが表示されます。

図3.5 正常終了時の結果メッセージ
注意：z
何らかの要因でインストールに失敗した場合は、次のメッセージが表示されます。エラーの要因は、ダイアログの「Messages」欄に表示されます。
z
再度インストールをやり直す場合は、OS/400上のMAGIC400という名前のライブラリを削除してからやり直してください。既に同名のライブラリが存在する場合は、インストールに失
敗します。
図3.3
TransferProcess

図3.6 異常終了時の結果メッセージ（４）

ホストライブラリのインストールが完了すると、次のような構成がOS/400に作成されます。
 指定されたホストライブラリ名(デフォルトでMAGIC400)の名前のライブラリが作成されます。
 MAGICという名前の新しいサブシステム記述が、ホストライブラリに作られます。
 MAGICサブシステムが起動され、自動的にEASYCOMジョブ(デーモン)を開始するよう設定されます。
 システム・スタートアップで、自動的にMAGICサブシステムを開始するよう設定されます。
参考： 構成については、「7.2 ホストライブラリインストール環境について」も参照してください。

（５）

CFGTCPMGCコマンドにて、Magic iSeries Clientの動作環境を変更することができます。
z
デフォルトの動作をできる限り、変更しないことを推奨します。
z
Magic/400 V8、Magic Platform for iSeries V9と共存させる場合には、CFGTCPMGCを実行しないでください。
z
CFGTCPMGCコマンドの操作方法については、「iSeries開発ガイド」参照してください。

SQLパッチの適用
SQLゲートウェイを利用する場合、iSeriesサーバのコマンドライン上で、次のコマンドを順に実行してください。
UPDPGM PGM（MAGIC400/EASYCOM） MODULE（MAGIC400/SQL2）

注意：

‑14‑

z

ここではインストール先のライブラリをMAGIC400としていますが、違うライブラリにインストールした場合には、適宜置き換えてください。

z

このパッチにより、ISAMゲートウェイ/SQLゲートウェイは併用できますが、ISAMゲートウェ
イによる「ダイレクトSQLセレクト」の機能は利用できなくなります。

z「ダイレクトSQLアクセス」は、「埋め込みSQL」に置き換えることにより、同様の処理が可能になります。

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

注意： Magic/400 V8、Magic Platform for iSeries V9 と共存させる場合
Magic/400 V8、および Magic Platform for iSeries V9 (V9.3SP5) を導入しているiSeriesの環境に、V9Plus用のホストライブラリを導入する場合は以下の注意が必要です。
z

通常とは異なるライセンスを必要としますので、V9Plusのライセンス申請時には、V8/V9環境と混在して使用することを記載してください。詳細は、ユーザ登録カードを参照してください。

z

V8、V9のホストライブラリがすでにインストールされている場合には、CFGTCPMGCの処理を実行しないでください。

z

V8、V9、V9Plusのホストライブラリ（HOST DBA）のライブラリは、以下の設定例のように、異なった名前にして分けておく必要があります。
表3.4 設定例
デフォルトライブラリ名の例
MAGIC400
MAGIC40094

Magic バージョン
Magic/400 V8
Magic iSeries V9Plusz

ホストライブラリのインストール画面(前ページ図3.4)では、iSeries Destination Library の欄には、MAGIC400でなく、MAGIC40094 などを指定します。

z

V9Plusを使用する場合、設定/DBMSでDBMSテーブルを開き、「パラメータ」欄に以下のような形式でホストライブラリのライブラリ名を指定してください。
MAGICDBA=MAGIC40094

図3.7 DBMSパラ
メータの設定z

EASYCLEFによる V9Plusのライセンス登録の作業は、すでにライセンス登録しているV8、又はV9のホストライブラリで行います。つまり、既存ライセンス登録に継続して、V9Plusのライセンスを登録します。こうすることにより、V8、V9でのライセンスの設定の内容を失うことがなくなります。
CHGCURLIB MAGIC400 EASYCLEF F4z以下の手順に従って、ジョブ待ち行列項目の登録を行ってください。
1.

ジョブ待ち行列項目の確認：コマンドを実行します。
DSPSBSD SBSD(MAGIC400/MAGIC)

2.

６「ジョブ待ち行列項目」を選択します。
ｻﾌﾞｼｽﾃﾑ 記述の表示
ｻﾌﾞｼｽﾃﾑ 記述 :MAGIC

ﾗｲﾌﾞﾗﾘｰ:

MAGIC400システム :
状況 :MSJIS400
活動

次の中から１つを選んでください。

‑15‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

1. 操作属性
2. プール定義
3. 自動開始ジョブ項目
4. ワークステーション名項目
5. ワークステーション・タイプ項目
6. ジョブ待ち行列項目
7. 経路指定項目
8. 通信項目
9. リモート・ロケーション名項目
10. 事前開始ジョブ項目
続く ...
選択項目またはコマンド===> 6
F3= 終了3.

F4=ﾌﾟﾛﾝﾌﾟﾄ

F9=ｺﾏﾝﾄﾞ の複写

F12= 取消し

SEQNBRの最後の番号を探します。下図では、30が最後の番号です。
ジョブ待ち行列項目の表示システム :
サブシステム記述 :

SEQ
NBR
10
20
30

ジョブ
待ち行列
MGCLIENTMGSERVERMGBROKER

MAGIC

状況 :

MSJIS400

活動最大‑‑‑‑‑‑ 優先順位による最大数 ‑‑‑‑‑‑
ﾗｲﾌﾞﾗﾘｰ
活動
1
2
3
4
5
6
7
8
9
MAGIC400*NOMAX *
*
*
*
*
*
*
*
*
MAGICRUN82 *NOMAX *
*
*
*
*
*
*
*
*
MAGICRUN82
5 *
*
*
*
*
* *
*
*
終わり

続行するためには，実行キーを押してください。
F3= 終了F12= 取消し
すでに区域の最下部が表示されている。
4.

ジョブ待ち行列項目を追加します。
ADDJOBQE SBSD(MAGIC400/MAGIC) JOBQ(MAGIC40094/MGCLIENT) MAXACT(*NOMAX)SEQNBR(40)

ここで、

5.

z

MAGIC40094： V9 ホストライブラリ名。

z

40： SEQNBR 重複していなければ何でも構いません。通常、最後の番号＋10を指定します。

ジョブ待ち行列項目を再確認します。
DSPSBSD SBSD(MAGIC400/MAGIC)

ジョブ待ち行列項目の表示システム :
サブシステム記述 :
SEQ
NBR
10

‑16‑

ジョブ
待ち行列
MGCLIENT

MAGIC

ﾗｲﾌﾞﾗﾘｰ
MAGIC400

状況 :
最大
活動
*NOMAX

MSJIS400

活動‑‑‑‑‑‑ 優先順位による最大数 ‑‑‑‑‑‑
1
2
3
4
5
6
7
8
9
*
*
*
*
*
*
*
*
*

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

20
30
40

MGSERVERMGBROKERMGCLIENTMAGICRUN82 *NOMAX *MAGICRUN82
5 *MAGIC40094 *NOMAX *

*
*
*

*
*
*

*
*
*

*
*
*

*
*
*

*
*
*

*
*
*

*
*
*
終わり

続行するためには，実行キーを押してください。

‑17‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

3.5

Magic iSeries Client のライセンス登録
ホストライブラリのインストールが終わったら、Magic iSeries Clientのライセンス登録を行います。
Magic iSeries Clientのライセンス登録手続きは､製品添付のユーザ登録シートに必要事項を記入し､インフォメーションセンター宛にお送りください。折り返し、ユーザ登録コード（Activation key）を通知いたします。

ライセンス登録時の注意事項
 ユーザ登録コードを登録する場合には、iSeries にOS/400エミュレータでログオンして行います。
このときのログオンアカウントには、ホストライブラリに対する "CHANGE"権限を持つ必要があります。
 ホストライブラリのオブジェクトが他のジョブ/ユーザによってロックされていると、正常に処理できません。WRKOBJLCKコマンドにてホストライブラリがロックされていないことを確認してください。
 Magic eDeveloperでは開発用ライセンス、Magic Clientでは実行ライセンスのライセンス登録が必要です。 Magic 製品とEASYCOM ライセンス（図4‑2 の「ACTIVATION KEY」）、及びMAGIC.INIファイ
ル中のライセンス名（LicenseName）の関連は以下の通りです。
Magic 製品
Magic eDeveloper
Magic Client
Magic Application Server（Windows 版）

EASYCOM ライセンス
D$MAGIC9MAGIC9MAGIC9MAGIC.INI のLicenseName
MGCSTK
MGCSRT
MGENT1

 LICENSEに「$」文字を入力する際、OS/400エミュレータのコードページ(CCSID) が930の場合は、キー
ボードの「¥」を使用してください。 （例）D$MAGIC9 → D¥MAGIC9
 EASYCOMは､英小文字を使用しています。従って､ログ情報､エラー情報等をAS/400ターミナルで表示
すると、一部の文字が化けて表示されることがあります。その場合は､OS/400ターミナルの画面を切り替えて確認してください。
参考： 表示の切り替えは、エミュレータのデフォルトの設定で、 CTRL+

F3 で行えます。

ユーザ登録コードの登録は、以下の手順で行います。
（１） ホストライブラリに対する CHANGE 権限を持つユーザ(QSECOFRなど)でログオンします。
（２） ホストライブラリをカレントライブラリとします。
CHGCURLIB（３）CCSID(*HEX)実行

EASYCLEF と入力し、 F4 キーを押します。
EASYCLEF（５）

実行

ジョブのCCSID を *HEX に変更します。
CHGJOB（４）

MAGIC400

F4EASYCOM ACTIVATION KEY 入力画面が表示されるので、取得した「LICENSE PAK」の内容を各フィールドに入力し 実行

キーを押下します。

参考： 送付された「LICENSE PAK」と、AS/400のEASYCLEF実行時の画面項目は以下のように対応しています。
表3.5 LICENSE PAK対応表
LICENSE PAK
1
2
3
4

‑18‑

REGISTRATION NAMEACTIVATION KEY
NO.OFSIMULTANEOUS SESSIONS
NO.OF SIMULTANEOUS STATIONEASYCLEF画面
COMPANY NAMEACTIVATION KEY
NUMBER OF CONNECTIONSNUMBER OF CONNECTED STATIONSMagic eBusiness Platform V9Plus for iSeries

インストールガイド

5
6
7
8
9

LICENSEVERSIONOPTION
EXPIRATION DATEMODEL

LICENSEEASYCOM'S VERSIONEASYCOM'S OPTIONSEXPIRATION DATEAUTHORISED AS/400 MODEL

図3.8 EASYCLEF

ライセンス登録が成功した場合、下記メッセージが表示されます。

ACTIVATION KEY IS CORRECT. EASYCOM IS OPERATIONAL.
失敗時には、次のようなメッセージが出ます。nnnn というのは、エラーコードです。

INVALID ACTIVATION KEY (nnnn). EASYCOM IS NOT OPERATIONAL.
エラー時は､ジョブログのメッセージをチェックしてください。
参考： ジョブログを参照するには、DSPJOBLOG を使います。
DSPJOBLOG

実行

以上で、Magic iSeries Client のインストールおよびユーザ登録は完了です。

‑19‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

Magic iSeries Server

第４章

本章では、Magic iSeries Serverのインストール及び動作環境の設定について説明します
Magic iSeries Serverをインストールには、予め Magic iSeries Clientが正しくインストールされ、ライセンス登録まで終了している必要があります。Magic iSeries Clientのインストールが終了していない場
合は、「第３章 Magic iSeries Client」を参照して、インストールしておいてください。
本章では、以下の環境例でインストールすることを仮定して説明します。実施の環境に合わせて、適宜読み替えて行ってください。

設定
Magicサーバアカウント
Magicサーバ コンポーネント
ライブラリ名iSeries サーバホスト名
iSeries サーバIPアドレス

表4.1 環境設定例
意味
インストール時のiSeries上のユーザ・プロ
ファイル (4.1参照)
Magic iSeries Server をインストールするライブラリ名 (4.2参照)

設定例
MAGIC94
MAGICRUN94
MSJIS400
10.3.0.33

4.1 ユーザー・プロファイルの作成
Magic iSeries Serverのインストールには、ユーザー・プロファイルのCCSIDが939(5035)に設定されているユーザアカウントが必要です。これは、インストーラがIFS形式ファイルを正しく復元するために必要となります。
そのようなアカウントがシステムに定義されていない場合には、以下の手順に従って作成してください。
ここでは例として、MAGIC94という名前のユーザアカウントを作ります。
注意： ユーザー・プロファイルの作成には *SECADM 権限をもつユーザー・プロファイルでサイン・オン
して作業してください。
①

CRTUSRPRF②「ユーザー・プロファイル」にMAGIC94、「テキスト記述」に実行ント欄です）を入力し、 F10MAGIC SERVER（この項目はコメキー(追加のパラメータ)を押します。

図4.1 CRTUSRPRF ①③

何回か [PageDown]キーを押すと、「コード化文字セット ID」欄が出てきますので、これを939(5035)に変更し 実行 を押します。

‑20‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

図4.2 CRTUSRPRF ②

4.2

Magic iSeries Server のインストール
次に、Magic iSeries Server をiSeries にインストールします。
（１）

CD‑ROMの¥Servers¥iSeries¥Mgobjtrf.Exeを起動します。

（２）

下記表4.1および図4.3を参考に各入力項目を設定して、 Install ボタンを押します。

項目名表4.2 TransferProcess設定値
意味1

iSeries Destination Library2
3

PC Client Code Page
Install on iSeries

45

User ID
Psssword

6

TCP/IP Address or Host Name

入力値例

Magicサーバ・コンポーネント・
ライブラリ名常に 942 を指定します。
常に「OS/400 V5R1 & later」を選択します。
Magicサーバアカウント
Magicサーバアカウントのパス
ワード
iSeries サーバのホスト名

MAGICRUN94
942
OS/400 V5R1 & later
MAGIC94
MAGIC94のパスワード
MSJIS400

図4.3 Transfer Process

インストールの間､進行状況を示すメッセージが表示され、インストール終了後、次のダイアログ‑21‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

が表示されます。

図4.4
正常終了時の結果メッセージ

何らかの要因でインストールに失敗した場合は、次のメッセージが表示されます。

図4.5
異常終了時の結果メッセージ

注意：z
インストールの失敗の原因については、Message 欄にメッセージが表示されます。よくあるエラーの原因は、User ID/Passwordのエラー、あるいは、同一名のライブラリがすでに存在するなどです。
z
再度インストールをやり直す場合は、OS/400上のMAGICRUN94という名前のライブラリを削除してからやり直してください。
Magic iSeries Serverのインストールが正常に終了すれば、IFSサーバ・コンフィギュレーション・
ディレクトリがOS/400に作成されます。この際、IFSサーバ・コンフィギュレーション・ディレク
ト リ 名 は 、 Magic iSeries Server を イ ン ス ト ー ル し た ラ イ ブ ラ リ 名 と 同 じ （ こ の 例 で は/MAGICRUN94）になります。

‑22‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

4.3

Magic iSeries Server ライセンス登録
Magic iSeries Server のライセンス登録を行います。
Magic iSeries Server のライセンス登録手続きは､製品添付のユーザ登録シートに必要事項を記入し､インフォメーションセンター宛にお送りください。後日、ユーザ登録コード（Activation key）を通知いたします。
ライセンス登録時の注意事項
 ユーザ登録コードを登録する場合には、iSeries にOS/400エミュレータでサイン・オンして行います。このときのユーザープロファイルには、ホストライブラリに対する "CHANGE"権限を持つ必要があります。
 ホストライブラリが他のジョブ/ユーザによってロックされていると、正常に処理できません。
WRKOBJLCKコマンドでホストライブラリがロックされていないことを確認してください。
 Magic 製品とEASYCOM ライセンス（図4‑2 の「ACTIVATION KEY」）、及びMAGIC400.INIのライセンス
名（LicenseName）の関連は以下の通りです。
Magic 製品
Magic Application Server

EASYCOM ライセンス
MAGICS9MAGIC400.INI のLicenseName
MGENT2

 EASYCOMは､英字小文字を使用しています。従って､ログ情報､エラー情報等をAS/400ターミナルで表示すると、一部の文字が化けて表示されることがあります。その場合は､OS/400ターミナルの画面を切り替えて確認してください。
参考： 表示の切り替えは、デフォルトのエミュレータの設定で、 CTRL

（１）
（２）

実行

EASYCLEF と入力し、 F4 キーを押します。
EASYCLEF（５）

実行

ジョブのCCSID を *HEX に変更します。
CHGJOB CCSID(*HEX)（４）

F3 で行えます。

ホストライブラリ(MAGIC400など)に対する CHANGE 権限を持つユーザ(QSECOFRなど)でサイン・オンします。
ホストライブラリをカレントライブラリとします。
CHGCURLIB MAGIC400

（３）

+

F4

EASYCOM ACTIVATION KEY 入力画面が出てきますので、取得した「LICENSE PAK」の内容を各フィールドに入力し 実行

キーを押下します。

参考： 送付された「LICENSE PAK」と、iSeriesのEASYCLEF実行時の画面項目は以下のように対応しています。
表4.3 LICENSE PAK対応表
LICENSE PAK
EASYCLEF画面
1
2
3
4
5
6
7
8
9

‑23‑

REGISTRATION NAMEACTIVATION KEY
NO.OFSIMULTANEOUS SESSIONS
NO.OF SIMULTANEOUS STATION
LICENSEVERSIONOPTION
EXPIRATION DATEMODELCOMPANY NAMEACTIVATION KEY
NUMBER OF CONNECTIONSNUMBER OF CONNECTED STATIONSLICENSEEASYCOM'S VERSIONEASYCOM'S OPTIONSEXPIRATION DATEAUTHORISED AS/400 MODEL

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

図4.6 EASYCLEF（６）

ライセンス登録が成功した場合、下記メッセージが表示されます。

ACTIVATION KEY IS CORRECT. EASYCOM IS OPERATIONAL.
失敗時には、次のようなメッセージが出ます。nnnn というのは、エラーコードです。

INVALID ACTIVATION KEY (nnnn). EASYCOM IS NOT OPERATIONAL.
エラー時は､ジョブログのメッセージをチェックしてください。
参考： ジョブログを参照するには、DSPJOBLOG を使います。
DSPJOBLOG

4.4

実行

TCP/IP ドメイン情報の登録
OS/400のドメイン名を登録します。
注意： すでにシステムのTCP/IP設定で、ドメイン名が設定されている場合には、このステップは不要です
ので、スキップして「4.5 TCP/IP ホスト・テーブルの登録」に移ってください。
（１） QSECOFR でログオンします。
（２） CHGTCPDMN と入力し、F4キーを押します。

表4.4 TCP/IPドメイン名設定値
設定値
ホスト名
MSJIS400
IPアドレス10.3.0.33
ドメイン名
MAGICDEV.CO.JP
ホスト名検索優先順位*LOCAL
インターネット・アドレス
*NONE
項目名

1
2
3
4
5

ホスト名には、iSeriesのシステム名を設定することを推奨します。ただし、システム名に ＃記号等が含まれている場合は、正しく設定できませんので、その場合は任意のホスト名を指定してください。

‑24‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

図4.7 CHGTCPDMN

4.5

TCP/IP ホスト・テーブルの登録OS/400のホスト・テーブルにiSeriesとクライアントＰＣのIPアドレス情報を追加します。
（１） CFGTCP プログラムを起動します。
（２） TCP/IPの構成画面から、10 「TCP/IP ホスト・テーブル項目の処理」を選びます。

図4.8 CFGTCP（３） 「TCP/IP ホスト・テーブル項目の処理」画面が表示されるので、OPT欄で 1 (追加)を選びます。

‑25‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

図4.9 CFGTCP（４） OS/400本体のIPアドレス情報を追加します。「TCP/IP ﾎｽﾄ･ﾃｰﾌﾞﾙ 項目の追加」画面が表示されます。ここでは、次のような情報を入力していきます。
表4.5 OS/400の追加設定値
項目
1 インターネット・アドレス
2 ホスト名①

意味
OS/400本体のIPアドレス

設定値例
10.3.0.33[ホスト名]+[.]+[ドメイン名]

MSJIS400.MAGICDEV.CO.JP

OS/400のシステム名

MSJIS400

IPアドレス (10.3.0.33)、ドメイン名付のホスト名 (MSJIS400.MAGICDEV.CO.JP) を入力して
ください。

図4.10
ADDTCPHTE ①‑26‑

キーを押します。

②「値の続きは+」に ＋ を入力し、 実行③「パラメーターの追加の値の指定」画面が出るので、ホスト名(MSJIS400)を入力します。

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

図4.11 ADDTCPHTE ②

追加が正しく設定された場合は下図のようになります。

図4.12 CFGTCP

以上で、Magic iSeries Server のインストールと設定は終了です。

‑27‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

第５章

デモアプリケーションの設定・実行

本章では、ブラウザクライアントアプリケーション開発手法のデモアプリケーション（以下、略して
BC̲Methodologyと呼びます）のセットアップ手順と、動作環境について説明します。
注意：z
本章の内容は、Magic iSeries Server 製品をインストールした場合にだけ行います。Client 製品のみをご利用になる場合には不要です。
zBC̲Methodologyを正しく動作させるには本書の第１章〜第４章までの設定が正しく行われていることを前提とします。
z
本章の説明では、Magic iSeries Server製品が、MAGICRUN94 という名前のライブラリにインストール
されたとして説明しています。別の名前のライブラリにインストールした場合には、適宜置き換えて
お読みください。

5.1

Magic Web アプリケーション用ファイルとフォルダ
ここでのステップは、すべてのMagic Webアプリケーションを正しく実行するために必要な設定です。
（１） Magic のWebアプリケーション(ブラウザクライアント・アプリケーション)を実行するために、下記のファイルが提供されています。
表5.1 Magic Webアプリケーション用ファイル
フォルダ名

内容

/MAGICRUN94/web̲utils

Magic Webアプリケーション用のアプレット、スクリプト、その他のファイル。

この中のファイルを、/QOpenSys/MAGICRUN94 にコピーします。
MKDIR DIR('/QOpenSys/MAGICRUN94')
CPY OBJ('/MAGICRUN94/web̲utils') TODIR('/QOpenSys/MAGICRUN94') SUBTREE(*ALL)

図5.1
web̲utils
コピー（２） 以下のディレクトリがブラウザクライアント実行時のキャッシュ用に必要となりますので、作成しておきます。

MKDIR DIR('/QOpenSys/MAGICRUN94/Browser̲Client̲Cache')‑28‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

5.2 デモアプリケーション用ファイルのコピー
BC̲Methodology デモアプリケーションが使うファイルとフォルダは、以下の通りです。
表5.2 BC̲Methodology が使うファイルとフォルダ
ファイル・フォルダ名

種類

内容/MAGICRUN94/Methodology94/meCTL.mff

ファイル/MAGICRUN94/Methodology94/Data/

フォルダ

Magicコントロールファイル
テキスト形式のサンプルデータが置かれています。
アプリケーションサーバが使用するHTMLファイルが置かれています。

/MAGICRUN94/Methodology94/Local/HTML/ フォルダ
フォルダ

Webサーバを経由してアクセスされるHTMLファ
イルとCSSファイルが置かれています。

/MAGICRUN94/Methodology94/Web/Images/ フォルダ

Webサーバを経由してアクセスされるイメージ
ファイルが置かれています。

/MAGICRUN94/Methodology94/Web/Html/

これらのファイルはフォルダごと /QOpenSys/MAGICRUN94 の下にコピーします
CPY OBJ('/MAGICRUN94/Methodology94') TODIR('/QOpenSys/MAGICRUN94') SUBTREE(*ALL)

図5.2
Methodology94
コピー

z
z

‑29‑

これらのファイルはデモアプリケーションですので、動作確認が終了し実際の運用に入るときには削除しても構いません。
BC̲Methodologyの詳細については、Magic eDeveloper に添付されている「ブラウザクライアントアプ
リケーション開発手法」を参照してください。

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

5.3

MAGIC400.INI の修正
MAGIC400.INI の中で、データベースの設定とデータベースのCCSIDの設定とを行います。
（１）

デフォルトデータベースの設定を行います。MAGIC.INIの中の[MAGIC̲DATABASES]セクションで、以下の 四角 で囲ってある部分の設定を変更してください。

[MAGIC̲DATABASES]
Default Database = 17, MAGIC, , DB̲LIBNAME, DB̲ADDRESS, , DB̲USER, +DB̲PASSWORD, NoMagicRecordLock, ChangeFileInToolkit,+
NoCheckDefinition, NoCheckKey, NoFileLocks, , , , NoCheckExist, 0, , +NoXATrans, AS400SrvrSort, etc/acs400.eng;
AS/400 = 17, , , DB̲LIBNAME, DB̲ADDRESS, , DB̲USER, DB̲PASSWORD, +NoMagicRecordLock, +ChangeFileInToolkit, NoCheckDefinition, NoCheckKey, FileLocks, , , , +NoCheckExist, 0, , NoXATrans, NoAS400SrvrSort,
各パラメータの意味と設定例を以下に示します。
表5.3 データベース定義のパラメータ
パラメータ名意味

設定例

DB̲LIBNAME

Magicアプリケーションがデータを格納するために用いるライブラリ名。このライブラリは事前に作成しておいてく
ださい。

MAGICAPLIBDB̲ADDRESS

iSeriesサーバのホスト名

MSJIS400

DB̲USER

セッション接続時のユーザＩＤ

MAGIC94

DB̲PASSWORD

上記ユーザIDに対するパスワード(MAGIC94のパスワード)

参考： BC̲Methodology デモアプリケーションは、データベースとしてはメモリーゲートウェイのみを使用しているので、実際にはDB2/400へのアクセスを行うことはありません。
（２）

デ ー タ ベ ー ス の CCSID を 設 定 し ま す 。 MAGIC400.INI の [dbMAGIC̲ENV] セ ク シ ョ ン で 、AS400ACSCodePage パラメータを設定してください。

[dbMAGIC̲ENV]
AS400ACSCodePage = 939※セットするCCSIDは、OS400環境により異なります。 「7.5 補足 CCSIDについて」を参照してください。

‑30‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

5.4 メッセージングサーバの設定
Magic iSeries Serverではメッセージングサーバとして、MRB (Magic Requests Broker)を使用します。
ここでは、一般的な設定として、Magic iSeries Server をインストールした iSeries上で動作するMRB をメッセージングサーバとして利用する場合の設定を行います。
参考： 他のプラットフォームで動作するMRBをメッセージングサーバとして使用することも可能ですが、ここでは説明を省略します。
（１）（２）

Magicサーバアカウント(MAGIC94など)でログオンします。
Magic サーバコンポーネントライブラリ (MAGICRUN94など) にカレントライブラリを設定します。
CHGCURLIB MAGICRUN94（３）

Magicサーバ構成プログラム CFGMGCSVR を起動します。
CFGMGCSVR
以下のような画面が表示されます。

図5.3
CFGMGCSVR画面（４）[MAGIC Config]→[MAGIC400.INI]メニューで MAGIC400.INIを開き、下記の設定を確認してください。これはインストール時のデフォルト値です。
表5.4 MAGIC.INI設定値
セクション名[MAGIC̲ENV][MAGIC̲SERVERS]①

設定値
MessagingServer△=△Default△Broker
Default△Broker△=△0,3300,,password,10,,1[Internet]→[MGREQ.INI]メニューで、MGREQ.INIを開き、以下の設定を確認します。これはインストール時のデフォルト値です
表5.5 MGREQ.INI設定値
設定値[REQUESTER̲ENV]‑31‑

Gateway△=△1
MessagingServer△=△3300

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

5.5

HTTP 属性の設定
Magic iSeries Serverのインターネット機能を利用するために、OS/400のHTTPサーバの設定を行います。

参考：z
HTTPサーバの詳細についてはIBMが提供する「TCP/IP 構成および解説書【SC41‑3420‑04】」、及びこのマニュアルの7章インターネットの「HTTPサーバのセットアップ」を参照してください。
この作業は、前節に引き続き、Magicサーバ構成プログラム CFGMGCSVR から行います。
（１） HTTPServerの起動： [Internet/Partition]→[Start HTTP Server]を選択します。
（２） 「TCP/IPサーバの開始(STRTCCPSVR)」の画面が出てきますので、「サーバ･インスタンス」に*ADMINを設定し、 実行を押します。

図5.4 STRTCPSVR

これ以降の作業は、クライアントPCから Webブラウザ(Internet Explorerなど)を起動して、Webブラウザ
上で行います。
（３）

Webブラウザのアドレスに、以下のURLを入力します。
http://MSJIS400:2001/
注意：z ここで、MSJIS400 というのは、Magic iSeries Server のインストールされている iSeries のホスト名です。実際のインストール環境に合わせて、適宜置き換えてください。

（４）

‑32‑

ユーザ名、パスワードが要求されるので、QSECOFR でログインします。

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

図5.5 パスワード（５）「iSeries タスク」画面が Webブラウザに表示されます。

図5.6
iSeriesタスク①（６）「IBM HTTP Server for iSeries」 を選択し、「セットアップ」→「グローバル・サーバー設定」
を選択し、コード化文字セットIDに943を入力し、 適用 ボタンを押します。その他の項目は変更する必要はありません。

図5.7
iSeriesタスク②‑33‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

5.5.1HTTP 構成の設定
ここでは、BC̲Methodology を動作させるためのOS/400のHTTPサーバ構成を設定します。
ここでの作業は、前節に引き続き、クライアントPC上の Webブラウザで行います。
以下の設定例で設定を行います。
HTTPサーバ設定例
項目
説明
設定例
HTTPサーバのタイプ
iSeriesでは、HTTPサーバとして Powered by Apache HTTP サ ー バ (Powered byと オ リ ジ ナ ル を 用 意 し て い ま す が 、 V9Plus で は Apache)Powered by Apacheのみをサポートしています。
サーバ名
HTTPサーバ毎に一意な名前をつけます。
BCMETHODP
サーバー・ルート
各HTTPサーバ毎の情報を格納するディレクトリを指 /www/bcmethodp
定します。
サーバの文書ルート
各HTTPサーバのルート 「/」に対応するディレクト /www/bcmethodp/htdocs
リ名を指定します。
使用ポート
HTTPサーバが待機するポート番号80（１） HTTPサーバの設定手順① 「新規HTTPサーバの作成」より「HTTPサーバ（powered by Apache）」を選択し、 次へ
ます。

を実行し

図5.8
HTTP ①②‑34‑

サーバ名に「BCMETHODP」を入力し、次へを実行します。

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

図5.9
HTTP ②③

既存のサーバーの構成を基にして新しいサーバーをセットアップしますか? では、「いいえ」を選択し、次へ を押します。

図5.10
HTTP ③④

サーバルートは、「/www/bcmethodp」として、次へを実行します。

図5.11
HTTP ④‑35‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

⑤

サーバーの文書ルートとして、「/www/bcmethodp/htdocs」として、次へを実行します。

図5.12
HTTP ⑤⑥

使用するポートは、80として、次へを実行します。

図5.13
HTTP ⑥⑦

アクセス・ログの使用は、「はい」のまま、次へ を押します。

図5.14
HTTP ⑦‑36‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

⑧

完了 を押して、新規HTTPサーバ作成をさせます。

図5.15
HTTP ⑧

図5.16
HTTP ⑨⑨「管理」− 「BCMETHODP−Apache」を選択します。

図5.17
HTTP ⑩‑37‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

⑩「構成ファイルの編集」を選択し、構成ファイルに設定を追加し、 適用 します。

図5.18
HTTP ⑪

表5.6 HTTP構成の設定
設定値
Alias△/Magic94Utils△/QOpenSys/MAGICRUN94/web̲utils
Alias△/Magic94Cache△/QOpenSys/MAGICRUN94/Browser̲Client̲Cache
ScriptAlias△/cgi‑bin△/QOpenSys/MAGICRUN94/cgibin<Directory△/QOpenSys/magicrun94/web̲utils>
Options△‑Indexes
AllowOverride△None
Order△allow,deny
Allow△from△all</Directory><Directory△/QOpenSys/MAGICRUN94/Browser̲Client̲Cache>
Options△Indexes△MultiViews
AllowOverride△None
Order△allow,deny
Allow△from all</Directory><Directory△/QOpenSys/MAGICRUN94/cgibin>
Options△‑Indexes
AllowOverride△None
Order△allow,deny
Allow△from△all
SetEnv△MGREQENV△/MAGICRUN94/etc/MGREQ.INI
SetEnv△MGCGIPASECONV※1</Directory># Methodology
Alias△/Methodology94△/QOpenSys/MAGICRUN94/Methodology94/Web<Directory△/QOpenSys/MAGICRUN94/Methodology94/Web>
Options△Indexes△MultiViews
AllowOverride△None
Order△allow,deny
Allow△from△all</Directory>※1 MGCGIPASECONV という環境変数は、iSeriesのApacheサーバでPASEのCGIリクエスタを使う際に、日本語文字を正しく扱うために必要です。

‑38‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

5.5.2

HTTP サーバの起動
OS/400のHTTPサーバーを以下の手順により起動します。
①

起動ボタンをクリックしてサーバを起動します。

図5.19
HTTPサーバ起動①②「実行中」となったことを確認します。

図5.20
HTTPサーバ起動②‑39‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

参考： HTTPサーバーの終了方法
通常、HTTPサーバを停止する必要はありませんが、必要な場合には以下のようにして停止させることができます。
①

停止ボタンにてHTTPサーバーを終了させます。

図5.21
HTTPサーバ停止 ①②「停止済み」になったことを確認します。

図5.22
HTTPサーバ停止②
参考： HTTPサーバーが起動状態で、HTTPの構成等を変更した場合、設定内容を有効にするには、一度HTTP
サーバーを終了させて、再起動する必要があります。この場合には、いったん停止ボタンで停止状態にしてから、実行ボタンで再開させてください。

‑40‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

5.6

MRB の起動iSeries上で動作するMRBは、以下のようにして起動します。
Magicサーバアカウント(MAGIC94など)でサイン・オンし、Magicサーバコンポーネントライブラリ(MAGICRUN94など) にカレントライブラリを設定しておきます。
（２） Magicサーバ構成プログラム CFGMGCSVR を起動します。
（３） [Internet/Partition]→[Start Magic Broker]メニューを選び、 実行 キーを押します。
（１）

図5.23
MRBの起動 ①（４）「Start Magic Broker (STRMRBRUN)」の画面が出るので、そのまま実行

キーを押します。

図5.24
MRBの起動 ②

（５）

‑41‑

MRBの起動状況を確認するには、[OS/400 Utility] → [Work with Active Jobs] にて活動ジョブの処理を実行します。
MAGICサブシテムの起動が正常に行われた場合は、MAGICサブシテムの下にMGBROKERが存在します。

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

図5.25 WRKACTJOB

5.7

Magic iSeries Server の起動
Magic iSeries Server を起動します。
（１）[Internet/Partition] → [Start eDeveloper Server] を選択して、 実行

キーを押します。

図5.26
Magic iSeries Server
の起動 ①

（２）

‑42‑

「Start eDeveloper Server (STRMAGINST)」画面が出るので、そのまま
１インスタンスが起動されます。

実行

キーを押すと、

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

図5.27
Magic iSeries Server
の起動 ②

（３）

Magic iSeries Serverの起動状況を確認するには、[OS/400 Utility] → [Work with Active Jobs]
にて活動ジョブの処理を実行します。
MAGICサブシテムの起動が正常に行われた場合は、MAGICサブシテムの下にMGSERVERが存在します。

図5.28 WRKACTJOB

以上で、設定がすべて終了しました。

‑43‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

5.8

BC_Methodology の実行
ここでは、BC̲Methodologyのデモアプリケーションが正しく動作することを確認します。デモアプリケー
ションの実行はクライアントPCのWebブラウザにて行います。
（１）

Webブラウザを起動し、以下のアドレスを入力します。
http://MSJIS400/Methodology94/Html/MainFrameset.htm
Magic iSeries Server、OS/400のHTTPサーバーの設定等が正しく行われていれば下図のようなデモアプリケーション(BC̲Methodology)のメインフレーム画面が表示されます。

図5.29 BC_Methodology
実行画面 ①

アプリケーションにログオンします。その際、以下のユーザ名、パスワードを使ってください。
表5.7 BC̲Methodology デモで用いるユーザIDとパスワード
アカウントの種類
ユーザ名
パスワード
デモシステム管理者
supervisor
1234
ゲスト
guest
guest
初期画面が表示され、ブラウザの左側にメニューが表示されますので、メニューを選んで、すべて正しく動作するかを確認してください。

図5.30 BC_Methodology
実行画面 ②‑44‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

第６章

導入時のトラブル対応

本章では、Magic iSeries Client、Magic iSeries Serverのインストール及び、デモアプリケーション（BC̲Methodology）セットアップ中に発生したトラブルの対応方法について説明します。

6.1

JOB ログの参照方法
MGCLIENT、MGSERVERジョブにおいてエラーが発生した場合、当該ジョブのジョブログに何かしらのエラー
情報が出力されている可能性があります。ここでは稼動中ジョブのジョブログの参照方法について説明します。
（１）

ジョブの変更

① コンソールから WRKACTJOB を起動します。
② 参照したいジョブの行のOPN欄に 2 を入力し 実行

キーを押します。

図6.1 WRKACTJOB

参考：zMagic 製品関係のジョブは、すべてMAGIC サブシステムの下にあります。
z
各コンポーネントのジョブ名は以下の通りです。
表6.1 Magic製品のジョブ名
ジョブ名
Magic iSeries
Client 製品
EASYCOM(通信ミドルウェア)
MGCLIENT○MRBMGBROKER(なし)
MagicアプリケーションサーバMGSERVER（なし）
コンポーネント

Magic iSeries
Server 製品○○○③ ジョブ変更(CHGJOB)画面が表示されるので、メッセージのロギング情報のレベルを4、ＣＬプログ
ラム・コマンドのログ*YESに変更し 実行‑45‑

キーを押します。

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

図6.2 CHGJOB

（２）
①
②

ジョブログの表示
コンソール画面から WRKACTJOB を起動します。
参照したいジョブの行のOPN欄に5を入力し 実行 キーを押します。

図6.3 WRKACTJOB③ ジョブの処理画面が表示されるので、「10. ジョブ・ログの表示」を選択し 実行 キーを押します。

図6.4 ジョブの処理④ ジョブの処理画面が表示されるので、「10. ジョブ・ログの表示」を選択し 実行 キーを押しま
す。

‑46‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

図6.5 ジョブログ⑤ ジョブログの詳細メッセージの表示方法
稼動中ジョブに何らかのエラーが発生している場合は、その旨のエラーメッセージが表示されます。また、表示メッセージ行にカーソルを置いて F1

キーを押すと、詳細メッセージが表示されます。

図6.6 ジョブログ（詳細）

参考：

‑47‑

z

画面上の半角英小文字は文字化けで表示されますが、Ctrl+ F3 で表示切替できます。

z③の「ジョブの処理」メニューよりその他の情報の参照が行えます。

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

6.2 フローモニタの参照方法
フローモニタは、Magicアプリケーションのデバッグ機能のひとつであり、Magicアプリケーションサーバ
が、アプリケーションを実行する様子をトレースし、ファイルに出力します。これには、Magicのコマンド(コール、項目更新等)の実行が1ステップごとにトレースされるので、Magicアプリケーションが意図したように動作しない場合に、内部動作の様子をチェックすることができます。
ここでは、Magic iSeries Server でフローモニタを設定する方法を説明します。
（１） フローモニタの設定① コンソールから Magic サーバ構成プログラム CFGMGCSVR を起動します。
② [Magic Config.] → [MGFLWMTR.INI] メニューを選びます。
③ 2（編集）を選びます。

図6.7 フローモニタ ①④

フローモニターの設定を行います。

図6.8 フローモニタ ②
参考：z
フローモニターの出力は、パフォーマンストラブルになる場合があります。実運用環境では極力使用しないようにして下さい。
z
MGFLWMTR.INIファイル中のパラメータの詳細は、iSeries開発ガイドを参照してください。
⑤

‑48‑

F3

で保管/終了します。

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

（２）フローモニタ出力の参照①[IFS Utility] → [Server Log Files] を選び、 実行②

5（表示）を選び、実行

キーを押します。

キーを押すと、選択されたログファイルの内容が表示されます。

図6.9 フローモニタ ③

図6.10 フローモニタ ④‑49‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

6.3

MRB ログとリクエスタログの設定・参照方法
Magic アプリケーションサーバでは、デバッグ用に各種ログを取得することが可能です。ここでは、MagiciSeries Server 製品でMRBログとリクエスタログを出力させる方法について説明します。
リクエスタログを出力させるためには、以下のファイルを修正します。
表6.2 ログ設定ファイル
ログの種類
設定ファイル
MRBのログ/MAGICRUN94/broker/MGRB.INI
リクエスタのログ/MAGICRUN94/etc/MGREQ.INIMRBのログ出力を有効・無効化するには、MGRB.INI の Log パラメータを、以下のように変更してください。
① Magicサーバ構成プログラム CFGMGCSVR を起動します。
② [Internet/Partition] → [MGRB.INI] メニューを選びます。
③ 2（編集）を選びます。

（１）

図6.11
リクエスタ‑ログ ①③

Logパラメータを設定します。

図6.12
リクエスタ‑ログ ②‑50‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

参考： Log パラメータの行は、次のように指定します。
Log = (ログファイル名) (同期) (レベル)zzz

ログファイル名： ログ出力を行うファイル名です。実行時には、これにプロセスIDが付加されたファイル名となります。
同期： Y または N を指定します。Y を指定すると、ログ1行ごとにディスクに書き込みが起こるため、ログ出力が確実になりますが、オーバーヘッドが大きくなります。
レベル： C、S、D を指定します。C がもっとも簡単な出力で、Dが一番詳細な出力です。
通常のトラブルシューティングには、S レベルが適当です。

ログ出力を停止するには、Log = の行をセミコロン ; でコメント化します。

（２）

Magic ア プ リ ケ ー シ ョ ン サ ー バ と 外 部 の モ ジ ュ ー ル (Web サ ー バ が 起 動 す る CGI リ ク エ ス タ(MGRQCGI94) や MRB)の通信のようすは、リクエスタログに記録されます。リクエスタログを有効化・無効化する場合は、MGREQ.INI を以下のように修正してください。

①

Magicサーバの構成プログラム CFGMGCSVR から、[Internet/Partition] → [MGREQ.INI] メニュー
を選びます。
2（編集）を選びます。

②

図6.13
リクエスタ‑ログ ③③

Logパラメータを設定します。

参考： Log = パラメータ行の意味は、MGRB.INI の場合と同じです。

‑51‑

図6.14
リクエスタ‑ログ ④

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

第７章

補足

Magic iSeries Client、Magic iSeries Server、デモアプリケーション(BC̲Methodology)の導入時における補足・注意事項について記載します。

7.1 ライセンス管理について
Magic iSeries 製品では、
z
ライセンスされたスレッド数z
MAGIC.INI中の [DBMS] セクションのDBMS特性→最大接続数 （MGCLIENTジョブの最大接続数）
z
MAGIC.INI中のMaxConcurrentRequests パラメータの設定が関連をもっており、設定を誤ると、必要以上のライセンス消費や接続時のエラーなどが発生することがありますので、正しく設定することが必要です。
ここではMAGIC.INIでのライセンス管理の設定について説明します。
（１）

クライアントPC上で動作する、Magic eDeveloper (開発版)、および Magic Client (実行版) が MagiciSeries Client を通して OS/400 上のファイルを参照する場合には、以下のように設定してください。

表7.1 ライセンス数と関連する MAGIC.INI パラメータ (Windows版)
設定
MAGIC.INI パラメータ
Magic eDeveloper および Magic Client の場合は常に1となり、MaxConcurrentRequests
設定は無視されます。
[DBMS／DBMS 特性／最大接続数]（２）１ を設定します。

クライアントPC (Windows) 上で動作する Magic Application Server が Magic iSeries Client を通して
OS/400 上のファイルを参照する場合には、以下のように設定してください。

表7.2 ライセンス数と関連する MAGIC.INI パラメータ (Windowsサーバ版)
設定
MAGIC.INI パラメータ
１インスタンスだけで運用される場合には、購入されたMagic
Application Server のライセンススレッド数を設定します。
MaxConcurrentRequests
複数インスタンスに分割する場合は、各インスタンスに分割することになりますが、全インスタンスの合計スレッド数が購入ライセ
ンススレッド数を超えないようにします。
1インスタンスだけで運用する場合には、購入された MagiciSeries Client のライセンス数を設定します。
[DBMS／DBMS 特性／最大接続数]
アプリケーションサーバを複数インスタンスに分割する場合は、各インスタンスに割り振ったMaxConcurrentRequests値と同じ値をセットします。
例：
購入ライセンスが以下の通りであったとします。
z
Magic Application Server ・・・ 10スレッドz
Magic for iSeries ・・・ 10 ユーザ
このとき、2インスタンスで運用する場合には、次のように設定します。
z
MaxConcurrentRequests = 5 （２インスタンス×５スレッド＝１０スレッド）z
DBMS／DBMS特性／最大接続数 = 5
（３）

‑52‑

iSeries 上で動作する Magic Application Server for iSeries （Magic iSeries Server）では、次のように設定してください。

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

表7.3 ライセンス数と関連する MAGIC.INI パラメータ (iSeriesサーバ版)
設定
MAGIC400.INI
１インスタンスだけで運用される場合には、購入されたMagic
Application Server for iSeries のライセンススレッド数を設定します。
MaxConcurrentRequests
複数インスタンスに分割する場合は、各インスタンスに分割することになりますが、全インスタンスの合計スレッド数が購入ライセ
ンススレッド数を超えないようにします。
1インスタンスだけで運用する場合には、購入された Magic
Application Server for iSeries のライセンス数を設定します。
[DBMS／DBMS 特性／最大接続数]
アプリケーションサーバを複数インスタンスに分割する場合は、各インスタンスに割り振ったMaxConcurrentRequests値と同じ値をセットします。
例：
購入ライセンスが以下の通りであったとします。
z
Magic Application Server for iSeries ・・・ 10スレッド
このとき、2インスタンスで運用する場合には、次のように設定します。
z
MaxConcurrentRequests = 5 （２インスタンス×５スレッド＝１０スレッド）z
DBMS／DBMS特性／最大接続数 = 5

7.2 ホストライブラリインストール環境について

OS/400システム値： iSeries 上で Magic 製品が正しく動作するために、下記OS/400システム値を確認してください
表7.4 iSeriesサーバ製品に関連するOS/400システム値
確認項目
確認内容
QAUTOCFG（自動構成装置）
オン’1’にする。
QAUTOVRT（仮想装置の自動構成装置の数）
接続最大数を設定（例 9999）
QALWOBJRST（オブジェクト復元可能オプション）*ALLにする。



ホストライブラリのインストール先ライブラリを MAGIC400（デフォルト値）とした場合は自動的に CFGTCPMGC の処理が行われますが、MAGIC400 以外のライブラリにホストライブラリをインストールした場合は、OS400 エミュレータ画面より、
CFGTCPMGC を実行する必要があります。 ホストライブラリを正しくインストールできた場合は、以下のように MAGIC サ
ブシステム、EASYCOMD ジョブが起動されます。ジョブの稼動確認は WRKACTJOB で行います。
OPTｻﾌﾞｼｽﾃﾑ/ｼﾞｮﾌﾞ ﾕｰｻﾞｰ
MAGIC
QSYS
QSYSWRKQSYS
EASYCOMDQSYSOPR

ﾀｲﾌﾟ
SBS
SBS
BCH

CPU %
機能
.0
.0
.0 PGM‑EASYCOMD

状況
DEQW
DEQW15:15 99/04/19
TIMW

MAGIC サブシステムが起動されていない場合、以下のコマンドを実行してください。
STRSBS SBSD(MAGIC400/MAGIC)EASCYCOMD ジョブが起動しない場合は、以下のコマンドを実行してください。
CHGCURLIB MAGIC400STREACD MAGIC400‑53‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

7.3 ホストライブラリの自動起動についてMagic環境の自動起動の流れ
ホストライブラリのが正常にインストールされると、OS/400のMAGICサブシステムが以下のような順序で自動起動されるように設定されます。
iSeries/400 電源投入
iSeries/400 IPL
QSYSWRKサブシステムの起動
MAGICサブシステムの起動
QSYSWRKサブシステムより、MGAUTO(自動開始ジョブ項目）が実行され、MAGICサブシステムが起動されます。
⑤ EASYCOMDジョブの起動
MAGICサブシステムより、MGDEAMON(自動開始ジョブ項目）が実行され、EASYCOMD ジョブが自動されま
す。
①
②
③
④



Magic環境が自動起動されない場合の確認事項
OS400の環境によっては起動タイミング等の問題で MAGICサブシステムの自動起動が正しく行われない場
合がありますが、その場合は 以下の項目を確認してください。

①

サブシステム記述(QSYS/QSYSWRK)の自動開始ジョブ項目にMGAUTOが登録されていること。

②

ジョブ記述(MAGIC400/MGAUTO)の要求データに STRSBS SBSD (MAGIC400/MAGIC) が登録されていること。
ここで指定するホストライブラリのライブラリ名(MAGIC400)には、V8と共存している環境の場合はV8のホストライブラリのライブラリ名を指定し、V8と共存していない場合にはV9のホストライブラリのライブラリ名を指定します。

③

ジョブ記述(MAGIC400/MGDRUN)の要求データにMAGIC400/STREACDと。

LIB(MAGIC400)が登録されているこ

上記の設定がされているにもかかわらず、OS/400のIPL時にEASYCOMDジョブが自動起動されない場合は、
TCP/IP環境より先にEASYCOMDジョブが起動されている可能性があります。
その場合は、以下のいずれかの方法で対応しください。

方法１： QSTRUP(CL)プログラムで、ジョブの遅延を行い、EASYCOMDジョブを起動する方法。
QGPL/QCLSRCにあるQSTRUP(CL)プログラムで、STRTCPコマンドより後に、 MAGIC400/STREACD LIB(MAGIC400)を実行するように修正し、コンパイルしてください。
必要に応じてジョブの遅延(DLYJOB)で調整を行い、OS400のTCP/IP環境より先にEASYCOMDジョブが起動されないようにしてください。
QSTRUP(CL)の例
0001.00 DLYJOB DLY(60) /* 60ﾋﾞｮｳノｼﾞｶﾝﾏﾁ */0002.00 ADDLIBLE LIB(MAGIC400)
0003.00 MONMSG MSGID(CPF0000)
0004.00 STREACD LIB(MAGIC400) /* MAGIC SUBSYSTEM ｷﾄﾞｳ */
0005.00 MONMSG MSGID(CPF0000)

方法２： QSTRUP(CL)プログラムから、ジョブの遅延を行い、MAGICサブシステムを起動する方法。
①QSYSWRKサブシステムの自動開始ジョブのMGAUTOを削除します。

RMVAJE SBSD(QSYSWRK) JOB(MGAUTO)‑54‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

②QSTRUP(CL)を修正します。
QSTRUP(CL)の例
0001.00 DLYJOB DLY(60) /* 60ﾋﾞｮｳノｼﾞｶﾝﾏﾁ */0002.00 STRSBS SBSD(MAGIC400/MAGIC)
0003.00 MONMSG MSGID(CPF0000)

7.4

Magic iSeries Server の動作環境を複数設定する方法について
本章では、異なる動作環境を複数作成・設定する方法について説明します。
Magic iSeries Server の動作環境(パラメータ)は、以下に示すような設定および設定ファイルにより定義されます。
表7.5 動作環境設定に関連する設定ファイル
項目
意味
デフォルトの値
ユーザID
iSeries にサインオンするユーザプロファイ Magic iSeries Server を イ ン ス
ルの名前。
トールしたときに利用したユーザ
プロファイル(MAGIC94など)。
ユーザ環境ファイル
ユーザIDと、そのユーザが利用する動作環境 etc/mguserenv
ファイルの対応を記述するファイル
動作環境ファイル
各ユーザが使用する MAGIC.INI、MGREQ.INI、 etc/mgappenv
MGFLWMTR.INI、ロードするベースゲートウェ
イ等を記述するファイル。
MAGIC.INIファイル
アプリケーションサーバの詳細な設定を行う etc/MAGIC400.INI
環境ファイル。
場合によっては、同じ iSeries ホスト上で、異なる動作環境（特に、異なる MAGIC.INI ファイル）で Magic
Application Server を同時に動作させたくなることがあります。
複数の動作環境は、サイン・オンするユーザ・プロファイルを複数作成して、ユーザ毎に異なるサーバ環
境ファイルを準備して構成することで実現します。
以下に、次のような設定で新しい動作環境を設定する場合について、説明します。

ユーザID
APPENVファイル
MAGIC.INIファイル（１）

新しいユーザー・プロファイル BCMETHOD を、CRTUSRPRF コマンドなどで作成します。
注意： このとき、コード化文字セットID (CCSID) を 939 にすることを忘れないでください。(4.1
節「ユーザプロファイルの作成」を参照)。

（２）

以下の手順で、サーバ動作環境設定ファイルをコピーします。

①
②
③

‑55‑

表7.6 新動作環境での設定要素の意味と設定例
意味
新動作環境での設定例
新しい動作環境を設定するためのユーザプロ BCMETHOD
ファイルの名前
Magic の動作環境設定ファイル（１）。
etc/mgappenv̲bcmethod
デフォルトでは etc/mgappenv
Magic の動作環境設定ファイル（２）。
etc/MAGIC400̲BC.INI
デフォルトでは etc/MAGIC400.INI

Magic のサーバアカウント (MAGIC94など)でログインします。
Magic サーバ構成プログラム（CFGMGCSVR）を起動します。
［IFS Utility］→［Work With Objects］ メニューを選ぶと「オブジェクト・リンクの処理(WRKLNK)」画面が出るので、「オブジェクト」に /MAGICRUN94/etc
を指定します。

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

図7.1
複数環境設定 ①④

etc で 5 (表示) を選びます。

図7.2
複数環境設定②⑤etc フォルダにあるファイルが表示されるので、mgappenv で 3（コピー）を入力し、 F4を押します。

キー

図7.3
複数環境設定③⑥‑56‑「オブジェクトのコピー」画面が出るので、「TOオブジェクト」にコピー先のファイル名/MAGICRUN94/etc/mgappenv̲bcmethod を設定して、 ENTER キーを押せば、ファイルがコピーさMagic eBusiness Platform V9Plus for iSeries

インストールガイド

れます。

図 7.4
複数環境設定 ④⑦

同様にして、MAGIC400.INI ファイルも MAGIC400̲BC.INI ファイルとしてコピーしてください。

図 7.5
複数環境設定 ⑤⑧

etc フォルダ内のファイル一覧を表示している「オブジェクトのリンクの処理」の画面まで戻り、
mgappenv̲bcmethod で 2 (編集) を選びます。

図7.6
複数環境設定⑥‑57‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

⑨mgappenv̲bcmethod ファイルの内容が表示されるので、MGENV=$MAGIC̲HOME/etc/MAGIC400.INIの行を
MGENV=$MAGIC̲HOME/etc/MAGIC400̲BC.INIに変更します。

図 7.7
複数環境設定⑦

参考： MGENV 以外の設定は、通常変更する必要はありません。
⑩

F3

⑪

同様にして、MAGIC400.INI ファイルの内容を、必要に応じて修正してください。

キーを押して、保管/終了してください。

図7.8
複数環境設定⑧‑58‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

（３）以下の手順で、ユーザ環境設定ファイルの設定を行います。

①

etc フォルダ内のファイル一覧を表示している「オブジェクトのリンクの処理」の画面まで戻り、
mguserenv で 2 (編集) を選びます。

②

mguserenv ファイルは、ログオンするユーザIDと、Magic Application Server が利用する環境設
定ファイルとの関連を定義しています。この例では、以下の構成で定義します。
表7.7 サーバ環境ファイル設定値
ユーザ・プロファイル
1 MAGIC94
2 BCMETHOD

サーバ環境ファイル/MAGICRUN94/etc/mgappenv（デフォルトサーバ環境ファイル）/MAGICRUN94/etc/mgappenv̲bcmethod

図7.9
複数環境設定⑨③

Magic サーバ構成プログラム（CFGMGCSVR）画面まで戻り、［Magic Config.］→［Setup Appl
Environment］ メニューを選び、「New Appl Environment File」で MGUSERENVを設定します。

図7.10
複数環境設定⑩④（４）F3キーを押して、Magic サーバ構成プログラムを終了します。

新しく設定された動作環境で Magic Application Server を起動するには、以下のように、新しいユーザプロファイル BCMETHOD でサイン・オンして、Magic Application Server を起動します。

① BCMETHODでサイン・オンします。
② CHGCURLIB MAGICRUN94 で、カレントライブラリを MAGICRUN94 にします。
③ CFGMGCSVR を起動します。
④ [Internet/Partition] → [Start eDeveloper Server] メニューを選び、Magic iSeries Server を起動します。

‑59‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

このときには、サーバ環境ファイルとして mgappenv̲bcmethod が使用され、MAGIC.INIは、/MAGICRUN94/etc/MAGIC400̲BC.INI が使用されます。
注意：mguserenv ファイルに記述されていないユーザ・プロファイルで起動された場合は、MagiciSeries Server は起動されません。

‑60‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

7.5

CCSID について
iSeriesは、１つのシステムで多言語をサポートしているため、日本語環境のシステム構築を行うには、
CCSIDを考慮して設定する必要があります。これらは、データベースだけでなく、関連するジョブに対しても設定されます。
CCSIDとは、簡単に言うと、ＩＢＭの文字セットの識別です。コンピューターの文字は、１バイト〜数バイ
トのビット構成で表現されますが、そのビット構成に対して、どういう記号文字を表示させるかを決定させるのが、文字セットです。
CCSIDは、日本語環境では大きく２つの種類があり、ユーザが正しく設定しないと、文字化けや誤動作が発生することがありますし、アプリケーションの拡張や統合の際に予期せぬ変更が必要になることがありますので、あらかじめ正しく理解しておく必要があります。

Magic for iSeriesでは、次の項目に対するCCSIDの確認、および設定が必要です。
表7.8 CCSIDの設定
設定場所

‑61‑

説明

既定の値

QCCSIDシ ス テ ム 全 体 の 省 略 時 CCSID 。
ジョブのデフォルト

iSeries出荷時のデフォル
ト値は、65535（*HEX）EASYCOMDジョブ

MGCLIENTジョブを起動するデー
モンジョブです。

通常は、QCCSIDの値となります。

MGCLIENTジョブ

データアクセスを行うときのCCSID。データベースファイルのCCSIDと同じにする必要があります。ファイルの新規作成時のCCSIDになります。

データベーステーブルに設定された接続ユーザIDのユーザプロファイルのCCSIDにより決まる。

データベースファイ
ル

ファイルに格納されたデータの
CCSID

作成時はMGCLIENTにより決定

ユーザプロファイル

サインオンユーザが起動した
ジョブのCCSIDを決定することができます。

MGSERVER ジョブ

アプリケーションサーバが動作する際のCCSID。5035（939）に設定する必要があります。

HTTPサーバジョブ

インターネットリクエスタが動作するときのCCSID。5035（939）に設定する必要があります。

IFSファイルMAGIC.INI, MGREQ.INI, HTMLテン
プレートなど。942または943に設定する必要があります。

Magic.ini−［設定／DBMS]のDBCSパラメータで指定されたCCSIDと矛盾がある
場合は、強制的にCCSIDが設定されます。

CFGMGCSVRより起動した場
合は、現在のジョブのCCSID（ユーザプロファイル）

SBCSのみの場合は、1208でも可能

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

日本語環境に関係するCCSIDには、次のような種類があります。

CCSID

種類

65535

表7.9 CCSIDの値
説明
OS/400導入時のQCCSIDに設定されている値。無変換を表す
特殊なCCSIDを意味します。
データベースファイルを生成した場合は、5026となります。

5026(930)

EBCDICSBCSにコードページ290を使用したCCSIDです。
コードページ290は、一般の英語圏の半角英小文字部分に半角カナを割り当てたもので拡張前のものは英小文字自体存在していません。
拡張後（拡張290）に英小文字が表示できるようになりま
したが、その他のCCSIDの英小文字とは別の位置に英小文字が詰め込まれたため、互換性はありません。

5035(939)

SBCSコードページ1027を使用したCCSIDです。
5026に対してその他のCCSIDと英小文字の互換性を取りつ
つ、半角カナを追加したCCSIDです。
全角文字については5026と同様で、丸付き数字等のいわゆるNEC選定漢字は利用できません

942
シフトJIS

943
1208

UTF‑8

日本語オープン環境用混合 PC データ

PASE上で動作するアプリケーションサーバが一時的に使用する場合があります。

表7.10 【CCSID＝5026】SBCSコードページ290‑62‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

表7.11【CCSID＝5035】 SBCSコードページ1027

7.5.1

QCCSID
通常、OS/400導入時の省略時CCSID（QCCSID）は、65535 (*HEX)にて出荷されています。CCSID=65535は、無変換を表す特殊なCCSIDを意味します。
QCCSIDは、DSPJOB によって確認することができます。

図7.11 CCSID

日本語環境では一次言語が日本語なので、出荷時のQCCSIDでは、起動したJOBの 省略時のCCSIDは「5026」(日本語半角カナ優先) になります。
従って、データベースファイルを生成した場合のデータベースのCCSIDは、5026となります。

‑63‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

「5026」では、半角英小文字の使用が制限されることにより、データベースファイルだけでなく、ジョブの動作に思わぬ問題が起こることがあるため、5035に変更することを推奨いたします。(IBM推奨値)
ただし、現在稼動中のシステムのQCCSIDを変更するとDBなどに影響がでることがあります。既存データに
半角カタカナを使用している場合、CCSID 5035ファイルへ変換させるなどの作業が必要になりますのでご注意ください。

7.5.2

MGCLIENT ジョブ の CCSIDMGCLIENTジョブのCCSIDはクライアントのデータベーステーブルで接続ユーザIDとして指定されている
ユーザプロファイルのCCSIDが設定されます。下図では、ユーザIDがMAGIC94と指定されていて、OS/400上
では MAGIC94 のユーザプロファイルで CCSID が939 と設定されているので、MGCLIENT ジョブも 939 で起動されます。
起動後に、MGCLIENTのCCSIDと、MAGIC.INI 中のDBMSテーブルで「DBCS=・・・」で指定されたCCSIDとが一致しているかが、ゲートウェイ初期化処理中にチェックされ、もし異なっている場合には警告メッセージ
ダイアログを出し、強制的にMGCLIENTジョブのCCSIDをMAGIC.INIの設定に合わせます。
OS/400MAGICサブシステム
Client(PC)DDSSRCCCSID:939

MGCLIENTジョブ
CCSID:939

Magic Client

DB2/400

接続ユーザのユーザプロ
ファイルのCCSIDが反映されます

Magic.ini
DBCS=IBM-943:IBM-939
AS400ACSCodePage = 939

EASYCOMDCCSID:939

ユーザ: MAGIC94
CCSID: 939

ユーザID=MAGIC94

図7.12 MGCLIENTジョブのCCSID概要

従って、警告メッセージが出た場合には、接続ユーザのユーザプロファイルのCCSIDと、DBCS=で指定されたCCSIDとが同じになるように設定してください。

図7.13 警告メッセージ

DDSSRCファイル、DB2/400ファイルのCCSIDは、作成時のMGCLIENTジョブのCCSIDが反映されます。
これは、DB2/400のCCSIDと読み込むジョブのCCSIDが一致している場合は特に問題はありませんが、異なる
場合、読み込んだデータが文字化けしたり、範囲処理で正しく処理できない原因となります。

‑64‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

7.5.3

Magic iSeries Server−QCCSID が 5035、939 環境での CCSID
Magic iSeries Server（MGSERVERジョブ）は、起動するCFGMGCSVRジョブのCCSID値により決定されます。
重要：
CFGMGCSVR、Magic iSeries Server（MGSERVERジョブ）のCCSIDは、必ず、939、又は5035にする必要があります。
OS/400MAGICサブシステム
Client(PC)MGCLIENTジョブ
CCSID:939

Magic Client

DDSSRCCCSID:939

MGCLIENTジョブ
CCSID:939

Magic.ini
DBMS=IBM-943:IBM-939
AS400ACSCodePage = 939
ユーザID： MAGIC94

DB2/400CCSID:939

MGSERVERジョブ
CCSID:939

ユーザ: MAGIC94
CCSID: 939

Magicエンジン

EASYCOMDMAGIC.INIHTTPサーバージョブ
CCSID:939
ブラウザ(PC)CGIリクエスター

図7.14 Magic iSeries Server 動作環境(CCSID)

DBMS=IBM-943:IBM-939
AS400ACSCodePage = 939

CFGMGCSVR

OS/400エミュレータ

ユーザープロファイル
CCSID:939
注）DB2/400ファイルのCCSIDは、作成時のジョブのCCSIDが使用されます。IFS関連ファイル（MAGIC.INI、
MGREQ.INI等）のCCSIDは942（又は932）にする必要があります。
AS400ACSCodePage：
使用するDB2/400のCCSIDの値を設定します。
指定のない場合のデフォルト値は、939[dbMAGIC̲ENV]
AS400ACSCodePage = 939‑65‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

7.5.4

Magic iSeries Server−QCCSID が 65535、5026、又は 930 環境での CCSID
Magic iSeries Server（MGSERVERジョブ）は、起動するCFGMGCSVRジョブのCCSID値により決定されます。
重要：
CFGMGCSVR、Magic iSeries Server（MGSERVERジョブ）のCCSIDは、必ず、939、又は5035にする必要があります。
OS/400MAGICサブシステム
Client(PC)MGCLIENTジョブ
CCSID:930

Magic Client

DDSSRCCCSID:930

MGCLIENTジョブ
CCSID:930

Magic.ini
DBMS=IBM-943:IBM-930
AS400ACSCodePage = 930
ユーザ: MAGIC94

DB2/400CCSID:930

MGSERVERジョブ
CCSID:939

ユーザ: MAGIC94
CCSID: 939

Magicエンジン

EASYCOMDMAGIC.INIHTTPサーバージョブ
CCSID:939

DBMS=IBM-943:IBM-930
AS400ACSCodePage = 930

CGIリクエスター

ブラウザ(PC)

CFGMGCSVR

図7.15 Magic iSeries Server 動作環境(CCSID)

OS/400エミュレータ

ユーザープロファイル
CCSID:939

注）DB2/400ファイルのCCSIDは、作成時のジョブのCCSIDが使用されます。IFS関連ファイル（MAGIC.INI、
MGREQ.INI等）のCCSIDは942（又は932）にする必要があります。
AS400ACSCodePage：
使用するDB2/400のCCSIDの値を設定します。
指定のない場合のデフォルト値は、939[dbMAGIC̲ENV]
AS400ACSCodePage = 930‑66‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

7.5.5

Magic iSeries Server−インターネット環境の CCSID
インターネットアプリケーションでは、英小文字の使用が前提になりますので、5026(930)の利用は適切ではありません。HTTPサーバージョブで動作するインターネットリクエスタ（MGRQCGI.PGM）は、HTTPサーバー
ジョブのCCSIDを元に動作するため、必ずHTTPサーバージョブは5035（939）で動作するように設定してください。
Magic iSeries Serverではデータベース以外のファイル（MAGIC.INI等）は、IFSを使用します。IFSファイ
ルのCCSIDは942又は932（Windows シフトJIS）で作成する必要があります。

‑67‑

Magic eBusiness Platform V9Plus for iSeries

インストールガイド

‑68‑Magic eBusiness Platform V9Plus for iSeries

インストールガイド