This page is my own personal work. Anyone can use it for their own edification, but must realize that this material is not supported by me and the site is not affiliated with IBM Rational Software or Atlassian.
Create an activity.
# ct mkact activity-nameThe activity-name is not mandatory, but it's recommended that you give the activity a nice mnemonic name, otherwise CC will choose a difficult name, such as activity000622.202648.
-hea.line Descriptive title. | Give the activity a title other than its name as the default. |
-in stream-name | Specify the stream name, if not in the development view you wish to associate with the activity. |
-nset | Do not set to the new activity. |
-force | If no acitivity-name is given, CC won't ask for confirmation before generating its own. |
Set an activity.
# ct lsact -cview # ct setact activity-name
Change or unset an activity associated with a view.
# If inside the view: ct setact -none # otherwise: ct setact -view-none
Remove an activity.
# ct rmact activity-nameTable of Contents
List activities.
# ct lsact [ option(s) ] [ activity ]Options:
-s.hort | List only the activity names. |
-l.ong | Display a detailed description of each activity. |
-fmt format-string | Format the output to taste. See the fmt_ccase reference page. |
-anc.estor [ -dep.th integer ] | Display the stream, project, folder tree to an optional depth of integer. |
-inv.ob vob:vob-tag | Specify a PVOB other than the default one. |
-in stream | List activities associated with stream. |
-cac.t | List the currently set activity. |
-vie.w view-tag | List the activities associated with the specified view. |
-cvi.ew | List the activities associated with the current view. |
-obs.olete | New in CC 4.2, also list those activities that have been locked and obsoleted. |
-contrib | New in CC 5.0/2002, list the activities that contributed to an integration's deliver activity. |
-me | New in CC 2003.06.00. Display activities owned by the current user. |
-user username | New in CC 2003.06.00. Display activities owned by the designated user. |
Modify an activity's parameters.
# ct chactivity option(s)Options:
-hea.dline headline activity | Modify the headline. Does not affect the activity's ID name. |
-fcs.et from-activity -tcs.et to-activity version(s)[,...] | Move version(s) from from-activity to to-activity in the same stream. |
-vie.w viewtag | New in CC 2003.06.00. Change the activity in the specified view. |
-cqact.ion { -cac.t | activity-selector } | New in CC 2003.06.00. Check in all versions and close CQ ticket if policy is set. See note below. |
Rename an activity.
# ct rename activity:old-name new-name # ct chactivity -headline "new headline" new-name
Lock an activity.
# ct lock activity:activity-nameTable of Contents
Move an activity between streams or projects.
Determine/find undelivered activities.
# ct deliver -preview -s
Set a CQ activity in a non-GUI environment.
# ct setact datab00000678Table of Contents
Deliver an activity to a non-default target.
Share an activity.
List all activities associated with an element.
# ct lshistory -fmt "%[activity]p\n" element | ccperl -e "foreach $activity (Table of Contents) {$index{$activity}++;}; print STDOUT sort keys (%index);"
Find the activities delivered as part of a deliver opertation.
Compare a version with its change set predecessor.
Clean out old activities. Obsolete an activity.
# ct lock -obsolete activity:activity-name@pvobtag Ex: ct lock -obsolete activity:add_gui_button@/vobs/widget_pvob
Finish an activity. Updated: 09/16/06
Determine an activity's change set. Updated: 11/30/11
use Win32::OLE; $CCApp = Win32::OLE->new("ClearCase.Application"); $activityObj = $CCApp->Activity($ucm_vob_object); $viewObj = $activityObj->NameResolverView; $versionsCol = $activityObj->ChangeSet($viewObj,"False");
Limit the use of a CQ Activity to the Owner (Assignee). Updated: 05/10/12
Reassign a CQ Activity. Updated: 05/10/12
ct setact -view view-tag -noneTable of Contents
View an Activity's change set in a CQ query. Updated: 06/13/12
Programmatically determine what activity was used to create a given version. Updated: 09/06/12
# ct describe -fmt "%[activity]p" elementTable of Contents
Create a baseline.
# ct mkbl baseline-nameOptions:
-vie.w view-tag | Make the baseline in the stream associated with view-tag. |
-com.ponent component-name[,...] | Baseline the specified component(s). |
-all | Baseline all components that have changed since the Full baseline. |
-ide.ntical | Baseline all components in the project even if they haven't changed. |
-act.ivities activity(s)[,...] | All activities are included in the baseline unless a subset is specified. |
-nlabel | Do not label the baseline. Cannot use as a foundation baseline, but can diffbl. |
-inc.remental | Label only the versions that have changed since the last Full baseline. |
-fu.ll | Label all versions visible in the view below the components root directory. |
-imp.ort label | Baseline based on versions marked by the specified label. |
-ade.pends_on dependent-component-selector | New in CC 5.0/2002, make -component a dependent of dependent-component-selector for composite baselines. |
-dde.pends_on dependent-component-selector | New in CC 5.0/2002, remove -component as a dependent of dependent-component-selector for composite baselines. |
-nac.t | New in CC 5.0/2002, make a baseline in -component. |
-vie.w viewtag | New in CC 2003.06.00. Specify the view from which to make the new baseline. |
Remove a baseline.
# ct rmbl baseline
List baselines.
# ct lsbl option(s)
Modify a baseline's parameters.
# ct chbl option baseline-nameOptions:
-inc.remental | Change the baseline's labeling status so that only versions that have changed since the last baseline get an incremental label. |
-fu.ll | Change the baseline's labeling status so that all versions selected by the view get a new label. |
-level level | Set the baseline's promotion level to level. |
-nre.curse | New in CC 5.0/2002. Apply the change to the composite baseline only and not its members. |
Diff baselines.
# ct diffbl object1 object2Options:
-act.ivities | Display differences in terms of activities. |
-ver.sions | Display differences in terms of versions. |
-fir.st_only | Only show the changes that appear in object1 |
-bas.elines | New in CC 5.0/2002, display differences in terms of baselines when diffing composite baselines. |
-nre.curse | New in CC 5.0/2002, show differences between composite baselines themselves. |
-nmerge | New in CC 2003.06.00. When diffing baselines, reports only activity and version changes to the same stream. |
Rebase
# ct setcs -stream
Rebase graphically. # ct rebase -graphical Cancel or get the status of a rebase. # ct rebase { -cancel | -status } Begin a rebase (see options below). # ct rebase Resume or complete a rebase. # ct rebase { -complete | -resume [ -complete ] }Rebase options:
-vie.w development-view-tag | Rebase the specified view. |
-pre.view [ -l.ong | -s.hort ] | Only display what would have happened in the rebase. |
-rec.ommended | Use the recommended baseline as the source to update your work area. |
-bas.line baseline-name(s)[,...] | Specify one or more baselines from which to rebase. |
-dba.seline baseline-name(s)[,...] | Specify one or more baselines to delete from the stream. |
-f.orce | Suppress the confirmation step. |
-str.eam stream-selector | New in CC 5.0/2002, specify the stream to be rebased. |
Import a label on which to baseline.
ct mkbl -import label baseline-name -or- ct mkbl -nc -import -component component-selector label-type-selectorTable of Contents
Customize baseline promotion levels.
# ct setplevel -default default-level level-order ex: ct setplevel -default BUILT REJECTED INITIAL BUILT TESTED QAED RELEASEDTable of Contents
Rename a baseline.
# ct rename baseline:old-baseline-name new-baseline-name
# ct describe -l baseline:new-baseline-name # ct rename lbtype:old-label-name new-label-name
# ct rmhlink UseBaseline@OID
Lock a baseline.
# ct lock -obsolete baseline:baseline-name
Determine which streams are referencing a baseline.
# ct lsbl -tree baselineTable of Contents
Promote a baseline.
# cd \pvob # ct lsproject -s # ct lsstream -s -in project # ct lsbl -s -stream stream # ct chbl -level new-level baselineTable of Contents
Determine/set a project's recommended baseline promotion level.
Determine the project's recommended promotion level.
# ct lsproj -l project-name or more specifically # ct describe -fmt "%[def_rebase_level]p\n" project-nameSet the project's recommended promotion level.
# ct chproject -rebase_level promotion-level project-nameTable of Contents
Determine a stream's latest baseline.
ct lsstream -fmt "%[latest_bls]p" stream-selectorTable of Contents
Create a composite baseline.
ct describe -fmt "%[components]CXp" stream-selector ct mkbl -component composite-bl-component -adepends_on all-other-components-comma-separated new-bl-name
Recommend a baseline.
ct chstream -recommended baseline-name stream-selector
ct chstream -recommended -default stream-selectorTable of Contents
Change a project's foundation baseline for a component.
Browse component baselines.
# clearcomptreeTable of Contents
Deliver a baseline
Determine the label type associated with a baseline
ct describe baseline:baseline-name@pvob-tagTable of Contents
Determine a composite baseline's dependent baseline heirarchy.
ct describe baseline:baseline-name@pvob
General UCM integration
Remove the CC-UCM/CQ integration
crmregister remove -database db-logical-name crmregister remove -all
Set CC-UCM/CQ integration policies.
Ensure UCM activities are linked to CQ records.
# ct chproject -crmenableTo ensure a single activity is linked, use the undocumented squid_patch command that lives in cc-home\etc\utils:
# squid_patch cq-db-name -activity cq-record-id -refreshSee "Ensure all activities are unlinked" for the opposite case.
UCM enable a CQ schema.
State Type | Description | State examples |
Waiting | Not yet assigned. | Submitted, Postponed |
Ready | Assigned but not being worked yet. | Assigned |
Active | Work is ongoing. | Opened |
Complete | Work is complete or ticket is abandoned. | Resolved, Closed, Duplicate |
Ensure all activities are unlinked.
# ct chproject -ncrmenableSee "Ensure UCM activities are linked to CQ records" for the opposite case.
Connect a UCM project to a CQ db in a different master db.
# setenv SQUID_DBSET dbset_nameTable of Contents
Use a record type other than UCMUtilityActivity when connecting an existing UCM project to CQ.
Refresh a CQ UCM_Project record that is linked to a CC project.
# squid_patch cq-db-name -project project-name -refresh
Display link information.
CC project link to CQ UCM_Project (if ok, will show "UCM_Project") # pvarutil -pvob pvob-tag -object project:project-name@pvob-tag SQUID_PROJ_ENTITYDEF_NAME CQ UCM_Project link to CC project (if ok, will show CC project oid, title, and name) # squid_patch cq-db-name -project project-name ucm_vob_object CC activity link to CQ record (if ok, will show CQ record type and record number) # pvarutil -pvob pvob-tag -object activity:activity-name@pvob-tag SQUID_ACT_ENTITYDEF_NAME SQUID_ACT_DISPLAY_NAME CQ record link to CC activity (if ok, will show activity title and name) # squid_patch cq-db-name -activity record-ID ucm_vob_objectTable of Contents
Repair links.
CC project link to CQ UCM_Project # pvarutil -pvob pvob-tag -object project:project-name@pvob-tag SQUID_PROJ_ENTITYDEF_NAME=UCM_Project CQ UCM_Project link to CC project # squid_patch cq-db-name -project project-name ucm_vob_object project:project-name@pvob-tag CC activity link to CQ record # pvarutil -pvob pvob-tag -object activity:activity-name@pvob-tag SQUID_ACT_ENTITYDEF_NAME=record-type name SQUID_ACT_DISPLAY_NAME=record-ID CQ record link to CC activity # squid_patch cq-db-name -activity record-ID ucm_vob_object activity:activity-name@pvob-tagTable of Contents
Remove links.
CC project link to CQ UCM_Project # pvarutil -pvob pvob-tag -object project:project-name@pvob-tag SQUID_PROJ_ENTITYDEF_NAME= CQ UCM_Project link to CC project # squid_patch cq-db-name -project project-name ucm_vob_object "" CC activity link to CQ record # pvarutil -pvob pvob-tag -object activity:activity-name@pvob-tag SQUID_ACT_ENTITYDEF_NAME= SQUID_ACT_DISPLAY_NAME= CQ record link to CC activity # squid_patch cq-db-name -activity record-ID ucm_vob_object ""Table of Contents
Connect a UCM Project to multiple CQ databases.
Create a component.
# ct mkcomp -root root-pname component-name@PVOBtag ex: single component VOB # ct mkcomp -root /vobs/myvob mycomponent@/vobs/mypvob --or-- ex: multiple component VOB # cd /vobs/myvob # ct mkcomp -root component1_rootdir component1_name@/vobs/mypvob # ct mkcomp -root component2_rootdir component2_name@/vobs/mypvobOptionally, you can use "-nroot" instead of "-root". The -nroot option creates a component whose sole purpose is to house composite baselines (CC 5.0/2002+) and cannot contain any elements.
Remove a component.
# ct rmcomp component
Table of Contents Table of Contents
List components.
# ct lscomp If not in a PVOB: # ct lscomp -invob PVOB-tagSome useful options:
-s.hort | Limit the listing to component names only. |
-l.ong | Include owner and group and in the listing. |
-fmt format-string | Format the output to taste. See the fmt_ccase reference page. |
-tre.e | Recursively list baselines and streams in the components. |
-obsolete | Also list those components that have been locked and obsoleted. (new in 4.2) |
Make a UCM component from an existing CC VOB.
Add the component to a project as modifiable.
# ct lscomp -s # ct lsproj -s # ct chproject -amodcomp component project
Add the component to a project as read-only.
element * /main/0 -ucm -nocheckoutTable of Contents
Rename a component.
# ct rename component:old-name new-name
Share a component between PVOBs.
# ct mkhlink AdminVOB vob:\pvob1-tag vob:\pvob2-tagTable of Contents
Create a component without a VOB (rootless).
Split a VOB-level component into separate components.