cscsvcctlサービス情報の管理

形式

cscsvcctl [-h]
         -user <ログインユーザID>
         -pass <ログインパスワード>
         {-getfile <サービス情報変更定義ファイル名>
          |-setfile <サービス情報変更定義ファイル名>
          |-cluster <クラスタ名>
          -name <サービスアダプタのサービスID>
          -props <プロパティ>}

機能

cscsvcctlコマンドには,次に示す機能があります。

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

引数

-h

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

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

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

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

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

-getfile <サービス情報変更定義ファイル名> ((1-200バイト))

出力するサービス情報変更定義ファイル名を指定します。絶対パスまたは相対パスで指定します。指定したファイルまでのディレクトリがない場合,異常終了します。指定したファイルがすでにある場合,上書きされます。指定したファイル名と同名のディレクトリがある場合は,異常終了します。

-setfile <サービス情報変更定義ファイル名> ((1-200バイト))

入力するサービス情報変更定義ファイル名を指定します。絶対パスまたは相対パスで指定します。指定したファイルがない場合,異常終了します。

-cluster <クラスタ名> ~<半角英数字およびアンダーライン(_)> ((1-8文字))

サービス情報を変更するサービスアダプタがあるクラスタ名を指定します。

-name <サービスアダプタのサービスID> ~((1文字以上))

サービス情報を変更するサービスアダプタのサービスIDを指定します。

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

操作対象に渡す情報を<key>=<value>形式で指定します。<key>はサービス情報表示コマンド(cscsvcls)で表示されるキー名を使用します。指定値はダブルクォーテーション(")で囲みます。また,-nameオプションで指定したアダプタに関するサービス情報であれば複数指定できます。複数指定する場合,指定値をコンマ(,)で区切ります(例:-props "a=b,c=d")。なお,サービス情報表示コマンド(cscsvcls)で確認したLocalCallの値がfalseの場合はtrueへ変更しないでください。

入力例

(1)サービス情報変更定義ファイルを出力する場合

cscsvcctl -getfile service_info.txt

(2)サービス情報変更定義ファイルを入力し,サービス情報の変更を設定する場合

cscsvcctl -setfile service_info.txt

(3)サービス情報変更定義ファイルを使用せずに,サービス情報の変更を設定する場合

cscsvcctl -cluster MyUnit -name adapter1 -props "Url=aaa,ReadTimeout=60"

戻り値

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

注意事項

-setfileや-nameオプションで指定したサービスアダプタが配備中(HCSCサーバがクラスタ構成の場合,クラスタ内のHCSCサーバが配備中)の場合,エラーになります。