promote Promotes derived objects from the reserved pool. Format promote [wildcard_build_unit_specifier] Description The promote command allows you to promote multiple builds of one or more components from the reserved pool to the appropriate system pools. When you replace an element, the configuration manager automatically looks for builds that used the element in the reserved pool that can be promoted to the appropriate system pool, and then promotes them. This allows you to avoid rebuilding the element once it's replaced. However, the configuration manager only automatically promotes those derived objects built for the current system. If you built the same Element dtty.pas for a number of systems, for example, the configuration manager only promotes the derived objects associated with your current system at the time you replace dtty.pas. If you issue the command promote dtty.pas after you issue the replace command, the configuration manager promotes all eligible builds that depend upon the element. (A build is generally eligible for promotion when all of the reserved elements it uses have been replaced. Note that the configuration manager cannot always promote builds that seem to be eligible. For example, the build of an aggregate is not promoted if one of its constituents has been forcibly deleted from the system pool.) Issuing the promote command with no argument causes the configuration manager to promote all builds in the reserved pool that are eligible for promotion. Specifying no argument is also useful when you want to promote builds that depend upon a nonbuildable part of the system that you have just replaced (for example, an include file). Note that the promote command is sensitive to the current model setting. It causes the configuration manager to promote only builds that were generated using the current model. If you want to promote builds generated with more than one model, alternately issue set model (for each model used in the builds that you want to promote) and promote. (To find out what model was used in a build, issue the show builds command.)