Server Express 5.1 Eclipse AddPack リリースノート

Server Express Eclipse AddPack によって Eclipse IDE 内での COBOL 開発が可能となります。 Eclipse は、プラグインツール用のプラットフォームを提供するオープンソースソフトウェアで、完全に統合されたソフトウェアワークベンチを提供します。

Eclipse IDE を使用して、COBOL やその他 Java などの言語で書かれたネイティブコードアプリケーションを開発します。ここで開発された COBOL アプリケーションは、 UNIX および Linux プラットフォームに展開できます。

Eclipse で COBOL アプリケーションを開発する場合、COBOL パースペクティブなどの Eclipse 機能と、構文および COBOL 起動構成のバックグラウンドチェック機能を使用します。他の Micro Focus 製品同様、COBOL 特有のプロジェクト、編集・デバッグ用の使い慣れた機能、および総合的な COBOL ヘルプを利用できます。

このリリースノートは以下の内容から構成されます:

インストール手順
主な機能
新機能
下位互換性
免責事項

このリリースノートは、ソフトウェアとともにインストールされるものではありません。カスタマーケアのWebサイトでいつでも参照でき、ダウンロードすることもできます。

今すぐインストールしない場合には、このページのプリントアウトを保管されることをお薦めします。

以前にベータ版などをインストールされている場合には、最新リリースの AddPack をコピーし UpdateSite をプラグインしなおす必要があります。

ステップ 1: 前提ソフトウェアのインストール

Server Express for Eclipse をインストールする前に以下をインストールしてください:

Eclipse バージョン 3.4 以降の Eclipse ベースの IDE。Eclipse SDK は、 www.eclipse.orgからダウンロードできます。完全テスト済みのバージョンは、この 3.4 のみです。
Sun の Java 2 Platform Standard Edition (J2SE) 1.4 から 1.5。 J2SE は、 java.sun.comからダウンロードできます。
Server Express 5.1 WebSync 2

ステップ 2: Server Express for Eclipseのインストール

Server Express for Eclipse は、Server Express製品の AddPack としてダウンロード提供されています。保守サービスの範囲内でカスタマーケアの Webサイトからダウンロードすることが可能です。

AddPack は .encr の拡張子を持つ自己解凍ファイルとして提供されています。以下の手順でインストールしてください。

rootでログオンします。
作業用ディレクトリを作成し cd します。
.encr ファイルを作業用ディレクトリにコピーし、以下のように実行権限を付加します:
```
chmod a+x *.encr
```
COBDIR環境変数にインストール済みの Server Expressのパスを設定します。
以下の例のように .encr ファイルを実行します。
```
./SXEclipseAddpack51.03_01_dev.tar.encr
```
解凍されて .tar が作成されますのでこれを更に展開します。
展開後に作成されている installシェルを以下のように実行します。
```
sh ./install
```

ステップ 3: UpdateSite の Eclipse IDE へのプラグイン

UpdateSites とは、Eclipse IDE に追加機能をプラグインする際に使用されるソフトウェアのパッケージの呼称です。 Net Express for Eclipse の UpdateSites には Eclipse の COBOLサポートが含まれています。これを Eclipse IDE にプラグインするには以下の手順に従います:

Eclipse IDE を起動します。
[ヘルプ] > [ソフトウェア更新] を選択し、[使用可能なソフトウェア] タブを開きます。
[サイトの追加...] ボタンをクリックし [ローカル...] ボタンをクリックします。
[ファイルシステム] の UpdateSite が置かれている場所を指定します。デフォルトでは、これは /opt/microfocus/cobol/eclipse/UpdateSite にあります。
表示されるすべてのコンポーネントを選択し [インストール...] をクリックします。
Eclipse を再起動します。

ステップ 4: Server Express コマンド環境の設定

Eclipse を実行するには、次のような Server Express コマンド環境を設定する必要があります。

