Net Express 5.1

WrapPack 7 Readme Document

Micro Focus製品登録ユーザ様 各位、

2012年 8月 28日
マイクロフォーカス 技術部

（このメールは、Micro Focusソフトウェア製品の保守サービス登録ユーザ様で、E-mailアドレスをご登録いただいているお客様を対象に自動送信させて頂いております。）

件名: Micro Focus Net Express の新 WrapPack 提供のご案内

毎々弊社製品をご利用くださいまして誠にありがとうございます。ソフトウェア製品のアップデートに関してご連絡申し上げますので、Net Express製品をご利用のお客様はご一読ください。Net Express 製品をご利用でないお客様は恐れ入りますがこのメールは廃棄してくださいますようお願い申し上げます。

Net Expressのリリースアップについては、随時弊社Webサイト http://www.amc.rocketsoftware.co.jp/support/fixpacks.asp にてご案内しております。このたび、8/28 (火) より以下の新 WrapPack が ダウンロード開始になります。

• Micro Focus Net Express 5.1 WrapPack 7 (5.107.0047)
• Micro Focus Server 5.1 WrapPack 7 (5.107.0047)

Net Express 5.1 J 製品の保守サービス期間内のお客様は、無償でアップデートをダウンロードできますのでご利用下さい。

障害改修の内容

#14704:
Windows イベントビューアのタスクカテゴリに正しいメッセージが表示されない不具合

#14863:
クリアキー押下で PIC N 項目が半角空白でクリアされる不具合

#15277:
PROGRAM COLLATING SEQUENCE 句指定時の SPECIAL-NAMES の大小順序の定義に X'FF' があると、X'00'とX'FF'の比較が不正になる不具合

#13349 #14025 #15333:
EXE でビルドしたプログラムで日本語の DISPLAY 文が正しく表示されない場合の対応方法を WrapPack 7 Readme の既知の不具合・制限に追加

新機能・変更

以下のアプリケーションサーバーのサポートの追加

• WebSphere 8

WrapPack適用の影響

1. WrapPack適用前に開発された COBOLプログラムはソース・バイナリ ともに基本的な互換性があります。
2. コンパイルされたアプリケーションは、WrapPack適用後の環境下で動作します。ただし、障害改修や性能改善がなされていますので再コンパイルをお薦めします。
3. COBOLデータファイルはそのまま利用可能です。
4. WrapPack の適用によって、Enterprise Serverリポジトリの内容が失われることがあります。 Enterprise Serverを使用している場合、WrapPack をインストールする前に、管理コンソールの「保存」メニューを使用して現在の構成をバックアップしておいてください。

インストールの手順

Net Express 5.1 J をインストール済みの方

このアップデートのセットアップは、Net Express 5.1 WrapPack 6 にのみ適用可能です。

Net Express 5.1 WrapPack 6 がインストール済み（バージョン 5.106.0072）の場合は、NXP3251070047.msp を適用しください。

WrapPack 5 またはそれ以前のバージョンがインストールされている場合は、以下の手順をおこなってください。

1. Windowsの［スタート］ボタンをクリックして[コントロールパネル > プログラムのアンインストール]を選択し、Micro Focus Net Express 5.1 を選択してアンインストールをしてください。

   ご注意： アンインストール選択後に最初に表示される、ライセンスの無効化に関する画面（[警告 製品のアンインストール]）で[保持]ボタンを選択してください。これにより製品本体のアンインストールのみがおこなわれ、ライセンスは削除されません。

2. Net Express 5.1 WrapPack 6 （ファイル名 NXP3251060079.exe）をインストールしてください。
3. NXP3251070047.msp を適用しください。

Micro Focus Server for COBOL 5.1 J をインストール済みの方

SRP3251070047.msp を適用してください。

Micro Focus Server for SOA 5.1 J をインストール済みの方

SRP3251070047.msp を適用してください。

インストール上の注意・補足

• WrapPackをインストールを実行する前の確認事項
  • 適用対象の製品が起動されていないことを確認してください。

  • Micro Focus の .NET ヘルプが開いていないことを確認してください。

  • 以前のWrapPack の Eclipse AddPack がインストールされている場合は、Windowsのメニューの[プログラムの追加と削除]でアンインストールしてください。

• 自動インストールのコマンドライン
  WrapPack を自動インストールする場合（さらにログファイルを作成する場合）は、次のコマンドを実行してください:

  start /wait msiexec.exe /update WrapPack.msp /qn /l*vx patchinstall.log
  

補足情報

