インストールガイド
Magic xpa for IBM 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 xpa は、Magic Software Japan K.K. の登録商標です。
Magic xpa Enterprise Studio、Magic xpa Enterprise Client および Magic xpa Enterprise Server、Magic xpa RIA Server は Magic Software Japan K.K. の商標です。
Pervasive.SQL は Pervasive Software, Inc. の商標です。
Microsoft および FrontPage は、Microsoft Corporation の登録商標です。また、Windows, Windows NT, Windows 2000, Windows XP,
Windows2003, ActiveX, SNAServer は Microsoft Corporation の商標です。
IBM Power SystemsTM は IBM 社の登録商標です。
EASYCOMTM は AURA Equipments 社の登録商標です。
一般に、会社名、製品名は各社の商標または登録商標です。
MSE および MSJ は、本製品の使用またはその使用によってもたらされる結果に関する保証や告知は一切していません。この製品のもたらす結果およびパフォーマンスに関する危険性は、すべてユーザが責任を負うものとします。
この製品を使用した結果、または使用不可能な結果生じた間接的、偶発的、副次的な損害（営利損失、業務中断、業務情報の損失などの損害も含む）に関し、事前に損害の可能性が勧告されていた場合であっても、MSE および MSJ、その管理者、役員、従業員、代理人は、いかなる場合にも一切責任を負いません。

2013 年 5 月 30 日

第一版

Copyright 2013 Magic Software Enterprises Ltd.and Magic Software Japan K.K.

All rights reserved.

目次
1 はじめにこのガイドの補足資料.................................................................................................................................................. 1
本書の概要...................................................................................................................................................................... 1
表記上の注意事項.......................................................................................................................................................... 1

2 Magic xpa for IBM i 導入手順
システム要件と設定例.................................................................................................................................................. 2
Magic xpa 製品....................................................................................................................................................................... 2
IBM i オペレーションシステムの必要要件 ....................................................................................................................... 2
クライアントマシン（PC）の必要要件............................................................................................................................. 3

Magic xpa for IBM i インストールの流れ.................................................................................................................... 4

3 Magic xpa IBM i Gateway セットアップ
Magic xpa Enterprise Studio ／ Client のインストール ............................................................................................... 5
クライアント PC の TCP/IP 環境の設定 ..................................................................................................................... 5
Magic xpa IBM i Gateway のインストール .................................................................................................................. 6
ホストライブラリ（Host DBA）のインストール..................................................................................................... 8
準備.......................................................................................................................................................................................... 8
旧バージョンと共存させる場合.......................................................................................................................................... 9
ユーザ・プロファイルのパスワードが正しくない.......................................................................................................... 13

4 補足
ライセンス管理について.............................................................................................................................................. 15
ホストライブラリインストール環境について.......................................................................................................... 17
ホストライブラリの自動起動について...................................................................................................................... 18
Magic 環境の自動起動の流れ............................................................................................................................................... 18
Magic 環境が自動起動されない場合の確認事項............................................................................................................... 18

CCSID について ............................................................................................................................................................. 20
QCCSID ................................................................................................................................................................................... 22
MGCLIENT ジョブ の CCSID .............................................................................................................................................. 23

Magic xpa for IBM i インストールガイドiこのガイドの補足資料

第 1 章 はじめに
本書は Magic xpa for IBM i 開発ガイドの補足資料とし、本書では、以下の Magic xpa for IBM i 製品のインストールのセットアップ方法・動作環境の設定について説明します。
本書では、製品名を以下のように省略する場合があります。
製品名

省略製品名

Magic xpa Application Platform

Magic xpa

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

1.1•

リファレンスヘルプ•

インストールガイド•

Magic xpa for IBM i 開発ガイド

このガイドの補足資料
Magic xpa のの各マニュアルに加えて、次に挙げる IBM 提供マニュアルは、IBM i サーバ環境でのアプリケーションの知識を補足することができます。
iSeries 実行管理
DDS 概念DDS 物理ファイルと論理ファイル
DB2 UDB for iSeries データベース・プログラミング
TCP/IP 構成および解説書【SD88-5013-04】

TCP/IP セットアップ

1.2

iSeries CL プログラミング【SD88-5038-06】

iSeries 機密保護解説書【SC41-5302-08】

本書の概要
第２章では、本書で使用するコンピュータの前提条件等の説明をします。
第３章では、Magic xpa for IBM i に関するインストール方法、および設定方法を説明します。
第４章では、導入時に発生しやすいトラブルの対応方法について説明します。

