About this task
To extend the configuration management
interface, use the four properties available, one for each definable
button, located under ConfigurationManagement::General::UserDefCommand_1 through UserDefCommand_4.
Items selected from the Configuration Items window
are passed as arguments. Rational Rhapsody expands
the keywords for each item selected in the Configuration Items list.
The format of the property is as follows:
Command ["ARG=
[$Path|$Ver|$Archive][additional_parameters]"]
[additional_parameters]
The keywords are as follows:
- $Path for full path + file name
- $Ver for Version
- $Archive for Archive session‑specific
string. This applies only to SCC model; it is empty in batch mode.
Note: Rational Rhapsody does
not know if the operation completed successfully. The standard timeout
applies in the case of a hanging script.
For
example:
- To run the IBM Rational ClearCase® version
tree on a selected item, set the property to the following value:
start cleartool.exe lsvtree -graph "ARG= $Path"
- To execute a batch file that uses the full path,
version number, and archive string of a list of units, set the property
as follows:
mycommand.bat "ARG= $Path, $Ver, $Archive ;"
Note: Activating various tools from a property
is operating system‑dependent. On Windows NT, use the following command:
start notepad.exe