• 新規オペレーションの既存のサービスへの追加
• ディプロイしたサービスの削除
• FaultFinder 構成
• ソート処理の最適化
• RM コンパイラ指令

• 新規オペレーションの既存のサービスへの追加

  mfdepinst ユーティリティ(Enterprise Server にサービスをインストールするために使われます。)は、 既存のサービスに新規作成したオペレーションを追加できるよう機能拡張されています。 この機能を有効にするには、deployment ディレクトリの .mfdeploy ファイルを開き、UPDATE_MODE=add を追加してください。

  この機能が有効になっている場合、mfdepinst はパッケージが既存の名前空間を指定しているのをみつけて、定義されていないオペレーションの追加のみをおこないます。もしそのサービスのパッケージが定義されていない場合も、オペレーションの追加をおこない、そうでない場合は、既存の定義が使用されます。

• ディプロイしたサービスの削除

  mfpackage コマンドは、ディプロイしたサービスをEnterprise Server のディレクトリから削除するために使うことができます。 このコマンドにサービス名前空間全体ではなく、単一のサービスを削除するオプションが追加されました。 １個のオペレーションを削除するには、そのオペレーションの名前を追加指定します。 区切り文字を付けて、あるいは区切り文字なしのオペレーションの名前、または、サービス名全体の指定が可能です。

  例：

  mfpackage undeploy http://tempuri.org/service operation 
  mfpackage undeploy http://tempuri.org/service #operation 
  mfpackage undeploy http://tempuri.org/service http://tempuri.org/service#operation 
  

• FaultFinder 構成

  FaultFinder 構成の詳細で、次のコマンドを使用して、出力ログファイルを指定できます。

  set faultfind_outfile="fault%p.log"

  このとき 以下を示します。

  • fault - 任意に選択した名前
  • %p - フォルト処理プロセスのプロセス ID
  • .log - 任意に選択したもうひとつの名前

  次のオプションが追加されました。

  • %d - フォルトの日付 <yyyymmdd>
  • %t - フォルトの時刻 <hhmmss>

  たとえば、FaultFinder が以下のように設定され、プロセス 12345 が 2007 年 1 月 12 日 11:26:53 にクラッシュすると、

  set faultfind_outfile=flt.%d.%t.%p.log', 

  作成されるログファイル名は、flt.20070112.112653.12345.log となります。

  その他の FaultFinder 構成の詳細については、[リファレンス]-[FaultFinder]-[FaultFinder] を参照してください。

  1060198

• ソート処理の最適化

  ラージファイル（通常、1GB以上）をソートする際、SORTSPACEで最適化を行うことができます。 これは SORTSCHEME=1 を指定すると、有効になります。SORTSCHEME を SORTSPACE とあわせて使用することによって、パフォーマンスが向上します。

  通常 SORTSPACE を増やすと、全体的なソートパフォーマンスが向上します。1GB以上のファイルのソートの際、SORTSCHEME を使うと、さらに、ソートパフォーマンスが向上します。

  考慮事項:

  • ソートの対象となるファイルの合計サイズが1GBを超える場合に、SORTSCHEME を設定する。
  • SORTSCHEME を設定する場合、レコードサイズからキーサイズを引いたサイズを考慮する。 キーサイズで SORTSCHEME の効果をあげるには、以下の SORTSPACE レベルを最小の設定とする

    SORTSPACE / SORTSCHEME の設定:

    • 1Mb またはそれ以上 - キー以外で 5K までのレコード
    • 4Mb またはそれ以上 - キー以外で 12K のレコード
    • 8Mb またはそれ以上 - キー以外で 28K のレコード
    • 16Mb またはそれ以上 - キー以外で 62K のレコード

      非常に大きいソート処理の場合、より大きい SORTSPACE が必要である場合があります。

  注意：SORTSPACE により大きい値を設定すると、より大きい一時ファイルスペースが使用される場合があります。

  実行中のソートの SORTSPACE の値が小さすぎると、実行時エラー 220 が発生することがあります。 この場合、SORTSPACE の値を大きくするか、SORTSCHEME が設定されていたら、SORTSCHEME=0 に設定してください。

  542074 9439 9853

• RM コンパイラ指令

RM コンパイラ指令設定時は、レコードロックモードは AUTOMATIC が設定されます。

関連トピック

• リファレンス > コンパイラ指令 > RM
• プログラミング ファイル処理 > ファイルの共有 > レコードロック

1079926 Case No.14604

既知の不具合・制限