1.3

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

記号等

意味

1

△記号

空白（ブランク）

2［F4］

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

3

［実行］

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

Magic xpa for IBM i インストールガイド

1システム要件と設定例

第 2 章 Magic xpa for IBM i 導入手順
Magic xpa for IBM i 製品のインストールの流れについて説明します。

2.1

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

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

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

Magic 製品バージョン

1

Magic xpa Enterprise Studio

Ver2.32

Magic xpa for IBM i

Ver2.3IBM i オペレーションシステムの必要要件
サポートされるバージョン
V5R4、V6R1、V7R1

通信アダプタ•LAN アダプタ ( イーサネットまたは、トークンリンク )•TCP/IP

ディスク容量IBM i サーバには、約 30MB の容量を必要とします。インストールを行う前に十分な空きスペースがあるかどうか確認して下さい。もしインストールの途中で容量が不足した場合、イントールは中断します。サーバのディスク容量は、次のような方法でチェックすることができます。
1. IBM i のコンソールで、WRKSYSSTS コマンドを実行して、ディスクの稼働率を調べます。
2. WRKSYSVAL コマンドを実行し、QSTGLOWLMT（補助記憶域下限）をチェックします。

ホストライブラリのインストール時に必要なセキュリティ権限
Magic xpa for IBM i のインストールを行うために次のような処理を行うことのできる権限が必要です。
•

ライブラリの作成•

CRTSBSD コマンドにより、サブシステム記述の作成または変更•

システムの起動時に QSYSWRK のサブシステムを変更することにより、MAGIC サブシステムを自動起動

ホストライブラリをインストールするためのユーザプロファイルには、これらの処理をすべて実行できる権限が必要です。従って、QSECOFR かそれと同等の権限を持つユーザで実行すべきです。

Magic xpa for IBM i インストールガイド2システム要件と設定例

クライアントマシン（PC）の必要要件
ハードウェア•32 ビットの Intex x86 Processor（またはその互換 CPU）•

512MB 以上のメモリ•

300MB 以上のディスク空き容量•

通信アダプタが IBM i と接続可能であること•

Magic xpa Enterprise Studio/Magic xpa Enterprise Client が稼働できるマシンであること•サポート OS：Windows XP/Windows 2003/Windows Vista/Windows 2008/Windows7

Magic 製品をインストール・利用する前提として、クライアント PC 上に必要となるリソース、およびソフトウェア
は次の通りです。

通信構成
IBM i サーバと通信するために TCP/IP プロトコルを使います。
TCP/IP スタックは、Winsock 1.1 と互換性を持つものでなければなりません。
表 2-2 クライアント PC 上に必要なソフトウェア（○は必要、- は不要なことを表します）

注意：#

ソフトウェア

説明

Client 製品

1

ネットワーク環境。

TCP/IP が必須です○

2

FTP クライアント

インストール時に利用します。

○ ( 管理者 )3ターミナルエミュレータ

IBM i Access for Windows など。IBM i 上での設定に使います。

○ ( 管理者 )FTP クライアントおよびターミナルエミュレータは、インストールを行ったり、IBM i 側にインストー
ルした Magic 製品の構成等を管理する管理者の PC にのみ必要です。一般ユーザが Magic xpa Enterprise
Client を実行するためには必要ありません。
本文中の説明で使用する、クライアント PC の環境設定例は以下の通りです。
表 2-3 クライアント PC 環境設定例
#

PC

概要説明

1

OS/Version

Windows XP

2

コンピュータ名

SAMP

3

IP アドレス

10.3.0.190

Magic xpa for IBM i インストールガイド

3

Magic xpa for IBM i インストールの流れ

2.2

Magic xpa for IBM i インストールの流れ
Magic xpa for IBM i のインストール作業の流れを以下に示します。

START① Magic xpa Enterprise Studio/Client のインストール

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

3.2 を参照

Magic xpa for IBM i 製品のインストール③ Magic xpa IBM i Gateway のインストール

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

3.4 を参照

END

図 2-1 Magic xpa for IBM i インストールの流れ

Magic xpa for IBM i インストールガイド

4

Magic xpa Enterprise Studio ／ Client のインストール

第 3 章 Magic xpa IBM i Gateway セットアップ
本章では、Magic xpa IBM i Gateway のインストール及び動作環境の設定について説明します。
注意：

