jirmcontrolservice

機能

JP1/ITRMのサービスを起動,停止する,またはサービスの状態を確認するコマンドです。このコマンドは,Windowsのサービスコントロールマネージャーに複数登録されているJP1/ITRMのサービスの稼働状態を,一括で確認する場合などに使用します。また,このコマンドを使用すると,JP1/ITRMの各サービスを起動,停止する順序を統一できます。

このコマンドで操作対象となるサービスを次の表に示します。

表1-2 操作対象のサービス

サービス表示名※1サービス名※2サービスの内容
JP1/ITRM Web ServiceJP1_ITRMWebServiceWebサーバサービス
JP1/ITRM ServiceJP1_ITRMServiceJP1/ITRMの製品サービス
JP1/ITRM DB ServiceHiRDBEmbeddedEdition_JR0データベースサービス
注※1
[コントロールパネル]-[管理ツール]-[サービス]で表示される名称です。
注※2
WSFCに登録する場合の名称です。

なお,データベースのクラスタ登録サービス(JP1/ITRM DB Cluster Service)は,操作対象ではありません。

実行時の前提条件

-aオプションでstartまたはstopを指定する場合,クラスタソフトにJP1/ITRMのサービスが登録されているときは,クラスタソフトでJP1/ITRMのサービスをオフラインにしてから実行してください。

形式

jirmcontrolservice -a {start | stop | state} [-q]

引数

-a {start | stop | state}

サービスに対する操作を指定します。

JP1/ITRMのサービスを起動,停止する順序,またはサービスの状態を確認する順序を次の表に示します。

表1-3 サービスの起動,停止,状態の確認をする順序

サービス起動(start)停止(stop)状態の確認(state)
JP1/ITRM Web Service413
JP1/ITRM Service322
JP1/ITRM DB Serviceサービス13
ユニットサーバ(JP1/ITRM DB Serviceの子プロセス)21
(凡例)
-:操作しない。

-q

非対話形式でコマンドを実行するときに指定します。コマンドを自動実行する場合など,ユーザーの確認を省略したいときに使用します。

戻り値

0正常終了
1ほかのJP1/ITRMコマンドが実行中
2システム環境不正
3Administrators権限で実行していない
4引数不正
9ユーザーが処理を中止した
10サービスが停止できない
11サービスが起動できない
17サービスの状態取得に失敗
18メモリの割り当てに失敗
20全サービスが起動状態(正常終了)
21JP1/ITRM DB Serviceが停止状態(正常終了)
22JP1/ITRM Serviceが停止状態(正常終了)
23JP1/ITRM Web Serviceが停止状態(正常終了)
24JP1/ITRM Web Serviceが起動状態(正常終了)
25JP1/ITRM Serviceが起動状態(正常終了)
26JP1/ITRM DB Serviceが起動状態(正常終了)
27JP1/ITRM DB Serviceの再起動を中断した
28全サービスが停止状態(正常終了)
80サービスの状態が不正
91JP1/ITRM DB Serviceの起動に失敗
93サービスのスタートアップの種類が「無効」になっている
94サービスの状態が起動動作中または停止動作中
97コマンドを待機系サーバで実行している
98[Ctrl]+[C]キーを押してコマンドを中止した
99その他のエラー

サービスの状態確認の結果

-aオプションにstateを指定した場合に出力される,サービスの状態確認の結果(戻り値)を次の表に示します。

表1-4 サービスの状態確認の結果(戻り値)

項番サービス状態確認の結果(戻り値)
JP1/ITRM Web ServiceJP1/ITRM ServiceJP1/ITRM DB Service
1開始開始開始全サービス開始(20)
2開始開始DBサービスの再起動が中断している状態DB再起動中断状態(27)
3開始開始JP1/ITRM DB Serviceは起動しているが,子プロセスは停止している状態DBサービス停止(21)
4開始開始停止DBサービス停止(21)
5開始停止開始製品サービス停止(22)
6開始停止DBサービスの再起動が中断している状態DB再起動中断状態(27)
7開始停止JP1/ITRM DB Serviceは起動しているが,子プロセスは停止している状態Webサービス開始(24)
8開始停止停止Webサービス開始(24)
9停止開始開始Webサービス停止(23)
10停止開始DBサービスの再起動が中断している状態DB再起動中断状態(27)
11停止開始JP1/ITRM DB Serviceは起動しているが,子プロセスは停止している状態製品サービス開始(25)
12停止開始停止製品サービス開始(25)
13停止停止開始DBサービス開始(26)
14停止停止DBサービスの再起動が中断している状態DB再起動中断状態(27)
15停止停止JP1/ITRM DB Serviceは起動しているが,子プロセスは停止している状態全サービス停止(28)
16停止停止停止全サービス停止(28)
17任意の状態任意の状態開始または停止処理中開始または停止処理中(94)
18任意の状態開始または停止処理中任意の状態開始または停止処理中(94)
19開始または停止処理中任意の状態任意の状態開始または停止処理中(94)

使用例1

サービスを起動する場合

jirmcontrolservice -a start

使用例2

サービスを停止する場合

jirmcontrolservice -a stop

使用例3

サービスの状態を確認する場合

jirmcontrolservice -a state