Magic eDeveloper V10 for System i

インストールガイド-1-

Magic eDeveloper V10 for System i

インストールガイド

本マニュアルに記載の内容は、将来予告なしに変更することがあります。これらの情報について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 Software Japan K.K.の登録商標です。
• Magic Studio、Magic Enterprise Server、およびMagic RichClient ServerはMagic Software Japan
K.K. の商標です。

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

• Oracle はOracle Corporation の登録商標です。
• System i™ , OS/400™ 、DB2/400™ 、MQ/Series™ およびDB2 Universal Database for iSeries™ は
IBM 社の登録商標です。

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

初版

２００８年７月１８日
マジックソフトウェア・ジャパン株式会社-2-

Magic eDeveloper V10 for System i

インストールガイド

目

次

第１章

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

1.1 このガイドの補足資料 ................................................................................................................................ 4
1.2 本書の概要 .................................................................................................................................................. 4
1.3 表記上の注意事項 ....................................................................................................................................... 4
第２章

MAGIC FOR SYSTEM I導入手順 ......................................................................................................... 5

2.1 システム要件と設定例 ................................................................................................................................ 5
2.2 Magic for System iインストール～デモアプリケーションセットアップの流れ....................................... 7
第３章

MAGIC FOR SYSTEM I セットアップ ................................................................................................ 8

3.1 Magic Studio／Magic Clientのインストール............................................................................................ 8
3.2 クライアントPCのTCP/IP環境の設定 ....................................................................................................... 8
3.3 Magic System i Clientのインストール...................................................................................................... 9
3.4 ホストライブラリ（Host DBA）のインストール.................................................................................... 11
3.5 Magic for System iのライセンス登録 ...................................................................................................... 17
第４章

補足 ...................................................................................................................................................... 20

4.1 ライセンス管理について .......................................................................................................................... 20
4.2 ホストライブラリインストール環境について.......................................................................................... 21
4.3 ホストライブラリの自動起動について..................................................................................................... 23
4.4 CCSIDについて........................................................................................................................................ 25

4.4.1 QCCSID .................................................................................................................................................27
4.4.2 MGCLIENTジョブ のCCSID ...............................................................................................................28-3-

Magic eDeveloper V10 for System i

インストールガイド

第１章

はじめに

本書は Magic eDeveloper V10 for System i 開発ガイドの補足資料とし、本書では、以下の Magic eDeveloper
for System i 製品のインストール及び、インターネットデモアプリケーション（ブラウザウクライアント開発手法）のセットアップ方法・動作環境の設定について説明します。
z
Magic System i Gateway V10
本書では、製品名を以下のように省略する場合があります。
製品名
Magic eDeveloper V10 for System i
Magic System i Gateway V10

省略製品名Magic for System i
Magic System i Client

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

リファレンスヘルプ
新機能ガイドインストールガイド
System i開発ガイド

1.1 このガイドの補足資料
Magic eDeveloperのの各マニュアルに加えて、次に挙げるIBM提供マニュアルは、System iサーバ環境でのア
プリケーションの知識を補足することができます。
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 for System iに関するインストール方法、および設定方法を説明します。
第４章では、導入時に発生しやすいトラブルの対応方法について説明します。

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

-4-

△ 記号

意味
空白（ブランク）

2

F4

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

実行

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

Magic eDeveloper V10 for System i

インストールガイド

第２章

Magic for System i 導入手順

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

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

注意： 本書での設定例はあくまで説明のための例ですので、インストールにあたっては、
実際にインストールするSystem iやPCの環境に合わせて適宜読み替えてください。
（１） Magic eDeveloper 製品
本書では、以下のバージョンのMagic製品について説明をします。
表2.1 Magic製品とバージョン
1
2

Magic製品
Magic Studio
Magic for System i