3.1

インストールの途中で、製品 DVD が必要になる場合がありますので、お手元に用意しておいてください。

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

3.2

クライアント PC の TCP/IP 環境の設定
クライアント PC と IBM i サーバ間には、ネットワーク環境として TCP/IP が必須であり、インストールに先立って、両者の間で正しく通信できるように、ホスト名の設定をしておく必要があります。

ホスト名の設定は、DNS あるいは HOSTS ファイルにより行います。

DNS を使用していないネットワーク環境では、HOSTS ファイルにホスト名と IP アドレスの対応を正しく定義しておいてください。
表 3-1 HOSTS ファイル設定例
127.0.0.1
10.3.0.33
10.3.0.190
参考：

localhost
MSJIS400
SAMP#AS/400#PC

HOSTS ファイルは、以下のディレクトリにあります。
•

Windows XP/Vista/7 では、C:\Windows\System32\Drivers\etc\HOSTS

ここで、C:\Windows というのは、Windows をインストールしたディレクトリで、違うフォルダにインストールした場合には、環境に合わせて読み替えてください。

Magic xpa for IBM i インストールガイド

5

Magic xpa IBM i Gateway のインストール

3.3

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

図 3-1 メンテナンス画面
2.

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

図 3-2 コンポーネント指定画面
この中から、「Magic xpa for IBM i 製品コンポーネント」を、以下のように選択します。
• 「IBM i Client」は必ず選択します。
※ホストライブラリは、管理者が一度だけ IBM i サーバにインストールします。

Magic xpa for IBM i インストールガイド

6

Magic xpa IBM i Gateway のインストール•

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

3. 「次へ（N）」を押下すると、IBM i クライアントコンポーネントがインストールされます。
参考：

このとき、次のようなダイアログが表示されたら、Magic xpa のインストール DVD を DVD ドライブ (この場合には G: ドライブ ) に挿入して、「OK」を押してください。

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

Magic xpa for IBM i インストールガイド

7

ホストライブラリ（Host DBA）のインストール

3.4

ホストライブラリ（Host DBA）のインストール
3.3 より継続して ホストライブラリのインストールが行われます。

準備•

ホストライブラリをインストールする際、インストーラでホストライブラリ名を指定します。デフォルトではMAGIC400 となりますが、別の名前のライブラリとすることも可能です。

•

旧バージョンのホストライブラリがインストールされている IBM i マシンにインストールする場合は、次ページの「旧バージョンと共存させる場合」の項を参照してください。

•

ホストライブラリのインストールは、QSECOFR アカウントで行います。QSECOFR アカウントのパスワードをシステム管理者より聞いておいてください。

•

以下の説明では、次の環境を仮定して説明します。別の名前のライブラリにインストールした場合には、適宜置き換えてお読みください。
表 3-2 インストール環境例
#

項目名

設定例

1

ホストライブラリ名

MAGIC400（デフォルト）2

IBM i ホスト名

MSJIS400

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

図 3-4Transfer Process 入力画面
2. 以下のようにインストールパラメータを入力し、[Install] ボタンをクリックします。
表 3-3TransferProcess 設定値
#

項目名

意味

入力値例

1

IBM i Destination Library

ホストライブラリ名

MAGIC400

2

SubSystemName

サブシステム名

MAGIC（変更しないことをお勧めします）

Magic xpa for IBM i インストールガイド

8

ホストライブラリ（Host DBA）のインストール
#

項目名

意味

入力値例

3

User ID

ログオンアカウント名QSECOFR

4

Psssword

パスワード（QSECOFR のパスワード）

5Port Number

接続ポート番号*DFT*DFT は 6077 番、変更したい場合は指定します。

6

Auto Start Job

ジョブ自動スタートYes

7

IBM i System

IBM i ホスト名

MSJIS400

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

図 3-5 正常終了時の結果メッセージ
注意：•

何らかの要因でインストールに失敗した場合は、次のメッセージが表示されます。エラーの要因は、ダイアログの「Messages」欄に表示されます。

•

再度インストールをやり直す場合は、IBM i 上の MAGIC400 という名前のライブラリを削除してからやり直してください。既に同名のライブラリが存在する場合は、インストールに失敗します。

図 3-6 異常終了時の結果メッセージ
4. ホストライブラリのインストールが完了すると、次のような構成が IBM i に作成されます。

参考：•

