Hitachi

Cosminexus V11 BPM/ESB基盤 サービスプラットフォーム リファレンス


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

ユーザ定義受付

次の優先順位に従って実行されます。

  1. ユーザ定義受付(呼出先選択)の受付IDの昇順

  2. ビジネスプロセス名の昇順,およびユーザ定義受付(呼出先固定)の受付IDの昇順

-errskip

指定されたHCSCコンポーネントの一部で開始に失敗しても,処理を継続します(エラースキップ機能)。このオプションは,-allまたは-namelistと同時に指定してください。

エラースキップ機能を使用していて,HCSCコンポーネントでエラーが発生した場合,HCSC-Managerのログおよびコンソールへのメッセージ出力の流れは次のようになります。

  1. 一部のHCSCコンポーネントでエラーが発生すると,該当するエラーメッセージを出力して,処理を継続します。

  2. すべての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」以外となるときがあります。

注意事項