Java I/F外部関数

必要なモジュール

• 「NOMAD for NT Server」「NOMAD for UNIX」のVer6.0以降（いずれか1つ）
  
• JDK(JRE) Ver 1.3.x (Sun Microsystems)
  

• NOMAD Ver6.0以降のインストール
  
  「NOMAD for NT Server」「NOMAD for UNIX」のVer6.0以降をインストールします。
  
  
• JDK(JRE) Ver1.3.xのインストール
  
  「Java I/F外部関数」を使用するときに、NOMADは「JavaVM」の起動を行います。 このためJava（JDK/JRE） Ver1.3.xのインストールが必要になります。
  Ver1.2.x以前のJava環境では「Java I/F外部関数」は動作しません。
  また、Ver1.4.xはサポート外です。
  
  ※注意：AIXではIBM AIX Developer Kit ver1.3.1以降を使用してください。また、最新のPTFが必須です。
  
  
• 環境変数の設定
  
  Java I/F外部関数は、JNI（JavaNativeInterface）を使用しているため、Java実行環境を環境変数に設定する必要があります。
  UNIXではJava実行環境については、Javaのバージョンやベンダに依存するので、下記２ライブラリファイルが存在するパスを設定してください。
  
  AIX ： libjvm.a 、 libjava.a
  Solaris : libjvm.so 、libjava.so
  
  設定例：

  OS	環境変数	例
  AIX	LIBPATH	/JDK/jre/bin /JDK/jre/bin/classic
  Solaris	LD_LIBRARY_PATH	/JDK/jre/lib/sparc /JDK/jre/lib/sparc/hotspot

  
  以下のプラットフォームではさらに設定が必要になります。
  
  

  Solaris 8

  環境変数LD_LIBRARY_PATHに、「/usr/lib/lwp」を追加してください。

  
  

  AIX

  環境変数

  AIXTHREAD_MUTEX_DEBUG=OFF
  AIXTHREAD_RWLOCK_DEBUG=OFF
  AIXTHREAD_COND_DEBUG=OFF
  AIXTHREAD_SCOPE=S

  の設定を行ってください。

  
  
• 「dsm.ini」のMaxCoexistHostの設定
  
  Ver6.0以降ではマルチスレッド対応により、1つのNOMADプロセスで複数のNOMADプロシージャを実行することができます。 MaxCoexistHostは、NOMAD1プロセスに対し、いくつのNOMADの処理ができるかという数（スレッド数）を表します。
  この機能を利用し、Java I/F外部関数は、1つのNOMADプロセスよりJavaVMを1つ立ち上げ、複数のJavaオブジェクトを保持・使用することができます。
  これにより、JavaVMの起動時間の短縮・メモリ消費量の軽減が期待できます。
  省略時は、MaxCoexistHostの値は100になります。
  
  例：
  

  ---

  [DSMCGI] MaxCoexistHost=40

  ---

  
  
• 「javaif.nom」ファイルをNOMADのSEARCHディレクトリにコピー
  
  「nomad.ini」ファイルの「SEARCH」で検索できるディレクトリ内に「javaif.nom」をコピーします。
  このファイルは、Java I/F外部関数のFUNCTION宣言が定義されています。Java I/F外部関数を使用するNOMADプロシージャでは、このファイルをINCLUDEする必要があります。
  
  
• 「nomad_java.ini」のJavaBinPathの設定
  
  Javaの実行ファイルがあるディレクトリ（bin）のフルパスを指定します。Windows環境の場合は、JREのbinのフルパスを指定してください。
  JavaVMのモジュール（jvm.dll/libjvm.a/libjvm.so）をこのディレクトリ（またはサブディレクトリ）より検索します。
  例：
  

  ---

  JavaBinPath=C:\Program Files\JavaSoft\JRE\1.3\bin

  ---

  
  
• 「nomad_java.ini」のCLASSPATHの設定
  
  Java I/F外部関数で利用するJavaクラスの存在するディレクトリやJARファイルのパスを「nomad_java.ini」のCLASSPATHに追加します。
  
  例：
  クラスファイル『C:\nomadxx\myClasses\javaTest.class』とJARファイル『C:\nomadxx\myLibrary\javaTest.jar』を使用する場合

  ---

  CLASSPATH=C:\nomadxx\myClasses;C:\nomadxx\myLibrary\javaTest.jar;

  ---