次の環境変数を設定してください。
- JAVA_HOME は、J2SE のインストールディレクトリを指定するように設定する。
- PATH は、J2SE インストールの bin と jre/bin サブディレクトリを含めるように設定する。例：
```
export JAVA_HOME=/etc/java/j2sdk1.5.0_09
. $COBDIR/bin/cobsje
```
通常の Java アプリケーションランチャ (java) に代わって、Java/COBOL アプリケーションランチャ (cobjrun32) を使用するよう指定します。これにより COBOL ランタイムシステムと JVM を管理する環境を設定できます。そのためには、次のことを行ってください。
1. Eclipse インストールディレクトリの eclipse.ini ファイルを編集する。
2. ファイルの先頭に -vm オプションを挿入する。
3. 次の行で、cobjrun32 実行ファイルの完全修飾名を指定する。例：
```
    -vm
    /opt/microfocus/cobol/bin/cobjrun32
    -vmargs
    -Xms40m
    -Xmx256m
```
telnet セッションで Eclipse を実行するには、環境変数 DISPLAY に X Window 端末をホストする IP アドレスを設定します。例：
```
export DISPLAY=10.120.11.28:0
```
AIX では、Eclipse を実行すると、次のエラーメッセージが表示される場合があります。
```
Unable to alloc heap of requested size, ...
   **Out of memory, aborting**
   *** panic: JVMST017: Cannot allocate memory ... 
```
これを回避するには、環境変数 LDR_CNTRL に適切な値を設定します。例：
```
export LDR_CNTRL=MAXDATA=0x20000000
```
詳細については、IBM developerWorks Web サイトで、「Getting more memory in AIX」に関する記事を検索してください。
ダイナミックヘルプは、ヘルプの表示に組み込みブラウザを使用し、一定のライブラリを必要とします。 Windows プラットフォームでは、ブラウザは通常 Internet Explorer で、デフォルトのインストールで使用できます。 Linux および Unix プラットフォームでは、Eclipse には Mozilla ブラウザの互換バージョンが必要です。
メモ:
- Mozilla 1.4 GTK2 ～ 1.7.12 GTK2 で、Eclipse を使用できます。
- Mozilla Firefox は、リンク可能な Gecko ライブラリを使用してコンパイルされた場合には、Eclipse (Linux のみ) と一緒に使用できます。現在、mozilla.org からダウンロードした Firefox は、この基準を満たしていませんが、主な Linux 配布に含まれている Firefox インストールのほとんどは満たしています。静的にリンクされた Firefox インストールの使用を試みると、「No more handles [NS_InitEmbedding...error -2147221164]」というエラーメッセージが表示されます。
- 環境変数 MOZILLA_FIVE_HOME が、Firefox がインストールされているフォルダを指定するよう設定されていることを確認してください。例：
```
setenv MOZILLA_FIVE_HOME /usr/lib/firefox-1.0.4
```
- 環境変数 LD_LIBRARY_PATH に MOZILLA_FIVE_HOME が追加されていることを確認してください。例：
```
setenv LD_LIBRARY_PATH $LD_LIBRARY_PATH;$MOZILLA_FIVE_HOME  
```
- グラフィカル環境によっては、[F1] キーまたは [Ctrl＋F1] キーを押すと、エディタまたは [問題] ペインから [COBOL ヘルプ] を呼び出せます。
２バイト文字を含むソースファイルのバックグラウンド構文解析でエラーが報告されることがあります。実際のコンパイル・実行には影響がありません。

ステップ 5: 無期限ライセンスの設定

Micro Focus 製品をインストールすると、デフォルトで 30 日間ご利用いただけます。製品を完全に有効にして無期限ライセンスにするには、ライセンス認証を行う必要があります。ライセンス認証を行うには以下の手順に従います:

Eclipse IDE を起動します。
[ウィンドウ > 設定]を選択し、さらに[Micro Focus COBOL > ライセンス]を選択してライセンス認証をおこなう画面を表示してください。または、Micro Focus プラグイン使用時に表示されるライセンス認証に関するプロンプトで[はい]をクリックすると、同様の画面が表示されます。
[マニュアル]を選択して[クリップボードにコピー]をクリックして[マシンID]をコピーしてください。
Micro Focus のサイトの申請フォームに 2. の[マシンID]をペーストして製品のシリアル番号と一緒に申請してください。
折り返しメールで送られるライセンス文字列をコピーして 2. の画面の[ライセンス文字列]の欄にペーストして[適用]をクリックしてください。無期限ライセンスが設定されます。

警告：期限付きライセンスを使用している場合 (デフォルトの 30日ライセンスなど)、マシンの日時を変更しないでください。日時を変更すると、ライセンスは無効化され、Micro Focus カスタマーケアにご連絡いただく必要があります。

マシンの日時を変える必要がある場合、ライセンス認証手続きが完了して無期限ライセンスが設定されていることを確認してください。

主な機能

サポートされる主な機能を以下に示します:

Eclipse IDE内で開発作業のための適切な領域を表示するパースペクティブ。 COBOL、デバッグ、インターフェイスマッパーなどが用意されています。
以下のようなCOBOLソース編集機能:
- バックグラウンド構文解析
- ctrl+spaceキーによるコードテンプレート
- アウトラインビュー
- コードセクションの縮小・拡大
- コードの色分け表示
以下のようなプロジェクト管理機能:
- 自動ビルド
- 依存性チェック
- ビルドエンジンとしての ANT
- ディレクトリ別のビルド優先順位
- SQL指令のサポート
- 複数のビルド構成のサポート
異なるデバッグシナリオを再利用するためのデバッグ構成管理機能。ある構成をローカルアプリケーションのデバッグに使用し、別の構成をリモートアプリケーションのデバッグに使用することができます。以下の機能を含みます :
- ローカルアプリケーション
- ローカルプロセスへのアタッチ
- コアダンプ
- Enterprise Serverサービスのデバッグ
- リモートアプリケーション (64ビットプラットフォームも)
- アプリケーションの待機
以下のような包括的なデバッグ機能:
- ブレークポイント
- 式ビュー
- スタックトレース
- ステップ実行
- 変数ビュー
- 監視ポイント