バージョン
V10.1JSP4b
V10.1JSP4b（２） IBM System i オペレーションシステムの必要要件
サポートされるバージョン
・V5R3以上
通信アダプタ・LANアダプタ (イーサネットまたは、トークンリンク)
ディスク容量
System i サーバには、約30MBの容量を必要とします。インストールを行う前に十分な空きスペー
スがあるかどうか確認して下さい。もしインストールの途中で容量が不足した場合、イントールは中断します。サーバのディスク容量は、次のような方法でチェックすることができます。
(1) System i のコンソールで、WRKSYSSTSコマンドを実行して、ディスクの稼働率を調べます。
(2) WRKSYSVALコマンドを実行し、QSTGLOWLMT(補助記憶域下限)をチェックします。
ホストライブラリのインストール時に必要なセキュリティ権限
Magic for System i のインストールを行うために次のような処理を行うことのできる権限が必要です。
・ ライブラリの作成
・ CRTSBSD コマンドにより、サブシステム記述の作成または変更
・ システムの起動時にQSYSWRKのサブシステムを変更することにより、MAGICサブシステムを自動起動
ホストライブラリをインストールするためのユーザプロファイルには、これらの処理をすべて実行できる権限が必要です。従って、QSECOFRかそれと同等の権限を持つユーザで実行すべきです。

（３） クライアントマシン（PC）の必要要件
ハードウェア・ Pentium 1GHz以上のCPU・ 512MB以上のメモリ
・ 300MB以上のディスク空き容量-5-

Magic eDeveloper V10 for System i

インストールガイド

・・・

通信アダプタがSystem i と接続可能であること
Magic Studio/Magic Clientが稼働できるマシンであること
サポートOS: Windows 2000/Windows XP/Windows 2003/Windows Vista

Magic製品をインストール・利用する前提として、クライアントPC上に必要となるリソース、および
ソフトウェアは次の通りです。
通信構成
System i サーバと通信するためにTCP/IPプロトコルを使います。
TCP/IPスタックは、Winsock 1.1と互換性を持つものでなければなりません。

1
2
3

表2.4 クライアントPC上に必要なソフトウェア（○は必要、- は不要なことを表します）
ソフトウェア
説明
Client製品
ネットワーク環境 TCP/IP が必須です。
○
FTPクライアント
インストール時に利用します。
○(管理者)
ターミナルエミュ System i Access for Windows な ど 。 ○(管理者)
レータ
System i上での設定に使います。
注意：z
FTPクライアントおよびターミナルエミュレータは、インストールを行ったり、System i側にインストールしたMagic製品の構成等を管理する管理者のPCにのみ必要です。一般ユーザがMagic Clientを実行するためには必要ありません。
本文中の説明で使用する、クライアントPCの環境設定例は以下の通りです。
表2.5 クライアントPC環境設定例

1
2
3

-6-

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

概要説明
Windows XP
SAMP
10.3.0.190

Magic eDeveloper V10 for System i

インストールガイド

2.2Magic for System i インストール～デモアプリケーションセットアップの流れ
Magic for System i のインストール、デモアプリケーションのセットアップ作業の流れを以下に示します。
START① Magic Studio／Magic Clientのインストール

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

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

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

3.4 参照⑤ Magic for System i ライセンス登録

3.5 参照Magic for System i製品のインストールEND

図2.2 Magic for System iインストールの流れ-7-

Magic eDeveloper V10 for System i

インストールガイド

第３章

Magic for System i セットアップ

本章では、Magic for System iのインストール及び動作環境の設定について説明します。
注意：z
インストールの途中で、製品CD-ROMが必要になる場合がありますので、お手元に用意しておいてください。

3.1

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

3.2 クライアント PC の TCP/IP 環境の設定
クライアントPCとSystem iサーバ間には、ネットワーク環境として 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 2000/XP/Vista では、C:\Windows\System32\Drivers\etc\HOSTS
ここで、C:\Windows というのは、Windows をインストールしたディレクトリで、違うフォルダにインストー
ルした場合には、環境に合わせて読み替えてください。

-8-

Magic eDeveloper V10 for System i

インストールガイド

