cscutil各種操作

形式

cscutil [-h]
       -user <ログインユーザID>
       -pass <ログインパスワード>
       {-mng <Cosminexus Manager名>
         |-host <IPアドレス>:<ポート番号> -mnguser <管理ユーザID>
           [-mngpass <管理ユーザパスワード>]}
       -target {server|compo|compo_urecp|request_service}
       -operation {start|stop|get_setup_info|get_info
         |get_bp_info|get_adapter_info|set_info|delete_info}
       {-props <プロパティ>|-propfile <プロパティファイル名>}
       [-binary <ファイル名>]

機能

次に示す操作ができます。

ログインユーザIDなどの必須オプションは,HCSC-Managerコマンド共通定義ファイルにデフォルト値を設定することで,このコマンドでの指定を省略できます。

引数

-h

コマンドの使用方法が表示されます。このオプションを指定している場合は,ほかのオプションを指定しても無視されます。

-user <ログインユーザID> ~<半角英数字およびアンダーライン(_)> ((1-16文字))

HCSC-Managerログイン時に使用するユーザIDを指定します。

-pass <ログインパスワード> ~<半角英数字およびアンダーライン(_)> ((1-16文字))

HCSC-Managerログイン時に使用するパスワードを指定します。

-mng <Cosminexus Manager名> ~<半角英数字およびアンダーライン(_)> ((1-16文字))

Cosminexus Managerのマネージャ識別名を指定します。リポジトリ内に存在するCosminexus Manager名を指定してください。

-host <ホスト名またはIPアドレス>:<ポート番号> ~<ホスト名またはIPアドレス:文字列,ポート番号:数字>((文字列:1文字以上,ポート番号:1-65535))

Managerリモート管理機能のホスト名(またはIPアドレス)とポート番号を「:」で連結して指定します。IPアドレス,ポート番号ともに省略はできません。

リポジトリが存在しない状態でも,-hostオプションは指定できます。-hostオプションを指定する場合,-mnguserオプションおよび-mngpassオプションを指定してください。

-mnguser <管理ユーザID> ~ ((1文字以上))

Cosminexus Managerの管理ユーザIDを指定します。

-mngpass <管理ユーザパスワード> ~ ((1文字以上))

Cosminexus Managerの管理ユーザIDに対するパスワードを指定します。変更するCosminexus ManagerのユーザIDにパスワードを設定している場合だけ,このオプションを指定できます。

-target {server|compo|compo_urecp|request_service}

実行する操作対象を指定します。

-operation {start|stop|get_setup_info|get_info|get_bp_info|get_adapter_info}

実行する操作を指定します。

-targetオプションと-operationオプションの値によって実施できる操作を次の表に示します。

表4-6 -targetオプションと-operationオプションの値によって実施できる操作

-targetオプション-operationオプション操作内容
serverstartHCSCサーバの起動
compostartビジネスプロセスの開始
compostartアダプタの開始
request_servicestart標準受付の開始
request_servicestop標準受付の停止
compostopアダプタの停止
compostopビジネスプロセスの停止
serverstopHCSCサーバの停止
serverget_setup_infoHCSCサーバのセットアップ情報取得
serverget_infoHCSCサーバの情報取得
compoget_bp_infoビジネスプロセスの情報取得
compoget_adapter_infoアダプタの情報取得
compo_urecpget_infoユーザ定義受付の情報取得
compo_urecpstartユーザ定義受付の開始
compo_urecpstopユーザ定義受付の停止

-props <プロパティ> ~ ((0文字以上))

