製品の導入に関する重要なお知らせ

最終更新日：2012年5月30日

LANSA製品をご使用のお客様へ

株式会社ランサ・ジャパン

製品の導入に関する重要なお知らせ

当ドキュメントではLANSA Xiの導入時に必要な考慮事項を記述しております。重要な事項が含まれておりますので、導入作業を開始する前に、必ず当ドキュメントをご確認ください。

1. LANSA Xi のCDについて

LANSA XiのCDには、

LANSA iSeriesソフトウェア Disk 1
LANSA iSeriesソフトウェア Disk 2
LANSA Windowsソフトウェア
CS Builder/クライアント

の４種類がございます。

ご購入下さいました製品により、お届けするCDが異なりますが、それぞれのCDからは、下記の製品の導入ができます。
※製品のご使用には、ライセンスが必要になります。

LANSA iSeriesソフトウェア Disk 1/2

LANSA/AD
LANSA for the Web
LANSA Integrator

LANSA Windows ソフトウェア

Visual LANSA
(Sybase Adaptive Server Anywhere V9.0.2 がバンドルされています)
LANSA for the Webユーティリティ
CS Builder/サーバー

CS Builder/クライアント

CS Builder/クライアント

※導入の詳細につきましては、導入手順書をご参照くださいますようお願い申し上げます。

2. LANSA導入手順書について

LANSA Xi　（iSeries、Windows共）の導入手順は、セットアップCDに含まれております。

2.1 Windowsソフトウェア

PCにCDをセットすると、自動的にインストーラWebページﾞが表示され、イントロダクションに従って進むことで、目的の製品をインストールすることができます。
インストールWebページから詳細のインストールガイドを参照することができます。
※Windows VISTA、Windows 7、Windows 2008等のユーザーアカウント制御(UAC)を実装したOSにインストールする場合には、UACを無効した状態でインストールを行ってください。UACが有効になっていますと、インストール処理が異常終了します。

2.2 iSeriesソフトウェア

PCにCDをセットすると、自動的にインストーラWebページが表示され、イントロダクションに従って進むと、目的の製品のインストール方法が表示されます。
インストール方法を確認後、CDをiSeriesへセットして確認したインストール方法に従って導入を行ってください。
インストールWebページから詳細のインストールガイドを参照することができます。

3. IBM iへのLANSAのインストールについて

LANSA Xiでは、CCSID5035が標準対応となっております。
LANSA　Xiの新規導入またはバージョンアップ作業前にご使用のIBM iのシステム値および既存ジョブの属性をご確認ください。
ご使用のIBM i環境により、LANSA　Xiの新規導入またはバージョンアップ作業中にジョブやユーザー・プロファイルのコード化文字セット識別(CCSID)の設定作業が必要になる場合があります。

3.1 システム値CCSIDの確認

5250画面からユーザーQSECOFRもしくはユーザー・クラス*QSECOFRのユーザーでサインオンし、コマンド入力行からDSPSYSVAL QCCSIDを実行してください。「システム値の表示」の画面が表示されます。この画面上の「コード化文字セット識別」の値をメモしてください。

IBM iは出荷時には65535になっていますが、ご使用のIBM iが日本語OSの場合はコード化文字セット識別は、通常以下の3つうちのいずれかの値になります。
LANSA for the WebやWebSphere等、インターネット関連のアプリケーションが稼動するシステムでは5035の設定が必須です。

65535（出荷時の省略値）
5026
5035

システム値CCSID の変更はシステム全体に影響を与えるため、LANSAおよびLANSA以外のシステムが既に稼動中の場合は、システム値の変更がシステムに与える影響を事前に十分考慮する必要があります。
システム値の変更がシステムに与える影響を予測できない場合、もしくは影響が大きい場合にはシステム値CCSIDを変更せず、稼動するリスナー・ジョブのユーザー・プロファイルまたはジョブ投入時のリスナー・ジョブのCCSIDを設定することができます。
また、システム内で使用するユーザー・プロファイルのCCSIDパラメータの省略値は通常*SYSVALで、上記システム値QCCSIDの値を参照します。
LANSA Xiではコード化文字セット識別が5035になっていることを前提にリスナー・ジョブを構成しているため、システム値CCSIDおよびジョブのCCSIDの見直し作業が必要になります。

3.2 LANSAおよびLANSA以外のシステムが既に稼動中の場合のジョブCCSID確認方法

