jirmcontrolservice
機能
JP1/ITRMのサービスを起動,停止する,またはサービスの状態を確認するコマンドです。このコマンドは,Windowsのサービスコントロールマネージャーに複数登録されているJP1/ITRMのサービスの稼働状態を,一括で確認する場合などに使用します。また,このコマンドを使用すると,JP1/ITRMの各サービスを起動,停止する順序を統一できます。
このコマンドで操作対象となるサービスを次の表に示します。
表1-2 操作対象のサービス
サービス表示名※1 | サービス名※2 | サービスの内容 |
---|---|---|
JP1/ITRM Web Service | JP1_ITRMWebService | Webサーバサービス |
JP1/ITRM Service | JP1_ITRMService | JP1/ITRMの製品サービス |
JP1/ITRM DB Service | HiRDBEmbeddedEdition_JR0 | データベースサービス |
なお,データベースのクラスタ登録サービス(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 Service | 4 | 1 | 3 | |
JP1/ITRM Service | 3 | 2 | 2 | |
JP1/ITRM DB Service | サービス | 1 | 3 | - |
ユニットサーバ(JP1/ITRM DB Serviceの子プロセス) | 2 | - | 1 |
-q
非対話形式でコマンドを実行するときに指定します。コマンドを自動実行する場合など,ユーザーの確認を省略したいときに使用します。
戻り値
0 | 正常終了 |
1 | ほかのJP1/ITRMコマンドが実行中 |
2 | システム環境不正 |
3 | Administrators権限で実行していない |
4 | 引数不正 |
9 | ユーザーが処理を中止した |
10 | サービスが停止できない |
11 | サービスが起動できない |
17 | サービスの状態取得に失敗 |
18 | メモリの割り当てに失敗 |
20 | 全サービスが起動状態(正常終了) |
21 | JP1/ITRM DB Serviceが停止状態(正常終了) |
22 | JP1/ITRM Serviceが停止状態(正常終了) |
23 | JP1/ITRM Web Serviceが停止状態(正常終了) |
24 | JP1/ITRM Web Serviceが起動状態(正常終了) |
25 | JP1/ITRM Serviceが起動状態(正常終了) |
26 | JP1/ITRM DB Serviceが起動状態(正常終了) |
27 | JP1/ITRM DB Serviceの再起動を中断した |
28 | 全サービスが停止状態(正常終了) |
80 | サービスの状態が不正 |
91 | JP1/ITRM DB Serviceの起動に失敗 |
93 | サービスのスタートアップの種類が「無効」になっている |
94 | サービスの状態が起動動作中または停止動作中 |
97 | コマンドを待機系サーバで実行している |
98 | [Ctrl]+[C]キーを押してコマンドを中止した |
99 | その他のエラー |
サービスの状態確認の結果
-aオプションにstateを指定した場合に出力される,サービスの状態確認の結果(戻り値)を次の表に示します。
表1-4 サービスの状態確認の結果(戻り値)
項番 | サービス | 状態確認の結果(戻り値) | ||
---|---|---|---|---|
JP1/ITRM Web Service | JP1/ITRM Service | JP1/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