RADE

Source Code Manager

adl_detach_is

Detaching components in local workspace
Quick Reference

Abstract

The adl_detach_is command is an intersite command that is used to detach one or many frameworks from the local workspace and from the remote mirror workspace. 

Synopsis

adl_detach_is component... [-transfer transfer_name] [-h | -help | -?]

 

Usage

The adl_detach_is command is used after having declared [1] an intersite transfer between a local workspace and another workspace of another remote site. It is used to detach components in both remote mirror workspace and current workspace. Those components have been attached with the [4] adl_attach_is command.

This command does not work if the current workspace is a root workspace.

The command operates on both current workspace and remote mirror workspace: the components are detached in the remote mirror workspace and then an intersite transfer is launched for refreshing the current workspace.

The adl_detach_is does not provide the same options as the adl_detach command. The command is built upon the general intersite commands [2].

The components to be detached must be accessible in the parent workspace (see the adl_ls_fw_is [3] command with the -all option to list the accessible frameworks). The current workspace must be synchronized with the remote parent workspace in case the components to detach appeared in it since the last synchronization. If the local workspace is not a root workspace  and forbids promotions, import commands are used to import the component in the parent workspace, then the workspace is synchronized. At least, the component is detached.

Example of a wrong adl_detach_is

>>>> 161 at 2002/07/23-16:53:29: adl_detach_is Fw1 Fw2

Changing current remote working workspace to "MIRROR_Site_Ws1S2DHpgZU00000_1"...
Detaching Fw1 in workspace Ws1S2DHpgZU0000030006K08d...
Local modifications:
-----------------------------
Fw1 has been created

Verifying that neither "Fw1" nor any contained SCM object is modified.
#ERR# ADLCMD - 3812: "Fw1" is modified, or it contains modified SCM objects.
Lose these modifications, or:
- promote these modifications
- your parent workspace collects them
- it publishes
- you synchronize your workspace.
##### THE COMMAND ENTIRELY OR PARTIALLY FAILED #####

#ERR# ADLMultiSite - 0727: Failed to detach "Fw1" in local workspace. If the component "Fw1" contains local modifications and if you want to force its detaching, then use adl_detach_is "Fw1" -force -transfer "my_transfer" to import those modifications into the parent workspace "RootWs1S2DHpgZU0000030006K08d", synchronize the current workspace "Ws1S2DHpgZU0000030006K08d" and finally detach the component.

Example of a correct adl_detach_is

>>>> 163 at 2002/07/23-16:53:57: adl_detach_is Fw1 Fw2 -force

Changing current remote working workspace to "MIRROR_Site_Ws1S2DHpgZU00000_1"...
Information: the command will use the parent workspace to import in it modifications that are local to the component "Fw1" in workspace "Ws1S2DHpgZU0000030006K08d" and synchronize "Ws1S2DHpgZU0000030006K08d" against its parent workspace, then the component will be detached.

Importing component to detach in workspace "RootWs1S2DHpgZU0000030006K08d"...
Synchronizing workspace "Ws1S2DHpgZU0000030006K08d" against contents of workspace "RootWs1S2DHpgZU0000030006K08d" in workspace tree "Tree1S2DHpgZU0000030006K08d"...
Freezing the revision "2" of the workspace "Ws1S2DHpgZU0000030006K08d" in the workspace tree "Tree1S2DHpgZU0000030006K08d".
Command successful.

Synchronizing the workspace "Ws1S2DHpgZU0000030006K08d" in the workspace tree "Tree1S2DHpgZU0000030006K08d".
Command successful.

Freezing the revision "3" of the workspace "Ws1S2DHpgZU0000030006K08d" in the workspace tree "Tree1S2DHpgZU0000030006K08d".
Command successful.

Refreshing the image "WINDOWS" of the workspace "Ws1S2DHpgZU0000030006K08d".
Command successful.

Detaching Fw1 in workspace Ws1S2DHpgZU0000030006K08d...
Detaching "Fw1" (Framework) in the workspace "Ws1S2DHpgZU0000030006K08d" and the workspace tree "Tree1S2DHpgZU0000030006K08d".
Command successful.

[Top]

Options

adl_detach_is accepts the following options:

-h|-help|-? Help of the command
framework Name of the framework to detach
-transfer transfer_name Name of an existing transfer of the current workspace.

[Top]

Examples

Detachment of the “MyFramework” framework in the current workspace where a transfer named "Transfer1" has been set up with a remote workspace where this framework is currently managed:  

adl_ch_ws MyWsDev
adl_detach_is MyFramework -transfer Transfer1

 

[Top]

References

[1] adl_mk_is_transfer: Creating an intersite transfer
[2] Inter site transfer: Sharing components between SCM sites
[3] adl_ls_fw_is: Listing framework in remote mirror workspace
[4] adl_attach_is: Attaching a framework on an inter-site transfer workspace

[Top]

History

Version: 1.1 [Oct 2002] Document update
Version: 1.0 [May 2002] Document creation

[Top]

Copyright © 2002, Dassault Systèmes. All rights reserved.