ccm baseline -c|-create [(-p|-project project_spec)...]
[(-bl|-baseline baseline_spec)...]
[(-pg|-project_grouping project_grouping_spec)...]
[-rehearse] [-r|-release release_spec] [-purpose purpose]
[-d|-desc|-description description]
[-vt|-version_template version_template] [-b|-build build]
[-s|-state state] ([-subprojects] | [-all_subprojects] |
[-no_subprojects])
([-cpu|-check_project_update] | [-nocpu|-nocheck_project_update])
[baseline_name]
–subprojects、-no_subprojects、–all_subprojects を使用すると、どのサブプロジェクトが追加されるかに影響します。
デフォルトでは、–baseline を使用し、–project を使用しない場合、サブプロジェクトは含まれません。しかし、–project と –baseline の両方を使用した場合、–project が暗黙的に指示する –subprojects のデフォルト値が、–baseline が暗黙的に指示する –no_subprojects のデフォルト値よりも優先されます。
baseline_name を指定しない場合、固有の名前がベースラインに自動的に割り当てられます。このデフォルト名の形式は、yyyymmdd です。必要に応じて、デフォルト名の後に下線と増分番号を付けて固有の名前にします。例えば、2002 年 4 月 1 日に作成された 1 番目のベースラインのデフォルト名は 20020401 です。同じ日に作成された 2 番目のベースラインのデフォルト名は、20020401_1 になります。
-project_grouping または -baseline が指定されていない場合、デフォルトは
-subprojects です。
-project_grouping または -baseline を指定した場合、デフォルトは -no_sub_projects です。
–subprojects、-no_subprojects、および –all_subprojects オプションは、どのサブプロジェクトがプロジェクト・グルーピングと共に追加されるかに影響します。
purpose は、プロジェクトの用途を指定する設定です (例えば、Insulated Development、Integration Testing、System Testing など)。
-purpose を指定した場合は、-release も指定する必要があります。
バージョン・コンフリクトが発生した場合、競合しているすべてのプロダクトとプロジェクトが警告に示されます。作成されたバージョンが新しいベースラインに存在する場合、または正当なバージョン・ストリングでない場合に、コンフリクトが発生します。
-release を指定した場合は、-purpose も指定する必要があります。
released 状態でベースラインを作成することは、published_baseline 状態でベースラインを作成してからリリースすることと同じです。
このオプションは、-project、-project_grouping、および
-baseline オプションを使用して追加されたプロジェクトに適用されます。これは、-project_grouping または
-baseline が指定されていない場合の、デフォルトの動作になります。-project_grouping または -baseline が指定されている場合、デフォルトは -no_subprojects です。
version_template は、%keyword または %{keyword} という形式のオプションのキーワードを含む任意のストリングです。このキーワードには、任意の Rational Synergy 属性または組み込みキーワードを使用できます。
属性を展開するとき、検査対象のビルド管理プロジェクトまたはプロダクトの対応する属性値が使用されます。指定されたキーワード名に属性または組み込みキーワードが見つからない場合、キーワードは空のストリングに置き換わります。
ベースライン内の任意のプロジェクトまたはプロダクトの、インスタンス化された version_template に、バージョン・ストリングで使用が認められていない文字が含まれている場合、それらの文字はデフォルトのバージョン・ストリング置換文字に置き換えられます。この設定は、baseline_template_repl_char オプションを使用してサーバーの ccm.ini ファイルで指定されます。この文字のデフォルトは下線 (_) です。例えば、%platform がバージョン・テンプレートに含まれており、ビルド管理プロジェクトのプラットフォームが SPARC-solaris である場合、バージョン・ストリングにはストリング SPARC_solaris が含まれます。あるいは、%release がプロダクトのバージョン・テンプレートに含まれており、prep プロダクトのリリースが CM/6.5 である場合、バージョン・ストリングにはストリング CM_6.5 が含まれます。
ベースライン内の任意のプロジェクトまたはプロダクトの、インスタンス化された version_template が、そのプロジェクトまたはプロダクトの別のバージョンで既に使用されている場合、下線 (_) と、バージョンを固有にする最初の整数 (1 から始まる) を付加することによって、バージョンは固有になります。これによってバージョン・ストリングが長くなりすぎる場合は、現在の日付に基づくバージョンが、そのプロジェクトまたはプロダクトに使用され、警告が表示されます。
–version_template を指定しない場合、デフォルト・テンプレートが使用されます。詳しくは、『baseline コマンド』の「バージョン・テンプレート仕様」を参照してください。
プロジェクトのワークエリア・テンプレートにそのバージョンが含まれている場合、ワークエリアは更新されます。ワークエリアが可視ではないためにワークエリアを更新できず、-skip_nonvisible_projects が使用されていない場合、操作は続行されて、すべてのエラーが報告されます。ワークエリアが可視であるが、他の理由 (適切なファイルのアクセス権限が欠如、またはディスク領域の不足など) で更新できない場合、操作は続行されますが、すべての障害が報告されます。
ccm baseline -c Build_1234_int -d "Integration build 1234" -r 2.0 -purpose "Integration Testing" -project proj1-sqa_3 -subprojects