指定されたホストライブラリ名（デフォルトで MAGIC400）の名前のライブラリが作成されます。

•

MAGIC という名前の新しいサブシステム記述が、ホストライブラリに作られます。

•

MAGIC サブシステムが起動され、自動的に EASYCOM ジョブ（デーモン）を開始するよう設定されます。

•

システム・スタートアップで、自動的に MAGIC サブシステムを開始するよう設定されます。

構成については、「ホストライブラリインストール環境について」（ページ 17）も参照してください。
5. CFGMGCTCP コマンドにて、Magic xpa for IBM i の動作環境を変更することができます。
•

デフォルトの動作をできる限り、変更しないことを推奨します。

旧バージョンと共存させる場合
Magic/400 V8、Magic Platform for iSeries V9/V9Plus、及び Magic eDeveloper V10 を導入している IBM i の環境に、Magic
xpa のホストライブラリを導入する場合は、以下のようにインストールします。
1. MAGIC サブシステムの停止

Magic xpa for IBM i インストールガイド

9

ホストライブラリ（Host DBA）のインストール
2. ホストライブラリのインストール
3. 旧ホストライブラリでの再コンフィグレーション
4. ジョブ待ち行列項目の登録
5. 自動開始ジョブの追加
6. クライアントの設定
複数のホストライブラリを混在させる場合は、ライブラリ名を別けておく必要があります。
表 3-4 設定例
Magic バージョン

デフォルトライブラリ名の例

Magic iSeries V9Plus

MAGIC400

Magic System i V10

MAGIC40010

uniPaaS IBM i

MAGIC400U1

Magic xpa for IBM i

MAGIC400U1

この説明では、旧ホストライブラリ：MAGIC400、新ホストライブラリ：MAGIC400U1 として説明します。
重要：

Magic uniPaaS と共存する場合は、同一のホストライブラリを使用するため、インストールの必要がありません。

① MAGIC サブシステムの停止
1. 事前に、必ず MAGIC サブシステムを停止するようにしてください。
ENDSBS SBS(MAGIC) OPTION(*IMMED) ［実行］2. 現在のライセンス管理しているホストライブラリを確認しておきます。（デフォルトは、MAGIC400）RUNQRY *N QGPL/EASYCOM ［実行］3. SVALUE の値を確認します。以下の例では、MAGIC400 ライブラリとなっています。
報告書の表示行の位置指定 .......
行....+....1....+....2....+....3....+....4....+....5....+....6....
KWRD
FILER1
IVALUE SVALUE
000001 LICENCES_F
0 MAGIC400****** ******** 報告書の終わり ********②ホストライブラリのインストール
Magic xpa のホストライブラリ（HOST DBA）をインストールします。
ホ ス トラ イ ブ ラ リ の イ ン ス ト ー ル 画面（図 3-4）では、「Ports Number」を 6078、「IBM i Destination Library」をMAGIC400U1 に変更します。

③旧ホストライブラリでの再コンフィグレーション
従来は、インストール先のライブラリ名が「MAGIC400」の場合のみコンフィグレーション（CFGTCPMGC）が実行されましたが Magic xpa for IBM i からは、無条件に実行されるようになりました。
この環境では、旧バージョンが正しく起動できなくなるため、再度旧ホストライブラリ環境でコンフィグレーションを実行します。
ENDSBS SBS(MAGIC) OPTION(*IMMED) ［実行］CHGCURLIBMAGIC400［実行］

CFGTCPMGC SBS(MAGIC) JOBQ(MGCLIENT) CLASS(MGCLIENT) HOSTLIB(MAGIC400)［実行］UPDDTA FILE(QGPL/EASYCOM) ［実行］Magic xpa for IBM i インストールガイド

10

ホストライブラリ（Host DBA）のインストール［Page Down］を行い、SVALUE: MAGIC400U1 になったものを①で確認したライブラリ名（MAGIC400）に変更します。
注意：

ホストライブラリが自動起動されない場合の対処で QSTRUP から MAGIC サブシステムを起動している場合、QSYSWRK サブシステムに自動開始ジョブ MGAUTO が再度登録されますので削除するようにしてください。
詳細は、「ホストライブラリの自動起動について」（ページ 18）を参照してください。

