Cosminexus　リファレンス　コマンド編

文法書

3020-3-M10-61

目　　次

前書き

変更内容

はじめに

1.　コマンドの概要

1.1　コマンドの種類

1.2　コマンドの入力形式

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

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

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

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

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

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

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

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

cjgetsysinfo（OS状態情報の取得）

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

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

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

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

cjstartsv（J2EEサーバの開始）

cjstopsv（J2EEサーバの停止）

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

cjaddapp（リソースの追加）

cjchmodapp（アプリケーションのモード切り替え）

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

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

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

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

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

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

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

cjimportlibjar（ライブラリJARのインポート）

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

cjlistlibjar（ライブラリJARの一覧表示）

cjreloadapp（アプリケーションのリロード）

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

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

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

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

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

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

cjclearpool（コネクションプール内のコネクション削除）

cjclosecn（J2EEサーバのコネクションクローズまたはコネクションの状態表示）

cjcopyres（リソースのコピー）

cjdeletejb（JavaBeansリソースの削除）

cjdeleteres（リソースの削除）

cjdeployrar（リソースアダプタのデプロイ）

cjexportrar（リソースアダプタのエクスポート）

cjgetjbprop（JavaBeansリソースの属性の取得）

cjgetrarprop（RARファイルの属性の取得）

cjgetresprop（リソースの属性の取得）

cjimportjb（JavaBeansリソースのインポート）

cjimportres（リソースのインポート）

cjlistjb（JavaBeansリソースの一覧表示）

cjlistpool（コネクションプールの一覧表示）

cjlistrar（リソースアダプタの一覧表示）

cjlistres（リソースの一覧表示）

cjresumepool（メンバコネクションプールの再開始）

cjsetjbprop（JavaBeansリソースの属性設定）

cjsetrarprop（RAR属性設定）

cjsetresprop（リソースの属性設定）

cjstartjb（JavaBeansリソースの開始）

cjstartrar（リソースアダプタの開始）

cjstopjb（JavaBeansリソースの停止）

cjstoprar（リソースアダプタの停止）

cjsuspendpool（メンバコネクションプールの一時停止）

cjtestres（リソースの接続テスト）

cjundeployrar（リソースアダプタのアンデプロイ）

2.5　J2EEサーバで使用するその他のコマンド

cjaddsec（ユーザとロールの追加）

cjdeletesec（ユーザとロールの削除）

cjlistsec（ユーザとロールの一覧表示）

cjlistthread（スレッド情報の表示）

cjlisttrn（稼働中のJ2EEサーバのトランザクション情報の表示）

cjlisttrnfile（停止中のJ2EEサーバのトランザクション情報の表示）

cjmapsec（ユーザとロールのマッピング）

cjresetsv（サーバ管理コマンドの排他強制解除）

cjstopthread（スレッドの削除）

cjtracesync（インプロセスHTTPサーバ用トレースファイルの同期）

cjunmapsec（ユーザとロールのアンマッピング）

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

3.1　バッチサーバで使用するコマンドの概要

3.2　バッチサーバを操作するコマンド

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

cjstartsv（バッチサーバの開始）

3.3　バッチアプリケーションで使用するコマンド

cjexecjob（バッチアプリケーションの実行）

cjkilljob（バッチアプリケーションの停止またはバッチサーバの強制停止）

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

3.5　バッチサーバで使用するその他のコマンド

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

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

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

cprfed（性能解析トレース情報の編集出力）

cprfflush（バッファ内容の強制ファイル出力）

cprfgetpid（PRFデーモンプロセスIDの取得）

cprflevel（PRFトレース取得レベルの表示と変更）

cprfstart（PRFデーモンの開始）

cprfstop（PRFデーモンの停止）

5.　CTMで使用するコマンド

5.1　CTMで使用するコマンドの一覧

5.2　CTMで使用するコマンドの詳細

ctmchpara（スケジュールキューの同時実行数の変更）

ctmdminfo（CTMドメイン情報の表示と削除）

ctmdmstart（CTMドメインマネジャの開始）

ctmdmstop（CTMドメインマネジャの終了）

ctmgetpid（プロセスIDの取得）

ctmholdque（スケジュールキューの閉塞）

ctmjver（実行形式ファイルおよびライブラリのバージョン情報の出力）

ctmlogcat（メッセージの編集と出力）

ctmlsque（スケジュールキュー情報の出力）

ctmrasget（トラブルシュート情報の取得と出力）

ctmregltd（CTMレギュレータの開始）

ctmridinfo（CTMドメイン情報の出力）

ctmrlesque（スケジュールキューの閉塞解除）

ctmstart（CTMデーモンの開始）

ctmstop（CTMデーモンの終了）

ctmstsed（稼働統計情報の編集と出力）

ctmstsflush（バッファ内容の強制ファイル出力）

ctmstsstart（稼働統計情報の取得開始）

ctmstsstop（稼働統計情報の取得終了）

ctmtscgwd（OTMゲートウェイの開始）

ctmver（実行形式ファイルおよびライブラリのバージョン情報の出力）

6.　Management Serverで使用するコマンド

6.1　Management Serverで使用するコマンドの一覧

6.2　Management Serverで使用するコマンドの詳細

adminagentcheck（運用管理エージェントの稼働確認）

adminagentctl（運用管理エージェントの起動と停止）

daemon（デーモンプロセスの起動）

kill（プロセスの強制停止）

mngautorun（サービスの設定）

mngenvsetup（管理グループの設定）

mngsvr_adapter_setup（Cosminexusアダプタコマンドのセットアップとアンセットアップ）

mngsvr_monitor_setup（Cosminexusモニタ起動コマンドのセットアップとアンセットアップ）

mngsvrctl（Management Serverの起動／停止／セットアップ）

mngsvrupdate（Management Serverの移行コマンド）

mngsvrutil（Management Serverの運用管理コマンド）

mstrexport（Management Server管理ファイルの退避）

mstrimport（Management Server管理ファイルの回復）

6.3　mngsvrutilコマンドのサブコマンドの詳細

7.　JavaVMで使用するコマンド

7.1　JavaVMで使用するコマンドの一覧

7.2　JavaVMで使用するコマンドの詳細

car_tar_Z（coreアーカイブ機能）

javacore（coreファイルの取得）

javagc（ガーベージコレクションの強制発生）

javatrace（トレース情報の収集）

jheapprof（日立クラス別統計付き拡張スレッドダンプの出力）

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

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

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

snapshotlog（snapshotログの収集）

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

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

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

auditsetup（監査ログの設定）

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

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

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

convpw（パスワードの暗号化）

ssoexport（シングルサインオン情報リポジトリの参照）

ssogenkey（暗号鍵ファイルの作成）

ssoimport（シングルサインオン情報リポジトリの登録）

uachpw（パスワードの変更）

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

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

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

cjcldellog（Javaアプリケーションのシステムログ出力先サブディレクトリの削除）

cjcldumpap（Javaアプリケーションのスレッドダンプの取得）

cjclstartap（Javaアプリケーションの開始）

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

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

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

cjjspc（JSPの事前コンパイル）

cjjsp2java（JSPソースのチェック）

13.　構築済み実行環境の切り替えで使用するコマンド

13.1　構築済み実行環境の切り替えで使用するコマンドの一覧

13.2　構築済み実行環境の切り替えで使用するコマンドの詳細

cosmienv（構築済み実行環境の退避，回復，削除，一覧出力）

14.　Webコンテナサーバで使用するコマンド

14.1　Webコンテナサーバで使用するコマンドの一覧

14.2　Webコンテナサーバで使用するコマンドの詳細

cjdumpweb（Webコンテナサーバのスレッドダンプの取得）

cjstartweb（Webコンテナサーバの開始）

cjstopweb（Webコンテナサーバの停止）

cjwebchangedbid（データベースIDの変更）

cjwebclearpool（プール内のコネクションのクリア）

cjwebclosepool（プール内のコネクションの強制切断）

cjwebdeletepool（プール管理情報の削除）

cjwebeditpool（プール管理情報の登録と変更）

cjweblistpool（プール管理情報の一覧表示）

cjwebsetup（Webコンテナサーバのセットアップとアンセットアップ）

付録

付録A　JavaVMで使用するポート番号と設定変更方法

付録B　dabsetup（Cosminexus DABroker Libraryのセットアップ）

付録C　J2EEアプリケーションを実行するシステムの構築と削除

付録C.1　システム構築の流れ

付録C.2　J2EEサーバのセットアップ

付録C.3　システムの削除の流れ

付録C.4　J2EEサーバのアンセットアップ

付録D　J2EEアプリケーションを実行するシステムの起動と停止（Windowsの場合）

付録D.1　システムの起動手順

付録D.2　システムの起動方法

付録D.3　システムの停止手順

付録D.4　システムの停止方法

付録E　J2EEアプリケーションを実行するシステムの起動と停止（UNIXの場合）

付録E.1　システムの起動手順

付録E.2　システムの起動方法

付録E.3　システムの停止手順

付録E.4　システムの停止方法

付録F　バッチアプリケーションを実行するシステムの構築と削除

付録F.1　システム構築の流れ

付録F.2　バッチサーバのセットアップ

付録F.3　システムの削除の流れ

付録F.4　バッチサーバのアンセットアップ

付録G　バッチアプリケーションを実行するシステムの起動と停止（Windowsの場合）

付録G.1　システムの起動手順

付録G.2　システムの起動方法

付録G.3　システムの停止手順

付録G.4　システムの停止方法

付録H　バッチアプリケーションを実行するシステムの起動と停止（UNIXの場合）

付録H.1　システムの起動手順

付録H.2　システムの起動方法

付録H.3　システムの停止手順

付録H.4　システムの停止方法

付録I　（3020-3-M10-61）の変更内容

索引

[他社商品名称に関する表示]

All Rights Reserved. Copyright (C) 2006, 2008, Hitachi, Ltd.

前書き

■ 対象製品

●適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Server 2003（x64），Windows Server 2003 R2（x64）

P-2443-7D74　 uCosminexus Application Server Standard　 07-60
P-2443-7K74　 uCosminexus Application Server Enterprise　 07-60
P-2443-7M74　 uCosminexus Web Redirector　 07-60
P-2443-7S74　 uCosminexus Service Platform　 07-60※

●適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Vista，Windows XP

P-2443-7E74　 uCosminexus Developer Standard　 07-60
P-2443-7F74　 uCosminexus Developer Professional　 07-60
P-2443-7T74　 uCosminexus Service Architect　 07-60※
P-2443-7U74　 uCosminexus Operator　 07-60※

●適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Server 2003（x64），Windows Server 2003 R2（x64），Windows Vista，Windows XP

P-2443-7H74　 uCosminexus Client　 07-60

●適用OS：AIX 5L V5.2，AIX 5L V5.3

P-1M43-7D71　 uCosminexus Application Server Standard　 07-60※
P-1M43-7K71　 uCosminexus Application Server Enterprise　 07-60※
P-1M43-7M71　 uCosminexus Web Redirector　 07-60※
P-1M43-7S71　 uCosminexus Service Platform　 07-60※

●適用OS：HP-UX 11i V2（IPF），HP-UX 11i V3（IPF）

P-1J43-7D71　 uCosminexus Application Server Standard　 07-60※
P-1J43-7K71　 uCosminexus Application Server Enterprise　 07-60※
P-1J43-7M71　 uCosminexus Web Redirector　 07-60※

●適用OS：Red Hat Enterprise Linux AS 3（x86），Red Hat Enterprise Linux AS 4（x86），Red Hat Enterprise Linux ES 3（x86），Red Hat Enterprise Linux ES 4（x86），Red Hat Enterprise Linux AS 3（AMD64 & Intel EM64T），Red Hat Enterprise Linux AS 4（AMD64 & Intel EM64T），Red Hat Enterprise Linux ES 3（AMD64 & Intel EM64T），Red Hat Enterprise Linux ES 4（AMD64 & Intel EM64T）

P-9S43-7D71　 uCosminexus Application Server Standard　 07-60※
P-9S43-7K71　 uCosminexus Application Server Enterprise　 07-60※
P-9S43-7M71　 uCosminexus Web Redirector　 07-60※

●適用OS：Red Hat Enterprise Linux AS 3（x86），Red Hat Enterprise Linux AS 4（x86），Red Hat Enterprise Linux 5 Advanced Platform（x86），Red Hat Enterprise Linux ES 3（x86），Red Hat Enterprise Linux ES 4（x86），Red Hat Enterprise Linux 5（x86），Red Hat Enterprise Linux AS 3（AMD64 & Intel EM64T），Red Hat Enterprise Linux AS 4（AMD64 & Intel EM64T），Red Hat Enterprise Linux 5 Advanced Platform（AMD/Intel 64），Red Hat Enterprise Linux ES 3（AMD64 & Intel EM64T），Red Hat Enterprise Linux ES 4（AMD64 & Intel EM64T），Red Hat Enterprise Linux 5（AMD/Intel 64）

P-9S43-7S71　 uCosminexus Service Platform　 07-60※

●適用OS：Red Hat Enterprise Linux AS 3（IPF），Red Hat Enterprise Linux AS 4（IPF），Red Hat Enterprise Linux 5 Advanced Platform（Intel Itanium）

P-9V43-7D71　 uCosminexus Application Server Standard　 07-60※
P-9V43-7K71　 uCosminexus Application Server Enterprise　 07-60※
P-9V43-7M71　 uCosminexus Web Redirector　 07-60※

●適用OS：Solaris 9，Solaris 10

P-9D43-7D71　 uCosminexus Application Server Standard　 07-60※
P-9D43-7K71　 uCosminexus Application Server Enterprise　 07-60※
P-9D43-7M71　 uCosminexus Web Redirector　 07-60※
P-9D43-7S71　 uCosminexus Service Platform　 07-60※

※印の製品については，サポート時期をご確認ください。
これらのプログラムプロダクトのほかにもこのマニュアルをご利用になれる場合があります。詳細は「リリースノート」でご確認ください。
本製品では日立トレース共通ライブラリをインストールします。

■ 輸出時の注意

本製品を輸出される場合には，外国為替および外国貿易法ならびに米国の輸出管理関連法規などの規制をご確認の上，必要な手続きをお取りください。
なお，ご不明な場合は，弊社担当営業にお問い合わせください。

■ 商標類

AIXは，米国における米国International Business Machines Corp.の登録商標です。
AMDは，Advanced Micro Devices,Inc.の商標です。
Borlandのブランド名および製品名はすべて，米国Borland Software Corporationの米国およびその他の国における商標または登録商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
IIOPは，OMG仕様によるORB(Object Request Broker)間通信のネットワークプロトコルの名称です。
Intelは，Intel Corporationの会社名です。
Internet Explorerは，米国Microsoft Corporationの米国及びその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国および他の国におけるインテル コーポレーションまたはその子会社の登録商標です。
Java 及びすべてのJava関連の商標及びロゴは，米国及びその他の国における米国Sun Microsystems, Inc.の商標または登録商標です。
JDKは，米国 Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Linuxは，Linus Torvaldsの米国およびその他の国における登録商標あるいは商標です。
Microsoftは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Microsoft Internet Information Servicesは，米国Microsoft Corp.の商品名称です。
Microsoft SQL Serverは，米国Microsoft Corp.の商品名称です。
OMG，CORBA，IIOP，UML，Unified Modeling Language，MDA，Model Driven Architectureは，Object Management Group, Inc.の米国及びその他の国における登録商標または商標です。
ORACLEは，米国Oracle Corporationの登録商標です。
Oracleは，米国Oracle Corporation及びその子会社，関連会社の登録商標です。
Oracle9iは，米国Oracle Corporationの商標です。
Oracle 10gは，米国Oracle Corporationの商標です。
PA-RISCは，米国Hewlett-Packard Companyの商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標若しくは商標です。
SOAP（Simple Object Access Protocol）は，分散ネットワーク環境においてXMLベースの情報を交換するための通信プロトコルの名称です。
Solaris は，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
SQL Serverは，米国法人Sybase，Inc.の商標です。
UNIXは，X/Open Company Limited が独占的にライセンスしている米国ならびに他の国における登録商標です。
Windowsは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Windows Serverは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
Windows Vistaは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
X/Openは，X/Open Company Limited の英国ならびに他の国における登録商標です。
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).
プログラムプロダクト「P-9D43-7D71，P-9D43-7K71，P-9D43-7M71，P-9D43-7S71」には，米国Sun Microsystems,Inc.が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D43-7D71，P-9D43-7K71，P-9D43-7M71，P-9D43-7S71」には，UNIX System Laboratories,Inc.が著作権を有している部分が含まれています。

■ 発行

2006年4月 (第1版) 3020-3-M10
2008年1月 (第4.1版) 3020-3-M10-61

■ 著作権

All Rights Reserved. Copyright (C) 2006, 2008, Hitachi, Ltd.

変更内容

変更内容（3020-3-M10-61）

追加・変更内容 | 変更個所
記載内容を変更した。詳細は，付録Ｉを参照のこと。 | 付録Ｉ

変更内容（3020-3-M10-60）uCosminexus Application Server Standard 07-60，uCosminexus Developer Standard 07-60，uCosminexus Developer Professional 07-60，uCosminexus Client 07-60，uCosminexus Application Server Enterprise 07-60，uCosminexus Web Redirector 07-60，uCosminexus Service Platform 07-60，uCosminexus Service Architect 07-60，uCosminexus Operator 07-60

追加・変更内容
変更個所

業務アプリケーションを，J2EEアプリケーションに変更した。
全体

アプリケーションを実行するシステムごとにコマンドを分類した。
1.1

Solarisの記述を追加した。
2.2，6.2，付録E.2，付録E.4

次のコマンドに，引数-inbound，-listenertypeを追加した。

cjlistappコマンド（アプリケーションの一覧表示）

cjlistrarコマンド（リソースアダプタの一覧表示）

cjlistresコマンド（リソースの一覧表示）

2.3，2.4

バッチサーバで使用するコマンドの章を追加した。
3章

デフォルトの設定で取得できるsnapshotログの資料の一覧を追加した。
8.1

EJBクライアントアプリケーションを，Javaアプリケーションに変更した。
11章

cjjspcコマンド（JSPの事前コンパイル）に，次の引数を追加した。

-customactiondeclarevariable

-usebeannocheckclass

-tagnocheckrtexprvalue

-tagrtexprvalueterminate

-taglibnocheckprefix

12.1

J2EEアプリケーションを実行するシステムの構築と削除の手順を追加した。
付録C

バッチアプリケーションを実行するシステムの構築と削除の手順を追加した。
付録F

バッチアプリケーションを実行するシステムの起動と停止の手順を追加した。
付録G，付録H

次の製品の適用OSに，Red Hat Enterprise Linux 5 Advanced Platform（x86），Red Hat Enterprise Linux 5（x86），Red Hat Enterprise Linux 5 Advanced Platform（AMD/Intel 64），およびRed Hat Enterprise Linux 5（AMD/Intel 64）を追加した。

uCosminexus Service Platform

－

次の製品の適用OSにLinux（IPF）を追加した。

uCosminexus Application Server Standard

uCosminexus Application Server Enterprise

uCosminexus Web Redirector

－

次の製品の適用OSにSolarisを追加した。

uCosminexus Application Server Standard

uCosminexus Application Server Enterprise

uCosminexus Web Redirector

uCosminexus Service Platform

－

HP-UX（PA-RISC）のサポート中止に伴い，このOSに適応していた次の製品の記述を削除した。

uCosminexus Application Server Standard

uCosminexus Application Server Enterprise

uCosminexus Web Redirector

－

次の製品の適用OSからHP-UX（IPF）を削除した。

uCosminexus Service Platform

－

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

第4版では新規に章を追加しました。また，コマンドを用途別に分類し，目次の構成を変更しました。第3版との対応は次のようになっています。

第3版
第4版

1.　コマンドの概要
1.　コマンドの概要

2.　J2EEサーバで使用するコマンド
2.1　J2EEサーバで使用するコマンドの一覧
2.2　J2EEサーバで使用するコマンドの詳細
2.　J2EEサーバで使用するコマンド
2.1　J2EEサーバで使用するコマンドの概要
2.2　J2EEサーバを操作するコマンド
2.3　J2EEアプリケーションで使用するコマンド
2.4　J2EEサーバで使用するリソース操作コマンド
2.5　J2EEサーバで使用するその他のコマンド

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

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

4.　CTMで使用するコマンド
5.　CTMで使用するコマンド

5.　Management Serverで使用するコマンド
6.　Management Serverで使用するコマンド

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

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

8.　EJBクライアントアプリケーションで使用するコマンド
11.　Javaアプリケーションで使用するコマンド

9.　JavaVMで使用するコマンド
7.　JavaVMで使用するコマンド

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

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

12.　構築済み実行環境の切り替えで使用するコマンド
13.　構築済み実行環境の切り替えで使用するコマンド

13.　Webコンテナサーバで使用するコマンド
14.　Webコンテナサーバで使用するコマンド

付録A.　JavaVMで使用するポート番号と設定変更方法
付録A.　JavaVMで使用するポート番号と設定変更方法

付録B.　dabsetup（Cosminexus DABroker Libraryのセットアップ）
付録B.　dabsetup（Cosminexus DABroker Libraryのセットアップ）

－
付録C.　J2EEアプリケーションを実行するシステムの構築と削除

付録C.　コマンドによるシステムの起動と停止（Windowsの場合）
付録D.　J2EEアプリケーションを実行するシステムの起動と停止（Windowsの場合）

付録D.　コマンドによるシステムの起動と停止（UNIXの場合）
付録E.　J2EEアプリケーションを実行するシステムの起動と停止（UNIXの場合）

－
付録F.　バッチアプリケーションを実行するシステムの構築と削除

－
付録G.　バッチアプリケーションを実行するシステムの起動と停止（Windowsの場合）

－
付録H.　バッチアプリケーションを実行するシステムの起動と停止（UNIXの場合）

変更内容（3020-3-M10-40）uCosminexus Application Server Standard 07-50，uCosminexus Developer Standard 07-50，uCosminexus Developer Professional 07-50，uCosminexus Client 07-50，uCosminexus Application Server Enterprise 07-50，uCosminexus Web Redirector 07-50，uCosminexus Service Platform 07-50，uCosminexus Service Architect 07-50，uCosminexus Operator 07-50

追加・変更内容

Windows Vista使用時の注意事項を追加した。

監査ログの設定で使用するコマンドを追加した。

構築済みの実行環境の切り替えで使用するコマンドを追加した。

サーバ管理コマンドを使用する場合の注意事項を追加した。

csecanalyzコマンド（セキュリティ設定のチェック）を削除した。

J2EEアプリケーションに含まれるリソースアダプタに対応した。

Connector 1.5に準拠するリソースアダプタに対応した。

mngenvsetupコマンド（管理グループの設定）を追加した。

mngsvrctl setupコマンド（Management Serverのセットアップ）で，管理ユーザアカウントを設定できるようにした。

アプリケーション開発で使用するコマンドを，Webアプリケーションで使用するコマンドに変更した。

AIX 5L V5.1のサポート中止に伴い，このOSに適応していた次の製品の記述を削除した。

uCosminexus Application Server Enterprise

uCosminexus Application Server Standard

uCosminexus Service Platform

uCosminexus Web Redirector

Microsoft(R) Windows(R) 2000 Advanced Server Operating System，Microsoft(R) Windows(R) 2000 Datacenter Server Operating System，およびMicrosoft(R) Windows(R) 2000 Server Operating Systemのサポート中止に伴い，これらのOSに適応していた次の製品の記述を削除した。

uCosminexus Application Server Enterprise

uCosminexus Application Server Standard

uCosminexus Client

uCosminexus Developer Professional

uCosminexus Developer Standard

uCosminexus Operator

uCosminexus Service Architect

uCosminexus Service Platform

uCosminexus Web Redirector

Microsoft(R) Windows(R) 2000 Professional Operating Systemのサポート中止に伴い，このOSに適応していた次の製品の記述を削除した。

uCosminexus Client

uCosminexus Developer Professional

uCosminexus Developer Standard

uCosminexus Operator

uCosminexus Service Architect

次の製品の適用OSに，HP-UX（IPF）を追加した。

uCosminexus Service Platform

次の製品の適用OSに，HP-UX 11i V3（IPF）を追加した。

uCosminexus Application Server Enterprise

uCosminexus Application Server Standard

uCosminexus Web Redirector

次の製品の適用OSに，Red Hat Enterprise Linux ES 3（AMD64 & Intel EM64T），およびRed Hat Enterprise Linux ES 4（AMD64 & Intel EM64T）を追加した。

uCosminexus Application Server Enterprise

uCosminexus Application Server Standard

uCosminexus Service Platform

uCosminexus Web Redirector

次の製品の適用OSに，Windows Vistaを追加した。

uCosminexus Client

uCosminexus Developer Professional

uCosminexus Developer Standard

uCosminexus Operator

uCosminexus Service Architect

第3版ではマニュアル「Cosminexus　運用ガイド」から内容の一部を移動し，目次の構成を変更しました。第2版との対応は次のようになっています。

第2版 | 第3版
マニュアル「Cosminexus　システム運用ガイド」から移動 | 付録C　コマンドによるシステムの起動と停止（Windowsの場合）
マニュアル「Cosminexus　システム運用ガイド」から移動 | 付録D　コマンドによるシステムの起動と停止（UNIXの場合）

変更内容（3020-3-M10-20）uCosminexus Application Server Standard 07-10，uCosminexus Application Server Enterprise 07-10，uCosminexus Developer Standard 07-10，uCosminexus Developer Professional 07-10，uCosminexus Client 07-10，uCosminexus Web Redirector 07-10，uCosminexus Service Platform 07-10，uCosminexus Service Architect 07-10，uCosminexus Operator 07-10

追加・変更機能

論理J2EEサーバ，または論理SFOサーバで使用する設定ファイルを，接続先ホストから再読み込みできる機能を追加した。

cjclstartapコマンドで，EJBクライアントアプリケーション以外のJavaアプリケーションを開始できる機能を追加した。

cjcldumpapコマンド（スレッドダンプの取得）を追加した。

cjjspcコマンドを使用してJSPファイルの事前コンパイルを実行する場合に，デフォルトの文字エンコーディングを指定できる機能を追加した。

uCosminexus Application Server Standard，uCosminexus Application Server EnterpriseおよびuCosminexus Web Redirectorの適用OSに，HP-UX（PA-RISC）を追加した。

uCosminexus Application Server Standard，uCosminexus Application Server EnterpriseおよびuCosminexus Web Redirectorの適用OSに，Linux（IPF）を追加した。

uCosminexus Service Platformの適用OSに，AIXを追加した。

はじめに

このマニュアルは，Cosminexus（コズミネクサス）の構築・運用・アプリケーション開発で使用するコマンドについて説明したものです。

Cosminexusでは，次に示すプログラムプロダクトを使用してアプリケーションサーバを構築，運用します。

P-1J43-7D71　uCosminexus Application Server Standard

P-1J43-7K71　uCosminexus Application Server Enterprise

P-1J43-7M71　uCosminexus Web Redirector

P-1M43-7D71　uCosminexus Application Server Standard

P-1M43-7K71　uCosminexus Application Server Enterprise

P-1M43-7M71　uCosminexus Web Redirector

P-1M43-7S71　uCosminexus Service Platform

P-2443-7D74　uCosminexus Application Server Standard

P-2443-7E74　uCosminexus Developer Standard

P-2443-7F74　uCosminexus Developer Professional

P-2443-7H74　uCosminexus Client

P-2443-7K74　uCosminexus Application Server Enterprise

P-2443-7M74　uCosminexus Web Redirector

P-2443-7S74　uCosminexus Service Platform

P-2443-7T74　uCosminexus Service Architect

P-2443-7U74　uCosminexus Operator

P-9D43-7D71　uCosminexus Application Server Standard

P-9D43-7K71　uCosminexus Application Server Enterprise

P-9D43-7M71　uCosminexus Web Redirector

P-9D43-7S71　uCosminexus Service Platform

P-9S43-7D71　uCosminexus Application Server Standard

P-9S43-7K71　uCosminexus Application Server Enterprise

P-9S43-7M71　uCosminexus Web Redirector

P-9S43-7S71　uCosminexus Service Platform

P-9V43-7D71　uCosminexus Application Server Standard

P-9V43-7K71　uCosminexus Application Server Enterprise

P-9V43-7M71　uCosminexus Web Redirector

このマニュアルでは，これらのプログラムプロダクトの構成ソフトウェアのうち，次に示す構成ソフトウェアについて説明しています。

Cosminexus Component Container

Cosminexus Component Container - Client

Cosminexus Operator Plug-in

Cosminexus Component Container - Redirector

Cosminexus Component Transaction Monitor

Cosminexus DABroker Library

Cosminexus Developer's Kit for Java

Cosminexus Performance Tracer

Cosminexus TPBroker

なお，オペレーティングシステム（OS）の種類によって，機能が異なる場合があります。OSごとの違いがある場合の表記方法については，「適用OSの違いによる機能相違点の表記」を参照してください。

対象読者

このマニュアルは，J2EEに準拠したアプリケーションを実行するためのシステムを構築，運用する方，またはアプリケーションを開発する方を対象としています。

なお，次の内容を理解されていることを前提としています。

システムを設計，構築または運用する方

WindowsまたはUNIXのシステム構築および運用に関する知識

J2EEに関する知識

SQLおよびリレーショナルデータベースに関する基本的な知識

CORBAに関する基本的な知識

なお，JP1連携機能を使用する場合は，次の内容も理解されていることを前提とします。

JP1の統合管理，ジョブ管理，ネットワーク管理およびアベイラビリティ管理に関する基本的な知識

アプリケーションを開発する方

WindowsまたはUNIXの基本操作に関する知識

Javaによるプログラム開発に関する基本的な知識

使用するIDEに関する基本的な知識

また，このマニュアルは，マニュアル「Cosminexus　機能解説」を理解していることを前提としていますので，あらかじめお読みいただくことをお勧めします。

マニュアルの構成

このマニュアルは，次に示す章と付録から構成されています。

第1章　コマンドの概要

Cosminexusで使用するコマンドの種類，入力形式，文法などの記述形式について説明しています。

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

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

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

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

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

性能解析トレースで使用するコマンドの入力形式，機能などについて説明しています。

第5章　CTMで使用するコマンド

CTMで使用するコマンドの入力形式，機能などについて説明しています。

第6章　Management Serverで使用するコマンド

Management Serverで使用するコマンドの入力形式，機能などについて説明しています。

第7章　JavaVMで使用するコマンド

JavaVMで使用するコマンドの入力形式，機能などについて説明しています。

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

ログの運用で使用するコマンドの入力形式，機能などについて説明しています。

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

監査ログの設定で使用するコマンドの入力形式，機能などについて説明しています。

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

統合ユーザ管理で使用するコマンドの入力形式，機能などについて説明しています。

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

Javaアプリケーションで使用するコマンドの入力形式，機能などについて説明しています。

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

Webアプリケーションで使用するコマンドの入力形式，機能などについて説明しています。

第13章　構築済み実行環境の切り替えで使用するコマンド

構築済み実行環境の切り替えで使用するコマンドの入力形式，機能などについて説明しています。

第14章　Webコンテナサーバで使用するコマンド

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

付録A　JavaVMで使用するポート番号と設定変更方法

JavaVMで使用するポート番号と設定の変更方法について説明しています。

付録B　dabsetup（Cosminexus DABroker Libraryのセットアップ）

Cosminexus DABroker Libraryのセットアップコマンドについて説明しています。

付録C　J2EEアプリケーションを実行するシステムの構築と削除

J2EEアプリケーションを実行するシステムを構築・削除する方法について説明しています。

付録D　J2EEアプリケーションを実行するシステムの起動と停止（Windowsの場合）

Windowsの場合のJ2EEアプリケーションを実行するシステムの起動と停止の手順について説明しています。

付録E　J2EEアプリケーションを実行するシステムの起動と停止（UNIXの場合）

UNIXの場合のJ2EEアプリケーションを実行するシステムの起動と停止の手順について説明しています。

付録F　バッチアプリケーションを実行するシステムの構築と削除

バッチアプリケーションを実行するシステムを構築・削除する方法について説明しています。

付録G　バッチアプリケーションを実行するシステムの起動と停止（Windowsの場合）

Windowsの場合のバッチアプリケーションを実行するシステムの起動と停止の手順について説明しています。

付録H　バッチアプリケーションを実行するシステムの起動と停止（UNIXの場合）

UNIXの場合のバッチアプリケーションを実行するシステムの起動と停止の手順について説明しています。

関連マニュアル

Cosminexusのマニュアル体系について，次の図に示します。

マニュアル体系図で示した関連マニュアルについて，それぞれの位置づけを次に示します。

Cosminexus　概説

Cosminexusの製品概要について説明しています。

Cosminexus　機能解説

Cosminexus Component Containerの機能を中心に，uCosminexus Application Serverの概要と提供する機能について説明しています。

Cosminexus　システム設計ガイド

システム設計時に，システムの目的に応じたシステム構成や運用方法を検討するための指針について説明しています。また，チューニングの方法についても説明しています。

Cosminexus　簡易構築・運用ガイド

セットアップウィザードおよびSmart Composer機能を使用して，システムを構築・運用する手順について説明しています。また，セットアップウィザードおよびSmart Composer機能が提供するコマンドやファイルについても説明しています。

Cosminexus　システム構築ガイド

システム構築時に必要な機能の設定方法について説明しています。

Cosminexus　システム運用ガイド

Cosminexusを使用したシステムの運用方法のうち，Smart Composer機能を使用する運用以外の方法について説明しています。

Cosminexus　アプリケーション設定操作ガイド

Cosminexus Component Containerのサーバ管理コマンド，およびServer Plug-inを使用した操作について説明しています。

Cosminexus　運用管理操作ガイド

Cosminexus Component Containerの運用管理ポータルの使用方法について説明しています。

Cosminexus　リファレンス　定義編

Cosminexusのシステムを構築・運用するとき，またはアプリケーションを開発するときに，使用するファイルの形式について説明しています。

Cosminexus　メッセージ 1　KAWS／KDAL／KDJE編，Cosminexus　メッセージ 2　KEOS／KEUC／KFCB編，Cosminexus　メッセージ 3　KFCT／KFDB／KFDJ編

Cosminexusで出力されるメッセージについて説明しています。

Hitachi Web Server

Hitachi Web Server（Webサーバ）の構築，管理方法について説明しています。

TPBroker　ユーザーズガイド

Cosminexus TPBrokerの概要，機能，運用方法について説明しています。

Cosminexus Reliable Messaging

Cosminexus RMを使用したメッセージの非同期通信によるアプリケーションの連携方法について説明しています。

Cosminexus　アプリケーション開発ガイド

構築したCosminexusのシステムで動作させる，アプリケーションの開発方法について説明しています。

Cosminexus　リファレンス　API編

アプリケーションの開発で使用するAPIおよびタグについて説明しています。

また，マニュアル体系図に示したマニュアル以外で，このマニュアルと関連するマニュアルを次に示します。必要に応じてお読みください。

Borland(R) Enterprise Server VisiBroker(R) デベロッパーズガイド（3020-3-M45）

JP1 Version 7i JP1/Cm2/Extensible SNMP Agent（3020-3-F92）

マニュアル体系の変更について

07-00では，06-70のマニュアル「Cosminexus Version 6　リファレンス（Windows(R)用）（3020-3-E56）」と「Cosminexus Version 6　リファレンス（UNIX(R)用）（3000-3-987）」の内容を3分冊して，マニュアル体系を変更しました。

目次構成の対応は次のようになっています。

06-70のマニュアル | 07-00以降のマニュアル
第1編　コマンド | マニュアル「Cosminexus　リファレンス　コマンド編」へ移動
第2編　ファイル | マニュアル「Cosminexus　リファレンス　定義編」へ移動
第3編　オプション | マニュアル「Cosminexus　リファレンス　定義編」へ移動
第4編　API／タグライブラリ | マニュアル「Cosminexus　リファレンス　API編」へ移動
付録A　ログ出力のデフォルトの設定 | 削除
付録B　TPBrokerの運用支援機能用定義ファイル | 削除
付録C　Naming Manager定義ファイル | 削除
付録D　拡張MIBオブジェクト定義ファイル | マニュアル「Cosminexus　リファレンス　定義編」へ移動
付録E　CMPのマッピング一覧 | 削除
付録F　Webアプリケーション用DD（web.xml） | マニュアル「Cosminexus　リファレンス　定義編」へ移動
付録G　csecanalyzコマンドによるシステムのセキュリティ設定のチェック内容 | 削除
付録H　dabsetup（Cosminexus DABroker Libraryのセットアップ）※ | マニュアル「Cosminexus　リファレンス　コマンド編」へ移動

注※　「Cosminexus Version 6　リファレンス（UNIX(R)用）」だけにある目次項目です。

ご利用の製品ごとの用語の読み替えについて

ご利用の製品によっては，マニュアルで使用している用語を，ご利用の製品名に読み替える必要があります。

次の表に従って，マニュアルで使用している用語をご利用の製品名に読み替えてください。

ご利用の製品名 | マニュアルで使用している用語
uCosminexus Developer Professional※1 | Application ServerおよびApplication Server Enterprise
uCosminexus Developer Standard※1※2 | Application Server
uCosminexus Service Architect※1 | Application ServerおよびApplication Server Enterprise
uCosminexus Service Platform

注※1　テスト環境で使用している場合にだけ読み替えが必要です。

注※2　uCosminexus Developer StandardとApplication Serverには一部機能差があります。機能差については，マニュアル「Cosminexus　アプリケーション開発ガイド」のDeveloper Standard使用時の注意事項に関する説明を参照してください。

このマニュアルでの表記

このマニュアルで使用している表記と，対応する製品名を次に示します。

表記 | 製品名
Application Server | Application Server Enterprise | uCosminexus Application Server Enterprise
Application Server Standard | uCosminexus Application Server Standard
Developer | Developer Professional | uCosminexus Developer Professional
Developer Standard | uCosminexus Developer Standard
HiRDBまたはHiRDBサーバ | HiRDB/Parallel Server | HiRDB/Parallel Server Version 7
HiRDB/Parallel Server Version 8
HiRDB/Single Server | HiRDB/Single Server Version 7
HiRDB/Single Server Version 8
HiRDB Run TimeまたはHiRDBクライアント | HiRDB/Run Time Version 7
HiRDB/Run Time Version 8
Internet Explorer | Microsoft(R) Internet Explorer
IPF | Itanium(R) Processor Family
JP1/Cm2 | JP1/Cm2/ESA | JP1/Cm2/Extensible SNMP Agent
JP1/Cm2/ESA for Extension Mib Runtime | JP1/Cm2/Extensible SNMP Agent for Extension Mib Runtime
JP1/IM | JP1/IM - Central Console | JP1/Integrated Manager - Central Console
JP1/IM - CM | JP1/Integrated Management - Central Information Master
JP1/Integrated Manager - Central Information Master
JP1/IM - Central Scope | JP1/Integrated Manager - Central Scope
JP1/IM - Manager | JP1/Integrated Management - Manager
JP1/IM - View | JP1/Integrated Management - View
JP1/Integrated Manager - View
Microsoft IIS | Microsoft IIS 6.0 | Microsoft(R) Internet Information Services 6.0
Oracle | Oracle9i | Oracle9i
Oracle9i R2
Oracle10g | Oracle 10g
Oracle 10g R2
UNIX | AIX | AIX 5L V5.2
AIX 5L V5.3
HP-UXまたはHP-UX（IPF） | HP-UX 11i V2（IPF）
HP-UX 11i V3（IPF）
Linux | Linux（IPF） | Red Hat Enterprise Linux AS 3（IPF）
Red Hat Enterprise Linux AS 4（IPF）
Red Hat Enterprise Linux 5 Advanced Platform（Intel Itanium）
Linux（x86／AMD64 & Intel EM64T） | Red Hat Enterprise Linux AS 3（x86）
Red Hat Enterprise Linux AS 4（x86）
Red Hat Enterprise Linux 5 Advanced Platform（x86）
Red Hat Enterprise Linux ES 3（x86）
Red Hat Enterprise Linux ES 4（x86）
Red Hat Enterprise Linux 5（x86）
Red Hat Enterprise Linux AS 3（AMD64 & Intel EM64T）
Red Hat Enterprise Linux AS 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux 5 Advanced Platform（AMD/Intel 64）
Red Hat Enterprise Linux ES 3（AMD64 & Intel EM64T）
Red Hat Enterprise Linux ES 4（AMD64 & Intel EM64T）
Red Hat Enterprise Linux 5（AMD/Intel 64）
Solaris | Solaris 9
Solaris 10
Web Redirector | uCosminexus Web Redirector
Windows Server 2003 | Windows Server 2003 Enterprise Edition | Microsoft(R) Windows Server(R) 2003，Enterprise Edition Operating System（x86）
Windows Server 2003 Standard Edition | Microsoft(R) Windows Server(R) 2003，Standard Edition Operating System（x86）
Windows Server 2003 R2 | Windows Server 2003 R2 Enterprise Edition | Microsoft(R) Windows Server(R) 2003 R2，Enterprise Edition Operating System（x86）
Windows Server 2003 R2 Standard Edition | Microsoft(R) Windows Server(R) 2003 R2，Standard Edition Operating System（x86）
Windows Server 2003（x64） | Windows Server 2003 Enterprise x64 Edition | Microsoft(R) Windows Server(R) 2003，Enterprise x64 Edition Operating System
Windows Server 2003 Standard x64 Edition | Microsoft(R) Windows Server(R) 2003，Standard x64 Edition Operating System
Windows Server 2003 R2（x64） | Windows Server 2003 R2 Enterprise x64 Edition | Microsoft(R) Windows Server(R) 2003 R2，Enterprise x64 Edition Operating System
Windows Server 2003 R2 Standard x64 Edition | Microsoft(R) Windows Server(R) 2003 R2，Standard x64 Edition Operating System
Windows Vista | Windows Vista Business | Microsoft(R) Windows Vista(R) Business
Windows Vista Enterprise | Microsoft(R) Windows Vista(R) Enterprise
Windows Vista Ultimate | Microsoft(R) Windows Vista(R) Ultimate
Windows XP | Microsoft(R) Windows(R) XP Professional Operating System
XDM/RD E2 | VOS3 XDM/RD E2

なお，Windows Server 2003，Windows Server 2003 R2，Windows Server 2003（x64），Windows Server 2003 R2（x64），Windows Vista，およびWindows XPを総称してWindowsと表記することがあります。

このマニュアルで使用している表記と，対応するCosminexusの機能名を次に示します。

表記 | Cosminexusの機能名
Cosminexus Developer's Kit for Java | Cosminexus Developer's Kit for JavaTM
CTM | Cosminexus Component Transaction Monitor
Management Server | Cosminexus Management Server
PRF | Cosminexus Performance Tracer
TPBroker | Cosminexus TPBroker

このマニュアルで使用している表記と，対応するJava関連用語を次に示します。

表記 | Java関連用語
Connector 1.0 | J2EETM Connector Architecture 1.0
Connector 1.5 | J2EETM Connector Architecture 1.5
EAR | Enterprise ARchive
EJBまたはEnterprise JavaBeans | Enterprise JavaBeansTM
J2EEまたはJava 2 Platform, Enterprise Edition | JavaTM 2 Platform, Enterprise Edition
J2SE | JavaTM 2 Platform, Standard Edition
JAAS | JavaTM Authentication and Authorization Service
JAR | JavaTM Archive
Java | JavaTM
Java 2 Runtime Environment, Standard Edition | JavaTM 2 Runtime Environment, Standard Edition
Java 2 SDK, Standard Edition | JavaTM 2 Software Development Kit, Standard Edition
JavaBeans | JavaBeansTM
JavaMail | JavaMailTM
JAXP | JavaTM API for XML Processing
JCA | J2EETM Connector Architecture
JCE | JavaTM Cryptography Extension
JDBC | JDBCTM
JavaTM Database Connectivity
JDK | JavaTM Development Kit
JMS | JavaTM Message Service
JNDI | Java Naming and Directory InterfaceTM
JNI | JavaTM Native Interface
JSP | JavaServer PagesTM
JTA | JavaTM Transaction API
JTS | JavaTM Transaction Service
Servletまたはサーブレット | JavaTM Servlet
WAR | Web ARchive

適用OSの違いによる機能相違点の表記

このマニュアルは，適用OSがWindows，AIX，HP-UX，Linux，およびSolarisの製品に対応します。OSによって記述を書き分ける場合，次に示す表記を使用して，それぞれの説明にOS名を明記しています。

表記 | 意味
Windowsの場合 | Windowsに該当する表記です。
AIXの場合 | AIXに該当する表記です。
HP-UXの場合 | HP-UXに該当する表記です。
Linuxの場合 | Linuxに該当する表記です。
Solarisの場合 | Solarisに該当する表記です。
UNIXの場合 | UNIX（AIX，HP-UX，Linux，Solaris）に該当する表記です。

このマニュアルで使用している略語

このマニュアルで使用している英略語を次に示します。

英略語 | 英字での表記
API | Application Programming Interface
ASCII | American Standard Code for Information Interchange
BMP | Bean-Managed Persistence
BMT | Bean-Managed Transaction
CA | Certification Authority
CMP | Container-Managed Persistence
CMR | Container-Managed Relationship
CMT | Container-Managed Transaction
CORBA | Common Object Request Broker Architecture
CPU | Central Processing Unit
CR | Carriage Return
CRL | Certificate Revocation List
CSR | Certificate Signing Request
CSV | Comma Separated Value
CUI | Character User Interface
DB | Database
DBMS | Database Management System
DD | Deployment Descriptor
DIT | Directory Information Tree
DN | Distinguished Name
DNS | Domain Name System
DoS | Denial of Service attack
DTD | Document Type Definition
EIS | Enterprise Information System
EJB QL | EJB Query Language
EUC | Extended UNIX Code
FF | Form Feed
GC | Garbage Collection
GUI | Graphical User Interface
HTML | Hyper Text Markup Language
HTTP | Hyper Text Transfer Protocol
IDE | Integrated Development Environment
IIOP | Internet Inter-Orb Protocol
ISAPI | Internet Server Application Programming Interface
ISO | International Organization for Standardization
JAR | Java Archive
JDBC | Java Database Connectivity
JIS | Japanese Industrial Standards
JMS | Java Message Service
JNI | Java Native Interface
LAN | Local Area Network
LDAP | Lightweight Directory Access Protocol
LDIF | LDAP Data Interchange Format
LF | Line Feed
MIB | Management Information Base
OID | Object Identifier
OMG | Object Management Group
ORB | Object Request Broker
OS | Operating System
OTS | Object Transaction Service
RDB | Relational Database
RMI | Remote Method Invocation
RPC | Remote Procedure Call
SFO | Session Fail Over
SHA | Secure Hash Algorithm
SNMP | Simple Network Management Protocol
SOA | Service Oriented Architecture
SOAP | Simple Object Access Protocol
SPI | Service Provider Interface
SPP | Service Providing Program
SSL | Secure Sockets Layer
TCS | Transaction Context Server
UDDI | Universal Description, Discovery and Integration
UML | Unified Modeling Language
UNC | Universal Naming Convention
URI | Uniform Resource Identifier
URL | Uniform Resource Locator
UTC | Universal Time Coordinated
UTF | UCS Transformation Format
WAR | Web ARchive
XML | Extensible Markup Language

このマニュアルで使用している記号

このマニュアルで使用する記号について次に示します。

記号
意　味

　｜
横に並べられた複数の項目に対する項目間の区切りを示し，「または」を意味します。
（例）　A｜B
　AまたはBを指定することを示します。

{ 　 }
この記号で囲まれている複数の項目のうちから一つを選択することを示します。項目が横に並べられ，記号｜で区切られている場合は，そのうちの一つを選択します。
（例）　｛A｜B｜C｝
　A，BまたはCのどれかを指定することを示します。

［　］
この記号で囲まれている項目は省略してもよいことを示します。複数の項目が横に並べて記述されている場合には，すべてを省略するか，記号｛ ｝と同じくどれか一つを選択します。
（例１）　［A］
　「何も指定しない」か「Aを指定する」ことを示します。
（例２）　［B｜C］
　「何も指定しない」か「BまたはCを指定する」ことを示します。

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

<　>
この記号で囲まれている項目は，該当する要素やファイルなどを指定したり，該当する要素が表示されたりすることを示します。
（例1）　<プロパティ>
　プロパティを記述します。またはプロパティが表示されます。
（例2）　<ファイル名>
　ファイル名を指定します。

　...
この記号の直前に示す記号を繰り返し，複数個指定できることを示します。
（例）　<プロパティ>...
　プロパティは複数個，繰り返して指定できます。

このマニュアルで使用している構文要素

このマニュアルで使用する構文要素の種類を次に示します。

種類 | 定義
英字 | A～Z　a～z
英小文字 | a～z
英大文字 | A～Z
数字 | 0～9
英数字 | A～Z　a～z　0～9
記号 | !　"　#　$　%　&　'　(　)　+　,　_　・　.　/　:　;　<　=　>　@　[　]　^　－　｛　｝　￣　タブ　空白

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

常用漢字以外の漢字の使用について

このマニュアルでは，常用漢字を使用することを基本としていますが，次に示す用語については，常用漢字以外の漢字を使用しています。

鍵（かぎ）　個所（かしょ）　全て（すべて）　脆弱（ぜいじゃく）　伝播（でんぱ）　汎用（はんよう）　必須（ひっす）　閉塞（へいそく）　漏洩（ろうえい）

KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

1.　コマンドの概要

この章では，Cosminexusで使用するコマンドの種類，入力形式，文法などの記述形式について説明します。

＜この章の構成＞

1.1　コマンドの種類

1.2　コマンドの入力形式

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

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

1.1　コマンドの種類

ここでは，Cosminexusで使用するコマンドの種類について説明します。

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

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

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

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

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

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

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

コマンドの種類
コマンドの説明
参照先

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

性能解析トレースで使用するコマンド
性能解析トレースでCosminexusのシステムの処理性能を解析する場合に，PRFデーモンの起動や停止，トレース情報の出力などで使用する，cprfで始まるコマンドです。
例：cprfstart，cprfed
4章

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

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

JavaVMで使用するコマンド
JavaVMのcoreファイルの取得，ガーベージコレクションの発生などで使用するコマンドです。
例：javacore，javagc
7章

ログの運用で使用するコマンド
Cosminexusのログを収集する場合に，snapshotログの収集などで使用するコマンドです。
例：snapshotlog
8章

監査ログの設定で使用するコマンド
監査ログのセットアップ時に使用するコマンドです。
例：auditsetup
9章

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

構築済み実行環境の切り替えで使用するコマンド
Cosminexusシステム環境の退避・回復を行うコマンドです。
例：cosmienv
13章

注※　CTMは，構成ソフトウェアにCosminexus Component Transaction Monitorを含む製品だけで利用できます。利用できる製品については，マニュアル「Cosminexus　概説」を参照してください。

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

コマンドの種類
コマンドの説明
参照先

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

性能解析トレースで使用するコマンド
性能解析トレースでCosminexusのシステムの処理性能を解析する場合に，PRFデーモンの起動や停止，トレース情報の出力などで使用する，cprfで始まるコマンドです。
例：cprfstart，cprfed
4章

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

JavaVMで使用するコマンド
JavaVMのcoreファイルの取得，ガーベージコレクションの発生などで使用するコマンドです。
例：javacore，javagc
7章

ログの運用で使用するコマンド
Cosminexusのログを収集する場合に，snapshotログの収集などで使用するコマンドです。
例：snapshotlog
8章

監査ログの設定で使用するコマンド
監査ログのセットアップ時に使用するコマンドです。
例：auditsetup
9章

構築済み実行環境の切り替えで使用するコマンド
Cosminexusシステム環境の退避・回復を行うコマンドです。
例：cosmienv
13章

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

コマンドの種類
コマンドの説明
参照先

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

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

コマンドの種類
コマンドの説明
参照先

Webアプリケーションで使用するコマンド
JSPソースのチェックなどで使用するコマンドです。
例：cjjsp2java
12章

参考

サーブレットエンジンモードで使用するコマンドの種類を次に示します。

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

JavaVMで使用するコマンド

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

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

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

Webコンテナサーバで使用するコマンド※

注※

サーブレットエンジンモードだけで使用できるコマンドです。

サーブレットエンジンモードでWebコンテナサーバを使用する場合に，Webコンテナサーバの起動や停止，プール管理情報の設定などで使用します。

例：cjstartweb，cjwebeditpool

コマンドについては，「14.　Webコンテナサーバで使用するコマンド」を参照してください。

1.2　コマンドの入力形式

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

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

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

＜この節の構成＞

(1)　コマンド名称

(2)　引数

(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.3　コマンドの文法の記述形式

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

形式

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

機能

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

引数

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

出力形式

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

入力例・出力例

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

戻り値

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

注意事項

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

参考

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

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

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

＜この節の構成＞

(1)　Windows VistaでCosminexusのコマンドを使用する場合の注意事項

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

(1)　Windows VistaでCosminexusのコマンドを使用する場合の注意事項

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

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

［スタート］ボタンをクリックします。

［プログラム］－［アクセサリ］を選択します。

［コマンド プロンプト］を右クリックして，［管理者として実行］をクリックします。

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

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

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

［例］

Windowsの場合

set USRCONF_JVM_ARGS=-Xmx512m

UNIXの場合

set USRCONF_JVM_ARGS="-Xmx512m"

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

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

UNIXの場合，Component Container管理者を設定すれば，スーパーユーザ以外の一般ユーザでもコマンドを実行できます。
Windows VistaではAdministrator権限を持つユーザであっても，コマンドプロンプトを管理者特権で開いていない場合，コマンドを実行できません。

ディレクトリ名，ファイル名にUnicodeの補助文字は使用できません。
ログファイルに，実行時の文字エンコーディングに変換できない文字を出力した場合，「?」に変換されます。

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

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

Cosminexus Component Container 06-00以前のバージョンからリモートでcjresetsvコマンドを実行するとKDJE37516-Iのメッセージが表示されますが，サーバ管理コマンドの排他情報はリセットされません。

削除系コマンドと一覧表示系コマンドを同一リソースに対し，同時に実行すると，J2EEサーバ，またはバッチサーバを起動したコンソールにKDJE39057-Eのメッセージが表示されることがありますが，J2EEサーバ，またはバッチサーバの動作への影響はありません。
削除系コマンドと一覧表示系コマンドを次に示します。
削除系サーバ管理コマンド
cjdeleteapp
cjdeleteres
cjundeployrar
cjdeletelibjar
一覧表示系サーバ管理コマンド
cjlistapp
cjlistres
cjlistrar
cjlistlibjar

サーバ管理コマンドのコマンドオプションに空白を含む場合は，次のように指定してください。
Windowsの場合
空白を含むコマンドオプションをダブルクォート（""）で囲んでください。
（例）Display nameがTP1/Message Queue - Accessのリソースアダプタの情報を取得する場合

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

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

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

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

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

ただし，次の場合には正しく動作しないことがあります。

シングルクォートで囲んだオプション中に空白が2個以上連続している。

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

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

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

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

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

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

＜この章の構成＞

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

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

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

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

2.5　J2EEサーバで使用するその他のコマンド

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

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

＜この節の構成＞

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

(2)　プロバイダURLについて

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

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

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

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

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

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥bin¥

UNIXの場合
/opt/Cosminexus/CC/server/bin/

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥

UNIXの場合
/opt/Cosminexus/CC/admin/bin/

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

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

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

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

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

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

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

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

cjstartsv
J2EEサーバの開始
J2EEサーバを開始します。
－

cjstopsv
J2EEサーバの停止
J2EEサーバを停止します。
更新※

（凡例）

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

－：該当なし

注※

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

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

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

＜この節の構成＞

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

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

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

cjgetsysinfo（OS状態情報の取得）

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

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

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

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

cjstartsv（J2EEサーバの開始）

cjstopsv（J2EEサーバの停止）

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

形式

cjdumpsv [<サーバ名称>]

機能

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

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

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

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

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

引数

<サーバ名称>

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

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

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

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

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

形式

cjenvsetup

機能

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

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

引数

なし

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

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

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

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

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

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

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

形式

cjenvupdate [-f]

機能

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

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

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

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

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

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

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

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

web.policy（SecurityManager定義ファイル）

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

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

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

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

Cosminexusの移行の手順については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

引数

-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の場合，cjenvupdateコマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

06-50以前のバージョンのCosminexusからアップグレードインストールしたとき，スタンダードモードまたはアドバンスドモードのJ2EEサーバ上にJdbcDbpsv.jarファイルとJdbcDbpsvEX.jarファイルで構成されたデータソースが存在する場合，DB Connector（DBConnector_DABJ_XA.rar）のJ2EEリソースアダプタへ置き換えます。また，データソースの表示名および属性情報はJ2EEリソースアダプタへ引き継がれます。表示名が同じJ2EEリソースアダプタがすでに存在した場合は，表示名の最後に1～2147483647の連番を付けて一意な表示名に変更します。ただし，J2EEリソースのリソースアダプタ（インポートされたリソースアダプタ）は作成されません。データソースの拡張DDファイル（hitachi-ds.xml）がスクランブルされている場合，DB ConnectorのJ2EE仕様に準拠したDDファイル（ra.xml）および拡張DDファイル（hitachi-ra.xml）はスクランブルされます。

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

cjgetsysinfo（OS状態情報の取得）

形式

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

機能

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

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

netstat -e
netstat -s
netstat -a
set

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

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

AIX
HP-UX
Linux
Solaris

df -k
ps -elf
ps -A -m -o THREAD
vmstat -t 1 1
vmstat -s
lsps -s
netstat -i
netstat -m
netstat -a
iostats
svmon -P
svmon -G
sar -A 1
instfix -i
lslpp -hac
uname -a
env
set
ipcs -a
df -kt
top -s 1 -d 1
ps -efl
vmstat
vmstat -s
netstat -i
netstat -a
iostat
sar -A 1
swapinfo -a
kmtune
swlist
swlist -l product
uname -a
env
set
ipcs -a
df
ps -eflm
vmstat
netstat -s
netstat -a
iostat※
top -b -n 1
sysctl -a
sar -A 1※
rpm -qa
rpm -qai
uname -a
env
set
ipcs
ipcs -t
ipcs -p
ipcs -c
ipcs -u
ipcs -l
df -k
ps -eflL
vmstat
vmstat -s
netstat -i
netstat -m
netstat -a
iostat
mpstat
swap -l
sar -A 1
sysdef
pkginfo
patchadd -p
uname -a
env
set

注※

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

引数

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

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

出力例

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

戻り値

0：

正常終了しました。

1以上：

異常終了しました。

注意事項

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

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

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

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

形式

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

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

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

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

機能

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

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

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

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

注※

移行するリソースアダプタ数やコマンド実行回数によって，必要なディスクの空き容量は変わります。移行に必要なディスク容量については，Cosminexusの移行の手順で確認してください。Cosminexusの移行の手順については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

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

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

引数

-type {dbconnector|rar}

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

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

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

-force

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

-f <ファイルパス>

移行対象としてDB Connector以外のリソースアダプタを指定した場合（-type rarを指定した場合）
旧バージョンの既存リソースアダプタと置き換えるリソースアダプタのファイルパスを指定します。ファイルパスは，複数回指定できますが，-fオプションは複数回指定できません。
-fオプションにConnector 1.5の仕様に準拠するリソースアダプタを指定した場合，メッセージKDJE42356-Eが出力されます。

移行対象としてDB Connectorを指定した場合（-type dbconnectorを指定した場合）
この引数は無視されます。

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

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

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

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

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

Cosminexus 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サーバにインポートまたはデプロイされたリソースアダプタを移行してしまった場合，バックアップ作業ディレクトリから元の環境を復旧してください。バックアップ作業ディレクトリについては，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

入力例

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

cjrarupdate -type rar -f file1 file2 file3

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

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

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

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

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

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

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

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

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

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

Connector 1.5の仕様に準拠するリソースアダプタの場合。

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

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

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

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

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

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

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

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

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

DB ConnectorのConnector属性ファイルの<config-property>タグに，loginTimeout，PreparedStatementPoolSize，CallableStatementPoolSize，またはCancelStatementプロパティが存在しない場合にcjrarupdateコマンドで移行をすると，移行前に存在しなかったプロパティの<config-property-value>は，移行後に次の値になります。

loginTimeout:0

PreparedStatementPoolSize:0

CallableStatementPoolSize:0

CancelStatement:false

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

形式

セットアップの場合

cjsetup [<サーバ名称>]

アンセットアップの場合

cjsetup -d <サーバ名称>

機能

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

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/

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

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥repository¥<サーバ名称>¥

UNIXの場合
/opt/Cosminexus/CC/server/repository/<サーバ名称>/

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥

UNIXの場合
/opt/Cosminexus/CC/server/public/ejb/<サーバ名称>/

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥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文字以下，かつマニュアル「Cosminexus　システム構築ガイド」のCosminexusの作業ディレクトリの説明を参照して見積もった範囲内の長さで指定してください。

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

-d

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

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

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

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

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

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

セットアップの場合(cjsetup <サーバ名称>)
セットアップに失敗します。

アンセットアップの場合(cjsetup -d <サーバ名称>)
すでに作成済みである，<サーバ名称>と大文字・小文字の区別以外は一致しているサーバが削除されます。

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

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

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

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アプリケーションに対する開始処理をしません。

J2EEアプリケーションの構成を変更（WARやEJB-JARを追加または削除）した場合。

サーバ管理コマンドでJ2EEアプリケーションや，J2EEアプリケーションを構成するWARまたはEJB-JARの属性を変更（プロパティを変更またはカスタマイズ）した場合。

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

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

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

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

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

-t <タイマ監視時間>

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

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

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

入力例

cjstartrecover MyServer -t 300

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

注意事項

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

UNIXの場合，cjstartrecoverコマンドの実行には，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アプリケーションは任意のリソースへのアクセスができるようになるため，セキュリティが低下します。

-nostartapp

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

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

J2EEアプリケーションの構成を変更（WARやEJB-JARを追加または削除）した場合。

サーバ管理コマンドでJ2EEアプリケーションや，J2EEアプリケーションを構成するWARまたはEJB-JARの属性を変更（プロパティを変更またはカスタマイズ）した場合。

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

ユーザ定義ファイル

Windowsの場合

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

<Cosminexusのインストールディレクトリ>¥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システムをログオフした。

注意事項

J2EEサーバを自動起動するように設定できます。J2EEサーバの起動については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

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

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

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

cjstopsv（J2EEサーバの停止）

形式

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

機能

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

引数

<サーバ名称>

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

-f

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

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

-fd

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

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

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

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

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

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

OSの稼働状況
Windowsの場合の出力先：
<Cosminexus作業ディレクトリ>¥ejb¥<サーバ名称>¥cjsysinfo.<出力時間>.txt
UNIXの場合の出力先：
<Cosminexus作業ディレクトリ>/ejb/<サーバ名称>/cjsysinfo.<出力時間>.txt
<出力時間>は，yymmddHHMMSSの形式になります。
なお，出力内容については，「cjgetsysinfo（OS状態情報の取得）」を参照してください。

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

J2EEサーバのクラッシュダンプ（Windowsの場合）またはcoreファイル（UNIXの場合）
最後のスレッドダンプ取得要求後，スレッドダンプ取得間隔時間経過後にクラッシュダンプまたはcoreファイルを出力します。
クラッシュダンプの出力先：
<ワトソン博士のクラッシュダンプ出力先>※¥user.dump
注※
　ワトソン博士のクラッシュダンプ作成オプションの設定が必要です。

coreファイルの出力先：
<Cosminexus作業ディレクトリ>/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の場合

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

<Cosminexusのインストールディレクトリ>¥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以上：

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

終了コード | 説明
1，または2以外の値以外 | パラメタ不正，内部エラーなどに関係するエラーの場合に出力されます（詳細は直前に表示されるメッセージを参照してください）。
2 | -waitによる正常終了監視タイムアウトです。

注意事項

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

J2EEサーバを自動停止するように設定できます。J2EEサーバの停止については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

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

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

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

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

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

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

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

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

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

コマンド名称 | 分類 | 概要 | コマンドの系統
cjaddapp | リソースの追加 | インポート済みのEJB-JARファイル，WARファイル，RARファイル，またはフィルタをJ2EEアプリケーションに追加します。 | 更新
cjchmodapp | アプリケーションのモード切り替え | J2EEアプリケーションの動作モードを変更します。 | 更新
cjdeleteapp※1 | 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※1 | アプリケーションの属性の取得 | J2EEアプリケーションまたはJ2EEアプリケーションに含まれるリソースの属性を取得して，属性ファイルを生成します。 | 更新
cjgetstubsjar※1 | アプリケーションのRMI-IIOPスタブおよびインタフェースの取得 | J2EEアプリケーションについて，RMI-IIOPスタブおよびインタフェースを取得します。 | 更新
cjimportapp※1 | J2EEアプリケーションのインポート | J2EEアプリケーションをJ2EEサーバにインポートします。 | 更新
cjimportlibjar | ライブラリJARのインポート | J2EEアプリケーションにライブラリJARをインポートします。 | 更新
cjlistapp※1 | アプリケーションの一覧表示 | すべてのJ2EEアプリケーションについての名称と状態，J2EEアプリケーションに含まれるEJB-JARファイル，WARファイル，またはRARファイルの一覧を標準出力に出力します。 | 参照
cjlistlibjar | ライブラリJARの一覧表示 | J2EEアプリケーションに含まれるライブラリJARの一覧を標準出力に出力します。 | 参照
cjreloadapp | アプリケーションのリロード | J2EEアプリケーションを停止しないで構成するクラスおよびJSPを入れ替えます。 | 更新
cjrenameapp | アプリケーション名の変更 | J2EEアプリケーションの名称を変更します。 | 更新
cjreplaceapp※1 | アプリケーションの入れ替え | J2EEアプリケーションを入れ替えます。 | 更新
cjsetappprop※1 | アプリケーションの属性設定 | アプリケーション，EJB-JARファイルに含まれるリソース，WARファイルに含まれるリソース，またはRARファイルの属性を，指定されたアプリケーション属性ファイルの値に変更します。 | 更新
cjstartapp※1 | J2EEアプリケーションの開始 | J2EEアプリケーションを開始して，クライアントからのリクエストを受け取ることができるようにします。 | 更新
cjstopapp※1 | J2EEアプリケーションの停止 | J2EEアプリケーションを停止して，クライアントからのリクエストを受け取らないようにします。 | 更新※2

（凡例）

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

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

注※1

テストモードでも実行できます。

注※2

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

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

＜この節の構成＞

cjaddapp（リソースの追加）

cjchmodapp（アプリケーションのモード切り替え）

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

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

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

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

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

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

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

cjimportlibjar（ライブラリJARのインポート）

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

cjlistlibjar（ライブラリJARの一覧表示）

cjreloadapp（アプリケーションのリロード）

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

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

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

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

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

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 Vistaの場合）。

注意事項

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

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

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

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

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

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

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

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

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

-cオプションで指定するフィルタ属性ファイルは，Cosminexus 06-70以降のバージョンのフォーマットであり，<filter-name>および<filter-class>タグが指定されている必要があります。

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

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

cjchmodapp（アプリケーションのモード切り替え）

形式

アプリケーションをテストモードから通常モードに変更する場合

cjchmodapp [<サーバ名称>] [-nameserver <プロバイダURL>] -test
          -name <アプリケーション名> -mode normal

アプリケーションを通常モードからテストモードに変更する場合

cjchmodapp [<サーバ名称>] [-nameserver <プロバイダURL>]
          -name <アプリケーション名> -mode test

機能

J2EEアプリケーションの動作モードを，テストモードから通常モードへ，または通常モードからテストモードへ変更します。

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-test

テストモードのアプリケーションに対してコマンドを実行する場合に指定します。

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

モードを変更するJ2EEアプリケーション名を指定します。

-mode {test|normal}

アプリケーションの動作モードを指定します。

test
テストモードに変更します。

normal
通常モードに変更します。このオプションを指定する場合，-testオプションの指定が必要です。

入力例

アプリケーションをテストモードから通常モードに変更する場合

cjchmodapp MyServer -test -name App1 -mode normal

アプリケーションを通常モードからテストモードに変更する場合

cjchmodapp MyServer -name App1 -mode test

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

3：

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

9：

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

注意事項

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

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

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

形式

アプリケーションの場合

cjdeleteapp [<サーバ名称>] [-nameserver <プロバイダURL>] [-test]
           -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について」を参照してください。

-test

テストモードのアプリケーションに対してコマンドを実行する場合に指定します。このオプションを省略したときは，通常モードのアプリケーションに対してコマンドが実行されます。

-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 Vistaの場合）。

注意事項

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

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

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

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

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

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

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

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

形式

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

機能

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

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-test

テストモードのアプリケーションに対してコマンドを実行する場合に指定します。このオプションを省略したときは，通常モードのアプリケーションに対してコマンドが実行されます。

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

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

-f <ライブラリJAR名>

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

入力例

cjdeletelibjar MyServer -name App1 -f applib.jar

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

3：

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

9：

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

注意事項

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

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

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

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

形式

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

機能

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

実行時情報を含んだEARファイルをインポートした場合，インポートしたJ2EEアプリケーションの実行時情報は，エクスポートした場合のJ2EEアプリケーションの実行時情報と同じになります。

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

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

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

-normalを指定，または省略した場合
Cosminexusのアプリケーション実行環境情報ファイル（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 Vistaの場合）。

注意事項

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

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

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

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

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

形式

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

機能

cjgencmpsqlコマンドは，CMP2.x Entity Bean用のSQL文を生成します。

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

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

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

EJB QLから生成したSQL文

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

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

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

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

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

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

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

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

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

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

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-test

テストモードのアプリケーションに対してコマンドを実行する場合に指定します。このオプションを省略したときは，通常モードのアプリケーションに対してコマンドが実行されます。

-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 Vistaの場合）。

注意事項

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

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

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

形式

アプリケーションの場合

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

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

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

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

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

機能

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

J2EEアプリケーションとリソースの設定で使用する属性ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

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

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-test

テストモードのアプリケーションに対してコマンドを実行する場合に指定します。このオプションを省略したときは，通常モードのアプリケーションに対してコマンドが実行されます。

-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のデフォルトエンコーディング名を使用します。使用されたエンコーディング名を確認するには，cjgetapppropで取得した属性ファイルの先頭行の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 Vistaの場合）。

注意事項

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

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

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

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

形式

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

機能

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

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-test

テストモードのアプリケーションに対してコマンドを実行する場合に指定します。このオプションを省略したときは，通常モードのアプリケーションに対してコマンドが実行されます。

-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 Vistaの場合）。

注意事項

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

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

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

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

アプリケーションが停止状態で取得したRMI-IIOPスタブおよびインタフェースは，最新の状態ではない可能性があります。

-nameオプションで指定したアプリケーションが一度も開始されていない場合，エラーになります。

J2EEアプリケーション内に，リモートインタフェースを持つEnterprise Beanが存在しない場合，エラーになります。

次のJ2EEアプリケーションでは，WebブラウザからRMI-IIOPスタブおよびインタフェースを取得することはできません。cjgetstubsjarコマンドで取得してください。

旧バージョンでエクスポートしたJ2EEアプリケーションをインポートしている場合。

新規に作成した場合。

cjrenameappコマンドでアプリケーション名称を変更した場合。

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

形式

アーカイブ形式のアプリケーションをインポートする場合

cjimportapp [<サーバ名称>] [-nameserver <プロバイダURL>]
           [-test] [-nodelete]
           -f <EARファイルのパス> [-f <EARファイルのパス>...]

展開ディレクトリ形式のアプリケーションとしてインポートする場合（アプリケーションディレクトリ）

cjimportapp [<サーバ名称>] [-nameserver <プロバイダURL>]
           [-test] -a <アプリケーションディレクトリパス>

展開ディレクトリ形式のアプリケーションとしてインポートする場合（標準のアプリケーションファイル（拡張子.ear）またはCosminexusのアプリケーション実行環境情報ファイル（拡張子.zip））

cjimportapp [<サーバ名称>] [-nameserver <プロバイダURL>]
           [-test] [-nodelete] -f <EARファイルのパス>
           -d <展開ディレクトリパス>

機能

J2EEアプリケーションを，指定されたJ2EEサーバにインポートします。EARファイルに含まれているapplication.xmlのdisplay-nameタグで指定した文字列がインポートしたJ2EEアプリケーション名になります。

実行時情報を含んだEARファイルをインポートした場合，インポートしたJ2EEアプリケーションの実行時情報は，エクスポートしたときのJ2EEアプリケーションの実行時情報と同じになります。

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-test

テストモードのアプリケーションに対してコマンドを実行する場合に指定します。このオプションを省略したときは，通常モードのアプリケーションに対してコマンドが実行されます。

-nodelete

実行時情報を含むEARファイルをインポートする場合，開始処理などに失敗したアプリケーションを削除しないときに指定します。

このオプションを省略した場合，インポート後の開始処理などに失敗するとインポートしたアプリケーションは削除されます。

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

インポートするJ2EEアプリケーションを含むEARファイルのパスを指定します。一度に複数のEARファイルの指定もできます。

-a <アプリケーションディレクトリパス>

アプリケーションディレクトリのパスを指定します。

-d <展開ディレクトリパス>

アプリケーションを展開するサーバ側のディレクトリのフルパスを指定します。J2EEサーバを起動したユーザに対して展開先ディレクトリの書き込み権限が必要です。

入力例

アーカイブ形式のアプリケーションをインポートする場合

cjimportapp MyServer -f App1.ear

アプリケーションディレクトリを展開ディレクトリ形式のアプリケーションとしてインポートする場合

cjimportapp MyServer -a AppDirPath

標準のアプリケーションファイル（拡張子.ear）またはCosminexusのアプリケーション実行環境情報ファイル（拡張子.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 Vistaの場合）。

注意事項

-dオプションを使用して，EARファイルまたはZIPファイルを展開して作成されたアプリケーションディレクトリが，次の条件のどれかと一致する場合，-aオプションを使用してインポートできません。

EJB-JARのモジュール名が“.jar”で終わっていない。

WARのモジュール名が“.war”で終わっていない。

モジュールの拡張子を除いた名称が，ほかのモジュールの拡張子を除いた名称と重複している。

モジュールの拡張子を除いた名称が，EARファイル内のディレクトリ名称と重複している。

同じアプリケーション名を持つJ2EEアプリケーションが，インポート先のJ2EEサーバにすでに存在する場合，このコマンドはエラー終了します。

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

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

J2EEアプリケーションのインポート時には，このほかにも注意事項があります。J2EEアプリケーションのインポートについては，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

インポートするアプリケーションのアプリケーション名が255文字より大きい場合はエラーとなります。

cjimportlibjar（ライブラリJARのインポート）

形式

cjimportlibjar [<サーバ名称>] [-nameserver <プロバイダURL>] [-test]
              -name <アプリケーション名> -f <ライブラリJARファイルパス>
              [-f <ライブラリJARファイルパス> ...]

機能

J2EEアプリケーションにライブラリJARをインポートします。また，一度に複数のファイルのインポートもできます。ライブラリJARについては，マニュアル「Cosminexus　機能解説」のJ2EEコンポーネントの説明を参照してください。

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-test

テストモードのアプリケーションに対してコマンドを実行する場合に指定します。このオプションを省略したときは，通常モードのアプリケーションに対してコマンドが実行されます。

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

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

-f <ライブラリJARファイルパス>

読み込み対象となるライブラリJARファイルのパスを指定します。

入力例

cjimportlibjar MyServer -name App1 -f applib.jar

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

3：

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

9：

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

注意事項

すでにインポートされているライブラリJARと同じファイル名を持つライブラリJARをインポートすることはできません。

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

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

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

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

形式

すべてのアプリケーションの場合

cjlistapp [<サーバ名称>] [-nameserver <プロバイダURL>]

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

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

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

cjlistapp [<サーバ名称>] [-nameserver <プロバイダURL>] [-test]
         -name <J2EEアプリケーション名> -type rar
         [-spec | -resname <表示名> -outbound| -resname <表示名> -inbound| -resname <表示名> -listenertype <メッセージリスナのタイプ名>]

機能

すべてのアプリケーションの場合

すべてのJ2EEアプリケーションの名称，状態，およびモードの一覧を標準出力に出力します。展開ディレクトリ形式のアプリケーションの場合，アプリケーションディレクトリのパスも標準出力に出力します。

アプリケーションに含まれる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について」を参照してください。

-test

テストモードのアプリケーションに対してコマンドを実行する場合に指定します。このオプションを省略したときは，通常モードのアプリケーションに対してコマンドが実行されます。

-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：強制停止中
illegal：定義不正状態

<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 Vistaの場合）。

注意事項

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

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

一覧は大文字小文字の区別なしで，昇順でソートされます。

cjlistlibjar（ライブラリJARの一覧表示）

形式

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

機能

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

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-test

テストモードのアプリケーションに対してコマンドを実行する場合に指定します。このオプションを省略したときは，通常モードのアプリケーションに対してコマンドが実行されます。

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

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

入力例

cjlistlibjar MyServer -name App1

出力形式

<ライブラリJAR名>
<ライブラリJAR名>
・・・

戻り値

0：

正常終了しました。

1：

異常終了しました。

3：

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

9：

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

注意事項

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

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

一覧は大文字小文字の区別なしで，昇順でソートされます。

cjreloadapp（アプリケーションのリロード）

形式

cjreloadapp [<サーバ名称>] [-nameserver <プロバイダURL>] [-test]
           -name <アプリケーション名>
           [-t <強制リロード開始までのタイムアウト時間>]

機能

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

入れ替え後のアプリケーションに引き継がれるセッション情報の詳細については，マニュアル「Cosminexus　機能解説」を参照してください。

展開ディレクトリを使用し，開始状態およびリロードに失敗して停止状態にあるアプリケーションだけに実行できます。

このコマンドを実行する場合は，J2EEサーバ側のユーザプロパティファイル（usrconf.properties）にejbserver.deploy.context.reload_scopeプロパティを指定しておく必要があります。ユーザプロパティファイル（usrconf.properties）の詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-test

テストモードのアプリケーションに対してコマンドを実行する場合に指定します。このオプションを省略したときは，通常モードのアプリケーションに対してコマンドが実行されます。

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

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

-t <強制リロード開始までのタイムアウト時間>

コマンドを実行してから強制リロード開始までの待ち時間（秒）を指定します。

0～2147483647の整数です。

0を指定した場合は，構成するクラスおよびJSPの入れ替え処理が終了するまでクライアントへ応答は返りません。強制リロード開始までの待ち時間（秒）を指定しなかった場合は，強制リロードを実行しません。

入力例

cjreloadapp MyServer -name App1

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

3：

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

4：

閉塞失敗しました。

9：

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

注意事項

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

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

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

形式

cjrenameapp [<サーバ名称>] [-nameserver <プロバイダURL>] [-test]
           -name <アプリケーション名> -newname <変更後アプリケーション名>

機能

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

アプリケーションの名前を変更することによって，アプリケーションの世代管理やバージョン管理を行うことができます。

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-test

テストモードのアプリケーションに対してコマンドを実行する場合に指定します。このオプションを省略したときは，通常モードのアプリケーションに対してコマンドが実行されます。

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

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

-newname <変更後アプリケーション名>

変更後のJ2EEアプリケーション名を1文字以上で指定します。

アプリケーション名には，英数字（0～9，A～Z，a～z）またはアンダースコア（_）を使用できます。

入力例

cjrenameapp MyServer -name App1 -newname App2

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

3：

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

9：

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

注意事項

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

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

このコマンドを実行する場合，名称変更の対象となるアプリケーションは停止している必要があります。

アプリケーション名称を変更した場合，lookup名称も変更されるのでlookup名称を使用しているEJBクライアントやネーミング切り替え機能などでパスを通している場合は，修正が必要となります。

テストモードと通常モードで，それぞれに一意のアプリケーション名称を登録できます。同一モードで同一アプリケーション名称が存在する場合は，エラーとなります。このとき，アプリケーション名の大文字・小文字は区別されません。

旧バージョンで作成されたアプリケーションについても，アプリケーション名を変更できます。

<アプリケーション名>と<変更後アプリケーション名>に同じ名前を指定した場合，正常に処理されますが，アプリケーション名は変わりません。

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

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

形式

cjreplaceapp [<サーバ名称>] [-nameserver <プロバイダURL>] [-test]
            -name <アプリケーション名> -f <ファイルパス>
            [-t <タイムアウト時間>] [-replaceDD]

機能

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

06-70より前のバージョンでは，入れ替え後のアプリケーションに，入れ替え前のアプリケーションのランタイム属性※だけを引き継ぎます。06-70以降のバージョンでは，デフォルトでは，J2EEアプリケーションのすべての属性情報を引き継ぎます。06-70より前のバージョンと同じように，ランタイム属性だけを引き継ぎたい場合は，-replaceDDオプションを指定してコマンドを実行します。

このコマンドは，アプリケーションの状態（停止状態，開始状態）に関係なく実行できます。アプリケーションが開始されている場合，アプリケーション中のメソッドの終了を待ってアプリケーションを停止して入れ替え処理をしたあと，アプリケーションを開始します。ただし，-tオプションで指定された時間が経過しても停止処理が終了していない場合，アプリケーションは強制停止します。

注※

属性ファイルには，DDファイル（application.xml，ejb-jar.xml，ra.xml，web.xml）の定義と属性ファイル独自の定義を設定できます。属性ファイル独自の定義のことを，ランタイム属性といいます。

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-test

テストモードのアプリケーションに対してコマンドを実行する場合に指定します。このオプションを省略したときは，通常モードのアプリケーションに対してコマンドが実行されます。

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

入れ替えるアプリケーション名を指定します。

-f <ファイルパス>

読み込み対象となるアプリケーションファイルのパスを指定します。

このオプションで指定するアプリケーションファイルは標準のアプリケーションファイル（拡張子.ear）を指定します。

-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 Vistaの場合）。

注意事項

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

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

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

Cosminexusのアプリケーション実行環境情報ファイル（拡張子.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ファイル内のホームインタフェース（ローカル，リモート），コンポーネントインタフェース（ローカル，リモート），ビジネスインタフェース（ローカル，リモート）のメソッド定義が異なる場合。

設定しているアノテーションの値を変更した場合。

このコマンドは，サーバ管理コマンド用システムプロパティファイルのejbserver.rmi.request.timeoutキーで指定したタイムアウト時間の影響を受けません。タイムアウト時間を指定する場合は，-tオプションを指定してください。

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

形式

アプリケーションの場合

cjsetappprop [<サーバ名称>] [-nameserver <プロバイダURL>] [-test]
            -name <J2EEアプリケーション名> -c <属性ファイルパス>

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

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

すべての情報を設定する場合

cjsetappprop [<サーバ名称>] [-nameserver <プロバイダURL>] [-test]
            -name <J2EEアプリケーション名> -type all
            -c <属性ファイルパス>

機能

アプリケーション，EJB-JARファイルに含まれるリソース（EJB-JARファイル，Session Bean，Entity Bean，Message-driven Bean），WARファイルに含まれるリソース（WARファイル，サーブレット／JSP，フィルタ），またはRARファイルの属性を指定したアプリケーション属性ファイルの値に変更します。

下位リソース表示名が指定されない場合はEJB-JARファイル，またはWARファイルの指定になります。

J2EEアプリケーションとリソースの設定で使用する属性ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

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

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-test

テストモードのアプリケーションに対してコマンドを実行する場合に指定します。このオプションを省略したときは，通常モードのアプリケーションに対してコマンドが実行されます。

-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 Vistaの場合）。

注意事項

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

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

指定したJ2EEアプリケーション，またはリソースは存在している必要があります。

-typeオプションでallを指定した場合，指定したアプリケーション属性ファイル内のリソースの表示名で変更対象とするリソースが決定します。そのため，リソースの表示名を変更することはできません。

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

形式

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

機能

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

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-test

テストモードのアプリケーションに対してコマンドを実行する場合に指定します。このオプションを省略したときは，通常モードのアプリケーションに対してコマンドが実行されます。

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

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

-jspc

この引数を指定すると，JSPの事前コンパイルが実行されます。既存のWebアプリケーションに対してJSPの事前コンパイルを実行したあと，アプリケーションを開始する場合に指定してください。JSPの事前コンパイルでエラーが発生してもアプリケーションの開始は実行されます。

入力例

cjstartapp MyServer -name App1

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

3：

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

9：

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

注意事項

指定された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>] [-test]
         -name <J2EEアプリケーション名> [-t <タイムアウト時間>]

通常停止がタイムアウトしたあと，強制停止を手動で行う場合

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

通常停止がタイムアウトしたあと，強制停止を自動で行う場合

cjstopapp [<サーバ名称>] [-nameserver <プロバイダURL>] [-test]
         -name <J2EEアプリケーション名> -t <タイムアウト時間> -force

機能

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

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-test

テストモードのアプリケーションに対してコマンドを実行する場合に指定します。このオプションを省略したときは，通常モードのアプリケーションに対してコマンドが実行されます。

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

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

-t <タイムアウト時間>

コマンドを実行してから応答が返る時間を，0～2147483647までの整数（単位：秒）で指定します。0を指定した場合は，停止処理が終了するまでクライアントへ応答が返りません。指定がない場合は60秒が設定されます。

-cancel

通常停止がタイムアウトしたあと，強制停止を手動で行う場合に指定します。

-force

通常停止がタイムアウトしたあと，強制停止を自動で行う場合に指定します。

入力例

cjstopapp MyServer -name App1

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

3：

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

9：

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

注意事項

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

通常停止を行う場合，60秒または-tオプションで指定した時間の間に該当するJ2EEアプリケーションが停止しなかったとき，このコマンドはエラー終了します。

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

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

タイムアウトエラーが発生した場合は，cjlistappコマンドでJ2EEアプリケーションの状態を確認してください。

このコマンドは，サーバ管理コマンド用システムプロパティファイルのejbserver.rmi.request.timeoutキーで指定したタイムアウト時間の影響を受けません。タイムアウト時間を指定する場合は，-tオプションを指定してください。

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

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

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

表2-5　J2EEサーバで使用するリソース操作コマンドの一覧

コマンド名称 | 分類 | 概要 | コマンドの系統
cjclearpool | コネクションプール内のコネクション削除 | リソースアダプタまたはデータソースのコネクションをクリアします。 | 更新
cjclosecn | J2EEサーバのコネクションクローズまたはコネクションの状態表示 | データソースのコネクションをクローズします。またはコネクションの状態を表示します。 | 更新※
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ファイルの一覧を標準出力に出力します。 | 参照
cjresumepool | メンバコネクションプールの再開始 | クラスタコネクションプールのメンバコネクションプールを再開します。 | 更新
cjsetjbprop | JavaBeansリソースの属性設定 | 指定されたJavaBeansリソースの属性を，指定したJavaBeansリソース属性ファイルの値に変更します。 | 更新
cjsetrarprop | RAR属性設定 | デプロイ済みのRARファイルに含まれるリソースの属性を属性ファイルに指定された値に変更します。 | 更新
cjsetresprop | リソースの属性設定 | EJB-JARファイルに含まれるリソース，WARファイルに含まれるリソース，データソースファイル，メール，またはデプロイ前のRARファイルに含まれるリソースの属性を，属性ファイルに指定された値に変更します。 | 更新
cjstartjb | JavaBeansリソースの開始 | JavaBeansリソースを開始します。 | 更新
cjstartrar | リソースアダプタの開始 | リソースアダプタを開始します。 | 更新
cjstopjb | JavaBeansリソースの停止 | 開始状態のJavaBeansリソースを停止します。 | 更新
cjstoprar | リソースアダプタの停止 | 開始されているリソースアダプタを停止します。 | 更新
cjsuspendpool | メンバコネクションプールの一時停止 | クラスタコネクションプールのメンバコネクションプールを一時停止します。 | 更新
cjtestres | リソースの接続テスト | J2EEリソースアダプタ，メールおよびデータソースの接続テストをします。 | 更新
cjundeployrar | リソースアダプタのアンデプロイ | デプロイされているリソースアダプタをアンデプロイします。 | 更新

（凡例）

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

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

注※

リスト表示の場合は，参照になります。

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

＜この節の構成＞

cjclearpool（コネクションプール内のコネクション削除）

cjclosecn（J2EEサーバのコネクションクローズまたはコネクションの状態表示）

cjcopyres（リソースのコピー）

cjdeletejb（JavaBeansリソースの削除）

cjdeleteres（リソースの削除）

cjdeployrar（リソースアダプタのデプロイ）

cjexportrar（リソースアダプタのエクスポート）

cjgetjbprop（JavaBeansリソースの属性の取得）

cjgetrarprop（RARファイルの属性の取得）

cjgetresprop（リソースの属性の取得）

cjimportjb（JavaBeansリソースのインポート）

cjimportres（リソースのインポート）

cjlistjb（JavaBeansリソースの一覧表示）

cjlistpool（コネクションプールの一覧表示）

cjlistrar（リソースアダプタの一覧表示）

cjlistres（リソースの一覧表示）

cjresumepool（メンバコネクションプールの再開始）

cjsetjbprop（JavaBeansリソースの属性設定）

cjsetrarprop（RAR属性設定）

cjsetresprop（リソースの属性設定）

cjstartjb（JavaBeansリソースの開始）

cjstartrar（リソースアダプタの開始）

cjstopjb（JavaBeansリソースの停止）

cjstoprar（リソースアダプタの停止）

cjsuspendpool（メンバコネクションプールの一時停止）

cjtestres（リソースの接続テスト）

cjundeployrar（リソースアダプタのアンデプロイ）

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}]
           [-test]
           -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（計画モード）
ユーザが使用中のコネクションはクリアしません。ただし，再利用できません。

-test

テストモードのアプリケーションに対してコマンドを実行する場合に指定します。省略した場合は通常モードのアプリケーションに対してコマンドを実行します。

-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 Vistaの場合）。

注意事項

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

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

一度に複数のデータソース（JDBC）またはリソースアダプタを削除した場合，削除できないデータソース（JDBC）またはリソースアダプタがあったときでも，すべてのデータソース（JDBC）またはリソースアダプタに対して削除を試みます。

通常モードの場合，コネクションプールから取り除いた使用中コネクションは，コネクション数としてカウントされません。そのため，コネクションプール内のコネクションとコネクションプールから取り除いた使用中コネクションの合計がコネクションプールの最大値を超える場合があります。

cjclosecn（J2EEサーバのコネクションクローズまたはコネクションの状態表示）

形式

JDBCコネクション一覧を表示する場合

指定されたデータソースを対象とする場合

cjclosecn [<サーバ名称>] [-nameserver <プロバイダURL>]
         -l [-verbose] -resname <データソース表示名>
         [-resname <データソース表示名> ...]

プールに登録されたすべてのデータソースを対象とする場合

cjclosecn [<サーバ名称>] [-nameserver <プロバイダURL>]
         -l [-verbose] -resall

タイムアウト時間を指定してコネクションをクローズする場合

指定されたデータソースを対象とする場合

cjclosecn [<サーバ名称>] [-nameserver <プロバイダURL>]
         -t <seconds> -resname <データソース表示名>
         [-resname <データソース表示名> ...]

プールに登録されたすべてのデータソースを対象とする場合

cjclosecn [<サーバ名称>] [-nameserver <プロバイダURL>]
         -t <seconds> -resall

コネクションIDを指定してコネクションをクローズする場合

cjclosecn [<サーバ名称>] [-nameserver <プロバイダURL>]
         -resname <データソースの表示名>
         -cid <コネクションID> [-cid <コネクションID> ...]

機能

指定されたデータソースまたはプールに登録されたすべてのデータソースを対象として，使用中のコネクションの中で，取得時からの経過時間が指定時間を超過しているものを強制的にクローズします。このコマンドでは，次の機能を使用できます。

JDBCコネクション一覧を表示する

指定されたデータソースまたはプールに登録されたすべてのデータソースを対象として，JDBCコネクション一覧を表示します。

-verboseを指定しない場合

使用中のJDBCコネクション一覧を表示します。データソースを指定する場合，一度に複数のデータソースを指定できます。

-verboseを指定した場合

使用中および未使用のすべてのJDBCコネクション一覧を表示します。

タイムアウト時間を指定してコネクションをクローズする

指定されたデータソースまたはプールに登録されたすべてのデータソースを対象として，使用中のコネクションの中で，取得時からの経過時間が指定時間を超過しているものを強制的にクローズします。データソースを指定する場合，一度に複数のデータソースを指定できます。

コネクションIDを指定してコネクションをクローズする

指定されたデータソースを対象として，JDBCコネクションの中で，コネクションIDを指定されたコネクションを強制的にクローズします。

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-l

使用中のコネクション情報の一覧を表示します。

-t <seconds>

コネクションを解放する際のタイムアウト時間を指定します。指定時間を超過したコネクションが解放対象となります。指定は秒単位で，指定できる値は0≦指定値≦2147483647の範囲になります。

-verbose

使用中のコネクションおよび使用中でないコネクションを表示対象とします。

-resname <データソース表示名>

クローズ対象となるデータソース名称を指定します。一度に複数のデータソースを指定できます。

-resall

すべてのデータソースの使用中コネクションが対象となります。

-resnameと同時に指定できません。

-cid <コネクションID>

-lオプションで表示した一覧情報の中から，-resnameで指定したリソースが取得したコネクションをID番号で指定します。コネクションIDは，16進数で指定します。IDの指定は8けたまで指定できます。

入力例

JDBCコネクション一覧を表示する場合（指定されたデータソースを対象とする場合）

cjclosecn MyServer -l -resname JdbcDbpsv

タイムアウト時間を指定してコネクションをクローズする場合（指定されたデータソースを対象とする場合）

cjclosecn MyServer -t 200 -resname JdbcDbpsv -resname JdbcDbpsv2

コネクションIDを指定してコネクションをクローズする場合

cjclosecn MyServer -resname JdbcDbpsv -cid 657ed

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

3：

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

9：

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

注意事項

このコマンドの機能は，ベーシックモードで実行する場合だけ有効となります。1.4モードで実行すると，サーバエラーとなります。

cjclearpoolコマンドでプールから削除したコネクションは，このコマンドの対象にはなりません。

コマンド実行時，未決着のJDBCトランザクションはタイムアウトになります。また，未決着のJDBCトランザクションはロールバックします。

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

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

一度に複数のデータソースを指定する場合，存在しないデータソースがあったときでも，すべてのデータソースに対して，JDBCコネクション一覧の表示またはコネクションのクローズを試みます。

コネクションIDを指定する場合，未使用のコネクションを指定したときはエラーとなります。

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）またはアンダースコア（_）を使用できます。

入力例

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 Vistaの場合）。

注意事項

コピー先に指定する表示名が存在してはいけません。

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

コピー先表示名に指定したデータソースファイル，メール，またはRARファイルの表示名が240文字より大きい場合はエラーとなります。

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 Vistaの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダ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 Vistaの場合）。

注意事項

一度に複数のファイルを削除した場合，削除できないファイルがあったときでも，すべてに対して削除を試みます。

いったん開始または停止した単体RARファイルは，J2EEサーバを再起動しないと削除できません。

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

cjdeployrar（リソースアダプタのデプロイ）

形式

cjdeployrar [<サーバ名称>] [-nameserver <プロバイダURL>]
           -resname <リソースアダプタ名> [-resname <リソースアダプタ名> ...]

機能

指定されたリソースアダプタをデプロイします。まだデプロイされていないリソースアダプタが対象となります。すでにアプリケーションに追加されているリソースアダプタの表示名と同じ表示名を持つリソースアダプタを指定することはできません。一度に複数のリソースアダプタをデプロイできます。

開始済みの実行時情報を含んだリソースアダプタを指定すると，デプロイ完了後に自動開始処理が行われます。自動開始処理に失敗した場合，06-51より前のバージョンのときは，デプロイ完了後にJ2EEリソースアダプタは削除されます。06-70以降のバージョンのときは，J2EEリソースアダプタは削除されません。

引数

<サーバ名称>

接続先J2EEサーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称となります。

-nameserver <プロバイダURL>

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

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

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

-resname <リソースアダプタ名>

リソースアダプタ名を指定します。

入力例

cjdeployrar MyServer -resname account-ra

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

3：

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

8：

デプロイに成功しましたが，開始に失敗しました。

9：

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

注意事項

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

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

一度に複数のリソースアダプタをデプロイする場合，追加できないリソースアダプタがあるときでも，すべてのリソースアダプタの追加を試みます。

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 Vistaの場合）。

注意事項

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

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

cjgetjbprop（JavaBeansリソースの属性の取得）

形式

cjgetjbprop [<サーバ名称>] [-nameserver <プロバイダURL>]
           -resname <JavaBeansリソース表示名>
           [-encoding <エンコーディング名>] -c <属性ファイルパス>

機能

-resnameで指定されたJavaBeansリソースの属性を取得し，属性ファイルを生成します。

JavaBeansリソース属性ファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

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

引数

<サーバ名称>

接続先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 Vistaの場合）。

注意事項

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

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

cjgetrarprop（RARファイルの属性の取得）

形式

cjgetrarprop [<サーバ名称>][-nameserver <プロバイダURL>]
            -resname <リソースアダプタ表示名>
            [-encoding <エンコーディング名>] -c <属性ファイルパス>

機能

-resnameに指定されたJ2EEリソースとしてデプロイ済みのRARファイルの属性を取得して，属性ファイルを生成します。

RARファイルの属性を設定するのは，Connector属性ファイルです。Connector属性ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

引数

<サーバ名称>

接続先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のデフォルトエンコーディング名を使用します。使用されたエンコーディング名を確認するには，cjgetrarpropで取得した属性ファイルの先頭行のXML宣言部分を参照してください。

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

-c ＜属性ファイルパス＞

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

入力例

cjgetrarprop MyServer -resname account-rar -encoding Shift_JIS -c MyRarprop.xml

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

3：

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

9：

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

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<リソースアダプタ表示名> -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アプリケーションとリソースの設定で使用する属性ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

引数

<サーバ名称>

接続先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のデフォルトエンコーディング名を使用します。使用されたエンコーディング名を確認するには，cjgetrespropで取得した属性ファイルの先頭行の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 Vistaの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<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リソース属性ファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

引数で指定したディレクトリにあるJavaBeansリソースのクラスのインポートをする場合

引数で指定したディレクトリにあるJavaBeansリソースのクラスをインポートします。

すでにインポートしたJavaBeansリソースと同じ表示名，または同じ実装クラス名を持つJavaBeansリソースをインポートすることはできません。

JavaBeansリソースをインポートし，属性ファイルに指定された値を設定します。

JavaBeansリソース属性ファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

引数

<サーバ名称>

接続先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 Vistaの場合）。

注意事項

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

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

JavaBeansリソースの表示名が240文字より大きい場合はエラーとなります。

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 Vistaの場合）。

注意事項

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

コマンドの引数にサーバ名称を指定する場合，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）のインポートについては，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

サーブレットとJSPのインポート時には，WARファイルのDDに関して注意事項があります。サーブレットとJSPのインポートについては，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

リソースアダプタのインポート時には，RARファイルのDDに関して注意事項があります。リソースアダプタのインポートについては，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

インポートするRARファイルの表示名またはデータソースの表示名が240文字より大きい場合はエラーとなります。

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 Vistaの場合）。

注意事項

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

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

cjlistpool（コネクションプールの一覧表示）

形式

J2EEリソースアダプタとしてデプロイされているリソースアダプタを指定する場合

cjlistpool [<サーバ名称>] [-nameserver <プロバイダURL>]
          -resname <リソースアダプタの表示名>
          [-resname <リソースアダプタの表示名> ...]

アプリケーションに含めて使用されるリソースアダプタを指定する場合

cjlistpool [<サーバ名称>] [-nameserver <プロバイダURL>]
          [-test]
          -name <アプリケーション名>
          -resname <リソースアダプタの表示名>
          [-resname <リソースアダプタの表示名> ...]

すべてのリソースアダプタを指定する場合

cjlistpool [<サーバ名称>] [-nameserver <プロバイダURL>] -resall

機能

J2EEリソースアダプタとしてデプロイされているリソースアダプタを指定する場合

指定されたJ2EEリソースアダプタのコネクションプールの情報を標準出力に出力します。

一度に複数のリソースアダプタのコネクションプールの情報を表示できます。表示できないリソースアダプタがあった場合でも，すべてのリソースアダプタに対して表示を試みます。

アプリケーションに含めて開始されているリソースアダプタを指定する場合

指定されたアプリケーションに含まれるリソースアダプタのコネクションプールの状態を標準出力に出力します。

一度に複数のリソースアダプタのコネクションプールの状態を表示できます。表示できないリソースアダプタがあった場合でも，すべてのリソースアダプタに対して表示を試みます。

すべてのリソースアダプタを指定する場合

起動されているすべてのリソースアダプタのコネクションプールの情報を標準出力に出力します。

なお，無効なコネクションプールは出力されません。

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-resname <リソースアダプタの表示名>

表示対象とするリソースアダプタの表示名を指定します。

Connector 1.5の場合，<リソースアダプタの表示名>!<コネクション定義識別子>で指定します。

-test

テストモードのアプリケーションに対してコマンドを実行する場合に指定します。

省略した場合，通常モードのアプリケーションに対してコマンドを実行します。

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

表示対象とするリソースアダプタを含んでいるアプリケーション名を指定します。

省略した場合，J2EEリソースアダプタとしてデプロイされているリソースアダプタが対象となります。

-resall

すべてのリソースアダプタを表示対象とする場合に指定します。

出力形式

<コネクションプールの状態>

表示されるコネクションプールの状態には，次のどれかの値が入ります。

running：開始状態

runningReserved：開始予約状態

resumingAutomatically：自動再開中状態

resumingManually：手動再開中状態

blockedAutomatically：自動閉塞状態

blockedManually：手動閉塞状態

suspendedAutomatically：自動一時停止状態

suspendedAutomaticallyReserved：自動一時停止予約状態

suspendedManually：手動一時停止状態

suspendedManuallyReserved：手動一時停止予約状態

invalid：不正状態

N/A：メンバリソースアダプタでない場合

<コネクションID>

コネクションIDを生成できない場合は「N/A」を出力します。

コネクションIDに関する詳細については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

入力例

形式1

cjlistpool MyServer -resname Rar1

形式2

cjlistpool MyServer -name App1 -resname Rar1

形式3

cjlistpool MyServer -resall

戻り値

0：

正常終了しました。

1：

異常終了しました。

3：

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

9：

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

注意事項

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

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

コネクションプールの状態にinvalidが出力された場合，メンバリソースアダプタをアンデプロイして再度デプロイしたあとに，再開始する必要があります。対処できない場合は，保守情報を取得して保守員に連絡してください。

cjlistrar（リソースアダプタの一覧表示）

形式

リソースアダプタの状態表示の場合

cjlistrar [<サーバ名称>] [-nameserver <プロバイダURL>] [-clusterpool]
         [-spec]

コネクション定義識別子の一覧表示の場合

cjlistrar [<サーバ名称>] [-nameserver <プロバイダURL>]
         {-resname <リソースアダプタの表示名> -outbound|

メッセージリスナのタイプの一覧表示の場合

          -resname <リソースアダプタの表示名> -inbound|

アクティブ化のために設定が必要なプロパティ名の一覧表示の場合

          -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について」を参照してください。

-clusterpool

コネクションプールの状態を表示する場合に指定します。コネクションプールのクラスタ化機能を使用している場合に有効になります。

-spec

コネクタアーキテクチャのバージョンを表示する場合に指定します。

次のどちらかのコネクタアーキテクチャのバージョンが表示されます。

Connector 1.0

Connector 1.5

-resname <リソースアダプタの表示名>

表示対象となるリソースアダプタ名を指定します。

-outbound

RARファイルに含まれるOutboundリソースアダプタのコネクション定義識別子を表示する場合に，-resnameとともに指定します。

-inbound

RARファイルに含まれるInboundリソースアダプタのメッセージリスナのタイプを表示する場合に，-resnameとともに指定します。

-listenertype <メッセージリスナのタイプ名>

指定したメッセージリスナのアクティブ化のために設定が必要なプロパティ名を表示する場合に，-resnameとともに指定します。

出力形式

-clusterpoolを指定しない場合

<リソースアダプタの状態> <リソースアダプタ名>
<リソースアダプタの状態> <リソースアダプタ名>
・・・

<リソースアダプタの状態>には，次のどちらかの値が入ります。

running：開始状態

stopped：停止状態

-clusterpoolを指定した場合

<リソースアダプタの状態> <コネクションプールの状態> <リソースアダプタ名>
<リソースアダプタの状態> <コネクションプールの状態> <リソースアダプタ名>
・・・

<コネクションプールの状態>には，次のどれかの値が入ります。

running：開始状態

runningReserved：開始予約状態

resumingAutomatically：自動再開中状態

resumingManually：手動再開中状態

blockedAutomatically：自動閉塞状態

blockedManually：手動閉塞状態

suspendedAutomatically：自動一時停止状態

suspendedAutomaticallyReserved：自動一時停止予約状態

suspendedManually：手動一時停止状態

suspendedManuallyReserved：手動一時停止予約状態

invalid：不正状態

N/A：メンバリソースアダプタでない場合

-specを指定した場合

<リソースアダプタの状態> <コネクタアーキテクチャの仕様バージョン> <リソースアダプタ名>
<リソースアダプタの状態> <コネクタアーキテクチャの仕様バージョン> <リソースアダプタ名>
・・・

-clusterpoolと-specを指定した場合

<リソースアダプタの状態> <コネクションプールの状態> <コネクタアーキテクチャの仕様バージョン> <リソースアダプタ名>
<リソースアダプタの状態> <コネクションプールの状態> <コネクタアーキテクチャの仕様バージョン> <リソースアダプタ名>
・・・

-resnameと-outboundを指定した場合

<コネクション定義識別子>
<コネクション定義識別子>
・・・

-resnameと-inboundを指定した場合

<メッセージリスナのタイプ>
<メッセージリスナのタイプ>
・・・

-resnameと-listenertypeを指定した場合

<プロパティ名>
<プロパティ名>
・・・

入力例

cjlistrar MyServer

戻り値

0：

正常終了しました。

1：

異常終了しました。

3：

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

9：

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

注意事項

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

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

一覧は大文字小文字の区別なしで，昇順でソートされます。

コネクションプールの状態にinvalidが出力された場合，メンバリソースアダプタをアンデプロイして再度デプロイしたあとに，再開始する必要があります。対処できない場合は，保守情報を取得して保守員に連絡してください。

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 Vistaの場合）。

注意事項

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

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

一覧は大文字小文字の区別なしで，昇順でソートされます。

cjresumepool（メンバコネクションプールの再開始）

形式

cjresumepool [<サーバ名称>] [-nameserver <プロバイダURL>]
            -resname <リソースアダプタ表示名>
            [-resname <リソースアダプタ表示名> ...]

機能

指定したクラスタコネクションプールのメンバコネクションプールを再開します。一度に複数のメンバコネクションプールの再開もできます。再開に失敗したメンバコネクションプールがあった場合でも，すべてのメンバコネクションプールに対して再開を試みます。一つでも再開できなかった場合は，異常終了します。

このコマンドは1.4モードで実行します。ベーシックモードで実行した場合は，異常終了となります。

リソースアダプタが開始状態の場合，このコマンドを実行すると，メンバコネクションプールは手動再開中状態になります。次に，メンバコネクションプールのウォーミングアップ機能が有効な場合は，メンバコネクションプール内にコネクションをプールし，その後，メンバコネクションプールは開始状態となります。

リソースアダプタが停止状態の場合，このコマンドを実行すると，メンバコネクションプールは開始予約状態になります。

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-resname <リソースアダプタ表示名>

再開対象となるメンバリソースアダプタの表示名を指定します。

クラスタコネクションプールのメンバリソースアダプタでないリソースアダプタを指定した場合，異常終了となります。

この引数は，指定したリソースアダプタの開始/停止状態に関係なく，このコマンド自体を実行できます。ただし，メンバコネクションプールの状態によって，コマンドを実行できる場合とできない場合があります。詳細は次の表を参照してください。

メンバコネクションプールの状態
コマンドの実行可否

自動一時停止状態
手動一時停止状態
自動一時停止予約状態
手動一時停止予約状態
実行可能

開始状態
開始予約状態
自動再開中状態
手動再開中状態
自動閉塞状態
手動閉塞状態
実行不可

入力例

cjresumepool MyServer -resname DB_Connector_for_Oracle_ClusterPool_Member

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

3：

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

9：

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

注意事項

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

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

cjsetjbprop（JavaBeansリソースの属性設定）

形式

cjsetjbprop [<サーバ名称>] [-nameserver <プロバイダURL>]
           -resname <JavaBeansリソース表示名> -c <属性ファイルパス>

機能

-resnameで指定されたJavaBeansリソースの属性を，指定したJavaBeansリソース属性ファイルの値に変更します。JavaBeansリソース属性ファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

指定したJavaBeansリソースは存在している必要があります。

JavaBeansリソースの表示名は，属性ファイルのdisplay-nameタグで指定したものに置き換わります。

すでにスタート状態にあるJavaBeansリソースの属性は変更できません。

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-resname <JavaBeansリソース表示名>

設定対象のJavaBeansリソース表示名を指定します。

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

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

入力例

cjsetjbprop MyServer -resname MyJavaBEansName -c MyJavaBeansPorp.xml

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

3：

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

9：

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

注意事項

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

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

cjsetrarprop（RAR属性設定）

形式

cjsetrarprop ［<サーバ名称>］［-nameserver <プロバイダURL>］
             -resname <リソースアダプタ表示名> -c <属性ファイルパス>

機能

-resnameに指定されたデプロイ済みのRARファイルに含まれるリソースの属性を属性ファイルに指定された値に変更します。

RARファイルの属性を設定するのは，Connector属性ファイルです。Connector属性ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

リソースの表示名は，属性ファイルのdisplay-nameタグで指定したものに置き換わります。

引数

<サーバ名称>

接続先サーバ名称を指定します。サーバ名称を省略したときは，ホスト名称がサーバ名称となります。

-nameserver <プロバイダURL>

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

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

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

-resname <リソースアダプタ表示名>

設定対象リソース（デプロイ済みのリソースアダプタ）の表示名を指定します。

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

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

入力例

cjsetrarprop MyServer -resname account-rar -c MyRarprop.xml

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

3：

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

9：

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

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<リソースアダプタ表示名> -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アプリケーションとリソースの設定で使用する属性ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

引数

<サーバ名称>

接続先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 Vistaの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<リソース表示名> -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タグで指定したものに置き換わります。

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 Vistaの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダ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 Vistaの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<リソースアダプタ表示名> -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 Vistaの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<アプリケーション名> -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 Vistaの場合）。

注意事項

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

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

cjsuspendpool（メンバコネクションプールの一時停止）

形式

cjsuspendpool [<サーバ名称>] [-nameserver <プロバイダURL>]
             -resname <リソースアダプタ表示名>
             [-resname <リソースアダプタ表示名> ...]

機能

クラスタコネクションプールのメンバコネクションプールを一時停止します。一度に複数のメンバコネクションプールの一時停止もできます。一時停止に失敗したメンバコネクションプールがある場合でも，すべてのメンバコネクションプールに対して一時停止を試みます。どれか一つでも一時停止できなかった場合は異常終了となります。

1.4モードで実行する場合だけ有効です。ベーシックモードで実行した場合には，異常終了となります。

リソースアダプタが開始状態のときに，このコマンドを実行すると，メンバコネクションプールは手動閉塞状態になり，コマンドは終了します。その後，J2EEサーバでは一時停止処理が行われます。一時停止処理が完了すると，メンバコネクションプールは手動一時停止状態になります。

リソースアダプタが停止状態のときに，このコマンドを実行すると，メンバコネクションプールは手動一時停止予約状態になります。

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-resname <リソースアダプタ表示名>

一時停止対象となるメンバリソースアダプタの表示名を指定します。

クラスタコネクションプールのメンバリソースアダプタの表示名以外を指定した場合，異常終了となります。

この引数は，指定したリソースアダプタの開始/停止状態に関係なく，このコマンド自体を実行できます。ただし，メンバコネクションプールの状態によって，コマンドを実行できる場合とできない場合があります。詳細は次の表を参照してください。

メンバコネクションプールの状態
コマンドの実行可否

開始状態
開始予約状態
自動一時停止状態
自動一時停止予約状態
実行可能

手動一時停止状態
手動一時停止予約状態
自動再開中状態
手動再開中状態
自動閉塞状態
手動閉塞状態
実行不可

入力例

cjsuspendpool MyServer -resname DB_Connector_for_Oracle_ClusterPool_Member

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

3：

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

9：

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

注意事項

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

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

cjtestres（リソースの接続テスト）

形式

データソースおよびメールの場合

cjtestres [<サーバ名称>] [-nameserver <プロバイダURL>]
         -type {datasource|mail}
         -resname <表示名> [-resname <表示名> ...]

J2EEリソースアダプタとしてデプロイして使用するリソースアダプタの場合

cjtestres [<サーバ名称>] [-nameserver <プロバイダURL>]
         -type rar
         -resname <表示名> [-resname <表示名> ...]

アプリケーションに含めて使用するリソースアダプタの場合

cjtestres [<サーバ名称>] [-nameserver <プロバイダURL>]
         [-test] -name <アプリケーション名> -type rar
         -resname <表示名> [-resname <表示名> ...]

機能

J2EEリソースアダプタ，メールおよびデータソースの接続テストをします。

リソースアダプタにコネクション定義が複数ある場合，すべてのコネクション定義に対して接続テストを行います。コネクション定義のどれかでエラーが発生した場合でもすべてのコネクション定義に対して接続テストを実行します。

なお，Inboundリソースアダプタの接続テストはできません。

引数

<サーバ名称>

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

-nameserver <プロバイダURL>

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

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

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

-test

テストモードのアプリケーションに対してコマンドを実行する場合に指定します。

省略した場合，通常モードのアプリケーションに対してコマンドを実行します。

-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 Vistaの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<表示名> -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 Vistaの場合）。

注意事項

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

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

一度に複数のリソースアダプタをアンデプロイする場合，削除できないリソースアダプタがあるときでも，すべてのリソースアダプタの削除を試みます。

一度でも開始・接続テストを試みたJ2EEリソースアダプタは，J2EEサーバを再起動するまでアンデプロイできません。

2.5　J2EEサーバで使用するその他のコマンド

ここでは，J2EEサーバで使用するその他のコマンドについて説明します。

J2EEサーバで使用するその他のコマンドの一覧を，次の表に示します。

表2-6　J2EEサーバで使用するその他のコマンドの一覧

コマンド名称
分類
概要
コマンドの系統

cjaddsec
ユーザとロールの追加
ユーザまたはロールを追加します。
更新

cjdeletesec
ユーザとロールの削除
ユーザまたはロールを削除します。
更新

cjlistsec
ユーザとロールの一覧表示
ユーザまたはロールの一覧を標準出力に出力します。
参照

cjlistthread
スレッド情報の表示
処理中のスレッドに関する情報を出力します。
テストモードで実行できます。
参照

cjlisttrn
稼働中のJ2EEサーバのトランザクション情報の表示
J2EEサーバで稼働しているトランザクション情報の一覧を標準出力に出力します。
特権

cjlisttrnfile
停止中のJ2EEサーバのトランザクション情報の表示
停止中のJ2EEサーバのトランザクション情報の一覧を標準出力に出力します。
－

cjmapsec
ユーザとロールのマッピング
ロールにユーザを追加します。
更新

cjresetsv
サーバ管理コマンドの排他強制解除
サーバ管理コマンドの排他情報をリセットして，サーバ管理コマンドを実行できるようにします。
－

cjstopthread
スレッドの削除
指定したスレッドを削除します。
テストモードで実行できます。
更新

cjtracesync
インプロセスHTTPサーバ用トレースファイルの同期
インプロセスHTTPサーバのトレース情報を共有メモリの情報と同期させます。
－

cjunmapsec
ユーザとロールのアンマッピング
ロールからユーザを削除します。
更新

（凡例）

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

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

特権：特権系コマンド。J2EEサーバの内容を更新するコマンドで，常にほかのコマンドよりも優先して処理されるコマンドです。

－：該当なし

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

＜この節の構成＞

cjaddsec（ユーザとロールの追加）

cjdeletesec（ユーザとロールの削除）

cjlistsec（ユーザとロールの一覧表示）

cjlistthread（スレッド情報の表示）

cjlisttrn（稼働中のJ2EEサーバのトランザクション情報の表示）

cjlisttrnfile（停止中のJ2EEサーバのトランザクション情報の表示）

cjmapsec（ユーザとロールのマッピング）

cjresetsv（サーバ管理コマンドの排他強制解除）

cjstopthread（スレッドの削除）

cjtracesync（インプロセスHTTPサーバ用トレースファイルの同期）

cjunmapsec（ユーザとロールのアンマッピング）

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 Vistaの場合）。

注意事項

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

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

すでに存在するユーザ名またはロール名は指定できません。

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 Vistaの場合）。

注意事項

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

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

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 Vistaの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダ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 Vistaの場合）。

注意事項

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

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

cjlisttrn（稼働中のJ2EEサーバのトランザクション情報の表示）

形式

cjlisttrn [<サーバ名称>] [-nameserver <プロバイダURL>]
         [-gid <グローバルトランザクションID>] [-pending]
         [-time <経過時間>] [-bqual]

機能

J2EEサーバで稼働しているトランザクションの状態，経過時間などを一覧表示します。

同一OS上で複数のJ2EEサーバを起動している場合は，トランザクションに関連するすべてのJ2EEサーバプロセスごとにcjlisttrnコマンドを発行する必要があります。

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）の設定が，次の場合に実行できます。

ejbserver.server.j2ee.featureキーの値が，1.4の場合

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を表示します。

入力例

cjlisttrn MyServer -gid d13800010000000000000000000000fefb57e6480000000000000001 -bqual

出力形式

[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が表示されます。

<表示エントリ数>

表示したエントリの数が表示されます。

戻り値

0：

正常終了しました。

1：

異常終了しました。

3：

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

9：

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

注意事項

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

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

-gidオプション，-pendingオプション，および-timeオプションを同時に指定した場合，すべての条件を満たすトランザクションについての情報が出力されます。

cjlisttrnfile（停止中のJ2EEサーバのトランザクション情報の表示）

形式

cjlisttrnfile [<サーバ名称>] [-gid <グローバルトランザクションID>]
             [-bqual]

機能

停止中のJ2EEサーバに生成されたステータスファイルからトランザクションの状態などを一覧表示します。コマンドを実行するホストに存在するJ2EEサーバだけがコマンドの対象となります。

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）に次のように設定され，J2EEサーバが起動されたことがある場合に実行できます。

ejbserver.server.j2ee.featureキーの値が，1.4の場合

ejbserver.distributedtx.XATransaction.enabledキーの値が，trueの場合

引数

<サーバ名称>

接続先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 Vistaの場合）。

注意事項

別のホストに存在する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 Vistaの場合）。

注意事項

コマンドの引数にサーバ名称を指定する場合，コマンド名の直後にする必要があります。そのほかの引数は，サーバ名称より後ろ（サーバ名称を省略した場合はコマンド名の後ろ）にあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プロバイダ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 Vistaの場合）。

注意事項

このコマンドは，コマンドの処理がJ2EEサーバ側で実行中でない場合にだけ排他情報を削除します。コマンドの処理が実行中のため排他情報を削除できなかった場合は，エラーメッセージKDJE42355-Wを出力し，異常終了します。

コマンド排他情報が存在しない場合，このコマンドは正常終了します。

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

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

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 Vistaの場合）。

注意事項

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

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

cjtracesync（インプロセスHTTPサーバ用トレースファイルの同期）

形式

cjtracesync [-h] [-thr|-comm] <サーバ名称>

機能

インプロセスHTTPサーバ使用時に，スレッドトレースおよび通信トレースの情報を共有メモリの情報と同期させます。インプロセスHTTPサーバを使用している場合に，Management Serverの機能を利用しないで障害情報を取得するときには，情報を取得する直前に，このコマンドを実行してください。

引数

-h

コマンドの使用方法が表示されます。

-thr

スレッドトレース情報を取得する場合に指定します。-thrオプション，-commオプションのどちらも指定されていない場合，スレッドトレースおよび通信トレースの両方の情報を更新します。

-comm

通信トレース情報を取得する場合に指定します。-thrオプション，-commオプションのどちらも指定されていない場合，スレッドトレースおよび通信トレースの両方の情報を更新します。

<サーバ名称>

トレース情報を取得するJ2EEサーバのサーバ名称を指定します。サーバ名称は必ず指定してください。

戻り値

0：

正常終了しました。

1：

異常終了しました。

9：

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

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 Vistaの場合）。

注意事項

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

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

一度に複数のユーザをアンマップした場合，アンマップできないユーザがあったときでも，すべてのユーザに対してアンマップを試みます。

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

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

＜この章の構成＞

3.1　バッチサーバで使用するコマンドの概要

3.2　バッチサーバを操作するコマンド

3.3　バッチアプリケーションで使用するコマンド

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

3.5　バッチサーバで使用するその他のコマンド

3.1　バッチサーバで使用するコマンドの概要

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

＜この節の構成＞

(1)　バッチサーバで使用するコマンドの種類

(2)　プロバイダURLについて

(1)　バッチサーバで使用するコマンドの種類

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

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

表3-1　バッチサーバで使用するコマンドの種類と格納先

バッチサーバで使用するコマンドの種類
コマンドの格納先

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥bin¥

UNIXの場合
/opt/Cosminexus/CC/server/bin/

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥batch¥bin¥

UNIXの場合
/opt/Cosminexus/CC/batch/bin/

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥

UNIXの場合
/opt/Cosminexus/CC/admin/bin/

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

(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 | 作業ディレクトリおよびユーザ定義ファイルの移行 | Cosminexus Component Containerの旧環境で利用されていた作業ディレクトリおよびユーザ定義ファイルを新環境で動作する形式に移行します。 | －
cjgetsysinfo※1 | OS状態情報の取得 | OSの状態情報を取得します。 | －
cjrarupdate※1 | リソースアダプタのバージョンアップ | Cosminexus Component Containerにインポート・デプロイされているリソースアダプタをバージョンアップします。 | －
cjsetup | バッチサーバのセットアップとアンセットアップ | バッチサーバの環境をセットアップして，デフォルトのユーザ定義を作成します。 | －
cjsleep※1 | バッチサーバの起動間隔 | 指定された秒数だけ実行を一時停止します。バッチファイルなどでサーバの起動間隔を空けるために使用します。このコマンドは，Windows用です。 | －
cjstartsv | バッチサーバの開始 | バッチサーバを開始します。 | －
cjstopsv※1 | バッチサーバの停止 | バッチサーバを停止します。 | 更新※2

（凡例）

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

－：該当なし

注※1

コマンドの詳細は，「2.2　J2EEサーバを操作するコマンド」を参照してください。なお，参照する場合は「J2EEサーバ」を「バッチサーバ」と読み替えてください。

注※2

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

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

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

＜この節の構成＞

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

cjstartsv（バッチサーバの開始）

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

形式

セットアップの場合

cjsetup -batch [<サーバ名称>]

アンセットアップの場合

cjsetup -d <サーバ名称>

機能

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

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/

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

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥repository¥<サーバ名称>¥

UNIXの場合
/opt/Cosminexus/CC/server/repository/<サーバ名称>/

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥public¥ejb¥<サーバ名称>¥

UNIXの場合
/opt/Cosminexus/CC/server/public/ejb/<サーバ名称>/

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

引数

<サーバ名称>

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

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

-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 <サーバ名称>）を実行しないでください。

cjstartsv（バッチサーバの開始）

形式

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

機能

指定したサーバ名称のバッチサーバを開始します。サーバ名称を省略したときは，ホスト名称と同じサーバ名称のバッチサーバを開始します。

引数

<サーバ名称>

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

-nosecurity

SecurityManagerを解除するために指定します。

ユーザ定義ファイル

Windowsの場合

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

<Cosminexusのインストールディレクトリ>¥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システムをログオフした。

注意事項

バッチサーバを自動起動するように設定できます。バッチサーバの起動については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

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

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

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

3.3　バッチアプリケーションで使用するコマンド

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

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

表3-3　バッチアプリケーションで使用するコマンドの一覧

コマンド名称 | 分類 | 概要 | コマンドの系統
cjexecjob | バッチアプリケーションの実行 | バッチアプリケーションを実行します。 | －
cjkilljob | バッチアプリケーションの停止またはバッチサーバの強制停止 | バッチアプリケーションを停止します。バッチアプリケーションの停止に失敗した場合，バッチサーバを強制停止します。 | －

（凡例）

－：該当なし　

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

＜この節の構成＞

cjexecjob（バッチアプリケーションの実行）

cjkilljob（バッチアプリケーションの停止またはバッチサーバの強制停止）

cjexecjob（バッチアプリケーションの実行）

形式

cjexecjob <サーバ名称> [[<Javaオプション>]...]
         <Javaアプリケーションクラス名>
         [[<mainメソッドに渡す引数>]...]

機能

指定したサーバ名称のバッチサーバで，バッチアプリケーションを実行します。<Javaオプション>以降の引数には最大1024バイトまで指定できます。

cjexecjobコマンドを実行した場合，およびcjexecjobコマンドの処理が終了した場合は，メッセージが出力されます。cjexecjobコマンドが出力するメッセージは，usrconf.cfg（バッチアプリケーション用オプション定義ファイル）のbatch.log.stdout.enabledキーによって抑止できます。

cjexecjobコマンドのオプションは，usrconf.cfg（バッチアプリケーション用オプション定義ファイル）で指定します。また，システムプロパティは，usrconf.properties（バッチアプリケーション用ユーザプロパティファイル）で指定します。usrconf.cfg（バッチアプリケーション用オプション定義ファイル）およびusrconf.properties（バッチアプリケーション用ユーザプロパティファイル）が格納されているディレクトリは，次の順で検索されます。

環境変数（CJBATCHUSRCONFDIR）に指定したディレクトリ

cjexecjobコマンドを実行したディレクトリ

同じキーのシステムプロパティを複数指定した場合，最後に指定したシステムプロパティが優先されます。

同じキーのシステムプロパティを異なる手段で指定した場合の優先順位は次のとおりです。

cjexecjobコマンドの引数

usrconf.properties（バッチアプリケーション用ユーザプロパティファイル）

usrconf.cfg（バッチアプリケーション用オプション定義ファイル）

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

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

引数

<サーバ名称>

バッチアプリケーションを実行するバッチサーバの名称を指定します。

<Javaオプション>

JavaVMの起動オプションを指定します。

指定できるオプションを次に示します。

-cp

-classpath

-D<name>=<value>

<Javaアプリケーションクラス名>

パッケージ名を含めたJavaアプリケーションのクラス名を指定します。

<mainメソッドに渡す引数>

Javaアプリケーションのmainメソッドに渡す引数を指定します。

入力例

cjexecjob MyBatchServer com.hitachi.mypackage.MyBatchApp

戻り値

<public static int main(String[])メソッドからreturnした値>：

public static int main(String[])メソッドを使用した場合に返却されます。

0：

public static void main(String[])メソッドを使用して，正常終了しました。

1：

バッチアプリケーションの実行に失敗しました。

または，バッチアプリケーションを強制終了しました。

注意事項

UNIXの場合，バッチサーバを起動したComponent Container管理者またはスーパーユーザがコマンドを実行できます。

Windowsの場合，Administrator権限を持つユーザがコマンドを実行できます。

Windows Vistaの場合，管理者特権を持つユーザがコマンドを実行できます。

サーバ名称は，バッチサーバのセットアップ時に指定したサーバ名称と大文字・小文字を一致させた文字列を指定してください。

クラスパスを複数指定した場合，すべての指定が有効になります。例えば，"-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）

cjkilljob（バッチアプリケーションの停止またはバッチサーバの強制停止）

形式

cjkilljob <サーバ名称>

機能

指定したサーバ名称のバッチサーバ上で実行中のバッチアプリケーションを停止します。実行中のバッチアプリケーションの停止に失敗した場合，バッチサーバを強制停止します。

引数

<サーバ名称>

停止するバッチアプリケーションを実行中のバッチサーバの名称を指定します。

入力例

cjkilljob MyBatchServer

戻り値

0：

バッチアプリケーションを停止しました。

1：

バッチサーバを強制停止しました。

2：

異常終了しました。

注意事項

UNIXの場合，バッチサーバを起動したComponent Container管理者またはスーパーユーザがコマンドを実行できます。
Windowsの場合，Administrator権限を持つユーザがコマンドを実行できます。
Windows Vistaの場合，管理者特権を持つユーザがコマンドを実行できます。

サーバ名称は，バッチサーバのセットアップ時に指定したサーバ名称と大文字・小文字を一致させた文字列を指定してください。

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

ここでは，バッチサーバで使用するリソース操作コマンドについて説明します。

コマンドの詳細は，「2.4　J2EEサーバで使用するリソース操作コマンド」を参照してください。なお，参照する場合は「J2EEサーバ」を「バッチサーバ」と読み替えてください。

バッチサーバで使用するリソース操作コマンドの一覧を，次の表に示します。

表3-4　バッチサーバで使用するリソース操作コマンドの一覧

コマンド名称 | 分類 | 概要 | コマンドの系統
cjclearpool | コネクションプール内のコネクション削除 | リソースアダプタのコネクションをクリアします。 | 更新
cjcopyres | リソースのコピー | RARファイルのプロパティをコピーします。 | 更新
cjdeleteres | リソースの削除 | インポート済みのRARファイルを削除します。 | 更新
cjdeployrar | リソースアダプタのデプロイ | リソースアダプタをデプロイします。 | 更新
cjexportrar | リソースアダプタのエクスポート | バッチサーバ上のリソースアダプタをエクスポートします。 | 更新
cjgetrarprop | RARファイルの属性の取得 | デプロイ済みのRARファイルの属性を取得して，属性ファイルを生成します。 | 更新
cjgetresprop | リソースの属性の取得 | デプロイ前のRARファイルに含まれるリソースの属性を取得して，属性ファイルを生成します。 | 更新
cjimportres | リソースのインポート | RARファイルをインポートします。 | 更新
cjlistpool | コネクションプールの一覧表示 | 指定されたリソースアダプタ，またはすべてのリソースアダプタのコネクションプール状態を標準出力に出力します。 | 参照
cjlistrar | リソースアダプタの一覧表示 | デプロイされているすべてのリソースアダプタの一覧を標準出力に出力します。 | 参照
cjlistres | リソースの一覧表示 | インポート済みのRARファイルの一覧を標準出力に出力します。 | 参照
cjresumepool | メンバコネクションプールの再開始 | クラスタコネクションプールのメンバコネクションプールを再開します。 | 更新
cjsetrarprop | RAR属性設定 | デプロイ済みのRARファイルに含まれるリソースの属性を属性ファイルに指定された値に変更します。 | 更新
cjsetresprop | リソースの属性設定 | デプロイ前のRARファイルに含まれるリソースの属性を，属性ファイルに指定された値に変更します。 | 更新
cjstartrar | リソースアダプタの開始 | リソースアダプタを開始します。 | 更新
cjstoprar | リソースアダプタの停止 | 開始されているリソースアダプタを停止します。 | 更新
cjsuspendpool | メンバコネクションプールの一時停止 | クラスタコネクションプールのメンバコネクションプールを一時停止します。 | 更新
cjundeployrar | リソースアダプタのアンデプロイ | デプロイされているリソースアダプタをアンデプロイします。 | 更新

（凡例）

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

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

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

3.5　バッチサーバで使用するその他のコマンド

ここでは，バッチサーバで使用するその他のコマンドについて説明します。

コマンドの詳細は，「2.5　J2EEサーバで使用するその他のコマンド」を参照してください。なお，参照する場合は「J2EEサーバ」を「バッチサーバ」と読み替えてください。

バッチサーバで使用するその他のコマンドの一覧を，次の表に示します。

表3-5　バッチサーバで使用するその他のコマンドの一覧

コマンド名称 | 分類 | 概要 | コマンドの系統
cjresetsv | サーバ管理コマンドの排他強制解除 | サーバ管理コマンドの排他情報をリセットして，サーバ管理コマンドを実行できるようにします。 | －

（凡例）

－：該当なし　

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

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

この章では，性能解析トレースで使用するコマンドの入力形式，機能などについて説明します。

＜この章の構成＞

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

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

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の場合
<Cosminexusのインストールディレクトリ>¥PRF¥bin¥

UNIXの場合
/opt/Cosminexus/PRF/bin/

＜この節の構成＞

cprfed（性能解析トレース情報の編集出力）

cprfflush（バッファ内容の強制ファイル出力）

cprfgetpid（PRFデーモンプロセスIDの取得）

cprflevel（PRFトレース取得レベルの表示と変更）

cprfstart（PRFデーモンの開始）

cprfstop（PRFデーモンの停止）

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オプションと同時に指定できません。

指定できるコマンドオプションの組み合わせの一覧を次に示します。

表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：

PRFデーモンが正常に停止しました。

0以外：

コマンド処理中にエラーが発生しました。出力されたメッセージに従って対策したあと，再度コマンドを実行してください。エラーメッセージは標準エラー出力，ログファイルに出力されます。資料の取得方法については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

出力形式

出力形式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およびリダイレクタで取得したトレース情報には，スレッドのハッシュ値が出力されない場合があります。

注※

インタフェース名，オペレーション名，アクセプタ名，ルックアップ名が33文字を超える場合は，次のように編集され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トレース出力時に排他制御を行っていません。そのため，一部トレース情報が正しく出力されない場合があります。

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環境変数が設定されていません。

上記以外：

コマンド処理中にエラーが発生しました。出力されたメッセージに従って対策したあと，再度コマンドを実行してください。エラーメッセージは標準エラー出力，ログファイルに出力されます。資料の取得方法については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

注意事項

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環境変数が設定されていません。

上記以外：

コマンド処理中にエラーが発生しました。出力されたメッセージに従って対策したあと，再度コマンドを実行してください。エラーメッセージは標準エラー出力，ログファイルに出力されます。資料の取得方法については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

入力例・出力例

入力例

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けたの値）で指定します。各インデックス番号に対応するレベル値をコンマ（,）区切りで左から複数指定できます。該当するインデックスのレベル値を変更しない場合は，値を指定しないでください。また，あるインデックス番号以降の値をすべて指定しない場合は，コンマ（,）の記述を省略してください。インデックス番号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けた目
Cosminexus Web Services - Base
uCosminexus TP1 Connector，
TP1/Client/J

6けた目
TP1/Message Queue - Access
Cosminexus RM

7けた目
OTS
－

8けた目
CTM
－

インデックス2
1けた目
HCSCサーバ
標準出力/標準エラー出力/ユーザログ

2けた目
DI
－

（凡例）－：該当する機能レイヤがありません。

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環境変数が設定されていません。

上記以外：

コマンド処理中にエラーが発生しました。出力されたメッセージに従って対策したあと，再度コマンドを実行してください。エラーメッセージは標準エラー出力，ログファイルに出力されます。資料の取得方法については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

入力例・出力例

入力例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 | 指定 | － | KAFCT73419-I
未指定 | KAFCT73418-I | KAFCT73415-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]

機能

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けたの値）で指定します。各インデックス番号のレベル値をコンマ（,）区切りで左から複数指定できます。レベル値の指定を省略する場合は，値を記述しないでください。また，あるインデックス番号以降の値をすべて指定しない場合は，コンマ（,）の記述を省略してください。インデックス番号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けた目
Cosminexus Web Services - Base
uCosminexus TP1 Connector，
TP1/Client/J

6けた目
TP1/Message Queue - Access
Cosminexus RM

7けた目
OTS
－

8けた目
CTM
－

インデックス2
1けた目
HCSCサーバ
標準出力/標準エラー出力/ユーザログ

2けた目
DI
－

（凡例）－：該当する機能レイヤがありません。

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もデフォルト値より小さい値を指定してください。

正常停止中と前回強制停止後の再起動中に，PRFトレースファイルをバックアップします。PRFトレースファイルサイズの合計値が大きい場合，バックアップ処理でPRFデーモンの起動や停止に時間がかかることがあります。そのため，Management Serverでプロセス監視する場合，デフォルトの監視時間ではタイムアウトが発生する場合があります。タイムアウトが発生した場合には，監視時間を長くしてください。

-PrfTraceBufferSize <PRFトレースバッファサイズ>

共用メモリに確保するバッファサイズを512～102400（単位：キロバイト）の範囲で指定します。このオプションには，-PrfTraceFileSizeで指定した値よりも大きい値は指定できません。省略した場合は，8192が設定されます。

バッファ領域が不足するとKFCT26999-Wメッセージが出力され，PRFトレースが欠落する場合があります。そのため，メッセージが出力されなくなるまでバッファ領域を拡張してください。

-PrfRemakeBuffer

共用メモリを再作成して起動します。再作成できない場合にはエラーとなります。

戻り値

0：

PRFデーモンが正常に起動しました。

1：

PRFデーモンの起動に失敗しました。PRFSPOOL環境変数が設定されていません。

上記以外：

コマンド処理中にエラーが発生しました。出力されたメッセージに従って対策したあと，再度コマンドを実行してください。エラーメッセージは標準エラー出力，ログファイルに出力されます。資料の取得方法については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

注意事項

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：

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

上記以外：

コマンド処理中にエラーが発生しました。出力されたメッセージに従って対策したあと，再度コマンドを実行してください。エラーメッセージは標準エラー出力，ログファイルに出力されます。資料の取得方法については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

注意事項

コマンドがタイムアウトして，PRFデーモンが正常終了しなかった場合は，-Forceオプションを指定して強制停止してください。

停止するPRFデーモンと同じPRFSPOOL環境変数が設定されている必要があります。設定されていない場合，コマンドがエラーリターンします。

cprfstartコマンドの-PrfTraceCountまたは-PrfTraceFileSizeに大きな値を指定すると，PRFデーモンの正常停止に時間が掛かる場合があります。

5.　CTMで使用するコマンド

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

＜この章の構成＞

5.1　CTMで使用するコマンドの一覧

5.2　CTMで使用するコマンドの詳細

5.1　CTMで使用するコマンドの一覧

CTMで使用するコマンドは，ctmで始まります。CTMで使用するコマンドの一覧を，次の表に示します。

表5-1　CTMで使用するコマンドの一覧

コマンド名称 | 分類 | 概要
ctmchpara | スケジュールキューの同時実行数の変更 | CTMで管理するスケジュールキューの同時実行数を動的に変更します。
ctmdminfo | CTMドメイン情報の表示と削除 | CTMドメインに関する情報を表示または削除します。
ctmdmstart | CTMドメインマネジャの開始 | CTMドメインマネジャを開始します。
ctmdmstop | CTMドメインマネジャの終了 | CTMドメインマネジャを終了します。
ctmgetpid | プロセスIDの取得 | CTMドメインマネジャ，CTMデーモンのプロセスIDを取得します。
ctmholdque | スケジュールキューの閉塞 | スケジュールキューを閉塞します。
ctmjver | 実行形式ファイルおよびライブラリのバージョン情報の出力 | CTMが提供するjarファイルのバージョン情報を出力します。
ctmlogcat | メッセージの編集と出力 | CTMで出力したメッセージを編集して標準出力に出力します。
ctmlsque | スケジュールキュー情報の出力 | スケジュールキューのスケジューリング情報を標準出力に出力します。
ctmrasget | トラブルシュート情報の取得と出力 | CTMが必要とするトラブルシュート情報を取得し，出力します。
ctmregltd | CTMレギュレータの開始 | CTMレギュレータを開始します。
ctmridinfo | CTMドメイン情報の出力 | CTMドメイン情報を標準出力に出力します。
ctmrlesque | スケジュールキューの閉塞解除 | スケジュールキューの閉塞状態を解除します。
ctmstart | CTMデーモンの開始 | CTMデーモンを開始します。
ctmstop | CTMデーモンの終了 | CTMデーモンを終了します。
ctmstsed | 稼働統計情報の編集と出力 | 取得した稼働統計情報を必要な情報・出力形式に編集して出力します。
ctmstsflush | バッファ内容の強制ファイル出力 | バッファ内のリクエスト情報をファイルに出力します。
ctmstsstart | 稼働統計情報の取得開始 | 稼働統計情報ファイルへの情報の取得を開始します。
ctmstsstop | 稼働統計情報の取得終了 | 稼働統計情報ファイルへの情報の取得を終了します。
ctmtscgwd | OTMゲートウェイの開始 | OTMクライアントのリクエストをCTMで処理するためのゲートウェイプロセスを開始します。
ctmver | 実行形式ファイルおよびライブラリのバージョン情報の出力 | CTMが提供する実行形式ファイルおよびライブラリのバージョン情報を出力します。

5.2　CTMで使用するコマンドの詳細

CTMで使用する各コマンドの入力形式，機能などを次に示します。

コマンドの格納先

CTMで使用するコマンドは，次のディレクトリに格納されています。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CTM¥bin¥

UNIXの場合
/opt/Cosminexus/CTM/bin/

＜この節の構成＞

ctmchpara（スケジュールキューの同時実行数の変更）

ctmdminfo（CTMドメイン情報の表示と削除）

ctmdmstart（CTMドメインマネジャの開始）

ctmdmstop（CTMドメインマネジャの終了）

ctmgetpid（プロセスIDの取得）

ctmholdque（スケジュールキューの閉塞）

ctmjver（実行形式ファイルおよびライブラリのバージョン情報の出力）

ctmlogcat（メッセージの編集と出力）

ctmlsque（スケジュールキュー情報の出力）

ctmrasget（トラブルシュート情報の取得と出力）

ctmregltd（CTMレギュレータの開始）

ctmridinfo（CTMドメイン情報の出力）

ctmrlesque（スケジュールキューの閉塞解除）

ctmstart（CTMデーモンの開始）

ctmstop（CTMデーモンの終了）

ctmstsed（稼働統計情報の編集と出力）

ctmstsflush（バッファ内容の強制ファイル出力）

ctmstsstart（稼働統計情報の取得開始）

ctmstsstop（稼働統計情報の取得終了）

ctmtscgwd（OTMゲートウェイの開始）

ctmver（実行形式ファイルおよびライブラリのバージョン情報の出力）

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ドメイン名称/"

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以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

ctmgetpid（プロセスIDの取得）

形式

ctmgetpid  [-h] | -CTMDomain <CTMドメイン名称> [-CTMID <CTM識別子>]
          [-CTMMyHost <ホスト名称またはIPアドレス>]

機能

プロセス監視を実行する場合に使用します。CTMドメインマネジャ，CTMデーモンのプロセス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コマンドで取得されるホスト名称が設定されます。

戻り値

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以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

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：

正常終了しました。出力するデータがない（KFOT73591-Iメッセージが出力された）場合，および-hオプションを指定した場合も0が返却されます。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

注意事項

ctmlogcatコマンド実行時には，CTMSPOOL環境変数が設定されている必要があります。

-tオプションを指定する場合，該当するCTM識別子の動作している実行環境に設定したCTMSPOOL環境変数が必要です。

-dオプションを指定する場合，CTMドメインマネジャ実行時に指定したCTMSPOOL環境変数が必要です。

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）の情報が繰り返し出力されます。

ctmrasget（トラブルシュート情報の取得と出力）

形式

ctmrasget { [-h] | [-p] [-s] [-CTMSpool <CTMスプールディレクトリ> |
         -CTMDomain <CTMドメイン名称>]
         [-PRFSpool <PRFデーモン実行環境ディレクトリ>] <出力先ディレクトリ>}

機能

ctmrasgetコマンドを実行するホスト上でCTMが必要とするトラブルシュート情報をファイルに取得し，取得した情報の一覧を標準出力または標準エラー出力に出力します。

引数

-h

コマンドの使用方法が表示されます。

-p

Cosminexus TPBrokerについてのトラブルシュート情報を出力先ディレクトリに出力します。あらかじめ，Cosminexus TPBrokerのVBROKER_ADM環境変数を設定してください。

-s

共通メッセージ（eventlogまたはsyslog）の取得を抑止します。

-CTMSpool <CTMスプールディレクトリ>

トラブルシュート情報を取得するCTMスプールディレクトリを指定します。

-CTMDomain <CTMドメイン名称>

トラブルシュート情報を取得するCTMドメイン名称を1～31文字の英数字，またはアンダースコア（_）で指定します。

省略した場合は，ホスト内のCTM環境に登録済みのすべてのCTMドメインからトラブルシュート情報を取得します。

-PRFSpool <PRFデーモン実行環境ディレクトリ>

トラブルシュート情報を取得するPRFデーモン実行環境ディレクトリを指定します。省略した場合はPRFSPOOL環境変数の値が設定されます。このオプションを省略し，かつPRFSPOOL環境変数が設定されていない場合は，PRFデーモンの情報は取得されません。

<出力先ディレクトリ>

トラブルシュート情報を出力するファイルのディレクトリ名（相対パスまたは絶対パス）を指定します。

戻り値

0：

正常終了しました。

0以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

出力形式

Cosminexus Component Transaction Monitor: RAS completed collection of aa...aa

（凡例）

aa...aa：収集する情報，ファイル名称など

注意事項

出力先ディレクトリにすでに同名のファイルがある場合は上書きされます。そのため，トラブルシュート情報を残しておきたい場合は，ファイルをコピーしておくか，新しく作成したディレクトリを出力先ディレクトリに指定してください。

ctmregltd（CTMレギュレータの開始）

形式

ctmregltd [-h] [-CTMDomain <CTMドメイン名称>] [-CTMID <CTM識別子>]
         [-PRFID <PRF識別子>] [-CTMMyHost <ホスト名称またはIPアドレス>]
         [-CTMClientConnectCount <コネクション数>]
         [-CTMEjbPort <EJBリクエスト受信ポート番号>]
         [-CTMAgent {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クライアントからの接続数です。省略した場合は"64"が設定されます。

-CTMEjbPort <EJBリクエスト受信ポート番号>

EJBクライアントがCTMレギュレータの新しいコネクションを探すときに使用するポート番号を5001～65535の整数で指定します。省略した場合は，OSが自動的に割り当てたポート番号を使用します。

-CTMAgent {1|0}

EJBに対応するCORBAオブジェクトをTPBrokerのOSAgentに登録するかどうかを指定します。ORBゲートウェイ機能を使用する場合は，"1"を指定します。省略した場合，または"0"が指定された場合は，OSAgentに登録しません。

-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 Hitachi"と指定してCTMデーモンを開始する場合，サービス名ファイルの次のように指定したエントリが読み込まれます。

CTM_JAPANHitachi                     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ユーザ環境変数定義ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

-CTMStartTimeOut <タイムアウト値>

CTMデーモンの開始処理の待ち時間（単位：秒）を0～2147483647の整数で指定します。"0"を指定した場合，無限に待ち続けます。省略した場合は"180"（秒）が設定されます。

-CTMEntryCount <登録プロセス数>

CTMデーモンで管理するプロセスの数を32～32767の整数で指定します。

省略した場合，-CTMServerConnectCountオプションと-CTMClientConnectCountオプションの指定値の合計が設定されます。

-CTMNice <nice値>

CTMデーモンが管理するサーバで使用する-CTMNiceオプションの指定値のデフォルトを整数で指定します。省略した場合は"0"が設定されます。指定値の範囲はOSが提供するniceの指定範囲に従います。

なお，-CTMNiceオプションはUNIXにしかありません。

-CTMClientConnectCount <接続クライアントの最大数>

CTMデーモンに接続するCTMレギュレータの最大数を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ノードで稼働統計情報を取得します。

-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オプションが有効にならない場合があります。

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以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

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 | 省略できます。

開始時刻を省略した場合は，ファイルの先頭から終了時刻までが出力範囲になります。終了時刻を省略した場合は，開始時刻からファイルの最後までが出力範囲になります。また，開始時刻と終了時刻の両方を省略した場合は，稼働統計情報ファイルのすべての情報が編集，出力されます。

-CTMQueueName <キュー名>[,<キュー名>...]

稼働統計情報を編集および出力するキュー名を1～63文字の英数字，またはアンダースコア（_）で指定します。

このオプションは，-CTMEditオプションに"que"を指定する場合，または-CTMEditオプションを省略する場合に指定できます。

-CTMMethod <メソッド名>[,<メソッド名>...]

稼働統計情報を編集および出力するメソッド名を指定します。

このオプションは，-CTMEditオプションに"mtd"を指定する場合，または-CTMEditオプションを省略する場合に指定できます。

-CTMCsv

編集および出力の結果をCSV形式（コンマで区切ったテキスト形式）で出力します。

-CTMStdout

編集および出力の結果を標準出力に出力します。

表5-2　引数（コマンドオプション）の組み合わせ一覧（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 | キュー名（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以外：

コマンド処理中にエラーが発生したため，異常終了しました。出力されるメッセージに従って対策したあと，再度コマンドを実行してください。

6.　Management Serverで使用するコマンド

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

＜この章の構成＞

6.1　Management Serverで使用するコマンドの一覧

6.2　Management Serverで使用するコマンドの詳細

6.3　mngsvrutilコマンドのサブコマンドの詳細

6.1　Management Serverで使用するコマンドの一覧

Management Serverで使用するコマンドの一覧を，次の表に示します。

表6-1　Management Serverで使用するコマンドの一覧

コマンド名称
分類
概要

adminagentcheck
運用管理エージェントの稼働確認
運用管理エージェントが稼働しているかどうかを確認します。

adminagentctl
運用管理エージェントの起動と停止
運用管理エージェントのサービスを起動または停止します。

daemon
デーモンプロセスの起動
Management Server，運用管理エージェントをデーモンプロセスとして起動します。
このコマンドは，UNIX用です。

kill
プロセスの強制停止
プロセスを強制終了します。
このコマンドは，Windows用です。

mngautorun
サービスの設定
Management Serverおよび運用管理エージェントのサービスの設定を変更します。
このコマンドは，Windows用です。

mngenvsetup
管理グループの設定
OSのグループをManager Sever管理グループ，統合ユーザ管理グループに設定します。
このコマンドは，UNIX用です。

mngsvr_adapter_setup
Cosminexusアダプタコマンドのセットアップとアンセットアップ
JP1/IM連携で使用するCosminexusアダプタコマンドのセットアップまたはアンセットアップを実行します。

mngsvr_monitor_setup
Cosminexusモニタ起動コマンドのセットアップとアンセットアップ
JP1/IM連携で使用するCosminexusモニタ起動コマンドのセットアップまたはアンセットアップを実行します。
このコマンドは，Windows用です。

mngsvrctl
Management Serverの起動／停止／セットアップ
Management Serverを起動または停止します。または，Management Serverの実行に必要なセットアップをします。

mngsvrupdate
Management Serverの移行コマンド
Management Serverで管理している情報を，最新のバージョンで使用する形式に移行します。

mngsvrutil
Management Serverの運用管理コマンド
Management Serverに接続して，運用管理ドメイン内での操作を実行します。

mstrexport
Management Server管理ファイルの退避
Management Server管理ファイルを収集してZIP形式で出力します。

mstrimport
Management Server管理ファイルの回復
回復に成功したファイルのパス名を，システムプロパティを含んだ形式で標準出力に出力します。

6.2　Management Serverで使用するコマンドの詳細

Management Serverで使用する各コマンドの入力形式，機能などを次に示します。

コマンドの格納先

Management Serverサーバで使用するコマンドは，次のディレクトリに格納されています。

Windowsの場合

mngsvr_monitor_setupコマンド以外のコマンド
<Cosminexusのインストールディレクトリ>¥manager¥bin¥

mngsvr_monitor_setupコマンド
<Cosminexusのインストールディレクトリ>¥manager¥externals¥jp1¥mngsvrmonitor¥
なお，このコマンドは，運用管理クライアントマシンのコピー先で実行します。

UNIXの場合

/opt/Cosminexus/manager/bin/

＜この節の構成＞

adminagentcheck（運用管理エージェントの稼働確認）

adminagentctl（運用管理エージェントの起動と停止）

daemon（デーモンプロセスの起動）

kill（プロセスの強制停止）

mngautorun（サービスの設定）

mngenvsetup（管理グループの設定）

mngsvr_adapter_setup（Cosminexusアダプタコマンドのセットアップとアンセットアップ）

mngsvr_monitor_setup（Cosminexusモニタ起動コマンドのセットアップとアンセットアップ）

mngsvrctl（Management Serverの起動／停止／セットアップ）

mngsvrupdate（Management Serverの移行コマンド）

mngsvrutil（Management Serverの運用管理コマンド）

mstrexport（Management Server管理ファイルの退避）

mstrimport（Management Server管理ファイルの回復）

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（運用管理エージェントの起動と停止）

形式

adminagentctl {start|stop}

機能

運用管理エージェントのサービスを起動または停止します。

UNIXの場合に，運用管理エージェントをデーモンプロセスとして起動する方法については，「daemon（デーモンプロセスの起動）」を参照してください。

このコマンドは，Administrator権限（Windowsの場合），またはroot権限（UNIXの場合）のあるユーザが実行してください。ただし，UNIXの場合，root権限がない特定のユーザにコマンドの実行権限を設定することもできます。設定については，「mngenvsetup（管理グループの設定）」を参照してください。

引数

引数の指定がない場合，コマンドの使用方法を表示します。

start

運用管理エージェントのサービスを開始します。

stop

運用管理エージェントのサービスを終了します。

戻り値

0：

正常終了しました。

1：

実行時エラーが発生しました。

2：

シンタックスエラーが発生しました。

入力例

adminagentctl start

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（サービスの設定）

形式

mngautorun [-d] [{server|agent|both}]

機能

Management Serverおよび運用管理エージェントのサービスの設定を変更します。このコマンドでは，次の設定をします。

マシン起動と同時に，Management Serverおよび運用管理エージェントのサービスを起動するように設定します。

マシン起動時に，Management Serverおよび運用管理エージェントのサービスの両方が起動する場合，運用管理エージェント起動後にManagement Serverを起動するように依存関係を設定します。

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

引数

オプションの指定がない場合，コマンドの使用方法が表示されます。

-d

Management Serverおよび運用管理エージェントのサービスに関する設定をインストール時の状態に戻します。

server

Management Serverのサービスのスタートアップに関する設定を自動に変更します。

agent

運用管理エージェントのサービスのスタートアップに関する設定を自動に変更します。

both

Management Serverおよび運用管理エージェントのサービスのスタートアップに関する設定を自動に変更して，運用管理エージェント起動後にManagement Serverを起動するように依存関係を設定します。

入力例

入力例1
Management Serverサービスと運用管理エージェントサービスをOS起動時に開始する場合

mngautorun both

入力例2
インストール時の状態に戻す場合

mngautorun -d

注意事項

このコマンドを使用してManagement Server，および運用管理エージェントのサービスの設定を変更した環境に，Cosminexusを上書きインストール，またはアップグレードインストールすると，サービスの設定がリセットされます。その場合は，再度このコマンドを実行してください。

mngenvsetup（管理グループの設定）

形式

mngenvsetup [-mng | -ua] {<OSのグループ名> | -d}

機能

root権限を持つユーザしかできなかったManagement Serverで使用するコマンドおよび統合管理ユーザで使用するコマンドを，root権限を持たない特定のユーザが実行できるように設定できます。なお，このコマンドは，UNIX用です。

Management Serverで使用するコマンドを実行できるユーザのグループをManagement Server管理グループといいます。統合管理ユーザで使用するコマンドを実行できるユーザのグループを統合ユーザ管理グループといいます。

このコマンドは，OSのグループをManagement Server管理グループと統合ユーザ管理グループとして設定します。

このコマンドの対象となるコマンドを次に示します。

root権限以外の運用で実行できるコマンド | 管理グループ
Management Server管理グループ | 統合ユーザ管理グループ※
adminagentctl | ○ | －
convpw | － | ○
mngsvr_adapter_setup | ○ | －
mngsvrctl | ○ | －
ssoexport | － | ○
ssogenkey | － | ○
ssoimport | － | ○
uachpw | － | ○

（凡例）

○：該当します。

－：該当しません。

注※　統合ユーザ管理グループのコマンドの詳細については，「10.　統合ユーザ管理で使用するコマンド」を参照してください。

引数の指定と管理グループの設定は次のとおりです。

-mngを指定するとManagement Server管理グループだけを設定します。

-uaを指定すると統合ユーザ管理グループだけを設定します。

-mng，-uaを指定しないで，OSのグループ名を指定した場合は，Management Server管理グループおよび統合ユーザ管理グループの両方に，指定したOSのグループが設定されます。

-dだけを指定すると，Management Server管理グループおよび統合ユーザ管理グループの両方の設定が削除されます。コマンドを実行できるのは，root権限を持つユーザだけに戻ります。また，Management Server管理グループおよび統合ユーザ管理グループは，Cosminexusインストール時の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権限を持つユーザだけに戻ります。

入力例

Management Server管理グループおよび統合ユーザ管理グループをmanagerに設定する場合

mngenvsetup manager

Management Server管理グループをmanagerに設定する場合

mngenvsetup -mng manager

統合ユーザ管理グループをmanagerに設定する場合

mngenvsetup -ua manager

Management Server管理グループおよび統合ユーザ管理グループをrootに戻す場合

mngenvsetup -d

注意事項

このコマンドを実行すると，Management Serverで使用するコマンドまたは統合ユーザ管理で使用するコマンドにSUIDビットが付加されます。このため，アクセス権を与えるユーザを適切に設定する必要があります。

mngsvr_adapter_setup（Cosminexusアダプタコマンドのセットアップとアンセットアップ）

形式

mngsvr_adapter_setup [ -i | -u ] [ -t { IM_CS | IM_CM } ]

機能

JP1/IM連携をする場合に，Cosminexusアダプタコマンドをセットアップまたはアンセットアップします。コマンドを実行すると，JP1/Baseの環境にCosminexus用のアダプタコマンド設定ファイルを追加します。

このコマンドは，Cosminexusの運用管理サーバ（Management Serverを配置しているホスト）で実行します。

このコマンドは，Administrator権限（Windowsの場合），またはroot権限（UNIXの場合）があるユーザが実行してください。ただし，UNIXの場合，root権限がない特定のユーザにコマンドの実行権限を設定することもできます。設定については，「mngenvsetup（管理グループの設定）」を参照してください。

引数

引数の指定がない場合，JP1/IM - Central Scope連携用のアダプタコマンドのセットアップを実行します。

-i

セットアップを実行します。

-u

アンセットアップを実行します。

-t IM_CS

JP1/IM - Central Scope連携用のアダプタコマンドのセットアップを実行します。

-t IM_CM

JP1/IM - CM連携用のアダプタコマンドのセットアップを実行します。

入力例

mngsvr_adapter_setup -i -t IM_CM

mngsvr_monitor_setup（Cosminexusモニタ起動コマンドのセットアップとアンセットアップ）

形式

mngsvr_monitor_setup [ -i | -u ]

機能

JP1/IM連携をする場合に，Cosminexusモニタ起動コマンドをセットアップまたはアンセットアップします。

このコマンドは，<Cosminexusのインストールディレクトリ>¥manager¥externals¥jp1¥mngsvrmonitor下に格納されています。運用管理クライアントマシンのコピー先で実行します。

このコマンドは，Administrator権限があるユーザが実行してください。なお，このコマンドは，Windows用です。

引数

引数の指定がない場合は，セットアップを実行します。

-i

セットアップを実行します。

-u

アンセットアップを実行します。

mngsvrctl（Management Serverの起動／停止／セットアップ）

形式

Management Serverを起動する場合

Windowsの場合

 mngsvrctl start

UNIXの場合

 /opt/Cosminexus/manager/bin/mngsvrctl start

Management Serverを停止する場合

Windowsの場合

 mngsvrctl stop

UNIXの場合

 /opt/Cosminexus/manager/bin/mngsvrctl stop

Management Serverをセットアップする場合

Windowsの場合

 mngsvrctl setup [<サーバ名>] [-u <管理ユーザID>] [-p <管理ユーザパスワード>] [-np <変更後の管理ユーザパスワード>] [-nu <変更後のユーザID>]

UNIXの場合

 /opt/Cosminexus/manager/bin/mngsvrctl setup [<サーバ名>] [-u <管理ユーザID>] [-p <管理ユーザパスワード>] [-np <変更後のユーザパスワード>] [-nu <変更後のユーザID>]

機能

Management Serverを起動または停止します。または，Application Serverを初めてインストールしたマシンで，Management Serverを実行するために必要なセットアップをします。

セットアップと同時に，Management Serverへログインするための管理ユーザアカウント（管理ユーザIDおよび管理ユーザパスワード）を設定できます。

また，設定済みの管理アカウントの変更もできます。変更後のユーザアカウントを指定すると，管理ユーザアカウントに変更後の管理ユーザアカウントが設定されます。

このコマンドは，Administrator権限（Windowsの場合），またはroot権限（UNIXの場合）のあるユーザが実行してください。ただし，UNIXの場合，root権限がない特定のユーザにコマンドの実行権限を設定することもできます。設定については，「mngenvsetup（管理グループの設定）」を参照してください。

UNIXの場合に，Management Serverをデーモンプロセスとして起動する方法については，「daemon（デーモンプロセスの起動）」を参照してください。

引数

引数の指定がない場合，コマンドの使用方法が表示されます。

start

Management Serverを起動します。

stop

Management Serverを停止します。

setup

Management Serverをセットアップします。

<サーバ名>

Management Serverの名称（Webコンテナのサーバ名称）を指定します。省略した場合は，「cosmi_m」が仮定されます。

-u <管理ユーザID>

Management Serverの管理ユーザIDを指定します。

-p <管理ユーザパスワード>

Management Serverの管理ユーザパスワードを指定します。

-np <変更後の管理ユーザパスワード>

新しいManagement Serverの管理ユーザパスワードを指定します。

-nu <変更後の管理ユーザID>

新しいManagement Serverの管理ユーザIDを指定します。

設定済みの管理ユーザパスワードを解除する場合は，空文字（" "）を指定します。

戻り値

0：

正常終了しました。

1：

実行時エラーが発生しました。

2：

シンタックスエラーが発生しました。

入力例

Management Serverをセットアップする場合

mngsvrctl setup [<サーバ名>]

セットアップ時に管理ユーザアカウントの設定もする場合

mngsvrctl setup [<サーバ名>] -u admin01 -p p1574809

設定済みの管理ユーザアカウントを変更する場合

mngsvrctl setup -u admin01 -p p1574809 -np passwd123 -nu admin02

管理ユーザパスワードを解除する場合

mngsvrctl setup localhost -u admin01 -p p1574809 -np " "

注意事項

UNIXの場合のmngsvrctlの注意事項を次に示します。

Management Serverを起動する前に，umask 022を設定してください。
コマンドからManagement Serverを起動した場合，umaskに影響されるファイルは，それぞれ次のownerおよびgroupで作成します。

AIXの場合
root/system

HP-UXの場合
root/sys

Linuxの場合
root/root

Solarisの場合
root/other

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

HP-UXの場合の設定例
export LANG=ja_JP.SJISまたはexport LANG=ja_JP.eucJP

Linuxの場合の設定例
export LANG=ja_JP.utf8

Solarisの場合の設定例
export LANG=Ja_JP.PCKまたはexport LANG=ja_JP.eucJP

Management Serverをセットアップする場合の注意事項を次に示します。

管理ユーザIDが設定されていない状態で，-nuオプションを指定したコマンドを入力すると，-uオプションの指定は無視されて，-nuオプションで指定した管理ユーザIDが設定されます。また，管理ユーザパスワードが設定されていない状態で，-npオプションを指定したコマンドを入力すると，-pオプションの指定は無視されて，-npオプションを指定した管理ユーザパスワードが設定されます。

mngsvrupdate（Management Serverの移行コマンド）

形式

mngsvrupdate [-t <ターゲット名称>][-k <ターゲット種別>]
            [<サブコマンド> [<引数>]]

機能

Cosminexus Component Containerのバージョンアップに合わせて，Management Serverで管理する情報を最新のバージョンで使用する形式に移行します。

このコマンドは，Management Serverが動作するホストで実行してください。

なお，移行手順については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

引数

-t <ターゲット名称>

サブコマンドの対象となるターゲット名称（論理サーバ名またはホスト名）を指定します。

運用管理ポータルの「論理サーバの構成定義」の定義に従います。

省略した場合，すべてのホストのすべての論理サーバが指定されます。

-k <ターゲット種別>

サブコマンドの対象となるターゲットの種別を指定します。次のどちらかを指定します。

logicalServer：論理サーバ

host：ホスト

省略した場合，または上記以外の値を指定した場合は，logicalServerが設定されます。

<サブコマンド> <引数>

指定しない場合はUsageが表示されます。

指定できるサブコマンドと引数について説明します。

d2r [<データソースの表示名> [<リソースアダプタの表示名>]]

Management Serverで管理するデータソースの情報をリソースアダプタに移行します。移行する対象は，<ターゲット名称>および<ターゲット種別>で指定します。

引数に<データソースの表示名>を指定した場合
指定したデータソースだけが移行されます。この引数を指定した場合，<ターゲット名称>に論理サーバ名を指定する必要があります。また，この引数を省略した場合，該当する論理サーバにインポートされたすべてのデータソースが移行対象となります。

引数に<リソースアダプタの表示名>を指定した場合
移行後のデータソースの表示名は，この引数で指定した値になります。ただし，すでに存在するリソースアダプタが指定された場合は移行されません。また，この引数を省略した場合，データソースの表示名がリソースアダプタの表示名になります。

移行処理では，次のファイルを編集します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥mmodel.xml

UNIXの場合
/opt/Cosminexus/manager/config/mmodel.xml

なお，mmodel.xmlはmmodel.xml.bakにバックアップしますが，すでにmmodel.xml.bakが存在する場合は上書きされます。

入力例

運用管理ドメイン内のすべてのホストを一括して移行する場合

mngsvrupdate d2r

ホストを指定して移行する場合

mngsvrupdate -t hostA -k host d2r

論理サーバを指定して移行する場合

mngsvrupdate -t MyServer d2r ds ds1

注意事項

このコマンドは，Management Serverが停止していることを確認してから実行してください。Management Serverの起動中に実行すると，変更が反映されない場合があります。

移行コマンドを同時に実行すると正しく環境が移行されないことがあります。コマンドは同時に実行しないでください。

移行コマンドを実行する前に，次のファイルをほかの場所に退避してください。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥mmodel.xml

UNIXの場合
/opt/Cosminexus/manager/config/mmodel.xml

mngsvrutil（Management Serverの運用管理コマンド）

形式

mngsvrutil [-m <ホスト名> [:<ポート番号>]
           -u <管理ユーザID> [-p <管理パスワード>]
          [[-o <ファイル名>][-h][-f <出力形式>]
          [-t <ターゲット名称>][-k <ターゲット種別>]
          [-s] [-i <監視時間間隔>] [-l <最大監視時間>]
           <サブコマンド> <引数>]]

機能

Management Serverに接続して，運用管理ドメインについての操作ができます。また，JP1/Cm2/ESA for Extension Mib Runtime（UNIXの場合は，JP1/Cm2/ESA）などのSNMPエージェント製品を使用して，mngsvrutilコマンドの出力結果をMIBに変換すると，SNMP Manager製品と連携できます。

このコマンドでは，次の機能を使用できます。

運用管理ドメインの構成情報の取得
運用管理ドメインの名称，および運用管理ドメインを構成する論理サーバの一覧を取得して，表示します。

論理サーバのステータス情報の取得
運用管理ドメインを構成する論理サーバの一覧に，ステータス（稼働しているかどうか）情報を付加して表示します。

論理サーバにデプロイされているJ2EEアプリケーションの情報の取得
J2EEアプリケーションの一覧を取得して，表示します。

論理サーバの性能情報の取得，および統計情報についての設定
論理サーバの性能情報（JavaVM，トランザクション，HTTPサーバ，HTTPサーバコネクタなど）を取得します。また，統計情報のサンプリング時間を設定します。

論理サーバの起動または停止
論理サーバを起動または停止します。

論理サーバの設定ファイルの再読み込み
論理サーバを再起動しないで，論理サーバで使用する設定ファイルを再読み込みします。また，論理J2EEサーバ，または論理SFOサーバで，接続先ホストの設定ファイルを再読み込みすることもできます。

論理サーバの追加・削除
論理サーバを追加または削除します。

論理サーバのアプリケーション管理
J2EEアプリケーション／J2EEリソースの開始／停止および一覧表示をします。アプリケーション管理の動作については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

性能解析トレースの収集
論理パフォーマンストレーサから性能解析トレースを収集します。

CTMキューの閉塞／閉塞解除
CTMのスケジュールキューの閉塞，および閉塞の解除をします。

CTM稼働統計情報の収集
CTMから稼働統計情報を収集します。

同時実行スレッド数の動的変更
Webアプリケーションの同時実行スレッド数を動的に変更します。

引数

-m <ホスト名>［:<ポート番号>］

Management Serverのホスト名とポート番号を指定します。

<ホスト名>
ドット記法でのIPアドレス指定（xxx.xxx.xxx.xxx），または名前解決できるホスト名で指定します。なお，xxxには0～255の整数を指定します。

<ポート番号>
Management Serverの設定に従います。デフォルト値は28080です。

-u <管理ユーザID>

mngsvrctl setupコマンドまたは運用管理ポータルの「管理ユーザアカウントの設定」で設定した管理ユーザIDを指定します。

運用管理ポータルの「管理ユーザアカウントの設定」で入力できる文字に従います。

-p <管理パスワード>

mngsvrctl setupコマンドまたは運用管理ポータルの「管理ユーザアカウントの設定」で設定した管理ユーザIDに対応する管理ユーザパスワードを指定します。

運用管理ポータルの「管理ユーザアカウントの設定」で入力できる文字に従います。

なお，パスワードを設定していない場合，-pオプションを指定する必要はありません。

-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アプリケーションが起動・停止しない場合，コマンドは異常終了します。省略時のデフォルトは60秒です。

<サブコマンド> <引数>

サブコマンドと引数を指定します。サブコマンドと引数に指定できる値は，Management Serverのバージョンに依存します。

サブコマンドでは，指定する引数によって，ターゲットに論理サーバまたはホストが指定できます。

次のサブコマンドが指定できます。

list

get

set

start

tracelevel

stop

reload

hold

release

collect

change

check

dump

add

delete

なお，サブコマンドの詳細は，「6.3　mngsvrutilコマンドのサブコマンドの詳細」を参照してください。

戻り値

0：

正常終了しました。

1：

実行時エラーが発生しました。

2：

シンタックスエラーが発生しました。

出力形式

CSV形式

名称，および値はコンマで区切って出力します。

-hオプションでヘッダの出力を抑止できます。

SNMP連携形式

値は半角スペース（0x20）で区切って出力します。また，文字列はダブルクォーテーション（0x22）で囲んで出力します。

なお，文字列にダブルクォーテーション（0x22）とバックスラッシュ「¥」（0x5c）が含まれていた場合，エスケープコード（バックスラッシュ「¥」（0x5c））を付加します。

（例）

編集前文字列：　”abc” def¥ g

編集後文字列：　”¥”abc¥” def¥¥ g”

整数値は32bit整数型で表します。また，浮動小数点数は小数点以下を切り捨てて32bit整数型で表します。

ヘッダは出力されません。

設定ファイル

クライアント側定義ファイル（.mngsvrutilrc）

mngsvrutilコマンドのオプションのデフォルト値を設定できます。

詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

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コマンドのオプションの共通のデフォルト値を設定できます。

詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

サーバ側定義ファイル（mngsvrutil.properties）

mngsvrutilコマンドの実行環境を変更できます。

詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

入力例・出力例

入力例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連携時の設定手順（Windowsの場合）

Windowsの場合のSNMP連携時の設定手順を次に示します。

JP1/Cm2/ESA for Extension Mib Runtimeのインストール

<実行ユーザのホームディレクトリ>¥.mngsvrutilrcファイルの作成，編集

<Cosminexusインストールディレクトリ>¥manager¥config¥templates¥.mngsvrutilrcファイルを<実行ユーザのホームディレクトリ>にコピーします。
実行ユーザ：SNMP AgentのJP1/Cm2/EAを実行するユーザ
<実行ユーザのホームディレクトリ>：実行ユーザのホームディレクトリの絶対パス

<実行ユーザのホームディレクトリ>¥.mngsvrutilrcファイルに対して，実行ユーザに適切なアクセス権限を与えます。

<実行ユーザのホームディレクトリ>¥.mngsvrutilrcファイルを編集します。

適切なエディタを使用して，次の項目を設定します。各項目の詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。
mngsvrutil.connect.host
mngsvrutil.connect.userid
mngsvrutil.connect.password
mngsvrutil.output.format=snmp
mngsvrutil.target_server_name

JP1/Cm2/ESA for Extension Mib Runtimeの環境設定
Cosminexusの拡張MIBオブジェクト定義ファイル（<Cosminexusインストール先>¥manager¥config¥hitachi-cosmiMng-MIB※）を使用して，JP1/Cm2/ESA for Extension Mib Runtimeの環境を設定します。環境設定の方法については，JP1/Cm2/ESA for Extension Mib Runtimeのヘルプを参照してください。
注※　実際は，hitachi-cosmiMng-MIBのあとに_V-R（バージョン）が付加されます（例：hitachi-cosmiMng-MIB_2-0）。
拡張MIBオブジェクト定義ファイルは最新のバージョンを使用してください。

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ファイルを編集します。
適切なエディタを使用して，次の項目を設定します。各項目の詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。
mngsvrutil.connect.host
mngsvrutil.connect.userid
mngsvrutil.connect.password
mngsvrutil.output.format=snmp
mngsvrutil.target_name
mngsvrutil.target_kind

JP1/Cm2/ESAの環境設定
Cosminexusの拡張MIBオブジェクト定義ファイル（/opt/Cosminexus/manager/config/ hitachi-cosmiMng-MIB※1 ※2）を使用して，SNMPサブエージェントを再構成します。SNMPサブエージェントの再構成の方法については，マニュアル「JP1 Version 7i JP1/Cm2/Extensible SNMP Agent」を参照してください。
注※1　実際は，hitachi-cosmiMng-MIBのあとに_V-R（バージョン）が付加されます（例：hitachi-cosmiMng-MIB_2-0）。
注※2　Cosminexus Manager 06-00以降で提供している拡張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オブジェクト定義ファイルのバージョンより新しくする必要があります。

mstrexport（Management Server管理ファイルの退避）

形式

mstrexport <ファイル名> [<退避対象定義ファイル名>]

機能

運用管理サーバの実行系と待機系を1:1にして系切り替えをする場合，実行系の運用管理サーバのManagement Server管理ファイルを収集してZIP形式ファイルに出力し，退避します。

引数

オプションの指定がない場合，コマンドの使用方法が表示されます。

<ファイル名>

Management Server管理ファイルを退避する時に出力するZIPファイル名を指定します。絶対パス，相対パスで指定できます。拡張子を「.zip（大文字，または小文字）」にしなかった場合は，「.zip」を付加します。

<退避対象定義ファイル名>

Management Server管理ファイル用退避対象定義ファイル名を絶対パス，または相対パスで指定します。

Management Server管理ファイル用退避対象定義ファイルは，デフォルトで退避対象となっているファイルのほかに収集したいファイルがある場合に指定します。詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

入力例

入力例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コマンドで回復したファイルには，実行権限が付きません。必要に応じて実行権限を付与してください。

6.3　mngsvrutilコマンドのサブコマンドの詳細

ここでは，mngsvrutilコマンドの引数として指定できる，サブコマンドについて説明します。

＜この節の構成＞

(1)　list

(2)　get

(3)　set

(4)　tracelevel

(5)　start

(6)　stop

(7)　reload

(8)　hold

(9)　release

(10)　collect

(11)　change

(12)　check

(13)　dump

(14)　add

(15)　delete

(1)　list

引数に指定された値のリストを表示します。次の引数を指定できます。

表6-2　サブコマンドlistに指定できる引数

引数
説明
ターゲット指定

論理サーバ
ホスト

logicalServers
運用管理ドメイン内の論理サーバ名と各サーバが稼働中かどうか（aliveまたはnot alive）を列挙します。
なお，Cosminexus Version 6以降ではstatusを使うことを推奨します。
－
－

status
運用管理ドメイン内の論理サーバ名とステータス情報を列挙します。
－
－

appStatus
"-t"オプションで指定された論理サーバにインポートされているJ2EEアプリケーション名とステータス情報を列挙します。
○
－

resStatus
"-t"オプションで指定された論理サーバにインポートされているJ2EEリソース名とステータス情報を列挙します。
○
－

resJavaBeansStatus
"-t"オプションで指定された論理サーバにインポートされているJavaBeansリソース名とステータス情報を列挙します。
○
－

queues
"-t"オプションで指定されたCTM，またはホストに属するキュー名とステータス情報を列挙します。
○
○

（凡例）

○：指定できます。

－：指定できません。

listでは，次の4種類の情報を表示できます。

引数に"status"を指定して，運用管理ドメイン内の論理サーバとそのステータス情報を表示します。
また，"logicalServers"を指定した場合，論理サーバ名と各サーバが稼働中かどうかを表示できます。なお，statusを使用することをお勧めします。
出力情報のヘッダ部のtypeは論理サーバの種類（Webサーバ，J2EEサーバ，ネーミングサービス，スマートエージェント，パフォーマンストレーサ，CTMドメインマネジャ，CTM，およびSFOサーバ），startingOrderは論理サーバの起動順序，parentは論理サーバが属するクラスタ名を表します。起動順序を設定していない場合，startingOrderにはデフォルト値が表示され，起動順序情報を取得できない場合は「－」が表示されます。デフォルト値については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。クラスタに属さない単体の論理サーバの場合，Parentには「－」が表示されます。
statusの種類は，working（稼働中），stopped（停止），starting（起動中），stopping（停止中），abnormal ended（異常停止），recovering（回復中），communication error（通信障害），auto stopping（自動停止中），auto restarting（自動再起動中），graceful stopping（計画停止中），またはforce stopping（強制停止中）のどれかです。論理サーバのステータスの詳細については，マニュアル「Cosminexus　機能解説」を参照してください。このサブコマンドでは，クラスタに属している論理サーバと単体の論理サーバだけを表示します。

引数に"appStatus"を指定して，J2EEサーバにインポートされているJ2EEアプリケーションの情報の一覧を表示します。
"-t"オプションで指定されたJ2EEサーバにインポートされているJ2EEアプリケーションの情報を一覧表示します。
J2EEサーバクラスタが指定された場合，メンバに処理を展開します。"-t"オプションにJ2EEサーバ（J2EEサーバクラスタのメンバも含む）またはJ2EEサーバクラスタ以外の論理サーバが指定された場合はエラーになります。
出力情報のヘッダ部のlogicalServerNameには，"-t"オプションで指定したJ2EEサーバ名が表示されます。
statusの種類は，working（稼働中），stopped（停止），またはunknown（J2EEサーバで管理されていない）のどれかです。

引数に"resStatus"を指定して，J2EEサーバ，またはバッチサーバにインポートされているJ2EEリソースの情報の一覧を表示します。
"-t"オプションで指定されたJ2EEサーバ，またはバッチサーバにインポートされているJ2EEリソースの情報を一覧表示します。
J2EEサーバクラスタが指定された場合，メンバに処理を展開します。"-t"オプションにJ2EEサーバ（J2EEサーバクラスタのメンバも含む），バッチサーバまたはJ2EEサーバクラスタ以外の論理サーバが指定された場合はエラーになります。
出力情報のヘッダ部のlogicalServerNameには，"-t"オプションで指定したJ2EEサーバ名，またはバッチサーバ名が表示されます。
statusの種類は，working（稼働中），stopped（停止），またはunknown（J2EEサーバで管理されていない）のどれかです。

引数に"resJavaBeansStatus"を指定して，J2EEサーバ，またはバッチサーバにインポートされているJavaBeansリソースの情報の一覧を表示します。
"-t"オプションで指定されたJ2EEサーバ，またはバッチサーバにインポートされているJavaBeansリソースの情報を一覧表示します。
J2EEサーバクラスタが指定された場合，メンバに処理を展開します。"-t"オプションにJ2EEサーバ（J2EEサーバクラスタのメンバも含む），バッチサーバまたはJ2EEサーバクラスタ以外の論理サーバが指定された場合はエラーになります。
出力情報のヘッダ部のlogicalServerNameには，"-t"オプションで指定したJ2EEサーバ名，またはバッチサーバ名が表示されます。
statusの種類は，working（稼働中），stopped（停止），またはunknown（J2EEサーバで管理されていない）のどれかです。

引数に"queues"を指定して，CTMのキューの情報を表示します。
"-t"オプションで指定されたCTM，またはホストに所属するキューの情報を一覧表示します。
ヘッダ部のlogicalServerNameにはCTM名称が表示されます。queueNameにはキュー名称が表示されます。
statusの種類は，scheduling（スケジューリングが可能な状態），preparing（キュー準備中），stopping（キュー終了処理中），closing[in]（キュー入り口閉塞中），またはclosing[out]（キュー出口閉塞中）のどれかです。

(2)　get

"-t"オプションで指定された論理サーバまたはホストについて，引数に指定された値を取得します。表6-3に示す引数を指定できます。なお，domainName以外の引数を，<metric category>といいます。

"-t"オプションに論理サーバを指定した場合，<metric category>に該当する論理サーバ（J2EEサーバ，SFOサーバ，CTM）以外の論理サーバ（Webサーバ，Naming Service，スマートエージェントなど）が指定された場合は，エラーになります。

ある一定間隔で統計情報を監視する場合，サンプリング時間をその一定間隔以上に設定すると，定期的な統計情報を取得できます。

なお，J2EEアプリケーションがテストモードで開始されている場合，出力情報には，<アプリケーション名>_TESTの形式で出力されます。

サブコマンドgetに指定できる引数を次に示します。サブコマンドgetに指定できる各引数の詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

表6-3　サブコマンドgetに指定できる引数

引数
説明
ターゲット指定

論理サーバ
ホスト

domainName
運用管理ドメイン名を取得します。
－
－

j2eeContainer
J2EEコンテナについての情報を取得します。
○
○

webContainer
Webコンテナに関する情報を取得します。
○
○

jvm
JavaVMについての情報を取得します。
○
○

transaction
Transactionについての情報を取得します。
○
○

httpServer
管理用サーバ（簡易Webサーバ）についての情報を取得します。
なお，この情報は内部で使用する管理用サーバの情報のため，取得しないことを推奨します。
○
○

httpSvrConn
WebサーバとWebコンテナの接続についての情報を取得します。
○
○

inprocHttpSvr
インプロセスHTTPサーバについての情報を取得します。
○
○

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アプリケーションについての情報を取得します。
○
○

（凡例）

○：指定できます。

－：指定できません。

(3)　set

引数を二つ指定して，一つ目の引数に指定された変数に二つ目で指定された値を設定します。

値を設定したあと，対象の論理J2EEサーバ，論理SFOサーバ，またはJ2EEアプリケーションが再起動または再デプロイされた場合，値を再設定してください。"-t"オプションに論理J2EEサーバ，論理SFOサーバ，または論理パフォーマンストレーサ以外の論理サーバが指定された場合は，エラーとなります。

サブコマンドsetに指定できる引数を次に示します。

表6-4　サブコマンドsetに指定できる引数

引数
説明
ターゲット指定

論理サーバ
ホスト

jvmSamplingTime <n>
JavaVMについてのサンプリング時間を<n>秒に設定します。※1
○
－

webContainerSamplingTime <n>
Webコンテナについてのサンプリング時間を<n>秒に設定します。※1
○
－

tranSamplingTime <n>
トランザクションについてのサンプリング時間を<n>秒に設定します。※1 ※2
○
－

httpSvrSamplingTime <n>
管理用サーバ（簡易Webサーバ）についてのサンプリング時間を<n>秒に設定します。※1
なお，管理用サーバ（簡易Webサーバ）の情報は内部で使用する管理用サーバの情報のため，取得しないことを推奨します。
○
－

httpSvrConnSamplingTime <n>
HTTPサーバコネクタについてのサンプリング時間を<n>秒に設定します。※1
○
－

inprocHttpSvrSamplingTime <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トレース取得レベルを「詳細」に設定します。

(4)　tracelevel

機能レイヤごとに異なるPRFトレース取得レベル指定します。4バイト（8けた）以下の16進数をコンマ（,）区切りで最大16個指定できます。指定値の詳細については，「4.2　性能解析トレースで使用するコマンドの詳細」の「cprfstart（PRFデーモンの開始）」の-PrfTraceLevelの説明，または「cprflevel（PRFトレース取得レベルの表示と変更）」の-PrfTraceLevelの説明を参照してください。

(5)　start

指定した論理サーバ，J2EEアプリケーション，J2EEリソースを起動します。

サブコマンドstartに指定できる引数を次に示します。

表6-5　サブコマンドstartに指定できる引数

引数 | 説明 | ターゲット指定
論理サーバ | ホスト
allServers | 運用管理ドメインに定義された論理サーバを定義された起動順序で起動します。 | － | －
server | "-t"オプションで指定された論理サーバを起動します。 | ○ | ○
app <displayName> | "-t"オプションで指定された論理サーバにインポートされている<displayName>のJ2EEアプリケーションを開始します。※ | ○ | －
resAdapter <displayName> | "-t"オプションで指定された論理サーバにインポートされている<displayName>のJ2EEリソースアダプタを開始します。※ | ○ | －
resJavaBeans | "-t"オプションで指定された論理サーバにインポートされている<displayName>のJavaBeansリソースを開始します。※ | ○ | －

（凡例）

○：指定できます。

－：指定できません。

注※

<displayName>は，J2EEアプリケーション，J2EEリソースまたはJavaBeansリソースの表示名（displayName）を示します。

startでは，次の2種類の操作を実行できます。

引数に"allServers"を指定して，指定された論理サーバを起動します。
運用管理ドメインに定義された論理サーバを，定義された起動順序で起動します。
引数にserverが指定された場合，"-t"オプションで指定された論理サーバ（スマートエージェント，ネーミングサービス，J2EEサーバ，J2EEサーバクラスタ，CTM，CTMドメインマネジャ，パフォーマンストレーサ，Webサーバ，Webサーバクラスタ，SFOサーバ，およびユーザサーバ）を起動します。

引数にはstartサブコマンドに対する引数を二つ指定して，指定されたJ2EEアプリケーション／J2EEリソースアダプタ／JavaBeansリソースを開始します。
一つ目の引数に"app"/"resAdapter"/"resJavaBeans"が指定された場合，"-t"オプションで指定されたJ2EEサーバにインポートされている，二つ目の引数で指定された表示名（displayname）のJ2EEアプリケーション/リソースアダプタ/JavaBeansリソースを開始します。J2EEサーバクラスタの場合は，メンバとなるJ2EEサーバに操作を展開します。
"-t"オプションにJ2EEサーバ（J2EEサーバクラスタのメンバも含む）またはJ2EEサーバクラスタ以外の論理サーバが指定された場合はエラーになります。また，"-t"オプションにホスト名は指定できません。
なお，J2EEアプリケーションは，テストモードで開始できません。

(6)　stop

指定した論理サーバ，J2EEアプリケーションまたはJ2EEリソースを停止します。

サブコマンドstopに指定できる引数を次に示します。

表6-6　サブコマンドstopに指定できる引数

引数
説明
ターゲット指定

論理サーバ
ホスト

allServers
運用管理ドメインに定義された論理サーバを定義された起動順序の逆順で停止します。
－
－

server [graceful[:<waitTime>]]
"-t"オプションで指定された論理サーバを停止します。
"graceful"が指定された場合，計画停止します。
○
○

app <displayName> [force]
"-t"オプションで指定された論理サーバで開始している<displayName>のJ2EEアプリケーションを停止します。※
"force"が指定された場合，強制停止します。
○
－

resAdapter <displayName>
"-t"オプションで指定された論理サーバで開始している<displayName>のJ2EEリソースを停止します。※
○
－

resJavaBeans
"-t"オプションで指定された論理サーバで開始している<displayName>のJavaBeansリソースを停止します。※
○
－

（凡例）

○：指定できます。

－：指定できません。

注※

<displayName>は，J2EEアプリケーションまたはJ2EEリソースまたはJavaBeansリソースの表示名（displayName）を示します。

stopでは，次の2種類の操作を実行できます。

引数に"allServers"を指定して，指定された論理サーバを停止します。
運用管理ドメインに定義された論理サーバを，定義された起動順序の逆順で停止します。引数に"server"が指定された場合，"-t"オプションで指定された論理サーバ（スマートエージェント，ネーミングサービス，J2EEサーバ，J2EEサーバクラスタ，CTM，CTMドメインマネジャ，パフォーマンストレーサ，Webサーバ，Webサーバクラスタ，SFOサーバ，およびユーザサーバ）を停止します。
一つ目の引数に"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アプリケーションは停止できません。

(7)　reload

引数に指定されたコンポーネントの設定ファイルを再読み込みします。

サブコマンドreloadに指定できる引数を次に示します。

表6-7　サブコマンドreloadに指定できる引数

引数
説明
ターゲット指定

論理サーバ
ホスト

userAdmin
統合ユーザ管理で使用する設定ファイルを再読み込みします。なお，"-t"オプションで指定された論理サーバで統合ユーザ管理を使用していない場合はエラーとなります。
また，サブコマンド"reload"に"userAdmin"を指定した場合，"-t"オプションに，論理J2EEサーバ以外の論理サーバを指定するとエラーとなります。
○
－

env※
論理J2EEサーバ，または論理SFOサーバで，接続先ホストの設定ファイルを再読み込みします。
なお，サブコマンド"reload"に"env"を指定した場合，"-t"オプションに，論理J2EEサーバ，および論理SFOサーバ以外の論理サーバを指定するとエラーとなります。
○
○

（凡例）

○：指定できます。

－：指定できません。

注※

サブコマンド"reload"に"env"を指定する場合には，注意事項があります。注意事項については，マニュアル「Cosminexus　運用管理操作ガイド」の，論理SFOサーバの設定読み込みに関する説明，および論理J2EEサーバの設定読み込みに関する説明を参照してください。

(8)　hold

引数に指定されたサービスを閉塞します。

サブコマンドholdに指定できる引数を次に示します。

表6-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"の場合と同じです。

(9)　release

引数に指定されたサービスの閉塞を解除します。

サブコマンドreleaseに指定できる引数を次に示します。

表6-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"を指定して，すべてのキューの閉塞を解除します。
運用管理ドメインのすべてのキューの閉塞を解除します。

(10)　collect

引数に指定されたファイルなどを収集します。"-t"オプションに，パフォーマンストレーサ，CTM以外の論理サーバが指定された場合は，エラーになります。

サブコマンドcollectに指定できる引数を次に示します。

表6-10　サブコマンドcollectに指定できる引数

引数 | 説明 | ターゲット指定
論理サーバ | ホスト
allPrfTraces | 運用管理ドメイン内のすべてのパフォーマンストレーサについて性能解析トレースを収集します。 | － | －
prfTrace | 指定されたパフォーマンストレーサ，または指定されたホスト内のパフォーマンストレーサについて性能解析トレースを収集します。 | ○ | ○
allCtmStatistics | 運用管理ドメイン内のすべてのCTMについて稼働統計情報を収集します。 | － | －
ctmStatistics | 指定されたCTM，または指定されたホスト内のCTMについて稼働統計情報を収集します。 | ○ | ○
snapshot [n]※ | 指定されたホスト内のsnapshotログを収集します。 | － | ○

（凡例）

○：指定できます。

－：指定できません。

注※

[n]は，次のどれかを指定します。

1：一次送付資料となるsnapshotログを収集します。

2：二次送付資料となるsnapshotログおよび性能解析トレースファイルを収集します。

省略：すべてを対象にsnapshotログおよび性能解析トレースファイルを収集します。

collectでは，次の3種類の操作を実行できます。

引数に"allPrfTraces"または"prfTrace"を指定して，稼働中のパフォーマンストレーサの性能解析トレースを収集します。
引数に"allPrfTraces"が指定された場合，運用管理ドメイン内のすべてのパフォーマンストレーサについて性能解析トレースを収集します。
引数に"prfTraces"が指定された場合，"-t"オプションで指定されたパフォーマンストレーサ，または"-t"オプションで指定されたホスト内のパフォーマンストレーサについて性能解析トレースを収集します。

引数に"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-<yyyyMMddHHmmss>.zip

二次送付資料：snapshot-<ホスト名>-log-<yyyyMMddHHmmss>.2.zip

(11)　change

引数に指定した同時実行スレッド数の設定項目の値を変更します。"-t"オプションで，J2EEサーバを指定する必要があります。

サブコマンドchangeに指定できる引数を次に示します。

表6-11　サブコマンドchangeに指定できる引数

引数
説明
ターゲット指定

論理サーバ
ホスト

webAppThreadCtrl <webApplicationContextRoot> <maxThreads>,<exclusiveThreads>,<queueSize>
"-t"オプションで指定されたJ2EEサーバ内で指定したWebアプリケーションの同時実行スレッド数を動的に制御します。
この引数は省略できません。
○
－

（凡例）

○：指定できます。

－：指定できません。

引数に"webAppThreadCtrl"が指定された場合，"-t"オプションで指定されたJ2EEサーバに属するWebアプリケーションの同時実行スレッド数を動的に制御します。

引数"webApplicationContextRoot"はWebアプリケーション（J2EEアプリケーションのWar）のコンテキストルートおよび同時実行スレッド数の各値を設定します。Webアプリケーションのコンテキストルートの値は，サブコマンドget webAppsで取得できます。コンテキストルートが設定されていない場合は，"/"（スラッシュ）を指定してください。

同時実行スレッド数の各値は，最大スレッド数，占有スレッド数，実行待ちキューサイズの順にコンマ(,)で区切って指定します。

引数"maxThreads"（最大スレッド数），"exclusiveThreads"（占有スレッド数），および"queueSize"（実行待ちキューサイズ）は，設定を変えない値は省略できますが，すべてを省略することはできません。

（例　占有スレッド数だけを変更したい場合：,20,）

同時スレッド数の各値は，次の範囲で指定します。

maxThreads（最大スレッド数）※：
1～1024の範囲で指定します。
Webコンテナ単位の最大同時実行スレッド数以下の値を指定します。

exclusiveThreads（占有スレッド数）※：
0～1024の範囲で指定します。

queueSize（実行待ちキューサイズ）：
0～2147483647の範囲で指定します。

注※　最大スレッド数 >= 占有スレッド数

なお，動的変更した同時実行スレッド数の値は，J2EEアプリケーション実行中だけ有効です。

(12)　check

Management Serverおよび運用管理エージェントが稼働しているかどうかを確認します。

サブコマンドcheckに指定できる引数を次に示します。

表6-12　サブコマンドcheckに指定できる引数

引数
説明
ターゲット指定

論理サーバ
ホスト

mngsvr
Management Serverが稼働しているかどうかを確認します。
"-t"オプションでターゲットを指定しても無視されます。
－
－

adminAgent
"-t"オプションで指定されたホスト上で運用管理エージェントが稼働しているかどうかを確認します。
"-k"オプションで"host"以外を指定した場合，"-t"オプションでホスト名以外を指定した場合，または"-t"オプションを指定しなかった場合は，エラーとなります。
－
○

（凡例）

○：指定できます。

－：指定できません。

サブコマンドcheckの戻り値を次に示します。

0：

稼働しています。

1：

コマンド実行時エラーです。

2：

コマンドシンタックスエラーです。

103：

稼働していません。

(13)　dump

稼働中の論理サーバのjavacoreを出力します。

サブコマンドdumpに指定できる引数を次に示します。

表6-13　サブコマンドdumpに指定できる引数

引数
説明
ターゲット指定

論理サーバ
ホスト

server [addition]※
"-t"オプションで指定された論理サーバのjavacore（稼働時間情報）を出力します。指定できる論理サーバは，J2EEサーバ（J2EEクラスタのメンバも含む），J2EEサーバクラスタ，SFOサーバ，CTM，またはネーミングサービスだけです。
additionを指定した場合，"-t"オプションで指定された論理サーバのcoreまたはメモリダンプ情報を取得します。
○
－

（凡例）

○：指定できます。

－：指定できません。

注※

server additionが指定された場合，指定された論理サーバの稼働監視方法はプロセスの存在確認だけに切り替わります。

javacore出力のために実行されるコマンドとjavacoreファイルの出力先について，OSごとに説明します。

(a)　Windowsの場合

Windowsの場合にjavacore出力のために実行されるコマンドとjavacoreファイルの出力先を論理サーバの種別ごとに示します。

論理サーバ | addition指定 | 実行されるコマンド | 出力情報 | javacoreファイルの出力先ディレクトリ
J2EEサーバ（クラスタも含む），SFOサーバ | あり | cjdumpsv，userdump※1 | javacore，メモリダンプ | <J2EEサーバ作業ディレクトリ>¥ejb¥<実サーバ名>¥
なし | cjdumpsv | javacore | <J2EEサーバ作業ディレクトリ>¥ejb¥<実サーバ名>¥
CTM | あり，なし※2 | hdumpns | javacore※3 | <Cosminexusインストールディレクトリ>¥TPB¥logj¥
ネーミングサービス | あり，なし※2 | hdumpns | javacore | <Cosminexusインストールディレクトリ>¥TPB¥logj¥

注※1

userdumpコマンドがインストールされている必要があります。

注※2

addition指定は無視され，稼働監視方法の変更はありません。

注※3

論理サーバにCTMを指定したときに出力されるjavacoreはCTMデーモンの情報ではなく，CTM用に起動されているネーミングサービスの情報です。

(b)　UNIXの場合

UNIXの場合にjavacore出力のために実行されるコマンドとjavacoreファイルの出力先を論理サーバの種別ごとに示します。

論理サーバ | addition指定 | 実行されるコマンド | 出力情報 | javacoreファイルの出力先ディレクトリ
J2EEサーバ（クラスタも含む），SFOサーバ | あり | 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用に起動されているネーミングサービスの情報です。

(14)　add

論理ユーザサーバを追加します。

サブコマンドaddに指定できる引数を次に示します。

表6-14　サブコマンドaddに指定できる引数

引数 | 説明 | ターゲット指定
論理サーバ | ホスト
userserver <userServiceDefinitionFile> | <userServiceDefinitionFile>に指定した論理ユーザサーバ定義ファイルの内容に従って論理ユーザサーバを追加します。論理ユーザサーバの定義内容を変更する場合は，論理ユーザサーバをいったん削除したあとに，再度論理ユーザサーバを追加してください。 | － | －

（凡例）

－：指定できません。

複数の論理ユーザサーバを指定した場合，定義順に追加処理をします。途中でエラーが発生した場合も追加処理をします。この場合の戻り値は，１（実行時エラー）となります。エラー条件を次に示します。

既存の論理サーバ名が指定された場合

定義されていないホスト名が指定された場合

(15)　delete

論理ユーザサーバを削除します。

サブコマンドdeleteに指定できる引数を次に示します。

表6-15　サブコマンドdeleteに指定できる引数

引数 | 説明 | ターゲット指定
論理サーバ | ホスト
userserver <logicalServerName> | <logicalServerName>に指定した名称の論理ユーザサーバを削除します。 | － | －

（凡例）

－：指定できません。

7.　JavaVMで使用するコマンド

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

なお，日立のJavaVMは，J2SE 5.0に準拠しています。対応するSun Microsystems社製のJDKのバージョンはJDK 5.0です。

JDK 5.0で使用できるコマンドについては，Sun Microsystems社が提供しているJDK 5.0のドキュメントを参照してください。

＜この章の構成＞

7.1　JavaVMで使用するコマンドの一覧

7.2　JavaVMで使用するコマンドの詳細

7.1　JavaVMで使用するコマンドの一覧

JavaVMで使用するコマンドの一覧を，次の表に示します。

表7-1　JavaVMで使用するコマンドの一覧

コマンド名称
分類
概要

car_tar_Z※
coreアーカイブ機能
coreファイルと関連するライブラリなどをまとめて，一つのアーカイブファイルに出力します。
このコマンドは，UNIX用です。

javacore
coreファイルの取得
coreファイルとスレッドダンプを同時に取得します。
このコマンドは，UNIX用です。

javagc
ガーベージコレクションの強制発生
メモリリーク，システム障害およびアプリケーションのデバッグのために，任意のタイミングでガーベージコレクションを発生させます。

javatrace
トレース情報の収集
coreファイルからスタックトレース情報を収集します。
このコマンドは，UNIX用です。

jheapprof
日立クラス別統計付き拡張スレッドダンプの出力
日立クラス別統計情報をスレッドダンプ中に出力します。

注※　AIXでは使用できません。snapcoreコマンドを使用してください。

7.2　JavaVMで使用するコマンドの詳細

JavaVMで使用するコマンドの入力形式，機能などを次に示します。

コマンドの格納先

JavaVMで使用するコマンドは，次のディレクトリに格納されています。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥jdk¥jre¥bin¥

UNIXの場合
/opt/Cosminexus/jdk/jre/bin/

＜この節の構成＞

car_tar_Z（coreアーカイブ機能）

javacore（coreファイルの取得）

javagc（ガーベージコレクションの強制発生）

javatrace（トレース情報の収集）

jheapprof（日立クラス別統計付き拡張スレッドダンプの出力）

car_tar_Z（coreアーカイブ機能）

形式

car_tar_Z [-i <実行ファイル名>] [-f] [-s|-S] [<coreファイル名>] > <出力ファイル名>

機能

coreファイルと関連するライブラリなどをまとめて，一つのアーカイブファイルに出力します。なお，このコマンドは，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

出力メッセージ

次のメッセージを出力した場合，正常なアーカイブファイルは出力されません。

表7-2　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コマンドは同時に実行できません。

システムにtarコマンドおよびcompressコマンドがインストールされている必要があります。

car_tar_Zコマンド実行中に強制終了した場合，カレントディレクトリにcar_tar_Zコマンドが作成した一時的なファイルやディレクトリが残ります。
一時的に作成されるファイル：car_exec??（??は，00～99）
一時的に作成されるディレクトリ：carYYMMDDhhmm/（YYMMDDhhmmは，coreファイルの作成年月日時分）

javacore（coreファイルの取得）

形式

javacore [-i|-f] -p <プロセスID>

機能

コマンド実行時のcoreファイルとスレッドダンプを同時に取得します。なお，このコマンドは，UNIX用です。

引数

-i

対象プロセスのプロセスIDについて，確認を要求します。省略した場合，-fオプションが指定されないかぎり，このオプションは有効です。

-f

-iオプションを無効にします。省略した場合，プロセスIDを確認するメッセージが表示されるので，yまたはnを入力します。このとき，yを入力するとcoreファイルとスレッドダンプを取得します。nを入力すると，何もしないで処理を終了します。

-p <プロセスID>

<プロセスID>には，coreファイルとスレッドダンプを取得するjavaプログラムのプロセスIDを指定します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

一定時間内にcore生成処理終了の応答がありませんでした。

入力例

-fオプションを省略してjavacoreコマンドを実行します。

javacore -p 8326

プロセスID確認のメッセージが表示されます。

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ファイルやスレッドダンプは取得されません。

表7-3　javacoreコマンドで出力されるエラーメッセージ

項番 | エラーメッセージ | 説明
1 | usage: javacore [-f|-i] -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 | コマンドの引数に指定した<プロセスID>に該当するプロセスが存在していません。
7 | <プロセスID>: Not owner | 実行ユーザは，コマンドの引数に指定した<プロセスID>に該当するプロセスのオーナーではありません。
8 | <プロセスID>: Now processing previous request, this request canceled | コマンドの引数に指定した<プロセスID>のプロセスが現在coreを生成中です。
9 | <プロセスID>: Timeout occurred. Java process not responding. | javacoreコマンドで指定した<プロセスID>に該当するプロセスから，一定時間内にcore出力処理終了の応答がありませんでした。または，javacoreコマンドで指定した<プロセスID>に該当するプロセスがjavaプロセス以外でした。

注意事項

javacoreコマンドは，SIGQUITシグナルを指定されたプロセスに送信します。誤ってjavaプログラム以外を指定すると，ほかのプログラムが停止することがあります。

javacoreコマンドは，前回のjavacoreコマンドによるcore出力処理が終了したあとに実行してください。

JavaVMプロセスが，スレッドダンプ取得要求に反応しないで無応答状態になっている場合には，javacoreコマンドによるcoreファイルも取得できません。この場合は，kill -6コマンドの実行によって，JavaVMプロセスを強制停止させてcoreファイルを取得してください。

AIX（5L V5.1）の場合，coredumpシステムコールでcoreを生成するため，次の環境変数を設定する必要があります。環境変数が設定されていない場合，coreファイルが正常に取得できません。

cshの場合

setenv LDR_CNTRL USERREGS

shまたはkshの場合

export LDR_CNTRL=USERREGS

LDR_CNTRL環境変数に複数指定する場合，@が区切り文字になります。例えば，MAXDATAとUSERREGSの二つを指定する場合は，次のようになります。

cshの場合

setenv LDR_CNTRL MAXDATA=0x40000000@USERREGS

shまたはkshの場合

export LDR_CNTROL=MAXDATA=0x40000000@USERREGS

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ファイルの出力はできません。

javagc（ガーベージコレクションの強制発生）

形式

javagc [-i|-f][-v][-s] -p <プロセスID>

機能

メモリリーク，システム障害およびアプリケーションのデバッグのために，プロセスIDが<プロセスID>のjavaプロセスに対して，任意のタイミングでガーベージコレクションを発生させます。

javaプロセスとの通信にはSIGQUITシグナルを使用します。コマンドを実行すると，ガーベージコレクションを発生させるかどうか（Windowsの場合），またはガーベージコレクションを発生させるためにSIGQUITシグナルを送信するかどうか（UNIXの場合）をユーザに確認します。発生させない，または送信しない（n）と回答した場合には，ガーベージコレクションは発生しません（戻り値が1となります）。この確認動作は，-fオプションを指定することで省略できます。

引数

-i

<プロセスID>のプロセスに対して，ガーベージコレクションを発生させるかどうか（Windowsの場合），またはSIGQUITシグナルを送信させるかどうか（UNIXの場合）をユーザに確認します。

このオプションより前に指定した，-fオプションを無効にします。

-f

<プロセスID>のプロセスに対して，ガーベージコレクションを発生させるかどうか（Windowsの場合），またはSIGQUITシグナルを送信させるかどうか（UNIXの場合）をユーザに確認しません。

このオプションより前に指定した，-iオプションを無効にします。

-v

-XX:+HitachiVerboseGCオプションが指定されている場合に出力される，日立JavaVMログファイルと同じ内容を，日立JavaVMログファイルに出力します。

-XX:+HitachiVerboseGCオプションが指定されている場合，その日立JavaVMログファイルに情報を追加します。

-XX:+HitachiVerboseGCPrintDate，-XX:+HitachiVerboseGCIntervalTime，-XX:+HitachiVerboseGCPrintCause，-XX:+HitachiVerboseGCCpuTime，-XX:+HitachiCommaVerboseGCなどの追加オプションが指定されている場合は，その形式に従って出力されます。

-XX:HitachiVerboseGCIntervalTimeオプションが指定され，指定時間を経過していない場合でも日立JavaVMログファイルを出力します。

-XX:+HitachiVerboseGCオプションが指定されていない場合は，日立JavaVMログファイル作成の規則に従って新規に日立JavaVMログファイルを作成します。

-s

-XX:+HitachiVerboseGCオプションが指定されている場合に出力される，日立JavaVMログファイルと同じ内容を，標準出力に出力します。

-XX:+HitachiVerboseGCPrintDate，-XX:+HitachiVerboseGCIntervalTime，-XX:+HitachiVerboseGCPrintCause，-XX:+HitachiCommaVerboseGCなどの追加オプションが指定されている場合は，その形式に従って出力されます。

-XX:HitachiVerboseGCIntervalTimeオプションが指定され，指定時間を経過していない場合でも日立JavaVMログファイルと同じ内容を標準出力に出力します。

-p <プロセスID>

プロセスIDを指定します。

日立固有のJavaVM拡張オプションについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

一定時間内にガーベージコレクション処理終了の応答がありませんでした。

入力例

-iオプションを指定してjavagcコマンドを実行します。

javagc -i -v -p 8326

Windowsの場合，ガーベージコレクションを発生させるかどうかの確認メッセージが表示されます。UNIXの場合，プロセスIDの確認メッセージが表示されます。

Windowsの場合
Force VM to execute GC ? (y/n)

UNIXの場合
send SIGQUIT to 8326:?(y/n)

Windowsの場合，ガーベージコレクションを発生させる場合は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)][Perm: 1300K->1300K(1536K)][cause:JavaGC Command]

出力メッセージ

表7-4　javagcコマンドで出力されるメッセージ（Windowsの場合）

項番
メッセージ
説明

1
usage: javagc [-f|-i] [-v] [-s] -p process-id
javagcコマンドへの引数の指定が間違っています。

2
javagc: illegal option--<オプション>
javagcコマンドに指定した<オプション>が不正です。

3
javagc: can't communicate with process <プロセスID>
javagcコマンドで指定したプロセスに問題があるか，通信処理でエラーが発生しているため，通信できません。

4
<プロセスID>: Not owner
javagcコマンドで指定した<プロセスID>に0が指定されています。

5
<プロセスID>: Now processing previous request, this request canceled
javagcコマンドで指定した<プロセスID>に該当するプロセスは現在ガーベージコレクションを実行中です。javagcコマンドによるガーベージコレクション実行要求はキャンセルされます。

6
javagc: can’t create work file at temporary directory, this request canceled
一時ファイル用ディレクトリに参照・書き込み権限がない場合，ガーベージコレクション要求ファイルが作成できません。このガーベージコレクション実行要求はキャンセルされます。

7
javagc: can't get temporary directory, this request canceled
一時ファイル用ディレクトリが取り出せない場合，ガーベージコレクション要求ファイルが作成できません。このガーベージコレクション実行要求はキャンセルされます。

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>に該当するプロセスから，一定時間内にガーベージコレクション処理終了の応答がありませんでした。または，javagcコマンドで指定した<プロセスID>に該当するプロセスがjavaプロセス以外でした。

10
javagc : please delete <削除できなかったファイル名> in <削除できなかったファイルのフルパス>
javagcコマンドを終了したときに，内部ファイルを削除できませんでした。削除できなかったファイルのフルパスにある，削除できなかったファイルを削除してください。

表7-5　javagcコマンドで出力されるメッセージ（UNIXの場合）

項番
メッセージ
説明

1
usage: javagc [-f|-i] [-v] [-s] -p process-id
javagcコマンドへの引数の指定が間違っています。

2
javagc: illegal option--<オプション>
javagcコマンドに指定した<オプション>が不正です。

3
<プロセスID>: No such process
javagcコマンドの引数に指定した<プロセスID>に該当するプロセスが存在していません。

4
<プロセスID>: Not owner
実行ユーザは，javagcコマンドの引数に指定した<プロセスID>に該当するプロセスのオーナーではありません。

5
<プロセスID>: Now processing previous request, this request canceled
javagcコマンドで指定した<プロセスID>に該当するプロセスは現在ガーベージコレクションを実行中です。javagcコマンドによるガーベージコレクション実行要求はキャンセルされます。

6
javagc: can't create work file at /tmp, this request canceled
/tmpに参照および書き込み権限がないため，ガーベージコレクション要求ファイルが作成できません。javagcコマンドによるガーベージコレクション実行要求はキャンセルされます。

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>に該当するプロセスから，一定時間内にガーベージコレクション処理終了の応答がありませんでした。または，javagcコマンドで指定した<プロセスID>に該当するプロセスがjavaプロセス以外でした。

9
javagc : please delete <削除できなかったファイル名> in <削除できなかったファイルのフルパス>
javagcコマンドを終了したときに，内部ファイルを削除できませんでした。削除できなかったファイルのフルパスにある，削除できなかったファイルを削除してください。

注意事項

javagcコマンドは，前回のjavagcコマンドによるガーベージコレクション処理が終了してから実行してください。前回のガーベージコレクション処理が終了している場合は，日立JavaVM固有ログファイルに出力される拡張verbosegc機能のガーベージコレクションの要因に"JavaGC Command"が出力されます。

Windowsの場合，引数に指定したプロセスIDのjavaプロセス所有者以外でもjavagcコマンドを実行できます。

UNIXの場合，javagcコマンドはSIGQUITシグナルを指定されたプロセスIDに送信します。誤ってjavaプロセス以外のプロセスIDを指定すると，ほかのプログラムが停止することがあります。

UNIXの場合，javagcコマンド実行時に，/tmp/hsperfdata_<ユーザ名>/<プロセスID>ファイルを使用します。該当するファイルが存在しない場合は，javagcコマンドによるガーベージコレクションの要求はできません。

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/jre/bin/javatrace core /opt/Cosminexus/CC/server/bin/cjstasrtsv]
#

coreファイル名がcoreの場合

/opt/Cosminexus/jdk/jre/bin/javatrace core /opt/Cosminexus/CC/server/bin/cjstasrtsv

OSによっては実際に出力されるcoreファイル名がcore.<プロセスID>になる場合があります。その場合は，実際に出力されたcoreファイル名をjavatraceの引数に指定してください。

coreファイル名がcore.<プロセスID>の場合

/opt/Cosminexus/jdk/jre/bin/javatrace core.8326 /opt/Cosminexus/CC/server/bin/cjstasrtsv

出力メッセージ

次のエラーメッセージまたは警告メッセージを出力した場合，スタックトレース情報は出力されません。

表7-6　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ファイルが生成されたマシンで実行してください。

jheapprof（日立クラス別統計付き拡張スレッドダンプの出力）

形式

jheapprof [-f|-i] [-class <クラス名>] -p <プロセスID>

機能

引数に指定したプロセスIDのjavaプロセスに対して，日立クラス別統計情報を含んだ拡張スレッドダンプを出力します。

引数

-f

-iオプションを無効にします。省略した場合，日立クラス別統計付き拡張スレッドダンプの出力処理の実行を確認するメッセージが表示されるので，yまたはnを入力します。このとき，yを入力すると日立クラス別統計付き拡張スレッドダンプが出力されます。nを入力すると，何もしないで処理を終了します。

-i

日立クラス別統計付き拡張スレッドダンプの出力処理の実行を確認するメッセージが表示されます。省略した場合，-fオプションが指定されないかぎり，このオプションは有効です。

-class <クラス名>

<クラス名>に指定したクラス（インスタンス）をメンバに持つクラスの構造を一覧にしてスレッドダンプ中に出力します。指定するクラスのパッケージ名は「"（ダブルクォーテーション）」で囲みます。

-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）を作成し，プログラムを継続します。

出力例

日立クラス別統計情報には，次の3種類の機能で出力した情報が存在します。

インスタンス統計機能

STATICメンバ統計機能

クラス構造出力機能（-classオプションを指定した場合）

インスタンス統計機能

インスタンス統計機能では，classAのインスタンス→classAのメンバ変数（クラスはclassB）→classBのインスタンス→...とインスタンスの参照関係を調べ，ほかのインスタンスへの参照を持たないインスタンスのサイズをそのインスタンスをメンバに持つクラスに再帰的に加算します。つまり，インスタンス統計機能とは，各クラスのインスタンスがメンバとして持つインスタンスサイズの合計が出力される機能です。

次のソースを例にして説明します。

public class instance {
 public static void main(String args[]) {
   classA cls_a = new classA();
   try {
     Thread.sleep(20000);
   } catch (Exception e) {}
 }
}
class classA {
 classB a1;
 classC a2;
 classA() {
   a1 = new classB();
   a2 = new classC();
 }
}
class classB {
 classD b1;
 String b2;
 classB() {
   b1 = new classD();
   b2 = null;
 }
}
class classC {
 String c1, c2;
 classC() {
   c1 = null;
   c2 = null;
 }
}
class classD {
 String d1, d2;
 classD() {
   d1 = null;
   d2 = null;
 }
}

上記のソースの場合，次のようなインスタンス構造になっています。

このようなインスタンス構造の場合，インスタンス統計機能では，次のように各クラスのサイズを加算します。

classAのサイズ：a1+a2+ b1+b2+ c1+c2+ d1+d2

classBのサイズ：b1+b2+ d1+d2

classCのサイズ：c1+c2

classDのサイズ：d1+d2

したがって，出力結果は次のようになります。

STATICメンバ統計機能

STATICメンバ統計機能もインスタンス統計機能と同様に，インスタンスの参照関係を調べ，そのサイズを加算して統計情報を出力します。インスタンス統計機能と異なる点は，インスタンス統計機能が最初に取り出したインスタンスの非staticフィールドから参照関係を構築するのに対し，STATICメンバ統計機能は最初に取り出したインスタンスのstaticフィールド(=クラスのstaticフィールド)から参照関係を調べるという点です。これによって，各クラスのstaticメンバが持つインスタンスの合計サイズを得ることができます。ただし，最初に取り出すインスタンス以外では，インスタンス統計機能／STATICメンバ統計機能共に，インスタンスの非staticメンバを基に参照関係を調べます。

インスタンス統計機能とSTATICメンバ統計機能の違いを次のソースを例にして説明します。

public class static_instance {
 public static void main(String args[]) {
   classA cls_a;
   classB cls_b;
   classC cls_c;

   cls_a = new classA();
   cls_b = new classB();
   cls_c = new classC();
   cls_b.cls_c = cls_c;
   cls_a.cls_b = cls_b;

   try {
     Thread.sleep(20000);
   } catch (Exception e) {}
 }
}
class classA {
 static classB cls_b;
}
class classB {
 classC cls_c;
}
class classC {
}

上記のソースの場合，インスタンス統計機能とSTATICメンバ統計機能では，次のような違いがあります。

上の図でインスタンス統計機能の参照関係は次のようになります。

インスタンスAのインスタンス変数 cls_b → インスタンスBのインスタンス変数 cls_c → インスタンスC

一方，STATICメンバ統計機能の参照関係は次のようになります。

クラスAのクラス変数cls_b → インスタンスBのインスタンス変数cls_c → インスタンスC

STATICメンバ統計機能での出力結果を次に示します。

クラス構造出力機能

jheapprofコマンドに-classオプションを指定することで，指定したクラス（インスタンス）をメンバに持つクラスの構造を一覧にしてスレッドダンプ中に出力できます。

指定したクラスのインスタンスが複数ある場合は，該当するすべてのインスタンスが出力されます。同じ名前のインスタンスが複数ある場合でも，インスタンス名のあとに，そのインスタンスのアドレスが出力されるため，別のインスタンスかどうか識別できます。

次のソースを例にして説明します。

public class instance2 {
 public static void main(String args[]) {
   classA cls_a1 = new classA();    classA cls_a2 = new classA();
   classB cls_b1 = new classB();    classB cls_b2 = new classB();
   classC cls_c1 = new classC();    classC cls_c2 = new classC();
   classC cls_c3 = new classC();    classC cls_c4 = new classC();
   cls_a1.cls_a = cls_a2;    cls_a1.cls_b = cls_b1;
   cls_a1.cls_c = cls_c1;    cls_a2.cls_b = cls_b2;
   cls_b1.cls_c = cls_c2;    cls_b2.cls_c = cls_c3;
   cls_c1.cls_c = cls_c4;
   try {
     Thread.sleep(20000);
   } catch (Exception e) {}
 }
}
class classA {
 classA cls_a;
 classB cls_b;
 classC cls_c;

 classA() {
   classB cls_b;
 }
}
class classB {
 classC cls_c;
}
class classC {
 classC cls_c;
}

上記のソースの場合，次のようなインスタンス構造になっています。

jheapprofコマンドに引数「-class <クラス名>」を指定した場合，出力結果は次のようになります。

（　）内はインスタンスのメモリ上のアドレスです。classAのアドレスはすべて同じアドレスになっています。したがって，classAはすべて同じインスタンスであることがわかります。一方，（1）と（4）のclassBはアドレスが異なっているので別のインスタンスであることがわかります。

なお，ガーベージコレクションの発生によってインスタンスのメモリ上の配置が変化します。そのため，出力するたびにアドレスが変化する場合があります。

出力メッセージ

次のエラーメッセージまたは警告メッセージが出力された場合，日立クラス別統計付き拡張スレッドダンプは出力されません。

表7-7　jheapprofコマンドで出力されるメッセージ（Windowsの場合）

項番
エラーメッセージ
説明

1
usage: jheapprof [-f|-i] [-class classname] -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>に該当するプロセスに問題がある，または通信処理でエラーが発生しているため，通信できません。

10
<プロセスID>: Timeout occurred. Java process not responding
jheapprofコマンドの引数に指定した<プロセスID>に該当するプロセスから，一定時間内に日立クラス別統計出力処理終了の応答がなかったか，または指定した<プロセスID>がjavaプロセス以外の<プロセスID>です。

表7-8　jheapprofコマンドで出力されるメッセージ（UNIXの場合）

項番
エラーメッセージ
説明

1
usage: jheapprof [-f|-i] [-class classname] -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>のプロセスがありません。

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>に該当するプロセスから，一定時間内に日立クラス別統計出力処理終了の応答がなかったか，または指定した<プロセスID>がjavaプロセス以外の<プロセスID>です。

注意事項

jheapprofコマンドは，前回のjheapprofコマンドによるクラス別統計情報が拡張スレッドダンプに出力されたあとに実行してください。

Windowsの場合，Javaプロセスは起動時にMailSlotを使った通信の初期化処理が必要ですが，初期化に失敗した場合もメッセージが表示され，処理が中断されます。

UNIXの場合，引数に指定したプロセスIDのjavaプロセスオーナーでないユーザがこのコマンドを実行するとメッセージが出力され，処理が終了します。ユーザがrootである場合は，処理を継続します。

Windowsの場合，引数に指定したプロセスIDのjavaプロセス所有者以外でもjheapprofコマンドを実行できます。

UNIXの場合，jheapprofコマンドは，SIGQUITシグナルを指定されたプロセスに送信します。誤ってjavaプログラム以外を指定すると，ほかのプログラムが停止することがあります。

UNIXの場合，jheapprofコマンド実行時に，/tmp/hsperfdata_<ユーザ名>/<プロセスID>ファイルを使用します。該当するファイルが存在しない場合，jheapprofコマンドによるクラス別統計情報出力はできません。

jheapprofコマンドはプログラムの開発用ユーティリティとして提供されているものです。システムの運用では使用しないでください。

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

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

＜この章の構成＞

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

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

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

ログの運用で使用するコマンドの一覧を，次の表に示します。

表8-1　ログの運用で使用するコマンドの一覧

コマンド名称
分類
概要

cjcldellog
Javaアプリケーションのシステムログ出力先サブディレクトリの削除
Javaアプリケーションのシステムログ出力先サブディレクトリを削除します。
cjcldellogコマンドについては，「11.　Javaアプリケーションで使用するコマンド」の「cjcldellog」を参照してください。

snapshotlog
snapshotログの収集
Cosminexusシステムの構成ソフトウェアが出力したログを収集します。

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

ログの運用で使用する各コマンドの入力形式，機能などを次に示します。

コマンドの格納先

ログの運用で使用するコマンドは，次のディレクトリに格納されています。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥bin¥

UNIXの場合
/opt/Cosminexus/manager/bin/

＜この節の構成＞

snapshotlog（snapshotログの収集）

snapshotlog（snapshotログの収集）

形式

snapshotlog <出力ファイル名> [<snapshotログ収集対象定義ファイル名>]

機能

snapshotログを収集します。snapshotログは，業務システムにトラブルが発生した場合に，調査用資料として利用できます。このコマンドは，Management Serverを利用しないで運用している場合も実行できます。

引数

<出力ファイル名>

収集したsnapshotログを出力するZIPファイルを指定します。

ファイル名だけを指定した場合は，カレントディレクトリ下に指定したファイル名でZIPファイルが作成されます。

フルパスで指定した場合は，指定したディレクトリ下に指定した名前でZIPファイルが作成されます。

拡張子に「.zip」以外を指定した場合も，ZIP形式で出力されます。

<snapshotログ収集対象定義ファイル名>

snapshotログ収集対象定義ファイルをフルパスで指定します。省略した場合，次のファイルに定義されたファイルが収集対象になります。空白を含む場合は，""（ダブルクォーテーション）で囲みます。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥config¥snapshotlog.conf

UNIXの場合
/opt/Cosminexus/manager/config/snapshotlog.conf

なお，snapshotログ収集対象定義ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

入力例

カレントディレクトリに出力する場合

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

注意事項

システムごとに，デフォルトの設定で一次送付資料および二次送付資料として収集できる資料が異なります。

J2EEアプリケーションを実行するシステムの場合
デフォルトの設定で一次送付資料および二次送付資料として収集できる資料を次の表に示します。

表8-2　デフォルトの設定で一次送付資料および二次送付資料として収集できる資料（J2EEアプリケーションを実行するシステムの場合）

資料の種類 | 一次送付資料 | 二次送付資料
メッセージログ | ○ | ○
ユーザログ | ○ | ○
例外ログ | ○ | ○
保守用ログ | ○※ | ○※
性能解析トレース | － | －
JavaVMのスレッドダンプ | － | －
JavaVMのガーベージコレクションのログ | － | －
メモリダンプ | － | －
JavaVMログファイル | － | －
エラーリポートファイル | ○ | ○
OSの状態・ログ | － | －
OSの統計情報 | － | －
定義情報 | ○ | ○
作業ディレクトリ | ○ | ○
リソースの設定 | － | －
Webサーバのログ | ○ | ○
JavaVMのスタックトレース情報 | － | －
稼働情報 | ○ | ○
監査ログ | － | ○

（凡例）　○：収集できる。　－：収集できない。

注　Cosminexusの各構成ソフトウェアが出力するメッセージログや保守用ログは，snapshotログのデフォルトの設定では，構成ソフトウェアのインストール時にデフォルトで作成されたディレクトリだけが収集対象となっています。構成ソフトウェアのログの出力先を変更している場合には，収集先も変更してください。

注※　Hitachi Web ServerまたはCosminexus TPBrokerの保守用ログの内容が最新ではない場合があります。hwstraceinfoコマンドまたはhmapfsyncコマンドを実行して最新のログを出力してから，snapshotログを収集してください。

バッチアプリケーションを実行するシステムの場合
デフォルトの設定で一次送付資料および二次送付資料として収集できる資料を次の表に示します。

表8-3　デフォルトの設定で一次送付資料および二次送付資料として収集できる資料（バッチアプリケーションを実行するシステムの場合）

資料の種類 | 一次送付資料 | 二次送付資料
メッセージログ | ○ | ○
ユーザログ | ○ | ○
例外ログ | ○ | ○
保守用ログ | ○※ | ○※
性能解析トレース | － | －
JavaVMのスレッドダンプ | － | －
JavaVMのガーベージコレクションのログ | － | －
メモリダンプ | － | －
JavaVMログファイル | － | －
エラーリポートファイル | ○ | ○
OSの状態・ログ | － | －
OSの統計情報 | － | －
定義情報 | ○ | ○
作業ディレクトリ | ○ | ○
リソースの設定 | － | －
JavaVMのスタックトレース情報 | － | －
稼働情報 | ○ | ○
監査ログ | － | ○

（凡例）　○：収集できる。　－：収集できない。

注　Cosminexusの各構成ソフトウェアが出力するメッセージログや保守用ログは，snapshotログのデフォルトの設定では，構成ソフトウェアのインストール時にデフォルトで作成されたディレクトリだけが収集対象となっています。構成ソフトウェアのログの出力先を変更している場合には，収集先も変更してください。

注※　Hitachi Web ServerまたはCosminexus TPBrokerの保守用ログの内容が最新ではない場合があります。hwstraceinfoコマンドまたはhmapfsyncコマンドを実行して最新のログを出力してから，snapshotログを収集してください。

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

この章では，監査ログの設定で使用するコマンドの入力形式，機能などについて説明します。

＜この章の構成＞

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

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

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

監査ログの設定で使用するコマンドの一覧を次の表に示します。

表9-1　監査ログの設定で使用するコマンドの一覧

コマンド名称 | 分類 | 概要
auditsetup | 監査ログの設定 | 監査ログ定義ファイルに指定されたプロパティに従って空の監査ログファイルを出力し，所有者およびアクセス権限を設定します。

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

監査ログの設定で使用するコマンドの入力形式，機能などを次に示します。

＜この節の構成＞

auditsetup（監査ログの設定）

auditsetup（監査ログの設定）

形式

auditsetup

機能

監査ログ定義ファイルに指定されたプロパティに従って空の監査ログファイルを出力し，所有者およびアクセス権限を設定します。

監査ログ定義ファイルは環境変数COSMINEXUS_AUDITLOG_CONFで指定されているファイルを使用します。環境変数COSMINEXUS_AUDITLOG_CONFが設定されていない場合は，デフォルトの設定ファイルを使用します。デフォルトの設定ファイルは次のとおりです。

Windowsの場合

<Cosminexusのインストールディレクトリ>¥common¥conf¥auditlog.properties

UNIXの場合

/opt/Cosminexus/common/conf/auditlog.properties

監査ログ定義ファイルの指定値と設定内容は，Windowsの場合とUNIXの場合で異なります。監査ログ定義ファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

引数

なし

戻り値

0：

正常終了しました。

0以外：

異常終了しました。

注意事項

このコマンドを実行したあと，監査ログファイルを削除（移動も含む）しないでください。削除（または移動）した場合，監査ログを出力したプロセスのユーザおよびプライマリグループが監査ログの所有者となります。

このコマンドを再度実行する場合，すべての監査ログファイル，管理ファイル，メッセージログファイルおよび例外ログファイルを削除してから，またはこれらのファイルの出力ディレクトリを変更してから実行してください。これらのファイルが残っている場合，実行に失敗します。

メッセージログファイルの出力ディレクトリが存在しない場合，デフォルトの出力ディレクトリが使用されます。

監査ログ定義ファイルを読み込めない場合や監査ログ出力ディレクトリが存在しない場合，実行に失敗します。

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

この章では，統合ユーザ管理で使用するコマンドの入力形式，機能などについて説明します。

＜この章の構成＞

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

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

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

統合ユーザ管理で使用するコマンドの一覧を，次の表に示します。

表10-1　統合ユーザ管理で使用するコマンドの一覧

コマンド名称 | 分類 | 概要
convpw | パスワードの暗号化 | ldifファイル内のパスワードフィールドの内容を暗号化して，その結果を標準出力に出力します。
ssoexport | シングルサインオン情報リポジトリの参照 | シングルサインオン情報リポジトリに内容を読み込んで，標準出力にCSV形式で表示します。
ssogenkey | 暗号鍵ファイルの作成 | シングルサインオン情報リポジトリに登録／参照するときの暗号鍵ファイルを作成します。
ssoimport | シングルサインオン情報リポジトリの登録 | シングルサインオン用の認証情報が格納されているCSV形式のファイルを読み込んでシングルサインオン情報リポジトリに登録します。
uachpw | パスワードの変更 | 統合ユーザ管理のコンフィグレーションファイル中のLDAPディレクトリサーバとDBサーバにアクセスするためのパスワードを変更します。

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

統合ユーザ管理で使用する各コマンドの入力形式，機能などを次に示します。

コマンドの格納先

統合ユーザ管理で使用するコマンドは，次のディレクトリに格納されています。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥manager¥bin¥

UNIXの場合
/opt/Cosminexus/manager/bin/

共通の仕様

終了コード

統合ユーザ管理で使用するコマンドの終了コードを，次の表に示します。

表10-2　統合ユーザ管理で使用するコマンドの終了コード

終了コード | 意味
0 | 正常終了しました。
1 | コマンドの実行中にエラーが発生しました。
2 | コマンドまたはサーバ起動時の引数に誤りがあります。

＜この節の構成＞

convpw（パスワードの暗号化）

ssoexport（シングルサインオン情報リポジトリの参照）

ssogenkey（暗号鍵ファイルの作成）

ssoimport（シングルサインオン情報リポジトリの登録）

uachpw（パスワードの変更）

convpw（パスワードの暗号化）

形式

convpw [-f {md5|sha1}] <ldif_file_name> <password_attribute>

機能

ユーザ情報リポジトリに登録するときに，ldifファイルの内容を暗号化します。このコマンドは，指定したldifファイルの内容を読み取って，<password_attribute>で指定されている内容を暗号化して標準出力に出力します。ldifファイルの内容で，<password_attribute>で指定した属性名の値以外は，そのまま標準出力に出力します。

なお，<password_attribute>で指定した属性名がない場合，そのままファイルの内容が標準出力に出力されます。

なお，このコマンドは，root権限があるユーザ，またはコマンドの実行権限を設定した特定のユーザだけが実行できます。特定のユーザにコマンドの実行権限を設定する方法については，「6.2　Management Serverで使用するコマンドの詳細」の「mngenvsetup（管理グループの設定）」を参照してください。

引数

-f {md5|sha1}

<ldif_file_name>に指定したファイルの内容の中で，password（パスワード）で指定された値を暗号化する形式を指定します。省略した場合は，sha1を仮定します。ここで指定する値は，大文字と小文字を区別しません。

md5
MD5形式で暗号化します。

sha1
SHA-1形式で暗号化します。

<ldif_file_name>

パスワード変換をするユーザ情報が格納されたldifファイルのファイル名を指定します。

<password_attribute>

パスワードのフィールドの内容を変換する際の属性名を指定します。

注意事項

変換するldifファイルに日本語を記述する場合，UTF-8に変換したあとで，base64エンコードしてください。LDIFの詳細については，RFC 2849 "The LDAP Data Interchange Format (LDIF) - Technical Specification"を参照してください。

ssoexport（シングルサインオン情報リポジトリの参照）

形式

ssoexport [-n <レルム名>] [-u <ユーザID>] [-scramble] <useradmin_configfile>

機能

シングルサインオン情報リポジトリに格納されたユーザ情報を，CSV形式で標準出力に出力します。

シングルサインオン情報リポジトリのユーザ情報を変更する場合，ssoexportコマンドによって出力された情報をCSV形式ファイルにリダイレクトして，CSV形式ファイルを編集したあとで，ssoimportコマンドで再度登録処理をします。

ssoexportコマンドでユーザ情報を取り出した場合，項目”SECRETDATA”の実データは復号化されます。

ssoexportコマンドがユーザ情報をCSV形式に変換して出力するには，ユーザ情報にレルムとユーザIDが含まれている必要があります。含まれていない場合，出力しないで無視します。

なお，このコマンドは，root権限があるユーザ，またはコマンドの実行権限を設定した特定のユーザだけが実行できます。特定のユーザにコマンドの実行権限を設定する方法については，「6.2　Management Serverで使用するコマンドの詳細」の「mngenvsetup（管理グループの設定）」を参照してください。

引数

-n <レルム名>

検索するレルム名を指定します。省略した場合，すべてのレルム名が対象となります。

-u <ユーザID>

検索するユーザIDを指定します。ユーザIDには，ワイルドカード（*）を指定できます。ワイルドカード（*）を指定する場合は，ダブルクォーテーション（"）で囲んでください。

（例）

-u "*"
すべてのユーザを取り出します。

-u "Ta*"
ユーザIDがTaで始まるユーザを取り出します。

-u "*no"
ユーザIDがnoで終わるユーザを取り出します。

省略した場合，すべてのユーザIDが対象となります。

-scramble

パスワード変更コマンド（uachpw）でパスワードをスクランブル化した場合に指定します。

<useradmin_configfile>

統合ユーザ管理のコンフィグレーションファイル（ua.conf）を指定します。

入力例・出力例

レルム名が「RealmA」で，「s9」で始まるユーザを取り出す場合の入力例および出力例を次に示します。

入力例

Windowsの場合

C:¥>ssoexport -n RealmA -u "s9*" "C:¥Program Files¥Hitachi¥Cosminexus¥manager¥config¥ua.conf"

UNIXの場合

% ssoexport -n RealmA -u "s9*" /opt/Cosminexus/manager/config/ua.conf

出力例

SecurityDomain,USERID,SECRETDATA,PUBLICDATA,LINK_J2EE,LINK_REALMA
RealmA,s981234,abfdef,,
RealmA,s991234,ghijkl,,

注意事項

シングルサインオン情報リポジトリに情報がない場合，または指定したレルム名／ユーザIDに対応したユーザ情報が取得できない場合，ヘッダだけ出力してこのコマンドは終了します。

ssoexportコマンドを実行中にLDAPディレクトリサーバを停止しないでください。エラーメッセージを出力しないで，コマンドが終了することがあります。

ssoexportコマンドとssoimportコマンドは，同時に実行しないでください。

ssoimportコマンドで登録する接続先のユーザ管理を持つアプリケーションについては，整合性を取りません。つまり，シングルサインオン情報リポジトリ内に対応するレルムのエントリ（またはユーザエントリ）がなくてもエラーとなりません。この場合，ssoexportコマンドで情報を参照しても出力されないため注意が必要です。ssoexportコマンドでは，接続先のユーザ管理を持つアプリケーションについては，ベースDNの直下にあるレルムのエントリに対応する値しか表示しません。

ssogenkey（暗号鍵ファイルの作成）

形式

ssogenkey <useradmin_configfile>

機能

シングルサインオン用の認証情報は，暗号化して保存します。また，参照する際は，復号化して参照します。このコマンドは，暗号化および復号化で使用する暗号鍵を作成します。

なお，このコマンドは，root権限があるユーザ，またはコマンドの実行権限を設定した特定のユーザだけが実行できます。特定のユーザにコマンドの実行権限を設定する方法については，「6.2　Management Serverで使用するコマンドの詳細」の「mngenvsetup（管理グループの設定）」を参照してください。

引数

<useradmin_configfile>

統合ユーザ管理のコンフィグレーションファイル（ua.conf）を指定します。

注意事項

指定したファイルがすでにある場合は，”.n”を付けて，指定したファイルと同一ディレクトリ内にバックアップを取ります。

このコマンドでは，シングルサインオン情報リポジトリの内容はアクセスしません。すでにシングルサインオン情報リポジトリ内にシングルサインオン用の認証情報を登録している場合は，先にすべての情報をssoexportで取り出したあと，ssoimportコマンドで登録する必要があります。

ssoimport（シングルサインオン情報リポジトリの登録）

形式

ssoimport {-a|-m|-d|-x} [-p] [-scramble] <csvfile_name> <useradmin_configfile>

機能

ユーザ管理を持つアプリケーションから取り出したCSV形式ファイル（または取り出して編集したCSV形式ファイル）を，シングルサインオン情報リポジトリに登録します。登録時，項目ID”SECRETDATA”に記述された実データは暗号化されてシングルサインオン情報リポジトリに登録されます。

なお，このコマンドは，root権限があるユーザ，またはコマンドの実行権限を設定した特定のユーザだけが実行できます。特定のユーザにコマンドの実行権限を設定する方法については，「6.2　Management Serverで使用するコマンドの詳細」の「mngenvsetup（管理グループの設定）」を参照してください。

引数

-a

<csvfile_name>に指定したファイルの内容をシングルサインオン情報リポジトリに追加します。シングルサインオン情報リポジトリ内に追加しようとするユーザのエントリがある場合は，該当ユーザに対する処理はしないで，警告メッセージを出力して次行以降の行の処理を継続します。

-m

<csvfile_name>に指定したファイルの内容でシングルサインオン情報リポジトリを上書きします。シングルサインオン情報リポジトリ内に上書きしようとするユーザのエントリがない場合は，ユーザエントリを追加します。

-d

<csvfile_name>に指定したファイルの内容をシングルサインオン情報リポジトリから削除します。シングルサインオン情報リポジトリ内に削除しようとするユーザのエントリがない場合は，警告メッセージを出力して処理は継続します。

-x

ラインオペレーションの指定に従って，シングルサインオン情報リポジトリの内容を更新します。シングルサインオン用認証情報のCSV形式ファイルのラインオペレーションについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

-p

追加，変更，または更新したレルム名とユーザ名の一覧を標準出力に出力します。

-scramble

パスワード変更コマンド（uachpw）でパスワードをスクランブル化した場合に指定します。

<csvfile_name>

シングルサインオン情報リポジトリに登録するCSV形式ファイルを指定します。

<useradmin_configfile>

統合ユーザ管理のコンフィグレーションファイル（ua.conf）を指定します。

入力例

ここでは，登録するCSV形式ファイルをuserdata.csv，シングルサインオン用設定ファイルを”ua.conf”として説明します。

CSV形式ファイルの内容をシングルサインオン情報リポジトリに追加する場合

ssoimport -a userdata.csv ua.conf

CSV形式ファイルの内容をシングルサインオン情報リポジトリから削除する場合

ssoimport -d userdata.csv ua.conf

CSV形式ファイルOPERATION項目の実データに指定したオペレーションに従ってシングルサインオン情報リポジトリに登録する場合

ssoimport -x userdata.csv ua.conf

出力メッセージ

ssoimportコマンドは，オプションに指定したCSV形式ファイルから1行ずつ取得してシングルサインオン情報リポジトリに登録（変更または削除）します。このとき，-pオプションを指定して実行すると，その操作についての情報を標準出力に出力します。なお，操作時に発生した警告，エラーメッセージについては，標準エラー出力に出力します。

-pオプションを指定しないで実行した場合は，警告，エラーメッセージと「結果」だけを出力します。

出力例を次の図に示します。

図10-1　ssoimportコマンドの出力例（Windowsの場合）

図10-2　ssoimportコマンドの出力例（UNIXの場合）

「OPERATION」「REALMNAME」「USERID」の順に表示します。

実行内容

ヘッダに対応した「OPERATION」「REALMNAME」「USERID」の内容，および操作時に発生した警告／エラーメッセージを表示します。

OPERATION

次の表に示す操作種別のどれかを出力します。

表10-3　ssoimportコマンドの操作種別

項目 | 内容
add | 情報を追加したことを意味します。
modify | 情報を変更（上書き）したことを意味します。
delete | 情報を削除したことを意味します。

REALMNAME

操作の対象となるレルム名を出力します。この値は，CSV形式ファイルの「REALMNAME」項目に指定した値を表示します。

USERID

操作の対象となるユーザIDを出力します。この値は，CSV形式ファイルのヘッダ「USERID」項目に指定した値を表示します。

実行結果

次の表に示す実行結果を表示します。

表10-4　ssoimportコマンドの実行結果

項目 | 内容
Total | 操作の対象となった行数を出力します。
ADD | シングルサインオン情報リポジトリ内に追加したエントリ数を表示します。
MODIFY | シングルサインオン情報リポジトリ内を変更したエントリ数を表示します。
DELETE | シングルサインオン情報リポジトリから削除したエントリ数を表示します。
WARNING | 上記の操作をした際に発生した警告メッセージの数を表示します。

注意事項

接続先のJAAS対応ユーザ管理を持つアプリケーションのユーザの情報を削除する場合は，ssoexportで対象とするユーザを取得したあとで，削除したい接続先のユーザ管理を持つアプリケーションのユーザを削除し，-mオプションで更新してください。

ssoexportコマンドとssoimportコマンドは，同時に実行しないでください。

ssoimportコマンドで登録する接続先のユーザ管理を持つアプリケーションについては，整合性を取りません。つまり，シングルサインオン情報リポジトリ内に対応するレルムのエントリ（またはユーザエントリ）がなくてもエラーとなりません。この場合，ssoexportコマンドで情報を参照しても出力されないため注意が必要です。ssoexportコマンドでは，接続先のユーザ管理を持つアプリケーションについては，ベースDNの直下にあるレルムのエントリに対応する値しか表示しません。

uachpw（パスワードの変更）

形式

uachpw [-scramble] [-ldap.<n> <パスワード>] [-db.<n> <パスワード>] <useradmin_configfile>

機能

統合ユーザ管理のコンフィグレーションファイル（ua.conf）のLDAPディレクトリサーバとDBサーバにアクセスするためのパスワードを変更します。また，変更時にパスワードをスクランブル化できます。

なお，このコマンドは，root権限があるユーザ，またはコマンドの実行権限を設定した特定のユーザだけが実行できます。特定のユーザにコマンドの実行権限の設定については，「6.2　Management Serverで使用するコマンドの詳細」の「mngenvsetup（管理グループの設定）」を参照してください。

引数

-scramble

変更するパスワードをスクランブル化する場合に指定します。

-ldap.<n> <パスワード>

<n>で指定したLDAPディレクトリサーバにアクセスするためのパスワードを変更します。<n>には，統合ユーザ管理のコンフィグレーションファイルに定義したLDAP設定番号を指定します。<パスワード>には，変更する新しいパスワードを指定します。

-db.<n> <パスワード>

<n>で指定したDBサーバにアクセスするためのパスワードを変更します。<n>には，統合ユーザ管理のコンフィグレーションファイルに定義したJDBC設定番号を指定します。<パスワード>には，変更する新しいパスワードを指定します。

<useradmin_configfile>

統合ユーザ管理のコンフィグレーションファイル（ua.conf）を指定します。この引数は省略できません。

入力例

統合ユーザ管理のコンフィグレーションファイル（ua.conf）に定義したパスワードを下記のように変更し，-scrambleオプションを使用してスクランブル化する場合の入力例を示します。

LDAPアクセス情報0のパスワードをdiradminに変更

LDAPアクセス情報1のパスワードをadministratorに変更

DBアクセス情報0をtigerに変更

% uachpw -scramble -ldap.0 diradmin -ldap.1 administrator -db.0 tiger ua.conf

注意事項

-scrambleオプションでパスワードをスクランブル化する場合は，usrconf.propertiesのcom.cosminexus.admin.auth.passwordScramble.enableにtrueを設定してください。設定しなかった場合，パスワードが復号化されないためLDAPディレクトリサーバやDBにアクセスできません。

パスワードに使用できる文字数は30文字までです。

オプションの大文字と小文字は区別されません。

コマンドを二重で実行しないでください。

引数に統合ユーザ管理のコンフィグレーションファイル（ua.conf）以外のファイルは指定しないでください。

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

この章では，Javaアプリケーションで使用するコマンドの入力形式，機能などについて説明します。

＜この章の構成＞

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

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

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

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

表11-1　Javaアプリケーションで使用するコマンドの一覧

コマンド名称 | 分類 | 概要
cjcldellog | Javaアプリケーションのシステムログ出力先サブディレクトリの削除 | vbjコマンドで起動したJavaアプリケーションのシステムログ出力先サブディレクトリを削除します。
cjcldumpap | Javaアプリケーションのスレッドダンプの取得 | cjclstartapコマンドで開始したJavaアプリケーションで障害が発生した場合に，JavaVMのスレッドダンプを取得します。
cjclstartap | Javaアプリケーションの開始 | Javaアプリケーションを開始します。

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

Javaアプリケーションで使用する各コマンドの入力形式，機能などを次に示します。

コマンドの格納先

Javaアプリケーションで使用するコマンドは，次のディレクトリに格納されています。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥client¥bin¥※

UNIXの場合
/opt/Cosminexus/CC/client/bin/

注※

uCosminexus Clientを使用している場合は，格納ディレクトリの「<Cosminexusのインストールディレクトリ>¥CC¥」を，「<Cosminexusのインストールディレクトリ>¥CCL¥」と読み替えてください。

＜この節の構成＞

cjcldellog（Javaアプリケーションのシステムログ出力先サブディレクトリの削除）

cjcldumpap（Javaアプリケーションのスレッドダンプの取得）

cjclstartap（Javaアプリケーションの開始）

cjcldellog（Javaアプリケーションのシステムログ出力先サブディレクトリの削除）

形式

cjcldellog -t <時間>h|<日数>d [-f] <ログ出力先ディレクトリ名称>
          [<ログ出力先ディレクトリ名称> ...]

機能

引数に指定したログ出力先ディレクトリに，指定した日数または時間より前の更新日時のサブディレクトリがあった場合に，削除します。なお，-fを指定しない場合は，起動中のJavaアプリケーションのサブディレクトリは削除しません。

なお，このコマンドは，vbjコマンドで起動したJava環境で実行するコマンドです。

このコマンドは，タスク（Windowsの場合），またはatコマンドやcrontabコマンド（UNIXの場合）を使用して定期的に実行してください。

引数

-t <時間>h

更新時間が何時間よりも前のサブディレクトリを削除するかを1～8760の範囲（単位：時間）で指定します。例えば，2を指定した場合，更新時間が2時間前よりも古いサブディレクトリが削除されます。

-t <日数>d

更新日が何日よりも前のサブディレクトリを削除するかを1～365の範囲（単位：日）で指定します。例えば，2を指定した場合，更新日が2日よりも古いサブディレクトリが削除されます。

-f

指定された日時より古いサブディレクトリすべてを削除対象とします。省略した場合は，client_process_endファイルが存在するサブディレクトリだけが削除対象になります。

この引数を使用すると，Javaアプリケーション起動中のサブディレクトリも削除対象としてしまうおそれがあるため，すべてのJavaアプリケーションが終了していることを確認してからコマンドを実行してください。

<ログ出力先ディレクトリ名称>

削除対象にするサブディレクトリの上位ディレクトリである，ログ出力先ディレクトリを，フルパス名で指定します。ログ出力先ディレクトリを複数指定するときは，空白で区切ってください。また，複数のログ出力先ディレクトリを指定した場合，最後のディレクトリだけにワイルドカード（*）を指定できます。

なお，Windowsの場合，空白を含むパスを指定するときは，パス全体を""で囲む必要があります。

指定できるパスの例を次に示します。

Windowsの場合

 "C:¥Program Files¥Hitachi¥Cosminexus¥CC¥client¥logs¥ejb"
 C:¥work¥logs¥ejb*
 C:¥work¥logs¥ejb*log
 C:¥work¥logs¥*log

UNIXの場合

 /work/logs/ejb*
 /work/logs/ejb*log
 /work/logs/*log

戻り値

0：

正常終了しました。

1：

異常終了しました。

入力例

7日より前の更新日時のサブディレクトリをすべて削除する場合

Windowsの場合

 cjcldellog -t 7d -f c:¥work¥logs

UNIXの場合

 cjcldellog -t 7d -f /work/logs

12時間より前の更新日時のサブディレクトリでclient_process_endファイルが存在するサブディレクトリを削除する場合

Windowsの場合

 cjcldellog -t 12h c:¥work¥logs

UNIXの場合

 cjcldellog -t 12h /work/logs

複数のディレクトリ下にある12時間より前の更新日時のサブディレクトリで，client_process_endファイルが存在するサブディレクトリを削除する場合

Windowsの場合

 cjcldellog -t 12h c:¥work¥logs¥ejb1 c:¥work¥logs¥ejb2 c:¥work¥logs¥ejb3

UNIXの場合

 cjcldellog -t 12h /work/logs/ejb1 /work/logs/ejb2 /work/logs/ejb3

“ejb”で始まるディレクトリにある12時間より前の更新日時のサブディレクトリで，client_process_endファイルが存在するサブディレクトリを削除する場合

Windowsの場合

 cjcldellog -t 12h c:¥work¥logs¥ejb*

UNIXの場合

 cjcldellog -t 12h /work/logs/ejb*

注意事項

ログ出力サブディレクトリ配下にユーザがディレクトリを作成した場合，このコマンドではサブディレクトリ下のログファイルは削除しますが，ユーザ作成ディレクトリは削除しません。この場合，サブディレクトリとユーザ作成ディレクトリが削除されないで残ります。

このコマンドでは作成後1時間以上経過していないログは削除できません。

サブディレクトリ共有モードで動作しているアプリケーションが使用しているサブディレクトリを削除しないでください。削除した場合，以降のログ出力が正しく行われなくなることがあります。

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コマンドを実行すると，エラーメッセージが出力されてスレッドダンプが出力されないことがあります。

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:NewRatio=<value>

-XX:PermSize=<size>

-XX:MaxPermSize=<size>

-XX:SurvivorRatio=<value>

-XX:[+|-]PrintTenuringDistribution

-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アプリケーションの終了コードが返却されます。

1：

Javaアプリケーション開始コマンドでエラーが発生しました。

143：

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

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

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

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

注意事項

オプション定義ファイル（usrconf.cfg），およびユーザプロパティファイル（usrconf.properties）が格納されているディレクトリパスを指定する場合，ユーザ定義ファイル格納先環境変数（CJCLUSRCONFDIR）を指定する必要があります。Javaアプリケーションの環境変数の設定については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。
ユーザ定義ファイル格納先環境変数が設定されていない場合，カレントディレクトリが参照されます。環境変数で設定したディレクトリにオプション定義ファイル（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オプションを複数指定した場合，すべての指定が有効になります。

Javaアプリケーションログはサブディレクトリ共有モードだけで使用できます。サブディレクトリ占有モードに設定した場合，ログは正しく出力されません。

アカウントのログオフ時にこのコマンドを実行した場合，起動に失敗することがあります。

このコマンドは，スレッドダンプを出力するため，Ctrl+Breakの信号を自身に送信します。この場合，cjclstartapコマンドとコンソールを共有するCtrl+Breakを無視していないアプリケーションは終了されます。

Windows Vistaの場合，このコマンドはユーザに書き込み権限があるディレクトリで実行してください。一般ユーザ権限で，%ProgramFiles%およびそのサブディレクトリで実行した場合，カレントディレクトリがリダイレクトされるため次のように動作します。

ログファイル，ロックファイル，pidファイルがリダイレクトされます。

複数のユーザが実行した場合，ユーザごとにプロセスが同時に動作します。

このコマンドを実行したユーザと異なるユーザは，cjcldumpapコマンドを実行できません。

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

この章では，Webアプリケーションで使用するコマンドの入力形式，機能などについて説明します。

＜この章の構成＞

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

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

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

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

表12-1　Webアプリケーションで使用するコマンドの一覧

コマンド名称 | 分類 | 概要
cjjspc | JSPの事前コンパイル | JSPファイルからJavaソースファイルを生成およびコンパイルし，クラスファイルを生成します。
cjjsp2java | JSPソースのチェック | JSPファイルのシンタックスチェックをします。

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

Webアプリケーションで使用するコマンドの入力形式，機能などを次に示します。

コマンドの格納先

Webアプリケーションで使用するコマンドは，次のディレクトリに格納されています。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥bin¥

UNIXの場合
/opt/Cosminexus/CC/web/bin/

＜この節の構成＞

cjjspc（JSPの事前コンパイル）

cjjsp2java（JSPソースのチェック）

cjjspc（JSPの事前コンパイル）

形式

Windowsの場合

cjjspc [-jspworkdir <JSPワークディレクトリ名>]
      [-classpath <クラスパス1>[;<クラスパス2>…]]
      [-excludefile <JSPファイルパス1>[;<JSPファイルパス2>…]|
      -excludelist <コンパイル対象外リストファイルパス>]
      [-keepgenerated]
      [-source {1.3|1.4|1.5|5}]
      [-pageencoding <文字エンコーディング>]
      [-resultlist <実行結果リストファイルパス>]
      [-customactiondeclarevariable]
      [-usebeannocheckclass]
      [-tagnocheckrtexprvalue]
      [-tagrtexprvalueterminate]
      [-taglibnocheckprefix]
      -root <Webアプリケーションのルートディレクトリ>
      [<JSPファイルパス>...]

UNIXの場合

cjjspc [-jspworkdir <JSPワークディレクトリ名>]
      [-classpath <クラスパス1>[:<クラスパス2>…]]
      [-excludefile <JSPファイルパス1>[:<JSPファイルパス2>…]|
      -excludelist <コンパイル対象外リストファイルパス>]
      [-keepgenerated]
      [-source {1.3|1.4|1.5|5}]
      [-pageencoding <文字エンコーディング>]
      [-resultlist <実行結果リストファイルパス>]
      [-customactiondeclarevariable]
      [-usebeannocheckclass]
      [-tagnocheckrtexprvalue]
      [-tagrtexprvalueterminate]
      [-taglibnocheckprefix]
      -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オプションの併用はできません。併用した場合はエラーメッセージが表示され，処理が終了します。

引数

-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.4 APIなどを含んだCosminexusシステムが使用するクラスライブラリ

複数のクラスパスを指定する場合，Windowsでは「;（半角セミコロン）」，UNIXでは「:（半角コロン）」で区切って指定します。なお，Cosminexusシステムが使用するクラスライブラリ内のクラスファイルと-classpathオプションに指定されたクラスパスに含まれるjarファイル内のクラスファイルが重複している場合は，Cosminexusシステムが使用するクラスライブラリ内のクラスファイルが優先して使用されます。

-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.3|1.4|1.5|5}

JSPをコンパイルする際，JSPトランスレーション時にJavaソースファイルが生成されます。このJavaソースファイルをコンパイルするJava言語仕様のバージョンを指定します。例えば，JSPファイルに，J2SE1.3の言語仕様に依存したプログラムコードを記述している場合は，このオプションに1.3を指定してください。このオプションを省略した場合，JavaSE5.0の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要素で指定できます。

-usebeannocheckclass

JSPコンパイル時に<jsp:useBean>タグのclass属性値の検証をしないようにする場合に指定します。

-tagnocheckrtexprvalue

Expressionが指定できないタグの属性値にExpressionが指定されているかどうかを検証しない場合に指定します。

-tagrtexprvalueterminate

タグの属性値が，「"<%=」（または「'<%=」）で開始していて，「%>"」（または「%>'」）で終了していない属性値がある場合，「"」（または「'」）で囲まれた値を文字列として扱うときに指定します。

-taglibnocheckprefix

aglibディレクティブの前に，taglibディレクティブで指定したprefixを使用したカスタムタグを記述しているかどうかをチェックしない場合に指定します。

-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ファイルをコンパイルしてください。

cjjsp2java（JSPソースのチェック）

形式

cjjsp2java [-d <ディレクトリ>|-d:non] [-classpath <クラスパス>]
          [-root <ディレクトリ> [[-taglib <uri> <location>]...]]
          <JSPファイル名>...

機能

JSP1.1仕様およびJSP1.2仕様に準拠したJSPファイルからJavaソースを生成し，JSPファイルのシンタックスチェックをします。

なお，JSP2.0仕様に準拠したJSPファイルのシンタックスチェックをする場合は，cjjspcコマンドを使用してください。

引数

-d <ディレクトリ>

生成したjavaソースファイルの出力先ディレクトリを指定します。このオプションを指定しなかった場合は，コマンドを実行したカレントディレクトリ下に生成されます。

-rootオプションを指定していない場合，-dオプションで指定したディレクトリの直下にjavaソースファイルが生成されます。同一ファイル名のJSPファイルが複数指定された場合，javaソースファイルも同一名称となるため，先に生成されたjavaソースファイルは，あとから生成されたjavaソースファイルに上書きされます。-rootオプションを指定している場合，-dオプションで指定したディレクトリ下に-rootオプションで指定したwebアプリケーションのルートディレクトリからJSPファイルまでのパスが生成され，そのディレクトリ下にjavaソースファイルが生成されます。

-d:non

javaソースファイルを生成しません。JSPファイルの確認だけを実施します。

-classpath <クラスパス>

JSPファイルからjavaファイルを生成する時に必要となるクラスのクラスパスを絶対パスで指定します。次のクラスパスが必要です。

タグライブラリの実装クラス（タグライブラリバリデータの実装クラスも含む）

<jsp:useBean>タグで指定したJavaBeansの実装クラス

複数のパスを指定する場合は，";" で区切って指定します。

なお，-rootオプションを使用し，指定したディレクトリ下のWEB-INF¥classes¥（UNIXの場合，WEB-INF/classes/）ディレクトリ，およびWEB-INF¥lib¥（UNIXの場合，WEB-INF/lib/）ディレクトリ下に必要なclassファイル，jarファイルを配置する場合，このオプションで指定する必要はありません。

-root <ディレクトリ>

Webアプリケーションのルートディレクトリを指定します。JSPファイルでincludeディレクティブを使用する場合，タグライブラリを使用する場合，またはjavaソースファイル生成時に必要なクラスパスを指定する場合に，このオプションを指定します。-rootオプションを指定した場合，指定したWebアプリケーションのルートディレクトリ下にJSPファイルを配置する必要があります。Webアプリケーションのルートディレクトリ下以外にあるJSPファイルを指定した場合は無視されます。

includeディレクティブを使用する場合

includeディレクティブのpage属性に"/"から始まるパスを指定した場合，このオプションで指定されたルートディレクトリからインクルード対象のJSPファイル，または静的コンテンツが検索されます。また，page属性に"/"から始まるパスを指定していても，-rootオプションを指定していない場合は，コマンドに指定したJSPファイルのディレクトリから"/"以下のファイルが検索されます。

タグライブラリを使用する場合

-taglibオプションの<location>に指定されたパス，または-taglibオプションを使用しないでJSPファイル内に直接記述されたtldファイルの検索に使用されます。タグライブラリを使用する場合，-rootオプションは必ず指定してください。

tldファイルがjarファイルに含まれる場合，そのjarファイルの検索に使用されます。この場合，使用するjarファイルは指定したWebアプリケーションのルートディレクトリ下のWEB-INF¥lib¥（UNIXの場合，WEB-INF/lib/）ディレクトリ下に配置する必要があります。

クラスパスを指定する場合

javaファイル生成時にクラスパスの指定が必要な場合，Webアプリケーションのルートディレクトリ下のWEB-INF¥classes¥（UNIXの場合，WEB-INF/classes/）ディレクトリ，またはWEB-INF¥lib¥（UNIXの場合，WEB-INF/lib/）ディレクトリ下にclassファイル，jarファイルを配置します。クラスパスの指定が必要な場合については，-classpathオプションの説明を参照してください。

-taglib <uri> <location>

タグライブラリを使用する場合に，<uri>および<location>に，それぞれweb.xmlに定義する<taglib-uri>タグ，<taglib-location>タグの内容を指定します。-taglibオプションを指定する場合，-rootオプションでWebアプリケーションのルートディレクトリを指定する必要があります。

複数のタグライブラリを使用する場合，-taglib <uri> <location>の形式で複数指定します。

<JSPファイル名>

javaソースファイルを生成するJSPファイルを指定します。複数のJSPファイルを指定する場合は，空白で区切って指定します。

複数のJSPファイルを指定した場合，同名のJSPファイルがあるときは，先に生成されたjavaソースファイルは，あとから生成されたjavaソースファイルに上書きされます。

複数のJSPファイルを指定した場合，指定した順にjavaソースが生成されます。途中でエラーを検出した場合はjavaソースファイルの生成が中断されます。

戻り値

0：

正常終了しました。

1：

オプション解析エラーです。

2以上：

異常終了しました。

注意事項

このコマンドで生成されたjavaソースファイルは，javacコマンドでコンパイルすることで，<%! ... %>タグ，<% ... %>タグ，または<%= ... %>タグで記述したjava言語ソースコードのコンパイル確認もできます。ただし，生成されたjavaソースファイルおよびjavacコマンドで作成したclassファイルは，サーバの実行環境では使用できません。

13.　構築済み実行環境の切り替えで使用するコマンド

この章では，構築済み実行環境の切り替えで使用するコマンドの入力形式，機能などについて説明します。

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

＜この章の構成＞

13.1　構築済み実行環境の切り替えで使用するコマンドの一覧

13.2　構築済み実行環境の切り替えで使用するコマンドの詳細

13.1　構築済み実行環境の切り替えで使用するコマンドの一覧

構築済み実行環境の切り替えで使用するコマンドの一覧を次の表に示します。

表13-1　構築済み実行環境の切り替えで使用するコマンドの一覧

コマンド名称 | 分類 | 概要
cosmienv | 構築済み実行環境の退避，回復，削除，一覧出力 | 実行環境の退避・回復を行います。

13.2　構築済み実行環境の切り替えで使用するコマンドの詳細

構築済み実行環境の切り替えで使用するコマンドの入力形式，機能などを次に示します。

＜この節の構成＞

cosmienv（構築済み実行環境の退避，回復，削除，一覧出力）

cosmienv（構築済み実行環境の退避，回復，削除，一覧出力）

形式

cosmienv <オプション> [-I<識別子>]
                     [-P<退避パス>]
                     [-f]

機能

実行環境の退避・回復，退避環境の削除または一覧を表示します。

引数

<オプション>

-s

構築済み実行環境を退避します。

-d

退避環境を削除します。

-r

退避環境を回復します。

-l

現在の退避環境の一覧を表示します。

-h

cosmienvコマンドのヘルプを表示します。

-I <識別子>

退避環境を識別するための識別子を指定します。

20文字までの半角英数字で指定します。

-s，-d，-rオプションを使用する場合には，識別子の指定は必須です。

-P <退避パス>

構築済み実行環境を退避するパス名をフルパスで指定します。

半角空白，全角空白，タブ文字を含むパス名は指定できません。

構築済み実行環境の退避先は <退避パス>/<識別子> となります。

-sオプションを使用する場合には，退避パスの指定は必須です。

-f

-rオプションを指定した場合に，退避環境を強制的に回復することを指定します。

-fオプションを指定した場合，Cosminexusのインストール先にファイルが残っていても，退避環境の回復が実行されます。

-fオプションを指定しない場合，Cosminexusのインストール先にファイルが残っていると，退避環境の回復は実行されません。

-rオプション以外のオプションと組み合わせて指定した場合，無効です。

出力形式

退避環境の一覧表示

aa…aa bb…bb cccc/dd/ee ff:gg:hh ii…ii jj…jj kk…kk

aa…aa　退避機能実行時に指定した識別子

bb…bb　退避機能実行時に指定した退避パス

cccc　退避機能実行時の時刻（年）

dd　退避機能実行時の時刻（月）

ee　退避機能実行時の時刻（日）

ff　退避機能実行時の時刻（時）

gg　退避機能実行時の時刻（分）

hh　退避機能実行時の時刻（秒）

ii…ii　退避した製品の形名

jj…jj　退避した製品のVV-RR-SS

kk…kk　退避した製品名

入力例・出力例

入力例

退避環境の一覧を表示します。

cosmienv -l

出力例

KEUC00001-I The cosmienv -l command will now start.
UCAPSE001 /home/CosmiBackup 2007/03/23 15:02:36 P-1M43-7K71 07-50 uCosminexus Application Server Enterprise
UCAPSS001 /home/CosmiBackup 2007/03/23 16:06:08 P-1M43-7D71 07-50 uCosminexus Application Server Standard
KEUC00002-I The cosmienv -l command ended successfully.

戻り値

コマンドの戻り値を次の表に示します。

表13-2　cosmienvコマンドの戻り値一覧

戻り値
意味

0
正常終了しました。

128
異常終了しました。

129
構築済み実行環境の退避・回復の元情報が正しくありません。

130
構築済み実行環境の退避・回復の後処理で障害が発生しました。

131
構築済み実行環境の退避・回復のための情報が正しくありません。

133
ディスクのアクセスでエラーが発生しました。

135
ファイルのオープンでエラーが発生しました。

138
引数の指定に誤りがあります。

139
製品がサポートしていない機能を指定しています。

140
コマンド実行中です。

141
コマンドの実行環境が正しくありません。

142
コマンドの実行権限がありません。

143
製品の構成ソフトウェアで障害が発生しました。
構成ソフトウェア※の戻り値が付与されています。

注※　障害が発生した構成ソフトウェアについては，コマンドで出力されるログファイルで確認してください。

戻り値「143」で付与される構成ソフトウェア別の戻り値を次の表に示します。

表13-3　構成ソフトウェア別の戻り値一覧

構成ソフトウェア | 戻り値 | 意味
Cosminexus cFramework | 128 | 異常終了しました。
144 | 退避に失敗しました。
Cosminexus Component Container | 145 | HNTRLibのインストールに失敗しました。
146 | 退避に失敗しました。
147 | 異常終了しました。
Cosminexus Component Transaction Monitor | 129 | 退避・回復の元情報が正しくありません。
130 | 退避・回復の後処理でエラーが発生しました。
131 | 退避・回復のための情報が正しくありません。
138 | 引数の指定に誤りがあります。
142 | 実行権限がありません。
146 | 退避先ディレクトリがありません。
147 | そのほかのエラーが発生しました。
148 | ファイルおよびディレクトリの削除に失敗しました。
Cosminexus DABroker Library | 128 | 異常終了しました。
131 | 退避・回復の元情報が正しくありません。
138 | 引数の指定に誤りがあります。
144 | Cosminexus DABroker Libraryが実行中です。
Cosminexus Developer's Kit for Java | 131 | 構築済み実行環境の退避・回復のための情報が正しくありません。
138 | 引数の指定に誤りがあります。
144 | 回復に失敗しました。
145 | /opt/Cosminexus/jdkがシンボリックリンクファイルです。
146 | そのほかのエラーが発生しました。
Cosminexus Performance Tracer | 129 | 退避・回復の元情報が正しくありません。
130 | 退避・回復の後処理でエラーが発生しました。
131 | 退避・回復のための情報が正しくありません。
138 | 引数の指定に誤りがあります。
142 | 実行権限がありません。
145 | HCCLibのインストールに失敗しました。
146 | 退避先のディレクトリがありません。
147 | そのほかのエラーが発生しました。
148 | ファイルおよびディレクトリの削除に失敗しました。
Cosminexus Reliable Messaging | 129 | 退避・回復の元情報が正しくありません。
130 | 退避・回復の後処理でエラーが発生しました。
144 | HNTRLib2のインストールに失敗しました。
145 | 退避先のディレクトリがありません。
146 | そのほかのエラーが発生しました。
Cosminexus TPBroker | 129 | 退避・回復の元情報が正しくありません。
130 | 退避・回復の後処理でエラーが発生しました。
131 | 退避・回復のための情報が正しくありません。
133 | ディスクのアクセスでエラーが発生しました。
135 | ファイルのオープンでエラーが発生しました。
144 | HCCLibのインストールに失敗しました。
145 | HNTRLib2のインストールに失敗しました。
146 | 退避に失敗しました。
147 | 日立PPインストーラ情報の取得・設定に失敗しました。
Cosminexus Web Services - Security | 129 | 退避・回復の元情報が正しくありません。
130 | 退避・回復の後処理でエラーが発生しました。
131 | 退避・回復のための情報が正しくありません。
138 | 引数の指定に誤りがあります。
146 | 退避に失敗しました。
147 | そのほかのエラーが発生しました。
148 | ファイルおよびディレクトリの削除に失敗しました。
Cosminexus XML Processor | 128 | 異常終了しました。
138 | 引数の指定に誤りがあります。
144 | 退避に失敗しました。
145 | HNTRLib2のインストールに失敗しました。
Hitachi Web Server | 128 | 異常終了しました。
138 | 引数の指定に誤りがあります。
144 | 退避に失敗しました。

注意事項

このコマンドはスーパーユーザで実行してください。

退避機能実行時は，Cosminexusが提供するすべてのプログラムが停止中であることを確認してください。

回復機能実行時は，Cosminexusが提供するすべての製品がアンインストール済みであることを確認してください。

すべての製品をアンインストールし，かつCosminexusのインストール先にファイルやディレクトリが残った状態で回復機能を実行したい場合は，-fオプションを指定してください。この場合，回復処理によってインストール先に残ったファイルが更新されることがあります。

退避機能で退避する範囲以外でCosminexusの動作に必要なものは，ユーザで退避してください。退避機能で退避する範囲およびユーザで退避が必要なファイルについては，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

14.　Webコンテナサーバで使用するコマンド

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

＜この章の構成＞

14.1　Webコンテナサーバで使用するコマンドの一覧

14.2　Webコンテナサーバで使用するコマンドの詳細

14.1　Webコンテナサーバで使用するコマンドの一覧

Webコンテナサーバで使用するコマンドの一覧を，次の表に示します。

表14-1　Webコンテナサーバで使用するコマンドの一覧

コマンド名称
分類
概要

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

cjenvsetup
Component Container管理者のセットアップ
インストールファイルの属性を変更して，root権限を持つユーザ以外で運用できるようにします。
このコマンドは，UNIX用です。
このコマンドについては，「2.　J2EEサーバで使用するコマンド」の「cjenvsetup」を参照してください。

cjgetsysinfo
OS状態情報の取得
OSの状態情報を取得します。
このコマンドについては，「2.　J2EEサーバで使用するコマンド」の「cjgetsysinfo」を参照してください。

cjstartweb
Webコンテナサーバの開始
Webコンテナサーバを開始します。

cjstopweb
Webコンテナサーバの停止
Webコンテナサーバを停止します。

cjwebchangedbid
データベースIDの変更
プール管理情報のデータベースIDを変更します。

cjwebclearpool
プール内のコネクションのクリア
データベースのコネクションをクローズして，クローズしたコネクションをプールから削除します。

cjwebclosepool
プール内のコネクションの強制切断
データベースのコネクションをプールから削除して，クローズします。

cjwebdeletepool
プール管理情報の削除
データベースのプール管理情報を削除します。

cjwebeditpool
プール管理情報の登録と変更
プール管理情報を新規登録または変更します。

cjweblistpool
プール管理情報の一覧表示
プール管理情報の一覧を表示します。

cjwebsetup
Webコンテナサーバのセットアップとアンセットアップ
Webコンテナの環境をセットアップまたはアンセットアップします。

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

14.2　Webコンテナサーバで使用するコマンドの詳細

Webコンテナサーバで使用する各コマンドの入力形式，機能などを次に示します。

コマンドの格納先

Webコンテナサーバで使用するコマンドは，次のディレクトリに格納されています。

cjdumpwebコマンド，cjstartwebコマンド，cjstopwebコマンド，cjwebsetupコマンド

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥bin¥

UNIXの場合
/opt/Cosminexus/CC/web/bin/

それ以外のコマンド

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥admin¥bin¥

UNIXの場合
/opt/Cosminexus/CC/admin/bin/

＜この節の構成＞

cjdumpweb（Webコンテナサーバのスレッドダンプの取得）

cjstartweb（Webコンテナサーバの開始）

cjstopweb（Webコンテナサーバの停止）

cjwebchangedbid（データベースIDの変更）

cjwebclearpool（プール内のコネクションのクリア）

cjwebclosepool（プール内のコネクションの強制切断）

cjwebdeletepool（プール管理情報の削除）

cjwebeditpool（プール管理情報の登録と変更）

cjweblistpool（プール管理情報の一覧表示）

cjwebsetup（Webコンテナサーバのセットアップとアンセットアップ）

cjdumpweb（Webコンテナサーバのスレッドダンプの取得）

形式

cjdumpweb [<サーバ名称>]

機能

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

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

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥javacore*.txt

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/javacore*.txt

引数

<サーバ名称>

Webコンテナのサーバ名称を指定します。サーバ名称には，半角英数字（0～9，A～Z，a～z），アンダースコア（_）またはハイフン（-）が使用できます。サーバ名称の先頭の文字は英数字でなければなりません。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

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

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

cjstartweb（Webコンテナサーバの開始）

形式

cjstartweb [<サーバ名称>] [-security]

機能

サーバ名称のWebコンテナサーバを開始します。

引数

<サーバ名称>

開始するWebコンテナのサーバ名称を指定します。サーバ名称には，半角英数字（0～9，A～Z，a～z），アンダースコア（_）またはハイフン（-）が使用できます。サーバ名称の先頭の文字は英数字でなければなりません。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-security

Webコンテナの実行時保護機能を有効にします。

戻り値

0：

正常終了しました。

1以上：

異常終了しました。

ユーザ定義ファイル

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥usrconf¥usrconf.cfg

<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥usrconf¥usrconf.properties

UNIXの場合

/opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf/usrconf.cfg

/opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf/usrconf.properties

注意事項

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

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

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

cjstopweb（Webコンテナサーバの停止）

形式

cjstopweb [<サーバ名称>]
         [-f|-fd [<スレッドダンプ取得間隔> <スレッドダンプ取得回数>]]

機能

サーバ名称のWebコンテナサーバを停止します。

引数

<サーバ名称>

停止するWebコンテナサーバのサーバ名称を指定します。サーバ名称には，半角英数字（0～9，A～Z，a～z），アンダースコア（_）またはハイフン（-）が使用できます。サーバ名称の先頭の文字は英数字でなければなりません。サーバ名称を省略したときは，ホスト名称がサーバ名称として使用されます。

-f

Webコンテナサーバを強制停止します。

-fd

Webコンテナサーバの障害情報を取得したあと，Webコンテナサーバを強制停止します。

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

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

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

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

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

OSの稼働状況
Windowsの場合の出力先：
<Cosminexusインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥cjsysinfo.<出力時間>.txt
UNIXの場合の出力先：
/opt/Cosminexus/CC/web/containers/<サーバ名称>/cjsysinfo.<出力時間>.txt
<出力時間>は，yymmddHHMMSSの形式になります。
なお，出力内容については，「2.　J2EEサーバで使用するコマンド」の「cjgetsysinfo（OS状態情報の取得）」を参照してください。

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

Webコンテナサーバのクラッシュダンプ（Windowsの場合）またはcoreファイル（UNIXの場合）
最後のスレッドダンプ取得要求後，スレッドダンプ取得間隔時間経過後にクラッシュダンプまたはcoreファイルを出力します。
クラッシュダンプの出力先：
<ワトソン博士のクラッシュダンプ出力先>※¥user.dump
注※
　ワトソン博士のクラッシュダンプ作成オプションの設定が必要です。

coreファイルの出力先：
/opt/Cosminexus/CC/web/containers/<サーバ名称>/core※
注※
　Linuxの場合，core.<強制停止されたWebコンテナサーバのプロセスID>

戻り値

0：

正常終了しました。

1以上：

異常終了しました。

ユーザ定義ファイル

Windowsの場合

<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥usrconf¥usrconf.cfg

<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥usrconf¥usrconf.properties

UNIXの場合

/opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf/usrconf.cfg

/opt/Cosminexus/CC/web/containers/<サーバ名称>/usrconf/usrconf.properties

注意事項

Webコンテナサーバを停止させるには，必ずcjstopwebコマンドを使用してください。［Ctrl+C］やタスクマネージャ（Windowsの場合）から停止しないでください。

cjstopwebコマンドでWebコンテナサーバを停止する場合，サーブレットまたはJSPのサービスメソッドが実行中のときは，該当するメソッドが終了するまでWebコンテナサーバは停止しません。なお，cjstopwebコマンドは，Webコンテナサーバの終了を待たないで，すぐに終了します。

サーブレットまたはJSPのサービスメソッドが実行中の状態でcjstopwebコマンドを実行した場合，Webコンテナサーバを停止できないことがあります。この場合，-fオプションまたは-fdオプションを指定して，再度cjstopwebコマンドを実行することでWebコンテナサーバを強制停止します。

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

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

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

cjwebchangedbid（データベースIDの変更）

形式

cjwebchangedbid [-host <ホスト名称>] [-port <ポート番号>]
               -olddbid <データベースID> -newdbid <データベースID>

機能

-olddbidに指定されたデータベースIDに該当するプール管理情報のデータベースIDを，-newdbidに指定されたデータベースIDに変更します。-olddbidと-newdbidに同じデータベースIDを指定された場合，処理は実行しません。

使用中のプールのデータベースIDを変更した場合は，Webコンテナを再起動した時に変更内容が有効となります。

引数

-host <ホスト名称>

接続先のホスト名称として，コマンドからのリクエスト要求を受け付けるサーブレットが動作しているホスト名称を指定します。指定を省略した場合は，localhostが仮定されます。

-port <ポート番号>

コマンドからのリクエスト要求を受け付けるサーブレットが使用するポート番号として，サーブレットが管理されているWebコンテナのポート番号を指定します。指定を省略した場合は，8080が仮定されます。

-olddbid <データベースID>

変更の対象となる現在のデータベースIDを指定します。データベースIDには，半角英数字（0～9，A～Z，a～z）またはアンダースコア（_）が使用できます。

-newdbid <データベースID>

変更後のデータベースIDを指定します。データベースIDには，半角英数字（0～9，A～Z，a～z）またはアンダースコア（_）が使用できます。

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

入力例

cjwebchangedbid -olddbid db_1 -newdbid db_2

注意事項

引数は，コマンド名の直後に指定する必要があります。引数は，コマンド名より後ろにあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<データベースID> -olddbid）はできません。

cjwebclearpool（プール内のコネクションのクリア）

形式

cjwebclearpool [-host <ホスト名称>] [-port <ポート番号>]
              [-mode {normal|plan}] [-dbid <データベースID>]

機能

動作種別を選択して，プール内のすべてのコネクションまたは指定されたデータベースのコネクションをクローズします。クローズしたコネクションは，プールから削除します。

このコマンドは，データベースサーバが異常終了した場合やネットワークが切断された場合などの，システム障害時に実行するコマンドです。このコマンドでは，プールからコネクションを削除してクローズすることだけを実行します。新たなコネクションは生成しません。

引数

-host <ホスト名称>

接続先のホスト名称として，コマンドからのリクエスト要求を受け付けるサーブレットが動作しているホスト名称を指定します。指定を省略した場合は，localhostが仮定されます。

-port <ポート番号>

コマンドからのリクエスト要求を受け付けるサーブレットが使用するポート番号として，サーブレットが管理されているWebコンテナのポート番号を指定します。指定を省略した場合は，8080が仮定されます。

-mode {normal|plan}

使用中のコネクションに対するクリア動作の種別を指定します。

normal（通常モード）
ユーザが使用中のコネクションはプールの外へ移して，プール内からはクリアされます。データベースとの接続はそのまま維持されますが，再利用はできません。

plan（計画モード）
ユーザが使用中のコネクションはクリアしません。ただし，再利用はできません。

-dbid <データベースID>

削除対象となるプール管理情報のデータベースIDを指定します。データベースIDには，半角英数字（0～9，A～Z，a～z）またはアンダースコア（_）が使用できます。

省略すると，指定した動作種別で，すべてのプール管理情報を対象に処理が実行されます。

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

入力例

cjwebclearpool -mode normal -dbid db_1

注意事項

引数は，コマンド名の直後に指定する必要があります。引数は，コマンド名より後ろにあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<データベースID> -dbid）やオプション名と値を非対応にすること（例：-mode <データベースID> -dbid normal）はできません。

cjwebclosepool（プール内のコネクションの強制切断）

形式

コネクションIDを指定する場合

cjwebclosepool [-host <ホスト名称>] [-port <ポート番号>]
              -dbid <データベースID> -type connectionid
              -cid <コネクションID>

タイムアウト時間を指定する場合

cjwebclosepool [-host <ホスト名称>] [-port <ポート番号>]
              -dbid <データベースID> -type timeout
              -time <タイムアウト時間>

機能

指定されたコネクションIDに該当するコネクション，または指定されたタイムアウト時間を超過したコネクションをプールから削除して，クローズします。

指定されたタイムアウト時間を超過したコネクションをプールから削除する場合，プールまたはデータベースに対してgetConnectionメソッド，SQLステートメントなどが実行されてからの経過時間が，指定された時間を超えているコネクションが対象となります。

このコマンドは，コネクションが使用中のまま長時間放置されている場合などに使用します。コネクションIDまたは経過時間をキーにして削除して，プール内のコネクションが［Minimum size］に達していない場合は，新たにプールにコネクションを生成します。

引数

-host <ホスト名称>

接続先のホスト名称として，コマンドからのリクエスト要求を受け付けるサーブレットが動作しているホスト名称を指定します。指定を省略した場合は，localhostが仮定されます。

-port <ポート番号>

コマンドからのリクエスト要求を受け付けるサーブレットが使用するポート番号として，サーブレットが管理されているWebコンテナのポート番号を指定します。指定を省略した場合は，8080が仮定されます。

-dbid <データベースID>

削除対象となるプール管理情報のデータベースIDを指定します。データベースIDには，半角英数字（0～9，A～Z，a～z）またはアンダースコア（_）が使用できます。

-type {connectionid|timeout}

コネクションを削除する基準の種別を指定します。

connectionid
コネクションIDを基に，プールからコネクションを削除します。

timeout
タイムアウト時間を基に，プールからコネクションを削除します。

-cid <コネクションID>

削除対象となるコネクションのコネクションIDを指定します。

-time <タイムアウト時間>

コネクションを削除する際のタイムアウト時間を指定します。コネクション最終アクセス時刻から，指定時間を超過したコネクションが削除対象となります。指定は秒単位で，指定できる値は0≦指定値≦2147483647の範囲になります。

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

入力例

コネクションIDを指定する場合

cjwebclosepool -dbid db_1 -type connectionid -cid connection1

タイムアウト時間を指定する場合

cjwebclosepool -dbid db_1 -type timeout -time 36000

注意事項

引数は，コマンド名の直後に指定する必要があります。引数は，コマンド名より後ろにあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<データベースID> -dbid）やオプション名と値を非対応にすること（例：-dbid timeout -type <データベースID>）はできません。

cjwebdeletepool（プール管理情報の削除）

形式

cjwebdeletepool [-host <ホスト名称>] [-port <ポート番号>]
               -dbid <データベースID>

機能

指定されたデータベースIDに該当するプール管理情報を削除します。

使用中のプール管理情報が削除された場合，動作中のプールには影響を与えません。Webコンテナを再起動した時に有効になります。

引数

-host <ホスト名称>

接続先のホスト名称として，コマンドからのリクエスト要求を受け付けるサーブレットが動作しているホスト名称を指定します。指定を省略した場合は，localhostが仮定されます。

-port <ポート番号>

コマンドからのリクエスト要求を受け付けるサーブレットが使用するポート番号として，サーブレットが管理されているWebコンテナのポート番号を指定します。指定を省略した場合は，8080が仮定されます。

-dbid <データベースID>

削除対象となるプール管理情報のデータベースIDを指定します。データベースIDには，半角英数字（0～9，A～Z，a～z）またはアンダースコア（_）が使用できます。

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

注意事項

引数は，コマンド名の直後に指定する必要があります。引数は，コマンド名より後ろにあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<データベースID> -dbid）はできません。

cjwebeditpool（プール管理情報の登録と変更）

形式

cjwebeditpool [-host <ホスト名称>] [-port <ポート番号>]
             -c <プール管理情報設定ファイルパス>

機能

プール管理情報を，新規登録または変更します。

登録されていないデータベースIDをプール管理情報設定ファイルに定義した場合，プール管理情報を新規登録します。すでに登録されているデータベースIDをプール管理情報設定ファイルに定義した場合，プール管理情報を変更します。

プール管理情報設定ファイルに，データベースID，クラス名およびURL名が指定されていない場合は，プール管理情報を登録できません。

プール管理情報設定ファイルは，あらかじめエディタなどを使って作成しておく必要があります。プール管理情報設定ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

プール管理情報の変更は，データベースIDをキーにして実行されます。登録されていないデータベースIDを指定した場合，プール管理情報が新規に作成，登録されます。

引数

-host <ホスト名称>

接続先のホスト名称として，コマンドからのリクエスト要求を受け付けるサーブレットが動作しているホスト名称を指定します。指定を省略した場合は，localhostが仮定されます。

-port <ポート番号>

コマンドからのリクエスト要求を受け付けるサーブレットが使用するポート番号として，サーブレットが管理されているWebコンテナのポート番号を指定します。指定を省略した場合は，8080が仮定されます。

-c <プール管理情報設定ファイルパス>

読み込み対象となるプール管理情報ファイル設定ファイルのパスを指定します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

注意事項

引数は，コマンド名の直後に指定する必要があります。引数は，コマンド名より後ろにあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<プール管理情報設定ファイルパス> -c）はできません。

プール管理情報を新規に登録する場合は，プール管理情報設定ファイルに<DatabaseID>，<ClassName>，<URL>を必ず指定してください。

プール管理情報を変更する場合は，プール管理情報設定ファイルに<DatabaseID>を必ず指定してください。

プール管理情報設定ファイルの<ClassName>と<URL>は対で指定してください。

プール管理情報設定ファイルのそれぞれのタグには，次の条件を満たす値を指定してください。

<UserCount> ≧ 0

<MinimumSize> ≦ <MaximumSize>かつ<MaximumSize> ≧ 1

<MinimumSize> ≧ 0

<MaximumSize> ≧ 0

<RetryInterval> ≧ 0

<RetryCount> ≧ 0

新規登録または変更されたプール管理情報に対して，まだ一度もコネクション取得要求がない場合，コネクション取得要求することで新規登録または変更したプール管理情報が反映されたプールが生成されます。

すでに使用中のプール管理情報を変更した場合，コマンド実行時に<DatabaseID>，<ClassName>，<URL>以外の項目が変更されます。<DatabaseID>，<ClassName>，<URL>については，Webコンテナを再起動してプールを再作成した時に有効になります。

新規登録時に<DatabaseID>，<ClassName>，<URL>以外の項目を省略した場合は，デフォルトの値が設定されます。

プール管理情報設定ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

cjweblistpool（プール管理情報の一覧表示）

形式

データベースリストを表示する場合

cjweblistpool [-host <ホスト名称>] [-port <ポート番号>]
             -listtype dblist [-f <ファイルパス>]

プールリストを表示する場合

cjweblistpool [-host <ホスト名称>] [-port <ポート番号>]
             -dbid <データベースID> -listtype poollist
             [-f <ファイルパス>]

コネクションリストを表示する場合

cjweblistpool [-host <ホスト名称>] [-port <ポート番号>]
             -dbid <データベースID> -userid <ユーザID>
             -listtype connectionlist[-f <ファイルパス>]

すべてのプール情報を表示する場合

cjweblistpool [-host <ホスト名称>] [-port <ポート番号>]
             -listtype all [-f <ファイルパス>]

機能

プール管理情報の一覧を表示します。表示できるプール管理情報を次に示します。

データベースリスト

データベースリスト（データベースID，データベースクラス，データベースURL，ユーザ数，コネクション最小数，コネクション最大数，リトライ待ち時間，リトライ回数，およびプールの数）を表示します。または，指定されたファイルに出力します。

プールリスト

プールリスト（ユーザID，コネクション取得待ちカウンタ，およびコネクションの数）と，キー項目のデータベースIDを表示します。または，指定されたファイルに出力します。

コネクションリスト

コネクションリスト（コネクションID，使用中フラグ，再利用可否フラグ，コネクション生成時刻，コネクション最終アクセス時刻）と，キー項目のデータベースID，ユーザIDおよびコネクションIDを表示します。または，指定されたファイルに出力します。

すべてのプール管理情報

上記のすべてのプール管理情報を一覧表示します。または，指定されたファイルに出力します。

表示順序は次の図中の番号に示した順番になります。一つのデータベースリストに関連するプールリストが表示され終わってから，次のデータベースリストが表示されます。また，一つのプールリストに関連するプールリストに関連するコネクションリストが表示され終わってから，次のプールリストが表示されます。

なお，データベースリスト，プールリストおよびコネクションリストに出力される項目については，-listtypeオプションのオプション引数に，dblist，poollist，connectionlistを指定した場合と同じです。

引数

-host <ホスト名称>

接続先のホスト名称として，コマンドからのリクエスト要求を受け付けるサーブレットが動作しているホスト名称を指定します。指定を省略した場合は，localhostが仮定されます。

-port <ポート番号>

コマンドからのリクエスト要求を受け付けるサーブレットが使用するポート番号として，サーブレットが管理されているWebコンテナのポート番号を指定します。指定を省略した場合は，8080が仮定されます。

-listtype {dblist|poollist|connectionlist|all}

表示対象となるプール管理情報の種別を指定します。

dblist
データベースリストを一覧表示します。

poollist
プールリストを一覧表示します。

connectionlist
コネクションリストを一覧表示します。

all
すべてのプール管理情報を一覧表示します。

-f <ファイルパス>

プール管理情報の出力先ファイルのパスを指定します。

-dbid <データベースID>

処理対象となるプール管理情報のデータベースIDを指定します。データベースIDには，半角英数字（0～9，A～Z，a～z）またはアンダースコア（_）が使用できます。

-userid <ユーザID>

処理対象となるプール管理情報のユーザIDを指定します。

入力例

データベースリストを表示する場合

cjweblistpool -listtype dblist -f db1.list

プールリストを表示する場合

cjweblistpool -dbid db_1 -listtype poollist -f pool1.list

コネクションリストを表示する場合

cjweblistpool -dbid db_1 -userid user1 -listtype connectionlist -f connection1.list

すべてのプール情報を表示する場合

cjweblistpool -listtype all -f all.list

出力形式

データベースリストを表示する場合

<DatabaseID=<データベースID1>><ClassName=<データベースクラス>><URL=<データベースURL>><UserCount=<ユーザ数>><MinimumSize=<コネクション最小数>><MaximumSize=<コネクション最大数>><RetryInterval=<リトライ待ち時間>><RetryCount=<リトライ回数>><PoolCount=<プールの数>>
<DatabaseID=<データベースID2>><ClassName=<データベースクラス>><URL=<データベースURL>><UserCount=<ユーザ数>><MinimumSize=<コネクション最小数>><MaximumSize=<コネクション最大数>><RetryInterval=<リトライ待ち時間>><RetryCount=<リトライ回数>><PoolCount=<プールの数>>
・・・
・・・

プールリストを表示する場合

<DatabaseID=<データベースID1>><UserID=<ユーザID1>><WaitCount=<コネクション取得待ちカウンタ>><ConnectionCount=<コネクションの数>>
<DatabaseID=<データベースID1>><UserID=<ユーザID2>><WaitCount=<コネクション取得待ちカウンタ>><ConnectionCount=<コネクションの数>>
<DatabaseID=<データベースID2>><UserID=<ユーザID3>><WaitCount=<コネクション取得待ちカウンタ>><ConnectionCount=<コネクションの数>>
・・・
・・・

コネクションリストを表示する場合

<DatabaseID=<データベースID1>><UserID=<ユーザID1>><ConnectionID=<コネクションID1>><ConnectionBusy=<使用中フラグ>><ConnectionReuse=<再利用可否フラグ>><ConnectionTime=<コネクション生成時刻>><LastTime=<最終アクセス時刻>>
<DatabaseID=<データベースID1>><UserID=<ユーザID2>><ConnectionID=<コネクションID2>><ConnectionBusy=<使用中フラグ>><ConnectionReuse=<再利用可否フラグ>><ConnectionTime=<コネクション生成時刻>><LastTime=<最終アクセス時刻>>
<DatabaseID=<データベースID2>><UserID=<ユーザID3>><ConnectionID=<コネクションID3>><ConnectionStatus=NotUsed><ReuseStatus=NotReuse><ConnectionTime=2003/11/25 11:36:00.616><LastTime=2003/11/25 11:40:00.313>
<DatabaseID=<データベースID2>><UserID=<ユーザID3>><ConnectionID=<コネクションID4>><ConnectionStatus=Used><ReuseStatus=Reuse><ConnectionTime=2003/11/25 11:37:00.256><LastTime=2003/11/25 11:37:00.256>
・・・
・・・

すべてのプール管理情報を表示する場合

<DatabaseID=<データベースID1>><ClassName=<データベースクラス>><URL=<データベースURL>><UserCount=<ユーザ数>><MinimumSize=<コネクション最小数>><MaximumSize=<コネクション最大数>><RetryInterval=<リトライ待ち時間>><RetryCount=<リトライ回数>><PoolCount=<プールの数>>
<DatabaseID=<データベースID1>><UserID=<ユーザID1>><WaitCount=<コネクション取得待ちカウンタ>><ConnectionCount=<コネクションの数>>
<DatabaseID=<データベースID1>><UserID=<ユーザID1>><ConnectionID=<コネクションID1>><ConnectionStatus=<使用中フラグ>><ReuseStatus=<再利用可否フラグ>><ConnectionTime=<コネクション生成時刻>><LastTime=<最終アクセス時刻>>
<DatabaseID=<データベースID1>><UserID=<ユーザID2>><WaitCount=<コネクション取得待ちカウンタ>><ConnectionCount=<コネクションの数>>
<DatabaseID=<データベースID1>><UserID=<ユーザID2>><ConnectionID=<コネクションID2>><ConnectionStatus=<使用中フラグ>><ReuseStatus=<再利用可否フラグ>><ConnectionTime=<コネクション生成時刻>><LastTime=<最終アクセス時刻>>
<DatabaseID=<データベースID2>><ClassName=<データベースクラス>><URL=<データベースURL>><UserCount=<ユーザ数>><MinimumSize=<コネクション最小数>><MaximumSize=<コネクション最大数>><RetryInterval=<リトライ待ち時間>><RetryCount=<リトライ回数>><PoolCount=1>
<DatabaseID=<データベースID2>><UserID=<ユーザID3>><WaitCount=<コネクション取得待ちカウンタ>><ConnectionCount=2>
<DatabaseID=<データベースID2>><UserID=<ユーザID3>><ConnectionID=<コネクションID3>><ConnectionStatus=NotUsed><ReuseStatus=NotReuse><ConnectionTime=2003/11/25 11:36:00.616><LastTime=2003/11/25 11:40:00.313>
<DatabaseID=<データベースID2>><UserID=<ユーザID3>><ConnectionID=<コネクションID4>><ConnectionStatus=Used><ReuseStatus=Reuse><ConnectionTime=2003/11/25 11:37:00.256><LastTime=2003/11/25 11:37:00.256>
・・・
・・・

戻り値

0：

正常終了しました。

1：

異常終了しました。

2：

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

注意事項

引数は，コマンド名の直後に指定する必要があります。引数は，コマンド名より後ろにあれば順序は任意です。ただし，オプション名と値の順序の入れ替え（例：<データベースID> -dbid）やオプション名と値を非対応にすること（例：-dbid timeout -type <データベースID>）はできません。

cjwebsetup（Webコンテナサーバのセットアップとアンセットアップ）

形式

セットアップの場合

cjwebsetup [<サーバ名称>]

アンセットアップの場合

cjwebsetup -d <サーバ名称>

機能

指定したサーバ名称のWebコンテナの環境をセットアップまたはアンセットアップします。

-dオプションを指定した場合，次に示すWebコンテナの環境（ディレクトリおよびファイル）の<サーバ名称>以下を削除します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥web¥containers¥<サーバ名称>¥

UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/

引数

<サーバ名称>

セットアップまたはアンセットアップするWebコンテナのサーバ名称を指定します。

サーバ名称には，半角英数字（0～9，A～Z，a～z），アンダースコア（_）またはハイフン（-）が使用できます。サーバ名称の先頭の文字は英数字でなければなりません。また，サーバ名称は，マニュアル「Cosminexus　システム構築ガイド」のCosminexusの作業ディレクトリの説明を参照して見積もった範囲内の長さで指定できます。

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

-d

Webコンテナの環境を削除する場合に指定します。

戻り値

0：

正常終了しました。

1：

異常終了しました。

注意事項

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

Windowsの場合，サーバ名称の大文字・小文字は区別されません。作成済みのサーバ名称と，大文字・小文字の区別以外は一致している文字列をcjwebsetupのサーバ名称として指定した場合，次のように動作します。

セットアップの場合(cjwebsetup <サーバ名称>)
セットアップに失敗します。

アンセットアップの場合(cjwebsetup -d <サーバ名称>)
すでに作成済みである，<サーバ名称>と大文字・小文字の区別以外は一致しているサーバが削除されます。

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

起動中のWebコンテナサーバに対して，-dオプションで削除しないでください。

Windowsの場合，削除対象のファイルの属性が読み取り専用，または使用中のときに，-dオプションで削除しないでください。

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

UNIXの場合，削除対象のディレクトリ，ファイルのアクセス権の設定および使用状態に関係なく，すべて削除します。

Webコンテナサーバを再セットアップする場合，cjwebsetup -d <サーバ名称>でサーバの環境をいったん削除してから再度セットアップコマンドを実行してください。

付録

＜この付録の構成＞

付録A　JavaVMで使用するポート番号と設定変更方法

付録B　dabsetup（Cosminexus DABroker Libraryのセットアップ）

付録C　J2EEアプリケーションを実行するシステムの構築と削除

付録D　J2EEアプリケーションを実行するシステムの起動と停止（Windowsの場合）

付録E　J2EEアプリケーションを実行するシステムの起動と停止（UNIXの場合）

付録F　バッチアプリケーションを実行するシステムの構築と削除

付録G　バッチアプリケーションを実行するシステムの起動と停止（Windowsの場合）

付録H　バッチアプリケーションを実行するシステムの起動と停止（UNIXの場合）

付録I　（3020-3-M10-61）の変更内容

付録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クライアントアプリケーションのシステムプロパティとして設定します。詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

付録B　dabsetup（Cosminexus DABroker Libraryのセットアップ）

ここでは，UNIXの場合に使用するCosminexus DABroker Libraryのセットアップコマンドについて説明します。

なお，dabsetupコマンドを実行する前に，次の操作が必要です。

Cosminexus DABroker Libraryの管理ユーザの登録

Cosminexus DABroker Libraryインストールディレクトリ（/opt/DABroker）の属性（ユーザ，グループ）の変更

Cosminexus DABroker Libraryのセットアップについては，マニュアル「Cosminexus　システム構築ガイド」を参照してください。

コマンドの格納先

/opt/DABroker/bin/

＜この節の構成＞

(1)　形式

(2)　機能

(3)　引数

(4)　入力例

(5)　注意事項

(6)　Cosminexus DABroker Library運用ディレクトリの削除について

(1)　形式

dabsetup [-d] [<パス名>]

(2)　機能

Cosminexus DABroker Libraryの運用ディレクトリを設定します。dabsetupコマンドを実行すると，インストールディレクトリのディレクトリおよびファイルが，<パス名>に指定した運用ディレクトリに移動されます。

また，-dオプションを指定することで，運用ディレクトリを削除できます。

(3)　引数

-d

Cosminexus DABroker Library運用ディレクトリ下のCosminexus DABroker Libraryシステムを，OSから削除します。Cosminexus DABroker Library運用ディレクトリを設定する場合は，このオプションを指定しないでください。

<パス名>

Cosminexus DABroker Libraryを運用したい任意のディレクトリを指定します。

ここで指定したディレクトリ下に"DABroker"ディレクトリが作成されて，インストールディレクトリのディレクトリおよびファイルが移動されます。

指定を省略した場合，Cosminexus DABroker Library運用ディレクトリはCosminexus DABroker Libraryのインストールディレクトリ（/opt/DABroker）となります。なお，リモートファイルシステム上のディレクトリ，リモートファイルシステム，またはローカルファイルとリンクしたディレクトリは指定できません。

(4)　入力例

Cosminexus DABroker Library運用ディレクトリを設定する場合

dabsetup /home

Cosminexus DABroker Libraryシステムを削除する場合

dabsetup -d /home

(5)　注意事項

dabsetupコマンドは，スーパーユーザで実行してください。

dabsetupコマンドは，Cosminexus DABroker Libraryが停止中に実行してください。

dabsetupコマンドでCosminexus DABroker Libraryを再度セットアップする場合，運用ディレクトリのCosminexus DABroker Libraryの動作状態は初期状態になります。ただし，ユーザが作成したCosminexus DABroker Library動作環境定義ファイル，ログファイル，およびトレースファイルなどはセットアップされません。

運用ディレクトリとして指定したパスが，ファイルとして存在する場合，dabsetupコマンドの実行を中止します。

運用ディレクトリとして指定したパスに，Cosminexus DABroker Libraryが提供するディレクトリと同一名称のファイル，またはCosminexus DABroker Libraryが提供するファイルと同一名称のディレクトリが存在する場合，dabsetupコマンドの実行を中止します。

運用ディレクトリとして指定したパスが，ディレクトリとして存在する場合，上書きするかどうかを確認します。なお，上書きすることを選択しても，指定したディレクトリに存在するCosminexus DABroker Libraryがセットアップしないファイル（ユーザが作成したCosminexus DABroker Library動作環境定義ファイル，ログファイル，およびトレースファイルなど）は保証されます。

dabsetupコマンドの実行が失敗した場合，dabsetupコマンドの実行を終了して，dabsetupコマンドを実行する前の状態に戻します。

(6)　Cosminexus DABroker Library運用ディレクトリの削除について

dabsetupコマンドでの運用ディレクトリの削除に成功した場合

インストールディレクトリに，dabsetupコマンドなどのシステムで必要なファイルが残ります。インストールディレクトリに残ったファイルは，インストーラで削除してください（アンインストールしてください）。

ユーザが作成したCosminexus DABroker Library動作環境定義ファイルは，dabsetupコマンドでは削除されません。必要に応じて削除してください。

dabsetupコマンドでの運用ディレクトリの削除に失敗した場合

残ったディレクトリおよびファイルをOSのrmコマンドで削除してください。

付録C　J2EEアプリケーションを実行するシステムの構築と削除

ここでは，J2EEアプリケーションを実行するシステムを，ファイル編集とコマンド実行で構築，および削除する手順について説明します。

＜この節の構成＞

付録C.1　システム構築の流れ

付録C.2　J2EEサーバのセットアップ

付録C.3　システムの削除の流れ

付録C.4　J2EEサーバのアンセットアップ

付録C.1　システム構築の流れ

J2EEアプリケーションを実行するシステムをファイル編集とコマンド実行で構築する場合，Cosminexusが提供するコマンド，ユーザ定義ファイルなどを使用してシステムの動作環境を設定します。

＜この項の構成＞

(1)　システムの構築で使用するファイル

(2)　J2EEアプリケーションを実行するシステムを構築する流れ

(3)　トラブルシューティングに必要な資料

(1)　システムの構築で使用するファイル

J2EEアプリケーションを実行するシステムを構築する場合に使用する主なファイルを次に示します。各ファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

注意

ファイルを変更する場合は，J2EEサーバを停止してください。J2EEサーバの稼働中にファイルの内容を変更した場合の動作は保証されません。

usrconf.properties（J2EEサーバ用ユーザプロパティファイル）
J2EEサーバのユーザプロパティを指定するファイルです。J2EEサーバが使用するネーミングサービス，トランザクション，コネクション，コンテナ，ログ，セキュリティなどを指定します。
ファイルの格納場所を次に示します。

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

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

usrconf.cfg（J2EEサーバ用オプション定義ファイル）
J2EEサーバのJavaVMの起動オプションを指定するファイルです。
ファイルの格納場所を次に示します。

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

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

server.policy（J2EEサーバ用セキュリティポリシーファイル）
J2EEサーバを実行するJavaVMのセキュリティポリシーを指定するファイルです。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥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サーバとは別のサーバ名称を使用したい場合に，セットアップしてください。詳細については，「付録C.2　J2EEサーバのセットアップ」を参照してください。

J2EEサーバの動作設定をします。
デフォルトの設定のままで利用する場合は，設定不要です。
使用する機能の動作を変更したり，特定の機能を使用したりする場合には，Cosminexusが提供するユーザ定義ファイルやコマンドを使用して，J2EEサーバの動作を設定，変更します。
J2EEサーバの動作を設定，変更できる機能の例を次に示します。

ネーミングサービス

トランザクション

JavaVMの起動オプション

コンテナ拡張ライブラリ

CTMによるリクエストのスケジューリング

Cosminexusが提供する主な機能の設定内容については，マニュアル「Cosminexus　システム構築ガイド」のJ2EEサーバの動作設定に関する説明を参照してください。

トラブルシューティングの資料取得の設定をします。
デフォルトの設定のままで利用する場合は，設定不要です。ただし，次の資料は，事前に取得のための設定をしておかないと，取得できません。これらの資料はトラブルシューティングで必要となるため，取得することをお勧めします。

OSの統計情報，ユーザダンプ（Windowsの場合）またはcoreダンプ（UNIXの場合）

JavaVMのガーベージコレクションのログ

これらの資料を取得する場合や，ほかの資料の取得設定を変更したい場合に，トラブルシューティングの資料取得の設定をしてください。トラブルシューティングに必要な資料の詳細と，システム構築時の設定の要否については「付録C.1(3)　トラブルシューティングに必要な資料」を参照してください。

Webサーバとの連携の設定をします。
Webサーバと連携しない場合は，設定不要です。
リダイレクタを利用したリクエストの振り分け，通信タイムアウト，エラーページのカスタマイズなど，Webサーバと連携するための設定をします。設定方法の詳細については，マニュアル「Cosminexus　システム構築ガイド」のWebサーバとの連携の設定（アプリケーションの実行環境の場合）に関する説明を参照してください。

統合ユーザ管理機能の設定をします。
統合ユーザ管理機能を使用しない場合は，設定不要です。
Cosminexusシステムにログインするユーザを統合管理するための設定をします。ユーザ認証情報を格納するLDAPディレクトリサーバや，統合ユーザ管理のコンフィグレーションファイルを設定します。設定方法の詳細については，マニュアル「Cosminexus　システム構築ガイド」の統合ユーザ管理機能の設定に関する説明を参照してください。

システムの可用性を高める設定をします。
システムの可用性を高める機能を使用しない場合は，設定不要です。
セッションフェイルオーバ機能によるJ2EEサーバへのセッション情報の引き継ぎの設定をします。設定方法の詳細については，マニュアル「Cosminexus　システム構築ガイド」のJ2EEサーバ間のセッション情報の引き継ぎの設定に関する説明を参照してください。

リソースとJ2EEアプリケーションの設定をします。
サーバ管理コマンドを使用して，リソースアダプタやJ2EEアプリケーションのプロパティを定義し，J2EEサーバにインポートします。設定方法の詳細については，マニュアル「Cosminexus　システム構築ガイド」のリソースとJ2EEアプリケーションの設定に関する説明を参照してください。

システムを起動して，システムの動作を確認します。
システムの起動および停止については，「付録D　J2EEアプリケーションを実行するシステムの起動と停止（Windowsの場合）」，または「付録E　J2EEアプリケーションを実行するシステムの起動と停止（UNIXの場合）」を参照してください。

注意

各ファイルでデフォルトの設定を変更する場合，参照先のマニュアル「Cosminexus　システム構築ガイド」で，簡易構築定義ファイルを使用して設定しているときはファイルの読み替えが必要です。読み替え方法については，マニュアル「Cosminexus　システム構築ガイド」のJ2EEサーバの動作設定についての説明の，そのほかのユーザ定義ファイルの編集についての説明を基に，使用するファイルを読み替えてください。

(3)　トラブルシューティングに必要な資料

トラブルシューティングに必要な資料と，システム構築時の設定の要否について次の表に示します。なお，設定方法の詳細については，マニュアル「Cosminexus　システム構築ガイド」のトラブルシューティングの資料取得の設定に関する説明を参照してください。

表C-1　トラブルシューティングの資料の種類と設定要否（J2EEアプリケーションを実行するシステムの場合）

資料の種類 | 設定の要否
snapshotログ | △※1
性能解析トレースファイル | ×※2
J2EEサーバのログ | △
SFOサーバのログ | △
Webサーバのログ | △
リダイレクタのログ | △
J2EEアプリケーションのユーザログ | ○
インプロセスHTTPサーバのログ | △
稼働情報ファイル | △
リソースアダプタのログ | △
Cosminexus TPBrokerのトレースファイル | △
Cosminexus DABroker Libraryのログ | △
OSの統計情報 | ○
ユーザダンプ | ○
coreダンプ | ○
JavaVMの資料 | ○
サーバ管理コマンドのログ | △

（凡例）

○：資料を取得する場合には，設定が必要。

△：デフォルトの資料取得の設定を変更する場合だけ，設定が必要。

×：設定は不要。

注※1

snapshotlogコマンドを使用してsnapshotログを取得します。この場合，あらかじめ設定しておいたリストファイルを，コマンド実行時に引数として指定します。snapshotlogコマンド，およびデフォルトの設定で収集できるsnapshotログについては，「8.2　ログの運用で使用するコマンドの詳細」の「snapshotlog（snapshotログの収集）」を参照してください。なお，snapshotログの収集先を変更する場合には，snapshotログ収集対象定義ファイルを編集します。snapshotログ収集対象定義ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

注※2

日常的なシステム運用の作業で，cprfstartコマンドを実行してパフォーマンストレーサを起動するときに，PRFトレースの取得レベルやファイルの面数を指定できます。性能解析トレースファイルの取得については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

表C-1に示したログは，snapshotログで一括収集できます。ただし，Cosminexus TPBrokerのトレースファイルについては，収集できるものと収集できないものが混在しています。このほかにも，snapshotログのデフォルトの設定で取得できないログについては，取得のための設定をしたり，snapshotログの収集先に追加したりする必要があります。

なお，次のログはログ出力先を変更できません。

セットアップ時に作成されるinstall.log，移行コマンドなどのログファイル

次のディレクトリに出力されるJavaのスレッドダンプファイル
Windowsの場合
<作業ディレクトリ>¥ejb¥<サーバ名称>
UNIXの場合
<作業ディレクトリ>/ejb/<サーバ名称>

ログの種類やデフォルト値，チャネル名，取得できるログの詳細や取得方法については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

付録C.2　J2EEサーバのセットアップ

Cosminexusのシステムを構成するJ2EEサーバのセットアップについて説明します。

J2EEサーバは，製品のインストール時にセットアップ済みです。デフォルトの設定では，J2EEサーバ名はホスト名です。別のサーバ名に変更したい場合には，J2EEサーバをセットアップしてください。また，同じホスト内で複数のJ2EEサーバを起動する場合には，それぞれのJ2EEサーバに別のサーバ名を割り当てる必要があるため，J2EEサーバをセットアップしてください。

J2EEサーバのセットアップの手順について説明します。セットアップに関する注意事項については，「付録C.2（3）　セットアップに関する注意事項」を参照して，必要に応じて対応してください。同じホスト内で複数のJ2EEサーバを起動する場合に，サーバ名を割り当てるときの注意事項については，「付録C.2（4）　複数のJ2EEサーバを起動する場合の注意事項」を参照してください。

＜この項の構成＞

(1)　Windowsの場合

(2)　UNIXの場合

(3)　セットアップに関する注意事項

(4)　複数のJ2EEサーバを起動する場合の注意事項

(1)　Windowsの場合

Windowsの場合のJ2EEサーバのセットアップ手順を次に示します。

次のコマンドでカレントディレクトリを移動します。
"cd <Cosminexusのインストールディレクトリ>¥CC¥server¥bin"

cjsetupコマンドでJ2EEサーバをセットアップします。
"cjsetup <サーバ名>"
J2EEサーバのセットアップの例を次に示します。この例では，Cosminexusのインストールディレクトリは「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サーバを操作するコマンド」を参照してください。

サーバ名称は，作業ディレクトリ中のディレクトリ名として使用されます。作業ディレクトリ下のパス長がプラットフォームの上限に達しないようにサーバ名称を指定してください。作業ディレクトリのパス長の見積もりについては，マニュアル「Cosminexus　システム構築ガイド」のJ2EEサーバの作業ディレクトリに関する説明を参照してください。

(4)　複数のJ2EEサーバを起動する場合の注意事項

J2EEサーバはサーバ名称によって識別されます。インストール時に，インストールされたホストのホスト名がデフォルトのサーバ名称として設定されています。このため，同じホスト内で複数のJ2EEサーバを起動する場合，それぞれのJ2EEサーバにサーバ名称を割り当て，J2EEサーバをセットアップします。

J2EEサーバのサーバ名称を割り当てる上で，次に示す二つの条件を考慮する必要があります。

同じホスト内では，同じサーバ名称のJ2EEサーバを複数回セットアップしてはいけません。同じサーバ名称で再セットアップした場合，エラーになります。

同じCORBAネーミングサービスを利用する場合，複数のホスト間でも同じサーバ名称のJ2EEサーバを複数回セットアップしてはいけません。

J2EEサーバと接続するCORBAネーミングサービスのホスト名およびポート番号，CORBAネーミングサービスの使用するスマートエージェントの設定に関する注意事項を次に示します。

ホスト名およびポート番号の設定

同一ホストで複数のJ2EEサーバを同時に起動する場合，CORBAネーミングサービスとの接続に使用するホスト名およびポート番号が両方とも重ならないようにしてください。ホスト名およびポート番号は，usrconf.propertiesで設定します。

また，usrconf.propertiesのwebserver.connector.ajp13.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）を指定して，スマートエージェントの使用を有効にします。

付録C.3　システムの削除の流れ

J2EEアプリケーションを実行するシステムをファイル編集とコマンド実行で削除する場合，Cosminexusが提供するコマンドを使用して，J2EEサーバをアンセットアップし，システムを削除します。

ファイル編集とコマンド実行で，J2EEアプリケーションを実行するシステムを削除する場合の，システム削除の流れについて説明します。

システムを停止します。
システムの停止手順および停止方法については，「付録D　J2EEアプリケーションを実行するシステムの起動と停止（Windowsの場合）」，または「付録E　J2EEアプリケーションを実行するシステムの起動と停止（UNIXの場合）」を参照してください。

J2EEサーバをアンセットアップします。
詳細については，「付録C.4　J2EEサーバのアンセットアップ」を参照してください。

付録C.4　J2EEサーバのアンセットアップ

Cosminexusのシステムを構成するJ2EEサーバのアンセットアップについて説明します。J2EEサーバのアンセットアップの手順について，OSごとに説明します。

＜この項の構成＞

(1)　Windowsの場合

(2)　UNIXの場合

(1)　Windowsの場合

Windowsの場合のJ2EEサーバのアンセットアップ手順を次に示します。

次のコマンドでカレントディレクトリを移動します。
"cd <Cosminexusのインストールディレクトリ>¥CC¥server¥bin"

cjsetupコマンドで引数に-dを指定して，J2EEサーバをアンセットアップします。
"cjsetup -d <サーバ名>"
J2EEサーバのアンセットアップの例を次に示します。この例では，Cosminexusのインストールディレクトリは「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

付録D　J2EEアプリケーションを実行するシステムの起動と停止（Windowsの場合）

ここでは，Windowsの場合のJ2EEアプリケーションを実行するシステムの起動と停止の手順について説明します。

＜この節の構成＞

付録D.1　システムの起動手順

付録D.2　システムの起動方法

付録D.3　システムの停止手順

付録D.4　システムの停止方法

付録D.1　システムの起動手順

システムの起動手順について説明します。

注意

システム構成によって，アプリケーションサーバだけを起動する場合と，アプリケーションサーバのほかに，統合ネーミングスケジューラサーバ，セッションフェイルオーバサーバを起動する場合があります。

アプリケーションサーバのほかに，統合ネーミングスケジューラサーバ，セッションフェイルオーバサーバを起動する場合，次の点に注意してください。

セッションフェイルオーバサーバを使用するときは，アプリケーションサーバより先にセッションフェイルオーバサーバを起動してください。

統合ネーミングスケジューラサーバの起動順序は任意です。

次に，アプリケーションサーバ，統合ネーミングスケジューラサーバおよびセッションフェイルオーバサーバの起動手順について説明します。

なお，データベース，LDAPディレクトリサーバ，EISなどの関連製品は起動済みであることを前提に説明します。データベース，LDAPディレクトリサーバ，EISなどを使用している場合は，必要に応じてあらかじめ起動しておいてください。

＜この項の構成＞

(1)　アプリケーションサーバの起動の流れ

(2)　統合ネーミングスケジューラサーバの起動の流れ

(3)　セッションフェイルオーバサーバの起動の流れ

(1)　アプリケーションサーバの起動の流れ

アプリケーションサーバの起動の流れについて説明します。

ここでは，標準システム構成の場合と，CTMを使用する構成の場合のアプリケーションサーバの起動の流れについて説明します。

アプリケーションサーバの起動の流れを次の図に示します。

図D-1　アプリケーションサーバの起動の流れ（Windowsの場合）

図中の1.～11.について説明します。

環境変数の設定
環境変数を設定します。環境変数の設定方法については，「付録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デーモンの起動」を参照してください。

SFOサーバの起動
SFOサーバを起動しない場合，この操作は不要です。また，アプリケーションサーバ内でSFOサーバを起動しない場合もこの操作は不要です。
cjstartsvコマンドに-nosecurityオプションを指定して，SFOサーバを起動します。また，SFOサーバを起動したときにSFOサーバアプリケーションが停止している場合，サーバ管理コマンド（cjstartapp）でSFOサーバアプリケーションを開始します。
起動方法およびアプリケーションの開始については，「付録D.2(7)　SFOサーバの起動」を参照してください。

J2EEサーバの起動
cjstartsvコマンドでJ2EEサーバを起動します。起動方法については，「付録D.2(8)　J2EEサーバの起動」を参照してください。

リソースの開始
リソースを使用しない場合，この操作は不要です。また，J2EEアプリケーションに含まれるリソースアダプタを利用する場合もこの操作は不要です。
サーバ管理コマンド（cjstartrar，cjstartjb）でリソースを開始します。開始方法については，「付録D.2(9)　リソースの開始」を参照してください。

J2EEアプリケーションの開始
サーバ管理コマンド（cjstartapp）でJ2EEアプリケーションを開始します。なお，リソースアダプタを含んだJ2EEアプリケーションの場合，J2EEアプリケーションに含まれるすべてのリソースアダプタが同時に開始されます。
開始方法については，「付録D.2(10)　J2EEアプリケーションの開始」を参照してください。

Webサーバの起動
起動方法については，ご使用のWebサーバのマニュアルを参照してください。
なお，Webサーバの起動のタイミングはシステムの運用形態に依存しますが，この順序で起動することでJ2EEアプリケーションへのリクエストの受け付けを制御できます。Webサーバ起動後，WebクライアントからのJ2EEアプリケーションへのリクエストの受け付けを開始します。開始方法については，「付録D.2(11)　Webサーバの起動」を参照してください。
また，インプロセスHTTPサーバを使用する場合は，Webサーバの起動は必要ありません。

(2)　統合ネーミングスケジューラサーバの起動の流れ

統合ネーミングスケジューラサーバの起動の流れを次の図に示します。

図D-2　統合ネーミングスケジューラサーバの起動の流れ（Windowsの場合）

図中の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デーモンの起動」を参照してください。

(3)　セッションフェイルオーバサーバの起動の流れ

セッションフェイルオーバサーバの起動の流れを次の図に示します。

図D-3　セッションフェイルオーバサーバの起動の流れ（Windowsの場合）

図中の1.～3.について説明します。

環境変数の設定
環境変数を設定します。環境変数の設定方法については，「付録D.2(1)　システム起動時の環境変数の設定」を参照してください。

PRFデーモンの起動
cprfstartコマンドでPRFデーモンを起動します。起動方法については，「付録D.2(2)　PRFデーモンの起動」を参照してください。

SFOサーバの起動
cjstartsvコマンドに-nosecurityオプションを指定して，SFOサーバを起動します。また，SFOサーバを起動したときに，SFOサーバアプリケーションが停止している場合，サーバ管理コマンド（cjstartapp）でSFOサーバアプリケーションを開始します。
起動方法およびアプリケーションの開始については，「付録D.2(7)　SFOサーバの起動」を参照してください。

注意

SFOサーバで実行できるアプリケーションは，SFOサーバアプリケーションだけです。SFOサーバでSFOサーバアプリケーション以外のアプリケーションは実行しないでください。

付録D.2　システムの起動方法

ここでは，構成ソフトウェアの各プロセスの起動方法，リソースの開始方法，およびJ2EEアプリケーションの開始方法について説明します。

＜この項の構成＞

(1)　システム起動時の環境変数の設定

(2)　PRFデーモンの起動

(3)　スマートエージェントの起動

(4)　CTMドメインマネジャの起動

(5)　CORBAネーミングサービスの起動

(6)　CTMデーモンの起動

(7)　SFOサーバの起動

(8)　J2EEサーバの起動

(9)　リソースの開始

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

(11)　Webサーバの起動

(1)　システム起動時の環境変数の設定

ここでは，アプリケーションサーバ，統合ネーミングスケジューラサーバ，およびSFOサーバに設定する環境変数について説明します。

setコマンドで次に示す環境変数を設定してください。

"set PATH=<Cosminexusのインストールディレクトリ>¥jdk¥bin;%PATH%"
"set PATH=<Cosminexusのインストールディレクトリ>¥TPB¥bin;%PATH%"
"set VBROKER_ADM=<Cosminexusのインストールディレクトリ>¥TPB¥adm"
"set TPDIR=<Cosminexusのインストールディレクトリ>¥TPB"
"set CTMDIR=<Cosminexusのインストールディレクトリ>¥CTM"※
"set CTMSPOOL=<Cosminexusのインストールディレクトリ>¥CTM¥spool"※

注※

CTMを使用する場合に，アプリケーションサーバおよび統合ネーミングスケジューラサーバで設定が必要な環境変数です。

環境変数「TZ」に「JST-9」を設定して，システム環境変数に登録してください。

CORBAネーミングサービスを手動起動する場合は，環境変数「PATH」の先頭に「<Cosminexusのインストールディレクトリ>¥jdk¥bin」を指定してください。

HiRDBまたはOracleを利用する場合には，それぞれのライブラリのパスを環境変数「PATH」に設定します。あらかじめシステム環境変数に設定している場合はsetコマンドの実行は不要です。

インストール時に，「<システムドライブ>:¥Common Files¥Hitachi」が環境変数「PATH」に追加され，自動的にシステム環境変数に登録されます。

インストール時に，「<Cosminexusのインストールディレクトリ>¥PRF¥spool」が環境変数「PRFSPOOL」に設定され，自動的にシステム環境変数に登録されます。

(2)　PRFデーモンの起動

PRFデーモンの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Cosminexusのインストールディレクトリ>¥PRF¥bin"

cprfstartコマンドでPRFデーモンを起動します。

cprfstart

(3)　スマートエージェントの起動

スマートエージェントの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Cosminexusのインストールディレクトリ>¥TPB¥bin"

osagentコマンドでスマートエージェントを起動します。
コマンドの実行には，Administrator権限が必要です。

osagent

(4)　CTMドメインマネジャの起動

CTMドメインマネジャの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Cosminexusのインストールディレクトリ>¥CTM¥bin"

ctmdmstartコマンドでCTMドメインマネジャを起動します。
コマンドの実行には，Administrator権限が必要です。

ctmdmstart

なお，CTMドメインマネジャを起動する時には，パフォーマンストレーサのライブラリパス（<Cosminexusのインストールディレクトリ>¥PRF¥lib）を同時に設定しないでください。パフォーマンストレーサのライブラリパスを同時に設定すると，CTMドメインマネジャがパフォーマンストレーサのライブラリをロードした場合にエラーとなり，起動できません。

(5)　CORBAネーミングサービスの起動

CORBAネーミングサービスの起動方法について説明します。

J2EEサーバ用のCORBAネーミングサービスは，J2EEサーバ起動時にインプロセスで起動することを推奨します。アウトプロセスで起動する場合は，nameservコマンドを使用して起動します。

ここでは，nameservコマンドでCORBAネーミングサービスをアウトプロセスで起動する方法について説明します。J2EEサーバの起動時にCORBAネーミングサービスをインプロセスで起動する方法については，「付録D.2(8)　J2EEサーバの起動」を参照してください。

なお，CORBAネーミングサービス起動時は次の点に留意してください。

CTMを使用する場合，J2EEサーバ用およびCTM用のCORBAネーミングサービスを起動します。CTM用にグローバルCORBAネーミングサービスをnameservコマンドで手動起動して，さらにJ2EEサーバ用のCORBAネーミングサービスをJ2EEサーバ起動時にインプロセスで自動起動してください。

J2EEサーバ間でのセッション情報の引き継ぎを行う場合，アプリケーションサーバ内でSFOサーバを起動するときは，SFOサーバ用のCORBAネーミングサービスはインプロセスで起動することが前提のため起動は不要です。

nameservコマンドでCORBAネーミングサービスを手動起動する場合の手順を次に示します。

setコマンドで環境変数「CLASSPATH」を設定解除します。

set CLASSPATH=

cdコマンドでカレントディレクトリを移動します。

cd "<Cosminexusのインストールディレクトリ>¥TPB¥bin"

nameservコマンドでローカルCORBAネーミングサービスを手動開始します。
コマンドの実行には，Administrator権限が必要です。

nameserv -J-Dvbroker.agent.enableLocator=false
-J-Djava.security.policy=="<Cosminexusのインストールディレクトリ>¥
CC¥server¥sysconf¥cli.policy"
-J-Dvbroker.se.iiop_tp.scm.iiop_tp.listener.port=<ポート番号>

注意事項

CORBAネーミングサービスを手動起動する場合は，環境変数「PATH」の先頭に「<Cosminexusのインストールディレクトリ>¥jdk¥bin」を指定してください。

nameservコマンドで指定するオプションの値に空白を含むディレクトリが含まれる場合は，値全体をダブルクォーテーション（"）で囲むようにしてください。

nameservコマンドで指定する値は環境に合わせて変更してください。

CORBAネーミングサービスは，次のオプションで指定したポート番号で起動します。
-J-Dvbroker.se.iiop_tp.scm.iiop_tp.listener.port=<ポート番号>

(6)　CTMデーモンの起動

CTMデーモンの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Cosminexusのインストールディレクトリ>¥CTM¥bin"

ctmstartコマンドでCTMデーモンを起動します。
コマンドの実行には，Administrator権限が必要です。

ctmstart -CTMINSRef <ホスト名：ポート番号>

ホスト名およびポート番号にはグローバルCORBAネーミングサービスを起動しているホスト名およびポート番号を指定してください。

なお，CTMデーモンを起動する時には，パフォーマンストレーサのライブラリパス（<Cosminexusのインストールディレクトリ>¥PRF¥lib）を同時に設定しないでください。パフォーマンストレーサのライブラリパスを同時に設定すると，CTMデーモンがパフォーマンストレーサのライブラリをロードした場合にエラーとなり，起動できません。

参考

CTMデーモンを開始するctmstartコマンドでは，コマンド実行時に次のファイルを指定できます。

CTMユーザ環境変数定義ファイル
-CTMEnvironオプションで指定するファイルです。CTMデーモンで管理するプロセスが使用する環境変数を指定したい場合は，このファイルに環境変数を記述します。

CTMコマンドオプションファイル
-CTMRegOptionで指定するファイルです。CTMレギュレータを自動開始するときのコマンドオプションを指定したい場合は，このファイルにコマンドオプションを記述します。

必要に応じて，これらのファイルを作成しておいてください。

(7)　SFOサーバの起動

SFOサーバの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Cosminexusのインストールディレクトリ>¥CC¥server¥bin"

cjstartsvコマンドに-nosecurityオプションを指定して，SFOサーバを開始します。
コマンドの実行には，Administrator権限が必要です。

cjstartsv <サーバ名称> -nosecurity

SFOサーバアプリケーションを開始します。
SFOサーバを起動したときにSFOサーバアプリケーションが停止している場合，サーバ管理コマンドを使用して，SFOサーバアプリケーションを開始します。なお，サーバ管理コマンドの実行には，Administrator権限が必要です。
SFOサーバアプリケーションの名称は「CCC_SFO_Server_Application」です。

注意

SFOサーバで実行できるアプリケーションは，SFOサーバアプリケーションだけです。SFOサーバでSFOサーバアプリケーション以外のアプリケーションは実行しないでください。

(8)　J2EEサーバの起動

J2EEサーバの起動方法について説明します。

J2EEサーバ起動時に，次に示すプロセスをインプロセスで起動することを推奨します。

J2EEサーバ用のCORBAネーミングサービス

トランザクションサービス（トランザクションサービスを使用する場合）

なお，CTMを使用する場合，J2EEサーバ用のCORBAネーミングサービスはインプロセスで起動してください。

次に示す場合のJ2EEサーバの起動手順について(a)～(d)で説明します。

標準システム構成でCORBAネーミングサービスをインプロセスで起動する場合

CTMを使用する構成でCORBAネーミングサービスおよびトランザクションサービスをインプロセスで起動する場合

標準システム構成でインプロセスHTTPサーバを起動してCORBAネーミングサービスをインプロセスで起動する場合

標準システム構成でCORBAネーミングサービスをアウトプロセスで起動する場合

また，J2EEサーバ起動時は次の点に留意してください。

複数のJ2EEサーバで一つのネーミングサービスを共有する場合，J2EEサーバは一つずつ起動してください。複数のJ2EEサーバを同時に起動しようとするとJ2EEサーバの起動に失敗することがあります。

(a)　標準システム構成でCORBAネーミングサービスをインプロセスで起動する場合

標準システム構成でCORBAネーミングサービスをインプロセスで起動する場合の，J2EEサーバの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Cosminexusのインストールディレクトリ>¥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 "<Cosminexusのインストールディレクトリ>¥CC¥server¥bin"

cjstartsvコマンドでJ2EEサーバを開始します。
コマンドの実行には，Administrator権限が必要です。

cjstartsv <サーバ名称>

(c)　標準システム構成でインプロセスHTTPサーバを起動してCORBAネーミングサービスをインプロセスで起動する場合

標準システム構成でインプロセスHTTPサーバを起動して，CORBAネーミングサービスをインプロセスで起動する場合の，J2EEサーバの起動手順について説明します。

なお，インプロセスHTTPサーバを起動する場合，およびCORBAネーミングサービスをインプロセスで起動する場合の前提を次に示します。

インプロセスHTTPサーバを使用する場合
usrconf.propertiesファイルのwebserver.connector.inprocess_http.enabledキーに「true」が指定されている必要があります。

J2EEサーバ用のCORBAネーミングサービスをインプロセスで使用する場合
usrconf.propertiesファイルのejbserver.naming.portキーにJ2EEサーバ用のCORBAネーミングサービスのTCPポート番号が設定されている必要があります。
ejbserver.naming.port = <TCPポート番号>

cdコマンドでカレントディレクトリを移動します。

cd "<Cosminexusのインストールディレクトリ>¥CC¥server¥bin"

cjstartsvコマンドでJ2EEサーバを開始します。
コマンドの実行には，Administrator権限が必要です。

cjstartsv <サーバ名称>

(d)　標準システム構成で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 "<Cosminexusのインストールディレクトリ>¥CC¥server¥bin"

cjstartsvコマンドでJ2EEサーバを開始します。
コマンドの実行には，Administrator権限が必要です。

cjstartsv <サーバ名称>

(9)　リソースの開始

リソースの開始方法について説明します。

リソースは，サーバ管理コマンド（cjstartrarコマンド，cjstartjbコマンド）を使用して開始します。

なお，開始するリソースは，あらかじめJ2EEリソースとして，J2EEサーバにデプロイされている必要があります。J2EEサーバへのリソースのデプロイも，サーバ管理コマンドで実行します。

J2EEアプリケーションに含まれるリソースアダプタを利用する場合，この操作は不要です。

詳細については，マニュアル「Cosminexus　システム構築ガイド」のリソースの設定に関する説明，および「Cosminexus　アプリケーション設定操作ガイド」のJ2EEリソースの設定に関する説明を参照してください。

注意

Cosminexus RMを起動する場合，あらかじめDB Connector for Cosminexus RMを起動しておいてください。DB Connector for Cosminexus RMを起動しないでCosminexus RMを起動しようとするとエラーが発生します。

ルートリソースアダプタは，ルートリソースアダプタに所属するすべてのメンバリソースアダプタが開始状態の場合に開始できます。

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

J2EEアプリケーションの開始方法について説明します。

J2EEアプリケーションは，サーバ管理コマンドを使用して開始します。なお，サーバ管理コマンドの実行には，Administrator権限が必要です。

J2EEアプリケーションは用途に応じて，動作モードを選択して開始します。本番稼働で動作するJ2EEアプリケーションは通常モードで実行します。本番稼働前のJ2EEアプリケーションの動作確認などで，テスト用として動作するJ2EEアプリケーションはテストモードで実行します。

動作モードによって，J2EEアプリケーションの開始方法が異なります。それぞれの場合の開始方法を次に示します。

通常モードの場合
通常モードでJ2EEアプリケーションを開始する場合，サーバ管理コマンド（cjstartapp）を使用します。

テストモードの場合
テストモードでJ2EEアプリケーションを開始する場合，サーバ管理コマンドのcjstartappコマンドに-testオプションを指定して実行します。

開始するJ2EEアプリケーションは，J2EEサーバにインポートされている必要があります。J2EEアプリケーションとは，Enterprise Bean（EJB-JAR）およびサーブレットとJSP（WAR）を一つにまとめたEARです。サーバ管理コマンドでは，J2EEアプリケーション単位に開始，停止を実行します。

J2EEサーバへのJ2EEアプリケーションのインポートも，サーバ管理コマンドで実行します。また，開発環境で作成したWARやEJB-JARを，サーバ管理コマンドを使用してJ2EEアプリケーションにすることもできます。

詳細については，マニュアル「Cosminexus　システム構築ガイド」のJ2EEアプリケーションの開始に関する説明，および「Cosminexus　アプリケーション設定操作ガイド」のJ2EEアプリケーションのインポートに関する説明を参照してください。

(11)　Webサーバの起動

Webサーバの起動方法については，ご使用のWebサーバのマニュアルを参照してください。

なお，Webサーバの起動のタイミングはシステムの運用形態に依存しますが，この順序で起動することでJ2EEアプリケーションへのリクエストの受け付けを制御できます。Webサーバ起動後，WebクライアントからのJ2EEアプリケーションへのリクエストの受け付けを開始します。

また，インプロセスHTTPサーバを使用する場合は，Webサーバの起動は必要ありません。

付録D.3　システムの停止手順

ここでは，構成ソフトウェアの各プロセス，リソース，およびJ2EEアプリケーションの停止の手順について説明します。

＜この項の構成＞

(1)　システムの停止の流れ

(1)　システムの停止の流れ

システムの停止手順は，起動手順と逆の順序になります。データベース，LDAPディレクトリサーバ，EISなどを使用している場合は，必要に応じて最後に停止してください。

注意

システム構成によって，アプリケーションサーバだけを停止する場合と，アプリケーションサーバのほかに，統合ネーミングスケジューラサーバ，セッションフェイルオーバサーバを停止する場合があります。

アプリケーションサーバのほかに，統合ネーミングスケジューラサーバ，セッションフェイルオーバサーバを停止する場合，次の点に注意してください。

セッションフェイルオーバサーバを使用しているときは，アプリケーションサーバを停止したあとに，セッションフェイルオーバサーバを停止してください。

統合ネーミングスケジューラサーバの停止順序は任意です。

次に示す停止操作を基にシステムを停止してください。

Webサーバの停止
停止方法については，ご使用のWebサーバのマニュアルを参照してください。
なお，Webサーバの停止のタイミングについてはシステムの運用形態に依存しますが，最初に停止することでJ2EEアプリケーションへのリクエストの受け付けを制御できます。また，インプロセスHTTPサーバを使用する場合は，Webサーバを停止する必要はありません。

J2EEアプリケーションの停止
サーバ管理コマンド（cjstopapp）でJ2EEアプリケーションを停止します。停止方法については，「付録D.4(2)　J2EEアプリケーションの停止」を参照してください。
なお，次回J2EEサーバの起動と同時にJ2EEアプリケーションを開始する場合は，J2EEアプリケーションの停止は不要です。

リソースの停止
J2EEリソースを使用しない場合，この操作は不要です。
サーバ管理コマンド（cjstoprar，cjstopjb）でJ2EEリソースを停止します。停止方法については，「付録D.4(3)　リソースの停止」を参照してください。
なお，次回J2EEサーバ起動時にJ2EEリソースを開始する場合は，J2EEリソースの停止は不要です。

J2EEサーバの停止
cjstopsvコマンドでJ2EEサーバを停止します。停止方法については，「付録D.4(4)　J2EEサーバの停止」を参照してください。

SFOサーバの停止
cjstopsvコマンドでSFOサーバを停止します。SFOサーバは，J2EEサーバと同様の手順で停止します。停止方法については，「付録D.4(5)　SFOサーバの停止」を参照してください。

CTMデーモンの停止
CTMを使用しない場合，この操作は不要です。
ctmstopコマンドでCTMデーモンを停止します。停止方法については，「付録D.4(6)　CTMデーモンの停止」を参照してください。

CORBAネーミングサービスの停止
CORBAネーミングサービスの起動方法によって，停止方法が異なります。停止方法については，「付録D.4(7)　CORBAネーミングサービスの停止」を参照してください。

CTMドメインマネジャの停止
CTMを使用しない場合，この操作は不要です。
ctmdmstopコマンドでCTMドメインマネジャを停止します。停止方法については，「付録D.4(8)　CTMドメインマネジャの停止」を参照してください。

スマートエージェントの停止
スマートエージェントを起動していない場合，この操作は不要です。
停止方法については，「付録D.4(9)　スマートエージェントの停止」を参照してください。

PRFデーモンの停止
cprfstopコマンドでPRFデーモンを停止します。停止方法については，「付録D.4(10)　PRFデーモンの停止」を参照してください。

付録D.4　システムの停止方法

ここでは，構成ソフトウェアの各プロセスの停止方法，リソースの停止方法，およびJ2EEアプリケーションの停止方法について説明します。

＜この項の構成＞

(1)　Webサーバの停止

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

(3)　リソースの停止

(4)　J2EEサーバの停止

(5)　SFOサーバの停止

(6)　CTMデーモンの停止

(7)　CORBAネーミングサービスの停止

(8)　CTMドメインマネジャの停止

(9)　スマートエージェントの停止

(10)　PRFデーモンの停止

(1)　Webサーバの停止

Webサーバの停止方法については，ご使用のWebサーバのマニュアルを参照してください。

なお，Webサーバの停止のタイミングについてはシステムの運用形態に依存しますが，最初に停止することでJ2EEアプリケーションへのリクエストの受け付けを制御できます。また，インプロセスHTTPサーバを使用する場合は，Webサーバを停止する必要はありません。

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

J2EEアプリケーションの停止方法について説明します。

J2EEアプリケーションは，サーバ管理コマンドを使用して停止します。通常モードの場合，およびテストモードの場合の停止方法を次に示します。

通常モードの場合
通常モードのJ2EEアプリケーションを停止する場合，サーバ管理コマンド（cjstopapp）を使用します。

テストモードの場合
テストモードのJ2EEアプリケーションを停止する場合，CUIを使用します。cjstopappコマンドに-testオプションを指定して実行します。

なお，サーバ管理コマンドの実行には，Administrator権限が必要です。

J2EEアプリケーションを停止しても，J2EEアプリケーション内のリクエスト処理が終了しないなどの原因で停止処理が完了しない場合があります。この場合，J2EEアプリケーションを強制的に停止する必要があります。J2EEアプリケーションを強制停止する場合，cjstopappコマンドに-forceオプションを指定して実行します。J2EEアプリケーションを停止するための具体的な手順については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

(3)　リソースの停止

リソースの停止方法について説明します。

リソースの停止は，サーバ管理コマンド（cjstoprar，cjstopjb）を使用します。

なお，サーバ管理コマンドの実行には，Administrator権限が必要です。

J2EEアプリケーションに含まれるリソースアダプタを利用する場合，この操作は不要です。

注意

DB Connector for Cosminexus RMを停止する場合，あらかじめCosminexus RMを停止しておいてください。Cosminexus RMを停止しないでDB Connector for Cosminexus RMを停止しようとするとエラーが発生します。

メンバリソースアダプタは，所属するルートリソースアダプタが停止状態のときだけ停止できます。

別名を定義したJ2EEリソースは，J2EEサーバで開始されているJ2EEアプリケーションがある場合は停止できません。停止しようとするとメッセージが出力されて処理が失敗します。別名を定義したJ2EEリソースは，J2EEサーバで開始されているすべてのJ2EEアプリケーションを停止してから停止してください。

(4)　J2EEサーバの停止

J2EEサーバの停止の手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Cosminexusのインストールディレクトリ>¥CC¥server¥bin"

cjstopsvコマンドでJ2EEサーバを停止します。
コマンドの実行には，Administrator権限が必要です。

cjstopsv <サーバ名称>

cjstopsvコマンドの実行例を次に示します。この例では，Cosminexusのインストールディレクトリは「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)　SFOサーバの停止

SFOサーバは，J2EEサーバと同様の手順で停止します。

J2EEサーバの停止手順については，「付録D.4(4)　J2EEサーバの停止」を参照してください。

(6)　CTMデーモンの停止

CTMデーモンの停止手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Cosminexusのインストールディレクトリ>¥CTM¥bin"

ctmstopコマンドでCTMデーモンを停止します。
コマンドの実行には，Administrator権限が必要です。

ctmstop

なお，CTMデーモンを停止しても，CTMデーモンの停止処理が完了しない場合があります。この場合，CTMデーモンを強制的に停止する必要があります。CTMデーモンを強制停止する場合，ctmstopコマンドに-CTMForceオプションを指定して実行します。

(7)　CORBAネーミングサービスの停止

CORBAネーミングサービスの停止手順は，CORBAネーミングサービスの起動方法によって異なります。

J2EEサーバ起動時にインプロセスで起動している場合
J2EEサーバ停止時にCORBAネーミングサービスも自動停止します。

アウトプロセスで起動している場合

J2EEサーバを停止しておきます。
J2EEサーバの停止については，「付録D.4(4)　J2EEサーバの停止」を参照してください。

［Ctrl］+［C］キーで，CORBAネーミングサービスを手動停止します。

(8)　CTMドメインマネジャの停止

CTMドメインマネジャの停止手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Cosminexusのインストールディレクトリ>¥CTM¥bin"

ctmdmstopコマンドでCTMドメインマネジャを停止します。
コマンドの実行には，Administrator権限が必要です。

ctmdmstop

なお，CTMドメインマネジャを停止しても，CTMドメインマネジャの停止処理が完了しない場合があります。この場合，CTMドメインマネジャを強制的に停止する必要があります。CTMドメインマネジャを強制停止する場合，ctmdmstopコマンドに-CTMForceオプションを指定して実行します。

(9)　スマートエージェントの停止

スマートエージェントの停止手順を次に示します。

Windowsのタスクバーに表示されているスマートエージェントのアイコンを右クリックして［Exit］を選択し，スマートエージェントを停止します。

(10)　PRFデーモンの停止

PRFデーモンの停止手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Cosminexusのインストールディレクトリ>¥PRF¥bin"

cprfstopコマンドでPRFデーモンを停止します。
cprfstartコマンドを実行したユーザが実行してください

cprfstop

なお，PRFデーモンを停止しても，PRFデーモンの停止処理が完了しない場合があります。この場合，PRFデーモンを強制的に停止する必要があります。PRFデーモンを強制停止する場合，cprfstopコマンドに-Forceオプションを指定して実行します。

付録E　J2EEアプリケーションを実行するシステムの起動と停止（UNIXの場合）

ここでは，UNIXの場合のJ2EEアプリケーションを実行するシステムの起動と停止の手順について説明します。

＜この節の構成＞

付録E.1　システムの起動手順

付録E.2　システムの起動方法

付録E.3　システムの停止手順

付録E.4　システムの停止方法

付録E.1　システムの起動手順

システムの起動手順について説明します。

注意

システムでは，システム構成によって，アプリケーションサーバだけを起動する場合と，アプリケーションサーバのほかに，統合ネーミングスケジューラサーバ，セッションフェイルオーバサーバを起動する場合があります。

アプリケーションサーバのほかに，統合ネーミングスケジューラサーバ，セッションフェイルオーバサーバを起動する場合，次の点に注意してください。

セッションフェイルオーバサーバを使用するときは，アプリケーションサーバより先にセッションフェイルオーバサーバを起動してください。

統合ネーミングスケジューラサーバの起動順序は任意です。

以降の項では，アプリケーションサーバ，統合ネーミングスケジューラサーバおよびセッションフェイルオーバサーバの起動手順について説明します。

なお，データベース，LDAPディレクトリサーバ，EISなどの関連製品は起動済みであることを前提に説明します。データベース，LDAPディレクトリサーバ，EISなどを使用している場合は，必要に応じてあらかじめ起動しておいてください。

＜この項の構成＞

(1)　アプリケーションサーバの起動の流れ

(2)　統合ネーミングスケジューラサーバの起動の流れ

(3)　セッションフェイルオーバサーバの起動の流れ

(1)　アプリケーションサーバの起動の流れ

システムで使用するアプリケーションサーバの起動の流れについて説明します。

ここでは，標準システム構成の場合と，CTMを使用する構成の場合のアプリケーションサーバの起動の流れについて説明します。

アプリケーションサーバの起動の流れを次の図に示します。

図E-1　アプリケーションサーバの起動の流れ（UNIXの場合）

図中の1.～11.について説明します。

環境変数の設定
環境変数を設定します。環境変数の設定方法については，「付録E.2(1)　システム起動時の環境変数の設定」を参照してください。

PRFデーモンの起動
cprfstartコマンドでPRFデーモンを起動します。起動方法については，「付録E.2(2)　PRFデーモンの起動」を参照してください。

スマートエージェントの起動
CTMを使用しない場合，この操作は不要です。
osagentコマンドでスマートエージェントを起動します。起動方法については，「付録E.2(3)　スマートエージェントの起動」を参照してください。

CTMドメインマネジャの起動
CTMを使用しない場合，この操作は不要です。
ctmdmstartコマンドでCTMドメインマネジャを起動します。起動方法については，「付録E.2(4)　CTMドメインマネジャの起動」を参照してください。

CORBAネーミングサービスの起動
J2EEサーバ用のCORBAネーミングサービスは，J2EEサーバ起動時にインプロセスで起動することを推奨します。
アウトプロセスでの起動方法については，「付録E.2(5)　CORBAネーミングサービスの起動」を参照してください。

CTMデーモンの起動
CTMを使用しない場合，この操作は不要です。
ctmstartコマンドでCTMデーモンを起動します。起動方法については，「付録E.2(6)　CTMデーモンの起動」を参照してください。

SFOサーバの起動
SFOサーバを起動しない場合，この操作は不要です。また，アプリケーションサーバ内でSFOサーバを起動しない場合もこの操作は不要です。
cjstartsvコマンドに-nosecurityオプションを指定して，SFOサーバを起動します。また，SFOサーバを起動したときにSFOサーバアプリケーションが停止している場合，サーバ管理コマンド（cjstartapp）でSFOサーバアプリケーションを開始します。
起動方法およびアプリケーションの開始については，「付録E.2(7)　SFOサーバの起動」を参照してください。

J2EEサーバの起動
cjstartsvコマンドでJ2EEサーバを起動します。起動方法については，「付録E.2(8)　J2EEサーバの起動」を参照してください。

リソースの開始
リソースを使用しない場合，この操作は不要です。
また，J2EEアプリケーションに含まれるリソースアダプタを利用する場合もこの操作は不要です。
サーバ管理コマンドでリソースを開始します。開始方法については，「付録E.2(9)　リソースの開始」を参照してください。

J2EEアプリケーションの開始
サーバ管理コマンドでJ2EEアプリケーションを開始します。なお，リソースアダプタを含んだJ2EEアプリケーションの場合，J2EEアプリケーションに含まれるすべてのリソースアダプタが同時に開始されます。開始方法については，「付録E.2(10)　J2EEアプリケーションの開始」を参照してください。

Webサーバの起動
起動方法については，ご使用のWebサーバのマニュアルを参照してください。
なお，Webサーバの起動のタイミングはシステムの運用形態に依存しますが，この順序で起動することでJ2EEアプリケーションへのリクエストの受け付けを制御できます。Webサーバ起動後，WebクライアントからのJ2EEアプリケーションへのリクエストの受け付けを開始します。開始方法については，「付録E.2(11)　Webサーバの起動」を参照してください。
また，インプロセスHTTPサーバを使用する場合は，Webサーバの起動は必要ありません。

(2)　統合ネーミングスケジューラサーバの起動の流れ

統合ネーミングスケジューラサーバの起動の流れを次の図に示します。

図E-2　統合ネーミングスケジューラサーバの起動の流れ（UNIXの場合）

図中の1.～6.について説明します。

環境変数の設定
環境変数を設定します。環境変数の設定方法については，「付録E.2(1)　システム起動時の環境変数の設定」を参照してください。

PRFデーモンの起動
cprfstartコマンドでPRFデーモンを起動します。起動方法については，「付録E.2(2)　PRFデーモンの起動」を参照してください。

スマートエージェントの起動
osagentコマンドでスマートエージェントを起動します。起動方法については，「付録E.2(3)　スマートエージェントの起動」を参照してください。

CTMドメインマネジャの起動
ctmdmstartコマンドでCTMドメインマネジャを起動します。起動方法については，「付録E.2(4)　CTMドメインマネジャの起動」を参照してください。

CORBAネーミングサービスの起動
CTM用のグローバルCORBAネーミングサービスを起動します。起動方法については，「付録E.2(5)　CORBAネーミングサービスの起動」を参照してください。

CTMデーモンの起動
ctmstartコマンドでCTMデーモンを起動します。起動方法については，「付録E.2(6)　CTMデーモンの起動」を参照してください。

(3)　セッションフェイルオーバサーバの起動の流れ

セッションフェイルオーバサーバの起動の流れを次の図に示します。

図E-3　セッションフェイルオーバサーバの起動の流れ（UNIXの場合）

図中の1.～3.について説明します。

環境変数の設定
環境変数を設定します。環境変数の設定方法については，「付録E.2(1)　システム起動時の環境変数の設定」を参照してください。

PRFデーモンの起動
cprfstartコマンドでPRFデーモンを起動します。起動方法については，「付録E.2(2)　PRFデーモンの起動」を参照してください。

SFOサーバの起動
cjstartsvコマンドに-nosecurityオプションを指定して，SFOサーバを起動します。また，SFOサーバを起動したときに，SFOサーバアプリケーションが停止している場合，サーバ管理コマンド（cjstartapp）でSFOサーバアプリケーションを開始します。
起動方法およびアプリケーションの開始については，「付録E.2(7)　SFOサーバの起動」を参照してください。

注意

SFOサーバで実行できるアプリケーションは，SFOサーバアプリケーションだけです。SFOサーバでSFOサーバアプリケーション以外のアプリケーションは実行しないでください。

付録E.2　システムの起動方法

ここでは，構成ソフトウェアの各プロセスの起動方法，リソースの開始方法，およびJ2EEアプリケーションの開始方法について説明します。

＜この項の構成＞

(1)　システム起動時の環境変数の設定

(2)　PRFデーモンの起動

(3)　スマートエージェントの起動

(4)　CTMドメインマネジャの起動

(5)　CORBAネーミングサービスの起動

(6)　CTMデーモンの起動

(7)　SFOサーバの起動

(8)　J2EEサーバの起動

(9)　リソースの開始

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

(11)　Webサーバの起動

(1)　システム起動時の環境変数の設定

ここでは，アプリケーションサーバ，統合ネーミングスケジューラサーバ，およびSFOサーバに設定する環境変数について説明します。

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」，HP-UX（IPF），LinuxおよびSolarisの場合は「LD_LIBRARY_PATH」となります。

CORBAネーミングサービスを手動起動する場合は，環境変数「PATH」の先頭に「/opt/Cosminexus/jdk/bin」を指定してください。

HiRDBまたはOracleを利用する場合には，それぞれのライブラリのパスを環境変数「LIBPATH」（AIXの場合），または「LD_LIBRARY_PATH」（HP-UX，LinuxおよびSolarisの場合）に設定します。あらかじめ環境変数に設定している場合は，setenvコマンドの実行は不要です。

(2)　PRFデーモンの起動

PRFデーモンの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/PRF/bin

cprfstartコマンドでPRFデーモンを起動します。
Solarisの場合，コマンドの実行には，root権限が必要です。

# cprfstart

(3)　スマートエージェントの起動

スマートエージェントの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/TPB/bin

osagentコマンドでスマートエージェントを起動します。

# osagent &

(4)　CTMドメインマネジャの起動

CTMドメインマネジャの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/CTM/bin

ctmdmstartコマンドでCTMドメインマネジャを起動します。
Solarisの場合，コマンドの実行には，root権限が必要です。

# ctmdmstart

(5)　CORBAネーミングサービスの起動

CORBAネーミングサービスの起動方法について説明します。

J2EEサーバ用のCORBAネーミングサービスは，J2EEサーバ起動時にインプロセスで起動することを推奨します。アウトプロセスで起動する場合は，nameservコマンドを使用して起動します。

ここでは，nameservコマンドでCORBAネーミングサービスをアウトプロセスで起動する方法について説明します。J2EEサーバの起動時にCORBAネーミングサービスをインプロセスで起動する方法については，「付録E.2(8)　J2EEサーバの起動」を参照してください。

なお，CORBAネーミングサービス起動時は次の点に留意してください。

CTMを使用する場合，J2EEサーバ用およびCTM用のCORBAネーミングサービスを起動します。CTM用にグローバルCORBAネーミングサービスをnameservコマンドで手動起動して，さらにJ2EEサーバ用のCORBAネーミングサービスをJ2EEサーバ起動時にインプロセスで自動起動してください。

J2EEサーバ間でのセッション情報の引き継ぎを行う場合，アプリケーションサーバ内でSFOサーバを起動するときは，SFOサーバ用のCORBAネーミングサービスはインプロセスで起動することが前提のため起動は不要です。

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デーモンを起動します。
Solarisの場合，コマンドの実行には，root権限が必要です。

# ctmstart -CTMINSRef <ホスト名：ポート番号>

ホスト名およびポート番号にはグローバルCORBAネーミングサービスを起動しているホスト名およびポート番号を指定してください。

参考

CTMデーモンを開始するctmstartコマンドでは，コマンド実行時に次のファイルを指定できます。

CTMユーザ環境変数定義ファイル
-CTMEnvironオプションで指定するファイルです。CTMデーモンで管理するプロセスが使用する環境変数を指定したい場合は，このファイルに環境変数を記述します。

CTMコマンドオプションファイル
-CTMRegOptionで指定するファイルです。CTMレギュレータを自動開始するときのコマンドオプションを指定したい場合は，このファイルにコマンドオプションを記述します。

必要に応じて，これらのファイルを作成しておいてください。

(7)　SFOサーバの起動

SFOサーバの起動手順を次に示します。

注意

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

root権限を持たないユーザをComponent Container管理者に設定している場合，SFOサーバ用のCORBAネーミングサービスのポート番号に1024以上の値を指定しておく必要があります。1024以上の値が指定されていない場合，エラーとなり，SFOサーバは起動できません。

SFOサーバ起動時にKDJE47500-Eというエラーメッセージが出力された場合，利用しようとしたCORBAネーミングサービスがすでに起動されているため，SFOサーバの起動処理に失敗します。すでに起動しているCORBAネーミングサービスを停止して，SFOサーバを起動してください。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/CC/server/bin

cjstartsvコマンドに-nosecurityオプションを指定して，SFOサーバを開始します。
コマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

# cjstartsv -nosecurity <サーバ名称>

SFOサーバアプリケーションを開始します。
SFOサーバを起動したときにSFOサーバアプリケーションが停止している場合，サーバ管理コマンドを使用して，SFOサーバアプリケーションを開始します。なお，サーバ管理コマンドの実行には，root権限，またはComponent Container管理者の権限が必要です。
SFOサーバアプリケーションの名称は「CCC_SFO_Server_Application」です。

注意

SFOサーバで実行できるアプリケーションは，SFOサーバアプリケーションだけです。SFOサーバでSFOサーバアプリケーション以外のアプリケーションは実行しないでください。

(8)　J2EEサーバの起動

J2EEサーバの起動方法について説明します。

J2EEサーバ起動時に，次に示すプロセスをインプロセスで起動することを推奨します。

J2EEサーバ用のCORBAネーミングサービス

トランザクションサービス（トランザクションサービスを使用する場合）

なお，CTMを使用する場合，J2EEサーバ用のCORBAネーミングサービスはインプロセスで起動してください。

次に示す場合のJ2EEサーバの起動手順について(a)～(d)で説明します。

標準システム構成でCORBAネーミングサービスをインプロセスで起動する場合

CTMを使用する構成でCORBAネーミングサービスおよびトランザクションサービスをインプロセスで起動する場合

標準システム構成でインプロセスHTTPサーバを起動して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)　標準システム構成でインプロセスHTTPサーバを起動してCORBAネーミングサービスをインプロセスで起動する場合

標準システム構成でインプロセスHTTPサーバを起動して，CORBAネーミングサービスをインプロセスで起動する場合の，J2EEサーバの起動手順について説明します。

なお，インプロセスHTTPサーバを起動する場合，およびCORBAネーミングサービスをインプロセスで起動する場合の前提を次に示します。

インプロセスHTTPサーバを使用する場合
usrconf.propertiesファイルのwebserver.connector.inprocess_http.enabledキーに「true」が指定されている必要があります。

J2EEサーバ用のCORBAネーミングサービスをインプロセスで使用する場合
usrconf.propertiesファイルのejbserver.naming.portキーにJ2EEサーバ用のCORBAネーミングサービスのTCPポート番号が設定されている必要があります。
ejbserver.naming.port = <TCPポート番号>

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/CC/server/bin

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

# cjstartsv <サーバ名称>

(d)　標準システム構成でCORBAネーミングサービスをアウトプロセスで起動する場合

標準システム構成で，J2EEサーバ用のCORBAネーミングサービスをアウトプロセスで起動する場合の，J2EEサーバの起動手順について説明します。

なお，J2EEサーバ用のCORBAネーミングサービスをアウトプロセスで起動する場合の前提を次に示します。

J2EEサーバ起動前に，J2EEサーバ用のCORBAネーミングサービスを起動しておく必要があります。CORBAネーミングサービスの手動起動の方法については，「付録E.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 <サーバ名称>

(9)　リソースの開始

リソースの開始方法について説明します。

リソースは，サーバ管理コマンド（cjstartrarコマンド，cjstartjbコマンド）を使用して開始します。

なお，開始するリソースは，あらかじめJ2EEリソースとして，J2EEサーバにデプロイされている必要があります。J2EEサーバへのリソースのデプロイも，サーバ管理コマンドで実行します。

J2EEアプリケーションに含まれるリソースアダプタを利用する場合，この操作は不要です。

詳細については，マニュアル「Cosminexus　システム構築ガイド」のリソースの設定に関する説明，および「Cosminexus　アプリケーション設定操作ガイド」のJ2EEリソースの設定に関する説明を参照してください。

注意

Cosminexus RMを起動する場合，あらかじめDB Connector for Cosminexus RMを起動しておいてください。DB Connector for Cosminexus RMを起動しないでCosminexus RMを起動しようとするとエラーが発生します。

ルートリソースアダプタは，ルートリソースアダプタに所属するすべてのメンバリソースアダプタが開始状態の場合に開始できます。

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

J2EEアプリケーションの開始方法について説明します。

J2EEアプリケーションは，サーバ管理コマンドを使用して開始します。なお，サーバ管理コマンドの実行には，root権限，またはComponent Container管理者の権限が必要です。

J2EEアプリケーションは用途に応じて，動作モードを選択して開始します。本番稼働で動作するJ2EEアプリケーションは通常モードで実行します。本番稼働前のJ2EEアプリケーションの動作確認などで，テスト用として動作するJ2EEアプリケーションはテストモードで実行します。

動作モードによって，J2EEアプリケーションの開始方法が異なります。それぞれの場合の開始方法を次に示します。

通常モードの場合
通常モードでJ2EEアプリケーションを開始する場合，サーバ管理コマンドのcjstartappコマンドを使用します。

テストモードの場合
テストモードでJ2EEアプリケーションを開始する場合，サーバ管理コマンドのcjstartappコマンドに-testオプションを指定して実行します。

開始するJ2EEアプリケーションは，あらかじめJ2EEアプリケーションとして，J2EEサーバにインポートされている必要があります。J2EEアプリケーションとは，アプリケーション開発環境で作成したJ2EEアプリケーションの構成要素であるEnterprise Bean（EJB-JAR）およびサーブレットとJSP（WAR）を一つにまとめたEARです。サーバ管理コマンドでは，J2EEアプリケーション単位に開始，停止を実行します。

J2EEサーバへのJ2EEアプリケーションのインポートも，サーバ管理コマンドで実行します。また，開発環境で作成したWARやEJB-JARを，サーバ管理コマンドを使用してJ2EEアプリケーションにすることもできます。

詳細については，マニュアル「Cosminexus　システム構築ガイド」のJ2EEアプリケーションの設定に関する説明，および「Cosminexus　アプリケーション設定操作ガイド」のJ2EEアプリケーションのインポートに関する説明を参照してください。

(11)　Webサーバの起動

Webサーバの起動方法については，ご使用のWebサーバのマニュアルを参照してください。

なお，Webサーバの起動のタイミングはシステムの運用形態に依存しますが，この順序で起動することでJ2EEアプリケーションへのリクエストの受け付けを制御できます。Webサーバ起動後，WebクライアントからのJ2EEアプリケーションへのリクエストの受け付けを開始します。

また，インプロセスHTTPサーバを使用する場合は，Webサーバの起動は必要ありません。

付録E.3　システムの停止手順

ここでは，構成ソフトウェアの各プロセス，リソース，およびJ2EEアプリケーションの停止の手順について説明します。

＜この項の構成＞

(1)　システムの停止の流れ

(1)　システムの停止の流れ

システムの停止手順は，起動手順と逆の順序になります。データベース，LDAPディレクトリサーバ，EISなどを使用している場合は，必要に応じて最後に停止してください。

注意

システム構成によって，アプリケーションサーバだけを停止する場合と，アプリケーションサーバのほかに，統合ネーミングスケジューラサーバ，セッションフェイルオーバサーバを停止する場合があります。

アプリケーションサーバのほかに，統合ネーミングスケジューラサーバ，セッションフェイルオーバサーバを停止する場合，次の点に注意してください。

セッションフェイルオーバサーバを使用しているときは，アプリケーションサーバを停止したあとに，セッションフェイルオーバサーバを停止してください。

統合ネーミングスケジューラサーバの停止順序は任意です。

次に示す停止操作を基にシステムを停止してください。

Webサーバの停止
停止方法については，ご使用のWebサーバのマニュアルを参照してください。
なお，Webサーバの停止のタイミングについてはシステムの運用形態に依存しますが，最初に停止することでJ2EEアプリケーションへのリクエストの受け付けを制御できます。また，インプロセスHTTPサーバを使用する場合は，Webサーバを停止する必要はありません。

J2EEアプリケーションの停止
サーバ管理コマンド（cjstopapp）でJ2EEアプリケーションを停止します。停止方法については，「付録E.4(2)　J2EEアプリケーションの停止」を参照してください。
なお，次回J2EEサーバの起動と同時にJ2EEアプリケーションを開始する場合は，J2EEアプリケーションの停止は不要です。

リソースの停止
J2EEリソースを使用しない場合，この操作は不要です。
サーバ管理コマンド（cjstoprar）でJ2EEリソースを停止します。停止方法については，「付録E.4(3)　リソースの停止」を参照してください。
なお，次回J2EEサーバ起動時にJ2EEリソースを開始する場合は，J2EEリソースの停止は不要です。

J2EEサーバの停止
cjstopsvコマンドでJ2EEサーバを停止します。停止方法については，「付録E.4(4)　J2EEサーバの停止」を参照してください。

SFOサーバの停止
cjstopsvコマンドでSFOサーバを停止します。SFOサーバは，J2EEサーバと同様の手順で停止します。停止方法については，「付録E.4(4)　J2EEサーバの停止」を参照してください。

CTMデーモンの停止
CTMを使用しない場合，この操作は不要です。
ctmstopコマンドでCTMデーモンを停止します。停止方法については，「付録E.4(6)　CTMデーモンの停止」を参照してください。

CORBAネーミングサービスの停止
CORBAネーミングサービスの起動方法によって，停止方法が異なります。停止方法については，「付録E.4(7)　CORBAネーミングサービスの停止」を参照してください。

CTMドメインマネジャの停止
CTMを使用しない場合，この操作は不要です。
ctmdmstopコマンドでCTMドメインマネジャを停止します。停止方法については，「付録E.4(8)　CTMドメインマネジャの停止」を参照してください。

スマートエージェントの停止
スマートエージェントを起動していない場合，この操作は不要です。
停止方法については，「付録E.4(9)　スマートエージェントの停止」を参照してください。

PRFデーモンの停止
cprfstopコマンドでPRFデーモンを停止します。停止方法については，「付録E.4(10)　PRFデーモンの停止」を参照してください。

付録E.4　システムの停止方法

ここでは，構成ソフトウェアの各プロセスの停止方法，リソースの停止方法，およびJ2EEアプリケーションの停止方法について説明します。

＜この項の構成＞

(1)　Webサーバの停止

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

(3)　リソースの停止

(4)　J2EEサーバの停止

(5)　SFOサーバの停止

(6)　CTMデーモンの停止

(7)　CORBAネーミングサービスの停止

(8)　CTMドメインマネジャの停止

(9)　スマートエージェントの停止

(10)　PRFデーモンの停止

(1)　Webサーバの停止

Webサーバの停止方法については，ご使用のWebサーバのマニュアルを参照してください。

なお，Webサーバの停止のタイミングについてはシステムの運用形態に依存しますが，最初に停止することでJ2EEアプリケーションへのリクエストの受け付けを制御できます。また，インプロセスHTTPサーバを使用する場合は，Webサーバを停止する必要はありません。

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

J2EEアプリケーションの停止方法について説明します。

J2EEアプリケーションは，サーバ管理コマンドを使用して停止します。通常モードの場合，およびテストモードの場合の停止方法を次に示します。

通常モードの場合
通常モードのJ2EEアプリケーションを停止する場合，サーバ管理コマンド（cjstopapp）を使用します。

テストモードの場合
テストモードのJ2EEアプリケーションを停止する場合，サーバ管理コマンド（cjstopapp）に-testオプションを指定して実行します。

なお，サーバ管理コマンドの実行には，root権限，またはComponent Container管理者の権限が必要です。

J2EEアプリケーションを停止しても，J2EEアプリケーション内のリクエスト処理が終了しないなどの原因で停止処理が完了しない場合があります。この場合，J2EEアプリケーションを強制的に停止する必要があります。J2EEアプリケーションを強制停止する場合，cjstopappコマンドに-forceオプションを指定して実行します。J2EEアプリケーションを停止するための具体的な手順については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

(3)　リソースの停止

リソースの停止方法について説明します。

リソースの停止は，サーバ管理コマンド（cjstoprar，cjstopjb）を使用します。

なお，サーバ管理コマンドの実行には，root権限，またはComponent Container管理者の権限が必要です。

J2EEアプリケーションに含まれるリソースアダプタを利用する場合，この操作は不要です。

注意

DB Connector for Cosminexus RMを停止する場合，あらかじめCosminexus RMを停止しておいてください。Cosminexus RMを停止しないでDB Connector for Cosminexus RMを停止しようとするとエラーが発生します。

メンバリソースアダプタは，所属するルートリソースアダプタが停止状態のときだけ停止できます。

別名を定義した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)　SFOサーバの停止

SFOサーバは，J2EEサーバと同様の手順で停止します。

J2EEサーバの停止手順については，「付録E.4(4)　J2EEサーバの停止」を参照してください。

(6)　CTMデーモンの停止

CTMデーモンの停止手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/CTM/bin

ctmstopコマンドでCTMデーモンを停止します。
Solarisの場合，コマンドの実行には，root権限が必要です。

# ctmstop

なお，CTMデーモンを停止しても，CTMデーモンの停止処理が完了しない場合があります。この場合，CTMデーモンを強制的に停止する必要があります。CTMデーモンを強制停止する場合，ctmstopコマンドに-CTMForceオプションを指定して実行します。

(7)　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」，HP-UX（IPF），LinuxおよびSolarisの場合は「LD_LIBRARY_PATH」となります。

取得したプロセスIDを指定して，CORBAネーミングサービスを停止します。

# kill `cat namesv_pid`

(8)　CTMドメインマネジャの停止

CTMドメインマネジャの停止手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/CTM/bin

ctmdmstopコマンドでCTMドメインマネジャを停止します。
Solarisの場合，コマンドの実行には，root権限が必要です。

# ctmdmstop

なお，CTMドメインマネジャを停止しても，CTMドメインマネジャの停止処理が完了しない場合があります。この場合，CTMドメインマネジャを強制的に停止する必要があります。CTMドメインマネジャを強制停止する場合，ctmdmstopコマンドに-CTMForceオプションを指定して実行します。

(9)　スマートエージェントの停止

スマートエージェントの停止手順を次に示します。

スマートエージェントの停止方法は，起動方法によって異なります。

フォアグラウンドで手動起動している場合

［Ctrl］+［C］キーで停止します。

バックグラウンドで手動起動している場合

次の手順でスマートエージェントを停止します。

スマートエージェントのプロセスIDを取得します。

# ps -ef | grep osagent

取得したプロセスIDを指定して，スマートエージェントを停止します。

# kill <スマートエージェントのプロセスID>

(10)　PRFデーモンの停止

PRFデーモンの停止手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/PRF/bin

cprfstopコマンドでPRFデーモンを停止します。
Solarisの場合，コマンドの実行には，root権限が必要です。

# cprfstop

なお，PRFデーモンを停止しても，PRFデーモンの停止処理が完了しない場合があります。この場合，PRFデーモンを強制的に停止する必要があります。PRFデーモンを強制停止する場合，cprfstopコマンドに-Forceオプションを指定して実行します。

付録F　バッチアプリケーションを実行するシステムの構築と削除

ここでは，バッチアプリケーションを実行するシステムを，ファイル編集とコマンド実行で構築，および削除する手順について説明します。

＜この節の構成＞

付録F.1　システム構築の流れ

付録F.2　バッチサーバのセットアップ

付録F.3　システムの削除の流れ

付録F.4　バッチサーバのアンセットアップ

付録F.1　システム構築の流れ

バッチアプリケーションを実行するシステムをファイル編集とコマンド実行で構築する場合，Cosminexusが提供するコマンド，ユーザ定義ファイルなどを使用してシステムの動作環境を設定します。

＜この項の構成＞

(1)　システムの構築で使用するファイル

(2)　バッチアプリケーションを実行するシステムを構築する流れ

(3)　トラブルシューティングに必要な資料

(1)　システムの構築で使用するファイル

バッチアプリケーションを実行するシステムを構築する場合に使用する主なファイルを次に示します。各ファイルの詳細については，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

注意

ファイルを変更する場合は，バッチサーバを停止してください。バッチサーバの稼働中にファイルの内容を変更した場合の動作は保証されません。

usrconf.properties（バッチサーバ用ユーザプロパティファイル）
バッチサーバのユーザプロパティを指定するファイルです。バッチサーバが使用するネーミングサービス，コネクション，コンテナ，ログ，セキュリティなどを指定します。
ファイルの格納場所を次に示します。

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

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

usrconf.cfg（バッチサーバ用オプション定義ファイル）
バッチサーバのJavaVMの起動オプションを指定するファイルです。
ファイルの格納場所を次に示します。

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

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

server.policy（バッチサーバ用セキュリティポリシーファイル）
バッチサーバを実行するJavaVMのセキュリティポリシーを指定するファイルです。
ファイルの格納場所を次に示します。

Windowsの場合
<Cosminexusのインストールディレクトリ>¥CC¥server¥usrconf¥ejb¥<サーバ名称>¥server.policy

UNIXの場合
/opt/Cosminexus/CC/server/usrconf/ejb/<サーバ名称>/server.policy

(2)　バッチアプリケーションを実行するシステムを構築する流れ

ファイル編集とコマンド実行で，バッチアプリケーションを実行するシステムを構築する場合の，システム構築の流れについて説明します。

バッチサーバをセットアップします。
詳細については，「付録F.2　バッチサーバのセットアップ」を参照してください。

バッチサーバの動作設定をします。
使用する機能の動作を変更したり，特定の機能を使用したりする場合には，Cosminexusが提供するユーザ定義ファイルやコマンドを使用して，バッチサーバの動作を設定，変更します。ただし，トランザクションは必ずローカルトランザクションに設定してください。
バッチサーバの動作を設定，変更できる機能の例を次に示します。

ネーミングサービス

JavaVMの起動オプション

コンテナ拡張ライブラリ

Cosminexusが提供する主な機能の設定内容については，マニュアル「Cosminexus　システム構築ガイド」のバッチサーバの動作設定に関する説明を参照してください。

トラブルシューティングの資料取得の設定をします。
デフォルトの設定のままで利用する場合は，設定不要です。ただし，次の資料は，事前に取得のための設定をしておかないと，取得できません。これらの資料はトラブルシューティングで必要となるため，取得することをお勧めします。

OSの統計情報，ユーザダンプ（Windowsの場合）またはcoreダンプ（UNIXの場合）

JavaVMのガーベージコレクションのログ

これらの資料を取得する場合や，ほかの資料の取得設定を変更したい場合に，トラブルシューティングの資料取得の設定をしてください。トラブルシューティングに必要な資料の詳細と，システム構築時の設定の要否については「付録F.1（3）　トラブルシューティングに必要な資料」を参照してください。

リソースの設定をします。
サーバ管理コマンドを使用して，リソースアダプタのプロパティを定義し，バッチサーバにインポートします。設定方法の詳細については，マニュアル「Cosminexus　システム構築ガイド」のリソースの設定に関する説明を参照してください。

システムを起動して，システムの動作を確認します。
システムの起動および停止については，「付録G　バッチアプリケーションを実行するシステムの起動と停止（Windowsの場合）」，または「付録H　バッチアプリケーションを実行するシステムの起動と停止（UNIXの場合）」を参照してください。

注意

各ファイルでデフォルトの設定を変更する場合，参照先のマニュアル「Cosminexus　システム構築ガイド」で，簡易構築定義ファイルを使用して設定しているときはファイルの読み替えが必要です。マニュアル「Cosminexus　システム構築ガイド」のバッチサーバの動作設定についての説明の，そのほかのユーザ定義ファイルの編集についての説明を基に，使用するファイルを読み替えてください。

(3)　トラブルシューティングに必要な資料

トラブルシューティングに必要な資料と，システム構築時の設定の要否について次の表に示します。なお，設定方法の詳細については，マニュアル「Cosminexus　システム構築ガイド」のトラブルシューティングの資料取得の設定に関する説明を参照してください。

表F-1　トラブルシューティングの資料の種類と設定要否（バッチアプリケーションを実行するシステムの場合）

資料の種類 | 設定の要否
snapshotログ | △※1
性能解析トレースファイル | ×※2
バッチサーバのログ | △
アプリケーションのユーザログ | ○
稼働情報ファイル | △
リソースアダプタのログ | △
Cosminexus TPBrokerのトレースファイル | △
Cosminexus DABroker Libraryのログ | △
OSの統計情報 | ○
ユーザダンプ | ○
coreダンプ | ○
JavaVMの資料 | ○
サーバ管理コマンドのログ | △

（凡例）

○：資料を取得する場合には，設定が必要。

△：デフォルトの資料取得の設定を変更する場合だけ，設定が必要。

×：設定は不要。

注※1

snapshotlogコマンドを使用してsnapshotログを取得します。この場合，あらかじめ設定しておいたリストファイルを，コマンド実行時に引数として指定します。snapshotlogコマンド，およびデフォルトの設定で収集できるsnapshotログについては，「8.2　ログの運用で使用するコマンドの詳細」の「snapshotlog（snapshotログの収集）」を参照してください。なお，snapshotログの収集先を変更する場合には，snapshotログ収集対象定義ファイルを編集します。snapshotログ収集対象定義ファイルについては，マニュアル「Cosminexus　リファレンス　定義編」を参照してください。

注※2

日常的なシステム運用の作業で，cprfstartコマンドを実行してパフォーマンストレーサを起動する場合，PRFトレースの取得レベルやファイルの面数を指定できます。性能解析トレースファイルの取得については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

表に示したログは，snapshotログで一括収集できます。ただし，Cosminexus TPBrokerのトレースファイルについては，収集できるものと収集できないものが混在しています。このほかにも，snapshotログのデフォルトの設定で取得できないログについては，取得のための設定をしたり，snapshotログの収集先に追加したりする必要があります。

なお，次のログはログ出力先を変更できません。

セットアップ時に作成されるinstall.log，移行コマンドなどのログファイル

次のディレクトリに出力されるJavaのスレッドダンプファイル
Windowsの場合
<作業ディレクトリ>¥ejb¥<サーバ名称>
UNIXの場合
<作業ディレクトリ>/ejb/<サーバ名称>

ログの種類やデフォルト値，チャネル名，取得できるログの詳細や取得方法については，マニュアル「Cosminexus　システム運用ガイド」を参照してください。

付録F.2　バッチサーバのセットアップ

Cosminexusのシステムを構成するバッチサーバのセットアップについて説明します。

デフォルトの設定では，バッチサーバ名はホスト名です。また，同じホスト内で複数のバッチサーバを起動する場合には，それぞれのバッチサーバに別のサーバ名を割り当ててください。サーバ名を割り当てるときの注意事項については，「付録F.2（4）　複数のバッチサーバを起動する場合の注意事項」を参照してください。

バッチサーバのセットアップの手順について説明します。セットアップに関する注意事項については，「付録F.2（3）　セットアップに関する注意事項」を参照して，必要に応じて対応してください。

＜この項の構成＞

(1)　Windowsの場合

(2)　UNIXの場合

(3)　セットアップに関する注意事項

(4)　複数のバッチサーバを起動する場合の注意事項

(1)　Windowsの場合

Windowsの場合のバッチサーバのセットアップ手順を次に示します。

次のコマンドでカレントディレクトリを移動します。
"cd <Cosminexusのインストールディレクトリ>¥CC¥server¥bin"

cjsetupコマンドでバッチサーバをセットアップします。
"cjsetup -batch <サーバ名>"
バッチサーバのセットアップの例を次に示します。この例では，Cosminexusのインストールディレクトリは「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　バッチサーバを操作するコマンド」を参照してください。

サーバ名称は，作業ディレクトリ中のディレクトリ名として用いられます。作業ディレクトリ下のパス長がプラットフォームの上限に達しないようにサーバ名称を指定してください。作業ディレクトリのパス長の見積もりについては，マニュアル「Cosminexus　システム構築ガイド」のバッチサーバの作業ディレクトリについての説明を参照してください。

(4)　複数のバッチサーバを起動する場合の注意事項

バッチサーバはサーバ名称によって識別されます。インストールされたホストのホスト名がデフォルトのサーバ名称として設定されます。このため，同じホスト内で複数のバッチサーバを起動する場合，それぞれのバッチサーバにサーバ名称を割り当て，バッチサーバをセットアップします。

バッチサーバにサーバ名称を割り当てる場合，同じホスト内では，同じサーバ名称のバッチサーバを複数回セットアップしてはいけません。同じサーバ名称で再セットアップすると，エラーになります。

バッチサーバと接続するCORBAネーミングサービスのホスト名およびポート番号に関する注意事項を次に示します。

ホスト名およびポート番号の設定

同一ホストで複数のバッチサーバを同時に起動する場合，CORBAネーミングサービスとの接続に使用するホスト名およびポート番号が両方とも重ならないようにしてください。ホスト名およびポート番号は，usrconf.propertiesで設定します。

また，usrconf.propertiesのwebserver.connector.ajp13.portキーおよびejbserver.http.portキーで設定されているポート番号には，同時に起動するバッチサーバ間で異なる値を使用するように設定してください。

付録F.3　システムの削除の流れ

バッチアプリケーションを実行するシステムをファイル編集とコマンド実行で削除する場合，Cosminexusが提供するコマンドを使用して，バッチサーバをアンセットアップし，システムを削除します。

ファイル編集とコマンド実行で，バッチアプリケーションを実行するシステムを削除する場合の流れについて説明します。

システムを停止します。
システムの停止手順および停止方法については，「付録G　バッチアプリケーションを実行するシステムの起動と停止（Windowsの場合）」，または「付録H　バッチアプリケーションを実行するシステムの起動と停止（UNIXの場合）」を参照してください。

バッチサーバをアンセットアップします。
詳細については，「付録F.4　バッチサーバのアンセットアップ」を参照してください。

付録F.4　バッチサーバのアンセットアップ

Cosminexusのシステムを構成するバッチサーバのアンセットアップについて説明します。バッチサーバのアンセットアップの手順について，OSごとに説明します。

＜この項の構成＞

(1)　Windowsの場合

(2)　UNIXの場合

(1)　Windowsの場合

Windowsの場合のバッチサーバのアンセットアップ手順を次に示します。

次のコマンドでカレントディレクトリを移動します。
"cd <Cosminexusのインストールディレクトリ>¥CC¥server¥bin"

cjsetupコマンドで引数に-dを指定して，バッチサーバをアンセットアップします。
"cjsetup -d <サーバ名>"
バッチサーバのアンセットアップの例を次に示します。この例では，Cosminexusのインストールディレクトリは「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

付録G　バッチアプリケーションを実行するシステムの起動と停止（Windowsの場合）

ここでは，バッチアプリケーションを実行するシステムの起動と停止の手順について説明します。

＜この節の構成＞

付録G.1　システムの起動手順

付録G.2　システムの起動方法

付録G.3　システムの停止手順

付録G.4　システムの停止方法

付録G.1　システムの起動手順

システムの起動手順について説明します。

なお，データベースは起動済みであることを前提に説明します。データベースを使用している場合は，必要に応じてあらかじめ起動しておいてください。

＜この項の構成＞

(1)　アプリケーションサーバの起動の流れ

(1)　アプリケーションサーバの起動の流れ

システムで使用するアプリケーションサーバの起動の流れについて説明します。

システムの起動の流れを次の図に示します。

図G-1　システムの起動の流れ（Windowsの場合）

図中の1.～6.について説明します。

環境変数の設定
環境変数を設定します。環境変数の設定方法については，「付録D.2(1)　システム起動時の環境変数の設定」を参照してください。

PRFデーモンの起動
cprfstartコマンドでPRFデーモンを起動します。起動方法については，「付録D.2(2)　PRFデーモンの起動」を参照してください。

バッチサーバの起動
cjstartsvコマンドでバッチサーバを起動します。起動方法については，「付録G.2(1)　バッチサーバの起動」を参照してください。

リソースの開始
リソースを使用しない場合，この操作は不要です。
サーバ管理コマンド（cjstartrar）でリソースを開始します。開始方法については，「付録D.2(9)　リソースの開始」を参照してください。

バッチアプリケーションの実行
cjexecjobコマンドでバッチアプリケーションを実行します。
実行方法については，「付録G.2(2)　バッチアプリケーションの実行」を参照してください。

付録G.2　システムの起動方法

ここでは，バッチサーバの起動方法，およびバッチアプリケーションの実行方法について説明します。

＜この項の構成＞

(1)　バッチサーバの起動

(2)　バッチアプリケーションの実行

(1)　バッチサーバの起動

バッチサーバの起動方法について説明します。

標準システム構成でCORBAネーミングサービスをインプロセスで起動する場合の，バッチサーバの起動手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Cosminexusのインストールディレクトリ>¥CC¥server¥bin"

cjstartsvコマンドでバッチサーバを開始します。
コマンドの実行には，Administrator権限が必要です。

cjstartsv <サーバ名称> -nosecurity

(2)　バッチアプリケーションの実行

バッチアプリケーションの実行方法について説明します。

バッチアプリケーションは，cjexecjobコマンドを使用して実行します。なお，cjexecjobコマンドの実行には，Administrator権限が必要です。Windows Vistaの場合は，管理者特権が必要です。

バッチアプリケーションの実行手順を次に示します。

cjexecjobコマンドでバッチアプリケーションを実行します。
コマンドの実行には，Administrator権限が必要です。

"<Cosminexusのインストールディレクトリ>¥CC¥batch¥bin¥cjexecjob.exe" <サーバ名称> <Javaアプリケーションクラス名>

付録G.3　システムの停止手順

ここでは，バッチアプリケーション，およびバッチサーバなどの停止の手順について説明します。

＜この項の構成＞

(1)　システムの停止の流れ

(1)　システムの停止の流れ

システムの停止手順は，起動手順と逆の順序になります。データベースを使用している場合は，必要に応じて最後に停止してください。

次に示す順にシステムを停止してください。

バッチアプリケーションの停止
バッチアプリケーションが停止していない場合に，cjkilljobコマンドでバッチアプリケーションを停止します。停止の方法については，「付録G.4(1)　バッチアプリケーションの停止」を参照してください。

リソースの停止
リソースを使用していない場合，この操作は不要です。
サーバ管理コマンド（cjstoprar）でリソースを停止します。停止方法については，「付録D.4(3)　リソースの停止」を参照してください。

バッチサーバの停止
cjstopsvコマンドでバッチサーバを停止します。停止方法については，「付録G.4(2)　バッチサーバの停止」を参照してください。

PRFデーモンの停止
cprfstopコマンドでPRFデーモンを停止します。停止方法については，「付録D.4(10)　PRFデーモンの停止」を参照してください。

付録G.4　システムの停止方法

ここでは，バッチアプリケーションおよびバッチサーバの停止の方法について説明します。

＜この項の構成＞

(1)　バッチアプリケーションの停止

(2)　バッチサーバの停止

(1)　バッチアプリケーションの停止

バッチアプリケーションの停止の方法について説明します。

バッチアプリケーションが停止していない場合に，cjkilljobコマンドを使用してバッチアプリケーションを停止します。なお，cjkilljobコマンドの実行には，Administrator権限が必要です。また，Windows Vistaの場合は，管理者特権が必要です。

cjkilljobコマンドは，メソッドキャンセルによりバッチアプリケーションを停止します。停止に失敗した場合は，バッチサーバを強制停止します。

バッチアプリケーションの停止手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Cosminexusのインストールディレクトリ>¥CC¥batch¥bin"

cjkilljobコマンドでバッチサーバを停止します。
コマンドの実行には，Administrator権限が必要です。

cjkilljob <サーバ名称>

(2)　バッチサーバの停止

バッチサーバの停止の手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

cd "<Cosminexusのインストールディレクトリ>¥CC¥server¥bin"

cjstopsvコマンドでバッチサーバを停止します。
コマンドの実行には，Administrator権限が必要です。

cjstopsv <サーバ名称>

cjstopsvコマンドの実行例を次に示します。この例では，Cosminexusのインストールディレクトリは「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オプションを指定すると，バッチサーバの障害情報を取得したあと，バッチサーバを強制停止します。

付録H　バッチアプリケーションを実行するシステムの起動と停止（UNIXの場合）

ここでは，バッチアプリケーションを実行するシステムの起動と停止の手順について説明します。

＜この節の構成＞

付録H.1　システムの起動手順

付録H.2　システムの起動方法

付録H.3　システムの停止手順

付録H.4　システムの停止方法

付録H.1　システムの起動手順

システムの起動手順について説明します。

なお，データベースは起動済みであることを前提に説明します。データベースを使用している場合は，必要に応じてあらかじめ起動しておいてください。

＜この項の構成＞

(1)　アプリケーションサーバの起動の流れ

(1)　アプリケーションサーバの起動の流れ

システムで使用するアプリケーションサーバの起動の流れについて説明します。

アプリケーションサーバの起動の流れを次の図に示します。

図H-1　アプリケーションサーバの起動の流れ（UNIXの場合）

図中の1.～6.について説明します。

環境変数の設定
環境変数を設定します。環境変数の設定方法については，「付録E.2(1)　システム起動時の環境変数の設定」を参照してください。

PRFデーモンの起動
cprfstartコマンドでPRFデーモンを起動します。起動方法については，「付録E.2(2)　PRFデーモンの起動」を参照してください。

バッチサーバの起動
cjstartsvコマンドでバッチサーバを起動します。起動方法については，「付録H.2(1)　バッチサーバの起動」を参照してください。

リソースの開始
リソースを使用しない場合，この操作は不要です。
サーバ管理コマンドでリソースを開始します。開始方法については，「付録E.2(9)　リソースの開始」を参照してください。

バッチアプリケーションの実行
cjexecjobコマンドでバッチアプリケーションを開始します。開始方法については，「付録H.2(2)　バッチアプリケーションの実行」を参照してください。

付録H.2　システムの起動方法

ここでは，バッチサーバの起動方法，およびバッチアプリケーションの実行方法について説明します。

＜この項の構成＞

(1)　バッチサーバの起動

(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管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

バッチアプリケーションの実行手順を次に示します。

cjexecjobコマンドでバッチアプリケーションを実行します。
コマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

# "/opt/Cosminexus/CC/batch/bin/cjexecjob" <サーバ名称> <Javaアプリケーションクラス名>

付録H.3　システムの停止手順

ここでは，バッチアプリケーション，およびバッチサーバなどの停止の手順について説明します。

＜この項の構成＞

(1)　システムの停止の流れ

(1)　システムの停止の流れ

システムの停止手順は，起動手順と逆の順序になります。データベースを使用している場合は，必要に応じて最後に停止してください。

次に示す順にシステムを停止してください。

バッチアプリケーションの停止
バッチアプリケーションが停止していない場合に，cjkilljobコマンドでバッチアプリケーションを停止します。停止方法については，「付録H.4(1)　バッチアプリケーションの停止」を参照してください。

リソースの停止
リソースを使用していない場合，この操作は不要です。
サーバ管理コマンド（cjstoprar）でリソースを停止します。停止方法については，「付録E.4(3)　リソースの停止」を参照してください。

バッチサーバの停止
cjstopsvコマンドでバッチサーバを停止します。停止方法については，「付録H.4(2)　バッチサーバの停止」を参照してください。

PRFデーモンの停止
cprfstopコマンドでPRFデーモンを停止します。停止方法については，「付録E.4(10)　PRFデーモンの停止」を参照してください。

付録H.4　システムの停止方法

ここでは，バッチアプリケーションおよびバッチサーバの停止方法について説明します。

＜この項の構成＞

(1)　バッチアプリケーションの停止

(2)　バッチサーバの停止

(1)　バッチアプリケーションの停止

バッチアプリケーションの停止方法について説明します。

バッチアプリケーションが停止していない場合に，cjkilljobコマンドを使用してバッチアプリケーションを停止します。なお，cjkilljobコマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

cjkilljobコマンドは，メソッドキャンセルによりバッチアプリケーションを停止します。停止に失敗した場合は，バッチサーバを強制停止します。

バッチアプリケーションの停止手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/CC/batch/bin

cjkilljobコマンドでバッチアプリケーションを停止します。
コマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

# cjkilljob <サーバ名称>

(2)　バッチサーバの停止

バッチサーバの停止手順を次に示します。

cdコマンドでカレントディレクトリを移動します。

# cd /opt/Cosminexus/CC/server/bin

cjstopsvコマンドでバッチサーバを停止します。
コマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。

# cjstopsv <サーバ名称>

cjstopsvコマンドの実行例を次に示します。この例では，サーバ名は「MyServer」です。

# cd /opt/Cosminexus/CC/server/bin
# cjstopsv MyServer
#

なお，バッチサーバでの処理が終了しないなどの原因で，バッチサーバの停止処理が完了しない場合があります。この場合，バッチサーバを強制的に停止する必要があります。バッチサーバを強制停止する場合，cjstopsvコマンドに-fオプションまたは-fdオプションを指定して実行します。-fdオプションを指定すると，バッチサーバの障害情報を取得したあと，バッチサーバを強制停止します。

付録I　（3020-3-M10-61）の変更内容

3020-3-M10-61の変更内容を表I-1に示します。

表I-1　（3020-3-M10-61）の変更内容

#
変更個所
追加・変更内容

1
2.2
cjdumpsv（J2EEサーバのスレッドダンプの取得）の注意事項
［訂正前］
・UNIXの場合，cjdumpsvコマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。
［訂正後］
・UNIXの場合，cjdumpsvコマンドの実行には，root権限，またはComponent Container管理者の権限が必要です。

2
2.2
cjenvsetup（Component Container管理者のセットアップ）の注意事項
［訂正前］
・cjenvsetupコマンドを実行する前に，インストールディレクトリ（/opt/Cosminexus/CC）の属性（オーナー，グループ）をComponent Container管理者およびComponent Container管理者グループに変更する必要があります。
［訂正後］
・cjenvsetupコマンドを実行する前に，インストールディレクトリ（/opt/Cosminexus/CCをシンボリックリンクしている場合は，リンク先ディレクトリ）の属性（オーナー，グループ）をComponent Container管理者およびComponent Container管理者グループに変更する必要があります。

3
13.2
cosmienv（構築済み実行環境の退避，回復，削除，一覧出力）
[訂正前]
-P <退避パス>
構築済み実行環境を退避するパス名をフルパスで指定します。
構築済み実行環境の退避先は <退避パス>/<識別子> となります。
-s オプションを使用する場合には，退避パスの指定は必須です。
[訂正後]
-P <退避パス>
構築済み実行環境を退避するパス名をフルパスで指定します。
半角空白，全角空白，タブ文字を含むパス名は指定できません。
構築済み実行環境の退避先は <退避パス>/<識別子> となります。
-s オプションを使用する場合には，退避パスの指定は必須です。

4
14.2
cjdumpweb（Webコンテナサーバのスレッドダンプの取得）の注意事項
［訂正前］
・UNIXの場合，cjdumpwebコマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。
［訂正後］
・UNIXの場合，cjdumpwebコマンドの実行には，root権限，またはComponent Container管理者の権限が必要です。

5
付録E.2(7)
SFOサーバの起動
［訂正前］
なお，サーバ管理コマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。
［訂正後］
なお，サーバ管理コマンドの実行には，root権限，またはComponent Container管理者の権限が必要です。

6
付録E.2(10)
J2EEアプリケーションの開始
［訂正前］
なお，サーバ管理コマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。
［訂正後］
なお，サーバ管理コマンドの実行には，root権限，またはComponent Container管理者の権限が必要です。

7
付録E.4(2)
J2EEアプリケーションの停止
［訂正前］
なお，サーバ管理コマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。
［訂正後］
なお，サーバ管理コマンドの実行には，root権限，またはComponent Container管理者の権限が必要です。

8
付録E.4(3)
リソースの停止
［訂正前］
なお，サーバ管理コマンドの実行には，root権限（Component Container管理者を設定していない場合），またはComponent Container管理者の権限（Component Container管理者を設定している場合）が必要です。
［訂正後］
なお，サーバ管理コマンドの実行には，root権限，またはComponent Container管理者の権限が必要です。

索引

[Ａ][Ｃ][Ｄ][Ｊ][Ｋ][Ｍ][Ｏ][Ｐ][Ｒ][Ｓ][Ｕ][Ｗ]
[ア行][カ行][サ行][タ行][ハ行][マ行][ヤ行][ラ行]

(英字)

(Ａ)

adminagentcheck

adminagentctl

auditsetup

(Ｃ)

car_tar_Z

cjaddapp

cjaddsec

cjchmodapp

cjcldellog

cjcldumpap

cjclearpool

cjclosecn

cjclstartap

cjcopyres

cjdeleteapp

cjdeletejb

cjdeletelibjar

cjdeleteres

cjdeletesec

cjdeployrar

cjdumpsv

cjdumpweb

cjenvsetup

cjenvupdate

cjexportapp

cjexportrar

cjgencmpsql

cjgetappprop

cjgetjbprop

cjgetrarprop

cjgetresprop

cjgetstubsjar

cjgetsysinfo

cjimportapp

cjimportjb

cjimportlibjar

cjimportres

cjjsp2java

cjjspc

cjlistapp

cjlistjb

cjlistlibjar

cjlistpool

cjlistrar

cjlistres

cjlistsec

cjlistthread

cjlisttrn

cjlisttrnfile

cjmapsec

cjrarupdate

cjreloadapp

cjrenameapp

cjreplaceapp

cjresetsv

cjresumepool

cjsetappprop

cjsetjbprop

cjsetrarprop

cjsetresprop

cjsetup

cjsetup

cjsleep

cjstartapp

cjstartjb

cjstartrar

cjstartrecover

cjstartsv

cjstartsv

cjstartweb

cjstopapp

cjstopjb

cjstoprar

cjstopsv

cjstopthread

cjstopweb

cjsuspendpool

cjtestres

cjtracesync

cjundeployrar

cjunmapsec

cjwebchangedbid

cjwebclearpool

cjwebclosepool

cjwebdeletepool

cjwebeditpool

cjweblistpool

cjwebsetup

CMP2.x Entity Bean用SQL文の生成

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

convpw

CORBAネーミングサービスの起動

CORBAネーミングサービスの起動

CORBAネーミングサービスの停止

CORBAネーミングサービスの停止

coreアーカイブ機能

coreファイルの取得

cosmienv

Cosminexus DABroker Libraryのセットアップ

Cosminexusアダプタコマンドのセットアップとアンセットアップ

Cosminexusモニタ起動コマンドのセットアップとアンセットアップ

cprfed

cprfflush

cprfgetpid

cprflevel

cprfstart

cprfstop

ctmchpara

ctmdminfo

ctmdmstart

ctmdmstop

ctmgetpid

ctmholdque

ctmlogcat

ctmlsque

ctmrasget

ctmregltd

ctmridinfo

ctmrlesque

ctmstart

ctmstop

ctmstsed

ctmstsflush

ctmstsstart

ctmstsstop

ctmtscgwd

ctmver

CTMデーモンの開始

CTMデーモンの起動

CTMデーモンの起動

CTMデーモンの終了

CTMデーモンの停止

CTMデーモンの停止

CTMで使用するコマンド

CTMドメイン情報の出力

CTMドメイン情報の表示と削除

CTMドメインマネジャの開始

CTMドメインマネジャの起動

CTMドメインマネジャの起動

CTMドメインマネジャの終了

CTMドメインマネジャの停止

CTMドメインマネジャの停止

CTMレギュレータの開始

(Ｄ)

dabsetup

daemon

(Ｊ)

J2EEアプリケーション

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

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

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

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

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

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

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

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

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

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

J2EEサーバの開始

J2EEサーバの起動

J2EEサーバの起動

J2EEサーバの起動間隔

J2EEサーバのコネクションクローズまたはコネクションの状態表示

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

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

J2EEサーバの停止

J2EEサーバの停止

J2EEサーバの停止

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

JavaBeansリソースの一覧表示

JavaBeansリソースのインポート

JavaBeansリソースの開始

JavaBeansリソースの削除

JavaBeansリソースの属性設定

JavaBeansリソースの属性の取得

JavaBeansリソースの停止

javacore

javagc

javatrace

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

Javaアプリケーションのシステムログ出力先サブディレクトリの削除

Javaアプリケーションのスレッドダンプの取得

jheapprof

JSPソースのチェック

JSPの事前コンパイル

(Ｋ)

kill

(Ｍ)

Management Server管理ファイルの回復

Management Server管理ファイルの退避

Management Serverで使用するコマンド

Management Serverの移行コマンド

Management Serverの運用管理コマンド

Management Serverの起動／停止／セットアップ

mngautorun

mngsvr_adapter_setup

mngsvr_monitor_setup

mngsvrctl

mngsvrupdate

mngsvrutil

mstrexport

mstrimport

(Ｏ)

OS状態情報の取得

OTMゲートウェイの開始

(Ｐ)

PRFデーモンの開始

PRFデーモンの起動

PRFデーモンの起動

PRFデーモンの停止

PRFデーモンの停止

PRFデーモンプロセスIDの取得

PRFトレース取得レベルの指定例（cprflevelコマンド）

PRFトレース取得レベルの指定例（cprfstartコマンド）

PRFトレース取得レベルの指定例（cprfstartコマンド）

PRFトレース取得レベルの表示と変更

(Ｒ)

RAR属性設定

RARファイルの属性の取得

(Ｓ)

SFOサーバの起動

SFOサーバの起動

SFOサーバの停止

SFOサーバの停止

snapshotlog

snapshotログの収集

ssoexport

ssogenkey

ssoimport

(Ｕ)

uachpw

(Ｗ)

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

Webコンテナサーバで使用するコマンド

Webコンテナサーバの開始

Webコンテナサーバのスレッドダンプの取得

Webコンテナサーバのセットアップとアンセットアップ

Webコンテナサーバの停止

Webサーバの起動

Webサーバの起動

Webサーバの停止

Webサーバの停止

(ア行)

(あ)

アプリケーションサーバの起動の流れ（UNIXの場合）

アプリケーションサーバの起動の流れ（UNIXの場合）

アプリケーションサーバの起動の流れ（Windowsの場合）

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

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

アプリケーションの入れ替え

アプリケーションの属性設定

アプリケーションの属性の取得

アプリケーションのモード切り替え

アプリケーションのリロード

アプリケーション名の変更

暗号鍵ファイルの作成

(い)

インプロセスHTTPサーバ用トレースファイルの同期

(う)

運用管理エージェントの稼働確認

運用管理エージェントの起動と停止

(カ行)

(か)

ガーベージコレクションの強制発生

稼働中のJ2EEサーバのトランザクション情報の表示

稼働統計情報の取得開始

稼働統計情報の取得終了

稼働統計情報の編集と出力

(く)

クライアント側共通定義ファイル（mngsvrutilcl.properties）

クライアント側定義ファイル（.mngsvrutilrc）

(こ)

構築済み実行環境の切り替えで使用するコマンド

コネクションプール内のコネクション削除

コネクションプールの一覧表示

(サ行)

(さ)

サーバ側定義ファイル（mngsvrutil.properties）

サーバ管理コマンドの排他強制解除

サービスの設定

作業ディレクトリおよびユーザ定義ファイルの移行

サブコマンド

サブコマンドchangeに指定できる引数

サブコマンドcheckに指定できる引数

サブコマンドcollectに指定できる引数

サブコマンドdumpに指定できる引数

サブコマンドgetに指定できる引数

サブコマンドholdに指定できる引数

サブコマンドlistに指定できる引数

サブコマンドreleaseに指定できる引数

サブコマンドreloadに指定できる引数

サブコマンドsetに指定できる引数

サブコマンドstartに指定できる引数

サブコマンドstopに指定できる引数

(し)

システム起動時の環境変数の設定

システム起動時の環境変数の設定

システムの起動手順

システムの起動手順

システムの起動手順

システムの起動手順

システムの起動の流れ（Windowsの場合）

システムの起動方法

システムの起動方法

システムの起動方法

システムの停止手順

システムの停止手順

システムの停止手順

システムの停止手順

システムの停止の流れ

システムの停止の流れ

システムの停止の流れ

システムの停止の流れ

システムの停止方法

システムの停止方法

システムの停止方法

システムの停止方法

実行形式ファイルおよびライブラリのバージョン情報の出力

実行形式ファイルおよびライブラリのバージョン情報の出力

詳細レベルのトレース情報を取得する場合の指定値（cprflevelコマンド）

詳細レベルのトレース情報を取得する場合の指定値（cprfstartコマンド）

詳細レベルまたは保守レベルのトレース情報を取得する場合の指定値（cprflevelコマンド）

詳細レベルまたは保守レベルのトレース情報を取得する場合の指定値（cprfstartコマンド）

シングルサインオン情報リポジトリの参照

シングルサインオン情報リポジトリの登録

(す)

スケジュールキュー情報の出力

スケジュールキューの同時実行数の変更

スケジュールキューの閉塞

スケジュールキューの閉塞解除

スマートエージェントの起動

スマートエージェントの起動

スマートエージェントの停止

スマートエージェントの停止

スレッド情報の表示

スレッドの削除

(せ)

性能解析トレース情報の編集出力

性能解析トレースで使用するコマンド

セッションフェイルオーバサーバの起動の流れ（UNIXの場合）

セッションフェイルオーバサーバの起動の流れ（Windowsの場合）

(タ行)

(て)

停止中のJ2EEサーバのトランザクション情報の表示

データベースIDの変更

デーモンプロセスの起動

(と)

統合ネーミングスケジューラサーバの起動の流れ（UNIXの場合）

統合ネーミングスケジューラサーバの起動の流れ（Windowsの場合）

統合ユーザ管理で使用するコマンド

トラブルシュート情報の取得と出力

トレース情報の収集

(ハ行)

(は)

パスワードの暗号化

パスワードの変更

バッチアプリケーションの実行

バッチアプリケーションの停止

バッチサーバで使用するコマンド

バッチサーバの開始

バッチサーバの起動

バッチサーバのセットアップとアンセットアップ

バッチサーバの停止

バッファ内容の強制ファイル出力

バッファ内容の強制ファイル出力

(ひ)

日立クラス別統計付き拡張スレッドダンプの出力

(ふ)

プール管理情報の一覧表示

プール管理情報の削除

プール管理情報の登録と変更

プール内のコネクションの強制切断

プール内のコネクションのクリア

プロセスIDの取得

プロセスの強制停止

(マ行)

(め)

メッセージの編集と出力

メンバコネクションプールの一時停止

メンバコネクションプールの再開始

(ヤ行)

(ゆ)

ユーザとロールのアンマッピング

ユーザとロールの一覧表示

ユーザとロールの削除

ユーザとロールの追加

ユーザとロールのマッピング

(ラ行)

(ら)

ライブラリJARの一覧表示

ライブラリJARのインポート

ライブラリJARの削除

(り)

リソースアダプタのアンデプロイ

リソースアダプタの一覧表示

リソースアダプタのエクスポート

リソースアダプタの開始

リソースアダプタの停止

リソースアダプタのデプロイ

リソースアダプタのバージョンアップ

リソースの一覧表示

リソースのインポート

リソースの開始

リソースの開始

リソースのコピー

リソースの削除

リソースの接続テスト

リソースの属性設定

リソースの属性の取得

リソースの追加

リソースの停止

リソースの停止

■ 商標類

AIXは，米国における米国International Business Machines Corp.の登録商標です。
AMDは，Advanced Micro Devices,Inc.の商標です。
Borlandのブランド名および製品名はすべて，米国Borland Software Corporationの米国およびその他の国における商標または登録商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
IIOPは，OMG仕様によるORB(Object Request Broker)間通信のネットワークプロトコルの名称です。
Intelは，Intel Corporationの会社名です。
Internet Explorerは，米国Microsoft Corporationの米国及びその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国および他の国におけるインテル コーポレーションまたはその子会社の登録商標です。
Java 及びすべてのJava関連の商標及びロゴは，米国及びその他の国における米国Sun Microsystems, Inc.の商標または登録商標です。
JDKは，米国 Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
Linuxは，Linus Torvaldsの米国およびその他の国における登録商標あるいは商標です。
Microsoftは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Microsoft Internet Information Servicesは，米国Microsoft Corp.の商品名称です。
Microsoft SQL Serverは，米国Microsoft Corp.の商品名称です。
OMG，CORBA，IIOP，UML，Unified Modeling Language，MDA，Model Driven Architectureは，Object Management Group, Inc.の米国及びその他の国における登録商標または商標です。
ORACLEは，米国Oracle Corporationの登録商標です。
Oracleは，米国Oracle Corporation及びその子会社，関連会社の登録商標です。
Oracle9iは，米国Oracle Corporationの商標です。
Oracle 10gは，米国Oracle Corporationの商標です。
PA-RISCは，米国Hewlett-Packard Companyの商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標若しくは商標です。
SOAP（Simple Object Access Protocol）は，分散ネットワーク環境においてXMLベースの情報を交換するための通信プロトコルの名称です。
Solaris は，米国Sun Microsystems, Inc. の米国およびその他の国における商標または登録商標です。
SQL Serverは，米国法人Sybase，Inc.の商標です。
UNIXは，X/Open Company Limited が独占的にライセンスしている米国ならびに他の国における登録商標です。
Windowsは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
Windows Serverは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
Windows Vistaは，米国Microsoft Corporationの米国及びその他の国における登録商標です。
X/Openは，X/Open Company Limited の英国ならびに他の国における登録商標です。
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).
プログラムプロダクト「P-9D43-7D71，P-9D43-7K71，P-9D43-7M71，P-9D43-7S71」には，米国Sun Microsystems,Inc.が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D43-7D71，P-9D43-7K71，P-9D43-7M71，P-9D43-7S71」には，UNIX System Laboratories,Inc.が著作権を有している部分が含まれています。