既存LANSAシステムのリスナー・ジョブが稼動中の場合は以下の方法でジョブのCCSIDを確認できます。

(1) 5250画面からサインオンし、WRKACTJOBを実行してリスナー・ジョブを探します。リスナージョブは通常TPで始まるジョブです。

(2)「活動ジョブの処理」の画面から該当ジョブに対して「5= 処理」を入力し、更に「2. ジョブ定義属性表示」を実行すると、「ジョブ定義属性表示」画面が現れます。
「PageDown」キーで画面を押して、最後のページを表示してください。「コード化文字セット識別コード」が見つかるはずです。この値がCCSIDです。
また、リスナー以外のジョブのCCSIDについても同様にWRKJOBまたはWRKACTJOBで確認できます。

3.3 LANSAおよびRPGシステムが既に稼動中の場合のリスナー・ジョブCCSID設定方法

3.3.1 LANSA Xiを新規導入し、リスナー・ジョブをCCSID　5035で実行する場合

LANSA for the Webを開発・実行する場合もしくはその他の要件でLANSAのジョブCCSID　を5035にする必要がある場合です。

リスナー・ジョブのCCSIDを5035に設定するには以下の手順で設定変更を行います。

(1) リスナー・ジョブ用ユーザー・プロファイルの変更

LANSA Xiを新規導入後
CHGUSRPRF USRPRF(<ユーザー名>) CCSID(5035)
を実行します。

<ユーザー名>は、通常、LANSAプログラムライブラリ名と同一で、LANSA　Xiを新規導入時に自動生成されます。
このユーザー・プロファイルは LANSA　Xiを新規導入時に自動生成されるサブシステム(通常:DCXPGMLIB)内の自動開始ジョブ用ジョブ記述DCXLISTJD内で使用されます。

(2) リスナー・サブシステムの再起動

ENDSBS SBS(<ユーザー名>) OPTION(*IMMED)

STRSBS SBS(<LANSAプログラムライブラリ>/<ユーザー名>)

例：

STRSBS SBSD(DCXPGMLIB/DCXPGMLIB)

再度、WRKACTJOBを実行し、サブシステム<ユーザー名>下でのリスナージョブ稼動状況を確認してください。

3.3.2 LANSAシステムを新規導入し、リスナージョブをCCSID 5035以外で実行する場合

ランサ・ジャパンお問合せ窓口、または担当の営業にご相談ください。

株式会社ランサ・ジャパン　お問合せ窓口
Tel: 03-5275-1201
Fax: 03-5275-1202
E-Mail： info_japan@lansa.jp

3.3.3 ＬＡＮＳＡバージョン10.0からアップグレードする場合

リスナー・ジョブを実行するCCSIDが5035の場合、リスナー構成LANSA REQUEST(CONFIGURE)で「通信経路指定テーブル」、「トレース・ファイル名」に英大文字また英小文字を使用することができますが、リスナーをSBMJOBするジョブのCCSIDまたは自動開始ジョブ用ユーザー・プロファイルのCCSIDを5035にしてください。

リスナー・ジョブを実行するCCSIDが5035以外の場合は、リスナー構成LANSA REQUEST(CONFIGURE)で「通信経路指定テーブル」、「トレース・ファイル名」に英大文字のみを使用してください。

3.4 IBM iを新規導入し、LANSAおよびLANSA以外のアプリケーションがまだ何も導入されていない場合

LANSAおよびLANSA導入するアプリケーションのシステムを含め、導入するアプリケーションの内容によりますが、システム値QCCSIDの値を5035に設定可能かご検討ください。

3.5 その他、システム移行または再構築でシステム値QCCSIDの値の見直しが可能な場合

システム値QCCSIDの値を5035に設定可能かご検討ください。

3.6 リスナー・サブシステム開始時のエラー

リスナー用サブシステムを起動し、リスナー・ジョブが開始されない場合は、出力待ち行列QEZJOBLOG内の該当するジョブログを探してください。

エラー・メッセージLCO0312でAPI: _tfopen() エラー 3025 プロシジャー : ROUT_ReadNextFacilityTrace

上記エラーは、リスナー・ジョブをCCSID 65535または5026で開始しようとする場合に発生します。

3.7 V5R4上でのセットアップの時間について

