Keyword expansion in batch mode

When doing configuration management operations in batch mode, IBM® Rational® Rhapsody® expands keywords.

The following table lists the keywords and their expansion:

Table 1. Keywords and their expansion
Administrative Keywords
Keyword Name Expanded to Comments
$Operation The name of the configuration management operation being executed by Rational Rhapsody Displays in CMOperationStartSeparator & CMOperationEndSeparator
$Time The current system time  
$Date The current system date  
$User The logged in user name  
$temp The current system temporary directory as specified in the TEMP environment variable  
$OMROOT The value of OMROOT as loaded into Rational Rhapsody (most likely from the .ini file)  
$projectname The name of the Rational Rhapsody project  
Directories, paths, file names
Keyword Name Expanded to Comments
$projectunitdirname Project unit directory name (_rpy). This is not the full path to the unit directory, but just the name of the directory. This keyword is different from the $rhpdirectory, which expands to full path to the project unit directory.
$FileName Repository file specified during connect to archive operation.  
$fulldir Name of the configuration management shadow directory to be created in the archive To be used in $MakeCMShadowDir property.
$parentdir The name of the parent directory of the configuration management shadow directory to be created in the archive  
$rhpdirectory Name of the project units directory (_rpy)  
$SubDirs Show the subdirectory of a configuration management unit under its archive root directory.  
$targetDir Name of the directory where the file is put during Fetch operation  
$unit Name of the configuration management unit file name  
$UnitDirectory Subdirectory of a configuration management unit with respect to project units directory (_rpy). This is the "PersistsAs" subdirectory of the configuration management unit.
$UnitDirPath Full directory name of the configuration management unit  
$UnitPath Complete path name of the configuration management unit file name  
$currentdirectory Current working directory name  
$archivedirectory Directory name of the configuration management archive  
$ArchivePath Directory name of the configuration management archive  
$dir Name of the directory that contains the configuration management units whose name is changed. To be used in Rename, RenameDirectory, Move, MoveDirectory properties.
$oldname Previous name of the configuration management unit file name it can be also a directory name  
$newname Changed name of the configuration management unit file name it can be also a directory name  
$olddir Name of the directory from which configuration management unit has been moved To be used in Move and MoveDirectory properties.
$newdir Name of the directory where configuration management unit is moved  
$archive Name of the archive file specified in "Connect2Archive" operation  
$ArchiveRoot NOT USED NOT USED
Arguments to configuration management commands
Keyword Name Expanded to Comments
$mode Locked or unlocked check box Reflects value entered by the user in the graphical user interface.
$log Comment string  
$label Label identifier string  
$newdir New directory in which a unit will be stored Used when moving a unit in tree structure.
$olddir Old directory name where unit used to be stored  
$newName New name for a unit file Used when renaming a unit.
$oldName Old name for a unit file  
$dir Name of the directory that contains the configuration management units whose names changed. To be used in Rename, RenameDirectory, Move, MoveDirectory properties.
$oldname Previous name of the configuration management unit file name it can be also a directory name  
$newname Changed name of the configuration management unit file name it can be also a directory name  
$olddir Name of the directory from which configuration management unit has been moved To be used in Move and MoveDirectory properties.
$newdir Name of the directory where configuration management unit is moved  
Keywords for IBM Rational Rhapsody DiffMerge
Keyword Name Expanded to Comments
$DiffInvocation The command line used to start Rational Rhapsody DiffMerge  
$source1 Full path name of the first file to be compared  
$source2 Full path name of the second file to be compared  
$output Name of the file used by the merge tool  

Feedback