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

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

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サーバが配備中)の場合,エラーになります。