Cosminexus サービスプラットフォーム　システム構築・運用ガイド

[目次][用語][索引][前へ][次へ]

cscutil（各種操作）

形式

 
cscutil [-h]
        -user <ログインユーザID>
        -pass <ログインパスワード>
        {-mng <Cosminexus Manager名>
          ｜-host <IPアドレス>:<ポート番号> -mnguser <管理ユーザID>
            [-mngpass <管理ユーザパスワード>]}
        -target {server｜compo｜compo_urecp｜request_service
          ｜connect_service｜connect}
        -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のマネージャ識別名を指定します。HCSCサーバ構成定義ファイルで指定したCosminexus Manager名を指定してください。

-host <ホスト名またはIPアドレス>：<ポート番号>　〜＜ホスト名またはIPアドレス：文字列，ポート番号：数字＞((文字列：1文字以上，ポート番号：1−65535))

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

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

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

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

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

-target {server｜compo｜compo_urecp｜request_service｜connect_service｜connect}

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

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

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

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

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

-targetオプション -operationオプション 操作内容
server start HCSCサーバの起動
compo start ビジネスプロセスの開始
compo start アダプタの開始
request_service start 標準受付の開始
connect_service start HCSCサーバ連携受付の開始
connect start HCSCサーバ連携の開始
connect stop HCSCサーバ連携の停止
connect_service stop HCSCサーバ連携受付の停止
request_service stop 標準受付の停止
compo stop アダプタの停止
compo stop ビジネスプロセスの停止
server stop HCSCサーバの停止
server get_setup_info HCSCサーバのセットアップ情報取得
server get_info HCSCサーバの情報取得
connect get_info HCSCサーバ連携の情報取得
compo get_bp_info ビジネスプロセスの情報取得
compo get_adapter_info アダプタの情報取得
compo_urecp get_info ユーザ定義受付の情報取得
compo_urecp start ユーザ定義受付の開始
compo_urecp stop ユーザ定義受付の停止

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

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

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

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

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

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

操作内容 -target -operation -propsで指定するプロパティ
HCSCサーバの起動 server start
  • J2EESrvName=HCSCサーバをセットアップしたJ2EEサーバ名
  • CSCSrvName=起動するHCSCサーバ名
ビジネスプロセスの開始 compo start
  • AdapterName=起動するビジネスプロセスのサービスID
  • ServiceKind=アダプタ種別
    bp：ビジネスプロセス
  • J2EESrvName=アダプタを起動するJ2EEサーバ名
  • CSCSrvName=アダプタを起動するHCSCサーバ名
アダプタの開始 compo start
  • AdapterName=起動するサービスアダプタのサービスID
  • ServiceKind=アダプタ種別
    serviceAdapter：サービスアダプタ
  • J2EESrvName=アダプタを起動するJ2EEサーバ名
  • CSCSrvName=アダプタを起動するHCSCサーバ名
標準受付の開始 request_service start
  • J2EESrvName=HCSCサーバが起動しているJ2EEサーバ名
  • CSCSrvName=リクエスト受付ができるHCSCサーバ名
HCSCサーバ連携受付の開始 connect_service start
  • J2EESrvName=J2EEサーバ名
  • CSCSrvName=連携受付を開始する連携元HCSCサーバ名
HCSCサーバ連携の開始 connect start
  • CSCSrvName=連携元HCSCサーバ名
  • ConnectClusterName=連携先クラスタ名
HCSCサーバ連携の停止 connect stop
  • CSCSrvName=対象HCSCサーバ名
  • ConnectClusterName=連携を終了する連携先クラスタ名
HCSCサーバ連携受付の停止 connect_service stop
  • J2EESrvName=インポートするJ2EEサーバ名
  • CSCSrvName=連携受付を停止する連携元HCSCサーバ名
  • OptionFlag=停止モード
    NORMAL_OPTION：通常停止
    WAIT_OPTION：オプション監視停止
標準受付の停止 request_service stop
  • J2EESrvName=インポートするJ2EEサーバ名
  • CSCSrvName=リクエスト抑止するHCSCサーバ名
  • ForceFlag=強制停止フラグ
    NORMAL_OPTION：通常停止
    WAIT_OPTION：計画停止
    FORCE_OPTION：強制停止
アダプタの停止 compo stop
  • J2EESrvName=アダプタを停止するJ2EEサーバ名
  • CSCSrvName=アダプタを停止するHCSCサーバ名
  • AdapterName=停止するサービスアダプタのサービスID
ビジネスプロセスの停止 compo stop
  • J2EESrvName=アダプタを停止するJ2EEサーバ名
  • CSCSrvName=アダプタを停止するHCSCサーバ名
  • AdapterName=停止するビジネスプロセスのサービスID
HCSCサーバの停止 server stop
  • J2EESrvName=HCSCサーバをセットアップしたJ2EEサーバ名
  • CSCSrvName=停止するHCSCサーバ名，
  • ForceFlag=強制停止フラグ
    false：通常停止
    true：強制停止
HCSCサーバのセットアップ情報取得 server get_setup_info
  • CSCSrvName=HCSCサーバ名
HCSCサーバの情報取得 server get_info
  • CSCSrvName=状態表示するHCSCサーバ名
HCSCサーバ連携の情報取得 connect get_info
  • CSCSrvName=連携状態を表示する連携元HCSCサーバ名
  • ConnectClusterName=連携先のクラスタ名
ビジネスプロセスの情報取得 compo get_bp_info
  • CSCSrvName=HCSCサーバ名
  • AdapterName=ビジネスプロセスのサービスID
アダプタの情報取得 compo get_adapter_info
  • CSCSrvName=HCSCサーバ名
  • AdapterName=サービスアダプタのサービスID
ユーザ定義受付の情報取得 compo_urecp get_info
  • CSCSrvName=ユーザ定義受付の情報を取得するHCSCサーバ名
ユーザ定義受付の開始 compo_urecp start
  • CSCSrvName=ユーザ定義受付を開始するHCSCサーバ名
  • J2EESrvName=ユーザ定義受付を開始するJ2EEサーバ名
ユーザ定義受付の停止 compo_urecp stop
  • CSCSrvName=ユーザ定義受付を停止するHCSCサーバ名
  • J2EESrvName=ユーザ定義受付を停止するJ2EEサーバ名

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

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

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

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

入力例

(1)HCSCサーバMyCSCを起動する場合
 
cscutil -user admin -pass admin -mng MyMNG -target server -operation start -props "CSCSrvName=MyCSC, J2EESrvName=MyServer"

(2)プロパティファイルcscutil.propertiesを使用して，HCSCサーバMyCSCを起動する場合
 
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=MyCSC
  J2EESrvName=MyServer

戻り値

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

注意事項

cscutilコマンドを実行する場合，参照機能（HCSCサーバ情報の参照など）は，複数同時に実行できます。

運用機能（HCSCサーバの起動やサービスアダプタの停止など）を複数同時に実行できません。

[目次][前へ][次へ]

[他社商品名称に関する表示]

All Rights Reserved. Copyright (C) 2006, 2008, Hitachi, Ltd.