Considerations for creating the file and directory structure

When you create a new unit in a model, the product creates a new file in the file system for that unit. This new file is not automatically placed under configuration management. Use the Add to Archive operation to add the file to the configuration management tool.

When creating a new package unit, if the project uses a hierarchical directory structure, both a file and a directory are created in the project. You need to create this new directory in the configuration management file structure.

Directories in SCC mode

To add a new package and package directory to a configuration management archive in Microsoft Common Source Code Control (SCC) mode, add the unit file to the repository using the Add to Archive operation. The Add to Archive operation creates directories automatically in the configuration management system, as necessary.

Directories in batch mode

When you use a configuration management tool in batch mode, directories are not automatically created in the configuration management archive. However, IBM® Rational® Rhapsody® assists you with creating new directories using the ConfigurationManagement::<configuration management tool>::MakeCMShadowDirActivation property.

The possible values are as follows:

  • Disable means that the product does not create a directory. You need to create the directory in the configuration management archive outside of Rational Rhapsody.
  • UserConfirmation means the product asks if you want to create a new directory in the configuration management structure whenever you save a project that contains a new directory.
  • Automatic means that the product automatically creates the directory in the configuration management structure whenever new directories are created by a save in Rational Rhapsody. The product creates the directory in the configuration management archive for every new directory. There exists the potential for the creation of unneeded (and probably unwanted) directories for packages that you do not intend to add to the archive.

Once you have created the new directory in the configuration management archive, you can archive the new package unit and any of its child unit files using the Add to Archive operation.


Feedback