アプリケーションサーバが提供するコマンドは，管理者特権で実行する必要があります。「管理者：コマンドプロンプト」で実行してください。

「管理者：コマンドプロンプト」は，Windows Server 2008 x86，Windows Server 2008 x64，Windows Server 2008 R2，Windows 7またはWindows Vistaで提供されている機能を使用して起動してください。起動方法の例を次に示します。

1. ［スタート］ボタンをクリックします。
2. ［すべてのプログラム］−［アクセサリ］を選択します。
3. ［コマンド プロンプト］を右クリックして，［管理者として実行］をクリックします。

管理者のパスワードまたは確認を求められた場合は，画面の指示に従って，パスワードを入力するか，または確認情報を設定してください。

• コマンドの実行でメモリ不足が発生しコマンドが正常に実行できない場合は，サーバ管理コマンド用のオプション定義ファイル（usrconf.bat）中のUSRCONF_JVM_ARGSキーにJavaVMのオプション-Xmx<size>を指定して，メモリ割り当てプールの最大サイズを拡張することで対応します。-Xmx<size>の指定がない場合のデフォルト値は64MBです。
  

  ［例］

  Windowsの場合

  set USRCONF_JVM_ARGS=-Xmx512m

  UNIXの場合

  set USRCONF_JVM_ARGS="-Xmx512m"

  　

• 属性ファイルのXML宣言部分で指定されているエンコーディングは，該当する属性ファイルのエンコーディングを決定するものであり，サーバ側のDeployment Descriptorファイルのエンコーディングには影響しません（サーバ側のDeployment Descriptorファイルのエンコーディングは必ず「UTF-8」となります）。
• Windows Server 2008 x86，Windows Server 2008 x64，Windows Server 2008 R2，Windows 7またはWindows Vistaを使用している場合に，管理者特権でコマンドプロンプトを開いていないときには，管理者特権エラーとなり，終了コード「9」が返されます。
• UNIXの場合，Component Container管理者を設定すれば，スーパーユーザ以外の一般ユーザでもコマンドを実行できます。
  Windows Server 2008 x86，Windows Server 2008 x64，Windows Server 2008 R2，Windows 7またはWindows VistaではAdministrator権限を持つユーザであっても，コマンドプロンプトを管理者特権で開いていない場合，コマンドを実行できません。
  
• ディレクトリ名，ファイル名にUnicodeの補助文字は使用できません。
  ログファイルに，実行時の文字エンコーディングに変換できない文字を出力した場合，「?」に変換されます。
  
• Beanのメソッドに設定した実行権限が有効となるのは，createメソッド，ビジネスメソッド，およびremoveメソッドだけです。これら以外のメソッドに対してサーバ管理コマンドで設定された実行権限は無視されます。
• コマンドでJ2EEサーバ，またはバッチサーバへリモート接続を実行した場合，コンソールおよびダイアログにKDJE30045-Eのメッセージが表示されることがあります。その場合には，サーバ管理コマンドとJ2EEサーバ，またはバッチサーバのCosminexus Component Containerのバージョンを合わせてください。
• Cosminexus Component Container 06-00以前のバージョンからリモートでcjresetsvコマンドを実行するとKDJE37516-Iのメッセージが表示されますが，サーバ管理コマンドの排他情報はリセットされません。
• 削除系コマンドと一覧表示系コマンドを同一リソースに対し，同時に実行すると，J2EEサーバ，またはバッチサーバを起動したコンソールにKDJE39057-Eのメッセージが表示されることがありますが，J2EEサーバ，またはバッチサーバの動作への影響はありません。
  削除系コマンドと一覧表示系コマンドを次に示します。
  削除系サーバ管理コマンド
  cjdeleteapp
  cjdeleteres
  cjundeployrar
  cjdeletelibjar
  一覧表示系サーバ管理コマンド
  cjlistapp
  cjlistres
  cjlistrar
  cjlistlibjar
  
