csccompostart(HCSCコンポーネントの開始)
形式
csccompostart [-h] -user <ログインユーザID> -pass <ログインパスワード> {-csc <HCSCサーバ名>|-cluster <クラスタ名>} {-name <サービスID|受付ID> |-all [-errskip] |-namelist <HCSCコンポーネント指定ファイル名> [-errskip]} [-nogc]
機能
HCSCコンポーネントを開始します。
ログインユーザIDなどの必須オプションは,HCSC-Managerコマンド共通定義ファイルにデフォルト値を設定することで,このコマンドでの指定を省略できます。
また,実行対象が複数のHCSCコンポーネントである場合,一部のHCSCコンポーネントでエラー(通信障害など,HCSCコンポーネント呼び出し時に発生するエラーを含む)が発生しても,そのHCSCコンポーネントの処理をスキップして処理を継続することもできます(エラースキップ機能)。エラースキップ機能は,運用環境の運用画面や開発環境の一括実行機能(「複数サービスをサーバに配備して開始」など)からは実行できません。
このコマンドの使用方法については,目的にあわせてマニュアル「サービスプラットフォーム システム構築・運用ガイド」の次に示す個所を参照してください。
引数
-h
コマンドの使用方法が表示されます。このオプションを指定している場合は,ほかのオプションを指定しても無視されます。
-user <ログインユーザID> 〜<半角英数字およびアンダーバー(_)> ((1−16文字))
HCSC-Managerログイン時に使用するユーザIDを指定します。
-pass <ログインパスワード> 〜<半角英数字およびアンダーバー(_)> ((1−16文字))
HCSC-Managerログイン時に使用するパスワードを指定します。
-csc <HCSCサーバ名> 〜<半角英数字およびアンダーバー(_)> ((1−8文字))
開始するHCSCコンポーネントのHCSCサーバ名を指定します。
-cluster <クラスタ名> 〜<半角英数字およびアンダーバー(_)> ((1−8文字))
HCSCコンポーネントを一括開始するクラスタ名を指定します。クラスタ種別がHAのときに-clusterを指定するとエラーになります。
-name <サービスID|受付ID> 〜<半角英数字およびアンダーバー(_)> ((1−8文字))
開始するHCSCコンポーネントのサービスIDまたは受付IDを指定します。-clusterと同時に指定した場合は,クラスタ内の同じサービスIDのHCSCコンポーネントをすべて開始します。
-all
指定範囲内で停止中のHCSCコンポーネントをすべて開始します。-cscと同時に指定した場合は,指定したHCSCサーバ内で停止中のすべてのHCSCコンポーネントを開始します。-clusterと同時に指定した場合は,指定したクラスタ内で停止中のすべてのHCSCコンポーネントを開始します。
このオプションを指定した場合のHCSCコンポーネントの開始順は次のとおりです。-errskipと同時に指定していない場合,処理中にエラーが発生すると,すべてのHCSCコンポーネントが開始されていなくても開始処理は終了します。
開始順 |
HCSCコンポーネントの種類 |
HCSCコンポーネント内の開始順 |
---|---|---|
1 |
サービスアダプタ |
サービスIDの昇順 |
2 |
ビジネスプロセス |
ビジネスプロセス名の昇順 |
3 |
ユーザ定義受付 |
次の優先順位に従って実行されます。
|
-errskip
指定されたHCSCコンポーネントの一部で開始に失敗しても,処理を継続します(エラースキップ機能)。このオプションは,-allまたは-namelistと同時に指定してください。
エラースキップ機能を使用していて,HCSCコンポーネントでエラーが発生した場合,HCSC-Managerのログおよびコンソールへのメッセージ出力の流れは次のようになります。
-
一部のHCSCコンポーネントでエラーが発生すると,該当するエラーメッセージを出力して,処理を継続します。
-
すべてのHCSCコンポーネントの処理終了後,エラーとなったHCSCコンポーネントの件数を通知する警告メッセージを出力します。
なお,このオプションをHCSC-Managerコマンド共通定義ファイル(csccmd.properties)に定義すれば,常にエラースキップ機能が有効になり,このコマンドでの指定を省略できます。HCSC-Managerコマンド共通定義ファイルの定義方法については,「6.5.2 HCSC-Managerコマンド共通定義ファイル」を参照してください。
-namelist <HCSCコンポーネント指定ファイル名> 〜((1−200バイト))
開始するHCSCコンポーネントをHCSCコンポーネント指定ファイルで指定します。絶対パスまたは相対パスで指定します。ファイルが存在しない場合は異常終了します。HCSCコンポーネント指定ファイルについては,「6.5.5 HCSCコンポーネント指定ファイル」を参照してください。
なお,指定されたHCSCコンポーネントの開始順およびエラー発生時の処理は,-allオプションと同じです。
-nogc
FullGCを発生させないでコンポーネントを開始します。ただし,このオプションを指定しても,JavaVMが自動的に発生させるFullGCや,J2EEサーバの異常処理で発行されるFullGCは抑止されません。
HCSCコンポーネント開始時に明示的にFullGCを発生させる場合は,javagcコマンドを実行してください。javagcコマンドについては,マニュアル「アプリケーションサーバ リファレンス コマンド編」の「javagc(GCの強制発生)」を参照してください。
入力例
- (1)HCSCサーバ「HCSC」下にある「BP1」を開始する場合
csccompostart -user admin -pass admin -csc HCSC -name BP1
- (2)HCSCサーバ「HCSC」下にあるすべてのHCSCコンポーネントを一括開始する場合
csccompostart -user admin -pass admin -csc HCSC -all
- (3)クラスタ「Cluster」下にあるHCSCサーバごとに「BP1」を一括開始する場合
csccompostart -user admin -pass admin -cluster Cluster -name BP1
- (4)クラスタ「Cluster」下にあるすべてのHCSCコンポーネントを一括開始する場合
csccompostart -user admin -pass admin -cluster Cluster -all
- (5)FullGCを発生させないで,HCSCサーバ「CSCSrv1」下にある「BP1」を一括開始する場合
csccompostart -user admin -pass admin -csc CSCSrv1 -name BP1 -nogc
- (6)HCSCサーバ「CSCSrv1」下にあるHCSCコンポーネントのうち,HCSCコンポーネント指定ファイル「hcsccomponent.txt」に指定されているHCSCコンポーネントを一括開始する場合
csccompostart -user admin -pass admin -csc CSCSrv1 -namelist hcsccomponent.txt
- (7)HCSCサーバ「CSCSrv1」下にあるすべてのHCSCコンポーネントを開始し,一部のHCSCコンポーネントの開始に失敗しても処理を継続する場合
csccompostart -csc CSCSrv1 -all -errskip
- (8)HCSCサーバ「CSCSrv1」下にあるHCSCコンポーネントのうち,HCSCコンポーネント指定ファイル「hcsccomponent.txt」に指定されているHCSCコンポーネントを開始し,一部のHCSCコンポーネントの開始に失敗しても処理を継続する場合
csccompostart -csc CSCSrv1 -namelist hcsccomponent.txt -errskip
戻り値
戻り値 |
意味 |
---|---|
0 |
正常終了しました。 |
1 |
コマンドが異常終了しました。 |
2 |
通信タイムアウトが発生しました。 |
3 |
排他エラーが発生しました。 |
9 |
実行権限のチェックエラーが発生しました。 |
-errskipを指定する場合は,HCSCコンポーネントの処理でエラーが発生しても処理を継続するため,戻り値は「0」となります。ただし,オプションの組み合わせ不正など,HCSCコンポーネント呼び出し時以外でエラーが発生した場合,戻り値は「0」以外となるときがあります。
注意事項
-
このコマンドは停止状態のHCSCコンポーネントに対して実行してください。複数のHCSCコンポーネントが指定された場合,起動状態ではないHCSCコンポーネントが処理対象となります。起動状態のHCSCコンポーネントが指定された場合は処理をスキップします。
-
コマンド実行時にHCSCサーバは起動している必要があります。
-
-clusterや-allを指定してエラーになった場合,結果をcscstatusコマンドで確認し,障害要因を取り除いたあとに,再度コマンドを実行してください。
-
このコマンドを複数のクライアントから1つのHCSCサーバに対して同時に実行すると,処理エラー(排他エラー,またはコンポーネントへの操作重複による異常終了)となるおそれがあります。エラーが発生した場合は,次のどちらかの方法でコマンドを再実行してください。
-
-allオプションを指定してHCSCコンポーネントを起動する
-
-nameオプションを指定して個別にHCSCコンポーネントを起動する
-