12 既存のゲートウェイからの移行

既存のインストールからOracle Database Gateway for APPC fromの新しいインスタンスに移行するのは、ガイドラインに従えば簡単です。この章では、そのような新たなインストールを可能なかぎり容易にするための情報を提供します。また、ゲートウェイ上でTCP/IP for IMS Connect通信プロトコルを使用している場合に必要なパラメータも提供します。

この章では、Oracle Database Gateway for APPC for Microsoft Windowsのこのリリースに固有の情報を示します。含まれる項は、次のとおりです。

• 既存のゲートウェイ・インスタンスからSNAプロトコルを使用する新リリースへの移行

• 既存のゲートウェイからSNAを使用するTCP/IPへの移行

12.1 既存のゲートウェイ・インスタンスからSNAプロトコルを使用する新リリースへの移行

既存のゲートウェイをSNA通信プロトコルを使用するゲートウェイのリリース11.1.0.6に移行するには、次の手順に従います。

ゲートウェイTCP/IP support for IMS Connectを使用している場合、ゲートウェイの既存のリリースを最新のリリースに移行させるのではないことに注意します。ただし、initsid.oraファイルに有効な異機種間サービス・パラメータを置く必要があります。「パラメータ変更: ゲートウェイのバージョン4からリリース11.1.0.6へ」に進みます。

12.1.1 手順1: 新しいリリースのインストール

第4章「ゲートウェイのインストール」で概説したように、新しいリリースは別のディレクトリにインストールします。

注意: 既存のインストール済ゲートウェイに上書きインストールしないでください。既存のインストールの機能に問題が生じます。

12.1.2 手順2:initsid.oraゲートウェイ初期化ファイル・パラメータの転送

古いゲートウェイ・インスタンスから新しいインスタンスにinitsid.oraファイルをコピーします。

ゲートウェイのリリース9.0.1以前から移行する場合、PGA_TRACEはサポートされず、かわりにパラメータをTRACE_LEVELに変更する必要があることに注意してください。

注意: TRACE_LEVELを使用する場合、LOG_DESTINATIONパラメータのパスを設定する必要があります。

12.1.3 新しいリリースへの移行時の取消しに関する考慮事項

ゲートウェイの新しいリリースをインストールしたり、既存のインスタンスをアップグレードしたりする場合、アップグレードに問題が発生した場合に備えて、古いゲートウェイのOracleホーム・ディレクトリやインスタンスの構成を維持しておくことをお薦めします。これは、異なるゲートウェイ・インスタンスに変更する際にダウンタイムを確実に最小に抑える方法として有用です。

12.1.4 Oracle Netに関する考慮事項

Oracle Database Gateway for APPCは、OracleとOracle Netの異機種間サービス（HS）機能を使用します。バージョン4のゲートウェイからアップグレードする場合、tnsnames.oraファイルのゲートウェイ・サービス名エントリを多少変更する必要があります。(HS=)句を追加して、ゲートウェイがHS機能を使用することをOracle Netに通知します。詳細は、「ゲートウェイのためのOracle Network構成」を参照してください。

12.1.5 パラメータ変更: ゲートウェイのバージョン4からリリース11.1.0.6へ

バージョン4のゲートウェイからゲートウェイのリリース11.1.0.6に移行する場合、Oracle Database Gateway for APPCのこのリリースで、新規または変更された初期化パラメータが導入されていることに注意してください。

注意: Oracle Database Gateway for APPCのバージョン8からリリース11.1.0.6に移行する場合、この項の説明は当てはまりません。

ゲートウェイでTCP/IP support for IMS Connectを使用している場合、ゲートウェイのバージョン4からは最新のリリースに移行されません。ただし、initsid.oraファイルに有効な異機種間サービス・パラメータを置く必要があります。

この章の一部では、ゲートウェイを実行するために必要な特定のHSパラメータを参照しています。

注意: Oracle製品で使用するすべてのHSパラメータの一覧表と詳細は、『Oracle Database Heterogeneous Connectivity管理者ガイド』を参照してください。

新しいゲートウェイ初期化パラメータ

次のパラメータは、ゲートウェイの初期化ファイル（initsid.ora）: にあります。

• FDS_CLASS

• FDS_INSTANCE

• HS_FDS_FETCH_ROWS

• LOG_DESTINATION

• TRACE_LEVEL

• PGA_TCP_DB（TCP/IPのみ）

• PGA_TCP_USER（TCP/IPのみ）

• PGA_TCP_PASS（TCP/IPのみ）

  
  

  注意: HSパラメータはOracle異機種間サービスに固有です。HSパラメータの詳細は、『Oracle Database管理者ガイド』を参照してください。

  
  

名前が変更されたゲートウェイ初期化パラメータ

