Cosminexus V11 アプリケーションサーバ リファレンス コマンド編

文法書

3021-3-J15-50

前書き

対象製品

マニュアル「アプリケーションサーバ & BPM/ESB基盤 概説」の前書きの対象製品の説明を参照してください。

輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。

なお、不明な場合は、弊社担当営業にお問い合わせください。

商標類

HITACHI，Cosminexus，HiRDB，JP1，OpenTP1，TPBroker，uCosminexusは，株式会社 日立製作所の商標または登録商標です。

AIXは，世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

Apache(R)，Apache Kafka(R) ，およびKafka(R)は，Apache Software Foundationの米国およびその他の国における登録商標または商標です。

Linuxは，Linus Torvalds氏の米国およびその他の国における登録商標です。

Microsoft，Excel，Windows，Windows Server は，マイクロソフト 企業グループの商標です。

Oracle(R)，Java ，MySQL及びNetSuite は，Oracle，その子会社及び関連会社の米国及びその他の国における登録商標です。

UNIXは，The Open Groupの登録商標です。

その他記載の会社名，製品名などは，それぞれの会社の商標もしくは登録商標です。

This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

発行

2024年 2月 3021-3-J15-50

著作権

All Rights Reserved. Copyright (C) 2020, 2024, Hitachi, Ltd.

変更内容

変更内容(3021-3-J15-50) uCosminexus Application Server 11-40，uCosminexus Client 11-40，uCosminexus Developer 11-40，uCosminexus Service Architect 11-40，uCosminexus Service Platform 11-40

追加・変更内容

変更個所

cjsetup（J2EEサーバのセットアップとアンセットアップ）に，JDK17を使用する場合や，アプリケーションサーバを再インストールする際にJDKのメジャーバージョンを変更する場合の注意事項を追加した。

2.2

JDK17サポートに関する記述を追加した。

10章

cjjspc（JSPの事前コンパイル）の-sourceについての説明を変更した。

14.2

JDK14でsun.nio.cs.mapプロパティが削除されたことに伴い，cjjspcコマンドが動作するJavaVMの起動オプションを環境変数「CJ_CMD_JVM_ARGS」で変更する場合の注意事項を変更した。

14.2

環境変数「CJ_CMD_JVM_ARGS」でGC方式を変更する場合の説明を追加した。

14.2

マニュアル訂正の内容を反映した。

-

単なる誤字・脱字などはお断りなく訂正しました。

はじめに

このマニュアルをお読みになる際の前提情報については，マニュアル「アプリケーションサーバ & BPM/ESB基盤 概説」のはじめにの説明を参照してください。

1　コマンドの概要

この章では，アプリケーションサーバで使用するコマンドの種類，入力形式，文法などの記述形式について説明します。

1.1　コマンドの種類

ここでは，アプリケーションサーバで使用するコマンドの種類について説明します。

アプリケーションサーバでは，実行するアプリケーションの種類によって使用できるコマンドが異なります。この節では，コマンドを次の5種類に分類して説明します。

J2EEアプリケーションを実行するシステムで使用するコマンド

バッチアプリケーションを実行するシステムで使用するコマンド

Javaアプリケーションを実行するシステムで使用するコマンド

Webアプリケーションを実行するシステムで使用するコマンド

Webサービスを実行するシステムで使用するコマンド

それぞれのコマンドについて次の表に示します。

表1‒1　J2EEアプリケーションを実行するシステムで使用するコマンド

コマンドの種類

コマンドの説明

参照先

J2EEサーバで使用するコマンド

J2EEサーバの起動や停止，J2EEアプリケーションの設定などで使用する，cjで始まるコマンドです。

例：cjstartsv，cjenvupdate

2章

性能解析トレースで使用するコマンド

性能解析トレースでアプリケーションサーバのシステムの処理性能を解析する場合に，PRFデーモンの起動や停止，トレース情報の出力などで使用する，cprfで始まるコマンドです。

例：cprfstart，cprfed

4章

CJMSプロバイダで使用するコマンド

CJMSプロバイダを使用して，メッセージの送受信などをするコマンドです。

5章

CTMで使用するコマンド

CTMを利用してリクエストのスケジューリングや負荷分散をする場合に，CTMドメインの起動や停止，CTMの情報の出力，キューの閉塞などで使用する，ctmで始まるコマンドです。

例：ctmstart，ctmholdque

6章

Management Serverで使用するコマンド

Management Serverを使用する場合に，運用管理エージェントの稼働確認，起動や停止，Management Serverの起動や停止などで使用するコマンドです。

例：adminagentcheck，mngsvrctl

7章

Smart Composer機能で使用するコマンド

Smart Composer機能を使用する場合に，Management Serverの管理ユーザアカウントの設定，Management Server上のWebシステムの構築などで使用するコマンドです。

例：cmx_admin_passwd，cmx_build_system

8章

仮想化システムで使用するコマンド

仮想サーバマネージャから情報を取得したり，更新したりするコマンドです。

9章

JavaVMで使用するコマンド

JavaVMのcoreファイルの取得，GCの発生などで使用するコマンドです。

例：javacore，javagc

10章

ログの運用で使用するコマンド

アプリケーションサーバのログを収集する場合に，snapshotログの収集などで使用するコマンドです。

例：snapshotlog

11章

監査ログの設定で使用するコマンド

監査ログのセットアップ時に使用するコマンドです。

例：auditsetup

12章

統合ユーザ管理で使用するコマンド

統合ユーザ管理機能を使用する場合に，ユーザ情報の暗号化，暗号鍵ファイルの作成などで使用するコマンドです。

例：convpw，ssogenkey

※

注※　マニュアル「アプリケーションサーバ 機能解説 セキュリティ管理機能編」の「13.　統合ユーザ管理で使用するコマンド」を参照してください。

表1‒2　バッチアプリケーションを実行するシステムで使用するコマンド

コマンドの種類

コマンドの説明

参照先

バッチサーバで使用するコマンド

バッチサーバの起動や停止，バッチアプリケーションの実行や強制停止などで使用する，cjで始まるコマンドです。

例：cjstartsv，cjexecjob

3章

性能解析トレースで使用するコマンド

性能解析トレースでアプリケーションサーバのシステムの処理性能を解析する場合に，PRFデーモンの起動や停止，トレース情報の出力などで使用する，cprfで始まるコマンドです。

例：cprfstart，cprfed

4章

CTMで使用するコマンド

CTMを利用してリクエストのスケジューリングや負荷分散をする場合に，CTMドメインの起動や停止，CTMの情報の出力，キューの閉塞などで使用する，ctmで始まるコマンドです。

例：ctmstart，ctmholdque

6章

Management Serverで使用するコマンド

Management Serverを使用する場合に，運用管理エージェントの稼働確認，起動や停止，Management Serverの起動や停止などで使用するコマンドです。

例：adminagentcheck，mngsvrctl

7章

Smart Composer機能で使用するコマンド

Smart Composer機能を使用する場合に，Management Serverの管理ユーザアカウントの設定，Management Server上のWebシステムの構築などで使用するコマンドです。

例：cmx_admin_passwd，cmx_build_system

8章

JavaVMで使用するコマンド

JavaVMのcoreファイルの取得，GCの発生などで使用するコマンドです。

例：javacore，javagc

10章

ログの運用で使用するコマンド

アプリケーションサーバのログを収集する場合に，snapshotログの収集などで使用するコマンドです。

例：snapshotlog

11章

監査ログの設定で使用するコマンド

監査ログのセットアップ時に使用するコマンドです。

例：auditsetup

12章

表1‒3　Javaアプリケーションを実行するシステムで使用するコマンド

コマンドの種類

コマンドの説明

参照先

Javaアプリケーションで使用するコマンド

Javaアプリケーションの起動，ログの出力先サブディレクトリの削除などで使用するコマンドです。

例：cjclstartap，cjcldellog

13章

表1‒4　Webアプリケーションを実行するシステムで使用するコマンド

コマンドの種類

コマンドの説明

参照先

Webアプリケーションで使用するコマンド

JSPソースのチェックなどで使用するコマンドです。

例：cjjspc

14章

表1‒5　Webサービスを実行するシステムで使用するコマンド

コマンドの種類

コマンドの説明

参照先

Webサービスで使用するコマンド

SOAP Webサービスに必要なSEIやJavaBeanクラスを生成したり，コンパイル済みのJavaソースからWSDLを生成するときに使用するコマンドです。

例：cjwsimport，hwsgen

※

注※　マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「14.　コマンド」を参照してください。

参考

SOAPアプリケーションを開発したり，XML文書を操作するプログラムを開発したり，Webサービスのセキュリティを確保したりする場合は次のコマンドを使用します。

SOAPアプリケーションの開発では，WSDLの生成，ソースコードの生成，およびサービスデプロイ定義の生成でコマンドを使用します。詳細はマニュアル「アプリケーションサーバ SOAPアプリケーション開発の手引」の「9.　開発支援コマンド」を参照してください。

XML文書を操作するプログラムを開発する機能では，スキーマコンパイラおよびスキーマジェネレータの使用時にコマンドを使用します。詳細はマニュアル「XML Processor ユーザーズガイド」の「2.5　JAXBのコマンド」を参照してください。

Webサービスセキュリティ機能では，暗号化機能の利用や，XMLの構文が正しいかどうかのチェックなどでコマンドを使用します。詳細はマニュアル「アプリケーションサーバ Webサービスセキュリティ構築ガイド」の「4.1　Webサービスセキュリティ機能が提供するコマンド」を参照してください。

1.2　コマンドの文法の記述形式

1.2.1　記述形式の詳細

コマンドの文法の記述形式と使用する記号について説明します。

(1)　記述形式

コマンドの文法について次の形式で説明します。なお，各コマンドは，アルファベットの順に説明します。

形式

コマンドの入力形式を示します。

機能

コマンドの機能について説明します。

引数

コマンドの引数およびオプションについて説明します。

出力形式

コマンドの出力形式を示します。

入力例・出力例

コマンドの入力例および出力例を示します。

戻り値

コマンドの戻り値について説明します。

注意事項

コマンドを実行する上での注意事項について説明します。

参考

各コマンドの説明では，上記の項目のうち必要な項目についてだけ説明しています。また，上記の項目以外に，各コマンドの固有情報を記載している場合があります。

(2)　使用する記号

コマンドの文法は次の表に示す記号および構文要素を使用して記述します。

表1‒6　文法で使用している記号

記号

意　味

　｜

横に並べられた複数の項目に対する項目間の区切りを示し，「または」を意味します。

（例）　A｜B

　AまたはBを指定することを示します。

{ 　 }

この記号で囲まれている複数の項目のうちから一つを選択することを示します。項目が横に並べられ，記号｜で区切られている場合は，そのうちの一つを選択します。

（例）　｛A｜B｜C｝

　A，BまたはCのどれかを指定することを示します。

［　］

この記号で囲まれている項目は省略してもよいことを示します。複数の項目が横に並べて記述されている場合には，すべてを省略するか，記号｛ ｝と同じくどれか一つを選択します。

（例1）　［A］

　「何も指定しない」か「Aを指定する」ことを示します。

（例2）　［B｜C］

　「何も指定しない」か「BまたはCを指定する」ことを示します。

…

記述が省略されていることを示します。

（例）　ABC…

　ABCの後ろに記述があり，その記述が省略されていることを示します。

<　>

この記号で囲まれている項目は，該当する要素やファイルなどを指定したり，該当する要素が表示されたりすることを示します。

（例1）　<プロパティ>

　プロパティを記述します。またはプロパティが表示されます。

（例2）　<ファイル名>

　ファイル名を指定します。

...

この記号の直前に示す記号を繰り返し，複数個指定できることを示します。

（例）　<プロパティ>...

　プロパティは複数個，繰り返して指定できます。

表1‒7　文法で使用している構文要素

構文要素

定義

英字

A〜Z　a〜z

英小文字

a〜z

英大文字

A〜Z

数字

0〜9

英数字

A〜Z　a〜z　0〜9

記号

!　"　#　$　%　&　'　(　)　+　,　_　・　.　/　:　;　<　=　>　@　[　]　^　−　｛　｝　￣　タブ　空白

注　すべて半角文字を使用してください。

1.3　コマンドの入力形式

1.3.1　入力形式の詳細

コマンドの入力形式を次に示します。

コマンド名称 [オプション…]

各項目について説明します。なお，コマンドプロンプトを「$」，コマンド名称を「cmd」と表記します。

(1)　コマンド名称

実行するコマンドのファイル名を指定します。

空白を含むパスを指定してコマンドを実行する場合，パス全体を""で囲む必要があります。

Windowsの場合

誤った指定例：$ C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin¥cmd

正しい指定例：$ "C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin¥cmd"

UNIXの場合

誤った指定例：$ /opt/program path/bin/command

正しい指定例：$ "/opt/program path/bin/command"

(2)　引数

引数には，オプションも含まれます。オプションの入力形式および指定規則を次に示します。

(a)　オプションの入力形式

オプションは，「-」（ハイフン）で始まる文字列です。オプションの入力形式には，オプション引数を指定しない形式と，1個のオプション引数を指定する形式があります。

オプション引数を指定しない形式

$ cmd -オプションフラグ

1個のオプション引数を指定する形式

$ cmd -オプションフラグ<スペースまたはタブ>オプション引数

（凡例）

オプションフラグ

1文字の半角英数字です。大文字と小文字が区別されます。

オプション引数

オプションフラグに対する引数です。

(b)　オプションの指定規則

オプションフラグは，一つの「-」（ハイフン）にまとめて指定できません。

誤った指定例：$ cmd -abc

正しい指定例：$ cmd -a -b -c

オプション引数を必要とするオプションフラグのオプション引数は，省略できません。

オプションフラグとオプション引数の間には，スペースまたはタブが必要です。

誤った指定例：$ cmd -afile

正しい指定例：$ cmd -a file

同じオプションフラグは，複数指定できません。

誤った指定例：$ cmd -a 1 -a 2

オプション引数に空白を含む場合，オプション引数全体を""で囲む必要があります。

誤った指定例：$ cmd -a file 1

正しい指定例：$ cmd -a "file 1"

1.4　コマンド使用時の注意事項

コマンド使用時の注意事項を説明します。

1.4.1　Windowsでアプリケーションサーバが提供するコマンドを使用する場合の注意事項

管理者特権でコマンドを実行してください。

1.4.2　サーバ管理コマンドを使用する場合の注意事項

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

［例］

Windowsの場合

set USRCONF_JVM_ARGS=-Xmx512m

UNIXの場合

set USRCONF_JVM_ARGS="-Xmx512m"

操作対象ファイルのファイルサイズが大きいと，サーバ管理コマンドを起動したコンソールに，「java.lang.OutOfMemoryError」メッセージが表示されることがあります。この場合は，サーバ管理コマンド用オプション定義ファイル（Windowsの場合はusrconf.bat，UNIXの場合はusrconf）のUSRCONF_JVM_ARGSキーの-Xmsオプションおよび-Xmxオプションを使用して，JavaVMのメモリ割り当てサイズを妥当な値に変更してください。

記述例

set USRCONF_JVM_ARGS="-Xms64m -Xmx256m"

属性ファイルのXML宣言部分で指定されているエンコーディングは，該当する属性ファイルのエンコーディングを決定するものであり，サーバ側のDeployment Descriptorファイルのエンコーディングには影響しません（サーバ側のDeployment Descriptorファイルのエンコーディングは必ず「UTF-8」となります）。

Windowsの場合，管理者特権でコマンドプロンプトを開いていないときには，管理者特権エラーとなり，終了コード「9」が返されます。

UNIXの場合，Component Container管理者を設定すれば，スーパーユーザ以外の一般ユーザでもコマンドを実行できます。

Windowsの場合，Administrator権限を持つユーザであっても，コマンドプロンプトを管理者特権で開いていない場合，コマンドを実行できません。

ディレクトリ名，ファイル名にUnicodeの補助文字は使用できません。

ログファイルに，実行時の文字エンコーディングに変換できない文字を出力した場合，「?」に変換されます。

Beanのメソッドに設定した実行権限が有効となるのは，createメソッド，ビジネスメソッド，およびremoveメソッドだけです。これら以外のメソッドに対してサーバ管理コマンドで設定された実行権限は無視されます。

コマンドでJ2EEサーバ，またはバッチサーバへリモート接続を実行した場合，コンソールおよびダイアログにKDJE30045-Eのメッセージが表示されることがあります。その場合には，サーバ管理コマンドとJ2EEサーバ，またはバッチサーバのComponent Containerのバージョンを合わせてください。

削除系コマンドと一覧表示系コマンドを同一リソースに対し，同時に実行すると，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個以上連続している。

先頭のシングルクォーテーションの直後に空白がある，または末尾のシングルクォーテーションの直前に空白がある。

UNIXの場合，サーバ管理コマンドのコマンドオプションにエクスクラメーションマーク（!）を含むときは，エクスクラメーションマーク（!）を含むコマンドオプションをシングルクォーテーション（'）で囲んでください。

（例）Connector 1.5のコネクションプールの一覧を表示する場合

cjlistpool <サーバ名称> -nameserver <プロバイダURL> '<リソースアダプタの表示名>!<コネクション定義識別子>'

サーバ管理コマンドで使用する属性ファイルでリソース環境変数用のタグ（<resource-env-ref>タグ内の<linked-to>タグ）に指定する「キューの表示名」には，先頭がアンダースコア"_"で始まる文字列，または連続したアンダースコア"__"を含む文字列は指定しないでください。

CLASSPATH環境変数，またはサーバ管理コマンド用オプション定義ファイルで指定したクラスパスに含まれるクラスから参照されるクラスは，アプリケーションに含めないでください。

Windowsでサーバ管理コマンドを実行する場合，PATH環境変数やCLASSPATH環境変数に設定するパスに「^，&」を含む文字列を使用しないでください。

usrconf.properties（サーバ管理コマンド用システムプロパティファイル）のvbroker.se.iiop_tp.scm.iiop_tp.listener.portを指定している場合は，HCSCコマンドとサーバ管理コマンドは併用できません。

ほかのホストのJ2EEサーバを操作する場合や複数のNICを使用する場合，あらかじめusrconf.properties（J2EEサーバ用ユーザプロパティファイル）で，webserver.connector.http.permitted.hostsキーを定義する必要があります。webserver.connector.http.permitted.hostsキーについては，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

1.4.3　管理ユーザアカウントの省略機能を有効にする場合の注意事項

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

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

分類

コマンド名

管理ユーザアカウント省略機能有効時の動作

Manager Serverで使用するコマンド

mngsvrctlコマンド

次に示す引数setupの設定が無効となります。

-u <管理ユーザID>

-p <管理パスワード>

-nu <管理ユーザID>

-np <管理パスワード>

-interactive

メッセージが出力されますが，セットアップ処理は通常どおり実行します。引数startおよびstopの設定は有効となります。

管理ユーザアカウントおよびパスワードは，設定および変更できません。

mngsvrutilコマンド

次に示す引数の設定が無効となります。

-u <管理ユーザID>

-p <管理パスワード>

Smart Composerで使用するコマンド

cmx_admin_passwdコマンド以外

cmx_admin_passwdコマンド

設定値が無効となり，メッセージが出力されます。

管理ユーザアカウントおよびパスワードは，設定および変更できません。

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

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

ファイル名

コマンド定義ファイルの種類

管理ユーザアカウント省略機能有効時の動作

.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

1.4.4　仮想サーバマネージャのコマンドを使用する場合の注意事項

仮想サーバマネージャのコマンドは，仮想サーバマネージャが起動している状態で実行できます。仮想サーバマネージャが起動していない状態でコマンドを実行した場合は，メッセージを出力してエラー終了します。

仮想サーバマネージャのコマンドの開始・終了メッセージ，およびコマンドの実行結果は，標準出力で出力されます。

コマンド実行前にログ出力ディレクトリおよびログファイルに書き込み権限があることを確認してください。ログ出力ディレクトリおよびログファイルに書き込み権限がない場合にはログが出力されません。

仮想サーバマネージャのコマンドは，実行ユーザの制限はありません。ただし，Windowsの場合は，コマンドを実行するOSの種類や実行ユーザに応じて，次の事項に注意する必要があります。

UAC（ユーザアカウント制御）が無効なOSの場合

Administrator権限を持たないユーザが実行する場合，コマンド実行前にログ出力ディレクトリおよびログファイルに書き込み権限があることを確認してください。ログ出力ディレクトリおよびログファイルに書き込み権限がない場合にはログが出力されません。

Administrator権限を持つユーザが実行する場合，注意事項は特にありません。

UAC（ユーザアカウント制御）が有効なOSの場合

Administrator権限を持たないユーザが実行する場合，OSの機能であるUAC（ユーザアカウント制御）のファイルの仮想化によって，manager.cfg（Manager設定ファイル）で指定したログ出力ディレクトリとは異なるディレクトリにログが出力されることがあります。

Administrator権限を持つユーザが実行する場合，注意事項は特にありません。

1.4.5　半角英数字以外の文字が含まれている表示名について

J2EEサーバでは，J2EEアプリケーションやリソースなどに設定された表示名（DDの<display-name>タグの値）を識別子として使用します。表示名に汎用文字，半角英数字（0〜9，A〜Z，a〜z）以外の文字が含まれていた場合は，その文字をアンダースコア（_）に変換して識別子を生成します。設定値によっては，変換処理で生成された識別子が重複して操作に失敗することがあります。表示名には，半角英数字，アンダースコア以外の文字を使用しないようにしてください。

表示名に半角英数字以外の文字が含まれていると，J2EEサーバが警告メッセージ（KDJE42374-W）を出力します。

1.4.6　コマンドの引数に指定するファイルおよびディレクトリの名称について

Smart Composer機能またはManagement Serverで使用するコマンドの引数に指定する，ファイルおよびそのファイルを格納するディレクトリの名称には，シャープ（#），パーセント（%），およびクエスチョンマーク（?）を使用しないでください。

これらの文字を使用した場合は，次のようなメッセージが出力され，コマンドの処理が中断されます。

KEOS24007-E The definition file is invalid. file name = <ファイル名> line number = 1 column number = 1 details = KECX01024-E Content is not allowed in prolog.

1.4.7　JavaVMで使用するコマンドでの注意事項（Windowsの場合）

アプリケーションサーバで提供している次のコマンドは，Windows APIのGetTempPath()関数で得られるディレクトリに一時ファイルを作成します。

javagcコマンド

jheapprofコマンド

eheapprofコマンド

これらのコマンドを正常に動作させるためには，GetTempPath()関数で得られるディレクトリに書き込み権限が必要です。また，JavaVMプロセス起動中は，このディレクトリを削除しないでください。

また，このディレクトリをWindowsのシステムディレクトリに指定しないでください。

1.4.8　CTMで使用するコマンドでの注意事項（Windowsの場合）

CTMで使用するコマンドは，Administratorsグループに属するユーザで実行してください。

1.4.9　性能解析トレースで使用するコマンドでの注意事項（Windowsの場合）

性能解析トレースで使用するコマンドの運用は，cprfstartコマンドを実行したユーザと同じユーザで実施してください。

2　J2EEサーバで使用するコマンド

この章では，J2EEサーバで使用するコマンドの入力形式，機能などについて説明します。

2.1　J2EEサーバで使用するコマンドの概要

ここでは，J2EEサーバで使用するコマンドの種類，プロバイダURLについて説明します。

2.1.1　J2EEサーバで使用するコマンドの種類

J2EEサーバで使用するコマンドの種類について説明します。

J2EEサーバで使用するコマンドの種類と格納先を，次の表に示します。

表2‒1　J2EEサーバで使用するコマンドの種類と格納先

J2EEサーバで使用するコマンドの種類

コマンドの格納先

J2EEサーバを操作するコマンド

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥bin¥

UNIXの場合

/opt/Cosminexus/CC/server/bin/

J2EEアプリケーションで使用するコマンド

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥bin¥

UNIXの場合

/opt/Cosminexus/CC/admin/bin/

J2EEサーバで使用するリソース操作コマンド

J2EEサーバで使用するそのほかのコマンド

2.1.2　プロバイダURLについて

CORBAネーミングサービスへのアクセスプロトコル，およびCORBAネーミングサービスが稼働しているホスト名称，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

なお，該当するCORBAネーミングサービスは，接続先J2EEサーバがネーミングサービスとして利用しているものです。サポートしているアクセスプロトコルはcorbanameだけです。

以前のバージョンで，iioplocまたはiiopnameを指定していた場合，corbanameに読み替えられます。

iioplocまたはiiopnameを指定する場合は，次の形式で指定します。

<プロトコル名称>://<ホスト名称>:<ポート番号>

<ホスト名称>にはCORBAネーミングサービスが稼働しているホスト名称を指定します。ただし，次の場合はvbroker.se.iiop_tp.hostキーに指定した値を<ホスト名称>に指定します。

接続先J2EEサーバのusrconf.properties（J2EEサーバ用ユーザプロパティファイル）でejbserver.naming.startupMode=inprocessを指定し，かつvbroker.se.iiop_tp.hostキーに値を指定している。

接続先J2EEサーバのusrconf.properties（J2EEサーバ用ユーザプロパティファイル）でejbserver.naming.startupMode=manualまたはautomaticを指定し，CORBAネーミングサービスの実行時オプションでvbroker.se.iiop_tp.hostキーに値を指定している。

<ホスト名称>を省略した場合は次のようになります。

usrconf.properties（サーバ管理コマンド用システムプロパティファイル）の"ejbserver.naming.protocol"キーの値をアクセスプロトコルとして使用します。

"ejbserver.naming.host"キーの値をホスト名称として使用します。

"ejbserver.naming.port"キーの値をポート番号として使用します。

また，<ホスト名称>のデフォルト値は次のとおりです。

"ejbserver.naming.protocol"キー：corbaname

"ejbserver.naming.host"キー：localhost

"ejbserver.naming.port"キー：900

2.2　J2EEサーバを操作するコマンド

ここでは，J2EEサーバを操作するコマンドについて説明します。

J2EEサーバを操作するコマンドの一覧を，次の表に示します。

表2‒2　J2EEサーバを操作するコマンドの一覧

コマンド名称

分類

概要

コマンドの系統

cjdumpsv

J2EEサーバのスレッドダンプの取得

J2EEサーバで障害が発生した場合などに，JavaVMのスレッドダンプを取得します。

−

cjenvsetup

Component Container管理者のセットアップ

インストールファイルの属性を変更して，root権限を持つユーザ以外で運用できるようにします。

このコマンドは，UNIX用です。

−

cjenvupdate

作業ディレクトリおよびユーザ定義ファイルの移行

Component Containerの旧環境で利用されていた作業ディレクトリおよびユーザ定義ファイルを新環境で動作する形式に移行します。

−

cjgetsysinfo

OS状態情報の取得

OSの状態情報を取得します。

−

cjrarupdate

リソースアダプタのバージョンアップ

Component Containerにインポート・デプロイされているリソースアダプタをバージョンアップします。

−

cjsetup

J2EEサーバのセットアップとアンセットアップ

J2EEサーバの環境をセットアップして，デフォルトのユーザ定義を作成します。

−

cjsleep

J2EEサーバの起動間隔

指定された秒数だけ実行を一時停止します。バッチファイルなどでサーバの起動間隔を空けるために使用します。

このコマンドは，Windows用です。

−

cjstartrecover

J2EEサーバのトランザクション回復

J2EEサーバのトランザクションを回復します。

−

cjstartsv

J2EEサーバの開始

J2EEサーバを開始します。

−

cjstopsv

J2EEサーバの停止

J2EEサーバを停止します。

更新※

（凡例）

更新：更新系コマンド。J2EEサーバの内容を更新，または構成情報を取得するコマンドです。

−：該当なし

注※

-fオプションを指定した場合は，−（該当なし）になります。

サーバ管理コマンドの系統ごとの排他制御については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「3.2　サーバ管理コマンドの排他制御」を参照してください。

セットアップ系コマンド（cjenvsetup，cjenvupdate，cjrarupdate，cjsetup）は単独で実行してください。ほかのセットアップ系コマンドと同時に実行しないでください。

cjdumpsv（J2EEサーバのスレッドダンプの取得）

形式

cjdumpsv [<サーバ名称>]

機能

WebブラウザやEJBクライアントに応答が返らない場合，J2EEサーバで障害が発生した場合，アプリケーションの挙動を調査したい場合などに，JavaVMのスレッドダンプを取得します。

コマンドを実行すると，サーバ標準出力ログ（cjstdout.log）および次のファイルに，スレッドダンプが出力されます。

Windowsの場合

<J2EEサーバの作業ディレクトリ>¥ejb¥<サーバ名称>¥javacore*.txt

UNIXの場合

<J2EEサーバの作業ディレクトリ>/ejb/<サーバ名称>/javacore*.txt

なお，<J2EEサーバの作業ディレクトリ>とは，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.public.directoryキーに指定したディレクトリです。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

UNIXの場合，このコマンドの実行には，root権限，またはComponent Container管理者の権限が必要です。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

J2EEサーバをManagerから起動している場合，またはWindowsのサービスとして起動している場合，スレッドダンプの取得に失敗する場合があります。

cjstopsvコマンドが他のサーバ管理コマンドの終了待ちの状態で，cjdumpsvコマンドを実行すると，スレッドダンプの取得に失敗します。

cjenvsetup（Component Container管理者のセットアップ）

形式

cjenvsetup

機能

インストールファイルの属性（オーナー，グループ，および権限）を変更します。なお，このコマンドはUNIX用です。

インストールディレクトリ（/opt/Cosminexus/CC）に設定されている属性（オーナー，グループ）が，Component Container管理者およびComponent Container管理者グループとして設定されます。

このコマンドの実行情報はメッセージログおよびテキストファイルに出力されます。実行情報の出力内容と出力先については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.4　Component Container管理者を設定するときの注意事項（UNIXの場合）」を参照してください。

引数

なし

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

このコマンドを実行する前に，インストールディレクトリ（/opt/Cosminexus/CCをシンボリックリンクしている場合は，リンク先ディレクトリ）の属性（オーナー，グループ）をComponent Container管理者およびComponent Container管理者グループに変更する必要があります。

このコマンド実行時に，次の操作をしないでください。操作した場合の動作は保証されません。

インストールディレクトリ（/opt/Cosminexus/CC）配下のファイル操作

サーバの起動・停止などの操作

インストールディレクトリ配下でシンボリックリンクを使用している場合，リンクが指しているファイルまたはディレクトリが存在しない状態でこのコマンドを実行しないでください。必ずリンク先が存在することを確認してからコマンドを実行してください。

このコマンドでは，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.server.log.directoryキーに指定したディレクトリの属性は変更しません。ejb.server.log.directoryキーに指定したディレクトリについては手動で属性を変更してください。

cjenvupdate（作業ディレクトリおよびユーザ定義ファイルの移行）

形式

cjenvupdate [-f]

機能

旧バージョンのComponent Containerで使用していたJ2EEサーバが使用しているすべての旧形式の作業ディレクトリおよび次のユーザ定義ファイルを，本バージョンで使用する形式に移行します。

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）

usrconf.cfg（J2EEサーバ用オプション定義ファイル）

server.policy（J2EEサーバ用セキュリティポリシーファイル）

usrconf.properties（サーバ管理コマンド用システムプロパティファイル）

usrconf.bat※（サーバ管理コマンド用オプション定義ファイル）

注※　UNIXの場合は，usrconfです。

旧バージョンからのアップグレードインストール終了後，続けてこのコマンドを実行する必要があります。また，作業ディレクトリを移行するには，作業ディレクトリのあるドライブに，作業ディレクトリのディスク使用量の約2倍分の空き容量が必要です。

なお，<作業ディレクトリ>とは，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.public.directoryキーに指定したディレクトリです。

このコマンドを実行すると，移行対象の定義ファイルのバックアップが，定義ファイルと同じディレクトリに作成されます。作成されるバックアップファイルの名称は，「<移行対象定義ファイル名>.envupdate_bak」になります。バックアップが作成されるときに同名のファイルがすでにあった場合，バックアップファイル名は「<移行対象定義ファイル名>.envupdate_bak_?」（?は1〜2147483647の連番）となります。なお，バックアップファイルは，このコマンドの完了後，自動で削除されません。

アプリケーションサーバの移行については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「10.　旧バージョンのアプリケーションサーバからの移行（J2EEサーバモードの場合）」を参照してください。

引数

-f

移行できないDDファイルがある場合でも強制的に移行します。

移行後の作業

このコマンドによって作業ディレクトリが移行される場合，移行が完了すると，各J2EEサーバの作業ディレクトリの直下にバックアップ作業ディレクトリが作成されます※1。作業ディレクトリには移行後の情報（ファイル），バックアップ作業ディレクトリには移行前の情報（ファイル）が保存されています。なお，作業ディレクトリが「・・・¥<ディレクトリ名>」または「・・・/<ディレクトリ名>」の場合，バックアップ作業ディレクトリは，「・・・¥<ディレクトリ名>¥<ディレクトリ名>_old¥」または「・・・/<ディレクトリ名>/<ディレクトリ名>_old/」※2になります。移行後，J2EEサーバの起動確認，J2EEアプリケーションの動作確認，およびJ2EEサーバの停止確認が終わり，移行前の作業ディレクトリの情報（ファイル）が不要な場合，バックアップ作業ディレクトリを削除してください。ただし，バックアップ作業ディレクトリは，別の場所に保存しておくことを推奨します。

注※1

作業ディレクトリが移行されない場合，バックアップ作業ディレクトリは作成されません。

注※2

すでにバックアップ作業ディレクトリが存在している場合，「・・・¥<ディレクトリ名>¥<ディレクトリ名>_old¥」または「・・・/<ディレクトリ名>/<ディレクトリ名>_old/」は，「・・・¥<ディレクトリ名>¥<ディレクトリ名>_old?¥」または「・・・/<ディレクトリ名>/<ディレクトリ名>_old?/」（?は，1〜2147483647の連番）にリネームされます。

エラー時の対処方法

作業ディレクトリ移行コマンドの実行に失敗した場合，コマンドが出力するメッセージから障害が発生したファイルパスを特定できます。メッセージの例を次に示します。

KDJE30220-I Migration of the definition files of the old version is in progress.
KDJE30221-I The definition files of the old version have been migrated successfully.
KDJE30204-I The server checking is in progress. Server name = [サーバ名称]
KDJE30202-E The Deployment Descriptor cannot be converted. File = [ファイルパス], Reason = [詳細情報]
KDJE30205-E The server will not be migrated because a problem occurred in the Deployment Descriptor. Server name = [サーバ名称]

詳細情報には，例外情報などが出力されます。この詳細情報を参照して問題を取り除き，ディスクに空き容量が十分にあることを確認して，再度コマンドを実行してください。

詳細情報から原因が判断できない場合，または見直し後再実行してもエラーが発生した場合，保守員に連絡してください。

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

UNIXの場合，このコマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

J2EEリソースのリソースアダプタおよびJ2EEリソースアダプタの拡張DDファイル（hitachi-ra.xml）がスクランブルされている場合，スクランブルされていないJava EE仕様に準拠したDDファイル（ra.xml）はスクランブルされます。

コマンドの実行時は，次のディレクトリの下のファイルにアクセスしないでください。コマンドが失敗するおそれがあります。なお，ウィルススキャンエンジンがスキャンを実行中の場合，意図しないでファイルにアクセスしていることがあるため，注意してください。

Windowsの場合

・<Application Serverのインストールディレクトリ>¥CC

・<作業ディレクトリ>

UNIXの場合

・/opt/Cosminexus/CC

・<作業ディレクトリ>

cjgetsysinfo（OS状態情報の取得）

形式

cjgetsysinfo [-f <OS状態情報出力ファイルパス>]

機能

OSの状態情報を取得します。OSの状態情報取得コマンドの実行結果を，標準出力または-fオプションで指定したファイルへ出力します。

Windowsの場合のOSの状態情報取得コマンドを次に示します。

netstat -e
netstat -s
netstat -an
set

UNIXの場合のOSの状態情報取得コマンドを次の表に示します。

表2‒3　OSの状態情報取得コマンドの一覧

AIX

Linux

df -k

ps -elf

ps -A -m -o THREAD

vmstat -t 1 1

vmstat -s

lsps -s

netstat -i

netstat -m

netstat -an

iostats

svmon -P

svmon -G

sar -A 1

instfix -i

lslpp -hac

uname -a

env

set

ipcs -a

df

ps -eflm

vmstat

netstat -s

netstat -an

iostat※

top -b -n 1

sysctl -a

sar -A 1 1※

rpm -qa

rpm -qai

uname -a

env

set

ipcs

ipcs -t

ipcs -p

ipcs -c

ipcs -u

ipcs -l

注※

sysstatパッケージがインストールされている必要があります。

引数

-f <OS状態情報出力ファイルパス>

OSの状態情報を出力するファイルパスを指定します。

UNIX版の場合，半角スペースを含むファイルパスは指定できません。

出力例

AIXの場合の例を次に示します。

戻り値

0：

正常終了しました。

1以上：

異常終了しました。

注意事項

指定したパスが存在しない場合，エラーとなります。

環境によって，OSの状態情報取得コマンドが見つからない場合，そのコマンドの実行結果は出力されません。

このコマンドに掛かる処理時間は，OSの状態情報取得コマンドの処理時間に依存します。

cjrarupdate（リソースアダプタのバージョンアップ）

形式

リソースアダプタをバージョンアップする場合

cjrarupdate -type {dbconnector|rar} [-force] [-f <ファイルパス> ...]
            [-backupto <バックアップ格納先ディレクトリ>]

作業ディレクトリ環境を回復する場合

cjrarupdate -recoverfrom <バックアップRARディレクトリ>

機能

リソースアダプタをバージョンアップする場合

Component Containerにインポート・デプロイされているリソースアダプタをバージョンアップします。

リソースアダプタの移行には，作業ディレクトリのディスク使用量の約2倍以上※の空き容量が必要です。また，アップグレードインストールの場合は，移行コマンドcjenvupdateによって移行処理が問題なく完了していることを確認してから，このコマンドを実行してください。

なお，<作業ディレクトリ>とは，usrconf.cfg（J2EEサーバ用オプション定義ファイル）のejb.public.directoryキーに指定したディレクトリです。

注※

移行するリソースアダプタ数やコマンド実行回数によって，必要なディスクの空き容量は変わります。移行に必要なディスク容量については，アプリケーションサーバの移行の手順で確認してください。アプリケーションサーバの移行については，マニュアル「アプリケーションサーバ機能解説 保守／移行編」の「10.　旧バージョンのアプリケーションサーバからの移行（J2EEサーバモードの場合）」を参照してください。

作業ディレクトリ環境を回復する場合

Component Containerにインポート・デプロイされているリソースアダプタのバージョンアップに失敗した場合，作業ディレクトリ環境を回復します。

引数

-type {dbconnector|rar}

バージョンアップするリソースアダプタの種類を指定します。

dbconnector

DB Connectorの場合に指定します。

rar

Component ContainerがサポートしているDB Connector以外のリソースアダプタの場合に指定します。

-force

強制的にバージョンアップします。この引数が指定された場合，リソースアダプタのバージョンにかかわらずリソースアダプタをバージョンアップします。

-f <ファイルパス>

移行対象としてDB Connector以外のリソースアダプタを指定した場合（-type rarを指定した場合）

旧バージョンの既存リソースアダプタと置き換えるリソースアダプタのファイルパスを指定します。ファイルパスは，複数回指定できますが，-fオプションは複数回指定できません。

-fオプションにTP1インバウンドアダプタまたはFTPインバウンドアダプタ以外のConnector 1.5の仕様に準拠するリソースアダプタを指定した場合，メッセージKDJE42356-Eが出力されます。

移行対象としてDB Connectorを指定した場合（-type dbconnectorを指定した場合）

この引数は無視されます。

-backupto <バックアップ格納先ディレクトリ>

作業ディレクトリのバックアップの格納先を指定します。このオプションを省略した場合，<作業ディレクトリ>下にバックアップディレクトリが作成されます。

作業ディレクトリのあるディスクの容量に余裕がない場合，またはファイルシステムのパス長制限でバックアップが作成できない場合に，このオプションを指定してください。なお，このオプションでバックアップ格納先ディレクトリを指定する場合，次のことに注意してください。

複数回このコマンドを実行する場合には，同一ディレクトリを指定してください。

長いパス名を指定すると，バックアップ作成に失敗することがあります。その場合，失敗したバックアップを削除してから，短いパス名を指定して再度実行してください。

Component Containerのインストールディレクトリを含まないようにしてください。

-recoverfrom <バックアップRARディレクトリ>

回復元となる作業ディレクトリのバックアップRARのディレクトリを指定します。

移行後の作業

移行が完了した場合，各J2EEサーバの作業ディレクトリ，または-backuptoオプションで指定したディレクトリの直下にバックアップ作業ディレクトリが作成され，作業ディレクトリには移行後の情報（ファイル），バックアップ作業ディレクトリには移行前の情報（ファイル）が保存されています。なお，作業ディレクトリが「・・・¥<ディレクトリ名>¥」または「・・・/<ディレクトリ名>/」の場合，バックアップ作業ディレクトリは，「・・・¥<ディレクトリ名>¥rarupdate_bk¥」または「・・・/<ディレクトリ名>/rarupdate_bk/」※になります。移行後，リソースアダプタの開始，停止およびデータベースへの接続確認が終わり，移行前の作業ディレクトリの情報（ファイル）が不要な場合，バックアップ作業ディレクトリを削除してください。ただし，バックアップ作業ディレクトリは，別の場所に保存しておくことを推奨します。

注※

バックアップの対象ディレクトリは，リソースアダプタに関連するディレクトリです。

すでにバックアップ作業ディレクトリが存在している場合，「・・・¥<ディレクトリ名>¥rarupdate_bk¥」または「・・・/<ディレクトリ名>/rarupdate_bk/」は，「・・・¥<ディレクトリ名>¥rarupdate_bk_?¥」または「・・・/<ディレクトリ名>/rarupdate_bk_?」（?は，コマンド実行時のミリ秒までの日時）にリネームされます。

バージョンタグの比較方法

移行するRARファイルによっては，バージョンタグを比較できないため，移行処理が正常に終了しないことがあります。次の手順でバージョンタグを比較してください。

バージョン文字列を，RARファイルに含まれるra.xmlまたはJ2EEサーバにインポート，デプロイされたリソースアダプタのra.xmlの<version>タグから取得します。

バージョン文字列が，次の形式で指定されている場合は，比較可能な形式に編集します。

<連続した数字1>.<連続した数字2><数字以外から開始する文字列>

比較可能な形式

V₁V₂-R₁R₂-S₁S₂（またはV₁V₂-R₁R₂）

V1，V2，R1およびR2：0〜9の数値
S1：/
S2：A〜Z（英字大文字）

編集手順は次のとおりです。

<連続した数字1>と<連続した数字2>の間に半角でハイフン(-)を追加します。

<連続した数字1>-<連続した数字2><数字以外から開始する文字列>

<連続した数字1>が10未満の場合，先頭に0を付加します。

<連続した数字2>が10未満の場合，末尾に0を付加します。

編集例

1.0  → 01-00
1.1  → 01-10
1.12 → 01-12
2.0  → 02-00

バージョン文字列が，V₁V₂-R₁R₂[-S₁S₂]の形式で指定されている場合，次の順序でバージョンの大小比較をします。

V₁V₂-R₁R₂部を文字列として比較して，Unicodeの辞書順で大きい方を新バージョンとします。（例：01-00-/Zと02-00では，02-00の方が新しい）

V₁V₂-R₁R₂部が同一の場合，-S₁S₂部が存在している方を新バージョンとします。（例：02-00-/Aと02-00では，02-00-/Aの方が新しい）

V₁V₂-R₁R₂部が同一の場合でどちらも-S₁S₂部が存在しているとき，次のようになります。

S2を文字列として比較し，Unicodeの辞書順で大きい方を新バージョンとします。

S1を文字列として比較し，/ > P > S の順で新バージョンとします。

（例：02-00-/Aと02-00-/Bでは，02-00-/Bの方が新しい

　02-01-SBと02-01-/Aでは，02-01-SBの方が新しい

　02-01-SAと02-01-PAでは，02-01-PAの方が新しい

　02-01-PAと02-01-/Aでは，02-01-/Aの方が新しい）

どちらかまたは両方の形式が異なる場合，バージョン文字列全体を文字列比較し，Unicodeの辞書順で大きい方を新バージョンとします。

なお，ra.xmlの<version>タグの値がサポート外の文字列を使用している場合，正しい比較ができません。次の対処が必要です。

入れ替えるRARファイルが新しいバージョンでも古いバージョンと認識されてしまう場合は，-forceオプションを指定して実行してください。

誤って古いバージョンのRARファイルでJ2EEサーバにインポートまたはデプロイされたリソースアダプタを移行してしまった場合，バックアップ作業ディレクトリから元の環境を復旧してください。バックアップ作業ディレクトリについては，次の個所を参照してください。

マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「10.7　J2EEサーバまたはバッチサーバの移行コマンドの実行」

マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「10.12　移行コマンドで作成されたバックアップの削除」

入力例

-fオプションに，ファイルパスを複数回指定する場合

cjrarupdate -type rar -f file1 file2 file3

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

Windowsの場合，このコマンドの実行には，Administrator権限が必要です。

UNIXの場合，このコマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

-typeオプションはコマンド名の直後に指定し，dbconnectorまたはrarを指定する必要があります。-forceオプション，-fオプションおよび-backuptoオプションの順序は任意です。

このコマンドは同時に実行しないでください。

J2EEサーバが起動している場合，またはJ2EEサーバの起動チェック中に問題が発生した場合は，メッセージを出力して処理を中断します。

次のRARファイルは，バージョンアップの対象外です。

RARファイルの内容を変更している場合。

Component Containerが提供，またはサポートしているRARファイル名と同名のファイルを作成してインポートしている場合。

Component Containerが提供，またはサポートしているRARファイル名と，数字および文字を組み合わせて生成されたファイル名の場合。

TP1インバウンドアダプタまたはFTPインバウンドアダプタ以外のConnector 1.5の仕様に準拠するリソースアダプタの場合。

TP1インバウンドアダプタまたはFTPインバウンドアダプタ以外のConnector 1.5の仕様に準拠するリソースアダプタをバージョンアップする場合，再インポートおよび定義を再設定してください。

TP1/Message Queue-Accessの移行をする場合に，新しいRARファイルが同一バージョンと認識されることがあります。その場合は-forceオプションを指定して強制的に移行処理を実行してください。

Component Container以外が提供するリソースアダプタ（TP1 ConnectorおよびTP1/Message Queue-Access）は，バージョンアップした場合にユーザがプロパティを追加する必要があるときがあります。その場合，このコマンドで移行しただけでは動作しません。リソースアダプタのマニュアルに従って設定をしてください。

Component Container以外が提供するリソースアダプタ（TP1 ConnectorおよびTP1/Message Queue-Access）は，バージョンアップに失敗する場合があります。その場合は，バージョンアップに失敗したリソースアダプタを削除し，再度インポートしたあとプロパティを設定してください。なお，削除する前に設定を控えておくことを推奨します。

入れ替えるRARファイルが新しいバージョンでも同一バージョンまたは古いバージョンと認識されてしまう場合は，-forceオプションを指定して再度このコマンドを実行してください。バージョンに関係なく強制的に移行されます。

<Application Serverのインストールディレクトリ>¥CC¥DBConnector¥（Windowsの場合），または/opt/Cosminexus/CC/DBConnector/（UNIXの場合）以下にあるrarファイルを変更，削除した場合，移行処理が正常に動作しないことがあるため，変更，削除しないでください。

バックアップ中に例外が発生した場合は，例外メッセージ出力後，このコマンドは終了しないで処理を続けます。このときバックアップディレクトリは作成されません。

リソースアダプタが存在しないJ2EEサーバについては，バックアップを作成しないで処理を続けます。

バックアップを作成していないJ2EEサーバについては，移行処理をしません。

このコマンドで移行すると，DB ConnectorのConnector属性ファイルの<config-property>タグに存在しなかったプロパティの<config-property-value>は，デフォルト値で設定されます。ただし，loginTimeout，PreparedStatementPoolSize，CallableStatementPoolSize，またはCancelStatementプロパティが存在しなかった場合，移行後に次の値で設定されます。

loginTimeout:0

PreparedStatementPoolSize:0

CallableStatementPoolSize:0

CancelStatement:false

cjsetup（J2EEサーバのセットアップとアンセットアップ）

形式

セットアップの場合

cjsetup [<サーバ名称> [-compat <セットアップバージョン識別子>]]

アンセットアップの場合

cjsetup -d <サーバ名称>

機能

指定したサーバ名称のJ2EEサーバの環境をセットアップします。

次のディレクトリにセットアップしたJ2EEサーバ用のデフォルトのユーザ定義を作成します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/

なお，-dオプションを指定した場合，次に示すJ2EEサーバの環境（ディレクトリおよびファイル）を削除します。

ユーザ定義ファイルの格納用ディレクトリ以下

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/

一時作業用ディレクトリ以下

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥repository¥<サーバ名称>¥

UNIXの場合

/opt/Cosminexus/CC/server/repository/<サーバ名称>/

作業用ディレクトリ以下（デフォルト）

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥

UNIXの場合

/opt/Cosminexus/CC/server/public/ejb/<サーバ名称>/

Webアプリケーションの格納用ディレクトリ以下（デフォルト）

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥public¥web¥<サーバ名称>¥

UNIXの場合

/opt/Cosminexus/CC/server/public/web/<サーバ名称>/

なお，作業用ディレクトリ，およびWebアプリケーションの格納用ディレクトリについては，ユーザ定義ファイル（usrconf.cfg）のejb.public.directoryキーにデフォルト値以外が指定されていた場合，そのディレクトリ以下も削除します。

引数

<サーバ名称>

セットアップ，またはアンセットアップするJ2EEサーバのサーバ名称を指定します。

サーバ名称には，半角英数字（0〜9，A〜Z，a〜z），アンダースコア（_）またはハイフン（-）を使用できます。サーバ名称の先頭の文字は英数字でなければなりません。また，サーバ名称は，255文字以下，かつマニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録C.1　J2EEサーバの作業ディレクトリ」を参照して見積もった範囲内の長さで指定してください。

サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。ただし，アンセットアップ時は省略できません。また，ホスト名称にサーバ名称として使用できない文字が含まれている場合はエラーになります。

-compat <セットアップバージョン識別子>

指定したバージョンの互換モードに切り替えてJ2EEサーバを構築します。

-compatを指定しない場合，推奨モードでJ2EEサーバを構築します。

セットアップバージョン識別子にはV9を指定し，V9互換モードでJ2EEサーバを構築します。

セットアップバージョン識別子に何も指定しない場合，エラーメッセージKDJE40027-Iを出力し，コマンドオプションの書式エラーとなります。

セットアップバージョン識別子にV9以外の値を入力した場合，エラーメッセージKDJE40075-Eを出力し，エラーとなります。

JDK17を使用している環境の場合は，互換モードに切り替えることはできません。セットアップバージョン識別子が指定された場合は，エラーメッセージKDJE40078-Eを出力し，エラーとなります。

-d

J2EEサーバの環境を削除する場合に指定します。サーバ名称は省略できません。

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

アプリケーションサーバを再インストールする際にJDKのメジャーバージョンを変更する場合は，再インストール前に構築した環境は使用せずに再セットアップを実行して環境を構築し直してください。

UNIXの場合，このコマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

UNIXの場合にアンセットアップ（cjsetup -d <サーバ名称>）を実行すると，削除対象のディレクトリ，ファイルのアクセス権の設定および使用状態に関係なく，すべて削除します。

セットアップ済みのサーバ名称を指定して再セットアップする（cjsetup <サーバ名称>）と，エラーとなります。

アンセットアップを実行するときにコマンドの引数に指定するサーバ名称には，セットアップで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。ただし，Windowsの場合，サーバ名称の大文字・小文字は区別されません。すでに作成済みのサーバ名称と，大文字・小文字の区別以外は一致している文字列をcjsetupのサーバ名称として指定した場合，次のように動作します。

セットアップの場合(cjsetup <サーバ名称>)

セットアップに失敗します。

アンセットアップの場合(cjsetup -d <サーバ名称>)

すでに作成済みである，<サーバ名称>と大文字・小文字の区別以外は一致しているサーバが削除されます。

サーバ管理コマンド，J2EEサーバの開始または停止コマンドを実行する場合，これらのコマンドにサーバ名称を引数として指定するときは，このコマンドで作成したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

起動中のJ2EEサーバに対して，アンセットアップ（cjsetup -d <サーバ名称>）を実行しないでください。

Windowsの場合，削除対象のファイルの属性が読み取り専用，または使用中のときに，アンセットアップ（cjsetup -d <サーバ名称>）を実行しないでください。

Component Container管理者を設定している場合，Management Serverのサーバ名と同じ名前でJ2EEサーバやバッチサーバをセットアップしないでください。

cjsleep（J2EEサーバの起動間隔）

形式

cjsleep [<スリープ時間>]

機能

指定された秒数だけ実行を一時停止します。バッチファイルなどでサーバの起動間隔を空けるために使用します。なお，このコマンドは，Windows用です。

スリープ時間に指定した値が1〜2147483647の正の整数でない場合は，デフォルト値として10が使用されます。

引数

<スリープ時間>

J2EEサーバの起動を遅らせる時間を，1〜2147483647（単位：秒）の正の整数で指定します。

戻り値

0：

正常終了しました。

0以外：

異常終了しました。

cjstartrecover（J2EEサーバのトランザクション回復）

形式

cjstartrecover [<サーバ名称>] [-nosecurity] [-nostartapp]
               [[-p <キー名称>=<値>] ...] [-t <タイマ監視時間>]

機能

J2EEサーバをリカバリ処理専用のリカバリモードとして起動します。

リカバリモードで起動したJ2EEサーバは，トランザクションのリカバリ処理を完了したあと，J2EEサーバを停止します。

引数

<サーバ名称>

リカバリするJ2EEサーバのサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nosecurity

SecurityManagerを解除する場合に指定します。リソースアクセス時の権限チェックのオーバーヘッドを削減できますが，J2EEアプリケーションは任意のリソースへのアクセスができるようになるため，セキュリティが低下します。

-nostartapp

無限ループなどの動作不正のJ2EEアプリケーションがある場合に，J2EEサーバを強制終了してもサーバ再起動時にJ2EEアプリケーションが自動開始されてしまい，アプリケーションの入れ替えができない状態を回避するときなどに指定します。

このオプションを指定してJ2EEサーバを起動し，登録済みのJ2EEアプリケーションに対して次の操作をした場合，次回このオプションを省略してJ2EEサーバを起動すると，そのJ2EEアプリケーションに対する開始処理をしません。

アプリケーションの属性設定

リソース（フィルタ，WAR，EJB-JAR，またはリソースアダプタ）の追加

リソース（フィルタ，WAR，EJB-JAR，またはリソースアダプタ）の削除

ライブラリJARのインポート

ライブラリJARの削除

アプリケーションの入れ替え

CMP2.x Entity Bean用SQL文の生成

なお，開始状態のJ2EEアプリケーションを実行時情報を含めてエクスポートした場合，このEARファイルをインポートすると，-nostartappオプションの指定に関係なくJ2EEアプリケーションは自動で開始されます。

-p <キー名称>=<値>

J2EEサーバを実行するJavaVMのシステムプロパティを指定します。指定できるのは，usrconf.properties（J2EEサーバ用ユーザプロパティファイル）のキーです。usrconf.properties（J2EEサーバ用ユーザプロパティファイル）については，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

値にスペースや記号（”|”,”&”など）が含まれる文字列を指定する場合は，値をダブルクォーテーション（""）で囲んでください。

指定したキー名称が，J2EEサーバ用ユーザプロパティファイルに定義されているプロパティのキー名称と重複した場合，-pオプションで指定したプロパティ値が優先されます。指定したプロパティの値に誤りがあった場合，指定したプロパティキー名称の仕様に従います。指定したプロパティのキー名称に誤りがあった場合，その指定を無視して処理を継続します。

-t <タイマ監視時間>

タイマ監視時間を0〜3600の整数（単位：秒）で指定します。

指定したタイマ監視時間内にリカバリ処理が終了しない場合，J2EEサーバは強制停止します。このオプションを省略した場合，0秒が設定されます。

タイマ監視時間に0を指定した場合，タイマ監視を行わないで，J2EEサーバが終了するまで待ち続けます。

入力例

cjstartrecover MyServer -t 300

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

タイムアウトによって強制停止しました。

注意事項

Windowsの場合，このコマンドの実行には，Administrator権限が必要です。

UNIXの場合，このコマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<タイマ監視時間> -t）やオプション名と値を非対応にすること（例：-t <キー名称>=<値> -p <タイマ監視時間>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

コマンドの引数に-tオプションを指定する場合は，そのほかの引数の後ろにする必要があります。また，タイマ監視時間には，トランザクションタイムアウト時間とJ2EEサーバの開始処理に掛かる時間を考慮して長めに設定しておく必要があります。

コマンドの引数に-pオプションを複数指定する場合，コマンドラインに指定できる文字長は使用するOSによって制限があります。

cjstartsv（J2EEサーバの開始）

形式

cjstartsv [<サーバ名称>] [-nosecurity] [-nostartapp]

機能

指定したサーバ名称のJ2EEサーバを開始します。サーバ名称を省略したときは，ホスト名称と同じサーバ名称が設定されたJ2EEサーバを開始します。

引数

<サーバ名称>

開始するJ2EEサーバのサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nosecurity

SecurityManagerを解除する場合に指定します。リソースアクセス時の権限チェックのオーバーヘッドを削減できますが，J2EEアプリケーションは任意のリソースへのアクセスができるようになるため，セキュリティが低下します。

このオプションを指定する場合，java.lang.SystemのsetSecurityManagerメソッドは使用できません。使用した場合，J2EEサーバの実行に不具合が生じるおそれがあります。また，該当するJ2EEサーバプロセスからEJBを呼び出す場合にダイナミッククラスローディングは使用できません。

-nostartapp

無限ループなどの動作不正のJ2EEアプリケーションがある場合に，J2EEサーバを強制終了してもサーバ再起動時にJ2EEアプリケーションが自動開始されてしまい，アプリケーションの入れ替えができない状態を回避するときなどに指定します。

このオプションを指定してJ2EEサーバを起動し，登録済みのJ2EEアプリケーションに対して次の操作をした場合，次回このオプションを省略してJ2EEサーバを起動すると，そのJ2EEアプリケーションに対する開始処理をしません。

アプリケーションの属性設定

リソース（フィルタ，WAR，EJB-JAR，またはリソースアダプタ）の追加

リソース（フィルタ，WAR，EJB-JAR，またはリソースアダプタ）の削除

ライブラリJARのインポート

ライブラリJARの削除

アプリケーションの入れ替え

CMP2.x Entity Bean用SQL文の生成

なお，開始状態のJ2EEアプリケーションを実行時情報を含めてエクスポートした場合，このEARファイルをインポートすると，-nostartappオプションの指定に関係なくJ2EEアプリケーションは自動で開始されます。

Transacted Delivery機能を使用している場合，本オプションを指定してJ2EEサーバを起動したあとにJ2EEリソースアダプタを停止状態にして，J2EEサーバを停止させないでください。その場合，J2EEサーバが起動できない状態となります。

ユーザ定義ファイル

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥usrconf.cfg

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥usrconf.properties

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/usrconf.cfg

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/usrconf.properties

戻り値

0：

正常終了しました。

1以上（143以外）：

異常終了しました。

143：

コマンド実行中に次の操作をしました（Windowsの場合）。

コマンドを起動しているコマンドプロンプトのウィンドウを「×」ボタンを押下して閉じた。

Windowsシステムをシャットダウンした。

Windowsシステムをログオフした。

注意事項

cjstartsvコマンドはJ2EEサーバ起動時に，システムプロパティjava.io.tmpdirに次の値を設定します。

Windowsの場合

<作業ディレクトリ>¥ejb¥<J2EEサーバ名>¥temp

UNIXの場合

<作業ディレクトリ>/ejb/<J2EEサーバ名>/temp

J2EEサーバを自動起動するように設定できます。J2EEサーバの起動については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録L.1　サーバ管理コマンドによるサンプル実行環境の構築，運用手順」を参照してください。

Windowsの場合，このコマンドの実行には，Administrator権限が必要です。

UNIXの場合，このコマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjstopsv（J2EEサーバの停止）

形式

cjstopsv [<サーバ名称>]
         [-f|-fd [<スレッドダンプ取得間隔> <スレッドダンプ取得回数>]]
         [-wait <終了待ち時間>]

機能

サーバ名称のJ2EEサーバを停止します。サーバ名称を省略したときは，ホスト名称がサーバ名称になります。

引数

<サーバ名称>

停止するJ2EEサーバのサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-f

J2EEサーバを強制停止します。

Management Serverから論理サーバとしてJ2EEサーバを起動している場合，コンソールからのこのコマンドによる強制停止はできません。強制停止する場合は，Management Serverから実行します。論理サーバの停止については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」を参照してください。

-fd

J2EEサーバの障害情報を取得したあと，J2EEサーバを強制停止します。

<スレッドダンプ取得間隔>

スレッドダンプを取得する間隔を1〜60の整数（単位：秒）で指定します。省略した場合の初期値は3秒です。

<スレッドダンプ取得回数>

スレッドダンプを取得する回数を1〜60の整数（単位：回）で指定します。省略した場合の初期値は10回です。

取得する障害情報を次に示します。

OSの稼働状況

Windowsの場合の出力先：

<J2EEサーバの作業ディレクトリ>¥ejb¥<サーバ名称>¥cjsysinfo.<出力時間>.txt

UNIXの場合の出力先：

<J2EEサーバの作業ディレクトリ>/ejb/<サーバ名称>/cjsysinfo.<出力時間>.txt

<出力時間>は，yymmddHHMMSSの形式になります。

なお，出力内容については，「cjgetsysinfo（OS状態情報の取得）」を参照してください。

JavaVMのスレッドダンプ

<スレッドダンプ取得間隔>，<スレッドダンプ取得回数>で指定した間隔と回数でスレッドダンプを取得します。J2EEサーバプロセスの状態によっては指定間隔，指定回数でスレッドダンプが出力されない場合もあります。なお，出力内容については，「cjdumpsv（J2EEサーバのスレッドダンプの取得）」を参照してください。

J2EEサーバのクラッシュダンプ（Windowsの場合）またはcoreファイル（UNIXの場合）

最後のスレッドダンプ取得要求後，スレッドダンプ取得間隔時間経過後にクラッシュダンプまたはcoreファイルを出力します。

クラッシュダンプの出力先：

<環境変数CJMEMDUMP_PATHで指定したディレクトリ>※¥cjmemdump.dmp

注※：環境変数CJMEMDUMP_PATHが指定されていないか，指定したディレクトリが存在しない場合，クラッシュダンプは出力されません。また，指定したディレクトリにクラッシュダンプがすでに存在する場合，クラッシュダンプは上書きされます。

coreファイルの出力先：

<J2EEサーバの作業ディレクトリ>/ejb/<サーバ名称>/core※

注※

Linuxの場合，core.<強制停止されたJ2EEサーバのプロセスID>

-wait＜終了待ち時間＞

終了待ち時間を0〜86400の符号なし整数で指定します。デフォルト値は，180秒です。

J2EEサーバへの正常終了要求を入力したあとからJ2EEサーバの正常終了が完了するまでのcjstopsvの終了待ち時間を指定します。終了待ち時間に0を指定した場合，J2EEサーバが正常終了するまで無限に待ちます。このとき，-fまたは-fdオプションが指定されていても無視されます。

指定値に誤りがあった場合は，エラーを出力したあと，デフォルト値で正常終了を待ちます。

指定時間を超えてもJ2EEサーバが正常終了しなかった場合，次の表に示すほかの引数との組み合わせによる処理をしたあと，コマンドは終了コード2で異常終了します。

ほかの引数との組み合わせ

タイムアウト後の動作

-fおよび-fdが未指定の場合

メッセージを出力して終了します。このとき，J2EEサーバの停止はしません。

-fが指定されている場合

メッセージを出力し，J2EEサーバの強制停止をします。

-fdが指定されている場合

メッセージを出力し，障害情報とスレッドダンプを取得してJ2EEサーバの強制停止をします。なお，障害情報取得完了までcjstopsvは終了しません。

ユーザ定義ファイル

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥usrconf.cfg

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥usrconf.properties

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/usrconf.cfg

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/usrconf.properties

戻り値

0：

正常終了しました。

1以上：

異常終了しました。詳細については，次の表を参照してください。

終了コード

説明

2

-waitによる正常終了監視タイムアウトです。

2以外

パラメタ不正，内部エラーなどに関係するエラーの場合に出力されます（詳細は直前に表示されるメッセージを参照してください）。

注意事項

このコマンドでJ2EEサーバを停止する場合，Enterprise Beanのビジネスメソッド，またはサーブレット／JSPのサービスメソッドが実行中のときは，該当するメソッドが終了するまでJ2EEサーバは停止しません。

Windowsの場合，このコマンドの実行には，Administrator権限が必要です。

UNIXの場合，このコマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<終了待ち時間> -wait）やオプション名と値を非対応にすること（例：-f <スレッドダンプ取得回数> -fd <スレッドダンプ取得間隔>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

アプリケーションが存在する状態でこのコマンドを実行した場合，J2EEサーバを停止できないことがあります。この場合，-fオプションまたは-fdオプションを指定して，再度このコマンドを実行することでJ2EEサーバを強制停止します。

-fdオプションを指定する場合，環境変数CJMEMDUMP_PATHは次のように設定してください。

環境変数CJMEMDUMP_PATHで指定した保存先のディスクに十分な空き容量があることを確認してください。クラッシュダンプのファイルサイズはJ2EEサーバの実メモリ所要量以上になります。

環境変数CJMEMDUMP_PATHに日本語などのマルチバイト文字を含むディレクトリを指定しないでください。クラッシュダンプの出力に失敗する場合があります。

クラッシュダンプの出力先ディレクトリには，存在するディレクトリを指定してください。

cjstopsvコマンドが他のサーバ管理コマンドの終了待ちの状態で，-fdオプションを指定してcjstopsvコマンドを実行すると，スレッドダンプの取得に失敗します。

2.3　J2EEアプリケーションで使用するコマンド

ここでは，J2EEアプリケーションで使用するコマンドについて説明します。

J2EEアプリケーションで使用するコマンドの一覧を，次の表に示します。

表2‒4　J2EEアプリケーションで使用するコマンドの一覧

コマンド名称

分類

概要

コマンドの系統

cjaddapp

リソースの追加

インポート済みのEJB-JARファイル，WARファイル，RARファイル，またはフィルタをJ2EEアプリケーションに追加します。

更新

cjdeleteapp

J2EEアプリケーションの削除

J2EEアプリケーションまたはJ2EEアプリケーションに含まれるEJB-JARファイル，WARファイル，RARファイル，またはフィルタを，指定されたJ2EEサーバから削除します。

更新

cjdeletelibjar

ライブラリJARの削除

ライブラリJARをJ2EEアプリケーションから削除します。

更新

cjexportapp

J2EEアプリケーションのエクスポート

J2EEサーバ上のJ2EEアプリケーションをエクスポートします。

更新

cjgencmpsql

CMP2.x Entity Bean用SQL文の生成

CMP2.x Entity Bean用のSQL文を生成します。

更新

cjgetappprop

アプリケーションの属性の取得

J2EEアプリケーションまたはJ2EEアプリケーションに含まれるリソースの属性を取得して，属性ファイルを生成します。

更新

cjgetstubsjar

アプリケーションのRMI-IIOPスタブおよびインタフェースの取得

J2EEアプリケーションについて，RMI-IIOPスタブおよびインタフェースを取得します。

更新

cjimportapp

J2EEアプリケーションのインポート

J2EEアプリケーションをJ2EEサーバにインポートします。

更新

cjimportwar

WARアプリケーションのインポート

WARアプリケーションをJ2EEサーバにインポートします。

更新

cjimportlibjar

ライブラリJARのインポート

J2EEアプリケーションにライブラリJARをインポートします。

更新

cjlistapp

アプリケーションの一覧表示

すべてのJ2EEアプリケーションについての名称と状態，J2EEアプリケーションに含まれるEJB-JARファイル，WARファイル，またはRARファイルの一覧を標準出力に出力します。

参照

cjlistlibjar

ライブラリJARの一覧表示

J2EEアプリケーションに含まれるライブラリJARの一覧を標準出力に出力します。

参照

cjreloadapp

アプリケーションのリロード

J2EEアプリケーションを停止しないで構成するクラスおよびJSPを入れ替えます。

更新

cjrenameapp

アプリケーション名の変更

J2EEアプリケーションの名称を変更します。

更新

cjreplaceapp

アプリケーションの入れ替え

J2EEアプリケーションを入れ替えます。

更新

cjsetappprop

アプリケーションの属性設定

アプリケーション，EJB-JARファイルに含まれるリソース，WARファイルに含まれるリソース，またはRARファイルの属性を，指定されたアプリケーション属性ファイルの値に変更します。

更新

cjstartapp

J2EEアプリケーションの開始

J2EEアプリケーションを開始して，クライアントからのリクエストを受け取ることができるようにします。

更新

cjstopapp

J2EEアプリケーションの停止

J2EEアプリケーションを停止して，クライアントからのリクエストを受け取らないようにします。

更新※

（凡例）

更新：更新系コマンド。J2EEサーバの内容を更新，または構成情報を取得するコマンドです。

参照：参照系コマンド。J2EEサーバの内容を更新しないで，構成状態を表示するだけのコマンドです。

注※

-cancelオプションを指定した場合，特権系コマンドになります。

サーバ管理コマンドの系統ごとの排他制御の条件については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「3.2　サーバ管理コマンドの排他制御」を参照してください。

cjaddapp（リソースの追加）

形式

EJB-JARファイル，WARファイル，またはRARファイルの場合

cjaddapp [<サーバ名称>] [-nameserver <プロバイダURL>]
          -type {ejb|war|rar} -name <J2EEアプリケーション名>
          -resname <表示名> [-resname <表示名> ...]

フィルタの場合

cjaddapp [<サーバ名称>] [-nameserver <プロバイダURL>]
          -type filter -name <J2EEアプリケーション名>
          -warname <WARファイルの表示名>
          -c <属性ファイルパス> [-c <属性ファイルパス> ...]

機能

EJB-JARファイル，WARファイルまたはRARファイルの場合

J2EEアプリケーションが存在する場合，インポート済みのEJB-JARファイル，WARファイル，またはRARファイルをJ2EEアプリケーションに追加します。また，一度に複数のファイルの追加もできます。その際，指定したファイルの順に処理されます。

J2EEアプリケーションが存在しない場合，J2EEアプリケーションを新規作成して，インポート済みのEJB-JARファイル，WARファイル，またはRARファイルをJ2EEアプリケーションに追加します。

フィルタの場合

J2EEアプリケーションおよびWARファイルが存在する場合，指定したWARファイルにフィルタを追加します。追加するフィルタは，-cオプションに指定するフィルタ属性ファイルに指定します。また，一度に複数のフィルタの追加もできます。その際，指定されたフィルタの順に処理されます。

J2EEアプリケーションまたはWARファイルが存在しない場合，エラーとなります。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-type {ejb|war|rar|filter}

追加するリソースの種別を指定します。

ejb：EJB-JARファイル

war：WARファイル

rar：RARファイル

filter：フィルタ

-name <J2EEアプリケーション名>

J2EEアプリケーション名を指定します。J2EEアプリケーション名は，1以上の文字列長である必要があります。

新規にJ2EEアプリケーションを作る場合，名称には英数字（0〜9，A〜Z，a〜z）または次の特殊文字を使用できます。

プラス（+），ハイフン（-），ピリオド（.），キャレット（^），アンダースコア（_）

-resname <表示名>

追加対象となるEJB-JARファイル，WARファイル，またはRARファイルの表示名を指定します。

-warname <WARファイルの表示名>

フィルタの追加先となるWARファイルの表示名を指定します。

-c <属性ファイルパス>

フィルタ属性ファイルの入力元パスを指定します。

入力例

EJB-JARファイルの場合

cjaddapp MyServer -type ejb -name App1 -resname accountJsp

WARファイルの場合

cjaddapp MyServer -type war -name App1 -resname account-war

RARファイルの場合

cjaddapp MyServer -type rar -name App1 -resname account-rar

フィルタの場合

cjaddapp MyServer -type filter -name App1 -warname account-war -c FilterProp.xml

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドが実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<データソース表示名> -resname）やオプション名と値を非対応にすること（例：-nameserver <データソース表示名> -resname <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

一度に複数のファイルを追加した場合，追加できないファイルがあったときでも，すべてのファイルに対して追加を試みます。一つでも追加できないファイルがあった場合，終了コードは1（異常終了）になります。

すでにアプリケーションに追加されているEJB-JARファイルと同じ表示名を持つEJB-JARファイルは，アプリケーションに追加できません。

すでにアプリケーションに追加されているWARファイルと同じ表示名を持つWARファイルは，アプリケーションに追加できません。

すでにWARファイルに追加されているフィルタまたはサーブレットと同じ表示名を持つフィルタは，WARファイルに追加できません。

すでにアプリケーションに追加されているRARファイルと同じ表示名を持つRARファイルは，アプリケーションに追加できません。

ネイティブライブラリを含むRARファイルは，アプリケーションに追加できません。

すでにJ2EEリソースアダプタとしてデプロイされているRARファイルの表示名と同じ表示名を持つRARファイルは，アプリケーションに追加できません。

-cオプションで指定するフィルタ属性ファイルは，<filter-name>および<filter-class>タグが指定されている必要があります。

EJB-JARファイル，WARファイル，およびRARファイルは，展開ディレクトリ形式のアプリケーションに追加できません。

拡張子が".jar"ではないEJB-JARファイル，拡張子が".war"ではないWARファイル，および拡張子が".rar"ではないRARファイルは，application.xmlを含まないアプリケーションに追加できません。

フィルタは，web.xmlを含まないWARファイルに追加できません。

指定したアプリケーション名が255文字より大きい場合は，エラーになります。

WARアプリケーションに対しリソース（EJB-JAR，WAR，Filter，RAR）を追加することはできません。-nameオプションにWARアプリケーションを指定した場合，このコマンドは異常終了します。

cjdeleteapp（J2EEアプリケーションの削除）

形式

アプリケーションの場合

cjdeleteapp [<サーバ名称>] [-nameserver <プロバイダURL>]
            -name <J2EEアプリケーション名>
            [-name <J2EEアプリケーション名> ...]

アプリケーションに含まれるEJB-JARファイル，WARファイル，またはRARファイルの場合

cjdeleteapp [<サーバ名称>] [-nameserver <プロバイダURL>]
            -type {ejb|war|rar} -name <J2EEアプリケーション名>
            -resname <表示名> [-resname <表示名> ...]

アプリケーション中のWARファイルに含まれるフィルタの場合

cjdeleteapp [<サーバ名称>] [-nameserver <プロバイダURL>]
            -type filter -name <J2EEアプリケーション名>
            -resname <WARファイルの表示名/フィルタの表示名>
            [-resname <WARファイルの表示名/フィルタの表示名> ...]

機能

アプリケーション，EJB-JARファイル，WARファイル，またはRARファイルの場合

J2EEアプリケーションまたはJ2EEアプリケーションに含まれるEJB-JARファイル，WARファイル，またはRARファイルを，指定されたJ2EEサーバから削除します。また，一度に複数のファイルの削除もできます。その際，指定されたファイルの順に処理されます。

J2EEアプリケーション中のWARファイルに含まれるフィルタの場合

J2EEアプリケーション中のWARファイルに含まれるフィルタを削除します。削除するフィルタは，フィルタ属性ファイルに指定します。また，一度に複数のフィルタの削除もできます。その際，指定されたフィルタの順に処理されます。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-type {ejb|war|rar|filter}

J2EEアプリケーションからEJB-JARファイル，WARファイル，またはRARファイルを削除する場合，ファイル種別を指定します。

ejb：EJB-JARファイル

war：WARファイル

rar：RARファイル

J2EEアプリケーション中のWARファイルからフィルタを削除する場合，次のファイル種別を指定します。

filter：フィルタ

-name <J2EEアプリケーション名>

削除するJ2EEアプリケーション名を指定します。

-resname <表示名>

削除するEJB-JARファイル，WARファイル，RARファイル，またはフィルタの表示名を指定します。

入力例

アプリケーションの場合

cjdeleteapp MyServer -name App1

EJB-JARファイルの場合

cjdeleteapp MyServer -name App1 -type ejb -resname accountJsp

WARファイルの場合

cjdeleteapp MyServer -name App1 -type war -resname account-war

RARファイルの場合

cjdeleteapp MyServer -name App1 -type rar -resname account-rar

フィルタの場合

cjdeleteapp MyServer -name App1 -type filter -resname account-war/account-filter

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

該当するJ2EEアプリケーションが開始状態の場合，このコマンドはエラー終了します。

指定されたJ2EEアプリケーションが存在しない場合，このコマンドはエラー終了します。

展開ディレクトリ形式のアプリケーションに対して実行した場合，J2EEサーバからアプリケーションは削除されますが，アプリケーションディレクトリは削除されません。

展開ディレクトリ形式のアプリケーションに対しては，アプリケーションに含まれるEJB-JARファイル，WARファイル，またはRARファイルの削除はできません。

一度に複数のファイルを削除した場合，削除できないファイルがあったときでも，すべてのファイルに対して削除を試みます。一つでも削除できないファイルがあった場合，終了コードは1（異常終了）になります。

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<表示名> -resname）やオプション名と値を非対応にすること（例：-nameserver <表示名> -resname <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

WARアプリケーションからWARを削除することはできません。-nameオプションにWARアプリケーションを指定した場合，このコマンドは異常終了します。

cjdeletelibjar（ライブラリJARの削除）

形式

cjdeletelibjar [<サーバ名称>] [-nameserver <プロバイダURL>]
               -name <アプリケーション名>
               -f <ライブラリJAR名> [-f <ライブラリJAR名> ...]

機能

ライブラリJARをJ2EEアプリケーションから削除します。複数のライブラリJARを指定できます。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-name <アプリケーション名>

ライブラリJARを削除するJ2EEアプリケーション名を指定します。

-f <ライブラリJAR名>

削除対象となるライブラリJAR名を指定します。一度に複数のライブラリJARを指定できます。

入力例

cjdeletelibjar MyServer -name App1 -f applib.jar

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

展開ディレクトリ形式のアプリケーションに対しては使用できません。

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<ライブラリJAR名> -f）やオプション名と値を非対応にすること（例：-nameserver <ライブラリJAR名> -f <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjexportapp（J2EEアプリケーションのエクスポート）

形式

cjexportapp [<サーバ名称>] [-nameserver <プロバイダURL>]
            -f <EARファイルのパス> -name <J2EEアプリケーション名>
            [-raw|-normal]

機能

J2EEサーバ上のJ2EEアプリケーションをEARファイルに出力します。実行時情報をEARファイルに含めることができます。

インポートしたJ2EEアプリケーションにcosminexus.xmlが含まれている場合，cosminexus.xmlを含んだ状態でエクスポートします。

インポートしたJ2EEアプリケーションにapplication.xmlが含まれていない場合は，application.xmlを含まない状態でエクスポートします。ただし，cjsetapppropコマンドまたはcjrenameappコマンドの実行でapplication.xmlが作成された場合は，application.xmlを含んだ状態でエクスポートします。application.xmlが作成される場合の説明については，cjsetapppropコマンドまたはcjrenameappコマンドを参照してください。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-f <EARファイルのパス>

-rawを指定した場合

エクスポートするJ2EEアプリケーションを含めるEARファイルのパスを指定します。

-normalを指定，または省略した場合

アプリケーションサーバのアプリケーション実行環境情報ファイル（hitachi-runtime.jar（拡張子はzip））の出力先となるファイルのパスを指定します。

-name <J2EEアプリケーション名>

エクスポートするJ2EEアプリケーション名を指定します。

-raw

EARファイルに実行時情報を含めない場合に指定します。この場合，出力EARファイルは，JavaTM 2 Platform, Enterprise Editionに準拠したものになります。

-normal

EARファイルに実行時情報を含める場合に指定します。実行時情報を含んだEARファイルは，実行時情報分だけファイルサイズが大きくなります。-rawオプション，-normalオプションのどちらも指定されていない場合，-normalオプションを指定した場合と同じになります。

入力例

cjexportapp MyServer -f App1.ear -name App1 -raw

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

J2EEアプリケーションのエクスポート時には，実行時情報やEARファイルのDDに関して注意事項があります。J2EEアプリケーションのエクスポートについては，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「8.2　J2EEアプリケーションのエクスポート」を参照してください。

指定されたJ2EEアプリケーションが存在しない場合，このコマンドはエラー終了します。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-nameserver <J2EEアプリケーション名> -name <プロバイダURL>）はできません。

J2EEアプリケーションに含まれているcosminexus.xmlの定義を変更，追加または削除した場合，cosminexus.xmlは次のようにエクスポートされます。

コメントは保持されません。

文字エンコードがUTF-8になります。

エクスポートしたアプリケーション実行環境情報ファイルやEARファイルに含まれるのはJ2EEサーバが最後に読み込みに成功したcosminexus.xmlです。

J2EEサーバがcosminexus.xmlを読み込んだあとに，アプリケーションディレクトリ内のcosminexus.xmlを変更しても，変更後の定義情報はエクスポートしたアプリケーション実行環境情報ファイルやEARファイルに含まれません。

例：展開ディレクトリ形式のJ2EEアプリケーションをインポート後に，アプリケーションディレクトリ内のcosminexus.xmlを書き換え，J2EEアプリケーションを開始しないで，そのJ2EEアプリケーションをEAR形式でエクスポートした場合，EARファイルにはインポート後に更新したアプリケーションディレクトリ内のcosminexus.xmlは含まれません。インポート時点のものと同等のcosminexus.xmlが含まれます。

WARアプリケーションのエクスポートはできません。-nameオプションにWARアプリケーションを指定した場合，このコマンドは異常終了します。

cjgencmpsql（CMP2.x Entity Bean用SQL文の生成）

形式

cjgencmpsql [サーバ名称] [-nameserver <プロバイダURL>]
            -name <アプリケーション名>
            [-resname <EJB-JARの表示名/Entity Beanの表示名>]

機能

CMP2.x Entity Bean用のSQL文を生成します。

このコマンドを実行すると次のSQL文が生成されます。

CMP2.x Entity Beanをマッピングしたテーブルを操作するSQL文

CMR用のテーブルを操作するSQL文

EJB QLから生成したSQL文

このコマンドは，CMP2.x Entity Beanに対して次のタイミングで実行する必要があります。

Bean間にCMRの関係がない場合

CMP2.x Entity Beanに対してフィールドをデータベース上のテーブルにマッピングします（cjsetapppropコマンドを使用）。

CMP2.x Entity Beanに対してこのコマンドを実行してSQL文を生成します。

Bean間にCMRの関係がある場合

CMRに関係するすべてのCMP2.x Entity Beanに対してフィールドをデータベース上のテーブルにマッピングします（cjsetapppropコマンドを使用）。

CMRに関係するすべてのCMP2.x Entity Beanに対してこのコマンドを実行してSQL文を生成します。

なお，一度SQLを生成したあとにCMRの設定を変更した場合は，デプロイをする前に，変更したCMRに関するBeanについてこのコマンドを実行してSQL文を生成する必要があります。

アプリケーションが停止状態の場合だけ実行できます。

また，展開ディレクトリ形式の場合，コマンド実行ホストと同じホストで稼働しているJ2EEサーバに対して操作できます。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-name <アプリケーション名>

アプリケーション名を指定します。

-resname <EJB-JARの表示名/Entity Beanの表示名>

SQL生成対象となるEntity Beanの表示名を指定します。

省略したときは，アプリケーションに含まれるすべてのCMP2.x Entity BeanがSQL生成対象となります。SQLの生成に失敗したCMP2.x Entity Beanがある場合でも，すべてのCMP2.x Entity Beanに対してSQLの生成を試みます。どれか一つでもSQLの生成が失敗した場合の終了コードは1となります。

入力例

cjgencmpsql MyServer -name App1 -resname EjbJar1/Ejb1

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドが実行できません。

3：

タイムアウトエラーが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-name <サーバ名>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjgetappprop（アプリケーションの属性の取得）

形式

アプリケーションの場合

cjgetappprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -name <J2EEアプリケーション名>
             [-encoding <エンコーディング名>] -c <属性ファイルパス>

EJB-JARファイル，WARファイル，またはRARファイルの場合

cjgetappprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -name <J2EEアプリケーション名> -type {ejb|war|rar}
             -resname <リソース表示名>[/<下位リソース表示名>]
             [-encoding <エンコーディング名>] -c <属性ファイルパス>

すべての情報を取得する場合

cjgetappprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -name <J2EEアプリケーション名> -type all
             [-encoding <エンコーディング名>] -c <属性ファイルパス>

機能

アプリケーション，またはそれぞれに含まれるリソース（EJB-JARファイルの場合：EJB-JARファイル，Session Bean，Entity Bean，Message-driven Bean，WARファイルの場合：WARファイル，サーブレット／JSP，フィルタ）の属性，またはRARファイルの属性を取得して，属性ファイルを生成します。

J2EEアプリケーションとリソースの設定で使用する属性ファイルについては，次の個所を参照してください。

マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.　J2EEアプリケーションの設定で使用する属性ファイル」

マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.　リソースの設定で使用する属性ファイル」

展開ディレクトリ形式の場合，コマンド実行ホストと同じホストで稼働しているJ2EEサーバに対して操作できます。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-name <J2EEアプリケーション名>

取得対象のJ2EEアプリケーション名を指定します。

-type {ejb|war|rar|all}

取得するリソースの種別を指定します。

ejb：EJB-JARファイルまたはEJB-JARファイル内のEJBファイル

war：WARファイル，WARファイル内のサーブレット／JSPまたは，フィルタ

rar：RARファイル

all：すべての情報

-resname <リソース表示名>

取得対象となるリソースの表示名を指定します。

ejb-jar：<EJB-JARファイルの表示名>

ejb：<EJB-JARファイルの表示名>[/<Enterprise Beanの表示名>]

war：<WARファイルの表示名>

rar：<RARファイルの表示名>

Servlet/JSP：<WARファイルの表示名>[/<サーブレット／JSPの表示名>]

filter：<WARの表示名>[/<フィルタの表示名>]

なお，下位リソース表示名を指定しなかった場合は，それぞれEJB-JARファイル，またはWARファイルの指定となります。

-encoding <エンコーディング名>

属性ファイル出力時のエンコーディング名を指定します。指定できるエンコーディング名を次に示します。

UTF8

UTF-8

ASCII

US-ASCII

ISO-8859-1

EUC_JP

Shift_JIS

SJIS

windows-31j

MS932

JavaVMがサポートしているエンコーディング名

省略した場合は，JavaVMのデフォルトエンコーディング名を使用します。使用されたエンコーディング名を確認するには，このコマンドで取得した属性ファイルの先頭行のXML宣言部分を参照してください。

<?xml version="<XML規格のバージョン番号>" encoding="<エンコーディング名>"?>

-c <属性ファイルパス>

属性ファイルの出力先パスを指定します。

入力例

アプリケーションの場合

cjgetappprop MyServer -name App1 -encoding Shift_JIS -c App1Prop.xml

EJB-JARファイルの場合

cjgetappprop MyServer -name App1 -type ejb -resname accountJsp/MyAccount -encoding UTF-8 -c MyAccountProp.xml

WARファイルの場合

cjgetappprop MyServer -name App1 -type war -resname account-war/Account -c AccountProp.xml

RARファイルの場合

cjgetappprop MyServer -name App1 -type rar -resname account-rar -c AccountProp.xml

すべての情報を取得する場合

cjgetappprop MyServer -name App1 -type all -encoding Shift_JIS -c App1AllProp.xml

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<J2EEアプリケーション名> -name）やオプション名と値を非対応にすること（例：-name ejb -type <J2EEアプリケーション名>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

指定したパスにすでに属性ファイルが存在する場合，上書きします。

cjgetstubsjar（アプリケーションのRMI-IIOPスタブおよびインタフェースの取得）

形式

cjgetstubsjar [<サーバ名称>] [-nameserver <プロバイダURL>]
              -name <アプリケーション名>
              -d <スタブおよびインタフェース格納先ディレクトリパス>

機能

J2EEアプリケーションのRMI-IIOPスタブおよびインタフェースを取得します。このコマンドは，アプリケーションの状態（停止状態，開始状態）に関係なく，実行できます。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-name <アプリケーション名>

RMI-IIOPスタブおよびインタフェースを取得するJ2EEアプリケーション名を指定します。

-d <スタブおよびインタフェース格納先ディレクトリパス>

RMI-IIOPスタブおよびインタフェースを格納するディレクトリのパスを指定します。指定したディレクトリ下に，次のファイルが作成されます。

stubs.jar（RMI-IIOPスタブのファイル名）

?.jar（RMI-IIOPインタフェースのファイル名）

?には，１からの連番が付与されます。

例えば，インタフェースが三つある場合，1.jar，2.jar，3.jarになります。

入力例

cjgetstubsjar MyServer -name App1 -d temp

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<アプリケーション名> -name）やオプション名と値を非対応にすること（例：-nameserver <アプリケーション名> -name <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

指定したパスにすでにファイルが存在する場合，ファイルは上書きされます。

指定したパスが存在しない場合，エラーになります。

アプリケーションが停止状態で取得したRMI-IIOPスタブおよびインタフェースは，最新の状態ではない可能性があります。

-nameオプションで指定したアプリケーションが一度も開始されていない場合，エラーになります。

J2EEアプリケーション内に，リモートインタフェースを持つEnterprise Beanが存在しない場合，エラーになります。

次のJ2EEアプリケーションでは，WebブラウザからRMI-IIOPスタブおよびインタフェースを取得することはできません。このコマンドで取得してください。

旧バージョンでエクスポートしたJ2EEアプリケーションをインポートしている場合。

新規に作成した場合。

cjrenameappコマンドでアプリケーション名称を変更した場合。

推奨モードまたはV9互換モードで取得したJ2EEアプリケーションのRMI-IIOPスタブ，およびインタフェースは別のモードでは使用できません。

cjimportapp（J2EEアプリケーションのインポート）

形式

アーカイブ形式のアプリケーションをインポートする場合

cjimportapp [<サーバ名称>] [-nameserver <プロバイダURL>]
            [-nodelete]
            -f <EARファイルのパス> [-f <EARファイルのパス>...]

展開ディレクトリ形式のアプリケーションとしてインポートする場合（アプリケーションディレクトリ）

cjimportapp [<サーバ名称>] [-nameserver <プロバイダURL>]
            -a <アプリケーションディレクトリパス>

展開ディレクトリ形式のアプリケーションとしてインポートする場合（標準のアプリケーションファイル（拡張子.ear）またはアプリケーションサーバのアプリケーション実行環境情報ファイル（拡張子.zip））

cjimportapp [<サーバ名称>] [-nameserver <プロバイダURL>]
            [-nodelete] -f <EARファイルのパス>
            -d <展開ディレクトリパス>

機能

指定されたJ2EEサーバにJ2EEアプリケーションをインポートします。なお，cosminexus.xmlを含むJ2EEアプリケーションをインポートした場合，cosminexus.xmlもインポートされます。

実行時情報を含んだEARファイルをインポートした場合，インポートしたJ2EEアプリケーションの実行時情報は，エクスポートしたときのJ2EEアプリケーションの実行時情報と同じになります。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-nodelete

実行時情報を含むEARファイルをインポートする場合，開始処理などに失敗したアプリケーションを削除しないときに指定します。

このオプションを省略した場合，インポート後の開始処理などに失敗するとインポートしたアプリケーションは削除されます。

-f <EARファイルのパス>

インポートするJ2EEアプリケーションを含むEARファイルのパスを指定します。一度に複数のEARファイルの指定もできます。

-a <アプリケーションディレクトリパス>

アプリケーションディレクトリのパスを指定します。

-d <展開ディレクトリパス>

アプリケーションを展開するサーバ側のディレクトリのフルパスを指定します。J2EEサーバを起動したユーザに対して展開先ディレクトリの書き込み権限が必要です。

入力例

アーカイブ形式のアプリケーションをインポートする場合

cjimportapp MyServer -f App1.ear

アプリケーションディレクトリを展開ディレクトリ形式のアプリケーションとしてインポートする場合

cjimportapp MyServer -a AppDirPath

標準のアプリケーションファイル（拡張子.ear）またはアプリケーションサーバのアプリケーション実行環境情報ファイル（拡張子.zip）を展開ディレクトリ形式のアプリケーションとしてインポートする場合

Windowsのとき

cjimportapp MyServer -f App1.zip -d C:¥extractdir¥ApplicationDir

UNIXのとき

cjimportapp MyServer -f App1.zip -d /extractdir/ApplicationDir

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

8：

実行時情報エラーが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

-dオプションを使用して，EARファイルまたはZIPファイルを展開して作成されたアプリケーションディレクトリが，次の条件のどれかと一致する場合，-aオプションでインポートして展開ディレクトリ形式のアプリケーションディレクトリとして使用できません。

EJB-JARのモジュール名が".jar"で終わっていない。

WARのモジュール名が".war"で終わっていない。

モジュールの拡張子を除いた名称が，ほかのモジュールの拡張子を除いた名称と重複している。

モジュールの拡張子を除いた名称が，EARファイル内のディレクトリ名称と重複している。

application.xmlの<display-name>タグを設定していない場合，または<display-name>タグに空文字を設定している場合，J2EEアプリケーションの表示名にファイル名またはディレクトリ名が使用されます。なお，ファイル名またはディレクトリ名に汎用文字，半角英数字以外の文字が含まれている場合，その文字はアンダースコア"_"に置き換えられます。

application.xmlを省略した場合，J2EEアプリケーションの表示名は次のように変換されます。

EARファイルのときは，ファイル名から拡張子を除いた文字列。ただしピリオド(.)が最初にだけ現れるファイル名の場合，拡張子は除かれません。

アプリケーションディレクトリのときは，アプリケーションディレクトリ名。

なお，変換された表示名に半角英数文字(0〜9, A〜Z, a〜z)，アンダースコア(_)以外の文字の文字がある場合，その文字はアンダースコア(_)に置き換えられます。

アプリケーションディレクトリを指定して展開ディレクトリ形式のアプリケーションをインポートする場合，インポートするJ2EEアプリケーションにapplication.xmlが存在するときはapplication.xmlの<module>タグで指定したパス名から拡張子を省いた名称がEJB-JARディレクトリ名およびWARディレクトリ名になります。また，インポートするJ2EEアプリケーションにapplication.xmlが存在しないときはEJB-JARディレクトリ名の最後は"_jar"，WARディレクトリ名の最後は"_war"になります。

同じアプリケーション名を持つJ2EEアプリケーションが，インポート先のJ2EEサーバにすでに存在する場合，このコマンドはエラー終了します。

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-nameserver <EARファイルのパス> -f <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

J2EEアプリケーションのインポート時には，このほかにも注意事項があります。J2EEアプリケーションのインポートについては，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「8.1　J2EEアプリケーションのインポート」を参照してください。

インポートするアプリケーションのアプリケーション名が255文字より大きい場合はエラーとなります。

引数に指定したファイルサイズの約3倍のJavaヒープを一時的に使用します。ファイルサイズを3倍にした値がJ2EEサーバのJavaヒープの見積もり値を超える場合は，ファイルサイズの3倍の値をJ2EEサーバのJavaヒープのサイズに指定する必要があります。

cjimportlibjar（ライブラリJARのインポート）

形式

cjimportlibjar [<サーバ名称>] [-nameserver <プロバイダURL>]
               -name <アプリケーション名> -f <ライブラリJARファイルパス>
               [-f <ライブラリJARファイルパス> ...]

機能

J2EEアプリケーションにライブラリJARをインポートします。また，一度に複数のファイルのインポートもできます。ライブラリJARのインポート先はJ2EEアプリケーションのルート直下です。

ライブラリJARについては，マニュアル「アプリケーションサーバ システム設計ガイド」の「2.3.3　J2EEアプリケーションとJ2EEコンポーネント」を参照してください。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-name <アプリケーション名>

ライブラリJARをインポートするアプリケーション名を指定します。

-f <ライブラリJARファイルパス>

読み込み対象となるライブラリJARファイルのパスを指定します。

入力例

cjimportlibjar MyServer -name App1 -f applib.jar

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

すでにインポートされているライブラリJARと同じファイル名を持つライブラリJARをインポートすることはできません。

展開ディレクトリ形式のアプリケーションに対しては使用できません。

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<ライブラリJARファイルパス> -f）やオプション名と値を非対応にすること（例：-nameserver <ライブラリJARファイルパス> -f <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

WARアプリケーションに対してライブラリJARをインポートすることはできません。-nameオプションにWARアプリケーションを指定した場合，このコマンドは異常終了します。

引数に指定したファイルサイズの約3倍のJavaヒープを一時的に使用します。ファイルサイズを3倍にした値がJ2EEサーバのJavaヒープの見積もり値を超える場合は，ファイルサイズの3倍の値をJ2EEサーバのJavaヒープのサイズに指定する必要があります。

cjimportwar（WARアプリケーションのインポート）

形式

アーカイブ形式のWARアプリケーションをインポートする場合

cjimportwar [<サーバ名称>] [-nameserver <プロバイダURL>]

-f <WARファイルのパス> [-name <アプリケーション名>]

[-contextroot <コンテキストルート>]

[-c <cosminexus.xmlファイル>]

展開ディレクトリ形式のWARアプリケーションとしてインポートする場合（WARディレクトリ）

cjimportwar [<サーバ名称>] [-nameserver <プロバイダURL>]

-a <WARディレクトリパス> [-name <アプリケーション名>]

[-contextroot <コンテキストルート>]

[-c <cosminexus.xmlファイル>]

機能

指定されたJ2EEサーバにWARアプリケーションをインポートします。なお，WARアプリケーションのインポートで，-cオプションで指定したパスにあるcosminexus.xmlを読み込みます。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-f <WARファイルのパス>

インポートするWARファイルのパスを指定します。

-a <WARディレクトリパス>

WARディレクトリのパスを指定します。

-name <アプリケーション名>

アプリケーション名を1文字以上で指定します。

アプリケーション名には，英数字（0〜9，A〜Z，a〜z）または次の特殊文字が使用できます。

プラス（+），ハイフン（-），ピリオド（.），キャレット（^），アンダースコア（_）

-nameオプションを省略した場合，J2EEサーバはWARファイル名，またはWARディレクトリ名を基に，使用できない文字をアンダースコア(_)に置き換えてアプリケーション名を設定します。なお，J2EEサーバが設定したアプリケーション名がJ2EEサーバ内で重複する場合，アプリケーション名がJ2EEサーバ内で一意となるように，そのアプリケーション名の末尾に通し番号（1〜2147483647）が追加されます。

-contextroot <コンテキストルート>

コンテキストルートを指定します。

コンテキストルートには，URI（RFC3986）で使用できる文字が使用できます。ただし，ejb/，web/，/ejb/，および/web/が先頭となる文字列を指定することはできません。

ルートを指定する場合は，空文字列またはスラッシュ（/）を指定します。

-contextrootオプションを省略した場合，web.xmlのdefault-context-pathタグに指定した値が適用されます。値が指定されていない場合は，J2EEサーバはWARファイル名，またはWARディレクトリ名を基に，使用できない文字をアンダースコア(_)に置き換えてコンテキストルートを設定します。ただし，WARファイルから拡張子を取り除いた文字列，またはWARディレクトリ名がejb，webの場合，それぞれejb1，web1に変換します。

-c <cosminexus.xmlファイル>

cosminexus.xmlファイルのパスを指定します。なお，cosminexus.xmlファイルのファイル名はすべて小文字の「cosminexus.xml」です。

cosminexus.xmlファイルのパスを省略したときは，cosminexus.xmlファイルは読み込まれません。

入力例

アーカイブ形式のWARアプリケーションをインポートする場合

cjimportwar MyServer -f WarApp1.war -name WarApp1 -contextroot app1/appwar -c cosminexus.xml

WARディレクトリを展開ディレクトリ形式のアプリケーションとしてインポートする場合

cjimportwar MyServer -a WarAppDirPath -name WarApp1 -contextroot app1/appwar -c cosminexus.xml

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

8：

実行時情報エラーが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-nameserver <WARファイルのパス> -f <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

同じアプリケーション名を持つJ2EEアプリケーションが，インポート先のJ2EEサーバにすでに存在する場合，このコマンドはエラー終了します。ただし，-nameオプションを省略した場合は，アプリケーションの末尾に通し番号を追加したアプリケーション名でインポートされます。

インポートするアプリケーションのアプリケーション名が255文字より大きい場合はエラーとなります。

cjlistapp（アプリケーションの一覧表示）

形式

すべてのアプリケーションの場合

cjlistapp [<サーバ名称>] [-nameserver <プロバイダURL>]

アプリケーションに含まれるEJB-JARファイルまたはWARファイルの場合

cjlistapp [<サーバ名称>] [-nameserver <プロバイダURL>]
          -name <J2EEアプリケーション名> -type {ejb|war}
          [-resname <表示名>]

アプリケーションに含まれるRARファイルの場合

cjlistapp [<サーバ名称>] [-nameserver <プロバイダURL>]
          -name <J2EEアプリケーション名> -type rar
          [-spec | -resname <表示名> -outbound| -resname <表示名> -inbound| -resname <表示名> -listenertype <メッセージリスナのタイプ名>]

機能

すべてのアプリケーションの場合

すべてのJ2EEアプリケーションの名称，状態，およびモードの一覧を標準出力に出力します。展開ディレクトリ形式のアプリケーションの場合，アプリケーションディレクトリのパスも標準出力に出力します。また，WARアプリケーションの場合，コンテキストルートを標準出力に出力します。

アプリケーションに含まれるEJB-JARファイルまたはWARファイルの場合

J2EEアプリケーションに含まれるEJB-JARファイルまたはWARファイルの一覧を標準出力に出力します。

-resnameを指定すると，EJB-JARファイルに含まれるリソース（Session Bean，Entity Bean，Message-driven Bean）の一覧，またはWARファイルに含まれるリソース（サーブレット／JSP，フィルタ）の一覧を標準出力に出力します。

アプリケーションに含まれるRARファイルの場合

J2EEアプリケーションに含まれるRARファイルの一覧を標準出力に出力します。

-specを指定すると，RARファイルのコネクタアーキテクチャの仕様バージョンを標準出力に出力します。

Connector 1.5のリソースアダプタで，-resnameと-outboundを指定すると，RARファイルに含まれるOutboundリソースアダプタのコネクション定義識別子の一覧を標準出力に出力します。Connector 1.0のリソースアダプタでは，-resnameと-outboundは指定できません。

Connector 1.5のリソースアダプタで，-resnameと-inboundを指定すると，RARファイルに含まれる，Inboundリソースアダプタのメッセージリスナのタイプの一覧を標準出力に出力します。Connector 1.0のリソースアダプタでは，-resnameと-inboundは指定できません。

Connector 1.5のリソースアダプタで，-resnameと-listenertypeを指定すると，指定したメッセージリスナのアクティブ化のために設定が必要なプロパティ名の一覧を標準出力に出力します。Connector 1.0のリソースアダプタでは，-resnameと-listenertypeは指定できません。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-name <J2EEアプリケーション名>

J2EEアプリケーション名を指定します。

-type {ejb|war|rar}

表示対象となるリソースの種別を指定します。

ejb：EJB-JARファイル

war：WARファイル

rar：RARファイル

-resname <表示名>

表示対象となるリソース（EJB-JARファイル，WARファイル，またはRARファイル）の表示名を指定します。

-spec

コネクタアーキテクチャのバージョンを表示する場合に指定します。

次のどちらかのコネクタアーキテクチャのバージョンが表示されます。

Connector 1.0

Connector 1.5

-outbound

RARファイルに含まれるOutboundリソースアダプタのコネクション定義識別子を表示する場合に，-resnameとともに指定します。

-inbound

RARファイルに含まれるInboundリソースアダプタのメッセージリスナのタイプを表示する場合に，-resnameとともに指定します。

-listenertype <メッセージリスナのタイプ名>

指定したメッセージリスナのアクティブ化のために設定が必要なプロパティ名を表示する場合に，-resnameとともに指定します。

入力例

すべてのアプリケーションの場合

cjlistapp MyServer

EJB-JARファイルの場合

cjlistapp MyServer -name App1 -type ejb

WARファイルの場合

cjlistapp MyServer -name App1 -type war -resname account-war

RARファイルの場合

cjlistapp MyServer -name App1 -type rar

出力形式

すべてのJ2EEアプリケーションの場合

<J2EEアプリケーションの状態> <J2EEアプリケーションのモード> <J2EEアプリケーション名> (path=<アプリケーションディレクトリのパス>)※
<J2EEアプリケーションの状態> <J2EEアプリケーションのモード> <J2EEアプリケーション名> (path=<アプリケーションディレクトリのパス>)※
・・・

<J2EEアプリケーションの状態>
running：開始状態
stopped：停止状態
stopFailure：通常停止失敗状態
forceStopFailure：強制停止失敗状態
blockadeFailure：閉塞失敗状態
blockading：閉塞中
blockade：閉塞状態
stopping：通常停止中
forceStopping：強制停止中

<J2EEアプリケーションのモード>
test：テストモード（旧バージョンとの互換用のモード）で動作
（空白）：通常モードで動作

注※　path=<アプリケーションディレクトリのパス>の情報は，展開ディレクトリ形式のアプリケーションのときだけ出力されます。アーカイブ形式のアプリケーションのときには出力されません。

EJB-JARファイルの場合（-resname指定なし）

<EJB-JARファイルの表示名>
<EJB-JARファイルの表示名>
・・・

EJB-JARファイルの場合（-resname指定あり）

<Enterprise Beanの表示名>
<Enterprise Beanの表示名>
・・・

WARファイルの場合（-resname指定なし）

<WARファイルの表示名>
<WARファイルの表示名>
・・・

WARファイルの場合（-resname指定あり）

<サーブレット／JSP，フィルタの表示名>
<サーブレット／JSP，フィルタの表示名>
・・・

RARファイルの場合（-resnameおよび-spec指定なし）

<RARファイルの表示名>
<RARファイルの表示名>
・・・

RARファイルの場合（-spec指定あり）

<コネクタアーキテクチャの仕様バージョン> <RARファイルの表示名>
<コネクタアーキテクチャの仕様バージョン> <RARファイルの表示名>
・・・

RARファイルの場合（-resnameおよび-outbound指定あり）

<コネクション定義識別子>
<コネクション定義識別子>
・・・

RARファイルの場合（-resnameおよび-inbound指定あり）

<メッセージリスナのタイプ>
<メッセージリスナのタイプ>
・・・

RARファイルの場合（-resnameおよび-listenertype指定あり）

<プロパティ名>
<プロパティ名>
・・・

戻り値

0：

正常終了しました。

1：

異常終了しました。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<J2EEアプリケーション名> -name）やオプション名と値を非対応にすること（例：-name ejb -type <J2EEアプリケーション名>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

一覧は大文字小文字の区別なしで，昇順でソートされます。

cjlistlibjar（ライブラリJARの一覧表示）

形式

cjlistlibjar [<サーバ名称>] [-nameserver <プロバイダURL>]
             -name <アプリケーション名>

機能

J2EEアプリケーションに含まれるライブラリJARの一覧を標準出力に出力します。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-name <アプリケーション名>

J2EEアプリケーション名を指定します。

入力例

cjlistlibjar MyServer -name App1

出力形式

<ライブラリJAR名>
<ライブラリJAR名>
・・・

戻り値

0：

正常終了しました。

1：

異常終了しました。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<アプリケーション名> -name）やオプション名と値を非対応にすること（例：-nameserver <アプリケーション名> -name <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

一覧は大文字小文字の区別なしで，昇順でソートされます。

cjreloadapp（アプリケーションのリロード）

形式

cjreloadapp [<サーバ名称>] [-nameserver <プロバイダURL>]
            -name <アプリケーション名>
            [-t <強制リロード開始までのタイムアウト時間>]

機能

アプリケーションを停止しないで，構成するクラスおよびJSPを入れ替えます。

入れ替え後のアプリケーションに引き継がれるセッション情報の詳細については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「18.8.8　Webアプリケーションのリロード」を参照してください。

展開ディレクトリを使用し，開始状態およびリロードに失敗して停止状態にあるアプリケーションだけに実行できます。

このコマンドを実行する場合は，J2EEサーバ側のユーザプロパティファイル（usrconf.properties）にejbserver.deploy.context.reload_scopeプロパティを指定しておく必要があります。ユーザプロパティファイル（usrconf.properties）の詳細については，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「2.2.3　usrconf.properties（J2EEサーバ用ユーザプロパティファイル）」を参照してください。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-name <アプリケーション名>

アプリケーション名を指定します。

-t <強制リロード開始までのタイムアウト時間>

コマンドを実行してから強制リロード開始までの待ち時間（秒）を指定します。

0〜2147483647の整数です。

0を指定した場合は，構成するクラスおよびJSPの入れ替え処理が終了するまでクライアントへ応答は返りません。強制リロード開始までの待ち時間（秒）を指定しなかった場合は，強制リロードを実行しません。

入力例

cjreloadapp MyServer -name App1

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドが実行できません。

3：

タイムアウトエラーが発生しました。

4：

閉塞失敗しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<アプリケーション名> -name）やオプション名と値を非対応にすること（例：-nameserver <アプリケーション名> -name <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

J2EEアプリケーションの停止処理が-tオプションで指定した時間内に終了しなかった場合，サーバ管理コマンド用システムプロパティファイルのejbserver.rmi.request.timeoutキーで指定した時間で強制終了します。

J2EEアプリケーションにcosminexus.xmlが含まれている場合，cosminexus.xmlの定義情報は読み込まれません。

cjrenameapp（アプリケーション名の変更）

形式

cjrenameapp [<サーバ名称>] [-nameserver <プロバイダURL>]
            -name <アプリケーション名> -newname <変更後アプリケーション名>

機能

指定したJ2EEアプリケーションの名称を変更します。

アプリケーションの名前を変更することによって，アプリケーションの世代管理やバージョン管理ができます。

なお，application.xmlを省略したアプリケーションの名前を変更した場合，application.xmlが作成されます。そのため，アプリケーション名を変更したJ2EEアプリケーションはapplication.xmlを含むアプリケーションになります。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-name <アプリケーション名>

名称を変更するJ2EEアプリケーション名を指定します。

-newname <変更後アプリケーション名>

変更後のJ2EEアプリケーション名を1文字以上で指定します。

アプリケーション名には，英数字（0〜9，A〜Z，a〜z）または次の特殊文字を使用できます。

プラス（+），ハイフン（-），ピリオド（.），キャレット（^），アンダースコア（_）

入力例

cjrenameapp MyServer -name App1 -newname App2

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<アプリケーション名> -name）やオプション名と値を非対応にすること（例：-nameserver <アプリケーション名> -name <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

このコマンドを実行する場合，名称変更の対象となるアプリケーションは停止している必要があります。

アプリケーション名称を変更した場合，lookup名称も変更されるのでlookup名称を使用しているEJBクライアントやネーミング切り替え機能などでパスを通している場合は，修正が必要となります。

旧バージョンで作成されたアプリケーションについても，アプリケーション名を変更できます。

<アプリケーション名>と<変更後アプリケーション名>に同じ名前を指定した場合，正常に処理されますが，アプリケーション名は変わりません。

指定したアプリケーション名が255文字より大きい場合はエラーとなります。

WARアプリケーションの名前を変更することはできません。-nameオプションにWARアプリケーションを指定した場合，このコマンドは異常終了します。

cjreplaceapp（アプリケーションの入れ替え）

形式

cjreplaceapp [<サーバ名称>] [-nameserver <プロバイダURL>]
             -name <アプリケーション名> -f <ファイルパス>
             [-t <タイムアウト時間>] [-replaceDD]

機能

J2EEアプリケーションを入れ替えます。

入れ替え後のJ2EEアプリケーションがcosminexus.xmlを含む場合，入れ替え前のアプリケーションサーバ独自の定義情報を破棄してデフォルト値に戻してから，cosminexus.xmlの定義情報で上書きします。入れ替え後のJ2EEアプリケーションがcosminexus.xmlを含まない場合，入れ替え前のJ2EEアプリケーションからアプリケーションサーバ独自の定義情報を引き継ぎます。

注意事項

WARアプリケーションの場合，cosminexus.xmlの再読み込みを実行しないため，インポートのときの設定を引き継ぎ，定義情報の更新は実行されません。

このコマンドは，アプリケーションの状態（停止状態，開始状態）に関係なく実行できます。アプリケーションが開始されている場合，アプリケーション中のメソッドの終了を待ってアプリケーションを停止して入れ替え処理をしたあと，アプリケーションを開始します。ただし，-tオプションで指定された時間が経過しても停止処理が終了していない場合，アプリケーションは強制停止します。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-name <アプリケーション名>

入れ替えるアプリケーション名を指定します。

-f <ファイルパス>

読み込み対象となるアプリケーションファイルのパスを指定します。

このオプションで指定するアプリケーションファイルは標準のアプリケーションファイル（拡張子.ear）またはWARファイル（拡張子.war）を指定します。

-t <タイムアウト時間>

コマンドを実行してから応答が返る時間を，0〜2147483647までの整数（単位：秒）で指定します。0を指定した場合は，開始状態のアプリケーションの停止処理が終了するまでクライアントへ応答が返りません。

指定がない場合は60秒が設定されます。

-replaceDD

入れ替え前のアプリケーションのDDファイル（application.xml，ejb-jar.xml，ra.xml，web.xml）の定義を，入れ替え後のアプリケーションに引き継がない場合に指定します。

入力例

cjreplaceapp MyServer -name App1 -f App1.ear

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

展開ディレクトリ形式のアプリケーションに対しては使用できません。

DDファイル（application.xml，ejb-jar.xml，web.xml）のどれかが「なし」から「あり」に，または「あり」から「なし」になった場合，J2EEアプリケーションの入れ替えはできません。

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<ファイルパス> -file）やオプション名と値を非対応にすること（例：-nameserver <ファイルパス> -file <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

アプリケーションサーバのアプリケーション実行環境情報ファイル（拡張子.zip）を指定した場合，エラーになります。

-nameに指定されたアプリケーション名とアプリケーションファイル内のDDファイル（application.xml）の<display-name>タグに指定されたアプリケーション名が異なる場合，エラーになります。

入れ替え前と入れ替え後のJ2EEアプリケーションの構成に次のような違いがあった場合，エラーになります。

J2EEアプリケーション内のEJB-JAR，リソースアダプタ，WARの数が異なる場合。

J2EEアプリケーション内のEJB-JARファイル，RARファイル，WARファイルの名称が異なる場合。

-replaceDDを指定した場合に，DDファイル（application.xml，ejb-jar.xml，ra.xml，web.xml）の定義が異なるとき。

EJB-JARファイル内のホームインタフェース，コンポーネントインタフェースのメソッド定義が異なる場合。

EJB-JARファイル内のホームインタフェース（ローカル，リモート），コンポーネントインタフェース（ローカル，リモート），ビジネスインタフェース（ローカル，リモート）のメソッド定義が異なる場合。

設定しているアノテーションの値を変更した場合。

J2EEアプリケーションの停止処理が-tオプションで指定した時間内に終了しなかった場合，サーバ管理コマンド用システムプロパティファイルのejbserver.rmi.request.timeoutキーで指定した時間で強制終了します。

デフォルトでは，J2EEアプリケーションのすべての属性情報を引き継ぎます。ランタイム属性※だけを引き継ぎたい場合は，-replaceDDオプションを指定してコマンドを実行します。

注※

属性ファイルには，DDファイル（application.xml，ejb-jar.xml，ra.xml，web.xml）の定義と属性ファイル独自の定義を設定できます。属性ファイル独自の定義のことを，ランタイム属性といいます。

入れ替え後のJ2EEアプリケーションが，cosminexus.xmlを含んでいて，CMP2.0を利用する場合，J2EEアプリケーションが停止状態のときにこのコマンドを実行してください。また，このコマンドを実行した後，デプロイ前にcjgencmpsqlコマンドを実行する必要があります。

-nameオプションに指定したJ2EEアプリケーションの種別と-fオプションに指定したファイルの種別が異なる場合はエラーになります。

引数に指定したファイルサイズの約3倍のJavaヒープを一時的に使用します。ファイルサイズを3倍にした値がJ2EEサーバのJavaヒープの見積もり値を超える場合は，ファイルサイズの3倍の値をJ2EEサーバのJavaヒープのサイズに指定する必要があります。

cjsetappprop（アプリケーションの属性設定）

形式

アプリケーションの場合

cjsetappprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -name <J2EEアプリケーション名> -c <属性ファイルパス>

EJB-JARファイル，WARファイル，またはRARファイルの場合

cjsetappprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -name <J2EEアプリケーション名> -type {ejb|war|rar}
             -resname <リソース表示名>[/<下位リソース表示名>]
             -c <属性ファイルパス>

すべての情報を設定する場合

cjsetappprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -name <J2EEアプリケーション名> -type all
             -c <属性ファイルパス>

機能

アプリケーション，EJB-JARファイルに含まれるリソース（EJB-JARファイル，Session Bean，Entity Bean，Message-driven Bean），WARファイルに含まれるリソース（WARファイル，サーブレット／JSP，フィルタ），またはRARファイルの属性を指定したアプリケーション属性ファイルの値に変更します。

下位リソース表示名が指定されない場合はEJB-JARファイル，またはWARファイルの指定になります。

J2EEアプリケーションとリソースの設定で使用する属性ファイルについては，次の個所を参照してください。

マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.　J2EEアプリケーションの設定で使用する属性ファイル」

マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.　リソースの設定で使用する属性ファイル」

展開ディレクトリ形式の場合，コマンド実行ホストと同じホストで稼働しているJ2EEサーバに対して操作できます。

cosminexus.xmlを含むアプリケーションのアプリケーションサーバ独自の定義情報がこのコマンドで変更，追加または削除された場合，アプリケーションに含まれるcosminexus.xmlが更新されます。なお，変更，追加または削除されるアプリケーションが展開ディレクトリ形式の場合，アプリケーションディレクトリ内のcosminexus.xmlが更新されます。アプリケーションサーバ独自の定義情報については，マニュアル「アプリケーションサーバリファレンス 定義編(アプリケーション／リソース定義)」の「2.　アプリケーション属性ファイル（cosminexus.xml）」を参照してください。

application.xmlを含まないアプリケーションに対して，次のタグの値を変更した場合，application.xmlが作成されます。

アプリケーション属性ファイル

<hitachi-application-property> - <description>

<hitachi-application-property> - <icon> - <small-icon>

<hitachi-application-property> - <icon> - <large-icon>

WAR属性ファイル

<hitachi-war-property> - <war-runtime> - <context-root>

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-name <J2EEアプリケーション名>

設定対象のJ2EEアプリケーション名を指定します。

-type {ejb|war|rar|all}

設定するリソースの種別を指定します。

ejb：EJB-JARファイルまたはEJB-JARファイル内のEJBファイルを設定

war：WARファイルまたはWARファイル内のサーブレット／JSPを設定

rar：RARファイルを設定

all：すべての情報を設定

-resname <リソース表示名>

設定対象となるリソースの表示名を指定します。

EJB-JARファイルの場合：<EJB-JARファイルの表示名>

EJBファイルの場合：<EJB-JARファイルの表示名>[/<Enterprise Beanの表示名>]

WARファイルの場合：<WARファイルの表示名>

サーブレット／JSPの場合：<WARファイルの表示名>[/<サーブレット／JSPの表示名>]

フィルタの場合：<WARの表示名>[/<フィルタの表示名>]

RARファイルの場合：<RARファイルの表示名>

-c <属性ファイルパス>

属性ファイルの入力元パスを指定します。

入力例

アプリケーションの場合

cjsetappprop MyServer -name App1 -c App1Prop.xml

EJB-JARファイルの場合

cjsetappprop MyServer -name App1 -type ejb -resname accountJsp/MyAccount -c MyAccountProp.xml

WARファイルの場合

cjsetappprop MyServer -name App1 -type war -resname account-war/Account -c AccountProp.xml

RARファイルの場合

cjsetappprop MyServer -name App1 -type rar -resname account-rar -c AccountProp.xml

すべての情報を設定する場合

cjsetappprop MyServer -name App1 -type all -c App1AllProp.xml

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<J2EEアプリケーション名> -name）やオプション名と値を非対応にすること（例：-name ejb -type <J2EEアプリケーション名>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

指定したJ2EEアプリケーション，またはリソースは存在している必要があります。

-typeオプションでallを指定した場合，指定したアプリケーション属性ファイル内のリソースの表示名で変更対象とするリソースが決定します。そのため，リソースの表示名を変更することはできません。

DDファイル（ejb-jar.xml）の<security-role-ref>-<role-link>タグを設定している場合，EJB-JAR属性ファイルを設定すると，DDファイル（ejb-jar.xml）の<security-role-ref>-<role-link>タグの値がクリアされることがあります。

cjstartapp（J2EEアプリケーションの開始）

形式

cjstartapp [<サーバ名称>] [-nameserver <プロバイダURL>]
           -name <J2EEアプリケーション名> [-jspc]

機能

J2EEアプリケーションを開始して，クライアントからのリクエストを受け取ることができるようにします。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-name <J2EEアプリケーション名>

開始するJ2EEアプリケーション名を指定します。

-jspc

この引数を指定すると，JSPの事前コンパイルが実行されます。既存のWebアプリケーションに対してJSPの事前コンパイルを実行したあと，アプリケーションを開始する場合に指定してください。JSPの事前コンパイルでエラーが発生してもアプリケーションの開始は実行されます。

入力例

cjstartapp MyServer -name App1

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

指定されたJ2EEアプリケーションが存在しない場合，このコマンドはエラー終了します。

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-nameserver <J2EEアプリケーション名> -name <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

-jspcオプションを指定する場合は，次のことに注意してください。

-jspcオプションを指定すると，Webアプリケーションに含まれるすべてのJSPファイルがコンパイルされるため，コンパイル不要なJSPファイルがコンパイルされてエラーになる場合があります。アプリケーション開始時のJSP事前コンパイルでコンパイルエラーが発生した場合でも，cjstartappコマンドは処理を続行します。

アーカイブ形式のアプリケーションの場合，アプリケーションの開始に失敗すると，アプリケーションは停止状態になり，JSPコンパイル結果は削除されます。そのため，あらかじめアプリケーションが開始できる状態であることを確認してください。

アプリケーション開始時のJSP事前コンパイルを実行すると，アプリケーションに含まれるJSPの数によっては，cjstartappコマンドの通信タイムアウトが発生する場合があります。cjstartappコマンドで通信タイムアウトが発生した場合，J2EEサーバのメッセージログを参照してアプリケーションが正常に開始されているかを確認してください。また，サーバ管理コマンドの通信タイムアウト時間の定義を見直してください。

cjstopapp（J2EEアプリケーションの停止）

形式

通常停止する場合

cjstopapp [<サーバ名称>] [-nameserver <プロバイダURL>]
          -name <J2EEアプリケーション名> [-t <タイムアウト時間>]

通常停止がタイムアウトしたあと，強制停止を手動でする場合

cjstopapp [<サーバ名称>] [-nameserver <プロバイダURL>]
          -name <J2EEアプリケーション名> -cancel

通常停止がタイムアウトしたあと，強制停止を自動でする場合

cjstopapp [<サーバ名称>] [-nameserver <プロバイダURL>]
          -name <J2EEアプリケーション名> -t <タイムアウト時間> -force

機能

J2EEアプリケーションを停止して，クライアントからのリクエストを受け取らないようにします。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-name <J2EEアプリケーション名>

停止するJ2EEアプリケーション名を指定します。

-t <タイムアウト時間>

コマンドを実行してから応答が返るタイムアウトの時間を整数（単位：秒）で指定します。

-forceオプションを同時に指定する場合は0〜2147483647を指定します。

-forceオプションを指定しないで，このオプションだけを指定する場合は0〜86400を指定します。

0を指定した場合は，停止処理が終了するまでクライアントへ応答が返りません。指定がない場合は60秒が設定されます。

-cancel

通常停止がタイムアウトしたあと，強制停止を手動でする場合に指定します。

-force

通常停止がタイムアウトしたあと，強制停止を自動でする場合に指定します。

J2EEアプリケーションのストップ処理が完了した場合，強制停止はしません※。

注※

停止処理では，J2EEアプリケーションのストップ処理，アンデプロイ処理の順に実施されます。サーバ管理コマンドが排他制御するため，J2EEアプリケーションのストップ処理が完了したあとアンデプロイ処理が完了するまでに更新系コマンドを実行すると，更新系コマンドは実行中のコマンドが終了するまで待機します。更新系コマンドを実行する場合は，アンデプロイ処理の待ち状態が解除されたあとにしてください。アンデプロイ処理の完了は，J2EEサーバ側のメッセージKDJE42142-Iで確認できます。停止処理については，マニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」を参照してください。

入力例

cjstopapp MyServer -name App1

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<アプリケーション名> -name）やオプション名と値を非対応にすること（例：-nameserver <アプリケーション名> -name <プロバイダURL>）はできません。

通常停止をする場合，60秒または-tオプションで指定した時間の間に該当するJ2EEアプリケーションの停止処理が完了しなかったとき，このコマンドはエラー終了します。

強制停止をする場合，J2EEアプリケーションの停止処理が-tオプションで指定した時間内に終了しなかったとき，サーバ管理コマンド用システムプロパティファイルのejbserver.rmi.request.timeoutキーで指定した時間で強制終了します。

指定されたJ2EEアプリケーションが存在しない場合，このコマンドはエラー終了します。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

タイムアウトエラーが発生した場合は，cjlistappコマンドでJ2EEアプリケーションの状態を確認してください。

J2EEアプリケーションの停止については，マニュアル「アプリケーションサーバ 機能解説 運用／監視／連携編」の「5.5.7　J2EEアプリケーションの停止」を参照してください。

2.4　J2EEサーバで使用するリソース操作コマンド

ここでは，J2EEサーバで使用するリソース操作コマンドについて説明します。

J2EEサーバで使用するリソース操作コマンドの一覧を，次の表に示します。

表2‒5　J2EEサーバで使用するリソース操作コマンドの一覧

コマンド名称

分類

概要

コマンドの系統

cjclearpool

コネクションプール内のコネクション削除

リソースアダプタまたはデータソースのコネクションをクリアします。

更新

cjcopyres

リソースのコピー

EJB-JARファイル，WARファイル，データソースファイル，メール，またはRARファイルのプロパティをコピーします。

更新

cjdeletejb

JavaBeansリソースの削除

インポートされているJavaBeansリソースを削除します。

更新

cjdeleteres

リソースの削除

インポート済みのEJB-JARファイル，WARファイル，データソースファイル，メール，またはRARファイルを削除します。

更新

cjdeployrar

リソースアダプタのデプロイ

リソースアダプタをデプロイします。

更新

cjexportrar

リソースアダプタのエクスポート

J2EEサーバ上のリソースアダプタをエクスポートします。

更新

cjgetjbprop

JavaBeansリソースの属性の取得

-resnameで指定されたJavaBeansリソースの属性を取得して，属性ファイルを生成します。

更新

cjgetrarprop

RARファイルの属性の取得

デプロイ済みのRARファイルの属性を取得して，属性ファイルを生成します。

更新

cjgetresprop

リソースの属性の取得

EJB-JARファイルに含まれるリソース，WARファイルに含まれるリソース，データソースファイル，メール，またはデプロイ前のRARファイルに含まれるリソースの属性を取得して，属性ファイルを生成します。

更新

cjimportjb

JavaBeansリソースのインポート

JavaBeansリソースをインポートします。

更新

cjimportres

リソースのインポート

EJB-JARファイル，WARファイル，データソースファイル，またはRARファイルをインポートします。

更新

cjlistjb

JavaBeansリソースの一覧表示

すべてのJavaBeansリソースの状態を標準出力に出力します。

参照

cjlistpool

コネクションプールの一覧表示

指定されたリソースアダプタ，またはすべてのリソースアダプタのコネクションプール状態を標準出力に出力します。

参照

cjlistrar

リソースアダプタの一覧表示

デプロイされているすべてのリソースアダプタの一覧を標準出力に出力します。

参照

cjlistres

リソースの一覧表示

インポート済みのEJB-JARファイル，WARファイル，データソースファイル，メール，またはRARファイルの一覧を標準出力に出力します。

参照

cjsetjbprop

JavaBeansリソースの属性設定

指定されたJavaBeansリソースの属性を，指定したJavaBeansリソース属性ファイルの値に変更します。

更新

cjsetrarprop

RAR属性設定

デプロイ済みのRARファイルに含まれるリソースの属性を属性ファイルに指定された値に変更します。

更新

cjsetresprop

リソースの属性設定

EJB-JARファイルに含まれるリソース，WARファイルに含まれるリソース，データソースファイル，メール，またはデプロイ前のRARファイルに含まれるリソースの属性を，属性ファイルに指定された値に変更します。

更新

cjstartjb

JavaBeansリソースの開始

JavaBeansリソースを開始します。

更新

cjstartrar

リソースアダプタの開始

リソースアダプタを開始します。

更新

cjstopjb

JavaBeansリソースの停止

開始状態のJavaBeansリソースを停止します。

更新

cjstoprar

リソースアダプタの停止

開始されているリソースアダプタを停止します。

更新

cjtestres

リソースの接続テスト

J2EEリソースアダプタ，メールおよびデータソースの接続テストをします。

更新

cjundeployrar

リソースアダプタのアンデプロイ

デプロイされているリソースアダプタをアンデプロイします。

更新

（凡例）

更新：更新系コマンド。J2EEサーバの内容を更新，または構成情報を取得するコマンドです。

参照：参照系コマンド。J2EEサーバの内容を更新しないで，構成状態を表示するだけのコマンドです。

サーバ管理コマンドの系統ごとの排他制御の条件については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「3.2　サーバ管理コマンドの排他制御」を参照してください。

cjclearpool（コネクションプール内のコネクション削除）

形式

データソース（JDBC）の場合

cjclearpool [<サーバ名称>] [-nameserver <プロバイダURL>]
            [-type jdbc] [-mode {normal｜plan}]
            -resname <データソース表示名>
            [-resname <データソース表示名> ...]

リソースアダプタ（J2EEリソースアダプタとしてデプロイして使用）の場合

cjclearpool [<サーバ名称>] [-nameserver <プロバイダURL>]
            -type connector [-mode {normal｜plan}]
            -resname <リソースアダプタ表示名>
            [-resname <リソースアダプタ表示名> ...]

リソースアダプタ（J2EEアプリケーションに含めて使用）の場合

cjclearpool [<サーバ名称>] [-nameserver <プロバイダURL>]
            -type connector [-mode {normal｜plan}]
            -name <アプリケーション名>
            -resname <リソースアダプタ表示名>
            [-resname <リソースアダプタ表示名> ...]

すべてのデータソース（JDBC）およびリソースアダプタの場合

cjclearpool [<サーバ名称>] [-nameserver <プロバイダURL>]
            [-mode {normal｜plan}] -resall

機能

指定されたデータソース（JDBC）またはリソースアダプタのコネクションをクリアします。一度に複数のデータソース（JDBC）またはリソースアダプタのコネクションを削除できます。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-type {jdbc|connector}

コネクションプールの種別を指定します。省略した場合はjdbcが設定されます。

jdbc：JDBC用のプール

connector：リソースアダプタ用のプール

-mode {normal|plan}

使用中のコネクションに対するクリア動作種別を指定します。未使用のコネクションはすべてクリア対象になります。省略した場合はnormalが設定されます。

normal（通常モード）

ユーザが使用中のコネクションはプールの外へ移して，プール内からはクリアされます。ただし，データベースとの接続はそのままで再利用はできません。

plan（計画モード）

ユーザが使用中のコネクションはクリアしません。ただし，再利用できません。

-name <アプリケーション名>

リソースアダプタがデプロイされているアプリケーション名を指定します。

コネクションプール種別がconnectorの場合に指定できます。省略した場合は，J2EEリソースアダプタとしてデプロイして使用したリソースアダプタのコネクションを削除します。

-resname <データソース表示名>または<リソースアダプタ表示名>

クリア対象となるデータソース（JDBC）またはリソースアダプタの表示名を指定します。

リソースアダプタ表示名の指定方法は，リソースアダプタのバージョンによって次のように異なります。

Connector 1.0の場合

<リソースアダプタの表示名>

Connector 1.5の場合

<リソースアダプタの表示名>!<コネクション定義識別子>

-resall

すべてのデータソース（JDBC）およびリソースアダプタを削除対象にする場合に指定します。

なお，-type，-name，または-resnameと同時に指定できません。

入力例

データソース（JDBC）の場合（通常モード）

cjclearpool MyServer -resname JdbcConnection

リソースアダプタ（J2EEリソースアダプタとしてデプロイして使用）の場合

cjclearpool MyServer -type connector -mode plan -resname RarConnection

リソースアダプタ（J2EEアプリケーションに含めて使用）の場合

cjclearpool MyServer -type connector -mode plan -name App1 -resname RarConnection

すべてのデータソース（JDBC）およびリソースアダプタの場合（計画モード）

cjclearpool MyServer -mode plan -resall

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<データソース表示名> -resname）やオプション名と値を非対応にすること（例：-nameserver <データソース表示名> -resname <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

一度に複数のデータソース（JDBC）またはリソースアダプタを削除した場合，削除できないデータソース（JDBC）またはリソースアダプタがあったときでも，すべてのデータソース（JDBC）またはリソースアダプタに対して削除を試みます。

通常モードの場合，コネクションプールから取り除いた使用中コネクションは，コネクション数としてカウントされません。そのため，コネクションプール内のコネクションとコネクションプールから取り除いた使用中コネクションの合計がコネクションプールの最大値を超える場合があります。

cjcopyres（リソースのコピー）

形式

cjcopyres [<サーバ名称>] [-nameserver <プロバイダURL>]
          -type {ejb|war|datasource|mail|rar}
          -src <コピー元表示名> -dst <コピー先表示名>

機能

リソース（EJB-JARファイル，WARファイル，データソースファイル，メール，またはRARファイル）のプロパティをコピーします。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-type {ejb|war|datasource|mail|rar}

コピー対象となるリソースの種別を指定します。

ejb：EJB-JARファイル

war：WARファイル

datasource：データソースファイル

mail：メール

rar：RARファイル

-src <コピー元表示名>

コピー元となるEJB-JARファイル，WARファイル，データソースファイル，メール，またはRARファイルの表示名を指定します。

-dst <コピー先表示名>

コピー先となるEJB-JARファイル，WARファイル，データソースファイル，メール，またはRARファイルの表示名を指定します。

表示名には，英数字（0〜9，A〜Z，a〜z）または次の特殊文字を使用できます。ただし，指定できる特殊文字は-typeで指定したリソースの種別によって異なります。

ejb，war，rarを指定した場合に使用できる特殊文字

プラス（+），ハイフン（-），ピリオド（.），キャレット（^），アンダースコア（_）

mailを指定した場合に使用できる特殊文字

スペース（ ），エクスクラメーションマーク（!），シャープ（#），ドル記号（$），パーセント（%），アンパサンド（&），バーレン（(）（)），プラス（+），ハイフン（-），ピリオド（.），セミコロン（;），レスザン（<），グレーターザン（>），単価記号（@），ブラケット（[）（]），円マーク（¥），キャレット（^），アンダースコア（_），バッククォート（`），ブレイス（{）（}），ストローク（|），チルダ（~）

ただし，先頭または末尾に半角スペースがある名前を指定した場合，半角スペースを除去して使用されます。

datasourceを指定した場合に使用できる特殊文字

アンダースコア（_）

なお，mailを指定した場合，次に示す名称は指定できません。指定した場合エラーとなります。

先頭・末尾に半角スペースがある名前

文字列の途中に連続した2個以上の半角スペースがある名前

入力例

EJB-JARファイルの場合

cjcopyres MyServer -type ejb -src accountJsp -dst accountJsp2

WARファイルの場合

cjcopyres MyServer -type war -src account-war -dst account_war2

データソースファイルの場合

cjcopyres MyServer -type datasource -src JdbcDbpsv -dst JdbcDbpsv2

メールの場合

cjcopyres MyServer -type mail -src Mail -dst Mail2

RARファイルの場合

cjcopyres MyServer -type rar -src account-ra -dst account-ra2

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コピー先に指定する表示名が存在してはいけません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

コピー先表示名に指定したデータソースファイル，メール，またはRARファイルの表示名が240文字より大きい場合はエラーとなります。

コピー先となるRARファイルの表示名に次の名称を指定した場合，J2EEアプリケーションの操作ができなくなるおそれがあります。このため，RARファイルの表示名に次の名称を指定しないでください。

記号の前後にアンダースコア(_)を指定している名称（例：abc_+_001）

記号で終わる名称（例：abc+）

cjdeletejb（JavaBeansリソースの削除）

形式

cjdeletejb [<サーバ名称>] [-nameserver <プロバイダURL>]
           -resname <JavaBeansリソース表示名>
           [-resname <JavaBeansリソース表示名> ...]

機能

インポートされているJavaBeansリソースを削除します。

一度に複数のJavaBeansリソースを削除できます。削除できないJavaBeansリソースがあった場合でも，すべてのJavaBeansリソースに対して削除しようと試みます。

一度でも開始されたJavaBeansリソースは，J2EEサーバを再起動するまで削除できません。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

省略時はNamingSeviceが返すデフォルト値を使用します。

-resname <JavaBeansリソース表示名>

削除対象となるJavaBeansリソースの表示名を指定します。

入力例

cjdeletejb MyServer -resname MyJavaBeans

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドが実行できません。

3：

タイムアウトエラーが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-resname <プロバイダURL> -nameserver <JavaBeansリソース表示名>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjdeleteres（リソースの削除）

形式

cjdeleteres [<サーバ名称>] [-nameserver <プロバイダURL>]
            -type {ejb|war|datasource|mail|rar} -resname <表示名>
            [-resname <表示名> ...]

機能

インポート済みのEJB-JARファイル，WARファイル，データソースファイル，メール，またはRARファイルを削除します。一度に複数のファイルの削除もできます。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-type {ejb|war|datasource|mail|rar}

削除するリソースの種別を指定します。

ejb：EJB-JARファイル

war：WARファイル

datasource：データソースファイル

mail：メール

rar：RARファイル

-resname <表示名>

削除対象となるEJB-JARファイル，WARファイル，データソースファイル，メール，またはRARファイルの表示名を指定します。

入力例

EJB-JARファイルの場合

cjdeleteres MyServer -type ejb -resname accountJsp

WARファイルの場合

cjdeleteres MyServer -type war -resname account-war

データソースファイルの場合

cjdeleteres MyServer -type datasource -resname JdbcDbpsv

メールの場合

cjdeleteres MyServer -type mail -resname Mail

RARファイルの場合

cjdeleteres MyServer -type rar -resname account-ra

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

一度に複数のファイルを削除した場合，削除できないファイルがあったときでも，すべてに対して削除を試みます。

いったん開始または停止した単体RARファイルは，J2EEサーバを再起動しないと削除できません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjdeployrar（リソースアダプタのデプロイ）

形式

cjdeployrar [<サーバ名称>] [-nameserver <プロバイダURL>]
            -resname <リソースアダプタ名> [-resname <リソースアダプタ名> ...]

機能

指定されたリソースアダプタをデプロイします。まだデプロイされていないリソースアダプタが対象となります。すでにアプリケーションに追加されているリソースアダプタの表示名と同じ表示名を持つリソースアダプタを指定することはできません。一度に複数のリソースアダプタをデプロイできます。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-resname <リソースアダプタ名>

リソースアダプタ名を指定します。

入力例

cjdeployrar MyServer -resname account-ra

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

8：

デプロイに成功しましたが，開始に失敗しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）であれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<リソースアダプタ名> -resname）やオプション名と値を非対応にすること（例：-resname <プロバイダURL> -nameserver <リソースアダプタ名>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

一度に複数のリソースアダプタをデプロイする場合，追加できないリソースアダプタがあるときでも，すべてのリソースアダプタの追加を試みます。

開始済みの実行時情報を含んだリソースアダプタを指定すると，デプロイ完了後に自動開始処理が行われます。自動開始処理に失敗した場合，J2EEリソースアダプタは削除されません。

cjexportrar（リソースアダプタのエクスポート）

形式

cjexportrar [<サーバ名称>] [-nameserver <プロバイダURL>]
            -f <ファイルパス> -resname <リソースアダプタ名> [-raw|-normal]

機能

J2EEサーバ上のリソースアダプタをRARファイルに出力します。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-f <ファイルパス>

RARファイルの出力先となるファイルのパスを指定します。

-resname <リソースアダプタ名>

エクスポートするリソースアダプタ名を指定します。

-raw

J2EE リソースアダプタファイルを生成します。

-normal

製品のリソースアダプタ拡張DDファイル（ファイル名：hitachi-ra.xml）を追加し，J2EEリソースアダプタファイルを生成します。-rawオプション，-normalオプションのどちらも指定されていない場合は，-normalオプションを指定した場合と同じになります。

入力例

cjexportrar MyServer -f res1.rar -resname Res1

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）であれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<リソースアダプタ名> -resname）やオプション名と値を非対応にすること（例：-resname <プロバイダURL> -nameserver <リソースアダプタ名>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjgetjbprop（JavaBeansリソースの属性の取得）

形式

cjgetjbprop [<サーバ名称>] [-nameserver <プロバイダURL>]
            -resname <JavaBeansリソース表示名>
            [-encoding <エンコーディング名>] -c <属性ファイルパス>

機能

-resnameで指定されたJavaBeansリソースの属性を取得し，属性ファイルを生成します。

JavaBeansリソース属性ファイルの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.2　JavaBeansリソース属性ファイル」を参照してください。

指定したパスにすでにファイルが存在する場合，上書きします。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-resname <JavaBeansリソース表示名>

取得対象となるJavaBeansリソースの表示名を指定します。

-encoding ＜エンコーディング名＞

属性ファイル出力時のエンコーディング名を指定します。指定できるエンコーディング名を次に示します。

UTF8

UTF-8

ASCII

US-ASCII

ISO-8859-1

EUC_JP

Shift_JIS

SJIS

windows-31j

MS932

JavaVMがサポートしているエンコーディング名

省略した場合は，JavaVMのデフォルトエンコーディング名を使用します。使用されたエンコーディング名を確認するには，cjgetjbpropコマンドで取得した属性ファイルの先頭行のXML宣言部分を参照してください。

<?xml version="<XML規格のバージョン番号>" encoding="<エンコーディング名>"?>

-c <属性ファイルパス>

属性ファイルの出力先パスを指定します。

入力例

cjgetjbprop MyServer -resname MyJavaBeansName -encoding Shift_JIS -c MyJavaBeansProp.xml

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドが実行できません。

3：

タイムアウトエラーが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-resname <プロバイダURL> -nameserver <JavaBeansリソース表示名>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjgetrarprop（RARファイルの属性の取得）

形式

cjgetrarprop [<サーバ名称>][-nameserver <プロバイダURL>]
             -resname <リソースアダプタ表示名>
             [-encoding <エンコーディング名>] -c <属性ファイルパス>

機能

-resnameに指定されたJ2EEリソースとしてデプロイ済みのRARファイルの属性を取得して，属性ファイルを生成します。

RARファイルの属性を設定するのは，Connector属性ファイルです。Connector属性ファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-resname <リソースアダプタ表示名>

取得対象となるリソース（デプロイ済みのリソースアダプタ）の表示名を指定します。

-encoding ＜エンコーディング名＞

属性ファイル出力時のエンコーディング名を指定します。指定できるエンコーディング名を次に示します。

UTF8

UTF-8

ASCII

US-ASCII

ISO-8859-1

EUC_JP

Shift_JIS

SJIS

windows-31j

MS932

JavaVMがサポートしているエンコーディング名

省略した場合は，JavaVMのデフォルトエンコーディング名を使用します。使用されたエンコーディング名を確認するには，このコマンドで取得した属性ファイルの先頭行のXML宣言部分を参照してください。

<?xml version="<XML規格のバージョン番号>" encoding="<エンコーディング名>"?>

-c ＜属性ファイルパス＞

属性ファイルの出力先パスを指定します。

入力例

cjgetrarprop MyServer -resname account-rar -encoding Shift_JIS -c MyRarprop.xml

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<リソースアダプタ表示名> -resname）やオプション名と値を非対応にすること（例：-resname <属性ファイルパス> -c <リソースアダプタ表示名>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

指定したパスにすでに属性ファイルが存在する場合，上書きします。

cjgetresprop（リソースの属性の取得）

形式

EJB-JARファイルおよびWARファイルの場合

cjgetresprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -type {ejb|war}
             -resname <リソース表示名>[/<下位リソース表示名>]
             [-encoding エンコーディング名] -c <属性ファイルパス>

データソースファイルの場合

cjgetresprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -type datasource -resname <データソース表示名>
             [-encoding エンコーディング名] -c <属性ファイルパス>

メールの場合

cjgetresprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -type mail -resname <メール表示名>
             [-encoding エンコーディング名] -c <属性ファイルパス>

RARファイルの場合

cjgetresprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -type rar -resname <リソースアダプタ表示名>
             [-encoding エンコーディング名] -c <属性ファイルパス>

機能

EJB-JARファイルに含まれるリソース（EJB-JARファイル，Session Bean，Entity Bean，Message-driven Bean），WARファイルに含まれるリソース（WARファイル，サーブレット／JSP，フィルタ），データソースファイル，メール，またはデプロイ前のRARファイルに含まれるリソースの属性を取得して，属性ファイルを生成します。

下位リソース表示名が指定されない場合は，EJB-JARファイルまたはWARファイルの指定となります。

J2EEアプリケーションとリソースの設定で使用する属性ファイルについては，次の個所を参照してください。

マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.　J2EEアプリケーションの設定で使用する属性ファイル」

マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.　リソースの設定で使用する属性ファイル」

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-type {ejb|war|datasource|mail|rar}

生成する属性ファイルの種別を指定します。

ejb：EJB-JARファイルまたはEJB-JARファイル中のリソースの属性ファイル

war：WARファイルまたはWARファイル中のリソースの属性ファイル

datasource：データソース属性ファイル

mail：メール属性ファイル

rar：デプロイ前のRARファイルの属性ファイル

-resname <リソース表示名，データソース表示名，メール表示名またはリソースアダプタ表示名>

取得対象となるリソースの表示名を指定します。

EJB-JARファイルの場合：<EJB-JARファイルの表示名>

EJBファイルの場合：<EJB-JARファイルの表示名>[/<EJBファイルの表示名>]

WARファイルの場合：<WARファイルの表示名>

サーブレット／JSPの場合：<WARファイルの表示名>[/<サーブレット／JSPの表示名>]

フィルタの場合：<WARの表示名>[/<フィルタの表示名>]

データソースファイルの場合：<データソースファイルの表示名>

メールの場合：<メールの表示名>

RARファイルの場合：<RARファイルの表示名>

-encoding <エンコーディング名>

属性ファイル出力時のエンコーディング名を指定します。指定できるエンコーディング名を次に示します。

UTF8

UTF-8

ASCII

US-ASCII

ISO-8859-1

EUC_JP

Shift_JIS

SJIS

windows-31j

MS932

JavaVMがサポートしているエンコーディング名

省略した場合は，JavaVMのデフォルトエンコーディング名を使用します。使用されたエンコーディング名を確認するには，このコマンドで取得した属性ファイルの先頭行のXML宣言部分を参照してください。

<?xml version="<XML規格のバージョン番号>" encoding="<エンコーディング名>"?>

-c <属性ファイルパス>

属性ファイルの出力先パスを指定します。

入力例

EJB-JARファイルの場合

cjgetresprop MyServer -type ejb -resname accountJsp/MyAccount -encoding Shift_JIS -c MyAccountProp.xml

WARファイルの場合

cjgetresprop MyServer -type war -resname account-war/Account -encoding UTF-8 -c AccountProp.xml

データソースファイルの場合

cjgetresprop MyServer -type datasource -resname JdbcDbpsv -c JdbcDbpsvProp.xml

メールの場合

cjgetresprop MyServer -type mail -resname Mail -c MailProp.xml

RARファイルの場合

cjgetresprop MyServer -type rar -resname account-rar -encoding Shift_JIS -c AccountProp.xml

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<J2EEアプリケーション名> -name）やオプション名と値を非対応にすること（例：-name ejb -type <J2EEアプリケーション名>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

指定したパスにすでに属性ファイルが存在する場合，上書きします。

cjimportjb（JavaBeansリソースのインポート）

形式

JavaBeansリソースのインポートをする場合

cjimportjb [<サーバ名称>] [-nameserver <プロバイダURL>]
           -f <JARファイルパス> -c <属性ファイルパス>

引数で指定したディレクトリにあるJavaBeansリソースのクラスのインポートをする場合

cjimportjb [<サーバ名称>] [-nameserver <プロバイダURL>]
           -d <JavaBeansリソースのクラスが存在するディレクトリパス>
           -c <属性ファイルパス>

機能

JavaBeansリソースのインポートをする場合

JavaBeansリソースをインポートします。

すでにインポートしたJavaBeansリソースと同じ表示名，または同じ実装クラス名を持つJavaBeansリソースをインポートすることはできません。

JavaBeansリソースをインポートし，属性ファイルに指定された値を設定します。

JavaBeansリソース属性ファイルの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.2　JavaBeansリソース属性ファイル」を参照してください。

引数で指定したディレクトリにあるJavaBeansリソースのクラスのインポートをする場合

引数で指定したディレクトリにあるJavaBeansリソースのクラスをインポートします。

すでにインポートしたJavaBeansリソースと同じ表示名，または同じ実装クラス名を持つJavaBeansリソースをインポートすることはできません。

JavaBeansリソースをインポートし，属性ファイルに指定された値を設定します。

JavaBeansリソース属性ファイルの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.2　JavaBeansリソース属性ファイル」を参照してください。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-f <JARファイルパス>

読み込み対象となるファイル（JavaBeansリソースを含むJARファイル）のパスを指定します。

-d <JavaBeans リソースのクラスが存在するディレクトリパス>

JavaBeansリソースのクラスが存在するディレクトリのパスを指定します。

指定されたディレクトリ下に存在するものすべてをJavaBeansリソースとしてインポートします。

-c <属性ファイルパス>

属性ファイルの入力元パスを指定します。

入力例

形式1

cjimportjb MyServer -f Myjavabeans.jar -c Myjavabeansprop.xml

形式2

cjimportjb MyServer -d MydirectoryPath -c Myjavabeansprop.xml

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドが実行できません。

3：

タイムアウトエラーが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<アプリケーション名> -name）やオプション名と値を非対応にすること（例：-f <属性ファイルパス> -c <JARファイルパス>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

JavaBeansリソースの表示名が240文字より大きい場合はエラーとなります。

引数に指定したファイルサイズの約3倍のJavaヒープを一時的に使用します。ファイルサイズを3倍にした値がJ2EEサーバのJavaヒープの見積もり値を超える場合は，ファイルサイズの3倍の値をJ2EEサーバのJavaヒープのサイズに指定する必要があります。

cjimportres（リソースのインポート）

形式

EJB-JARファイル，WARファイル，またはRARファイルの場合

cjimportres [<サーバ名称>] [-nameserver <プロバイダURL>]
            -type {ejb|war|rar} -f <ファイルパス>
            [-f <ファイルパス> ...]

データソースの場合

cjimportres [<サーバ名称>] [-nameserver <プロバイダURL>]
            -type datasource -resname <データソース表示名>
            -c <データソース設定ファイルパス>
            -f <JDBCドライバファイルパス>
            [-f <JDBCドライバファイルパス> ...]

機能

リソース（EJB-JARファイル，WARファイル，データソースファイル，またはRARファイル）をインポートします。また，一度に複数のファイルのインポートもできます。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-type {ejb|war|datasource|rar}

インポートするファイルのファイル種別を指定します。

ejb：EJB-JARファイル

war：WARファイル

datasource：JDBCドライバファイルおよびデータソース設定ファイル

rar：RARファイル

-resname <データソース表示名>

インポートするデータソースに付与する名前を指定します。名前には英数字（0〜9，A〜Z，a〜z）またはアンダースコア（_）を使用できます。

-c <データソース設定ファイルパス>

読み込み対象となるデータソース設定ファイルのパスを指定します。

-f <ファイルパスまたはJDBCドライバファイルパス>

読み込み対象となるファイル（EJB-JARファイル，WARファイル，JDBCドライバ，またはRARファイル）のパスを指定します。

JDBCドライバが複数のファイルで構成されている場合，-fオプションを複数回指定してください。

入力例

EJB-JARファイルの場合

cjimportres MyServer -type ejb -f account.jar

WARファイルの場合

cjimportres MyServer -type war -f account.war

データソースファイルの場合

cjimportres MyServer -type datasource -resname JdbcDbpsv -c JdbcDbpsvConf.xml -f JdbcDbpsv.jar

RARファイルの場合

cjimportres MyServer -type rar -f account.rar

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<データソース表示名> -resname）やオプション名と値を非対応にすること（例：-nameserver <データソース表示名> -resname <プロバイダURL>）はできません。

DDファイルの<display-name>タグを設定していない場合，または<display-name>タグに空文字を設定している場合，リソースの表示名にファイル名が使用されます。なお，ファイル名に汎用文字，半角英数字以外の文字が含まれている場合，その文字はアンダースコア"_"に置き換えられます。

Deployment Descriptorを省略した場合，リソースの表示名は次のように変換されます。

EJB-JARファイル(EJB3.0以降)のときは，ファイル名から拡張子(.jar)を除いた文字列。

WARファイル(Servlet2.5以降)のときは，ファイル名から拡張子を除いた文字列。

なお，ピリオド(.)が最初にだけ現れるファイル名の場合，拡張子は除かれません。また，変換された表示名に半角英数文字(0〜9, A〜Z, a〜z)，アンダースコア(_)以外の文字がある場合，その文字はアンダースコア(_)に置き換えられます。

RARファイルの場合，DDファイルは省略できません。

RARファイルの表示名に次の名称を指定した場合，J2EEアプリケーションの操作ができなくなるおそれがあります。このため，RARファイルの表示名に次の名称を指定しないでください。

記号の前後にアンダースコア(_)を指定している名称（例：abc_+_001）

記号で終わる名称（例：abc+）

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

すでにインポートされているEJB-JARファイルと同じ表示名を持つEJB-JARファイルはインポートできません。

すでにインポートされているWARファイルと同じ表示名を持つWARファイルはインポートできません。

すでにインポートされているRARファイルと同じ表示名を持つRARファイルはインポートできません。

すでにインポートされているデータソース，生成済みのメールと同じ表示名でデータソースをインポートできません。

ネイティブライブラリを含むRARファイルはインポートできません。

EJB-JARに表示名が指定されていない場合，EJB-JARファイルのファイル名（.jarを除く）をEJB-JARファイルの表示名として使用します。

RARファイルの場合も同様になります。

WARファイルの場合も同様にファイル名を表示名としますが，英数字，アンダースコア以外の文字はアンダースコアに置き換えます。置換対象文字が連続する場合は一つのアンダースコアにまとめられます。

一度に複数のファイルをインポートした場合，インポートできないファイルがあったときでも，すべてのファイルに対してインポートを試みます。

Enterprise Bean（EJB-JAR）のインポート時には，EJB-JARファイルのDDに関して注意事項があります。Enterprise Bean（EJB-JAR）のインポートについては，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「7.2.1　Enterprise Bean（EJB-JAR）のインポート」を参照してください。

サーブレットとJSPのインポート時には，WARファイルのDDに関して注意事項があります。サーブレットとJSPのインポートについては，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「7.2.2　サーブレットとJSP（WAR）のインポート」を参照してください。

リソースアダプタのインポート時には，RARファイルのDDに関して注意事項があります。リソースアダプタのインポートについては，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「7.2.3　リソースアダプタ（RAR）のインポート」を参照してください。

インポートするRARファイルの表示名またはデータソースの表示名が240文字より大きい場合はエラーとなります。

引数に指定したファイルサイズの約3倍のJavaヒープを一時的に使用します。ファイルサイズを3倍にした値がJ2EEサーバのJavaヒープの見積もり値を超える場合は，ファイルサイズの3倍の値をJ2EEサーバのJavaヒープのサイズに指定する必要があります。

cjlistjb（JavaBeansリソースの一覧表示）

形式

cjlistjb [<サーバ名称>] [-nameserver <プロバイダURL>]

機能

すべてのJavaBeansリソースの状態を標準出力に出力します。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

出力形式

<JavaBeansリソースの状態><JavaBeansリソース表示名>
<JavaBeansリソースの状態><JavaBeansリソース表示名>
・・・

JavaBeansリソースの状態には次のどちらかが入ります。

running

開始状態

stopped

停止状態

入力例

cjlistjb MyServer

戻り値

0：

正常終了しました。

1：

異常終了しました。

3：

タイムアウトエラーが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）に指定します。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-nameserver <サーバ名称>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjlistpool（コネクションプールの一覧表示）

形式

J2EEリソースアダプタとしてデプロイされているリソースアダプタを指定する場合

cjlistpool [<サーバ名称>] [-nameserver <プロバイダURL>]
           -resname <リソースアダプタの表示名>
           [-resname <リソースアダプタの表示名> ...]

アプリケーションに含めて使用されるリソースアダプタを指定する場合

cjlistpool [<サーバ名称>] [-nameserver <プロバイダURL>]
           -name <アプリケーション名>
           -resname <リソースアダプタの表示名>
           [-resname <リソースアダプタの表示名> ...]

すべてのリソースアダプタを指定する場合

cjlistpool [<サーバ名称>] [-nameserver <プロバイダURL>] -resall

機能

J2EEリソースアダプタとしてデプロイされているリソースアダプタを指定する場合

指定されたJ2EEリソースアダプタのコネクションプールの情報を標準出力に出力します。

一度に複数のリソースアダプタのコネクションプールの情報を表示できます。表示できないリソースアダプタがあった場合でも，すべてのリソースアダプタに対して表示を試みます。

アプリケーションに含めて開始されているリソースアダプタを指定する場合

指定されたアプリケーションに含まれるリソースアダプタのコネクションプールの状態を標準出力に出力します。

一度に複数のリソースアダプタのコネクションプールの状態を表示できます。表示できないリソースアダプタがあった場合でも，すべてのリソースアダプタに対して表示を試みます。

すべてのリソースアダプタを指定する場合

起動されているすべてのリソースアダプタのコネクションプールの情報を標準出力に出力します。

なお，無効なコネクションプールは出力されません。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-resname <リソースアダプタの表示名>

表示対象とするリソースアダプタの表示名を指定します。

Connector 1.5の場合，<リソースアダプタの表示名>!<コネクション定義識別子>で指定します。

-name <アプリケーション名>

表示対象とするリソースアダプタを含んでいるアプリケーション名を指定します。

省略した場合，J2EEリソースアダプタとしてデプロイされているリソースアダプタが対象となります。

-resall

すべてのリソースアダプタを表示対象とする場合に指定します。

出力形式

入力例

形式1

cjlistpool MyServer -resname Rar1

形式2

cjlistpool MyServer -name App1 -resname Rar1

形式3

cjlistpool MyServer -resall

戻り値

0：

正常終了しました。

1：

異常終了しました。

3：

タイムアウトエラーが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-nameserver <リソースアダプタの表示名> -resname <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjlistrar（リソースアダプタの一覧表示）

形式

リソースアダプタの状態表示の場合

cjlistrar [<サーバ名称>] [-nameserver <プロバイダURL>]
          [-spec]

コネクション定義識別子の一覧表示の場合

cjlistrar [<サーバ名称>] [-nameserver <プロバイダURL>]
          -resname <リソースアダプタの表示名> -outbound

メッセージリスナのタイプの一覧表示の場合

cjlistrar [<サーバ名称>] [-nameserver <プロバイダURL>]
          -resname <リソースアダプタの表示名> -inbound

アクティブ化のために設定が必要なプロパティ名の一覧表示の場合

cjlistrar [<サーバ名称>] [-nameserver <プロバイダURL>]
          -resname <リソースアダプタの表示名>
          -listenertype <メッセージリスナのタイプ名>

機能

リソースアダプタの状態表示の場合

デプロイされているすべてのリソースアダプタについて，リソースアダプタ名とリソースアダプタの状態を標準出力に出力します。

-specを指定すると，RARファイルのコネクタアーキテクチャの仕様バージョンを標準出力に出力します。

コネクション定義識別子の一覧表示の場合

Connector 1.5のリソースアダプタで，-resnameと-outboundを指定すると，デプロイされているRARファイルに含まれるOutboundリソースアダプタのコネクション定義識別子の一覧を標準出力に出力します。Connector 1.0のリソースアダプタでは，-resnameと-outboundは指定できません。

Connector 1.5のリソースアダプタで，-resnameと-inboundを指定すると，デプロイされているRARファイルに含まれる，Inboundリソースアダプタのメッセージリスナのタイプの一覧を標準出力に出力します。Connector 1.0のリソースアダプタでは，-resnameと-inboundは指定できません。

Connector 1.5のリソースアダプタで，-resnameと-listenertypeを指定すると，指定したメッセージリスナのアクティブ化のために設定が必要なプロパティ名の一覧を標準出力に出力します。Connector 1.0のリソースアダプタでは，-resnameと-listenertypeは指定できません。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-spec

コネクタアーキテクチャのバージョンを表示する場合に指定します。

次のどちらかのコネクタアーキテクチャのバージョンが表示されます。

Connector 1.0

Connector 1.5

-resname <リソースアダプタの表示名>

表示対象となるリソースアダプタ名を指定します。

-outbound

RARファイルに含まれるOutboundリソースアダプタのコネクション定義識別子を表示する場合に，-resnameとともに指定します。

-inbound

RARファイルに含まれるInboundリソースアダプタのメッセージリスナのタイプを表示する場合に，-resnameとともに指定します。

-listenertype <メッセージリスナのタイプ名>

指定したメッセージリスナのアクティブ化のために設定が必要なプロパティ名を表示する場合に，-resnameとともに指定します。

出力形式

-specを指定しない場合

<リソースアダプタの状態> <リソースアダプタ名>
<リソースアダプタの状態> <リソースアダプタ名>
・・・

<リソースアダプタの状態>には，次のどちらかの値が入ります。

running：開始状態

stopped：停止状態

-specを指定した場合

<リソースアダプタの状態> <コネクタアーキテクチャの仕様バージョン> <リソースアダプタ名>
<リソースアダプタの状態> <コネクタアーキテクチャの仕様バージョン> <リソースアダプタ名>
・・・

-resnameと-outboundを指定した場合

<コネクション定義識別子>
<コネクション定義識別子>
・・・

-resnameと-inboundを指定した場合

<メッセージリスナのタイプ>
<メッセージリスナのタイプ>
・・・

-resnameと-listenertypeを指定した場合

<プロパティ名>
<プロパティ名>
・・・

入力例

cjlistrar MyServer

戻り値

0：

正常終了しました。

1：

異常終了しました。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）に指定します。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-nameserver <サーバ名称>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

一覧は大文字小文字の区別なしで，昇順でソートされます。

cjlistres（リソースの一覧表示）

形式

RARファイル以外のリソースの場合

cjlistres [<サーバ名称>] [-nameserver <プロバイダURL>]
          -type {ejb|war|datasource|mail} [-resname <表示名>]

RARファイルのリソースの場合

cjlistres [<サーバ名称>] [-nameserver <プロバイダURL>]-type rar [-spec|
          -resname <表示名> -outbound |
          -resname <表示名> -inbound |
          -resname <表示名> -listenertype <メッセージリスナのタイプ名>]

機能

RARファイル以外のリソースの場合

インポート済みのEJB-JARファイル，WARファイル，データソースファイル，またはメールの一覧を標準出力に出力します。

RARファイルのリソースの場合

インポート済みのRARファイルの一覧を標準出力に出力します。

-specを指定すると，RARファイルのコネクタアーキテクチャの仕様バージョンを標準出力に出力します。

Connector 1.5のリソースアダプタで，-resnameと-outboundを指定すると，RARファイルに含まれるOutboundリソースアダプタのコネクション定義識別子の一覧を標準出力に出力します。Connector 1.0のリソースアダプタでは，-resnameと-outboundは指定できません。

Connector 1.5のリソースアダプタで，-resnameと-inboundを指定すると，RARファイルに含まれる，Inboundリソースアダプタのメッセージリスナのタイプの一覧を標準出力に出力します。Connector 1.0のリソースアダプタでは，-resnameと-inboundは指定できません。

Connector 1.5のリソースアダプタで，-resnameと-listenertypeを指定すると，指定したメッセージリスナのアクティブ化のために設定が必要なプロパティ名の一覧を標準出力に出力します。Connector 1.0のリソースアダプタでは，-resnameと-listenertypeは指定できません。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-type {ejb|war|datasource|mail|rar}

表示対象となるリソースの種別を指定します。

ejb：EJB-JARファイル

war：WARファイル

datasource：データソースファイル

mail：メール

rar：RARファイル

-resname <表示名>

表示対象となるリソース（EJB-JARファイル，WARファイル，またはRARファイル）の表示名を指定します。

EJB-JARファイル，WARファイル，またはRARファイルの場合に-resnameを指定すると，それぞれに含まれるリソース（EJB-JARファイル：Enterprise Bean，WARファイル：サーブレット／JSPまたは，フィルタ，RARファイル：RARファイルのコネクション定義識別子）の一覧を標準出力に出力します。

-spec

コネクタアーキテクチャのバージョンを表示する場合に指定します。

次のどちらかのコネクタアーキテクチャのバージョンが表示されます。

Connector 1.0

Connector 1.5

-outbound

RARファイルに含まれるOutboundリソースアダプタのコネクション定義識別子を表示する場合に，-resnameとともに指定します。

-inbound

RARファイルに含まれるInboundリソースアダプタのメッセージリスナのタイプを表示する場合に，-resnameとともに指定します。

-listenertype <メッセージリスナのタイプ名>

指定したメッセージリスナのアクティブ化のために設定が必要なプロパティ名を表示する場合に，-resnameとともに指定します。

入力例

EJB-JARファイルの場合

cjlistres MyServer -type ejb

WARファイルの場合

cjlistres MyServer -type war

データソースファイルの場合

cjlistres MyServer -type datasource

メールの場合

cjlistres MyServer -type mail

RARファイルの場合

cjlistres MyServer -type rar

出力形式

EJB-JARファイルの場合（-resname指定なし）

<EJB-JARファイルの表示名>
<EJB-JARファイルの表示名>
・・・

EJB-JARファイルの場合（-resname指定あり）

<Enterprise Beanの表示名>
<Enterprise Beanの表示名>
・・・

WARファイルの場合（-resname指定なし）

<WARファイルの表示名>
<WARファイルの表示名>
・・・

WARファイルの場合（-resname指定あり）

<サーブレット／JSP，フィルタの表示名>
<サーブレット／JSP，フィルタの表示名>
・・・

データソースファイルの場合

<データソースファイルの表示名>
<データソースファイルの表示名>
・・・

メールの場合

<メールの表示名>
<メールの表示名>
・・・

RARファイルの場合（-resnameおよび-spec指定なし）

<RARファイルの表示名>
<RARファイルの表示名>
・・・

RARファイルの場合（-spec指定あり）

<コネクタアーキテクチャの仕様バージョン> <RARファイルの表示名>
<コネクタアーキテクチャの仕様バージョン> <RARファイルの表示名>
・・・

RARファイルの場合（-resnameおよび-outbound指定あり）

<コネクション定義識別子>
<コネクション定義識別子>
・・・

RARファイルの場合（-resnameおよび-inbound指定あり）

<メッセージリスナのタイプ>
<メッセージリスナのタイプ>
・・・

RARファイルの場合（-resnameおよび-listenertype指定あり）

<プロパティ名>
<プロパティ名>
・・・

戻り値

0：

正常終了しました。

1：

異常終了しました。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-nameserver ejb -type <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

一覧は大文字小文字の区別なしで，昇順でソートされます。

cjsetjbprop（JavaBeansリソースの属性設定）

形式

cjsetjbprop [<サーバ名称>] [-nameserver <プロバイダURL>]
            -resname <JavaBeansリソース表示名> -c <属性ファイルパス>

機能

-resnameで指定されたJavaBeansリソースの属性を，指定したJavaBeansリソース属性ファイルの値に変更します。JavaBeansリソース属性ファイルの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.2　JavaBeansリソース属性ファイル」を参照してください。

指定したJavaBeansリソースは存在している必要があります。

JavaBeansリソースの表示名は，属性ファイルの<display-name>タグで指定したものに置き換わります。

すでにスタート状態にあるJavaBeansリソースの属性は変更できません。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-resname <JavaBeansリソース表示名>

設定対象のJavaBeansリソース表示名を指定します。

-c <属性ファイルパス>

属性ファイルの入力元パスを指定します。

入力例

cjsetjbprop MyServer -resname MyJavaBEansName -c MyJavaBeansProp.xml

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドが実行できません。

3：

タイムアウトエラーが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<アプリケーション名> -name）やオプション名と値を非対応にすること（例：-resname <属性ファイルパス> -c <JavaBeansリソース表示名>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjsetrarprop（RAR属性設定）

形式

cjsetrarprop ［<サーバ名称>］［-nameserver <プロバイダURL>］
              -resname <リソースアダプタ表示名> -c <属性ファイルパス>

機能

-resnameに指定されたデプロイ済みのRARファイルに含まれるリソースの属性を属性ファイルに指定された値に変更します。

RARファイルの属性を設定するのは，Connector属性ファイルです。Connector属性ファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1　Connector属性ファイル」を参照してください。

リソースの表示名は，属性ファイルの<display-name>タグで指定したものに置き換わります。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-resname <リソースアダプタ表示名>

設定対象リソース（デプロイ済みのリソースアダプタ）の表示名を指定します。

-c <属性ファイルパス>

属性ファイルの入力元パスを指定します。

入力例

cjsetrarprop MyServer -resname account-rar -c MyRarprop.xml

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<リソースアダプタ表示名> -resname）やオプション名と値を非対応にすること（例：-resname <属性ファイルパス> -c <リソースアダプタ表示名>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjsetresprop（リソースの属性設定）

形式

EJB-JARファイルおよびWARファイルの場合

cjsetresprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -type {ejb|war}
             -resname <リソース表示名>[/<下位リソース表示名>]
             -c <属性ファイルパス>

データソースファイルの場合

cjsetresprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -type datasource -resname <データソース表示名>
             -c <属性ファイルパス>

メールの場合

cjsetresprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -type mail -resname <メール表示名> -c <属性ファイルパス>

RARファイルの場合

cjsetresprop [<サーバ名称>] [-nameserver <プロバイダURL>]
             -type rar -resname <リソースアダプタ表示名>
             -c <属性ファイルパス>

機能

EJB-JARファイルに含まれるリソース（EJB-JARファイル，Session Bean，Entity Bean，Message-driven Bean），WARファイルに含まれるリソース（WARファイル，サーブレット／JSP，フィルタ），データソースファイル，メール，またはデプロイ前のRARファイルに含まれるリソースの属性を属性ファイルに指定された値に変更します。

下位リソース表示名が指定されない場合はEJB-JARファイル，WARファイルの指定となります。

J2EEアプリケーションとリソースの設定で使用する属性ファイルについては，次の個所を参照してください。

マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「3.　J2EEアプリケーションの設定で使用する属性ファイル」

マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.　リソースの設定で使用する属性ファイル」

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-type {ejb|war|datasource|mail|rar}

設定するリソースの種別を指定します。

ejb：EJB-JARファイルまたはEJB-JARファイル中のリソースの属性

war：WARファイルまたはWARファイル中のリソースの属性

datasource：データソースファイル

mail：メール

rar：デプロイ前のRARファイルの属性

-resname <リソース表示名，データソース表示名，メール表示名またはリソースアダプタ表示名>

設定対象リソースの表示名を指定します。

EJB-JARファイルの場合：<EJB-JARファイルの表示名>

EJBファイルの場合：<EJB-JARファイルの表示名>[/<Enterprise Beanの表示名>]

WARファイルの場合：<WARファイルの表示名>

サーブレット／JSPの場合：<WARファイルの表示名>[/<サーブレット／JSPの表示名>]

フィルタの場合：<WARの表示名>[/<フィルタの表示名>]

データソースファイルの場合：<データソースファイルの表示名>

メールの場合：<メールの表示名>

RARファイルの場合：<RARファイルの表示名>

-c <属性ファイルパス>

属性ファイルの入力元パスを指定します。

入力例

EJB-JARファイルの場合

cjsetresprop MyServer -type ejb -resname accountJsp/MyAccount -c MyAccountProp.xml

WARファイルの場合

cjsetresprop MyServer -type war -resname account-war/Account -c AccountProp.xml

データソースファイルの場合

cjsetresprop MyServer -type datasource -resname JdbcDbpsv -c JdbcDbpsvProp.xml

メールの場合

cjsetresprop MyServer -type mail -resname Mail -c MailProp.xml

RARファイルの場合

cjsetresprop MyServer -type rar -resname account-ra -c AccountProp.xml

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<リソース表示名> -resname）やオプション名と値を非対応にすること（例：-resname ejb -type <リソース表示名>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

属性ファイルに設定されたsecurity-role/link-toの値は無視されます。指定されたリソースがSession Bean，Entity Bean，またはWARファイルの場合はruntimeの値も無視されます。

データソース表示名は，属性ファイルの<display-name>タグで指定したものに置き換わります。

リソース表示名は，属性ファイルの<display-name>タグで指定したものに置き換わります。

データソースの場合，指定した表示名は存在している必要があります。

メールの場合，指定した表示名が存在しないときは新規登録として扱います。新規登録では，英数字（0〜9，A〜Z，a〜z）または次の特殊文字を使用できます。ただし，先頭または末尾に半角スペースがある名前を指定した場合，半角スペースを除去して使用されます。また，既存のものに設定する場合，メール表示名は，プロパティファイルの<display-name>タグで指定したものに置き換わります。

スペース（ ），エクスクラメーションマーク（!），シャープ（#），ドル記号（$），パーセント（%），アンパサンド（&），バーレン（(）（)），プラス（+），ハイフン（-），ピリオド（.），セミコロン（;），レスザン（<），グレーターザン（>），単価記号（@），ブラケット（[）（]），円マーク（¥），キャレット（^），アンダースコア（_），バッククォート（`），ブレイス（{）（}），ストローク（|），チルダ（~）

DDファイル（ejb-jar.xml）の<security-role-ref>-<role-link>タグを設定している場合，EJB-JAR属性ファイルを設定すると，DDファイル（ejb-jar.xml）の<security-role-ref>-<role-link>タグの値がクリアされることがあります。

cjstartjb（JavaBeansリソースの開始）

形式

cjstartjb [<サーバ名称>] [-nameserver <プロバイダURL>]
          -resname <JavaBeansリソース表示名>

機能

JavaBeansリソースを開始します。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-resname <JavaBeansリソース表示名>

JavaBeansリソースの表示名を指定します。

入力例

cjstartjb MyServer -resname javabeansname

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドが実行できません。

3：

タイムアウトエラーが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-nameserver JavaBeans <リソース表示名> -resname<プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjstartrar（リソースアダプタの開始）

形式

cjstartrar [<サーバ名称>] [-nameserver <プロバイダURL>]
           -resname <リソースアダプタ表示名>

機能

指定されたデプロイ済みのリソースアダプタを開始します。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-resname <リソースアダプタ表示名>

デプロイされたリソースアダプタの表示名を指定します。

入力例

cjstartrar MyServer -resname account-ra

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<リソースアダプタ表示名> -resname）やオプション名と値を非対応にすること（例：-resname <プロバイダURL> -nameserver <リソースアダプタ表示名>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjstopjb（JavaBeansリソースの停止）

形式

cjstopjb [<サーバ名称>] [-nameserver <プロバイダURL>]
         -resname <JavaBeansリソース表示名>

機能

開始状態のJavaBeansリソースを停止します。

アプリケーションから使用されるJavaBeansリソースを停止する場合は，先にJavaBeansリソースを使用するアプリケーションを停止しておく必要があります。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-resname <JavaBeansリソース表示名>

JavaBeansリソースの表示名を指定します。

入力例

cjstopjb MyServer -resname javabeansname

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドが実行できません。

3：

タイムアウトエラーが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<アプリケーション名> -name）やオプション名と値を非対応にすること（例：-nameserver <JavaBeansリソース表示名> -resname <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjstoprar（リソースアダプタの停止）

形式

cjstoprar [<サーバ名称>] [-nameserver <プロバイダURL>]
          -resname <リソースアダプタ表示名>

機能

開始されているリソースアダプタを停止します。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-resname <リソースアダプタ表示名>

停止するリソースアダプタ名を指定します。

入力例

cjstoprar MyServer -resname account-ra

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<リソースアダプタ表示名> -resname）やオプション名と値を非対応にすること（例：-resname <プロバイダURL> -nameserver <リソースアダプタ表示名>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjtestres（リソースの接続テスト）

形式

データソースおよびメールの場合

cjtestres [<サーバ名称>] [-nameserver <プロバイダURL>]
          -type {datasource|mail}
          -resname <表示名> [-resname <表示名> ...]

J2EEリソースアダプタとしてデプロイして使用するリソースアダプタの場合

cjtestres [<サーバ名称>] [-nameserver <プロバイダURL>]
          -type rar
          -resname <表示名> [-resname <表示名> ...]

アプリケーションに含めて使用するリソースアダプタの場合

cjtestres [<サーバ名称>] [-nameserver <プロバイダURL>]
          -name <アプリケーション名> -type rar
          -resname <表示名> [-resname <表示名> ...]

機能

J2EEリソースアダプタ，メールおよびデータソースの接続テストをします。

リソースアダプタにコネクション定義が複数ある場合，すべてのコネクション定義に対して接続テストをします。コネクション定義のどれかでエラーが発生した場合でもすべてのコネクション定義に対して接続テストを実行します。

なお，Inboundリソースアダプタの接続テストはできません。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-name <アプリケーション名>

アプリケーションに含まれるリソースアダプタの接続テストをする場合に，アプリケーション名を指定します。

-type {datasource|mail|rar}

接続テストの対象となるリソースの種別を指定します。

datasource：データソースファイル

mail：メール

rar：RARファイル

-resname <表示名>

接続テストの対象となるデータソースファイル，メール，またはRARファイルの表示名を指定します。このオプションは，複数回指定できます。

入力例

データソースの場合

cjtestres -type datasource -resname Myds1

メールの場合

cjtestres -type mail -resname Mymail1

J2EEリソースアダプタとしてデプロイして使用するリソースアダプタの場合

cjtestres -type rar -resname Myrar1

アプリケーションに含めて使用するリソースアダプタの場合

cjtestres -name App1 -type rar -resname Myrar1

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<表示名> -resname）やオプション名と値を非対応にすること（例：-nameserver <表示名> -resname <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjundeployrar（リソースアダプタのアンデプロイ）

形式

cjundeployrar [<サーバ名称>] [-nameserver <プロバイダURL>]
              -resname <リソースアダプタ表示名>
              [-resname <リソースアダプタ名> ...]

機能

指定されたリソースアダプタをアンデプロイします。デプロイされているリソースアダプタが対象となります。一度に複数のリソースアダプタをアンデプロイできます。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-resname <リソースアダプタ表示名>

リソースアダプタ名を指定します。

入力例

cjundeployrar MyServer -resname account-ra

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<リソースアダプタ名> -resname）やオプション名と値を非対応にすること（例：-resname <プロバイダURL> -nameserver <リソースアダプタ名>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

一度に複数のリソースアダプタをアンデプロイする場合，削除できないリソースアダプタがあるときでも，すべてのリソースアダプタの削除を試みます。

一度でも開始・接続テストを試みたJ2EEリソースアダプタは，J2EEサーバを再起動するまでアンデプロイできません。

2.5　J2EEサーバで使用するそのほかのコマンド

ここでは，J2EEサーバで使用するそのほかのコマンドについて説明します。

J2EEサーバで使用するそのほかのコマンドの一覧を，次の表に示します。

表2‒6　J2EEサーバで使用するそのほかのコマンドの一覧

コマンド名称

分類

概要

コマンドの系統

cjaddsec

ユーザとロールの追加

ユーザまたはロールを追加します。

更新

cjclearsession

グローバルセッション情報の削除（データベースセッションフェイルオーバ機能）

データベース上のグローバルセッション情報を削除します。

−

cjcommittrn

未決着のトランザクションのコミット

未決着状態のトランザクションをコミットします。

更新

cjdeletesec

ユーザとロールの削除

ユーザまたはロールを削除します。

更新

cjforgettrn

ヒューリスティック状態のトランザクションの強制決着

ヒューリスティック状態のトランザクションを強制決着します。

更新

cjlistsec

ユーザとロールの一覧表示

ユーザまたはロールの一覧を標準出力に出力します。

参照

cjlistthread

スレッド情報の表示

処理中のスレッドに関する情報を出力します。

参照

cjlisttrn

稼働中のJ2EEサーバのトランザクション情報の表示

J2EEサーバで稼働しているトランザクション情報の一覧を標準出力に出力します。

特権

cjlisttrnfile

停止中のJ2EEサーバのトランザクション情報の表示

停止中のJ2EEサーバのトランザクション情報の一覧を標準出力に出力します。

−

cjmapsec

ユーザとロールのマッピング

ロールにユーザを追加します。

更新

cjresetsv

サーバ管理コマンドの排他強制解除

サーバ管理コマンドの排他情報をリセットして，サーバ管理コマンドを実行できるようにします。

−

cjrollbacktrn

未決着のトランザクションのロールバック

未決着状態のトランザクションをロールバックします。

更新

cjstopthread

スレッドの削除

指定したスレッドを削除します。

更新

cjunmapsec

ユーザとロールのアンマッピング

ロールからユーザを削除します。

更新

（凡例）

更新：更新系コマンド。J2EEサーバの内容を更新，または構成情報を取得するコマンドです。

参照：参照系コマンド。J2EEサーバの内容を更新しないで，構成状態を表示するだけのコマンドです。

特権：特権系コマンド。J2EEサーバの内容を更新するコマンドで，常にほかのコマンドよりも優先して処理されるコマンドです。

−：該当なし

サーバ管理コマンドの系統ごとの排他制御の条件については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「3.2　サーバ管理コマンドの排他制御」を参照してください。

cjaddsec（ユーザとロールの追加）

形式

ユーザの場合

cjaddsec [<サーバ名称>] [-nameserver <プロバイダURL>]
         -type user -name <ユーザ名> -password <パスワード>

ロールの場合

cjaddsec [<サーバ名称>] [-nameserver <プロバイダURL>]
         -type role -name <ロール名>

機能

ユーザまたはロールを追加します。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-type {user|role}

追加するリソースの種別を指定します。

user：ユーザ

role：ロール

-name {<ユーザ名>|<ロール名>}

ユーザ名またはロール名を指定します。

-password <パスワード>

ユーザ認証時に使用するパスワードを指定します。

入力例

ユーザの場合

cjaddsec MyServer -type user -name scott -password tiger

ロールの場合

cjaddsec MyServer -type role -name manager

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-type <ユーザ名> -name user）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

すでに存在するユーザ名またはロール名は指定できません。

-passwordオプションにパスワードを指定した場合，このコマンドの実行中に，プロセスの引数を確認できるOS機能などでパスワードが観測されるおそれがあります。-passwordオプションを使用する際は，プロセスの引数を確認できるOS機能などを，他ユーザが使用できない状況下で実施してください。

cjclearsession（グローバルセッション情報の削除（データベースセッションフェイルオーバ機能））

形式

データベースに接続するユーザ名とパスワードをコマンドに直接入力する場合

cjclearsession [-count] [-dbtype {hirdb|oracle}]
             <JDBCドライバに指定するURL><データベースのユーザ名>
             <データベースのパスワード><アプリケーション識別子><サーバID>

データベースに接続するユーザ名とパスワードを対話形式で入力する場合

cjclearsession [-count] [-dbtype {hirdb|oracle}] -interactive
             <JDBCドライバに指定するURL>
             <アプリケーション識別子><サーバID>

機能

データベース上のグローバルセッション情報を削除，またはデータベース上のグローバルセッション情報数を表示します。なお，このコマンドは，データベースセッションフェイルオーバ機能を利用し，完全性保障モードを無効にした場合に使用できます。

このコマンドの引数にデータベースのパスワードを指定した場合，プロセスの引数を確認できるOS機能などでパスワードが観測されるおそれがあります。このため，-interactiveオプションによる対話形式でのパスワードの設定を推奨します。

引数

-count

データベース上のグローバルセッション情報数を表示する場合に指定します。省略したときは，グローバルセッション情報を削除します。

-dbtype {hirdb|oracle}

接続するデータベースの種類を指定します。省略したときは，hirdbが指定されたと見なされます。

hirdb：HiRDBに接続する場合

oracle：Oracleに接続する場合

-interactive

データベースに接続するユーザ名とパスワードを対話形式で入力する場合に指定します。このオプションを指定してコマンドを実行すると，次のプロンプトが表示され，データベースのユーザ名の入力を待つ状態になります。

> User ID:

ここで入力するユーザ名は，データベースのテーブル操作の権限があるユーザにしてください。権限の詳細は，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「6.6.3(1)　データベース接続に必要な権限」を参照してください。データベースのユーザ名を入力すると，次のプロンプトが表示され，データベースのパスワードの入力を待つ状態になります。

> Password:

コマンドプロンプトやコンソールなどから直接実行した場合，パスワードをエコーバックしません。ほかのプログラムから間接的に実行した場合は，パスワードをエコーバックすることがあります。

<JDBCドライバに指定するURL>

データベースに接続するためのJDBCドライバに指定するURLを指定します。URLの構文については，ご使用のデータベースのマニュアルを参照してください。

<データベースのユーザ名>

データベースに接続するユーザを指定します。

<データベースのパスワード>

データベースに接続するユーザのパスワードを指定します。

<アプリケーション識別子>

削除または表示対象とするWebアプリケーションのアプリケーション識別子を指定します。

<サーバID>

削除または表示対象のグローバルセッション情報を所有するJ2EEサーバのサーバIDを指定します。

入力例

データベース上のグローバルセッション情報の削除の場合

cjclearsession -dbtype hirdb jdbc:hitachi:hirdb://DBID=22200,DBHOST=DBSERVER USER PASS APPID SERVERID

データベース上のグローバルセッション情報数の表示の場合

cjclearsession -count -dbtype hirdb jdbc:hitachi:hirdb://DBID=22200,DBHOST=DBSERVER USER PASS APPID SERVERID

戻り値

0：

正常終了しました。

1：

構文エラーです。

2：

1以外のエラーです。

cjcommittrn（未決着のトランザクションのコミット）

形式

cjcommittrn [<サーバ名称>] [-nameserver <プロバイダURL>]
            -gid <グローバルトランザクションID>

機能

J2EEサーバ内に存在する未決着状態（Prepared）のグローバルトランザクションIDを指定して，トランザクションをコミットします。なお，このコマンドはTP1インバウンド連携機能を利用する場合に使用できます。

指定したグローバルトランザクションIDが存在する場合，トランザクションを決着します。

指定したグローバルトランザクションIDが不正な場合，KFCB40122-E，およびUsage（KFCB40130-E）を返します。

指定したグローバルトランザクションIDが存在しない場合，KFCB40131-Eを返しUsageは返しません。

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）の設定で，ejbserver.distributedtx.XATransaction.enabledキーの値が，trueの場合に実行できます。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-gid <グローバルトランザクションID>

コミットするトランザクションの，グローバルトランザクションIDを指定します。

入力例

cjcommittrn MyServer -gid d13800010000000000000000000000fefb57e6480000000000000001

戻り値

0：

正常終了しました。

1：

異常終了しました。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-nameserver <グローバルトランザクションID> -gid <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

次のどれかに示す場所で問題が発生した場合，KFCB40137-Eが返されコミットされません。メッセージ内容を基に問題を解決し，コマンドを再度実行してください。

リソースマネージャ

リソースマネージャへの通信経路

ほかのJ2EEサーバ

ほかのJ2EEサーバへの通信経路

cjdeletesec（ユーザとロールの削除）

形式

cjdeletesec [<サーバ名称>] [-nameserver <プロバイダURL>]
            -type {user|role} -name {<ユーザ名>|<ロール名>}

機能

ユーザまたはロールを削除します。

削除対象のユーザがロールにマップされている場合，そのロールからアンマップされます。削除対象のロールにマップされているユーザがある場合，そのユーザはアンマップされます。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-type {user|role}

削除するリソースの種別を指定します。

user：ユーザ

role：ロール

-name {<ユーザ名>|<ロール名>}

ユーザ名またはロール名を指定します。

入力例

ユーザの場合

cjdeletesec MyServer -type user -name scott

ロールの場合

cjdeletesec MyServer -type role -name manager

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）であれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-type <ユーザ名> -name user）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjforgettrn（ヒューリスティック状態のトランザクションの強制決着）

形式

cjforgettrn [<サーバ名称>] [-nameserver <プロバイダURL>]
            -gid <グローバルトランザクションID>

機能

ヒューリスティック決着（HeuristicCommit，HeuristicRollback，HeuristicMixed，HeuristicHazard）されたトランザクションのグローバルトランザクションIDを指定して強制終了します。なお，このコマンドはTP1インバウンド連携機能を利用する場合に使用できます。

指定したトランザクションのステータスがHeuristicCommit，HeuristicRollback，HeuristicMixed，HeuristicHazardのどれとも異なる場合，KFCB40135-Eを返します。

指定したグローバルトランザクションIDが存在する場合，トランザクションを強制終了します。

指定したグローバルトランザクションIDが不正な場合，KFCB40122-EとUsage（KFCB40134-E）を返します。

指定したグローバルトランザクションIDが存在しない場合，KFCB40131-Eを返しUsageは返しません。

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）の設定で，ejbserver.distributedtx.XATransaction.enabledキーの値が，trueの場合に実行できます。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-gid <グローバルトランザクションID>

強制決着するトランザクションの，グローバルトランザクションIDを指定します。

入力例

cjforgettrn MyServer -gid d13800010000000000000000000000fefb57e6480000000000000001

戻り値

0：

正常終了しました。

1：

異常終了しました。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-nameserver <グローバルトランザクションID> -gid <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

次のどれかに示す場所で問題が発生した場合，KFCB40137-Eが返され強制決着されません。メッセージ内容を基に問題を解決し，コマンドを再度実行してください。

リソースマネージャ

リソースマネージャへの通信経路

ほかのJ2EEサーバ

ほかのJ2EEサーバへの通信経路

cjlistsec（ユーザとロールの一覧表示）

形式

cjlistsec [<サーバ名称>] [-nameserver <プロバイダURL>]
          -type {user|role} [-name {<ユーザ名>|<ロール名>}]

機能

ユーザまたはロールの一覧を標準出力に出力します。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-type {user|role}

表示するリソースの種別を指定します。

user：ユーザ

role：ロール

-name {<ユーザ名>|<ロール名>}

ユーザ名またはロール名を指定します。

入力例

すべてのユーザの場合

cjlistsec MyServer -type user

任意のユーザのロールの場合

cjlistsec MyServer -type user -name scott

すべてのロールの場合

cjlistsec MyServer -type role

任意のロールのユーザの場合

cjlistsec MyServer -type role -name manager

戻り値

0：

正常終了しました。

1：

異常終了しました。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-type <ユーザ名> -name user）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

一覧は大文字小文字の区別なしで，昇順でソートされます。

cjlistthread（スレッド情報の表示）

形式

スタックトレースを出力しない場合

cjlistthread [<サーバ名称>] [-nameserver <プロバイダURL>]

スタックトレースを出力する場合

cjlistthread [<サーバ名称>] [-nameserver <プロバイダURL>] -detail

機能

処理中のスレッドに関する，スレッドID，ルートAP情報，スレッドの状態，アプリケーション名，実行中メソッドの開始時刻，タイムアウト設定値などの情報を出力します。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-detail

このオプションが指定されている場合，最後に取得されたスタックトレースの情報が出力されます。ただし，スレッドの状態が「running」のスレッドに対して

このオプションを指定してもスタックトレースの情報は出力されません。

入力例

スタックトレースを出力しない場合

cjlistthread MyServer

スタックトレースを出力する場合

cjlistthread MyServer -detail

出力形式

ThreadID=<スレッドID>,RootApInfo=<ルートAP情報>,Status=<スレッドの状態>,AppName=<アプリケーション名>,StartTime=<開始時刻>,TimeOut=<タイムアウト時間>

出力例

スタックトレースを出力しない場合

Current Time=HH:MM:SS

ThreadID=aa..aa,RootApInfo=bb..bb,Status=cc..cc,AppName=dd..dd,StartTime=ee..ee,TimeOut=ff..ff
ThreadID=aa..aa,RootApInfo=bb..bb,Status=cc..cc,AppName=dd..dd,StartTime=ee..ee,TimeOut=ff..ff
…

スタックトレースを出力する場合

Current Time=HH:MM:SS
ThreadID=aa..aa,RootApInfo=bb..bb,Status=cc..cc,AppName=dd..dd,StartTime=ee..ee,TimeOut=ff..ff
    com.hitachi.XXXX
     at com.hitachi.YYYY
     at user.code.UserClass1
     at com.hitachi.ZZZZ
…
…
ThreadID=aa..aa,RootApInfo=bb..bb,Status=cc..cc,AppName=dd..dd,StartTime=ee..ee,TimeOut=ff..ff
    com.hitachi.xxxx
     at com.hitachi.yyyy
     at user.code.UserClass2
     at com.hitachi.zzzz
…
…

（凡例）

aa..aa：スレッドID
bb..bb：ルートAP情報
cc..cc：スレッドの状態
dd..dd：アプリケーション名
ee..ee：開始時刻
ff..ff：タイムアウト時間

戻り値

0：

正常終了しました。

1：

異常終了しました。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver ）やオプション名と値を非対応にすること（例：-nameserver <アプリケーション名> -name <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjlisttrn（稼働中のJ2EEサーバのトランザクション情報の表示）

形式

cjlisttrn [<サーバ名称>] [-nameserver <プロバイダURL>]
          [-gid <グローバルトランザクションID>] [-pending]
          [-time <経過時間>] [-bqual] [-tp1]

機能

指定したJ2EEサーバで稼働しているトランザクションの状態，経過時間などを一覧表示します。

同一OS上で複数のJ2EEサーバを起動している場合は，トランザクションに関連するすべてのJ2EEサーバプロセスごとにこのコマンドを発行する必要があります。

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）の設定で，ejbserver.distributedtx.XATransaction.enabledキーの値が，trueの場合に実行できます。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-gid <グローバルトランザクションID>

表示対象となる，グローバルトランザクションIDを指定します。

-pending

このオプションが指定されている場合，次の未決着処理中のトランザクションについての情報が表示されます。

Preparing

Prepared

Committing

Rollingback

HeuristicCommit

HeuristicRollback

HeuristicMixed

HeuristicHazard

-time <経過時間>

トランザクションを開始してからの経過時間を，0〜2147483647の整数（単位：秒）で指定します。このオプションで指定した時間を経過しているトランザクションについて情報が表示されます。

-bqual

このオプションが指定されている場合，トランザクションに関連している，すべてのXidのブランチIDを表示します。

-tp1

アプリケーションサーバのグローバルトランザクションIDに対応する，OpenTP1のトランザクショングローバル識別子，およびトランザクションブランチ識別子を表示します。

OpenTP1と連携しているトランザクションが存在する場合，OpenTP1のトランザクショングローバル識別子，およびトランザクションブランチ識別子を出力結果に追加して表示します。

OpenTP1と連携していないトランザクションの場合，OpenTP1のトランザクショングローバル識別子，およびトランザクションブランチ識別子は表示しません。

入力例

cjlisttrn MyServer -gid d13800010000000000000000000000fefb57e6480000000000000001 -bqual

出力形式

引数に-tp1を指定している場合

[Global transaction information]
Status            GlobalTransactionId                                      ElapsedTime BranchType     TP1TRNGID        TP1TRNBID
----------------- -------------------------------------------------------- ----------- -------------- ---------------- ----------------
<トランザクションの状態> <グローバルトランザクションID>                    <経過時間>  <ブランチの種類>  <OpenTP1のGID>  <OpentTP1のBID>
[<XidのブランチID一覧>]
<トランザクションの状態> <グローバルトランザクションID>                    <経過時間>  <ブランチの種類>  <OpenTP1のGID>  <OpentTP1のBID>
[<XidのブランチID一覧>]
・・・

total count <表示エントリ数>

引数に-tp1を指定していない場合

[Global transaction information]
Status                 GlobalTransactionID            ElapsedTime BranchType
----------------- -------------------------------------------------------- ----------- --------------
<トランザクションの状態> <グローバルトランザクションID> <経過時間>  <ブランチの種類>
[<XidのブランチID一覧>]
<トランザクションの状態> <グローバルトランザクションID> <経過時間>  <ブランチの種類>
[<XidのブランチID一覧>]
・・・
total count <表示エントリ数>

<トランザクションの状態>

Active            : アクティブな状態。
MarkedRollback    : ロールバックにマークされた状態。
Preparing         : プリペア処理中。
Prepared          : Superiorからの決着指示待ち状態。
Committing        : コミット処理中。
RollingBack       : ロールバック処理中。
HeuristicCommit   : 強制コミットされた状態。
HeuristicRollback : 強制ロールバックされた状態。
HeuristicMixed    : 部分的にコミットまたはロールバックされたため，データの一貫性が失われた状態。
HeuristicHazard   : コミットしたかロールバックしたか，わからない状態。
Invalid           : 上記以外で内部矛盾が発生した状態。

<グローバルトランザクションID>

対象のグローバルトランザクションIDが表示されます。

<経過時間>

トランザクションを開始してからの経過時間が表示されます。ただし，<ブランチの種類>が「Top（recovered）」または「Sub（recovered）」のトランザクションの場合は，ステータスファイルから回復されてからの経過時間を，「Xid（recovered）」のトランザクションの場合は，Xid回復後に新規に作成されてからの経過時間が表示されます。

<ブランチの種類>

Top           ：トップルートブランチ。
Sub           ：サブオーディネートブランチ。
Top(recovered)：ステータスファイルから回復されたトップルートブランチ。
Sub(recovered)：ステータスファイルから回復されたサブオーディネートブランチ。
Xid(recovered)：XAResourceからXidが回復されたが，これに対応するブランチが存在しないため，新規に生成されたブランチ。

<XidのブランチID一覧>

トランザクションに関連しているすべてのXidのブランチIDが表示されます。

<OpenTP1のGID>

アプリケーションサーバのグローバルトランザクションIDに対応する，OpenTP1のトランザクショングローバル識別子を表示します。

<OpentTP1のBID>

アプリケーションサーバのグローバルトランザクションIDに対応する，OpenTP1のトランザクションブランチ識別子を表示します。

<表示エントリ数>

表示したエントリの数が表示されます。

戻り値

0：

正常終了しました。

1：

異常終了しました。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver ）やオプション名と値を非対応にすること（例：-nameserver <グローバルトランザクションID> -gid <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

-gidオプション，-pendingオプション，および-timeオプションを同時に指定した場合，すべての条件を満たすトランザクションについての情報が出力されます。

cjlisttrnfile（停止中のJ2EEサーバのトランザクション情報の表示）

形式

cjlisttrnfile [<サーバ名称>] [-gid <グローバルトランザクションID>]
              [-bqual]

機能

停止中のJ2EEサーバに生成されたステータスファイルからトランザクションの状態などを一覧表示します。コマンドを実行するホストに存在するJ2EEサーバだけがコマンドの対象となります。

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）で，ejbserver.distributedtx.XATransaction.enabledキーの値をtrueに設定し，J2EEサーバを起動した場合に実行できます。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

指定されたサーバに設定されているステータスファイルディレクトリ情報から，対象となるステータスファイルが決定されます。ステータスファイルディレクトリ情報とは，usrconf.properties（J2EEサーバ用ユーザプロパティファイル）で指定する次のプロパティ値のことです。

ejbserver.distributedtx.ots.status.directory1

ejbserver.distributedtx.ots.status.directory2

-gid <グローバルトランザクションID>

表示対象となる，グローバルトランザクションIDを指定します。

-bqual

このオプションが指定されている場合，トランザクションに関連している，すべてのXidのブランチIDを表示します。

入力例

Prompt> cjlisttrnfile MyServer -gid d13800010000000000000000000000fefb57e6480000000000000001 -bqual

出力形式

[Global transaction information(status file)]
status file1: <ステータスファイル名>
[status file2: <ステータスファイル名>]
host       (recorded in status file): "<ホスト名>"
J2EE server(recorded in status file): "<サーバ名称>"

Status                   GlobalTransactionId            BranchType
------------------------ ------------------------------ ----------------
<トランザクションの状態> <グローバルトランザクションID> <ブランチの種類>
[<XidのブランチID一覧>]
<トランザクションの状態> <グローバルトランザクションID> <ブランチの種類>
[<XidのブランチID一覧>]
・・・

total count: <表示エントリ数>

<ステータスファイル名>

このコマンドで表示対象となるステータスファイルの名称が表示されます。

<ホスト名>

上記のステータスファイルを生成したホスト名，またはIPアドレス（ステータスファイルに書き込まれているホスト名またはIPアドレス）が表示されます。

<サーバ名称>

上記ステータスファイルを生成したJ2EEサーバ名（ステータスファイルに書き込まれているJ2EEサーバ名）が表示されます。

<グローバルトランザクションID>

対象のグローバルトランザクションIDが表示されます。

<トランザクションの状態>

Prepared          : Superiorからの決着指示待ち状態。
Committing        : コミット処理中。
HeuristicCommit   : 強制コミットされた状態。
HeuristicRollback : 強制ロールバックされた状態。
HeuristicMixed    : 部分的にコミットまたはロールバックされたため，データの一貫性が失われた状態。
HeuristicHazard   : コミットしたかロールバックしたか，わからない状態。
Invalid           : 上記以外で内部矛盾が発生した状態。

<ブランチの種類>

Top           ：トップルートブランチ。
Sub           ：サブオーディネートブランチ。

<XidのブランチID一覧>

トランザクションに関連しているすべてのXidのブランチIDが表示されます。

<表示エントリ数>

表示したエントリの数が表示されます。

戻り値

0：

正常終了しました（トランザクションが存在しない）。

1：

異常終了しました。

6：

警告終了しました（トランザクションが存在する）。

7：

警告終了しました（トランザクションが存在するかどうかわからない）。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

別のホストに存在するJ2EEサーバはコマンドの実行対象にできません。

J2EEサーバが起動された状態で，トランザクションの処理中にこのコマンドを実行した場合，表示内容の正当性は保証されません。必ずJ2EEサーバが停止している状態でコマンドを実行してください。また，コマンド実行中にJ2EEサーバを起動すると，インプロセストランザクションサービスの初期化に失敗することがあります。

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<グローバルトランザクションID> -gid ）やオプション名と値を非対応にすること（例：-gid -bqual <グローバルトランザクションID>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjmapsec（ユーザとロールのマッピング）

形式

cjmapsec [<サーバ名称>] [-nameserver <プロバイダURL>]
         -role <ロール名> -user <ユーザ名> [-user <ユーザ名> ...]

機能

ロールにユーザを追加します。一度に複数のユーザのマッピングもできます。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-role <ロール名>

ロール名を指定します。

-user <ユーザ名>

ユーザ名を指定します。

入力例

cjmapsec MyServer -role manager -user scott

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-role <ユーザ名> -user <ロール名>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

すでに指定したロール名とユーザ名でマッピングされている場合，マッピングはできません。

一度に複数のユーザをマッピングした場合，マッピングできないユーザがあったときでも，すべてのユーザに対してマッピングを試みます。

cjresetsv（サーバ管理コマンドの排他強制解除）

形式

cjresetsv [<サーバ名称>] [-nameserver <プロバイダURL>]

機能

サーバ管理コマンドの異常終了などによって，サーバ管理コマンドの排他情報に矛盾が生じる場合があります。サーバ管理コマンドの排他情報に矛盾が生じた場合，ほかにサーバ管理コマンドを実行していなくても，次のメッセージが表示され，サーバ管理コマンドを実行できなくなります。

"KDJE37057-E  Another command is already running."

この場合に，このコマンドを実行すると，サーバ管理コマンドの排他情報をリセットして，サーバ管理コマンドを実行できるようになります。排他制御の対象となるコマンドは，サーバ管理コマンドとcjstopsvコマンドです。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

入力例

cjresetsv MyServer

戻り値

0：

正常終了しました。

1：

異常終了しました。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

このコマンドは，コマンドの処理がJ2EEサーバ側で実行中でない場合にだけ排他情報を削除します。コマンドの処理が実行中のため排他情報を削除できなかった場合は，エラーメッセージKDJE42355-Wを出力し，異常終了します。

コマンド排他情報が存在しない場合，このコマンドは正常終了します。

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。また，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-nameserver <サーバ名称>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjrollbacktrn（未決着のトランザクションのロールバック）

形式

cjrollbacktrn [<サーバ名称>] [-nameserver <プロバイダURL>]
            -gid <グローバルトランザクションID>

機能

J2EEサーバ内に存在する未決着状態（Prepared）のグローバルトランザクションIDを指定して，トランザクションをロールバックします。なお，このコマンドはTP1インバウンド連携機能を利用する場合に使用できます。

指定したグローバルトランザクションIDが存在する場合，トランザクションを決着します。

指定したグローバルトランザクションIDが不正な場合，KFCB40122-E，およびUsage（KFCB40133-E）を返します。

指定したグローバルトランザクションIDが存在しない場合，KFCB40131-Eを返しUsageは返しません。

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）の設定で，ejbserver.distributedtx.XATransaction.enabledキーの値が，trueの場合に実行できます。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-gid <グローバルトランザクションID>

ロールバックするトランザクションの，グローバルトランザクションIDを指定します。

入力例

cjrollbacktrn MyServer -gid d13800010000000000000000000000fefb57e6480000000000000001

戻り値

0：

正常終了しました。

1：

異常終了しました。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-nameserver <グローバルトランザクションID> -gid <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

次のどれかに示す場所で問題が発生した場合，KFCB40137-Eが返されロールバックされません。メッセージ内容を基に問題を解決し，コマンドを再度実行してください。

リソースマネージャ

リソースマネージャへの通信経路

ほかのJ2EEサーバ

ほかのJ2EEサーバへの通信経路

cjstopthread（スレッドの削除）

形式

cjstopthread [<サーバ名称>] [-nameserver <プロバイダURL>]
             -tid <スレッドID> [-tid <スレッドID> ...]

機能

指定したスレッドを停止します。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-tid <スレッドID>

停止させるスレッドのスレッドIDを指定します。このオプションは複数回指定できます。なお，スレッドIDの取得方法については，「cjlistthread（スレッド情報の表示）」を参照してください。

入力例

cjstopthread MyServer -tid 100234

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-nameserver <スレッドID> -tid <プロバイダURL>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

cjunmapsec（ユーザとロールのアンマッピング）

形式

cjunmapsec [<サーバ名称>] [-nameserver <プロバイダURL>]
           -role <ロール名> -user <ユーザ名> [-user <ユーザ名> ...]

機能

ロールからユーザを削除します。一度に複数のユーザのアンマップもできます。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nameserver <プロバイダURL>

CORBAネーミングサービスへのアクセスプロトコル，CORBAネーミングサービスが稼働しているホスト名，およびそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

指定内容の詳細については，「2.1.2　プロバイダURLについて」を参照してください。

-role <ロール名>

削除先のロール名を指定します。

-user <ユーザ名>

削除対象のユーザ名を指定します。

入力例

cjunmapsec MyServer -role manager -user scott

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

排他エラーによってコマンドを実行できません。

3：

タイムアウトが発生しました。

9：

管理者特権がないため，コマンドが実行できません（Windowsの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダURL> -nameserver）やオプション名と値を非対応にすること（例：-role <ユーザ名> -user <ロール名>）はできません。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

一度に複数のユーザをアンマップした場合，アンマップできないユーザがあったときでも，すべてのユーザに対してアンマップを試みます。

3　バッチサーバで使用するコマンド

この章では，バッチサーバで使用するコマンドの入力形式，機能などについて説明します。

3.1　バッチサーバで使用するコマンドの概要

ここでは，バッチサーバで使用するコマンドの種類，プロバイダURLについて説明します。

3.1.1　バッチサーバで使用するコマンドの種類

バッチサーバで使用するコマンドの種類について説明します。

バッチサーバで使用するコマンドの種類と格納先を，次の表に示します。

表3‒1　バッチサーバで使用するコマンドの種類と格納先

バッチサーバで使用するコマンドの種類

コマンドの格納先

バッチサーバを操作するコマンド

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥bin¥

UNIXの場合

/opt/Cosminexus/CC/server/bin/

バッチアプリケーションで使用するコマンド

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥batch¥bin¥

UNIXの場合

/opt/Cosminexus/CC/batch/bin/

バッチサーバで使用するリソース操作コマンド

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥admin¥bin¥

UNIXの場合

/opt/Cosminexus/CC/admin/bin/

バッチサーバで使用するそのほかコマンド

3.1.2　プロバイダURLについて

CORBAネーミングサービスへのアクセスプロトコル，およびCORBAネーミングサービスが稼働しているホスト名称，ならびにそれが使用しているポート番号を次に示す形式で指定します。

<プロトコル名称>::<ホスト名称>:<ポート番号>

なお，該当するCORBAネーミングサービスは，接続先バッチサーバがネーミングサービスとして利用しているものです。サポートしているアクセスプロトコルはcorbanameだけです。

<ホスト名称>にはCORBAネーミングサービスが稼働しているホスト名称を指定します。ただし，接続先バッチサーバのusrconf.properties（バッチサーバ用ユーザプロパティファイル）でvbroker.se.iiop_tp.hostキーに値を指定している場合は，vbroker.se.iiop_tp.hostキーに指定した値を<ホスト名称>に指定します。

<ホスト名称>を省略した場合は次のようになります。

usrconf.properties（サーバ管理コマンド用システムプロパティファイル）の"ejbserver.naming.protocol"キーの値をアクセスプロトコルとして使用します。

"ejbserver.naming.host"キーの値をホスト名称として使用します。

"ejbserver.naming.port"キーの値をポート番号として使用します。

また，<ホスト名称>のデフォルト値は次のとおりです。

"ejbserver.naming.protocol"キー：corbaname

"ejbserver.naming.host"キー：localhost

"ejbserver.naming.port"キー：900

3.2　バッチサーバを操作するコマンド

ここでは，バッチサーバを操作するコマンドについて説明します。

バッチサーバを操作するコマンドの一覧を，次の表に示します。

表3‒2　バッチサーバを操作するコマンドの一覧

コマンド名称

分類

概要

コマンドの系統

cjdumpsv※1

バッチサーバのスレッドダンプの取得

バッチサーバで障害が発生した場合などに，JavaVMのスレッドダンプを取得します。

−

cjenvsetup※1

Component Container管理者のセットアップ

インストールファイルの属性を変更して，root権限を持つユーザ以外で運用できるようにします。このコマンドは，UNIX用です。

−

cjenvupdate※1

作業ディレクトリおよびユーザ定義ファイルの移行

Component Containerの旧環境で利用されていた作業ディレクトリおよびユーザ定義ファイルを新環境で動作する形式に移行します。

−

cjgetsysinfo※1

OS状態情報の取得

OSの状態情報を取得します。

−

cjrarupdate※1

リソースアダプタのバージョンアップ

Component Containerにインポート・デプロイされているリソースアダプタをバージョンアップします。

−

cjsetup

バッチサーバのセットアップとアンセットアップ

バッチサーバの環境をセットアップして，デフォルトのユーザ定義を作成します。

−

cjsleep※1

バッチサーバの起動間隔

指定された秒数だけ実行を一時停止します。バッチファイルなどでサーバの起動間隔を空けるために使用します。このコマンドは，Windows用です。

−

cjstartsv

バッチサーバの開始

バッチサーバを開始します。

−

cjstopsv※1

バッチサーバの停止

バッチサーバを停止します。

更新※2

（凡例）

更新：更新系コマンド。バッチサーバの内容を更新，または構成情報を取得するコマンドです。

−：該当なし

注※1

コマンドの詳細は，「2.2　J2EEサーバを操作するコマンド」を参照してください。なお，参照する場合は「J2EEサーバ」を「バッチサーバ」と読み替えてください。

注※2

-fオプションを指定した場合は，−（該当なし）になります。

サーバ管理コマンドの系統ごとの排他制御の条件については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「3.2　サーバ管理コマンドの排他制御」を参照してください。

セットアップ系コマンド（cjenvsetup，cjenvupdate，cjrarupdate，cjsetup）は単独で実行してください。ほかのセットアップ系コマンドと同時に実行しないでください。

cjsetup（バッチサーバのセットアップとアンセットアップ）

形式

セットアップの場合

cjsetup -batch [<サーバ名称>]

アンセットアップの場合

cjsetup -d <サーバ名称>

機能

指定したサーバ名称のバッチサーバの環境をセットアップします。

次のディレクトリにセットアップしたバッチサーバ用のデフォルトのユーザ定義を作成します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/

なお，-dオプションを指定した場合，次に示すバッチサーバの環境（ディレクトリおよびファイル）を削除します。

ユーザ定義ファイルの格納用ディレクトリ以下

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/

一時作業用ディレクトリ以下

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥repository¥<サーバ名称>¥

UNIXの場合

/opt/Cosminexus/CC/server/repository/<サーバ名称>/

作業用ディレクトリ以下（デフォルト）

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥

UNIXの場合

/opt/Cosminexus/CC/server/public/ejb/<サーバ名称>/

なお，作業用ディレクトリについては，ユーザ定義ファイル（usrconf.cfg）のejb.public.directoryキーにデフォルト値以外が指定されていた場合，そのディレクトリ以下も削除します。

引数

<サーバ名称>

セットアップするバッチサーバのサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。ただし，アンセットアップ時は省略できません。また，ホスト名称にサーバ名称として使用できない文字が含まれている場合はエラーになります。

半角英数字（0〜9，A〜Z，a〜z），アンダースコア（_）またはハイフン（-）を使用できます。サーバ名称の先頭の文字は英数字でなければなりません。また，サーバ名称は，255文字以下，かつマニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録C.2　バッチサーバの作業ディレクトリ」を参照して見積もった範囲内の長さで指定してください。

-batch

バッチサーバの環境を構築する場合に指定します。

-d

バッチサーバの環境を削除する場合に指定します。サーバ名称は省略できません。

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

UNIXの場合，cjsetupコマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

UNIXの場合にアンセットアップ（cjsetup -d <サーバ名称>）を実行すると，削除対象のディレクトリ，ファイルのアクセス権の設定および使用状態に関係なく，すべて削除します。

セットアップ済みのサーバ名称を指定して再セットアップする（cjsetup -batch <サーバ名称>）と，エラーとなります。

Windowsの場合，サーバ名称の大文字・小文字は区別されません。作成済みのサーバ名称と，大文字・小文字の区別以外は一致している文字列をcjsetupのサーバ名称として指定した場合，次のように動作します。

セットアップの場合(cjsetup -batch <サーバ名称>)

セットアップに失敗します。

アンセットアップの場合(cjsetup -d <サーバ名称>)

すでに作成済みである，<サーバ名称>と大文字・小文字の区別以外は一致しているサーバが削除されます。

サーバ管理コマンド，バッチサーバの開始または停止コマンドを実行する場合，これらのコマンドにサーバ名称を引数として指定するときは，cjsetupコマンドで作成したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

起動中のバッチサーバに対して，アンセットアップ（cjsetup -d <サーバ名称>）を実行しないでください。

Windowsの場合，削除対象のファイルの属性が読み取り専用，または使用中のときに，アンセットアップ（cjsetup -d <サーバ名称>）を実行しないでください。

バッチサーバはV9互換モードだけで構築されます。

cjstartsv（バッチサーバの開始）

形式

cjstartsv [<サーバ名称>] [-nosecurity]

機能

指定したサーバ名称のバッチサーバを開始します。サーバ名称を省略したときは，ホスト名称と同じサーバ名称のバッチサーバを開始します。

引数

<サーバ名称>

開始するバッチサーバのサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-nosecurity

SecurityManagerを解除するために指定します。

ユーザ定義ファイル

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥usrconf.cfg

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥usrconf.properties

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/usrconf.cfg

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/usrconf.properties

戻り値

0：

正常終了しました。

1以上（143以外）：

異常終了しました。

143：

コマンド実行中に次の操作をしました（Windowsの場合）。

コマンドを起動しているコマンドプロンプトのウィンドウを「×」ボタンを押下して閉じた。

Windowsシステムをシャットダウンした。

Windowsシステムをログオフした。

注意事項

バッチサーバを自動起動するように設定できます。バッチサーバの起動については，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「2.2　バッチアプリケーション実行環境の概要」を参照してください。

Windowsの場合，cjstartsvコマンドの実行には，Administrator権限が必要です。

UNIXの場合，cjstartsvコマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

コマンドの引数にサーバ名称を指定する場合，cjsetupコマンドで指定したサーバ名称と大文字・小文字を一致させた文字列を指定する必要があります。

3.3　バッチアプリケーションで使用するコマンド

ここでは，バッチアプリケーションで使用するコマンドについて説明します。

バッチアプリケーションで使用するコマンドの一覧を，次の表に示します。

表3‒3　バッチアプリケーションで使用するコマンドの一覧

コマンド名称

分類

概要

コマンドの系統

cjexecjob

バッチアプリケーションの実行

バッチアプリケーションを実行します。

−

cjkilljob

バッチアプリケーションの停止またはバッチサーバの強制停止

バッチアプリケーションを停止します。バッチアプリケーションの停止に失敗した場合，バッチサーバを強制停止します。

−

cjlistjob

バッチアプリケーション情報の一覧表示

バッチアプリケーションの情報を標準出力に出力します。

−

（凡例）

−：該当なし　

上記の表のコマンドは，バッチアプリケーションのスケジューリング機能を使用できます。バッチアプリケーションのスケジューリング機能については，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「4.　バッチアプリケーションのスケジューリング」を参照してください。

以降，ここでは，バッチアプリケーションのスケジューリング機能をスケジューリング機能といいます。

サーバ管理コマンドの系統ごとの排他制御の条件については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「3.2　サーバ管理コマンドの排他制御」を参照してください。

cjexecjob（バッチアプリケーションの実行）

形式

スケジューリング機能を使用しない場合

cjexecjob <サーバ名称> [[<Javaオプション>]...]
          <Javaアプリケーションクラス名>
          [[<mainメソッドに渡す引数>]...]

スケジューリング機能を使用する場合

cjexecjob [<スケジュールグループ名>] [-jobID <ジョブID>]
          [[<Javaオプション>]...]
          <Javaアプリケーションクラス名>
          [[<mainメソッドに渡す引数>]...]

機能

スケジューリング機能を使用しない場合は，指定したサーバ名称のバッチサーバでバッチアプリケーションを実行します。

スケジューリング機能を使用する場合は，CTMによって振り分けられたバッチサーバでバッチアプリケーションを実行します。なお，ジョブが実行できるバッチサーバがないときは，バッチアプリケーションをスケジュールキューに待機させます。

<Javaオプション>以降の引数として指定できる引数のサイズは，1024バイト未満です。

cjexecjobコマンドを実行した場合，およびcjexecjobコマンドの処理が終了した場合は，メッセージが出力されます。cjexecjobコマンドが出力するメッセージは，usrconf.cfg（バッチアプリケーション用オプション定義ファイル）のbatch.log.stdout.enabledキーによって抑止できます。

cjexecjobコマンドのオプションは，usrconf.cfg（バッチアプリケーション用オプション定義ファイル）で指定します。また，システムプロパティは，usrconf.properties（バッチアプリケーション用ユーザプロパティファイル）で指定します。usrconf.cfg（バッチアプリケーション用オプション定義ファイル）およびusrconf.properties（バッチアプリケーション用ユーザプロパティファイル）が格納されているディレクトリは，次の順で検索されます。

環境変数（CJBATCHUSRCONFDIR）に指定したディレクトリ※

cjexecjobコマンドを実行したディレクトリ

注※　環境変数（CJBATCHUSRCONFDIR）にはディレクトリを絶対パスで指定してください。

同じキーのシステムプロパティを複数指定した場合，最後に指定したシステムプロパティが優先されます。

同じキーのシステムプロパティを異なる手段で指定した場合の優先順位は次のとおりです。

cjexecjobコマンドの引数

usrconf.properties（バッチアプリケーション用ユーザプロパティファイル）

usrconf.cfg（バッチアプリケーション用オプション定義ファイル）

usrconf.properties（バッチサーバ用ユーザプロパティファイル）

usrconf.cfg（バッチサーバ用オプション定義ファイル）

引数

<サーバ名称>

バッチアプリケーションを実行するバッチサーバの名称を指定します。

<スケジュールグループ名>

CTMがバッチアプリケーションの実行をスケジューリングするときに割り当てるバッチサーバのグループ名を指定します。

スケジュールグループ名は，usrconf.cfg（バッチアプリケーション用オプション定義ファイル）でも指定できます。スケジュールグループ名の指定の優先順位は次のとおりです。

cjexecjobコマンドの引数

usrconf.cfg（バッチアプリケーション用オプション定義ファイル）

なお，スケジュールグループ名の指定は省略できます。スケジュールグループ名の指定を省略した場合のデフォルト値は"JOBGROUP"です。

-jobID <ジョブID>

実行するバッチアプリケーションのジョブIDをユニークな1〜32文字の英数字で指定します。

-jobID <ジョブID>を省略した場合，ジョブIDは自動生成されます。ジョブIDの自動生成については，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「4.　バッチアプリケーションのスケジューリング」を参照してください。

UNIXの場合，<ジョブID>の指定を省略しバッチアプリケーションを起動したときは，アプリケーションを停止する際に，ジョブIDをダブルクォーテーション("")で囲んで次のように指定する必要があります。

-jobID "<ジョブID>"

<Javaオプション>

JavaVMの起動オプションを指定します。

指定できるオプションを次に示します。

-cp

-classpath

-D<name>=<value>

<Javaアプリケーションクラス名>

パッケージ名を含めたJavaアプリケーションのクラス名を指定します。

<mainメソッドに渡す引数>

Javaアプリケーションのmainメソッドに渡す引数を指定します。

スケジューリング機能を使用する場合に，<スケジュールグループ名>を省略するときは，次のどちらかの引数を必ず一緒に指定してください。

<ジョブID>

<Java オプション>

次に例を示します。

（誤った例）
cjexecjob com.hitachi.mypackage.MyBatchApp argA argB

（正しい例）
cjexecjob -jobID JOBID com.hitachi.mypackage.MyBatchApp argA argB
cjexecjob -D<name>=<value> com.hitachi.mypackage.MyBatchApp argA argB

入力例

スケジューリング機能を使用しない場合

cjexecjob MyBatchServer com.hitachi.mypackage.MyBatchApp

スケジューリング機能を使用する場合

cjexecjob JOBGROUP com.hitachi.mypackage.MyBatchApp

戻り値

<public static int main(String[])メソッドからreturnした値>：

public static int main(String[])メソッドを使用した場合に返却されます。

<System.exit(),Runtime.halt()，Runtime.exit()の引数に指定した値>：

System.exit(),Runtime.halt()，Runtime.exit()を使用した場合に返却されます。

0：

public static void main(String[])メソッドを使用して，正常終了しました。

1：

バッチアプリケーションの実行に失敗しました。

または，バッチアプリケーションを強制終了しました。

注意事項

UNIXの場合，バッチサーバを起動したComponent Container管理者またはスーパーユーザがコマンドを実行できます。

Windowsの場合，管理者特権でコマンドを実行してください。

サーバ名称は，バッチサーバのセットアップ時に指定したサーバ名称と大文字・小文字を一致させた文字列を指定してください。

クラスパスを複数指定した場合，すべての指定が有効になります。例えば，"-cp a -cp b"を指定した場合，"-cp a;b"(Windowsの場合)と同等になります。

クラスパスは指定した順に検索します。複数のクラスパスを異なる手段で指定した場合，次の順番で検索します。

usrconf.cfg（バッチサーバ用オプション定義ファイル）

cjexecjobコマンドの引数

usrconf.cfg（バッチアプリケーション用オプション定義ファイル）

クラスパスはCLASSPATH環境変数には指定できません。指定しても無視されます。

また，-cp,-classpathの指定がない場合，デフォルトのクラスパスとしてカレントディレクトリは使用されません。

クラスパスに相対パスを指定した場合，コマンドを実行したディレクトリからの相対パスとして扱います。

cjexecjobコマンドの引数にマルチバイト文字を使用する場合は，次の個所で使用しているマルチバイト文字とエンコードを統一してください。

usrconf.cfg（バッチアプリケーション用オプション定義ファイル）

usrconf.cfg（バッチサーバ用オプション定義ファイル）

バッチアプリケーションのソースコード（バッチアプリケーション内のjava.lang.System.out，またはjava.lang.System.err）

スケジューリング機能を使用する場合，cjexecjobコマンドとバッチサーバ間の通信タイムアウトの設定をusrconf.cfg（バッチアプリケーション用オプション定義ファイル）で指定できます。デフォルト値は0で，無限待ちとなります。

cjkilljob（バッチアプリケーションの停止またはバッチサーバの強制停止）

形式

スケジューリング機能を使用しない場合

cjkilljob <サーバ名称>

スケジューリング機能を使用する場合

cjkilljob { <サーバ名称>|[<スケジュールグループ名>] -jobID <ジョブID> }

機能

指定したサーバ名称のバッチサーバ上で実行中のバッチアプリケーションを停止します。実行中のバッチアプリケーションの停止に失敗した場合，バッチサーバを強制停止します。

スケジューリング機能を使用する場合で，スケジュールグループ名を指定したときは，-jobIDで指定したジョブIDを持つ実行中のバッチアプリケーションを停止します。また，-jobIDで指定したジョブIDを持つバッチアプリケーションがCTMのスケジュールキューで待機中のときは，バッチアプリケーションの削除予約ができます。削除予約したバッチアプリケーションは，スケジュールキューから出たときにCTMによって削除されます。

cjkilljobコマンドのオプションは，usrconf.cfg（バッチアプリケーション用オプション定義ファイル）で指定できます。usrconf.cfg（バッチアプリケーション用オプション定義ファイル）が格納されているディレクトリは，次の順で検索されます。

環境変数（CJBATCHUSRCONFDIR）に指定したディレクトリ※

cjkilljobコマンドを実行したディレクトリ

注※　環境変数（CJBATCHUSRCONFDIR）にはディレクトリを絶対パスで指定してください。

引数

<サーバ名称>

停止するバッチアプリケーションを実行中のバッチサーバの名称を指定します。

<スケジュールグループ名>

CTMがバッチアプリケーションの実行をスケジューリングするときに割り当てるバッチサーバのグループ名を指定します。

スケジュールグループ名は，usrconf.cfg（バッチアプリケーション用オプション定義ファイル）でも指定できます。スケジュールグループ名の指定の優先順位は次のとおりです。

cjexecjobコマンドの引数

usrconf.cfg（バッチアプリケーション用オプション定義ファイル）

なお，スケジュールグループ名の指定は省略できます。スケジュールグループ名の指定を省略した場合のデフォルト値は"JOBGROUP"です。

-jobID <ジョブID>

停止するバッチアプリケーションのジョブIDを指定します。

UNIXの場合，#付きのジョブIDのときは，ジョブIDをダブルクォーテーション("")で囲んで指定してください（cjexecjob実行時にジョブIDの指定を省略した場合は，自動で#付きのジョブIDとなります）。

入力例

サーバ名を指定する場合

cjkilljob MyBatchServer

ジョブIDを指定する場合

cjkilljob JOBGROUP -jobID HOGE

戻り値

0：

バッチアプリケーションを停止しました。

または，スケジュールキューに待機していたジョブIDの削除を予約しました。

1：

バッチサーバを強制停止しました。

2：

異常終了しました。

または次のどれかで警告終了をしました。

バッチアプリケーションが実行されていない。

指定したジョブIDが見つからない。

すでに削除予約されている。

注意事項

UNIXの場合，バッチサーバを起動したComponent Container管理者またはスーパーユーザがコマンドを実行できます。

Windowsの場合，管理者特権でコマンドを実行してください。

サーバ名称は，バッチサーバのセットアップ時に指定したサーバ名称と大文字・小文字を一致させた文字列を指定してください。

スケジューリング機能を使用する場合，cjkilljobコマンドとバッチサーバ間の通信タイムアウトの設定をusrconf.cfg（バッチアプリケーション用オプション定義ファイル）で指定できます。デフォルト値は0で，無限待ちとなります。

cjlistjob（バッチアプリケーション情報の一覧表示）

形式

スケジューリング機能を使用しない場合

cjlistjob <サーバ名称>

スケジューリング機能を使用する場合

cjlistjob {[ [<スケジュールグループ名>]...]|[-all] }

機能

スケジューリング機能を使用しない場合

指定したサーバ名称のバッチサーバで実行中のバッチアプリケーションの情報を標準出力に出力します。

出力するバッチアプリケーションの情報を次に示します。

バッチアプリケーションの状態

バッチアプリケーション名

PRFのルートAP情報

cjexecjobコマンドの実行時刻

スケジューリング機能を使用する場合

指定したスケジュールグループで実行中のバッチアプリケーションの情報を標準出力に1行で出力します。

出力するバッチアプリケーションの情報を次に示します。

スケジュールグループ名

バッチアプリケーションの状態

バッチアプリケーション名

PRFのルートAP情報

cjexecjobコマンドの実行時刻

バッチアプリケーションの待機開始，実行開始，または強制停止受付時刻

ジョブID

バッチアプリケーションを実行しているサーバ名

cjlistjobコマンドのオプションは，usrconf.cfg（バッチアプリケーション用オプション定義ファイル）で指定できます。usrconf.cfg（バッチアプリケーション用オプション定義ファイル）が格納されているディレクトリは，次の順で検索されます。

環境変数（CJBATCHUSRCONFDIR）に指定したディレクトリ※

cjlistjobコマンドを実行したディレクトリ

注※　環境変数（CJBATCHUSRCONFDIR）にはディレクトリを絶対パスで指定してください。

引数

<サーバ名称>

情報を取得したいバッチアプリケーションを実行しているバッチサーバの名称を指定します。

サーバ名称は，バッチサーバのセットアップ時に指定したサーバ名称と大文字・小文字を一致させた文字列を指定してください。

<スケジュールグループ名>

情報を取得したいバッチアプリケーションを実行しているスケジュールグループの名称を指定します。複数のスケジュールグループをコンマ（,）区切りで指定できます。

なお，スケジュールグループ名の指定は省略できます。スケジュールグループ名の指定を省略した場合は，このコマンドのusrconf.cfg（バッチアプリケーション用オプション定義ファイル）内にあるbatch.schedule.group.nameが使用されます。フォルト値は"JOBGROUP"です。

-all

同一マシン内のバッチサーバが使用しているすべてのスケジュールグループのバッチアプリケーション情報を表示する場合に指定します。

入力例

スケジューリング機能を使用しない場合

cjlistjob MyBacthServer

スケジューリング機能を使用する場合

cjlistjob JOBGROUP

戻り値

0：

バッチアプリケーション情報の一覧を表示しました。

1：

バッチアプリケーション情報の一覧の表示に失敗しました。

出力形式

スケジューリング機能を使用しない場合

<バッチアプリケーションの状態>△<バッチアプリケーション名>△<PRFのルートAP情報>△<cjexecjobコマンドの実行時刻>

スケジューリング機能を使用する場合

<スケジュールグループ名>△<バッチアプリケーションの状態>△<バッチアプリケーション名>△<PRFのルートAP情報>△<cjexecjobコマンドの実行時刻>△<バッチアプリケーション待機開始，実行時間，または強制停止受付時間>△<ジョブID>△<ジョブを実行しているバッチサーバ名>

（凡例）　△：半角スペース

次に出力項目について説明します。

<スケジュールグループ名>

バッチアプリケーションの実行リクエストが振り分けられるスケジュールグループの名称を表示します。

<バッチアプリケーションの状態>

バッチアプリケーションの次の状態を表示します。

バッチアプリケーション実行中：running

バッチアプリケーション待機中：waiting

バッチアプリケーション強制停止中：forceStopping

<バッチアプリケーション名>

cjexecjobコマンドで指定したJavaアプリケーションのクラス名を表示します。

<PRFのルートAP情報>

PRFのルートアプリケーションの通信番号を，先頭けたが0xである16けたの16進数で表示します。

<cjexecjobコマンドの実行時刻>

cjexecjobコマンドを実行した時刻を次の形式で表示します。

yyyy/mm/dd△hh:mm:ss.ssssss

（凡例）　△：半角スペース　yyyy/mm/dd△hh:mm:ss.ssssss：西暦年/月/日 時間/分/秒

<バッチアプリケーションの待機開始，実行開始，または強制停止受付時刻>

スケジューリング機能を使用する場合に出力されます。

バッチアプリケーションの状態別に，バッチアプリケーションの開始時刻，待機時刻，または強制停止受付時刻を次の形式で表示します。

yyyy/mm/dd△hh:mm:ss.ssssss

（凡例）　△：半角スペース　yyyy/mm/dd△hh:mm:ss.ssssss：西暦年/月/日 時間/分/秒

バッチアプリケーションの状態と表示される時刻の対応を次の表に示します。

表3‒4　バッチアプリケーションの状態と表示される時刻

バッチアプリケーションの状態

表示される時刻

説明

waiting

待機開始時刻

バッチアプリケーションがスケジュールキューに入った時刻

running

実行開始時刻

バッチアプリケーションがスケジュールキューから出た時刻

forceStopping

強制停止受付時刻

スケジュールキューのバッチアプリケーションに強制停止予約をした時刻

<ジョブID>

バッチアプリケーションのジョブIDを表示します。

<ジョブを実行しているバッチサーバ名>

スケジューリング機能を使用する場合に出力されます。

バッチアプリケーションを実行しているバッチサーバ名を表示します。バッチアプリケーションが待機中の場合は，「-」を表示します。

出力例

指定したサーバ名称のバッチサーバの情報

running△com.hitachi.mypackage.batchApp1△0x0000000000123456△2008/04/14△17:27:35.689012

指定したスケジュールグループの情報

JOBGROUP△running△com.hitachi.mypackage.batchApp1△0x0000000000123456△2008/04/14△17:27:35.689012△2008/04/14△17:27:37.182777△HOGE△MybatchServer1
JOBGROUP△running△com.hitachi.mypackage.batchApp2△0x0000000002345678△2008/04/14△17:45:20.123456△2008/04/14△19:21:56.271354△102△MybatchServer2
JOBGROUP△running△com.hitachi.mypackage.batchApp3△0x0000000034567890△2008/04/14△18:15:54.397890△2008/04/14△19:00:00.123447△#5HL390_G3CV7△MybatchServer3
JOBGROUP△waiting△com.hitachi.mypackage.batchApp4△0x0000000045678901△2008/04/14△18:30:24.125444△2008/04/14△18:30:25.006220△112345△-

（凡例）　△：半角スペース

注意事項

UNIXの場合，バッチサーバを起動したComponent Container管理者またはスーパーユーザがコマンドを実行できます。

Windowsの場合，管理者特権でコマンドを実行してください。

バッチアプリケーションがない場合，情報は何も出力されないでコマンドが正常終了します。

スケジューリング機能を使用する場合，バッチアプリケーション情報の一覧表示のタイムアウト設定をusrconf.cfg（バッチアプリケーション用オプション定義ファイル）で指定できます。スケジューリング機能を使用する場合の設定については，マニュアル「アプリケーションサーバ機能解説 拡張編」の「4.　バッチアプリケーションのスケジューリング」を参照してください。

スケジューリング機能を使用する場合，cjlistjobコマンドとバッチサーバ間の通信タイムアウトの設定をusrconf.cfg（バッチアプリケーション用オプション定義ファイル）で指定できます。デフォルト値は0で，無限待ちとなります。

3.4　バッチサーバで使用するリソース操作コマンド

ここでは，バッチサーバで使用するリソース操作コマンドについて説明します。

コマンドの詳細は，「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。なお，参照する場合は「J2EEサーバ」を「バッチサーバ」と読み替えてください。

バッチサーバで使用するリソース操作コマンドの一覧を，次の表に示します。

表3‒5　バッチサーバで使用するリソース操作コマンドの一覧

コマンド名称

分類

概要

コマンドの系統

cjclearpool

コネクションプール内のコネクション削除

リソースアダプタのコネクションをクリアします。

更新

cjcopyres

リソースのコピー

RARファイルのプロパティをコピーします。

更新

cjdeleteres

リソースの削除

インポート済みのRARファイルを削除します。

更新

cjdeployrar

リソースアダプタのデプロイ

リソースアダプタをデプロイします。

更新

cjexportrar

リソースアダプタのエクスポート

バッチサーバ上のリソースアダプタをエクスポートします。

更新

cjgetrarprop

RARファイルの属性の取得

デプロイ済みのRARファイルの属性を取得して，属性ファイルを生成します。

更新

cjgetresprop

リソースの属性の取得

デプロイ前のRARファイルに含まれるリソースの属性を取得して，属性ファイルを生成します。

更新

cjimportres

リソースのインポート

RARファイルをインポートします。

更新

cjlistpool

コネクションプールの一覧表示

指定されたリソースアダプタ，またはすべてのリソースアダプタのコネクションプール状態を標準出力に出力します。

参照

cjlistrar

リソースアダプタの一覧表示

デプロイされているすべてのリソースアダプタの一覧を標準出力に出力します。

参照

cjlistres

リソースの一覧表示

インポート済みのRARファイルの一覧を標準出力に出力します。

参照

cjsetrarprop

RAR属性設定

デプロイ済みのRARファイルに含まれるリソースの属性を属性ファイルに指定された値に変更します。

更新

cjsetresprop

リソースの属性設定

デプロイ前のRARファイルに含まれるリソースの属性を，属性ファイルに指定された値に変更します。

更新

cjstartrar

リソースアダプタの開始

リソースアダプタを開始します。

更新

cjstoprar

リソースアダプタの停止

開始されているリソースアダプタを停止します。

更新

cjundeployrar

リソースアダプタのアンデプロイ

デプロイされているリソースアダプタをアンデプロイします。

更新

（凡例）

更新：更新系コマンド。バッチサーバの内容を更新，または構成情報を取得するコマンドです。

参照：参照系コマンド。バッチサーバの内容を更新しないで，構成状態を表示するだけのコマンドです。

サーバ管理コマンドの系統ごとの排他制御の条件については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「3.2　サーバ管理コマンドの排他制御」を参照してください。

3.5　バッチサーバで使用するそのほかのコマンド

ここでは，バッチサーバで使用するそのほかのコマンドについて説明します。

コマンドの詳細は，「2.5　J2EEサーバで使用するそのほかのコマンド」を参照してください。なお，参照する場合は「J2EEサーバ」を「バッチサーバ」と読み替えてください。

バッチサーバで使用するそのほかのコマンドの一覧を，次の表に示します。

表3‒6　バッチサーバで使用するそのほかのコマンドの一覧

コマンド名称

分類

概要

コマンドの系統

cjresetsv

サーバ管理コマンドの排他強制解除

サーバ管理コマンドの排他情報をリセットして，サーバ管理コマンドを実行できるようにします。

−

（凡例）

−：該当なし　

サーバ管理コマンドの系統ごとの排他制御の条件については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「3.2　サーバ管理コマンドの排他制御」を参照してください。

4　性能解析トレースで使用するコマンド

この章では，性能解析トレースで使用するコマンドの入力形式，機能などについて説明します。

4.1　性能解析トレースで使用するコマンドの一覧

性能解析トレースで使用するコマンドは，cprfで始まるコマンドです。性能解析トレースで使用するコマンドの一覧を，次の表に示します。

表4‒1　性能解析トレースで使用するコマンドの一覧

コマンド名称

分類

概要

cprfed

性能解析トレース情報の編集出力

性能解析トレース情報を編集出力します。

cprfflush

バッファ内容の強制ファイル出力

バッファ内のトレース情報を出力します。

cprfgetpid

PRFデーモンプロセスIDの取得

PRFデーモンのプロセスIDを取得します。

cprflevel

PRFトレース取得レベルの表示と変更

PRFトレース取得レベルを表示または変更します。

cprfstart

PRFデーモンの開始

PRFデーモン（cprfd）を起動します。

cprfstop

PRFデーモンの停止

PRFデーモン（cprfd）を停止します。

4.2　性能解析トレースで使用するコマンドの詳細

性能解析トレースで使用する各コマンドの入力形式，機能などを次に示します。

コマンドの格納先

性能解析トレースで使用するコマンドは，次のディレクトリに格納されています。

Windowsの場合

<Application Serverのインストールディレクトリ>¥PRF¥bin¥

UNIXの場合

/opt/Cosminexus/PRF/bin/

cprfed（性能解析トレース情報の編集出力）

形式

cprfed [-h] | [-Dump | -CSV] [-Time <開始時刻>,<終了時刻>]
       [-ProcessID <プロセスID>[,<プロセスID>...]]
       [-TraceFile <PRFトレースファイル名> [,<PRFトレースファイル名>...]
       | -AllTraceFile ]

機能

PRFトレース情報を入力して，性能解析トレース情報を編集出力します。

引数

-h

コマンドの使用方法が表示されます。

-Dump

詳細情報をダンプ形式で出力します。

-CSV

詳細情報をCSV形式で出力します。

-Time <開始時刻>，<終了時刻>

指定された時刻内に取得されたトレース情報だけを出力します。

開始時刻，終了時刻は，hhmmss[MMdd[yyyy]]形式で指定します。MMdd，yyyyは省略できます。省略した場合は，コマンドを実行した月日年が指定されます。

時刻の文字列の形式：hhmmss[MMdd[yyyy]]

hh：時（00〜23）

mm：分（00〜59）

ss：秒（00〜59）

MM：月（01〜12）

dd：日（01〜31）

yyyy：年（1970〜20xx）

2003年10月11日にコマンドを実行した場合の引数の指定例とその編集範囲の例を次に示します。

引数の指定

編集範囲

-Time 102345,

2003年10月11日10時23分45秒からトレースファイルの最後まで。

-Time ,102345

トレースファイルの最初から2003年10月11日10時23分45秒まで。

-Time 102345,102350

2003年10月11日10時23分45秒から2003年10月11日10時23分50秒まで。

-Time 1023451012,1023501013

2003年10月12日10時23分45秒から2003年10月13日10時23分50秒まで。

-Time 10234510122002,10235010132002

2002年10月12日10時23分45秒から2002年10月13日10時23分50秒まで。

-ProcessID <プロセスID>

指定されたプロセスIDの情報だけを編集出力します。プロセスIDは10進数で指定してください。

-TraceFile <PRFトレースファイル名>

PRFトレースファイルを指定します。トレースファイルは最大256個指定できます。このオプションは，-AllTraceFileオプションと同時に指定できません。

PRFトレースファイルは，PRFトレースファイル出力先ディレクトリに自動的に作成され，ファイル名はprf_???になります。???は，001からトレースファイルの面数を最大値とした整数です。

PRFトレースファイル出力先ディレクトリ

Windowsの場合

%PRFSPOOL%¥utt¥prf¥PRF識別子¥dcopltrc¥

UNIXの場合

$PRFSPOOL/utt/prf/PRF識別子/dcopltrc/

また，<PRFトレースファイル名>を指定する場合は，絶対パスを指定するか，PRFトレースファイル出力先ディレクトリに移動してから，ファイル名だけを指定します。

-AllTraceFile

カレントディレクトリ下のすべてのファイルを入力ファイルとして読み込みます。このオプションは，-TraceFileオプションと同時に指定できません。カレントディレクトリに256を超える数のファイルがある場合は256ファイルだけ編集します。なお，cprfedコマンドの結果をカレントディレクトリにリダイレクトする場合は，リダイレクト先のファイルも入力ファイルとして数えます。

指定できるコマンドオプションの組み合わせの一覧を次に示します。

表4‒2　引数（コマンドオプション）の組み合わせ一覧（cprfedコマンド）

コマンド

オプション

-h

-Dump

-CSV

-Time

-ProcessID

-TraceFile

-AllTraceFile

-h

−

△-h

△-h

△-h

△-h

△-h

△-h

-Dump

△-h

−

△-CSV

○

○

○

○

-CSV

△-h

△-CSV

−

○

○

○

○

-Time

△-h

○

○

−

○

○

○

-ProcessID

△-h

○

○

○

−

○

○

-TraceFile

△-h

○

○

○

○

−

×

-AllTraceFile

△-h

○

○

○

○

×

−

（凡例）

○：同時に指定できます。

△：△のあとに続くオプション名のオプションが有効になります。

×：同時に指定できません。

−：該当しません。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生しました。出力されたメッセージに従って対策したあと，再度コマンドを実行してください。エラーメッセージは標準エラー出力，ログファイルに出力されます。資料の取得方法については，マニュアル「アプリケーションサーバ 機能解説保守／移行編」の「2.4.3　取得方法および調査方法との対応」を参照してください。

出力形式

出力形式1（ダンプ形式）

PRF: aa…aa Process: bb…bb Thread: cc…cc(FF…FF) Trace: dd…dd
ProcessName: zz.zz
Event: eeeee Time: ffff/gg/hh ii:jj:kk lll/mmm/nnn
Rc: oo…oo
ClientAP:pp…pp qq…qq - rr…rr RootAP: ss…ss tt…tt - uu…uu
SendSCD:vv…vv ww…ww RecieveSCD:xx…xx yy…yy
INT: XX…XX OPR: YY…YY
LookupName:ZZ..ZZ
 Offset +0 +1 +2 +3 +4 +5 +6 +7 +8 +9 +a +b +c +d +e +f 0123456789abcdef
  AAAA BB BB BB BB BB BB BB BB BB BB BB BB BB BB BB BB CC…CC
  AAAA BB BB BB BB BB BB BB BB BB BB BB BB BB BB BB BB CC…CC
                               ：
  AAAA BB BB BB BB BB BB BB BB BB BB BB BB BB BB BB BB CC…CC

出力形式2（CSV形式）

PRF,Process,Thread,Trace,ProcessName,Event,Date,Time,Time(msec/usec/nsec),Rc,ClientAP IP,ClientAP PID, ClientAP CommNo.,RootAP IP,RootAP PID,RootAP CommNo.,SendSCD IP,SendSCD PID,ReceiveSCD IP,ReceiveSCD PID,INT,OPR,LookupName,OPT,ASCII
aa…aa,bb…bb,cc…cc(CC…CC),dd…dd,zz…zz,ee…ee,ffff/gg/hh,ii:jj:kk，lll/mmm/nnn,oo…oo,pp…pp,qq…qq,rr…rr,ss…ss,tt…tt,uu…uu,vv…vv,ww…ww,xx…xx,yy…yy,XX…XX,YY…YY,ZZ…ZZ,DD…DD,EE…EE

（凡例）

記号

説明

aa…aa

レコード状態（６文字以内）

Rec：レコードの状態は正常です。

ErrRec：レコードの状態は異常です。

bb…bb

トレース情報を取得したプロセスのプロセスID（10進数で10けた以内）

cc…cc

トレース情報を取得したプロセス内スレッドのスレッドID（10進数で20けた以内）

dd…dd

該当スレッドでのトレース通番（10進数で進10けた以内）

ee…ee

イベントID（16進6けた（先頭の0x含む））

ffff

トレースを取得した時刻（年）

gg

トレースを取得した時刻（月）

hh

トレースを取得した時刻（日）

ii

トレースを取得した時刻（時）

jj

トレースを取得した時刻（分）

kk

トレースを取得した時刻（秒）

lll

トレースを取得した時刻（ミリ秒）

mmm

トレースを取得した時刻（マイクロ秒）

nnn

トレースを取得した時刻（ナノ秒）

oo…oo

リターンコード（16進数で10けた（先頭の0x含む））

pp…pp

クライアントアプリケーションのIPアドレス（xxx.xxx.xxx.xxxの形式）

qq…qq

クライアントアプリケーションのプロセスID（10進10けた以内）

rr…rr

クライアントの通信番号（18けた（先頭の0x含む））

ss…ss

ルートアプリケーションのIPアドレス（xxx.xxx.xxx.xxxの形式）

tt…tt

ルートアプリケーションのプロセスID（10進数で10けた以内）

uu…uu

ルートの通信番号（18けた（先頭の0x含む））

vv…vv

リクエスト要求元CTMのIPアドレス（xxx.xxx.xxx.xxxの形式）

ww…ww

リクエスト要求元CTMのプロセスID（10進数で10けた以内）

xx…xx

リクエスト要求先CTMのIPアドレス（xxx.xxx.xxx.xxxの形式）

yy…yy

リクエスト要求先CTMのプロセスID（10進数で10けた以内）

zz…zz

プロセス名称（32文字以内）

XX…XX

インタフェース名（33文字以内）※

YY…YY

オペレーション名（33文字以内）※

ZZ…ZZ

ルックアップ名（33文字以内）※

バッチアプリケーションを実行するシステムの場合，スケジュールグループ名を出力します。

AAAA

オフセット

BB

各イベントで取得した情報の1バイト分の16進数表示。

CC…CC

BBの内容をASCII文字で表現します。ASCII文字で表現できない内容は「.」（ピリオド）で出力します。

DD…DD

各イベントで取得した情報を512文字以内の16進数形式で出力します。

ダンプ形式の情報は，""で囲んで出力します。

EE…EE

DDの内容をASCII文字で出力（最大514文字）します。

ASCII文字は，""で囲んで出力します。

ASCII文字で表示できないコード（制御コード）は「.」（ピリオド）で出力し，ASCII文字で"（1文字）は""（2文字）で出力します。

CSV形式の場合に出力される情報です。

FF…FF

スレッドのハッシュ値を出力（10進数で10けた以内）します。CTMおよびリダイレクタで取得したトレース情報には，スレッドのハッシュ値が出力されない場合があります。

注※

インタフェース名，オペレーション名，ルックアップ名が32文字を超える場合は，次のように編集され33文字で出力されます。

「前16文字」+「＊」＋「後ろ16文字」

「前32文字」+「＊」

「＊」+「後ろ32文字」

入力例・出力例

入力例1

cprfed -TraceFile prf_001

出力例1

PRF: Rec Process: 516        Thread: 2204       Trace: 10
ProcessName: ctmd.exe
Event: 0x1406 Time: 2004/02/05 16:46:55 576/000/000
Rc: 0
ClientAP: 10.209.13.123   2148       - 0000000000000107 RootAP: 10.209.13.123
 2200        - 0000000000000104
SendSCD: 10.209.13.122    516        ReceiveSCD: ****             ****
INT: com/abcd/BookShop              OPR: orderBook
LookupName: BookShop

入力例2

cprfed -Dump -TraceFile prf_001

出力例2

PRF: Rec Process: 516        Thread: 2204       Trace: 10
ProcessName: ctmd.exe
Event: 0x1406 Time: 2004/02/05 16:46:55 576/000/000
Rc: 0
ClientAP: 10.209.13.123   2148       - 0000000000000107 RootAP: 10.209.13.123
 2200        - 0000000000000104
SendSCD: 10.209.13.122    516        ReceiveSCD: ****             ****
INT: com/abcd/BookShop              OPR: orderBook
LookupName: BookShop

 Offset  +0 +1 +2 +3 +4 +5 +6 +7 +8 +9 +a +b +c +d +e +f  0123456789abcdef
  +0000  0a d1 0d 7a 04 02 00 00 0a d1 0d 7b 64 08 00 00  ...z.......{d...
  +0010  00 00 00 00 07 01 00 00 0a d1 0d 7b 98 08 00 00  ...........{....
  +0020  00 00 00 00 04 01 00 00 00 00 00 00 63 6f 6d 2f  ............com/
  +0030  61 6d 61 7a 6f 73 6f 2f 42 6f 6f 6b 53 68 6f 70  abcd/BookShop
  +0040  00 6f 72 64 65 72 42 6f 6f 6b 00 42 6f 6f 6b 53  .orderBook.BookS
  +0050  68 6f 70 00                                      hop.

入力例3

cprfed -CSV -TraceFile prf_001

出力例3

PRF,Process,Thread,Trace,ProcessName,Event,Date,Time,Time(msec/usec/nsec),Rc,ClientAP IP,ClientAP PID, ClientAP CommNo.,RootAP IP,RootAP PID,RootAP CommNo.,SendSCD IP,SendSCD PID,ReceiveSCD IP,ReceiveSCD PID,INT,OPR,LookupName,OPT,ASCII
Rec,516,2204,10,ctmd.exe,0x1406,2004/02/05,16:46:55,576/000/000,0,10.209.13.123,2148,0x0000000000000107,10.209.13.123,2200,0x0000000000000104,10.209.13.122,516,****,****,com/abcd/BookShop,orderBook,BookShop,

注意事項

性能解析トレースでは高負荷時に排他によるボトルネックが生じないように，PRFトレース出力時に排他制御をしていません。そのため，一部トレース情報が正しく出力されない場合があります。

CSV形式に編集したファイルに日本語を含む場合は，Unicodeをサポートしたエディタ，またはExcel 2003以降で参照してください。

cprfflush（バッファ内容の強制ファイル出力）

形式

cprfflush [-PRFID <PRF識別子>] [ -h ]

機能

PRFデーモンに対して，バッファに格納されているトレース情報の出力を要求します。

出力する範囲は，前回ファイル出力したトレースの次のトレースから，コマンドが入力された時点までです。

引数

-PRFID <PRF識別子>

PRF識別子を1〜31文字の英数字，またはアンダースコア（_）で指定します。"TSC"や"tsc"，または"CTM"や"ctm"で始まる文字列は指定しないでください。省略した場合は，"PRF_ID"という文字列がPRF識別子となります。

-h

コマンドの使用方法が表示されます。

戻り値

0：

正常終了しました。

1：

PRFデーモンが起動していません。PRFSPOOL環境変数が異なっている，または-PRFIDの値が誤っているおそれがあります。

2：

PRFSPOOL環境変数が設定されていません。

上記以外：

コマンド処理中にエラーが発生しました。出力されたメッセージに従って対策したあと，再度コマンドを実行してください。エラーメッセージは標準エラー出力，ログファイルに出力されます。資料の取得方法については，マニュアル「アプリケーションサーバ 機能解説保守／移行編」の「2.4.3　取得方法および調査方法との対応」を参照してください。

注意事項

cprfflushコマンドの実行中は，cprfflushコマンドを実行できません。

要求先のPRFデーモンと同じPRFSPOOL環境変数が設定されている必要があります。設定されていない場合，コマンドがエラーリターンします。

cprfgetpid（PRFデーモンプロセスIDの取得）

形式

cprfgetpid [-PRFID <PRF識別子>] [ -h ]

機能

指定したPRF識別子のプロセスIDを取得します。また，PRFデーモンの起動確認を表示します。

引数

-PRFID <PRF識別子>

PRF識別子を1〜31文字の英数字，またはアンダースコア（_）で指定します。"TSC"や"tsc"，または"CTM"や"ctm"で始まる文字列は指定しないでください。省略した場合は，"PRF_ID"という文字列がPRF識別子となります。

-h

コマンドの使用方法が表示されます。

戻り値

0：

正常終了しました。プロセスは起動していない場合があります。

1：

プロセスは起動していません。

2：

PRFSPOOL環境変数が設定されていません。

上記以外：

コマンド処理中にエラーが発生しました。出力されたメッセージに従って対策したあと，再度コマンドを実行してください。エラーメッセージは標準エラー出力，ログファイルに出力されます。資料の取得方法については，マニュアル「アプリケーションサーバ 機能解説保守／移行編」の「2.4.3　取得方法および調査方法との対応」を参照してください。

入力例・出力例

入力例

cprfgetpid

出力例

出力結果は，標準出力に出力されます。

1700

注意事項

PRFデーモンと同じPRFSPOOL環境変数が設定されている必要があります。

PRFデーモンが一度も起動していない，または正常終了したあとにこのコマンドを実行した場合は，エラーになります。

cprflevel（PRFトレース取得レベルの表示と変更）

形式

cprflevel [-PRFID <PRF識別子>] [ -h ]
          [-PrfChangeLevel <PRFトレース取得レベル>[,[<PRFトレース
          取得レベル>]...]]
          [-PrfLevelIndex <インデックス番号>] [-PrfLevelAll]

機能

PRFトレース取得レベルを表示または変更します。

-PrfChangeLevelオプションを省略した場合は，指定したPRF識別子に指定されているPRFトレース取得レベルを表示します。-PrfChangeLevelオプションを指定した場合は，指定したPRF識別子に指定されているPRFトレース取得レベルを指定値に変更します。

-PrfLevelIndexオプションを指定した場合は，指定したインデックスのPRFトレース取得レベルの一覧が表示されます。-PrfLevelAllオプションを指定した場合は，すべてのインデックスに対応するPRFトレース取得レベルが表示されます。

引数

-PRFID <PRF識別子>

PRF識別子を1〜31文字の英数字，またはアンダースコア（_）で指定します。"TSC"や"tsc"，または"CTM"や"ctm"で始まる文字列は指定しないでください。省略した場合は，"PRF_ID"という文字列がPRF識別子となります。

-h

コマンドの使用方法が表示されます。

-PrfChangeLevel <PRFトレース取得レベル> [,[<PRFトレース取得レベル>]...]

PRFトレース取得レベルを4バイトの16進数（8けたの値）で指定します。ここで4バイトの16進数の先頭に0xを付けることができますが，0xは無視されます。各インデックス番号に対応するレベル値をコンマ（,）区切りで左から複数指定できます。該当するインデックスのレベル値を変更しない場合は，値を指定しないでください。また，あるインデックス番号以降の値をすべて指定しない場合は，コンマ（,）の記述を省略してください。インデックス番号1のトレース取得レベルを（1），インデックス番号2のPRFトレース取得レベルを（2）とした場合，PRFトレース取得レベルは「（1）,（2）,...」と指定します。

PRFトレース取得レベルの指定例を次に示します。

表4‒3　PRFトレース取得レベルの指定例（cprflevelコマンド）

PRFトレース取得レベルの指定例

オプションの指定

インデックス番号1のPRFトレース取得レベルを指定する

-PrfChangeLevel 0x44445555

インデックス番号1とインデックス番号2のPRFトレース取得レベルを指定する

-PrfChangeLevel 0x44445555,0x55554444

インデックス番号2のPRFトレース取得レベルを指定する

-PrfChangeLevel ,0x55554444

各機能レイヤでのPRFトレース取得レベルの割り当てについて説明します。

PRFトレース取得レベルは，インデックスごとに8けたの16進数で指定します。それぞれのけたには，機能レイヤが二つずつ割り当てられています。16進数を2進数にした場合の上位2ビットに割り当てられている機能レイヤを上位レイヤ，下位2ビットに割り当てられている機能レイヤを下位レイヤといいます。

けたごとの上位レイヤ，下位レイヤに割り当てられている機能レイヤについて，次の表に示します。

表4‒4　詳細レベルのトレース情報を取得する場合の指定値（cprflevelコマンド）

インデックス

けた番号

上位レイヤ

下位レイヤ

インデックス1

1けた目

リダイレクタ

Webコンテナ

2けた目

EJBコンテナ

JNDI

3けた目

JTA

JCAコンテナ

4けた目

DB Connector

RMI

5けた目

SOAP通信基盤

TP1 Connector，

TP1/Client/J

6けた目

TP1/Message Queue - Access

Reliable Messaging

7けた目

OTS

（なし）

8けた目

CTM

（なし）

インデックス2

1けた目

HCSCサーバ

標準出力/標準エラー出力/ユーザログ

2けた目

DI

Service Coordinator Interactive Workflow

3けた目

HCSCサーバ（Object Accessアダプタ）

HCSCサーバ（ファイルアダプタ）

4けた目

HCSCサーバ（Message Queueアダプタ）

JPA

5けた目

JAX-WSエンジン

JPAコンテナ（V9互換モード）

6けた目

CJMSプロバイダ機能

TP1インバウンドアダプタ

7けた目

HCSCサーバ（FTPアダプタ，Kafkaアダプタ）

JavaMail

8けた目

Java VM

JSFおよびJSTL

インデックス3

1けた目

バッチアプリケーション実行基盤

（なし）

インデックス4

1けた目

CDI

（なし）

3けた目

（なし）

Websocket

インデックス5

1けた目

JSF 2.2

（なし）

2けた目

JAX-RS 2.0

JavaBatch 1.0

3けた目

Concurrency Utilities 1.0

JPAコンテナ（推奨モード）

インデックス9

1けた目

Elastic Application Data store

（なし）

PRFトレース取得レベルを指定する場合は，けたごとの上位レイヤ，下位レイヤのPRFトレース取得レベルを「標準」「詳細」「保守」のどのレベルで取得するかを決め，それを16進数で指定します。上位レイヤと下位レイヤのPRFトレース取得レベルの組み合わせと指定値の対応を，次の表に示します。

なお，保守レベルは，障害発生時などの保守情報を取得するためのレベルです。通常は指定しないでください。

表4‒5　詳細レベルまたは保守レベルのトレース情報を取得する場合の指定値（cprflevelコマンド）

上位レイヤ

下位レイヤ

指定値

標準

標準

0

標準

詳細

1

標準

保守

2

詳細

標準

4

詳細

詳細

5

詳細

保守

6

保守

標準

8

保守

詳細

9

保守

保守

a

指定例を示します。

表4‒6　PRFトレース取得レベルの指定例（cprflevelコマンド）

インデックス

指定例

説明

インデックス1

00000000

インデックス1の各機能レイヤの標準レベルのトレース情報を取得します。

00000004

CTMだけ詳細レベルのトレース情報を取得して，ほかの機能レイヤは標準レベルのトレース情報を取得します。

55555544

インデックス1の各機能レイヤの詳細レベルのトレース情報を取得します。

a5565544

リダイレクタ，WebコンテナおよびRMIの保守情報を取得して，ほかの機能レイヤは詳細レベルのトレース情報を取得します。

インデックス2

00000000

インデックス2の各機能レイヤの標準レベルのトレース情報を取得します。

40000000

HCSCサーバだけ詳細レベルのトレース情報を取得します。

また，RMIについては，抑止レベルを指定できます。

RMIに抑止レベルを指定するには，トレース取得レベルの指定値（インデックス1の4けた目）に次の値を設定してください。

表4‒7　RMIの抑止レベルの指定値

上位レイヤ（DB Connector）

下位レイヤ（RMI）

指定値

標準

抑止

3

詳細

抑止

7

保守

抑止

b

-PrfLevelIndex <インデックス番号>

変更または参照するPRFトレース取得レベルのインデックス番号を1〜16の整数で指定します。デフォルト値は1です。この引数と一緒に-PrfChangeLevelを指定した場合は，指定したインデックス番号のPRFトレース取得レベルのレベル値を-PrfChangeLevelで指定した値に変更します。

この引数と一緒に-PrfChangeLevelを指定しなかった場合は，指定したインデックス番号のPRFトレース取得レベルのレベル値が表示されます。この引数と一緒に-PrfChangeLevelを指定する場合は，-PrfChangeLevelには必ず一つの値だけを指定してください。

（例）インデックス番号2番目の値を，0x55554444に変更する場合

cprflevel -PrfChangeLevel 0x55554444 -PrfLevelIndex 2

-PrfChangeLevelに複数の値を指定した場合は，オプションエラーとなります。

（例）-PrfChangeLevelに複数の値を指定した場合

cprflevel -PrfChangeLevel ,0x55554444,0x55554444 -PrfLevelIndex 2

-PrfLevelIndexで2を指定しているにもかかわらず，-PrfChangeLevelで複数の値を指定しているためです。なお，-PrfLevelIndexの指定を省略した場合は，1が設定されます。

-PrfLevelAll

すべてのレベル値を表示します。-PrfChangeLevelまたは-PrfLevelIndexと組み合わせた指定はできません。このオプションと-PrfLevelIndexの組み合わせを，次に示します。

表4‒8　-PrfLevelAllと-PrfLevelIndexの組み合わせ一覧

cprflevel現在のレベル値の

表示方法

-PrfLevelIndex

指定

未指定

-PrfLevelAll

指定

オプションエラー

すべてのレベル値を表示

未指定

指定されたインデックス番号のレベル値だけを表示

インデックス1のレベル値だけを表示

指定できるコマンドオプションの組み合わせの一覧を次に示します。

表4‒9　引数（コマンドオプション）の組み合わせ一覧（cprflevelコマンド）

コマンド

オプション

-h

-PRFID

-PrfChangeLevel

-PrfLevelIndex

-PrfLevelAll

-h

−

△-h

△-h

△-h

△-h

-PRFID

△-h

−

○

○

○

-PrfChangeLevel

△-h

○

−

○

×

-PrfLevelIndex

△-h

○

○

−

×

-PrfLevelAll

△-h

○

×

×

−

（凡例）

○：同時に指定できます。

△：△のあとに続くオプション名のオプションが有効になります。

×：同時に指定できません。

−：該当しません。

戻り値

0：

正常終了しました。

1：

PRFデーモンが起動していません。PRFSPOOL環境変数が異なっている，または-PRFIDの値が誤っているおそれがあります。

2：

PRFSPOOL環境変数が設定されていません。

上記以外：

コマンド処理中にエラーが発生しました。出力されたメッセージに従って対策したあと，再度コマンドを実行してください。エラーメッセージは標準エラー出力，ログファイルに出力されます。資料の取得方法については，マニュアル「アプリケーションサーバ 機能解説保守／移行編」の「2.4.3　取得方法および調査方法との対応」を参照してください。

入力例・出力例

入力例1

cprflevel

出力例1

KFCT73415-I 2661 1: prf trace level is 0x12345678

入力例2

cprflevel -PrfLevelAll

出力例2

KFCT73418-I 2661 1: all prf trace levels are:
[ 1]=0x12345678 [ 2]=0x00000000 [ 3]=0x00000000 [ 4]=0x00000000
[ 5]=0x00000000 [ 6]=0x00000000 [ 7]=0x00000000 [ 8]=0x00000000
[ 9]=0x00000000 [10]=0x00000000 [11]=0x00000000 [12]=0x00000000
[13]=0x00000000 [14]=0x00000000 [15]=0x00000000 [16]=0x00000000

入力例3

cprflevel -PrfLevelIndex 5

出力例3

KFCT73419-I 2661 1: prf trace level of [5] is 0x00000000.

入力例4

cprflevel -PrfChangeLevel 000000001

出力例4

KFCT73416-I 2661 1: prf trace level was changed from 0x00000000 to 0x00000001.

入力例5

cprflevel -PrfChangeLevel 0x00000055,0x55554444

出力例5

KFCT73420-I 2661 1: prf trace level was changed:
[ 1]=0x00000000 -> [ 1]=0x00000055
[ 2]=0x00000000 -> [ 2]=0x55554444

入力例6

cprflevel -PrfChangeLevel 0x44445555 -PrfLevelIndex 2

出力例6

KFCT73420-I 2661 1: prf trace level was changed:
[ 2]=0x00000000 -> [ 2]=0x44445555

注意事項

現在のPRFトレース取得レベルを表示する場合，-PrfLevelIndexと-PrfLevelAllの組み合わせで，出力されるメッセージIDは，「KFCT73415-I」，「KFCT73418-I」，「KFCT73419-I」のどれか一つとなっています。PRFトレース取得レベルを表示する場合の出力されるメッセージIDの対応は，次のとおりです。

PRFトレース取得レベルを表示する場合のメッセージID

-PrfLevelAll

指定

未指定

-PrfLevelIndex

指定

−

KFCT73419-I

未指定

KFCT73418-I

KFCT73415-I

PRFトレース取得レベルを変更する場合，-PrfChangeLevelの指定方法で出力されるメッセージIDは，「KFCT73416-I」または「KFCT73420-I」のどちらかになります。次の条件をすべて満たした場合，「KFCT73416-I」が出力されます。それ以外は，「KFCT73420-I」が出力されます。

-PrfChangeLevel 0x44445555のように値を一つだけ指定し，コンマ（,）を使用していない。

-PrfLevelIndexを指定していない。

このコマンドは，PRFデーモンの起動中に実行してください。PRFデーモンが起動していないときにコマンドを実行した場合，エラーメッセージを出力します。

変更するPRFデーモンと同じPRFSPOOL環境変数が設定されている必要があります。

このコマンドでレベル変更した場合，次のリクエストから変更が有効になります。

cprfstart（PRFデーモンの開始）

形式

cprfstart [-h] [-PRFID <PRF識別子>]
          [-PrfTraceLevel <PRFトレース取得レベル> [,[<PRFトレース
          取得レベル>]...]]
          [-PrfTraceCount <PRFトレースファイル数>]
          [-PrfTraceFileSize <PRFトレースファイルサイズ>]
          [-PrfTraceBufferSize <PRFトレースバッファサイズ>]
          [-PrfRemakeBuffer]
          [-PrfNoBackUp [0|1]]

機能

PRFデーモン（cprfd）を起動します。なお，PRFデーモンは，ほかのプロセスよりも先に起動してください。

PRFデーモンは開始後にカレントディレクトリを移動します。移動先は，次のディレクトリです。

Windowsの場合

PRFトレース出力ディレクトリ%PRFSPOOL%¥utt¥prf¥<PRF識別子>¥

UNIXの場合

PRFトレース出力ディレクトリ$PRFSPOOL/utt/prf/<PRF識別子>/

引数

-h

コマンドの使用方法が表示されます。

-PRFID <PRF識別子>

PRF識別子を1〜31文字の英数字，またはアンダースコア（_）で指定します。"TSC"や"tsc"，または"CTM"や"ctm"で始まる文字列は指定しないでください。省略した場合は，"PRF_ID"という文字列がPRF識別子となります。

-PrfTraceLevel <PRFトレース取得レベル> [,[<PRFトレース取得レベル>]...]

-PrfTraceLevelを省略した場合は標準レベルで情報が出力されます。

PRFトレース取得レベルを4バイトの16進数（8けたの値）で指定します。ここで4バイトの16進数の先頭に0xを付けることができますが，0xは無視されます。

各インデックス番号のレベル値をコンマ（,）区切りで左から複数指定できます。レベル値の指定を省略する場合は，値を記述しないでください。また，あるインデックス番号以降の値をすべて指定しない場合は，コンマ（,）の記述を省略してください。インデックス番号1のトレース取得レベルを（1），インデックス番号2のPRFトレース取得レベルを（2）とした場合，PRFトレース取得レベルは「（1）,（2）,...」と指定します。

PRFトレース取得レベルの指定例を次に示します。

表4‒10　PRFトレース取得レベルの指定例（cprfstartコマンド）

PRFトレース取得レベルの指定例

オプションの指定

インデックス番号1のPRFトレース取得レベルを指定する

-PrfTraceLevel 0x44445555

インデックス番号1とインデックス番号2のPRFトレース取得レベルを指定する

-PrfTraceLevel 0x44445555,0x55554444

インデックス番号2のPRFトレース取得レベルを指定する

-PrfTraceLevel ,0x55554444

各機能レイヤでのPRFトレース取得レベルの割り当てについて説明します。

PRFトレース取得レベルは，インデックスごとに8けたの16進数で指定します。それぞれのけたには，機能レイヤが二つずつ割り当てられています。16進数を2進数にした場合の上位2ビットに割り当てられている機能レイヤを上位レイヤ，下位2ビットに割り当てられている機能レイヤを下位レイヤといいます。

けたごとの上位レイヤ，下位レイヤに割り当てられている機能レイヤについて，次の表に示します。

表4‒11　詳細レベルのトレース情報を取得する場合の指定値（cprfstartコマンド）

インデックス

けた番号

上位レイヤ

下位レイヤ

インデックス1

1けた目

リダイレクタ

Webコンテナ

2けた目

EJBコンテナ

JNDI

3けた目

JTA

JCAコンテナ

4けた目

DB Connector

RMI

5けた目

SOAP通信基盤

TP1 Connector，

TP1/Client/J

6けた目

TP1/Message Queue - Access

Reliable Messaging

7けた目

OTS

（なし）

8けた目

CTM

（なし）

インデックス2

1けた目

HCSCサーバ

標準出力/標準エラー出力/ユーザログ

2けた目

DI

Service Coordinator Interactive Workflow

3けた目

HCSCサーバ（Object Accessアダプタ）

HCSCサーバ（ファイルアダプタ）

4けた目

HCSCサーバ（Message Queueアダプタ）

JPA

5けた目

JAX-WSエンジン

JPAコンテナ

6けた目

CJMSプロバイダ機能

TP1インバウンドアダプタ

7けた目

HCSCサーバ（FTPアダプタ）

JavaMail

8けた目

Java VM

JSFおよびJSTL

インデックス3

1けた目

バッチアプリケーション実行基盤

（なし）

インデックス4

1けた目

CDI

（なし）

3けた目

（なし）

WebSocket

インデックス5

1けた目

JSF 2.2

（なし）

2けた目

JAX-RS 2.0

JavaBatch 1.0

3けた目

Concurrency Utilities 1.0

（なし）

インデックス9

1けた目

Elastic Application Data store

（なし）

PRFトレース取得レベルを指定する場合は，けたごとの上位レイヤ，下位レイヤのPRFトレース取得レベルを「標準」「詳細」「保守」のどのレベルで取得するかを決め，それを16進数で指定します。上位レイヤと下位レイヤのPRFトレース取得レベルの組み合わせと指定値の対応を，次の表に示します。

なお，保守レベルは，障害発生時などの保守情報を取得するためのレベルです。通常は指定しないでください。

表4‒12　詳細レベルまたは保守レベルのトレース情報を取得する場合の指定値（cprfstartコマンド）

上位レイヤ

下位レイヤ

指定値

標準

標準

0

標準

詳細

1

標準

保守

2

詳細

標準

4

詳細

詳細

5

詳細

保守

6

保守

標準

8

保守

詳細

9

保守

保守

a

指定例を示します。

表4‒13　PRFトレース取得レベルの指定例（cprfstartコマンド）

インデックス

指定例

説明

インデックス1

00000000

インデックス1の各機能レイヤの標準レベルのトレース情報を取得します。

00000004

CTMだけ詳細レベルのトレース情報を取得して，ほかの機能レイヤは標準レベルのトレース情報を取得します。

55555544

インデックス1の各機能レイヤの詳細レベルのトレース情報を取得します。

a5565544

リダイレクタ，WebコンテナおよびRMIの保守情報を取得して，ほかの機能レイヤは詳細レベルのトレース情報を取得します。

インデックス2

00000000

インデックス2の各機能レイヤの標準レベルのトレース情報を取得します。

40000000

HCSCサーバだけ詳細レベルのトレース情報を取得します。

また，RMIについては，抑止レベルを指定できます。

RMIに抑止レベルを指定するには，トレース取得レベルの指定値（インデックス1の4けた目）に次の値を設定してください。

表4‒14　RMIの抑止レベルの指定値

上位レイヤ（DB Connector）

下位レイヤ（RMI）

指定値

標準

抑止

3

詳細

抑止

7

保守

抑止

b

-PrfTraceCount <PRFトレースファイル数>

PRFトレースファイルの面数を3〜256の範囲で指定します。省略した場合は，4が設定されます。

正常停止中と前回強制停止後の再起動中に，PRFトレースファイルをバックアップします。PRFトレースファイルサイズの合計値が大きい場合，バックアップ処理でPRFデーモンの起動や停止に時間が掛かることがあります。そのため，Management Serverでプロセス監視する場合，デフォルトの監視時間ではタイムアウトが発生する場合があります。タイムアウトが発生した場合には，監視時間を長くしてください。

-PrfTraceFileSize <PRFトレースファイルサイズ>

PRFトレースファイルの１ファイル当たりの最大容量を1024〜1048576（単位：キロバイト）の範囲で指定します。ファイル容量を１メガバイトとする場合，1024と指定します。実際のファイルサイズは，この値より多少の増減があります。増減の中で増分の幅は，最大で「-PrfTraceBufferSize指定値−32キロバイト」です。省略した場合は，8192が設定されます。

デフォルト値の8192より小さい値を指定する場合は，-PrfTraceBufferSizeもデフォルト値より小さい値を指定してください。

-PrfNoBackUpオプションに0を指定した場合，正常停止中と前回強制停止後の再起動中に，PRFトレースファイルをバックアップします。PRFトレースファイルサイズの合計値が大きい場合，バックアップ処理でPRFデーモンの起動や停止に時間がかかることがあります。そのため，cprfstartコマンドに-PrfNoBackUp 0を指定する設定でManagement Serverでプロセス監視する場合，デフォルトの監視時間ではタイムアウトが発生する場合があります。タイムアウトが発生した場合には，監視時間を長くしてください。

-PrfTraceBufferSize <PRFトレースバッファサイズ>

共用メモリに確保するバッファサイズを512〜102400（単位：キロバイト）の範囲で指定します。このオプションには，-PrfTraceFileSizeで指定した値よりも大きい値は指定できません。省略した場合は，8192が設定されます。

バッファ領域が不足するとKFCT26999-Wメッセージが出力され，PRFトレースが欠落する場合があります。そのため，メッセージが出力されなくなるまでバッファ領域を拡張してください。

-PrfRemakeBuffer

共用メモリを再作成して起動します。再作成できない場合にはエラーとなります。

-PrfNoBackUp [0|1]

PRFデーモンの起動時，および停止時にPRFトレースファイルをバックアップするかを指定します。値に0を指定した場合，PRFトレースファイルをバックアップします。PRFトレースファイルをコピーするため，PRFデーモンの起動，および停止に時間が掛かることがあります。障害発生後，PRFトレースがラップするまでの間にPRFトレースファイルを採取できない場合は，値に0を指定してください。なお，Management Serverを使用している時は，障害発生後にPRFトレースファイルを含むsnapshotログを自動的に収集します。

値に1を指定した場合，PRFトレースファイルをバックアップしません。値を指定しなかった場合，値に1を指定したときと同じ動作をします。

PRFトレースファイルをバックアップするタイミング，バックアップの有無，および-PRFNoBackUpオプションの関係は次のようになります。

表4‒15　PRFトレースファイルをバックアップするタイミング，バックアップの有無，および-PRFNoBackUpオプションの関係

実行コマンド

前回開始したPRFデーモンの終了状態

PRFトレースファイルのバックアップ

-PrfNoBackUp 0

-PrfNoBackUp 1（デフォルト）

cprfstart

正常終了

しない

しない

強制終了または異常終了

する

しない

cprfstop

終了状態に依存しない

する

しない

cprfstop -Force

終了状態に依存しない

しない

しない

戻り値

0：

PRFデーモンが正常に起動しました。

1：

PRFデーモンの起動に失敗しました。PRFSPOOL環境変数が設定されていません。

上記以外：

コマンド処理中にエラーが発生しました。出力されたメッセージに従って対策したあと，再度コマンドを実行してください。エラーメッセージは標準エラー出力，ログファイルに出力されます。資料の取得方法については，マニュアル「アプリケーションサーバ 機能解説保守／移行編」の「2.4.3　取得方法および調査方法との対応」を参照してください。

注意事項

PRFSPOOL環境変数を設定してください。設定していない場合，コマンドがエラーリターンします。

PRFデーモンを再起動する場合，-PrfTraceCountと-PrfTraceFileSizeに前回と同じ値を指定して再起動してください。指定を省略して再起動した場合，PRFトレースファイル数とPRFトレースファイルサイズについては，前回の起動時の値は引き継がれないので，デフォルトの値になります。

PRFデーモンが異常終了して再起動した場合，終了時のトレース取得レベルが引き継がれます。そのため，トレース取得レベルを変更したあとに異常終了した場合，再起動時に指定したトレース取得レベル（前回起動時と同じ値）と異なる値（変更後の値）が設定されます。次に運用例を示します。

PRFデーモン起動：cprfstart -PrfTraceLevel 0x00000001

トレース取得レベル変更（0x00000001 → 0x0000000f）

PRFデーモン異常終了

PRFデーモン再起動：cprfstart -PrfTraceLevel 0x00000001

この場合，再起動後のトレース取得レベルは，0x000000fになります。

PRFデーモンを再起動する場合，前回使用したバッファを再利用し，トレース取得レベルを引き継ぎます。また，バッファのサイズが変更になった場合は，前回のバッファを削除し，再作成します。ほかのプロセスがバッファにアクセスしている場合，この作成処理に失敗します。

PRFデーモンを再起動した場合，共用メモリダンプ出力してから，バッファを初期化します。また，保守情報を次のディレクトリに作成します。

Windowsの場合

%PRFSPOOL%¥utt¥prf¥<PRF識別子>¥spool¥save¥

UNIXの場合

$PRFSPOOL/utt/prf/<PRF識別子>/spool/save/

Windowsの場合，起動済み，または起動中のPRFデーモンと，大文字・小文字だけが異なるPRF識別子（例えば"aaa"と"AAA"）を持つPRFデーモンは起動できません。

PRFデーモンが異常終了した場合，PRFデーモンだけを再起動してください。

PRFデーモンが異常終了してから再起動するまでの間に取得されたトレースは破棄されます。

-PrfTraceCountまたは-PrfTraceFileSizeに大きな値を指定すると，PRFデーモンが異常終了したあとのPRFデーモンの再起動に時間が掛かる場合があります。

cprfstop（PRFデーモンの停止）

形式

cprfstop [ -PRFID <PRF識別子> ] [ -Force ][ -h ]

機能

PRFデーモン（cprfd）を停止します。なお，PRFデーモンはほかのプロセスよりもあとに停止してください。

引数

-PRFID <PRF識別子>

PRF識別子を1〜31文字の英数字，またはアンダースコア（_）で指定します。"TSC"や"tsc"，または"CTM"や"ctm"で始まる文字列は指定しないでください。省略した場合は，"PRF_ID"という文字列がPRF識別子になります。

-Force

PRFデーモンを強制停止します。

-h

コマンドの使用方法が表示されます。

戻り値

0：

PRFデーモンが正常に停止しました。

1：

PRFデーモンが起動していません。PRFSPOOL環境変数が異なっている，または-PRFIDの値が誤っているおそれがあります。

2：

PRFSPOOL環境変数が設定されていません。

3：

タイムアウトが発生しました。

上記以外：

コマンド処理中にエラーが発生しました。出力されたメッセージに従って対策したあと，再度コマンドを実行してください。エラーメッセージは標準エラー出力，ログファイルに出力されます。資料の取得方法については，マニュアル「アプリケーションサーバ 機能解説保守／移行編」の「2.4.3　取得方法および調査方法との対応」を参照してください。

注意事項

コマンドがタイムアウトして，PRFデーモンが正常終了しなかった場合は，-Forceオプションを指定して強制停止してください。

停止するPRFデーモンと同じPRFSPOOL環境変数が設定されている必要があります。設定されていない場合，コマンドがエラーリターンします。

cprfstartコマンドの-PrfTraceCountまたは-PrfTraceFileSizeに大きな値を指定すると，PRFデーモンの正常停止に時間が掛かる場合があります。

5　CJMSプロバイダで使用するコマンド

この章では，CJMSプロバイダで使用するコマンドの入力形式，機能などについて説明します。

5.1　CJMSプロバイダで使用するコマンドの概要

CJMSプロバイダには，ブローカー構成を編集するために，CJMSPブローカーユーティリティとコマンドユーティリティがあります。

CJMSPブローカーユーティリティ

CJMSPブローカーインスタンスを起動するためのユーティリティで，cjmsbrokerコマンドを持っています。

コマンドユーティリティ

CJMSPブローカー，コネクションサービス，物理的送信先，永続化サブスクライバーおよびトランザクションを管理するためのユーティリティです。管理する対象ごとにコマンドを持っています。

5.2　CJMSプロバイダで使用するコマンドの一覧

ここでは，CJMSプロバイダで使用するコマンドの一覧について説明します。

5.2.1　CJMSPブローカーユーティリティのコマンドの一覧

CJMSPブローカーユーティリティが持つコマンドの一覧を次の表に示します。

表5‒1　CJMSPブローカーユーティリティのコマンドの一覧

コマンド名称

概要

cjmsbroker

CJMSPブローカーインスタンスを起動します。

5.2.2　コマンドユーティリティのコマンドの一覧

コマンドユーティリティが持つコマンドの一覧を管理対象ごとに説明します。なお，CJMSPブローカーの状態がSHUTDOWN_COMPLETE（停止処理が完了した状態）の場合，これらのコマンドは正常に動作しません。

(1)　CJMSPブローカー管理

表5‒2　CJMSPブローカー管理で使用するコマンドの一覧

コマンド名称

概要

cjmsicmd list bkr

CJMSPブローカーの状態を一覧表示します。

cjmsicmd pause bkr

稼働中のCJMSPブローカーを一時停止します。

cjmsicmd query bkr

CJMSPブローカーのプロパティ値を一覧表示します。

cjmsicmd resume bkr

CJMSPブローカーを再開します。

cjmsicmd shutdown bkr

CJMSPブローカーを停止します。

(2)　コネクションサービス管理

表5‒3　コネクションサービス管理で使用するコマンドの一覧

コマンド名称

概要

cjmsicmd list svc

利用可能なコネクションサービスを一覧表示します。

(3)　物理的送信先管理

表5‒4　物理的送信先管理で使用するコマンドの一覧

コマンド名称

概要

cjmsicmd compact dst

物理的送信先を圧縮します。

cjmsicmd create dst

物理的送信先を作成します。

cjmsicmd destroy dst

物理的送信先を破棄します。

cjmsicmd list dst

物理的送信先を一覧表示します。

cjmsicmd pause dst

物理的送信先へのメッセージ配信を一時停止します。

cjmsicmd purge dst

物理的送信先からすべてのメッセージを削除します。

cjmsicmd query dst

物理的送信先のプロパティ値を一覧表示します。

cjmsicmd resume dst

物理的送信先へのメッセージ配信を再開します。

(4)　永続化サブスクライバー管理

表5‒5　永続化サブスクライバー管理で使用するコマンドの一覧

コマンド名称

概要

cjmsicmd destroy dur

永続化サブスクライバーを破棄します。

cjmsicmd list dur

永続化サブスクライバーを一覧表示します。

cjmsicmd purge dur

永続化サブスクライバーのすべてのメッセージを削除します。

(5)　コマンドユーティリティの共通オプション

コマンドユーティリティが持っているすべてのコマンドに指定できる共通オプションがあります。コマンドユーティリティの共通オプションの一覧を次の表に示します。

表5‒6　コマンドユーティリティの共通オプションの一覧

オプション名称

概要

-rtm timeoutInterval

タイムアウト間隔（単位：秒）の初期値を0〜2147483647の整数で指定します。コマンドを実行してから再度要求を出すまでに，CJMSPブローカーからの応答を待つ時間の初期値です。リトライ間隔はタイムアウト間隔の初期値の倍数が設定されます。デフォルト値は10秒です。また，0を指定した場合は，タイムアウトは発生しません。

-b <ホスト名称>:<ポート番号>

CJMSPブローカーに接続されているホスト名（またはIPアドレス），ポート番号を指定します。デフォルト値は次のとおりです。

ホスト名称：localhost

ポート番号：7676

リモートホストでCJMSPブローカーインスタンスを起動しているときに正しい値を設定しないと，エラーメッセージが表示されます。

ホスト名称を省略してポート番号だけを指定した場合，ローカルホストのCJMSPブローカーに接続します。例えば，「:7676」と指定した場合，「localhost:7676」と指定した場合と同じ意味になります。

-f

ユーザの確認をしないで，コマンドを実行します。

-h | -help

ヘルプを表示します。

5.2.3　CJMSプロバイダで使用するコマンドの格納先

CJMSプロバイダで使用するコマンドは，次のディレクトリに格納されています。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥cjmsp¥bin¥

UNIXの場合

/opt/Cosminexus/CC/cjmsp/bin/

5.3　CJMSPブローカー管理のコマンドの詳細

CJMSPブローカー管理で使用するコマンドの入力形式，機能などを次に示します。

cjmsbroker（CJMSPブローカーの起動）

形式

cjmsbroker -name <インスタンス名称>
           -reset store
           -reset messages
           -reset durables
           -remove instance
           -varhome <ロケーション>
           -vmargs <引数1>[[<引数2>]...]
           -force
           -h | -help

機能

CJMSPブローカーインスタンスを起動します。

引数

-name <インスタンス名称>

起動するCJMSPブローカーインスタンスの名称を指定します。同じホストで複数のCJMSPブローカーインスタンスを起動する場合は，異なるインスタンス名称を指定してください。デフォルト値はcjmsbrokerです。

インスタンスの命名規則を次に示します。

Windows環境の場合，予約デバイス名は指定できません。

（例）

AUX，CON，NUL，PRN，COM1- COM9，LPT1-LPT9

指定できる文字数は，OSで規定されたディレクトリ作成時の最大文字数と同じです。

英数字と特殊文字を組み合わせて指定します。ただし，Windows環境の場合，次に示す特殊文字は使用できません。

¥　/　:　*　?　”　<　>　|

UNIX環境の場合，使用できる文字はファイルシステムの仕様に依存します。

インスタンス名称に円マーク（¥）またはスラッシュ（/）を使用した場合，動作保証しません。

-reset store

永続化データストアのコンフィグレーション値をリセットします。永続化データストアのコンフィグレーション値をリセットすると，永続化データストアにあるすべての永続化データが削除されます。

永続化データのうち，永続化メッセージだけを削除する場合は-reset messagesオプションを，永続化サブスクライバーだけを削除する場合は-reset durablesオプションを指定してください。

-reset messages

永続化データストアにある永続化データのうち，永続化メッセージだけを削除します。

-reset durables

永続化データストアにある永続化データのうち，永続化サブスクライバーだけを削除します。

-remove instance

CJMSPブローカーインスタンス下にある永続化データストアやその他のファイル，およびディレクトリを削除します。ただし，propsディレクトリとログディレクトリは削除されません。

なお，-remove instanceオプションを使用する場合，次の点に注意してください。

削除対象のCJMSPブローカーインスタンスは起動しないでください。

-nameオプションでCJMSPブローカーインスタンスの名称を指定した場合，指定したインスタンスが削除されます。また，-nameオプションを指定しない場合，デフォルトのCJMSPブローカーインスタンス「cjmsbroker」が削除されます。

cjmsbrokerコマンドはCJMSPブローカーインスタンスを起動するコマンドですが，-remove instanceオプションを指定した場合は，CJMSPブローカーインスタンスは起動されません。

-remove instanceコマンドですでに削除されている場合やインスタンスファイルのリポジトリがすでに削除されている場合は，「Removing instance data」というメッセージが表示されます。

-varhome <ロケーション>

varディレクトリの格納先を絶対パスで指定します。ただし，ネットワーク上のパスは指定できません。デフォルト値は<CJMSP_HOME>/varです。

格納先には書き込み権限と読み込み権限の両方を持つディレクトリを指定してください。読み込み権限しか持たないディレクトリを指定すると，エラーメッセージが表示されます。

また，指定したディレクトリが存在しない場合，または利用停止の場合，新しくディレクトリを作成します。

格納先に指定するパスの命名規則を次に示します。

Windows環境の場合，予約デバイス名は指定できません。指定した場合，エラーメッセージが表示されます。

（例）

AUX，CON，NUL，PRN，COM1- COM9，LPT1-LPT9

英数字と特殊文字を組み合わせて指定します。ただし，Windows環境の場合，次に示す特殊文字は使用できません。

¥　/　:　*　?　”　<　>　|

UNIX環境の場合，使用できる文字はファイルシステムの仕様に依存します。使用できない特殊文字を使用した場合，エラーメッセージが表示されます。

格納先に指定するパスはJavaの標準ファイルの構文規則に従います。

-vmargs <引数>

JavaVMに渡す引数を指定します。指定できる引数はJava HotSpot VMの引数です。指定できる引数の詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「14.　JavaVM起動オプション」を参照してください。なお，-XX:-HitachiOutOfMemoryAbortオプションを指定した場合，CJMSプロバイダは-vmargsオプションを無視します。

JavaVMへはコマンドラインからだけ引数を渡せます。CJMSPブローカーインスタンスのコンフィグレーションファイルには，関連する設定プロパティはありません。

次の場合，引数全体をダブルクォーテーション（"）で囲みます。

引数に空白が含まれている場合

引数にイコール（=）が含まれている場合

引数を二つ以上指定する場合（各引数はスペースで区切る）

（例）

cjmsbroker -vmargs "-Xms256m -Xmx1024m"

Xms：最小ヒープサイズ

Xmx：最大小ヒープサイズ

m：容量単位（メガバイト）

上記の例では，最小ヒープサイズを256メガバイト，最大ヒープサイズを１ギガバイトに設定します。CJMSPブローカーのJavaVMのヒープサイズのデフォルト値は192メガバイトです。

-force

ユーザの確認をしないで，動作を実行します。

-h | -help

ヘルプを表示します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

なお，-remove instanceオプションを指定した場合は，戻り値として次の値が返ります。

10：

削除対象のインスタンスが存在しません。

11：

削除対象のインスタンスは起動中です。

12：

インスタンスの削除権限がありません。

13：

インスタンスの削除中に内部エラーが発生しました。

14：

インスタンスの削除中にI/Oエラー発生がしました。

注意事項

インスタンスを作成するとディレクトリに書き込み権限が付与されますが，この権限は変更しないでください。読み込み権限しか持たないディレクトリをインスタンスとして指定すると，エラーメッセージが表示されます。

jmsサービスまたはadminサービスのどちらかが起動された場合に，CJMSPブローカーは起動されます。

cjmsicmd list bkr（CJMSPブローカーの一覧表示）

形式

cjmsicmd list bkr [-b <ホスト名称>:<ポート番号>]

機能

CJMSPブローカーの状態を一覧表示します。

CJMSPブローカーの状態には次の3種類があります。

OPERATING：CJMSPブローカーがメッセージを処理できる状態

SHUTDOWN_STARTED：CJMSPブローカーの停止処理が開始された状態

SHUTDOWN_COMPLETE：CJMSPブローカーの停止処理が完了した状態

詳細については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「7.17.3　CJMSPブローカーの状態の確認」を参照してください。

上記の状態のうち，一覧に表示できるのは，OPERATINGとSHUTDOWN_STARTEDです。SHUTDOWN_COMPLETEは一覧に表示できません。

引数

-b <ホスト名称>:<ポート番号>

ホスト名とポート番号を「:」で区切って指定します。

出力例

cjmsicmd list bkrの出力例を次に示します。

Cluster is Highly Available   false

--------------------------------
      Address            State
--------------------------------
DE205372437F45F:7676   OPERATING

KDAN34466-I Successfully listed broker.

出力ヘッダ

Address

CJMSPブローカーが起動時のホストアドレス（ホストシステムのホスト名またはIPアドレス）およびポート番号です。

State

CJMSPブローカーの現在の状態です。

戻り値

0：

正常終了しました。

1：

異常終了しました。

cjmsicmd pause bkr（CJMSPブローカーの一時停止）

形式

cjmsicmd pause bkr [-b <ホスト名称>:<ポート番号>]

機能

稼働中のCJMSPブローカーを一時停止します。

このコマンドを実行してCJMSPブローカーを一時停止すると，jmsサービスだけが停止され，adminサービスは起動されたままになります。そのため，CJMSPブローカーとしての状態はOPERATINGとなります。しかし，jmsサービスが停止しているので，メッセージは送受信できません。

引数

-b <ホスト名称>:<ポート番号>

ホスト名とポート番号を「:」で区切って指定します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

一時停止中のCJMSPブローカーに対してこのコマンドを実行すると，「Successfully paused the broker」というメッセージが表示されますが，コマンドは無視されます。

cjmsicmd query bkr（CJMSPブローカーのプロパティ値の一覧表示）

形式

cjmsicmd query bkr [-b <ホスト名称>:<ポート番号>]

機能

CJMSPブローカーのプロパティ値を一覧表示します。

引数

-b <ホスト名称>:<ポート番号>

ホスト名とポート番号を「:」で区切って指定します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

cjmsicmd resume bkr（CJMSPブローカーの再開）

形式

cjmsicmd resume bkr [-b <ホスト名称>:<ポート番号>]

機能

CJMSPブローカーを再開します。

引数

-b <ホスト名称>:<ポート番号>

ホスト名とポート番号を「:」で区切って指定します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

一時停止中ではないCJMSPブローカーに対してこのコマンドを実行すると，「Successfully resumed the broker」というメッセージが表示されますが，コマンドは無視されます。

cjmsicmd shutdown bkr（CJMSPブローカーの停止）

形式

cjmsicmd shutdown bkr [-b <ホスト名称>:<ポート番号>]
                      [-time <待機時間>]

機能

CJMSPブローカーを停止します。

引数

-b <ホスト名称>:<ポート番号>

ホスト名とポート番号を「:」で区切って指定します。

-time <待機時間>

コマンドを実行してからCJMSPブローカーが停止されるまでの待機時間を0〜2147483647の整数（単位：秒）で指定します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

コマンドを実行してから停止されるまでの間，起動中のjmsサービスは引き続き動作します。ただし，新しいjmsサービスは起動できません（adminサービスは起動できます）。

コマンドを実行してから停止されるまでの間に，このコマンドを実行すると，CJMSPブローカーはすぐに停止されます。なお，このコマンド以外のコマンドを実行した場合は，動作を保証しません。

5.4　コネクションサービス管理のコマンドの詳細

コネクションサービス管理で使用するコマンドの入力形式，機能などを次に示します。

cjmsicmd list svc（コネクションサービスの一覧表示）

形式

cjmsicmd list svc [-b <ホスト名称>:<ポート番号>]

機能

利用可能なコネクションサービスを一覧表示します。

引数

-b <ホスト名称>:<ポート番号>

ホスト名とポート番号を「:」で区切って指定します。

出力例

cjmsicmd list svcの出力例を次に示します。

-----------------------------------------------
Service Name    Port Number       Service State
-----------------------------------------------
admin           3616 (dynamic)    RUNNING
jms             0 (dynamic)       PAUSED

KDAN34113-I Successfully listed services.

出力ヘッダ

Service Name

利用可能なサービス名です。

Port number

サービスに割り当てられたポート番号です。

CJMSPブローカーによって割り当てられた，またはユーザが割り当てたポート番号です。

Service State

現在のサービスの状態です。状態は，RUNNINGまたはPAUSEDになります。

戻り値

0：

正常終了しました。

1：

異常終了しました。

5.5　物理的送信先管理のコマンドの詳細

物理的送信先管理で使用するコマンドの入力形式，機能などを次に示します。

cjmsicmd compact dst（物理的送信先の圧縮）

形式

cjmsicmd compact dst [-t <送信先タイプ>
                      -n <送信先名称>]
                     [-b <ホスト名称>:<ポート番号>]

機能

物理的送信先のファイルベースの永続化ストアデータを圧縮します。

引数

-t <送信先タイプ>

送信先タイプを指定します。指定できる送信先タイプは次のとおりです。

q：キュー

t：トピック

-n <送信先名称>

送信先名を指定します。

-tオプションおよび-nオプションを省略した場合，すべての物理的送信先が圧縮されます。

-b <ホスト名称>:<ポート番号>

ホスト名とポート番号を「:」で区切って指定します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

物理的送信先は圧縮する前に一時停止してください。

cjmsicmd create dst（物理的送信先の作成）

形式

cjmsicmd create dst  -t <送信先タイプ>
                     -n <送信先名称>
                    [[-o <プロパティ>=<値>]...]
                    [-b <ホスト名称>:<ポート番号>]

機能

物理的送信先を作成します。

引数

-t <送信先タイプ>

送信先タイプを指定します。指定できる送信先タイプは次のとおりです。

q：キュー

t：トピック

-n <送信先名称>

送信先名を指定します。

送信先の命名規則は次のとおりです。

英数字で指定してください。

最初の文字は，英字，アンダースコア（_），ドル記号（$）を指定してください。

最初の文字に「mq.」および数字は指定できません。

「__JMQAdmin」は，CJMSプロバイダによって自動生成される物理的送信先の名称であるため指定できません。

空白は指定できません。

「<OSで定められている指定可能なディレクトリ名の長さの上限値>-1」以内の長さの名称を指定してください。「<OSで定められている指定可能なディレクトリ名の長さの上限値>-1」を超える長さの名称を指定した場合，コマンドの実行には成功しますが，メッセージの送信時に例外が発生します。

-o <プロパティ>=<値>

プロパティ名を指定します。

-oオプションで使用できるプロパティを次に示します。

consumerFlowLimit

maxNumMsgs

maxTotalMsgBytes

maxNumProducers

無効な値を設定した場合は，エラーメッセージが表示されます。

プロパティの詳細については，「5.7　物理的送信先の設定プロパティ」を参照してください。

-b <ホスト名称>:<ポート番号>

ホスト名とポート番号を「:」で区切って指定します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

一つのCJMSPブローカーインスタンスに対して，送信先タイプが異なれば，同じ名称の物理的送信先を作成できます。送信先タイプが同じ場合は，同じ名称の物理的送信先は作成できません。

異なるCJMSPブローカーインスタンスであれば，同じ名称の物理的送信先を作成できます。

CJMSPブローカー個別プロパティファイルでimq.autocreate.queue(topic).consumerFlowLimitを設定し，-oオプションにはconsumerFlowLimitを指定しないでこのコマンドを実行した場合，作成された物理的送信先には，imq.autocreate.queue(topic).consumerFlowLimitで指定した数のメッセージを配信できます。imq.autocreate.queue(topic).consumerFlowLimitを設定しない場合，配信できるメッセージ数はキューが100，トピックが1000（consumerFlowLimitのデフォルト値）となります。

cjmsicmd destroy dst（物理的送信先の破棄）

形式

cjmsicmd destroy dst  -t <送信先タイプ>
                      -n <送信先名称>
                     [-b <ホスト名称>:<ポート番号>]

機能

物理的送信先を破棄します。

引数

-t <送信先タイプ>

送信先タイプを指定します。指定できる送信先タイプは次のとおりです。

q：キュー

t：トピック

-n <送信先名称>

送信先名を指定します。

-b <ホスト名称>:<ポート番号>

ホスト名とポート番号を「:」で区切って指定します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

デッドメッセージキューなどのシステムによって作成された送信先に対して，この操作はできません。

cjmsicmd list dst（物理的送信先の一覧表示）

形式

cjmsicmd list dst [-t <送信先タイプ>]
                  [-tmp]
                  [-b <ホスト名称>:<ポート番号>]

機能

物理的送信先を一覧表示します。

送信先タイプの指定がない場合は，キューとトピック両方のタイプの物理的送信先が一覧表示されます。

引数

-t <送信先タイプ>

送信先タイプを指定します。指定できる送信先タイプは次のとおりです。

q：キュー

t：トピック

-tmp

一時的な物理的送信先を一覧表示します。

-b <ホスト名称>:<ポート番号>

ホスト名とポート番号を「:」で区切って指定します。

出力例

cjmsicmd list dstの出力例を次に示します。

--------------------------------------------------------------------------
    Name      Type    State   Producers  Consumers           Msgs
                                           Total    Count  UnAck  Avg Size
--------------------------------------------------------------------------
JMSDEMOQueue  Queue  RUNNING  0          1          1000   451    210.0
JMSDEMOTopic  Topic  RUNNING  0          0          0      0      0.0
mq.sys.dmq    Queue  RUNNING  0          0          3999   0      702.0

KDAN34110-I Successfully listed destinations.

出力ヘッダ

Name

システムまたはユーザが作成した送信先名です。mq.sys.dmqは，システムで作成されたデッドメッセージキューです。

Type

送信先の種類です。種類は，キューとトピックがあります。mq.sys.dmqの送信先はキューです。

State

送信先の状態です。正常な送信先の状態は，RUNNINGまたはPAUSEDです。

Producers

送信先のアクティブプロデューサーの数です。

Consumers Total

送信先のアクティブコンシューマーの数です。

Count

送信先に蓄えられたメッセージ数です。

Msgs UnAck

送信先で応答のなかったメッセージ数です。

Avg Size

メッセージの平均サイズです。

戻り値

0：

正常終了しました。

1：

異常終了しました。

cjmsicmd pause dst（物理的送信先のメッセージ配信の一時停止）

形式

cjmsicmd pause dst [-t <送信先タイプ>
                    -n <送信先名称>]
                   [-b <ホスト名称>:<ポート番号>]

機能

物理的送信先に対して，メッセージ配信を一時停止します。

送信先タイプと送信先名称の指定がない場合は，すべての物理的送信先を一時停止します。

引数

-t <送信先タイプ>

送信先タイプを指定します。指定できる送信先タイプは次のとおりです。

q：キュー

t：トピック

-n <送信先名称>

送信先名を指定します。

-b <ホスト名称>:<ポート番号>

ホスト名とポート番号を「:」で区切って指定します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

一時停止中の物理的送信先に対してこのコマンドを実行した場合，無視されます。

デッドメッセージキューを一時停止する場合は，ほかの物理的送信先からのメッセージを受け付けられるようにするため，最後に停止してください。また，再開する場合は，デッドメッセージキューを最初に再開してください。

cjmsicmd purge dst（物理的送信先のメッセージの削除）

形式

cjmsicmd purge dst  -t <送信先タイプ>
                    -n <送信先名称>
                   [-b <ホスト名称>:<ポート番号>]

機能

物理的送信先からすべてのメッセージを削除します。

引数

-t <送信先タイプ>

送信先タイプを指定します。指定できる送信先タイプは次のとおりです。

q：キュー

t：トピック

-n <送信先名称>

送信先名を指定します。

-b <ホスト名称>:<ポート番号>

ホスト名とポート番号を「:」で区切って指定します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

cjmsicmd query dst（物理的送信先のプロパティ値の一覧表示）

形式

cjmsicmd query dst  -t <送信先タイプ>
                    -n <送信先名称>
                   [-b <ホスト名称>:<ポート番号>]

機能

物理的送信先のプロパティ値（単位：バイト）を一覧表示します。

引数

-t <送信先タイプ>

送信先タイプを指定します。指定できる送信先タイプは次のとおりです。

q：キュー

t：トピック

-n <送信先名称>

送信先名を指定します。

-b <ホスト名称>:<ポート番号>

ホスト名とポート番号を「:」で区切って指定します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

cjmsicmd resume dst（物理的送信先へのメッセージ配信の再開）

形式

cjmsicmd resume dst [-t <送信先タイプ>
                     -n <送信先名称>]
                    [-b <ホスト名称>:<ポート番号>]

機能

物理的送信先へのメッセージ配信を再開します。

送信先タイプと送信先名称の指定がない場合は，すべての物理的送信先を一時停止します。

引数

-t <送信先タイプ>

送信先タイプを指定します。指定できる送信先タイプは次のとおりです。

q：キュー

t：トピック

-n <送信先名称>

送信先名を指定します。

-b <ホスト名称>:<ポート番号>

ホスト名とポート番号を「:」で区切って指定します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

状態がRUNNINGの物理的送信先に対してこのコマンドを実行すると，「Successfully resumed the destination」というメッセージが表示されますが，コマンドは無視されます。

5.6　永続化サブスクライバー管理のコマンドの詳細

永続化サブスクライバー管理で使用するコマンドの入力形式，機能などを次に示します。

cjmsicmd destroy dur（永続化サブスクライバーの破棄）

形式

cjmsicmd destroy dur -n <サブスクライバー名称>
                     -c <クライアントID>
                    [-b <ホスト名称>:<ポート番号>]

機能

永続化サブスクライバーを破棄します。

引数

-n <サブスクライバー名称>

永続化サブスクライバー名を指定します。

-c <クライアントID>

クライアントIDを指定します。

-b <ホスト名称>:<ポート番号>

ホスト名とポート番号を「:」で区切って指定します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

cjmsicmd list dur（永続化サブスクライバーの一覧表示）

形式

cjmsicmd list dur -d <トピック名称>
                 [-b <ホスト名称>:<ポート番号>]

機能

永続化サブスクライバーを一覧表示します。

引数

-d <トピック名称>

トピック名を指定します。

-b <ホスト名称>:<ポート番号>

ホスト名とポート番号を「:」で区切って指定します。

出力例

cjmsicmd list dur の出力例を次に示します。

トピック名に「Test_Topic」を指定した場合

-----------------------------------------------------------------------
Durable Sub. Name   Client ID   Number of Messages   Durable Sub. State
-----------------------------------------------------------------------
DurableSUB1         clientID3   2998                 INACTIVE

KDAN34323-I Successfully listed durable subscriptions.

出力ヘッダ

Durable Sub. Name

永続化サブスクライバー名です。

Client ID

永続化サブスクライバー用のクライアントID値です。

Number of Messages

永続化サブスクライバーで使用されていないメッセージ数です。

Durable Sub. State

永続化サブスクライバーの使用状態です。

戻り値

0：

正常終了しました。

1：

異常終了しました。

cjmsicmd purge dur（永続化サブスクライバーの削除）

形式

cjmsicmd purge dur -n <サブスクライバー名称>
                   -c <クライアントID>
                  [-b <ホスト名称>:<ポート番号>]

機能

永続化サブスクライバーのすべてのメッセージを削除します。

引数

-n <サブスクライバー名称>

永続化サブスクライバーを指定します。

-c <クライアントID>

クライアントIDを指定します。

-b <ホスト名称>:<ポート番号>

ホスト名とポート番号を「:」で区切って指定します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

5.7　物理的送信先の設定プロパティ

ここでは，コマンドユーティリティのcjmsicmd create dstコマンド（物理的送信先の作成）の-oオプションに指定する設定プロパティについて説明します。

表5‒7　物理的送信先の設定プロパティの一覧

プロパティ

説明

maxNumMsgs

コンシューマーに配信されないメッセージの最大数を-1〜2147483647の整数で指定します。省略した場合，-1が設定されます。-1はメッセージ数が無制限であることを示します。デッドメッセージキューの場合は，省略すると1000が設定されます。

0を指定した場合は，-1とみなされます。

maxTotalMsgBytes

コンシューマーに配信されないメッセージ用の総メモリ量の最大値を-1〜2147483647の整数で指定します。また，サフィックスとしてb（バイト），k（キロバイト），m（メガバイト）を指定できます。

省略した場合，-1が設定されます。デッドメッセージキューの場合は，省略すると10mが設定されます。

サフィックスを省略した場合は，bとなります。

-1を指定した場合，メモリ量は無制限となります。

consumerFlowLimit

一つのバッチでコンシューマーに配信されるメッセージの最大数を-1〜2147483647の整数で指定します。

省略した場合，送信先タイプによって次の値が設定されます。

キュー：100

トピック：1000

デッドメッセージキュー：1000

-１を指定した場合，メッセージの数は無制限になります。

maxNumProducers

プロデューサーの最大数を-1または1〜2147483647の整数で指定します。省略した場合は，-1（無制限）が設定されます。

プロデューサー数が指定した最大値（-1を除く）に達した場合，新しいプロデューサーは作成できません。

なお，0は指定できません。指定した場合は，エラーメッセージが表示されます。

5.8　CJMSプロバイダで使用するコマンドの注意事項

ここでは，CJMSプロバイダで使用するコマンドの注意事項について説明します。

CJMSPブローカーでは大文字と小文字を区別します。ただし，OSがWindowsの場合，インスタンス名およびコマンドは大文字と小文字を区別しません。例えば，cjmsbrokerとCJMSBROKERは同じ意味になります。

-oオプションは，オーバーライドできません。ただし，プロパティの特徴が異なっている場合は，設定できます。同じプロパティが設定された場合，最後に設定されたプロパティが適用されます。

-hオプションまたは-helpオプションを指定した場合，そのほかのオプションは無視されます。

例：cjmsicmd create dst -n TestQueue -t t -h

CJMSプロバイダのコマンドでは，同じオプションを二つ以上指定した場合，最後のオプションの値が有効となります。

例：cjmsicmd create dst -n hello -t q -t t

上記の場合，-tオプションを二つ指定していますが，有効になるのは-t tです。

無効なオプションを指定してコマンドを実行した場合，指定したオプションが別のコマンドで有効であれば，エラーにはなりませんが，無視されます。ただし，オプションの入力形式が間違っている場合は，エラーとなります。

（例1）

cjmsicmd list bkr -n jms

-nオプションは物理的送信先を指定するオプションで，cjmsicmd list bkrコマンドでは無効です。しかし，オプションの入力形式が正しいので，エラーにならないで，cjmsicmd list bkrコマンドは正しく動作します。

（例2）

cjmsicmd list bkr -n

-nオプションはcjmsicmd list bkrコマンドでは無効なオプションである上，入力形式にも誤りがあります（送信先が指定されていない）。この場合は，エラーとなります。

6　CTMで使用するコマンド

この章では，CTMで使用するコマンドの入力形式，機能などについて説明します。

6.1　CTMで使用するコマンドの一覧

CTMで使用するコマンドは，ctmで始まります。CTMで使用するコマンドの一覧を，次の表に示します。

表6‒1　CTMで使用するコマンドの一覧

コマンド名称

分類

概要

ctmchpara

スケジュールキューの同時実行数の変更

CTMで管理するスケジュールキューの同時実行数を動的に変更します。

ctmdminfo

CTMドメイン情報の表示と削除

CTMドメインに関する情報を表示または削除します。

ctmdmstart

CTMドメインマネジャの開始

CTMドメインマネジャを開始します。

ctmdmstop

CTMドメインマネジャの終了

CTMドメインマネジャを終了します。

ctmgetior

IOR文字列の取得

ORBゲートウェイに登録されているオブジェクトのIOR文字列を取得します。

ctmgetpid

プロセスIDの取得

CTMドメインマネジャ，CTMデーモンのプロセスIDを取得します。

ctmholdque

スケジュールキューの閉塞

スケジュールキューを閉塞します。

ctmjver

実行形式ファイルおよびライブラリのバージョン情報の出力

CTMが提供するjarファイルのバージョン情報を出力します。

ctmidl2cpp

C++のスタブコードの生成

IDLファイルからOTMクライアント用のC++のスタブコードを生成します。

ctmidl2j

Javaのスタブコードの生成

IDLファイルからOTMクライアント用のJavaのスタブコードを生成します。

ctmjava2idl

IDLの生成

EJBのクラスファイルからIDLを生成します。

ctmlogcat

メッセージの編集と出力

CTMで出力したメッセージを編集して標準出力に出力します。

ctmlsque

スケジュールキュー情報の出力

スケジュールキューのスケジューリング情報を標準出力に出力します。

ctmrasget

トラブルシュート情報の取得と出力

CTMが必要とするトラブルシュート情報を取得し，出力します。

ctmregltd

CTMレギュレータの開始

CTMレギュレータを開始します。

ctmridinfo

CTMドメイン情報の出力

CTMドメイン情報を標準出力に出力します。

ctmrlesque

スケジュールキューの閉塞解除

スケジュールキューの閉塞状態を解除します。

ctmstart

CTMデーモンの開始

CTMデーモンを開始します。

ctmstartgw

ORBゲートウェイの開始

ORBクライアントのリクエストをCTMで処理するためのゲートウェイプロセスを開始します。

ctmstop

CTMデーモンの終了

CTMデーモンを終了します。

ctmstopgw

ORBゲートウェイの終了

ORBクライアントのリクエストをCTMで処理するためのゲートウェイプロセスを終了します。

ctmstsed

稼働統計情報の編集と出力

取得した稼働統計情報を必要な情報・出力形式に編集して出力します。

ctmstsflush

バッファ内容の強制ファイル出力

バッファ内のリクエスト情報をファイルに出力します。

ctmstsstart

稼働統計情報の取得開始

稼働統計情報ファイルへの情報の取得を開始します。

ctmstsstop

稼働統計情報の取得終了

稼働統計情報ファイルへの情報の取得を終了します。

ctmtscgwd

OTMゲートウェイの開始

OTMクライアントのリクエストをCTMで処理するためのゲートウェイプロセスを開始します。

ctmver

実行形式ファイルおよびライブラリのバージョン情報の出力

CTMが提供する実行形式ファイルおよびライブラリのバージョン情報を出力します。

6.2　CTMで使用するコマンドの詳細

CTMで使用する各コマンドの入力形式，機能などを次に示します。

コマンドの格納先

CTMで使用するコマンドは，次のディレクトリに格納されています。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CTM¥bin¥

UNIXの場合

/opt/Cosminexus/CTM/bin/

ctmchpara（スケジュールキューの同時実行数の変更）

形式

ctmchpara  [-h] [-CTMDomain <CTMドメイン名称>] [-CTMID <CTM識別子>]
           [-CTMMyHost <ホスト名称またはIPアドレス>]
           [-CTMTimeOut <タイムアウト値>]
           -CTMQueue <スケジュールキュー名称>
           -CTMChangeCount <同時実行数>

機能

スケジュールキュー単位の同時実行数を変更します。同時実行数は，スレッド数を増減させることで変更します。

スレッドを増加する場合と減少する場合のコマンド完了については，次のように処理されます。

スレッドを増加する場合，スレッドの生成完了を待ち合わせます。

スレッドを減少する場合，リクエストの完了を待ってスレッドを消滅させますが，コマンドは待ち合わせません。

スレッド数はスケジュールキューの状態が次の場合に変更できます。なお，スケジュールキューの状態は，ctmlsqueコマンドで表示される"Status"を確認してください。

A：スケジューリング可能状態

H：スケジューリング閉塞中

C：スケジューリング可能閉塞

また，同時実行数を変更すると，CTMキューを共有するアプリケーションのスレッド数は平均化されます。

引数

-h

コマンドの使用方法が表示されます。

-CTMDomain <CTMドメイン名称>

同時実行数を変更するCTMデーモンのCTMドメイン名称を1〜31文字の英数字，またはアンダースコア（_）で指定します。

"CTM"または"ctm"で始まる文字列は指定しないでください。省略した場合は"CTMDOMAIN"が設定されます。

-CTMID <CTM識別子>

同時実行数を変更するCTMデーモンのCTM識別子を1〜31文字の英数字，ピリオド（.），またはアンダースコア（_）で指定します。

"CTM"または"ctm"で始まるCTM識別子は指定しないでください。ピリオド（.）は，IPアドレスを指定する場合だけ使用できます。省略した場合は，IPアドレスでCTM識別子が設定されます。

例えば，ホストのIPアドレスが"172.17.112.43"のとき，"172.17.112.43"という文字列がCTM識別子となります。

-CTMMyHost <ホスト名称またはIPアドレス>

マルチホームまたはIPアドレスを引き継ぐ系切り替え環境でCTMが使用するホスト名称またはIPアドレスを指定します。値は1〜64文字の文字列で指定します。省略した場合は，hostnameコマンドで取得されるホスト名称が設定されます。

-CTMTimeOut <タイムアウト値>

スケジュールキューの同時実行数変更処理の待ち時間（単位：秒）を0〜2147483647の整数で指定します。"0"を指定した場合，無限に待ち続けます。省略した場合は"180"(秒)が設定されます。

-CTMQueue <スケジュールキュー名称>

同時実行数を変更するスケジュールキューの登録名称を1〜63文字の英数字，またはアンダースコア（_）で指定します。

-CTMChangeCount <同時実行数>

同時実行数の変更値を1からキューの共有数×127までの整数で指定します。CTMデーモン起動時に指定した-CTMDispatchParallelCountオプションの値（CTMデーモン起動時に-CTMDispatchParallelCount オプションを省略した場合は"255"）より大きい値は指定できません。例えば，同時実行数を30から10に変更したい場合は，10を指定してください。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生しました。出力されたメッセージに従って対策したあと，再度コマンドを実行してください。

注意事項

バッチアプリケーションを実行するシステムでは，このコマンドを使用しないでください。使用した場合，システムの動作は不定となります。

スケジュールキューを共有しているJ2EEサーバ数より同時実行数を小さくする場合，各J2EEサーバにリクエストを送信するスレッド数は1となります。

このコマンドを実行するには，Session Beanのプールのインスタンス数を無制限または同時実行数の最大値"127"以上の値に設定してください。

J2EEアプリケーションを停止した場合，またはJ2EEサーバが異常終了した場合の同時実行数は次のように処理されます。

コマンド実行前の場合：

該当するJ2EEアプリケーション分の同時実行数を減少させます。

コマンド実行後の場合：

スケジュールキューの同時実行数の設定値は変更されません。

コマンドで設定した同時実行数および実行の成否は，変更先のCTMログ，またはctmlsqueコマンドで表示される"ParallelCount"で確認してください。

ctmdminfo（CTMドメイン情報の表示と削除）

形式

ctmdminfo [-h] [-d]

機能

ホスト内のCTM環境に登録済みのCTMドメインに関する情報を表示または削除します。

引数

-h

コマンドの使用方法が表示されます。

-d

ホスト内のCTM環境に登録済みのCTMドメイン情報を削除します。

"ctmdminfo -d"の実行後に，現在のCTM環境に登録済みのCTMSPOOLとCTMドメイン名称の一覧が表示されます。一覧から削除したい組み合わせの番号を選択し，コマンドの指示に従って入力します。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

入力例・出力例

-dオプションを指定してctmdminfoコマンドを実行します。

ctmdminfo -d

CTMドメイン名称およびCTMSPOOLの一覧が表示されます。

Windowsの場合

No CTM-Domain   Port   CTMSPOOL
1 hitachi       9496   C:¥Program Files¥HITACHI¥ctm¥spool
2 CTMDOMAIN     20137  C:¥Program Files¥HITACHI¥Cosminexus¥CTM¥spool
Please input Number which you wish delete. ->

UNIXの場合

No CTM-Domain   Port   CTMSPOOL
1 hitachi       9496   /home/hitachi/ctm/spool
2 CTMDOMAIN     20137  /opt/Cosminexus/CTM/spool
Please input Number which you wish delete. ->

削除したい環境を表す数字を入力します。

Please input Number which you wish delete. -> 2

問題がなければ"y"を入力します。

Windowsの場合

2 CTMDOMAIN     20137  C:¥Program Files¥HITACHI¥Cosminexus¥CTM¥spool
We will delete this combination of Domain_name and CTMSPOOL directory.
OK ? (y/n) -> y

UNIXの場合

2 CTMDOMAIN     20137  /opt/Cosminexus/CTM/spool
We will delete this combination of Domain_name and CTMSPOOL directory.
OK ? (y/n) -> y

注意事項

同じホストにTPBroker Object Transaction Monitorの環境が存在する場合，TSCドメインに関する情報も表示または削除できるため注意してください。

ctmdmstart（CTMドメインマネジャの開始）

形式

ctmdmstart  [-h] [-CTMDomain <CTMドメイン名称>]
            [-CTMMaxCTM <CTMデーモン管理最大数>]
            [-CTMPort <CTMドメイン管理ポート番号>]
            [-CTMMyHost <ホスト名称またはIPアドレス>]
            [-CTMSendInterval <CTMデーモン情報の送信間隔>]
            [-CTMSubnetMask <サブネットマスク>]
            [-CTMSendHost <ホスト名称またはIPアドレス>
            [,<ホスト名称またはIPアドレス>,...]]
            [-CTMSendHostInterval
             <異なるネットワークセグメントへのCTMデーモン情報の送信間隔>]
            [-CTMAliveCheckCount <CTMドメインマネジャ稼働判定係数>]
            [-CTMForceStart | -CTMAutoForce]

機能

CTMドメインマネジャを開始します。

引数

-h

コマンドの使用方法が表示されます。

-CTMDomain <CTMドメイン名称>

CTMドメインマネジャが属するCTMドメイン名称を1〜31文字の英数字，またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まる文字列は指定しないでください。省略した場合は"CTMDOMAIN"が設定されます。

-CTMMaxCTM <CTMデーモン管理最大数>

CTMドメイン内で管理するCTMデーモンの最大数を1〜1024の整数で指定します。省略した場合は"64"が設定されます。

-CTMPort <CTMドメイン管理ポート番号>

CTMドメインマネジャがCTMデーモン情報を交換するために使用するポート番号を5001〜65535の整数で指定します。同じCTMドメイン名称を持つCTMドメインマネジャを複数のホストで開始する場合，-CTMPortオプションに同じ値を指定してください。省略した場合はサービス名ファイルが参照されます。サービス名ファイルに指定がないときは"20137"が設定されます。

サービス名ファイルへの記述の形式を次に示します。

CTM_CTMドメイン名称       ポート番号/tcp

例えば，"ctmdmstart -CTMDomain JAPAN"と指定してCTMドメインマネジャを開始する場合，サービス名ファイルの，次のように指定したエントリが読み込まれます。

CTM_JAPAN                  10021/tcp

CTMドメインマネジャは一つのポート番号でtcpおよびudpの両方のプロトコルを使用します。そのため，CTMドメインマネジャが使用するポート番号をほかのudpのポート番号として使用しないでください。

-CTMPortオプションの指定値は，異常終了後にCTMドメインマネジャを再開始するときは変更しないでください。変更したい場合は，CTMドメインマネジャを正常終了させてから変更してください。

-CTMMyHost <ホスト名称またはIPアドレス>

マルチホームまたはIPアドレスを引き継ぐ系切り替え環境でCTMが使用するホスト名称またはIPアドレスを1〜64文字の文字列で指定します。省略した場合は，hostnameコマンドで取得されるホスト名称が設定されます。

-CTMMyHostオプションの指定値は，異常終了後にCTMドメインマネジャを再開始するときは変更しないでください。変更したい場合は，CTMドメインマネジャを正常終了させてから変更してください。

-CTMSendInterval <CTMデーモン情報の送信間隔>

CTMドメインマネジャがCTMデーモン情報をネットワークセグメント内にブロードキャストする間隔を秒単位で指定します。値は0〜65535の整数で指定してください。CTMデーモン情報をブロードキャストしない場合は，"0"を指定してください。省略した場合は"60（秒）"が設定されます。

-CTMSendIntervalオプションに大きな値を指定すると，異なるホスト上で開始したCTMドメインマネジャにCTMデーモン情報をブロードキャストする間隔が長くなり，CTMデーモン間でのEnterprise Beanの呼び出しに失敗することがあります。小さな値を指定する場合，異なるホスト上で開始したCTMドメインマネジャにCTMデーモン情報をブロードキャストする間隔が短くなります。その結果，ネットワークに負荷が掛かることがあります。

-CTMSubnetMask <サブネットマスク>

ネットワークのサブネットマスクを，xxx.xxx.xxx.xxxの形式で指定します。xxxには0〜255の整数を指定します。区切りにはピリオドを指定します。

省略した場合は"255.255.255.0"が設定されます。

-CTMSendHost <ホスト名称またはIPアドレス> [,<ホスト名称またはIPアドレス>,...]

CTMデーモン情報の配布先となる，異なるネットワークセグメントにあるCTMドメインマネジャが動作するホストのホスト名称またはIPアドレスを指定します。値は英数字，ピリオド（.），ハイフン（-），またはアンダースコア（_）で指定します。

このオプションを指定することで，複数のネットワークセグメントで構成したCTMドメインで，CTMデーモン情報を配布できるようになります。

ホスト名称を指定する場合は，<Windowsディレクトリ>¥system32¥drivers¥etc¥hosts（Windowsの場合），またはetc/hosts（UNIXの場合）に設定されているホスト名称を指定してください。また，ハイフン（-）で始まるホスト名称またはIPアドレスは指定しないでください。指定した場合の動作は保証しません。

複数のホストを指定する場合は，指定値をコンマ（,）で区切ります。次に指定例を示します。

-CTMSendHost HOSTA,HOSTB

-CTMSendHostInterval <異なるネットワークセグメントへのCTMデーモン情報の送信間隔>

異なるネットワークセグメントにあるCTMドメインマネジャが動作するホストにCTMデーモン情報を送信する間隔を秒単位で指定します。値は0〜65535までの整数で指定します。CTMデーモン情報を送信しない場合は，"0"を指定してください。また，省略した場合は，-CTMSendIntervalオプションに指定した値が設定されます。

-CTMSendHostIntervalオプションに大きな値を指定すると，異なるホスト上で開始したCTMドメインマネジャにCTMデーモン情報を送信する間隔が長くなり，CTMデーモン間でのEnterprise Bean呼び出しに失敗することがあります。小さな値を指定する場合，異なるホスト上で開始したCTMドメインマネジャにCTMデーモン情報を送信する間隔が短くなります。その結果，ネットワークに負荷が掛かることがあります。

-CTMSendHostIntervalオプションに値を指定しても，-CTMSendHostオプションを指定しなければ無効になります。また，-CTMSendHost，-CTMSendInterval，および-CTMSendHostIntervalオプションの指定値によってCTMデーモン情報の送信の有無は異なります。

コマンドオプションの指定値とCTMデーモン情報の送信の関係を次の表に示します。

-CTMSendHost

-CTMSendHostInterval

-CTMSendInterval

CTMデーモン情報

指定あり

0

0

×

0以外※

×

０以外

0

○

0以外※

○

指定なし

0

×

0以外※

○

指定なし

無効

無効

×

（凡例）

○：送信されます。

×：送信されません。

注※

-CTMSendIntervalオプションを指定しない場合のデフォルト値（60秒）を含みます。

-CTMAliveCheckCount <CTMドメインマネジャ稼働判定係数>

異なるホスト上で開始したCTMドメインマネジャが稼働しているかどうかを判定する係数を，2から255までの整数で指定します。省略した場合は，"2"が設定されます。稼働判定間隔は，次のどちらかの値になります。

ブロードキャストによってCTMデーモン情報を送信してきたCTMドメインマネジャの，-CTMSendIntervalオプションで指定した<CTMデーモン情報の送信間隔>に<CTMドメインマネジャ稼働判定係数>を掛けた値。

ネットワークセグメントを超えてCTMデーモン情報を送信してきたCTMドメインマネジャの，-CTMSendHostIntervalオプションで指定した<異なるネットワークセグメントへのCTMデーモン情報の送信間隔>に<CTMドメインマネジャ稼働判定係数>を掛けた値。

稼働判定間隔の間にCTMデーモン情報が送信されなかった場合，送信元のCTMドメインマネジャが停止したと判定して，送信元に対するCTMデーモン情報は削除されます。CTMデーモン情報が削除された場合，そのCTMデーモンへのリクエストの振り分けはされません。

-CTMForceStart

前回に強制終了または異常終了した場合に，CTMドメインマネジャを強制的に正常開始します。前回管理していたCTMデーモンを強制終了し，管理情報を初期化してCTMドメインマネジャを開始します。このとき，CTMデーモンは再開始されません。

前回に正常終了していた場合は正常開始するため，-CTMForceStartオプションの指定は無視されます。

-CTMForceStartオプションは，-CTMAutoForceオプションと同時に指定できません。

-CTMAutoForce

前回に強制終了または異常終了した場合に，前回の管理情報を引き継いでCTMドメインマネジャを自動強制開始します。前回の管理情報を正常に引き継げる場合は，終了前のシステム状態を復元できます。前回の管理情報を引き継げない場合は，-CTMForceStartオプションが指定されたときと同じように動作します。

前回に正常終了していた場合は正常開始するため，-CTMAutoForceオプションの指定は無視されます。

-CTMAutoForceオプションは，-CTMForceStartオプションと同時に指定できません。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

注意事項

CTMドメインマネジャは開始後にカレントディレクトリを移動します。そのため，次に示す場合のコアファイルの出力先は，実行形式ファイルのディレクトリとは異なります。

"ctmdmstop -CTMForce -CTMDebugInfo"，killコマンドなどでCTMドメインマネジャを強制終了した場合

CTMドメインマネジャが異常終了した場合

移動後のカレントディレクトリを次に示します。

Windowsの場合

"%CTMSPOOL%¥adm¥CTMドメイン名称¥"

UNIXの場合

"$CTMSPOOL/adm/CTMドメイン名称/"

CTMドメインマネジャとCTMデーモンが異常終了し，CTMデーモンの子プロセスであるCTMレギュレータが存在している状態で，CTMドメインマネジャに-CTMForceStartオプションを指定して，強制的に正常開始した場合，CTMドメインマネジャはCTMデーモンの子プロセスを強制停止します。

ctmdmstop（CTMドメインマネジャの終了）

形式

ctmdmstop  [-h] [-CTMDomain <CTMドメイン名称>]
           [-CTMMyHost <ホスト名称またはIPアドレス>]
           [-CTMForce [-CTMDebugInfo]]

機能

CTMドメインマネジャを終了します。

引数

-h

コマンドの使用方法が表示されます。

-CTMDomain <CTMドメイン名称>

CTMドメインマネジャが属するCTMドメイン名称を1〜31文字の英数字，またはアンダースコア（_）で指定します。

"CTM"または"ctm"で始まる文字列は指定しないでください。省略した場合は"CTMDOMAIN"が設定されます。

-CTMMyHost <ホスト名称またはIPアドレス>

マルチホームまたはIPアドレスを引き継ぐ系切り替え環境でCTMが使用するホスト名称またはIPアドレスを1〜64文字の文字列で指定します。省略した場合は，hostnameコマンドで取得されるホスト名称が設定されます。

-CTMMyHostオプションの指定値は，異常終了後にCTMドメインマネジャを再開始するときは変更しないでください。変更したい場合は，CTMドメインマネジャを正常終了させてから変更してください。

-CTMForce

CTMドメインマネジャを強制終了します。

-CTMForceオプションでCTMドメインマネジャを強制終了させたあとの再開始では，ctmdmstartコマンドに-CTMForceStartオプションを指定して開始してください。

-CTMDebugInfo

CTMドメインマネジャの強制終了時にデバッグ情報として，共用メモリダンプおよびコアを取得します。-CTMDebugInfoオプションは，-CTMForceオプションを指定した場合にだけ有効です。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

ctmgetior（IOR文字列取得コマンド）

形式

ctmgetior  [-h] |
         [ { -CTMDomain <CTMドメイン名称>[,<CTMドメイン名称>...] | -CTMDomainAll } ]
         [ { -CTMID <CTM識別子>[,<CTM識別子>...] | -CTMIDAll } ]
         [-CTMHost <ホスト名称又はIPアドレス>[,<ホスト名称又はIPアドレス>...]]
         [-CTMMyHost <ホスト名称又はIPアドレス>]
         [-CTMInterfaceName <リモートインタフェース名[,<リモートインタフェース名>...]]
         [-CTMLookupName <Lookup名称>[,<Lookup名称>...]]
         [-CTMOutPath <出力ディレクトリ名>]

機能

ORBゲートウェイに登録されているオブジェクトのIOR文字列を取得します。このコマンドは，オプションに指定された条件に合致するオブジェクトのIOR文字列を抽出し，ファイルに出力します。ORBクライアントアプリケーションは，このコマンドが出力するファイルのIOR文字列を使用することで，任意のORBゲートウェイに接続できます。このコマンドで出力するファイルには，テキスト形式で，IOR文字列だけが出力されます。

引数

-h

コマンドの使用方法が表示されます。

-CTMDomain <CTMドメイン名称>[，<CTMドメイン名称>...]

IOR文字列取得対象となるORBゲートウェイが属するCTMドメイン名称を英数字で指定します。複数のCTMドメイン名称を指定できます。

"CTM"または"ctm"で始まる文字列は指定しないでください。省略した場合は"CTMDOMAIN"が設定されます。IOR文字列を取得する場合は，このコマンドと同じホストで開始済みのCTMドメイン名称を指定してください。

このオプションは，-CTMDomainAllオプションと同時に指定できません。

-CTMDomainAll

このコマンドを実行するホストにあるすべてのCTMドメインを対象として，IOR文字列を取得します。自ホスト内にあるCTMドメインを確認する場合はctmdminfoコマンドを実行してください。省略した場合，-CTMDomainオプションで指定されたCTMドメインを対象としてIOR文字列を取得します。

このオプションは，-CTMDomainオプションと同時に指定できません。

-CTMID <CTM識別子>[，<CTM識別子>...]

IOR文字列取得対象となるORBゲートウェイが属するCTMノードのCTM識別子を英数字またはピリオド（.）で指定します。複数のCTM識別子を指定できます。

"CTM"または"ctm"で始まるCTM識別子は指定しないでください。省略した場合は，IPアドレスでCTM識別子が設定されます。

例えば，ホストのIP アドレスが"172.17.112.43"のとき，"172.17.112.43"という文字列がCTM識別子となります。

このオプションは，-CTMIDAllオプションと同時に指定できません。

-CTMIDAll

指定されたCTMドメインが認識するすべてのCTM識別子を対象としてIOR文字列を取得します。省略した場合，-CTMIDオプションで指定されたCTM識別子を対象としてIOR文字列を取得します。

このオプションは，-CTMIDオプションと同時に指定できません。

-CTMHost <ホスト名称またはIPアドレス>[，<ホスト名称またはIPアドレス>...]

IOR文字列取得対象となるホストのホスト名称またはIPアドレスを1〜64文字のアスキー文字列で指定します。複数のホスト名称またはIPアドレスを指定できます。

-CTMDomainオプション（または-CTMDomainAllオプション）および-CTMIDオプション（または-CTMIDAllオプション）で指定されたCTMノードのうち，このオプションで指定されたホストにあるCTMノードを対象としてIOR文字列を取得します。省略した場合，このコマンドでIOR文字列の取得を要求したホストのCTMドメインマネジャが認識できる，すべてのホストを対象とします。

-CTMMyHost <ホスト名称またはIPアドレス>

マルチホームドホスト環境でCosminexus Component Transaction Monitorが使用するホスト名称又はIPアドレスを1〜64文字のアスキー文字列で指定します。省略した場合は，gethostnameシステムコールによって取得したホスト名称が設定されます。

-CTMIDオプションを省略して，-CTMMyHostオプションを指定した場合，デフォルトのCTM識別子は-CTMMyHostオプションで指定したIPアドレスになります。

-CTMInterfaceName <リモートインタフェース名称>[，<リモートインタフェース名称>...]

IOR文字列取得対象となるEJBのリモートインタフェース名称を英数字またはピリオド（.）で指定します。複数のEJBリモートインタフェース名称を指定できます。

リモートインタフェース名はDDファイル（ejb-jar.xml）の<remote>タグで指定される名称です。package指定がある場合は完全修飾クラス名で指定してください。省略した場合は，対象となるCTMドメインが認識するORBゲートウェイに登録されている，すべてのEJBを対象とします。

-CTMLookupName <Lookup名称>[，<Lookup名称>...]

IOR文字列取得対象となるEJBのLookup名称をアスキー文字列で指定します。複数のLookup名称が指定できます。省略した場合は，対象となるCTMドメインが認識するORBゲートウェイに登録されている，すべてのEJBのLookup名称が対象となります。

-CTMOutPath <出力ディレクトリ名称>

IOR文字列ファイルを出力するディレクトリ名称（相対パスまたは絶対パス）を指定します。省略した場合は，コマンドを実行した時のカレントディレクトリに出力します。使用できる文字列は次のとおりです。

Windowsの場合

〜＜英数字，ピリオド（.），円符号（¥），プラス（+），コロン（：），およびハイフン（-）＞≪カレントディレクトリ≫

UNIXの場合

〜＜英数字，ピリオド（.），スラッシュ（/），プラス（+），およびハイフン（-）＞≪カレントディレクトリ≫

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

出力形式

IOR文字列ファイルは，取得対象となるORBゲートウェイに登録されているEJBのオブジェクト一つにつき，一つずつ出力されます。各EJBのIOR文字列ファイルは，次に示すディレクトリおよびファイル名称で出力されます。

aa...aa

ORBゲートウェイに登録されているEJBのLookup名称

bb...bb

ORBゲートウェイに登録されているEJBのリモートインタフェース名

cc...cc

ORBゲートウェイが動作しているホストのIPアドレス

dd...dd

ORBゲートウェイ開始時に-CTMEjbPortで指定したポート番号

（例）

aa...aa/bb...bb/cc...cc#dd...dd.ior

-CTMOutPathに指定したディレクトリ下に出力されます。スラッシュ（/）はディレクトリの区切りを表します。Windowsの場合は円符号（¥）となります。

Lookup名称の階層（スラッシュ（/）で区切られる）はそのままディレクトリ階層となります。

注意事項

コマンドオプション引数を複数指定する場合，区切り文字としてコンマ（,）を指定してください。また，各オプション引数とコンマ（,）の間に空白を入れないでください。

すでに同一ファイル名称を持つファイルが存在した場合，そのファイルに上書きします。IOR文字列ファイルを退避しておきたい場合はその都度ファイルをコピーしておいてください。

次の条件をすべて満たしている場合だけ，IOR文字列を取得できます。

取得対象となるORB ゲートウェイプロセスが-CTMIDLConnectオプションに1を指定して開始されている。

取得対象となるEJBがデプロイされている。

コマンドを実行するホスト上で，該当するCTMドメインマネジャが開始されている。

ほかのホスト上のORBゲートウェイのIOR文字列を取得するときは，取得対象となるホストでも，該当するCTMドメインマネジャが開始されている。

出力処理で障害が発生した場合，IOR文字列ファイルが不正な内容になっているおそれがあります。

ctmgetpid（プロセスIDの取得）

形式

ctmgetpid  [-h] | -CTMDomain <CTMドメイン名称> [-CTMID <CTM識別子>]
           [-CTMMyHost <ホスト名称またはIPアドレス>]
           [-CTMGWID <ORBゲートウェイ識別子>]

機能

プロセス監視を実行する場合に使用します。CTMドメインマネジャ，CTMデーモン，またはORBゲートウェイのプロセスIDを取得します。

引数

-h

コマンドの使用方法が表示されます。

-CTMDomain <CTMドメイン名称>

-CTMIDオプションを指定する場合，プロセスID取得対象となるCTMデーモンが属するCTMドメイン名称を1〜31文字の英数字，またはアンダースコア（_）で指定します。

-CTMIDオプションを省略する場合，プロセスID取得対象となるCTMドメインマネジャのCTMドメイン名称を1〜31文字の英数字，またはアンダースコア（_）で指定します。

指定するときは，"CTM"または"ctm"で始まるCTMドメイン名称は指定しないでください。

-CTMID <CTM識別子>

プロセスID取得対象となるCTMデーモンのCTM識別子を1〜31文字の英数字，ピリオド（.），またはアンダースコア（_）で指定します。

"CTM"または"ctm"で始まるCTM識別子は指定しないでください。ピリオド（.）は，IPアドレスを指定する場合だけ使用できます。省略した場合は，-CTMDomainオプションで指定されたCTMドメインマネジャのプロセスIDが取得されます。

-CTMMyHost <ホスト名称またはIPアドレス>

マルチホームまたはIPアドレスを引き継ぐ系切り替え環境でCTMが使用するホスト名称またはIPアドレスを指定します。値は1〜64文字の文字列で指定します。省略した場合は，hostnameコマンドで取得されるホスト名称が設定されます。

-CTMGWID <ゲートウェイ識別子>

プロセスID 取得対象となるゲートウェイ識別子を1〜32 文字の英数字で指定します。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

ctmholdque（スケジュールキューの閉塞）

形式

ctmholdque  [-h] [-CTMDomain <CTMドメイン名称>] [-CTMID <CTM識別子>]
            [-CTMMyHost <ホスト名称またはIPアドレス>]
            {-CTMQueue <スケジュールキュー登録名称> | -CTMQueueALL}
            [[-CTMRequestLeave] [-CTMTimeOut <タイムアウト値>]
             | [-CTMChangeServer]]
            [-CTMForce]

機能

スケジュールキューを閉塞します。

スケジュールキューを閉塞すると，それ以降のリクエストとスケジュールキュー内のリクエストはエラーになります。ただし，-CTMRequestLeaveオプションを指定した場合，スケジュールキュー内のリクエストは閉塞状態でもJ2EEアプリケーションで処理されます。

また，-CTMChangeServerオプションを指定して閉塞した場合，オンライン状態でJ2EEアプリケーションを入れ替えられます。

引数

-h

コマンドの使用方法が表示されます。

-CTMDomain <CTMドメイン名称>

スケジュールキューを閉塞するCTMデーモンのCTMドメイン名称を1〜31文字の英数字，またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まる文字列は指定しないでください。省略した場合は"CTMDOMAIN"が設定されます。

-CTMID <CTM識別子>

スケジュールキューを閉塞するCTMデーモンのCTM識別子を1〜31文字の英数字，ピリオド（.），またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まるCTM識別子は指定しないでください。ピリオド（.）は，IPアドレスを指定する場合だけ使用できます。省略した場合は，IPアドレスでCTM識別子が設定されます。

例えば，ホストのIPアドレスが"172.17.112.43"のとき，"172.17.112.43"という文字列がCTM識別子となります。

-CTMMyHost <ホスト名称またはIPアドレス>

マルチホームまたはIPアドレスを引き継ぐ系切り替え環境でCTMが使用するホスト名称またはIPアドレスを指定します。値は1〜64文字の文字列で指定します。省略した場合は，hostnameコマンドで取得されるホスト名称が設定されます。

-CTMQueue <スケジュールキュー登録名称>

閉塞するスケジュールキューの登録名称を1〜63文字の英数字，またはアンダースコア（_）で指定します。

バッチアプリケーションを実行するシステムでは，スケジュールキューの登録名称としてスケジュールグループ名を指定してください。

-CTMQueueALL

すべてのスケジュールキューを一括して閉塞します。このとき，閉塞済みのスケジュールキューも含まれます。

-CTMRequestLeave

スケジュールキュー閉塞時に，スケジュールキューに滞留しているリクエストを破棄しないでスケジュールキューを閉塞します。破棄しなかったリクエストは，J2EEアプリケーションで処理されます。

ctmholdqueコマンドは滞留しているすべてのリクエストが取り出されるのを，-CTMTimeOutオプションの指定値まで待ち合わせます。リクエストの待ち合わせ中にctmrlesqueコマンドによって閉塞解除された場合は，リクエストの受け付けを可能にして，ctmholdqueコマンドは正常終了します。

-CTMTimeOut <タイムアウト値>

スケジュールキューの閉塞処理の待ち時間（単位：秒）を0〜2147483647の整数で指定します。"0"を指定した場合，無限に待ち続けます。省略した場合は"180"(秒)が設定されます。

-CTMChangeServer

スケジュールキューからJ2EEアプリケーションへのリクエストのスケジュールを閉塞します。このとき，EJBクライアントからのリクエストをキューイングできます。また，スケジュールキューに滞留しているリクエストは，ctmrlesqueコマンドによって閉塞解除されるまで保持されます。ただし，CTMデーモンを停止する場合には，スケジュールキューに滞留しているリクエストを破棄して停止処理を続行します。

-CTMChangeServerオプションでスケジュールキューを閉塞した場合，リクエストのキューイングおよび滞留しているリクエストを保持するため，オンライン状態でJ2EEアプリケーションを入れ替えられます。なお，同じCTMドメイン内にスケジュール可能なJ2EEアプリケーションが存在する場合には，負荷が掛かっていないJ2EEアプリケーションに対応するスケジュールキューにスケジュールします。

-CTMChangeServerオプションは，-CTMRequestLeaveオプションおよび-CTMTimeOutオプションと同時に指定できません。

J2EEサーバが異常終了したときのリクエスト保持機能（ctmstart -CTMQueueDeleteWait）と併用した場合，J2EEサーバが異常終了したあとにctmholdque -CTMChangeServerは実行できません。

-CTMForce

スケジュールキュー閉塞時に，CTMデーモンに通信を行わないでスケジュールキューを高速に閉塞します。その際，滞留しているリクエストは一定時間後に破棄されます。ただし，同時に-CTMRequestLeaveオプションを指定すると，滞留しているリクエストは破棄されません。また，同時に-CTMChangeServerオプションを指定した場合，-CTMChangeServerオプションは無視されます。

戻り値

0：

正常終了しました。

1：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

2：

指定されたスケジュールキューはすでに閉塞しています。なお，この戻り値は-CTMQueueオプションを指定した場合だけ返却されます。

ctmjver（実行形式ファイルおよびライブラリのバージョン情報の出力）

形式

ctmjver -h | <ファイルパス>

機能

CTMが提供するjarファイルのバージョン情報を出力します。

引数

-h

コマンドの使用方法が表示されます。

<ファイルパス>

対象となるファイルパス（相対パスおよび絶対パス）を指定します。

出力形式

Information For：aa…aa
Product Name：bb…bb
PP Number：cc…cc
Version：dd…dd
Copyright：ee…ee
Company：ff…ff
Build OS：gg…gg
Build Compiler：hh…hh
Build Date：ii…ii jj…jj
Build Number：kk…kk

（凡例）

aa…aa：ファイル名称（文字列）

bb…bb：製品名称（文字列）

cc…cc：PP型名（文字列）

dd…dd：バージョンおよびリビジョン（文字列）

ee…ee：コピーライト（文字列）

ff…ff：会社名（文字列）

gg…gg：ビルドOS（文字列）

hh…hh：ビルドコンパイラ（文字列）

ii…ii：ビルド日付（文字列）

jj…jj：ビルド時刻（文字列）

kk…kk：保守情報 (文字列)

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

ctmidl2cpp（C++スタブ生成コマンド）

形式

ctmidl2cpp  [-h] |
            [-TSCclient_ext <文字列>] [-client_ext <文字列>]
            [-TSChdr_suffix <拡張子名>] [-hdr_suffix <拡張子名>]
            [-TSCsrc_suffix <拡張子名>] [-src_suffix <拡張子名>]
            [-TSCroot_dir <パス名>] [-root_dir <パス名>]
            [-TSCsrc_dir <パス名>]
            [-TSChdr_dir <パス名>]
            [-TSCexport <文字列>] [-export <文字列>]
            [-type_code_info]※
            [-namespace]※
            [-gen_included_files]
            [[-I <ディレクトリ>[;<ディレクトリ>...]]...]
            [-A] <IDLファイル>

注※

OTMV5環境でだけ使用できます。

機能

IDLファイルからOTMクライアント用のC++のスタブコードを生成します。

引数

-h

コマンドの使用方法が表示されます。

-TSCclient_ext <文字列>

クライアント部分を出力するファイル名称に付ける文字列を指定します。省略した場合は"_TSC_c"が設定されます。

-client_ext <文字列>

idl2cppコマンドで出力されるクライアント部分のファイルに付ける文字列を指定します。省略した場合は"_c"が設定されます。

-TSChdr_suffix <拡張子名>

ヘッダファイルの拡張子を指定します。省略した場合は"hh"が設定されます。

-hdr_suffix <拡張子名>

idl2cppコマンドで出力されるヘッダファイルのサフィックス名称を指定します。省略した場合は-TSChdr_suffixオプションで指定する拡張子名が使用されます。どちらも指定されていない場合は".hh"が設定されます。

-TSCsrc_suffix <拡張子名>

ソースファイルの拡張子を指定します。省略した場合は"cc"が設定されます。

-src_suffix <拡張子名>

idl2cppコマンドで出力されるソースファイルのサフィックス名称を指定します。省略した場合は-TSCsrc_suffixオプションで指定する拡張子名が使用されます。どちらも指定されていない場合は".cc"が設定されます。

-TSCroot_dir <パス名>

ソースファイルおよびヘッダファイルを出力するディレクトリを指定します。指定したディレクトリがない場合は，ディレクトリを作成します。

出力先を変更した場合，コンパイル時に出力先ディレクトリをインクルードファイルのサーチパスに指定してください。

-root_dir <パス名>

idl2cppコマンドで出力されるソースファイルおよびヘッダファイルを出力するディレクトリを指定します。

出力先を変更した場合，コンパイル時に出力先ディレクトリをインクルードファイルのサーチパスに指定する必要があります。

-TSCsrc_dir <パス名>

ソースファイルを出力するディレクトリを指定します。指定したディレクトリがない場合は，ディレクトリを作成します。

-TSChdr_dir <パス名>

ヘッダファイルを出力するディレクトリを指定します。指定したディレクトリがない場合は，ディレクトリを作成します。

出力先を変更した場合，出力ファイルのコンパイル時に，出力先ディレクトリをインクルードファイルのサーチパスに指定してください。

-TSCexport <文字列>

TSCユーザプロキシにエクスポートタグを指定します。-TSCexportオプションは，WindowsでDLL内のクラスにアクセスするための宣言に使用します。

-export <文字列>

idl2cppコマンドで出力されるスタブにエクスポートタグを指定します。-exportオプションはWindowsでDLL内のクラスにアクセスするための宣言に使用します。

-type_code_info

IDLに定義されたデータ型に対するTypeCode情報を，idl2cppコマンドで出力されるクライアント部分のファイルに生成します。生成されたTypeCode情報を利用すると，CORBA::Any型を容易に扱えます。

このオプションは，OTMV5 環境でだけ使用できます。

-namespace

moduleをnamespaceとして実装します。namespaceとして出力されるmodule名称は，classとして出力された名称のようには拡張されないで，IDL に定義した名称のままになります。

このオプションは，OTMV5 環境でだけ使用できます。

-gen_included_files

includeされたIDL定義を出力します。

-I <ディレクトリ>[; <ディレクトリ>...]

インクルードファイルのサーチパスを指定します。複数指定する場合，UNIXの場合は:（コロン），Windowsの場合は;（セミコロン）で区切るか，または-Iオプションを複数回指定してください。

-A

内部でosagentを開始しません。ローカルホスト内で，すでにosagentが開始されている場合に指定してください。

<IDLファイル>

入力のIDLファイル名称を指定します。-hオプションを指定する場合だけ省略できます。IDLファイル名称は必ずコマンドラインの最後に指定してください。また，IDLファイル名称の拡張子は必ず".idl"にしてください。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

注意事項

OTMのバージョンによって一部動作が異なります。

TSCDIR環境変数を設定してください。

OTM クライアントのバージョンに対応した，TPBrokerの共用ライブラリ，コマンドを使用できるようにしてください。OTMクライアントがV3の場合は，TPBrokerV3 のディレクトリを，OTMがV5の場合は，TPBrokerV5のディレクトリを設定してください。

表6‒2　コマンド実行時の環境変数設定内容

OTMクライアント

環境変数の設定に必要な製品

OTM V3

OTM V5

TPBrokerV3

TPBrokerV5

CTM

V3

○

×

○

×

○

V5

×

○

×

○

○

（凡例）

○：環境変数設定必要。

×：環境変数設定不要。

PATH環境変数にTPBrokerのosagent，idl2ir，irep，およびOTMのtscidl2cppが格納されているディレクトリを設定してください。

オプションとコマンドオプション引数との間に，必ず空白を入れてください。

CTMで使用できない定義が含まれている場合，不正な動作をしたり，または不正なファイルが出力されたりするおそれがあります。

ctmidl2cppコマンドの実行中に，内部で使用しているTPBroker，およびOTMのメッセージが出力される場合があります。

ctmidl2j（Javaスタブ生成コマンド）

形式

ctmidl2j  [-h] |
          [-package <パッケージ名>]
          [-CTMroot_dir <パス名>] [-root_dir <パス名>]
          [-gen_included_files]
          [[-I <ディレクトリ>[;<ディレクトリ>...]]...]
          [-A] <IDLファイル>

機能

IDLファイルからOTMクライアント用のJavaのスタブコードを生成します。

引数

-h

コマンドの使用方法が表示されます。

-package <パッケージ名>

IDLファイルに定義したパッケージ名の前に，-packageオプションで指定したパッケージ名を付加します。指定したパッケージ名のディレクトリがない場合は，ディレクトリが作成されます。指定したパッケージ名のディレクトリがある場合は，そのディレクトリの内容が更新されます。なお，-packageオプションを指定しなくても，同一ユーザ定義IDLインタフェースの相手とは通信できます。

-TSCroot_dir <パス名>

ソースファイルおよびヘッダファイルを出力するディレクトリを指定します。指定したディレクトリがない場合は，ディレクトリを作成します。

-root_dir <パス名>

idl2javaコマンドで出力されるソースファイルおよびヘッダファイルを出力するディレクトリを指定します。

-gen_included_files

includeされたIDL定義を出力します。

-I <ディレクトリ>[;<ディレクトリ>...]

インクルードファイルのサーチパスを指定します。複数指定する場合，UNIXの場合は:（コロン），Windowsの場合は;（セミコロン）で区切るか，または-Iオプションを複数回指定してください。

-A

内部でosagentを開始しません。ローカルホスト内で，すでにosagentが開始されている場合に指定してください。

<IDLファイル>

入力のIDLファイル名称を指定します。-hオプションを指定する場合だけ省略できます。IDLファイル名称は必ずコマンドラインの最後に指定してください。また，IDLファイル名称の拡張子は必ず".idl"にしてください。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

注意事項

OTMのバージョンによって一部動作が異なります。

TSCDIR環境変数を設定してください。

OTM クライアントのバージョンに対応した，TPBrokerの共用ライブラリ，コマンドを使用できるようにしてください。OTMクライアントがV3の場合は，TPBrokerV3 のディレクトリを，OTMがV5の場合は，TPBrokerV5のディレクトリを設定してください。

表6‒3　コマンド実行時の環境変数設定内容

OTMクライアント

環境変数の設定に必要な製品

OTM V3

OTM V5

TPBrokerV3

TPBrokerV5

CTM

V3

○

×

○

×

○

V5

×

○

×

○

○

（凡例）

○：環境変数設定必要。

×：環境変数設定不要。

PATH環境変数にTPBrokerのosagent，idl2ir，irep，およびOTMのtscidl2cppが格納されているディレクトリを設定してください。

オプションとコマンドオプション引数との間に，必ず空白を入れてください。

CTMで使用できない定義が含まれている場合，不正な動作をしたり，または不正なファイルが出力されたりするおそれがあります。

ctmidl2jコマンドの実行中に，内部で使用しているTPBroker，およびOTMのメッセージが出力される場合があります。

ctmjava2idl（IDL生成コマンド）

形式

ctmjava2idl  [-h] | [-g]
             [-o <出力ファイル名>]
             [-c <クラスパス>] <EJBクラスファイル>

機能

EJBのクラスファイルからIDLを生成します。

引数

-h

コマンドの使用方法が表示されます。

-g

CTMの提供するIDL定義ファイルを生成します。

-o <出力ファイル名>

出力ファイルの名前を指定します。

-c <クラスパス>

クラスファイルが参照するクラスパスを指定します。

<EJBクラスファイル>

IDLを生成するEJBのクラスファイルを指定します。クラスファイルは必ずコマンドラインの最後に指定してください。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

注意事項

PATH環境変数にTPBrokerV5のjava2idlが格納されているディレクトリを設定してください。Unixの場合は共用ライブラリのパス環境変数にTPBrokerV5のパスを設定してください。

-gオプションで生成されるIDL定義ファイルは，Cosminexsusで提供されるJDK1.4.2における定義ファイルとなります。

ctmjava2idlコマンドの実行中に，内部で使用しているTPBrokerのメッセージが出力される場合があります。

ctmjava2idlコマンドは，-oオプションに指定された名称のファイルを上書きします。コマンドラインに誤りがあった場合でも，-oオプションの次に記述された名称のファイルを上書きする場合があります。

ctmjava2idlコマンドは，OTMで使用できるIDLを出力します。IDLについての詳細は，マニュアル「TPBroker Object Transaction Monitor プログラマーズガイド」を参照してください。

ctmlogcat（メッセージの編集と出力）

形式

ctmlogcat [-h] | [-d | -t <CTM識別子>]

機能

CTMで出力したメッセージを編集して標準出力に出力します。オプションによってCTMログを出力するか，CTMドメインログを出力するかを指定できます。

引数

-h

コマンドの使用方法が表示されます。

-d

CTMドメインログを出力します。

-t <CTM識別子>

指定したCTM識別子のCTMログを出力します。値は1〜31文字の英数字，またはアンダースコア（_）で指定します。省略した場合は，IPアドレスが設定されます。

すべてのオプションを省略した場合は，IPアドレスをCTM識別子とした-tオプションが設定されます。マルチホームホスト環境でCTMログを出力する場合は，-tオプションは省略できません。

例えば，ホストのIPアドレスが"192.17.113.19"の場合，"-t 192.17.113.19"が設定されます。

戻り値

0：

正常終了しました。出力するデータがない（KFCT73591-Iメッセージが出力された）場合，および-hオプションを指定した場合も0が返却されます。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

注意事項

ctmlogcatコマンド実行時には，CTMSPOOL環境変数が設定されている必要があります。

-tオプションを指定する場合，該当するCTM識別子の動作している実行環境に設定したCTMSPOOL環境変数が必要です。

-dオプションを指定する場合，CTMドメインマネジャ実行時に指定したCTMSPOOL環境変数が必要です。

CTMSPOOL下に格納されているログ情報ファイルの更新日時が変更された場合，ctmlogcatコマンドが正しい順序でメッセージを編集できないことがあります。

ctmlsque（スケジュールキュー情報の出力）

形式

ctmlsque  [-h] [-CTMDomain <CTMドメイン名称>] [-CTMID <CTM識別子>]
          [-CTMMyHost <ホスト名称またはIPアドレス>]
          [-CTMQueue <スケジュールキュー登録名称>]
          [-CTMInterface [<インタフェース名称>]] [-CSV]
          [-CTMAppInfo]

機能

スケジュールキューのスケジューリング情報を出力します。

引数

-h

コマンドの使用方法が表示されます。

-CTMDomain <CTMドメイン名称>

スケジュールキュー情報を出力するCTMデーモンのCTMドメイン名称を1〜31文字の英数字，またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まる文字列は指定しないでください。省略した場合は"CTMDOMAIN"が設定されます。

-CTMID <CTM識別子>

スケジュールキュー情報を出力するCTMデーモンの識別子を1〜31文字の英数字，ピリオド（.），またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まるCTM識別子は指定しないでください。ピリオド（.）は，IPアドレスを指定する場合だけ使用できます。省略した場合は，IPアドレスでCTM識別子が設定されます。

例えば，ホストのIPアドレスが"172.17.112.43"のとき，"172.17.112.43"という文字列がCTM識別子となります。

-CTMMyHost <ホスト名称またはIPアドレス>

マルチホームまたはIPアドレスを引き継ぐ系切り替え環境でCTMが使用するホスト名称またはIPアドレスを指定します。値は1〜64文字の文字列で指定します。省略した場合は，hostnameコマンドで取得されるホスト名称が設定されます。

-CTMQueue <スケジュールキュー登録名称>

出力するスケジュールキューの登録名称を1〜63文字の英数字，またはアンダースコア（_）で指定します。

バッチアプリケーションを実行するシステムでは，スケジュールキューの登録名称としてスケジュールグループ名を指定してください。

-CTMInterface <インタフェース名称>

出力するEJBのインタフェース名称を1文字以上の文字列で指定します。インタフェース名称を指定した場合，指定したインタフェース名称とEJBのINS登録名称が出力されます。

-CTMInterfaceオプションだけを指定した場合，すべてのインタフェース名称とINS登録名称が出力されます。

-CSV

標準出力情報をCSV形式で出力します。

-CTMAppInfo

スケジュールキューを共有しているアプリケーション情報を出力します。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

出力形式

標準出力形式

*** ctmd Information ***
CTMDomain               aa…aa
CTMID                   bb…bb
--------------------------------------------------------------------
*** CTMQueue Information ***
QueueName               cc…cc
Status                  d
ApplicationCount        ee…ee
RequestCount            ff…ff
RequestMax              gg…gg
QueueLength             hh…hh
ParallelCount           ii…ii
TotalThreadCount        jj…jj
*** Application Information ***
[1]J2EEServerName        kk…kk
[1]StartParallelCount    ll…ll
[1]ResidentThreadCount   mm…mm

[2]J2EEServerName        kk…kk
[2]StartParallelCount    ll…ll
[2]ResidentThreadCount   mm…mm
*** LookupName and Interface Information ***
[1]LookupName            nn…nn
[1]InterfaceName         oo…oo

[2]LookupName            nn…nn
[2]InterfaceName         oo…oo

[3]LookupName            nn…nn
[3]InterfaceName         oo…oo
--------------------------------------------------------------------
*** CTMQueue Information ***
QueueName               cc…cc
Status                  d
ApplicationCount        ee…ee
RequestCount            ff…ff
RequestMax              gg…gg
QueueLength             hh…hh
ParallelCount           ii…ii
TotalThreadCount        jj…jj
*** LookupName and Interface Information ***
                                :
                                :

CSV出力形式

CTMDomain,CTMID
aa…aa,bb…bb
QueueName,Status,ApplicationCount,RequestCount,RequestMax,QueueLength,ParallelCount,TotalThreadCount,J2EEServerName,StartParallelCount,ResidentThreadCount,LookupName,InterfaceName
cc…cc,dd…dd,ee…ee,ff…ff,gg…gg,hh…hh,ii…ii,jj…jj,kk…kk,ll…ll,mm…mm,nn…nn,oo…oo
,,,,,,,,kk…kk,ll…ll,mm…mm,nn…nn,oo…oo
,,,,,,,,,,,nn…nn,oo…oo
        :
        :
QueueName,Status,ApplicationCount,RequestCount,RequestMax,QueueLength,ParallelCount,TotalThreadCount,J2EEServerName,StartParallelCount,ResidentThreadCount,LookupName,InterfaceName
cc…cc,dd…dd,ee…ee,ff…ff,gg…gg,hh…hh,ii…ii,jj…jj,kk…kk,ll…ll,mm…mm,nn…nn,oo…oo
,,,,,,,,kk…kk,ll…ll,mm…mm,nn…nn,oo…oo
,,,,,,,,,,,nn…nn,oo…oo
        :
        :

（凡例）

記号

説明

種別

aa…aa

指定したCTMドメイン名称（1〜31文字の英数字）

CTMデーモン情報

bb…bb

指定したCTM識別子（1〜31文字の英数字）

cc…cc

指定した条件と一致するスケジュールキュー名称（1〜63文字の英数字）

スケジュールキュー情報（1）

d

指定した条件と一致するスケジュールキューの状態を次の値で示します。

S：スケジュールキュー準備中

A：スケジューリング可能状態

E：スケジュールキュー終了処理中

H：スケジュールキュー閉塞中

C：キューイング可能閉塞

ee…ee

スケジュールキューを共有しているJ2EEアプリケーション数（10進数5けた）

ff…ff

スケジュールキューに滞留しているリクエスト数（10進数10けた）

gg…gg

スケジュールキューに滞留したリクエスト最大数（10進数10けた）

hh…hh

同時に登録できるリクエスト数（10進数5けた）

ii…ii

スケジュールキューが管理している同時実行数（10進数3けた）

jj…jj

スケジュールキューが管理している現在の総常駐スレッド数（10進数3けた）

kk…kk

スケジュールキューが接続しているJ2EEサーバ名称（英数字）

スケジュールキュー情報（2）

ll…ll

kk…kkで表示されたJ2EEアプリケーションの開始時の同時実行数（10進数3けた）

mm…mm

kk…kkで表示されたJ2EEアプリケーションに対する現在の常駐スレッド数（10進数3けた）

nn…nn

キューが管理しているINS登録名称（英数字）

スケジュールキュー情報（3）

oo…oo

キューが管理しているインタフェース名称（英数字）

注

指定した条件と一致するスケジュールキューが複数ある場合，一致するスケジュールキューの数だけ，スケジュールキュー情報（1）〜（3）が繰り返し出力されます。

-CTMInterfaceオプションを指定した場合，スケジュールキュー情報（1）の情報出力後，スケジュールキューが管理しているINS登録名，インタフェース名情報をすべて出力するまで，スケジュールキュー情報（3）の情報が繰り返し出力されます。

-CTMAppInfoオプションを指定した場合，スケジュールキュー情報（1）の情報出力後，スケジュールキューが接続しているJ2EEサーバ名称，J2EEアプリケーション開始時のスレッド数，J2EEアプリケーションのスレッド数をすべて出力するまで，スケジュールキュー情報（2）の情報が繰り返し出力されます。

-CTMInterfaceオプションと-CTMAppInfoオプションの両方を指定した場合，スケジュールキュー情報（1）の情報出力後，スケジュールキュー情報（2）とスケジュールキュー情報（3）の情報が繰り返し出力されます。

バッチアプリケーションを実行するシステムでは，「出力形式」の（凡例）の記載は一部異なります。バッチアプリケーションを実行するシステムでは，J2EEアプリケーションはバッチアプリケーションとなり，J2EEサーバはバッチサーバとなります。また，スケジュールキュー名称およびINS登録名称には，スケジュールグループ名が出力されます。

ctmrasget（トラブルシュート情報の取得と出力）

形式

ctmrasget { [-h] | [-p] [-s] [-CTMSpool <CTMスプールディレクトリ> |
          -CTMDomain <CTMドメイン名称>]
          [-PRFSpool <PRFデーモン実行環境ディレクトリ>] <出力先ディレクトリ>}

機能

ctmrasgetコマンドを実行するホスト上でCTMが必要とするトラブルシュート情報をファイルに取得し，取得した情報の一覧を標準出力または標準エラー出力に出力します。

引数

-h

コマンドの使用方法が表示されます。

-p

TPBrokerについてのトラブルシュート情報を出力先ディレクトリに出力します。あらかじめ，TPBrokerのVBROKER_ADM環境変数を設定してください。

-s

共通メッセージ（eventlogまたはsyslog）の取得を抑止します。

-CTMSpool <CTMスプールディレクトリ>

トラブルシュート情報を取得するCTMスプールディレクトリを指定します。

-CTMDomain <CTMドメイン名称>

トラブルシュート情報を取得するCTMドメイン名称を1〜31文字の英数字，またはアンダースコア（_）で指定します。

省略した場合は，ホスト内のCTM環境に登録済みのすべてのCTMドメインからトラブルシュート情報を取得します。

-PRFSpool <PRFデーモン実行環境ディレクトリ>

トラブルシュート情報を取得するPRFデーモン実行環境ディレクトリを指定します。省略した場合はPRFSPOOL環境変数の値が設定されます。このオプションを省略し，かつPRFSPOOL環境変数が設定されていない場合は，PRFデーモンの情報は取得されません。

<出力先ディレクトリ>

トラブルシュート情報を出力するファイルのディレクトリ名（相対パスまたは絶対パス）を指定します。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

出力形式

Component Transaction Monitor: RAS completed collection of aa...aa

（凡例）

aa...aa：収集する情報，ファイル名称など

注意事項

出力先ディレクトリにすでに同名のファイルがある場合は上書きされます。そのため，トラブルシュート情報を残しておきたい場合は，ファイルをコピーしておくか，新しく作成したディレクトリを出力先ディレクトリに指定してください。

ctmrasgetコマンド実行中に，CTMを開始および終了しないでください。

ctmregltd（CTMレギュレータの開始）

形式

ctmregltd [-h] [-CTMDomain <CTMドメイン名称>] [-CTMID <CTM識別子>]
          [-PRFID <PRF識別子>] [-CTMMyHost <ホスト名称またはIPアドレス>]
          [-CTMClientConnectCount <コネクション数>]
          [-CTMEjbPort <EJBリクエスト受信ポート番号>]
          [-CTMAgent {1|0}]
          [-CTMIDLConnect [1|0]]
          [-CTMTimeOut <タイムアウト値>]

機能

EJBクライアントからの要求を分散集約するために，CTMレギュレータを開始します。CTMレギュレータはCTMデーモンが動作するホストと同じホストで開始してください。なお，CTMレギュレータを直接開始することはできません。

引数

-h

コマンドの使用方法が表示されます。

-CTMDomain <CTMドメイン名称>

CTMデーモンが属するCTMドメイン名称を1〜31文字の英数字，またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まる文字列は指定しないでください。省略した場合は"CTMDOMAIN"が設定されます。

-CTMID <CTM識別子>

CTMデーモンのCTM識別子を1〜31文字の英数字，ピリオド（.），またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まるCTM識別子は指定しないでください。ピリオド（.）は，IPアドレスを指定する場合だけ使用できます。

省略した場合は，IPアドレスがCTM識別子に設定されます。例えば，ホストのIPアドレスが"172.17.112.43"のとき，"172.17.112.43"という文字列がCTM識別子となります。

-PRFID <PRF識別子>

PRFトレースを出力するPRFデーモンの識別子を1〜31文字の英数字，またはアンダースコア（_）で指定します。"TSC"や"tsc"または"CTM"や"ctm"で始まる文字列は指定しないでください。省略した場合は，"PRF_ID"という文字列がPRF識別子となります。

-CTMMyHost <ホスト名称またはIPアドレス>

マルチホームホストまたはIPアドレスを引き継ぐ系切り替え環境でCTMが使用するホスト名称またはIPアドレスを1〜64文字の文字列で指定します。省略した場合は，hostnameコマンドで取得されるホスト名称が設定されます。

-CTMIDオプションを省略して-CTMMyHostオプションを指定した場合，デフォルトのCTM識別子は-CTMMyHostオプションで指定したIPアドレスになります。

-CTMClientConnectCount <コネクション数>

CTMレギュレータに接続できるコネクション数を1〜32767の整数で指定します。コネクション数は，EJBクライアントからの接続数です。EJBクライアントがcreate()，invoke()を繰り返す場合は，EJBクライアントのプロセス終了，通信障害，またはタイムアウトが発生するまでCTMレギュレータとのコネクションが確立されます。したがって，-CTMClientConnectCountには，EJBクライアントのプロセス数分の設定が必要になる場合があります。省略した場合は，ctmstartコマンドに設定した-CTMClientConnectCountが引き継がれます。ctmstartコマンドで-CTMClientConnectCountを省略した場合は"64"が設定されます。

-CTMEjbPort <EJBリクエスト受信ポート番号>

EJBクライアントがCTMレギュレータの新しいコネクションを探すときに使用するポート番号を5001〜65535の整数で指定します。省略した場合は，OSが自動的に割り当てたポート番号を使用します。

-CTMAgent {1|0}

EJBに対応するCORBAオブジェクトをTPBrokerのOSAgentに登録するかどうかを指定します。省略した場合，または"0"が指定された場合は，OSAgentに登録しません。

-CTMIDLConnect [1|0]

開始するORBゲートウェイに対応するCORBAオブジェクトのリポジトリIDをIDL形式IDL:<インタフェース名>:1.0にし，IOR接続するかどうかを指定します。クライアントのORB製品がIDL形式のリポジトリIDだけサポートする場合に指定します。

オプション引数を省略した場合は"1"が設定されます。

省略した場合，または"1"を指定した場合は，ORBゲートウェイを開始すると，J2EEサーバにアプリケーションを開始したあとに，ctmgetiorコマンドでORBゲートウェイのIOR文字列の取得ができます。"0"を指定した場合は，ORBゲートウェイを開始すると，新たにIOR文字列を取得できませんが，1を指定した場合に比べ，アプリケーションやORBゲートウェイの開始時間を短縮できます。

このオプションを指定した場合は，必ず-CTMEjbPortオプションを指定してください。

-CTMTimeOut <タイムアウト値>

クライアントからのサービス要求を受信してからサービスの応答が返るまでのデフォルト待ち時間（単位：秒）を0〜2147483647の整数で指定します。"0"を指定した場合，無限に待ち続けます。省略した場合は"180"（秒）が設定されます。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

注意事項

CTMレギュレータは開始後にカレントディレクトリを移動します。そのため，次に示す場合のコアファイルの出力先は，実行形式ファイルのディレクトリとは異なります。

"ctmstop -CTMForce -CTMDebugInfo"，killコマンドなどでCTMレギュレータを強制終了した場合

CTMレギュレータが異常終了した場合

移動後のカレントディレクトリを次に示します。

Windowsの場合

"%CTMSPOOL%¥adm¥CTM識別子¥reg¥カレントディレクトリID¥"

UNIXの場合

"$CTMSPOOL/adm/CTM識別子/reg/カレントディレクトリID/"

カレントディレクトリIDは，KFCT70606-Iメッセージを参照してください。

ctmridinfo（CTMドメイン情報の出力）

形式

ctmridinfo  [-h] | [-CTMDomain <CTMドメイン名称>]
            [-CTMHost <ホストの完全修飾名またはIPアドレス>]
            [-CTMMyHost <ホスト名称またはIPアドレス>]

機能

CTMドメイン情報を出力します。

引数

-h

コマンドの使用方法が表示されます。

-CTMDomain <CTMドメイン名称>

CTMドメイン情報を出力するCTMドメインマネジャのCTMドメイン名称を1〜31文字の英数字，またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まる文字列は指定しないでください。省略した場合は"CTMDOMAIN"が設定されます。

-CTMHost <ホストの完全修飾名またはIPアドレス>

-CTMDomainオプションで指定したCTMドメイン名称に対応するCTMドメインマネジャがあるホストの完全修飾名またはIPアドレスを指定します。値は1〜64文字の文字列で指定します。マルチホームホスト環境では，CTMの使用する-CTMMyHostオプションに指定するホスト名称またはIPアドレスを指定してください。

省略した場合は，自ホストのIPアドレスが設定されます。また，マルチホームホスト環境では，省略時に設定されるIPアドレスはOSの動作に依存します。

-CTMMyHost <ホスト名称またはIPアドレス>

マルチホームまたはIPアドレスを引き継ぐ系切り替え環境でCTMが使用するホスト名称またはIPアドレスを指定します。値は，1〜64文字の文字列で指定します。省略した場合は，hostnameコマンドで取得されるホスト名称が設定されます。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

ctmrlesque（スケジュールキューの閉塞解除）

形式

ctmrlesque [-h] [-CTMDomain <CTMドメイン名称>] [-CTMID <CTM識別子>]
           [-CTMMyHost <ホスト名称またはIPアドレス>]
           {-CTMQueue <スケジュールキュー登録名称> | -CTMQueueALL}

機能

スケジュールキューの閉塞状態を解除します。

引数

-h

コマンドの使用方法が表示されます。

-CTMDomain <CTMドメイン名称>

スケジュールキューを閉塞解除するCTMデーモンのCTMドメイン名称を1〜31文字の英数字，またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まる文字列は指定しないでください。省略した場合は"CTMDOMAIN"が設定されます。

-CTMID <CTM識別子>

スケジュールキューを閉塞解除するCTMデーモンの識別子を1〜31文字の英数字，ピリオド（.），またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まるCTM識別子は指定しないでください。ピリオド（.）は，IPアドレスを指定する場合だけ使用できます。省略した場合は，IPアドレスがCTM識別子に設定されます。例えば，ホストのIPアドレスが"172.17.112.43"のとき，"172.17.112.43"という文字列がCTM識別子となります。

-CTMMyHost <ホスト名称またはIPアドレス>

マルチホームまたはIPアドレスを引き継ぐ系切り替え環境でCTMが使用するホスト名称またはIPアドレスを指定します。値は1〜64文字の文字列で指定します。省略した場合は，hostnameコマンドで取得されるホスト名称が設定されます。

-CTMQueue <スケジュールキュー登録名称>

閉塞解除するスケジュールキューの登録名称を1〜63文字の英数字，またはアンダースコア（_）で指定します。

バッチアプリケーションを実行するシステムでは，スケジュールキューの登録名称としてスケジュールグループ名を指定してください。

-CTMQueueALL

すべてのスケジュールキューを一括して閉塞解除します。閉塞解除済みのスケジュールキューを含めることができます。

戻り値

0：

正常終了しました。

1：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

2：

指定されたスケジュールキューはすでに閉塞解除しています。なお，この戻り値は，-CTMQueueオプションを指定した場合だけ返却されます。

ctmstart（CTMデーモンの開始）

形式

ctmstart  [-h] [-CTMDomain <CTMドメイン名称>] [-CTMID <CTM識別子>]
          -CTMINSRef <CORBAネーミングサービスのURL>
          [-CTMDCSendTimeOut<CTMデーモン間リクエスト転送時のタイムアウト値>]
          [-PRFID <PRF識別子>]
          [-CTMPort <ポート番号>]
          [-CTMEjbPort <EJBリクエスト受信ポート番号>]
          [-CTMMyHost <ホスト名称またはIPアドレス>]
          [-CTMRegStart <プロセス数>]
          [-CTMRegOption <CTMコマンドオプションファイル名称>]
          [-CTMEnviron <CTMユーザ環境変数定義ファイル名称>]
          [-CTMStartTimeOut <タイムアウト値>]
          [-CTMEntryCount <登録プロセス数>] [-CTMNice <nice値>]
          [-CTMClientConnectCount <接続クライアントの最大数>]
          [-CTMServerConnectCount <接続J2EEサーバの最大数>]
          [-CTMLogFileSize <CTMログファイル最大サイズ>]
          [-CTMLogFileCount <CTMログファイル最大数>]
          [-CTMQueueCount <スケジュールキュー登録数>]
          [-CTMQueueRegistCount <スケジュールキュー共有数>]
          [-CTMServerCacheSize <サーバキャッシュサイズ>]
          [-CTMDispatchPolicy normalDispatch | priorDispatch]
          [-CTMDispatchParallelCount <スレッドの最大値>]
          [-CTMMaxRequestCount <最大リクエスト数>]
          [-CTMWatchRequest<タイムアウト発生回数,監視時間間隔>]
          [-CTMQueueDeleteWait <スケジュールキュー保留時間>]
          [-CTMCreatePolicy normalDispatch | priorDispatch]
          [-CTMLoadCheckInterval <負荷状況監視時間間隔>]
          [-CTMWatchQueue
           <監視開始滞留率,システム停止処理率,監視時間間隔,停止モード>]
          [-CTMTSCGwStart <プロセス数>]
          [-CTMTSCGwOption <CTMコマンドオプションファイル名称>]
          [-CTMStatsUse {Y|N}]
          [-CTMStatsFileCount ＜稼働統計情報ファイルの世代数＞]
          [-CTMStatsFileSize ＜稼働統計情報ファイルサイズ＞]

機能

リクエストをスケジューリングするためのCTMデーモンを開始します。

引数

-h

コマンドの使用方法が表示されます。

-CTMDomain <CTMドメイン名称>

CTMデーモンが属するCTMドメイン名称を1〜31文字の英数字，またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まるCTMドメイン名称は指定しないでください。また，CTM識別子とCTMドメイン名称には同じ値を指定しないでください。省略した場合は"CTMDOMAIN"が設定されます。

-CTMID <CTM識別子>

CTMデーモンの識別子を1〜31文字の英数字，ピリオド（.），またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まるCTM識別子は指定しないでください。また，同じCTMドメイン内で重複するCTM識別子は使用できません。ピリオド（.）は，IPアドレスを指定する場合だけ使用できます。省略した場合は，IPアドレスがCTM識別子に設定されます。

例えば，ホストのIPアドレスが"172.17.112.43"のときは，"172.17.112.43"という文字列がCTM識別子となります。

-CTMINSRef <CORBAネーミングサービスのURL>

CTMデーモンと対応付けるCORBAネーミングサービスのURLを指定します。値は次の形式で1〜65535文字で指定します。

<ホスト名称>:<ポート番号>

次に指定例を示します。

-CTMINSRef localhost:9001

このオプションは省略できません。

CORBAネーミングサービスは，CTMデーモンと同じホスト上に開始してください。また，J2EEサーバやそのほかのCTMデーモンが使用しているCORBAネーミングサービスを指定しないでください。それらのCORBAネーミングサービスを共用した場合の動作は保証しません。

-CTMDCSendTimeOut<CTMデーモン間リクエスト転送時のタイムアウト値>

ほかのCTMデーモンへのリクエスト転送処理の待ち時間を，0〜2147483647の整数（単位：秒）で指定します。"0"を指定した場合，無限に待ち続けます。省略した場合は"180"（秒）が設定されます。このオプションのタイムアウト値では，ほかのCTMデーモンからのリクエストの応答を監視しません。ホストやネットワークに障害が発生した場合，デーモン間転送処理が行なわれると，このオプションで指定したタイムアウト値が経過するまで，障害を検知できません。タイムアウト値を短くすると，長大電文のデーモン間転送に失敗することがあります。

-PRFID <PRF識別子>

PRFトレースを出力するPRFデーモンの識別子を1〜31文字の英数字，またはアンダースコア（_）で指定します。"TSC"や"tsc"または"CTM"や"ctm"で始まる文字列は指定しないでください。省略した場合は，"PRF_ID"という文字列がPRF識別子となります。

-CTMPort <ポート番号>

CTMデーモンの新しいコネクションを探すときに使用するポート番号を指定します。値は5001〜65535の整数で指定します。省略した場合はサービス名ファイルが参照されます。サービス名ファイルに指定がないときは"20138"が設定されます。

サービス名ファイルへの記述の形式を次に示します。

CTM_CTMドメイン名称CTM識別子       ポート番号/tcp

例えば，"ctmstart -CTMDomain JAPAN -CTMID XXX"と指定してCTMデーモンを開始する場合，サービス名ファイルの次のように指定したエントリが読み込まれます。

CTM_JAPANXXX                         10021/tcp

-CTMEjbPort <EJBリクエスト受信ポート番号>

EJBクライアントがCTMデーモンの新しいコネクションを探すときに使用するポート番号を指定します。値は5001〜65535の整数で指定します。省略した場合は，OSが自動的に割り当てたポート番号を使用します。

-CTMMyHost <ホスト名称またはIPアドレス>

マルチホームまたはIPアドレスを引き継ぐ系切り替え環境でCTMが使用するホスト名称またはIPアドレスを指定します。値は1〜64文字の文字列で指定します。省略した場合は，hostnameコマンドで取得されるホスト名称が設定されます。

-CTMIDオプションを省略して-CTMMyHostオプションを指定した場合，デフォルトのCTM識別子は-CTMMyHostオプションで指定したIPアドレスになります。

-CTMRegStart <プロセス数>

CTMデーモン開始時に自動開始するCTMレギュレータのプロセス数を0〜32767の整数で指定します。CTMデーモンはCTMレギュレータの動作を監視し，異常終了を検出すると再開始します。省略した場合は，"1"が設定されます。

J2EEサーバを開始する場合は，CTMレギュレータを必ず開始してください。自動開始のCTMレギュレータの数が多くなると，CTMデーモンの開始処理に時間が掛かる場合があります。その場合は，-CTMStartTimeOutオプションで開始処理の待ち時間を調整してください。

-CTMRegOption <CTMコマンドオプションファイル名称>

CTMレギュレータを自動開始するときに指定するコマンドオプションを記述したファイル名称を指定します。

Windowsの場合

英数字，ピリオド（.），円符号（¥），コロン（:），プラス（+），ハイフン（-），またはアンダースコア（_）で指定します。

UNIXの場合

英数字，ピリオド（.），スラッシュ（/），プラス（+），ハイフン（-），またはアンダースコア（_）で指定します。

CTMコマンドオプションファイル名称はユーザ任意の名称です。コマンドオプションファイルには英数字，空白，ハイフン（-），ピリオド（.），スラッシュ（/），またはアンダースコア（_）を記述できます。コマンドオプション以外は記述しないでください。例えば，次のように指定します。

-CTMClientConnectCount 64

CTMコマンドオプションファイル名称を"regoption"とする場合は，CTMデーモン開始時に次のように指定します。

ctmstart -CTMRegOption regoption -CTMRegStart 10

自動開始する複数のCTMレギュレータのポート番号を固定したい場合は，コマンドオプションファイル内で-CTMEjbPortオプションを指定します。指定された-CTMEjbPortオプションの値を基底値とし，1ずつ加算した値が各CTMレギュレータの-CTMEjbPortオプションに指定されます。

コマンドオプションファイルに指定しなかった-CTMEjbPort，および-CTMPort以外のオプションは，ctmstartコマンドに指定された値を引き継いで設定します。

-CTMEnviron <CTMユーザ環境変数定義ファイル名称>

開始するプロセスが使用する環境変数を記述したCTMユーザ環境変数定義ファイル名称を絶対パスで指定します。

Windowsの場合

英数字，ピリオド（.），円符号（¥），コロン（:），プラス（+），ハイフン（-），またはアンダースコア（_）で指定します。

UNIXの場合

英数字，ピリオド（.），スラッシュ（/），プラス（+），ハイフン（-），またはアンダースコア（_）で指定します。

CTMユーザ環境変数定義ファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「7.2.1　CTMユーザ環境変数定義ファイル」を参照してください。

-CTMStartTimeOut <タイムアウト値>

CTMデーモンの開始処理の待ち時間（単位：秒）を0〜2147483647の整数で指定します。"0"を指定した場合，無限に待ち続けます。省略した場合は"180"（秒）が設定されます。

-CTMEntryCount <登録プロセス数>

CTMデーモンで管理するプロセスの数を32〜32767の整数で指定します。

省略した場合，-CTMServerConnectCountオプションと-CTMClientConnectCountオプションの指定値の合計が設定されます。

-CTMNice <nice値>

CTMデーモンが管理するサーバで使用する-CTMNiceオプションの指定値のデフォルトを整数で指定します。省略した場合は"0"が設定されます。指定値の範囲はOSが提供するniceの指定範囲に従います。

なお，-CTMNiceオプションはUNIXにしかありません。

-CTMClientConnectCount <CTMレギュレータとOTMゲートウェイの最大プロセス数>

CTMデーモンに接続するCTMレギュレータとOTMゲートウェイの最大プロセス数を0〜32767の整数で指定します。省略した場合は"64"が設定されます。

-CTMServerConnectCount <接続J2EEサーバの最大数>

CTMデーモンに接続するJ2EEサーバの最大数を0〜32767の整数で指定します。省略した場合は"64"が設定されます。

-CTMLogFileSize <CTMログファイル最大サイズ>

CTMログファイルの1ファイルの最大サイズをメガバイト単位で指定します。値は1〜3までの整数で指定します。省略した場合は"1"（メガバイト）が設定されます。

（-CTMLogFileSizeオプションの指定値）×（-CTMLogFileCountオプションの指定値）メガバイト分のメッセージをCTMログファイルに保存できます。CTMログファイルに保存するメッセージの容量を変更するには，まず-CTMLogFileCountオプションの指定値を変更してください。-CTMLogFileCountオプションの指定値の変更だけでは不十分な場合に，-CTMLogFileSizeオプションを指定してください。

-CTMLogFileCount <CTMログファイル最大数>

CTMログファイルの最大ファイル数を2〜32の整数で指定します。省略した場合は"2"が設定されます。

CTMログファイルのサイズが-CTMLogFileSizeオプションの指定値を超えると，CTMログファイルは次のファイルに切り替えられます。また，CTMログファイルの切り替え時にCTMログファイルの総数が-CTMLogFileCountオプションの指定値を超えていると，最も古いCTMログファイルの内容が削除されます。これらの内容に留意してCTMログファイルの容量を見積もってください。

-CTMQueueCount <スケジュールキュー登録数>

CTMデーモンに登録できるスケジュールキュー数を1〜32767の整数で指定します。省略した場合は"128"が設定されます。

-CTMQueueRegistCount <スケジュールキュー共有数>

同じスケジュールキューを共有できるJ2EEアプリケーション数を1〜32767の整数で指定します。省略した場合は"64"が設定されます。

-CTMServerCacheSize <サーバキャッシュサイズ>

CTMドメイン内のサーバ情報を格納するキャッシュテーブルのサイズ（単位：キロバイト）を1〜32767の整数で指定します。省略した場合は"1024"（キロバイト）が設定されます。

サーバキャッシュテーブルのサイズは次に示す計算式で求めてください。

｛256 × 同じCTMドメイン内のCTMデーモン数
＋ 256 × 同じCTMドメイン内の全スケジュールキュー数
＋（256 ＋ INS登録名の最大長）× 同じCTMドメイン内のスケジュールキューに登録するEnterprise Bean数
＋（256 ＋インタフェース名の最大長）× 同じCTMドメイン内のインタフェース数
 ｝× 1.5　（バイト）

-CTMDispatchPolicy normalDispatch | priorDispatch

スケジュールポリシーを次の値で指定します。

"normalDispatch"

スケジュールキューの負荷状況に応じてリクエストをスケジュールします。

"priorDispatch"

リクエストを受け付けたCTMデーモンに登録されているスケジュールキューに，優先的にリクエストをスケジュールします。ただし，そのCTMデーモンに登録されているスケジュールキューが高負荷状態，および閉塞状態の場合は，ほかのCTMデーモンに登録しているスケジュールキューにリクエストをスケジュールします。省略した場合は"priorDispatch"が設定されます。

-CTMDispatchParallelCount <スレッドの最大値>

CTMデーモン内でクライアントからの要求メッセージをJ2EEサーバに振り分けるスレッドの最大値，つまり，CTMデーモンに登録されるJ2EEアプリケーションのパラレルカウント（常駐するスレッド数）の和を指定します。値は0〜32767の整数で指定します。省略した場合は"255"が設定されます。

-CTMMaxRequestCount <最大リクエスト数>

CTMデーモンに登録するスケジュールキューが，同時に登録できるリクエスト数（キューの長さ）を1〜32767の整数で指定します。省略した場合は"50"が設定されます。

-CTMWatchRequest <タイムアウト発生回数,監視時間間隔>

CTMデーモンがタイムアウト時間監視を実施します。指定された閉塞時間間隔内で，指定されたタイムアウト発生回数以上のタイムアウトが発生した場合に，スケジュールキューを閉塞します。閉塞処理は時間監視のタイミングで実施されるため，指定されたタイムアウトが発生後，次の監視時に閉塞します。この機能によってリクエストキューが閉塞された場合，キューに滞留しているリクエストを破棄し，負荷情報の更新を行います。

タイムアウト発生回数

自動閉塞するためのタイムアウト発生回数を，1〜32767の整数（単位：回）で指定します。

監視時間間隔

タイムアウト発生回数を求める時間間隔を，0〜32767の整数（単位：秒）で指定します。0を指定した場合は，タイムアウト閉塞機能は動作しません。

-CTMQueueDeleteWait <スケジュールキュー保留時間>

異常終了したJ2EEサーバが登録していたスケジュールキューを削除しないで保留し，J2EEアプリケーションの再開始を待つ場合の待ち時間（単位：秒）を指定します。値は0〜2147483647の整数で指定します。

指定した時間内にJ2EEアプリケーションが再開始された場合は，保留中のスケジュールキューを再利用し，キューイングされていたリクエストがスケジュールされます。

指定時間を経過してもJ2EEアプリケーションが再開始されない場合は，スケジュールキューを閉塞したあと，スケジュールキューに登録されたリクエストを削除します。なお，スケジュールキューの閉塞，およびスケジュールキューに登録されたリクエストの削除は，インターバル処理で実行されるため，指定時間よりも遅れることがあります。

省略した場合，または"0"が指定された場合は，スケジュールキューを保留しないでスケジュールキューに登録されたリクエストを削除します。

オンライン状態でのJ2EEアプリケーションの入れ替え機能（ctmholdque -CTMChangeServer）と併用した場合，ctmholdque -CTMChangeServerが実行されたあとにJ2EEサーバが異常終了すると，この機能は無効となります。

-CTMCreatePolicy normalDispatch | priorDispatch

create要求のCTMデーモン選択ポリシーを次の値で指定します。

省略した場合は"normalDispatch"が設定されます。

"normalDispatch"

スケジュールキューの負荷状況に応じてCTMデーモンを選択します。

"priorDispatch"

create要求を受け付けたCTMデーモンを，優先的に選択します。ただし，そのCTMデーモンに登録されているスケジュールキューが高負荷状態，および閉塞状態の場合は，ほかのCTMデーモンを選択します。

-CTMLoadCheckInterval <負荷状況監視時間間隔>

スケジュールキューの負荷状況を監視する時間間隔を，0〜32767の整数（単位：秒）で指定します。

指定した時間間隔ですべてのスケジュールキューの負荷状況を確認します。負荷状況に変化がある場合は，変化のあるスケジュールキュー単位に最新の負荷状況を同一ドメイン内のすべてのCTMデーモンに通知します。

省略した場合，10が設定されます。0が指定された場合，一定時間間隔での負荷状況監視を行いません。

-CTMWatchQueue <監視開始滞留率,システム停止処理率,監視時間間隔,停止モード>

スケジュールキューの滞留監視の条件を設定します。

-CTMWatchQueueオプションを省略した場合，スケジュールキューの滞留監視は行いません。

-CTMWatchQueueオプションで指定する引数は，必ず次の順番でコンマ（,）で区切って指定します。引数を省略することはできません。

監視開始滞留率

キュー滞留監視状態へ移行する滞留率のしきい値を，0〜99の整数（単位：%）で指定します。0を指定した場合は，常に監視します。

システム停止処理率

CTMデーモンの停止へ移行する処理率のしきい値を，1〜100の整数（単位：%）で指定します。

監視時間間隔

CTMデーモン停止しきい値の処理率を求める時間間隔を，0〜32767の整数（単位：秒）で指定します。0を指定した場合は，スケジュールキューの滞留監視は行いません。

停止モード

スケジュールキューの滞留を検知した場合に，CTMデーモンを停止するかどうかを指定します。

1：

CTMデーモンを停止します。

0：

CTMデーモンを停止しません。

-CTMTSCGwStart ＜プロセス数＞

CTMデーモン開始時に自動開始するOTMゲートウェイのプロセス数を0〜32767の整数で指定します。省略した場合は，"0"が設定されます。

CTMデーモンはOTMゲートウェイの動作を監視し，異常終了を検出すると再開始します。

自動開始のOTMゲートウェイの数が多くなると，CTMデーモンの開始処理に時間が掛かる場合があります。その場合は，-CTMStartTimeOutオプションで開始処理の待ち時間を調整してください。

-CTMTSCGwOption ＜CTMコマンドオプションファイル名称＞

OTMゲートウェイを自動開始するときに指定するコマンドオプションを記述したファイル名称を絶対パスで指定します。

Windowsの場合

英数字，ピリオド（.），円符号（¥），コロン（:），プラス（+），ハイフン（-），またはアンダースコア（_）で指定します。

UNIXの場合

英数字，ピリオド（.），スラッシュ（/），プラス（+），ハイフン（-），またはアンダースコア（_）で指定します。

CTMコマンドオプションファイル名称はユーザ任意の名称です。コマンドオプションファイルには，英数字，空白，ハイフン（-），ピリオド（.），スラッシュ（/），またはアンダースコア（_）を記述できます。コマンドオプション以外は記述しないでください。例えば，次のように指定します。

-CTMClientConnectCount 64

CTMコマンドオプションファイル名称を"tscoption"とする場合は，CTMデーモン開始時に次のように指定します。

ctmstart -CTMTSCGwOption tscoption -CTMTSCGwStart 1

自動開始する複数のOTMゲートウェイのポート番号を固定したい場合は，コマンドオプションファイル内で-CTMPortオプションを指定します。指定された-CTMPortオプションの値を基底値とし，1ずつ加算した値が各OTMゲートウェイの-CTMPortオプションに指定されます。

コマンドオプションファイルに指定しなかった-CTMPort以外のオプションは，ctmstartコマンドに指定された値を引き継いで設定します。

-CTMStatsUse {Y|N}

該当するCTMノードで稼働統計情報をバッファに取得するかどうかを指定します。

小文字での指定もできます。省略した場合は"Y"が設定され，該当するCTMノードで稼働統計情報をバッファに取得します。

なお，稼働統計情報ファイルへのバッファの情報の出力を開始するには，ctmstsstartコマンドを実行してください。

-CTMStatsFileCount ＜稼働統計情報ファイル世代数＞

稼働統計情報ファイルの世代数を3〜256の整数で指定します。省略した場合は"3"が設定されます。

-CTMStatsFileSize ＜稼働統計情報ファイルサイズ＞

稼働統計情報ファイルのサイズ（単位：メガバイト）を1〜1024の整数で指定します。省略した場合は"3（メガバイト）"が設定されます。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

注意事項

CTMデーモンは，開始後にカレントディレクトリを移動します。そのため，次に示す場合のコアファイルの出力先は，実行形式ファイルのディレクトリとは異なります。

"ctmstop -CTMForce -CTMDebugInfo"，killコマンドなどでCTMデーモンを強制終了した場合

CTMデーモンが異常終了した場合

移動後のカレントディレクトリを次に示します。

Windowsの場合

"%CTMSPOOL%¥adm¥CTM識別子¥"

UNIXの場合

"$CTMSPOOL/adm/CTM識別子/"

-CTMRegStartオプションを指定した場合，CTMレギュレータの自動開始が一つでも異常終了すると，CTMデーモンは開始処理失敗と判断してエラーメッセージを出力し，開始処理を中止します。

-CTMRegOptionオプションで指定したコマンドオプションファイル内に記述したコマンドオプションの正当性を，自動開始したCTMレギュレータがチェックします。そのため，コマンドオプション不正，および-CTMEjbPortオプション指定によるポート番号の重複は，自動開始したCTMレギュレータで出力したエラーメッセージを参照して対策してください。

CTMデーモンの開始完了前のメッセージには，-CTMLogFileSizeオプションおよび-CTMLogFileCountオプションが有効にならない場合があります。

CTMを開始する際，-CTMPortオプション，および-CTMEjbPortオプションで指定されたポート番号は，マシン内で一意になるよう設定してください。

ctmstartgw（ORBゲートウェイの開始）

形式

ctmstartgw [-h] |
           -CTMGWID <ゲートウェイ識別子>
           [-CTMDomain <CTMドメイン名称>]
           [-CTMID <CTM識別子>]
           [-CTMMyHost <ホスト名称またはIPアドレス>]
           [-CTMEnviron <ユーザ環境変数定義ファイル名称>]
           [-CTMEjbPort <ポート番号>]
           [-CTMAgent {1|0}]
           [-CTMIDLConnect [1|0]]
           [-CTMTimeOut <タイムアウト値>]
           [-CTMClientConnectCount <接続クライアントの最大数>]

機能

ORBクライアントのリクエストをCTMで処理するためのゲートウェイプロセスを開始します。ORBゲートウェイは，CTMレギュレータを開始しているCTMデーモンが動作するホストと同じホストで開始してください。

引数

-h

コマンドの使用方法が表示されます。

-CTMGWID <ゲートウェイ識別子>

開始するORBゲートウェイのゲートウェイ識別子を1〜32文字の英数字で指定します。-CTMDomainオプションおよび-CTMIDオプションで指定したCTMノード内で，ゲートウェイ識別子が一意となるように指定してください。

-CTMDomain <CTMドメイン名称>

CTMデーモンが属するCTMドメイン名称を1〜31文字の英数字で指定します。"CTM"または"ctm"で始まるCTMドメイン名称は指定しないでください。省略した場合は"CTMDOMAIN"が設定されます。

-CTMID <CTM識別子>

CTMデーモンのCTM識別子を1〜31文字の英数字，またはピリオド（.）で指定します。"CTM"または"ctm"で始まるCTM識別子は指定しないでください。ピリオド（.）は，IPアドレスを指定する場合だけ使用できます。

省略した場合は，IPアドレスがCTM識別子に設定されます。例えば，ホストのIPアドレスが"172.17.112.43"のとき，"172.17.112.43"という文字列がCTM識別子となります。

-CTMMyHost <ホスト名称またはIPアドレス>

マルチホームホストまたはIPアドレスを引き継ぐ系切り替え環境でCTMが使用するホスト名称またはIPアドレスを1〜64文字の文字列で指定します。省略した場合は，hostnameコマンドで取得されるホスト名称が設定されます。

-CTMIDオプションを省略して-CTMMyHostオプションを指定した場合，デフォルトのCTM識別子は-CTMMyHostオプションで指定したIPアドレスになります。

-CTMEnviron <ユーザ環境変数定義ファイル名称>

開始するプロセスが使用する環境変数を記述したCTMユーザ環境変数定義ファイル名称を絶対パスで指定します。

Windowsの場合

英数字，ピリオド（.），円符号（¥），コロン（:），プラス（+），ハイフン（-），またはアンダースコア（_）で指定します。

UNIXの場合

英数字，ピリオド（.），スラッシュ（/），プラス（+），ハイフン（-），またはアンダースコア（_）で指定します。

CTMユーザ環境変数定義ファイルの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「7.2.1　CTMユーザ環境変数定義ファイル」を参照してください。

-CTMEjbPort <ポート番号>

ORBクライアントがORBゲートウェイの新しいコネクションを探すときに使用するポート番号を5001〜65535の整数で指定します。省略した場合は，OSが自動的に割り当てたポート番号を使用します。

-CTMAgent {1|0}

EJBに対応するCORBAオブジェクトをTPBrokerのOSAgentに登録するかどうかを指定します。省略した場合，または"1"を指定した場合は，CORBAオブジェクトをOSAgentに登録します。"0"を指定した場合は，OSAgentに登録しません。

また，"0"を指定した場合は，必ず-CTMIDLConnectオプションを指定してください。

-CTMIDLConnect [1|0]

開始するORBゲートウェイに対応するCORBAオブジェクトのリポジトリIDをIDL形式IDL:<インタフェース名>:1.0にし，IOR文字列による接続を可能にします。

クライアントのORB製品がIDL形式のリポジトリIDだけサポートする場合に指定します。

オプション引数を省略した場合は"1"が設定されます。

省略した場合，または"1"を指定した場合は，ORBゲートウェイを開始すると，J2EEサーバにアプリケーションを開始したあとに，ctmgetiorコマンドでORBゲートウェイのIOR文字列の取得ができます。"0"を指定した場合は，ORBゲートウェイを開始すると，新たにIOR文字列を取得できませんが，1を指定した場合に比べ，アプリケーションやORBゲートウェイの開始時間を短縮できます。

このオプションを指定した場合は，必ず-CTMEjbPortオプションを指定してください。また，このオプションを省略した場合は，-CTMAgentオプションに1を指定してください。

-CTMTimeOut <タイムアウト値>

クライアントからのサービス要求を受信してからサービスの応答が返るまでのデフォルト待ち時間（単位：秒）を0〜2147483647の整数で指定します。"0"を指定した場合，無限に待ち続けます。省略した場合は"180"（秒）が設定されます。

-CTMClientConnectCount <接続クライアントの最大数>

ORBゲートウェイに接続できるORBクライアントからのコネクション数を1〜32767の整数で指定します。

省略した場合はCTMデーモンに設定した-CTMClientConnectCountの値が引き継がれます。CTMデーモンの-CTMClientConnectCountも省略した場合は"64"が設定されます。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

注意事項

このコマンドを実行する場合，ctmstartコマンドに指定する-CTMRegStartに1以上を指定して，CTMレギュレータを開始してください。CTMレギュレータが存在しない場合，EJBクライアントからの呼び出しがエラーになるおそれがあります。

OTMゲートウェイ(ctmtscgwd)と「-CTMAgent 1」を指定してCTMデーモンから開始したCTMレギュレータは，CTMデーモンによりプロセス管理されているため，異常終了しても自動再開始されますが，ctmstartgwコマンドで開始したORBゲートウェイ(ctmregltd)は，異常終了した場合自動再開始されません。

そのため，Cosminexus Managerの運用機能を使用してプロセス監視してください。

ctmstop（CTMデーモンの終了）

形式

ctmstop  [-h] [-CTMDomain <CTMドメイン名称>] [-CTMID <CTM識別子>]
         [-CTMMyHost <ホスト名称またはIPアドレス>]
         [-CTMForce [-CTMDebugInfo]]

機能

リクエストをスケジューリングするためのCTMデーモンを終了します。

引数

-h

コマンドの使用方法が表示されます。

-CTMDomain <CTMドメイン名称>

CTMデーモンが属するCTMドメイン名称を1〜31文字の英数字，またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まる文字列は指定しないでください。省略した場合は"CTMDOMAIN"が設定されます。

-CTMID <CTM識別子>

CTMデーモンのCTM識別子を1〜31文字の英数字，ピリオド（.），またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まるCTM識別子は指定しないでください。ピリオド（.）は，IPアドレスを指定する場合だけ使用できます。

省略した場合は，IPアドレスがCTM識別子に設定されます。例えば，ホストのIPアドレスが"172.17.112.43"のとき，"172.17.112.43"という文字列がCTM識別子となります。

-CTMMyHost <ホスト名称またはIPアドレス>

マルチホームまたはIPアドレスを引き継ぐ系切り替え環境でCTMが使用するホスト名称またはIPアドレスを1〜64文字の文字列で指定します。省略した場合は，hostnameコマンドで取得されるホスト名称が設定されます。

-CTMIDオプションを省略して-CTMMyHostオプションを指定した場合，デフォルトのCTM識別子は-CTMMyHostオプションで指定したIPアドレスになります。

-CTMForce

CTMデーモンを強制終了します。

-CTMDebugInfo

CTMデーモンの強制終了時にデバッグ情報として，共用メモリダンプおよびコアを取得します。

-CTMDebugInfoオプションは，-CTMForceオプションを指定したときだけ有効です。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

注意事項

CTMデーモンの正常終了では，実行中リクエストがなくなるまで待ち合わせます。そのため，タイムアウトが無限待ち（デフォルト）のEJBの業務リクエストに対して通信障害などが発生すると，正常に終了できなくなるため注意してください。

ctmstopgw（ORBゲートウェイの終了）

形式

ctmstopgw [-h] |
          -CTMGWID <ゲートウェイ識別子>
          [-CTMDomain <CTMドメイン名称>]
          [-CTMID <CTM識別子>]
          [-CTMMyHost <ホスト名称またはIPアドレス>]
          [-CTMForce [-CTMDebugInfo]]

機能

ORBクライアントのリクエストをCTMで処理するためのゲートウェイプロセスを終了します。

引数

-h

コマンドの使用方法が表示されます。

-CTMGWID <ゲートウェイ識別子>

終了するORBゲートウェイのゲートウェイ識別子を1〜32文字の英数字で指定します。-CTMDomainオプションおよび-CTMIDオプションで指定したCTMノード内で，ゲートウェイ識別子が一意となるように指定してください。

-CTMDomain <CTMドメイン名称>

CTMデーモンが属するCTMドメイン名称を1〜31文字の英数字で指定します。"CTM"または"ctm"で始まるCTMドメイン名称は指定しないでください。省略した場合は"CTMDOMAIN"が設定されます。

-CTMID <CTM識別子>

CTMデーモンのCTM識別子を1〜31文字の英数字，またはピリオド（.）で指定します。"CTM"または"ctm"で始まるCTM識別子は指定しないでください。ピリオド（.）は，IPアドレスを指定する場合だけ使用できます。

省略した場合は，IPアドレスがCTM識別子に設定されます。例えば，ホストのIPアドレスが"172.17.112.43"のとき，"172.17.112.43"という文字列がCTM識別子となります。

-CTMMyHost <ホスト名称またはIPアドレス>

マルチホームホストまたはIPアドレスを引き継ぐ系切り替え環境でCTMが使用するホスト名称またはIPアドレスを1〜64文字の文字列で指定します。省略した場合は，hostnameコマンドで取得されるホスト名称が設定されます。

-CTMIDオプションを省略して-CTMMyHostオプションを指定した場合，デフォルトのCTM識別子は-CTMMyHostオプションで指定したIPアドレスになります。

-CTMForce

ORBゲートウェイを強制終了させます。

-CTMDebugInfo

ORBゲートウェイの強制終了時に，デバッグ情報として共用メモリダンプおよびコアファイルを取得します。このオプションは-CTMForceオプションを指定した時だけ有効です。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

ctmstsed（稼働統計情報の編集と出力）

形式

ctmstsed  [-h] [-CTMEdit <編集出力形式>[,<編集出力形式>...]]
          [-CTMInterval <時間間隔>] [-CTMTime [<開始時刻>][,<終了時刻>]]
          [-CTMQueueName <キュー名>[,<キュー名>...]]
          [-CTMMethod <メソッド名>[,<メソッド名>...]]
          [-CTMCsv] [-CTMStdout]
          [<稼働統計情報ファイル名>[ <稼働統計情報ファイル名>...]]

機能

稼働統計情報ファイルに，取得した稼働統計情報を編集して出力します。デフォルトはテキスト形式です。

出力できる情報は次の3種類です。

CTMノード全体でまとめた情報

キュー単位のスケジュールキュー情報

メソッド単位のリクエスト情報

引数

-h

コマンドの使用方法が表示されます。

-CTMEdit <編集出力形式>[,<編集出力形式>...]

編集および出力する稼働統計情報の種類を指定します。

nod：CTMノード全体でまとめた情報を編集および出力します。

que：キュー単位のスケジュールキュー情報を編集および出力します。

mtd：メソッド単位のリクエスト情報を編集および出力します。

省略した場合は，nod，que，mtdのすべてが設定されます。

-CTMInterval <時間間隔>

稼働統計情報を編集および出力する時間の間隔（単位：分）を1〜1440の整数で指定します。ctmstsstartコマンドの-CTMIntervalオプションに指定した時間間隔の整数倍を指定してください。整数倍を指定しない場合は，編集結果が正しく出力されません。

省略した場合は，"10"が設定されます。

-CTMTime [<開始時刻>][,<終了時刻>]

稼働統計情報を編集および出力する範囲を，データの取得時刻で指定します。

時分月日年をhhmm[MMDD[YYYY]]の形式で指定します。月（MM），日（DD），および年（YYYY）を省略すると，現在の年月日が設定されます。

指定できる値の範囲を次の表に示します。

記号

意味

値の範囲

省略の可否

hh

時

00≦hh≦23

省略できません。

mm

分

00≦mm≦59

省略できません。

MM

月

01≦MM≦12

省略できます。

DD

日

01≦DD≦31

省略できます。

YYYY

年

1970≦YYYY≦2099

省略できます。

開始時刻を省略した場合は，ファイルの先頭から終了時刻までが出力範囲になります。終了時刻を省略した場合は，開始時刻からファイルの最後までが出力範囲になります。また，開始時刻と終了時刻の両方を省略した場合は，稼働統計情報ファイルのすべての情報が編集，出力されます。

-CTMQueueName <キュー名>[,<キュー名>...]

稼働統計情報を編集および出力するキュー名を1〜63文字の英数字，またはアンダースコア（_）で指定します。

このオプションは，-CTMEditオプションに"que"を指定する場合，または-CTMEditオプションを省略する場合に指定できます。

バッチアプリケーションを実行するシステムでは，キュー名としてスケジュールグループ名を指定してください。

-CTMMethod <メソッド名>[,<メソッド名>...]

稼働統計情報を編集および出力するメソッド名を指定します。

このオプションは，-CTMEditオプションに"mtd"を指定する場合，または-CTMEditオプションを省略する場合に指定できます。

-CTMCsv

編集および出力の結果をCSV形式（コンマで区切ったテキスト形式）で出力します。

-CTMStdout

編集および出力の結果を標準出力に出力します。

表6‒4　引数（コマンドオプション）の組み合わせ一覧（ctmstsedコマンド）

コマンドオプション

-h

-CTMEdit

-CTMInterval

-CTMTime

-CTMQueueName

-CTMMethod

-CTMCsv

-CTMStdout

nod

que

mtd

-h

−

△-h

△-h

△-h

△-h

△-h

△-h

△-h

△-h

△-h

-CTMEdit

nod

△-h

−

○

○

○

○

×

×

○

○

que

△-h

○

−

○

○

○

○

×

○

○

mtd

△-h

○

○

−

○

○

×

○

○

○

-CTMInterval

△-h

○

○

○

−

○

○

○

○

○

-CTMTime

△-h

○

○

○

○

−

○

○

○

○

-CTMQueueName

△-h

×

○

×

○

○

−

○

○

○

-CTMMethod

△-h

×

×

○

○

○

○

−

○

○

-CTMCsv

△-h

○

○

○

○

○

○

○

−

○

-CTMStdout

△-h

○

○

○

○

○

○

○

○

−

（凡例）

○：同時に指定できます。

△：△のあとに続くオプションが有効になります。

×：同時に指定できません。

−：該当しません。

注

-hオプションとほかのオプションを指定する場合，-hが優先されます。

<稼働統計情報ファイル名>[ <稼働統計情報ファイル名>...]

編集および出力する対象となる稼働統計情報ファイル名を指定します。半角スペースで区切って，最大256個のファイル名を指定できます。省略した場合は，標準入力から入力します。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

出力形式

CTMノード全体でまとめた情報を出力する形式（-CTMEditオプションに"nod"を指定）

*** Statistics Information by CTMNode ***
CTMDomain :aa..aa
CTMID     :bb..bb
--------------------------------------------------------------------------------
** Edit time cc..cc − dd..dd **
statistical data : ee..ee − ee..ee
no data       : ff..ff − ff..ff
--------------------------------------------------------------------------------
Event                        Count    Maximum      Minimum     Average (unit)
Request Response Time(Reg)  gg..gg      gg..gg      gg..gg      gg..gg (usec)
Request Time Out(Reg)       hh..hh           -           -           - (count)
Request Error(Reg)          ii..ii           -           -           - (count)
Request Response Time(OTM)  jj..jj      jj..jj      jj..jj      jj..jj (usec)
Request Time Out(OTM)       kk..kk           -           -           - (count)
Request Error(OTM)          ll..ll           -           -           - (count)
Schedule Wait Count         mm..mm      mm..mm      mm..mm      mm..mm (count)
Schedule Wait Time          nn..nn      nn..nn      nn..nn      nn..nn (usec)
Request Overflow            oo..oo           -           -           - (count)
Regulator down              pp..pp           -           -           - (count)
OTMGateway down             qq..qq           -           -           - (count)
Regulator-Client                 -      rr..rr      rr..rr      rr..rr (count)
OTMGateway-Client                -      ss..ss      ss..ss      ss..ss (count)
CTMDaemon-J2EEServer(Ctr)        -      tt..tt      tt..tt      tt..tt (count)
CTMDaemon-J2EEServer(Req)        -      uu..uu      uu..uu      uu..uu (count)
CTMDaemon-Regulator              -      vv..vv      vv..vv      vv..vv (count)
CTMDaemon-OTMGateway             -      ww..ww      ww..ww      ww..ww (count)

(凡例)

記号

説明

aa..aa

CTMドメイン名称（1〜31文字の英数字）です。

bb..bb

CTM識別子（1〜31文字の英数字）です。

cc..cc

編集開始時間です。

dd..dd

編集終了時間です。

ee..ee

編集時間内の稼働統計情報が取得されている時間帯です。

ff..ff

編集時間内で稼働統計情報が取得されていない時間帯です。

gg..gg

CTMレギュレータのレスポンス時間（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

hh..hh

CTMレギュレータのリクエストタイムアウト（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

ii..ii

CTMレギュレータのリクエスト障害（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

jj..jj

OTMゲートウェイのレスポンス時間（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

kk..kk

OTMゲートウェイのリクエストタイムアウト（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

ll..ll

OTMゲートウェイのリクエスト障害（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

mm..mm

スケジュール待ち件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

nn..nn

スケジュール待ち時間（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

oo..oo

スケジュールできなかったリクエスト数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

pp..pp

CTMレギュレータ異常終了の件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

qq..qq

OTMゲートウェイ異常終了の件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

rr..rr

CTMレギュレータとクライアント間のコネクション件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

ss..ss

OTMゲートウェイとOTMクライアント間のコネクション件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

tt..tt

CTMデーモンとJ2EEサーバ間の制御用のコネクション件数※（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

uu..uu

CTMデーモンとJ2EEサーバ間のリクエスト用のコネクション件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます

vv..vv

CTMデーモンとCTMレギュレータ間のコネクション件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

ww..ww

CTMデーモンとOTMゲートウェイ間のコネクション件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

注※

CTMデーモンとJ2EEサーバ（バッチアプリケーションを実行するシステムの場合，バッチサーバ）間制御用のコネクション件数は，J2EEサーバ数およびJ2EEサーバごとに生成しているキュー数の合計をカウントして出力します。

CTMノード全体でまとめた情報をCSV形式で出力する形式（-CTMEditオプションに"nod"を指定し，かつ-CTMCsvオプションを指定）

*** Statistics Information by CTMNode ***
CTMDomain，CTMID，start，end，Event，Count，Maximum，Minimum，Average，unit
aa..aa，bb..bb，cc..cc，dd..dd，ee..ee，ff..ff，gg..gg，hh..hh，ii..ii，jj..jj
aa..aa，bb..bb，cc..cc，dd..dd，ee..ee，ff..ff，gg..gg，hh..hh，ii..ii，jj..jj

（凡例）

記号

説明

aa..aa

CTMドメイン名称（1〜31文字の英数字）です。

bb..bb

CTM識別子（1〜31文字の英数字）です。

cc..cc

編集開始時間です。

dd..dd

編集終了時間です。

ee..ee

イベント内容です。

ff..ff

発生件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

gg..gg

最大値（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

hh..hh

最小値（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

ii..ii

平均値（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

jj..jj

単位です。

注

-CTMCsvオプションでは，編集時間内の統計情報データが取得されている時間帯，および編集時間内で稼働統計が取得されていない時間帯は出力されません。

キュー単位のスケジュールキュー情報を出力する形式（-CTMEditオプションに"que"を指定）

*** Statistics Information by Queue ***
CTMDomain :aa..aa
CTMID     :bb..bb
--------------------------------------------------------------------------------
QueueName : cc..cc
--------------------------------------------------------------------------------
** Edit time dd..dd - ee..ee **
statistical data : ff..ff − ff..ff
no data       　: gg..gg − gg..gg
--------------------------------------------------------------------------------
Event                        Count     　Maximum   　 Minimum    Average(unit)
Schedule Wait Count           hh..hh    　hh..hh      hh..hh      hh..hh(count)
Schedule Wait Time            ii..ii      ii..ii      ii..ii      ii..ii(usec)
Request Overflow              jj..jj           -           -           -(count)
CTMDaemon-J2EEServer(Req)  　　    -      kk..kk       kk..kk     kk..kk(count)

（凡例）

記号

説明

aa..aa

CTMドメイン名称（1〜31文字の英数字）です。

bb..bb

CTM識別子（1〜31文字の英数字）です。

cc..cc

J2EEアプリケーションの場合は，キュー名（1〜63文字）です。

バッチアプリケーションの場合は，スケジュールグループ名です。

dd..dd

編集開始時間です。

ee..ee

編集終了時間です。

ff..ff

編集時間内の稼働統計情報が取得されている時間帯です。

gg..gg

編集時間内の稼働統計情報が取得されていない時間帯です。

hh..hh

スケジュール待ち件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

ii..ii

スケジュール待ち時間（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

jj..jj

スケジュールできなかったリクエスト数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

kk..kk

CTMデーモンとJ2EEサーバ間（バッチアプリケーションを実行するシステムの場合はバッチサーバ間）のリクエスト用コネクションの件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

注

QueueName : cc..cc以下は，キュー単位に繰り返し出力されます。

キュー単位のスケジュールキュー情報をCSV形式で出力する形式（-CTMEditオプションに"que"を指定し，かつ-CTMCsvオプションを指定）

*** Statistics Information by CTMQueue ***
CTMDomain，CTMID，start，end，Event，Count，Maximum，Minimum，Average，unit
aa..aa，bb..bb，cc..cc，dd..dd，ee..ee，ff..ff，gg..gg，hh..hh，ii..ii，jj..jj
aa..aa，bb..bb，cc..cc，dd..dd，ee..ee，ff..ff，gg..gg，hh..hh，ii..ii，jj..jj
：
：

（凡例）

記号

説明

aa..aa

CTMドメイン名称（1〜31文字の英数字）です。

bb..bb

CTM識別子（1〜31文字の英数字）です。

cc..cc

編集開始時間です。

dd..dd

編集終了時間です。

ee..ee

イベント内容です。

ff..ff

発生件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

gg..gg

最大値（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

hh..hh

最小値（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

ii..ii

平均値（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

jj..jj

単位です。

注

-CTMCsvオプションでは，編集時間内の統計情報データが取得されている時間帯，および編集時間内で稼働統計が取得されていない時間帯は出力されません。

メソッド単位のリクエスト情報を出力する形式（-CTMEditオプションに"mtd"を指定）

*** Statistics Information by Method ***
CTMDomain :aa..aa
CTMID     :bb..bb
--------------------------------------------------------------------------------
** Edit time cc..cc - dd..dd **
statistical data : ee..ee − ee..ee
no data       : ff..ff − ff..ff
--------------------------------------------------------------------------------
Interface    : gg..gg
Method　     : hh..hh
--------------------------------------------------------------------------------
Event                        Count     Maximum     Minimum     Average (unit)
Request Response Time(Reg)  ii..ii      ii..ii      ii..ii      ii..ii (usec)
Request Time Out(Reg)       jj..jj           -           -           - (count)
Request Error(Reg)          kk..kk           -           -           - (count)
Request Response Time(OTM)  ll..ll      ll..ll      ll..ll      ll..ll (usec)
Request Time Out(OTM)       mm..mm           -           -           - (count)
Request Error(OTM)          nn..nn           -           -           - (count)

（凡例）

記号

説明

aa..aa

CTMドメイン名称（1〜31文字の英数字）です。

bb..bb

CTM識別子（1〜31文字の英数字）です。

cc..cc

編集開始時間です。

dd..dd

編集終了時間です。

ee..ee

編集時間内の稼働統計情報が取得されている時間帯です。

ff..ff

編集時間内の稼働統計情報が取得されている時間帯です。

gg..gg

インタフェース名（1〜31文字の英数字）です。31文字を超える場合は，"先頭から15文字" + "*" + "最後から15文字"の形式で出力されます。

hh..hh

メソッド名（1〜31文字の英数字）です。31文字を超える場合は，"先頭から15文字" + "*" + "最後から15文字"の形式で出力されます。

ii..ii

CTMレギュレータのレスポンス時間（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

jj..jj

CTMレギュレータのリクエストタイムアウト（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

kk..kk

CTMレギュレータのリクエスト障害（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

ll..ll

OTMゲートウェイのレスポンス時間（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

mm..mm

OTMゲートウェイのリクエストタイムアウト（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

nn..nn

OTMゲートウェイのリクエスト障害（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

注

Interface以下の情報が，J2EEサーバのメソッド単位に繰り返し出力されます。

メソッド単位のリクエスト情報をCSV形式で出力する形式（-CTMEditオプションに"mtd"を指定し，かつ-CTMCsvオプションを指定）

*** Statistics Information by Method ***
CTMDomain，CTMID，start，end，Event，Count，Maximum，Minimum，Average，unit
aa..aa，bb..bb，cc..cc，dd..dd，ee..ee，ff..ff，gg..gg，hh..hh，ii..ii，jj..jj
aa..aa，bb..bb，cc..cc，dd..dd，ee..ee，ff..ff，gg..gg，hh..hh，ii..ii，jj..jj
：

（凡例）

記号

説明

aa..aa

CTMドメイン名称（1〜31文字の英数字）です。

bb..bb

CTM識別子（1〜31文字の英数字）です。

cc..cc

編集開始時間です。

dd..dd

編集終了時間です。

ee..ee

イベント内容です。

ff..ff

発生件数（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

gg..gg

最大値（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

hh..hh

最小値（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

ii..ii

平均値（11けたの10進数）です。出力する値が100000000000以上の場合，"***********"が出力されます。

jj..jj

単位です。

注

-CTMCsvオプションでは，編集時間内の統計情報データが取得されている時間帯，および編集時間内で稼働統計が取得されていない時間帯は出力されません。バッチアプリケーションを実行するシステムの場合，メソッド単位のリクエスト情報は無効です。

ctmstsflush（バッファ内容の強制ファイル出力）

形式

ctmstsflush [-h] [-CTMDomain <CTMドメイン名称>] [-CTMID <CTM識別子>]

機能

バッファリング中のメソッド単位のリクエスト情報を強制的にファイルに出力します。

引数

-h

コマンドの使用方法が表示されます。

-CTMDomain <CTMドメイン名称>

CTMドメインマネジャが属するCTMドメイン名称を1〜31文字の英数字，またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まる文字列は指定しないでください。省略した場合は"CTMDOMAIN"が設定されます。

-CTMID <CTM識別子>

メソッド単位のリクエスト情報を強制的にファイルに出力させる，CTMデーモンのCTM識別子を1〜31文字の英数字，ピリオド（.），またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まるCTM識別子は指定しないでください。ピリオド（.）は，IPアドレスを指定する場合だけ使用できます。

省略した場合は，IPアドレスがCTM識別子に設定されます。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

ctmstsstart（稼働統計情報の取得開始）

形式

ctmstsstart [-h]｜[[-CTMDomain <CTMドメイン名称>] [-CTMID <CTM識別子>]
            [-CTMInterval <時間間隔>] [-CTMCheckInterval <時間間隔>]]

機能

稼働統計情報ファイルへの情報の取得を開始します。

CTMデーモンを開始する前にこのコマンドを実行するとエラーになります。

引数

-h

コマンドの使用方法が表示されます。

-CTMDomain <CTMドメイン名称>

CTMドメインマネジャが属するCTMドメイン名称を1〜31文字の英数字，またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まる文字列は指定しないでください。省略した場合は"CTMDOMAIN"が設定されます。

-CTMID <CTM識別子>

稼働統計情報ファイルへの情報の取得を開始する，CTMデーモンのCTM識別子を1〜31文字の英数字，ピリオド（.），またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まるCTM識別子は指定しないでください。ピリオド（.）は，IPアドレスを指定する場合だけ使用できます。マルチホームドホスト環境で使用する場合は，-CTMIDオプションは省略できません。

省略した場合は，IPアドレスがCTM識別子に設定されます。

-CTMInterval <時間間隔>

稼働統計情報ファイルに情報を取得する時間の間隔（単位：分）を1〜1440の整数で指定します。省略した場合は"1"（分）が設定されます。

-CTMCheckInterval <時間間隔>

コネクション情報を取得する時間の間隔（単位：秒）を1〜60の整数で指定します。コネクション数が多くなるとコネクション情報の取得に時間が掛かるので，コネクション数が多い場合は，指定する値を大きくしてください。省略した場合は"60"（秒）が設定されます。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

注意事項

ctmstsstartコマンドを実行して-CTMIntervalオプションに指定した時間が経過した時点で，稼働統計情報ファイルに情報が出力されるとは限りません。これは，ctmstsstartコマンドを実行して最初にXX時YY分00秒（X，Y：符号なし整数）となった時から，稼働統計情報の取得が開始されるためです。この取得開始から-CTMIntervalオプションに指定した時間が経過した時点で，稼働統計情報ファイルに情報が出力されます。

例えば，ctmstsstartコマンドに-CTMInterval 1を指定して，18時10分30秒に実行すると，稼働統計情報の取得は18時11分00秒に開始され，稼働統計情報ファイルが出力されるのは18時12分00秒となります。

ctmstsstop（稼働統計情報の取得終了）

形式

ctmstsstop [-h] [-CTMDomain <CTMドメイン名称>] [-CTMID <CTM識別子>]

機能

稼働統計情報ファイルへの情報の取得を終了します。

引数

-h

コマンドの使用方法が表示されます。

-CTMDomain <CTMドメイン名称>

CTMドメインマネジャが属するCTMドメイン名称を1〜31文字の英数字，またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まる文字列は指定しないでください。省略した場合は"CTMDOMAIN"が設定されます。

-CTMID <CTM識別子>

稼働統計情報ファイルへの情報の取得を停止する，CTMデーモンのCTM識別子を1〜31文字の英数字，ピリオド（.），またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まるCTM識別子は指定しないでください。ピリオド（.）は，IPアドレスを指定する場合だけ使用できます。マルチホームドホスト環境で使用する場合は，-CTMIDオプションは省略できません。

省略した場合は，IPアドレスがCTM識別子に設定されます。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

注意事項

ctmstsstartコマンドの-CTMIntervalオプションに指定した時間間隔の経過前にctmstsstopコマンドを実行すると，ctmstsstopコマンドの実行までに取得した情報がすべてファイルに出力されます。

ctmtscgwd（OTMゲートウェイの開始）

形式

ctmtscgwd [-h] |
          [-CTMDomain <CTMドメイン名称>]
          [-CTMID <CTM識別子>]
          [-CTMPort <ポート番号>]
          [-CTMMyHost <ホスト名称またはIPアドレス>]
          [-CTMClientConnectCount <接続クライアントの最大数>]
          [-CTMTPool]

機能

OTMクライアントのリクエストをCTMで処理するためのゲートウェイプロセスを開始します。OTMゲートウェイはCTMデーモンが動作するホストと同じホストで開始してください。なお，OTMゲートウェイを直接開始することはできません。

引数

-h

コマンドの使用方法が表示されます。

-CTMDomain <CTMドメイン名称>

CTMデーモンが属するCTMドメイン名称を1〜31文字の英数字，またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まる文字列は指定しないでください。省略した場合は"CTMDOMAIN"が設定されます。

-CTMID <CTM識別子>

CTMデーモンのCTM識別子を1〜31文字の英数字，ピリオド（.），またはアンダースコア（_）で指定します。"CTM"または"ctm"で始まるCTM識別子は指定しないでください。ピリオド（.）は，IPアドレスを指定する場合だけ使用できます。

省略した場合は，IPアドレスがCTM識別子に設定されます。例えば，ホストのIPアドレスが"172.17.112.43"のとき，"172.17.112.43"という文字列がCTM識別子となります。

-CTMPort <ポート番号>

OTMクライアントがOTMゲートウェイの新しいコネクションを探すときに使用するポート番号を5001〜65535の整数で指定します。省略した場合は，OSが自動的に割り当てたポート番号を使用します。

-CTMMyHost <ホスト名称またはIPアドレス>

マルチホームまたはIPアドレスを引き継ぐ系切り替え環境でCTMが使用するホスト名称またはIPアドレスを1〜64文字の文字列で指定します。省略した場合は，hostnameコマンドで取得されるホスト名称が設定されます。

-CTMIDオプションを省略して-CTMMyHostオプションを指定した場合，デフォルトのCTM識別子は-CTMMyHostオプションで指定したIPアドレスになります。

-CTMClientConnectCount ＜接続クライアントの最大数＞

OTMゲートウェイに接続できるコネクション数を1〜32767の整数で指定します。コネクション数は，OTMクライアントからの接続数です。省略した場合は"64"が設定されます。

-CTMTPool

OTMゲートウェイをスレッドプーリング（ThreadPool）モデルで動作させます。省略した場合は，スレッドパーセション（ThreadSession）で動作させます。スレッドプーリングおよびスレッドパーセションの詳細については，マニュアル「Borland(R) Enterprise Server VisiBroker(R) デベロッパーズガイド」を参照してください。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

注意事項

OTMゲートウェイは開始後にカレントディレクトリを移動します。そのため，次に示す場合のコアファイルの出力先は，実行形式ファイルのディレクトリとは異なります。

"ctmdmstop -CTMForce -CTMDebugInfo"，killコマンドなどでOTMゲートウェイを強制終了した場合

OTMゲートウェイが異常終了した場合

移動後のカレントディレクトリを次に示します。

Windowsの場合

"%CTMSPOOL%¥adm¥CTM識別子¥tgwd¥カレントディレクトリID¥"

UNIXの場合

"$CTMSPOOL/adm/CTM識別子/tgwd/カレントディレクトリID/"

カレントディレクトリIDは，メッセージKFCT70606-Iを参照してください。

ctmver（実行形式ファイルおよびライブラリのバージョン情報の出力）

形式

ctmver -h | <ファイルパス>

機能

CTMが提供する実行形式ファイルおよびライブラリのバージョン情報を出力します。

引数

-h

コマンドの使用方法が表示されます。

<ファイルパス>

対象となるファイルパス（相対パスまたは絶対パス）を指定します。

出力形式

Information For：aa…aa
Product Name：bb….bb
PP Number：cc…cc
Version：dd…dd
Copyright：ee…ee
Company：ff…ff
Build OS：gg…gg
Build Compiler：hh…hh
Build Date：ii…ii jj…jj
Build Number：kk…kk

（凡例）

aa…aa：ファイル名称（文字列）

bb…bb：製品名称（文字列）

cc…cc：PP型名（文字列）

dd…dd：バージョンおよびリビジョン（文字列）

ee…ee：コピーライト（文字列）

ff…ff：会社名（文字列）

gg…gg：ビルドOS（文字列）

hh…hh：ビルドコンパイラ（文字列）

ii…ii：ビルド日付（文字列）

jj…jj：ビルド時刻（文字列）

kk…kk：保守情報(文字列)

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

7　Management Serverで使用するコマンド

この章では，Management Serverで使用するコマンドの入力形式，機能などについて説明します。

7.1　Management Serverで使用するコマンドの一覧

Management Serverで使用するコマンドの一覧を，次の表に示します。

表7‒1　Management Serverで使用するコマンドの一覧

コマンド名称

分類

概要

adminagentcheck

運用管理エージェントの稼働確認

運用管理エージェントが稼働しているかどうかを確認します。

adminagentctl

運用管理エージェントの起動と停止

運用管理エージェントを起動または停止します。

daemon

デーモンプロセスの起動

Management Server，運用管理エージェントをデーモンプロセスとして起動します。

このコマンドは，UNIX用です。

kill

プロセスの強制停止

プロセスを強制終了します。

このコマンドは，Windows用です。

mngautorun

自動起動および自動再起動の設定／設定解除

Management Serverおよび運用管理エージェントの自動起動および自動再起動を設定します。または，Management Serverおよび運用管理エージェントの自動起動および自動再起動の設定を解除します。

mngenvsetup

管理グループの設定

OSのグループをManager Sever管理グループ，統合ユーザ管理グループに設定します。

このコマンドは，UNIX用です。

mngenvupdate

Management Serverの移行コマンド

Management Serverで管理している情報を，最新のバージョンで使用する形式に移行します。

mngsvr_adapter_setup

アダプタコマンドのセットアップとアンセットアップ

JP1/IM連携で使用するアダプタコマンドのセットアップまたはアンセットアップを実行します。

mngsvr_monitor_setup

モニタ起動コマンドのセットアップとアンセットアップ

JP1/IM連携で使用するモニタ起動コマンドのセットアップまたはアンセットアップを実行します。

このコマンドは，Windows用です。

mngsvrctl

Management Serverの起動／停止／セットアップ

Management Serverを起動または停止します。または，Management Serverの実行に必要なセットアップをします。

mngsvrupdate

Management Serverの移行コマンド

Component Containerのバージョンアップに合わせて，Management Serverで管理している情報を，最新のバージョンで使用する形式に移行します。

mngsvrutil

Management Serverの運用管理コマンド

Management Serverに接続して，運用管理ドメイン内での操作を実行します。

mngunsetup

Management Serverの構築環境の削除

Management Serverおよび運用管理エージェントをアンセットアップし，Management Serverを使用して構築したシステム環境（論理サーバ）を削除します。

mstrexport

Management Server管理ファイルの退避

Management Server管理ファイルを収集してZIP形式で出力します。

mstrimport

Management Server管理ファイルの回復

回復に成功したファイルのパス名を，システムプロパティを含んだ形式で標準出力に出力します。

setupwizard

システムのセットアップ，アンセットアップと複製

セットアップウィザードを起動して，システム環境をセットアップ，アンセットアップまたは複製します。また，セットアップウィザードで使用するセットアップ情報ファイルの内容を表示します。

注意事項

運用管理エージェントまたはManagement Serverの起動に続けて，運用管理コマンド（mngsvrutil）またはSmart Composer機能などでManagement Serverにアクセスする場合，事前に次のどちらかの対策をしてください。

運用管理エージェントまたはManagement Serverの起動時に同期実行を有効にし起動に続けてコマンドを実行する。

mngsvrutil checkまたはadminagentcheckコマンドで，Management Serverまたは運用管理エージェントが起動済みであることを確認する。

7.2　Management Serverで使用するコマンドの詳細

Management Serverで使用する各コマンドの入力形式，機能などを次に示します。

コマンドの格納先

Management Serverサーバで使用するコマンドは，次のディレクトリに格納されています。

Windowsの場合

mngsvr_monitor_setupコマンドおよびsetupwizardコマンド以外のコマンド

<Application Serverのインストールディレクトリ>¥manager¥bin¥

mngsvr_monitor_setupコマンド

<Application Serverのインストールディレクトリ>¥manager¥externals¥jp1¥mngsvrmonitor¥

なお，このコマンドは，運用管理クライアントマシンのコピー先で実行します。

setupwizardコマンド

<Application Serverのインストールディレクトリ>¥manager¥setup¥bin¥

UNIXの場合

setupwizardコマンド以外のコマンド

/opt/Cosminexus/manager/bin/

setupwizardコマンド

/opt/Cosminexus/manager/setup/bin/

adminagentcheck（運用管理エージェントの稼働確認）

形式

他ホストの運用管理エージェントの稼働状況を確認する場合

adminagentcheck [-t <タイムアウト時間>] [<ホスト名>[：<ポート番号>]]

自ホストの運用管理エージェントの稼働状況を確認する場合

adminagentcheck [-t <タイムアウト時間>]

機能

運用管理エージェントが稼働しているかどうかを，Management Serverを経由しないで確認します。

引数

-t <タイムアウト時間>

運用管理エージェントとの接続タイムアウト時間（単位：秒）を，0〜2147483の整数で指定します。0を指定した場合，タイムアウトは無限と解釈されます。その場合，接続が確立されるまで，またはエラーが発生するまで待ち続けます。このオプションを省略した場合，タイムアウト時間は5（秒）です。

<ホスト名>

運用管理エージェントとの通信で使用するドット記法でのIPアドレス（xxx.xxx.xxx.xxx），または名前解決できるホスト名を指定します。なお，xxxには0〜255の整数を指定します。

<ポート番号>

運用管理エージェントとの通信で使用するポート番号を1〜65535の整数で指定します。

オプションが省略された場合に，adminagent.propertiesに省略値が設定されているときは，その値が使用されます。値が設定されていない場合，またはポート番号に指定できない値が設定されている場合はデフォルト値が使用されます。オプションの省略時に使用されるadminagent.propertiesのプロパティ名，デフォルト値を次に示します。

オプション

プロパティ名

デフォルト値

ホスト名

adminagent.adapter.bind_host

127.0.0.1

ポート番号

adminagent.adapter.port

20295

戻り値

0：

運用管理エージェントは稼働しています。

1：

コマンド実行時エラーです。

指定されたホスト名がアドレス解決できない場合，1となります。

2：

コマンドシンタックスエラーです。

103：

運用管理エージェントは稼働していません。

すべての通信エラーおよびタイムアウト時に，103となります。

注意事項

オプションが省略された場合は，adminagent.propertiesのポート番号に指定範囲外の値が設定されていてもデフォルト値が設定されますが，オプションに指定範囲外の値が設定された場合は，シンタックスエラーとなります。

adminagentcheckコマンドは，運用監視を行うバッチまたはシェルからの使用が想定されています。そのため，標準出力およびエラー出力には何も出力されません。運用管理エージェントが稼働しているかどうか，およびコマンドエラーについては，戻り値から判定してください。ただし，コマンドシンタックスエラーの場合だけ，Usageが出力されます。

adminagentctl（運用管理エージェントの起動と停止）

形式

運用管理エージェントを起動する場合

Windowsのとき

adminagentctl start [-sync [-timeout <同期実行のタイムアウト時間>]]

UNIXのとき

adminagentctl start [-sync [-timeout <同期実行のタイムアウト時間>]] [-daemon]

運用管理エージェントを停止する場合

Windowsのとき

adminagentctl stop [-sync [-timeout <同期実行のタイムアウト時間>]]

UNIXのとき

adminagentctl stop [-sync [-timeout <同期実行のタイムアウト時間>]]

機能

運用管理エージェントを起動または停止します。

このコマンドは，Administrator権限（Windowsの場合），またはroot権限（UNIXの場合）のあるユーザが実行してください。ただし，UNIXの場合，root権限がない特定のユーザにコマンドの実行権限を設定することもできます。設定については，「mngenvsetup（管理グループの設定）」を参照してください。

引数

引数の指定がない場合，コマンドの使用方法を表示します。

start

運用管理エージェントを起動します。

stop

運用管理エージェントを停止します。

-sync

コマンドの処理と，運用管理エージェントの起動または停止処理の同期実行を有効にします。

-timeout <同期実行のタイムアウト時間>

コマンドを同期実行してから，運用管理エージェントが起動または停止するまでの待ち時間（単位：秒）を0，61〜2147483の整数で指定します。このオプションは，-syncオプションを指定すると有効になります。

0を指定した場合，タイムアウトしないで運用管理エージェントが起動または停止するまで待ち続けます。このオプションを省略した場合，同期実行のタイムアウト時間は120（秒）です。

-daemon

運用管理エージェントをデーモンプロセスとして起動します。daemonコマンドを使用してデーモンプロセスとして起動する場合と同様に動作します。daemonコマンドについては，「daemon（デーモンプロセスの起動）」を参照してください。

戻り値

0：

正常終了しました。

1：

実行時エラーが発生しました。

2：

シンタックスエラーが発生しました。

3：

同期実行エラーが発生しました。

入力例

入力例1

運用管理エージェントを起動する場合

adminagentctl start

入力例2

運用管理エージェントを同期実行で起動する場合

adminagentctl start -sync

注意事項

運用管理エージェントやManagement Serverの起動に続けて，運用管理コマンドまたはSmart ComposerなどでManagement Serverにアクセスする場合，同期実行を有効にしてください。

daemon（デーモンプロセスの起動）

形式

Management Serverを起動する場合

Management Serverをデーモンプロセスとして起動する場合，次の方法で起動してください。

/opt/Cosminexus/manager/bin/daemon -cf /opt/Cosminexus/manager/bin/mngsvrctl start

mngsvrctl（Management Serverの起動／停止／セットアップ）の詳細については，「mngsvrctl（Management Serverの起動／停止／セットアップ）」を参照してください。

運用管理エージェントを起動する場合

運用管理エージェントをデーモンプロセスとして起動する場合，次の方法で起動してください。

/opt/Cosminexus/manager/bin/daemon -cf /opt/Cosminexus/manager/bin/adminagentctl start

adminagentctl（運用管理エージェントの起動と停止）の詳細については，「adminagentctl（運用管理エージェントの起動と停止）」を参照してください。

機能

Management Server，運用管理エージェントを，デーモンプロセスとして起動します。この場合，同期実行はできません。なお，このコマンドは，UNIX用です。

kill（プロセスの強制停止）

形式

kill <プロセスID> [<プロセスID> ...]

機能

プロセスを強制終了します。運用管理ポータルから論理サーバを停止できなくなった場合などに実行します。

このコマンドは，Administrator権限のあるユーザが実行してください。なお，このコマンドは，Windows用です。

引数

<プロセスID>

強制終了するプロセスのIDを指定します。

複数指定できます。

入力例

kill 2034

mngautorun（自動起動および自動再起動の設定／設定解除）

形式

Management Serverと運用管理エージェントの自動起動を設定する場合

Windowsの場合

mngautorun [once] {server|agent|both} [-sync [-timeout <同期実行のタイムアウト時間>]]

UNIXの場合

mngautorun [once] {server|agent|both} [-runlevel <ランレベル>] [-sync [-timeout <同期実行のタイムアウト時間>]]

Management Serverと運用管理エージェントの自動起動および自動再起動を設定する場合

Windowsの場合

mngautorun respawn {server|agent|both} [-sync [-timeout <同期実行のタイムアウト時間>]]

UNIXの場合

mngautorun respawn {server|agent|both} [-runlevel <ランレベル>]

Management Serverと運用管理エージェントの自動起動および自動再起動の設定を解除する場合

Windowsの場合

mngautorun -d

UNIXの場合

mngautorun -d

機能

Management Serverおよび運用管理エージェントの自動起動および自動再起動を設定，または設定を解除します。このコマンドでは，次の設定をします。

マシン起動と同時に，Management Serverと運用管理エージェントを自動起動するように設定します。

マシン起動時に，Management Serverおよび運用管理エージェントの両方が自動起動する場合，運用管理エージェント起動後にManagement Serverを起動するように依存関係を設定します。

障害発生時に，Management Serverと運用管理エージェントを自動再起動するように設定します。

Management Serverおよび運用管理エージェントから自動起動および自動再起動の設定を解除します。

引数

オプションの指定がない場合，コマンドの使用方法が表示されます。

-d

Management Serverおよび運用管理エージェントの自動起動および自動再起動を無効にします。

once

Management Serverまたは運用管理エージェントの自動起動を有効にします。自動再起動は有効になりません。なお，onceオプションおよびrespawnオプションの両方が省略された場合は，onceオプションが指定されたものとして動作します。

respawn

Management Serverまたは運用管理エージェントの自動起動および自動再起動を有効にします。なお，onceオプションおよびrespawnオプションの両方が省略された場合は，onceオプションが指定されたものとして動作します。

server

Management Serverの自動起動または自動再起動を有効にします。

agent

運用管理エージェントの自動起動または自動再起動を有効にします。

both

Management Serverおよび運用管理エージェントの自動起動または自動再起動を有効にし，運用管理エージェント起動後にManagement Serverを起動するように依存関係を設定します。

-runlevel

自動起動および自動再起動が実行されるランレベルを指定します。ランレベルは複数指定できます。このオプションはUNIXの場合だけ有効です。ランレベルについては，OSのドキュメントを参照してください。

指定例を次に示します。

（例）

-runlevel 23456

オプションが省略された場合は，2が設定されます。

-sync

自動起動または自動再起動時に，Management Serverおよび運用管理エージェントの起動で同期実行を有効にします。UNIXの場合，respawnオプションを指定するときは，このオプションを指定できません。

-timeout <同期実行のタイムアウト時間>

自動起動または自動再起動時に，Management Serverおよび運用管理エージェントが起動するまでの待ち時間（単位：秒）を0，61〜2147483の整数で指定します。0を指定した場合，タイムアウトしないでManagement Serverおよび運用管理エージェントが自動起動するまで待ち続けます。このオプションを省略した場合，同期実行のタイムアウト時間は120（秒）です。UNIXの場合，respawnオプションを指定するときは，このオプションを指定できません。

戻り値

0：

正常終了しました。

1：

実行時エラーが発生しました。

2：

シンタックスエラーが発生しました。

入力例

入力例1

Management Serverと運用管理エージェントをOS起動時に開始する場合

mngautorun both

入力例2

Management Serverと運用管理エージェントの自動起動と自動再起動を開始する場合

mngautorun respawn both

入力例3（UNIXの場合）

Management Serverと運用管理エージェントの自動起動と自動再起動をランレベル3で開始する場合

mngautorun respawn both -runlevel 3

入力例4

Management Serverと運用管理エージェントの自動起動と自動再起動を解除する場合

mngautorun -d

入力例5

Management Serverと運用管理エージェントの自動起動を同期実行で開始（タイムアウトは180秒を設定）する場合

mngautorun once both -sync -timeout 180

入力例6（Windowsの場合）

Management Serverと運用管理エージェントの自動起動と自動再起動を同期実行で開始（タイムアウトは180秒を設定）する場合

mngautorun respawn both -sync -timeout 180

注意事項

Windowsの場合，bothオプションで依存関係が設定されたManagement Serverおよび運用管理エージェントでは次の点に注意してください。

bothオプションを指定してコマンドを実行したあとは，マシンを再起動してください。マシンを再起動しないと，Management Serverおよび運用管理エージェントの依存関係は設定されません。

-dオプションを指定してコマンドを実行してあとは，マシンを再起動してください。マシンを再起動しないと，Management Serverおよび運用管理エージェントの依存関係は無効になりません。

自動再起動が設定された運用管理エージェントを停止するときは，Management Serverを先に停止してください。運用管理エージェントをManagement Serverより前に停止すると，運用管理エージェントが再起動されます。

UNIXの場合，mngautorunコマンドで/etc/inittabに登録されたエントリの識別子などを手動で変更したときは，mngautorunコマンドの-dオプションを実行しても設定が解除されないことがあります。

UNIXの場合，OSの仕様によって，自動再起動を同期実行で開始できません。指定した場合は，シンタックスエラーとなります。

AIXの場合，mngautorunコマンドを実行すると，自動起動が設定されてManagement Serverおよび運用管理エージェントが稼働状態になることがあります。また，inittabで起動されたManagement Serverおよび運用管理エージェントがある場合にmngautorunコマンドの-dオプションを実行すると，Management Serverおよび運用管理エージェントが停止状態になることがあります。

Management Serverを起動する際，論理サーバを一括起動する設定で，かつOS起動時にManagement Serverが自動的に起動する設定の場合，OS起動時の負荷によって論理サーバの起動に時間が掛かることがあります。このため，あらかじめ論理サーバの起動監視時間を長めに設定しておくことをお勧めします。

mngenvsetup（管理グループの設定）

形式

mngenvsetup [-mng | -ua] {<OSのグループ名> | -d}

機能

root権限を持つユーザしかできなかったManagement Serverで使用するコマンドおよび統合管理ユーザで使用するコマンドを，root権限を持たない特定のユーザが実行できるように設定できます。なお，このコマンドは，UNIX用です。

Management Serverで使用するコマンドを実行できるユーザのグループをManagement Server管理グループといいます。統合管理ユーザで使用するコマンドを実行できるユーザのグループを統合ユーザ管理グループといいます。

このコマンドは，OSのグループをManagement Server管理グループと統合ユーザ管理グループとして設定します。

このコマンドの対象となるコマンドを次に示します。

root権限以外の運用で実行できるコマンド

管理グループ

Management Server管理グループ

統合ユーザ管理グループ※

adminagentctl

○

−

convpw

−

○

mngautorun

○

−

mngsvr_adapter_setup

○

−

mngsvrctl

○

−

mngunsetup

○

−

ssoexport

−

○

ssogenkey

−

○

ssoimport

−

○

uachpw

−

○

（凡例）

○：該当します。

−：該当しません。

注※　統合ユーザ管理グループのコマンドの詳細については，マニュアル「アプリケーションサーバ 機能解説 セキュリティ管理機能編」の「13.　統合ユーザ管理で使用するコマンド」を参照してください。

引数の指定と管理グループの設定は次のとおりです。

-mngを指定するとManagement Server管理グループだけを設定します。

-uaを指定すると統合ユーザ管理グループだけを設定します。

-mng，-uaを指定しないで，OSのグループ名を指定した場合は，Management Server管理グループおよび統合ユーザ管理グループの両方に，指定したOSのグループが設定されます。

-dだけを指定すると，Management Server管理グループおよび統合ユーザ管理グループの両方の設定が削除されます。コマンドを実行できるのは，root権限を持つユーザだけに戻ります。また，Management Server管理グループおよび統合ユーザ管理グループは，アプリケーションサーバのインストール時のOSグループに戻ります。

-dと-mngまたは-uaを同時に指定すると，Management Server管理グループまたは統合ユーザ管理グループのどちらかの設定が削除されます。設定が削除された管理グループのコマンドを実行できるのは，root権限を持つユーザだけに戻ります。

Management Server管理グループまたは統合ユーザ管理グループが設定された状態でこのコマンドを実行すると上書き設定されます。

引数

-mng <OSのグループ名>

OSのグループをManagement Server管理グループに設定します。OSのグループ名を省略した場合にはUSAGEが表示されます。

-ua <OSのグループ名>

OSのグループを統合ユーザ管理グループに設定します。OSのグループ名を省略した場合にはUSAGEが表示されます。

-d

Management Server管理グループおよび統合ユーザ管理グループの設定が削除されます。コマンドを実行できるのは，root権限を持つユーザだけに戻ります。

入力例

入力例1

Management Server管理グループおよび統合ユーザ管理グループをmanagerに設定する場合

mngenvsetup manager

入力例2

Management Server管理グループをmanagerに設定する場合

mngenvsetup -mng manager

入力例3

統合ユーザ管理グループをmanagerに設定する場合

mngenvsetup -ua manager

入力例4

Management Server管理グループおよび統合ユーザ管理グループをrootに戻す場合

mngenvsetup -d

注意事項

このコマンドを実行すると，Management Serverで使用するコマンドまたは統合ユーザ管理で使用するコマンドにSUIDビットが付加されます。このため，アクセス権を与えるユーザを適切に設定する必要があります。

mngenvupdate（Management Serverの移行コマンド）

形式

mngenvupdate

機能

Management Serverで管理する情報を最新のバージョンで使用する形式に移行します。

このコマンドは，Management Serverが動作するホストで実行します。

このコマンドは，Administrator権限（Windowsの場合）またはroot権限（UNIXの場合）のあるユーザが実行してください。

なお，移行手順については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「10.　旧バージョンのアプリケーションサーバからの移行（J2EEサーバモードの場合）」を参照してください。

mngenvupdateコマンドを実行すると，次の処理が実行されます。

Management Serverで管理する定義ファイル（mserver.cfg）を，最新のバージョンで使用する形式に移行します。

参考

移行時，バックアップファイルが定義ファイルと同じディレクトリに作成されます。作成されるバックアップファイルの名称は，「<移行対象の定義ファイル名>.envupdate_bak」です。バックアップファイル作成時に同名のファイルがある場合，その名称は「<移行対象の定義ファイル名>.envupdate_bak_[n]」（nは1〜2147483647の連番）となります。なお，1〜2147483647のすべての番号でバックアップファイルが作成されている場合は，1に戻ってバックアップファイルを上書きします。

旧バージョンで次のManagement Serverの機能を使用していた場合は，各機能で使用していたファイルを，最新のバージョンで使用する形式に移行します。

統合ユーザ管理機能

<Application Serverのインストールディレクトリ>/manager/containers/m/j2eeapps/mngsvr/mportal/useradmin/config/data/editusersConfig.xml

Management Serverのサーバ名を変更していた場合は，サーバ名を最新バージョンの環境に移行（<Application Serverのインストールディレクトリ>/CC/server/bin/cjsetup <実サーバ名>を実行）します。

入力例

mngenvupdate

戻り値

0：

正常終了しました。

0以外：

異常終了しました。

注意事項

このコマンドは，旧バージョンからバージョンアップしたあとに実行してください。

mngenvupdateコマンドの実行に失敗した場合，<Application Serverのインストールディレクトリ>/manager/configディレクトリの直下に一時ファイル（mserver.cfgxxxxxxxxxxxxxxxxxxxx.tmp）が残ることがありますが，この一時ファイルを残しても削除しても，そのあとの操作に影響はありません。

mngsvr_adapter_setup（アダプタコマンドのセットアップとアンセットアップ）

形式

mngsvr_adapter_setup [ -i | -u ] [ -t IM_CS ]

機能

JP1/IM連携をする場合に，アダプタコマンドをセットアップまたはアンセットアップします。コマンドを実行すると，JP1/Baseの環境にApplication Server用のアダプタコマンド設定ファイルを追加します。

このコマンドは，アプリケーションサーバの運用管理サーバ（Management Serverを配置しているホスト）で実行します。

このコマンドは，Administrator権限（Windowsの場合），またはroot権限（UNIXの場合）があるユーザが実行してください。ただし，UNIXの場合，root権限がない特定のユーザにコマンドの実行権限を設定することもできます。設定については，「mngenvsetup（管理グループの設定）」を参照してください。

引数

引数の指定がない場合，JP1/IM - Central Scope連携用のアダプタコマンドのセットアップを実行します。

-i

セットアップを実行します。

-u

アンセットアップを実行します。

-t IM_CS

JP1/IM - Central Scope連携用のアダプタコマンドのセットアップを実行します。

入力例

mngsvr_adapter_setup -i -t IM_CS

mngsvr_monitor_setup（モニタ起動コマンドのセットアップとアンセットアップ）

形式

mngsvr_monitor_setup [ -i | -u ]

機能

JP1/IM連携をする場合に，モニタ起動コマンドをセットアップまたはアンセットアップします。

このコマンドは，<Application Serverのインストールディレクトリ>¥manager¥externals¥jp1¥mngsvrmonitor下に格納されています。運用管理クライアントマシンのコピー先で実行します。

このコマンドは，Administrator権限があるユーザが実行してください。なお，このコマンドは，Windows用です。

引数

引数の指定がない場合は，セットアップを実行します。

-i

セットアップを実行します。

-u

アンセットアップを実行します。

mngsvrctl（Management Serverの起動／停止／セットアップ）

形式

Management Serverを起動する場合

Windowsの場合

mngsvrctl start [-sync [-timeout <同期実行のタイムアウト時間>]]

UNIXの場合

mngsvrctl start [-sync [-timeout <同期実行のタイムアウト時間>]] [-daemon]

Management Serverを停止する場合

Windowsの場合

mngsvrctl stop [-sync [-timeout <同期実行のタイムアウト時間>]]

UNIXの場合

mngsvrctl stop [-sync [-timeout <同期実行のタイムアウト時間>]]

Management Serverをセットアップする場合

Windowsの場合

mngsvrctl setup [<サーバ名>] {[-u <管理ユーザID>] [-p <管理ユーザパスワード>] [-nu <変更後の管理ユーザID>] [-np <変更後の管理ユーザパスワード>] | -interactive}

UNIXの場合

mngsvrctl setup [<サーバ名>] {[-u <管理ユーザID>] [-p <管理ユーザパスワード>] [-nu <変更後の管理ユーザID>] [-np <変更後の管理ユーザパスワード>] | -interactive}

機能

Management Serverを起動または停止します。または，アプリケーションサーバを初めてインストールしたマシンで，Management Serverを実行するために必要なセットアップをします。

管理ユーザアカウントの省略機能を無効にしている場合，セットアップと同時に，Management Serverへログインするための管理ユーザアカウント（管理ユーザIDおよび管理ユーザパスワード）を設定できます。セットアップ時に管理ユーザアカウントを設定しないと，Management Serverの起動時および停止時に管理ユーザアカウントの設定が必要になります。また，管理ユーザアカウントがすでに設定されている場合は，別のユーザアカウントを指定することで管理ユーザアカウントを変更することもできます。

管理ユーザアカウントの省略機能を有効にしている場合，および仮想化したサーバ上でJP1ユーザ認証連携機能を有効にしている場合，このコマンドの実行時およびManagement Serverの起動後に管理ユーザアカウントを設定する必要はありません。

管理ユーザアカウントの省略機能については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.15(3)　管理ユーザアカウントを設定しない場合の設定」を参照してください。

このコマンドは，Administrator権限（Windowsの場合），またはroot権限（UNIXの場合）のあるユーザが実行してください。ただし，UNIXの場合，root権限がない特定のユーザにコマンドの実行権限を設定することもできます。設定については，「mngenvsetup（管理グループの設定）」を参照してください。

このコマンドの-pまたは-npオプションにパスワードを指定した場合，プロセスの引数を確認できるOS機能などでパスワードが観測されるおそれがあります。このため，-interactiveオプションによる対話形式でのパスワードの設定を推奨します。

引数

引数の指定がない場合，コマンドの使用方法が表示されます。

start

Management Serverを起動します。

stop

Management Serverを停止します。

-sync

コマンドの処理と，Management Serverの起動または停止処理の同期実行を有効にします。次の場合は，このオプションを省略しても同期実行されます。ただし，-timeoutオプションを指定するときは，このオプションは省略できません。

Management Serverを停止する場合

Windowsでかつ，Management Serverを起動する場合

なお，UNIXでかつ，Management Serverを起動する場合は，このオプションを指定するとバックグラウンドジョブとして同期実行され，省略するとフォアグラウンドジョブとして同期実行されます。

-timeout <同期実行のタイムアウト時間>

コマンドを同期実行してから，Management Serverが起動または停止するまでの待ち時間（単位：秒）を0，61〜2147483の整数で指定します。このオプションは，-syncオプションを指定すると有効になります。

0を指定した場合，タイムアウトしないでManagement Serverが起動または停止するまで待ち続けます。このオプションを省略した場合，同期実行のタイムアウト時間は120（秒）です。

-daemon

Management Serverをデーモンプロセスとして起動します。daemonコマンドを使用してデーモンプロセスとして起動する場合と同様に動作します。daemonコマンドについては，「daemon（デーモンプロセスの起動）」を参照してください。

setup

Management Serverをセットアップします。

<サーバ名>

Management Serverの名称（J2EEサーバのサーバ名称）を指定します。省略した場合は，「cosmi_m」が仮定されます。

-u <管理ユーザID>

Management Serverの管理ユーザIDを指定します。

-p <管理ユーザパスワード>

Management Serverの管理ユーザパスワードを指定します。

-nu <変更後の管理ユーザID>

新しいManagement Serverの管理ユーザIDを指定します。

設定済みの管理ユーザパスワードを解除する場合は，空文字（""）を指定します。

-np <変更後の管理ユーザパスワード>

新しいManagement Serverの管理ユーザパスワードを指定します。

-interactive

管理ユーザアカウントのユーザIDとパスワードを対話形式に設定する場合に指定します。

戻り値

0：

正常終了しました。

1以上：

実行時エラーが発生しました。ただし，2はシンタックスエラー，3は同期実行エラーが発生した場合もあります。

2：

シンタックスエラーが発生しました。

3：

同期実行エラーが発生しました。

入力例

入力例1

Management Serverを起動する場合

mngsvrctl start

入力例2

Management Serverを同期実行で起動する場合

mngsvrctl start -sync

入力例3

Management Serverをセットアップする場合

mngsvrctl setup [<サーバ名>]

入力例4

セットアップ時に管理ユーザアカウントの設定もする場合

mngsvrctl setup [<サーバ名>] -u admin01 -p p1574809

入力例5

設定済みの管理ユーザアカウントを変更する場合

mngsvrctl setup -u admin01 -p p1574809 -nu admin02 -np passwd123

入力例6

管理ユーザパスワードを解除する場合

mngsvrctl setup localhost -u admin01 -p p1574809 -np ""

入力例7

管理ユーザアカウントを対話形式に設定する場合

mngsvrctl setup -interactive

注意事項

OS共通の注意事項

論理J2EEサーバの実サーバ名と，Management Serverの名称（J2EEサーバのサーバ名称）を同じ名称で使用することはできません。

同じ名称を使用すると次の問題が発生します。

論理J2EEサーバの実サーバ名を，Management Serverの名称と同じ名称でセットアップした場合，論理J2EEサーバのセットアップに失敗します。

Management Serverの名称を，すでに存在する論理J2EEサーバの実サーバ名と同じ名称でセットアップした場合，Management Serverのセットアップに失敗します。

運用管理エージェントやManagement Serverの起動に続けて，運用管理コマンドまたはSmart ComposerなどでManagement Serverにアクセスする場合，同期実行を有効にしてください。

Management Serverをセットアップする場合の注意事項を次に示します。

管理ユーザアカウントの省略機能を有効にしてこのコマンドを実行した場合，共通引数の-uオプション，-pオプション，-nuオプション，および-npオプションの設定は無効になります。このときメッセージが出力され，セットアップ処理は続行されます。

管理ユーザアカウントの省略機能を無効にして管理ユーザIDが設定されていない状態で-nuオプションを指定したコマンドを実行すると，-uオプションの指定は無視されて，-nuオプションで指定した管理ユーザIDが設定されます。また，管理ユーザアカウントの省略機能を無効にして管理ユーザパスワードが設定されていない状態で-npオプションを指定したコマンドを実行すると，-pオプションの指定は無視されて，-npオプションで指定した管理ユーザパスワードが設定されます。

Component Containerは，インストール時にホスト名でJ2EEサーバをセットアップしているため，Management Serverのサーバ名をホスト名でセットアップしないでください。

Management Serverのセットアップでサーバ名を変更する場合は，Management Serverが停止していることを確認してから，mngsvrctlコマンドを実行してください。

UNIXの場合の注意事項

Management Serverで稼働するプロセスがバージョンによって異なります。08-70以前ではmngsvrctlプロセスおよびcjstartwebプロセス，09-00以降ではcjstartsvプロセスが稼働します。

Management Serverを起動する前に，umask 022を設定してください。

コマンドからManagement Serverを起動した場合，umaskに影響されるファイルは，それぞれ次のownerおよびgroupで作成します。

AIXの場合

root/system

Linuxの場合

root/root

umaskに影響されるファイルを次に示します。

構成情報の退避／回復画面で退避した構成情報ファイル（ユーザ任意）

J2EEアプリケーションまたはリソースのインポート時に作成されるJ2EEアプリケーションファイル（EARファイル），またはリソース情報ファイル（mapps_<論理サーバ名>_<内部ID>）

登録されたJ2EEアプリケーション（<アプリケーション表示名>_<登録時刻>）

ssogenkeyコマンド実行時またはリポジトリ管理で暗号鍵ファイルの設定時に作成される暗号化／復号化用の鍵ファイル（ユーザ任意）

J2EEサーバ，またはバッチサーバへの設定情報の配布時に作成される運用監視エージェントの設定ファイル（mngagent.<論理サーバ名>.properties）

snapshotログ収集の直前に作成されるsnapshotログ機能で設定されている環境変数の格納ファイル（envinfo.txt）

J2EEサーバ，またはバッチサーバへの設定情報の配布時に作成されるJ2EEサーバ，またはバッチサーバのユーザ定義ファイルのバックアップファイル（usrconf.cfg.bak）

J2EEサーバ，またはバッチサーバへの設定情報の配布時に作成されるJ2EEサーバ，またはバッチサーバのユーザ定義ファイルのバックアップファイル（usrconf.properties.bak）

Management Serverを起動する場合，ロケールを日本語に設定してから実行してください。

kshを使用している環境でロケールを日本語に設定する場合の例を次に示します。

AIXの場合の設定例

export LANG=Ja_JPまたはexport LANG=ja_JP

Linuxの場合の設定例

export LANG=ja_JP.utf8

Windowsの場合の注意事項

Management Serverをセットアップする場合の注意事項を次に示します。

管理ユーザアカウントの省略機能を有効にしてこのコマンドを実行した場合，共通引数の-interactiveオプションの設定は無効になります。コマンドプロンプトでは，管理ユーザIDおよびパスワードを入力するように対話形式で促されますが，入力しても設定は無効になります。このときメッセージが出力され，セットアップ処理は続行されます。

mngsvrupdate（Management Serverの移行コマンド）

形式

mngsvrupdate [-t <ターゲット名称>][-k <ターゲット種別>]
             [<サブコマンド> [<引数>]]

機能

Component Containerのバージョンアップに合わせて，Management Serverで管理する情報を最新のバージョンで使用する形式に移行します。

このコマンドは，Management Serverが動作するホストで実行してください。

なお，移行手順については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「10.　旧バージョンのアプリケーションサーバからの移行（J2EEサーバモードの場合）」を参照してください。

引数

-t <ターゲット名称>

サブコマンドの対象となるターゲット名称（論理サーバ名またはホスト名）を指定します。

運用管理ポータルの「論理サーバの構成定義」の定義に従います。

省略した場合，すべてのホストのすべての論理サーバが指定されます。

-k <ターゲット種別>

サブコマンドの対象となるターゲットの種別を指定します。次のどちらかを指定します。

logicalServer：論理サーバ

host：ホスト

省略した場合，または上記以外の値を指定した場合は，logicalServerが設定されます。

<サブコマンド> <引数>

指定しない場合はUsageが表示されます。

指定できるサブコマンドと引数について説明します。

d2r [<データソースの表示名> [<リソースアダプタの表示名>]]

Management Serverで管理するデータソースの情報をリソースアダプタに移行します。移行する対象は，<ターゲット名称>および<ターゲット種別>で指定します。

引数に<データソースの表示名>を指定した場合

指定したデータソースだけが移行されます。この引数を指定した場合，<ターゲット名称>に論理サーバ名を指定する必要があります。また，この引数を省略した場合，該当する論理サーバにインポートされたすべてのデータソースが移行対象となります。

引数に<リソースアダプタの表示名>を指定した場合

移行後のデータソースの表示名は，この引数で指定した値になります。ただし，すでに存在するリソースアダプタが指定された場合は移行されません。また，この引数を省略した場合，データソースの表示名がリソースアダプタの表示名になります。

移行処理では，次のファイルを編集します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥mmodel.xml

UNIXの場合

/opt/Cosminexus/manager/config/mmodel.xml

なお，mmodel.xmlはmmodel.xml.bakにバックアップしますが，すでにmmodel.xml.bakが存在する場合は上書きされます。

入力例

入力例1

運用管理ドメイン内のすべてのホストを一括して移行する場合

mngsvrupdate d2r

入力例2

ホストを指定して移行する場合

mngsvrupdate -t hostA -k host d2r

入力例3

論理サーバを指定して移行する場合

mngsvrupdate -t MyServer d2r ds ds1

注意事項

このコマンドは，Management Serverが停止していることを確認してから実行してください。Management Serverの起動中に実行すると，変更が反映されない場合があります。

移行コマンドを同時に実行すると正しく環境が移行されないことがあります。コマンドは同時に実行しないでください。

移行コマンドを実行する前に，次のファイルをほかの場所に退避してください。

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥mmodel.xml

UNIXの場合

/opt/Cosminexus/manager/config/mmodel.xml

mngsvrutil（Management Serverの運用管理コマンド）

形式

mngsvrutil [-m <ホスト名> [:<ポート番号>]
           {[-u <管理ユーザID>] [-p <管理ユーザパスワード>] | -interactive}
           [[-o <ファイル名>] [-h] [-f <出力形式>]
           [-t <ターゲット名称>] [-k <ターゲット種別>]
           [-s] [-i <監視時間間隔>] [-l <最大監視時間>]
           [-w < 稼働確認待ち時間>] <サブコマンド> <引数>]]

機能

Management Serverに接続して，運用管理ドメインについての操作ができます。また，JP1/Cm2/ESAなどのSNMPエージェント製品を使用して，mngsvrutilコマンドの出力結果をMIBに変換すると，SNMP Manager製品と連携できます。

このコマンドでは，次の機能を使用できます。

運用管理ドメインの構成情報の取得

運用管理ドメインの名称，および運用管理ドメインを構成する論理サーバの一覧を取得して，表示します。

論理サーバのステータス情報の取得

運用管理ドメインを構成する論理サーバの一覧に，ステータス（稼働しているかどうか）情報を付加して表示します。

論理サーバにデプロイされているJ2EEアプリケーションの情報の取得

J2EEアプリケーションの一覧を取得して，表示します。

論理サーバの性能情報の取得，および統計情報についての設定

論理サーバの性能情報（JavaVM，トランザクション，HTTPサーバ，HTTPサーバコネクタなど）を取得します。また，統計情報のサンプリング時間を設定します。

論理サーバの起動または停止

論理サーバを起動または停止します。

論理サーバの設定ファイルの再読み込み

論理サーバを再起動しないで，論理サーバで使用する設定ファイルを再読み込みします。また，論理J2EEサーバで，接続先ホストの設定ファイルを再読み込みすることもできます。

論理サーバの追加・削除

論理サーバを追加または削除します。

論理サーバのアプリケーション管理

J2EEアプリケーション／J2EEリソースの開始／停止および一覧表示をします。アプリケーション管理の動作については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「12.　論理サーバのアプリケーション管理」を参照してください。

性能解析トレースの収集

論理パフォーマンストレーサから性能解析トレースを収集します。

CTMキューの閉塞／閉塞解除

CTMのスケジュールキューの閉塞，および閉塞の解除をします。

CTM稼働統計情報の収集

CTMから稼働統計情報を収集します。

同時実行スレッド数の動的変更

Webアプリケーションの同時実行スレッド数を動的に変更します。

このコマンドの-pオプションにパスワードを指定した場合，プロセスの引数を確認できるOS機能などでパスワードが観測されるおそれがあります。このため，-interactiveオプションによる対話形式でのパスワードの設定を推奨します。

引数

-m <ホスト名>［:<ポート番号>］

Management Serverのホスト名とポート番号を指定します。

<ホスト名>

ドット記法でのIPアドレス指定（xxx.xxx.xxx.xxx），または名前解決できるホスト名で指定します。なお，xxxには0〜255の整数を指定します。

<ポート番号>

Management Serverの設定に従います。デフォルト値は28080です。

-u <管理ユーザID>

mngsvrctl setupコマンドまたは運用管理ポータルの「管理ユーザアカウントの設定」で設定した管理ユーザIDを指定します。

運用管理ポータルの「管理ユーザアカウントの設定」で入力できる文字に従います。

管理ユーザアカウントの省略機能が有効の場合，管理ユーザIDを指定しても無効となります。管理ユーザアカウントの省略機能については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.15(3)　管理ユーザアカウントを設定しない場合の設定」を参照してください。

-p <管理ユーザパスワード>

mngsvrctl setupコマンドまたは運用管理ポータルの「管理ユーザアカウントの設定」で設定した管理ユーザIDに対応する管理ユーザパスワードを指定します。

運用管理ポータルの「管理ユーザアカウントの設定」で入力できる文字に従います。

なお，パスワードを設定していない場合，-pオプションを指定する必要はありません。

管理ユーザアカウントの省略機能が有効の場合，管理ユーザパスワードを指定しても無効となります。管理ユーザアカウントの省略機能については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.15(3)　管理ユーザアカウントを設定しない場合の設定」を参照してください。

-interactive

管理ユーザIDと管理ユーザパスワードを対話形式で入力する場合に指定します。対話形式で入力した場合，.mngsvrutilrcファイルまたはmngsvrutilcl.propertiesファイルに指定した，管理ユーザIDおよび管理ユーザパスワードは無視されます。

管理ユーザアカウントの省略機能有効時には，対話形式で入力した管理ユーザIDおよび管理ユーザパスワードは有効になりません。

このオプションを指定する場合は，-uオプションまたは-pオプションは指定できません。-uオプションまたは-pオプションを指定した場合，KEOS16118-Eメッセージが出力され処理を終了します。

このオプションを指定してコマンドを実行すると，次のプロンプトが表示され，管理ユーザIDの入力を待つ状態になります。

> User ID:

管理ユーザIDを入力すると，次のプロンプトが表示され，管理ユーザパスワードの入力を待つ状態になります。

> Password:

コマンドプロンプトやコンソールなどから直接実行した場合，パスワードをエコーバックしません。ほかのプログラムから間接的に実行した場合は，パスワードをエコーバックすることがあります。

-o <ファイル名>

出力先のファイル名を指定します。指定されたファイルに上書き出力します。なお，指定できるファイル名は，コマンドを実行するOSに依存します。また，省略した場合，標準出力に出力します。

-h

ヘッダを出力しない場合に指定します。

-f <出力形式>

接続するManagement Serverで提供している出力形式を指定します。Management Serverでは，次に示す出力形式を提供しています。

csv：CSV形式（デフォルト値）

snmp：SNMP連携用形式

-t <ターゲット名称>

サブコマンドの対象となるターゲット名称（論理サーバ名またはホスト名）を指定します。

運用管理ポータルの「論理サーバの構成定義」の定義に従います。

-k <ターゲット種別>

サブコマンドの対象となるターゲットの種別を指定します。次のどちらかを指定します。

logicalServer：論理サーバ

host：ホスト

省略した場合，または上記以外の値を指定した場合は，logicalServerが設定されます。

-s

論理サーバやJ2EEアプリケーションの起動または停止の完了を待つ場合に指定します。

このオプションは，サブコマンドに"start"または"stop"を指定した場合に有効です。

なお，このオプションを指定した場合，起動／停止障害発生時，障害回復のためにサブコマンドのリトライ処理が実行されます。

-i <監視時間間隔>

論理サーバやJ2EEアプリケーションの起動・停止の完了を監視する際の監視時間間隔を，0〜2147483647の整数（単位：秒）で指定します。省略時のデフォルトは3秒です。

なお，このオプションは，起動／停止障害発生時のサブコマンドのリトライ処理間隔としても利用されます。

-l <最大監視時間>

論理サーバやJ2EEアプリケーションの起動・停止の完了を監視する際の最大監視時間を，0〜2147483647の整数（単位：秒）で指定します。

指定した値の時間を超えても論理サーバやJ2EEアプリケーションが起動・停止しない場合，コマンドは異常終了します。0を指定した場合は無限に待ちます。省略時のデフォルトは60秒です。

-w <稼働確認待ち時間>

Management Serverおよび運用管理エージェントが稼働しているかどうかを確認するための待ち時間を，0〜2147483の整数（単位：秒）で指定します。

指定した待ち時間を経過しても応答がない場合，コマンドは異常終了します。

0を指定した場合は無限に待ちます。なお，0より小さい値を指定した場合は0を，2147483より大きい値を指定した場合は2147483が仮定されます。省略時のデフォルトは0です。

このオプションは，checkサブコマンドを指定した場合だけに有効です。

<サブコマンド> <引数>

サブコマンドと引数を指定します。サブコマンドと引数に指定できる値は，Management Serverのバージョンに依存します。

サブコマンドでは，指定する引数によって，ターゲットに論理サーバまたはホストが指定できます。

次のサブコマンドが指定できます。

list

get

set

start

stop

reload

hold

release

collect

change

check

dump

add

delete

なお，サブコマンドの詳細は，「7.3　mngsvrutilコマンドのサブコマンドの詳細」を参照してください。

戻り値

0：

正常終了しました。

1：

実行時エラーが発生しました。

2：

シンタックスエラーが発生しました。

出力形式

CSV形式

名称，および値はコンマで区切って出力します。

-hオプションでヘッダの出力を抑止できます。

SNMP連携形式

値は半角スペース（0x20）で区切って出力します。また，文字列はダブルクォーテーション（0x22）で囲んで出力します。

なお，文字列にダブルクォーテーション（0x22）とバックスラッシュ「¥」（0x5c）が含まれていた場合，エスケープコード（バックスラッシュ「¥」（0x5c））を付加します。

（例）

編集前文字列：　”abc” def¥ g

編集後文字列：　”¥”abc¥” def¥¥ g”

整数値は32bit整数型で表します。また，浮動小数点数は小数点以下を切り捨てて32bit整数型で表します。

ヘッダは出力されません。

設定ファイル

クライアント側定義ファイル（.mngsvrutilrc）

mngsvrutilコマンドのオプションのデフォルト値を設定できます。

詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.14　.mngsvrutilrc（mngsvrutilコマンドのクライアント側定義ファイル）」を参照してください。

mngsvrutilrcのパラメタであるmngsvrutil.target_kind，mngsvrutil.target_name，mngsvrutil.target_server_nameプロパティと"-k"，"-t"オプションとの組み合わせの時に有効となる値を次の表に示します。

項番

target_kind

target_name

target_server_name

-k

-t

指定値の解釈

1

logicalServer/−

−

−

logicalServer/−

−

サーバ名が指定されていません。

2

logicalServer/−

A

B/−

logicalServer/−

−

“A”という名称のサーバが指定されました。

3

logicalServer/−

−

B

logicalServer/−

−

“B”という名称のサーバが指定されました。

4

logicalServer/−

A/−

B/−

logicalServer/−

C

“C”という名称のサーバが指定されました。

5

host

−

−

−

−

ホスト名が指定されていません。

6

host/−

−

−

host

−

ホスト名が指定されていません。

7

host

−

B

−

−

ホスト名が指定されていません。

8

host/−

−

B

host

−

ホスト名が指定されていません。

9

host

A

B/−

−

−

“A”という名称のホストが指定されました。

10

host/−

A/−

B/−

host

C

“C”という名称のホストが指定されました。

（凡例）

−：値を指定しません。

クライアント側共通定義ファイル（mngsvrutilcl.properties）

mngsvrutilコマンドのオプションの共通のデフォルト値を設定できます。

詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.16　mngsvrutilcl.properties（mngsvrutilコマンドのクライアント側共通定義ファイル）」を参照してください。

サーバ側定義ファイル（mngsvrutil.properties）

mngsvrutilコマンドの実行環境を変更できます。

詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.15　mngsvrutil.properties（mngsvrutilコマンドのサーバ側定義ファイル）」を参照してください。

入力例・出力例

入力例1

運用管理ドメイン内の論理サーバとステータス情報の一覧の取得

$ mngsvrutil -m 123.45.67.89:28880 -u admin1 -p pw1 list status

出力例1

logicalServerName,status,type,startingOrder,parent
smplSvrName1,working,NamingService,10,-
smplSvrName2,starting,SFOServer,15,-
smplSvrName3,stopped,J2EEServer,20,J2EEServerCluster1
smplSvrName4,starting,J2EEServer,30,J2EEServerCluster1
smplSvrName5,stopping,WebServer,40,WebServerCluster1
smplSvrName6,abnormal ended,J2EEServer,50,-
smplSvrName7,recovering,J2EEServer,60,-
smplSvrName8,communication error,J2EEServer,70,J2EEServerCluster2
・・・
・・・

入力例2

運用管理ドメイン名称の取得

$ mngsvrutil -m localhost -u admin1 -p pw1 get domainName

出力例2

smplDomainName

入力例3

J2EEアプリケーションについての情報の取得
$ mngsvrutil -m 123.45.67.89 -u admin2 -t myServer get j2eeApps

出力例3

index,fullyQualifiedName,name,deployedTime
1,serverName1:smplApp1,smplApp1,1234567890
2,serverName2:smplApp2,smplApp2,9876543210
・・・
・・・
7,serverName7:smplApp7_TEST,smplApp7,7656543210

入力例4

Stateless Session Beanのホームインタフェースについての情報の取得

$ mngsvrutil -m 123.45.67.89 -u admin2 -t myServer get statelessBeanHome

出力例4

index,fullyQualifiedName,name,responseMaxTime,responseMinTime,responseAveTime,statisticsStartedTime,samplingTime
1,smpQfn1,smplBeanName1,300,100,123.45,67339847,600
2,smpQfn2,smplBeanName2,17,52,34.251,122343838,10
・・・
・・・

入力例5

ホスト内のすべてのJ2EEアプリケーションに対応するスケジュールキューの閉塞

$ mngsvrutil -m 123.45.67.89 -u admin2 -t hostA -k host hold queues in:-1

入力例6

ホスト内のすべてのJ2EEアプリケーションに対応するスケジュールキューの閉塞解除

$ mngsvrutil -m 123.45.67.89 -u admin2 -t hostA -k host release queues

入力例7

運用管理ドメイン内のすべてのパフォーマンストレーサが収集した性能解析トレースの一括収集

$ mngsvrutil -m 123.45.67.89 -u admin2 collect allPrfTraces

SNMP連携時の設定手順（UNIXの場合）

UNIXの場合のSNMP連携時の設定手順を次に示します。

JP1/Cm2/ESAのインストール

~root/.mngsvrutilrcファイルの作成，編集

/opt/Cosminexus/manager/config/templates/.mngsvrutilrcファイルを~rootにコピーします。

# cp /opt/Cosminexus/manager/config/templates/.mngsvrutilrc ~root/

~root/.mngsvrutilrcファイルのファイルパーミッションを600に変更します。

# chmod 600 ~root/.mngsvrutilrc

~root/.mngsvrutilrcファイルを編集します。

適切なエディタを使用して，次の項目を設定します。各項目の詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.14　.mngsvrutilrc（mngsvrutilコマンドのクライアント側定義ファイル）」を参照してください。

mngsvrutil.connect.host

mngsvrutil.connect.userid

mngsvrutil.connect.password

mngsvrutil.output.format=snmp

mngsvrutil.target_name

mngsvrutil.target_kind

JP1/Cm2/ESAの環境設定

Application Serverの拡張MIBオブジェクト定義ファイル（/opt/Cosminexus/manager/config/ hitachi-cosmiMng-MIB※1，※2）を使用して，SNMPサブエージェントを再構成します。SNMPサブエージェントの再構成の方法については，マニュアル「JP1/Cm2/Extensible SNMP Agent」を参照してください。

注※1　実際は，hitachi-cosmiMng-MIBのあとに_V-R（バージョン）が付加されます（例：hitachi-cosmiMng-MIB_2-0）。

注※2　拡張MIBオブジェクト定義ファイルを使用する場合は，hitachi-cosmiMng-MIB_V-R_forESAを使用してください。

拡張MIBオブジェクト定義ファイルは最新のバージョンを使用してください。

注意事項

コマンドを入力する際，オプションおよびサブコマンドを次のように指定します。

オプションのサブコマンドおよび引数は，必ず最後尾に指定してください。

オプションを重複して指定した場合は，最後に指定したものを有効とします。

ある特定の操作に対して無意味なオプションを指定した場合（例えば，setサブコマンドで-hオプションを指定），そのオプションは無視されます。

オプションの指定が省略された場合，クライアント側定義ファイル（.mngsvrutilrc）にデフォルト値が設定されているときは，そのデフォルト値を有効にします。

すべてのオプションを省略した場合，Usage（Simple Usage）を表示します。また，-m，-u，および-pオプション以外の引数をすべて省略した場合，詳細なUsage（detailed usage）を表示します。

listまたはgetで取得した値が異常値（統計を取得していないときの統計値など）の場合，値は-1を0として表示します。

サブコマンドで取得した情報は標準出力に表示します。

Usageおよびエラー情報は標準エラー出力に表示します。

SNMP連携時の設定で，SNMP Managerが参照する拡張MIBオブジェクト定義ファイルのバージョンが，SNMP Agentが参照する拡張MIBオブジェクト定義ファイルのバージョンよりも新しい場合は，期待する結果が得られない場合があります。

このため，同じバージョンに合わせるか，SNMP Agentが参照する拡張MIBオブジェクト定義ファイルのバージョンを，SNMP Managerが参照する拡張MIBオブジェクト定義ファイルのバージョンより新しくする必要があります。

同一論理サーバに対して，startの直後にstopを実行したり，stopの直後にstartを実行したりする場合は，先に実行するサブコマンドに-sオプションを指定し，そのサブコマンドが完了したあとに次のサブコマンドを実行してください。

listで取得されるステータスは，list以外のサブコマンド（start，stopなど）の処理の実行状態に関係なく，呼び出し時点での情報が返されます。そのため，startによる起動処理が完了する前に"working"のステータスを返したり，stopによる停止処理が完了する前に"stopped"のステータスを返したりすることがあります。

mngunsetup（Management Serverの構築環境の削除）

形式

mngunsetup [-force]

機能

このコマンドを実行したホスト内にある，Management Serverおよび運用管理エージェントのアンセットアップ，ならびにManagement Serverを使用して構築したシステム環境（論理サーバ）のアンセットアップを実行します。このコマンドは，Management Serverおよび運用管理エージェントが稼働しているかどうかに関係なく実行できます。

このコマンドは，ホスト単位モデルの場合はアプリケーションサーバ，運用管理サーバモデルの場合は，運用管理サーバ（Management Serverが動作するホスト）およびアプリケーションサーバで実行します。

このコマンドは，管理者権限のあるユーザ，またはManagement Server管理グループのユーザが実行してください。

また，アンセットアップする環境が次の条件に当てはまる場合に，コマンドを実行すると失敗することがあります。それぞれの対処を実施してから，コマンドを実行してください。

Management Serverを使用しないで起動されたCTMおよびOTM（TPBroker Object Transaction Monitor）のプロセスと実行中のコマンドがある場合

CTMおよびOTM（TPBroker Object Transaction Monitor）のプロセスと実行中のコマンドをすべて停止してください。

UNIXで，運用管理エージェントおよびManagement Serverで自動再起動を設定している場合

mngautorunコマンドを実行し，自動再起動の設定を解除してから再起動してください。

引数

引数の指定がない場合，アンセットアップを実行するかどうかを確認するメッセージを出力します。yが選択されるとアンセットアップを実行し，nが選択されるとアンセットアップを中止して終了します。

-force

アンセットアップを実行するかどうかを確認するメッセージを出力しないで，強制的にアンセットアップを実行します。

入力例

mngunsetupを実行します。

mngunsetup

アンセットアップを実行するかどうかを確認するメッセージが出力されます。

Windowsの場合

本当に次の環境をアンセットアップしますか？
・運用管理機能（Management Serverおよび運用管理エージェント）
・システム環境（論理サーバ）
{y|n}
>

UNIXの場合

本当に次の環境をアンセットアップしますか？
・運用管理機能（Management Serverおよび運用管理エージェント）
・システム環境（論理サーバ）
・J2EEサーバの起動ユーザの設定（Component Container管理者）
{y|n}
>

アンセットアップを実行する場合はyを，アンセットアップを中止する場合はnを入力します。

戻り値

0：

正常終了しました。

1：

実行時エラーが発生しました。

2：

シンタックスエラーが発生しました。

注意事項

負荷分散機，サーバ通信エージェント，およびManagement Serverが管理している構成情報や設定情報以外のファイルはアンセットアップされません。手動で削除してください。

09-00より前に構築した環境でアンセットアップを実行すると，論理サーバ（論理J2EEサーバ，および論理Webサーバ）を削除できないことがあります。これらの論理サーバは09-00に移行したあとに一度起動された場合にだけ削除できます。ただし，セットアップ時に指定していた環境変数が保持されていないため，環境変数を設定しないでアンセットアップを実行すると，削除に失敗することがあります。一度も起動されていない論理サーバは，コマンドを使用して手動で削除してください。

論理J2EEサーバの削除

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥bin¥cjsetup -d <実サーバ名>

UNIXの場合

/opt/Cosminexus/CC/server/bin/cjsetup -d <実サーバ名>

論理Webサーバの削除

Windowsの場合

<Application Serverのインストールディレクトリ>¥httpsd¥admin¥bin¥hwsserveredit -delete HWS_<実サーバ名>

UNIXの場合

/opt/hitachi/httpsd/admin/bin/hwsserveredit -delete HWS_<実サーバ名>

09-50より前に構築した環境でManagement Serverの実サーバ名を変更している場合は，アンセットアップを実行しても，変更前の実サーバ名で設定されたManagement Serverの環境は削除されません。コマンドを使用して手動で削除してください。

変更前の実サーバ名で設定されたManagement Serverの環境の削除

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥bin¥cjsetup -d <実サーバ名>

UNIXの場合

/opt/Cosminexus/CC/server/bin/cjsetup -d <実サーバ名>

UNIXの場合，Management Serverおよび運用管理エージェントに自動再起動が設定されているときは，mngautorunコマンドで自動再起動設定を解除し，マシンを再起動したあと，このコマンドを実行してください。自動再起動の設定解除とマシンの再起動を実施しないと，アンセットアップ時にエラーが発生することがあります。

論理J2EEサーバ，および論理Webサーバの場合，Management Serverを使用して構築された論理サーバが削除対象となります。このため，事前に運用管理ポータルやSmart Composer機能を使用して論理サーバを削除していた場合も，実サーバの削除が実行されます。

論理CTMドメインマネジャの場合，Management Serverを使用して起動された論理CTMドメインマネジャのCTMドメイン情報が削除対象となります。このため，事前に運用管理ポータルやSmart Composer機能を使用して論理CTMドメインマネジャを削除していた場合も，CTMドメイン情報の削除が実行されます。

CTMドメインマネジャの場合，次の点にも注意してください。

Management Serverを使用しないで起動されたCTMドメインマネジャのCTMドメイン情報も削除されます。

コマンドを実行するホストにOTM（TPBroker Object Transaction Monitor）の環境がある場合は，TSCドメインに関する情報も削除されます。

Management Serverを使用しないで起動されたCTMおよびOTMのプロセス，およびこれらのプロセスで実行中のコマンドがある場合は，プロセスやコマンドで予期しないエラーが発生することがあります。このため，CTMおよびOTMのプロセス，およびこれらのプロセスで実行中のコマンドをすべて停止してからこのコマンドを実行してください。

UNIXの場合，Management Server管理グループの設定は解除されません。Management Server管理グループの設定を解除したい場合は，mngenvsetupコマンドを実行してください。mngenvsetupコマンドについては，「mngenvsetup（管理グループの設定）」を参照してください。

mstrexport（Management Server管理ファイルの退避）

形式

mstrexport <ファイル名> [<退避対象定義ファイル名>]

機能

運用管理サーバの実行系と待機系を1:1にして系切り替えをする場合，実行系の運用管理サーバのManagement Server管理ファイルを収集してZIP形式ファイルに出力し，退避します。

引数

オプションの指定がない場合，コマンドの使用方法が表示されます。

<ファイル名>

Management Server管理ファイルを退避する時に出力するZIPファイル名を指定します。絶対パス，相対パスで指定できます。拡張子を「.zip（大文字，または小文字）」にしなかった場合は，「.zip」を付加します。

<退避対象定義ファイル名>

Management Server管理ファイル用退避対象定義ファイル名を絶対パス，または相対パスで指定します。

Management Server管理ファイル用退避対象定義ファイルは，デフォルトで退避対象となっているファイルのほかに収集したいファイルがある場合に指定します。詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.13　Management Server管理ファイル用退避対象定義ファイル」を参照してください。

入力例

入力例1

カレントディレクトリにManagement Server管理ファイルを収集したmstruct.zipを出力する場合

mstrexport mstruct.zip

入力例2

カレントディレクトリ以外のディレクトリに，デフォルトで収集されるファイルに加えてfilelist.txtに記述されたファイルを収集したmstruct.zipを出力する場合

Windowsの場合

mstrexport c:/tmp/mstruct.zip "c:/Documents and Settings/MyUser/filelist.txt"

UNIXの場合

mstrexport /tmp/mstruct.zip "/usr/filelist.txt"

注意事項

mstrexportコマンドで退避したファイルのアクセス権は，デフォルトのアクセス権となります。そのため，一般ユーザの読み取りを許可しないなど，アクセス制限を設ける必要のあるファイルは退避対象に含めないでください。

mstrimport（Management Server管理ファイルの回復）

形式

mstrimport <ファイル名>

機能

運用管理サーバの実行系と待機系を1:1にして系切り替えをする場合に，mstrexportコマンドで退避した実行系の運用管理サーバの管理ファイル（ZIP形式）を待機系の運用管理サーバで回復します。

回復に成功したファイルのパス名は，システムプロパティを含んだ形式で標準出力に出力されます。

このコマンドはManagement Serverが停止している場合に実行できます。

引数

オプションの指定がない場合，コマンドの使用方法が表示されます。

<ファイル名>

Management Server管理ファイルの退避コマンドで退避したManagement Server管理ファイル名（ZIP形式）を指定します。絶対パス，または相対パスで指定できます。

Management Server管理ファイルの退避コマンドで退避していないファイルを指定した場合や，ファイルが展開できない場合はエラーになります。エラーが発生した場合は，処理が中断されます。

入力例

入力例1

カレントディレクトリのmstruct.zipの内容を展開する場合

mstrimport mstruct.zip

入力例2

カレントディレクトリ以外にあるmstruct.zipの内容を展開する場合

Windowsの場合

mstrimport c:/tmp/mstruct.zip

UNIXの場合

mstrimport /tmp/mstruct.zip

注意事項

mstrimportコマンドは既存のファイルを上書きします。そのため，コマンド実行前にファイルのバックアップを取得することをお勧めします。バックアップを取得するには，mstrexportコマンドを使用します。待機系でmstrimportコマンドを実行したときに上書き対象となるファイルをすべて退避するには，待機系で実行するmstrexportコマンドの引数に，実行系で実行したmstrexportコマンドに指定した退避対象定義ファイルを指定します。なお，実行系でのmstrexportコマンド実行時に退避対象定義ファイルを指定している場合は，待機系でのmstrexportコマンド実行時にも退避対象定義ファイルを指定してください。このとき指定する退避対象定義ファイルは，実行系のバックアップ時に指定した退避対象定義ファイルと同じファイルを指定します。

また，UNIXの場合，mstrimportコマンドで回復したファイルには，実行権限が付きません。必要に応じて実行権限を付与してください。

setupwizardコマンド（システムのセットアップ，アンセットアップと複製）

形式

セットアップウィザードの起動

setupwizard

セットアップ情報ファイルを使用した一括セットアップ

setupwizard -f <セットアップ情報ファイル> [-force]

簡易構築定義ファイルのエクスポート

setupwizard -export -omd <簡易構築定義ファイル>

システムの複製

setupwizard -f <セットアップ情報ファイル> -md <簡易構築定義ファイル> [-force]

アンセットアップ

setupwizard -clean [-force]

セットアップ情報ファイルの内容表示

setupwizard -view -f <セットアップ情報ファイル>

コマンドの使用方法の表示

setupwizard -h｜-help

機能

セットアップウィザードの起動

セットアップウィザードを起動します。

セットアップ情報ファイルを使用した一括セットアップ

-fオプションに指定したセットアップ情報ファイルの情報に従って，一括セットアップをします。-forceオプションを指定すると，セットアップ情報ファイルの内容を確認しないで一括セットアップをします。

簡易構築定義ファイルのエクスポート

簡易構築定義ファイルをエクスポートします。-omdオプションには，簡易構築定義ファイルの出力先とファイル名を指定します。エクスポートした簡易構築定義ファイルは，システムの複製時の入力ファイルとなります。

システムの複製

次のファイルの情報に従って，システムを複製します。

-fオプションに指定したセットアップ情報ファイル

-mdオプションに指定した簡易構築定義ファイル

-forceオプションを指定すると，セットアップ情報ファイルの内容を確認しないで，システムを複製します。

なお，次の情報は，セットアップ情報ファイルの内容ではなく，簡易構築定義ファイルの内容に従います。

Webシステムの設定

JDBCドライバの設定（データベースの設定を「する」を選択している場合）

アンセットアップ

セットアップウィザードでセットアップ，またはセットアップウィザード以外で構築したシステムのアンセットアップをします。-forceオプションを指定すると，アンセットアップをするかどうか確認しないでアンセットアップをします。

セットアップ情報ファイルの内容表示

-fオプションに指定したセットアップ情報ファイルの内容を表示します。

コマンドの使用方法の表示

setupwizardコマンドの使用方法を表示します。

引数

-f <セットアップ情報ファイル>

セットアップ情報ファイルのパスを指定します。

-export

簡易構築定義ファイルをエクスポートする場合に指定します。

-omd <簡易構築定義ファイル>

エクスポートする簡易構築定義ファイルのパスを指定します。

-md <簡易構築定義ファイル>

システムの複製で使用する簡易構築定義ファイルのパスを指定します。

-clean

システムのアンセットアップをする場合に指定します。

-force

次の操作を処理の実施確認をしないで実施するときに指定します。

セットアップ情報ファイルを使用した一括セットアップ

アンセットアップ

システムの複製

-view

セットアップ情報ファイルの内容を表示する場合に指定します。

-h｜-help

setupwizardコマンドの使用方法を表示する場合に指定します。

入力例

入力例1

セットアップウィザードを起動する場合

setupwizard

入力例2

セットアップ情報ファイルを使用して一括セットアップする場合

setupwizard -f <Application Serverのインストールディレクトリ>/manager/setup/config/setupwizard.dat -force

入力例3

簡易構築定義ファイルをエクスポートする場合

setupwizard -export -omd <任意のディレクトリ>/<簡易構築定義ファイルのファイル名>

入力例4

システムを複製する場合

setupwizard -f <Application Serverのインストールディレクトリ>/manager/setup/config/setupwizard_success.dat -md <任意のディレクトリ>/<簡易構築定義ファイルのファイル名>

入力例5

実施確認をしないアンセットアップする場合

setupwizard -clean -force

入力例6

セットアップ情報ファイルの内容を表示する場合

setupwizard -view -f <Application Serverのインストールディレクトリ>/manager/setup/config/setupwizard.dat

入力例7

コマンドの使用方法を表示する場合

setupwizard -h

戻り値

0：

正常終了しました。

1：

実行時エラーが発生しました。

2：

シンタックスエラーが発生しました。

注意事項

コマンドを実行できるユーザは次のとおりです。次に示すユーザ以外がコマンドを実行した場合，エラーとなります。

Windowsの場合

管理者特権でコマンドを実行してください。それ以外のWindowsのOSのときは，Administrator権限のあるユーザがコマンドを実行できます。

UNIXの場合

root権限のあるユーザがコマンドを実行できます。

セットアップ情報ファイルを使用した一括セットアップで-forceオプションを指定して，セットアップに失敗すると，障害に対処するための資料として，snapshotログが自動的に収集されます。

snapshotログの格納先と収集内容を次に示します。

snapshotログの格納先

<セットアップウィザードのログの出力先>/snapshot.zip

snapshotログの収集内容

<Application Serverのインストールディレクトリ>/manager/config/snapshotlog.confで示す範囲

<セットアップウィザードのログの出力先>/setupwizard<ファイル面数>.log

<セットアップウィザードのログの出力先>/maintenance/setupwizard<ファイル面数>.log

<Application Serverのインストールディレクトリ>/manager/setup/config/

<Application Serverのインストールディレクトリ>/manager/setup/tmp/

<セットアップウィザードのログの出力先>は，setup.cfgのsetup.log.dirで指定した出力先です。setup.cfgについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「8.2.18　setup.cfg（セットアップウィザード用設定ファイル）」を参照してください。

-mdオプションに指定する簡易構築定義ファイルは，-exportオプションでエクスポートした簡易構築定義ファイルを指定してください。ほかの簡易構築定義ファイルを指定すると，システムの複製に失敗することがあります。

-exportオプションを指定してコマンドを実行する場合は，Management Serverが起動している必要があります。Management Serverが起動していない場合，コマンドの実行に失敗します。

次の環境で-cleanオプションを指定してコマンドを実行すると，KEOS28058-Iメッセージが出力され，コマンドは終了コード0で終了します。

セットアップを実行していない環境

一度-cleanオプションを指定したコマンド（アンセットアップ）を実行した環境

Management Serverをセットアップしていない環境

コマンドを実行している間は，Ctrl+Cキーなどで外部から停止しないでください。停止した場合は再度セットアップウィザードを実行してください。再度セットアップウィザードを実行してもエラーが発生する場合は，OSを再起動してください。

7.3　mngsvrutilコマンドのサブコマンドの詳細

ここでは，mngsvrutilコマンドの引数として指定できる，サブコマンドについて説明します。

7.3.1　list

引数に指定された値のリストを表示します。次の引数を指定できます。

表7‒2　サブコマンドlistに指定できる引数

引数

説明

ターゲット指定

論理サーバ

ホスト

status

運用管理ドメイン内の論理サーバ名とステータス情報を列挙します。

−

−

appStatus

"-t"オプションで指定された論理サーバにインポートされているJ2EEアプリケーション名とステータス情報を列挙します。

○

−

resStatus

"-t"オプションで指定された論理サーバにインポートされているJ2EEリソース名とステータス情報を列挙します。

○

−

resJavaBeansStatus

"-t"オプションで指定された論理サーバにインポートされているJavaBeansリソース名とステータス情報を列挙します。

○

−

queues

"-t"オプションで指定されたCTM，またはホストに属するキュー名とステータス情報を列挙します。

○

○

（凡例）

○：指定できます。

−：指定できません。

listでは，次の5種類の情報を表示できます。

引数に"status"を指定して，運用管理ドメイン内の論理サーバとそのステータス情報を表示します。

出力情報のヘッダ部のtypeは論理サーバの種類（Webサーバ，J2EEサーバ，ネーミングサービス，スマートエージェント，パフォーマンストレーサ，CTMドメインマネジャ，およびCTM），startingOrderは論理サーバの起動順序，parentは論理サーバが属するクラスタ名を表します。起動順序を設定していない場合，startingOrderにはデフォルト値が表示され，起動順序情報を取得できない場合は「−」が表示されます。デフォルト値については，マニュアル「アプリケーションサーバ運用管理ポータル操作ガイド」の「11.3.5　運用管理ドメイン全体の論理サーバの起動順序の設定」を参照してください。クラスタに属さない単体の論理サーバの場合，Parentには「−」が表示されます。

statusの種類は，working（稼働中），stopped（停止），starting（起動中），stopping（停止中），abnormal ended（異常停止），recovering（回復中），communication error（通信障害），auto stopping（自動停止中），auto restarting（自動再起動中），graceful stopping（計画停止中），またはforce stopping（強制停止中）のどれかです。論理サーバのステータスの詳細については，マニュアル「アプリケーションサーバ運用管理ポータル操作ガイド」の「4.4　論理サーバの運用監視」を参照してください。このサブコマンドでは，クラスタに属している論理サーバと単体の論理サーバだけを表示します。

引数に"appStatus"を指定して，J2EEサーバにインポートされているJ2EEアプリケーションの情報の一覧を表示します。

"-t"オプションで指定されたJ2EEサーバにインポートされているJ2EEアプリケーションの情報を一覧表示します。

J2EEサーバクラスタが指定された場合，メンバに処理を展開します。"-t"オプションにJ2EEサーバ（J2EEサーバクラスタのメンバも含む）またはJ2EEサーバクラスタ以外の論理サーバが指定された場合はエラーになります。

出力情報のヘッダ部のlogicalServerNameには，"-t"オプションで指定したJ2EEサーバ名が表示されます。

出力情報のヘッダ部のappNameには，J2EEサーバにインポートされているアプリケーションの表示名が表示されます。なお，J2EEサーバが起動していない場合は，空文字（""）が表示されます。J2EEサーバが起動していて，インポートされたアプリケーションがない場合は，レコードを出力しません。

statusの種類は，working（稼働中），stopped（停止），またはunknown（J2EEサーバが起動していない，もしくはJ2EEサーバで管理されていない）のどれかです。

引数に"resStatus"を指定して，J2EEサーバ，またはバッチサーバにインポートされているJ2EEリソースの情報の一覧を表示します。

"-t"オプションで指定されたJ2EEサーバ，またはバッチサーバにインポートされているJ2EEリソースの情報を一覧表示します。

J2EEサーバクラスタが指定された場合，メンバに処理を展開します。"-t"オプションにJ2EEサーバ（J2EEサーバクラスタのメンバも含む），バッチサーバまたはJ2EEサーバクラスタ以外の論理サーバが指定された場合はエラーになります。

出力情報のヘッダ部のlogicalServerNameには，"-t"オプションで指定したJ2EEサーバ名，またはバッチサーバ名が表示されます。

出力情報のヘッダ部のresourceNameには，J2EEサーバにインポートされているリソースアダプタの表示名が表示されます。なお，J2EEサーバが起動していない場合は，空文字（""）が表示されます。

statusの種類は，working（稼働中），stopped（停止），またはunknown（J2EEサーバが起動していない，もしくはJ2EEサーバで管理されていない）のどれかです。

引数に"resJavaBeansStatus"を指定して，J2EEサーバ，またはバッチサーバにインポートされているJavaBeansリソースの情報の一覧を表示します。

"-t"オプションで指定されたJ2EEサーバ，またはバッチサーバにインポートされているJavaBeansリソースの情報を一覧表示します。

J2EEサーバクラスタが指定された場合，メンバに処理を展開します。"-t"オプションにJ2EEサーバ（J2EEサーバクラスタのメンバも含む），バッチサーバまたはJ2EEサーバクラスタ以外の論理サーバが指定された場合はエラーになります。

出力情報のヘッダ部のlogicalServerNameには，"-t"オプションで指定したJ2EEサーバ名，またはバッチサーバ名が表示されます。

出力情報のヘッダ部のJavaBeansResourceNameには，J2EEサーバにインポートされているJavaBeansリソースの表示名が表示されます。J2EEサーバが起動していない場合は，空文字（""）が表示されます。

statusの種類は，working（稼働中），stopped（停止），またはunknown（J2EEサーバが起動していない，もしくはJ2EEサーバで管理されていない）のどれかです。

引数に"queues"を指定して，CTMのキューの情報を表示します。

"-t"オプションで指定されたCTM，またはホストに所属するキューの情報を一覧表示します。

ヘッダ部のlogicalServerNameにはCTM名称が表示されます。queueNameにはキュー名称が表示されます。

statusの種類は，scheduling（スケジューリングが可能な状態），preparing（キュー準備中），stopping（キュー終了処理中），closing[in]（キュー入り口閉塞中），またはclosing[out]（キュー出口閉塞中）のどれかです。

7.3.2　get

"-t"オプションで指定された論理サーバまたはホストについて，引数に指定された値を取得します。表7-3に示す引数を指定できます。なお，domainName以外の引数を，<metric category>といいます。

"-t"オプションに論理サーバを指定した場合，<metric category>に該当する論理サーバ（J2EEサーバ，CTM）以外の論理サーバ（Webサーバ，Naming Service，スマートエージェントなど）が指定された場合は，エラーになります。

ある一定間隔で統計情報を監視する場合，サンプリング時間をその一定間隔以上に設定すると，定期的な統計情報を取得できます。

なお，J2EEアプリケーションがテストモードで開始されている場合，出力情報には，<アプリケーション名>_TESTの形式で出力されます。

サブコマンドgetに指定できる引数を次に示します。サブコマンドgetに指定できる各引数の詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「付録A　拡張MIBオブジェクト定義ファイル」を参照してください。

表7‒3　サブコマンドgetに指定できる引数

引数

説明

ターゲット指定

論理サーバ

ホスト

domainName

運用管理ドメイン名を取得します。

−

−

j2eeContainer

J2EEコンテナについての情報を取得します。

○

○

webContainer

Webコンテナに関する情報を取得します。

○

○

jvm

JavaVMについての情報を取得します。

○

○

transaction

Transactionについての情報を取得します。

○

○

httpServer

管理用サーバについての情報を取得します。

なお，この情報は内部で使用する管理用サーバの情報のため，取得しないことを推奨します。

○

○

httpSvrConn

WebサーバとWebコンテナの接続についての情報を取得します。

○

○

dataSource

データソース（JDBC）についての情報を取得します。

○

○

dataSrcFull

データソース（OTS 1.2対応のJTA）についての情報を取得します。

○

○

resAdapter

リソースアダプタについての情報を取得します。

○

○

j2eeApps

J2EEアプリケーションについての情報を取得します。

○

○

ejbApps

EJBアプリケーション（EJB-JARs）についての情報を取得します。

○

○

statelessBean

Stateless Session Beanについての情報を取得します。

○

○

statelessBeanHome

Stateless Session Beanのリモートホームインタフェースについての情報を取得します。

○

○

statelessBeanHomeMethod

Stateless Session Beanのリモートホームインタフェースのメソッドに関する情報を取得します。

○

○

statelessBeanLocalHome

Stateless Session Beanのローカルホームインタフェースについての情報を取得します。

○

○

statelessBeanLocalHomeMethod

Stateless Session Beanのローカルホームインタフェースのメソッドに関する情報を取得します。

○

○

statelessBeanRemote

Stateless Session Beanのリモートコンポーネントインタフェースについての情報を取得します。

○

○

statelessBeanRemoteMethod

Stateless Session Beanのリモートコンポーネントインタフェースのメソッドに関する情報を取得します。

○

○

statelessBeanLocalComponent

Stateless Session Beanのローカルコンポーネントインタフェースについての情報を取得します。

○

○

statelessBeanLocalComponentMethod

Stateless Session Beanのローカルコンポーネントインタフェースのメソッドに関する情報を取得します。

○

○

statefulBean

Stateful Session Beanについての情報を取得します。

○

○

statefulBeanHome

Stateful Session Beanのリモートホームインタフェースについての情報を取得します。

○

○

statefulBeanHomeMethod

Stateful Session Beanのリモートホームインタフェースのメソッドに関する情報を取得します。

○

○

statefulBeanLocalHome

Stateful Session Beanのローカルホームインタフェースについての情報を取得します。

○

○

statefulBeanLocalHomeMethod

Stateful Session Beanのローカルホームインタフェースのメソッドに関する情報を取得します。

○

○

statefulBeanRemote

Stateful Session Beanのリモートコンポーネントインタフェースについての情報を取得します。

○

○

statefulBeanRemoteMethod

Stateful Session Beanのリモートコンポーネントインタフェースのメソッドに関する情報を取得します。

○

○

statefulBeanLocalComponent

Stateful Session Beanのローカルコンポーネントインタフェースについての情報を取得します。

○

○

statefulBeanLocalComponentMethod

Stateful Session Beanのローカルコンポーネントインタフェースのメソッドに関する情報を取得します。

○

○

entityBean

Entity Beanについての情報を取得します。

○

○

entityBeanHome

Entity Beanのリモートホームインタフェースについての情報を取得します。

○

○

entityBeanLocalHome

Entity Beanのローカルホームインタフェースについての情報を取得します。

○

○

entityBeanRemote

Entity Beanのリモートコンポーネントインタフェースについての情報を取得します。

○

○

entityBeanLocalComponent

Entity Beanのローカルコンポーネントインタフェースについての情報を取得します。

○

○

msgDrivenBean

Message-driven Beanについての情報を取得します。

○

○

webApps

Webアプリケーションについての情報を取得します。

○

○

servlets

サーブレットについての情報を取得します。

○

○

requestUrl

要求された各URLについての情報を取得します。

○

○

queues

CTMのスケジュール（キューの状態）についての情報を取得します。

○

○

queueApps

CTMのキューに接続されたJ2EEアプリケーションについての情報を取得します。

○

○

（凡例）

○：指定できます。

−：指定できません。

7.3.3　set

引数を二つ指定して，一つ目の引数に指定された変数に二つ目で指定された値を設定します。

値を設定したあと，対象の論理J2EEサーバ，またはJ2EEアプリケーションが再起動または再デプロイされた場合，値を再設定してください。"-t"オプションに論理J2EEサーバ，または論理パフォーマンストレーサ以外の論理サーバが指定された場合は，エラーとなります。

サブコマンドsetに指定できる引数を次に示します。

表7‒4　サブコマンドsetに指定できる引数

引数

説明

ターゲット指定

論理サーバ

ホスト

jvmSamplingTime <n>

JavaVMについてのサンプリング時間を<n>秒に設定します。※1

○

−

webContainerSamplingTime <n>

Webコンテナについてのサンプリング時間を<n>秒に設定します。※1

○

−

tranSamplingTime <n>

トランザクションについてのサンプリング時間を<n>秒に設定します。※1，※2

○

−

httpSvrSamplingTime <n>

管理用サーバについてのサンプリング時間を<n>秒に設定します。※1

なお，管理用サーバの情報は内部で使用する管理用サーバの情報のため，取得しないことを推奨します。

○

−

httpSvrConnSamplingTime <n>

HTTPサーバコネクタについてのサンプリング時間を<n>秒に設定します。※1

○

−

dataSrcFullSamplingTime <n>

データソース（OTS 1.2対応のJTA）についてのサンプリング時間を<n>秒に設定します。※1，※3

○

−

resAdapterSamplingTime <n>

リソースアダプタについてのサンプリング時間を<n>秒に設定します。※1，※3

○

−

ejbSamplingTime <n>

EJBについてのサンプリング時間を<n>秒に設定します。※1，※3

○

−

webAppSamplingTime <n>

Webアプリケーションについてのサンプリング時間を<n>秒に設定します。※1，※3

○

−

servletSamplingTime <n>

サーブレットについてのサンプリング時間を<n>秒に設定します。※1，※3

○

−

reqUrlSamplingTime <n>

設定以降に要求される各URLのサンプリング時間を<n>秒にします。※1，※3

○

−

allPrfTraceLevel STANDARD|DETAIL | <tracelevel>

運用管理ドメイン内のすべてのパフォーマンストレーサについてPRFトレース取得レベルを設定します。※4

−

−

prfTraceLevel STANDARD|DETAIL | <tracelevel>

指定されたパフォーマンストレーサ，または指定されたホスト内のパフォーマンストレーサのPRFトレース取得レベルを設定します。※4

○

○

（凡例）

○：指定できます。

−：指定できません。

注※1

-2147483647≦n≦3600（秒）の整数値を指定します。この範囲以外の値が指定された場合はエラーとなります。なお，n≦0の場合は統計値取得スイッチをOFFにします。また，0<n<10の場合はn=10とします。指定値による動作を次に示します。

0以下の値が指定された場合は，統計を停止します。

1以上9以下の値が指定された場合は，サンプリング時間をデフォルト（10秒）に設定して，統計を開始します。

10以上の値が指定された場合は，サンプリング時間を指定された値に設定して，統計を開始します。

注※2

最初のトランザクション開始後に設定する必要があります。

注※3

この変数を設定後にJ2EEアプリケーションをデプロイした場合，新たに設定する必要があります。

注※4

パフォーマンストレーサへの操作については，稼働中のパフォーマンストレーサが対象となります。

STANDARD

PRFトレース取得レベルを「標準」に設定します。

DETAIL

PRFトレース取得レベルを「詳細」に設定します。

7.3.4　start

指定した論理サーバ，J2EEアプリケーション，J2EEリソースを起動します。

サブコマンドstartに指定できる引数を次に示します。

表7‒5　サブコマンドstartに指定できる引数

引数

説明

ターゲット指定

論理サーバ

ホスト

allServers

運用管理ドメインに定義された論理サーバを定義された起動順序で起動します。

−

−

server

"-t"オプションで指定された論理サーバを起動します。

○

○

app <displayName>

"-t"オプションで指定された論理サーバにインポートされている<displayName>のJ2EEアプリケーションを開始します。※

○

−

resAdapter <displayName>

"-t"オプションで指定された論理サーバにインポートされている<displayName>のJ2EEリソースアダプタを開始します。※

○

−

resJavaBeans <displayName>

"-t"オプションで指定された論理サーバにインポートされている<displayName>のJavaBeansリソースを開始します。※

○

−

（凡例）

○：指定できます。

−：指定できません。

注※

<displayName>は，J2EEアプリケーション，J2EEリソースまたはJavaBeansリソースの表示名（displayName）を示します。

startでは，次の2種類の操作を実行できます。

引数に"allServers"を指定して，指定された論理サーバを起動します。

運用管理ドメインに定義された論理サーバを，定義された起動順序で起動します。

引数にserverが指定された場合，"-t"オプションで指定された論理サーバ（スマートエージェント，ネーミングサービス，J2EEサーバ，J2EEサーバクラスタ，CTM，CTMドメインマネジャ，パフォーマンストレーサ，Webサーバ，Webサーバクラスタ，およびユーザサーバ）を起動します。

引数にはstartサブコマンドに対する引数を二つ指定して，指定されたJ2EEアプリケーション／J2EEリソースアダプタ／JavaBeansリソースを開始します。

一つ目の引数に"app"/"resAdapter"/"resJavaBeans"が指定された場合，"-t"オプションで指定されたJ2EEサーバにインポートされている，二つ目の引数で指定された表示名（displayname）のJ2EEアプリケーション/リソースアダプタ/JavaBeansリソースを開始します。J2EEサーバクラスタの場合は，メンバとなるJ2EEサーバに操作を展開します。

"-t"オプションにJ2EEサーバ（J2EEサーバクラスタのメンバも含む）またはJ2EEサーバクラスタ以外の論理サーバが指定された場合はエラーになります。また，"-t"オプションにホスト名は指定できません。

注意事項

start/stopサブコマンドを実行した直後に，同一論理サーバに対して同様の処理を実行する場合には，まず-sオプションを指定してstart/stopを実行し，その処理の完了を待ってから次のコマンドを実行してください。

listサブコマンドで取得されるステータスは，start，stopなどの他のサブコマンドの処理の実行状態に関係なく，呼び出し時点での情報を返します。そのため，startコマンドによる起動処理が完了する前に"working"のステータスを返したり，stopコマンドによる停止処理が完了する前に"stopped"のステータスを返したりすることがあります。

7.3.5　stop

指定した論理サーバ，J2EEアプリケーションまたはJ2EEリソースを停止します。

サブコマンドstopに指定できる引数を次に示します。

表7‒6　サブコマンドstopに指定できる引数

引数

説明

ターゲット指定

論理サーバ

ホスト

allServers

運用管理ドメインに定義された論理サーバを定義された起動順序の逆順で停止します。

−

−

server [graceful[:<waitTime>]]

"-t"オプションで指定された論理サーバを停止します。

"graceful"が指定された場合，計画停止します。

○

○

app <displayName> [force]

"-t"オプションで指定された論理サーバで開始している<displayName>のJ2EEアプリケーションを停止します。※

"force"が指定された場合，強制停止します。

○

−

resAdapter <displayName>

"-t"オプションで指定された論理サーバで開始している<displayName>のJ2EEリソースを停止します。※

○

−

resJavaBeans <displayName>

"-t"オプションで指定された論理サーバで開始している<displayName>のJavaBeansリソースを停止します。※

○

−

（凡例）

○：指定できます。

−：指定できません。

注※

<displayName>は，J2EEアプリケーションまたはJ2EEリソースまたはJavaBeansリソースの表示名（displayName）を示します。

stopでは，次の2種類の操作を実行できます。

引数に"allServers"を指定して，指定された論理サーバを停止します。

運用管理ドメインに定義された論理サーバを，定義された起動順序の逆順で停止します。引数に"server"が指定された場合，"-t"オプションで指定された論理サーバ（スマートエージェント，ネーミングサービス，J2EEサーバ，J2EEサーバクラスタ，CTM，CTMドメインマネジャ，パフォーマンストレーサ，Webサーバ，Webサーバクラスタ，およびユーザサーバ）を停止します。

一つ目の引数に"server"が指定された場合，二つ目の引数に"graceful"を指定できます。"graceful"が指定された場合，"-t"オプションで指定された論理サーバがWebサーバまたはWebサーバクラスタの場合，論理サーバを計画停止します。計画停止とは，現在受け付けているすべてのリクエストの処理終了を待って論理サーバを停止させることです。"-t"オプションで指定された論理サーバがWebサーバおよびWebサーバクラスタ以外の場合，または"-t"オプションにホスト名を指定した場合は，引数"graceful"は無視されます。また，引数"graceful"では":<waitTime>"を指定して停止までの待ち時間を指定できます。"<waitTime>"には，60〜1800（単位：秒）の値を指定します。指定した待ち時間の間にリクエストが終了しなかった場合，論理サーバを強制停止します。":<waitTime>"を省略した場合は，運用管理ポータルの「論理サーバの起動／停止」で設定した「停止監視時間」が設定されます。

引数にstopサブコマンドに対する引数を二つ指定して，指定されたJ2EEアプリケーション/J2EEリソースアダプタ/JavaBeansリソースを停止します。

一つ目の引数に"app"/"resAdapter"/"resJavaBeans"が指定された場合，"-t"オプションで指定されたJ2EEサーバで，二つ目の引数で指定された表示名（displayname）の開始しているJ2EEアプリケーション/リソースアダプタ/JavaBeansリソースを停止します。J2EEサーバクラスタの場合はメンバとなるJ2EEサーバに操作を展開します。

"-t"オプションにJ2EEサーバ（J2EEサーバクラスタのメンバも含む）またはJ2EEサーバクラスタ以外の論理サーバが指定された場合は，エラーになります。また，"-t"オプションにホスト名は指定できません。

一つ目の引数に"app"が指定された場合，三つ目の引数に"force"を指定できます。引数"force"が指定された場合，J2EEアプリケーションがリクエスト処理の実行中であっても，その終了を待たないでJ2EEアプリケーションを強制停止します。

注意事項

start/stopサブコマンドを実行した直後に，同一論理サーバに対して同様の処理を実行する場合には，まず-sオプションを指定してstart/stopを実行し，その処理の完了を待ってから次のコマンドを実行してください。

listサブコマンドで取得されるステータスは，start，stopなどの他のサブコマンドの処理の実行状態に関係なく，呼び出し時点での情報を返します。そのため，startコマンドによる起動処理が完了する前に"working"のステータスを返したり，stopコマンドによる停止処理が完了する前に"stopped"のステータスを返したりすることがあります。

停止対象の論理サーバのうち，異常停止ステータスの論理サーバは停止済みとし，該当論理サーバを停止処理のリトライ対象としません。09-70以前では，異常停止ステータスの論理サーバに対して停止処理のリトライを行います。そのため，異常停止ステータスの論理サーバに対して停止処理を行うと，最大監視時間（-lオプションの値(デフォルトは60秒)）によるタイムアウトまで待ち，戻り値1で終了します。

論理J2EEサーバの接続するCTMに設定している論理CTMサーバを停止する場合，論理J2EEサーバを先に停止し，論理J2EEサーバの停止処理が完了したことを確認してから論理CTMサーバを停止してください。論理J2EEサーバの停止処理が完了していない状態で論理CTMサーバを停止したとき，論理CTMサーバの停止に失敗することがあります。論理J2EEサーバの停止処理が完了したことはJ2EEサーバのプロセス（cjstartsv）の停止で確認してください。

7.3.6　reload

引数に指定されたコンポーネントの設定ファイルを再読み込みします。

サブコマンドreloadに指定できる引数を次に示します。

表7‒7　サブコマンドreloadに指定できる引数

引数

説明

ターゲット指定

論理サーバ

ホスト

userAdmin

統合ユーザ管理で使用するjaas.confファイルを再読み込みします。ua.confファイルは再読み込みできません。ua.confの設定を反映させるには，論理J2EEサーバの再起動が必要となります。なお，"-t"オプションで指定された論理サーバで統合ユーザ管理を使用していない場合はエラーとなります。

また，サブコマンド"reload"に"userAdmin"を指定した場合，"-t"オプションに，論理J2EEサーバ以外の論理サーバを指定するとエラーとなります。

○

−

env※

論理J2EEサーバで，接続先ホストの設定ファイルを再読み込みします。

なお，サブコマンド"reload"に"env"を指定した場合，"-t"オプションに，論理J2EEサーバ以外の論理サーバを指定するとエラーとなります。

○

○

（凡例）

○：指定できます。

−：指定できません。

注※

サブコマンド"reload"に"env"を指定する場合には，注意事項があります。注意事項については，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.8.28　論理J2EEサーバの設定読み込み」を参照してください。

7.3.7　hold

引数に指定されたサービスを閉塞します。

サブコマンドholdに指定できる引数を次に示します。

表7‒8　サブコマンドholdに指定できる引数

引数

説明

ターゲット指定

論理サーバ

ホスト

queue <queueName> { in[:<waitTime>] | out | force[:<waitTime>]}

"-t"オプションで指定されたCTMに属する<queueName>で指定された名称のキューを閉塞します。

○

−

queues { in[:<waitTime>] | out | force[:<waitTime>] }

"-t"オプションで指定されたCTM，またはホストに属するキューを閉塞します。

○

○

allQueues { in[:<waitTime>] | out | force[:<waitTime>] }

運用管理ドメイン内の，すべてのCTMのキューを閉塞します。

−

−

（凡例）

○：指定できます。

−：指定できません。

holdでは，次の3種類の方法でキューを閉塞できます。

引数に"queue"を指定して，特定の名称のキューを閉塞します。

"-t"オプションで指定されたCTMに属する<queueName>の名称のキューを閉塞します。"-t"オプションおよび<queueName>は必ず指定してください。なお，"-t"オプションにホスト名は指定できません。

キューの閉塞条件として，"in"（キューの入り口を閉塞），"out"（キューの出口を閉塞）または"force"（キューの強制閉塞）のどれかを指定してください。"in"指定の場合，キューイング中のリクエスト終了の待ち時間を指定できます。待ち時間は，"in:<waitTime>"の形式で，次の値を指定します。

0：

キューの入り口を閉塞し，キューイング中のすべてのリクエストが終了するまで待ちます。

1〜2147483647：

キューの入り口を閉塞し，キューイング中のリクエストの終了を指定秒数まで待ちます。

-1：

キューの入り口を閉塞し，キューイング中のリクエストはすべてエラーリターンします。

"in"だけ指定した場合は，"in:-1"が設定されます。

"out"を指定し，キューの出口を閉塞した場合，閉塞中もリクエストは受け付けられますが，リクエストはJ2EEアプリケーションに振り分けられません。オンライン中にJ2EEアプリケーションの入れ替えをする場合には，"out"を指定してキューを閉塞してください。

"force"を指定した場合は，"in:-1"を指定したときと同様にキューの入り口を閉塞し，キューイング中のリクエストはすべてエラーリターンしますが，"in:-1"を指定したときよりも高速に閉塞できます。また，"force:<waitTime>"の形式で待ち時間を指定できます。指定する値は，"in"指定の場合と同じです。

引数に"queues"を指定して，複数のキューを閉塞します。

"-t"オプションで指定されたCTM，またはホストに属するすべてのキューを閉塞します。"-t"オプションは必ず指定してください。"in"，"out"，"force"の指定は"queue"の場合と同じです。

引数に"allQueues"を指定して，すべてのキューを閉塞します。

運用管理ドメインのすべてのキューを閉塞します。"in"，"out"，"force"の指定は"queue"の場合と同じです。

7.3.8　release

引数に指定されたサービスの閉塞を解除します。

サブコマンドreleaseに指定できる引数を次に示します。

表7‒9　サブコマンドreleaseに指定できる引数

引数

説明

ターゲット指定

論理サーバ

ホスト

queue <queueName>

"-t"オプションで指定されたCTMに属する<queueName>で指定された名称のキューの閉塞を解除します。

○

−

queues

"-t"オプションで指定されたCTM，またはホストに属するキューの閉塞を解除します。

○

○

allQueues

運用管理ドメイン内の，すべてのCTMのキューの閉塞を解除します。

−

−

（凡例）

○：指定できます。

−：指定できません。

releaseでは，次の3種類の方法でキューの閉塞を解除できます。

引数に"queue"を指定して，特定の名称のキューの閉塞を解除します。

"-t"オプションで指定されたCTMに属する名称<queueName>のキューの閉塞を解除します。"-t"オプションおよび<queueName>は必ず指定します。なお，"-t"オプションにホスト名は指定できません。

引数に"queues"を指定して，複数のキューの閉塞を解除します。

"-t"オプションで指定されたCTM，またはホストに属するキューの閉塞を解除します。"-t"オプションは必ず指定してください。

引数に"allQueues"を指定して，すべてのキューの閉塞を解除します。

運用管理ドメインのすべてのキューの閉塞を解除します。

7.3.9　collect

引数に指定されたファイルなどを収集します。"-t"オプションに，パフォーマンストレーサ，CTM以外の論理サーバが指定された場合は，エラーになります。

サブコマンドcollectに指定できる引数を次に示します。

表7‒10　サブコマンドcollectに指定できる引数

引数

説明

ターゲット指定

論理サーバ

ホスト

allPrfTraces

運用管理ドメイン内のすべてのパフォーマンストレーサについて性能解析トレースを収集します。

−

−

prfTrace

指定されたパフォーマンストレーサ，または指定されたホスト内のパフォーマンストレーサについて性能解析トレースを収集します。

○

○

allCtmStatistics

運用管理ドメイン内のすべてのCTMについて稼働統計情報を収集します。

−

−

ctmStatistics

指定されたCTM，または指定されたホスト内のCTMについて稼働統計情報を収集します。

○

○

snapshot [n]※

指定されたホスト内のsnapshotログを収集します。

−

○

（凡例）

○：指定できます。

−：指定できません。

注※

[n]は，次のどれかを指定します。

1：一次送付資料となるsnapshotログを収集します。

2：二次送付資料となるsnapshotログおよび性能解析トレースファイルを収集します。

省略：すべてを対象にsnapshotログおよび性能解析トレースファイルを収集します。

collectでは，次の3種類の操作を実行できます。

引数に"allPrfTraces"または"prfTrace"を指定して，稼働中のパフォーマンストレーサの性能解析トレースを収集します。

引数に"allPrfTraces"が指定された場合，運用管理ドメイン内のすべてのパフォーマンストレーサについて性能解析トレースを収集します。

引数に"prfTrace"が指定された場合，"-t"オプションで指定されたパフォーマンストレーサ，または"-t"オプションで指定されたホスト内のパフォーマンストレーサについて性能解析トレースを収集します。

性能解析トレースは，<Managerのログ出力ディレクトリ>¥prf¥（Windowsの場合），または<Managerのログ出力ディレクトリ>/prf/（UNIXの場合）に出力されます。

なお，性能解析トレースファイルは，トレース情報の収集対象別に次の表に示すファイル名で出力されます。

ドメイン指定の場合：<運用管理ドメイン名>-<日時※>.zip

ホスト指定の場合：<ホスト名>-<日時※>.zip

論理サーバ指定の場合：<論理サーバ名>-<日時※>.zip

引数に"allCtmStatistics"または"ctmStatistics"を指定して，稼働中のCTMの稼働統計情報を収集します。

引数に"allCtmStatistics"が指定された場合，運用管理ドメイン内のすべてのCTMについて稼働統計情報を収集します。

引数に"ctmStatistics"が指定された場合，"-t"オプションで指定されたCTM，または"-t"オプションで指定されたホスト内のCTMについて稼働統計情報を収集します。

CTM起動ホストでCSV形式で出力されたCTM稼働統計情報の収集ファイルは，ZIP形式でアーカイブされ，<ホスト名>-<論理サーバ名>-<日時>.zipファイルが作成されます。さらに，Management Serverにファイル転送されたあと，<Managerログ出力ディレクトリ>¥ctm¥（Windowsの場合），または<Managerログ出力ディレクトリ>/ctm/（UNIXの場合）に格納されます。ドメイン指定またはホスト指定の場合は複数ファイルをZIP形式の一つのファイルにして，論理サーバ指定の場合はファイル名を変更して格納します。

ドメイン指定の場合：<ドメイン名>-<日時※>.zip

ホスト指定の場合：<ホスト名>-<日時※>.zip

論理サーバ指定の場合：<論理サーバ名>-<日時※>.zip

引数に"snapshot"を指定して，snapshotログを収集します。

引数に"snapshot"が指定された場合，"-t"オプションで指定されたホスト内のsnapshotログを収集します。同時に，インストール情報およびOS状態情報が取得されます。なお，"-t"オプションに，論理サーバが指定された場合はエラーとなります。

収集が成功すると，ZIP形式で作成された次のファイル名を表示します。

一次送付資料：snapshot-<ホスト名>-log-<日時※>.zip

二次送付資料：snapshot-<ホスト名>-log-<日時※>.2.zip

注※

日付の形式は，次のどれかになります。

・yyyyMMddHHmmss

・yyyyMMddHHmmss+hhmm

・yyyyMMddHHmmss-hhmm

7.3.10　change

引数に指定した同時実行スレッド数の設定項目の値を変更します。"-t"オプションで，J2EEサーバを指定する必要があります。

サブコマンドchangeに指定できる引数を次に示します。

表7‒11　サブコマンドchangeに指定できる引数

引数

説明

ターゲット指定

論理サーバ

ホスト

webAppThreadCtrl <webApplicationContextRoot> <maxThreads>,<exclusiveThreads>,<queueSize>

"-t"オプションで指定されたJ2EEサーバ内で指定したWebアプリケーションの同時実行スレッド数を動的に制御します。

この引数は省略できません。

○

−

（凡例）

○：指定できます。

−：指定できません。

引数に"webAppThreadCtrl"が指定された場合，"-t"オプションで指定されたJ2EEサーバに属するWebアプリケーションの同時実行スレッド数を動的に制御します。

引数"webApplicationContextRoot"はWebアプリケーション（J2EEアプリケーションのWar）のコンテキストルートおよび同時実行スレッド数の各値を設定します。Webアプリケーションのコンテキストルートの値は，サブコマンドget webAppsで取得できます。コンテキストルートが設定されていない場合は，"/"（スラッシュ）を指定してください。

同時実行スレッド数の各値は，最大スレッド数，占有スレッド数，Webアプリケーション単位の実行待ちキューサイズの順にコンマ(,)で区切って指定します。

引数"maxThreads"（最大スレッド数），"exclusiveThreads"（占有スレッド数），および"queueSize"（Webアプリケーション単位の実行待ちキューサイズ）は，設定を変えない値は省略できますが，すべてを省略することはできません。

（例　占有スレッド数だけを変更したい場合：,20,）

同時スレッド数の各値は，次の範囲で指定します。

maxThreads（最大スレッド数）※：

1〜1024の範囲で，Webコンテナがリクエストを処理する同時実行数以下の値を指定します。

exclusiveThreads（占有スレッド数）※：

0〜1024の範囲で指定します。

queueSize（Webアプリケーション単位の実行待ちキューサイズ）：

0〜2147483647の範囲で指定します。

注※　最大スレッド数 >= 占有スレッド数

なお，動的変更した同時実行スレッド数の値は，J2EEアプリケーション実行中だけ有効です。

7.3.11　check

Management Serverおよび運用管理エージェントが稼働しているかどうかを確認します。

サブコマンドcheckに指定できる引数を次に示します。

表7‒12　サブコマンドcheckに指定できる引数

引数

説明

ターゲット指定

論理サーバ

ホスト

mngsvr

Management Serverが稼働しているかどうかを確認します。

"-t"オプションでターゲットを指定しても無視されます。

−

−

adminAgent

"-t"オプションで指定されたホスト上で運用管理エージェントが稼働しているかどうかを確認します。

"-k"オプションで"host"以外を指定した場合，"-t"オプションでホスト名以外を指定した場合，または"-t"オプションを指定しなかった場合は，エラーとなります。

−

○

（凡例）

○：指定できます。

−：指定できません。

サブコマンドcheckの戻り値を次に示します。

0：

稼働しています。

1：

コマンド実行時エラーです※。

2：

コマンドシンタックスエラーです。

103：

稼働していません※。

注※　-wオプションで指定した稼働確認待ち時間が経過してもManagement Serverからの応答が返ってこなかった場合，サブコマンドcheckに指定した引数によって，戻り値は次のように異なります。

mngsvrを指定した場合，終了値103が返されます。

adminAgentを指定した場合，終了値1が返されます。

7.3.12　dump

稼働中の論理サーバのjavacoreを出力します。

サブコマンドdumpに指定できる引数を次に示します。

表7‒13　サブコマンドdumpに指定できる引数

引数

説明

ターゲット指定

論理サーバ

ホスト

server [addition]※

"-t"オプションで指定された論理サーバのjavacore（稼働時間情報）を出力します。指定できる論理サーバは，J2EEサーバ（J2EEクラスタのメンバも含む），J2EEサーバクラスタ，CTM，またはネーミングサービスだけです。

additionを指定した場合，"-t"オプションで指定された論理サーバのcoreを取得します。

Windowsの場合，additionを指定しないでください。

○

−

（凡例）

○：指定できます。

−：指定できません。

注※

server additionが指定された場合，指定された論理サーバの稼働監視方法はプロセスの存在確認だけに切り替わります。

javacore出力のために実行されるコマンドとjavacoreファイルの出力先について，OSごとに説明します。

(1)　Windowsの場合

Windowsの場合にjavacore出力のために実行されるコマンドとjavacoreファイルの出力先を論理サーバの種別ごとに示します。

論理サーバ

addition指定

実行されるコマンド

出力情報

javacoreファイルの出力先ディレクトリ

J2EEサーバ（クラスタも含む）

なし

cjdumpsv

javacore

<J2EEサーバ作業ディレクトリ>¥ejb¥<実サーバ名>¥

CTM

あり，なし※1

hdumpns

javacore※2

<Application Serverのインストールディレクトリ>¥TPB¥logj¥

ネーミングサービス

あり，なし※1

hdumpns

javacore

<Application Serverのインストールディレクトリ>¥TPB¥logj¥

注※1

addition指定は無視され，稼働監視方法の変更はありません。

注※2

論理サーバにCTMを指定したときに出力されるjavacoreはCTMデーモンの情報ではなく，CTM用に起動されているネーミングサービスの情報です。

(2)　UNIXの場合

UNIXの場合にjavacore出力のために実行されるコマンドとjavacoreファイルの出力先を論理サーバの種別ごとに示します。

論理サーバ

addition指定

実行されるコマンド

出力情報

javacoreファイルの出力先ディレクトリ

J2EEサーバ（クラスタも含む）

あり

javacore -f -p※1

javacore，core

<J2EEサーバ作業ディレクトリ>/ejb/<実サーバ名>/

なし

cjdumpsv

javacore

<J2EEサーバ作業ディレクトリ>/ejb/<実サーバ名>/

CTM

あり，なし※2

kill -3

javacore※3

/opt/Cosminexus/TPB/logj/

ネーミングサービス

あり，なし※2

kill -3

javacore

/opt/Cosminexus/TPB/logj/

注※1

gdbのパッケージがインストールされている必要があります。

注※2

addition指定は無視され，稼働監視方法の変更はありません。

注※3

論理サーバにCTMを指定したときに出力されるjavacoreはCTMデーモンの情報ではなく，CTM用に起動されているネーミングサービスの情報です。

7.3.13　add

論理ユーザサーバを追加します。

サブコマンドaddに指定できる引数を次に示します。

表7‒14　サブコマンドaddに指定できる引数

引数

説明

ターゲット指定

論理サーバ

ホスト

userserver <userServiceDefinitionFile>

<userServiceDefinitionFile>に指定した論理ユーザサーバ定義ファイルの内容に従って論理ユーザサーバを追加します。論理ユーザサーバの定義内容を変更する場合は，論理ユーザサーバをいったん削除したあとに，再度論理ユーザサーバを追加してください。

−

−

（凡例）

−：指定できません。

複数の論理ユーザサーバを指定した場合，定義順に追加処理をします。途中でエラーが発生した場合も追加処理をします。この場合の戻り値は，１（実行時エラー）となります。エラー条件を次に示します。

既存の論理サーバ名が指定された場合

定義されていないホスト名が指定された場合

7.3.14　delete

論理ユーザサーバを削除します。

サブコマンドdeleteに指定できる引数を次に示します。

表7‒15　サブコマンドdeleteに指定できる引数

引数

説明

ターゲット指定

論理サーバ

ホスト

userserver <logicalServerName>

<logicalServerName>に指定した名称の論理ユーザサーバを削除します。

−

−

（凡例）

−：指定できません。

8　Smart Composer機能で使用するコマンド

この章では，Smart Composer機能で使用するコマンドの入力形式，機能などについて説明します。

8.1　Smart Composer機能で使用するコマンドの一覧

ここでは，Smart Composer機能で使用するコマンドの一覧について説明します。

注意事項

運用管理エージェントまたはManagement Serverの起動に続けて，運用管理コマンド（mngsvrutil）またはSmart Composer機能などでManagement Serverにアクセスする場合，事前に次のどちらかの対策をしてください。

運用管理エージェントまたはManagement Serverの起動時に同期実行を有効にし起動に続けてコマンドを実行する。

mngsvrutil checkまたはadminagentcheckコマンドで，Management Serverまたは運用管理エージェントが起動済みであることを確認する。

8.1.1　J2EEアプリケーションを実行するシステムで使用できるコマンドの一覧

J2EEアプリケーションを実行するシステムで使用できるコマンドの一覧を次の表に示します。

表8‒1　Smart Composer機能で使用するコマンドの一覧（J2EEアプリケーションを実行するシステムの場合）

分類

コマンド名称

概要

環境設定

cmx_admin_passwd

Management Serverの管理ユーザアカウントを設定します。または，設定済みの管理ユーザアカウントを変更，解除します。

Webシステムの構築

cmx_build_model

Management Server上にWebシステムの情報モデルを生成します。

cmx_build_system

Management Server上のWebシステムの情報モデルからWebシステムを構築します。

cmx_change_model

Management Server上のWebシステムの情報モデルを変更します。

cmx_delete_system

構築したWebシステムやWebシステム中のサービスユニットを削除します。

cmx_resume_lb

負荷分散機の休止状態を解除して，設定処理を再開します。

cmx_scaleout_host

Management Server上の，ホスト単位管理モデルのWebシステムの情報モデルを変更します。

cmx_test_lb

負荷分散機との接続に問題がないか，接続テストをします。

cmx_trans_param

抽象パラメタを実パラメタに展開します。

サービスユニットの操作

cmx_list_status

サービスユニットの稼働状況のステータスや運用環境の構築状況を表示します。

cmx_start_target

単一のサービスユニット，またはWebシステム中の全サービスユニットを開始します。

cmx_stop_target

単一のサービスユニット，またはWebシステム中の全サービスユニットを停止します。

構成情報の参照

cmx_list_model

Management Server上に構築したWebシステムの情報モデルの内容をCSV形式で出力します。

構築済みのシステムの設定内容の出力

cmx_export_model

構築済みのシステムの設定内容を，簡易構築定義ファイルの形式で出力します。

注

Smart Composer機能で使用するコマンドの実行状況は，アプリケーションサーバのログ（コマンド保守ログ）として出力されます。アプリケーションサーバのログ（コマンド保守ログ）については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「4.3　アプリケーションサーバのログ（J2EEアプリケーションを実行するシステム）」を参照してください。

8.1.2　バッチアプリケーションを実行するシステムで使用できるコマンドの一覧

バッチアプリケーションを実行するシステムの場合，使用できるコマンドが一部異なります。バッチアプリケーションを実行するシステムで使用できるコマンドの一覧を次の表に示します。

表8‒2　Smart Composer機能で使用するコマンドの一覧（バッチアプリケーションを実行するシステムの場合）

分類

コマンド名称

概要

環境設定

cmx_admin_passwd

Management Serverの管理ユーザアカウントを設定します。または，設定済みの管理ユーザアカウントを変更，解除します。

Webシステムの構築

cmx_build_model

Management Server上にWebシステムの情報モデルを生成します。

cmx_build_system

Management Server上のWebシステムの情報モデルからWebシステムを構築します。

cmx_change_model

Management Server上のWebシステムの情報モデルを変更します。

cmx_delete_system

構築したWebシステムやWebシステム中のサービスユニットを削除します。

cmx_scaleout_host

Management Server上の，ホスト単位管理モデルのWebシステムの情報モデルを変更します。

サービスユニットの操作

cmx_list_status

サービスユニットの稼働状況のステータスや運用環境の構築状況を表示します。

cmx_start_target

単一のサービスユニット，またはWebシステム中の全サービスユニットを開始します。

cmx_stop_target

単一のサービスユニット，またはWebシステム中の全サービスユニットを停止します。

構成情報の参照

cmx_list_model

Management Server上に構築したWebシステムの情報モデルの内容をCSV形式で出力します。

構築済みのシステムの設定内容の出力

cmx_export_model

構築済みのシステムの設定内容を，簡易構築定義ファイルの形式で出力します。

注

Smart Composer機能で使用するコマンドの実行状況は，アプリケーションサーバのログ（コマンド保守ログ）として出力されます。アプリケーションサーバのログ（コマンド保守ログ）については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「4.4　アプリケーションサーバのログ（バッチアプリケーションを実行するシステム）」を参照してください。

バッチアプリケーションを実行するシステムの場合は，次の点に留意してください。

バッチアプリケーションを実行するシステムでは，サービスユニットとしてj2ee-tierまたはctm-tierを使用します。それ以外のティアの説明は，バッチアプリケーションを実行するシステムでは該当しません。

Smart Composer機能のコマンドでは，バッチサーバをJ2EEサーバとして扱います。このため，この章の説明中の「J2EEサーバ」は，「バッチサーバ」に読み替えてください。

8.2　コマンドを同時に複数実行した場合の排他制御

Smart Composer機能のコマンドを同時に複数実行した場合，コマンドによって，あとから実行したコマンドが排他制御されるものと，排他制御されないものがあります。

Smart Composer機能のコマンドについて，排他制御の対象となるかどうかを次の表に示します。

表8‒3　排他制御の対象/対象外のコマンド

コマンドの種類

コマンド名

排他制御の対象

Webシステム全体に対するコマンド

cmx_build_model

○

cmx_change_model

○

cmx_scaleout_host

○

個別のWebシステムに対するコマンド

cmx_admin_passwd

×

cmx_build_system

○

cmx_delete_system

○

cmx_export_model

×

cmx_list_model

×

cmx_list_status

×

cmx_resume_lb

○

cmx_start_target

○

cmx_stop_target

○

cmx_test_lb

○

cmx_trans_param

×

（凡例）

○：排他制御の対象です。これらのコマンドは，「8.3　Smart Composer機能で使用するコマンドの詳細」の共通引数にある，-wait/-nowaitオプションが指定できるコマンドです。

×：排他制御の対象外です。実行中のコマンドがある場合でも実行できます。

排他制御の対象となるコマンドでは，コマンドの共通引数の-wait/-nowaitオプションの指定によって，複数のコマンドを同時に実行したときの動作が変わります。また，コマンドの種類や，どのWebシステムを対象としてコマンドを実行するかの組み合わせで，排他制御される場合とされない場合があります。

次の表に，複数のコマンドを同時に実行したときの排他制御のルールを示します。なお，表中の「Webシステム全体に対するコマンド」および「個別のWebシステムに対するコマンド」に分類されるコマンドの種類については，表8-3を参照してください。

表8‒4　排他制御のルール

あとから実行するコマンド

実行中のコマンド

コマンドの種類

対象となるシステム

共通引数の指定

コマンドの種類

Webシステム全体に対するコマンド

個別のWebシステムに対するコマンド

Webシステム全体に対するコマンド

−

-wait

△

△

-nowait

×

×

個別のWebシステムに対するコマンド

同じWebシステム

-wait

△

△

-nowait

×

×

異なるWebシステム

-wait

△

○

-nowait

×

○

（凡例）

○：あとから実行するコマンドを実行します。

△：あとから実行するコマンドは実行中のコマンドが終了するまで待ちます。

×：あとから実行するコマンドは排他エラーが返ります。

−：該当しません。

8.3　Smart Composer機能で使用するコマンドの詳細

Smart Composer機能で使用するコマンドの入力形式，機能などを次に示します。

コマンドの格納先

Smart Composer機能で使用するコマンドは，次のディレクトリに格納されています。

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥bin¥

UNIXの場合

/opt/Cosminexus/manager/bin/

共通引数

各コマンドには，次の引数を共通引数として指定します。共通引数は，.cmxrc（クライアント設定プロパティファイル）またはcmxclient.properties（クライアント共通設定ファイル）で，指定を省略したときのデフォルト値を設定できます。.cmxrcファイルについては，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「4.2.2　.cmxrc（クライアント設定プロパティファイル）」を参照してください。cmxclient.propertiesファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.2.3　cmxclient.properties（クライアント共通設定プロパティファイル）」を参照してください。

形式

コマンド名称 [-m <ホスト名>[:<ポート番号>]]
             [-u <管理ユーザID>] [-p <管理ユーザパスワード>]
             [-wait | -nowait] [-verbose | -noverbose]

説明

-m <ホスト名>[:<ポート番号>]

Management Serverのホスト名とポート番号を指定します。

<ホスト名>

ドット記法でのIPアドレス指定（xxx.xxx.xxx.xxx），または名前解決できるホスト名で指定します。なお，xxxには0〜255の整数を指定します。

<ポート番号>

Management Serverの設定に従います。デフォルト値は28080です。

-u <管理ユーザID>

Management Serverのセットアップで設定した，Management Serverの管理ユーザIDを指定します。Management Serverのセットアップについては，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.14　運用管理機能を構築する」を参照してください。管理ユーザアカウントの省略機能が有効の場合，管理ユーザIDを指定しても無効となります。管理ユーザアカウントの省略機能については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.15(3)　管理ユーザアカウントを設定しない場合の設定」を参照してください。

-p <管理ユーザパスワード>

Management Serverのセットアップで設定した，Management Serverの管理ユーザパスワードを指定します。Management Serverのセットアップについては，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.14　運用管理機能を構築する」を参照してください。管理ユーザアカウントの省略機能が有効の場合，管理ユーザパスワードを指定しても無効となります。管理ユーザアカウントの省略機能については，マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.15(3)　管理ユーザアカウントを設定しない場合の設定」を参照してください。

-wait | -nowait

コマンド実行時に，すでに実行しているコマンドとの排他が必要な場合，処理できるようになるまで待つか（-wait），待たずにエラーリターンするか（-nowait）のどちらかを指定します。詳細は，「8.2　コマンドを同時に複数実行した場合の排他制御」を参照してください。

-verbose | -noverbose

コマンドの実行結果の詳細を出力するか（-verbose），出力しないか（-noverbose）のどらかを指定します。

共通引数は，コマンドによって指定が有効になる場合と，無効になる場合があります。コマンドに無効な引数を指定した場合，その引数は無視されます。共通引数の指定について，コマンドごとに次の表に示します。

表8‒5　共通引数の指定の可否

コマンド名称

共通引数

-m

-u

-p

-wait

-nowait

-verbose

-noverbose

cmx_admin_passwd

○

○

○

×

×

cmx_build_model

○

○

○

○

×

cmx_build_system

○

○

○

○

○

cmx_change_model

○

○

○

○

×

cmx_delete_system

○

○

○

○

○

cmx_export_model

○

○

○

×

×

cmx_list_model

○

○

○

×

×

cmx_list_status

○

○

○

×

×

cmx_resume_lb

○

○

○

○

○

cmx_scaleout_host

○

○

○

○

○

cmx_start_target

○

○

○

○

○

cmx_stop_target

○

○

○

○

○

cmx_test_lb

○

○

○

○

○

cmx_trans_param

×

×

×

×

×

（凡例）

○：有効です。

×：無効です。指定した場合，無視されます。

終了コード

Smart Composer機能で使用するコマンドは，次の範囲で戻り値を返します。

表8‒6　Smart Composer機能で使用するコマンドの戻り値

戻り値

意味

0

コマンドの処理が正常終了しました。

1〜63

コマンドの処理で軽微な障害が発生しました。

64〜127

コマンドの処理が異常終了しました。

cmx_admin_passwd（Management Serverの管理ユーザアカウントの設定）

形式

cmx_admin_passwd [共通引数] [-np <新管理ユーザパスワード>] [-nu <新管理ユーザID>]

機能

Management Serverへログインするための管理ユーザアカウントを設定します。新管理ユーザアカウントを指定している場合は，設定済みの管理ユーザアカウントを新管理ユーザアカウントに変更します。また，-npオプションに空文字（""）を指定している場合は，設定済みの管理ユーザパスワードを解除します。

引数

-np <新管理ユーザパスワード>

新しいManagement Serverの管理ユーザパスワードを指定します。

-nu <新管理ユーザID>

新しいManagement Serverの管理ユーザIDを指定します。

入力例

新規に管理ユーザアカウントを設定する場合

cmx_admin_passwd -m localhost -u admin01 -p p1574809

設定済みの管理ユーザアカウントを変更する場合

cmx_admin_passwd -m localhost -u admin01 -p p1574809 -np passwd123 -nu admin02

管理ユーザパスワードを解除する場合

cmx_admin_passwd -m localhost -u admin01 -p p1574809 -np ""

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

管理ユーザパスワードが設定されていない状態で，-npオプションを指定したコマンドを入力すると，共通引数の-pオプションの指定は無視されて，新管理ユーザパスワードが設定されます。また，管理ユーザIDが設定されていない状態で，-nuオプションを指定したコマンドを入力すると，共通引数の-uオプションの指定は無視されて，新管理ユーザIDが設定されます。管理ユーザアカウントの省略機能を有効にしている場合，メッセージを表示し，終了コード0を出力します。また，管理ユーザアカウントの設定はしません。管理ユーザアカウントの省略機能については，マニュアル「アプリケーションサーバシステム構築・運用ガイド」の「4.1.15(3)　管理ユーザアカウントを設定しない場合の設定」を参照してください。

-npオプションにパスワードを指定した場合，このコマンドの実行中に，プロセスの引数を確認できるOS機能などでパスワードが観測されるおそれがあります。-npオプションを使用する際は，プロセスの引数を確認できるOS機能などを，他ユーザが使用できない状況下で実施してください。このため，管理ユーザアカウントを設定する場合や，設定済みの管理ユーザアカウントを変更したい場合は，mngsvrctlコマンドで引数setupと-interactiveオプションを指定して対話形式で実行することを推奨します。または運用管理ポータルの「Cosminexus Management Serverの設定」の［管理ユーザアカウントの設定］画面で設定してください。共通引数の-pオプションは，.cmxrc（クライアント設定プロパティファイル）またはcmxclient.properties（クライアント共通設定ファイル）にパスワードを設定することで指定を省略できます。mngsvrctlコマンドについては，「7.2　Management Serverで使用するコマンドの詳細」の「mngsvrctl（Management Serverの起動／停止／セットアップ）」を参照してください。運用管理ポータルについては，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「8.2.1　管理ユーザアカウントの設定」を参照してください。

cmx_build_model（Webシステムの情報モデルの生成）

形式

cmx_build_model [共通引数] -f <簡易構築定義ファイル>

機能

cmx_build_modelコマンドを使用すると，簡易構築定義ファイルの内容に従って，Management Serverにホストおよび論理サーバを定義し，Webシステムの情報モデルを構築します。

cmx_build_modelコマンドでManagement Server上に論理サーバ名が定義される場合のルールについては，「cmx_build_system」を参照してください。

引数

-f <簡易構築定義ファイル>

簡易構築定義ファイルのパスを指定します。

入力例

cmx_build_model -f MyWebSystemDef.xml

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

構築済みのWebシステムを処理対象に指定した場合はエラーになります。

cmx_build_systemコマンドを使用して，Webシステムの情報モデルの生成から，Webシステムの構築まで一括で実行することをお勧めします。

cmx_build_system（Webシステムの構築）

形式

Webシステムの構築

簡易構築定義ファイルからWebシステムを構築する場合

cmx_build_system [共通引数] -f <簡易構築定義ファイル>

[-lb {keepvs|deletevs}]

登録済みの情報モデルを基にWebシステムを構築する場合

cmx_build_system [共通引数] [-s <Webシステム名>]

[-lb {keepvs|deletevs}] [-sd]

Webシステムに関連づいていない論理サーバを含むシステムを構築する場合

cmx_build_system [共通引数] -ns

構築済みのシステムのパラメタ変更

構築済みのシステムのパラメタを簡易構築定義ファイルで変更する場合

cmx_build_system [共通引数] -f <簡易構築定義ファイル> -change

機能

Webシステムを構築します。また，構築済みのシステムのパラメタを変更します。

Webシステムの構築

登録済みのWebシステムの情報モデルに従って，Webシステムを構築します。または，簡易構築定義ファイルの内容に従って，Webシステムの情報モデルを生成し，その情報モデルに従ってWebシステムを構築します。

cmx_build_systemコマンドは，各ホストのWebサーバとJ2EEサーバのセットアップ，および各論理サーバの環境を設定します。また，必要に応じて負荷分散機に仮想サーバや実サーバを作成します。

登録済みの情報モデルを基にWebシステムを構築する場合，簡易構築定義ファイルからWebシステムを構築する場合，またはWebシステムに関連づいていない論理サーバを含むシステムを構築する場合で，構築のしかたが異なります。

簡易構築定義ファイルからWebシステムを構築する場合

指定した簡易構築定義ファイルの内容に従って，Webシステムの情報モデルを構築します。さらに，その情報モデルに従って，Webシステムを構築します。あらかじめcmx_build_modelでモデルを登録しないで，Webシステムの構築ができます。

登録済みの情報モデルを基にWebシステムを構築する場合

cmx_build_modelコマンド，またはcmx_change_modelコマンドで登録したWebシステムの情報モデルに従って，Webシステムを構築します。各ホストのサーバに設定情報が配布されているかどうかに関係なく，常に論理サーバの設定情報を配布します。設定情報が配布されていない論理サーバの設定情報だけを配布したい場合は，-sdオプションを指定して実行してください。

Webシステムに関連づいていない論理サーバを含むシステムを構築する場合

cmx_build_modelコマンド，またはcmx_change_modelコマンドで登録したWebシステムの情報モデルに従って，Webシステムに関連づいていない論理サーバを含むシステムを構築します。

構築済みのシステムのパラメタ変更

-changeオプションを指定することで，構築済みのシステムのパラメタを，-fオプションで指定した簡易構築定義ファイルに定義されたパラメタに変更します。

-changeオプションを指定して構築済みのシステムのパラメタを変更する場合

-fオプションにパラメタ変更済みの簡易構築定義ファイルを指定して，-changeオプションを指定します。-fオプションで指定した簡易構築定義ファイルの内容に従って，Webシステムの情報モデルを，パラメタを変更した状態で再生成します。さらに，その情報モデルを基にして，Webシステムを再構築します。ただし，構成変更はできません。

Webシステムの構築時に，論理サーバ名を簡易構築定義ファイルで定義していない場合，Management Server上に論理サーバ名が定義されます。なお，登録済みの情報モデルに従ってWebシステムを構築する場合，論理サーバ名はcmx_build_modelコマンド実行時に定義されます。Management Server上に論理サーバ名が定義されるときのルールを次に示します。

論理サーバ名の定義ルール

論理サーバ名は次の形式で定義されます。

形式

cmx_<Webシステム名>_<サービスユニット名>_<種別>_<通番>

<種別>は，論理サーバの種類によって異なります。論理サーバの種類と<種別>との対応を次の表に示します。

表8‒7　論理サーバの種類と<種別>との対応

論理サーバの種類

<種別>

論理Webサーバ

HTTP

論理J2EEサーバ

J2EE

論理パフォーマンストレーサ

PRF

論理CTMドメインマネジャ

CTMDM

論理CTM

CTM

論理スマートエージェント

SA

論理ユーザサーバ

USER

<通番>は，基本的に「01」が設定されます。ただし，CTMを使用するシステムのように論理サーバを複数配置する場合は，重複しない番号が割り振られます。

ACOS使用時の実サーバ名称について

負荷分散機にACOSを使用する場合，負荷分散機によるリクエストの振り分け先を表す実サーバとして，cmx_build_systemコマンドでは次の名称で実サーバを作成しますので，誤って削除しないように注意してください。

形式

cmx_rs_<WebサーバマシンのIPアドレス>

引数

-f <簡易構築定義ファイル>

簡易構築定義ファイルのパスを指定します。

簡易構築定義ファイルの内容に従って，Webシステムの情報モデルが生成されます。さらに，その情報モデルを基にしてWebシステムが構築されます。

-s <Webシステム名>

Webシステム名を指定します。

登録済みの情報モデルから，指定したWebシステムが構築されます。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-fオプションを指定している場合には指定が無効になります。

-lb

この引数は使用する負荷分散機の種類がBIG-IP v9，BIG-IP v10.1，BIG-IP v10.2，およびBIG-IP v11の場合に有効になります。

負荷分散機の仮想サーバを初期化するかどうかを指定します。JP1/SC/DPMを使用しないで，ホスト単位管理モデルで構築した負荷分散機を使用するWebシステムをスケールアウトする場合に指定します。

keepvs

負荷分散機の仮想サーバは初期化しません。複数のホストで負荷分散機の仮想サーバを共有する場合に指定します。

deletevs

負荷分散機の仮想サーバを初期化します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.lbキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.lbキーを省略している場合に，このオプションを省略したときはdeletevsが仮定されます。.cmxrcファイルについては，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「4.2.2　.cmxrc（クライアント設定プロパティファイル）」を参照してください。cmxclient.propertiesファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.2.3　cmxclient.properties（クライアント共通設定プロパティファイル）」を参照してください。

-sd

設定情報が配布されていない論理サーバの設定情報だけを，各ホストのサーバに配布します。各ホストのサーバに設定情報を強制的に配布（上書き）したくない場合に，このオプションを設定してください。

-ns

登録済みの情報モデルから，Webシステムに関連づいていない論理サーバを含むシステムを構築する場合に指定します。

このオプションを指定する場合，cmx_build_modelコマンドを使用して，情報モデルを登録しておく必要があります。cmx_build_modelコマンドについては，「cmx_build_model」を参照してください。

-change

パラメタを変更する場合に指定します。

-fオプションで指定した簡易構築定義ファイルの内容に従って，Webシステムの情報モデルが再生成されます。さらに，その情報モデルを基にしてWebシステムが再構築されます。

入力例

簡易構築定義ファイルからWebシステムを構築する場合

cmx_build_system -f MyWebSystemDef.xml

登録済みの情報モデルを基にWebシステムを構築する場合

cmx_build_system -s sample-system

Webシステムに関連づいていない論理サーバを含むシステムを構築する場合

cmx_build_system -ns

構築済みのシステムのパラメタを簡易構築定義ファイルで変更する場合

cmx_build_system -f MyWebSystemDef2.xml -change

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

-changeオプションを指定する場合，次のことに注意してください。

構築済みのWebシステムに対してパラメタ（<param>タグで指定する論理サーバのパラメタ）変更以外の変更をしようとした場合はエラーになります。

-fオプションで指定した簡易構築定義ファイルのスキーマのバージョンが，構築済みのシステムの構築時に使用した簡易構築定義ファイルのスキーマのバージョンより古いときは，動作が保証されません。

構築済みのシステムの構築時に使用した簡易構築定義ファイルのスキーマのバージョンが2.1以前の場合，-fオプションで指定する簡易構築定義ファイルのホストの定義の<host-ref>タグは次のように指定します。

<host-ref>タグに指定する値

構築済みのシステムの構築時に使用した簡易構築定義ファイルのホストの定義の<operational-ip>タグで指定している値

cmx_change_model（Webシステムの情報モデルの変更）

形式

cmx_change_model [共通引数] -f <構成変更定義ファイル>

機能

構成変更定義ファイルの内容に従って，Webシステムの情報モデルを変更（サービスユニット・ホストの追加またはパラメタの一括変更）します。

サービスユニット・ホストの追加

Webシステムの情報モデルに，構成変更定義ファイルで定義したサービスユニットまたはホストを追加します。サービスユニットに指定するホストには，新規のものも，Management Server上のWebシステムの情報モデルにあるものも指定できます。

cmx_change_modelコマンドでは，サービスユニットに対応するホストおよび論理サーバをManagement Serverに定義します。論理サーバ名の設定ルールについては，「cmx_build_system」を参照してください。

パラメタの一括変更

構成変更定義ファイルに指定した論理サーバのコンフィグレーション定義の情報に変更します。

引数

-f <構成変更定義ファイル>

構成変更定義ファイルのパスを指定します。

入力例

cmx_change_model -f MyWebSystemDef.xml

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

-fオプションで指定した構成変更定義ファイルのスキーマのバージョンが，構築済みのシステムの構築時に使用した簡易構築定義ファイルのスキーマのバージョンより古いときは，動作が保証されません。

構築済みのシステムの構築時に使用した簡易構築定義ファイルのスキーマのバージョンが2.1以前の場合，-fオプションで指定する構成変更定義ファイルのホストの定義の<host-ref>タグは次のように指定します。

<host-ref>タグに指定する値

構築済みのシステムの構築時に使用した簡易構築定義ファイルのホストの定義の<operational-ip>タグで指定している値

cmx_delete_system（Webシステムの削除）

形式

Webシステムを削除する場合

cmx_delete_system [共通引数] [-s <Webシステム名>] [-lb {keepvs|deletevs}]

サービスユニットを削除する場合

cmx_delete_system [共通引数] [-s <Webシステム名>] -unit <サービスユニット名>

Webシステムに関連づいていない論理サーバ，およびホストをすべて削除する場合

cmx_delete_system [共通引数] -ns

機能

Webシステム，またはWebシステム中のサービスユニットを削除します。-unitオプションの指定を省略した場合はWebシステムを，-unitオプションを指定した場合はWebシステム中のサービスユニットを削除します。ホスト単位管理モデルで構築したWebシステムの場合に，複数のアプリケーションサーバ（ホスト）で負荷分散機の仮想サーバを共有しているときは，-lbオプションで仮想サーバを削除するかどうかを指定して，Webシステムを削除してください。

また，-nsオプションを指定した場合は，Webシステムに関連づいていない論理サーバ，およびホストをすべて削除します。

なお，このコマンドはManagement Serverに登録したWebシステムの情報モデル，負荷分散機に設定した情報，および削除対象のWebシステムまたはサービスユニットに関連づいている，すべてのホストも削除します。ただし，ほかのWebシステムや削除対象外のサービスユニットから参照しているホスト，およびSmart Composer機能以外で論理サーバを追加したホストは削除しません。運用管理ドメイン内に登録されていて，Webシステムと関連づいていないホストを削除する場合は，一時的なWebシステムやサービスユニットに削除対象とするホストを関連づけて，関連づけたWebシステムまたはサービスユニットごと削除する必要があります。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-unit <サービスユニット名>

サービスユニット名を指定します。

-lb

負荷分散機の仮想サーバを削除するかどうかを指定します。ホスト単位管理モデルで構築したWebシステムをスケールアウトする場合に指定します。

keepvs

負荷分散機の仮想サーバは削除しません。負荷分散機の設定情報を削除します。複数のホストで負荷分散機の仮想サーバを共有している場合に指定します。

deletevs

負荷分散機の仮想サーバおよび負荷分散機の設定情報を削除します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.lbキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.lbキーを省略している場合に，このオプションを省略したときはdeletevsが仮定されます。.cmxrcファイルについては，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「4.2.2　.cmxrc（クライアント設定プロパティファイル）」を参照してください。cmxclient.propertiesファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.2.3　cmxclient.properties（クライアント共通設定プロパティファイル）」を参照してください。

-ns

Webシステムに関連づいていない論理サーバ，およびホストをすべて削除します。

入力例

cmx_delete_system -s sample-system -unit unit1

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

このコマンドで，Webシステムやサービスユニットを削除した場合，サービスユニットを構成するホストにWebサーバやJ2EEサーバの環境が残ります。

このホストをSmart Composer機能を使って再利用する場合は，次の方法でサーバの環境をアンセットアップしてください。

Webサーバの環境のアンセットアップ

HTTP Serverのユーティリティを使用してアンセットアップします。

ユーティリティに指定するWebサーバ名は，「HWS_<Webサーバの論理サーバ名>」の形式で指定します。Webサーバの論理サーバ名はcmx_list_modelコマンドを使用して参照できます。cmx_delete_systemコマンドを実行する前に論理サーバ名を確認してください。

ただし，物理ティアのrealservernameパラメタでWebサーバの実サーバ名を指定している場合は，ユーティリティに指定するサーバ名は，「HWS_<Webサーバの実サーバ>」を指定してください。

J2EEサーバの環境のアンセットアップ

サーバ管理コマンドのcjsetupコマンドを使用してアンセットアップします。

コマンドには，J2EEサーバの論理サーバ名を指定します。J2EEサーバの論理サーバ名はcmx_list_modelコマンドを使用して参照できます。cmx_delete_systemコマンドを実行する前に論理サーバ名を確認してください。

ただし，物理ティアのrealservernameパラメタでJ2EEサーバの実サーバ名を指定している場合は，コマンドに指定するサーバ名は実サーバ名を指定してください。

それぞれのサーバの環境削除の例を次に示します。

Webサーバの環境削除の例

Windowsの場合

<Application Serverのインストールディレクトリ>¥httpsd¥admin¥bin¥hwsserveredit -delete HWS_cmx_sample-system_unit1_HTTP_01

UNIXの場合

/opt/hitachi/httpsd/admin/bin/hwsserveredit -delete HWS_cmx_sample-system_unit1_HTTP_01

J2EEサーバの環境削除の例

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥bin¥cjsetup -d cmx_sample-system_unit1_J2EE_01

UNIXの場合

/opt/Cosminexus/CC/server/bin/cjsetup -d cmx_sample-system_unit1_J2EE_01

HTTP Serverのユーティリティについてはマニュアル「HTTP Server」を参照してください。

このコマンドを実行すると，論理ユーザサーバも同時に削除されます。

cmx_export_model（簡易構築定義ファイルの出力）

形式

cmx_export_model [共通引数] [-indent <インデントサイズ>] [-myhost <置換するホスト名>] [-encoding <文字エンコーディング名>] -o <出力ファイル>

機能

構築されているWebシステムの内容に従って，簡易構築定義ファイルを出力します。

引数

-indent <インデントサイズ>

簡易構築定義ファイルのタグのインデントサイズを指定します。下位タグの開始位置を上位のタグから半角スペースで何文字分右にずらすかを0〜8の範囲で指定します。

「-indent 4」を指定した場合の出力例

<web-system>
△△△△<name>MyWebSystem</name>
△△△△<tier>
△△△△△△△△<tier-type>combined-tier</tier-type>
△△△△</tier>
       ：

（凡例）△：半角スペース1文字分

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.indentキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.indentキーを省略している場合に，このオプションを省略してコマンドを実行したときは，2が設定されます。

-myhost <置換するホスト名>

出力する簡易構築定義ファイルの運用管理サーバマシンのホスト名を指定します。

ホスト単位管理モデルのシステムを，別のホストに移行する場合に指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.myhostキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.myhostキーを省略している場合に，このオプションを省略してコマンドを実行したときは，出力する簡易構築定義ファイルの運用管理サーバマシンのホスト名が設定されません。

なお，移行先の環境で，このオプションの指定が有効になるのは次の場合です。

ホストの定義の<host-name>に，移行先の環境の運用管理サーバマシンのIPアドレスと一致するIPアドレス，または移行先の環境の運用管理サーバマシンのIPアドレスと一致するIPアドレスに変換できるホスト名を指定している。

ホストの定義の<host-name>にlocalhostかループバックアドレスを指定している。

これらの条件を満たさないホスト名を指定した場合，動作を保証できなくなるおそれがあるので，-myhostを使用しないでください。

指定する値は，移行先の環境の運用管理サーバマシンのホスト名，または@myhostです。移行先の環境の運用管理サーバマシンのホスト名を指定した場合と，@myhostを指定した場合のホスト名の置換について，それぞれ説明します。

移行先の環境の運用管理サーバマシンのホスト名を指定する場合

移行先の環境の運用管理サーバマシンのホスト名を指定すると，出力する簡易構築定義ファイルで，次に示すタグの値が指定したホスト名に置換されます。

ホストの定義の<host-name>タグ

ユニットの定義の<host-ref>タグ

論理サーバのコンフィグレーションに指定されているパラメタのホスト名

@myhostを指定する場合

@myhostを指定すると，出力する簡易構築定義ファイルで，次に示すタグの値が@myhostに置換されます。

ユニットの定義の<host-ref>タグ

論理サーバのコンフィグレーションに指定されているパラメタのホスト名

@myhostを指定した場合，ホストの定義は出力されません。ただし，@myhostを指定した場合に，ホストの定義の<display-name>タグ，<description>タグ，<agent-host>タグ，または<agent-port>タグに値を指定したときは，ホストの定義が出力されます。

-encoding <文字エンコーディング名>

出力する簡易構築定義ファイルの文字エンコーディングを指定します。指定を省略した場合はUTF-8が設定されます。

設定できる文字エンコーディングは，JavaVMがサポートしている文字エンコーディングとなります。JavaVMがサポートしている文字エンコーディングについては，JDKのドキュメントのサポートされているエンコーディングに関する説明を参照してください。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.encodingキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.encodingキーを省略している場合に，このオプションを省略してコマンドを実行したときは，UTF-8が設定されます。

-o <出力ファイル>

出力する簡易構築定義ファイルの出力先を指定します。

入力例

<Application Serverのインストールディレクトリ>¥manager¥bin¥cmx_export_model -o c:¥temp¥MyWebSystemexport.xml

出力形式

XMLファイル形式の簡易構築定義ファイルで出力します。簡易構築定義ファイルの出力例については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.3　簡易構築定義ファイル」を参照してください。

注意事項

Smart Composer機能で構築したシステムに当てはまらない構成は，free-tier構成で出力されます。出力した簡易構築定義ファイルに，free-tierの定義が含まれていた場合，出力した簡易構築定義ファイルに対して，Smart Composer機能のコマンドでは，システム構築以外の操作は実行できません。

-myhost指定時，置換対象のホストが複数存在した場合，エラーになります。

-myhost指定時，置換対象のホストが一つだけで，<host-name>タグと<agent-host>タグが異なる場合，エラーになります。

cmx_list_model（Webシステムの情報モデルの取得）

形式

Webシステムの情報モデルを取得する場合

cmx_list_model [共通引数] -modeltype {SERVER|APPLICATION|RESOURCE|RESADAPTER|RESJAVABEANS|SERVEREX} [{-s <Webシステム名>|-all|-r}]

Webシステムに関連づいていない論理サーバの一覧を取得する場合

cmx_list_model [共通引数] -ns

機能

Webシステムの情報モデルを取得する場合

登録されているWebシステムの情報モデルを取得し，標準出力に取得結果を出力します。

-sオプション，または.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーでWebシステム名が指定されている場合は，そのWebシステムだけを対象とします。

Webシステムに関連づいていない論理サーバの一覧を取得する場合

Webシステムに関連づいていない論理サーバの一覧を取得し，標準出力に取得結果を出力します。一覧には論理サーバの種別も表示します。

引数

-modeltype

表示する対象を指定します。

SERVER

Webシステムの情報モデル中の論理サーバの一覧を表示します。

APPLICATION

Webシステムの情報モデル中のJ2EEアプリケーションの一覧を表示します。

RESOURCE※

Webシステムの情報モデル中のリソースアダプタの一覧を表示します。

RESADAPTER

Webシステムの情報モデル中のリソースアダプタの一覧を表示します。

RESJAVABEANS

Webシステムの情報モデル中のJavaBeansリソースの一覧を表示します。

SERVEREX

Webシステムの情報モデル中の論理サーバの一覧を表示します。一覧には論理サーバの種別も表示します。

注※　互換用の引数です。RESADAPTERを使用することをお勧めします。

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。

-all

登録されているすべてのWebシステムを表示する対象とします。

-r

J2EEアプリケーションの一覧，またはリソースアダプタの一覧を表示する場合に指定します。

-ns

Webシステムに関連づいていない論理サーバの一覧表示する場合に指定します。

出力形式

CSV形式で出力します。

Webシステムの情報モデルを取得する場合

論理サーバ一覧の場合（SERVER指定時）

<論理サーバ名>,<ホスト名>,<ティア種類>※,<サービスユニット名>,<Webシステム名>

注※

論理ユーザサーバの場合，ティア種類には空文字が出力されます。

論理サーバ一覧の場合（SERVEREX指定時）

<論理サーバ名>,<論理サーバ種別>,<ホスト名>,<ティア種類>※,<サービスユニット名>,<Webシステム名>

注※

論理ユーザサーバの場合，ティア種類には空文字が出力されます。

Webシステムに関連づけられたアプリケーション一覧の場合

<アプリケーション表示名>,<アプリケーションバージョン>,<Webシステム名>

登録されているJ2EEアプリケーション一覧の場合

<アプリケーション表示名>,<アプリケーションバージョン>

Webシステムに関連づけられたリソースアダプタ一覧の場合

<リソースアダプタ表示名>,<Webシステム名>

登録されているリソースアダプタ一覧の場合

<リソースアダプタ表示名>

Webシステムに関連づけられたJavaBeansリソース一覧の場合

<JavaBeansリソース表示名>,<Webシステム名>

登録されているJavaBeansリソース一覧の場合

<JavaBeansリソース表示名>

Webシステムに関連づいていない論理サーバの一覧

<論理サーバ名>,<論理サーバ種別>,<ホスト名>

入力例・出力例

論理サーバ一覧（SERVER指定時）

>cmx_list_model -modeltype SERVER
cmx_Web01_Unit01_PRF_01,Host01,combined-tier,Unit01,Web01
cmx_Web01_Unit01_J2EE_01,Host01,combined-tier,Unit01,Web01
cmx_Web01_Unit01_HTTP_01,Host01,combined-tier,Unit01,Web01
cmx_Web01_Unit02_PRF_01,Host01,combined-tier,Unit02,Web01
cmx_Web01_Unit02_J2EE_01,Host01,combined-tier,Unit02,Web01
cmx_Web01_Unit02_HTTP_01,Host01,combined-tier,Unit02,Web01
cmx_Web02_Unit01_PRF_01,Host01,combined-tier,Unit01,Web02
cmx_Web02_Unit01_USER_01,Host01,,Unit01,Web02
：

論理サーバ一覧（SERVEREX指定時）

>cmx_list_model -modeltype SERVER
cmx_Web01_Unit01_PRF_01,PRF,Host01,combined-tier,Unit01,Web01
cmx_Web01_Unit01_J2EE_01,J2EEServer,Host01,combined-tier,Unit01,Web01
cmx_Web01_Unit01_HTTP_01,Webserver,Host01,combined-tier,Unit01,Web01
cmx_Web01_Unit02_PRF_01,PRF,Host01,combined-tier,Unit02,Web01
cmx_Web01_Unit02_J2EE_01,J2EEServer,Host01,combined-tier,Unit02,Web01
cmx_Web01_Unit02_HTTP_01,Webserver,Host01,combined-tier,Unit02,Web01
cmx_Web02_Unit01_PRF_01,PRF,Host01,combined-tier,Unit01,Web02
cmx_Web02_Unit01_USER_01,UserServer,Host01,,Unit01,Web02
：

Webシステムに関連づけられたアプリケーション一覧

>cmx_list_model -modeltype APPLICATION
App01,Ver01,Web01
App02,Ver02,Web02
App03,Ver01,Web02

登録されているアプリケーション一覧

>cmx_list_model -modeltype APPLICATION -r
App01,Ver01
App02,Ver01
App02,Ver02
App03,Ver01

Webシステムに関連づけられたリソースアダプタ一覧

>cmx_list_model -modeltype RESADAPTER
Rar01,Web01
Rar02,Web02

登録されているリソースアダプタ一覧

>cmx_list_model -modeltype RESADAPTER -r
Rar01
Rar02
Rar03
Rar04

Webシステムに関連づけられたJavaBeansリソース一覧

>cmx_list_model -modeltype RESJAVABEANS
Jar01,Web01
Jar02,Web02

登録されているJavaBeansリソース一覧

>cmx_list_model -modeltype RESJAVABEANS -r
Jar01
Jar02
Jar03
Jar04

Webシステムに関連づいていない論理サーバ一覧

>cmx_list_model -ns
PRF_01,PRF,Host01
J2EE_01,J2EEServer,Host01
HTTP_01,Webserver,Host01
：

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

-sオプション，-allオプション，および.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーの指定をすべて省略した場合は，登録されているすべてのWebシステムを表示する対象とします。

.cmxrcファイル，またはcmxclient.propertiesファイルのcmx.websystem.nameキーにWebシステム名を指定している場合に，すべてのWebシステムのモデルを取得するには，-allオプションを指定してください。

modeltype SERVERと-rを同時に指定した場合，エラーになります。

統合ネーミングスケジューラサーバ用のWebシステムの場合，-modeltypeオプションにAPPLICATION，RESOURCE，RESADAPTER，またはRESJAVABEANSを指定すると，何も表示されません。

cmx_list_status（サービスユニット状況の表示）

形式

Webシステム中のサービスユニットのステータスを取得する場合

cmx_list_status [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>]

Webシステムに関連づいていない論理サーバのステータスを取得する場合

cmx_list_status [共通引数] -ns

機能

Webシステム中のサービスユニットのステータスを取得する場合

サービスユニットの稼働状況のステータス，およびサービスユニットに対するcmx_build_systemコマンドの実行状態を取得し，標準出力に取得結果を出力します。

サービスユニットの稼働状況のステータス

サービスユニットの状態を取得し，標準出力に取得結果を出力します。出力されるサービスユニット稼働状況のステータスを次に示します。

working

稼働状態を表します。サービスユニット中の全論理サーバが稼働中で，負荷分散機からリクエストが振り分けられる状態（閉塞解除状態）です。負荷分散機がない場合は，cmx_start_targetコマンドで-modeオプションにALLを指定して実行したときの状態です。

ready

準備状態を表します。サービスユニット中の全論理サーバが稼働中で，負荷分散機からのリクエスト振り分けが抑止されている状態（閉塞状態）です。負荷分散機がない場合は，cmx_start_targetコマンドで-modeオプションにREADYを指定して実行したときの状態です。通常，アプリケーションのテストなどは，停止状態から準備状態にして，アプリケーションのデプロイや外部との接続をしないで実施します。

hold

閉塞状態を表します。サービスユニット中のWebサーバが計画停止済み（ほかの論理サーバは稼働中）で，負荷分散機からのリクエスト振り分けが抑止されている状態（閉塞状態）です。通常，J2EEアプリケーションの入れ替えなどは，稼働状態から閉塞状態にして，実施します。なお，閉塞状態と準備状態との違いは，Webサーバが起動しているかどうかだけです。

stopped

停止状態を表します。サービスユニット中の全論理サーバが停止済みで，負荷分散機からのリクエスト振り分けが抑止されている状態（閉塞状態）です。

no working

未稼働状態を表します。サービスユニット中の論理サーバの一部が稼働中または全論理サーバが停止済みで，負荷分散機からリクエストが振り分けられる状態（閉塞解除状態）です。負荷分散機がない場合は出力されません。

no ready

未準備状態を表します。サービスユニット中のWebサーバが停止済みでほかの論理サーバの一部が稼働中，またはサービスユニット中のWebサーバが稼働中でほかの論理サーバの一部が稼働中もしくは全論理サーバが停止済みで，負荷分散機からのリクエスト振り分けが抑止されている状態（閉塞状態）です。

cmx_build_systemコマンドの実行状態

サービスユニットに対するcmx_build_systemコマンドの実行状態を取得し，標準出力に取得結果を出力します。出力されるcmx_build_systemコマンドの実行状態を次に示します。

done

実行済み状態を表します。cmx_build_systemコマンドを実行して，負荷分散機および論理サーバがセットアップ済みで，論理サーバの設定情報が配布済みの状態です。

not done

未実行状態を表します。cmx_build_systemコマンドの実行に失敗した状態（負荷分散機または論理サーバのどれかが未セットアップまたは未配布）です。

コマンドのオプションで，サービスユニットが指定されていれば特定のサービスユニットが，省略されていればWebシステム中の全ユニットが表示の対象となります。

なお，それぞれのJ2EEアプリケーションやそれぞれの論理サーバの稼働状態を知りたい場合は，mngsvrutilコマンドを使用してください。mngsvrutilコマンドについては，「7.2　Management Serverで使用するコマンドの詳細」の「mngsvrutil（Management Serverの運用管理コマンド）」を参照してください。

Webシステムに関連づいていない論理サーバのステータスを取得する場合

論理サーバの稼働状況のステータス

論理サーバの状態を取得し，標準出力に取得結果を出力します。出力されるサービスユニット稼働状況のステータスについては，マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「4.4　論理サーバの運用監視」を参照してください。

論理サーバの設定情報の配布の実行状態

論理サーバに対する設定情報の配布の実行状態を取得し，標準出力にdone（実行済み）とnot done（未実行）で取得結果を出力します。設定情報の配布が実行済みの状態とは，次の2種類の状態を指します。

cmx_build_systemコマンドを引数に-nsを指定して実行し，正常にシステムの構築が完了した状態

運用管理ポータルで正常に論理サーバの配布が完了した状態

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-unit <サービスユニット名>

サービスユニット名を指定します。

-ns

Webシステムに関連づいていない論理サーバのステータスを取得する場合に指定します。

出力形式

CSV形式で出力されます。

Webシステム中のサービスユニットのステータスを表示する場合

<サービスユニット名>,<Webシステム名>,<cmx_build_system実行状態>,<サービスユニットの稼働状態>

Webシステムに関連づいていない論理サーバのステータスを表示する場合

<論理サーバ名>,<論理サーバの設定情報の配布の実行状態>※,<論理サーバの稼働状態>

注※

論理サーバの種別がJ2EEサーバ，Webサーバ以外の場合は論理サーバの設定情報の配布の実行状態は空文字で表示されます。

入力例・出力例

Webシステム中のサービスユニットのステータスを表示する場合

>cmx_list_status -s sample-system
unit01,sample-system,done,working
unit02,sample-system,done,ready
unit03,sample-system,done,hold
unit04,sample-system,done,stopped
unit05,sample-system,done,no working
unit06,sample-system,not done,no ready

Webシステムに関連づいていない論理サーバのステータスを表示する場合

>cmx_list_status -ns
PRF01,,working
J2EE01,done,working
HTTP01,done,working

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

CTM用のサービスユニットおよび統合ネーミングスケジューラサーバ用のサービスユニットの場合，サービスユニットの稼働状況のステータスには，「working」，「stopped」および「no ready」の3種類が表示されます。

CTM用のサービスユニットに複数のJ2EEサーバを配置している場合に，サービスユニットが正常に起動したあと，一部のJ2EEサーバが異常停止したときは，サービスユニットの稼働状況のステータスには「no working」または「no ready」が表示されます。

cmx_resume_lb（負荷分散機の設定再開始）

形式

cmx_resume_lb [共通引数] [-s <Webシステム名>]

機能

負荷分散機を冗長化したシステムの場合に，障害の発生した負荷分散機の休止状態を解除して，設定処理を再開します。

負荷分散機を冗長化したシステムの場合，cmx_build_systemコマンドなどを入力すると，2台の負荷分散機に対して同じ設定が同時に実行されます。一方の負荷分散機で障害が発生すると，障害が発生した負荷分散機に対する設定は抑止され，もう一方の負荷分散機だけに設定を実行する運用になります。この場合，障害の発生した負荷分散機を正常な負荷分散機と同じ設定に復旧してから，cmx_resume_lbコマンドを実行します。cmx_resume_lbコマンドが正常に受け付けられると，両方の負荷分散機に対して同じ設定を同時に実行する運用に回復されます。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

入力例

cmx_resume_lb -s sample-system

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

負荷分散機を冗長化したシステムでない場合，または負荷分散機が休止状態でない場合はエラーになります。

cmx_scaleout_host（Webシステムの情報モデルの変更）

形式

cmx_scaleout_host [共通引数] -f <スケールアウト用ホスト定義ファイル>

機能

スケールアウト用ホスト定義ファイルの内容に従って，ホスト単位管理モデルのWebシステムの情報モデルを変更します。JP1/SC/DPMを利用して，ホスト単位管理モデルのWebシステムをスケールアウトする場合に使用します。このコマンドは複製先のホストで実行します。

引数

-f <スケールアウト用ホスト定義ファイル>

スケールアウト用ホスト定義ファイルのパスを指定します。

入力例

cmx_scaleout_host -f MyWebSystemHostScaleout.xml

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

運用管理サーバモデルのWebシステムのホストに対して，このコマンドを実行した場合はエラーになります。

負荷分散機およびCTMを使用したシステムで，このコマンドを実行する場合の注意事項を次に示します。

負荷分散機を使用したシステムの場合

複製元のホストと複製先のホストは，負荷分散機の仮想サーバを共有します。負荷分散機で使用するサーバIDの割り振りルールの範囲が，ホスト間で重複しないように，スケールアウト用ホスト定義ファイルを設定してください。

CTMを使用したシステムの場合

複製元のホストと複製先のホストは，同じCTMドメインに属します。複製元のホストにCTM識別子が定義されている場合，複製先のホストにも同じCTM識別子が定義されるため，CTMドメイン内でCTM識別子が重複することになります。このため，複製元のホストでは，CTM識別子の設定を省略することをお勧めします。CTM識別子の設定を省略した場合，CTM識別子は，ホスト間で一意になるように，Management Serverで自動的に設定されます。

なお，複製元のホストでCTM識別子を定義している場合は，このコマンドを実行したあとに，複製先のホストのCTM識別子をCTMドメイン内でユニークになるように設定し直してください。

cmx_start_target（Webシステムまたはサービスユニットの開始）

形式

Webシステムを開始する場合

cmx_start_target [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>] -mode { ALL|READY } [-strict]

Webシステムに関連づいていない論理サーバを含むシステムを開始する場合

cmx_start_target [共通引数] -ns

機能

システムの開始をします。Webシステムを開始する場合と，Webシステムに関連づいていない論理サーバを含むシステムを開始する場合で動作が異なります。それぞれの場合の動作について説明します。

Webシステムを開始する場合

指定されたモードに応じて，開始対象のサービスユニットの状態を稼働状態または準備状態にします。稼働状態とは，サービスユニット中の全論理サーバが稼働中で負荷分散機からリクエストが振り分けられる状態です。準備状態とは，サービスユニット中の全論理サーバが稼働中で，負荷分散機からのリクエスト振り分けが抑止されている状態です。

コマンドのオプションで，サービスユニットが指定されていれば特定のサービスユニットが，省略されていればWebシステム中の全サービスユニットが，開始の対象となります。

サービスユニットの状態は，cmx_list_statusコマンドで参照できます。サービスユニットの状態の種類，およびサービスユニットの状態の参照方法については，「cmx_list_status」を参照してください。

Webシステムに関連づいていない論理サーバを含むシステムを開始する場合

開始対象のシステムに含まれるすべての論理サーバを起動して，稼働状態にします。すでに稼働中の論理サーバは，引き続き稼働状態が保たれ，この操作によって再起動されることはありません。

運用管理ポータルで論理サーバの起動順序を設定している場合は，その順序に従って起動されます。

Webシステムに関連づいていない論理サーバの状態は，cmx_list_statusコマンドに-nsオプションを指定することで参照できます。論理サーバの状態の種類，および論理サーバの状態の参照方法については，「cmx_list_status」を参照してください。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-unit <サービスユニット名>

サービスユニット名を指定します。

-mode { ALL|READY }

開始モードを指定します。

ALL

停止状態，閉塞状態，準備状態を稼働状態に引き上げます。

READY

停止状態，閉塞状態を準備状態に引き上げます。

稼働状態のサービスユニットを準備状態に引き下げることはできません。

-strict

論理サーバの起動に失敗した場合に，以降の論理サーバの起動を中断するときに指定します。

このオプションを省略してコマンドを実行した場合，論理サーバの起動に失敗したとき，以降の論理サーバの起動を継続します。

-ns

Webシステムに関連づいていない論理サーバを含むシステムを起動する場合に指定します。

入力例

cmx_start_target -s sample-system -unit unit1 -mode ALL

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

戻り値の詳細を次の表に示します。

戻り値

サービスユニットが一つの場合

サービスユニットが複数の場合

0

すべての論理サーバの起動に成功しました。

すべてのサービスユニットの起動に成功※1しました。

1

−

一部のサービスユニットの起動に失敗※2しました。

64

一部の論理サーバの起動に失敗しました。

すべてのサービスユニットの起動に失敗※2しました。

（凡例）　−：なし。

注※1　サービスユニットの起動成功とは，サービスユニット中のすべての論理サーバの起動に成功したことです。

注※2　サービスユニットの起動失敗とは，サービスユニット中の一部の論理サーバの起動に失敗したことです。

注意事項

-unitオプションでCTM用または統合ネーミングスケジューラサーバ用のサービスユニットを指定する場合，-modeオプションにREADYを指定したときはエラーになります。-unitオプションを省略している場合に，-modeオプションにREADYを指定した場合，Webシステムに属するCTM用および統合ネーミングスケジューラサーバ用のサービスユニットの状態は，稼働状態に引き上げられます。

開始対象のサービスユニットに含まれている論理ユーザサーバは，-modeオプションの指定に関係なく，起動されます。開始対象のサービスユニットに論理ユーザサーバが含まれている場合に，論理ユーザサーバの起動に失敗したときは，サービスユニットの開始も失敗したとみなされます。この場合，-unitオプションを指定したコマンドは異常終了し，-unitオプションを省略したコマンドは警告終了します。

複数のJ2EEサーバを配置したCTM用のサービスユニットを起動する場合，一部のJ2EEサーバで起動処理を失敗しても，すべてのJ2EEサーバに対して起動処理を実行します。この場合，コマンドは異常終了します。

サービスユニットを一括起動すると，サービスユニットを構成する論理サーバは，論理サーバごとに設定した起動順序の昇順に従って起動されます。Smart Composer機能では，一括起動処理中に論理サーバの起動に失敗しても，そのまま処理を続行します。ただし，Webシステムに関連づいていない論理サーバを含むシステムの場合は，論理サーバの起動に失敗すると一括起動処理を中断します。論理サーバの起動に失敗していると，リクエストの受け付けを開始できない，受け付けたリクエストを処理できないなどの障害が発生します。一括起動時に-strictオプションを指定すると，論理サーバの起動に失敗した場合に，サービスユニットの一括起動処理を中断できます。

次に示す起動順序で論理J2EEサーバの起動に失敗した場合を例に，それぞれのシステムの処理について説明します。

論理サーバの起動順序

論理パフォーマンストレーサ

論理J2EEサーバ

論理Webサーバ

一括起動を続行したときのシステムの処理

論理Webサーバを起動してリクエストを受け付けます。論理J2EEサーバの起動に失敗しているため，受け付けたリクエストを処理できません。

一括起動を中断したときのシステムの処理

論理Webサーバを起動しません。このため，リクエストを受け付けません。

cmx_stop_target（Webシステムまたはサービスユニットの停止）

形式

Webシステムを停止する場合

cmx_stop_target [共通引数] [-s <Webシステム名>] [-unit <サービスユニット名>] -mode { ALL|HOLD }

Webシステムに関連づいていない論理サーバを含むシステムを停止する場合

cmx_stop_target [共通引数] -ns [-normal]

機能

Webシステムを停止する場合

指定されたモードに応じて，停止対象のサービスユニットの状態を停止状態または閉塞状態にします。停止状態とは，サービスユニット中の全論理サーバが停止済みで，負荷分散機からのリクエスト振り分けが抑止されている状態です。また，閉塞状態とは，サービスユニット中のWebサーバが計画停止済み（ほかの論理サーバは稼働中）で，負荷分散機からのリクエスト振り分けが抑止されている状態です。

コマンドのオプションで，サービスユニットが指定されていれば特定のサービスユニットが，省略されていればWebシステム中の全サービスユニットが停止の対象となります。

なお，このコマンドでは，実行中のクライアントからのリクエストを中断させないために，Webサーバは計画停止させます。

サービスユニットの状態は，cmx_list_statusコマンドで参照できます。サービスユニットの状態の種類，およびサービスユニットの状態の参照方法については，「cmx_list_status」を参照してください。

Webシステムに関連づいていない論理サーバを含むシステムを停止する場合

開始対象のシステムに含まれるすべての論理サーバを停止します。すでに停止中の論理サーバは，引き続き停止状態が保たれます。

運用管理ポータルで論理サーバの起動順序を設定している場合は，その順序の逆順に従って停止されます。また，Webサーバは計画停止します。計画停止とは，現在受け付けているすべてのリクエストの処理終了を待って論理サーバを停止させることです。Webサーバの計画停止をしたくない場合は-normalオプションを指定します。

Webシステムに関連づいていない論理サーバの状態は，cmx_list_statusコマンドに-nsオプションを指定することで参照できます。論理サーバの状態の種類，および論理サーバの状態の参照方法については，「cmx_list_status」を参照してください。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

-unit <サービスユニット名>

サービスユニット名を指定します。

-mode { ALL | HOLD }

停止モードを指定します。

ALL

稼働状態，準備状態，閉塞状態を停止状態に引き下げます。

HOLD

稼働状態，準備状態を閉塞状態に引き下げます。

停止状態のサービスユニットを閉塞状態に引き上げることはできません。

-ns

Webシステムに関連づいていない論理サーバを含むシステムを停止する場合に指定します。

-normal

Webサーバの計画停止をしたくない場合に指定します。このオプションを指定しないでコマンドを実行すると，Webサーバは計画停止します。

入力例

cmx_stop_target -s sample-system -unit unit1 -mode ALL

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

-unitオプションでCTM用または統合ネーミングスケジューラサーバ用のサービスユニットを指定する場合に，-modeオプションにHOLDを指定したときはエラーになります。-unitオプションを省略している場合に，-modeオプションにHOLDを指定した場合，Webシステム中のCTM用および統合ネーミングスケジューラサーバ用のサービスユニットは，稼働状態のままで変更されません。

停止対象のサービスユニットに論理ユーザサーバが含まれている場合に，-modeオプションにHOLDを指定したときは，サービスユニットは閉塞状態となりますが，論理ユーザサーバが停止されません。また，停止対象のサービスユニットに論理ユーザサーバが含まれている場合に，-modeオプションにALLを指定したときは，論理ユーザサーバが停止されます。論理ユーザサーバの停止に失敗した場合は，サービスユニットの停止も失敗したとみなされます。この場合，-unitオプションを指定したコマンドは異常終了し，-unitオプションを省略したコマンドは警告終了します。

複数のJ2EEサーバを配置したCTM用のサービスユニットを停止する場合，一部のJ2EEサーバで停止処理を失敗しても，すべてのJ2EEサーバに対して停止処理を実行します。この場合，コマンドは異常終了します。

サービスユニットを一括停止すると，停止対象のサービスユニットを負荷分散機から切り離し，実行中のリクエストを処理したあとに，サービスユニット内のすべての論理サーバを停止します。論理サーバは，論理サーバごとに設定した起動順序の降順に従って停止されます。

一括停止の場合，停止対象のシステムによって，論理サーバの停止に失敗したときの動作が異なります。

Webシステムの場合

論理Webサーバの停止に失敗すると，一括停止処理を中断します。そのほかの論理サーバの停止に失敗しても処理を続行します。

Webシステムに関連づいていない論理サーバを含むシステムの場合

論理サーバの停止に失敗しても処理を続行します。論理Webサーバの停止に失敗すると，リクエストの受け付けは継続されます。この場合，一括停止時に-modeオプションを指定して，停止対象のシステムをいったん閉塞状態にしてから，停止状態にします。

cmx_test_lb（負荷分散機との接続テスト）

形式

cmx_test_lb [共通引数] [-s <Webシステム名>]

機能

引数で指定されたWebシステムに定義している負荷分散機を操作できるか，テストします。

このコマンドを利用することで，簡易構築定義ファイルの負荷分散機の定義内容やSmart Composer機能の環境設定，およびJP1/Cm2/NCの環境設定が正しく設定されているかどうか確認できます。

引数

-s <Webシステム名>

Webシステム名を指定します。

このオプションを省略した場合は，.cmxrcファイルまたはcmxclient.propertiesファイルのcmx.websystem.nameキーで設定した値が仮定されます。なお，.cmxrcファイルおよびcmxclient.propertiesファイルのcmx.websystem.nameキーを省略している場合に，このオプションを省略してコマンドを実行したときは，エラーになります。

入力例

cmx_test_lb -s sample-system

戻り値

0：

負荷分散機の接続に成功しました。

1：

指定されたWebシステムには負荷分散機が定義されていません。

64：

負荷分散機との接続に失敗しました。

cmx_trans_param（抽象パラメタの展開）

形式

cmx_trans_param -i <入力ファイル> -p <抽象パラメタ指定> -o <出力ファイル>

機能

入力した簡易構築定義ファイル，または構成変更定義ファイル（論理サーバのパラメタ変更用）に対して，指定された抽象パラメタを展開し，Webシステムに適した物理ティアのコンフィグレーションを生成します。

このコマンドはV9互換モードだけで使用できます。簡易構築定義ファイルに，次のパラメタを指定する必要があります。

Webサーバ

パラメタ名：manager.web.send_request_method

パラメタ値：redirector

J2EEサーバ

パラメタ名：manager.j2ee.compat

パラメタ値：V9

参考

Webシステムを初期構築する場合は簡易構築定義ファイルを，構築したWebシステムの構成を変更する（論理サーバのパラメタを変更する）場合は構成変更定義ファイルを使用します。

なお，構成変更定義ファイルには，論理サーバのパラメタ変更用と，サービスユニット・ホスト追加用の2種類があります。このコマンドはWebシステムの初期構築をする場合，およびWebシステム全体の設定を変更する場合に使用するため，サービスユニット・ホスト追加用の構成変更定義ファイルは指定できません。

引数

-i <入力ファイル>

簡易構築定義ファイル，または構成変更定義ファイル（論理サーバのパラメタ変更用）を指定します。

-p <抽象パラメタ指定>

<抽象パラメタ指定>には，<抽象パラメタ>=<値>の形式で，抽象パラメタとその値を指定します。

抽象パラメタにはリクエスト最大同時処理数を指定します。リクエスト最大同時処理数のパラメタ名は「UnitMaxParallelCount」であるため，<抽象パラメタ指定>には，「UnitMaxParallelCount=<値>」を指定します。

なお，抽象パラメタの詳細については，「付録I　Smart Composer機能で使用できる抽象パラメタ（V9互換モードの場合）」を参照してください。

-o <出力ファイル>

抽象パラメタ展開後の出力ファイルを指定します。

入力例

cmx_trans_param -i MyWebSystemDef.xml -p UnitMaxParallelCount=10 -o outMyWebSystemDef.xml

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

注意事項

<入力ファイル>に指定した物理ティアがcombined-tier以外の場合はエラーになります。

9　仮想化システムで使用するコマンド

この章では，仮想化システムで使用するコマンドの入力形式，機能などについて説明します。

9.1　仮想化システムで使用するコマンドの一覧

仮想化システムで使用するコマンドの一覧を次の表に示します。

表9‒1　仮想化システムで使用するコマンドの一覧

コマンド名称

分類

概要

アカウントごとの実行可否

コマンド

サブコマンド

仮想サーバマネージャ管理者

システム構築者

rasetup

−

仮想サーバへのセットアップ・アンセットアップ

仮想サーバマネージャと連携して仮想サーバ上にシステム環境をセットアップまたはアンセットアップする機能を呼び出します。

−

−

vmiaccount

create

システム構築者アカウントの追加

仮想サーバマネージャにシステム構築者アカウントを追加します。

○

×

delete

システム構築者アカウントの削除

仮想サーバマネージャからシステム構築者アカウントを削除します。

○

×

help

vmiaccountコマンドのヘルプ表示

vmiaccountコマンドのヘルプを表示します。

○

○

list

システム構築者アカウントの一覧表示

仮想サーバマネージャに登録されているシステム構築者アカウントの一覧を表示します。

○

×

password

システム構築者アカウントのパスワード変更

システム構築者アカウントのパスワードを変更します。

○

○※1

vmiunit

attach

仮想サーバグループの登録

管理ユニットに仮想サーバグループを登録します。

○

○※2

block

管理ユニットまたは仮想サーバグループの閉塞

管理ユニットまたは仮想サーバグループを閉塞します。

○

○※2

compare

登録済みの定義ディレクトリとの内容比較

定義ディレクトリの内容を比較します。

○

○※2

detach

仮想サーバグループの登録解除

仮想サーバグループの登録を解除します。

○

○※2

export

定義ディレクトリの取り出し

管理ユニットに登録されている定義ディレクトリを取り出します。

○

○※2

help

vmiunitコマンドのヘルプ表示

vmiunitコマンドのヘルプを表示します。

○

○

import

定義ディレクトリの取り込みまたは内容変更

管理ユニットに定義ディレクトリを取り込みます。または，管理ユニットに登録済みの定義ディレクトリの内容を変更します。

○

○※2

info

管理ユニットの情報表示

管理ユニットの情報を表示します。

○

○※2

list

管理ユニットまたは仮想サーバグループに属する仮想サーバの一覧表示

管理ユニットまたは仮想サーバグループに属する仮想サーバの一覧を表示します。

○

○※2

mark

仮想サーバグループの障害マークの設定

仮想サーバグループに障害マークを設定します。

○

○※2

script

仮想サーバのユーザスクリプトの実行

仮想サーバでユーザスクリプトを実行します。

○

○※2

start

管理ユニットまたは仮想サーバグループの起動（業務の開始）

管理ユニットまたは仮想サーバグループに属する仮想サーバを一括起動して業務を開始します。

○

○※2

status

管理ユニットまたは仮想サーバグループの状態表示

管理ユニットまたは仮想サーバグループの状態を表示します。

○

○※2

stop

管理ユニットまたは仮想サーバグループの停止（業務の停止）

管理ユニットまたは仮想サーバグループに属する仮想サーバを一括停止し業務を停止します。

○

○※2

unblock

管理ユニットまたは仮想サーバグループの閉塞解除

管理ユニットまたは仮想サーバグループの閉塞を解除します。

○

○※2

unmark

仮想サーバグループの障害マークの設定解除

仮想サーバグループから障害マークを除去します。

○

○※2

update

管理ユニットに属する仮想サーバへの定義ディレクトリの反映

管理ユニットに属するすべての仮想サーバに，定義ディレクトリを反映します。

○

○※2

vmiunitadmin

changeowner

管理ユニットの所有者の変更

管理ユニットの所有者を変更します。

○

×

create

管理ユニットの作成

仮想サーバマネージャに管理ユニットを作成します。

○

○

delete

管理ユニットの削除

仮想サーバマネージャから管理ユニットを削除します。

○

○※2

help

vmiunitaコマンドのヘルプ表示

vmiunitaコマンドのヘルプを表示します。

○

○

list

管理ユニットの一覧表示

仮想サーバマネージャに作成されている管理ユニットの一覧を表示します。

○

×

（凡例）○：実行できる。　×：実行できない。　−：該当しない。

注※1　自分のシステム構築者アカウントのパスワードだけを変更できます。

注※2　システム構築者アカウントが所有する管理ユニット，および所有する管理ユニットに属する仮想サーバに対して操作できます。

注意事項

運用管理エージェントまたはManagement Serverの起動に続けて，運用管理コマンド（mngsvrutil）またはSmart Composer機能などでManagement Serverにアクセスする場合，事前に次のどちらかの対策をしてください。

運用管理エージェントまたはManagement Serverの起動時に同期実行を有効にし起動に続けてコマンドを実行する。

mngsvrutil checkまたはadminagentcheckコマンドで，Management Serverまたは運用管理エージェントが起動済みであることを確認する。

9.2　仮想化システムで使用するコマンドの詳細

仮想化システムで使用するコマンドの入力形式，機能などを次に示します。

コマンドの格納先

仮想化システムで使用するコマンドは，次のディレクトリに格納されています。

rasetupコマンド以外のコマンド

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥vmi¥bin¥

UNIXの場合

/opt/Cosminexus/manager/vmi/bin/

rasetupコマンド

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥setup¥bin¥

UNIXの場合

/opt/Cosminexus/manager/setup/bin/

共通引数

共通引数は，.vmirc（クライアント設定プロパティファイル）またはvmiclient.properties（クライアント共通設定プロパティファイル）で，指定を省略したときのデフォルト値を設定できます。

共通引数の優先順位は次のとおりです。

コマンド入力時に指定した値

.vmircの設定値

vmiclient.propertiesの設定値

なお，.vmircおよびvmiclient.propertiesのどちらも設定していない場合は，コマンド入力時に共通引数を省略できません。

.vmircについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「9.2.10　.vmirc（仮想サーバマネージャのクライアント設定プロパティファイル）」を，vmiclient.propertiesについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「9.2.9　vmiclient.properties（仮想サーバマネージャのクライアント共通設定プロパティファイル）」を参照してください。

形式

コマンド名称  [-m <ホスト名>[:<ポート番号>]]
              [-u <ユーザID>] [-p <ユーザパスワード>]
              [-wait <実行待ち時間>]

説明

-m <ホスト名>[:<ポート番号>]

仮想サーバマネージャ（Management Server）のホスト名とポート番号を指定します。

<ホスト名>

ドット記法でのIPアドレス指定（xxx.xxx.xxx.xxx），または名前解決できるホスト名で指定します。なお，xxxには0〜255の整数を指定します。

<ポート番号>

Management Serverの設定に従います。設定個所は，mserver.properties（Management Server環境設定ファイル）のwebserver.connector.http.portキーの値となります。デフォルト値は28080です。

-u <ユーザID>

コマンドを実行するアカウントのユーザIDを指定します。

仮想サーバマネージャ管理者が実行する場合

仮想サーバマネージャのセットアップで設定した，仮想サーバマネージャ管理者アカウントの管理ユーザIDを指定します。仮想サーバマネージャのセットアップについては，マニュアル「アプリケーションサーバ 仮想化システム構築・運用ガイド」の「3.1.2　運用環境の構築」を参照してください。

システム構築者が実行する場合

仮想サーバマネージャで追加した，システム構築者アカウントのユーザIDを指定します。

-p <ユーザパスワード>

コマンドを実行するアカウントのパスワードを指定します。

仮想サーバマネージャ管理者が実行する場合

仮想サーバマネージャのセットアップで設定した，仮想サーバマネージャ管理者アカウントの管理ユーザパスワードを指定します。仮想サーバマネージャのセットアップについては，マニュアル「アプリケーションサーバ 仮想化システム構築・運用ガイド」の「3.1.2　運用環境の構築」を参照してください。

システム構築者が実行する場合

仮想サーバマネージャで追加した，システム構築者アカウントのパスワードを指定します。

-wait <実行待ち時間>

ほかのプロセスですでにコマンドが実行中の場合に，その実行中のコマンドが終了するまでの待ち時間（単位：秒）を0〜2147483647の範囲で指定します。この引数を指定しない場合のデフォルト値は0です。0の場合，待ち時間は発生しません。

この引数は，次のコマンドのサブコマンドの場合に有効となります。このほかのコマンドのサブコマンドの場合，この引数は無視されます。

vmiadminのサブコマンド「changeowner」，「delete」

vmiunitのサブコマンド「attach」，「block」，「detach」，「import」，「script」，「start」，「stop」，「unblock」，「update」

これらのコマンドで，すでに同じ管理ユニットに対する操作が実行中の場合は，待ち時間が発生します。ただし，これらのコマンドが実行中の場合でも，操作対象の管理ユニットが異なるときは，待ち時間が発生しないで同時実行されます。

指定した待ち時間内に実行中のコマンドが終了した場合は，あとから実行したコマンドは実行されます。指定した待ち時間を超過してもすでに実行中のコマンドが終了しなかった場合は，あとから実行したコマンドは実行待ち時間超過による排他エラー（終了コード2）で処理を行わないで終了します。

コマンドのエラーおよび警告条件

項番

エラー・警告条件

戻り値

1

仮想サーバマネージャとの通信に失敗しました。

64

2

引数の指定方法に誤りがあります。

64

3

コマンドを実行する権限がありません。

64

4

認証に失敗しました（ユーザIDの誤り，またはユーザパスワードの誤り）。

64

5

内部状態の保存に失敗しました。

64

6

JP1/Baseの接続に失敗しました。

64

7

JP1/Baseの認証処理でエラーが発生しました。

64

コマンドで指定する名称の入力規則

コマンドで指定する名称の入力規則を次の表に示します。

表9‒2　コマンドで指定する名称の入力規則

項番

名称

長さの制限

文字の制限

1

管理ユニット名

1〜31バイト

半角英数字，アンダースコア（_）またはハイフン（-）で指定します。

ただし，先頭文字は半角英字である必要があります。

英字の大文字・小文字は区別されます。

2

ティア識別子

1〜31バイト

半角英数字，アンダースコア（_）またはハイフン（-）で指定します。

ただし，先頭文字は半角英字である必要があります。

英字の大文字・小文字は区別されます。

3

仮想サーバグループ名

1〜31バイト

半角英数字，アンダースコア（_）またはハイフン（-）で指定します。

ただし，先頭文字は半角英字である必要があります。

英字の大文字・小文字は区別されます。

4

システム構築者アカウントのユーザID

1〜256バイト

半角英数字，アンダースコア（_）またはハイフン（-）で指定します。

ただし，先頭文字は半角英字である必要があります。

英字の大文字・小文字は区別されます。

5

システム構築者アカウントのユーザパスワード

1〜256バイト

半角英数字，または半角記号（!"#$%&'()*+,-./:;<=>?@[¥]^_`{|}~）で指定します。

英字の大文字・小文字は区別されます。

6

仮想サーバ識別子

7〜15バイト

IPv4記法で指定します。

管理LANに接続されているNICのIPアドレスを指定します。

7

業務用IPアドレス

7〜15バイト

IPv4記法で指定します。

業務LANに接続されているNICのIPアドレスを指定します。

8

管理ユニットの説明

なし

コマンドラインで指定できる文字で指定します。

英字の大文字・小文字は区別されます。

9

コメント（障害マーク）

なし

コマンドラインで指定できる文字で指定します。

英字の大文字・小文字は区別されます。

注意事項

仮想化システムで使用するコマンドは，仮想サーバマネージャが起動している状態で実行してください。

rasetup（仮想サーバへのセットアップ・アンセットアップ）

形式

セットアップする場合（形式1）

rasetup -vm -dir <定義ファイル格納ディレクトリ>

アンセットアップする場合（形式2）

rasetup -vm -clean

セットアップの完了を確認する場合（形式3）

rasetup -vm -check

機能

仮想サーバマネージャと連携して，仮想サーバ上にシステム環境をセットアップまたはアンセットアップする機能を呼び出して実行します。このコマンド実行時のログファイルの出力先，ファイルサイズなどは，rasetup.cfgで設定します。rasetup.cfgについては，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「9.2.2　rasetup.cfg（rasetupコマンド用設定ファイル）」を参照してください。

引数

-vm

仮想サーバへのセットアップまたはアンセットアップする機能を使用します。必ず指定してください。

-dir <定義ファイル格納ディレクトリ>

システム環境のセットアップで使用する定義ファイルを格納したディレクトリを指定します。

-clean

rasetup -vmコマンドでセットアップしたシステム環境をアンセットアップします。

-check

システム環境のセットアップ処理が完了したかどうかを確認します。

システムのセットアップ処理が完了していない（未構築の状態，または前回の構築で失敗した状態）場合，コマンドは終了コード103で終了します。

戻り値

-checkオプションを実行した場合

0：

仮想サーバ上にシステム環境のセットアップが完了しました。

1：

実行時エラーが発生しました。

2：

シンタックスエラーが発生しました。

103：

仮想サーバ上でシステム環境のセットアップ処理が完了していません。

-checkオプション以外を実行した場合

0：

正常終了しました。

1：

実行時エラーが発生しました。

2：

シンタックスエラーが発生しました。

注意事項

コマンドを実行できるユーザは次のとおりです。次に示すユーザ以外がコマンドを実行した場合，エラーとなります。

Windowsの場合

管理者特権のあるユーザ

UNIXの場合

スーパーユーザ（root権限のあるユーザ）

次の環境で-cleanオプションを指定してコマンドを実行すると，エラーメッセージが出力され，コマンドの処理を終了します。

セットアップを実行していない環境

一度-cleanオプションを指定したコマンド（アンセットアップ）を実行した環境

このコマンド以外でセットアップしたシステム環境

このコマンドで呼び出される機能を起動するために必要な環境変数はありません。ただし，セットアップ完了後にApplication Serverのコマンドを実行する場合などは，必要に応じて環境変数を設定する必要があります。

Component Container管理者，およびManagement Server管理グループに設定するユーザおよびグループは，OSにあらかじめ登録しておいてください。OSに登録されていないユーザまたはグループを指定した場合は，セットアップ処理でエラーとなります。

このコマンドの引数に指定するファイル，およびそのファイルを格納するディレクトリの名称には次の文字を使用しないでください。使用した場合にはエラーとなり，コマンドの処理が中断されます。

# % ?

コマンドを実行している間は，Ctrl+Cキーなどで外部から停止しないでください。外部から停止した場合，プロセスが残ってしまうことがあります。再度このコマンドを実行してもエラーが発生する場合は，OSを再起動してください。

vmiaccount（アカウント操作コマンド）

形式

vmiaccount <サブコマンド> [共通引数] <サブコマンドの引数>

機能

仮想サーバマネージャに対して，システム構築者アカウントの操作をします。このコマンドにサブコマンドを指定して実行します。

JP1ユーザ認証連携機能を使用している場合，このコマンドは使用できません。

引数

<サブコマンド>

システム構築者アカウントの操作を示すサブコマンドを指定します。指定できるサブコマンドについては，「9.3　vmiaccountコマンドのサブコマンドの詳細」を参照してください。

[共通引数]

仮想化システムで使用するコマンドの共通引数を指定します。

<サブコマンドの引数>

サブコマンドの引数を指定します。サブコマンドの引数については，「9.3　vmiaccountコマンドのサブコマンドの詳細」を参照してください。

戻り値

サブコマンドの仕様に従います。サブコマンドの戻り値については，「9.3　vmiaccountコマンドのサブコマンドの詳細」を参照してください。

エラーおよび警告条件

サブコマンドの仕様に従います。サブコマンドのエラーおよび警告条件については，「9.3　vmiaccountコマンドのサブコマンドの詳細」を参照してください。

vmiunit（管理ユニット運用操作コマンド）

形式

vmiunit <サブコマンド> [共通引数] <サブコマンドの引数>

機能

管理ユニットを運用操作します。このコマンドにサブコマンドを指定して実行します。

引数

<サブコマンド>

管理ユニットの運用操作を示すサブコマンドを指定します。指定できるサブコマンドについては，「9.4　vmiunitコマンドのサブコマンドの詳細」を参照してください。

[共通引数]

仮想化システムで使用するコマンドの共通引数を指定します。

<サブコマンドの引数>

サブコマンドの引数を指定します。サブコマンドの引数については，「9.4　vmiunitコマンドのサブコマンドの詳細」を参照してください。

戻り値

サブコマンドの仕様に従います。サブコマンドの戻り値については，「9.4　vmiunitコマンドのサブコマンドの詳細」を参照してください。

エラーおよび警告条件

サブコマンドの仕様に従います。サブコマンドのエラーおよび警告条件については，「9.4　vmiunitコマンドのサブコマンドの詳細」を参照してください。

vmiunitadmin（管理ユニット管理コマンド）

形式

vmiunitadmin <サブコマンド> [共通引数] <サブコマンドの引数>

機能

仮想サーバマネージャに作成されている管理ユニットを管理します。このコマンドにサブコマンドを指定して実行します。

引数

<サブコマンド>

管理ユニットの管理操作を示すサブコマンドを指定します。指定できるサブコマンドについては，「9.5　vmiunitadminコマンドのサブコマンドの詳細」を参照してください。

[共通引数]

仮想化システムで使用するコマンドの共通引数を指定します。

<サブコマンドの引数>

サブコマンドの引数を指定します。サブコマンドの引数については，「9.5　vmiunitadminコマンドのサブコマンドの詳細」を参照してください。

戻り値

サブコマンドの仕様に従います。サブコマンドの戻り値については，「9.5　vmiunitadminコマンドのサブコマンドの詳細」を参照してください。

エラーおよび警告条件

サブコマンドの仕様に従います。サブコマンドのエラーおよび警告条件については，「9.5　vmiunitadminコマンドのサブコマンドの詳細」を参照してください。

9.3　vmiaccountコマンドのサブコマンドの詳細

vmiaccountコマンドのサブコマンドの詳細について説明します。

vmiaccount create（システム構築者アカウントの追加）

形式

vmiaccount create [共通引数]
                  -user <システム構築者アカウントのユーザID>
                  -password <システム構築者アカウントのパスワード>

機能

仮想サーバマネージャにシステム構築者アカウントを追加します。

JP1ユーザ認証連携機能を使用している場合，このコマンドは使用できません。

引数

-user <システム構築者アカウントのユーザID>

追加するシステム構築者アカウントのユーザIDを指定します。

-password <システム構築者アカウントのパスワード>

追加するシステム構築者アカウントのパスワードを指定します。

入力例

vmiaccount create -user user_a -password abcdefg8

戻り値

0：

正常終了しました。

2：

排他エラーが発生しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

戻り値

1

指定されたユーザIDが不正です。

64

2

指定されたパスワードが不正です。

64

3

登録済みのユーザIDがあります。

64

4

仮想サーバマネージャ管理者アカウントと同じユーザIDが指定されました。

64

5

JP1ユーザ認証連携機能が有効になっている設定では使用できないコマンドが実行されました。

64

注意事項

-passwordオプションにパスワードを指定した場合，このコマンドの実行中に，プロセスの引数を確認できるOS機能などでパスワードが観測されるおそれがあります。-passwordオプションを使用する際はプロセスの引数を確認できるOS機能などを，他ユーザが使用できない状況下で実施してください。共通引数の-pオプションは，.vmirc（クライアント設定プロパティファイル）またはvmiclient.properties（クライアント共通設定プロパティファイル）にパスワードを設定することで指定を省略できます。

vmiaccount delete（システム構築者アカウントの削除）

形式

vmiaccount delete [共通引数]
                  -user <システム構築者アカウントのユーザID>

機能

仮想サーバマネージャに登録されているシステム構築者アカウントを削除します。

JP1ユーザ認証連携機能を使用している場合，このコマンドは使用できません。

引数

-user <システム構築者アカウントのユーザID>

削除するシステム構築者アカウントのユーザIDを指定します。

入力例

vmiaccount delete -user user_a

戻り値

0：

正常終了しました。

2：

排他エラーが発生しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

戻り値

1

指定されたユーザIDがありません。

64

2

指定されたユーザIDが管理ユニットの所有者に設定されています。

64

3

仮想サーバマネージャ管理者アカウントが指定されました。

64

4

JP1ユーザ認証連携機能が有効になっている設定では使用できないコマンドが実行されました。

64

vmiaccount help（vmiaccountコマンドのヘルプ表示）

形式

サブコマンドの一覧を表示する場合（形式1）

vmiaccount help

サブコマンドのヘルプを表示する場合（形式2）

vmiaccount help <サブコマンド>

機能

vmiaccountコマンドのヘルプを表示します。

サブコマンドが指定された場合は，サブコマンドのヘルプを表示します。サブコマンドが指定されていない場合は，サブコマンドの一覧を表示します。

引数

<サブコマンド>

vmiaccountコマンドのサブコマンドを指定します。

入力例・出力例

サブコマンドの一覧を表示する場合（形式1）

vmiaccount help

KEOS29601-I Usage :
  vmiaccount <subcommand> <common option> <subcommand option>
  <subcommand>:
    create - Add a system builder account.
    delete - Delete a system builder account.
    list - Show all system builder accounts.
    password - Change the password of a system builder account.
    help - Show this message.
  <common option>:
    [-m <host>[:<port>]]
    [-u <user ID>]
    [-p <password>]
    [-wait <waiting time>]
  <subcommand option>: Subcommand arguments.
For details on subcommand option, execute the "<command> help <subcommand>" command.

サブコマンドのヘルプを表示する場合（形式2）

vmiaccount help create

KEOS29601-I Usage :
  vmiaccount create <common option> -user <user ID> -password <password>
  <common option>:
    [-m <host>[:<port>]]
    [-u <user ID>]
    [-p <password>]
    [-wait <waiting time>]
  -user <user ID>: User ID of the system builder account.
  -password <password>: Password of the system builder account.

戻り値

0：

正常終了しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

コマンド形式

戻り値

1

指定されたサブコマンドがありません。

形式2

64

vmiaccount list（システム構築者アカウントの一覧表示）

形式

vmiaccount list [共通引数]

機能

仮想サーバマネージャに登録されているシステム構築者アカウントの一覧を表示します。一覧には，システム構築者アカウントのユーザIDが昇順で出力されます。

JP1ユーザ認証連携機能を使用している場合，このコマンドは使用できません。

引数

なし

入力例・出力例

入力例

vmiaccount list

出力例

user_a
user_b
user_c

戻り値

0：

正常終了しました。

2：

排他エラーが発生しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

戻り値

1

JP1ユーザ認証連携機能が有効になっている設定では使用できないコマンドが実行されました。

64

注意事項

このコマンドでは，仮想サーバマネージャ管理者アカウントのユーザIDは表示されません。

vmiaccount password（システム構築者アカウントのパスワード変更）

形式

仮想サーバマネージャ管理者が実行する場合（形式1）

vmiaccount password [共通引数]
                    -user <システム構築者アカウントのユーザID>
                    -password <システム構築者アカウントの新パスワード>

システム構築者が実行する場合（形式2）

vmiaccount password [共通引数]
                    -password <システム構築者アカウントの新パスワード>

機能

システム構築者アカウントのパスワードを変更します。

JP1ユーザ認証連携機能を使用している場合，このコマンドは使用できません。

引数

-user <システム構築者アカウントのユーザID>

パスワードを変更するシステム構築者アカウントのユーザIDを指定します。

この引数は，仮想サーバマネージャ管理者が実行する場合だけ指定します。システム構築者が実行する場合，指定できません。

-password <システム構築者アカウントの新パスワード>

システム構築者アカウントの新しいパスワードを指定します。

入力例

仮想サーバマネージャ管理者が実行する場合（形式1）

vmiaccount password -user user_a -password aiueo9

システム構築者が実行する場合（形式2）

vmiaccount password -u user_a -p abcdef8 -password aiueo9

戻り値

0：

正常終了しました。

2：

排他エラーが発生しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

コマンド形式

戻り値

1

指定されたユーザIDがありません。

形式1

64

2

指定されたパスワードが不正です。

形式1，形式2

64

3

仮想サーバマネージャ管理者が実行する場合に，必要な引数が指定されていません。

形式2

64

4

システム構築者が実行する場合に，指定できない引数が指定されています。

形式1

64

5

仮想サーバマネージャ管理者アカウントが指定されました。

形式1

64

6

JP1ユーザ認証連携機能が有効になっている設定では使用できないコマンドが実行されました。

形式1，形式2

64

注意事項

このコマンドでは，仮想サーバマネージャ管理者アカウントのパスワードは変更できません。

-passwordオプションにパスワードを指定した場合，このコマンドの実行中に，プロセスの引数を確認できるOS機能などでパスワードが観測されるおそれがあります。-passwordオプションを使用する際はプロセスの引数を確認できるOS機能などを，他ユーザが使用できない状況下で実施してください。共通引数の-pオプションは，.vmirc（クライアント設定プロパティファイル）またはvmiclient.properties（クライアント共通設定プロパティファイル）にパスワードを設定することで指定を省略できます。

9.4　vmiunitコマンドのサブコマンドの詳細

vmiunitコマンドのサブコマンドの詳細について説明します。

vmiunit attach（仮想サーバグループの登録）

形式

vmiunit attach [共通引数] -unit <管理ユニット名>
               -f <仮想サーバグループ情報ファイル>

機能

管理ユニットに仮想サーバグループを登録します。仮想サーバグループ内の仮想サーバが管理ユニットに登録されます。

引数

-unit <管理ユニット名>

仮想サーバの登録先となる管理ユニットの名称を指定します。

-f <仮想サーバグループ情報ファイル>

仮想サーバグループ情報ファイルのパスを指定します。仮想サーバグループ情報ファイルの内容に従って，仮想サーバが管理ユニットに登録されます。仮想サーバグループ情報ファイルには，仮想サーバグループの名称や，仮想サーバのIPアドレス（仮想サーバ識別子，仮想サーバの業務用IPアドレス），仮想サーバを割り当てるティアなどの情報を指定します。

入力例

vmiunit attach -unit gyoumu01 -f virtualserver-info.xml

戻り値

0：

正常終了しました。

1：

警告終了しました。

2：

排他エラーが発生しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

戻り値

1

指定された管理ユニットがありません。

64

2

指定された仮想サーバグループ情報ファイルのファイル形式が不正です。

64

3

指定された管理ユニットに定義ディレクトリが登録されていません。

64

4

すでに同じ名称の仮想サーバグループがあります。

1

5

ティア識別子が一致しません。

64

6

仮想サーバグループ情報ファイル内でIPアドレス（仮想サーバ識別子または業務用IPアドレス）が重複しています。

64

7

仮想サーバグループ情報ファイルに指定された仮想サーバ識別子は，仮想サーバ識別子，または業務用IPアドレスとして管理ユニットにすでに登録されています。

64

8

仮想サーバグループ情報ファイルに指定された業務用IPアドレスは，仮想サーバ識別子，または業務用IPアドレスとして管理ユニットにすでに登録されています。

64

9

仮想サーバグループ情報ファイルに指定された仮想サーバ識別子は，仮想サーバ識別子，または業務用IPアドレスとしてほかの管理ユニットですでに登録されています。

64

10

仮想サーバグループ情報ファイルに指定された業務用IPアドレスは，仮想サーバ識別子，または業務用IPアドレスとしてほかの管理ユニットですでに登録されています。

64

11

実行待ち時間が超過しました。

2

注意事項

仮想サーバグループがすでに登録されている場合に，同じ名称で内容が異なる仮想サーバグループを登録すると，警告メッセージが出力され，その仮想サーバグループは無視されます。

仮想サーバグループ情報ファイルが登録済みの場合に，仮想サーバ情報を追加するときは，次のどちらかの操作を実施してください。

登録時に使用した仮想サーバグループ情報ファイルに仮想サーバを追記して，そのファイルを再登録する

追加する仮想サーバ情報だけを記述した仮想サーバグループ情報ファイルを作成して登録する

このコマンドを実行する前に，vmiunitコマンドにサブコマンドimportを指定して実行し，管理ユニットに定義ディレクトリを登録しておいてください。また，仮想サーバグループ情報ファイルで指定するティア識別子は，定義ディレクトリを構成するティア別定義ディレクトリのディレクトリ名（ティア識別子）と一致している必要があります。

vmiunit block（管理ユニットまたは仮想サーバグループの閉塞）

形式

管理ユニットを閉塞する場合（形式1）

vmiunit block [共通引数] -unit <管理ユニット名>

仮想サーバグループを閉塞する場合（形式2）

vmiunit block [共通引数] -unit <管理ユニット名>
              -group <仮想サーバグループ名>

機能

管理ユニットまたは仮想サーバグループを閉塞します。

引数

-unit <管理ユニット名>

閉塞する管理ユニットの名称を指定します。

-group <仮想サーバグループ名>

閉塞する仮想サーバグループの名称を指定します。

入力例

管理ユニットを閉塞する場合（形式1）

vmiunit block -unit gyoumu01

仮想サーバグループを閉塞する場合（形式2）

vmiunit block -unit gyoumu01 -group group02

戻り値

0：

正常終了しました。

2：

排他エラーが発生しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

コマンド形式

戻り値

1

指定された管理ユニットがありません。

形式1，形式2

64

2

指定された管理ユニットに仮想サーバが一つも登録されていません。

形式1

64

3

指定された仮想サーバグループがありません。

形式2

64

4

閉塞の対象※となる仮想サーバが見つかりません。

形式1，形式2

64

5

負荷分散機の操作でエラーが発生しました。

形式1，形式2

64

6

負荷分散機連携が有効でない場合に，このコマンドを実行しました。

形式1，形式2

64

7

実行待ち時間が超過しました。

形式1，形式2

2

注※　構築済み（論理ステータスがinitial以外）の仮想サーバを指します。

vmiunit compare（登録済みの定義ディレクトリとの内容比較）

形式

vmiunit compare [共通引数] -unit <管理ユニット名>
                -dir <定義ディレクトリ>

機能

管理ユニットに登録されている定義ディレクトリの内容と，指定された定義ディレクトリの内容とを比較します。

引数

-unit <管理ユニット名>

比較対象となる定義ディレクトリが登録されている管理ユニットの名称を指定します。

-dir <定義ディレクトリ>

比較対象となる定義ディレクトリを指定します。

入力例・出力例

入力例

vmiunit compare -unit gyoumu01 -dir D:/temp/dir

出力例

ティアが一つのとき

## compared definition directory. ##
M combined-tier-01/vmi/tier.properties
  combined-tier-01/vmi/tierlb.properties
D combined-tier-01/app/gyoumu1.ear
A combined-tier-01/app/gyoumu2.ear
D combined-tier-01/config/Cosminexus/gyoumu1/META-INF/cosminexus.xml
A combined-tier-01/config/Cosminexus/gyoumu2/META-INF/cosminexus.xml
  combined-tier-01/config/Cosminexus/CC/admin/usrconf/usrconf.bat
M combined-tier-01/config/Cosminexus/CC/admin/usrconf/usrconf.properties
     :
 (空行)
Update Scope:
combined-tier-01 : all

ティアが複数のとき

## compared definition directory. ##
M http-tier-001/vmi/tier.properties
  http-tier-001/vmi/tierlb.properties
M http-tier-001/config/Cosminexus/manager/config/adminagent.properties
     :
M j2ee-tier-01/vmi/tier.properties
  j2ee-tier-01/vmi/tierlb.properties
D j2ee-tier-01/app/gyoumu1.ear
A j2ee-tier-01/app/gyoumu2.ear
D j2ee-tier-01/config/Cosminexus/gyoumu1/META-INF/cosminexus.xml
A j2ee-tier-01/config/Cosminexus/gyoumu2/META-INF/cosminexus.xml
j2ee-tier-01/config/Cosminexus/CC/admin/usrconf/usrconf.bat
M j2ee-tier-01/config/Cosminexus/CC/admin/usrconf/usrconf.properties
     :
 (空行)
Update Scope:
http-tier-001 : meta
j2ee-tier-01 : all
j2ee-tier-02 : mismatch

出力形式

＜比較結果＞ ＜ファイルパス＞
(空行)
Update Scope:
＜ティア識別子＞ : ＜変更範囲＞

定義ディレクトリのディレクトリパスを最上位パスとして，それ以下のファイルパスが出力されます。ファイルパスは，大文字・小文字の違いは無視されて昇順にソートされます。「Update Scope:」よりあとは，ティア識別子ごとに出力されます。

なお，定義ディレクトリの取り込み時に無視されたファイルについては，このコマンドでの出力の前に，ファイルごとにワーニングメッセージが出力されます。無視されたファイルは，この出力形式に出力されません。

＜比較結果＞

管理ユニットに登録済みの定義ディレクトリと，指定された定義ディレクトリの比較結果が次のどれかで出力されます。

A：指定された定義ディレクトリだけにあります。

D：管理ユニットに登録済みの定義ディレクトリだけにあります。

M：どちらにもありますが，ファイルの中身が異なります。

＜空白＞：どちらにもあります。また，ファイルの中身も同じです。

＜変更範囲＞

すべての比較結果から仮想サーバの変更範囲が次のどれかで出力されます。

all：vmiunitコマンドにサブコマンドupdateを指定して実行した場合，仮想サーバの定義ディレクトリ全体を更新します。

application：vmiunitコマンドにサブコマンドupdateを指定して実行した場合，仮想サーバのアプリケーションだけを更新します。

meta：管理ユニットに関する設定だけを更新します。vmiunitコマンドにサブコマンドupdateを指定して実行しても仮想サーバの定義は更新しません。

none：仮想サーバの定義に変更はありません。

mismatch：登録済みの定義ディレクトリとティア識別子が一致しないため，vmiunitコマンドにサブコマンドimportを指定して実行しても定義ディレクトリの内容は更新しません。

戻り値

0：

正常終了しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

戻り値

1

指定された管理ユニットがありません。

64

2

指定された定義ディレクトリがありません。

64

3

指定された定義ディレクトリの内容に誤りがあります。

64

4

定義ディレクトリが登録されていません。

64

vmiunit detach（仮想サーバグループの登録解除）

形式

vmiunit detach [共通引数] -unit <管理ユニット名>
               -group <仮想サーバグループ名>

機能

管理ユニットから仮想サーバグループの登録を解除します。仮想サーバグループ内の仮想サーバが管理ユニットから登録解除されます。

引数

-unit <管理ユニット名>

登録解除の対象となる管理ユニットの名称を指定します。

-group <仮想サーバグループ名>

登録を解除する仮想サーバグループの名称を指定します。指定した仮想サーバグループ内のすべての仮想サーバが登録を解除されます。

入力例

vmiunit detach -unit gyoumu01 -group http_group01

戻り値

0：

正常終了しました。

2：

排他エラーが発生しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

戻り値

1

指定された管理ユニットがありません。

64

2

指定された仮想サーバグループがありません。

64

3

負荷分散機の操作でエラーが発生しました。

64

4

実行待ち時間が超過しました。

2

vmiunit export（定義ディレクトリの取り出し）

形式

vmiunit export [共通引数] -unit <管理ユニット名>
               -dir <出力先ディレクトリパス>

機能

管理ユニットに登録されている定義ディレクトリを取得することで，管理ユニットの定義ファイルおよびアプリケーションを取り出します。

引数

-unit <管理ユニット名>

取り出す対象となる管理ユニットの名称を指定します。

-dir <出力先ディレクトリパス>

定義ディレクトリを出力するディレクトリパスを指定します。

入力例

vmiunit export -unit gyoumu01 -dir D:/temp/dir

戻り値

0：

正常終了しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

戻り値

1

指定された管理ユニットがありません。

64

2

定義ディレクトリが登録されていません。

64

3

指定されたディレクトリの書き込みに失敗しました。

64

4

指定されたディレクトリが空ではありません。

64

注意事項

このコマンドを実行してエラーが発生した場合でも，-dirオプションに指定したディレクトリが作成されることがあります。作成されたディレクトリが不要な場合は削除してください。

vmiunit help（vmiunitコマンドのヘルプ表示）

形式

サブコマンドの一覧を表示する場合（形式1）

vmiunit help

サブコマンドのヘルプを表示する場合（形式2）

vmiunit help <サブコマンド>

機能

vmiunitコマンドのヘルプを表示します。

サブコマンドが指定された場合は，サブコマンドのヘルプを表示します。サブコマンドが指定されていない場合は，サブコマンド一覧を表示します。

引数

<サブコマンド>

vmiunitコマンドのサブコマンド名を指定します。

入力例・出力例

サブコマンドの一覧を表示する場合（形式1）

vmiunit help

KEOS29601-I Usage :
  vmiunit <subcommand> <common option> <subcommand option>
  <subcommand>:
    attach - Attach a virtual server information to a management unit.
    detach - Detach a virtual server information from a management unit.
    update - Build an application servers on virtual servers that attached on a management unit.
    start - Start virtual servers belonging to a management unit.
    stop - Stop virtual servers belonging to a management unit.
    status - Show the status of a management unit and its virtual servers.
    list - Show information about virtual servers belonging to a management unit.
    info - Show information about a management unit.
    mark - Mark a virtual server group as malfunctioning.
    unmark - Remove the malfunction mark from a virtual server group .
    import - Import definition files and business applications to a management unit.
    export - Export definitions and business applications from a management unit.
    compare - Compare definition directories.
    block - Block a management unit or a virtual server group .
    unblock - Unblock a management unit or a virtual server group .
    script - Execute an user's script on a virtual server.
    help - Show this message.
  <common option>:
    [-m <host>[:<port>]]
    [-u <user ID>]
    [-p <password>]
    [-wait <waiting time>]
  <subcommand option>: Subcommand arguments.
For details on subcommand option, execute the "<command> help <subcommand>" command.

サブコマンドのヘルプを表示する場合（形式2）

vmiunit help attach

KEOS29601-I Usage :
  vmiunit attach <common option> -unit <unit name> -fｂrtual server group information file>
  <common option>:
    [-m <host>[:<port>]]
    [-u <user ID>]
    [-p <password>]
    [-wait <waiting time>]
  -unit <unit name>: Name of the management unit.
  -f <virtual server group ｂrmation file>: Virtual server group information file path.

戻り値

0：

正常終了しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

コマンド形式

戻り値

1

指定されたサブコマンドがありません。

形式2

64

vmiunit import（定義ディレクトリの取り込みまたは内容変更）

形式

vmiunit import [共通引数] -unit <管理ユニット名>
               -dir <定義ディレクトリ>

機能

管理ユニットの定義ファイルと業務アプリケーションを定義ディレクトリにまとめて，新規に管理ユニットに取り込みます。または，登録済みの管理ユニットの定義ディレクトリの内容を変更します。

引数

-unit <管理ユニット名>

取り込む対象となる管理ユニットの名称を指定します。

-dir <定義ディレクトリ>

管理ユニットに取り込む定義ディレクトリを指定します。

入力例

vmiunit import -unit gyoumu01 -dir D:/temp/dir

戻り値

0：

正常終了しました。

2：

排他エラーが発生しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

戻り値

1

指定された管理ユニットがありません。

64

2

指定された定義ディレクトリがありません。

64

3

指定された定義ディレクトリの内容に誤りがあります。

64

4

指定された定義ディレクトリと，登録済みの定義ディレクトリのティア識別子が一致しません。

64

5

実行待ち時間が超過しました。

2

注意事項

登録できる定義ディレクトリについては，マニュアル「アプリケーションサーバ 仮想化システム構築・運用ガイド」の「5.2.4　管理ユニットへの定義ディレクトリの取り込み」を参照してください。

定義ディレクトリ読み込み時に無視されたファイルについては，ファイルごとにワーニングメッセージが出力されますが，コマンドの出力結果には影響しません。

ティア別プロパティファイルでの負荷分散機連携機能の設定を変更する場合，または負荷分散機接続設定プロパティファイルでの負荷分散機の種類（lb.type）を変更する場合は，管理ユニットの再作成が必要です。

サブコマンドupdateを指定したvmiunitコマンドを実行済みの管理ユニットに対して，負荷分散機連携機能の設定を誤って変更した定義ディレクトリをこのコマンドで再度取り込んだ場合，その後の操作がエラー終了することがあります。その場合は，定義ディレクトリの負荷分散機連携機能の設定を変更前に戻すか，または負荷分散機連携機能を使用しない設定に戻して，このコマンドで定義ディレクトリを取り込んでください。

このコマンドでは，ティア識別子を変更できません。ティア識別子を変更する場合は，管理ユニットを再作成してください。

vmiunit info（管理ユニットの情報表示）

形式

vmiunit info [共通引数] -unit <管理ユニット名>

機能

管理ユニットの情報を一覧で表示します。

引数

-unit <管理ユニット名>

表示対象の管理ユニットの名称を指定します。

入力例・出力例

入力例

vmiunit info -unit gyoumu01

出力例

JP1ユーザ認証連携機能を使用している場合

ティアが一つのとき

UnitName:        gyoumu01
Description:     業務用の管理ユニット
Tier count:      1
  Tier ID:       combined_system01
       type:     combined-tier

ティアが複数のとき

UnitName:        gyoumu01
Description:     業務用の管理ユニット
Tier count:      3
  Tier ID:       http_system01
       type:     http-tier
  Tier ID:       ejb_system001
       type:     j2ee-tier
  Tier ID:       servlet_system
       type:     j2ee-tier

JP1ユーザ認証連携機能を使用していない場合

ティアが一つのとき

UnitName:        gyoumu01
Owner:           user_a
Description:     業務用の管理ユニット
Tier count:      1
  Tier ID:       combined_system01
       type:     combined-tier

ティアが複数のとき

UnitName:        gyoumu01
Owner:           user_a
Description:     業務用の管理ユニット
Tier count:      3
  Tier ID:       http_system01
       type:     http-tier
  Tier ID:       ejb_system001
       type:     j2ee-tier
  Tier ID:       servlet_system
       type:     j2ee-tier

出力ヘッダ

UnitName

管理ユニットの名称が出力されます。

Owner

管理ユニットの所有者であるシステム構築者アカウントのユーザIDが出力されます。

JP1ユーザ認証連携機能を使用している場合，この項目は出力されません。

Description

管理ユニットの説明が出力されます。

Tier count

管理ユニットが管理するティアの数が出力されます。

Tier ID

ティア識別子が出力されます。管理ユニットが管理するティアの数だけ出力されます。

type

ティアの種別が出力されます。管理ユニットが管理するティアの数だけ出力されます。

戻り値

0：

正常終了しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

戻り値

1

指定された管理ユニットがありません。

64

vmiunit list（管理ユニットまたは仮想サーバグループに属する仮想サーバの一覧表示）

形式

vmiunit list [共通引数] -unit <管理ユニット名>
             [-group <仮想サーバグループ名>] [-format {list|xml}]

機能

管理ユニットに属するすべての仮想サーバ，または仮想サーバグループ内の仮想サーバの情報を一覧で表示します。一覧には，仮想サーバの情報が仮想サーバ識別子の昇順で出力されます。

引数

-unit <管理ユニット名>

表示対象の管理ユニットの名称を指定します。

-group <仮想サーバグループ名>

表示対象の仮想サーバグループの名称を指定します。

-format {list | xml}

一覧の表示形式を指定します。デフォルト値はlistです。

list

仮想サーバごとに一覧情報を表示します。

xml

仮想サーバグループ情報ファイルの形式で表示します。仮想サーバグループ情報ファイルの形式については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「9.2.12　仮想サーバグループ情報ファイル」を参照してください。

入力例・出力例

入力例

仮想サーバごとに一覧情報を表示する場合

vmiunit list -unit gyoumu01

vmiunit list -unit gyoumu01 -group group02

管理ユニットに属するすべての仮想サーバの情報を仮想サーバグループ情報ファイルの形式で表示する場合

vmiunit list -unit gyoumu01 -format xml

vmiunit list -unit gyoumu01 -group group02 -format xml

出力例

仮想サーバごとに一覧情報を表示する場合

ティアが一つのとき

Virtual Server ID:               192.168.0.11
Server Communication Agent Port: 20580
Service IP Address:              192.168.20.1
Tier ID:                         combined-tier-001
Group Name:                      group01
(空行)
Virtual Server ID:               192.168.0.13
Server Communication Agent Port: 20580
Service IP Address:              192.168.20.3
Tier ID:                         combined-tier-001
Group Name:                      group02

ティアが複数のとき

Virtual Server ID:               192.168.0.11
Server Communication Agent Port: 20580
Service IP Address:              192.168.20.1
Tier ID:                         http-tier-001
Group Name:                      group01
(空行)
Virtual Server ID:               192.168.0.12
Server Communication Agent Port: 20580
Service IP Address:              192.168.20.2
Tier ID:                         j2ee-tier-01
Group Name:                      group01
(空行)
Virtual Server ID:               192.168.0.13
Server Communication Agent Port: 20580
Service IP Address:              192.168.20.3
Tier ID:                         http-tier-001
Group Name:                      group02

管理ユニットに属するすべての仮想サーバの情報を仮想サーバグループ情報ファイルの形式で表示する場合

ティアが一つのとき

<virtualserver-info xmlns="http://www.cosminexus.com/mngsvr/schema/VirtualServerInfo-1.0">
  <group name="set_001">
    <virtualserver tier="combined-tier-01" ip="111.111.111.101" port="20580" serviceip="111.111.155.101"/>
  </group>
  <group name="set_002">
    <virtualserver tier="combined-tier-01" ip="111.111.111.102" port="20580" serviceip="111.111.155.102"/>
  </group>
   :

ティアが複数のとき

<virtualserver-info xmlns="http://www.cosminexus.com/mngsvr/schema/VirtualServerInfo-1.0">
  <group name="set_001">
    <virtualserver tier="http-tier" ip="111.111.111.101" port="20580" serviceip="111.111.155.101"/>
    <virtualserver tier="j2ee-tier-01" ip="111.111.222.101" port="20580" serviceip="111.111.166.101"/>
  </group>
  <group name="set_002">
    <virtualserver tier="http-tier" ip="111.111.111.102" port="20580" serviceip="111.111.155.102"/>
    <virtualserver tier="j2ee-tier-01" ip="111.111.222.102" port="20580" serviceip="111.111.166.102"/>
  </group>
   :

仮想サーバグループ内の仮想サーバの情報を仮想サーバグループ情報ファイルの形式で表示する場合

ティアが一つのとき

<virtualserver-info xmlns="http://www.cosminexus.com/mngsvr/schema/VirtualServerInfo-1.0">
  <group name="set_002">
    <virtualserver tier="combined-tier-01" ip="111.111.111.002" port="20580" serviceip="111.111.155.002"/>
  </group>
</virtualserver-info>

ティアが複数のとき

<virtualserver-info xmlns="http://www.cosminexus.com/mngsvr/schema/VirtualServerInfo-1.0">
  <group name="set_002">
    <virtualserver tier="http-tier-001" ip="111.111.111.102" port="20580" serviceip="111.111.155.102"/>
    <virtualserver tier="j2ee-tier-01" ip="111.111.222.102" port="20580" serviceip="111.111.166.102"/>
  </group>
</virtualserver-info>

出力ヘッダ

仮想サーバごとに一覧情報を表示する場合の出力ヘッダの意味を次に示します。

Virtual Server ID

仮想サーバの仮想サーバ識別子が出力されます。

Server Communication Agent Port

仮想サーバのサーバ通信エージェント接続ポートが出力されます。

Service IP Address

仮想サーバの業務用IPアドレスが出力されます。

管理ユニットへの仮想サーバの登録時に省略した場合は，仮想サーバ識別子と同じIPアドレスが出力されます。

Tier ID

仮想サーバに割り当てられているティア識別子が出力されます。

Group Name

仮想サーバグループの名称が出力されます。

戻り値

0：

正常終了しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

戻り値

1

指定された管理ユニットがありません。

64

2

指定された仮想サーバグループがありません。

64

3

指定された管理ユニットに仮想サーバグループが一つも登録されていません。

64

vmiunit mark（仮想サーバグループの障害マークの設定）

形式

vmiunit mark [共通引数] -unit <管理ユニット名>
             -group <仮想サーバグループ名> [-comment <コメント>]

機能

仮想サーバグループに障害マークを設定します。

引数

-unit <管理ユニット名>

仮想サーバグループが属する管理ユニットの名称を指定します。

-group <仮想サーバグループ名>

障害マークを設定する仮想サーバグループの名称を指定します。

-comment <コメント>

障害マークのコメントを指定します。

入力例

vmiunit mark -unit gyoumu01 -group Instance-001

戻り値

0：

正常終了しました。

1：

警告終了しました。

2：

排他エラーが発生しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

戻り値

1

指定された管理ユニットがありません。

64

2

指定された仮想サーバグループがありません。

64

3

すでに障害マークが設定されています。

1

注意事項

-commentオプションに指定された内容は，文字コードをUnicodeに変換して保存します。そのため，指定内容によっては表示時に文字化けが発生する場合があります。半角英数字，半角記号以外の文字を使用する場合，vmiunitコマンドにサブコマンドstatusを指定して実行し，管理ユニットの情報を表示して，文字化けが発生しないことを確認してください。

vmiunit script（仮想サーバのユーザスクリプトの実行）

形式

管理ユニットに属するすべての仮想サーバでユーザスクリプトを実行する場合（形式1）

vmiunit script [共通引数] -unit <管理ユニット名> -dir <ユーザスクリプト配置ディレクトリ> [-timeout <タイムアウト時間>]

仮想サーバグループ内の仮想サーバでユーザスクリプトを実行する場合（形式2）

vmiunit script [共通引数] -unit <管理ユニット名> -group <仮想サーバグループ名> -dir <ユーザスクリプト配置ディレクトリ> [-timeout <タイムアウト時間>]

特定の仮想サーバでユーザスクリプトを実行する場合（形式3）

vmiunit script [共通引数] -unit <管理ユニット名> -vs <仮想サーバ識別子> -dir <ユーザスクリプト配置ディレクトリ> [-timeout <タイムアウト時間>]

機能

仮想サーバでユーザスクリプトを実行します。この機能は，管理ユニット単位，仮想サーバグループ単位，および仮想サーバ単位で実行できます。

引数

-unit <管理ユニット名>

ユーザスクリプトを実行する仮想サーバが属する管理ユニットの名称を指定します。

-dir <ユーザスクリプト配置ディレクトリ>

仮想サーバで実行するユーザスクリプトを配置したディレクトリを指定します。ディレクトリは相対パスまたは絶対パスで指定します。

-group <仮想サーバグループ名>

ユーザスクリプトを実行する仮想サーバグループの名称を指定します。

-vs <仮想サーバ識別子>

ユーザスクリプトを実行する仮想サーバのIPアドレスを指定します。

-timeout <タイムアウト時間>

ユーザスクリプトの実行が終了するまでの待ち時間（単位：秒）を0〜2147483の整数で指定します。0を指定，またはこのオプションを省略した場合，タイムアウトしないでユーザスクリプトの実行が終了するまで待ち続けます。

入力例

管理ユニットに属するすべての仮想サーバでユーザスクリプトを実行する場合（形式1）

vmiunit script -unit gyoumu01 -dir script

仮想サーバグループ内の仮想サーバでユーザスクリプトを実行する場合（形式2）

vmiunit script -unit gyoumu01 -group group02 -dir "D:¥script folder"

特定の仮想サーバでユーザスクリプトを実行する場合（形式3）

vmiunit script -unit gyoumu01 -vs 192.168.0.2 -dir "D:¥script folder"

戻り値

0：

正常終了しました。

1：

警告終了しました。

2：

排他エラーが発生しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

コマンド形式

戻り値

1

指定された管理ユニットがありません。

形式1，形式2，形式3

64

2

指定された管理ユニットに仮想サーバが一つも登録されていません。

形式1

64

3

指定された仮想サーバグループがありません。

形式2

64

4

指定された仮想サーバが，指定された管理ユニットに登録されていません。

形式3

64

5

ユーザスクリプトの実行でエラーが発生しました。

形式1，形式2，形式3

64

6

ユーザスクリプトの配布でエラーが発生しました。

形式1，形式2，形式3

64

7

指定されたユーザスクリプトが見つかりません。

形式1，形式2，形式3

64

8

タイムアウトが発生しました。

形式1，形式2，形式3

64

9

仮想サーバ上のファイルの削除に失敗しました。

形式1，形式2，形式3

1

10

実行待ち時間が超過しました。

形式1，形式2，形式3

2

vmiunit start（管理ユニットまたは仮想サーバグループの起動（業務の開始））

形式

管理ユニットに属するすべての仮想サーバを起動する場合（形式1）

vmiunit start [共通引数] -unit <管理ユニット名> [-lb]

仮想サーバグループ内の仮想サーバを起動する場合（形式2）

vmiunit start [共通引数] -unit <管理ユニット名>
              -group <仮想サーバグループ名> [-lb]

機能

管理ユニットを起動，または管理ユニットに属する仮想サーバ上の業務を開始します。

引数

-unit <管理ユニット名>

起動対象の管理ユニットの名称を指定します。

-group <仮想サーバグループ名>

起動対象の仮想サーバグループの名称を指定します。

-lb

負荷分散機連携機能を使用する場合に指定します。

入力例

管理ユニットに属するすべての仮想サーバを起動する場合（形式1）

vmiunit start -unit gyoumu01

仮想サーバグループ内の仮想サーバを起動する場合（形式2）

vmiunit start -unit gyoumu01 -group group02

戻り値

0：

正常終了しました。

1：

警告終了しました。

2：

排他エラーが発生しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

コマンド形式

戻り値

1

指定された管理ユニットがありません。

形式1，形式2

64

2

指定された管理ユニットに仮想サーバが一つも登録されていません。

形式1，形式2

64

3

指定された仮想サーバグループがありません。

形式2

64

4

一部の仮想サーバの起動に失敗しました。

形式1，形式2

1

5

負荷分散機連携機能が有効でない場合に，-lbオプションが指定されました。

形式1，形式2

64

6

負荷分散機の操作でエラーが発生しました。

形式1，形式2

64

7

実行待ち時間が超過しました。

形式1，形式2

2

vmiunit status（管理ユニットまたは仮想サーバグループの状態表示）

形式

管理ユニットの状態を表示する場合（形式1）

vmiunit status [共通引数] -unit <管理ユニット名> -target unit

仮想サーバグループの状態を表示する場合（形式2）

vmiunit status [共通引数] -unit <管理ユニット名> -target group [-group <仮想サーバグループ名>]

仮想サーバの状態を表示する場合（形式3）

vmiunit status [共通引数] -unit <管理ユニット名> -target virtualserver [-group <仮想サーバグループ名>]

機能

管理ユニットまたは仮想サーバグループの状態，またはそれぞれに属する仮想サーバの状態を表示します。仮想サーバグループの状態を表示する場合は，仮想サーバグループの登録順に出力されます。仮想サーバの状態を表示する場合は，仮想サーバ識別子の昇順で出力されます。

仮想サーバグループまたは仮想サーバの状態を表示する場合は，-groupオプションの設定によって表示内容が異なります。オプションの設定の組み合わせによる表示内容を次の表に示します。

表9‒3　オプションの設定の組み合わせによる表示内容

-targetオプションの設定

表示内容

-groupオプションの設定あり

-groupオプションの設定なし

group

特定の仮想サーバグループの状態

管理ユニットに属するすべての仮想サーバグループの状態

virtualserver

特定の仮想サーバグループに属する仮想サーバの状態

管理ユニットに属するすべての仮想サーバの状態

引数

-unit <管理ユニット名>

表示対象の管理ユニットの名称を指定します。

-target {unit | group | virtualserver}

表示対象を指定します。

unit

管理ユニットの状態を表示します。

group

仮想サーバグループの状態を表示します。

virtualserver

管理ユニットまたは仮想サーバグループに属する仮想サーバの状態を表示します。

-group <仮想サーバグループ名>

表示対象の仮想サーバグループの名称を指定します。

入力例・出力例

入力例

管理ユニットの状態を表示する場合（形式1）

vmiunit status -unit gyoumu01 -target unit

仮想サーバグループの状態を表示する場合（形式2）

vmiunit status -unit gyoumu01 -target group
vmiunit status -unit gyoumu01 -target group -group group02

仮想サーバの状態を表示する場合（形式3）

vmiunit status -unit gyoumu01 -target virtualserver
vmiunit status -unit gyoumu01 -target virtualserver -group group02

出力例

管理ユニットの状態を表示する場合

Definition Status: latest
All Groups:        3
Active Groups:     1
Invalid Groups:    2

仮想サーバグループの状態を表示する場合

Group Name:         group01
Update Scope:       latest
Service Status:     active
All Servers:        4
Active Servers:     3
Invalid Servers:    1
(空行)
Group Name:         group02
Update Scope:       changed
Service Status:     blocked
All Servers:        3
Active Servers:     1
Invalid Servers:    0
(空行)
Group Name:         group03
Update Scope:       latest
Service Status:     invalid
All Servers:        3
Active Servers:     2
Invalid Servers:    1
Mark Time:          2009/08/10 15:01:23 JST
Mark Comment:       調査中

仮想サーバの状態を表示する場合

ティアが一つのとき

Virtual Server ID:  192.168.0.11
Tier ID:            combined-tier-001
Group Name:         group01
Update Scope:       none
Logical Status:     working
Observed Status:    working
LB Status:          unblocked
Access:             online
(空行)
Virtual Server ID:  192.168.0.13
Tier ID:            combined-tier-001
Group Name:         group02
Update Scope:       all
Logical Status:     working
Observed Status:    unknown
Access:             offline

ティアが複数のとき

Virtual Server ID:  192.168.0.11
Tier ID:            http-tier-001
Group Name:         group01
Update Scope:       none
Logical Status:     working
Observed Status:    working
LB Status:          unblocked
Access:             online
(空行)
Virtual Server ID:  192.168.0.12
Tier ID:            j2ee-tier-01
Group Name:         group01
Update Scope:       applications
Logical Status:     working
Observed Status:    working
Access:             online
(空行)
Virtual Server ID:  192.168.0.13
Tier ID:            http-tier-001
Group Name:         group02
Update Scope:       all
Logical Status:     working
Observed Status:    operating
LB Status:          blocked
Access:             online
(空行)
Virtual Server ID:  192.168.0.14
Tier ID:            j2ee-tier-01
Group Name:         group02
Update Scope:       all
Logical Status:     working
Observed Status:    unknown
Access:             offline

出力ヘッダ

管理ユニットの状態を表示する場合

Definition Status

管理ユニットの定義の状態が出力されます。

not imported

管理ユニットに定義ディレクトリが何も取り込まれていません。

unattached

管理ユニットに定義ディレクトリは取り込まれているが，仮想サーバグループが登録されていません。

changed

仮想サーバグループの定義の変更範囲（Update Scope）にlatest以外が含まれます。

latest

仮想サーバグループの定義の変更範囲（Update Scope）がすべてlatestです。

All Groups

管理ユニットに登録されている仮想サーバグループの数が出力されます。次の場合は0が出力されます。

定義ディレクトリが取り込まれていない場合（管理ユニットの定義の状態（Definition Status）がnot importedの場合）

仮想サーバグループが登録されていない場合（管理ユニットの定義の状態（Definition Status）がunattachedの場合）

Active Groups

業務を運用中の仮想サーバグループの数が出力されます。業務が運用中の仮想サーバグループとは，業務ステータス（Service Status）がactiveであるものを指します。

Invalid Groups

不正な状態の仮想サーバグループの数が出力されます。不正な状態の仮想サーバグループとは，業務ステータス（Service Status）がInvalidであるものを指します。

仮想サーバグループの状態を表示する場合

Group Name

仮想サーバグループの名称が出力されます。

Update Scope

仮想サーバグループの定義の変更範囲が出力されます。

noupdate

仮想サーバに定義ディレクトリが反映されていません。

changed

仮想サーバの定義の変更範囲（Update Scope）にnone以外が含まれています。

latest

仮想サーバの定義の変更範囲（Update Scope）がすべてnoneです。

Service Status

仮想サーバグループの業務ステータス（運用状態）が出力されます。仮想サーバグループ内の仮想サーバの状態によって，出力される内容が異なります。

active

仮想サーバグループ内のすべての仮想サーバが業務を運用中であること（All Serversの値=Active Serversの値）を示します。

no active

仮想サーバグループ内の一部の仮想サーバが業務を運用中で，かつ不正な状態の仮想サーバがないこと（All Serversの値＞Active Serversの値，かつInvalid Serversの値=0）を示します。

blocked

仮想サーバグループ内に，負荷分散機ステータスがblockedである仮想サーバが一つ以上あることを示します。負荷分散機連携機能を有効にしている場合に出力されます。

invalid

仮想サーバグループ内の一部の仮想サーバが不正な状態であること（Invalid Serversの値＞0）を示します。

All Servers

仮想サーバグループ内の仮想サーバの数が出力されます。

Active Servers

業務を運用中の仮想サーバの数が出力されます。業務を運用中の仮想サーバとは，次の条件すべてを満たすものです。

論理ステータス※がworkingである

負荷分散機連携機能を有効にしている場合は負荷分散機ステータス※がunblockedである

Invalid Servers

不正な状態の仮想サーバの数を示します。不正な状態の仮想サーバとは，次の条件のどちらかを満たすものです。

論理ステータス※がfaultである

負荷分散機連携機能を有効にしている場合は負荷分散機ステータス※がinvalidである

Mark Time

仮想サーバグループに障害マークが設定された時刻が出力されます。障害マークが設定されていない場合は出力されません。

Mark Comment

仮想サーバグループに障害マークが設定された時に記入されたコメントが出力されます。障害マークが設定されていない場合は出力されません。

仮想サーバの状態を表示する場合

Virtual Server ID

仮想サーバ識別子が出力されます。

Tier ID

仮想サーバに割り当てられているティア識別子が出力されます。

Group Name

仮想サーバグループの名称が出力されます。

Update Scope

仮想サーバの定義の変更範囲が出力されます。

none

更新の必要はありません。

applications

アプリケーションの更新が必要です。

all

すべての定義の更新が必要です。

Logical Status

仮想サーバの論理ステータス※が出力されます。

Observed Status

仮想サーバの実ステータス※が出力されます。

LB Status

仮想サーバの負荷分散機ステータス※が出力されます。負荷分散機連携機能が無効な場合は出力されません。

Access

仮想サーバのサーバ通信エージェントとの通信状態が出力されます。

online（正常）

通信状態が正しいことを示します。

offline（異常）

通信状態が正しくないことを示します。この状態は，仮想サーバの電源が入っていない場合も出力されます。仮想サーバの実ステータス※が「operating」の場合は，出力されません。

注※　仮想サーバのステータスには，論理ステータス，実ステータス，負荷分散機ステータスがあります。各ステータスの種類と意味を次に説明します。

論理ステータス

仮想サーバマネージャが記憶している仮想サーバのステータスです。論理ステータスの種類と意味を次の表に示します。

表9‒4　論理ステータスの種類と意味

ステータスの種類

意味

initial

管理ユニットに登録した直後の状態です（初期状態）。未構築状態ともいいます。

working

仮想サーバの業務が稼働している状態です（稼働中状態）。

stopped

仮想サーバの業務が停止している状態です（停止状態）。

starting

仮想サーバの業務の開始処理が実行中の状態です（開始中状態）。

stopping

仮想サーバの業務の停止処理が実行中の状態です（停止中状態）。

updating

仮想サーバの反映処理が実行中の状態です（反映中状態）。

fault（starting）

仮想サーバの業務の開始処理に失敗した状態です（開始失敗による障害状態）。

fault（stopping）

仮想サーバの業務の停止処理に失敗した状態です（停止失敗による障害状態）。

fault（updating）

仮想サーバの反映処理に失敗した状態です（反映失敗による障害状態）。

実ステータス

仮想サーバの実際の状態を示すステータスです。仮想サーバマネージャが仮想サーバに対する処理を実行するたびにチェックします。実ステータスの種類と意味を次の表に示します。

表9‒5　実ステータスの種類と意味

ステータスの種類

意味

initial

仮想サーバ上にアプリケーションサーバが構築されていない状態です（初期状態）。

working

仮想サーバ上のサーバ通信エージェントが起動していて，アプリケーションサーバのすべてのプロセスが稼働している状態です（稼働中状態）。

stopped

仮想サーバ上のサーバ通信エージェントが起動していて，アプリケーションサーバのすべてのプロセスが停止している状態です（停止状態）。

invalid

仮想サーバ上のサーバ通信エージェントが起動しているが，「working」でも「stopped」でもない状態です（不正状態）。

unknown

仮想サーバ上のサーバ通信エージェントと通信できない状態です（不明状態（initialを除く））。

operating

仮想サーバマネージャによって，仮想サーバで何か処理が実行中である状態です（操作中状態）。

注　アプリケーションサーバのすべてのプロセスとは，Management Server，運用管理エージェント，各論理サーバ，J2EEアプリケーション，およびリソースアダプタ（DB Connector）のことです。

負荷分散機ステータス

仮想サーバの負荷分散機上の状態を示すステータスです。仮想サーバマネージャが負荷分散機に閉塞および閉塞解除を実行した状態を記憶しておきます。負荷分散機ステータスの種類と意味を次の表に示します。

表9‒6　負荷分散機ステータスの種類と意味

ステータスの種類

意味

initial

管理ユニットに仮想サーバを登録した直後の状態です（初期状態）。

blocked

負荷分散機の操作で，仮想サーバを閉塞した状態です（閉塞状態）。

unblocked

負荷分散機の操作で，仮想サーバの閉塞を解除した状態です（閉塞解除状態）。

invalid

負荷分散機の操作に失敗した状態や，負荷分散機の状況が不明な状態です（障害状態）。

戻り値

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

コマンド形式

戻り値

1

指定された管理ユニットがありません。

形式1，形式2

64

2

指定された仮想サーバグループがありません。

形式2，形式3

64

3

指定された管理ユニットに仮想サーバグループが一つも登録されていません。

形式2

1

4

指定された管理ユニットに仮想サーバが一つも登録されていません。

形式3

1

vmiunit stop（管理ユニットまたは仮想サーバグループの停止（業務の停止））

形式

管理ユニットに属するすべての仮想サーバを停止する場合（形式1）

vmiunit stop [共通引数] -unit <管理ユニット名> [-lb]

仮想サーバグループ内の仮想サーバを停止する場合（形式2）

vmiunit stop [共通引数] -unit <管理ユニット名>
             -group <仮想サーバグループ名> [-lb]

機能

管理ユニットを停止，または管理ユニットに属する仮想サーバ上の業務を停止します。

引数

-unit <管理ユニット名>

停止対象の管理ユニットの名称を指定します。

-group <仮想サーバグループ名>

停止対象の仮想サーバグループの名称を指定します。

-lb

負荷分散機連携機能を使用する場合に指定します。

入力例

管理ユニットに属するすべての仮想サーバを停止する場合（形式1）

vmiunit stop -unit gyoumu01

仮想サーバグループ内の仮想サーバを停止する場合（形式2）

vmiunit stop -unit gyoumu01 -group group02

戻り値

0：

正常終了

1：

警告終了

2：

排他エラー

64：

異常終了

エラーおよび警告条件

項番

エラー・警告条件

コマンド形式

戻り値

1

指定された管理ユニットがありません。

形式1，形式2

64

2

指定された管理ユニットに仮想サーバが一つも登録されていません。

形式1，形式2

64

3

指定された仮想サーバグループがありません。

形式2

64

4

一部の仮想サーバの停止に失敗しました。

形式1，形式2

1

5

負荷分散機連携機能が無効な場合に，-lbオプションが指定されました。

形式1，形式2

64

6

負荷分散機の操作でエラーが発生しました。

形式1，形式2

64

7

実行待ち時間が超過しました。

形式1，形式2

2

vmiunit unblock（管理ユニットまたは仮想サーバグループの閉塞解除）

形式

管理ユニットの閉塞を解除する場合（形式1）

vmiunit unblock [共通引数] -unit <管理ユニット名>

仮想サーバグループの閉塞を解除する場合（形式2）

vmiunit unblock [共通引数] -unit <管理ユニット名>
                -group <仮想サーバグループ名>

機能

管理ユニットまたは仮想サーバグループの閉塞を解除します。

引数

-unit <管理ユニット名>

閉塞を解除する管理ユニットの名称を指定します。

-group <仮想サーバグループ名>

閉塞を解除する仮想サーバグループの名称を指定します。

入力例

管理ユニットの閉塞を解除する場合（形式1）

vmiunit unblock -unit gyoumu01

仮想サーバグループの閉塞を解除する場合（形式2）

vmiunit unblock -unit gyoumu01 -group group02

戻り値

0：

正常終了しました。

2：

排他エラーが発生しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

コマンド形式

戻り値

1

指定された管理ユニットがありません。

形式1，形式2

64

2

指定された管理ユニットに仮想サーバが一つも登録されていません。

形式1

64

3

指定された仮想サーバグループがありません。

形式2

64

4

閉塞解除の対象※となる仮想サーバが見つかりません。

形式1，形式2

64

5

負荷分散機の操作でエラーが発生しました。

形式1，形式2

64

6

負荷分散機連携機能が無効な場合に，このコマンドが実行されました。

形式1，形式2

64

7

実行待ち時間が超過しました。

形式1，形式2

2

注※　構築済み（論理ステータスがinitial以外）の仮想サーバを指します。

vmiunit unmark（仮想サーバグループの障害マークの設定解除）

形式

vmiunit unmark [共通引数] -unit <管理ユニット名>
               -group <仮想サーバグループ名> [-comment <コメント>]

機能

仮想サーバグループから障害マークの設定を解除します。

引数

-unit <管理ユニット名>

仮想サーバグループが属する管理ユニットの名称を指定します。

-group <仮想サーバグループ名>

障害マークの設定を解除する仮想サーバグループの名称を指定します。

入力例

vmiunit unmark -unit gyoumu01 -group Instance-001

戻り値

0：

正常終了しました。

1：

警告終了しました。

2：

排他エラーが発生しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

戻り値

1

指定された管理ユニットがありません。

64

2

指定された仮想サーバグループがありません。

64

3

障害マークが設定されていません。

1

vmiunit update（管理ユニットに属する仮想サーバへの定義ディレクトリの反映）

形式

vmiunit update [共通引数] -unit <管理ユニット名> [-force]

機能

管理ユニットに属するすべての仮想サーバに定義ディレクトリを反映して，アプリケーションサーバを構築します。または，変更された定義ディレクトリの内容を，管理ユニットに属するすべての仮想サーバに反映します。

引数

-unit <管理ユニット名>

反映対象の管理ユニットの名称を指定します。

-force

定義ディレクトリの内容が変更されていない場合も，管理ユニットに属するすべての仮想サーバへ強制的に定義ディレクトリを反映します。

省略した場合は，定義ディレクトリの内容が変更された場合に，管理ユニットに属するすべての仮想サーバへ反映します。

入力例

vmiunit update -unit gyoumu01

戻り値

0：

正常終了しました。

1：

警告終了しました。

2：

排他エラーが発生しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

戻り値

1

指定された管理ユニットがありません。

64

2

定義ディレクトリが登録されていません。

64

3

指定された管理ユニットに仮想サーバが一つも登録されていません。

64

4

一部の仮想サーバへの反映に失敗しました。

1

5

負荷分散機の操作でエラーが発生しました。

64

6

実行待ち時間が超過しました。

2

9.5　vmiunitadminコマンドのサブコマンドの詳細

vmiunitadminコマンドのサブコマンドの詳細について説明します。

vmiunitadmin changeowner（管理ユニットの所有者の変更）

形式

vmiunitadmin changeowner [共通引数] -unit <管理ユニット名>
                         -user <ユーザID>

機能

管理ユニットの所有者を変更します。

JP1ユーザ認証連携機能を使用している場合，このコマンドは使用できません。

引数

-unit <管理ユニット名>

所有者を変更する管理ユニットの名称を指定します。

-user <ユーザID>

管理ユニットの新しい所有者に設定するシステム構築者アカウント，または仮想サーバマネージャ管理者アカウントのユーザIDを指定します。

入力例

所有者をシステム構築者アカウントに変更する場合

vmiunitadmin changeowner -unit gyoumu01 -user user_a

所有者を仮想サーバマネージャ管理者アカウントに変更する場合

vmiunitadmin changeowner -unit gyoumu01 -user admin

戻り値

0：

正常終了しました。

1：

警告終了しました。

2：

排他エラーが発生しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

戻り値

1

指定された管理ユニット名がありません。

64

2

指定されたユーザIDがありません。

64

3

指定されたユーザIDは，すでに管理ユニットの所有者です。

1

4

実行待ち時間が超過しました。

2

5

JP1ユーザ認証連携機能が有効になっている設定で，使用できないコマンドが実行されました。

64

vmiunitadmin create（管理ユニットの作成）

形式

vmiunitadmin create [共通引数] -unit <管理ユニット名>
                    [-description <管理ユニットの説明>]

機能

仮想サーバマネージャに管理ユニットを作成します。

引数

-unit <管理ユニット名>

作成する管理ユニットの名称を指定します。

-description <管理ユニットの説明>

管理ユニットの説明を指定します。

入力例

vmiunitadmin create -unit gyoumu01

戻り値

0：

正常終了しました。

2：

排他エラーが発生しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

戻り値

1

指定された管理ユニット名が不正です。

64

2

同じ名称で登録済みの管理ユニットがあります。

64

注意事項

大文字・小文字の違いだけの管理ユニット名がすでにある場合は，作成できません。

-descriptionオプションに指定された内容は，文字コードをUnicodeに変換して保存します。そのため，指定内容によっては表示時に文字化けが発生する場合があります。半角英数字，および半角記号以外の文字を使用する場合，vmiunitコマンドにサブコマンドstatusを指定して実行し，管理ユニットの情報を表示して文字化けが発生しないことを確認してください。

vmiunitadmin delete（管理ユニットの削除）

形式

vmiunitadmin delete [共通引数] -unit <管理ユニット名>

機能

仮想サーバマネージャに作成されている管理ユニットを削除します。

引数

-unit <管理ユニット名>

削除する管理ユニットの名称を指定します。

入力例

vmiunitadmin delete -unit gyoumu01

戻り値

0：

正常終了しました。

2：

排他エラーが発生しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

戻り値

1

指定された管理ユニットがありません。

64

2

指定された管理ユニットに仮想サーバが登録されています。

64

3

負荷分散機の操作でエラーが発生しました。

64

4

実行待ち時間が超過しました。

2

vmiunitadmin help（vmiunitadminコマンドのヘルプ表示）

形式

サブコマンドの一覧を表示する場合（形式1）

vmiunitadmin help

サブコマンドのヘルプを表示する場合（形式2）

vmiunitadmin help <サブコマンド>

機能

vmiunitadminコマンドのヘルプを表示します。

サブコマンドが指定された場合は，サブコマンドのヘルプを表示します。サブコマンドが指定されていない場合は，サブコマンドの一覧を表示します。

引数

<サブコマンド>

サブコマンド名を指定します。

入力例・出力例

サブコマンドの一覧を表示する場合（形式1）

vmiunitadmin help

KEOS29601-I Usage :
  vmiunitadmin <subcommand> <common option> <subcommand option>
  <subcommand>:
    create - Create a management unit.
    delete - Delete a management unit.
    changeowner - Change the owner of a management unit.
    list - Show all management units.
    help - Show this message.
  <common option>:
    [-m <host>[:<port>]]
    [-u <user ID>]
    [-p <password>]
    [-wait <waiting time>]
  <subcommand option>: Subcommand arguments.
For details on subcommand option, execute the "<command> help <subcommand>" command.

サブコマンドのヘルプを表示する場合（形式2）

vmiunitadmin help create

KEOS29601-I Usage :
  vmiunitadmin create <common option> -unit <unit name> [-description <description>]
  <common option>:
    [-m <host>[:<port>]]
    [-u <user ID>]
    [-p <password>]
    [-wait <waiting time>]
  -unit <unit name>: Name of the management unit.
  -description <description>: Description of the management unit.

戻り値

0：

正常終了しました。

64：

異常終了しました。

エラーおよび警告条件

項番

エラー・警告条件

コマンド形式

戻り値

1

指定されたサブコマンドがありません。

形式2

64

vmiunitadmin list（管理ユニットの一覧表示）

形式

vmiunitadmin list [共通引数]

機能

仮想サーバマネージャに作成されている管理ユニットの一覧を表示します。一覧には，管理ユニットの情報が管理ユニット名の昇順で出力されます。

引数

なし

入力例・出力例

vmiunitadmin list

JP1ユーザ認証連携機能を使用していない場合

UnitName:      gyoumu01
Owner:         user_a
Description:   業務01

UnitName:      gyoumu02
Owner:         user_a
Description:   業務02

UnitName:      testunit03
Owner:         admin
Description:   テスト用ユニット

JP1ユーザ認証連携機能を使用している場合

UnitName:      gyoumu01
Description:   業務01

UnitName:      gyoumu02
Description:   業務02

UnitName:      testunit03
Description:   テスト用ユニット

出力ヘッダ

UnitName

管理ユニットの名称が出力されます。

Owner

管理ユニットの所有者が出力されます。

JP1ユーザ認証連携機能を使用している場合，この項目は出力されません。

Description

管理ユニットの説明が出力されます。

戻り値

0：

正常終了しました。

64：

異常終了しました。

エラーおよび警告条件

なし

10　JavaVMで使用するコマンド

この章では，製品のJavaVM（以降，JavaVMと呼びます）で使用するコマンドの入力形式，機能などについて説明します。

なお，JavaVMは，Java SE 11またはJava SE 17に準拠しています。詳細については，マニュアル「アプリケーションサーバ & BPM/ESB基盤 概説」を参照してください。また，JDK 11またはJDK 17で使用できるコマンドについては，Oracle社が提供しているJDK 11またはJDK 17のドキュメントを参照してください。

10.1　JavaVMで使用するコマンドの一覧

JavaVMで使用するコマンドの一覧を，次の表に示します。

表10‒1　JavaVMで使用するコマンドの一覧

コマンド名称

分類

概要

car_tar_gz※

coreアーカイブ機能

coreファイルと関連するライブラリなどをgzipコマンドでまとめて，一つのアーカイブファイルに出力します。

このコマンドは，UNIX用です。

car_tar_Z※

coreアーカイブ機能

coreファイルと関連するライブラリなどをcompressコマンドでまとめて，一つのアーカイブファイルに出力します。

このコマンドは，UNIX用です。

eheapprof

Explicitヒープ詳細情報付き拡張スレッドダンプの出力

Explicitヒープ詳細情報をスレッドダンプ中に出力します。

javacore（coreファイルとスレッドダンプの取得／UNIXの場合）

coreファイルの取得

スレッドダンプの取得

coreファイルとスレッドダンプを同時に取得します。

このコマンドは，UNIX用です。

javacore（スレッドダンプの取得／Windowsの場合）

スレッドダンプの取得

スレッドダンプを取得します。

このコマンドは，Windows用です。

javagc

FullGCの強制発生

メモリリーク，システム障害およびアプリケーションのデバッグのために，任意のタイミングでFullGCを発生させます。また，任意のタイミングでFullGCと，Explicitメモリブロックの解放を実行します。

javatrace

トレース情報の収集

coreファイルからスタックトレース情報を収集します。

このコマンドは，UNIX用です。

jheapprof

クラス別統計情報付き拡張スレッドダンプの出力

クラス別統計情報をスレッドダンプ中に出力します。

jheapprofanalyzer

クラス別統計情報解析ファイルのCSV出力

クラス別統計情報解析ファイルをCSV形式で出力します。

注※　AIXでは使用できません。snapcoreコマンドを使用してください。

10.2　JavaVMで使用するコマンドの詳細

JavaVMで使用するコマンドの入力形式，機能などを次に示します。

コマンドの格納先

JavaVMで使用するコマンドは，次のディレクトリに格納されています。

Windowsの場合

<Application Serverのインストールディレクトリ>¥jdk¥bin¥

UNIXの場合

/opt/Cosminexus/jdk/bin/

car_tar_gz（coreアーカイブ機能）

形式

car_tar_gz [-i <実行ファイル名>] [-f] [-s|-S] [<coreファイル名>] > <出力ファイル名>

機能

coreファイルと関連するライブラリなどをまとめて，一つのアーカイブファイルに出力します。car_tar_gzコマンドはgzipコマンドを使用して圧縮します。なお，このコマンドはUNIX用です。

引数

-i <実行ファイル名>

実行ファイル名を指定します。

-f

パス名付きでライブラリなどのファイルを取得します。

-s

出力するアーカイブファイルのサイズ（単位：バイト）を報告します。

この場合，アーカイブファイルは出力されません。

-S

アーカイブファイルを作成するための，シェルスクリプトを出力します。

このオプションを指定する場合，<出力ファイル名>には，シェルスクリプト名を指定してください。

出力されたシェルスクリプトを実行すると，アーカイブファイルが出力されます。

<coreファイル名>

coreファイル名を指定します。省略した場合，"core"が指定されます。

<出力ファイル名>

アーカイブファイル，またはシェルスクリプトのファイル名を指定します。

入力例

アーカイブファイルを作成する場合

car_tar_gz -f core.8326 > corefile.tar.gz

アーカイブファイルのサイズを調べる場合

car_tar_gz -s core.8326

シェルスクリプトからアーカイブファイルを作成する場合

シェルスクリプトを作成します。

car_tar_gz -S core.8326 > collect_cores.csh

シェルスクリプトに実行権を付与します。

chmod +x ./collect_cores.csh

シェルスクリプトを実行して，アーカイブファイルを作成します。

./collect_cores.csh > corefile.tar.gz

戻り値

0：

正常終了しました。

1：

異常終了しました。

出力メッセージ

次のメッセージを出力した場合，正常なアーカイブファイルは出力されません。

表10‒2　car_tar_gzコマンドで出力されるエラーメッセージ

項番

エラーメッセージ

説明

1

usage: car_tar_gz [ -i executable-file ] [ -f ] [ -s | -S ] [ core-file ]

コマンドの引数が不正です。

2

car_tar_gz: inner error!

car_tar_gzコマンドの内部エラーです。

3

car_tar_gz: cannot create temporary name

一時的に使用するファイルが作成できません。

カレントディレクトリにある，ファイルcar_exec??（??は00〜99）を削除するか，移動してください。

4

car_tar_gz: 〜 : file not found

ファイルが見つかりません。

coreファイルおよび-iオプションで指定した実行ファイルを確認してください。

5

car_tar_gz: 〜 : not supported platform

サポートしていないOSです。

注意事項

カレントディレクトリに書き込み権限が必要です。

同じディレクトリ下で，同じcoreファイルまたは作成時間が同じcoreファイルに対して，car_tar_Zコマンドおよびcar_tar_gzコマンドは同時に実行できません。

システムにtarコマンドおよびgzipコマンドがインストールされている必要があります。

car_tar_gzコマンド実行中に強制終了した場合，カレントディレクトリにcar_tar_gzコマンドが作成した一時的なファイルやディレクトリが残ります。

一時的に作成されるファイル：car_exec??（??は，00〜99）

一時的に作成されるディレクトリ：carYYMMDDhhmm/（YYMMDDhhmmは，coreファイルの作成年月日時分）

car_tar_Z（coreアーカイブ機能）

形式

car_tar_Z [-i <実行ファイル名>] [-f] [-s|-S] [<coreファイル名>] > <出力ファイル名>

機能

coreファイルと関連するライブラリなどをまとめて，一つのアーカイブファイルに出力します。car_tar_Zコマンドはcompressコマンドを使用して圧縮します。なお，このコマンドはUNIX用です。

引数

-i <実行ファイル名>

実行ファイル名を指定します。

-f

パス名付きでライブラリなどのファイルを取得します。

-s

出力するアーカイブファイルのサイズ（単位：バイト）を報告します。

この場合，アーカイブファイルは出力されません。

-S

アーカイブファイルを作成するための，シェルスクリプトを出力します。

このオプションを指定する場合，<出力ファイル名>には，シェルスクリプト名を指定してください。

出力されたシェルスクリプトを実行すると，アーカイブファイルが出力されます。

<coreファイル名>

coreファイル名を指定します。省略した場合，"core"が指定されます。

<出力ファイル名>

アーカイブファイル，またはシェルスクリプトのファイル名を指定します。

入力例

アーカイブファイルを作成する場合

car_tar_Z -f core.8326 > corefile.tar.Z

アーカイブファイルのサイズを調べる場合

car_tar_Z -s core.8326

シェルスクリプトからアーカイブファイルを作成する場合

シェルスクリプトを作成します。

car_tar_Z -S core.8326 > collect_cores.csh

シェルスクリプトに実行権を付与します。

chmod +x ./collect_cores.csh

シェルスクリプトを実行して，アーカイブファイルを作成します。

./collect_cores.csh > corefile.tar.Z

戻り値

0：

正常終了しました。

1：

異常終了しました。

出力メッセージ

次のメッセージを出力した場合，正常なアーカイブファイルは出力されません。

表10‒3　car_tar_Zコマンドで出力されるエラーメッセージ

項番

エラーメッセージ

説明

1

usage: car_tar_Z [ -i executable-file ] [ -f ] [ -s | -S ] [ core-file ]

コマンドの引数が不正です。

2

car_tar_Z: inner error!

car_tar_Zコマンドの内部エラーです。

3

car_tar_Z: cannot create temporary name

一時的に使用するファイルが作成できません。

カレントディレクトリにある，ファイルcar_exec??（??は00〜99）を削除するか，移動してください。

4

car_tar_Z: 〜 : file not found

ファイルが見つかりません。

coreファイルおよび-iオプションで指定した実行ファイルを確認してください。

5

car_tar_Z: 〜 : not supported platform

サポートしていないOSです。

注意事項

カレントディレクトリに書き込み権限が必要です。

同じディレクトリ下で，同じcoreファイルまたは作成時間が同じcoreファイルに対して，car_tar_Zコマンドおよびcar_tar_gzコマンドは同時に実行できません。

システムにtarコマンドおよびcompressコマンドがインストールされている必要があります。

car_tar_Zコマンド実行中に強制終了した場合，カレントディレクトリにcar_tar_Zコマンドが作成した一時的なファイルやディレクトリが残ります。

一時的に作成されるファイル：car_exec??（??は，00〜99）

一時的に作成されるディレクトリ：carYYMMDDhhmm/（YYMMDDhhmmは，coreファイルの作成年月日時分）

eheapprof（Explicitヒープ詳細情報付き拡張スレッドダンプの出力）

形式

eheapprof [-i|-f] [-force] [-freeratio] -p <プロセスID>

機能

引数に指定したプロセスIDのjavaプロセスについて，Explicitヒープ詳細情報を含んだ拡張スレッドダンプを出力します。また，Explicitメモリブロック内のオブジェクトの統計情報，およびExplicitメモリブロックの解放率情報も拡張スレッドダンプに出力できます。

引数

-i

Explicitヒープ詳細情報付き拡張スレッドダンプの出力処理の実行を確認するメッセージが表示されます。表示されたメッセージに対してyまたはnを入力します。このとき，yを入力すると，Explicitヒープ詳細情報を含んだ拡張スレッドダンプが出力されます。nを入力すると，何も出力しないで処理を終了します。省略した場合，-fオプションが指定されないかぎり，このオプションは有効です。

-f

-iオプションを無効にします。省略した場合，-iオプションが有効になります。

-force

javaプロセスが作成する/tmp/hsperfdata_<ユーザ名>/<プロセスID>ファイルの有無の確認をしないで，-pオプションで指定したプロセスIDのjavaプロセスに対して拡張スレッドダンプの出力を要求します。

なお，このオプションはUNIX用のオプションです。

-freeratio

Explicitメモリブロックのオブジェクト解放率情報の出力を有効にして，拡張スレッドダンプを出力します。

このオプションを指定してeheapprofコマンドを実行すると，JavaVMによって次の処理が実行され，オブジェクト解放率情報が取得されます。

FullGC

Explicitメモリブロックの解放処理

これらの処理によって，アプリケーションの実行が数秒間止まるおそれがあるため，Explicitメモリブロックのオブジェクト解放率情報は，システム開発時や業務停止時間中に出力することをお勧めします。

-p <プロセスID>

Explicitヒープ詳細情報を含んだ拡張スレッドダンプを出力するjavaプログラムのプロセスIDを指定します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

一定時間内にExplicitヒープ詳細情報を含んだ拡張スレッドダンプ出力処理終了の応答がありませんでした。

出力メッセージ

次のエラーメッセージまたは警告メッセージが出力された場合，Explicitヒープ詳細情報付き拡張スレッドダンプは出力されません。

表10‒4　eheapprofコマンドで出力されるメッセージ（Windowsの場合）

項番

エラーメッセージ

説明

1

usage: eheapprof [-f|-i] [-freeratio] -p process-id

eheapprofコマンドへの引数の指定が間違っています。

2

eheapprof: illegal option -- <オプション>

eheapprofコマンドに指定した<オプション>が不正です。

3

<プロセスID>: Now processing previous request, this request canceled

eheapprofコマンドの引数に指定した<プロセスID>に該当するプロセスが，現在Explicitヒープ詳細情報を出力しています。

4

<プロセスID>: Not owner

eheapprofコマンドの引数に指定した<プロセスID>に0が指定されています。

5

eheapprof: can't create work file at temporary directory , this request canceled

一時ファイル用ディレクトリに参照・書き込み権限がない場合，Explicitヒープ詳細情報付き拡張スレッドダンプを出力できません。Explicitヒープ詳細情報付き拡張スレッドダンプの出力要求はキャンセルされます。

6

eheapprof: can't get temporary directory, this request canceled

一時ファイル用ディレクトリが取り出せない場合，Explicitヒープ詳細情報付き拡張スレッドダンプを出力できません。Explicitヒープ詳細情報付き拡張スレッドダンプの出力要求はキャンセルされます。

7

eheapprof: please delete <削除できなかったファイル名> in <削除できなかったファイルのフルパス>

eheapprofコマンドを終了したときに，内部ファイルを削除できませんでした。削除できなかったファイルのフルパスにある，削除できなかったファイルを削除してください。

8

eheapprof: unexpected error occurred: <エラー原因>

eheapprofコマンド実行中に予期しないエラーが発生しました。

<エラー原因>には，例えば下記のような表示がされます。

作業用メモリ確保に失敗した場合

malloc systemcall fail (errno=Y)

オブジェクトのクローズに失敗した場合

close systemcall fail (errno=Y)

9

eheapprof: can't communicate with process <プロセスID>

eheapprofコマンドの引数に指定した<プロセスID>に該当するプロセスに問題があり，通信処理でエラーが発生しているため通信できません。または，eheapprofコマンドの引数に指定した<プロセスID>に該当するプロセスがありません。

10

<プロセスID>: Timeout occurred. Java process not responding

eheapprofコマンドの引数に指定した<プロセスID>に該当するプロセスから，一定時間内にExplicitヒープ詳細情報出力処理終了の応答がありませんでした。

表10‒5　eheapprofコマンドで出力されるメッセージ（UNIXの場合）

項番

エラーメッセージ

説明

1

usage: eheapprof [-f|-i] [-force] [-freeratio] -p process-id

eheapprofコマンドへの引数の指定が間違っています。

2

eheapprof: illegal option -- <オプション>

eheapprofコマンドに指定した<オプション>が不正です。

3

<プロセスID>: Now processing previous request, this request canceled

eheapprofコマンドの引数に指定した<プロセスID>に該当するプロセスが，現在Explicitヒープ詳細情報を出力しています。

4

<プロセスID>: No such process

eheapprofコマンドの引数に指定した<プロセスID>に該当するプロセスがありません。または，eheapprofコマンドで指定した<プロセスID>に該当するプロセスがjavaプロセス以外でした。

5

<プロセスID>: Not owner

eheapprofコマンドの引数に指定した<プロセスID>のプロセスのオーナーではありません。

6

eheapprof: can't create work file at /tmp , this request canceled

一時ファイル用ディレクトリに参照・書き込み権限がない場合，Explicitヒープ詳細情報付き拡張スレッドダンプを出力できません。Explicitヒープ詳細情報付き拡張スレッドダンプの出力要求はキャンセルされます。

7

eheapprof: please delete <削除できなかったファイル名> in <削除できなかったファイルのフルパス>

eheapprofコマンドを終了したときに，内部ファイルを削除できませんでした。削除できなかったファイルのフルパスにある，削除できなかったファイルを削除してください。

8

eheapprof: unexpected error occurred: <エラー原因>

eheapprofコマンド実行中に予期しないエラーが発生しました。

<エラー原因>には，例えば下記のような表示がされます。

作業用メモリ確保に失敗した場合

malloc systemcall fail (errno=Y)

オブジェクトのクローズに失敗した場合

close systemcall fail (errno=Y)

9

<プロセスID>: Timeout occurred. Java process not responding

eheapprofコマンドの引数に指定した<プロセスID>に該当するプロセスから，一定時間内にExplicitヒープ詳細情報出力処理終了の応答がありませんでした。

注意事項

eheapprofコマンドはプログラムの開発用ユーティリティとして提供されているものです。システムの運用では使用しないでください。

同じjavaプロセスに対して，同時にeheapprofコマンドは実行できません。前回のeheapprofコマンドによるExplicitヒープ詳細情報が拡張スレッドダンプに出力されたあとに実行してください。

Windowsの場合，Javaプロセスは起動時にMailSlotを使った通信の初期化処理を実行します。初期化に失敗した場合，メッセージを出力して処理を中断します。

Windowsの場合，引数に指定したプロセスIDのjavaプロセス所有者以外でもeheapprofコマンドを実行できます。

UNIXの場合，引数に指定したプロセスIDのjavaプロセスオーナーでないユーザがこのコマンドを実行すると，メッセージを出力して処理を終了します。ただし，ユーザがrootである場合は，処理を継続します。

UNIXの場合，eheapprofコマンドは，SIGQUITシグナルを指定されたプロセスに送信します。誤ってjavaプログラム以外を指定すると，ほかのプログラムが停止することがあります。

UNIXの場合，eheapprofコマンド実行時に，/tmp/hsperfdata_<ユーザ名>/<プロセスID>ファイルを使用します。該当するファイルが存在しない場合，eheapprofコマンドによるExplicitヒープ詳細情報付き拡張スレッドダンプは出力できません。ただし，-forceオプションを指定した場合，/tmp/hsperfdata_<ユーザ名>/<プロセスID>ファイルの有無の確認をしないで，-pオプションで指定したプロセスIDのjavaプロセスに対して拡張スレッドダンプの出力を要求します。

javacore（coreファイルとスレッドダンプの取得／UNIXの場合）

形式

javacore [-i|-f] [-force] -p <プロセスID>

機能

コマンド実行時のcoreファイルとスレッドダンプを同時に取得します。なお，このコマンドは，UNIX用です。

引数

-i

coreファイルおよびスレッドダンプの出力処理の実行を確認するメッセージが表示されます。表示されたメッセージに対してyまたはnを入力します。このとき，yを入力するとスレッドダンプが出力されます。nを入力すると，何も出力しないで処理を終了します。省略した場合，-fオプションが指定されないかぎり，このオプションは有効です。

-f

-iオプションを無効にします。省略した場合，-iオプションが有効になります。

-force

javaプロセスが作成する/tmp/hsperfdata_<ユーザ名>/<プロセスID>ファイルの有無の確認をしないで，-pオプションで指定したプロセスIDのjavaプロセスに対してcoreを出力させます。

-p <プロセスID>

<プロセスID>には，coreファイルとスレッドダンプを取得するjavaプログラムのプロセスIDを指定します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

一定時間内にcore生成処理終了の応答がありませんでした。

入力例

-fオプションを省略してjavacoreコマンドを実行します。

javacore -p 8326

coreファイルおよびスレッドダンプの出力処理の実行を確認するメッセージが表示されます。

send SIGQUIT to 8326:?(y/n)

coreファイルおよびスレッドダンプを取得する場合はyを，取得しない場合はnを入力します。

send SIGQUIT to 8326:?(y/n)y

coreファイルおよびスレッドダンプを取得すると，実行中のjavaプログラムでは次のメッセージが出力されます。

Now generating core file (javacore8662.030806215140.core)...
done

(スレッドダンプを出力)

Writing Java core to javacore8662.030806215140.txt... OK

実行中のjavaプログラムは，カレントディレクトリに次のファイルを作成し，プログラムを継続します。

coreファイル

javacore<プロセスID>.<日時>.core

スレッドダンプ

javacore<プロセスID>.<日時>.txt

出力メッセージ

次のエラーメッセージまたは警告メッセージを出力した場合，coreファイルやスレッドダンプは取得されません。

表10‒6　javacoreコマンドで出力されるエラーメッセージ

項番

エラーメッセージ

説明

1

usage: javacore [-f|-i] [-force] -p process-id

コマンドの引数が不正です。

2

javacore: can't create work file at /tmp, this request canceled

/tmpに参照および書き込み権限がありません。

3

javacore: illegal option --<オプション>

コマンドの引数に指定した<オプション>が不正です。

4

javacore: unexpected error occurred:<エラー原因>

コマンド実行中に予期しないエラーが発生しました。

5

javacore: please delete <削除できなかったファイル名> in <削除できなかったファイルのフルパス>

コマンド終了時にjavacoreコマンドの内部処理で作成したファイルを削除できませんでした。<削除できなかったファイルのフルパス>にある，削除できなかったファイルを削除してください。

6

<プロセスID>: No such process

javacoreコマンドの引数に指定した<プロセスID>に該当するプロセスがありません。または，javacoreコマンドで指定した<プロセスID>に該当するプロセスがjavaプロセス以外でした。

7

<プロセスID>: Not owner

実行ユーザは，コマンドの引数に指定した<プロセスID>に該当するプロセスのオーナーではありません。

8

<プロセスID>: Now processing previous request, this request canceled

コマンドの引数に指定した<プロセスID>のプロセスが現在coreを生成中です。

9

<プロセスID>: Timeout occurred. Java process not responding.

コマンドの引数に指定した<プロセスID>に該当するプロセスから，一定時間内にcore出力処理終了の応答がありませんでした。

注意事項

javacoreコマンドは，SIGQUITシグナルを指定されたプロセスに送信します。誤ってjavaプログラム以外を指定すると，ほかのプログラムが停止することがあります。

同じJavaプロセスに対して，同時にjavacoreコマンドは実行できません。前回のjavacoreコマンドによるcore出力処理が終了したあとに実行してください。

JavaVMプロセスが，スレッドダンプ取得要求に反応しないで無応答状態になっている場合には，javacoreコマンドによるcoreファイルも取得できません。この場合は，kill -6コマンドの実行によって，JavaVMプロセスを強制停止させてcoreファイルを取得してください。

Linuxの場合，gdbのgcoreコマンドでcoreを生成します。gdbがインストールされていない場合には，次のエラーメッセージが標準出力に出力されます。

Error occurred in generating core file, gdb not found.

また，インストールされているgdbのバージョンが古い場合には，次のエラーメッセージが標準出力に出力されます。

Error occurred in generating core file, gdb version 5.2 or later needed.

javacoreコマンドは，実行時に，/tmp/hsperfdata_<ユーザ名>/<プロセスID>ファイルを使用します。該当するファイルが存在しない場合は，javacore コマンドによるcoreファイルの出力はできません。ただし，-forceオプションを指定した場合，/tmp/hsperfdata_<ユーザ名>/<プロセスID>ファイルの有無の確認をしないで，-pオプションで指定したプロセスIDのJavaプロセスに対してcoreを出力させます。

javacore（スレッドダンプの取得／Windowsの場合）

形式

javacore [-i|-f] -p <プロセスID>

機能

コマンド実行時のスレッドダンプを取得します。なお，このコマンドは，Windows用です。

引数

-i

スレッドダンプの出力処理の実行を確認するメッセージが表示されます。表示されたメッセージに対してyまたはnを入力します。このとき，yを入力するとスレッドダンプが出力されます。nを入力すると，何も出力しないで処理を終了します。省略した場合，-fオプションが指定されないかぎり，このオプションは有効です。

-f

-iオプションを無効にします。省略した場合，-iオプションが有効になります。

-p <プロセスID>

<プロセスID>には，スレッドダンプを取得するjavaプログラムのプロセスIDを指定します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

一定時間内にスレッドダンプ出力処理終了の応答がありませんでした。

入力例

-fオプションを省略してjavacoreコマンドを実行します。

% javacore -p 8326

スレッドダンプの出力処理の実行を確認するメッセージが表示されます。

Output a thread dump:?(y/n)

スレッドダンプを出力する場合はyを，出力しない場合はnを入力します。

Output a thread dump:?(y/n)y

実行中のjavaプログラムは，カレントディレクトリに次のファイルを作成し，プログラムを継続します。

スレッドダンプ

javacore<プロセスID>.<日時>.txt

出力メッセージ

次のエラーメッセージまたは警告メッセージを出力した場合，スレッドダンプは取得されません。

表10‒7　javacoreコマンドで出力されるエラーメッセージ

項番

メッセージ

説明

1

usage: javacore [-f|-i] -p process-id

コマンドの引数が不正です。

2

javacore: illegal option -- <オプション>

コマンドの引数に指定した<オプション>が不正です。

3

javacore: can't communicate with process <プロセスID>.

引数に指定した<プロセスID>に問題があるため，通信できません。

または，引数に指定した<プロセスID>に該当するプロセスが存在しません。

4

<プロセスID>: Not owner

コマンドの引数に指定した<プロセスID>に0が指定されています。

5

<プロセスID>: Now processing previous request, this request canceled

コマンドの引数に指定した<プロセスID>のプロセスがすでに処理中です。

6

javacore: can't create work file at temporary directory, this request canceled

一時ファイル用ディレクトリに参照および書き込み権限がありません。

7

javacore: can't get temporary directory, this request canceled

GetTempPath()APIがエラーリターンしたため，一時ファイル用ディレクトリが取り出せません。

8

javacore: unexpected error occurred: <エラー原因>

コマンド実行中に予期しないエラーが発生しました。

9

<プロセスID>: Timeout occurred. Java process not responding.

コマンドの引数に指定した<プロセスID>に該当するプロセスから，一定時間内にスレッドダンプ出力処理終了の応答がありませんでした。

10

javacore: please delete <削除できなかったファイル名> in <削除できなかったファイルのフルパス>.

コマンド終了時にjavacoreコマンドの内部処理で作成したファイルを削除できませんでした。<削除できなかったファイルのフルパス>にある，削除できなかったファイルを削除してください。

注意事項

同じJavaプロセスに対して，同時にjavacoreコマンドは実行できません。前回のjavacoreコマンドによるスレッドダンプ出力処理が終了したあとに実行してください。

次の場合，メッセージ「<プロセスID>: Timeout occurred. Java process not responding.」が出力されてjavacoreコマンドが終了することがあります。

メモリ使用量が1ギガバイトを超えるようなJavaプロセスに対してjavacoreコマンドを実行した場合

システムが高負荷の状態でjavacoreコマンドを実行した場合

メッセージが出力されても，対象となるJavaプロセスのカレントディレクトリにcore.<プロセスID>が生成され，ファイルサイズが徐々に増えている場合は処理が正常に行われています。その場合はJavaプロセスを停止させないようにしてください。

javagc（GCの強制発生）

形式

javagc [-i|-f] [-v] [-s] [-force] [-ehgc] -p <プロセスID>

機能

メモリリーク，システム障害およびアプリケーションのデバッグのために，プロセスIDが<プロセスID>のjavaプロセスに対して，任意のタイミングでFullGCを発生させます。また，プロセスIDが<プロセスID>のjavaプロセスに対して，任意のタイミングでFullGCと，Explicitメモリブロックの解放を実行します。

javaプロセスとの通信にはSIGQUITシグナルを使用します。コマンドを実行すると，コマンドの処理内容をユーザに確認します。n（発生させない，実行しない，または送信しない）と回答した場合には，コマンドの処理は実行されません（戻り値が1となります）。この確認動作は，-fオプションを指定することで省略できます。

<プロセスID>のjavaプロセスが通常の要因で発生するCopyGCやFullGCを実行中の場合は，その終了を待ってからコマンドを実行します。

引数

-i

次に示すコマンドの処理内容をユーザに確認します。

<プロセスID>のプロセスに対して，GCを発生させるかどうか（Windowsの場合）

<プロセスID>のプロセスに対して，Explicitメモリブロックの解放を実行するかどうか

GCを発生させるためにSIGQUITシグナルを送信させるかどうか（UNIXの場合）

このオプションより前に指定した，-fオプションを無効にします。

-f

次に示すコマンドの処理内容をユーザに確認しません。

<プロセスID>のプロセスに対して，GCを発生させるかどうか（Windowsの場合）

Explicitメモリブロックの解放を実行するかどうか

GCを発生させるためにSIGQUITシグナルを送信させるかどうか（UNIXの場合）

このオプションより前に指定した，-iオプションを無効にします。

-v

-XX:+HitachiVerboseGCオプションの指定がなくても，JavaVMログファイル作成の規則に従ってJavaVMログファイルを作成して，拡張verbosegc情報を出力します。

その際，以下のオプション値も反映した内容の拡張verbosegc情報を出力します。

-XX:+HitachiVerboseGCPrintDate

-XX:+HitachiVerboseGCPrintCause

-XX:+HitachiVerboseGCCpuTime

-XX:+HitachiCommaVerboseGC

-s

標準出力に拡張verbosegc情報を出力します。

その際，以下のオプション値も反映した内容の拡張verbosegc情報を出力します。

-XX:+HitachiVerboseGCPrintDate

-XX:+HitachiVerboseGCPrintCause

-XX:+HitachiVerboseGCCpuTime

-XX:+HitachiCommaVerboseGC

-force

javaプロセスが作成する/tmp/hsperfdata_<ユーザ名>/<プロセスID>ファイルの有無の確認をしないで，-pオプションで指定したプロセスIDのjavaプロセスに対してGCやExplicitメモリブロックの解放を実行します。

なお，このオプションはUNIX用のオプションです。

-ehgc

プロセスIDが<プロセスID>のjavaプロセスに対して，FullGCと，Explicitメモリブロックの解放を実行します。Explicitメモリブロックの解放については，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「7.9　javagcコマンドによるExplicitメモリブロックの解放」を参照してください。

-p <プロセスID>

FullGCや，Explicitメモリブロックの解放を実行したいプロセスIDを指定します。

JavaVM拡張オプションについては，次の個所を参照してください。

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「14.1　JavaVM拡張オプションの一覧」

マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「14.2　JavaVM拡張オプションの詳細」

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

一定時間内にGC処理終了の応答がありませんでした。

入力例

-iオプションを指定してjavagcコマンドを実行します。

javagc -i -v -p 8326

Windowsの場合，GCを発生させるかどうかの確認メッセージが表示されます。UNIXの場合，プロセスIDの確認メッセージが表示されます。

Windowsの場合

Force VM to execute GC ? (y/n)

UNIXの場合

send SIGQUIT to 8326:?(y/n)

Windowsの場合，GCを発生させる場合はyを，発生させない場合はnを入力します。UNIXの場合，SIGQUITシグナルを送信させる場合はyを，送信させない場合はnを入力します。

Windowsの場合

Force VM to execute GC ? (y/n)y

UNIXの場合

send SIGQUIT to 8326:?(y/n)y

出力例

[VGC]<Wed Mar 17 00:42:30 2004>(Skip Full:0,Copy:0)[Full GC 149K->149K(1984K), 0.0786038 secs][DefNew::Eden: 264K->0K(512K)][DefNew::Survivor: 0K->63K(64K)][Tenured: 85K->149K(1408K)][Metaspace: 3634K(4492K, 4492K)->3634K(4492K, 4492K)][class space: 356K(388K, 388K)->356K(388K, 388K)][cause:JavaGC Command]

出力メッセージ

表10‒8　javagcコマンドで出力されるメッセージ（Windowsの場合）

項番

メッセージ

説明

1

usage: javagc [-f|-i] [-v] [-s] [-ehgc] -p process-id

javagcコマンドへの引数の指定が間違っています。

2

javagc: illegal option--<オプション>

javagcコマンドに指定した<オプション>が不正です。

3

javagc: can't communicate with process <プロセスID>

javagcコマンドの引数に指定した<プロセスID>に問題があり，通信処理でエラーが発生しているため通信できません。または，javagcコマンドの引数に指定した<プロセスID>に該当するプロセスがありません。

4

<プロセスID>: Not owner

javagcコマンドで指定した<プロセスID>に0が指定されています。

5

<プロセスID>: Now processing previous request, this request canceled

javagcコマンドの引数に指定した<プロセスID>に該当するプロセスは，前回のjavagcコマンドによるGCを実行中です。javagcコマンドによるGC実行要求はキャンセルされます。

6

javagc: can't create work file at temporary directory, this request canceled

一時ファイル用ディレクトリに参照・書き込み権限がない場合，GC要求ファイルが作成できません。このGC実行要求はキャンセルされます。

7

javagc: can't get temporary directory, this request canceled

一時ファイル用ディレクトリが取り出せない場合，GC要求ファイルが作成できません。このGC実行要求はキャンセルされます。

8

javagc: unexpected error occurred:<エラー原因>

javagcコマンド実行中に予期しないエラーが発生しました。

<エラー原因>には，例えば下記のような表示がされます。

作業用メモリ確保に失敗した場合

malloc systemcall fail (errno=Y)

オブジェクトのクローズに失敗した場合

close systemcall fail (errno=Y)

9

<プロセスID>: Timeout occurred. Java process not responding.

javagcコマンドの引数に指定した<プロセスID>に該当するプロセスから，一定時間内にGC処理終了の応答がありませんでした。

10

javagc : please delete <削除できなかったファイル名> in <削除できなかったファイルのフルパス>

javagcコマンドを終了したときに，内部ファイルを削除できませんでした。削除できなかったファイルのフルパスにある，削除できなかったファイルを削除してください。

11

<プロセスID>: Failed to retry GC. Java process is GC locked.

javagcコマンドに引数に指定した<プロセスID>に該当するプロセスが，GC実行が抑止された状態で，GC処理が実行できませんでした。

表10‒9　javagcコマンドで出力されるメッセージ（UNIXの場合）

項番

メッセージ

説明

1

javagc [-f|-i][-v][-s] [-force] [-ehgc] -p process-id

javagcコマンドへの引数の指定が間違っています。

2

javagc: illegal option--<オプション>

javagcコマンドに指定した<オプション>が不正です。

3

<プロセスID>: No such process

javagcコマンドの引数に指定した<プロセスID>に該当するプロセスがありません。または，javagcコマンドで指定した<プロセスID>に該当するプロセスがjavaプロセス以外でした。

4

<プロセスID>: Not owner

実行ユーザは，javagcコマンドの引数に指定した<プロセスID>に該当するプロセスのオーナーではありません。

5

<プロセスID>: Now processing previous request, this request canceled

javagcコマンドの引数に指定した<プロセスID>に該当するプロセスは，前回のjavagcコマンドによるGCを実行中です。javagcコマンドによるGC実行要求はキャンセルされます。

6

javagc: can't create work file at /tmp, this request canceled

/tmpに参照および書き込み権限がないため，GC要求ファイルが作成できません。javagcコマンドによるGC実行要求はキャンセルされます。

7

javagc: unexpected error occurred:<エラー原因>

javagcコマンド実行中に予期しないエラーが発生しました。

<エラー原因>には，例えば下記のような表示がされます。

作業用メモリ確保に失敗した場合

malloc systemcall fail (errno=Y)

オブジェクトのクローズに失敗した場合

close systemcall fail (errno=Y)

8

<プロセスID>: Timeout occurred. Java process not responding.

javagcコマンドの引数に指定した<プロセスID>に該当するプロセスから，一定時間内にGC処理終了の応答がありませんでした。

9

javagc : please delete <削除できなかったファイル名> in <削除できなかったファイルのフルパス>

javagcコマンドを終了したときに，内部ファイルを削除できませんでした。削除できなかったファイルのフルパスにある，削除できなかったファイルを削除してください。

10

<プロセスID>: Failed to retry GC. Java process is GC locked.

javagcコマンドに引数に指定した<プロセスID>に該当するプロセスが，GC実行が抑止された状態で，GC処理が実行できませんでした。

注意事項

同じjavaプロセスに対して，同時にjavagcコマンドは実行できません。前回のjavagcコマンドによるGC処理が終了してから実行してください。前回のGC処理が終了している場合は，JavaVMログファイルに出力される拡張verbosegc機能のGCの要因に"JavaGC Command"が出力されます。

Windowsの場合，引数に指定したプロセスIDのjavaプロセス所有者以外でもjavagcコマンドを実行できます。

UNIXの場合，javagcコマンドはSIGQUITシグナルを指定されたプロセスIDに送信します。誤ってjavaプロセス以外のプロセスIDを指定すると，ほかのプログラムが停止することがあります。

UNIXの場合，javagcコマンド実行時に，/tmp/hsperfdata_<ユーザ名>/<プロセスID>ファイルを使用します。該当するファイルが存在しない場合は，javagcコマンドによるGCの要求はできません。ただし，-forceオプションを指定した場合，/tmp/hsperfdata_<ユーザ名>/<プロセスID>ファイルの有無の確認をしないで，-pオプションで指定したプロセスIDのjavaプロセスに対してGCを発生させます。

javatrace（トレース情報の収集）

形式

javatrace <coreファイル名> <実行ファイル名> [<出力ファイル名>] [-l <ライブラリファイル名> ...]

機能

coreファイルからスタックトレース情報を取得します。なお，このコマンドは，UNIX用です。

このコマンドは，JavaVMが異常終了してcoreファイルを生成した場合，その異常終了の原因究明に必要な情報を取得するために実行するコマンドです。プロセスダウン時の詳細要因などが調査できます。

引数

<coreファイル名>

coreファイル名を指定します。

<実行ファイル名>

coreファイルを生成した実行ファイル名を指定します。

<出力ファイル名>

出力ファイル名を指定します。

省略した場合は，カレントディレクトリの"javatrace.log"に出力されます。

-l <ライブラリファイル名>

使用したライブラリファイルを指定します。

共用ライブラリが絶対パスで実行ファイルに取り込まれている場合は，自動的に読み込まれるため，指定する必要はありません。

戻り値

0：

正常終了しました。

1：

異常終了しました。

入力例

JavaVMが異常終了してcoreファイルを生成した場合，次のメッセージが表示されます。このメッセージ内のjavatraceコマンドの文字列を実行します。

なお，このメッセージは，異常終了時に生成されるエラーリポートファイル（hs_err_pid<プロセスID>.log）にも出力されます。

  ：
# You can get further information from javatrace.log file generated
# by using javatrace command.
# usage: javatrace core-file-name loadmodule-name [out-file-name] [-l(library-name)...]
# Please use javatrace command as follows and submit a bug report
# to Hitachi with javatrace.log file:
# [/opt/Cosminexus/jdk/bin/javatrace core /opt/Cosminexus/CC/server/bin/cjstartsv]
#

coreファイル名がcoreの場合

/opt/Cosminexus/jdk/bin/javatrace core /opt/Cosminexus/CC/server/bin/cjstartsv

OSによっては実際に出力されるcoreファイル名がcore.<プロセスID>になる場合があります。その場合は，実際に出力されたcoreファイル名をjavatraceの引数に指定してください。

coreファイル名がcore.<プロセスID>の場合

/opt/Cosminexus/jdk/bin/javatrace core.8326 /opt/Cosminexus/CC/server/bin/cjstartsv

出力メッセージ

次のエラーメッセージまたは警告メッセージを出力した場合，スタックトレース情報は出力されません。

表10‒10　javatraceコマンドで出力されるエラーメッセージ

項番

エラーメッセージ

説明

1

usage : javatrace core-filename loadmodule-name [out-filename] [-llibrary-name...]

javatrace コマンドへの引数の指定が間違っています。

2

javatrace: Cannot open file-name :No such file or directory

<出力ファイル>で指定したファイル以外のファイル（file-name）が見つかりません。

3

javatrace: Cannot open file-name : Permission denied

ファイル（file-name）の読み込みが許可されていません。

4

javatrace : Cannot create file-name : Already exist

<出力ファイル>に指定したファイル（file-name）がすでに存在しています。

5

* unknown core type(XXXXXXX) ignored.

<coreファイル名>で指定したファイルは，coreファイルではありません。

6

* ERROR : file-name, unknown magic(0xXXXX)

<実行ファイル名>で指定したファイルは，実行ファイルではありません。

7

WARNING : core file may not match loadmodule (core file from ‘loadmodule-name')

<実行ファイル名>で指定した実行ファイルと，<coreファイル名>で指定したcoreファイルから取り出した実行ファイル（loadmodule-name）が一致していません。

8

javatrace : Bad argument : argument-name is directory

指定したファイル（file-name）はディレクトリです。

9

* ERROR : library-name open : No such file or directory

実行ファイルが取り込んだ共用ライブラリ（library-name）が見つかりません。共用ライブラリが相対パスで取り込まれている場合には，-lオプションで共用ライブラリを明示的に指定する必要があります。

10

javatrace : illegal option -- x

誤ったオプション文字（x）が指定されています。

11

javatrace : Cannot create file-name : Permission denied

<出力ファイル>で指定したファイル（file-name）の出力先に書き込み権限がありません。

注意事項

javatraceコマンドはcoreファイルが生成されたマシンで実行してください。

JavaVMが異常終了した場合に標準出力とエラーリポートファイルに出力されるメッセージで，javatraceコマンドの第2引数が，次のように絶対パスのロードモジュール名になっていないことがあります。

#
# You can get further information from javatrace.log file generated
# by using javatrace command.
# usage: javatrace core-file-name loadmodule-name [out-file-name] [-l(library-name)...]
# Please use javatrace command as follows and submit a bug report
# to Hitachi with javatrace.log file:
# [/opt/Cosminexus/jdk/bin/javatrace /users/Java/core ../java]
#

その場合は，javatraceコマンドの第2引数に指定するロードモジュール名を，絶対パスに変換してから実行してください。

jheapprof（クラス別統計情報付き拡張スレッドダンプの出力）

形式

jheapprof [-i|-f] [-class <クラス名>] [-staticroot|-nostaticroot]
          [-explicit|-noexplicit] [-fullgc|-copygc|-nogc]
          [-garbage|-nogarbage] [-rootobjectinfo|-norootobjectinfo]
          [-rootobjectinfost <値> ] [-force] -p <プロセスID>

機能

引数に指定したプロセスIDのjavaプロセスについて，クラス別統計情報を含んだ拡張スレッドダンプを出力します。

引数

-i

クラス別統計情報付き拡張スレッドダンプの出力処理の実行を確認するメッセージが表示されます。表示されたメッセージに対してyまたはnを入力します。このとき，yを入力すると，クラス別統計情報を含んだ拡張スレッドダンプが出力されます。nを入力すると，何も出力しないで処理を終了します。省略した場合，-fオプションが指定されないかぎり，このオプションは有効です。

-f

-iオプションを無効にします。省略した場合，-iオプションが有効になります。

-class <クラス名>

<クラス名>に指定したクラス（インスタンス）をメンバに持つクラスの構造を一覧にしてスレッドダンプ中に出力します。

-staticroot

staticフィールドを基点とした参照関係情報出力機能を有効にし，staticフィールドを基点とした参照関係情報を出力します。省略した場合，-nostaticrootオプションが指定されない限り，このオプションは有効です。

このオプションの前提は，-classオプションです。-classオプションの指定がない場合，このオプションは無効になります。

なお，このオプションとnostaticrootオプションを同時に指定している場合，最後に指定しているオプションが有効になります。

-nostaticroot

staticフィールドを基点とした参照関係情報出力機能を無効にします。省略した場合，-staticrootオプションが有効になります。

なお，このオプションと-staticrootオプションを同時に指定している場合，最後に指定しているオプションが有効になります。

-explicit

インスタンス統計機能の統計対象にExplicitヒープを含めます。省略した場合，-noexplicitオプションが指定されないかぎり，このオプションは有効です。なお，このオプションと-noexplicitオプションを同時に指定している場合，最後に指定しているオプションが有効になります。

-noexplicit

インスタンス統計機能の統計対象にExplicitヒープを含めません。省略した場合，-explicitオプションが有効になります。なお，このオプションと-explicitオプションを同時に指定している場合，最後に指定しているオプションが有効になります。

-fullgc

統計する前に実行するGCにFullGCを設定します。省略した場合，-copygcオプションや-nogcオプションが指定されないかぎり，このオプションは有効です。なお，このオプションと-copygcオプションまたは-nogcオプションを同時に指定している場合，最後に指定しているオプションが有効になります。

-copygc

統計する前に実行するGCにCopyGCを設定します。このオプションと-nogcオプションを省略した場合，-fullgcオプションが有効になります。

なお，このオプションと-fullgcオプションまたは-nogcオプションを同時に指定している場合，最後に指定しているオプションが有効になります。

-nogc

統計する前にGCを実行しません。このオプションと-copygcオプションを省略した場合，-fullgcオプションが有効になります。なお，このオプションと-fullgcオプションまたは-copygcオプションを同時に指定している場合，最後に指定しているオプションが有効になります。

-garbage

Tenured領域内不要オブジェクト統計機能が有効になり，Tenured領域内の不要なオブジェクトを統計対象としたクラス別統計情報を出力します。また，インスタンス統計機能とSTATICメンバ統計機能は無効になります。省略した場合，-nogarbageオプションが有効になります。統計前GC選択機能については，-fullgcオプション，-copygcオプションが無効になり，-nogcオプションは有効になります。このため，統計処理前にGCを実行しません。なお，このオプションと-nogarbage オプションを同時に指定している場合，最後に指定しているオプションが有効になります。

-nogarbage

Tenured領域内不要オブジェクト統計機能が無効になります。そのため，Tenured領域内の不要なオブジェクトを統計対象としたクラス別統計情報は出力しません。省略した場合，-garbageオプションが指定されないかぎり，このオプションは有効です。なお，このオプションと-garbageオプションを同時に指定している場合，最後に指定しているオプションが有効になります。

-rootobjectinfo

Tenured増加要因の基点オブジェクトリスト出力機能が有効になり，Tenured増加要因の基点オブジェクトリストを出力します。

このオプションは，-garbageオプションが有効であることが前提です。そのため，-nogarbageオプションを有効にすると，このオプションは無効になります。省略した場合，-norootobjectinfoオプションが指定されないかぎり，このオプションは有効です。なお，このオプションと-norootobjectinfoオプションを同時に指定している場合，最後に指定しているオプションが有効になります。

-norootobjectinfo

Tenured増加要因の基点オブジェクトリスト出力機能が無効になります。そのため，Tenured増加要因の基点オブジェクトリストは出力しません。省略した場合，-rootobjectinfoオプションが有効になります。なお，このオプションと-rootobjectinfoオプションを同時に指定している場合，最後に指定しているオプションが有効になります。

-rootobjectinfost <値>

Tenured増加要因の基点オブジェクトリストの情報量を調節します。インスタンスサイズの合計が，指定した<値>以上のクラス情報だけが，Tenured増加要因の基点オブジェクトリストに出力されます。省略した場合，0が設定されます。

このオプションは，-rootobjectinfoオプションが有効であることが前提です。そのため，-norootobjectinfoオプションを有効にすると，このオプションは無効になります。<値>には0以上の自然数を指定できます。自然数以外や，文字列を指定した場合は，引数の指定に誤りがあるという内容のエラーメッセージが出力されて終了します。

-force

javaプロセスが作成する/tmp/hsperfdata_<ユーザ名>/<プロセスID>ファイルの有無の確認をしないで，-pオプションで指定したプロセスIDのjavaプロセスに対して拡張スレッドダンプの出力を要求します。

なお，このオプションはUNIX用のオプションです。

-p <プロセスID>

<プロセスID>には，クラス別統計情報を出力するjavaプログラムのプロセスIDを指定します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

一定時間内にクラス別統計情報出力処理終了の応答がありませんでした。

入力例

-fオプションを省略してjheapprofコマンドを実行します。

% jheapprof -p 2463

Windowsの場合，クラス別統計情報付き拡張スレッドダンプを出力するかどうかの確認メッセージが表示されます。UNIXの場合，プロセスIDの確認メッセージが表示されます。

Windowsの場合

Force VM to output HitachiJavaHeapProfile: ? (y/n)

UNIXの場合

send SIGQUIT to 2463: ? (y/n)

Windowsの場合，クラス別統計情報付き拡張スレッドダンプを出力する場合はyを，出力しない場合はnを入力します。UNIXの場合，SIGQUITシグナルを送信させる場合はyを，送信させない場合はnを入力します。

Windowsの場合

Force VM to output HitachiJavaHeapProfile: ? (y/n)y

UNIXの場合

send SIGQUIT to 2463: ? (y/n)y

クラス別統計情報付き拡張スレッドダンプを出力すると，実行中のjavaプログラムでは次のメッセージが出力されます。

Writing Java core to javacore2463.030806215140.txt... OK

実行中のjavaプログラムは，カレントディレクトリにクラス別統計情報付き拡張スレッドダンプ（javacore<プロセスID>.<日時>.txt）を作成し，プログラムを継続します。

出力形式

クラス別統計情報の出力形式については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「9.10　クラス別統計情報解析機能」を参照してください。

出力メッセージ

次のエラーメッセージまたは警告メッセージが出力された場合，クラス別統計情報付き拡張スレッドダンプは出力されません。

表10‒11　jheapprofコマンドで出力されるメッセージ（Windowsの場合）

項番

エラーメッセージ

説明

1

usage: jheapprof [-f|-i] [-class classname] [-staticroot|-nostaticroot] [-explicit|-noexplicit] [-fullgc|-copygc|-nogc] [-garbage|-nogarbage] [-rootobjectinfo|-norootobjectinfo] [-rootobjectinfost size] -p process-id

jheapprofコマンドへの引数の指定が間違っています。

2

jheapprof: illegal option -- <オプション>

jheapprofコマンドに指定した<オプション>が不正です。

3

<プロセスID>: Now processing previous request, this request canceled

jheapprofコマンドの引数に指定した<プロセスID>に該当するプロセスが，クラス別統計情報の出力中です。

4

<プロセスID>: Not owner

jheapprofコマンドの引数に指定した<プロセスID>に0が指定されています。

5

jheapprof: can't create work file at temporary directory , this request canceled

一時ファイル用ディレクトリに参照・書き込み権限がない場合，クラス別統計情報付き拡張スレッドダンプを出力できません。クラス別統計情報付き拡張スレッドダンプの出力要求はキャンセルされます。

6

jheapprof: can't get temporary directory, this request canceled

一時ファイル用ディレクトリが取り出せない場合，クラス別統計情報付き拡張スレッドダンプを出力できません。クラス別統計情報付き拡張スレッドダンプの出力要求はキャンセルされます。

7

jheapprof: please delete <削除できなかったファイル名> in <削除できなかったファイルのフルパス>

jheapprofコマンドを終了したときに，内部ファイルを削除できませんでした。削除できなかったファイルのフルパスにある，削除できなかったファイルを削除してください。

8

jheapprof: unexpected error occurred: <エラー原因>

jheapprofコマンド実行中に予期しないエラーが発生しました。

<エラー原因>には，例えば下記のような表示がされます。

作業用メモリ確保に失敗した場合

malloc systemcall fail (errno=Y)

オブジェクトのクローズに失敗した場合

close systemcall fail (errno=Y)

9

jheapprof: can't communicate with process <プロセスID>

jheapprofコマンドの引数に指定した<プロセスID>に該当するプロセスに問題があり，通信処理でエラーが発生しているため通信できません。または，jheapprofコマンドの引数に指定した<プロセスID>に該当するプロセスがありません。

10

<プロセスID>: Timeout occurred. Java process not responding

jheapprofコマンドの引数に指定した<プロセスID>に該当するプロセスから，一定時間内にクラス別統計出力処理終了の応答がありませんでした。

表10‒12　jheapprofコマンドで出力されるメッセージ（UNIXの場合）

項番

エラーメッセージ

説明

1

usage: jheapprof [-f|-i] [-class classname] [-staticroot|-nostaticroot] [-explicit|-noexplicit] [-fullgc|-copygc|-nogc] [-garbage|-nogarbage] [-rootobjectinfo|-norootobjectinfo] [-rootobjectinfost size] [-force] -p process-id

jheapprofコマンドへの引数の指定が間違っています。

2

jheapprof: illegal option -- <オプション>

jheapprofコマンドに指定した<オプション>が不正です。

3

<プロセスID>: Now processing previous request, this request canceled

jheapprofコマンドの引数に指定した<プロセスID>に該当するプロセスが現在クラス別統計情報の出力中です。

4

<プロセスID>: No such process

jheapprofコマンドの引数に指定した<プロセスID>に該当するプロセスがありません。または，jheapprofコマンドで指定した<プロセスID>に該当するプロセスがjavaプロセス以外でした。

5

<プロセスID>: Not owner

jheapprofコマンドの引数に指定した<プロセスID>のプロセスのオーナーではありません。

6

jheapprof: can't create work file at /tmp , this request canceled

一時ファイル用ディレクトリに参照・書き込み権限がない場合，クラス別統計情報付き拡張スレッドダンプを出力できません。クラス別統計情報付き拡張スレッドダンプの出力要求はキャンセルされます。

7

jheapprof: please delete <削除できなかったファイル名> in <削除できなかったファイルのフルパス>

jheapprofコマンドを終了したときに，内部ファイルを削除できませんでした。削除できなかったファイルのフルパスにある，削除できなかったファイルを削除してください。

8

jheapprof: unexpected error occurred: <エラー原因>

jheapprofコマンド実行中に予期しないエラーが発生しました。

<エラー原因>には，例えば下記のような表示がされます。

作業用メモリ確保に失敗した場合

malloc systemcall fail (errno=Y)

オブジェクトのクローズに失敗した場合

close systemcall fail (errno=Y)

9

<プロセスID>: Timeout occurred. Java process not responding

jheapprofコマンドの引数に指定した<プロセスID>に該当するプロセスから，一定時間内にクラス別統計情報出力処理終了の応答がありませんでした。

注意事項

jheapprofコマンドはプログラムの開発用ユーティリティとして提供されているものです。システムの運用では使用しないでください。

同じjavaプロセスに対して，同時にjheapprofコマンドは実行できません。前回のjheapprofコマンドによるクラス別統計情報が拡張スレッドダンプに出力されたあとに実行してください。

Windowsの場合，Javaプロセスは起動時にMailSlotを使った通信の初期化処理を実行します。初期化に失敗した場合，メッセージを出力して処理を中断します。

Windowsの場合，引数に指定したプロセスIDのjavaプロセス所有者以外でもjheapprofコマンドを実行できます。

UNIXの場合，引数に指定したプロセスIDのjavaプロセスオーナーでないユーザがこのコマンドを実行すると，メッセージが出力されて，処理は終了します。ただし，ユーザがrootである場合は，処理を継続します。

UNIXの場合，jheapprofコマンドは，SIGQUITシグナルを指定されたプロセスに送信します。誤ってjavaプログラム以外を指定すると，ほかのプログラムが停止することがあります。

UNIXの場合，jheapprofコマンド実行時に，/tmp/hsperfdata_<ユーザ名>/<プロセスID>ファイルを使用します。該当するファイルが存在しない場合，jheapprofコマンドによるクラス別統計情報出力はできません。

Explicitヒープをインスタンス統計情報の統計対象に含めるためには，-XX:+HitachiUseExplicitMemoryを指定して，明示管理ヒープ機能を有効にしているjavaプロセスに対して，jheapprofコマンドで-explicitオプションを指定してください。なお，-XX:-HitachiUseExplicitMemoryを指定して，明示管理ヒープ機能を無効にしている場合，-explicitを指定してもExplicitヒープ内のインスタンスはインスタンス統計情報の統計対象になりません。

G1GCを使用中にjheapprofコマンドを使用した場合，次のエラーメッセージを出力してスレッドダンプを出力しません。

jheapprof: can't use jheapprof and g1gc at the same time.

クラス別統計情報を取得するため，jheapprofコマンド実行中のjavaプロセスは，他の処理をすべて停止して処理を実行します。

jheapprofanalyzer（クラス別統計情報解析ファイルのCSV出力）

形式

jheapprofanalyzer [-J <オプション名>] [<ファイル名>]

機能

クラス別統計情報解析ファイルをCSV形式で出力します。

クラス別統計情報解析ファイルで使用する入力ファイルについては，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「9.10　クラス別統計情報解析機能」を参照してください。

引数

-J <オプション名>

<オプション名>には，次のオプションを指定できます。また，次のオプション以外を指定した場合は，動作保証の対象外となります。

-Xms

メモリ割り当てプールの初期サイズをバイト数で指定します。

-Xmx

メモリ割り当てプールの最大サイズをバイト数で指定します。

-DJP.co.Hitachi.soft.jvm.tools.jheapprofanalyzer.threshold=num

num: インスタンス合計サイズのしきい値を設定します。範囲は0〜2⁶³-1 （Long.MAX_VALUE）です。インスタンス合計サイズがnum以上のクラスだけ出力します。デフォルト値は，1024です。

<ファイル名>

クラス別統計情報付き拡張スレッドダンプファイルを指定できます。ファイル名称の規定は，特にありません。また，ファイルの指定は，順不同であり，数に制限はありません。

戻り値

0：

正常終了しました。

1以上：

異常終了しました。

入力例

jheapprofanalyzer -J-Xms1024m -J-Xmx1024m -J-DJP.co.Hitachi.soft.jvm.tools.jheapprofanayzer.threshold=5000
javacore22356.080523161703.txt  javacore22356.080523161711.txt

出力形式

クラス別統計情報解析ファイルの出力形式については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「9.10　クラス別統計情報解析機能」を参照してください。

出力メッセージ

次のエラーメッセージが出力された場合，クラス別統計情報解析ファイルは出力されません。また，次のエラーメッセージ以外が出力された場合は，デフォルトの例外処理となります。

表10‒13　jheapprofanalyzerコマンドで出力されるエラーメッセージ

項番

エラーメッセージ

説明

出力後の動作

1

usage: jheapprofanalyzer [options] file...

where options include:

-J-Xms<size> set initial Java heap size

-J-Xmx<size> set maximum Java heap size

-J-DJP.co.Hitachi.soft.jvm.tools.jheapprofanalyzer.threshold=<num> set instance total size threshold

JheapprofAnalyzerクラスへの引数の指定が間違っています。

(a)

2

JheapprofAnalyzer: Illegal property value<num>. Default is assumed.

JP.co.Hitachi.soft.jvm.tools.jheapprofanalyzer.thresholdの<num>に数字以外を指定しました。または<num>が範囲外となっています。

(b)

3

JheapprofAnalyzer: can't open input file<ファイル名>

ディレクトリに<ファイル名>がありません。または，別の原因でファイルを開けません。

(c)

4

JheapprofAnalyzer: can't read input file<ファイル名>

<ファイル名>の読み込みに失敗しました。

(c)

5

JheapprofAnalyzer: Illegal input file format<ファイル名>

<ファイル名>は，クラス別統計情報付き拡張スレッドダンプファイルではありません。

(c)

6

JheapprofAnalyzer: can't open output file<ファイル名>

出力ファイルが開けません。

エラーの原因として，次の状態が考えられます。

出力ファイルがディレクトリとなっています。

出力ファイルがありません。

別の原因で出力ファイルを開けません。

(a)

7

JheapprofAnalyzer: can't write output file<ファイル名>

<ファイル名>の書き込みに失敗しました。

(a)

（凡例）

(a)：エラーとなり処理を終了します。

(b)：デフォルトを仮定して処理を続行します。

(c)：処理を続行し，指定したすべての入力ファイルのエラーチェックをします。

注意事項

クラス別統計情報解析機能では，日付を取得するときと，データを読み込むときにファイルを開きます。そのため，コマンド実行中に入力ファイルの更新および削除の操作をした場合の結果は保証されません。

11　ログの運用で使用するコマンド

この章では，ログの運用で使用するコマンドの入力形式，機能などについて説明します。

11.1　ログの運用で使用するコマンドの一覧

ログの運用で使用するコマンドの一覧を，次の表に示します。

表11‒1　ログの運用で使用するコマンドの一覧

コマンド名称

分類

概要

snapshotlog

snapshotログの収集

アプリケーションサーバシステムの構成ソフトウェアが出力したログを収集します。

11.2　ログの運用で使用するコマンドの詳細

ログの運用で使用する各コマンドの入力形式，機能などを次に示します。

コマンドの格納先

ログの運用で使用するコマンドは，次のディレクトリに格納されています。

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥bin¥

UNIXの場合

/opt/Cosminexus/manager/bin/

snapshotlog（snapshotログの収集）

形式

snapshotlog <出力ファイル名> [<snapshotログ収集対象定義ファイル名>]

機能

snapshotログを収集します。snapshotログは，業務システムにトラブルが発生した場合に，調査用資料として利用できます。このコマンドは，Management Serverを利用しないで運用している場合も実行できます。また，定義送付資料の収集に使用します。

snapshotログ情報については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「2.3.3　snapshotログの収集」を参照してください。

引数

<出力ファイル名>

収集したsnapshotログを出力するZIPファイルを指定します。

ファイル名だけを指定した場合は，カレントディレクトリ下に指定したファイル名でZIPファイルが作成されます。

フルパスで指定した場合は，指定したディレクトリ下に指定した名前でZIPファイルが作成されます。

拡張子に「.zip」以外を指定した場合も，ZIP形式で出力されます。

<snapshotログ収集対象定義ファイル名>

snapshotログ収集対象定義ファイルをフルパスで指定します。省略した場合，次のファイルに定義されたファイルが収集対象になります。空白を含む場合は，""（ダブルクォーテーション）で囲みます。

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥config¥snapshotlog.conf

UNIXの場合

/opt/Cosminexus/manager/config/snapshotlog.conf

なお，snapshotログ収集対象定義ファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「10.2.1　snapshotログ収集対象定義ファイル」を参照してください。

入力例

カレントディレクトリに出力する場合

snapshotlog snapshot.zip

指定したディレクトリに出力する場合

Windowsの場合

  snapshotlog c:¥tmp¥snapshot.zip

UNIXの場合

  snapshotlog /tmp/snapshot.zip

snapshotログ収集対象定義ファイル名を指定した場合

Windowsの場合

  snapshotlog snapshot.zip c:¥temp¥snapshotlog.conf

UNIXの場合

  snapshotlog snapshot.zip /temp/snapshotlog.conf

定義資料を指定したディレクトリに出力する場合

Windowsの場合

  snapshotlog c:¥tmp¥snapshot.zip <Application Serverのインストールディレクトリ>¥manager¥config¥snapshotlog.param.conf

UNIXの場合

  snapshotlog /tmp/snapshot.zip /opt/Cosminexus/manager/config/snapshotlog.param.conf

戻り値

0：

正常終了しました。

1：

実行時エラーが発生しました。

2：

シンタックスエラーが発生しました。

12　監査ログの設定で使用するコマンド

この章では，監査ログの設定で使用するコマンドの入力形式，機能などについて説明します。

12.1　監査ログの設定で使用するコマンドの一覧

監査ログの設定で使用するコマンドの一覧を次の表に示します。

表12‒1　監査ログの設定で使用するコマンドの一覧

コマンド名称

分類

概要

auditsetup

監査ログの設定

監査ログ定義ファイルに指定されたプロパティに従って空の監査ログファイルを出力し，所有者およびアクセス権限を設定します。

12.2　監査ログの設定で使用するコマンドの詳細

監査ログの設定で使用するコマンドの入力形式，機能などを次に示します。

コマンドの格納先

監査ログの設定で使用するコマンドは，次のディレクトリに格納されています。

Windowsの場合

<Application Serverのインストールディレクトリ>¥common¥bin¥

UNIXの場合

/opt/Cosminexus/common/bin/

auditsetup（監査ログの設定）

形式

auditsetup

機能

監査ログ定義ファイルに指定されたプロパティに従って空の監査ログファイルを出力し，所有者およびアクセス権限を設定します。

監査ログ定義ファイルは環境変数COSMINEXUS_AUDITLOG_CONFで指定されているファイルを使用します。環境変数COSMINEXUS_AUDITLOG_CONFが設定されていない場合は，デフォルトの設定ファイルを使用します。デフォルトの設定ファイルは次のとおりです。

Windowsの場合

<Application Serverのインストールディレクトリ>¥common¥conf¥auditlog.properties

UNIXの場合

/opt/Cosminexus/common/conf/auditlog.properties

監査ログ定義ファイルの指定値と設定内容は，Windowsの場合とUNIXの場合で異なります。監査ログ定義ファイルの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「11.2.1　監査ログ定義ファイル」を参照してください。

引数

なし

戻り値

0：

正常終了しました。

0以外：

異常終了しました。

注意事項

このコマンドを実行したあと，監査ログファイルを削除（移動も含む）しないでください。削除（または移動）した場合，監査ログを出力したプロセスのユーザおよびプライマリグループが監査ログの所有者となります。

このコマンドを再度実行する場合，すべての監査ログファイル，管理ファイル，メッセージログファイルおよび例外ログファイルを削除してから，またはこれらのファイルの出力ディレクトリを変更してから実行してください。これらのファイルが残っている場合，実行に失敗します。

メッセージログファイルの出力ディレクトリが存在しない場合，デフォルトの出力ディレクトリが使用されます。

監査ログ定義ファイルを読み込めない場合や監査ログ出力ディレクトリが存在しない場合，実行に失敗します。

13　Javaアプリケーションで使用するコマンド

この章では，Javaアプリケーションで使用するコマンドの入力形式，機能などについて説明します。

13.1　Javaアプリケーションで使用するコマンドの一覧

Javaアプリケーションで使用するコマンドの一覧を次の表に示します。

表13‒1　Javaアプリケーションで使用するコマンドの一覧

コマンド名称

分類

概要

cjcldumpap

Javaアプリケーションのスレッドダンプの取得

cjclstartapコマンドで開始したJavaアプリケーションで障害が発生した場合に，JavaVMのスレッドダンプを取得します。

cjclstartap

Javaアプリケーションの開始

Javaアプリケーションを開始します。

13.2　Javaアプリケーションで使用するコマンドの詳細

Javaアプリケーションで使用する各コマンドの入力形式，機能などを次に示します。

コマンドの格納先

Javaアプリケーションで使用するコマンドは，次のディレクトリに格納されています。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥client¥bin¥※

UNIXの場合

/opt/Cosminexus/CC/client/bin/

注※

Clientを使用している場合は，格納ディレクトリの「<Application Serverのインストールディレクトリ>¥CC¥」を，「<Application Serverのインストールディレクトリ>¥CCL¥」と読み替えてください。

cjcldumpap（Javaアプリケーションのスレッドダンプの取得）

形式

cjcldumpap [<プロセスID>]

機能

cjclstartapコマンドで開始したJavaアプリケーションのスレッドダンプを，cjclstartapコマンドを実行しているカレントディレクトリに出力します。また，指定したcjclstartapプロセスのスレッドダンプを出力することもできます。

プロセスを指定しない場合，スレッドダンプを出力したいcjclstartapコマンドを実行しているカレントディレクトリで，このコマンドを実行してください。

引数

<プロセスID>

特定のプロセスのスレッドダンプを出力する場合，cjclstartapコマンドのプロセスIDを指定します。引数を指定しない場合，cjcldumpapコマンドを実行したカレントディレクトリから起動したcjclstartapプロセスに対するスレッドダンプを出力します。存在しないプロセスIDを指定した場合，エラーメッセージが出力されて，異常終了します。

プロセスID以外を指定した場合，コマンドの使用方法を表示します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

cjcldumpapコマンドは，cjclstartapコマンドを実行したユーザ，またはスーパーユーザが実行できます。

usrconf.cfgのejb.client.directory.shareableに「false」を指定していないでcjclstartapコマンドを実行した場合，引数に<プロセスID>を指定しないでcjcldumpapコマンドを実行すると，エラーメッセージが出力されてスレッドダンプが出力されないことがあります。

JavaアプリケーションをManagerから起動している場合，またはWindowsのサービスとして起動している場合，スレッドダンプの取得に失敗するときがあります。

cjclstartap（Javaアプリケーションの開始）

形式

cjclstartap [[<Javaオプション>]...] <Javaアプリケーションクラス名>
            [[<mainメソッドに渡される引数>] ...]

機能

Javaアプリケーションを開始します。

引数

引数の指定がない場合，コマンドの使用方法を表示します。

<Javaオプション>

JavaVMの起動オプションを指定します。

<Javaオプション>とオプション定義ファイル（usrconf.cfg）で同じオプションを指定した場合，<Javaオプション>に指定した内容が有効になります。

指定できるオプションを次に示します。

-cp

-classpath

-D<name>=<value>

-verbose[:class|gc|jni]

-ea[:<packagename>...|:<classname>]

-enableassertions[:<packagename>...|:<classname>]

-da[:<packagename>...|:<classname>]

-disableassertions[:<packagename>...|:<classname>]

-esa | -enablesystemassertions

-dsa | -disablesystemassertions

-agentlib:<libname>[=<options>]

-agentpath:<pathname>[=<options>]

-javaagent:<jarpath>[=<options>]

-Xmixed

-Xint

-Xbootclasspath:<directories and zip/jar files separated by ;>

-Xbootclasspath/a:<directories and zip/jar files separated by ;>

-Xbootclasspath/p:<directories and zip/jar files separated by ;>

-Xnoclassgc

-Xloggc:<file>

-Xbatch

-Xms<size>

-Xmx<size>

-Xmn<size>

-Xss<size>

-Xprof

-Xrunhprof[:help]|[:<option>=<value>, ...]

-Xdebug

-Xrs

-Xcheck:jni

-XX:MetaspaceSize=<size>

-XX:MaxMetaspaceSize=<size>

-XX:SurvivorRatio=<value>

-XX:TargetSurvivorRatio=<value>

-XX:MaxTenuringThreshold=<value>

なお，次のオプションは指定できません。

-jar jarfile（-cp jarfile <Javaアプリケーションクラス名>で代替）

-client（usrconf.cfgファイルにjvm.type=clientを指定することで代替）

-server（usrconf.cfgファイルにjvm.type=serverを指定することで代替）

-hotspot

-version

-showversion

-? -help

-X

-XX

-Xfuture

<Javaアプリケーションクラス名>

ユーザ作成のJavaアプリケーションクラス名を指定します。

<mainメソッドに渡される引数>

Javaアプリケーションのmainメソッドに渡す引数を指定します。

戻り値

次の戻り値以外は，Javaアプリケーションの終了コードが返却されます。ただし，UNIXではSIGHUP, SIGINT, SIGTERMが発生した場合，シグナル番号に+128した値が返却されます。

1：

Javaアプリケーション開始コマンドでエラーが発生しました。

143：

コマンド実行中に次の操作をしました（Windowsの場合）。

コマンドを起動しているコマンドプロンプトのウィンドウを「×」ボタンを押下して閉じた。

Windowsシステムをシャットダウンした。

Windowsシステムをログオフした。

注意事項

オプション定義ファイル（usrconf.cfg），およびユーザプロパティファイル（usrconf.properties）が格納されているディレクトリパスを指定する場合，ユーザ定義ファイル格納先環境変数（CJCLUSRCONFDIR）を指定する必要があります。Javaアプリケーションの環境変数の設定については，マニュアル「アプリケーションサーバ機能解説 基本・開発編(EJBコンテナ)」の「3.3.2　cjclstartapコマンドの場合」を参照してください。

ユーザ定義ファイル格納先環境変数が設定されていない場合，カレントディレクトリが参照されます。環境変数で設定したディレクトリにオプション定義ファイル（usrconf.cfg），またはユーザプロパティファイル（usrconf.properties）が存在しない場合は，エラーメッセージが出力され，異常終了します。

このコマンドは，Javaアプリケーションのメインクラスのmainメソッドを実行します。mainメソッドは，public static void main(String[])と宣言する必要があります。

CLASSPATH環境変数に指定したクラスパスは無視されます。

このコマンドを実行するには，カレントディレクトリ，およびログ出力先ディレクトリに，書き込み権限が必要です。

UNIXの場合，ログの出力先を複数のユーザで使用するには，umaskを「0」に設定しておく必要があります。

ejb.client.directory.shareableオプションに「false」を指定した場合，同じカレントディレクトリ，または同じログ出力先ディレクトリを使用する複数のプロセスを同時に起動しようとすると，エラーメッセージが出力されて，異常終了します。

ejb.client.directory.shareableオプションに「false」を指定した場合，カレントディレクトリにプロセスIDを格納するファイル（.cjclstartap.pid）とロックファイル（.cjclstartap.lock）が作成されます。また，UNIXの場合，パイプファイル（.COSMINEXUS_CC_EJBCLIENT_<プロセスID>）が作成されます。これらのファイルを編集または削除した場合，ログファイル，およびスレッドダンプが正しく出力されないことがあります。

JavaVMイベントログの「hs_err<pid>.log」，およびcoreダンプはカレントディレクトリに出力されます。

Windowsの場合，UNC名を含むパスをカレントディレクトリにすると，ログが出力されないことがあります。

UNIXの場合，nfsマウントされたディスクをカレントディレクトリにすると，ログが出力されないことがあります。

usrconf.cfgのejb.client.directory.shareableオプションに「false」を指定しないで，同じログ出力先を指定した複数のcjclstartapコマンドから同時にJavaログが出力された場合，Javaログが正しく出力されないことがあります。その場合，ejb.client.log.directoryに指定するディレクトリパスは別にしてください。

-cpオプション，および-classpathオプションの指定がない場合，デフォルトのクラスパスとしてカレントディレクトリを使用しません。

-cpオプション，および-classpathオプションを複数指定した場合，すべての指定が有効になります。

アカウントのログオフ時にこのコマンドを実行した場合，起動に失敗することがあります。

このコマンドは，スレッドダンプを出力するため，Ctrl+Breakの信号を自身に送信します。この場合，cjclstartapコマンドとコンソールを共有するCtrl+Breakを無視していないアプリケーションは終了されます。

Windowsの場合，このコマンドはユーザに書き込み権限があるディレクトリで実行してください。一般ユーザ権限で，%ProgramFiles%およびそのサブディレクトリで実行した場合，カレントディレクトリがリダイレクトされるため次のように動作します。

ログファイル，ロックファイル，pidファイルがリダイレクトされます。

複数のユーザが実行した場合，ユーザごとにプロセスが同時に動作します。

このコマンドを実行したユーザと異なるユーザは，cjcldumpapコマンドを実行できません。

このコマンドでは，環境変数やクラスパスに製品が提供するライブラリのディレクトリパスを設定しています。Javaアプリケーションからクラスパスの情報を取得する場合は，製品が提供するライブラリのディレクトリパスの情報は無視してください。

このコマンドは，セキュリティマネージャを期待するようなJavaアプリケーションの実行をサポートしていません。

-DオプションでJavaアプリケーションのカスタマイズ用のキーは指定できません。カスタマイズ用のキーについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「12.2.2　usrconf.properties（Javaアプリケーション用ユーザプロパティファイル）」を参照してください。

14　Webアプリケーションで使用するコマンド

この章では，Webアプリケーションで使用するコマンドの入力形式，機能などについて説明します。

14.1　Webアプリケーションで使用するコマンドの一覧

Webアプリケーションで使用するコマンドの一覧を次の表に示します。

表14‒1　Webアプリケーションで使用するコマンドの一覧

コマンド名称

分類

概要

cjjspc

JSPの事前コンパイル

JSPファイルからJavaソースファイルを生成およびコンパイルし，クラスファイルを生成します。

14.2　Webアプリケーションで使用するコマンドの詳細

Webアプリケーションで使用するコマンドの入力形式，機能などを次に示します。

コマンドの格納先

Webアプリケーションで使用するコマンドは，次のディレクトリに格納されています。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥web¥bin¥

UNIXの場合

/opt/Cosminexus/CC/web/bin/

cjjspc（JSPの事前コンパイル）

形式

Windowsの場合

cjjspc [-jspworkdir <JSPワークディレクトリ名>]
       [-classpath <クラスパス1>[;<クラスパス2>…]]
       [-excludefile <JSPファイルパス1>[;<JSPファイルパス2>…]|
       -excludelist <コンパイル対象外リストファイルパス>]
       [-keepgenerated]
       [-source {1.6|6|1.7|7|1.8|8|9|11}]
       [-pageencoding <文字エンコーディング>]
       [-resultlist <実行結果リストファイルパス>]
       [-customactiondeclarevariable]
       [-customactionignorecaseattributename]
       [-usebeannocheckclass]
       [-usebeannocheckduplicateid]
       [-tagnocheckrtexprvalue]
       [-tagrtexprvalueterminate]
       [-taglibnocheckprefix]
       [-debugging]
       [-jsppagedisablebom]
       [-nojavaeetaglib]
       [-lowerversion {2.4|2.5}]
       [-addimport <クラス名1>[,<クラス名2>…]]
       -root <Webアプリケーションのルートディレクトリ>
       [<JSPファイルパス>...]

UNIXの場合

cjjspc [-jspworkdir <JSPワークディレクトリ名>]
       [-classpath <クラスパス1>[:<クラスパス2>…]]
       [-excludefile <JSPファイルパス1>[:<JSPファイルパス2>…]|
       -excludelist <コンパイル対象外リストファイルパス>]
       [-keepgenerated]
       [-source {1.6|6|1.7|7|1.8|8|9|11}]
       [-pageencoding <文字エンコーディング>]
       [-resultlist <実行結果リストファイルパス>]
       [-customactiondeclarevariable]
       [-customactionignorecaseattributename]
       [-usebeannocheckclass]
       [-usebeannocheckduplicateid]
       [-tagnocheckrtexprvalue]
       [-tagrtexprvalueterminate]
       [-taglibnocheckprefix]
       [-debugging]
       [-jsppagedisablebom]
       [-nojavaeetaglib]
       [-lowerversion {2.4|2.5}]
       [-addimport <クラス名1>[,<クラス名2>…]]
       -root <Webアプリケーションのルートディレクトリ>
       [<JSPファイルパス>...]

機能

JSPファイルからJavaソースファイルを生成およびコンパイルし，クラスファイルを生成します。このコマンドを実行したときのログは，標準出力または標準エラー出力します。Webアプリケーションに含まれるすべてのJSPファイルをコンパイルできます。

-excludelistオプションまたは-excludefileオプションを指定することで，コンパイルする必要のないJSPファイルをコンパイル対象外ファイルとして指定できます。コンパイル対象外ファイルには，次の「コンパイルが不要なファイル」または「再度コンパイルする必要がないファイル」のどちらかの条件に当てはまるファイルを指定してください。

次のどれかに該当するファイルでコンパイルが不要なファイル

拡張子が「.jsp」または「.jspx」のファイル

Deployment Descriptor（/WEB-INF/web.xml）の<jsp-file>に指定されたファイル

Deployment Descriptor（/WEB-INF/web.xml）の<jsp-property-group><url-pattern>タグに合致するファイル

cjjspcコマンドの引数に指定したファイル

コンパイル済みであり，再度コンパイルする必要がないファイル

なお，-excludelistオプションと-excludefileオプションの併用はできません。併用した場合はエラーメッセージが表示され，処理が終了します。

また，-resultlistオプションと-excludelistオプションに同じファイルを指定することで，一度コンパイルに成功したJSPファイルをコンパイル対象外ファイルに指定できます。また，コンパイルに失敗したJSPファイルがコンパイル不要な場合は，実行結果リストファイルに出力されたコンパイルに失敗したJSPファイルパスの行頭の「#」を削除することで，コンパイル対象外に指定できます。

引数

-jspworkdir <JSPワークディレクトリ名>

JSPワークディレクトリ（<Webアプリケーションのルートディレクトリ>/WEB-INF/cosminexus_jsp_work）のディレクトリ名を変更する場合に指定します。JSPワークディレクトリ名に使用できる文字列は，A〜Z，a〜z，0〜9の半角英数字と「_（半角アンダースコア）」だけです。また，次のディレクトリ名は，大文字・小文字の区別なく，JSPワークディレクトリ名として使用できません。

lib

tags

classes

-classpath <クラスパス>

JSPのコンパイルに必要となるクラスのクラスパスを絶対パスで指定します。デフォルトで指定されているクラスパスは，次のとおりです。

<Webアプリケーションのルートディレクトリ>/WEB-INF/classes

<Webアプリケーションのルートディレクトリ>/WEB-INF/libに含まれるjarファイル

Servlet 2.5 APIなどを含んだアプリケーションサーバのシステムが使用するクラスライブラリ

複数のクラスパスを指定する場合，Windowsでは「;（半角セミコロン）」，UNIXでは「:（半角コロン）」で区切って指定します。なお，アプリケーションサーバのシステムが使用するクラスライブラリ内のクラスファイルと-classpathオプションに指定されたクラスパスに含まれるjarファイル内のクラスファイルが重複している場合は，アプリケーションサーバのシステムが使用するクラスライブラリ内のクラスファイルが優先して使用されます。

-excludefile <JSPファイルパス>

コンパイル対象外とするJSPファイルを指定します。

複数のJSPファイルパスを指定する場合，Windowsでは「;（半角セミコロン）」，UNIXでは「:（半角コロン）」で区切って指定します。JSPファイルは，Webアプリケーションのルートディレクトリからの相対パスを指定します。ファイルパスにワイルドカード文字「*(アスタリスク)」や空白文字列を含める場合は，ファイルパスを必ず「"（ダブルクォーテーション）」で囲みます。

ファイルパスに区切り文字（Windowsの場合「;（半角セミコロン）」，UNIXの場合「:（半角コロン）」）を含めることはできません。ファイルパスに区切り文字を含める必要がある場合は，コンパイル対象外リストファイルを使用してください。コンパイル対象外リストは-excludelistオプションで指定します。

指定方法を次に示します。

指定方法（Windowsの場合）

cjjspc -excludefile <JSPファイルパス1>;<JSPファイルパス2>;… -root <Webアプリケーションのルートディレクトリ>

指定方法（UNIXの場合）

cjjspc -excludefile <JSPファイルパス1>:<JSPファイルパス2>:… -root <Webアプリケーションのルートディレクトリ>

-excludelist <コンパイル対象外リストファイルパス>

コンパイル対象外とするJSPファイルを記述したコンパイル対象外リストファイルを指定します。コンパイル対象外リストファイルとは，コマンドによるJSP事前コンパイルを実行する際，コンパイルの対象外とするJSPファイルパスを記述するためのテキストファイルです。

ファイルは相対パスまたは絶対パスで指定します。

指定方法とファイル形式を次に示します。

コンパイル対象外リストファイルの指定方法

cjjspc -excludelist <コンパイル対象外リストファイルのパス> -root <Webアプリケーションのルートディレクトリ>

コンパイル対象外リストファイルのファイル形式

# コメント
＜コンパイルの対象外とするJSPファイルパス１＞
＜コンパイルの対象外とするJSPファイルパス２＞
…

-keepgenerated

JSPをコンパイルする際，JSPトランスレーション時に生成されたJavaソースファイルを残す場合に指定します。作成されたJavaソースファイルは，コンパイルされたクラスファイルと同じディレクトリに作成されます。

指定方法を次に示します。

指定方法

cjjspc -keepgenerated -root <Webアプリケーションのルートディレクトリ>

-source {1.6|6|1.7|7|1.8|8|9|11}

JSPをコンパイルする際，JSPトランスレーション時にJavaソースファイルが生成されます。このJavaソースファイルをコンパイルするJava言語仕様のバージョンを指定します。例えば，JSPファイルに，J2SE1.6の言語仕様に依存したプログラムコードを記述している場合は，このオプションに1.6を指定してください。ただし，1.6および6はJDK11を使用している場合だけ指定できます。また，11はJDK17以降を使用している場合だけ指定できます。このオプションを省略した場合，インストールしているJDKのJava言語仕様に従ってコンパイルします。

指定方法を次に示します。

指定方法

cjjspc -source <バージョン> -root <Webアプリケーションのルートディレクトリ>

-pageencoding <文字エンコーディング>

JSPファイルのデフォルトの文字エンコーディングを指定します。デフォルトの文字エンコーディングとして設定できる文字は，JavaVMがサポートしている文字エンコーディングとなります。JavaVMがサポートしている文字エンコーディングについては，JDKのドキュメントのサポートされているエンコーディングに関する説明を参照してください。

また，指定できる文字列は，java.nio API用の正準名とjava.lang API用の正準名に記載されている文字エンコーディング，およびそれらの別名になります。サポートされていない文字エンコーディングを指定した場合，エラーメッセージが出力されて処理が終了します。

-resultlist <実行結果リストファイルパス>

コンパイル実行結果リストファイルを絶対パスまたはカレントディレクトリからの相対パスで指定します。コンパイル実行結果リストファイルには次のリストが出力されます。

コンパイル対象外のJSPファイルパス

コンパイルに成功したJSPファイルパス

コンパイルに失敗したJSPファイルパス

指定方法と出力形式を次に示します。

指定方法

cjjspc -resultlist <実行結果リストファイルのパス> -root <Webアプリケーションのルートディレクトリ>

実行結果リストファイルの出力形式

# Excluded JSP files.
＜コンパイル対象外JSPファイルの一覧＞
# Compiled JSP files.
＜コンパイルに成功したJSPファイル＞
# ＜コンパイルに失敗したJSPファイル＞
…

指定したファイルと同名のファイルが存在した場合は，ファイルを上書きして処理を続行します。

-customactiondeclarevariable

複数のカスタムタグで，スクリプト変数名とスクリプト変数のスコープが重複する場合，JSPファイルから生成されたJavaコードで，2回目のカスタムタグに対応するスクリプト変数の変数宣言を出力するときに，このオプションを指定します。このオプションを指定しない場合は，スクリプト変数の変数宣言を出力しません。

(*)スクリプト変数のスコープは，javax.servlet.jsp.tagext.TagExtraInfoクラスのサブクラス，またはTLDファイルのvariable要素内のscope要素で指定できます。

-customactionignorecaseattributename

カスタムタグで指定された属性が，TLDファイルまたはタグファイルで定義されているかどうかのチェックで，大文字小文字を区別しない場合に指定します。

-usebeannocheckclass

JSPコンパイル時に<jsp:useBean>タグのclass属性値の検証をしない場合に指定します。

-usebeannocheckduplicateid

JSPコンパイル時に<jsp:useBean>タグのid属性値の検証をしない場合に指定します。

-tagnocheckrtexprvalue

Expressionが指定できないタグの属性値にExpressionが指定されているかどうかを検証しない場合に指定します。

-tagrtexprvalueterminate

タグの属性値が，「"<%=」（または「'<%=」）で開始していて，「%>"」（または「%>'」）で終了していない属性値がある場合，「"」（または「'」）で囲まれた値を文字列として扱うときに指定します。

-taglibnocheckprefix

aglibディレクティブの前に，taglibディレクティブで指定したprefixを使用したカスタムタグを記述しているかどうかをチェックしない場合に指定します。

-debugging

JSPデバッグ機能を有効にする場合に指定します。

JSPデバッグ機能が有効な場合，JSPファイルから作成されたサーブレットのclassファイルにSMAPが埋め込まれます。また，このオプションを指定した場合と指定しない場合で，出力されるクラス名が異なります。詳細については，マニュアル「アプリケーションサーバ機能解説 基本・開発編(Webコンテナ)」の「2.4　JSPデバッグ機能」を参照してください。

-jsppagedisablebom

Servlet 2.5仕様以降のWebアプリケーションのJSPページでBOMによる文字エンコーディングの決定をしない場合に指定します。

-nojavaeetaglib

Servle t2.5仕様以降のWebアプリケーションでJava EE仕様に含まれるタグライブラリ（JSTLおよびJSF）を自動的にマッピングしない場合に指定します。また，Servlet 2.5仕様以降のWebアプリケーションで，アプリケーションサーバが提供するタグライブラリ（JSTL，JSF）以外を使用する場合に指定します。

-lowerversion {2.4|2.5}

設定したWebアプリケーションのバージョンで，JSPファイルをコンパイルできます。

指定方法を次に示します。

指定方法

cjjspc -lowerversion <バージョン> -root <Webアプリケーションのルートディレクトリ>

-addimport <クラス名1>[,<クラス名2>…]

暗黙インポートするクラス名（完全修飾名のクラス名，または「パッケージ名.*」）を指定します。複数のクラス名を指定する場合は，クラス名とクラス名を「,（コンマ）」で区切って指定します。暗黙インポートの詳細については，マニュアル「アプリケーションサーバ機能解説 基本・開発編(Webコンテナ)」の「2.3.7　page/tagディレクティブのimport属性暗黙インポート」を参照してください。

-root <Webアプリケーションのルートディレクトリ>

コンパイル対象のJSPを含むWebアプリケーションのルートディレクトリを指定します。カレントディレクトリからの相対パスまたは絶対パスで指定します。パス名に空白が含まれるときは，「"（ダブルクォーテーション）」で囲みます。

<JSPファイルパス>...

JSPファイル単位のコンパイルを実行する場合に指定します。JSPファイルパスは，-rootで指定したWebアプリケーションのルートディレクトリからの相対パスで指定します。パスの区切り文字には「/」を使用して，パスの先頭には必ず「/」を付けます。JSPファイルパスを複数指定する場合は，それぞれのJSPファイルパスを半角スペースで区切って，複数のJSPファイルパスを指定します。省略した場合は，Webアプリケーション内のすべてのJSPファイルがコンパイル対象となります。パス名にアスタリスク（*），または空白が含まれるときは，JSPファイルパスごとに「"（ダブルクォーテーション）」で囲みます。

戻り値

0：

正常終了しました。

1：

オプション解析エラーです。

2以上：

異常終了しました。

注意事項

このコマンドを実行したときには，Deployment Descriptor（/WEB-INF/web.xml）およびTLDファイルが，DTDまたはXMLスキーマに従っているか検証します。Deployment Descriptor（/WEB-INF/web.xml）がスキーマに従っていない場合は，エラーとなりコマンドの処理が終了します。また，TLDファイルがスキーマに従っていない場合も，JSPがトランスレーションしているときにエラーとなります。したがって，スキーマに従っていない場合は，エラーとなりコマンドの処理が終了します。

タグファイル，静的インクルードされたファイル，またはTLDファイルを更新した場合，更新したファイルを参照するすべてのJSPファイルをコンパイルしてください。

環境変数「CJ_CMD_JVM_ARGS」を設定すると，cjjspcコマンドが動作するJavaVMの起動オプションを変更できます。

デフォルトではJavaVMの起動オプションに「-Xmx512m」（Javaヒープメモリ領域の最大値が512MB）が設定されています。cjjspcコマンドで大規模なWebアプリケーションをコンパイルする場合，Javaヒープメモリ領域の最大値を超え，java.lang.OutOfMemoryErrorが発生するおそれがあります。したがって，大規模なWebアプリケーションをコンパイルする場合は，あらかじめ環境変数「CJ_CMD_JVM_ARGS」に，適切なJavaヒープメモリ領域を指定する必要があります。

また，文字エンコーディングの別名であるshift_jis，csshiftjis，ms_kanji，x-sjisは，JDK1.4.0ではMS932の別名でしたが，JDK1.4.2以降ではSJISの別名に変更になりました。今までMS932の別名として shift_jis，csshiftjis，ms_kanji，x-sjis を使用していたプログラムをそのままこのバージョンで実行すると文字化けすることがあります。shift_jis，csshiftjis，ms_kanji ，x-sjis を以前のバージョンと同じく，MS932の別名として実行させる場合，環境変数「CJ_CMD_JVM_ARGS」に，「-Dsun.nio.cs.map=Windows-31J/Shift_JIS」を指定してください※。

注※

JDK17以降の場合は，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「10.3.3(6)　sun.nio.cs.mapシステムプロパティの削除」を参照してください。

また，JavaVMの起動オプションにデフォルトで-XX:+UseSerialGCを指定しているため，環境変数「CJ_CMD_JVM_ARGS」でGC方式を変更する場合は，-XX:-UseSerialGCも指定する必要があります。

付録

付録A　JavaVMで使用するポート番号と設定変更方法

JavaVMで使用するポート番号，ポート番号の目的，およびポート番号の設定変更方法について，次の表に示します。

表A‒1　JavaVMで使用するポート番号一覧

ポート番号

目的

変更方法

1049（TCP）

orbdコマンドが使用します。orbdコマンドは，このポートで持続オブジェクトに対する要求を受け取ります。

orbdコマンドの-portオプションで変更できます。

% orbd -port <ポート番号>

1080（TCP）

SOCKSプロトコルで用いるポート番号です。

プロパティsocksProxyPort※にポート番号を指定して変更できます。

% java -DsocksProxyPort=<ポート番号>

1098（TCP）

rmidコマンドが使用します。rmidコマンドは，このポートで内部レジストリを起動します。

rmidコマンドの-portオプションで変更できます。

% rmid -port <ポート番号>

1099（TCP）

rmiregistryコマンドが使用します。rmiregistryコマンドは，このポート番号上にリモートオブジェクトレジストリを作成します。

rmiregistryコマンドにポート番号を指定することで変更できます。

% rmiregistry <ポート番号>

注※

socksプロパティについては，J2EEサーバ，Webコンテナサーバ，またはEJBクライアントアプリケーションのシステムプロパティとして設定します。

付録B　J2EEアプリケーションを実行するシステムの構築と削除

ここでは，J2EEアプリケーションを実行するシステムを，ファイル編集とコマンド実行で構築，および削除する手順について説明します。

付録B.1　システム構築の流れ

J2EEアプリケーションを実行するシステムをファイル編集とコマンド実行で構築する場合，アプリケーションサーバが提供するコマンド，ユーザ定義ファイルなどを使用してシステムの動作環境を設定します。

(1)　システムの構築で使用するファイル

J2EEアプリケーションを実行するシステムを構築する場合に使用する主なファイルを次に示します。各ファイルの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.　J2EEサーバで使用するファイル」を参照してください。

注意事項

ファイルを変更する場合は，J2EEサーバを停止してください。J2EEサーバの稼働中にファイルの内容を変更した場合の動作は保証されません。

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）

J2EEサーバのユーザプロパティを指定するファイルです。J2EEサーバが使用するネーミングサービス，トランザクション，コネクション，コンテナ，ログ，セキュリティなどを指定します。

ファイルの格納場所を次に示します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥usrconf.properties

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/usrconf.properties

usrconf.cfg（J2EEサーバ用オプション定義ファイル）

J2EEサーバのJavaVMの起動オプションを指定するファイルです。

ファイルの格納場所を次に示します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥usrconf.cfg

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/usrconf.cfg

server.policy（J2EEサーバ用セキュリティポリシーファイル）

J2EEサーバを実行するJavaVMのセキュリティポリシーを指定するファイルです。

ファイルの格納場所を次に示します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥server.policy

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/server.policy

hitachi_web.properties（J2EEサーバ用Webアプリケーションプロパティファイル）

Webアプリケーション個別のプロパティを指定するファイルです。なお，J2EEサーバ全体でのプロパティの設定は，usrconf.propertiesで指定します。

ファイルの格納場所を次に示します。

Windowsの場合

<WebアプリケーションのWEB-INFディレクトリ>¥hitachi_web.properties

UNIXの場合

<WebアプリケーションのWEB-INFディレクトリ>/hitachi_web.properties

hitachi_web.propertiesを変更した場合，WARファイルを作成，インポートし直してください。

(2)　J2EEアプリケーションを実行するシステムを構築する流れ

ファイル編集とコマンド実行で，J2EEアプリケーションを実行するシステムを構築する場合の，システム構築の流れについて説明します。

J2EEサーバをセットアップします。

デフォルトの設定のままで利用する場合は，セットアップ不要です。

インストール時にセットアップ済みのJ2EEサーバとは別のサーバ名称を使用したい場合に，セットアップしてください。詳細については，「付録B.2　J2EEサーバのセットアップ」を参照してください。

J2EEサーバの動作設定をします。

デフォルトの設定のままで利用する場合は，設定不要です。

使用する機能の動作を変更したり，特定の機能を使用したりする場合には，アプリケーションサーバが提供するユーザ定義ファイルやコマンドを使用して，J2EEサーバの動作を設定，変更します。

J2EEサーバの動作を設定，変更できる機能の例を次に示します。

ネーミングサービス

トランザクション

JavaVMの起動オプション

コンテナ拡張ライブラリ

CTMによるリクエストのスケジューリング

トラブルシューティングの資料取得の設定をします。

デフォルトの設定のままで利用する場合は，設定不要です。ただし，次の資料は，事前に取得のための設定をしておかないと，取得できません。これらの資料はトラブルシューティングで必要となるため，取得することをお勧めします。

OSの統計情報，ユーザダンプ（Windowsの場合）またはcoreダンプ（UNIXの場合）

JavaVMのGCのログ

これらの資料を取得する場合や，ほかの資料の取得設定を変更したい場合に，トラブルシューティングの資料取得の設定をしてください。トラブルシューティングに必要な資料の詳細と，システム構築時の設定の要否については「付録B.1(3)　トラブルシューティングに必要な資料」を参照してください。

Webサーバとの連携の設定をします。

Webサーバと連携しない場合は，設定不要です。

リバースプロキシを利用したリクエストの振り分け，通信タイムアウト，エラーページのカスタマイズなど，Webサーバと連携するための設定をします。

統合ユーザ管理機能の設定をします。

統合ユーザ管理機能を使用しない場合は，設定不要です。

アプリケーションサーバシステムにログインするユーザを統合管理するための設定をします。ユーザ認証情報を格納するLDAPディレクトリサーバや，統合ユーザ管理のコンフィグレーションファイルを設定します。設定方法の詳細については，マニュアル「アプリケーションサーバ機能解説 セキュリティ管理機能編」の「5.13　統合ユーザ管理機能の設定手順」を参照してください。

システムの可用性を高める設定をします。

システムの可用性を高める機能を使用しない場合は，設定不要です。

セッションフェイルオーバ機能によるJ2EEサーバへのセッション情報の引き継ぎの設定をします。設定方法の詳細については，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「5.　J2EEサーバ間のセッション情報の引き継ぎ」を参照してください。

リソースとJ2EEアプリケーションの設定をします。

サーバ管理コマンドを使用して，リソースアダプタやJ2EEアプリケーションのプロパティを定義し，J2EEサーバにインポートします。設定方法の詳細については，マニュアル「アプリケーションサーバ 機能解説 基本・開発編(コンテナ共通機能)」の「3.　リソース接続とトランザクション管理」を参照してください。

システムを起動して，システムの動作を確認します。

システムの起動および停止については，「付録C　J2EEアプリケーションを実行するシステムの起動と停止（Windowsの場合）」，または「付録D　J2EEアプリケーションを実行するシステムの起動と停止（UNIXの場合）」を参照してください。

(3)　トラブルシューティングに必要な資料

トラブルシューティングに必要な資料と，システム構築時の設定の要否について次の表に示します。なお，設定方法の詳細については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「3.　トラブルシューティングのための準備」を参照してください。

表B‒1　トラブルシューティングの資料の種類と設定要否（J2EEアプリケーションを実行するシステムの場合）

資料の種類

設定の要否

snapshotログ

△※1

性能解析トレースファイル

×※2

J2EEサーバのログ

△

Webサーバのログ

△

J2EEアプリケーションのユーザログ

○

稼働情報ファイル

△

リソースアダプタのログ

△

TPBrokerのトレースファイル

△

OSの統計情報

○

ユーザダンプ

○

coreダンプ

○

JavaVMの資料

○

サーバ管理コマンドのログ

△

（凡例）

○：資料を取得する場合には，設定が必要。

△：デフォルトの資料取得の設定を変更する場合だけ，設定が必要。

×：設定は不要。

注※1

snapshotlogコマンドを使用してsnapshotログを取得します。この場合，あらかじめ設定しておいたリストファイルを，コマンド実行時に引数として指定します。snapshotlogコマンド，およびデフォルトの設定で収集できるsnapshotログについては，「11.2　ログの運用で使用するコマンドの詳細」の「snapshotlog（snapshotログの収集）」を参照してください。なお，snapshotログの収集先を変更する場合には，snapshotログ収集対象定義ファイルを編集します。snapshotログ収集対象定義ファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「10.2.1　snapshotログ収集対象定義ファイル」を参照してください。

注※2

日常的なシステム運用の作業で，cprfstartコマンドを実行してパフォーマンストレーサを起動するときに，PRFトレースの取得レベルやファイルの面数を指定できます。性能解析トレースファイルの取得については，マニュアル「アプリケーションサーバ 機能解説保守／移行編」の「7.3.1　性能解析トレースファイルの収集方法」を参照してください。

表B-1に示したログは，snapshotログで一括収集できます。ただし，TPBrokerのトレースファイルについては，収集できるものと収集できないものが混在しています。このほかにも，snapshotログのデフォルトの設定で取得できないログについては，取得のための設定をしたり，snapshotログの収集先に追加したりする必要があります。

なお，次のログはログ出力先を変更できません。

セットアップ時に作成されるinstall.log，移行コマンドなどのログファイル

次のディレクトリに出力されるJavaのスレッドダンプファイル

Windowsの場合

<作業ディレクトリ>¥ejb¥<サーバ名称>

UNIXの場合

<作業ディレクトリ>/ejb/<サーバ名称>

ログの種類やデフォルト値，チャネル名，取得できるログの詳細や取得方法については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「2.4　取得が必要な資料の種類」を参照してください。

付録B.2　J2EEサーバのセットアップ

アプリケーションサーバのシステムを構成するJ2EEサーバのセットアップについて説明します。

J2EEサーバは，製品のインストール時にセットアップ済みです。デフォルトの設定では，J2EEサーバ名はホスト名です。別のサーバ名に変更したい場合には，J2EEサーバをセットアップしてください。また，同じホスト内で複数のJ2EEサーバを起動する場合には，それぞれのJ2EEサーバに別のサーバ名を割り当てる必要があるため，J2EEサーバをセットアップしてください。

J2EEサーバのセットアップの手順について説明します。セットアップに関する注意事項については，「付録B.2(3)　セットアップに関する注意事項」を参照して，必要に応じて対応してください。同じホスト内で複数のJ2EEサーバを起動する場合に，サーバ名を割り当てるときの注意事項については，「付録B.2(4)　複数のJ2EEサーバを起動する場合の注意事項」を参照してください。

(1)　Windowsの場合

Windowsの場合のJ2EEサーバのセットアップ手順を次に示します。

次のコマンドでカレントディレクトリを移動します。

"cd <Application Serverのインストールディレクトリ>¥CC¥server¥bin"

cjsetupコマンドでJ2EEサーバをセットアップします。

"cjsetup <サーバ名>"

J2EEサーバのセットアップの例を次に示します。この例では，Application Serverのインストールディレクトリは「C:¥Program Files¥Hitachi¥Cosminexus」，サーバ名は「MyServer」です。

C:¥>cd C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥binC:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin>cjsetup MyServer

(2)　UNIXの場合

UNIXの場合のJ2EEサーバのセットアップ手順を次に示します。

cjsetupコマンドでJ2EEサーバをセットアップします。コマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

/opt/Cosminexus/CC/server/bin/cjsetup <サーバ名>

J2EEサーバのセットアップの例を次に示します。この例では，サーバ名は「MyServer」です。

/opt/Cosminexus/CC/server/bin/cjsetup MyServer

(3)　セットアップに関する注意事項

J2EEサーバのセットアップは，1回だけ実行してください。セットアップ済みのJ2EEサーバを設定してセットアップすると，エラーメッセージが出力されます。

J2EEサーバをセットアップして，カスタマイズしない場合，J2EEサーバはホスト名「localhost」，ポート番号「900」のCORBAネーミングサービスをインプロセスで自動起動して使用します。使用するCORBAネーミングサービスを変更する場合は，usrconf.propertiesのejbserver.naming.hostキーとejbserver.naming.portキーで変更してください。また，CORBAネーミングサービスの起動モードを変更する場合には，usrconf.propertiesのejbserver.naming.startupModeキーで変更してください。

J2EEサーバを開始する前に，環境変数「OSAGENT_PORT」の値とusrconf.propertiesのvbroker.agent.portキーの値が一致しているかどうかを確認してください。

サーバ名称に使用できる文字については，cjsetupコマンドの説明を参照してください。cjsetupコマンドについては，「2.2　J2EEサーバを操作するコマンド」を参照してください。

サーバ名称は，作業ディレクトリ中のディレクトリ名として使用されます。作業ディレクトリ下のパス長がプラットフォームの上限に達しないようにサーバ名称を指定してください。作業ディレクトリのパス長の見積もりについては，マニュアル「アプリケーションサーバシステム構築・運用ガイド」の「付録C.1　J2EEサーバの作業ディレクトリ」を参照してください。

(4)　複数のJ2EEサーバを起動する場合の注意事項

J2EEサーバはサーバ名称によって識別されます。インストール時に，インストールされたホストのホスト名がデフォルトのサーバ名称として設定されています。このため，同じホスト内で複数のJ2EEサーバを起動する場合，それぞれのJ2EEサーバにサーバ名称を割り当て，J2EEサーバをセットアップします。

J2EEサーバのサーバ名称を割り当てる上で，次に示す二つの条件を考慮する必要があります。

同じホスト内では，同じサーバ名称のJ2EEサーバを複数回セットアップしてはいけません。同じサーバ名称で再セットアップした場合，エラーになります。

同じCORBAネーミングサービスを利用する場合，複数のホスト間でも同じサーバ名称のJ2EEサーバを複数回セットアップしてはいけません。

J2EEサーバと接続するCORBAネーミングサービスのホスト名およびポート番号，CORBAネーミングサービスの使用するスマートエージェントの設定に関する注意事項を次に示します。

ホスト名およびポート番号の設定

同一ホストで複数のJ2EEサーバを同時に起動する場合，CORBAネーミングサービスとの接続に使用するホスト名およびポート番号が両方とも重ならないようにしてください。ホスト名およびポート番号は，usrconf.propertiesで設定します。

また，usrconf.propertiesのwebserver.connector.nio_http.portキーおよびejbserver.http.portキーで設定されているポート番号には，同時に起動するJ2EEサーバ間で異なる値を使用するように設定してください。

スマートエージェントの設定

J2EEサーバが接続するCORBAネーミングサービスでスマートエージェントを使用する場合，同一のスマートエージェントの範囲内（同一のポート番号で接続する範囲内）でJ2EEサーバ名を一意としてください。J2EEサーバ名を一意にしない場合には，サーバ管理コマンドでKDJE37302-Eのメッセージが出力され，サーバ管理コマンドが実行できなくなることがあります。

なお，CORBAネーミングサービスでスマートエージェントを使用する場合とは，次のとおりです。

CORBAネーミングサービスをアウトプロセスで手動起動する場合

ejbserver.naming.startupModeキーにmanualを指定して起動する場合，CORBAネーミングサービス起動時の引数で，vbroker.agent.enableLocator=true（デフォルトはtrue）を指定します。

CORBAネーミングサービスをアウトプロセスで自動起動，またはインプロセスで自動起動する場合

ejbserver.naming.startupModeキーにautomaticまたはinprocessを指定して起動する場合，usrconf.propertiesで，vbroker.agent.enableLocator=true（デフォルトはfalse）を指定して，スマートエージェントの使用を有効にします。

付録B.3　システムの削除の流れ

J2EEアプリケーションを実行するシステムをファイル編集とコマンド実行で削除する場合，アプリケーションサーバが提供するコマンドを使用して，J2EEサーバをアンセットアップし，システムを削除します。

ファイル編集とコマンド実行で，J2EEアプリケーションを実行するシステムを削除する場合の，システム削除の流れについて説明します。

システムを停止します。

システムの停止手順および停止方法については，「付録C　J2EEアプリケーションを実行するシステムの起動と停止（Windowsの場合）」，または「付録D　J2EEアプリケーションを実行するシステムの起動と停止（UNIXの場合）」を参照してください。

J2EEサーバをアンセットアップします。

詳細については，「付録B.4　J2EEサーバのアンセットアップ」を参照してください。

付録B.4　J2EEサーバのアンセットアップ

アプリケーションサーバのシステムを構成するJ2EEサーバのアンセットアップについて説明します。J2EEサーバのアンセットアップの手順について，OSごとに説明します。

(1)　Windowsの場合

Windowsの場合のJ2EEサーバのアンセットアップ手順を次に示します。

次のコマンドでカレントディレクトリを移動します。

"cd <Application Serverのインストールディレクトリ>¥CC¥server¥bin"

cjsetupコマンドで引数に-dを指定して，J2EEサーバをアンセットアップします。

"cjsetup -d <サーバ名>"

J2EEサーバのアンセットアップの例を次に示します。この例では，Application Serverのインストールディレクトリは「C:¥Program Files¥Hitachi¥Cosminexus」，サーバ名は「MyServer」です。

C:¥>cd C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥binC:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin>cjsetup -d MyServer

(2)　UNIXの場合

UNIXの場合のJ2EEサーバのアンセットアップ手順を次に示します。

cjsetupコマンドで引数に-dを指定して，J2EEサーバをアンセットアップします。コマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

/opt/Cosminexus/CC/server/bin/cjsetup -d <サーバ名>

J2EEサーバのアンセットアップの例を次に示します。この例では，サーバ名は「MyServer」です。

/opt/Cosminexus/CC/server/bin/cjsetup -d MyServer

付録C　J2EEアプリケーションを実行するシステムの起動と停止（Windowsの場合）

ここでは，Windowsの場合のJ2EEアプリケーションを実行するシステムの起動と停止の手順について説明します。

付録C.1　システムの起動手順

システムの起動手順について説明します。

注意事項

システム構成によって，アプリケーションサーバだけを起動する場合と，アプリケーションサーバのほかに，統合ネーミングスケジューラサーバを起動する場合があります。

アプリケーションサーバのほかに，統合ネーミングスケジューラサーバを起動する場合，次の点に注意してください。

統合ネーミングスケジューラサーバの起動順序は任意です。

次に，アプリケーションサーバ，および統合ネーミングスケジューラサーバの起動手順について説明します。

なお，データベース，LDAPディレクトリサーバ，EISなどの関連製品は起動済みであることを前提に説明します。データベース，LDAPディレクトリサーバ，EISなどを使用している場合は，必要に応じてあらかじめ起動しておいてください。

(1)　アプリケーションサーバの起動の流れ

アプリケーションサーバの起動の流れについて説明します。

ここでは，標準システム構成の場合と，CTMを使用する構成の場合のアプリケーションサーバの起動の流れについて説明します。

アプリケーションサーバの起動の流れを次の図に示します。

図C‒1　アプリケーションサーバの起動の流れ（Windowsの場合）

図中の1.〜10.について説明します。

システム起動時の環境変数の設定

環境変数を設定します。環境変数の設定方法については，「付録C.2(1)　システム起動時の環境変数の設定」を参照してください。

PRFデーモンの起動

cprfstartコマンドでPRFデーモンを起動します。起動方法については，「付録C.2(2)　PRFデーモンの起動」を参照してください。

スマートエージェントの起動

CTMを使用しない場合，この操作は不要です。

osagentコマンドでスマートエージェントを起動します。起動方法については，「付録C.2(3)　スマートエージェントの起動」を参照してください。

CTMドメインマネジャの起動

CTMを使用しない場合，この操作は不要です。

ctmdmstartコマンドでCTMドメインマネジャを起動します。起動方法については，「付録C.2(4)　CTMドメインマネジャの起動」を参照してください。

CORBAネーミングサービスの起動

J2EEサーバ用のCORBAネーミングサービスは，J2EEサーバ起動時にインプロセスで起動することを推奨します。

アウトプロセスでの起動方法については，「付録C.2(5)　CORBAネーミングサービスの起動」を参照してください。

CTMデーモンの起動

CTMを使用しない場合，この操作は不要です。

ctmstartコマンドでCTMデーモンを起動します。起動方法については，「付録C.2(6)　CTMデーモンの起動」を参照してください。

J2EEサーバの起動

cjstartsvコマンドでJ2EEサーバを起動します。起動方法については，「付録C.2(7)　J2EEサーバの起動」を参照してください。

リソースの開始

リソースを使用しない場合，この操作は不要です。また，J2EEアプリケーションに含まれるリソースアダプタを利用する場合もこの操作は不要です。

サーバ管理コマンド（cjstartrar，cjstartjb）でリソースを開始します。開始方法については，「付録C.2(8)　リソースの開始」を参照してください。

J2EEアプリケーションの開始

サーバ管理コマンド（cjstartapp）でJ2EEアプリケーションを開始します。なお，リソースアダプタを含んだJ2EEアプリケーションの場合，J2EEアプリケーションに含まれるすべてのリソースアダプタが同時に開始されます。

開始方法については，「付録C.2(9)　J2EEアプリケーションの開始」を参照してください。

Webサーバの起動

起動方法については，ご使用のWebサーバのマニュアルを参照してください。

なお，Webサーバの起動のタイミングはシステムの運用形態に依存しますが，この順序で起動することでJ2EEアプリケーションへのリクエストの受け付けを制御できます。Webサーバ起動後，WebクライアントからのJ2EEアプリケーションへのリクエストの受け付けを開始します。開始方法については，「付録C.2(10)　Webサーバの起動」を参照してください。

(2)　統合ネーミングスケジューラサーバの起動の流れ

統合ネーミングスケジューラサーバの起動の流れを次の図に示します。

図C‒2　統合ネーミングスケジューラサーバの起動の流れ（Windowsの場合）

図中の1.〜6.について説明します。

システム起動時の環境変数の設定

環境変数を設定します。環境変数の設定方法については，「付録C.2(1)　システム起動時の環境変数の設定」を参照してください。

PRFデーモンの起動

cprfstartコマンドでPRFデーモンを起動します。起動方法については，「付録C.2(2)　PRFデーモンの起動」を参照してください。

スマートエージェントの起動

osagentコマンドでスマートエージェントを起動します。起動方法については，「付録C.2(3)　スマートエージェントの起動」を参照してください。

CTMドメインマネジャの起動

ctmdmstartコマンドでCTMドメインマネジャを起動します。起動方法については，「付録C.2(4)　CTMドメインマネジャの起動」を参照してください。

CORBAネーミングサービスの起動

CTM用のグローバルCORBAネーミングサービスを起動します。起動方法については，「付録C.2(5)　CORBAネーミングサービスの起動」を参照してください。

CTMデーモンの起動

ctmstartコマンドでCTMデーモンを起動します。起動方法については，「付録C.2(6)　CTMデーモンの起動」を参照してください。

付録C.2　システムの起動方法

ここでは，構成ソフトウェアの各プロセスの起動方法，リソースの開始方法，およびJ2EEアプリケーションの開始方法について説明します。

(1)　システム起動時の環境変数の設定

ここでは，アプリケーションサーバおよび統合ネーミングスケジューラサーバに設定する環境変数について説明します。

setコマンドで次に示す環境変数を設定してください。

set PATH=<Application Serverのインストールディレクトリ>¥jdk¥bin;%PATH%
set PATH=<Application Serverのインストールディレクトリ>¥TPB¥bin;%PATH%
set VBROKER_ADM=<Application Serverのインストールディレクトリ>¥TPB¥adm
set TPDIR=<Application Serverのインストールディレクトリ>¥TPB
set CTMDIR=<Application Serverのインストールディレクトリ>¥CTM※
set CTMSPOOL=<Application Serverのインストールディレクトリ>¥CTM¥spool※

注※

CTMを使用する場合に，アプリケーションサーバおよび統合ネーミングスケジューラサーバで設定が必要な環境変数です。

環境変数「TZ」に「JST-9」を設定して，システム環境変数に登録してください。

CORBAネーミングサービスを手動起動する場合は，環境変数「PATH」の先頭に「<Application Serverのインストールディレクトリ>¥jdk¥bin」を指定してください。

HiRDBまたはOracleを利用する場合には，それぞれのライブラリのパスを環境変数「PATH」に設定します。あらかじめシステム環境変数に設定している場合はsetコマンドの実行は不要です。

インストール時に，「<システムドライブ>:¥Common Files¥Hitachi」が環境変数「PATH」に追加され，自動的にシステム環境変数に登録されます。

インストール時に，「<Application Serverのインストールディレクトリ>¥PRF¥spool」が環境変数「PRFSPOOL」に設定され，自動的にシステム環境変数に登録されます。

環境変数の内容については，「付録H　システムの環境変数」を参照してください。

(2)　PRFデーモンの起動

PRFデーモンの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Application Serverのインストールディレクトリ>¥PRF¥bin"

cprfstartコマンドでPRFデーモンを起動します。

cprfstart

(3)　スマートエージェントの起動

スマートエージェントの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Application Serverのインストールディレクトリ>¥TPB¥bin"

osagentコマンドでスマートエージェントを起動します。

コマンドの実行には，Administrator権限が必要です。

osagent

(4)　CTMドメインマネジャの起動

CTMドメインマネジャの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Application Serverのインストールディレクトリ>¥CTM¥bin"

ctmdmstartコマンドでCTMドメインマネジャを起動します。

コマンドの実行には，Administrator権限が必要です。

ctmdmstart

なお，CTMドメインマネジャを起動する時には，パフォーマンストレーサのライブラリパス（<Application Serverのインストールディレクトリ>¥PRF¥lib）を同時に設定しないでください。パフォーマンストレーサのライブラリパスを同時に設定すると，CTMドメインマネジャがパフォーマンストレーサのライブラリをロードした場合にエラーとなり，起動できません。

(5)　CORBAネーミングサービスの起動

CORBAネーミングサービスの起動方法について説明します。

J2EEサーバ用のCORBAネーミングサービスは，J2EEサーバ起動時にインプロセスで起動することを推奨します。アウトプロセスで起動する場合は，nameservコマンドを使用して起動します。

ここでは，nameservコマンドでCORBAネーミングサービスをアウトプロセスで起動する方法について説明します。J2EEサーバの起動時にCORBAネーミングサービスをインプロセスで起動する方法については，「付録C.2(7)　J2EEサーバの起動」を参照してください。

なお，CORBAネーミングサービス起動時は次の点に留意してください。

CTMを使用する場合，J2EEサーバ用およびCTM用のCORBAネーミングサービスを起動します。CTM用にグローバルCORBAネーミングサービスをnameservコマンドで手動起動して，さらにJ2EEサーバ用のCORBAネーミングサービスをJ2EEサーバ起動時にインプロセスで自動起動してください。

nameservコマンドでCORBAネーミングサービスを手動起動する場合の手順を次に示します。

setコマンドで環境変数「CLASSPATH」を設定解除します。

set CLASSPATH=

cdコマンドでカレントディレクトリを移動します。

cd "<Application Serverのインストールディレクトリ>¥TPB¥bin"

nameservコマンドでローカルCORBAネーミングサービスを手動開始します。

コマンドの実行には，Administrator権限が必要です。

nameserv -J-Dvbroker.agent.enableLocator=false
-J-Djava.security.policy=="<Application Serverのインストールディレクトリ>¥
CC¥server¥sysconf¥cli.policy"
-J-Dvbroker.se.iiop_tp.scm.iiop_tp.listener.port=<ポート番号>

注意事項

CORBAネーミングサービスを手動起動する場合は，環境変数「PATH」の先頭に「<Application Serverのインストールディレクトリ>¥jdk¥bin」を指定してください。

nameservコマンドで指定するオプションの値に空白を含むディレクトリが含まれる場合は，値全体をダブルクォーテーション（"）で囲むようにしてください。

nameservコマンドで指定する値は環境に合わせて変更してください。

CORBAネーミングサービスは，次のオプションで指定したポート番号で起動します。

-J-Dvbroker.se.iiop_tp.scm.iiop_tp.listener.port=<ポート番号>

(6)　CTMデーモンの起動

CTMデーモンの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Application Serverのインストールディレクトリ>¥CTM¥bin"

ctmstartコマンドでCTMデーモンを起動します。

コマンドの実行には，Administrator権限が必要です。

ctmstart -CTMINSRef <ホスト名：ポート番号>

ホスト名およびポート番号にはグローバルCORBAネーミングサービスを起動しているホスト名およびポート番号を指定してください。

なお，CTMデーモンを起動する時には，パフォーマンストレーサのライブラリパス（<Application Serverのインストールディレクトリ>¥PRF¥lib）を同時に設定しないでください。パフォーマンストレーサのライブラリパスを同時に設定すると，CTMデーモンがパフォーマンストレーサのライブラリをロードした場合にエラーとなり，起動できません。

参考

CTMデーモンを開始するctmstartコマンドでは，コマンド実行時に次のファイルを指定できます。

CTMユーザ環境変数定義ファイル

-CTMEnvironオプションで指定するファイルです。CTMデーモンで管理するプロセスが使用する環境変数を指定したい場合は，このファイルに環境変数を記述します。

CTMコマンドオプションファイル

-CTMRegOptionで指定するファイルです。CTMレギュレータを自動開始するときのコマンドオプションを指定したい場合は，このファイルにコマンドオプションを記述します。

必要に応じて，これらのファイルを作成しておいてください。

(7)　J2EEサーバの起動

J2EEサーバの起動方法について説明します。

J2EEサーバ起動時に，次に示すプロセスをインプロセスで起動することを推奨します。

J2EEサーバ用のCORBAネーミングサービス

トランザクションサービス（トランザクションサービスを使用する場合）

なお，CTMを使用する場合，J2EEサーバ用のCORBAネーミングサービスはインプロセスで起動してください。

次に示す場合のJ2EEサーバの起動手順について(a)〜(d)で説明します。

標準システム構成でCORBAネーミングサービスをインプロセスで起動する場合

CTMを使用する構成でCORBAネーミングサービスおよびトランザクションサービスをインプロセスで起動する場合

標準システム構成でCORBAネーミングサービスをアウトプロセスで起動する場合

また，J2EEサーバ起動時は次の点に留意してください。

複数のJ2EEサーバで一つのネーミングサービスを共有する場合，J2EEサーバは一つずつ起動してください。複数のJ2EEサーバを同時に起動しようとするとJ2EEサーバの起動に失敗することがあります。

(a)　標準システム構成でCORBAネーミングサービスをインプロセスで起動する場合

標準システム構成でCORBAネーミングサービスをインプロセスで起動する場合の，J2EEサーバの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Application Serverのインストールディレクトリ>¥CC¥server¥bin"

cjstartsvコマンドでJ2EEサーバを開始します。

コマンドの実行には，Administrator権限が必要です。

cjstartsv <サーバ名称>

(b)　CTMを使用する構成でCORBAネーミングサービスおよびトランザクションサービスをインプロセスで起動する場合

CTMを使用する構成で，J2EEサーバ用のCORBAネーミングサービス，およびトランザクションサービスをインプロセスで起動する場合の，J2EEサーバの起動手順について説明します。

なお，J2EEサーバ用のCORBAネーミングサービス，およびトランザクションサービスをインプロセスで起動する場合の前提を次に示します。

usrconf.propertiesファイルのejbserver.naming.portキーにJ2EEサーバ用のCORBAネーミングサービスのTCPポート番号が設定されている必要があります。

ejbserver.naming.port = <TCPポート番号>

J2EEサーバの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Application Serverのインストールディレクトリ>¥CC¥server¥bin"

cjstartsvコマンドでJ2EEサーバを開始します。

コマンドの実行には，Administrator権限が必要です。

cjstartsv <サーバ名称>

(c)　標準システム構成でCORBAネーミングサービスをアウトプロセスで起動する場合

標準システム構成で，J2EEサーバ用のCORBAネーミングサービスをアウトプロセスで起動する場合の，J2EEサーバの起動手順について説明します。

なお，J2EEサーバ用のCORBAネーミングサービスをアウトプロセスで起動する場合の前提を次に示します。

J2EEサーバ起動前に，J2EEサーバ用のCORBAネーミングサービスを起動しておく必要があります。CORBAネーミングサービスの手動起動の方法については，「付録C.2(5)　CORBAネーミングサービスの起動」を参照してください。

usrconf.propertiesファイルのejbserver.naming.startupModeキーに「manual」を設定しておく必要があります。

usrconf.propertiesファイルのejbserver.naming.portキーに設定するTCPポート番号が，同じホストで起動しているほかのCORBAネーミングサービスと同じ値にならないように注意してください。

J2EEサーバの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Application Serverのインストールディレクトリ>¥CC¥server¥bin"

cjstartsvコマンドでJ2EEサーバを開始します。

コマンドの実行には，Administrator権限が必要です。

cjstartsv <サーバ名称>

(8)　リソースの開始

リソースの開始方法について説明します。

リソースは，サーバ管理コマンド（cjstartrarコマンド，cjstartjbコマンド）を使用して開始します。

なお，開始するリソースは，あらかじめJ2EEリソースとして，J2EEサーバにデプロイされている必要があります。J2EEサーバへのリソースのデプロイも，サーバ管理コマンドで実行します。

J2EEアプリケーションに含まれるリソースアダプタを利用する場合，この操作は不要です。

詳細については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「6.　リソースアダプタ以外のJ2EEリソースの設定」を参照してください。

注意事項

Reliable Messagingを起動する場合，あらかじめDB Connector for Reliable Messagingを起動しておいてください。DB Connector for Reliable Messagingを起動しないでReliable Messagingを起動しようとするとエラーが発生します。

(9)　J2EEアプリケーションの開始

J2EEアプリケーションの開始方法について説明します。

J2EEアプリケーションは，サーバ管理コマンドを使用して開始します。なお，サーバ管理コマンドの実行には，Administrator権限が必要です。

J2EEアプリケーションを開始する場合，サーバ管理コマンド（cjstartapp）を使用します。

開始するJ2EEアプリケーションは，J2EEサーバにインポートされている必要があります。J2EEアプリケーションとは，Enterprise Bean（EJB-JAR）およびサーブレットとJSP（WAR）を一つにまとめたEARです。サーバ管理コマンドでは，J2EEアプリケーション単位に開始，停止を実行します。

J2EEサーバへのJ2EEアプリケーションのインポートも，サーバ管理コマンドで実行します。また，開発環境で作成したWARやEJB-JARを，サーバ管理コマンドを使用してJ2EEアプリケーションにすることもできます。

詳細については，次の個所を参照してください。

マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.29　業務アプリケーションを設定して開始する（CUI利用時）」

マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「8.1　J2EEアプリケーションのインポート」

(10)　Webサーバの起動

Webサーバの起動方法については，ご使用のWebサーバのマニュアルを参照してください。

なお，Webサーバの起動のタイミングはシステムの運用形態に依存しますが，この順序で起動することでJ2EEアプリケーションへのリクエストの受け付けを制御できます。Webサーバ起動後，WebクライアントからのJ2EEアプリケーションへのリクエストの受け付けを開始します。

付録C.3　システムの停止手順

ここでは，構成ソフトウェアの各プロセス，リソース，およびJ2EEアプリケーションの停止の手順について説明します。

(1)　システムの停止の流れ

システムの停止手順は，起動手順と逆の順序になります。データベース，LDAPディレクトリサーバ，EISなどを使用している場合は，必要に応じて最後に停止してください。

注意事項

システム構成によって，アプリケーションサーバだけを停止する場合と，アプリケーションサーバのほかに，統合ネーミングスケジューラサーバを停止する場合があります。

アプリケーションサーバのほかに，統合ネーミングスケジューラサーバを停止する場合，次の点に注意してください。

統合ネーミングスケジューラサーバの停止順序は任意です。

次に示す停止操作を基にシステムを停止してください。

Webサーバの停止

停止方法については，ご使用のWebサーバのマニュアルを参照してください。

なお，Webサーバの停止のタイミングについてはシステムの運用形態に依存しますが，最初に停止することでJ2EEアプリケーションへのリクエストの受け付けを制御できます。

J2EEアプリケーションの停止

サーバ管理コマンド（cjstopapp）でJ2EEアプリケーションを停止します。停止方法については，「付録C.4(2)　J2EEアプリケーションの停止」を参照してください。

なお，次回J2EEサーバの起動と同時にJ2EEアプリケーションを開始する場合は，J2EEアプリケーションの停止は不要です。

リソースの停止

J2EEリソースを使用しない場合，この操作は不要です。

サーバ管理コマンド（cjstoprar，cjstopjb）でJ2EEリソースを停止します。停止方法については，「付録C.4(3)　リソースの停止」を参照してください。

なお，次回J2EEサーバ起動時にJ2EEリソースを開始する場合は，J2EEリソースの停止は不要です。

J2EEサーバの停止

cjstopsvコマンドでJ2EEサーバを停止します。停止方法については，「付録C.4(4)　J2EEサーバの停止」を参照してください。

CTMデーモンの停止

CTMを使用しない場合，この操作は不要です。

ctmstopコマンドでCTMデーモンを停止します。停止方法については，「付録C.4(5)　CTMデーモンの停止」を参照してください。

CORBAネーミングサービスの停止

CORBAネーミングサービスの起動方法によって，停止方法が異なります。停止方法については，「付録C.4(6)　CORBAネーミングサービスの停止」を参照してください。

CTMドメインマネジャの停止

CTMを使用しない場合，この操作は不要です。

ctmdmstopコマンドでCTMドメインマネジャを停止します。停止方法については，「付録C.4(7)　CTMドメインマネジャの停止」を参照してください。

スマートエージェントの停止

スマートエージェントを起動していない場合，この操作は不要です。

停止方法については，「付録C.4(8)　スマートエージェントの停止」を参照してください。

PRFデーモンの停止

cprfstopコマンドでPRFデーモンを停止します。停止方法については，「付録C.4(9)　PRFデーモンの停止」を参照してください。

付録C.4　システムの停止方法

ここでは，構成ソフトウェアの各プロセスの停止方法，リソースの停止方法，およびJ2EEアプリケーションの停止方法について説明します。

(1)　Webサーバの停止

Webサーバの停止方法については，ご使用のWebサーバのマニュアルを参照してください。

なお，Webサーバの停止のタイミングについてはシステムの運用形態に依存しますが，最初に停止することでJ2EEアプリケーションへのリクエストの受け付けを制御できます。

(2)　J2EEアプリケーションの停止

J2EEアプリケーションの停止方法について説明します。

J2EEアプリケーションは，サーバ管理コマンド（cjstopapp）を使用して停止します。

なお，サーバ管理コマンドの実行には，Administrator権限が必要です。

J2EEアプリケーションを停止しても，J2EEアプリケーション内のリクエスト処理が終了しないなどの原因で停止処理が完了しない場合があります。この場合，J2EEアプリケーションを強制的に停止する必要があります。J2EEアプリケーションを強制停止する場合，cjstopappコマンドに-forceオプションを指定して実行します。

J2EEアプリケーションを停止するための具体的な手順については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「10.2.2　J2EEアプリケーションの停止」を参照してください。

(3)　リソースの停止

リソースの停止方法について説明します。

リソースの停止は，サーバ管理コマンド（cjstoprar，cjstopjb）を使用します。

なお，サーバ管理コマンドの実行には，Administrator権限が必要です。

J2EEアプリケーションに含まれるリソースアダプタを利用する場合，この操作は不要です。

注意事項

DB Connector for Reliable Messagingを停止する場合，あらかじめReliable Messagingを停止しておいてください。Reliable Messagingを停止しないでDB Connector for Reliable Messagingを停止しようとするとエラーが発生します。

別名を定義したJ2EEリソースは，J2EEサーバで開始されているJ2EEアプリケーションがある場合は停止できません。停止しようとするとメッセージが出力されて処理が失敗します。別名を定義したJ2EEリソースは，J2EEサーバで開始されているすべてのJ2EEアプリケーションを停止してから停止してください。

(4)　J2EEサーバの停止

J2EEサーバの停止の手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Application Serverのインストールディレクトリ>¥CC¥server¥bin"

cjstopsvコマンドでJ2EEサーバを停止します。

コマンドの実行には，Administrator権限が必要です。

cjstopsv <サーバ名称>

cjstopsvコマンドの実行例を次に示します。この例では，Application Serverのインストールディレクトリは「C:¥Program Files¥Hitachi¥Cosminexus」，サーバ名は「MyServer」です。

C:¥>cd "C:¥Program Files¥HITACHI¥Cosminexus¥CC¥server¥bin"
C:¥Program Files¥HITACHI¥Cosminexus¥CC¥server¥bin>cjstopsv MyServer
C:¥Program Files¥HITACHI¥Cosminexus¥CC¥server¥bin>

なお，J2EEサーバを停止しても，J2EEサーバでの処理が終了しないなどの原因で停止処理が完了しない場合があります。この場合，J2EEサーバを強制的に停止する必要があります。J2EEサーバを強制停止する場合，cjstopsvコマンドに-fオプションまたは-fdオプションを指定して実行します。-fdオプションを指定すると，J2EEサーバの障害情報を取得したあと，J2EEサーバを強制停止します。

注意事項

CORBAネーミングサービスを自動起動している場合は，J2EEサーバ停止時にCORBA ネーミングサービスも自動停止されます。

(5)　CTMデーモンの停止

CTMデーモンの停止手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Application Serverのインストールディレクトリ>¥CTM¥bin"

ctmstopコマンドでCTMデーモンを停止します。

コマンドの実行には，Administrator権限が必要です。

ctmstop

なお，CTMデーモンを停止しても，CTMデーモンの停止処理が完了しない場合があります。この場合，CTMデーモンを強制的に停止する必要があります。CTMデーモンを強制停止する場合，ctmstopコマンドに-CTMForceオプションを指定して実行します。

(6)　CORBAネーミングサービスの停止

CORBAネーミングサービスの停止手順は，CORBAネーミングサービスの起動方法によって異なります。

J2EEサーバ起動時にインプロセスで起動している場合

J2EEサーバ停止時にCORBAネーミングサービスも自動停止します。

アウトプロセスで起動している場合

J2EEサーバを停止しておきます。

J2EEサーバの停止については，「付録C.4(4)　J2EEサーバの停止」を参照してください。

Ctrl+Cキーで，CORBAネーミングサービスを手動停止します。

(7)　CTMドメインマネジャの停止

CTMドメインマネジャの停止手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Application Serverのインストールディレクトリ>¥CTM¥bin"

ctmdmstopコマンドでCTMドメインマネジャを停止します。

コマンドの実行には，Administrator権限が必要です。

ctmdmstop

なお，CTMドメインマネジャを停止しても，CTMドメインマネジャの停止処理が完了しない場合があります。この場合，CTMドメインマネジャを強制的に停止する必要があります。CTMドメインマネジャを強制停止する場合，ctmdmstopコマンドに-CTMForceオプションを指定して実行します。

(8)　スマートエージェントの停止

スマートエージェントの停止手順を次に示します。

Windowsのタスクバーに表示されているスマートエージェントのアイコンを右クリックして［Exit］を選択し，スマートエージェントを停止します。

(9)　PRFデーモンの停止

PRFデーモンの停止手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Application Serverのインストールディレクトリ>¥PRF¥bin"

cprfstopコマンドでPRFデーモンを停止します。

cprfstartコマンドを実行したユーザが実行してください

cprfstop

なお，PRFデーモンを停止しても，PRFデーモンの停止処理が完了しない場合があります。この場合，PRFデーモンを強制的に停止する必要があります。PRFデーモンを強制停止する場合，cprfstopコマンドに-Forceオプションを指定して実行します。

付録D　J2EEアプリケーションを実行するシステムの起動と停止（UNIXの場合）

ここでは，UNIXの場合のJ2EEアプリケーションを実行するシステムの起動と停止の手順について説明します。

付録D.1　システムの起動手順

システムの起動手順について説明します。

注意事項

システムでは，システム構成によって，アプリケーションサーバだけを起動する場合と，アプリケーションサーバのほかに，統合ネーミングスケジューラサーバを起動する場合があります。

アプリケーションサーバのほかに，統合ネーミングスケジューラサーバを起動する場合，次の点に注意してください。

統合ネーミングスケジューラサーバの起動順序は任意です。

以降の項では，アプリケーションサーバ，および統合ネーミングスケジューラサーバの起動手順について説明します。

なお，データベース，LDAPディレクトリサーバ，EISなどの関連製品は起動済みであることを前提に説明します。データベース，LDAPディレクトリサーバ，EISなどを使用している場合は，必要に応じてあらかじめ起動しておいてください。

(1)　アプリケーションサーバの起動の流れ

システムで使用するアプリケーションサーバの起動の流れについて説明します。

ここでは，標準システム構成の場合と，CTMを使用する構成の場合のアプリケーションサーバの起動の流れについて説明します。

アプリケーションサーバの起動の流れを次の図に示します。

図D‒1　アプリケーションサーバの起動の流れ（UNIXの場合）

図中の1.〜10.について説明します。

システム起動時の環境変数の設定

環境変数を設定します。環境変数の設定方法については，「付録D.2(1)　システム起動時の環境変数の設定」を参照してください。

PRFデーモンの起動

cprfstartコマンドでPRFデーモンを起動します。起動方法については，「付録D.2(2)　PRFデーモンの起動」を参照してください。

スマートエージェントの起動

CTMを使用しない場合，この操作は不要です。

osagentコマンドでスマートエージェントを起動します。起動方法については，「付録D.2(3)　スマートエージェントの起動」を参照してください。

CTMドメインマネジャの起動

CTMを使用しない場合，この操作は不要です。

ctmdmstartコマンドでCTMドメインマネジャを起動します。起動方法については，「付録D.2(4)　CTMドメインマネジャの起動」を参照してください。

CORBAネーミングサービスの起動

J2EEサーバ用のCORBAネーミングサービスは，J2EEサーバ起動時にインプロセスで起動することを推奨します。

アウトプロセスでの起動方法については，「付録D.2(5)　CORBAネーミングサービスの起動」を参照してください。

CTMデーモンの起動

CTMを使用しない場合，この操作は不要です。

ctmstartコマンドでCTMデーモンを起動します。起動方法については，「付録D.2(6)　CTMデーモンの起動」を参照してください。

J2EEサーバの起動

cjstartsvコマンドでJ2EEサーバを起動します。起動方法については，「付録D.2(7)　J2EEサーバの起動」を参照してください。

リソースの開始

リソースを使用しない場合，この操作は不要です。

また，J2EEアプリケーションに含まれるリソースアダプタを利用する場合もこの操作は不要です。

サーバ管理コマンドでリソースを開始します。開始方法については，「付録D.2(8)　リソースの開始」を参照してください。

J2EEアプリケーションの開始

サーバ管理コマンドでJ2EEアプリケーションを開始します。なお，リソースアダプタを含んだJ2EEアプリケーションの場合，J2EEアプリケーションに含まれるすべてのリソースアダプタが同時に開始されます。開始方法については，「付録D.2(9)　J2EEアプリケーションの開始」を参照してください。

Webサーバの起動

起動方法については，ご使用のWebサーバのマニュアルを参照してください。

なお，Webサーバの起動のタイミングはシステムの運用形態に依存しますが，この順序で起動することでJ2EEアプリケーションへのリクエストの受け付けを制御できます。Webサーバ起動後，WebクライアントからのJ2EEアプリケーションへのリクエストの受け付けを開始します。開始方法については，「付録D.2(10)　Webサーバの起動」を参照してください。

(2)　統合ネーミングスケジューラサーバの起動の流れ

統合ネーミングスケジューラサーバの起動の流れを次の図に示します。

図D‒2　統合ネーミングスケジューラサーバの起動の流れ（UNIXの場合）

図中の1.〜6.について説明します。

システム起動時の環境変数の設定

環境変数を設定します。環境変数の設定方法については，「付録D.2(1)　システム起動時の環境変数の設定」を参照してください。

PRFデーモンの起動

cprfstartコマンドでPRFデーモンを起動します。起動方法については，「付録D.2(2)　PRFデーモンの起動」を参照してください。

スマートエージェントの起動

osagentコマンドでスマートエージェントを起動します。起動方法については，「付録D.2(3)　スマートエージェントの起動」を参照してください。

CTMドメインマネジャの起動

ctmdmstartコマンドでCTMドメインマネジャを起動します。起動方法については，「付録D.2(4)　CTMドメインマネジャの起動」を参照してください。

CORBAネーミングサービスの起動

CTM用のグローバルCORBAネーミングサービスを起動します。起動方法については，「付録D.2(5)　CORBAネーミングサービスの起動」を参照してください。

CTMデーモンの起動

ctmstartコマンドでCTMデーモンを起動します。起動方法については，「付録D.2(6)　CTMデーモンの起動」を参照してください。

付録D.2　システムの起動方法

ここでは，構成ソフトウェアの各プロセスの起動方法，リソースの開始方法，およびJ2EEアプリケーションの開始方法について説明します。

(1)　システム起動時の環境変数の設定

ここでは，アプリケーションサーバおよび統合ネーミングスケジューラサーバに設定する環境変数について説明します。

Cシェルの場合，setenvコマンドで次に示す環境変数を設定してください。

set path=( /opt/Cosminexus/jdk/bin /opt/Cosminexus/TPB/bin /bin $path)
setenv SHLIB_PATH "${SHLIB_PATH}:/opt/Cosminexus/TPB/lib:/opt/Cosminexus/PRF/lib:/opt/hitachi/common/lib"
setenv VBROKER_ADM /opt/Cosminexus/TPB/adm
setenv TPDIR /opt/Cosminexus/TPB
setenv PRFSPOOL /opt/Cosminexus/PRF/spool
setenv CTMDIR /opt/Cosminexus/CTM※
setenv CTMSPOOL /opt/Cosminexus/CTM/spool※
setenv TZ JST-9

注※

CTMを使用する場合に，アプリケーションサーバおよび統合ネーミングスケジューラサーバで設定が必要な環境変数です。

下線の部分は，OSごとに変数名が異なります。AIXの場合は「LIBPATH」，Linuxの場合は「LD_LIBRARY_PATH」となります。

CORBAネーミングサービスを手動起動する場合は，環境変数「PATH」の先頭に「/opt/Cosminexus/jdk/bin」を指定してください。

HiRDBまたはOracleを利用する場合には，それぞれのライブラリのパスを環境変数「LIBPATH」（AIXの場合），または「LD_LIBRARY_PATH」（Linuxの場合）に設定します。あらかじめ環境変数に設定している場合は，setenvコマンドの実行は不要です。

環境変数の内容については，「付録H　システムの環境変数」を参照してください。

(2)　PRFデーモンの起動

PRFデーモンの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/PRF/bin

cprfstartコマンドでPRFデーモンを起動します。

# cprfstart

(3)　スマートエージェントの起動

スマートエージェントの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/TPB/bin

osagentコマンドでスマートエージェントを起動します。

# osagent &

(4)　CTMドメインマネジャの起動

CTMドメインマネジャの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/CTM/bin

ctmdmstartコマンドでCTMドメインマネジャを起動します。

# ctmdmstart

(5)　CORBAネーミングサービスの起動

CORBAネーミングサービスの起動方法について説明します。

J2EEサーバ用のCORBAネーミングサービスは，J2EEサーバ起動時にインプロセスで起動することを推奨します。アウトプロセスで起動する場合は，nameservコマンドを使用して起動します。

ここでは，nameservコマンドでCORBAネーミングサービスをアウトプロセスで起動する方法について説明します。J2EEサーバの起動時にCORBAネーミングサービスをインプロセスで起動する方法については，「付録D.2(7)　J2EEサーバの起動」を参照してください。

なお，CORBAネーミングサービス起動時は次の点に留意してください。

CTMを使用する場合，J2EEサーバ用およびCTM用のCORBAネーミングサービスを起動します。CTM用にグローバルCORBAネーミングサービスをnameservコマンドで手動起動して，さらにJ2EEサーバ用のCORBAネーミングサービスをJ2EEサーバ起動時にインプロセスで自動起動してください。

nameservコマンドでCORBAネーミングサービスを手動起動する場合の手順を次に示します。

unsetenvコマンドで環境変数「CLASSPATH」を設定解除します。（Ｃシェルの場合）

# unsetenv CLASSPATH

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/TPB/bin

nameservコマンドでローカルCORBAネーミングサービスを手動開始します。

コマンドの実行には，root権限が必要です。

# nameserv -J-Dvbroker.agent.enableLocator=false
-J-Djava.security.policy==/opt/Cosminexus/CC/server/sysconf/cli.policy
-J-Dvbroker.se.iiop_tp.scm.iiop_tp.listener.port=<ポート番号> &

注意事項

CORBAネーミングサービスを手動起動する場合は，環境変数「PATH」の先頭に「/opt/Cosminexus/jdk/bin」を指定してください。

nameservコマンドで指定するオプションの値に空白を含むディレクトリが含まれる場合は，値全体をダブルクォーテーション（"）で囲むようにしてください。

nameservコマンドで指定する値は環境に合わせて変更してください。

CORBAネーミングサービスは，次のオプションで指定したポート番号で起動します。

-J-Dvbroker.se.iiop_tp.scm.iiop_tp.listener.port=<ポート番号>

(6)　CTMデーモンの起動

CTMデーモンの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/CTM/bin

ctmstartコマンドでCTMデーモンを起動します。

# ctmstart -CTMINSRef <ホスト名：ポート番号>

ホスト名およびポート番号にはグローバルCORBAネーミングサービスを起動しているホスト名およびポート番号を指定してください。

参考

CTMデーモンを開始するctmstartコマンドでは，コマンド実行時に次のファイルを指定できます。

CTMユーザ環境変数定義ファイル

-CTMEnvironオプションで指定するファイルです。CTMデーモンで管理するプロセスが使用する環境変数を指定したい場合は，このファイルに環境変数を記述します。

CTMコマンドオプションファイル

-CTMRegOptionで指定するファイルです。CTMレギュレータを自動開始するときのコマンドオプションを指定したい場合は，このファイルにコマンドオプションを記述します。

必要に応じて，これらのファイルを作成しておいてください。

(7)　J2EEサーバの起動

J2EEサーバの起動方法について説明します。

J2EEサーバ起動時に，次に示すプロセスをインプロセスで起動することを推奨します。

J2EEサーバ用のCORBAネーミングサービス

トランザクションサービス（トランザクションサービスを使用する場合）

なお，CTMを使用する場合，J2EEサーバ用のCORBAネーミングサービスはインプロセスで起動してください。

次に示す場合のJ2EEサーバの起動手順について(a)〜(d)で説明します。

標準システム構成でCORBAネーミングサービスをインプロセスで起動する場合

CTMを使用する構成でCORBAネーミングサービスおよびトランザクションサービスをインプロセスで起動する場合

標準システム構成でCORBAネーミングサービスをアウトプロセスで起動する場合

また，J2EEサーバ起動時は次の点に留意してください。

複数のJ2EEサーバで一つのネーミングサービスを共有する場合，J2EEサーバは一つずつ起動してください。複数のJ2EEサーバを同時に起動しようとするとJ2EEサーバの起動に失敗することがあります。

cjstartsvコマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

root権限を持たないユーザをComponent Container管理者に設定している場合，CORBAネーミングサービスを起動するときは，J2EEサーバ用のCORBAネーミングサービスのポート番号に1024以上の値を指定しておく必要があります。1024以上の値が指定されていない場合，エラーとなり，J2EEサーバは起動できません。

J2EEサーバ起動時にKDJE47500-Eというエラーメッセージが出力された場合，利用しようとしたCORBAネーミングサービスがすでに起動されているため，J2EEサーバの起動処理に失敗します。すでに起動しているCORBAネーミングサービスを停止して，J2EEサーバを起動してください。

(a)　標準システム構成でCORBAネーミングサービスをインプロセスで起動する場合

標準システム構成でCORBAネーミングサービスをインプロセスで起動する場合の，J2EEサーバの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/CC/server/bin

cjstartsvコマンドでJ2EEサーバを開始します。

コマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

# cjstartsv <サーバ名称>

(b)　CTMを使用する構成でCORBAネーミングサービスおよびトランザクションサービスをインプロセスで起動する場合

CTMを使用する構成で，J2EEサーバ用のCORBAネーミングサービス，およびトランザクションサービスをインプロセスで起動する場合の，J2EEサーバの起動手順について説明します。

なお，J2EEサーバ用のCORBAネーミングサービス，およびトランザクションサービスをインプロセスで起動する場合の前提を次に示します。

usrconf.propertiesファイルのejbserver.naming.portキーにJ2EEサーバ用のCORBAネーミングサービスのTCPポート番号が設定されている必要があります。

ejbserver.naming.port = <TCPポート番号>

J2EEサーバの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/CC/server/bin

cjstartsvコマンドでJ2EEサーバを開始します。

コマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

# cjstartsv <サーバ名称>

(c)　標準システム構成でCORBAネーミングサービスをアウトプロセスで起動する場合

標準システム構成で，J2EEサーバ用のCORBAネーミングサービスをアウトプロセスで起動する場合の，J2EEサーバの起動手順について説明します。

なお，J2EEサーバ用のCORBAネーミングサービスをアウトプロセスで起動する場合の前提を次に示します。

J2EEサーバ起動前に，J2EEサーバ用のCORBAネーミングサービスを起動しておく必要があります。CORBAネーミングサービスの手動起動の方法については，「付録D.2(5)　CORBAネーミングサービスの起動」を参照してください。

usrconf.propertiesファイルのejbserver.naming.startupModeキーに「manual」を設定しておく必要があります。

usrconf.propertiesファイルのejbserver.naming.portキーに設定するTCPポート番号が，同じホストで起動しているほかのCORBAネーミングサービスと同じ値にならないように注意してください。

J2EEサーバの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/CC/server/bin

cjstartsvコマンドでJ2EEサーバを開始します。

コマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

# cjstartsv <サーバ名称>

(8)　リソースの開始

リソースの開始方法について説明します。

リソースは，サーバ管理コマンド（cjstartrarコマンド，cjstartjbコマンド）を使用して開始します。

なお，開始するリソースは，あらかじめJ2EEリソースとして，J2EEサーバにデプロイされている必要があります。J2EEサーバへのリソースのデプロイも，サーバ管理コマンドで実行します。

J2EEアプリケーションに含まれるリソースアダプタを利用する場合，この操作は不要です。

詳細については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「6.　リソースアダプタ以外のJ2EEリソースの設定」

注意事項

Reliable Messagingを起動する場合，あらかじめDB Connector for Reliable Messagingを起動しておいてください。DB Connector for Reliable Messagingを起動しないでReliable Messagingを起動しようとするとエラーが発生します。

(9)　J2EEアプリケーションの開始

J2EEアプリケーションの開始方法について説明します。

J2EEアプリケーションは，サーバ管理コマンドを使用して開始します。なお，サーバ管理コマンドの実行には，root権限，またはComponent Container管理者の権限が必要です。

J2EEアプリケーションを開始する場合，サーバ管理コマンドのcjstartappコマンドを使用します。

開始するJ2EEアプリケーションは，あらかじめJ2EEアプリケーションとして，J2EEサーバにインポートされている必要があります。J2EEアプリケーションとは，アプリケーション開発環境で作成したJ2EEアプリケーションの構成要素であるEnterprise Bean（EJB-JAR）およびサーブレットとJSP（WAR）を一つにまとめたEARです。サーバ管理コマンドでは，J2EEアプリケーション単位に開始，停止を実行します。

J2EEサーバへのJ2EEアプリケーションのインポートも，サーバ管理コマンドで実行します。また，開発環境で作成したWARやEJB-JARを，サーバ管理コマンドを使用してJ2EEアプリケーションにすることもできます。

詳細については，次の個所を参照してください。

マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「4.1.29　業務アプリケーションを設定して開始する（CUI利用時）」

マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「8.1　J2EEアプリケーションのインポート」

(10)　Webサーバの起動

Webサーバの起動方法については，ご使用のWebサーバのマニュアルを参照してください。

なお，Webサーバの起動のタイミングはシステムの運用形態に依存しますが，この順序で起動することでJ2EEアプリケーションへのリクエストの受け付けを制御できます。Webサーバ起動後，WebクライアントからのJ2EEアプリケーションへのリクエストの受け付けを開始します。

付録D.3　システムの停止手順

ここでは，構成ソフトウェアの各プロセス，リソース，およびJ2EEアプリケーションの停止の手順について説明します。

(1)　システムの停止の流れ

システムの停止手順は，起動手順と逆の順序になります。データベース，LDAPディレクトリサーバ，EISなどを使用している場合は，必要に応じて最後に停止してください。

注意事項

システム構成によって，アプリケーションサーバだけを停止する場合と，アプリケーションサーバのほかに，統合ネーミングスケジューラサーバを停止する場合があります。

アプリケーションサーバのほかに，統合ネーミングスケジューラサーバを停止する場合，次の点に注意してください。

統合ネーミングスケジューラサーバの停止順序は任意です。

次に示す停止操作を基にシステムを停止してください。

Webサーバの停止

停止方法については，ご使用のWebサーバのマニュアルを参照してください。

なお，Webサーバの停止のタイミングについてはシステムの運用形態に依存しますが，最初に停止することでJ2EEアプリケーションへのリクエストの受け付けを制御できます。

J2EEアプリケーションの停止

サーバ管理コマンド（cjstopapp）でJ2EEアプリケーションを停止します。停止方法については，「付録D.4(2)　J2EEアプリケーションの停止」を参照してください。

なお，次回J2EEサーバの起動と同時にJ2EEアプリケーションを開始する場合は，J2EEアプリケーションの停止は不要です。

リソースの停止

J2EEリソースを使用しない場合，この操作は不要です。

サーバ管理コマンド（cjstoprar）でJ2EEリソースを停止します。停止方法については，「付録D.4(3)　リソースの停止」を参照してください。

なお，次回J2EEサーバ起動時にJ2EEリソースを開始する場合は，J2EEリソースの停止は不要です。

J2EEサーバの停止

cjstopsvコマンドでJ2EEサーバを停止します。停止方法については，「付録D.4(4)　J2EEサーバの停止」を参照してください。

CTMデーモンの停止

CTMを使用しない場合，この操作は不要です。

ctmstopコマンドでCTMデーモンを停止します。停止方法については，「付録D.4(5)　CTMデーモンの停止」を参照してください。

CORBAネーミングサービスの停止

CORBAネーミングサービスの起動方法によって，停止方法が異なります。停止方法については，「付録D.4(6)　CORBAネーミングサービスの停止」を参照してください。

CTMドメインマネジャの停止

CTMを使用しない場合，この操作は不要です。

ctmdmstopコマンドでCTMドメインマネジャを停止します。停止方法については，「付録D.4(7)　CTMドメインマネジャの停止」を参照してください。

スマートエージェントの停止

スマートエージェントを起動していない場合，この操作は不要です。

停止方法については，「付録D.4(8)　スマートエージェントの停止」を参照してください。

PRFデーモンの停止

cprfstopコマンドでPRFデーモンを停止します。停止方法については，「付録D.4(9)　PRFデーモンの停止」を参照してください。

付録D.4　システムの停止方法

ここでは，構成ソフトウェアの各プロセスの停止方法，リソースの停止方法，およびJ2EEアプリケーションの停止方法について説明します。

(1)　Webサーバの停止

Webサーバの停止方法については，ご使用のWebサーバのマニュアルを参照してください。

なお，Webサーバの停止のタイミングについてはシステムの運用形態に依存しますが，最初に停止することでJ2EEアプリケーションへのリクエストの受け付けを制御できます。

(2)　J2EEアプリケーションの停止

J2EEアプリケーションの停止方法について説明します。

J2EEアプリケーションは，サーバ管理コマンドを使用して停止します。

J2EEアプリケーションを停止する場合，サーバ管理コマンド（cjstopapp）を使用します。

なお，サーバ管理コマンドの実行には，root権限またはComponent Container管理者の権限が必要です。

J2EEアプリケーションを停止しても，J2EEアプリケーション内のリクエスト処理が終了しないなどの原因で停止処理が完了しない場合があります。この場合，J2EEアプリケーションを強制的に停止する必要があります。J2EEアプリケーションを強制停止する場合，cjstopappコマンドに-forceオプションを指定して実行します。

J2EEアプリケーションを停止するための具体的な手順については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「10.2.2　J2EEアプリケーションの停止」を参照してください。

(3)　リソースの停止

リソースの停止方法について説明します。

リソースの停止は，サーバ管理コマンド（cjstoprar，cjstopjb）を使用します。

なお，サーバ管理コマンドの実行には，root権限またはComponent Container管理者の権限が必要です。

J2EEアプリケーションに含まれるリソースアダプタを利用する場合，この操作は不要です。

注意事項

DB Connector for Reliable Messagingを停止する場合，あらかじめReliable Messagingを停止しておいてください。Reliable Messagingを停止しないでDB Connector for Reliable Messagingを停止しようとするとエラーが発生します。

別名を定義したJ2EEリソースは，J2EEサーバで開始されているJ2EEアプリケーションがある場合は停止できません。停止しようとするとメッセージが出力されて処理が失敗します。別名を定義したJ2EEリソースは，J2EEサーバで開始されているすべてのJ2EEアプリケーションを停止してから停止してください。

(4)　J2EEサーバの停止

J2EEサーバの停止の手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/CC/server/bin

cjstopsvコマンドでJ2EEサーバを停止します。

コマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）必要です。

# cjstopsv <サーバ名称>

cjstopsvコマンドの実行例を次に示します。この例では，サーバ名は「MyServer」です。

# cd /opt/Cosminexus/CC/server/bin
# cjstopsv MyServer
#

なお，J2EEサーバを停止しても，J2EEサーバでの処理が終了しないなどの原因で停止処理が完了しない場合があります。この場合，J2EEサーバを強制的に停止する必要があります。J2EEサーバを強制停止する場合，cjstopsvコマンドに-fオプションまたは-fdオプションを指定して実行します。-fdオプションを指定すると，J2EEサーバの障害情報を取得したあと，J2EEサーバを強制停止します。

注意事項

CORBAネーミングサービスを自動起動している場合は，J2EEサーバ停止時にCORBAネーミングサービスも自動停止されます。

(5)　CTMデーモンの停止

CTMデーモンの停止手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/CTM/bin

ctmstopコマンドでCTMデーモンを停止します。

# ctmstop

なお，CTMデーモンを停止しても，CTMデーモンの停止処理が完了しない場合があります。この場合，CTMデーモンを強制的に停止する必要があります。CTMデーモンを強制停止する場合，ctmstopコマンドに-CTMForceオプションを指定して実行します。

(6)　CORBAネーミングサービスの停止

CORBAネーミングサービスの停止手順は，CORBAネーミングサービスの起動方法によって異なります。

J2EEサーバ起動時にインプロセスで起動している場合

J2EEサーバ停止時にCORBAネーミングサービスも自動停止します。

フォアグラウンドで手動起動している場合

Ctrl+Cキーで停止します。

バックグラウンドで手動起動している場合

CORBAネーミングサービスのプロセスIDを特定して，killコマンドで停止します。

次に，バックグラウンドで手動起動している場合の停止手順の詳細について説明します。

バックグラウンドで手動起動している場合，ほかのJavaプロセスと区別がつかなくなり，どれがCORBAネーミングサービスなのかわからなくなることがあります。このため，ほかに起動しているJavaプロセスの有無によってCORBAネーミングサービスのプロセスIDの取得方法が異なります。なお，AIXの場合は，ps -efコマンドを実行するとプロセスの引数が他プラットフォームよりも長めに表示されるため，CORBAネーミングサービスを識別できます。

ほかに起動しているJavaプロセスがないとき

CORBAネーミングサービスのプロセスIDを取得します。

# ps -ef | grep java

取得したプロセスIDを指定して，CORBAネーミングサービスを停止します。

# kill <CORBAネーミングサービスのプロセスID>

ほかに起動しているJavaプロセスがあるとき

CORBAネーミングサービスのプロセスIDを取得します。

CORBAネーミングサービスの起動用シェルスクリプトを使用すると，カレントワーキングディレクトリに生成されるnamesv_pidファイルにCORBAネーミングサービスのプロセスIDを出力できます。

CORBAネーミングサービスの起動用シェルスクリプトの例を次に示します。

#!/bin/sh
export VBROKER_ADM=/opt/Cosminexus/TPB/adm
export SHLIB_PATH="${SHLIB_PATH}:/opt/Cosminexus/TPB/lib"

# start name server process
exec /opt/Cosminexus/TPB/bin/nameserv ¥
-J-Dvbroker.agent.enableLocator=false ¥
-J-Djava.security.policy==/opt/Cosminexus/CC/server/sysconf/cli.policy ¥
-J-Dvbroker.se.iiop_tp.scm.iiop_tp.listener.port=900 &

# save background java process pid
echo $! > ./namesv_pid

なお，下線の部分は，OSごとに変数名が異なります。AIXの場合は「LIBPATH」，Linuxの場合は「LD_LIBRARY_PATH」となります。

取得したプロセスIDを指定して，CORBAネーミングサービスを停止します。

# kill `cat namesv_pid`

(7)　CTMドメインマネジャの停止

CTMドメインマネジャの停止手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/CTM/bin

ctmdmstopコマンドでCTMドメインマネジャを停止します。

# ctmdmstop

なお，CTMドメインマネジャを停止しても，CTMドメインマネジャの停止処理が完了しない場合があります。この場合，CTMドメインマネジャを強制的に停止する必要があります。CTMドメインマネジャを強制停止する場合，ctmdmstopコマンドに-CTMForceオプションを指定して実行します。

(8)　スマートエージェントの停止

スマートエージェントの停止手順を次に示します。

スマートエージェントの停止方法は，起動方法によって異なります。

フォアグラウンドで手動起動している場合

Ctrl+Cキーで停止します。

バックグラウンドで手動起動している場合

次の手順でスマートエージェントを停止します。

スマートエージェントのプロセスIDを取得します。

# ps -ef | grep osagent

取得したプロセスIDを指定して，スマートエージェントを停止します。

# kill <スマートエージェントのプロセスID>

(9)　PRFデーモンの停止

PRFデーモンの停止手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/PRF/bin

cprfstopコマンドでPRFデーモンを停止します。

# cprfstop

なお，PRFデーモンを停止しても，PRFデーモンの停止処理が完了しない場合があります。この場合，PRFデーモンを強制的に停止する必要があります。PRFデーモンを強制停止する場合，cprfstopコマンドに-Forceオプションを指定して実行します。

付録E　バッチアプリケーションを実行するシステムの構築と削除

ここでは，バッチアプリケーションを実行するシステムを，ファイル編集とコマンド実行で構築，および削除する手順について説明します。

付録E.1　システム構築の流れ

バッチアプリケーションを実行するシステムをファイル編集とコマンド実行で構築する場合，アプリケーションサーバが提供するコマンド，ユーザ定義ファイルなどを使用してシステムの動作環境を設定します。

(1)　システムの構築で使用するファイル

バッチアプリケーションを実行するシステムを構築する場合に使用する主なファイルを次に示します。各ファイルの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「3.　バッチサーバで使用するファイル」を参照してください。

注意事項

ファイルを変更する場合は，バッチサーバを停止してください。バッチサーバの稼働中にファイルの内容を変更した場合の動作は保証されません。

usrconf.properties（バッチサーバ用ユーザプロパティファイル）

バッチサーバのユーザプロパティを指定するファイルです。バッチサーバが使用するネーミングサービス，コネクション，コンテナ，ログ，セキュリティ，CTMの使用などを指定します。

ファイルの格納場所を次に示します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥usrconf.properties

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/usrconf.properties

usrconf.cfg（バッチサーバ用オプション定義ファイル）

バッチサーバのJavaVMの起動オプションを指定するファイルです。

ファイルの格納場所を次に示します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥usrconf.cfg

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/usrconf.cfg

server.policy（バッチサーバ用セキュリティポリシーファイル）

バッチサーバを実行するJavaVMのセキュリティポリシーを指定するファイルです。

ファイルの格納場所を次に示します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥server.policy

UNIXの場合

/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/server.policy

(2)　バッチアプリケーションを実行するシステムを構築する流れ

ファイル編集とコマンド実行で，バッチアプリケーションを実行するシステムを構築する場合の，システム構築の流れについて説明します。

バッチサーバをセットアップします。

詳細については，「付録E.2　バッチサーバのセットアップ」を参照してください。

バッチサーバの動作設定をします。

使用する機能の動作を変更したり，特定の機能を使用したりする場合には，アプリケーションサーバが提供するユーザ定義ファイルやコマンドを使用して，バッチサーバの動作を設定，変更します。ただし，トランザクションは必ずローカルトランザクションに設定してください。

バッチサーバの動作を設定，変更できる機能の例を次に示します。

ネーミングサービス

JavaVMの起動オプション

コンテナ拡張ライブラリ

アプリケーションサーバが提供する主な機能の設定内容については，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「2.3.10　実行環境での設定（バッチサーバの設定）」を参照してください。

ジョブスケジューリング機能を使用する場合の設定をします。

バッチアプリケーションの実行をスケジューリングする場合にだけ必要な設定です。スケジューリング機能はCTMを使用します。CTMを使用するための動作設定は次のファイルで指定します。

usrconf.properties（バッチサーバ用ユーザプロパティファイル）のejbserver.ctm.enabledプロパティ

詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「3.2.2　usrconf.properties（バッチサーバ用ユーザプロパティファイル）」を参照してください。

バッチアプリケーションで使用するコマンド（cjexecjob，cjkilljob，cjlistjob）のusrconf.cfg（バッチアプリケーション用オプション定義ファイル）のbatch.ctm.enabledオプション

詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「3.2.5　usrconf.cfg（バッチアプリケーション用オプション定義ファイル）」を参照してください。

トラブルシューティングの資料取得の設定をします。

デフォルトの設定のままで利用する場合は，設定不要です。ただし，次の資料は，事前に取得のための設定をしておかないと，取得できません。これらの資料はトラブルシューティングで必要となるため，取得することをお勧めします。

OSの統計情報，ユーザダンプ（Windowsの場合）またはcoreダンプ（UNIXの場合）

JavaVMのGCのログ

これらの資料を取得する場合や，ほかの資料の取得設定を変更したい場合に，トラブルシューティングの資料取得の設定をしてください。トラブルシューティングに必要な資料の詳細と，システム構築時の設定の要否については「付録E.1(3)　トラブルシューティングに必要な資料」を参照してください。

リソースの設定をします。

サーバ管理コマンドを使用して，リソースアダプタのプロパティを定義し，バッチサーバにインポートします。設定方法の詳細については，マニュアル「アプリケーションサーバ 機能解説 拡張編」の「2.7.6　リソースアダプタの設定の流れ」を参照してください。

システムを起動して，システムの動作を確認します。

システムの起動および停止については，「付録F　バッチアプリケーションを実行するシステムの起動と停止（Windowsの場合）」，または「付録G　バッチアプリケーションを実行するシステムの起動と停止（UNIXの場合）」を参照してください。

(3)　トラブルシューティングに必要な資料

トラブルシューティングに必要な資料と，システム構築時の設定の要否について次の表に示します。なお，設定方法の詳細については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「3.　トラブルシューティングのための準備」を参照してください。

表E‒1　トラブルシューティングの資料の種類と設定要否（バッチアプリケーションを実行するシステムの場合）

資料の種類

設定の要否

snapshotログ

△※1

性能解析トレースファイル

×※2

バッチサーバのログ

△

アプリケーションのユーザログ

○

稼働情報ファイル

△

リソースアダプタのログ

△

TPBrokerのトレースファイル

△

OSの統計情報

○

ユーザダンプ

○

coreダンプ

○

JavaVMの資料

○

サーバ管理コマンドのログ

△

（凡例）

○：資料を取得する場合には，設定が必要。

△：デフォルトの資料取得の設定を変更する場合だけ，設定が必要。

×：設定は不要。

注※1

snapshotlogコマンドを使用してsnapshotログを取得します。この場合，あらかじめ設定しておいたリストファイルを，コマンド実行時に引数として指定します。snapshotlogコマンド，およびデフォルトの設定で収集できるsnapshotログについては，「11.2　ログの運用で使用するコマンドの詳細」の「snapshotlog（snapshotログの収集）」を参照してください。なお，snapshotログの収集先を変更する場合には，snapshotログ収集対象定義ファイルを編集します。snapshotログ収集対象定義ファイルについては，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「10.2.1　snapshotログ収集対象定義ファイル」を参照してください。

注※2

日常的なシステム運用の作業で，cprfstartコマンドを実行してパフォーマンストレーサを起動する場合，PRFトレースの取得レベルやファイルの面数を指定できます。性能解析トレースファイルの取得については，マニュアル「アプリケーションサーバ 機能解説保守／移行編」の「7.3.1　性能解析トレースファイルの収集方法」を参照してください。

表E-1に示したログは，snapshotログで一括収集できます。ただし，TPBrokerのトレースファイルについては，収集できるものと収集できないものが混在しています。このほかにも，snapshotログのデフォルトの設定で取得できないログについては，取得のための設定をしたり，snapshotログの収集先に追加したりする必要があります。

なお，次のログはログ出力先を変更できません。

セットアップ時に作成されるinstall.log，移行コマンドなどのログファイル

次のディレクトリに出力されるJavaのスレッドダンプファイル

Windowsの場合

<作業ディレクトリ>¥ejb¥<サーバ名称>

UNIXの場合

<作業ディレクトリ>/ejb/<サーバ名称>

ログの種類やデフォルト値，チャネル名，取得できるログの詳細や取得方法については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「2.4　取得が必要な資料の種類」を参照してください。

付録E.2　バッチサーバのセットアップ

アプリケーションサーバのシステムを構成するバッチサーバのセットアップについて説明します。

デフォルトの設定では，バッチサーバ名はホスト名です。また，同じホスト内で複数のバッチサーバを起動する場合には，それぞれのバッチサーバに別のサーバ名を割り当ててください。サーバ名を割り当てるときの注意事項については，「付録E.2(4)　複数のバッチサーバを起動する場合の注意事項」を参照してください。

バッチサーバのセットアップの手順について説明します。セットアップに関する注意事項については，「付録E.2(3)　セットアップに関する注意事項」を参照して，必要に応じて対応してください。

(1)　Windowsの場合

Windowsの場合のバッチサーバのセットアップ手順を次に示します。

次のコマンドでカレントディレクトリを移動します。

"cd <Application Serverのインストールディレクトリ>¥CC¥server¥bin"

cjsetupコマンドでバッチサーバをセットアップします。

"cjsetup -batch <サーバ名>"

バッチサーバのセットアップの例を次に示します。この例では，Application Serverのインストールディレクトリは「C:¥Program Files¥Hitachi¥Cosminexus」，サーバ名は「MyServer」です。

C:¥>cd C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin>cjsetup -batch MyServer

(2)　UNIXの場合

UNIXの場合のバッチサーバのセットアップ手順を次に示します。

cjsetupコマンドでバッチサーバをセットアップします。コマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

/opt/Cosminexus/CC/server/bin/cjsetup -batch <サーバ名>

バッチサーバのセットアップの例を次に示します。この例では，サーバ名は「MyServer」です。

/opt/Cosminexus/CC/server/bin/cjsetup -batch MyServer

(3)　セットアップに関する注意事項

バッチサーバのセットアップは，1回だけ行ってください。セットアップ済みのバッチサーバを指定するとエラーメッセージが出力されます。

バッチサーバをセットアップして，バッチサーバをカスタマイズしない場合，バッチサーバはホスト名「localhost」，ポート番号「900」のCORBAネーミングサービスをインプロセスで自動起動して使用します。使用するCORBAネーミングサービスを変更する場合は，usrconf.propertiesのejbserver.naming.hostキーとejbserver.naming.portキーで変更してください。

バッチサーバを開始する前に，環境変数「OSAGENT_PORT」の値とusrconf.propertiesのvbroker.agent.portキーの値が一致しているかどうかを確認してください。

サーバ名称に使用できる文字については，cjsetupコマンドの説明を参照してください。cjsetupコマンドについては，「3.2　バッチサーバを操作するコマンド」を参照してください。

サーバ名称は，作業ディレクトリ中のディレクトリ名として用いられます。作業ディレクトリ下のパス長がプラットフォームの上限に達しないようにサーバ名称を指定してください。作業ディレクトリのパス長の見積もりについては，マニュアル「アプリケーションサーバシステム構築・運用ガイド」の「付録C.2　バッチサーバの作業ディレクトリ」を参照してください。

(4)　複数のバッチサーバを起動する場合の注意事項

バッチサーバはサーバ名称によって識別されます。インストールされたホストのホスト名がデフォルトのサーバ名称として設定されます。このため，同じホスト内で複数のバッチサーバを起動する場合，それぞれのバッチサーバにサーバ名称を割り当て，バッチサーバをセットアップします。

バッチサーバにサーバ名称を割り当てる場合，同じホスト内では，同じサーバ名称のバッチサーバを複数回セットアップしてはいけません。同じサーバ名称で再セットアップすると，エラーになります。

バッチサーバと接続するCORBAネーミングサービスのホスト名およびポート番号に関する注意事項を次に示します。

ホスト名およびポート番号の設定

同一ホストで複数のバッチサーバを同時に起動する場合，CORBAネーミングサービスとの接続に使用するホスト名およびポート番号が両方とも重ならないようにしてください。ホスト名およびポート番号は，usrconf.propertiesで設定します。

また，usrconf.propertiesのwebserver.connector.ajp13.portキーおよびejbserver.http.portキーで設定されているポート番号には，同時に起動するバッチサーバ間で異なる値を使用するように設定してください。

付録E.3　システムの削除の流れ

バッチアプリケーションを実行するシステムをファイル編集とコマンド実行で削除する場合，アプリケーションサーバが提供するコマンドを使用して，バッチサーバをアンセットアップし，システムを削除します。

ファイル編集とコマンド実行で，バッチアプリケーションを実行するシステムを削除する場合の流れについて説明します。

システムを停止します。

システムの停止手順および停止方法については，「付録F　バッチアプリケーションを実行するシステムの起動と停止（Windowsの場合）」，または「付録G　バッチアプリケーションを実行するシステムの起動と停止（UNIXの場合）」を参照してください。

バッチサーバをアンセットアップします。

詳細については，「付録E.4　バッチサーバのアンセットアップ」を参照してください。

付録E.4　バッチサーバのアンセットアップ

アプリケーションサーバのシステムを構成するバッチサーバのアンセットアップについて説明します。バッチサーバのアンセットアップの手順について，OSごとに説明します。

(1)　Windowsの場合

Windowsの場合のバッチサーバのアンセットアップ手順を次に示します。

次のコマンドでカレントディレクトリを移動します。

"cd <Application Serverのインストールディレクトリ>¥CC¥server¥bin"

cjsetupコマンドで引数に-dを指定して，バッチサーバをアンセットアップします。

"cjsetup -d <サーバ名>"

バッチサーバのアンセットアップの例を次に示します。この例では，Application Serverのインストールディレクトリは「C:¥Program Files¥Hitachi¥Cosminexus」，サーバ名は「MyServer」です。

C:¥>cd C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin
C:¥Program Files¥Hitachi¥Cosminexus¥CC¥server¥bin>cjsetup -d MyServer

(2)　UNIXの場合

UNIXの場合のバッチサーバのアンセットアップ手順を次に示します。

cjsetupコマンドで引数に-dを指定して，バッチサーバをアンセットアップします。コマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

/opt/Cosminexus/CC/server/bin/cjsetup -d <サーバ名>

バッチサーバのアンセットアップの例を次に示します。この例では，サーバ名は「MyServer」です。

/opt/Cosminexus/CC/server/bin/cjsetup -d MyServer

付録F　バッチアプリケーションを実行するシステムの起動と停止（Windowsの場合）

ここでは，バッチアプリケーションを実行するシステムの起動と停止の手順について説明します。

付録F.1　システムの起動手順

システムの起動手順について説明します。

なお，データベースは起動済みであることを前提に説明します。データベースを使用している場合は，必要に応じてあらかじめ起動しておいてください。

(1)　アプリケーションサーバの起動の流れ

システムで使用するアプリケーションサーバの起動の流れについて説明します。

アプリケーションサーバの起動の流れを次の図に示します。

図F‒1　アプリケーションサーバの起動の流れ（Windowsの場合）

図中の1.〜9について説明します。

環境変数の設定

環境変数を設定します。環境変数の設定方法については，「付録C.2(1)　システム起動時の環境変数の設定」を参照してください。

PRFデーモンの起動

cprfstartコマンドでPRFデーモンを起動します。起動方法については，「付録C.2(2)　PRFデーモンの起動」を参照してください。

スマートエージェントの起動

CTMを使用しない場合，この操作は不要です。

osagentコマンドでスマートエージェントを起動します。起動方法については，「付録C.2(3)　スマートエージェントの起動」を参照してください。

CTMドメインマネジャの起動

CTMを使用しない場合，この操作は不要です。

ctmdmstartコマンドでCTMドメインマネジャを起動します。起動方法については，「付録C.2(4)　CTMドメインマネジャの起動」を参照してください。

CORBAネーミングサービスの起動

CTMを使用しない場合，この操作は不要です。

CTMを使用する場合，nameservコマンドでCTM用のCORBAネーミングを起動します。起動方法については，「付録C.2(5)　CORBAネーミングサービスの起動」を参照してください。

CTMデーモンの起動

CTMを使用しない場合，この操作は不要です。

ctmstartコマンドでCTMデーモンを起動します。起動方法については，「付録C.2(6)　CTMデーモンの起動」を参照してください。

バッチサーバの起動

cjstartsvコマンドでバッチサーバを起動します。起動方法については，「付録F.2(1)　バッチサーバの起動」を参照してください。

リソースの開始

リソースを使用しない場合，この操作は不要です。

サーバ管理コマンド（cjstartrar）でリソースを開始します。開始方法については，「付録C.2(8)　リソースの開始」を参照してください。

バッチアプリケーションの実行

cjexecjobコマンドでバッチアプリケーションを実行します。

実行方法については，「付録F.2(2)　バッチアプリケーションの実行」を参照してください。

付録F.2　システムの起動方法

ここでは，バッチサーバの起動方法，およびバッチアプリケーションの実行方法について説明します。

(1)　バッチサーバの起動

バッチサーバの起動方法について説明します。

標準システム構成でCORBAネーミングサービスをインプロセスで起動する場合の，バッチサーバの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Application Serverのインストールディレクトリ>¥CC¥server¥bin"

cjstartsvコマンドでバッチサーバを開始します。

コマンドの実行には，Administrator権限が必要です。

cjstartsv <サーバ名称> -nosecurity

(2)　バッチアプリケーションの実行

バッチアプリケーションの実行方法について説明します。

バッチアプリケーションは，cjexecjobコマンドを使用して実行します。なお，cjexecjobコマンドの実行には，Administrator権限が必要です。Windowsの場合，管理者特権でコマンドを実行してください。

バッチアプリケーションの実行手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Application Serverのインストールディレクトリ>¥CC¥batch¥bin"

cjexecjobコマンドでバッチアプリケーションを実行します。

コマンドの実行には，Administrator権限が必要です。

バッチアプリケーションがジョブスケジューリング機能を使用する場合と使用しない場合とでは接続サーバの指定方法が異なります。

ジョブスケジューリング機能を使用しない場合

ジョブの実行ができるバッチサーバを指定します。

cjexecjob <サーバ名称> <Javaアプリケーションクラス名>

ジョブスケジューリング機能を使用する場合

ジョブスケジューリングのグループを指定します。

cjexecjob [<スケジュールグループ名>] [-jobID <ジョブID>] <Javaアプリケーションクラス名>

付録F.3　システムの停止手順

ここでは，バッチアプリケーション，およびバッチサーバなどの停止の手順について説明します。

(1)　システムの停止の流れ

システムの停止手順は，起動手順と逆の順序になります。データベースを使用している場合は，必要に応じて最後に停止してください。

次に示す順にシステムを停止してください。

バッチアプリケーションの停止

バッチアプリケーションが停止していない場合に，cjkilljobコマンドでバッチアプリケーションを停止します。停止の方法については，「付録F.4(1)　バッチアプリケーションの停止」を参照してください。

リソースの停止

リソースを使用していない場合，この操作は不要です。

サーバ管理コマンド（cjstoprar）でリソースを停止します。停止方法については，「付録C.4(3)　リソースの停止」を参照してください。

バッチサーバの停止

cjstopsvコマンドでバッチサーバを停止します。停止方法については，「付録F.4(2)　バッチサーバの停止」を参照してください。

CTMデーモンの停止

CTMを使用しない場合，この操作は不要です。

ctmstopコマンドでCTMデーモンを停止します。停止方法については，「付録C.4(5)　CTMデーモンの停止」を参照してください。

CORBAネーミングサービスの停止

Ctrl＋CでCORBAネーミングサービスを停止します。

CTMドメインマネジャの停止

CTMを使用しない場合，この操作は不要です。

ctmdmstopコマンドでCTMドメインを停止します。停止方法については，「付録C.4(7)　CTMドメインマネジャの停止」を参照してください。

スマートエージェントの停止

スマートエージェントのアイコンを右クリックしてExitを選択してスマートエージェントを停止します。

PRFデーモンの停止

cprfstopコマンドでPRFデーモンを停止します。停止方法については，「付録C.4(9)　PRFデーモンの停止」を参照してください。

付録F.4　システムの停止方法

ここでは，バッチアプリケーションおよびバッチサーバの停止の方法について説明します。

(1)　バッチアプリケーションの停止

バッチアプリケーションの停止の方法について説明します。

バッチアプリケーションが停止していない場合に，cjkilljobコマンドを使用してバッチアプリケーションを停止します。なお，cjkilljobコマンドの実行には，Administrator権限が必要です。Windowsの場合，管理者特権でコマンドを実行してください。

cjkilljobコマンドは，メソッドキャンセルまたはCTMによりバッチアプリケーションを停止します。停止に失敗した場合は，バッチサーバを強制停止します。

バッチアプリケーションの停止手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Application Serverのインストールディレクトリ>¥CC¥batch¥bin"

cjkilljobコマンドでバッチサーバを停止します。

コマンドの実行には，Administrator権限が必要です。

バッチアプリケーションの停止には，サーバ名称を指定する場合とジョブIDを指定する場合があります。

サーバ名称を指定する場合

メソッドキャンセルによってバッチアプリケーションを停止します。

cjkilljob <サーバ名称>

ジョブIDを指定する場合

CTMによってバッチアプリケーションを停止します。

ジョブスケジューリング機能を使用している場合にだけ使用できます。

cjkilljob -jobID <ジョブID>

(2)　バッチサーバの停止

バッチサーバの停止の手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Application Serverのインストールディレクトリ>¥CC¥server¥bin"

cjstopsvコマンドでバッチサーバを停止します。

コマンドの実行には，Administrator権限が必要です。

cjstopsv <サーバ名称>

cjstopsvコマンドの実行例を次に示します。この例では，Application Serverのインストールディレクトリは「C:¥Program Files¥Hitachi¥Cosminexus」，サーバ名は「MyServer」です。

C:¥>cd "C:¥Program Files¥HITACHI¥Cosminexus¥CC¥server¥bin"
C:¥Program Files¥HITACHI¥Cosminexus¥CC¥server¥bin>cjstopsv MyServer
C:¥Program Files¥HITACHI¥Cosminexus¥CC¥server¥bin>

なお，バッチサーバでの処理が終了しないなどの原因で，バッチサーバの停止処理が完了しない場合があります。この場合，バッチサーバを強制的に停止する必要があります。バッチサーバを強制停止する場合，cjstopsvコマンドに-fオプションまたは-fdオプションを指定して実行します。-fdオプションを指定すると，バッチサーバの障害情報を取得したあと，バッチサーバを強制停止します。

付録G　バッチアプリケーションを実行するシステムの起動と停止（UNIXの場合）

ここでは，バッチアプリケーションを実行するシステムの起動と停止の手順について説明します。

付録G.1　システムの起動手順

システムの起動手順について説明します。

なお，データベースは起動済みであることを前提に説明します。データベースを使用している場合は，必要に応じてあらかじめ起動しておいてください。

(1)　アプリケーションサーバの起動の流れ

システムで使用するアプリケーションサーバの起動の流れについて説明します。

アプリケーションサーバの起動の流れを次の図に示します。

図G‒1　アプリケーションサーバの起動の流れ（UNIXの場合）

図中の1.〜9.について説明します。

環境変数の設定

環境変数を設定します。環境変数の設定方法については，「付録D.2(1)　システム起動時の環境変数の設定」を参照してください。

PRFデーモンの起動

cprfstartコマンドでPRFデーモンを起動します。起動方法については，「付録D.2(2)　PRFデーモンの起動」を参照してください。

スマートエージェントの起動

CTMを使用しない場合，この操作は不要です。

osagentコマンドでスマートエージェントを起動します。起動方法については，「付録D.2(3)　スマートエージェントの起動」を参照してください。

CTMドメインマネジャの起動

CTMを使用しない場合，この操作は不要です。

ctmdmstartコマンドでCTMドメインマネジャを起動します。起動方法については，「付録D.2(4)　CTMドメインマネジャの起動」を参照してください。

CORBAネーミングサービスの起動

CTMを使用しない場合，この操作は不要です。

CTMを使用する場合，nameservコマンドでCTM用のCORBAネーミングを起動します。起動方法については，「付録D.2(5)　CORBAネーミングサービスの起動」を参照してください。

CTMデーモンの起動

CTMを使用しない場合，この操作は不要です。

ctmstartコマンドでCTMデーモンを起動します。起動方法については，「付録D.2(6)　CTMデーモンの起動」を参照してください。

バッチサーバの起動

cjstartsvコマンドでバッチサーバを起動します。起動方法については，「付録G.2(1)　バッチサーバの起動」を参照してください。

リソースの開始

リソースを使用しない場合，この操作は不要です。

サーバ管理コマンドでリソースを開始します。開始方法については，「付録D.2(8)　リソースの開始」を参照してください。

バッチアプリケーションの実行

cjexecjobコマンドでバッチアプリケーションを開始します。開始方法については，「付録G.2(2)　バッチアプリケーションの実行」を参照してください。

付録G.2　システムの起動方法

ここでは，バッチサーバの起動方法，およびバッチアプリケーションの実行方法について説明します。

(1)　バッチサーバの起動

バッチサーバの起動方法について説明します。

バッチサーバ起動時は次の点に留意してください。

cjstartsvコマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

root権限を持たないユーザをComponent Container管理者に設定している場合，CORBAネーミングサービスを起動するときは，バッチサーバ用のCORBAネーミングサービスのポート番号に1024以上の値を指定しておく必要があります。1024以上の値が指定されていない場合，エラーとなり，バッチサーバは起動できません。

バッチサーバ起動時にKDJE47500-Eというエラーメッセージが出力された場合，利用しようとしたCORBAネーミングサービスがすでに起動されているため，バッチサーバの起動処理に失敗します。すでに起動しているCORBAネーミングサービスを停止して，バッチサーバを起動してください。

標準システム構成でCORBAネーミングサービスをインプロセスで起動する場合の，バッチサーバの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/CC/server/bin

cjstartsvコマンドでバッチサーバを開始します。

コマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

# cjstartsv <サーバ名称> -nosecurity

(2)　バッチアプリケーションの実行

バッチアプリケーションの実行方法について説明します。

バッチアプリケーションは，サーバ管理コマンドを使用して実行します。なお，サーバ管理コマンドの実行には，root権限またはComponent Container管理者の権限が必要です。

バッチアプリケーションの実行手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd /opt/Cosminexus/CC/batch/bin/cjexecjob

cjexecjobコマンドでバッチアプリケーションを実行します。

コマンドの実行には，root権限またはComponent Container管理者の権限が必要です。

バッチアプリケーションがジョブスケジューリング機能を使用する場合と使用しない場合とでは接続サーバの指定方法が異なります。

ジョブスケジューリング機能を使用しない場合

ジョブの実行ができるバッチサーバを指定します。

cjexecjob.exe <サーバ名称> <Javaアプリケーションクラス名>

ジョブスケジューリング機能を使用する場合

ジョブスケジューリングのグループを指定します。

cjexecjob [<スケジュールグループ名>] [-jobID <ジョブID>] <Javaアプリケーションクラス名>

付録G.3　システムの停止手順

ここでは，バッチアプリケーション，およびバッチサーバなどの停止の手順について説明します。

(1)　システムの停止の流れ

システムの停止手順は，起動手順と逆の順序になります。データベースを使用している場合は，必要に応じて最後に停止してください。

次に示す順にシステムを停止してください。

バッチアプリケーションの停止

バッチアプリケーションが停止していない場合に，cjkilljobコマンドでバッチアプリケーションを停止します。停止方法については，「付録G.4(1)　バッチアプリケーションの停止」を参照してください。

リソースの停止

リソースを使用していない場合，この操作は不要です。

サーバ管理コマンド（cjstoprar）でリソースを停止します。停止方法については，「付録D.4(3)　リソースの停止」を参照してください。

バッチサーバの停止

cjstopsvコマンドでバッチサーバを停止します。停止方法については，「付録G.4(2)　バッチサーバの停止」を参照してください。

CTMデーモンの停止

CTMを使用しない場合，この操作は不要です。

ctmstopコマンドでCTMデーモンを停止します。停止方法については，「付録D.4(5)　CTMデーモンの停止」を参照してください。

CORBAネーミングサービスの停止

Ctrl＋CでCORBAネーミングサービスを停止します。

CTMドメインマネジャの停止

CTMを使用しない場合，この操作は不要です。

ctmdmstopコマンドでCTMドメインを停止します。停止方法については，「付録D.4(7)　CTMドメインマネジャの停止」を参照してください。

スマートエージェントの停止

Ctrl＋Cでスマートエージェントを停止します。

PRFデーモンの停止

cprfstopコマンドでPRFデーモンを停止します。停止方法については，「付録D.4(9)　PRFデーモンの停止」を参照してください。

付録G.4　システムの停止方法

ここでは，バッチアプリケーションおよびバッチサーバの停止方法について説明します。

(1)　バッチアプリケーションの停止

バッチアプリケーションの停止方法について説明します。

バッチアプリケーションが停止していない場合に，cjkilljobコマンドを使用してバッチアプリケーションを停止します。なお，cjkilljobコマンドの実行には，root権限またはComponent Container管理者の権限が必要です。

cjkilljobコマンドは，メソッドキャンセルまたはCTMによりバッチアプリケーションを停止します。停止に失敗した場合は，バッチサーバを強制停止します。

バッチアプリケーションの停止手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/CC/batch/bin

cjkilljobコマンドでバッチアプリケーションを停止します。

コマンドの実行には，root権限またはComponent Container管理者の権限が必要です。

バッチアプリケーションの停止には，サーバ名称を指定する場合とジョブIDを指定する場合があります。

サーバ名称を指定する場合

メソッドキャンセルによってバッチアプリケーションを停止します。

cjkilljob <サーバ名称>

ジョブIDを指定する場合

CTMによってバッチアプリケーションを停止します。

ジョブスケジューリング機能を使用している場合にだけ使用できます。

cjkilljob -jobID <ジョブID>

(2)　バッチサーバの停止

バッチサーバの停止手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/CC/server/bin

cjstopsvコマンドでバッチサーバを停止します。

コマンドの実行には，root権限またはComponent Container管理者の権限が必要です。

# cjstopsv <サーバ名称>

cjstopsvコマンドの実行例を次に示します。この例では，サーバ名は「MyServer」です。

# cd /opt/Cosminexus/CC/server/bin
# cjstopsv MyServer
#

なお，バッチサーバでの処理が終了しないなどの原因で，バッチサーバの停止処理が完了しない場合があります。この場合，バッチサーバを強制的に停止する必要があります。バッチサーバを強制停止する場合，cjstopsvコマンドに-fオプションまたは-fdオプションを指定して実行します。-fdオプションを指定すると，バッチサーバの障害情報を取得したあと，バッチサーバを強制停止します。

付録H　システムの環境変数

Management Serverを使用しないでシステムを構築する場合に必要なシステムの環境変数について説明します。

付録H.1　OS共通のシステムの環境変数

OS共通で設定する，システムの環境変数を次の表に示します。システムの環境変数は，CTMによるスケジューリング機能を使用するシステムかどうかによって設定要否が異なります。

表H‒1　システムの環境変数の設定値と設定要否（OS共通）

システムの環境変数名

説明

設定値

環境変数の設定要否

CTMを使用しない場合

CTMを使用する場合

LIBPATH，LD_LIBRARY_PATH※1 ※2

パスを設定します。

/opt/Cosminexus/TPB/lib

○

○

/opt/Cosminexus/PRF/lib

○

○

/opt/Cosminexus/CTM/lib

−

○

/opt/Cosminexus/common/lib

○

○

/opt/hitachi/common/lib

○

○

PATH

パスを設定します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥jdk¥bin※3

UNIXの場合

/opt/Cosminexus/jdk/bin※3

○

○

Windowsの場合

<Application Serverのインストールディレクトリ>¥TPB¥bin

UNIXの場合

/opt/Cosminexus/TPB/bin

○

○

Windowsの場合

<Application Serverのインストールディレクトリ>¥PRF¥bin※4

UNIXの場合

/opt/Cosminexus/PRF/bin※4

○

○

Windowsの場合

<Application Serverのインストールディレクトリ>¥CTM¥bin※4

UNIXの場合

/opt/Cosminexus/CTM/bin※4

−

○

<ProgramFiles>¥Common Files¥Hitachi※5

▲

▲

/bin※1

○

○

/usr/bin※1

○

○

<Application Serverのインストールディレクトリ>¥common¥lib ※8

▲

▲

TPDIR

TPBrokerのインストールディレクトリを設定します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥TPB

UNIXの場合

/opt/Cosminexus/TPB

○

○

VBROKER_ADM

ログ出力先などの管理ディレクトリを設定します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥TPB¥adm※6

UNIXの場合

/opt/Cosminexus/TPB/adm※6

○

○

PRFSPOOL

パフォーマンストレーサの実行環境ディレクトリを設定します。デフォルトのディレクトリがインストーラによって作成されます。デフォルトのディレクトリを変更する場合は，パフォーマンストレーサの実行環境ディレクトリを作成して，この環境変数に指定してください。PRFSPOOLの設定値とPRF識別子の長さ（最大32バイト）の合計が201バイト以内になるように設定してください。なお，環境変数が指定されていない場合，パフォーマンストレーサは動作しません。

Windowsの場合，デフォルト以外に変更するときは，設定したディレクトリ，およびそのディレクトリまでのパスに含まれるすべてのディレクトリに対するアクセス許可をフルコントロールとし，アクセス許可を割り当てるユーザにはEveryoneを指定してください。

UNIXの場合，実行環境ディレクトリ，およびそのパスに含まれるすべてのディレクトリに対して，アクセス権限（777）を設定してください。

Windowsの場合

<Application Serverのインストールディレクトリ>¥PRF¥spool

UNIXの場合

/opt/Cosminexus/PRF/spool

▲※7

▲※7

OSAGENT_PORT

スマートエージェント（osagent）が使用するポート番号を5,001〜65,535の整数で設定します。

14000※6

−

△

CTMDIR

CTMのインストールディレクトリを設定します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥CTM

UNIXの場合

/opt/Cosminexus/CTM

−

○

CTMSPOOL

CTMの実行環境ディレクトリを設定します。デフォルトのディレクトリがインストーラによって作成されます。デフォルトのディレクトリを変更する場合は，CTMの実行環境ディレクトリを作成して，この環境変数に指定してください。パス名は，大文字と小文字を区別して使用してください。

Windowsの場合

%CTMDIR%¥spool

UNIXの場合

/opt/Cosminexus/CTM/spool

−

△

TZ

タイムゾーンを設定します。

JST-9※6

○

○

（凡例）

○：設定が必要です。

▲：インストーラによって設定されるため，設定は不要です。

△：システム環境に応じて設定が必要です。

−：設定は不要です。

CTMを使用しない場合：CTMによるスケジューリング機能を使用しないシステムを示します。

CTMを使用する場合：CTMによるスケジューリング機能を使用するシステムを示します。

注※1　UNIXの場合に設定する環境変数です。Windowsの場合は設定しません。

注※2　OSによって設定する環境変数名が異なります。

AIXの場合：LIBPATH

Linuxの場合：LD_LIBRARY_PATH

注※3　次の場合は，環境変数「PATH」の先頭に指定してください。

CORBAネーミングサービスを手動起動する場合

Windowsの場合

注※4　CTMドメインマネジャやCTMを起動する場合には，パフォーマンストレーサのパス（<Application Serverのインストールディレクトリ>¥PRF¥bin）を同時に設定しないでください。パフォーマンストレーサのパスを同時に設定すると，CTMがパフォーマンストレーサのライブラリをロードした場合にエラーとなり，起動できません。

注※5　Windowsの場合に設定する環境変数です。UNIXの場合は設定しません。<ProgramFiles>¥Common Files¥Hitachiは，デフォルトではインストーラによってシステム環境変数に設定されます。なお，<ProgramFiles>は，通常，システム環境変数%ProgramFiles%に設定されているディレクトリのことです。

注※6　通常は，この値を設定してください。ほかの値も設定できます。

注※7　Windowsの場合はインストーラによって設定されます。UNIXの場合は設定されないため，手動で設定してください。

注※8　Windowsの場合はインストーラによって設定されます。UNIXの場合は設定不要です。

注意事項

CLASSPATHは無効です。クラスパスは，J2EEサーバ用オプション定義ファイルのadd.class.pathキーに設定します。

付録H.2　AIX固有の環境変数

OSがAIXの場合は，「付録H.1　OS共通のシステムの環境変数」で説明している環境変数のほかに，AIX固有のシステムの環境変数も設定する必要があります。AIX固有のシステムの環境変数を次の表に示します。

表H‒2　AIX固有のシステムの環境変数

システムの環境変数名

設定値

説明

PSALLOC※

early

メモリ確保時に必要なページングスペースをすぐに確保する設定にします。

NODISCLAIM※

true

free()に対するコールの処理方法として，disclaim()の発行を抑止する設定にします。

AIXTHREAD_SCOPE

S

コンテンションの有効範囲として，システム・ベースのコンテンションの有効範囲（1:1）を設定します。

AIXTHREAD_MUTEX_DEBUG

OFF

デバッグリストを使用しない設定にします。

AIXTHREAD_RWLOCK_DEBUG

OFF

デバッグリストを使用しない設定にします。

AIXTHREAD_COND_DEBUG

OFF

デバッグリストを使用しない設定にします。

EXTSHM

ON

プロセス空間の共有メモリ領域数の制限をなくす設定にします。

LDR_CNTRL（任意）

MAXDATA=0x40000000

カーネルの従来の区分化より大きいデータエリアを扱えるようにするための設定です。必要に応じて設定してください。

「0x40000000」は，未設定時のJ2EEサーバのmalloc領域サイズ（単位：バイト）です。mmap領域のJavaHeapや共用メモリなどを確保するためには，指定サイズを小さくするなど調整してください。

注※　システム構築の初期段階でメモリの見積もりができていない場合は，HTTP Serverに対してPSALLOCにearly，およびNODISCLAIMにtrueを設定しないでください。設定した場合，ページングスペースが十分に確保できなくなり，プロセスの起動に失敗することがあります。

付録I　Smart Composer機能で使用できる抽象パラメタ（V9互換モードの場合）

Smart Composer機能では，互いに関連があるパラメタを一つにまとめたパラメタとして提供しています。これを抽象パラメタといいます。抽象パラメタとは，個々の製品のそれぞれ具体的な実パラメタではなく，システム設計の見地からシステムの性能要件として定義されるパラメタのことをいいます。Smart Composer機能では，次の抽象パラメタを使用します。

リクエスト最大同時処理数

一つのサービスユニットでの，リクエストの最大同時処理数です。リクエストとは，クライアントから送られるHTTPリクエストに端を発する，一連の業務処理をいいます。

cmx_trans_paramコマンドを実行すると，定義した抽象パラメタの値が，展開規則に従って複数の実パラメタとして展開されます。なお，そのほかの実パラメタについては，パラメタのデフォルト値を使用します。それぞれのパラメタの詳細については，マニュアル「アプリケーションサーバリファレンス 定義編(サーバ定義)」の「4.　Smart Composer機能で使用するファイル」を参照してください。

抽象パラメタの展開機能は，物理ティアがcombined-tier構成の場合だけ利用できます。combined-tier以外の物理ティアの場合は，Smart Composer機能を利用しない場合のWebシステム構築と同様のパラメタ定義設計が必要です。

ここでは，抽象パラメタの展開，および抽象パラメタによって展開される実パラメタについて説明します。

付録I.1　抽象パラメタの展開

cmx_trans_paramコマンドに，簡易構築定義ファイルと抽象パラメタを入力することによって，抽象パラメタから実パラメタに展開された定義ファイル（抽象パラメタ展開済み簡易構築定義ファイル）が作成されます。抽象パラメタ展開のイメージを，次の図に示します。

図I‒1　抽象パラメタ展開のイメージ

なお，抽象パラメタの展開には，抽象パラメタが設計されている必要があります。抽象パラメタを展開する前に，リクエスト最大同時処理数の見積もりをしてください。

次に，リクエスト最大同時処理数を20と見積もった場合の抽象パラメタの展開の実行例を示します。

Windowsの場合

<Application Serverのインストールディレクトリ>¥manager¥bin¥cmx_trans_param -i <任意のディレクトリ>¥MyWebSystemDef.xml -p UnitMaxParallelCount=20 -o <任意のディレクトリ>¥MyWebSystemDef2.xml

UNIXの場合

# /opt/Cosminexus/manager/bin/cmx_trans_param -i <任意のディレクトリ>/MyWebSystemDef.xml -p UnitMaxParallelCount=20 -o <任意のディレクトリ>/MyWebSystemDef2.xml

cmx_trans_paramコマンドの詳細については，「8.3　Smart Composer機能で使用するコマンドの詳細」の「cmx_trans_param」を参照してください。

付録I.2　抽象パラメタによって展開される実パラメタ

抽象パラメタであるリクエスト最大同時処理数は，cmx_trans_paramコマンドを実行すると，簡易構築定義ファイルの次の七つの実パラメタに値が展開されます。

ThreadsPerChild

MaxClients

StartServers

HWSKeepStartServers

KeepAliveTimeout

webserver.connector.ajp13.backlog

webserver.connector.ajp13.max_threads

また，この抽象パラメタを使用して，Connector属性ファイルの，次の二つのパラメタの値を決定できます。なお，Connector属性ファイルとは，リソースアダプタの属性を取得，編集する場合に使用するファイルです。

MaxPoolSize

MinPoolSize

ここでは，簡易構築定義ファイルに展開される実パラメタの展開規則と，Connector属性ファイルに設定するパラメタの値の設定規則について説明します。

(1)　簡易構築定義ファイルに展開される実パラメタ

リクエスト最大同時処理数の値が，それぞれの実パラメタへ展開されるときの規則および実パラメタの説明を，実パラメタごとに説明します。なお，説明中の「設定先のファイル」とは，抽象パラメタ展開済みの簡易構築定義ファイルの情報が最終的に反映される，Application Serverのファイルを指します。

(a)　ThreadsPerChild

展開規則

(KeepAliveTimeout＋1リクエストの平均処理時間)／1リクエストの平均処理時間×リクエスト最大同時処理数

展開規則は上記のとおりですが，ここでは，1リクエストの平均処理時間＝KeepAliveTimeoutとして計算されるため，次のような式になります。

リクエスト最大同時処理数×2

実パラメタの説明

HTTP Serverで，Webサーバとして起動するスレッド数を指定するパラメタです。指定したスレッド数はWebサーバの最大同時接続数を示します。

詳細については，マニュアル「HTTP Server」を参照してください。

設定先のファイル

httpsd.conf（HTTP Server定義ファイル）

(b)　MaxClients

展開規則

(KeepAliveTimeout＋1リクエストの平均処理時間)／1リクエストの平均処理時間×リクエスト最大同時処理数

展開規則は上記のとおりですが，ここでは，1リクエストの平均処理時間＝KeepAliveTimeoutとして計算されるため，次のような式になります。

リクエスト最大同時処理数×2

実パラメタの説明

HTTP Serverで，同時に接続できるクライアントの最大数を指定するパラメタです。

設定先のファイル

httpsd.conf（HTTP Server定義ファイル）

(c)　StartServers

展開規則

(KeepAliveTimeout＋1リクエストの平均処理時間)／1リクエストの平均処理時間×リクエスト最大同時処理数

展開規則は上記のとおりですが，ここでは，1リクエストの平均処理時間＝KeepAliveTimeoutとして計算されるため，次のような式になります。

リクエスト最大同時処理数×2

実パラメタの説明

HTTP Serverで，Webサーバ起動時のサーバプロセス数を指定するパラメタです。

詳細については，マニュアル「HTTP Server」を参照してください。

設定先のファイル

httpsd.conf（HTTP Server定義ファイル）

(d)　HWSKeepStartServers

展開規則

「On」が展開されます。

実パラメタの説明

HTTP Serverで，サーバプロセスの稼働数をStartServersパラメタに指定した数だけ維持するかどうかを指定するパラメタです。

詳細については，マニュアル「HTTP Server」を参照してください。

設定先のファイル

httpsd.conf（HTTP Server定義ファイル）

(e)　KeepAliveTimeout

展開規則

「3」（秒）が展開されます。

実パラメタの説明

KeepAliveTimeoutは，HTTP1.1の持続型接続をしているときの，コネクションを持続する時間を指定するパラメタです。

持続型接続を使用する場合（KeepAliveディレクティブをオンにする場合），レスポンスの高速化のため，クライアントからのリクエストに対して応答を返したあともコネクションを切断しないで，同じクライアントからの次のリクエストを待ちます。このため，KeepAliveTimeoutでタイムアウト時間を設定します。

詳細については，マニュアル「HTTP Server」を参照してください。

設定先のファイル

httpsd.conf（HTTP Server定義ファイル）

(f)　webserver.connector.ajp13.backlog

展開規則

(KeepAliveTimeout＋1リクエストの平均処理時間)／1リクエストの平均処理時間×リクエスト最大同時処理数

展開規則は上記のとおりですが，ここでは，1リクエストの平均処理時間＝KeepAliveTimeoutとして計算されるため，次のような式になります。

リクエスト最大同時処理数×2

実パラメタの説明

リダイレクタからの接続要求の最大の待ち行列数を指定します。

設定先のファイル

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）

(g)　webserver.connector.ajp13.max_threads

展開規則

リクエスト最大同時処理数がそのまま展開されます。

実パラメタの説明

Webコンテナがリクエストを処理する同時実行数を指定します。

設定先のファイル

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）

(2)　抽象パラメタの展開例

cmx_trans_paramコマンドを実行すると物理ティアの定義（<tier>タグの定義）の<configuration>タグに，次の表に示すパラメタが自動展開されて，抽象パラメタ展開済み簡易構築定義ファイルが作成されます。

表I‒1　cmx_trans_paramコマンドによって自動展開されるパラメタ一覧

logical-server-type

param-name

web-server

ThreadsPerChild

MaxClients

StartServers

HWSKeepStartServers

KeepAliveTimeout

j2ee-server

webserver.connector.ajp13.backlog

webserver.connector.ajp13.max_threads

なお，パラメタの詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.　Smart Composer機能で使用するファイル」を参照してください。

抽象パラメタ展開済み簡易構築定義ファイルの内容を，次に示します（一部抜粋）。

抽象パラメタ展開済み簡易構築定義ファイル

<?xml version="1.0" encoding="UTF-8"?>
<model-definition xmlns="http://www.cosminexus.com/mngsvr/schema/ModelDefinition-2.5">
  <web-system>
    <name>MyWebSystem</name>
    <!-- 負荷分散機の定義 -->
    <load-balancer>
      :
    </load-balancer>
    <!-- 物理ティア(combined-tier)の定義 -->
    <tier>
      <tier-type>combined-tier</tier-type>

      <!-- Generate web-server configuration by cmx_trans_param -->
      <configuration>
        <logical-server-type>web-server</logical-server-type>
        <param>
          <param-name>ThreadsPerChild</param-name>
          <param-value>40</param-value>
        </param>
        <param>
          <param-name>MaxClients</param-name>
          <param-value>40</param-value>
        </param>
        <param>
          <param-name>StartServers</param-name>
          <param-value>40</param-value>
        </param>
        <param>
          <param-name>HWSKeepStartServers</param-name>
          <param-value>On</param-value>
        </param>
        <param>
          <param-name>KeepAliveTimeout</param-name>
          <param-value>3</param-value>
        </param>
      </configuration>

      <!-- Generate j2ee-server configuration by cmx_trans_param -->
      <configuration>
        <logical-server-type>j2ee-server</logical-server-type>
        <param>
          <param-name>webserver.connector.ajp13.backlog</param-name>
          <param-value>40</param-value>
        </param>
        <param>
          <param-name>webserver.connector.ajp13.max_threads</param-name>
          <param-value>20</param-value>
        </param>
          :
      </configuration>
    </tier>
    <!-- サービスユニットの定義 -->
    <unit>
      :
    </unit>
  </web-system>
  <!-- ホストの定義 -->
  <host>
    :
  </host>
</model-definition>

注　背景色付きの太字の部分が自動展開された定義です。

(3)　Connector属性ファイルのパラメタの値

Connector属性ファイルの，MaxPoolSizeおよびMinPoolSizeのパラメタについては，抽象パラメタの値を基に設定値を決定できます。これらのパラメタは，cmx_trans_paramコマンドで自動的に設定されません。手動でConnector属性ファイルに設定し，リソースアダプタをデプロイしてください。

(a)　MaxPoolSize

設定値

リクエスト最大同時処理数に設定した値を設定します。

実パラメタの説明

コネクションプールの最大値を指定します。

設定先のファイル

Connector属性ファイル

(b)　MinPoolSize

設定値

リクエスト最大同時処理数に設定した値を設定します。

実パラメタの説明

コネクションプールの最小値を指定します。

設定先のファイル

Connector属性ファイル

索引

A

adminagentcheck[1]

adminagentctl[1]

AIX固有のシステムの環境変数[1]

auditsetup[1]

C

C++スタブ生成コマンド[1]

car_tar_gz[1]

car_tar_Z[1]

cjaddapp[1]

cjaddsec[1]

cjcldumpap[1]

cjclearpool[1]

cjclearsession[1]

cjclstartap[1]

cjcommittrn[1]

cjcopyres[1]

cjdeleteapp[1]

cjdeletejb[1]

cjdeletelibjar[1]

cjdeleteres[1]

cjdeletesec[1]

cjdeployrar[1]

cjdumpsv[1]

cjenvsetup[1]

cjenvupdate[1]

cjexecjob[1]

cjexportapp[1]

cjexportrar[1]

cjforgettrn[1]

cjgencmpsql[1]

cjgetappprop[1]

cjgetjbprop[1]

cjgetrarprop[1]

cjgetresprop[1]

cjgetstubsjar[1]

cjgetsysinfo[1]

cjimportapp[1]

cjimportjb[1]

cjimportlibjar[1]

cjimportres[1]

cjimportwar[1]

cjjspc[1]

cjkilljob[1]

cjlistapp[1]

cjlistjb[1]

cjlistjob[1]

cjlistlibjar[1]

cjlistpool[1]

cjlistrar[1]

cjlistres[1]

cjlistsec[1]

cjlistthread[1]

cjlisttrn[1]

cjlisttrnfile[1]

cjmapsec[1]

cjmsbroker[1]

CJMSPブローカー管理[1]

CJMSPブローカーの起動[1]

CJMSPブローカーユーティリティ[1]

CJMSプロバイダで使用するコマンド[1]

CJMSプロバイダで使用するコマンドの一覧[1]

CJMSプロバイダで使用するコマンドの概要[1]

CJMSプロバイダで使用するコマンドの注意事項[1]

cjrarupdate[1]

cjreloadapp[1]

cjrenameapp[1]

cjreplaceapp[1]

cjresetsv[1]

cjrollbacktrn[1]

cjsetappprop[1]

cjsetjbprop[1]

cjsetrarprop[1]

cjsetresprop[1]

cjsetup[1]、[2]

cjsleep[1]

cjstartapp[1]

cjstartjb[1]

cjstartrar[1]

cjstartrecover[1]

cjstartsv[1]、[2]

cjstopapp[1]

cjstopjb[1]

cjstoprar[1]

cjstopsv[1]

cjstopthread[1]

cjtestres[1]

cjundeployrar[1]

cjunmapsec[1]

CMP2.x Entity Bean用SQL文の生成[1]

cmx_admin_passwd[1]

cmx_build_model[1]

cmx_build_system[1]

cmx_change_model[1]

cmx_delete_system[1]

cmx_export_model[1]

cmx_list_model[1]

cmx_list_status[1]

cmx_resume_lb[1]

cmx_scaleout_host[1]

cmx_start_target[1]

cmx_stop_target[1]

cmx_test_lb[1]

cmx_trans_param[1]

Component Container管理者のセットアップ[1]

Connector属性ファイルのパラメタの値[1]

CORBAネーミングサービスの起動[1]、[2]

CORBAネーミングサービスの停止[1]、[2]

coreアーカイブ機能[1]、[2]

coreファイルとスレッドダンプの取得／UNIXの場合[1]

cprfed[1]

cprfflush[1]

cprfgetpid[1]

cprflevel[1]

cprfstart[1]

cprfstop[1]

ctmchpara[1]

ctmdminfo[1]

ctmdmstart[1]

ctmdmstop[1]

ctmgetior[1]

ctmgetpid[1]

ctmholdque[1]

ctmidl2cpp[1]

ctmidl2j[1]

ctmjava2idl[1]

ctmlogcat[1]

ctmlsque[1]

ctmrasget[1]

ctmregltd[1]

ctmridinfo[1]

ctmrlesque[1]

ctmstart[1]

ctmstartgw[1]

ctmstop[1]

ctmstopgw[1]

ctmstsed[1]

ctmstsflush[1]

ctmstsstart[1]

ctmstsstop[1]

ctmtscgwd[1]

ctmver[1]

CTMデーモンの開始[1]

CTMデーモンの起動[1]、[2]

CTMデーモンの終了[1]

CTMデーモンの停止[1]、[2]

CTMで使用するコマンド[1]

CTMドメイン情報の出力[1]

CTMドメイン情報の表示と削除[1]

CTMドメインマネジャの開始[1]

CTMドメインマネジャの起動[1]、[2]

CTMドメインマネジャの終了[1]

CTMドメインマネジャの停止[1]、[2]

CTMレギュレータの開始[1]

D

daemon[1]

E

eheapprof[1]

Explicitヒープ詳細情報付き拡張スレッドダンプの出力[1]

G

GCの強制発生[1]

H

HWSKeepStartServers[1]

I

IDL生成コマンド[1]

IOR文字列取得コマンド[1]

J

J2EEアプリケーション[1]

J2EEアプリケーションのインポート[1]

J2EEアプリケーションのエクスポート[1]

J2EEアプリケーションの開始[1]、[2]、[3]

J2EEアプリケーションの削除[1]

J2EEアプリケーションの停止[1]、[2]、[3]

J2EEサーバで使用するコマンド[1]

J2EEサーバの開始[1]

J2EEサーバの起動[1]、[2]

J2EEサーバの起動間隔[1]

J2EEサーバのスレッドダンプの取得[1]

J2EEサーバのセットアップとアンセットアップ[1]

J2EEサーバの停止[1]、[2]、[3]

J2EEサーバのトランザクション回復[1]

JavaBeansリソースの一覧表示[1]

JavaBeansリソースのインポート[1]

JavaBeansリソースの開始[1]

JavaBeansリソースの削除[1]

JavaBeansリソースの属性設定[1]

JavaBeansリソースの属性の取得[1]

JavaBeansリソースの停止[1]

javacore[1]、[2]

javagc[1]

javatrace[1]

JavaVMで使用するコマンド[1]

JavaVMで使用するコマンドの一覧[1]

JavaVMで使用するコマンドの詳細[1]

Javaアプリケーションで使用するコマンド[1]

Javaアプリケーションで使用するコマンドの一覧[1]

Javaアプリケーションで使用するコマンドの詳細[1]

Javaアプリケーションの開始[1]

Javaアプリケーションのスレッドダンプの取得[1]

Javaスタブ生成コマンド[1]

jheapprof[1]

jheapprofanalyzer[1]

JSPの事前コンパイル[1]

K

KeepAliveTimeout[1]

kill[1]

M

Management Server管理ファイルの回復[1]

Management Server管理ファイルの退避[1]

Management Serverで使用するコマンド[1]

Management Serverの移行コマンド[1]、[2]

Management Serverの運用管理コマンド[1]

Management Serverの管理ユーザアカウントの設定[1]

Management Serverの起動／停止／セットアップ[1]

Management Serverの構築環境の削除[1]

MaxClients[1]

MaxPoolSize[1]

MinPoolSize[1]

mngautorun[1]

mngenvupdate[1]

mngsvr_adapter_setup[1]

mngsvr_monitor_setup[1]

mngsvrctl[1]

mngsvrupdate[1]

mngsvrutil[1]

mngunsetup[1]

mstrexport[1]

mstrimport[1]

O

ORBゲートウェイの開始[1]

ORBゲートウェイの終了[1]

OS状態情報の取得[1]

OTMゲートウェイの開始[1]

P

PRFデーモンの開始[1]

PRFデーモンの起動[1]、[2]

PRFデーモンの停止[1]、[2]

PRFデーモンプロセスIDの取得[1]

PRFトレース取得レベルの指定例（cprflevelコマンド）[1]

PRFトレース取得レベルの指定例（cprfstartコマンド）[1]、[2]

PRFトレース取得レベルの表示と変更[1]

R

RAR属性設定[1]

RARファイルの属性の取得[1]

rasetup[1]

S

setupwizardコマンド（システムのセットアップ，アンセットアップと複製）[1]

Smart Composer機能で使用するコマンド[1]

Smart Composer機能で使用するコマンドの詳細[1]

Smart Composer機能で使用できる抽象パラメタ（V9互換モードの場合）[1]

snapshotlog[1]

snapshotログの収集[1]

StartServers[1]

T

ThreadsPerChild[1]

V

vmiaccount[1]

vmiaccount create[1]

vmiaccount delete[1]

vmiaccount help[1]

vmiaccount list[1]

vmiaccount password[1]

vmiaccountコマンドのヘルプ表示[1]

vmiunit[1]

vmiunitadmin[1]

vmiunitadmin changeowner[1]

vmiunitadmin create[1]

vmiunitadmin delete[1]

vmiunitadmin help[1]

vmiunitadmin list[1]

vmiunitadminコマンドのヘルプ表示[1]

vmiunit attach[1]

vmiunit block[1]

vmiunit compare[1]

vmiunit detach[1]

vmiunit export[1]

vmiunit help[1]

vmiunit import[1]

vmiunit info[1]

vmiunit list[1]

vmiunit mark[1]

vmiunit script[1]

vmiunit start[1]

vmiunit status[1]

vmiunit stop[1]

vmiunit unblock[1]

vmiunit unmark[1]

vmiunit update[1]

vmiunitコマンドのヘルプ表示[1]

W

WARアプリケーションのインポート[1]

webserver.connector.ajp13.backlog[1]

webserver.connector.ajp13.max_threads[1]

Webアプリケーションで使用するコマンド[1]

Webアプリケーションで使用するコマンドの一覧[1]

Webアプリケーションで使用するコマンドの詳細[1]

Webサーバの起動[1]、[2]

Webサーバの停止[1]、[2]

Webシステムの構築[1]

Webシステムの削除[1]

Webシステムの情報モデルの取得[1]

Webシステムの情報モデルの生成[1]

Webシステムの情報モデルの変更[1]、[2]

Webシステムまたはサービスユニットの開始[1]

Webシステムまたはサービスユニットの停止[1]

あ

アカウント操作コマンド[1]

アダプタコマンドのセットアップとアンセットアップ[1]

アプリケーションサーバの起動の流れ（UNIXの場合）[1]、[2]

アプリケーションサーバの起動の流れ（Windowsの場合）[1]、[2]

アプリケーションのRMI-IIOPスタブおよびインタフェースの取得[1]

アプリケーションの一覧表示[1]

アプリケーションの入れ替え[1]

アプリケーションの属性設定[1]

アプリケーションの属性の取得[1]

アプリケーションのリロード[1]

アプリケーション名の変更[1]

う

運用管理エージェントの稼働確認[1]

運用管理エージェントの起動と停止[1]

か

仮想化システムで使用するコマンド[1]

仮想サーバグループに属する仮想サーバの一覧表示[1]

仮想サーバグループの起動[1]

仮想サーバグループの障害マークの設定[1]

仮想サーバグループの障害マークの設定解除[1]

仮想サーバグループの状態表示[1]

仮想サーバグループの停止[1]

仮想サーバグループの登録[1]

仮想サーバグループの登録解除[1]

仮想サーバグループの閉塞[1]

仮想サーバグループの閉塞解除[1]

仮想サーバのユーザスクリプトの実行[1]

仮想サーバへのセットアップ・アンセットアップ[1]

稼働中のJ2EEサーバのトランザクション情報の表示[1]

稼働統計情報の取得開始[1]

稼働統計情報の取得終了[1]

稼働統計情報の編集と出力[1]

簡易構築定義ファイルに展開される実パラメタ[1]

簡易構築定義ファイルの出力[1]

監査ログの設定で使用するコマンド[1]

監査ログの設定で使用するコマンドの一覧[1]

監査ログの設定で使用するコマンドの詳細[1]

管理ユニット運用操作コマンド[1]

管理ユニット管理コマンド[1]

管理ユニットに属する仮想サーバの一覧表示[1]

管理ユニットに属する仮想サーバへの定義ディレクトリの反映[1]

管理ユニットの一覧表示[1]

管理ユニットの起動[1]

管理ユニットの削除[1]

管理ユニットの作成[1]

管理ユニットの状態表示[1]

管理ユニットの情報表示[1]

管理ユニットの所有者の変更[1]

管理ユニットの停止[1]

管理ユニットの閉塞[1]

管理ユニットの閉塞解除[1]

き

業務の開始[1]

業務の停止[1]

く

クライアント側共通定義ファイル（mngsvrutilcl.properties）[1]

クライアント側定義ファイル（.mngsvrutilrc）[1]

クラス別統計情報解析ファイルのCSV出力[1]

クラス別統計情報付き拡張スレッドダンプの出力[1]

グローバルセッション情報の削除（データベースセッションフェイルオーバ機能）[1]

こ

コネクションプール内のコネクション削除[1]

コネクションプールの一覧表示[1]

コマンドユーティリティ[1]

コマンドを同時に複数実行した場合の排他制御[1]

さ

サーバ側定義ファイル（mngsvrutil.properties）[1]

サーバ管理コマンドの排他強制解除[1]

サービスユニット状況の表示[1]

作業ディレクトリおよびユーザ定義ファイルの移行[1]

サブコマンド[1]

サブコマンドchangeに指定できる引数[1]

サブコマンドcheckに指定できる引数[1]

サブコマンドcollectに指定できる引数[1]

サブコマンドdumpに指定できる引数[1]

サブコマンドgetに指定できる引数[1]

サブコマンドholdに指定できる引数[1]

サブコマンドlistに指定できる引数[1]

サブコマンドreleaseに指定できる引数[1]

サブコマンドreloadに指定できる引数[1]

サブコマンドsetに指定できる引数[1]

サブコマンドstartに指定できる引数[1]

サブコマンドstopに指定できる引数[1]

し

システム起動時の環境変数の設定[1]、[2]

システム構築者アカウントの一覧表示[1]

システム構築者アカウントの削除[1]

システム構築者アカウントの追加[1]

システム構築者アカウントのパスワード変更[1]

システムの環境変数の設定値と設定要否[1]

システムの起動手順[1]、[2]、[3]、[4]

システムの起動方法[1]、[2]、[3]

システムの停止手順[1]、[2]、[3]、[4]

システムの停止の流れ[1]、[2]、[3]、[4]

システムの停止方法[1]、[2]、[3]、[4]

実行形式ファイルおよびライブラリのバージョン情報の出力[1]、[2]

自動起動および自動再起動の設定／設定解除[1]

詳細レベルのトレース情報を取得する場合の指定値（cprflevelコマンド）[1]

詳細レベルのトレース情報を取得する場合の指定値（cprfstartコマンド）[1]

詳細レベルまたは保守レベルのトレース情報を取得する場合の指定値（cprflevelコマンド）[1]

詳細レベルまたは保守レベルのトレース情報を取得する場合の指定値（cprfstartコマンド）[1]

す

スケジュールキュー情報の出力[1]

スケジュールキューの同時実行数の変更[1]

スケジュールキューの閉塞[1]

スケジュールキューの閉塞解除[1]

スマートエージェントの起動[1]、[2]

スマートエージェントの停止[1]、[2]

スレッド情報の表示[1]

スレッドダンプの取得／Windowsの場合[1]

スレッドの削除[1]

せ

性能解析トレース情報の編集出力[1]

性能解析トレースで使用するコマンド[1]

ち

抽象パラメタによって展開される実パラメタ[1]

抽象パラメタの展開[1]、[2]

抽象パラメタの展開例[1]

て

定義ディレクトリの取り込みまたは内容変更[1]

定義ディレクトリの取り出し[1]

停止中のJ2EEサーバのトランザクション情報の表示[1]

デーモンプロセスの起動[1]

と

統合ネーミングスケジューラサーバの起動の流れ（UNIXの場合）[1]

統合ネーミングスケジューラサーバの起動の流れ（Windowsの場合）[1]

登録済みの定義ディレクトリとの内容比較[1]

トラブルシュート情報の取得と出力[1]

トレース情報の収集[1]

は

バッチアプリケーション情報の一覧表示[1]

バッチアプリケーションで使用するコマンド[1]

バッチアプリケーションの実行[1]、[2]

バッチアプリケーションの停止[1]

バッチアプリケーションの停止またはバッチサーバの強制停止[1]

バッチサーバで使用するコマンド[1]

バッチサーバで使用するコマンドの概要[1]

バッチサーバで使用するリソース操作コマンド[1]

バッチサーバの開始[1]

バッチサーバの起動[1]

バッチサーバのセットアップとアンセットアップ[1]

バッチサーバの停止[1]

バッチサーバを操作するコマンド[1]

バッファ内容の強制ファイル出力[1]、[2]

ひ

ヒューリスティック状態のトランザクションの強制決着[1]

ふ

負荷分散機との接続テスト[1]

負荷分散機の設定再開始[1]

プロセスIDの取得[1]

プロセスの強制停止[1]

み

未決着のトランザクションのコミット[1]

未決着のトランザクションのロールバック[1]

め

メッセージの編集と出力[1]

も

モニタ起動コマンドのセットアップとアンセットアップ[1]

ゆ

ユーザとロールのアンマッピング[1]

ユーザとロールの一覧表示[1]

ユーザとロールの削除[1]

ユーザとロールの追加[1]

ユーザとロールのマッピング[1]

ら

ライブラリJARの一覧表示[1]

ライブラリJARのインポート[1]

ライブラリJARの削除[1]

り

リソースアダプタのアンデプロイ[1]

リソースアダプタの一覧表示[1]

リソースアダプタのエクスポート[1]

リソースアダプタの開始[1]

リソースアダプタの停止[1]

リソースアダプタのデプロイ[1]

リソースアダプタのバージョンアップ[1]

リソースの一覧表示[1]

リソースのインポート[1]

リソースの開始[1]、[2]

リソースのコピー[1]

リソースの削除[1]

リソースの接続テスト[1]

リソースの属性設定[1]

リソースの属性の取得[1]

リソースの追加[1]

リソースの停止[1]、[2]

ろ

ログの運用で使用するコマンド[1]

ログの運用で使用するコマンドの一覧[1]

ログの運用で使用するコマンドの詳細[1]