set_roleロールの追加

機能

システムに共通の役割の定義内容をデータベースのコミュニティロールテーブル(TBL_COMMUROLE)に設定します。2回目以降の実行時には,設定内容を上書きします。上書きする際に,対応するロール情報がメンバロールテーブル(TBL_MEMBERROLE)にある場合は,同時に更新します。

形式

set_role [-o 出力ファイル名] [-q] [-e ログファイル名] [-f 共通の役割定義ファイル名]

オプション

-o 出力ファイル名
指定したファイルに,標準出力データを出力します。ただし,出力メッセージのうち,KDCM00071-E~KDCM00076-Eは出力しません。
出力ファイル名の指定方法の詳細は,「5.2(3)-oオプションに指定する出力ファイル」を参照してください。
-q
標準出力および標準エラー出力への出力を抑制します。
-e ログファイル名
指定したログファイルに,次の情報を出力します。
  • SQLクエリ発行直前および発行直後のSQLクエリ文字列
  • SQLクエリ発行時のエラーメッセージ
ログファイル名の指定方法の詳細は,「5.2(4)-eオプションに指定するログファイル」を参照してください。
-f 共通の役割定義ファイル名
共通の役割定義ファイル(set_role.cfg)に定義されている内容をデータベースのコミュニティロールテーブル(TBL_COMMUROLE)に設定します。
ファイル名の指定方法
共通の役割定義ファイルのファイル名は,絶対パス,またはコマンドを実行するディレクトリからの相対パスで指定します。ファイル名は,220バイト以内の文字列で指定します。ただし,絶対パスで表したときに220バイト以内の文字列になるように指定してください。
ファイルの記述形式
共通の役割定義ファイルの記述形式については,「7.2.5 共通の役割定義ファイル(set_role.cfg)」を参照してください。
サンプルファイルの利用
共通の役割定義ファイルには,サンプルファイル(set_role.cfg.sam)を利用します。サンプルファイルの内容を変更しないで,ファイル名を「set_role.cfg」に変更して保存してください。
-fオプションを省略した場合
デフォルトの共通の役割定義ファイルに定義されている内容が設定されます。デフォルトの共通の役割定義ファイル名は,コマンドプロパティファイル(hptl_clb_ccm_cmd.properties)のhptl_clb_ccm_cmd_set_role_configキーに指定された値となります。
-fオプションを省略しhptl_clb_ccm_cmd_set_role_configキーを指定していない場合
共通の役割定義ファイル名は,プログラムのデフォルトである「set_role.cfg」となります。

戻り値

set_roleコマンドの戻り値を次に示します。

表5-6 set_roleコマンドの戻り値

戻り値意味
0正常終了しました。
1ユーザによる強制終了が発生したか,またはコマンド用jarが見つかりません。
2指定した共通の役割定義ファイル,またはhptl_clb_ccm_cmd.propertiesが見つかりません。
出力ファイル,またはログファイルを生成できません。
12出力ファイル名,ログファイル名,または共通の役割定義ファイル名が長過ぎます。
13共通の役割定義ファイルの書式にエラーがあります。
14共通の役割定義ファイル,またはhptl_clb_ccm_cmd.propertiesの属性値が適切な範囲にありません。
21データベースからの応答がありません。
22データベースへの接続に失敗しました。
23SQLクエリの実行に失敗しました。
24JDBCドライバがインストールされていません。または,パスが通っていません。
31入出力処理中にエラーが発生しました。
32トレース処理中にエラーが発生しました。
33コマンドの書式が違います。
34システム情報の取得に失敗しました。
35nullが指定されました。
36内部矛盾が発生しました。
39次の意味が考えられます。
  • コマンドが実行できる状態ではありません。
  • 環境変数が設定されていません。
  • システムコールでエラーが発生しました。

実行結果

指定した値がデータベースのコミュニティロールテーブル(TBL_COMMUROLE)に設定されます。また,メンバロールテーブル(TBL_MEMBERROLE)の対応する情報が更新されます。

使用例

set_roleコマンドの使用例を紹介します。ここでは,次のような環境を想定しています。

共通の役割定義ファイルの内容をコミュニティロールテーブルに登録する場合
共通の役割定義ファイルの内容をデータベースのコミュニティロールテーブル(TBL_COMMUROLE)に登録する場合,set_roleコマンドを次のように実行します。
set_role
-e "C:¥Program Files¥Hitachi¥Collaboration¥community¥command¥log¥set_role.log"
-f "C:¥Program Files¥Hitachi¥Collaboration¥community¥command¥sys¥set_role.cfg"
この実行例では,set_roleを実行すると,エラーログがある場合は-eオプションで指定したログファイル(set_role.log)に出力されます。
実行例は改行されているように表示されていますが,実際に実行するときは,1行で記述する必要があります。
標準出力に何も出力しない場合
ログをデフォルトのログファイルに出力する場合,set_roleコマンドを次のように実行します。
set_role -q
この実行例は,あらかじめコマンドプロパティファイル(hptl_clb_ccm_cmd.properties)のhptl_clb_ccm_cmd_logfileキーの設定値に,ログファイルとしてC:¥Program Files¥Hitachi¥Collaboration¥community¥log¥error_set_role.logを指定していることを想定しています。

注意事項