3.3Magic System i Client のインストール
Magic for System iのインストールは、Magic Studio/Magic Clientのインストールと同時に行うことも可能ですし、後から追加インストールすることも可能です。ここでは、Magic Studio/Magic Clientのインストー
ル後に追加する方法を説明します。
（１）「コントロールパネル」→「プログラムの追加と削除」から、Magic Studio／Magic Client を選択
し、「変更と削除」ボタンを押下すると、下図のようなメンテナンス画面が表示されます。

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

図3.2
コンポーネン
ト指定画面
この中から、「System i製品コンポーネント」を、以下のように選択します。
z「Magic for System iクライアントコンポーネント」は必ず選択します。
※ホストライブラリは、管理者が一度だけSystem iサーバにインストールします。
z（３）

管理者以外の通常のユーザのクライアントPCに Magic for iSeries クライアントコンポーネントをインストールする場合には、ホストライブラリを選択しないでください。

「次に(N)」を押下すると、System iクライアントコンポーネントがインストールされます。
参考： このとき、次のようなダイアログが表示されたら、MagicのインストールCDをCDドライブ(この場合には D: ドライブ)に挿入して、「OK」を押してください。

-9-

Magic eDeveloper V10 for System i

インストールガイド

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

-10-

Magic eDeveloper V10 for System i

インストールガイド

3.4 ホストライブラリ（Host DBA）のインストール
3.3より継続して ホストライブラリのインストールが行われます。
準備:z
ホストライブラリをインストールする際、インストーラでホストライブラリ名を指定します。デフォル
トでは MAGIC400 となりますが、別の名前のライブラリとすることも可能です。
z
Magic/400 (dbMAGIC V8.2) あるいはMagic Platform for iSeries V9/V9Plusがすでにインストールされている System iマシンに、V9Plus 用のホストライブラリをインストールする場合には、次ページの「Magic/400 V8、Magic Platform for iSeries V9/V9Plusと共存させる場合」の項を参照してください。
z
ホストライブラリのインストールは、QSECOFR アカウントで行います。QSECOFR アカウントのパスワー
ドをシステム管理者より聞いておいてください。
z
以下の説明では、次の環境を仮定して説明します。別の名前のライブラリにインストールした場合には、適宜置き換えてお読みください。
表3.2 インストール環境例
項目名
設定例

（１）

1

ホストライブラリ名

MAGIC400 (デフォルト)

2

System i ホスト名

MSJIS400

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

図3.4 Transfer
Process 入力画面（２）

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

（３）

-11-

System i System
User ID
Psssword

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

MSJIS400QSECOFR(QSECOFRのパスワード)

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

Magic eDeveloper V10 for System i

インストールガイド

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

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

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

（５）

CFGTCPMGCコマンドにて、Magic for System iの動作環境を変更することができます。
z
デフォルトの動作をできる限り、変更しないことを推奨します。ただし、インストール先のラ
イブラリをMAGIC400（デフォルト値）以外にした場合は、CFGTCPMGCを実行しなければいけません。（旧バージョンと共存する場合は除く）
z

CFGTCPMGCコマンドの操作方法については、「4.2 ホストライブラリインストール環境について」を参照してください。

SQLパッチの適用
SQLゲートウェイを利用する場合、System i のエミュレータから、次のコマンドを順に実行してください。

CHGCURLIB MAGIC400CALL PGM(MGEASY53U) PARM(MAGIC400 V5R3)
注意：
z

-12-

ここではインストール先のライブラリをMAGIC400としていますが、サーバ環境に合わせて適宜置き換えてください。

Magic eDeveloper V10 for System i

インストールガイド

注意： Magic/400 V8、Magic Platform for iSeries V9/V9Plus と共存させる場合
Magic/400 V8、および Magic Platform for iSeries V9/V9Plus を導入しているSystem iの環境に、
V10のホストライブラリを導入する場合は、次のような点を考慮する必要があります。
zzz

ホストライブラリのインストール先の変更
MAGICサブシステムへの追加、及び自動起動の設定
クライアントの設定

