Entity identifiers

Many jagtool commands take one or more entity identifiers as arguments. An entity identifier is a string of the form EntityType:EntityName that uniquely identifies an entity in the repository. EntityName is the J2EE module name; that is, the name of the archive from which the entity is deployed. For example, if you deploy myejb.jar, the entity name is “myejb.”

Table 6-3 provides examples of entity identifiers for each entity type.

**Table 6-3: Example entity identifiers**
Entity identifier	Specifies
`Agent:agent1`	Agent named agent1.
`Application:estore`	Application named estore.
`ApplicationClient:estore/PetStoreClient`	Application client named PetstoreClient in application named estore.
`Cluster:TheBigCluster`	Cluster named TheBigCluster.
`Component:SVU/SVULogin`	Component named SVULogin that is installed in the SVU package. The package name is included because EAServer components always reside in packages.
`ConnCache:JavaCache`	Connection cache named JavaCache.
`Connector:BlackBoxLocalTx`	J2EE connector named BlackBoxLocalTx.
`DatabaseType:Sybase_ASA`	Database type definition named Sybase_ASA.
`EntityCollection:MyEntityCollection`	Entity collection named MyEntityCollection.
`Filter:WebTier/MyFilter`	Servlet filter named MyFilter installed in the Web application named WebTier.
`InstancePool:MyPool`	The named instance pool MyPool.
`Listener:Jaguar/iiops1`	The network listener named iiops1 installed in the server named Jaguar. When specifying a listener name, use the server name and the listener name as displayed in the Management Console.
`ManagedConnectionFactory:BlackBoxLocalTx/EASDemo`	The managed connection factory named EASDemo in the J2EE connector named BlackBoxLocalTx.
`Method:SVU/SVULogin/isLogin`	Method named isLogin of component SVULogin in package SVU.
`Package:SVU`	Package named SVU.
`Role:MyRole`	Role named MyRole.
`Security:sample1`	Security entity named sample1.
`Server:Jaguar`	Server named Jaguar.
`Service:MyPack/MyComp`	Service component named MyComp, installed in package MyPack. Use this syntax to install or remove service components from a server.
`Servlet:StandAloneServlet`	The servlet named StandaloneServlet. This syntax is valid only for servlets that are not installed in a Web application.
`Servlet:MyWebApp/MyServlet`	Servlet named MyServlet in Web application named MyWebApp. You must use this syntax for servlets that are installed in a Web application.
`WebApplication:WebTier`	Web application named Web tier.

Not all jagtool commands support every type of entity in the repository. For example, the refresh command is not supported for the Listener entity type.

When a command specifies an invalid entity type, an appropriate error message is displayed.