コマンドを実行するために必要な条件を次に示します。

• HiRDBが起動している
• 「2.2　データベースサーバの構築」に従ってテーブルが作成されている
• 次に示す環境変数が設定されている
  PATHの設定
  
  • Cosminexus Driver for Javaライブラリの格納場所
    例：C:\Program Files\Hitachi\Cosminexus\DAB\lib
    
  • Javaの格納場所
    例：C:\Program Files\Hitachi\Cosminexus\jdk\bin
    
  • データベースクライアントライブラリの格納場所
    例：C:\Program Files\Hitachi\HiRDB\utl
    
  CLASSPATHの設定
  
  • JDBCドライバの絶対パス名
    例：C:\Program Files\Hitachi\Cosminexus\DABJ\JdbcDbpsv.jar
    
  • HNTRLib2の絶対パス名
    例：C:\Program Files\Hitachi\HNTRLib2\classes\hntrlib2j.jar
    
  • Collaboration - Online Community Management用jarの絶対パス名
    例：C:\Program Files\Hitachi\Collaboration\community\command\lib\hptl_clb_ccm_cmd.jar
    
  • Collaboration - Online Community Managementコマンド用プロパティファイル格納場所のディレクトリの絶対パス名
    例：C:\Program Files\Hitachi\Collaboration\community\command\conf
    
  なお，異なるディレクトリに同じ名称のディレクトリやファイルが存在し，それらが共にPATHやCLASSPATHに設定されていた場合，OSの制御によって，どちらが優先されるかが決まります。したがって，同じディレクトリ名およびファイル名が設定されている場合は注意が必要です。
  これらの環境変数の設定例を記述したバッチファイルを次のディレクトリに用意してあります。
  <Collaboration - Serverインストールディレクトリ>\community\command\sample\sample.bat
  

オプションを指定する際の規則

各コマンドのオプションは，次の規則に従って指定できます。

• 複数指定できます。複数ある場合，どのような順でも指定できます。
• 同一オプションを複数指定した場合，最後に指定したオプションが有効になります。
• 省略できます。
• オプションの文字列は，大文字と小文字が区別されます。ただし，Windows版の場合，ファイル名の大文字と小文字は区別されません。
• ディレクトリ名およびファイル名に半角スペースが含まれる場合は，ファイルのパス全体を「"（半角引用符）」で囲みます。
  例："C:\\Program△files・・・"
  注：△は半角スペースを示します。
  
• コマンドの引数や定義ファイル中に定義するファイル名に使用できる文字を次に示します。下記以外の文字を指定した場合，動作は保証されません。
  半角英数字
  全角文字
  「\」(半角円記号)
  「"」(半角引用符)
  「:」(半角コロン)
  半角スペース
  

  注意

  ファイル名は，使用するOSのファイルシステムの規則に従って指定してください。OSのファイルシステムで許可されていないファイル名を指定した場合，動作は保証されません。

オプションの指定方法の表示

オプションの指定を誤ってコマンドを実行すると，オプションの指定方法が標準エラー出力に出力されます。

ファイル名の規則

-oオプションには，出力ファイルのファイル名を絶対パス，またはコマンドを実行するディレクトリからの相対パスで指定します。ファイル名は，220バイト以内の文字列で指定します。ただし，絶対パスで表したときに220バイト以内の文字列になるように指定してください。

-oオプションに指定したディレクトリおよび出力ファイルが存在しない場合

指定したディレクトリおよび出力ファイルが新規に作成されます。

-oオプションに指定したファイルがすでに存在する場合

次のファイル名で，出力ファイルが新規に作成されます。

aaa_bbb_yyyyMMdd_HHmmss.ccc

文字列の意味

aaa：-oオプションに指定したファイル名から拡張子を除いた文字列

bbb：コマンド名

yyyy：実行日付（年）

MM：実行日付（月）

dd：実行日付（日）

HH：実行時刻（時）

mm：実行時刻（分）

ss：実行時刻（秒）

ccc：-oオプションに指定したファイル名の拡張子

例

-oオプションに指定した出力ファイルのファイル名が「output.log」，コマンドの実行日時が「2003年12月31日20:32:10」の場合，新規に作成される出力ファイルのファイル名は，次のようになります。

output_コマンド名_20031231_203210.log

-oオプションに指定した出力ファイルに出力される情報

-oオプションに指定した出力ファイルには，標準出力に出力されるデータおよび標準エラー出力に出力されるデータが出力されます。

ファイル名の規則

-eオプションには，ログファイルのファイル名を絶対パス，またはコマンドを実行するディレクトリからの相対パスで指定します。ファイル名は，220バイト以内の文字列で指定します。ただし，絶対パスで表したときに220バイト以内の文字列になるように指定してください。

