Chapter 12: Using jagtool and jagant

remove

Removes, but does not delete, an entity from another entity. For example, use remove to remove a package from a server.

Local mode support: Yes.

Command line:

remove [ connect-args | local-args ] source target

Ant build file:

<jag_remove source=”source” target=”target” />

Option	Description	Required
connect-args \| local-args	Arguments to specify a connection to the server or to run in local mode. See “Local versus connected mode”.	Yes
source	The entity identifier of the entity being removed.	Yes
target	The entity identifier of the entity from which the source is removed.	Yes

Return value	Indicates
0	The command ran successfully; the result is true/success.
1	The command ran successfully; the result is false/failure.
2	The command did not run successfully; an exception was thrown.

This example removes Package:SVU from the entity Server:Jaguar.

Command line:

jagtool remove Package:SVU Server:Jaguar

Ant build file:

<jag_remove source="Package:SVU" target="Server:Jaguar"/>

This example removes WebApplication:WebTier from the entity Application:estore.

Command line:

jagtool remove WebApplication:WebTier Application:estore

Ant build file:

<jag_remove source="WebApplication:WebTier" target="Application:estore" />

This example removes the service component MyPack/MyComp from the Jaguar server:

Command line:

jagtool remove Service:MyPack/MyComp Server:Jaguar

Ant build file:

<jag_remove source="Service:MyPack/MyComp" target=”Server:Jaguar” />