• Windows Vista 以降の日本語版 Windows 上において、日本語を DISPLAY するプログラムを実行可能ファイルで実行すると、正しく表示されない不具合があります。（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. 
  

  （関連 #13349 #14025 #15333）

• Interface Mapping Toolkit で、マッピング参照を含むインターフェイスフィールドを削除すると、エラーが発生します。サービスは妥当性検査で失敗してディプロイできません。この不具合を回避するには、プロジェクトを一度クローズして再度開いてください。これにより妥当性検査が通ります。この不具合が最初から起きないようにするには、インターフェイスフィールドを削除する前に、フィールドのマッピングを削除してください。

• Windows 7 上で、WrapPack をアンインストールする際の不具合を回避するには、以下のサービスをアンインストール実行前に、停止してください。
  • EnterpriseLink Loader Services
  • Micro Focus Audit Manager
  • Micro Focus XDB Services

• Windows Server 2008 上で、Net Express 5.1 製品に WrapPack が適用されている場合、この WrapPack をアンインストールしようとすると、エラー 1306 が発生する場合があります。この不具合を回避するには、アンインストール実行前、もしくはエラーが発生した際に、以下のサービスを停止してください。
  • EnterpriseLink Loader Services
  • Micro Focus XDB Services

• XA トランザクションサポートは WebSphere 6.1 ＋ EJB 3.0 Feature Pack の使用では提供されていません。

• WebLogic 10.3.5 の EJB の生成時、ローカルインターフェイスタイプはサポートされません。

• 実行環境製品がインストールされている環境に、開発環境製品の 5.1 WS 6 のフルインストールイメージ（セットアップファイル名 NXP3251060079.exe）がインストールできてしまいます。

  開発環境製品と実行環境製品は、異なるライセンス体系をもつ製品であり、同一筐体上で共存できません。

  もし誤ってインストールしてしまった場合の対処方法は以下の通りです。

  1. Net Express のフルライセンスが設定されている場合は、 無効化の方法に従って、無効化をおこない、無効化キー（テキスト データ）を控えておきます。

     この無効化キーはライセンスの再発行で必要となるので、保管しておきます。

     Net Express のフルライセンスが設定されていない場合は、この手順をスキップします。

  2. Windows メニュー [スタート > コントロールパネル > プログラム > プログラムのアンインストール] を選択します。
  3. Net Express を選択して[アンインストール]を実行します。
  4. Server for COBOL を選択して[修復]を実行します。

  逆に、開発環境製品の 5.1 WS 6（またはそれ以降の WrapPack）がインストールされている環境に実行環境製品のフルインストールイメージ（セットアップファイル名 SRP3251010074.exe）をインストールしようとした場合は、 競合するアプリケーションとして Net Express 5.1 が表示されるため、誤って共存させないようにします。 これは正しい動作です。