④ジョブ待ち行列項目の登録
1. ジョブ待ち行列項目の確認：コマンドを実行します。
DSPSBSD SBSD(MAGIC400/MAGIC) ［実行］2. # ６「ジョブ待ち行列項目」を選択します。
ｻﾌﾞｼｽﾃﾑ 記述の表示
システム :
ｻﾌﾞｼｽﾃﾑ記述 ： MAGIC

ﾗｲﾌﾞﾗﾘｰ： MAGIC400MSJIS400

状況 ： 活動

次から１つを選択してください。
1. 操作属性
2. プール定義
3. 自動開始ジョブ項目
4. ワークステーション名項目
5. ワークステーション・タイプ項目
6. ジョブ待ち行列項目
7. 経路指定項目
8. 通信項目
9. リモート・ロケーション名項目
10. 事前開始ジョブ項目
続く ...
選択項目またはコマンド===> 6
F3= 終了F4= ﾌﾟﾛﾝﾌﾟﾄ

F9= ｺﾏﾝﾝﾄﾞ の複写

F12= 取り消し

3. SEQNBR の最後の番号を探します。下図では、30 が最後の番号です。
ジョブ待ち行列項目の表示システム :
ｻﾌﾞｼｽﾃﾑ記述 ： MAGIC

SEQ ジョブNBR 待ち行列 ﾗｲﾌﾞﾗﾘｰ
10 MGCLIENT MAGIC400
20 MGCLIENT MAGIC40094
30 MGCLIENT MAGIC40010

ﾗｲﾌﾞﾗﾘｰ： MAGIC400MSJIS400

状況 ： 活動最大 ------ 優先順位による最大数 -----活動 1 2 3 4 5 6 7 8 9*NOMAX * * * * * * * * **NOMAX * * * * * * * * **NOMAX * * * * * * * * *終わり

続行するには，実行キーを押してください。
F3= 終了 F12= 取り消し4. ジョブ待ち行列項目を追加します。
ADDJOBQE SBSD(MAGIC400/MAGIC) JOBQ(MAGIC400U1/MGCLIENT) MAXACT(*NOMAX) SEQNBR(40) ［実行］ここで、SEQNBR(40) の番号は、重複していなければ何でも構いません。通常、最後の番号＋ 10 を指定します。

Magic xpa for IBM i インストールガイド

11

ホストライブラリ（Host DBA）のインストール
5. ジョブ待ち行列項目を再確認します。
DSPSBSD SBSD(MAGIC400/MAGIC) ［実行］
ジョブ待ち行列項目の表示システム :
ｻﾌﾞｼｽﾃﾑ記述 ： MAGIC

ﾗｲﾌﾞﾗﾘｰ： MAGIC400

SEQ ジョブNBR 待ち行列 ﾗｲﾌﾞﾗﾘｰ
10 MGCLIENT MAGIC400
20 MGCLIENT MAGIC40094
30 MGCLIENT MAGIC40010
40 MGCLIENT MAGIC400U1MSJIS400

状況 ： 活動最大 ------ 優先順位による最大数 -----活動
1 2 3 4 5 6 7 8 9*NOMAX * * * * * * * * **NOMAX * * * * * * * * **NOMAX * * * * * * * * **NOMAX * * * * * * * * *終わり

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

⑤自動開始ジョブの追加
1. 自動開始ジョブを追加します。
ADDAJE SBSD(MAGIC400/MAGIC) JOB(MGDEAMON2) JOBD(MAGIC400U1/EASYCOMD) ［実行］MGDEAMON2 は、デーモンジョブの名称です。
2. 正しく設定されたかを確認します。旧／新バージョンのホストライブラリのデーモンジョブが起動されることを確認します。
ENDSBS SBS(MAGIC) OPTION(*IMMED) ［実行］WRKACTJOB を起動し、QSYSWRK で EASYCOMD ジョブが起動されていた場合は終了させます。
STRSBS SBSD(MAGIC400/MAGIC) ［実行］WRKACTJOB ［実行］旧バージョン、新バージョンのデーモンジョブ（EASYCOMD）が起動されていることを確認します。
活動ジョブの処理

MSJIS400
10/03/29 11:31:48

CPU %:

OPT.8

ｻﾌﾞｼｽﾃﾑ / ｼﾞｮﾌﾞMAGIC
MGDEAMON2QBATCHQCMNQSPL
QSYSWRKEASYCOMDQCSTCTCASD

経過時間 :

00:23:23

活動ジョブ数 :ユーザー
QSYS
QSYSOPR
QSYS
QSYS

