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 move<br />

moves one or more project members between projects, or between directories in a single<br />

project<br />

SYNOPSIS<br />

si move [(--cpid ID|--changePackageId=ID)]<br />

[--[no|confirm]closeCP] [--[no]confirm] [--[no]defer] [-f] [--issueId=ID]<br />

[--[no]moveWorkingFile] [--[no|confirm]overwrite] [--[no]createSubprojects]<br />

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

[--targetSandbox=value] [--filter=filteroptions] [(-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]] member...<br />

DESCRIPTION<br />

As software designs and project structures change, it may be<strong>com</strong>e necessary to move one or more<br />

members between projects, variants of the same project, or directories in a project.<br />

Moving a member performs a drop in the source location and an add in the target location, creating<br />

a new revision in the existing archive. The member’s archive remains in its original location in the<br />

repository so that change packages, member histories, and project histories continue to work. If<br />

the move is performed with a change package, the member is added as a single Move entry in the<br />

change package. If you are moving multiple members, any <strong>com</strong>mon directory prefix shared by the<br />

members is automatically removed during the move.<br />

Key Considerations<br />

● Moving members between projects on different servers is not supported.<br />

● You can perform deferred member moves only if both the source and target locations are<br />

sandboxes.<br />

● si move does not work recursively on subprojects. To move one or more subprojects, use<br />

the si movesubproject <strong>com</strong>mand.<br />

● Source Integrity detects whether any ACLs exist in the tree defined by the source project,<br />

the target project, and the <strong>com</strong>mon root between them (or the global ACL, if there is no<br />

<strong>com</strong>mon root). If any ACLs are found, Source Integrity warns you so you can manually<br />

make any required adjustments to the ACLs after the move is <strong>com</strong>plete.<br />

168 of 457

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

Saved successfully!

Ooh no, something went wrong!