• 5.1 WrapPack 7 HotFix 1 の障害改修情報 - cobimtk または imtkmake で自動生成される Java の テスト用クライアントの不具合

  • 概要

    サービス名に大文字を指定している場合、cobimtk または imtkmake で自動生成される Java の テスト用クライアントが正しく動作しない不具合があります。 開発者が利用するテスト用のクライアントの生成内容の不具合であるため、本番環境で使用される JSP クライアントへの影響はありません。

  • エラー例

    16:06:52,396 INFO  [ServerImpl] JBoss (Microcontainer) [5.1.0 (build: SVNTag=JBPAPP_5_1_0 date=201009150028)] Started in 59s:202ms
    16:07:20,702 ERROR [[jsp]] Servlet.service() for servlet jsp threw exception
    org.apache.jasper.JasperException: Cannot find any information on property 'sRV00001_P1_io' in a bean of type 'com.mypackage.SRV00001S.SRV00001SJspBean'
            at org.apache.jasper.runtime.JspRuntimeLibrary.getReadMethod(JspRuntimeLibrary.java:839)
            at org.apache.jasper.compiler.Generator$GenerateVisitor.visit(Generator.java:1117)
            at org.apache.jasper.compiler.Node$GetProperty.accept(Node.java:1124)
            at org.apache.jasper.compiler.Node$Nodes.visit(Node.java:2359)
            at org.apache.jasper.compiler.Node$Visitor.visitBody(Node.java:2409)
            at org.apache.jasper.compiler.Node$Visitor.visit(Node.java:2415)
            at org.apache.jasper.compiler.Node$Root.accept(Node.java:495)
            at org.apache.jasper.compiler.Node$Nodes.visit(Node.java:2359)
            at org.apache.jasper.compiler.Generator.generate(Generator.java:3433)
            at org.apache.jasper.compiler.Compiler.generateJava(Compiler.java:217)
            at org.apache.jasper.compiler.Compiler.compile(Compiler.java:333)
            at org.apache.jasper.compiler.Compiler.compile(Compiler.java:313)
            at org.apache.jasper.compiler.Compiler.compile(Compiler.java:300)
            at org.apache.jasper.JspCompilationContext.compile(JspCompilationContext.java:585)
            at org.apache.jasper.servlet.JspServletWrapper.service(JspServletWrapper.java:312)
            at org.apache.jasper.servlet.JspServlet.serviceJspFile(JspServlet.java:322)
            at org.apache.jasper.servlet.JspServlet.service(JspServlet.java:249)
    

  • 原因および詳細情報

    この不具合は、サービス名及び COBOLプログラムのエントリ名を構成する文字列の大文字・小文字の並びによって、内部で自動生成する JSPBean のプロパティ名とサーブレットで使用する set/get メソッド名の生成内容の大文字・小文字の整合性がとられなくなることに起因しています。

  • 回避策

    一時的な回避策として、cobimtk または imtkmake 実行時、サービス名をすべて小文字にして、マッピング時に作成されるサービス名.xmlファイル内のプログラム名、エントリ名をすべて小文字に修正する方法があります。（以下は、cobimtk の場合ですが、imtkmake もこの手順に準じた方法となります。）

    1. cobimtkを起動し、設定画面のサービス名の英字を小文字にして定義します。例) "srv00001s"

    2. サービスをEnterprise Serverにディプロイします。

    3. ディプロイファイルが作成されるディレクトリ (サービス名.deploy) の配下に サービス名.xmlファイルがあります。    例) "srv00001s.xml"

       このファイルをテキストエディタで開き、プログラム名が記載されている programName、entryPoint、name の属性値を小文字に変更します。

       例)
       <service dataDictFilename="SRV00001.xml" implementation="java" name="srv00001s"
        programName="srv00001" xmlns="http://xml.microfocus.com/schema/java/v2.0/mfjava.xsd" 
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
        xsi:schemaLocation="http://xml.microfocus.com/schema/java/v2.0/mfjava.xsd http://xml.microfocus.com/schema/java/v2.0/mfjava.xsd">
           <operation entryPoint="srv00001" name="srv00001" transactionType="notSupported">
       

    4. cobimtkでクライアントを生成します。

    上記の方法は、生成される EJBのメソッド名が通常の方法と異なるため、COBOLサービスの単体テスト目的でのみ有効です。

  • 改修情報

    5.1 WrapPack 7 HotFix 1 の適用により改修されます。

  • 改修 5.1 WrapPack 7 HotFix 1 のインストール方法

    ご注意：このアップデートのセットアップは、5.1 WrapPack 7 の不具合を改修するものであるため、5.1 WrapPack 7 がインストールされている環境にのみインストール可能です。

    Net Express 5.1 J WrapPack 7 をインストール済みの方

    Net Express 5.1 WrapPack 7 がインストール済みの場合は、nxp3251070047-60706-hotfix01-8955.msp を適用しください。

    Net Express 5.1 WrapPack 7 がインストール済みの場合は、Windows コントロールパネルの[プログラム > プログラムと機能 > インストールされた更新プログラム] に次の通り表示されます。

          Micro Focus Net Express 5.1 WrapPack #07
    

    HotFix 適用後は、[インストールされた更新プログラム] に次の表示が追加されます。

          Micro Focus Net Express 5.1 WrapPack #07 HotFix 01 #8955 #60706
    

    Micro Focus Server for COBOL 5.1 J または Micro Focus Server for SOA 5.1 J をインストール済みの方

    Server for COBOL 5.1 WrapPack 7 がインストール済みの場合は、srp3251070047-60706-hotfix01-8955.msp を適用しください。

    Server 5.1 WrapPack 7 がインストール済みの場合は、Windows コントロールパネルの[プログラム > プログラムと機能 > インストールされた更新プログラム] に次の通り表示されます。

          Micro Focus Server 5.1 WrapPack #07
    

    HotFix 適用後は、[インストールされた更新プログラム] に次の表示が追加されます。

          Micro Focus Server 5.1 WrapPack #07 HotFix 01 #8955 #60706
    

Micro Focus and Net Express are registered trademarks, and WrapPack are trademarks of Micro Focus International Ltd.

Copyright © Micro Focus IP Development Limited 1984-2012. All rights reserved.