新機能

このバージョンでは以下の新機能が使用可能となっています:

64ビットサポート
デバッグ構成
デバッグ機能拡張
Enterprise Server上のサービスのデバッグ
インタフェースマッパー
Sentinelによるライセンス管理
リンク・リソースとCOPYメンバー
Open ESQL サポート
リモートデバッグ
ユーザインタフェースの機能拡張

64ビットサポート

64ビットプラットフォームでは 64ビットアプリケーションの開発がサポートされました。デバッグと実行も可能です。64ビットアプリケーションをデバッグ・実行するには、デバッグ・実行の構成の中で、アプリケーションは 64ビットをチェックしてください。

32ビットプラットフォームで 64ビットアプリケーションの開発はサポートされません。しかし 64ビットのビルド構成を作成することはでき、64ビットプラットフォーム上で実行されるアプリケーションをリモートデバッグすることができます。これを行うには、ビルド構成・リモートデバッグ構成の中で、アプリケーションは 64ビットをチェックしてください。

このチェックボックスは実行構成とローカルデバッグ構成の中では選択できません。

デバッグ構成

以下のデバッグ構成オプションが追加されました:

COBOL アプリケーションへのアタッチ
COBOL コアダンプ
COBOL Enterprise Server
COBOL リモートアプリケーション
COBOL アプリケーションの待機

デバッグ機能拡張

デバッグ機能に以下の拡張がなされました:

データ項目内容の 16進数での変更
変数ビューでのデータ項目値変更
式ビュー
データ項目を監視するウォッチポイント
条件付きブレークポイント

Enterprise Server上のサービスのデバッグ

Enterprise Server配下で実行される COBOLサービスのデバッグがサポートされました。

インタフェースマッパー

インタフェースマッパー (IMTK) が Eclipse内で使用できます。 COBOLプログラムを EJB や Webサービスにディプロイすることができます。

Sentinelによるライセンス管理

この製品はセーフネット社の Sentinel RMS によってライセンス保護されています。

警告: インストール後 30日間はライセンス保護が有効になりません。この期間中にコンピュータのシステム日付の変更を行うとライセンスは即座に使用不可となります。

リンク・リソースとCOPYメンバー

Eclipseのリンク・リソース機能は COBOLプロジェクトでも使用可能です。プロジェクト外部にあるソースをプロジェクトにリンクすることができます。この機能は共通COPYメンバーを使用する場合に特に有益です。

以前のバージョンではコピーブックパスを定義する方法がとられていましたが、現在はリンク・リソースで実現されます。

Open ESQLサポート

Open ESQLのサポートが追加されました。

リモートデバッグ

開発しているコンピュータとは異なるマシン上で実行されている COBOLプログラムをリモートデバッグすることができます。開発プロジェクトをリモートマシンにコピーしビルドしておく必要があります。

ユーザインタフェースの機能拡張

ユーザインタフェースにおいていくつかの機能拡張がなされています:

「参照を検索」: 指定されたデータ項目のプログラム中での参照箇所をリストします。アウトラインビューでデータ項目を選択し、右クリックして参照を検索を選択します。
統合化トレース機能 (CTF) : CTF はトレース情報をコンソール上にリアルタイム表示します。
「ビルド優先順位」: プロジェクト内で、ビルドを実施する順番をディレクトリ別に指定できます。

下位互換性

既存の Net Express プロジェクトで COBOLアプリケーションの開発を行っていた方が、 Eclipseに移行するための方法がヘルプの Migrating from the Net Express IDE に記載されています。

免責事項

本ソフトウェアは、いかなる種類の保証事項も伴わずに、「そのまま」の状態で提供されるものです。マイクロフォーカスは、明示、黙示のいずれについても、本ソフトウェアに関するいかなる保証（市販性、特定目的との適合性などを含みます）も行いません。いかなる場合も、マイクロフォーカスまたはその提供者は、直接的、間接的、偶発的、必然的、営業利益の損失、あるいは特別損害など、たとえマイクロフォーカスまたはその提供者がそのような損害の可能性について事前に通知されていた場合でも、いかなる損害についても保証を行いません。州によっては、必然的または偶発的損害への責任を除外または制限することを許可していないところがあり、その場合には、前述の制限は適用されません。

Micro Focus and Net Express are registered trademarks, and AddPack, FixPack and WrapPack are trademarks, of Micro Focus (IP) Limited.