ゲートウェイのこのリリースで名前が変更されたゲートウェイ初期化ファイル（initsid.ora）パラメータのリストを次に示します。パラメータの旧称もかっこに入れて示します。

• HS_COMMIT_STRENGTH_POINT（COMMIT_STRENGTH_POINT）

• HS_DB_DOMAIN（DB_DOMAIN）

• HS_DB_INTERNAL_NAME（DB_INTERNAL_NAME）

• HS_DB_NAME（DB_NAME）

• HS_DESCRIBE_CACHE_HWM（DESCRIBE_CACHE_HWM）

• HS_LANGUAGE（LANGUAGE）

• HS_NLS_DATE_FORMAT（NLS_DATE_FORMAT）

• HS_NLS_DATE_LANGUAGE（NLS_DATE_LANGUAGE

• HS_OPEN_CURSORS（OPEN_CURSORS）

• HS_ROWID_CACHE_SIZE（ROWID_CACHE_SIZE）

廃止されたパラメータ

次のパラメータは廃止されました。構成ファイルから削除してください。

• MODE

• SERVER_PATH

• ERROR_LOGGING

• ERROR_REPORTING

• ERRORTAG

• GATEWAY_SID

• GROUP_BY_OFF

• GTWDEBUG

• INCREMENT_CURSORS

• INIT_CURSORS

• LIST

• MAX_LOG_SIZE

• OPTIMIZE_FILE_OPEN

• ORDER_BY_OFF

• RESOLVE_BINDS

• RETRY

• SET

• SNMP_SUPPORT

• SQL_TRACE

• TRIM_CURSORS

• D_OPEN_CURSORS

• D_INIT_CURSORS

• D_INCREMENT_CURSORS

• D_TRIM_CURSORS

• PGA_TRACE

12.1.6 パラメータ変更: バージョン8以前からゲートウェイ・リリース11.1.0.6へ

バージョン4またはバージョン8のゲートウェイから現在のリリースのOracle Database Gateway for APPCに移行する場合、次の起動シェル・スクリプト・パラメータをinitsid.oraに追加する必要があります。

• FDS_CLASS_VERSION

12.1.7 ゲートウェイ・リリース9.0.1または9.2.0からゲートウェイ・リリース11.1.0.6への移行

ゲートウェイのリリース9.0.1とこのリリースの間には、新しいパラメータは追加されていません。

12.2 既存のゲートウェイからSNAを使用するTCP/IPへの移行

次の各項では、SNAプロトコルを使用するゲートウェイの既存のリリースがあるが、TCP/IP support for IMS Connectに切り替えようとしている場合について説明します。

ゲートウェイのこのリリースのTCP/IP support for IMS Connect機能を使用すると、既存のTIPを続けて使用することができます。

12.2.1 既存のサイド・プロファイル定義で既存のTIPを使用するには

次の説明に従ってください。

1. pg4tcpmapツールを使用して有効なパラメータ値をPGA_TCP_IMSC表に挿入したことを確認します。

   PGA_TCP_IMSC表のロード手順は、第10章「TCP/IP通信プロトコルを使用したゲートウェイの構成」を参照してください。

2. TIPのLANGUAGEパラメータがamerican_america_us7asciiに設定されていることを確認します。

3. PGAUを使用してIMS TIPを再生成します。

4. initsid.oraファイルに次の新しいTCP/IPパラメータを追加します。

   • PGA_TCP_DB

   • PGA_TCP_USER

   • PGA_TCP_PASS

   これらのパラメータの追加に関する詳細は、12.1.5項「パラメータ変更: ゲートウェイのバージョン4からリリース11.1.0.6へ」にあります。パラメータの説明は、付録B「TCP/IP通信プロトコルでのゲートウェイ初期化パラメータ」にもあります。

   
   

   注意: ゲートウェイの旧バージョンから引き継いだTIPがサイド・プロファイル名を使用してすでに定義されていて、NLS_LANGUAGEパラメータがamerican_america_us7asciiの値に設定されている場合、そのTIPを再コンパイルする必要はありません。ただし、pg4tcpmapツールを使用してパラメータをマップする必要はあります。

   
   
   
   

   注意: 通信プロトコルをSNAからTCP/IPに変更する場合は、TIPを再コンパイルする必要があります。 SNAプロトコルを使用して以前に生成された既存のTIPがゲートウェイにあり、新しいTCP/IP機能を使用する場合、必須のNLS_LANGUAGE設定およびサイド・プロファイル設定を使用してPGAUがTIPを再コンパイルする必要があります。DEFINE TRANSACTIONコマンドで、適切なASCIIキャラクタ・セットを指定します。 これは、ゲートウェイではIMS Connect内で適切なユーザー・イグジットが使用されており、それによってASCIIキャラクタ・セットとEBCDICキャラクタ・セットの間で適切な変換が行われると想定されているためです。