ホストライブラリのインストール先の変更
V8、V9、V9Plus、V10のホストライブラリ（HOST DBA）のライブラリは、以下の例のように異なる名前
でセットアップする必要があります。
従って、ホストライブラリのインストール画面(前ページ図3.4)では、「System i Destination Library」のMAGIC400を、MAGIC40010等に変更します。
表3.4 設定例
デフォルトライブラリ名の例
MAGIC400
MAGIC40094
MAGIC40010

Magic バージョン
Magic/400 V8
Magic iSeries V9Plus
Magic iSeries V10

MAGICサブシステムへの追加、及び自動起動の設定
デフォルトのMAGIC400以外のライブラリにインストールした場合、インストーラによるサーバコンフィ
グレーションが行われないため、手動で以下のようなコマンドを実行します。
また、旧バージョンのEASYCOMサーバと並行実行するために、V10のEASYCOMサーバのポート番号を変更する必要があります。(デフォルトのポート番号は6077)
以下の例では、ホストライブラリをMAGIC40010、起動するポート番号を6078としています。

1.

カレントライブラリを変更します。
CHGCURLIB MAGIC40010

2.

実行

EASYCOMサーバのコンフィグレーションを行います。

CFGEAC LIB(MAGIC40010) PTY('0') TCPTOUT(120) RESIGN(0) SIGNOF(0)LOGLEV('0') LOGCLOCK('*NO') HBEAT('*YES') JOBLOG('*NO')
LOCKED('*NO') PGMTOUT(0) CCSID('*USRPRF') SRTSEQ('*LIBL'/'*NONE')実行

3.

MAGICサブシステムのジョブを登録します。
ADDAJE SBSD(MAGIC400/MAGIC) JOB(MGDEAMON2) JOBD(MAGIC40010/MGDRUN)
実行

