02.05.2013 Views

Description - Mks.com

Description - Mks.com

Description - Mks.com

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

si movesubproject<br />

moves a subproject between projects or between directories of a single project<br />

SYNOPSIS<br />

si movesubproject [--[no]confirm] [--[no]createSubprojects] [-f]<br />

[--moveWorkingFiles=[none|members|all]] [--[no|confirm]overwrite]<br />

[--targetDevpath=value] [--targetDir=value] [--targetProject=value]<br />

[--targetSandbox=value] [(-P project|--project=project)]<br />

[(-S sandbox|--sandbox=sandbox)] [--devpath=path] [--hostname=server]<br />

[--port=number] [--password=password] [--user=name] [(-?|--usage)]<br />

[(-F file|--selectionFile=file)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=directory]<br />

[--forceConfirm=[yes|no]] [(-g|--gui)] [--quiet] [--settingsUI=[gui|default]]<br />

[--status=[none|gui|default]] subproject or subsandbox<br />

DESCRIPTION<br />

To meet the needs of changing project configurations, you can move one or more subprojects, and<br />

all of its members and sub-subprojects, between projects, and/or directories in a single project, or<br />

variants of the same project on the same Integrity Server.<br />

When a subproject is moved, it behaves like a shared subproject. The subproject in the new<br />

location continues to be backed by the underlying subproject in the old location and the path and<br />

name of the subproject file in the repository remains the same. Any external references (ACL<br />

names, event triggers, policy statements) to the moved subproject continue to work because they<br />

are based on the subproject’s original name; however, a subproject that is moved into a new<br />

project hierarchy continues to inherit ACLs from its original hierarchy and not from the new parent<br />

project. The moved subproject also retains its configuration type (normal, variant, build). If you are<br />

moving multiple subprojects, any <strong>com</strong>mon directory prefix shared by the subprojects is<br />

automatically removed during the move.<br />

Before using si movesubproject, note the following:<br />

❍ Moving subprojects between projects on different servers is not supported.<br />

❍ The moved subproject inherits the project or directory ACLs from its original location. You<br />

cannot apply the ACLs from the new location to the subproject.<br />

❍ The path and name of the subproject file in the repository is permanently reserved. If you<br />

attempt to create a new subproject using the moved subproject’s path and name in the<br />

repository, you are prompted to add the existing subproject. If you answer no, the create<br />

subproject operation exits without providing you with the option of creating a subproject with<br />

a different path and name.<br />

❍ Deferred and pending subproject moves are not supported.<br />

171 of 457

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!