   ==========================================================================
                              M I C R O   F O C U S

                      S E R V E R   5.0   W R A P P A C K   4
                                       
                             for SPARC running Solaris
   ==========================================================================

   目次
   ====

       はじめに
       マニュアル
       補足事項
       制限事項


   はじめに
   ========
   このリリース情報では、Micro Focus Server の概要を説明します。
   このリリースの新機能、拡張機能および注意すべき特定の制限について説明
　 します。

   本製品をご使用になる前に、このリリース情報を 『ご使用の前に』 および
   関連マニュアルと併せてお読みください。

   本製品は、次のプラットフォームとオペレーティングシステム用に開発され
   ており、これが、このリリースのリファレンス環境となっています。

       SunOS 5.8 (Solaris 8) SPARC
       SunOS 5.9 (Solaris 8) SPARC
       SunOS 5.10 (Solaris 10) SPARC


   マニュアル
   ==========
   この製品に付属のマニュアルの詳細およびアクセス方法については、パッ
   ケージに含まれている『ご使用の前に』をご覧ください。


   Server for COBOL の補足事項
   ===========================

   o  ランタイムチューナ

      ランタイムチューナとして no_mfredir が新たに追加されました。
      以下にその仕様を示します：

          no_mfredir 

          アプリケーションがプログラムのリモート実行を行わないという前提
          で、ランタイムシステムの初期化の処理時間を短縮します。

          構文: 

          >>-----set no_mfredir=---.-TRUE-.-------------><
                                   +-FALSE+
          パラメタ:

            TRUE    ランタイムシステムは、初期化時にオプションのモジュール
                    _MFREDIR を探索しない 
            FALSE   ランタイムシステムは、初期化時に _MFREDIR を探索する  

          省略値: FALSE  

          注記:

          _MFREDIR モジュールはプログラムのリモート実行を行うときにだけ必用
          なモジュールであり、ほとんどの場合必用とされません。
          デフォルトではランタイムシステムはこのモジュールを探索するために
          初期化に余計な時間がかかります。

   o  デフォルトのスレッドスタックサイズ

      デフォルトのスレッドスタックサイズは 32 ビットモードでは 160KB、
      64ビットモードでは 320KB です。多数のスレッドを作成する場合、
      スタックスペースが不足する可能性があります。COBMAINSTACK 環境変
      数を設定するとスレッドスタックサイズを増やすことができます。


   Server for SOA の補足事項
   =========================

   o  タイムアウトの変更

      Enterprise Serverの COBOLクライアントには 2種類のタイムアウトオプション
      が用意されています。一つは接続の確立に関するもの、もう一つはその他の操
      作に関するものです。以下の環境変数を設定することによってデフォルト設定
      を変更することができます。

      MFC_TIMEOUT
      MFC_CONNECT_TIMEOUT

      あるいは mf-client.dat の以下のセクションを編集することによっても設定す
      ることができます。

      [defaults]
      connect-timeout=<nn>
      timeout=<nn>

      ここで、<nn> はタイムアウト時間を秒単位で指定します。

      タイムアウト時間の設定は秒単位で指定することができますが、実際の動作は、
      5秒単位でなされますので、7秒と指定した場合、実際の動作は 10秒となります。
      設定の優先順位は以下の通りとなります。

      環境変数 MFC_TIMEOUT または MFC_CONNECT_TIMEOUT が設定されていれば、そ
      の値が優先的に使用されます。 
      そうではなくて、mf-client.dat に "[defaults]" セクションに、
      "connect-timeout" または "timeout" が書かれていれば、その値が使用されま
      す。
      そうでなければ、デフォルトのタイムアウト時間が採用され、接続タイムアウト
      が 15秒、その他の操作が 30秒となります。

   o  J2EEアプリケーションサーバーのサポート
      
      生成する EJB のディプロイでは J2EE 1.3 と 1.4 がサポートされます。
      ここでは以下の範囲がサポートされます:
 
        - EJB 2.0 仕様
        - EJB 2.1 仕様
        - Java Connector Architecture 1.0 仕様
        - Java Connector Architecture 1.5 仕様

      必要となる JDK のバージョンは、生成された EJB をディプロイする対象の
      J2EE アプリケーションサーバー製品によって異なり、以下の通りです：

          JBoss 3.2.8 - JDK 1.4.2 (Sun) for J2EE 1.3
          JBoss 4.0.2 - JDK 1.5 (Sun) for J2EE 1.4
          Oracle 10.1.2 - JDK 1.4.2 (Sun) for J2EE 1.3
          Oracle 10.1.3 - JDK 1.5 (Sun) for J2EE 1.4
          WebLogic 8.1 - JDK 1.4.2 (Sun) for J2EE 1.3
          WebLogic 9.0 - JDK 1.5 (Sun) for J2EE 1.4
          WebSphere 5.1 - JDK 1.4.2 (IBM) for J2EE 1.3
          WebSphere 6.0 - JDK 1.4.2 (IBM) for J2EE 1.4

   o  J2EE アプリケーション

      Enterprise Server に接続する J2EEアプリケーションを実行している場合、
      Enterprise Server を停止して再起動したら、WebSphere または WebLogic
      などの J2EEアプリケーションサーバーも再起動する必要があります。

   o  リソースマネージャ

      Enterprise Server は、XA準拠のデータベースに対するアプリケーション
      の実行をサポートします。

      以下のデータベースに関しては、Enterprise Server からデータベースの
      XAスイッチ構造体にアクセスするためのスイッチモジュールが提供されて
      います。

      - Oracle

        以下のバージョンの Pro*COBOL を使用してコンパイルされたアプリケ
        ーション

        * Oracle Pro*COBOL Version 1.8 or later
        * Oracle Pro*COBOL Version 8 or later

      - IBM DB2 Universal Database

        IBM DB2 PREPコマンドまたは、Mciro Focus の DB2指令を使用してコン
        パイルされたアプリケーション

       その他のデータベースに関しては、XAスイッチモジュールの詳細について、
       データベースベンダーのマニュアルを参照してください。

      Oracle または DB2 についての外部 XAリソースマネージャを定義する場合
      には、Directory Server を開始する前にデータベース環境変数の設定をし
      ておく必要があります。

      Oracle と DB2 の両方についての外部 XAリソースマネージャを定義する場
      合には、Oracleリソースマネージャの方を、DB2リソースマネージャより先
      に定義してください。


   Server for COBOL の制限事項
   ===========================

   o  クライアント・サーバのバインディング

      バックグラウンドで mfserver を実行する場合、-b オプションを 
      mfserver に指定して、標準入力をクローズまたはリダイレクトする必要が
      あります。そうでないと、mfserver は 、SIGTTOU (端末出力) シグナルを
      受け取ることになり、クライアントが mfserver に接続すると停止します。
      例えば、次のように指定します。

      cobrun mfserver -s filetran -b < /dev/null &

   o  Dialog System の端末

      ダイアログシステムは、25 行を超える行を表示できる端末では正常に実行
      できません。LINES 環境変数を 25 に設定すると、正常に実行されます。

   o  64Bit の Fileshare

      64Bit のバイトストリーム I/O に対して、Fileshare はオフセットを正しく 
      操作しないことがあります。

   o  FSVIEW API と コマンド行インタフェース

      FSVIEW API と コマンド行インタフェースは 64Bit ではサポートされていま
      せん。
      ログファイルに関する FSVIEW API とコマンドは現在実装されていません。

   o  ランタイムシステム

      スレッドプログラム - リターンコード
      -----------------------------------
      プログラムの終了時に CBL_EXIT_PROC を使って、終了手続きを実行するマ
      ルチスレッドのアプリケーションで、終了手続き中にエラーが発生した場合
      は、アプリケーションが、オペレーティングシステムに対してゼロ以外の終
      了コードでは終了しません。

   o  SORT/MERGE

      旧バージョンの .int ファイルを使う SORT/MERGE
      ---------------------------------------------
      UNIX で旧バージョンの COBOL を使って作成した、SORT/MERGE 文を含む中
      間コードファイルを実行すると、プログラムエラーが発生する場合がありま
      す。

      NLS 指令を使う SORT
      -------------------
      英数字キーで COBOL SORT 動詞を利用する NLS 指令でコンパイルしたプロ
      グラムは、NLS ロケールに対応した正しい順番ではなく、英数字順にレコー
      ドを返します。この制限はファイルのソートにのみ適用され、テーブルの
      ソートには適用されません。

   o  Unicode

      DISPLAY-OF 組込み関数
      -----------------------------
      DISPLAY-OF 組込み関数でUnicode 文字をカレントロケールに変換する場合、
      カレントロケールに相当語句がない Unicode 文字は、いくつかのUNIX 
      プラットフォームではオプションのデフォルトの置き換え文字による置き
      換えが行われなくなります。


   Server for SOA の制限事項
   =========================

   o  64-bit 

      Enterprise Server は 64-Bit でコンパイルされたアプリケーションの実行
      をサポートしていません。

   o  アプリケーション管理サービス

      外部 XA リソースマネージャを定義することによって、コンテナ管理サー
      ビスをサポートするように Enterprise Server を構成している場合、定
      義されたリソースマネージャのいずれかに CONNECT を発行する、あるい
      はリソースマネージャから DISCONNECT を受け取るアプリケーション管理
      サービスはすべて、警告レベルの応答コードを受け取ることになります。

   o  トランザクショナルなクライアント要求

      COBOLサービスが、ローカルコネクタ (mfcobol-localtx.rar) を経由して
      トランザクショナルな J2EEクライアント要求を処理する場合、サービスが
      失敗を示す RETURN-CODE値を返すと、Enterprise Server が、
      "Cannot end/commit/rollback/recover a transaction that doesn't exist"
      というメッセージを表示することがあります。
      このメッセージは誤っており、実際にはトランザクションは正しくロールバ
      ックされています。


   サード パーティのソフトウェアによる制限
   =======================================

   o  BEA WebLogic 8.1 では、ローカルトランザクションのリソースアダプタにお
      ける COMMIT文のエラーに対して例外をスローすることができません。
      Micro Focus リソースアダプタは、COMMITのエラーを検出すると例外をスロー
      しますが、WebLogic はこれを無視して処理を続けます。このため、後の時点
      でユーザコードに例外がスローされることになります。

   o  IBM WebSphere 5.0 では、ステートフルセッションが非活性化されると、再び
      活性化される際に問題があり、以下のエラーを生じます :

      org.omg.CORBA.OBJECT_NOT_EXIST: null:java.rmi.NoSuchObjectException: at
      com.ibm.ejs.container.passivator.StatefulPassivator.activate 
      (StatefulPassivator.java:156)
      at com.ibm.ejs.container.StatefulBeanO.activate(StatefulBeanO.java:382) 

      これを回避するには、ステートレスビーンを使用するは、ステートフルビーン
      が非活性化されることの無いように WebSphere を構成する必要があります。
      このためには、Application Assembly Tool (AAT) を使用して、EJB のIBM拡
      張属性の中のタイムアウト値を変更します。デフォルトは 600秒になっていま
      すので、これを 0秒に変更すると、ステートフルビーンは非活性化されなくな
      ります。
 
   o  SuSE Linux x86 上の IBM WebSphere 5.x では、Enterprise Serverを呼び出
      す EJBの実行時に、'connection refused' というメッセージが出る場合には、
      ポート番号が正しいかどうかを確認し、WebSphere を開始する前に Enterprise
      Serverを開始しておいてください。
      それでも同じメッセージが出る場合には、リソースアダプタの ServerHost 
      構成プロパティの設定を "localhost" ではなくマシンのホスト名に変更して
      みてください。

   o  WebLogic 8.1 または WebLogic 9.0 から、リソースアダプタをアンディプロ
      イするときに java.lang.NullPointer 例外が発生することがあります。
      これは無視しても何の問題もありません。

   o  Solaris 上の Oracle Application Server 10.1.2 で、セッションの終了時に
      NullPointerException が発生することがあります。J2EEクライアント側でキ
      ャッチして無視していただくことで回避できます。COBOLプログラムの実行結
      果には何の問題もありません。


   ==========================================================================
   Micro Focus, Animator and Net Express are registered trademarks, and 
   Object COBOL and Server Express are trademarks, of Micro Focus
   International Limited. All other trademarks are the property of their
   respective owners.
   ==========================================================================
   @(#)Vrn/readme.1/////04/13 March 2007/nrV 
   Copyright (C) 1992-2007 Micro Focus (IP) Limited. All rights reserved.
 