LANSAのオブジェクトはV6R1以降のOSに対応したオブジェクトのため、V5R4へのセットアップ時にオブジェクトの変換処理が実行されます。インストールやアップグレード処理の開始後、ジョブがOPTWの状態が30分程 (変換処理の時間はマシンのスペックにより変わります) 続く場合がありますが、そのままお待ちくださいますようお願い致します。

3.8 コンパイルオプションをILEから変更する

LANSA Xi を新規インストールすると、コンパイルオプションが、ILE RPG を使用するになっています。
このまま使用すると、RDMLから、ILE RPG が生成され、条件によっては、日本語が文字化けを起こすことがあります。
下記の手順により、従来通り、RPG3 を生成するよう設定して頂けますようお願い致します。
■手順
(1) iSeries の LANSA を起動して、メインメニューを表示してください。
(2) 「8. 管理タスクの処理」を指定してください。
(3) 「2. システム設定表示」を指定してください。
(4) コンパイルと編集オプションを指定してください。
(5) コンパイルオプションを変更します。
・RPG/IV コード使用のコンパイル
・ILE はプログラム内に RPG/IV モジュールをバインドの二つの値を'N'にしてください。

3.9 eBiz Accelerator 2.2とV6R1以降のオブジェクト変換について

eBiz Accelerator 2.2が提供するLANSAのリポジトリに登録されている内部ファイルとプログラムは、
V6R1上でオブジェクト変換頂く必要はございません。

また、eBiz Accelerator 2.2提供のソースコードの無いファンクションを再コンパイルされた場合には、
eBizが動作しなくなりますのでご注意ください。
もし、誤ってソースコードの無いファンクションを再コンパイルされた場合には、
正しくeBiz Accelerator 2.2が動作する区画から、ファンクションをエクスポート／インポートで移行して下さい。

・eBiz Accelerator 2.2提供内部ファイル一覧

ファイルID

ACCCTL

NETACC

NETFUNC

PAYOPR

PAYUSR

PPF01

PPF02

PPF03

PPF04

PPF05

PPF05A

PPF06

PPF07

PPF13

PPF14

PPF15

PPF15A

PPF15B

PPF15C

PPF15D

PPF15E

PPF15F

PPF19

PPF21

PRENAV

PREVAR

SYSVAR

UIDATA

・eBiz Accelerator 2.2提供プロセス／ファンクション一覧

プロセスID

EXP000

EXT000

SYS000

SYS900

・eBiz Accelerator 2.2提供ソースコードの無いプロセス／ファンクション一覧

プロセスID ファンクションID

EXP000 PP0010

PP0011

PP0012

PP0013

EXT000 PP0020

PP0021

PP0023

PP0024

PP0028

PP0031

PP0032

PP0034

PP0034R

PP0035

PP0036

PP0037

SYS000 PP0002A

SYS900 PP0039

ファイルID
ACCCTL
NETACC
NETFUNC
PAYOPR
PAYUSR
PPF01
PPF02
PPF03
PPF04
PPF05
PPF05A
PPF06
PPF07
PPF13
PPF14
PPF15
PPF15A
PPF15B
PPF15C
PPF15D
PPF15E
PPF15F
PPF19
PPF21
PRENAV
PREVAR
SYSVAR
UIDATA

プロセスID
EXP000
EXT000
SYS000
SYS900

プロセスID	ファンクションID
EXP000	PP0010
	PP0011
	PP0012
	PP0013
EXT000	PP0020
	PP0021
	PP0023
	PP0024
	PP0028
	PP0031
	PP0032
	PP0034
	PP0034R
	PP0035
	PP0036
	PP0037
SYS000	PP0002A
SYS900	PP0039

4. WindowsへのLANSAのインストールについて

4.1 WindowsのDEPの機能について

WindowsのDEPの設定が「例外を除く全てのプロセスでDEPが有効」になっている場合に、DEPの機能によりLANSAの導入処理がブロックされエラーになる場合があることが確認されています。
LANSAのインストール時にはDEPの設定を「重要なWindowsのプログラムおよびサービスについてのみ有効」に変更してくださいますようお願い致します。
設定の変更後にWindowsの再起動が必要になりますのでご注意ください。
Windows Server 2008はDEPの省略値の設定が「例外を除く全てのプロセスでDEPが有効」になっていますのでご注意ください。

4.2 Windows 7にVisual LANSA Xi SP5をインストールする場合