指定した操作対象やオペレーションに指定する引数を 「<キー値>= <指定値>」の形式で指定します。指定値はダブルクォーテーション(")で囲みます。

ただし,キー値および指定値には,次に示す文字を指定できません。指定すると,動作が不定となります。

また,複数指定する場合,各引数はコンマ(,)で区切ります。

(例) -props "J2EESrvName=HCSCサーバをセットアップしたJ2EEサーバ名,CSCSrvName=起動するHCSCサーバ名"

表4-7 操作対象や操作に対する-propsオプションへ指定するプロパティ

操作内容-target-operation-propsで指定するプロパティ
HCSCサーバの起動serverstart
  • J2EESrvName=HCSCサーバをセットアップしたJ2EEサーバ名
  • CSCSrvName=起動するHCSCサーバ名
ビジネスプロセスの開始compostart
  • AdapterName=起動するビジネスプロセスのサービスID
  • ServiceKind=アダプタ種別
    bp:ビジネスプロセス
  • J2EESrvName=アダプタを起動するJ2EEサーバ名
  • CSCSrvName=アダプタを起動するHCSCサーバ名
アダプタの開始compostart
  • AdapterName=起動するサービスアダプタのサービスID
  • ServiceKind=アダプタ種別
    serviceAdapter:サービスアダプタ
  • J2EESrvName=アダプタを起動するJ2EEサーバ名
  • CSCSrvName=アダプタを起動するHCSCサーバ名
標準受付の開始request_servicestart
  • J2EESrvName=HCSCサーバが起動しているJ2EEサーバ名
  • CSCSrvName=リクエスト受付ができるHCSCサーバ名
標準受付の停止request_servicestop
  • J2EESrvName=インポートするJ2EEサーバ名
  • CSCSrvName=リクエスト抑止するHCSCサーバ名
  • ForceFlag=強制停止フラグ
    NORMAL_OPTION:通常停止
    WAIT_OPTION:計画停止
    FORCE_OPTION:強制停止
アダプタの停止compostop
  • J2EESrvName=アダプタを停止するJ2EEサーバ名
  • CSCSrvName=アダプタを停止するHCSCサーバ名
  • AdapterName=停止するサービスアダプタのサービスID
ビジネスプロセスの停止compostop
  • J2EESrvName=アダプタを停止するJ2EEサーバ名
  • CSCSrvName=アダプタを停止するHCSCサーバ名
  • AdapterName=停止するビジネスプロセスのサービスID
HCSCサーバの停止serverstop
  • J2EESrvName=HCSCサーバをセットアップしたJ2EEサーバ名
  • CSCSrvName=停止するHCSCサーバ名
  • ForceFlag=強制停止フラグ
    false:通常停止
    true:強制停止
HCSCサーバのセットアップ情報取得serverget_setup_info
  • CSCSrvName=HCSCサーバ名
HCSCサーバの情報取得serverget_info
  • CSCSrvName=状態表示するHCSCサーバ名
ビジネスプロセスの情報取得compoget_bp_info
  • CSCSrvName=HCSCサーバ名
  • AdapterName=ビジネスプロセスのサービスID
アダプタの情報取得compoget_adapter_info
  • CSCSrvName=HCSCサーバ名
  • AdapterName=サービスアダプタのサービスID
ユーザ定義受付の情報取得compo_urecpget_info
  • CSCSrvName=ユーザ定義受付の情報を取得するHCSCサーバ名
ユーザ定義受付の開始compo_urecpstart
  • CSCSrvName=ユーザ定義受付を開始するHCSCサーバ名
  • J2EESrvName=ユーザ定義受付を開始するJ2EEサーバ名
ユーザ定義受付の停止compo_urecpstop
  • CSCSrvName=ユーザ定義受付を停止するHCSCサーバ名
  • J2EESrvName=ユーザ定義受付を停止するJ2EEサーバ名

-propfile <プロパティファイル名> ~ ((1-200バイト))

引数を記述したプロパティファイル名を絶対パス,または相対パスで指定します。J2SEのプロパティファイル形式で指定します。

-binary <ファイル名> ~ ((1-200バイト))

バイナリ形式のファイル名を絶対パス,または相対パスで指定します。このオプションは将来使用するために定義されているオプションです。

入力例

(1)HCSCサーバHCSCを起動する場合

cscutil -user admin -pass admin -mng Manager -target server -operation start -props "CSCSrvName=HCSC, J2EESrvName=J2EEServer"

(2)プロパティファイルcscutil.propertiesを使用して,HCSCサーバHCSCを起動する場合

cscutil -user admin -pass admin -host 10.209.13.165:9001 -mnguser admin -mngpass admin -target server -operation start -propfile cscutil.properties

cscutil.propertiesの中身

 CSCSrvName=HCSC
 J2EESrvName=J2EEServer

戻り値

戻り値意味
0正常終了しました。
1コマンドが異常終了しました。
2通信タイムアウトが発生しました。
3排他エラーが発生しました。
9実行権限のチェックエラーが発生しました。

注意事項