ﾀｲﾌﾟ
SBS
ASJ
SBS
SBS

CPU %
.0
.0
.0
.0

QSYS
QSYS
QSYSOPR
QSYS

SBS
SBS
BCH
BCI

.0
.0
.0
.0

機能
PGM-EASYCOMD

PGM-EASYCOMDPGM-QCSTCTEXEC

150

状況
DEQW
TIMW
DEQW
DEQW

DEQW
DEQW
TIMW
SELW

⑥クライアントの設定
ホストライブラリとサーバのポート番号の変更にあわせて、クライアントの設定を変更します。

Magic xpa for IBM i インストールガイド

12

ホストライブラリ（Host DBA）のインストール
1. 設定 /DBMS で DBMS テーブルを開き、「パラメータ」欄に以下の形式でホストライブラリのライブラリ名を指定してください。
MAGICDBA=MAGIC400U1

図 3-7DBMS パラメータの設定
2.

設定 / データベースでデータベーステーブルを開き、IBM i のデータベース特性を開き、データベースサーバに、サーバ名：ポート番号 の形式で記述します。（例：IS400:6078）

図 3-8 データベースサーバの設定

ユーザ・プロファイルのパスワードが正しくない
OS400 V7R1、QCCSID が 65535 の環境の場合、接続時に以下のように「ユーザ・プロファイルのパスワードが正しくない」のエラーになる場合があります。

Magic xpa for IBM i インストールガイド

13

ホストライブラリ（Host DBA）のインストール

図 3-9 エラーメッセージ
その場合は、以下のように対応します。
EASYCOM のデーモンジョブの CCSID を 5035 で動作するように変更します。
通常のインストール状態では、EASYCOM のデーモンジョブ（EASYCOMD、又は MGDEAMON2）は、QSYSOPR
ユーザで動作しているのでジョブの CCSID は QCCSID で動作しています。

*SYSOPR 以上の CCSID=5035 のプロフィールを作成し、EASYCOMD デーモンジョブのジョブ記述のプロファイル
を変更します。
(例)
1. EASYCOM デーモンジョブ用のユーザ・プロファイルを作成します。
CRTUSRPRF USRPRF(MAGIC) USRCLS(*SYSOPR) CCSID(5035) ［実行］2. ジョブ記述のユーザ・プロファイルを指定します。
新規インストール時CHGJOBD JOBD(MAGIC400/EASYCOMD) USER(MAGIC) ［実行］旧バージョンと共存する時
CCHGJOBD JOBD(MAGIC400U1/EASYCOMD) USER(MAGIC)［実行］

Magic xpa for IBM i インストールガイド

14ライセンス管理について

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

4.1

ライセンス管理について
Magic IBM i 製品では、•MAGIC.INI 中の LicenseName ライセンス名の設定•

MAGIC.INI 中の［DBMS］セクションの DBMS 特性→最大接続数（MGCLIENT ジョブの最大接続数）•

MAGIC.INI 中の MaxConcurrentRequests パラメータの設定•

MAGIC.INI 中の MaxConcurrentUsers パラメータの設定が関連をもっており、設定を誤ると、必要以上のライセンス消費や接続時のエラーなどが発生することがあります
ので、正しく設定することが必要です。
ここでは MAGIC.INI でのライセンス管理の設定について説明します。
1. クライアント PC 上で動作する、Magic xpa Enterprise Studio ( 開発版 )、および Magic xpa Enterprise Client ( 実行版 ) が Magic xpa IBM i Gateway を通して IBM i 上のファイルを参照する場合には、以下のように設定してください。
表 4-1 ライセンス数と関連する MAGIC.INI パラメータ（Windows 版）
MAGIC.INI パラメータ

設定

MaxConcurrentRequests

Magic xpa Enterprise Studio および Magic xpa Enterprise Clientの場合は常に 1 となり、設定は無視されます。

DBMS ／ DBMS 特性／最大接続数

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

2. Windows 上で動作する Magic xpa Enterprise Server、および Magic xpa RIA Server が Magic xpa for IBM i を通して
IBM i 上のファイルを参照する場合には、以下のように設定してください。
表 4-2 ライセンス数と関連する MAGIC.INI パラメータ（Windows サーバ版）
MAGIC.INI パラメータ

設定

MaxConcurrentRequests