インストール時に、データベースシステムを「SQL Anywhere サーバー/クライアント」を選択してください。
データベースシステムを「SQL Anywhere ローカル」を選択すると、Sybaseのデータベースが正しく作られません。

5. RDMLX区画について

LANSA Xiでは新しい開発環境RDMLXが追加になっております。
RDMLXは区画単位で設定し、RDMLX区画内では従来のRDMLとRDMLXのいずれも稼動することが可能ですが、一度RDMLからRDMLXへ設定を変更しますと、元に戻すことができません。
設定の変更は十分に考慮する必要があります。RDMLX区画で新しくサポートされる機能を使用しない場合は、RDMLのままにしておいていだたく事をお勧めいたします。

6. LANSA製品ライセンス登録手順について

ライセンス登録はLANSAの新規導入時、およびMES時のみ行ってください。

6.1 IBM i (System i、iSeries、i5、AS/400)の場合

6.1.1 下記LANSA製品の場合

LANSA/CS400ベース（※e-PACK共通を含む）
LANSA/AD
LANSA for the Web
CS Builder/サーバー
CS Builder/クライアント
Visual LANSA Choreographer （RAMPコンポーネント）

(1) サイン・オン後、コマンド行に次のコマンドを入力し実行してください。 <PGMLIB>はLANSAのインストール時に指定したプログラムライブラリ名です。 <PGMLIB>/LANSA LICENCE 実行後、［ライセンスの処理］メニュー画面が表示されます。（右図参照）
(2) メニューから「２．ライセンス・コードの登録」を選択します。右記の画面が表示されますので、連絡票に記載されたライセンス・タイプとライセンス・コードを入力し、実行キーを押してください。
(3) 処理を終了して、サイン・オフしてください。
※ライセンス状況の確認方法「ライセンスの処理］メニュー画面から「１．現行ライセンスの表示」を選択します。

6.1.2 LANSA Integratorの場合

(1) 添付ファイルの名前をlansakey.txtに変更し、PCに保管します。

(2) IBM i上のIFS /LANSA_dcxpgmlib/jsm/instance/sytem内に、FTPまたはIBM System i Access for Windowsを使用してlansakey.txt をコピーしてください。
※IFSパス /LANSA_dcxpgmlib/jsm/instance/ は、御社環境に合わせてパスを変更してください。LANSA Integratorインストール時に「JAVA SERVICE MANAGER PATH」に指定したパスになります。

※ライセンス状況の確認方法
IBM System i Access for Windowsの共有フォルダの機能を使用し、PC上のメモ帳にて確認することができます。
または、5250画面のコマンドWRKLINKを実行し、/LANSA_dcxpgmlib/jsm/instance/sytem/lansakey.txt を開いて内容をご確認ください。

6.1.3 LANSA eBiz Acceleratorの場合

(1) LANSA eBiz Accelerator の共通モジュールライブラリ(EBIZPACC)をライブラリリストに追加します。（右図参照） ADDLIBLE EBIZPACC
(2) コマンド行にWRKEBALICを入力し実行します。（右図参照）
(3) F6 でライセンスの登録を行います。連絡票に記載されたライセンス・タイプとライセンス・コードを入力し実行してください。

6.2 Windowsサーバーの場合

(1) LANSAのプログラムフォルダを開きます。
(2) 構成/管理のフォルダを開きます。
(3) ライセンスの定義のアイコンをダブルクリックします
(4) 連絡票に記載されたライセンス・タイプとライセンス・コードを、空白を空けずに入力し、実行してください。

※ライセンス状況の確認方法 ① LANSAのプログラムフォルダの「プロセスの実行」のアイコンをダブルクリックします。
② プロセスのパラメーターに *LICENSES を入力します。他のパラメーターも通常のように入力します。詳細については「パラメーターヘルプ」を参照してください。 ※必ずサーバーで実行してください。クライアントで実行する場合、ライセンスの情報を正常に検索できない可能性がございます。
③ OK ボタンをクリックすると以下の画面が表示されます。ライセンスが正常に登録されていると、この画面にそれぞれのライセンスのタイプと有効期限が表示されます。この画面を確認して「OK」ボタンをクリックしてください。

7. EPC、パッチのご確認及び適用のお願い

既に発見された不具合の修正および追加機能がEPC、パッチで配布されている可能性がございます。
製品をご使用になる前に必ずランサ・ジャパンのWebサイトから、EPC情報、不具合情報をご確認くださいますようお願いいたします。