-eオプションに指定したディレクトリおよびファイルが存在しない場合

指定したディレクトリおよびファイルが新規に作成されます。

-eオプションに指定したログファイルがすでに存在する場合

次のファイル名で，ログファイルが新規に作成されます。

aaa_bbb_yyyyMMdd_HHmmss.ccc

文字列の意味

aaa：-eオプションに指定したファイル名から拡張子を除いた文字列

bbb：コマンド名

yyyy：実行日付（年）

MM：実行日付（月）

dd：実行日付（日）

HH：実行時刻（時）

mm：実行時刻（分）

ss：実行時刻（秒）

ccc：-eオプションに指定したファイル名の拡張子

例

-eオプションに指定したログファイルのファイル名が「error.log」，コマンドの実行日時が「2003年12月31日20:32:10」の場合，新規に作成されるログファイルのファイル名は，次のようになります。

error_コマンド名_20031231_203210.log

-eオプションを省略した場合

コマンドプロパティファイル（hptl_clb_ccm_cmd.properties）のhptl_clb_ccm_cmd_logfileキーに指定された値が，ログファイルのファイル名となります。ただし，この値と同じファイル名のファイルがすでに存在するときは，ログファイルのファイル名は，次のようになります。

aaa_bbb_yyyyMMdd_HHmmss.ccc

文字列の意味

aaa：コマンドプロパティファイル（hptl_clb_ccm_cmd.properties）のhptl_clb_ccm_cmd_logfileキーに指定された値から，拡張子を除いた文字列

bbb：コマンド名

yyyy：実行日付（年）

MM：実行日付（月）

dd：実行日付（日）

HH：実行時刻（時）

mm：実行時刻（分）

ss：実行時刻（秒）

ccc：コマンドプロパティファイル（hptl_clb_ccm_cmd.properties）のhptl_clb_ccm_cmd_logfileキーに指定された値の拡張子

例

hptl_clb_ccm_cmd_logfileキーに指定したログファイルのファイル名が「error.log」，コマンドの実行日時が「2003年12月31日20:32:10」の場合，新規に作成されるログファイルのファイル名は，次のようになります。

error_コマンド名_20031231_203210.log

-eオプションが省略されていてhptl_clb_ccm_cmd_logfileキーが指定されていない場合

プログラムのデフォルトである「error.log」がファイル名となります。ただし，カレントディレクトリに「error.log」という名前のファイルがすでに存在する場合は，「error_コマンド名_実行日付_実行時刻.log」となります。

例

コマンドの実行日時が「2003年12月31日20:32:10」の場合，新規に作成されるログファイルのファイル名は，次のようになります。

error_コマンド名_20031231_203210.log

コマンドを実行する際は，Collaboration - Online Community Managementをインストールしたマシンで実行します。set_memberコマンドの-sオプションを指定する場合は，Collaboration - Online Community Management，Collaboration - Directory Access，およびCollaboration - Common Utilityをインストールしたマシン上で実行します。

コマンドの実行時にはデータベースと接続するために，ユーザ名およびパスワードを入力する必要があります。Windowsのコマンドプロンプトで入力するユーザ名およびパスワードに使える文字はASCII文字の英大文字，数字および英小文字だけです。

手順

1. Windowsのコマンドプロンプトでコマンドを実行します。
2. 「Database User Name：」と表示されるのでユーザ名を入力して，［Enter］キーを押します。
   ユーザ名に「"（半角引用符）」を使用する場合は，エスケープ文字として「\（半角円記号）」を付けます。例えば，ユーザ名として「"root"」を入力する場合は，「\"root\"」と入力します。
   
3. 「Password:」と表示されるのでパスワードを入力し，［Enter］キーを押します。
   パスワードは，入力しても画面には表示されません。パスワードの場合もユーザ名と同様に「"（半角引用符）」を使用する場合は，エスケープ文字として「\」を付けます。
   

• コマンドの中断
  キー割り込みなどによって強制終了された場合の戻り値などの動作は保証されません。なお，強制終了された場合は，データベースのコネクションが保持されたままの状態となることがあるので注意が必要です。
  
• コマンドの二重実行
  Collaboration - Online Community Managementで提供しているコマンドを二重に実行するとエラーになり，コマンドの実行が中止されます。例えば，set_memberコマンドの実行中に同じset_memberコマンドを実行したり，set_memberコマンドの実行中にset_applicationコマンドを実行したりするとエラーになります。
  
• ユーザアカウント制御（UAC）
  ユーザアカウント制御（UAC）が有効に設定されている場合，コマンドの実行時にユーザアカウント制御のダイアログが表示されることがあります。コマンドは管理者権限で実行する必要があるため，ダイアログの［続行］ボタンをクリックしてコマンドを実行してください。