１インスタンスだけで運用される場合には、購入された
Magic xpa Enterprise Server のライセンススレッド数を設定します。
複数インスタンスに分割する場合は、各インスタンスに分割することになりますが、全インスタンスの合計スレッド数が購入ライセンススレッド数を超えないようにします。

MaxConcurrentUsers

Magic xpa RIA Server の場合のみ有効です。
１インスタンスだけで運用される場合には、購入された
Magic xpa RIA Server のライセンスユーザ数を設定します。
複数インスタンスに分割する場合は、各インスタンスに分割することになりますが、全インスタンスの合計ユーザ数が購
入ライセンスユーザ数を超えないようにします。

DBMS ／ DBMS 特性／最大接続数

実行時に最大接続数を超える場合は、並行実行数× 3 倍程度の値を設定してください。

例：① Magic xpa Enterprise Client の構成例
購入ライセンスが以下の通りであったとします。
•

Magic xpa Enterprise Client……100 ユーザ

Magic xpa for IBM i インストールガイド

15ライセンス管理について•

Magic xpa IBM i Gateway……100 ユーザ•

LicenseName=MGCSRT2•DBMS ／ DBMS 特性／最大接続数 = 0 ※ 0 は 3 となります。並行実行等を使用する場合は、並行実行数×3 倍程度を追加してください。

② Magic xpa Enterprise Server の構成例
購入ライセンスが以下の通りであったとします。
•

Magic xpa Enterprise Server……10 スレッド•

Magic xpa IBM i Gateway……10 ユーザ

このとき、2 インスタンスで運用する場合には、次のように設定します。
•

LicenseName=MGENT12•

MaxConcurrentRequests = 5 （2 インスタンス× 5 スレッド＝ 10 スレッド）•

DBMS ／ DBMS 特性／最大接続数 = 15

※使用スレッド数の 3 倍程度③ Magic xpa RIA Server の構成例
購入ライセンスが以下の通りであったとします。
•

Magic xpa RIA Server……100 ユーザ•

Magic xpa IBM i Gateway……100 ユーザ

このとき、2 インスタンスで運用する場合には、次のように設定します。
•

LicenseName=MGRIA12•

MaxConcurrentUsers = 50 （2 インスタンス× 50 ユーザ＝ 50 ユーザ）•

DBMS ／ DBMS 特性／最大接続数 = 150

Magic xpa for IBM i インストールガイド※使用ユーザ数の 3 倍程度

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

4.2

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

IBM i システム値：IBM i 上で Magic 製品が正しく動作するために、下記 IBM i システム値を確認してください
表 4-3IBM i システム値

•

確認項目

確認内容

QALWOBJRST（オブジェクト復元可能オプション）*ALL にする。

MAGIC サブシステムが起動されていない場合、以下のコマンドを実行してください。

STRSBS SBSD(MAGIC400/MAGIC) ［実行］•EASCYCOMD ジョブが起動しない場合は、以下のコマンドを実行してください。

CHGCURLIB MAGIC400 ［実行］STREACD LIB(MAGIC400) PORT(*DFT) ［実行］注意：

ホストライブラリの接続ポート番号をデフォルト値以外に設定して場合は値を指定してください。

Magic xpa for IBM i インストールガイド

17

ホストライブラリの自動起動について

4.3

ホストライブラリの自動起動について

Magic 環境の自動起動の流れ
ホストライブラリのが正常にインストールされると、IBM i の MAGIC サブシステムが以下のような順序で自動起動されるように設定されます。
1. IBM i 電源投入
2. IBM i IPL
3. QSYSWRK サブシステムの起動
4. MAGIC サブシステムの起動
MAGIC サブシステムより、MGAUTO（自動開始ジョブ項目）が実行され、MAGIC サブシステムが起動されます。
5. EASYCOMD ジョブの起動
MAGIC サブシステムより、MGDEAMON（自動開始ジョブ項目）が実行され、EASYCOMD ジョブが自動されます。

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

注意：•

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

•

ジョブ記述（MAGIC400/MGAUTO）の要求データに STRSBS SBSD（MAGIC400/MAGIC）が登録されていること。

•

ジョブ記述（MAGIC400/EASYCOMDN）の要求データに CALLPGM（MAGIC400/EASYCOMD）PARM（‘MAGIC400’’*DFT’’*ON’）が登録されていること。
• MAGIC400 は、ライセンスを登録しているホストライブラリです。
現在のライセンス登録を行っているホストライブラリは、以下で確認できます。（デフォルトは、
MAGIC400）
RUNQRY *N QGPL/EASYCOMSVALUE の値を確認• '*DFT' はホストライブラリの接続ポート番号です。デフォルト値以外を設定する場合は値を指定してください。

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

