この Readme には、Micro Focus® Visual COBOL® for Linux and Unix に関する情報が記述されています。
Micro Focus Visual COBOL for Linux and Unix パッケージは次の製品で構成されています。
この製品には、Enterprise Server 配下でのネーティブ COBOL アプリケーションの Web サービスとして展開、および、J2EE アプリケーションサーバーからアクセスのサポートが含まれています。
Eclipse パースペクティブには、Enterprise Server に展開させるメインフレーム サブシステム アプリケーション関連の項目が表示されますが、この製品にはそのためのライセンスは含まれていないため、機能しません。
この Readme には製品ヘルプに記載がない情報が含まれている場合があります。 製品をインストールする前に、Readme 全体を必ずご一読ください。
この Readme は、次の項で構成されています。
次の環境変数を設定する必要があります。
次のアプリケーション サーバーは、次の JDK を使用してサポートされています:
| アプリケーション サーバー | JDK バージョン | コンテナ サポート バージョン |
| Tomcat 7.0.39 | 1.6.027 | Servlets 2.5 |
| JBoss 6.1 | 1.6.027 | Servlets 2.5 |
| WebLogic 12.1.1 | 1.6.027 | Servlets 2.5 |
| WebSphere 8.5 | 1.6.027 | Servlets 2.5 |
| プラットフォーム | Visual COBOL Development Hub (MB) | Sentinel RMS ライセンスサーバー (MB) |
| POWER running AIX | 396 | 26 |
| HP IA | 806 | 54 |
| System Z running Red Hat Linux | 332 | 28 |
| x86-64 running Red Hat Linux | 358 | 33 |
| SPARC running Solaris | 431 | 31 |
| x86-64 running Solaris | 327 | 23 |
| System Z running SuSE SLES | 337 | 28 |
| x86-64 running SuSE SLES | 363 | 33 |
（注：インストールには、インストールする製品と同じサイズの空きディスク領域が必要です。）
次のソフトウェアを事前にインストールしておく必要があります。
注: AIX 6.1 上での最低必要なバージョンは、Java 6.0 SR10 FP1 です。
次の環境変数を設定する必要があります。
次のアプリケーション サーバーは、次の JDK を使用してサポートされています:
| アプリケーション サーバー | JDK バージョン | コンテナ サポート バージョン |
| Tomcat 7.0.39 | 1.6.027 | Servlets 2.5 |
| JBoss 6.1 | 1.6.027 | Servlets 2.5 |
| WebLogic 12.1.1 | 1.6.027 | Servlets 2.5 |
| AIX 上での WebLogic 12.1.1 | 1.6.0 SR10 FP1 | Servlets 2.5 |
| WebSphere 8.5 | 1.6.027 | Servlets 2.5 |
| AIX 上での WebSphere 8.5 | 1.6.0 SR10 FP1 | Servlets 2.5 |
| プラットフォーム | Tomcat 7.0.39 | JBoss 6.1 | WebLogic 12.1.1 | WebSphere 8.5 |
| Red Hat EL 5 | 32 ビット / 64 ビット | 32 ビット / 64 ビット | 32 ビット / 64 ビット | 32 ビット / 64 ビット |
| SPARC Solaris | 32 ビット | 32 ビット | 32 ビット | 32 ビット |
| HP/UX 11.31 on Intel IA64 | 64 ビット | 64 ビット | ||
| AIX 6.1 | 32 ビット / 64 ビット | 32 ビット / 64 ビット | ||
| SUSE 11 | 32 ビット / 64 ビット |
この製品は、Development Hub と連携してリモート開発をするために使用することができます。
（Windows 環境での ZIP ファイルの解凍には Windows に標準搭載されている圧縮ファイルの展開機能や、Windows 用のファイル解凍ユーティリティをお使いくださ い。）
C:\Users\Public\Micro Focus\Enterprise Developer\eclipse ディレクトリに、 Micro Focus プラグインが既にインストールされている、Eclipse の完全版がインストールされます。 Eclipse のバージョンは 3.8 です。
Windows タスクバーから[スタート ＞ すべてのプログラム > Micro Focus Enterprise Developer > Enterprise Developer for Eclipse] をクリックすると製品が起動されます。
Eclipse パースペクティブの設定はインストール後リセットされません。 新機能を使うには、インストール後に次の方法でCOBOL パースペクティブをリセットする必要があります：
製品ヘルプの『ここからはじめよう!』および『製品情報』の項を参照してください。チュートリアルやデモ・プログラムなど、入門者向けの情報が記載されています。
Visual COBOL 2.1 Update 1 でコンパイルされた SQL(DBMAN=ODBC)を使用したマネージ アプリケーションは、Visual COBOL 2.2 で再コンパイルする必要があります。
以前の Micro Focus 製品を使用してコンパイルされたアプリケーションの実行可能ファイルがある場合、 Visual COBOL を使用してソースからコンパイルする必要があります。
Enterprise Server Administration から起動される、すべての Enterprise Server プロセスは、ファイルのアクセスと作成の権限のあるプロセス ユーザー ID の下で実行されます。
デフォルトでは、インストーラはインストーラを実行するユーザーのログインIDをプロセス ユーザー IDとして使用しています。インストール後に、このプロセス ユーザー IDを変更する場合は、 $COBDIR/bin/casperm.sh を実行します。
Visual_COBOL_2.2_プラットフォーム名.zip
インストール先に直接ダウンロードして解凍する場合は、スーパーユーザ権限で次のように unzip コマンドを使って解凍します。
unzip ./Visual_COBOL_2.2_プラットフォーム名.zip
Windows 環境にダウンロードして解凍したファイルを、インストール先の環境に ftp でバイナリ転送しても同様です。
（Windows 環境での ZIP ファイルの解凍には Windows に標準搭載されている圧縮ファイルの展開機能や、Windows 用のファイル解凍ユーティリティをお使いくださ い。）
例 bsh の場合
PATH=/usr/xpg4/bin:$PATH export PATH
設定がない場合のインストールエラー例
tar: /install_image_dir/safenet.tar: ファイルもディレクトリもありません。
install_image_dir : インストールファイルのあるディレクトリ名
設定例
例 bsh の場合 （ /usr/local/bin に tar が存在しない場合）
cd /usr/local/bin ln /usr/sfw/bin/gtar tar PATH=/usr/local/bin:$PATH export PATH
設定がない場合のインストールエラー例
remotedevinstall - unTar - エラー - /COBDIR_dir/remotedev/ant/apache-ant-1.7.1-bin.tar の /COBDIR_dir/remotedev/ant への解凍に失敗しました。
COBDIR_dir はデフォルトの場合 /opt/microfocus/EnterpriseDeveloper です。
Linux/Unix 上で License Server が正常に起動されるには、hostname を構成する必要があります。
動作の不具合を回避するには、localhost と コンピュータの hostname の両方を IPアドレス 127.0.0.1 にマップしてはいけません。 localhost にのみ IPアドレス 127.0.0.1 にマップする必要があります。
/etc/hosts ファイルでの正しい指定例は次の通りです。
127.0.0.1 localhost.localdomain localhost IP machinelonghostname machineshorthostnameここで IP は xx.xx.xx.xx フォーマットのコンピュータの一意の IP アドレスを意味します。
chmod +x setup_entdev_2.2_プラットフォーム名
./setup_entdev_2.2_プラットフォーム名
スーパーユーザ権限で実行していない場合は、インストール時にスーパーユーザのパスワードの入力を促すプロンプトが表示されます。
COBOL 環境のデフォルトのインストール先は /opt/microfocus/EnterpriseDeveloper です。このデフォルトを変更するには、
-installlocation="Location" パラメータを使用して
以下の例のように別のディレクトリを指定します。
./setup_entdev_2.2_プラットフォーム名 -installlocation="インストール先のフルパス"
-help オプションを指定すると、インストール・スクリプトに渡すことができる他のパラメータの詳細を確認できます。
次のオプションを指定して、Enterprise Server の構成を指定することができます:
[ -ESsysLog="location" ] [ -ESadminID="User ID" ] [ -CASrtDir="location" ]
それぞれ、次の内容を指定します:
Enterprise Server のシステムログの作成場所を指定します。
例: -ESsysLog="/home/esuser/logs"
デフォルトの場所は /var/mfcobol/logs です。
Enterprise Server のシステム管理のプロセス ユーザー IDを指定します。
例: -EDadminID="esadm"
デフォルトはインストール実行するユーザIDです。
Enterprise Server 実行時システムファイルの場所を指定します。
例: -CASrtDir="/home/esuser/casrt/es"
デフォルトの場所は /var/mfcobol/es です。
./setup_entdev_2.2_プラットフォーム名 -skipsafenet
touch /var/microfocuslicensing/SKIP_SAFENET_INSTALLこのファイルが存在すると、SafeNet インストーラはインストールの更新や実行中のライセンスデーモンの停止を行いません。 ライセンスの更新を行うには、このファイルを削除して Sentinel RMS ライセンス・サーバを手動でインストールします。
シェル初期化ファイル (/etc/profile、/etc/bashrc など) に下記のコマンドを追加すれば、すべてのシェルで cobsetenv を実行する必要はなくなります。
ただし、cobsetenv は bash、ksh、XPG4 sh のように POSIX 系のシェルでのみ動作します。C シェルまたは XPG4 Bourne シェル以前のものとは互換性がないので、ご注意ください。
. /opt/microfocus/EnterpriseDeveloper/bin/cobsetenv
cob -Version
日本語対応のための設定を追加するために、次の方法で cobol.dir を追加作成します。（これは最初に１度だけ行う作業です。）
. インストール先のフルパス/bin/cobsetenv
インストール先がデフォルトの場合は、次の通りです。
. /opt/microfocus/EnterpriseDeveloper/bin/cobsetenv
test `uname -s` = Linux && echocmd="echo -e" || echocmd="echo" $echocmd 'CURRENCY-SIGN"92"' >> $COBDIR/etc/cobol.dir $echocmd 'NCHAR"2"' >> $COBDIR/etc/cobol.dir chmod 444 $COBDIR/etc/cobol.dir
CURRENCY-SIGN"92" NCHAR"2"
確認例 cat コマンドで設定内容を表示した場合の例
$ cat $COBDIR/etc/cobol.dir CURRENCY-SIGN"92" NCHAR"2" $
Visual COBOL Development Hub に関する情報は、製品ヘルプのリモートデバッグに関する項目を参照してください。
この製品をアンインストールするには、Windows の以下のメニューを表示してから、アンインストールする Micro Focus 製品を選択してアンインストールします。
[スタート > コントロールパネル > プログラム > プログラムのアンインストール]
アンインストール上の表示名は Micro Focus Enterprise Developer for Eclipse です。
Micro Focus Development Hub を削除するには、root ユーザで$COBDIR/bin ディレクトリの Uninstall_EnterpriseDeveloper2.2.sh スクリプトを実行します。
これらの製品をアンインストールしても、Micro Focus Licensing Manager または必須ソフトウェアのアンインストールは自動的には行われません。
Micro Focus ライセンス・マネージャをアンインストールするには、/var/microfocuslicensing/bin ディレクトリの UnInstallMFLicenseServer.sh スクリプトを実行します。このスクリプトを実行しても、特定のシステム設定またはライセンスが含まれる一部のファイルは削除されません。
Visual COBOL for Eclipse の機能の中には、X Window インストールを必要とするものがあるので、Micro Focus ViewNowX が製品に同梱されています。 インストールするには、Visual COBOL インストールに含まれるファイル ViewNow_X_Server.exe を実行します。 このファイルは、デフォルトでは、C:\Program Files\Micro Focus\Enterprise Developer\ViewNowX フォルダにあります。
ViewNowX を使用するには、クライアント・マシンに Microsoft Visual C++ 2008 SP1 Redistributable Package (x86) がインストールされている必要があります。 インストールされていない場合は、ViewNowX インストールにより、パッケージをダウンロードするためのリンクが表示されます。
詳細については、RDBMS ベンダのマニュアルを参照してください。
それには、コマンド・ラインで次のコマンドを実行します。
$COBDIR/src/oracle/set_cobopt_oracle COBOPT=$PWD/cobopt.ora export COBOPT
Eclipse IDE からのリモート開発は、Linux/Unix マシンで動作し、プログラムのビルドとデバッグに関する IDE からの要求をすべて処理する RSE DStore 機能によってサポートされています。RSE DStore 機能は Linux/Unix デーモンとして実行され、Eclipse クライアントが RSE DStore サーバに接続する際に、RSE DStore サーバを起動します。DStore デーモンの起動環境はすべてのサーバに継承され、結果的にすべてのビルド・セッションとデバッグ・セッションに継承されます。Eclipse RSE DStore サーバの詳細については、ここをクリックしてください。
RSE DStore デーモンを起動するには、Linux/Unix マシン上で Perl、Java、as (アセンブラ) および ld (リンカ) が利用可能である必要があります。
$COBDIR/remotedev/startrdodaemon &
これで、デーモンは、マシンのポート 4075 に接続する Eclipse RSE プロセスをリスンします。別のポートを使用する場合は、startrdodaemon コマンドで別のポート番号を指定してください。
指定した範囲のポートでサーバをインスタンス化するように、デーモンを構成することもできます。この方法は特に、ファイアウォール経由で特定のポートだけ開く場合に適しています。 起動するには、次のコマンドをスーパーユーザ権限で実行します:
$COBDIR/remotedev/startrdodaemon [<port> | <low port>-<high port>]
指定方法詳細は次の通りです:
<port> にポート番号を指定します。デーモンはこのポートからクライアントマシン上の Eclipse からの接続をリスンします。 値の指定がない場合は、デフォルト値の 4075 が割り当てられます。この値は、インストールされている Eclipse 内で割当てられた値と一致します。
例: $COBDIR/remotedev/startrdodaemon 4999
この例では、4999 ポートでリスンするデーモンが起動され、ランダムにサーバーのポートが使用されます。
[<port> | <low port>-<high port>] に、デーモンによって起動されたサーバーがクライアントマシン上の Eclipse と通信するのに使用するポートの範囲を指定します。
例: $COBDIR/remotedev/startrdodaemon 4080 4090-4999
この例では、4080 ポートでリスンするデーモンが起動され、サーバー ポートは 4090-4999 が使用されます。
$COBDIR/remotedev/stoprdodaemon <port>
Eclipse IDE のリモートプロジェクトのデバッグで DISPLAY/ACCEPT 文による日本語の入出力をする場合は、 RSE デーモンを起動するセッション内でデーモンを起動する前に使用するターミナルとして kterm を使用するように設定を行う必要があります。
kterm を使用するには、TERM 環境変数に kterm を指定します。
また、この場合、デフォルトでは SJIS モードが使用されますが、他のロケールやフォントを変更するには、COBTERMOPTS 環境変数を使って kterm オプションを上書き設定することが可能です。
COBTERMOPTS の設定例は次の通りです。
EUC を使用する場合
export COBTERMOPTS="-fn 8x16 -fk kanji16 -km euc"
14 ポイントフォントを使用する場合
export COBTERMOPTS="-fn a14 -fk k14 -km sjis"
X Window System の kterm 上での日本語の表示や入力の設定手順に関する詳細は、kterm 関連のドキュメント、X Window System のドキュメント、および、お使いの Linux/Unix 環境の日本語入力に関するドキュメントをご参照ください。
製品には、統合開発環境 Eclipse を使用してアプリケーションを作成するための Visual COBOL for Eclipse のライセンスと Linux/UNIX 上で動作する Development Hub のライセンスの合計２個の開発用ライセンスが提供されています。
製品のライセンスを有効にするには、製品のインストール後、認証コード（Authorization Code）を使用して、次の手順を実行します。
認証コード（Authorization Code）は、16桁の英数字からなる文字列です。
これは、製品パッケージに同梱されている『ライセンス証書』に記載されています。
Visual COBOL for Eclipse の場合は 『Product Detail: Visual COBOL for Eclipse 』で始まる項に記載されているコードを使用します。
Development Hub の場合は 『Product Detail: Visual COBOL Development Hub 』で始まる項に記載されているコードを使用します。
ライセンスのサイレントインストールをおこなう場合は、製品のインストール後に、以下のコマンドを実行してください。
start /wait install-dir\bin\cesadmintool -term activate 認証コードサイレントインストールのコマンド実行例
start /wait "C:\Program Files\Micro Focus\Enterprise Developer\bin\CesAdminTool.exe" -term activate XXXE00DXXXDAXXX
C:\Program Files (x86)\Common Files\SafeNet Sentinel\Sentinel RMS License Manager\WinNT
C:\Program Files\Common Files\SafeNet Sentinel\Sentinel RMS License Manager\WinNT
cd /var/microfocuslicensing/bin cesadmintool.sh
上記のライセンス管理ツールを実行して表示されるメニューから、「1. オンライン認証（1. Online Authorization.）」を選択し、認証コード（Authorization Code）を入力してライセンスの認証をおこなうことができます。
認証コード（Authorization Code）は、16桁の英数字の文字列で、製品パッケージに同梱されている「ライセンス証書」に記載されています。
ライセンス・ポリシーの内容または必要なライセンスの種類がわからない場合は、システム管理者または製品の購入元に連絡し、有効なライセンスを取得してください。
製品ヘルプの『製品情報』のトピック『既知の問題点と制限事項』を参照してください。また、次の注意事項があります。
本リリースでは、インストール時に日本語ロケールが設定されていても、開発環境で必要な日本語対応用の指令ファイルが作成されない不具合があります。
日本語を使用する場合は、インストール後に、システム指令ファイル cobol.dir の追加作成にある手順をおこなってください。
日本語版 Windows 上において、日本語を DISPLAY するプログラムを GUI の実行可能ファイルで実行すると、正しく表示されない不具合があります。
（INT・GNT 形式やキャラクターベースの実行可能ファイル形式ではこの不具合は発生しません。）
以下のいずれかのコーディングにより、この不具合を回避することができます。
o 手続き文の先頭に以下の DISPLAY 文を追加する。
PROCEDURE DIVISION.
DISPLAY SPACE UPON CRT.
o 以下のコードをプログラムの冒頭に追加する。
WORKING-STORAGE SECTION.
01 func-code pic x comp-x value 18.
01 func-param pic x comp-x value 1.
PROCEDURE DIVISION.
call x"A7" using func-code func-param.
この問題を回避するには、リモートマシン上で TMPDIR 環境変数の設定がないか、または、Visual COBOL Development Hub サーバー上と、デバッグされる実行プロセス内で、TMPDIR に同一の設定がされているかを確認してください。Visual COBOL Development Hub は直接 $COBDIR/remotedev/startrdoserver で起動されるか、または間接的に $COBDIR/remotedev/startrdodaemon デーモンとして起動されます。
Visual COBOL Development Hub サーバーで使用されている環境変数を確認する方法は次の通りです:
ご注意：Visual COBOL Development Hub サーバで使用されている TMPDIR 環境変数の値は、Remote Shell 上では変更できません。 デーモンまたはサーバーの起動前に設定する必要があります。
このセクションは障害改修のリストです。
Windows タスクバーから[スタート > すべてのプログラム > Micro Focus Enterprise Developer > ドキュメント(Eclipse)] をクリックします。
製品ヘルプの次のセクションは、リリース後に変更されています。
コンパイラ指令
コンパイラ指令 ILREF は .NET マネージ COBOL コードだけでなく JVM マネージ COBOL にも適用可能です。これにより現行のコンパイル処理単位に存在しない拡張メソッドおよび拡張演算子の定義が可能になります。
パラメータには、必要な拡張メソッドおよび拡張演算子を含む .class または .jar ファイル名を指定します。これにより、次の通り処理されます。
本ソフトウェアは、いかなる保証もなしに「現状有姿」で提供されます。Micro Focus は、市場性または特定の目的への適合性に関する保証を含む明示的または黙示的保証を一切否認します。Micro Focus またはそのサプライヤは、直接的、間接的、付随的、結果的、営業利益的、または特別な損害を含むいかなる損害に関して、たとえ事前にそのような損害の可能性を通知されていたとしても、一切の責任を負わないものとします。一部の州では、結果的または付随的な損害の責任の除外または制限を許可していないため、上述の制限が適用されない可能性があります。
Micro Focus は登録商標です。
Copyright © Micro Focus IP Development Limited 1984-2014. All rights reserved.