• サーバ管理コマンドのコマンドオプションに空白を含む場合は，次のように指定してください。
  Windowsの場合
  空白を含むコマンドオプションをダブルクォーテーション（""）で囲んでください。
  （例）Display nameがTP1/Message Queue - Accessのリソースアダプタの情報を取得する場合
  

  cjgetresprop -type rar -resname "TP1/Message Queue - Access" -c C:\temp\rar.xml
  　

  AIXの場合
  空白を含むコマンドオプションをダブルクォーテーション（""）で囲んでください。
  （例）Display nameがTP1/Message Queue - Accessのリソースアダプタの情報を取得する場合
  

  cjgetresprop -type rar -resname "TP1/Message Queue - Access" -c /home/rar.xml
  　

  そのほかのUNIXの場合
  コマンドオプション全体をダブルクォーテーション（""）で囲み，さらに空白を含むコマンドオプションをシングルクォーテーション（''）で囲んでください。
  （例）Display nameがTP1/Message Queue - Accessのリソースアダプタの情報を取得する場合
  

  cjgetresprop "-type rar -resname 'TP1/Message Queue - Access' -c /home/rar.xml"
  　

  ただし，次の場合には正しく動作しないことがあります。
  
  • シングルクォーテーションで囲んだオプション中に空白が2個以上連続している。
  • 先頭のシングルクォーテーションの直後に空白がある，または末尾のシングルクォーテーションの直前に空白がある。
• サーバ管理コマンドで使用する属性ファイルでリソース環境変数用のタグ（<resource-env-ref>タグ内の<linked-to>タグ）に指定する「キューの表示名」には，先頭がアンダースコア"_"で始まる文字列，または連続したアンダースコア"__"を含む文字列は指定しないでください。
• CLASSPATH環境変数，またはサーバ管理コマンド用オプション定義ファイルで指定したクラスパスに含まれるクラスから参照されるクラスは，アプリケーションに含めないでください。
• Windowsでサーバ管理コマンドを実行する場合，PATH環境変数やCLASSPATH環境変数に設定するパスに「^，&」を含む文字列を使用しないでください。

次のコマンドを使用する場合は，物理ティアのJ2EEサーバのコンフィグレーション設定で，J2EEサーバの運用監視を有効（ejbserver.instrumentation.enabledパラメタにtrueを設定）にしてください。

• cmx_start_application
• cmx_stop_application
• cmx_start_resource
• cmx_stop_resource

なお，物理ティアの設定は，簡易構築定義ファイルで実施します。簡易構築定義ファイルについては，マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

Manager ServerおよびSmart Composerで使用するコマンドの中に，管理ユーザアカウントの省略機能を有効にした場合に，通常と動作が変わるコマンドがあります。一覧を次の表に示します。

表1-5　管理ユーザアカウント省略機能有効時に動作が変わるコマンド

分類	コマンド名	管理ユーザアカウント省略機能有効時の動作
Manager Serverで使用するコマンド	mngsvrctlコマンド	次に示す引数setupの設定が無効となります。 -u <管理ユーザID> -p <管理パスワード> -nu <管理ユーザID> -np <管理パスワード> メッセージが出力されますが，セットアップ処理は通常どおり実行します。引数startおよびstopの設定は有効となります。 管理ユーザアカウントおよびパスワードは，設定および変更できません。
	mngsvrutilコマンド	次に示す引数の設定が無効となります。 -u <管理ユーザID> -p <管理パスワード>
Smart Composerで使用するコマンド	cmx_admin_passwdコマンド以外
	cmx_admin_passwdコマンド	設定値が無効となり，メッセージが出力されます。 管理ユーザアカウントおよびパスワードは，設定および変更できません。

コマンドのオプションのデフォルト値を共通定義ファイルとして設定できます。これらのファイルも管理ユーザアカウントの省略機能を有効にしたとき，動作が変わります。動作が変わるファイルの一覧を次の表に示します。

表1-6　管理ユーザアカウント省略機能有効時に動作が変わるファイル

ファイル名	コマンド定義ファイルの種類	管理ユーザアカウント省略機能有効時の動作
.mngsvrutilrc	mngsvrutilコマンド定義ファイル	次のプロパティの設定が無効となります。 mngsvrutil.connect.userid mngsvrutil.connect.password
mngsvrutilcl.properties
.cmxrc	Smart Composerで使用するコマンドの定義ファイル	次のプロパティの設定が無効となります。 cmx.connect.userid cmx.connect.passwd
cmxclient.properties
.mngsvrmonitorrc	mngsvrmonitorコマンド定義ファイル	次のプロパティの設定が無効となります。 mngsvrmonitor.connect.userid mngsvrmonitor.connect.password

• 仮想サーバマネージャのコマンドは，仮想サーバマネージャが起動している状態で実行できます。仮想サーバマネージャが起動していない状態でコマンドを実行した場合は，メッセージを出力してエラー終了します。
• 仮想サーバマネージャのコマンドは，Windowsの場合はAdministrator権限を持つユーザが，Linuxの場合はroot権限を持つユーザが実行できます。
• 仮想サーバマネージャのメッセージは，標準出力で出力されます。