方法１： QSTRUP(CL) プログラムで、ジョブの遅延を行い、EASYCOMD ジョブを起動する方法。
QGPL/QCLSRC にある QSTRUP(CL) プログラムで、STRTCP コマンドより後に、MAGIC400/STREACD LIB（MAGIC400）を実行するように修正し、コンパイルしてください。
必要に応じてジョブの遅延（DLYJOB）で調整を行い、IBM i の 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) PORT(*DFT) /* MAGIC SUBSYSTEM ｷﾄﾞｳ */
0005.00 MONMSG MSGID(CPF0000)

Magic xpa for IBM i インストールガイド

18

ホストライブラリの自動起動について
方法２： QSTRUP(CL) プログラムから、ジョブの遅延を行い、MAGIC サブシステムを起動する方法。
1. QSYSWRK サブシステムの自動開始ジョブの MGAUTO を削除します。
RMVAJE SBSD(QSYSWRK) JOB(MGAUTO) ［実行］2. QSTRUP(CL) を修正します。
QSTRUP(CL) の例
0001.00 DLYJOB DLY(60) /* 60 ﾋﾞｮｳノｼﾞｶﾝﾏﾁ */0002.00 STRSBS SBSD(MAGIC400/MAGIC)
0003.00 MONMSG MSGID(CPF0000)

Magic xpa for IBM i インストールガイド

19

CCSID について

4.4

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

説明

既定の値

QCCSID

システム全体の省略時 CCSID。ジョブのデフォルトIBM i 出荷時のデフォルト値は、65535（*HEX）EASYCOMD ジョブ

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

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

MGCLIENT ジョブ

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

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

データベースファイル

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

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

ユーザプロファイル

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

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

CCSID

説明

EBCDIC

65535

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

5026(930)

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

Magic xpa for IBM i インストールガイド

20

CCSID について
種類

CCSID

説明

5035(939)

SBCS コードページ 1027 を使用した CCSID です。
5026 に対してその他の CCSID と英小文字の互換性を取りつつ、半角カナを追加した CCSID です。
全角文字については 5026 と同様で、丸付き数字等のいわゆる NEC 選定漢字は利用できません。
注意：
Magic xpa for IBM i では、5026/5035 共に、NEC 選定漢字は、CCSID1399の割り付けに沿って処理されます。CCSID1399 とは、Unicode ベースの日
本語 EBCDIC コードです。
CCSID1399 が使用できる環境であれば、OS400 環境からでも NEC 選定漢字を確認することが可能です。ただし、Magic xpa for IBM i で使用できる文字コードの範囲は、あくまで 5026/5035 の範囲となります。

シフト JIS942

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

943
UTF-8

1208

PASE 上で動作するアプリケーションサーバが一時的に使用する場合があります。
表 4-6【CCSID ＝ 5026】SBCS コードページ 290

表 4-7【CCSID ＝ 5035】 SBCS コードページ 1027

Magic xpa for IBM i インストールガイド

21

CCSID について

QCCSID
通常、IBM i 導入時の省略時 CCSID（QCCSID）は、65535 (*HEX) にて出荷されています。CCSID=65535 は、無変換を表す特殊な CCSID を意味します。

QCCSID は、DSPJOB によって確認することができます。

図 4-1CCSID

Magic xpa for IBM i インストールガイド

22

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

MGCLIENT ジョブ の CCSIDMGCLIENT ジョブの CCSID は起動時の MAGIC.INI に設定されたコードページが優先されて設定されます。
（図 4-2を参照）

図 4-2MGCLIENT ジョブの CCSID 概要

MAGIC.INI の DBMS パラメータで指定するホストのコードページの種類は次の通りです。
表 4-8 コードページの種類
テーブル名

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

939

英数小文字拡張

外字領域に割当*1 V10 より前のバージョンとの互換モードのため、将来サポートされない可能性があります。

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

Magic xpa for IBM i インストールガイド

23

Magic xpa for IBM i インストールガイド

Copyright 2014 Magic Software Enterprises Ltd.and Magic Software Japan K.K.

発行 〒 169-0074

東京都新宿区北新宿二丁目二十一番地一号
新宿フロントタワー 24 階All rights reserved.