サーバ管理コマンドの動作設定をカスタマイズできます。ここでは，サーバ管理コマンドが使用するユーザ指定名前空間機能の設定について説明します。

サーバ管理コマンドのカスタマイズは，usrconf.properties（サーバ管理コマンド用システムプロパティファイル）で設定します。設定内容を次に示します。

表2-28　ユーザ指定名前空間機能を使用するためのサーバ管理コマンドのカスタマイズ

注※　サーバ管理コマンドを使用してJ2EEアプリケーションのプロパティを定義するときに別名を指定します。JNDI名前空間に登録される名称の参照と変更については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「9.13　JNDI名前空間に登録される名称の参照と変更」を参照してください。

実行環境でのJ2EEアプリケーションの設定は，サーバ管理コマンドおよび属性ファイルで実施します。Enterprise Beanの別名の設定とJ2EEリソースの設定に分けて説明します。なお，ここで説明するタグは，cosminexus.xmlと対応しています。cosminexus.xmlでの定義については，「2.6.5　Enterprise Beanの別名の設定」または「2.6.6　J2EEリソースの別名の設定」を参照してください。

(a)　Enterprise Beanの別名の設定

Enterprise Beanに別名を付与するための設定には，Session Bean属性ファイルまたはEntity Bean属性ファイルを使用します。インタフェースの種別によってタグ名が異なります。インタフェースの種別ごとに使用する属性ファイルとタグを次に示します。

• リモートインタフェースの別名
  Session Beanの場合はSession Bean属性ファイル，Entity Beanの場合はEntity Bean属性ファイルの<optional-name>タグに指定します。
  
• ローカルインタフェースの別名
  Session Beanの場合はSession Bean属性ファイル，Entity Beanの場合はEntity Bean属性ファイルの<local-optional-name>タグに指定します。
  

属性ファイルでの別名の指定例を次に示します。この例は，SessionBean属性ファイルを使用して，Stateful Session Beanに別名を設定する場合の例です。

　
<hitachi-session-bean-property>
  <display-name>MyAdder</display-name>
  <session-type>Stateful</session-type>
  <transaction-type>Container</transaction-type>
  <runtime>
    <lookup-name>MyAdder</lookup-name>
    <optional-name>user/Adder</optional-name>
    <local-optional-name>user/localAdder</local-optional-name>
    <maximum-sessions>0</maximum-sessions>
    <stateful>
      <maximum-active-sessions>0</maximum-active-sessions>
      <inactivity-timeout>0</inactivity-timeout>
      <removal-timeout>0</removal-timeout>
 

この例の場合は，リモートインタフェースの別名として「user/Adder」，ローカルインタフェースの別名として「user/localAdder」が設定されます。

(b)　J2EEリソースの別名の設定

J2EEリソースに別名を付与するための設定は，DB Connector，メールコンフィグレーション，またはJavaBeansリソースの属性として設定します。設定に使用するコマンドおよび属性ファイルは，リソースの種別ごとに異なります。リソースの種別と別名を設定するコマンドおよび属性ファイルを次の表に示します。

表2-29　リソースの種別と別名を設定するコマンドおよび属性ファイル

注　メールコンフィグレーションおよびJavaBeansリソースについては，cosminexus.xmlでは設定できません。属性ファイルで設定してください。

属性ファイルでの別名の指定例を次に示します。この例は，Connector属性ファイルを使用して，リソースアダプタに別名を設定する場合の例です。

　
<hitachi-connector-property>
  <description></description>
  <display-name>DB_Connector_for_Oracle</display-name>
  <icon />
  <vendor-name>Hitachi, Ltd.</vendor-name>
  :
  <connector-runtime>
    <resource-external-property>
    <description></description>
    <optional-name>jdbc/TestDB1</optional-name>
    <res-auth>Container</res-auth>
    <res-sharing-scope>Shareable</res-sharing-scope>
    </resource-external-property>
  </connector-runtime>
</hitachi-connector-property>
　

この例の場合は，DB Connectorの別名として「jdbc/TestDB1」が設定されます。