4.
登録したジョブの自動起動とコマンドを設定します。
CHGJOBDJOBD(MAGIC40010/MGDRUN)JOBQ(MAGIC40010/MGCLIENT)RQSDTA('MAGIC40010/STREACD
LIB(MAGIC40010)
PORT(6078)
PJ(*ON)RESTART(*NO)') INLLIBL(MAGIC40010)

実行※コマンドのスペースがない場合、CALL QCMDによるプロンプトから入力して下さい。

-13-

Magic eDeveloper V10 for System i

インストールガイド

EASYCLEFによる V10のライセンス登録の作業は、すでにライセンス登録しているV8、又はV9/V9Plusのホストライブラリで行います。つまり、既存ライセンス登録に継続して、V10のライセンスを登録します。
続いて以下の手順に従って、ジョブ待ち行列項目の登録を行ってください。
5.

ジョブ待ち行列項目の確認：コマンドを実行します。

DSPSBSD SBSD(MAGIC400/MAGIC)

6.

実行

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

ｻﾌﾞｼｽﾃﾑ 記述 :MAGIC

ﾗｲﾌﾞﾗﾘｰ:

MAGIC400

状況 :MSJIS400
活動

次の中から１つを選んでください。
1. 操作属性
2. プール定義
3. 自動開始ジョブ項目
4. ワークステーション名項目
5. ワークステーション・タイプ項目
6. ジョブ待ち行列項目
7. 経路指定項目
8. 通信項目
9. リモート・ロケーション名項目
10. 事前開始ジョブ項目

続く ...
選択項目またはコマンド===> 6

F3= 終了7.

F4=ﾌﾟﾛﾝﾌﾟﾄ

F9=ｺﾏﾝﾄﾞ の複写

F12= 取消し

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

サブシステム記述 :

-14-

SEQ

ジョブ

NBR

待ち行列

10

MAGIC

状況 :

MSJIS400

活動最大------ 優先順位による最大数 ------

ﾗｲﾌﾞﾗﾘｰ

活動

1

2

3

4

5

6

7

8

9

MGCLIENTMAGIC400*NOMAX

*

*

*

*

*

*

*

*

*

20

MGSERVERMAGICRUN82*NOMAX

*

*

*

*

*

*

*

*

*

30

MGBROKERMAGICRUN82

5

*

*

*

*

*

*

*

*

*

Magic eDeveloper V10 for System i

インストールガイド

終わり続行するためには，実行キーを押してください。
F3= 終了F12= 取消し

すでに区域の最下部が表示されている。

8.

ジョブ待ち行列項目を追加します。

ADDJOBQE SBSD(MAGIC400/MAGIC) JOBQ(MAGIC40010/MGCLIENT) MAXACT(*NOMAX)SEQNBR(40)

実行

ここで、
• MAGIC40010：V10 ホストライブラリ• 40：SEQNBR 重複していなければ何でも構いません。通常、最後の番号＋10を指定します。

9.

ジョブ待ち行列項目を再確認します。

DSPSBSD SBSD(MAGIC400/MAGIC

実行

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

ジョブ

NBR

待ち行列

10

MAGIC

状況 :

MSJIS400

活動最大------ 優先順位による最大数 ------

ﾗｲﾌﾞﾗﾘｰ

活動

1

2

3

4

5

6

7

8

9

MGCLIENTMAGIC400*NOMAX

*

*

*

*

*

*

*

*

*

20

MGSERVERMAGICRUN82*NOMAX

*

*

*

*

*

*

*

*

*

30

MGBROKERMAGICRUN82

5

*

*

*

*

*

*

*

*

*

40

MGCLIENTMAGIC40010*NOMAX

*

*

*

*

*

*

*

*

*
終わり

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

10. MAGICサブシステムが既に起動されている場合には、再起動します。

ENDSBS SBS(MAGIC) OPTION(*IMMED)STRSBS SBSD(MAGIC400/MAGIC)

実行

実行

クライアントの設定
ホストライブラリとサーバのポート番号の変更にあわせて、クライアントの設定を変更します。
1. 設定/DBMSでDBMSテーブルを開き、「パラメータ」欄に以下の形式でホストライブラリのライブラリ名を指定してください。
MAGICDBA=MAGIC40010-15-

Magic eDeveloper V10 for System i

インストールガイド

図3.7 DBMSパラ
メータの設定2. 設定/データベースでデータベーステーブルを開き、System iのデータベース特性を開き、データベー
スサーバに、サーバ名:ポート番号 の形式で記述します。(例．IS400:6078)

図3.8 データ
ベースサーバの設定-16-

Magic eDeveloper V10 for System i

インストールガイド

3.5

Magic for System i のライセンス登録
ホストライブラリのインストールが終わったら、Magic for System iのライセンス登録を行います。
Magic for System iのライセンス登録手続きは､Web でのユーザ登録、又はメールでのユーザ登録で行います。
折り返し、ユーザ登録コード（Activation key）を通知いたします。

Web でのユーザ登録
Web でユーザ登録情報を記入します。後程、ライセンス情報をメールで返信いたします。詳細は、以下のURLにアクセスしてください。
http://www.magicsoftware.co.jp/user/reg/v10userreg.html

メールでのユーザ登録
ユーザ登録情報を電子メール（japan_magicreg@magicsoftware.com）で送っていただきます。後程、ライセ
ンス情報をメールで返信いたします。
詳細は、CD-ROM の V10Registration.txt を参照してください。

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

EASYCOM ライセンス
D$MAGICE9MAGICE9MAGICE9MAGIC.INI のLicenseName
MGCSTKX
MGCSRTX
MGENTX1

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

F3 で行えます。

ユーザ登録コードの登録は、以下の手順で行います。
（１）（２）

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

（３）

-17-

実行

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

MAGIC400

CCSID(*HEX)実行

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

Magic eDeveloper V10 for System i

インストールガイド

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

キーを押下します。

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

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

図3.9 EASYCLEF

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

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

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

実行

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

-18-

Magic eDeveloper V10 for System i

インストールガイド

ライセンス登録に関するＦＡＱ
Ｑ：ホストライブラリの名前がMAGIC400以外の場合、どうすればよいですか？
Ａ： EASYCLEFコマンドの前に、CHGCURLIB(ライブラリ名)でインストールしたライブラリに変更して下さい。

Ｑ：新しいゲートウェイを入手して同じマシンの別のライブラリにインストールしてテストした
いのですが、その場合ライセンス登録は再度必要ですか？
Ａ：必要ありません。ライセンス登録は１つのライブラリでのみ行います。そのファイルは、
QGPL/EASYCOMです。

Ｑ：もし、有効なライセンスを持つホストライブラリを削除した場合、どうしたらよいですか？
Ａ：QGPL/EASYCOMというファイルを削除するか、現在保持している全てのライセンスを別のライブラリで再登録しなければなりません。

Ｑ：登録されたライセンスとほかのユーザ情報をどうやって見ることができますか？
Ａ：まず最初に、RUNQRY *N QGPL/EASYCOM コマンドを実行して、SVALUEの値を見ることによって、どのラ
イブラリにライセンス登録があるのかを知ることができます。
次にRUNQRY *N <ホストライブラリ>/AURA コマンドによってライセンス情報を見ることができます。

-19-

Magic eDeveloper V10 for System i

インストールガイド

第４章

補足

Magic for System iの導入時における補足・注意事項について記載します。

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

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

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

同時接続時の最大数を設定します。

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

表7.2 ライセンス数と関連する MAGIC.INI パラメータ (Windowsサーバ版)
設定
MAGIC.INI パラメータ
１インスタンスだけで運用される場合には、購入されたMagicEnterprise Server／Magic RichClient Server のライセンススレッ
ド数を設定します。
MaxConcurrentRequests
複数インスタンスに分割する場合は、各インスタンスに分割することになりますが、全インスタンスの合計スレッド数が購入ライセン
ススレッド数を超えないようにします。
実行時に最大接続数を超える場合には、適切な値を設定して下[DBMS／DBMS 特性／最大接続数]
さい。
例：
購入ライセンスが以下の通りであったとします。
z
Magic Enterprise Server ・・・ 10スレッドz
Magic for System i ・・・ 10 ユーザ
このとき、2インスタンスで運用する場合には、次のように設定します。
z
MaxConcurrentRequests = 5 （２インスタンス×５スレッド＝１０スレッド）z
DBMS／DBMS特性／最大接続数 = 5-20-

Magic eDeveloper V10 for System i

インストールガイド

4.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
EASYCOMD

ﾕｰｻﾞｰ
QSYS
QSYSOPR

ﾀｲﾌﾟ
SBS
BCH

CPU %
.0
.0

機能
PGM-EASYCOMD

状況
DEQW
TIMW

MAGIC サブシステムが起動されていない場合、以下のコマンドを実行してください。
STRSBS SBSD(MAGIC400/MAGIC)EASCYCOMD ジョブが起動しない場合は、以下のコマンドを実行してください。
CHGCURLIB MAGIC400STREACD LIB(MAGIC400)
注意：・EASYCOMDジョブの起動を画面から「STREACD MAGIC400」 コマンド（前述参照）で行なった場合は、現在
サインオンしているジョブのコード化文字セットＩＤ(CCISD)が反映されますので注意してください。
「4.5.2 MGCLIENT ジョブのCCSID」も参照してください。



CFGTCPMGC を実行する場合は、以下のように行います。
① CHGCURLIB MAGIC400② MAGICのTCPを設定するために、CFGTCPMGCをタイプして、 F4 を押下してください。
Configure TCP/IP For Magic (CFGTCPMGC)

選択項目を入力して，実行キーを押してください。

Subsystem name .................

MAGIC*HOSTLIB

Name
Name, *HOSTLIB

Job queue name ................. MGCLIENT*HOSTLIB

Name
Name, *HOSTLIBClass name ..................... MGCLIENT*HOSTLIB

Name
Name, *HOSTLIB

Auto start the subsystem ..........

Logical value, *YES, *NO*YES

Host library .................... MAGIC400
Character value
Number-21-

Magic eDeveloper V10 for System i

インストールガイド

③ 必要に応じてフィールドに入力して、実行 キーを押下します。

システムは、新しい設定値で構成されます。Auto start the subsystem(*YES)のデフォルトが許可されていれば、次にシステムがIPLを実行するとき、MAGICサブシステムとデーモンが自動的に開始されます。

-22-

Magic eDeveloper V10 for System i

インストールガイド

4.3 ホストライブラリの自動起動についてMagic環境の自動起動の流れ
ホストライブラリのが正常にインストールされると、OS/400のMAGICサブシステムが以下のような順序で自動起動されるように設定されます。
①②③④

System i電源投入
System i IPLQSYSWRKサブシステムの起動
MAGICサブシステムの起動
MAGICサブシステムより、MGAUTO(自動開始ジョブ項目）が実行され、MAGICサブシステムが起動されます。
⑤ EASYCOMDジョブの起動
MAGICサブシステムより、MGDEAMON(自動開始ジョブ項目）が実行され、EASYCOMD ジョブが自動されます。
Magic環境が自動起動されない場合の確認事項
OS/400の環境によっては起動タイミング等の問題で 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)で調整を行い、OS/400の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を削除します。

-23-

Magic eDeveloper V10 for System i

インストールガイド

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

Magic eDeveloper V10 for System i

インストールガイド

4.4

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

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

-25-

説明

既定の値

QCCSID

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

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

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

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

MGCLIENTジョブ

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

初期起動時は、Magic.ini－［設定／DBMS]のDBCSパラメータの設定になります。起動するユーザのユーザプロファイルと異なる場合
は、警告メッセージが表示されます。

データベースファイル

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

作成時はMGCLIENTにより決定されます。

ユーザプロファイル

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

Magic eDeveloper V10 for System i

インストールガイド

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

CCSID
65535

説明
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-26-

Magic eDeveloper V10 for System i

インストールガイド

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

4.4.1

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

図7.11 CCSID

日本語環境では一次言語が日本語なので、出荷時のQCCSIDでは、起動したJOBの 省略時のCCSIDは「5026」(日
本語半角カナ優先) になります。

-27-

Magic eDeveloper V10 for System i

インストールガイド

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

4.4.2

MGCLIENT ジョブ の CCSIDMGCLIENTジョブのCCSIDは起動時のMAGIC.INIに設定されたコードページが優先されて設定されます。（下図参照）
OS/400MAGICサブシステム
Client(PC)DDSSRCMGCLIENTジョブ
CCSID:5026

Magic Client

CCSID:5026

DB2/400

MAGIC.INI の CCSID が 反映されます。

CCSID:5026

Magic.ini
EASYCOMDDBMS=IBM-943:IBM-5026
AS400ACSCodePage = 5026

CCSID:5026

図7.12 MGCLIENTジョブのCCSID概要
MAGIC.INIのDBMSパラメータで指定するホストのコードページの種類は次の通りです。
テーブル名

EBCDICコード
ページ

半角文字

NEC特殊文字IBM-5026

5026

英数カナ

CCSID1399に対応

IBM-5035

5035

英数小文字拡張CCSID1399に対応

IBM-930(*1)

930

英数カナ

未対応

IBM-939(*1)

939

英数小文字拡張

未対応

IBM-990(*1)

930

英数カナ

外字領域に割当IBM-999(*1)

939

英数小文字拡張

外字領域に割当*1 V10より前のバージョンとの互換モードのため、将来サポートされない可能性があります。
ユーザプロファイルに設定されたCCSIDと異なる場合は警告メッセージが表示されます。
DDSSRCファイル、DB2/400ファイルのCCSIDは、作成時のMGCLIENTジョブのCCSIDが反映されます。

-28-

Magic eDeveloper V10 for System i

インストールガイド

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

-29-

Magic eDeveloper V10 for System i

インストールガイド

Magic eDeveloper V10 for System i インストールガイド

Copyright 2008 Magic Software Enterprises Ltd.and Magic Software Japan K.K. All rights reserved.
第2版

2008年7月18日

発行 〒151-0053 東京都渋谷区代々木三丁目二十五番地三号
あいおい損保新宿ビル14階-30-

Magic eDeveloper V10 for System i

インストールガイド