Chapter 12: Using jagtool and jagant

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.

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

**Table 12-3: Example entity identifiers**
Entity Identifier	Specifies
`Agent:agent1`	Agent named agent1.
`Application:estore`	Application named estore.
`ApplicationClient:estore/PetStoreClient`	Application client PetstoreClient in application estore.
`Cluster:TheBigCluster`	The 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`	The entity collection named “MyEntityCollection.”
`Filter:WebTier/MyFilter`	The servlet filter MyFilter installed in the Web application WebTier.
`InstancePool:MyPool`	The named instance pool MyPool.
`Listener:Jaguar/iiops1`	The network listener iiops1 installed in the server named Jaguar. When specifying a listener name, use the server name and the listener name as displayed in EAServer Manager.
`ManagedConnectionFactory:BlackBoxLocalTx/EASDemo`	The managed connection factory EASDemo in the J2EE connector named BlackBoxLocalTx.
`Method:SVU/SVULogin/isLogin`	The isLogin method of component SVULogin in package SVU.
`Package:SVU`	The package named SVU.
`Role:MyRole`	The role named MyRole.
`Security:sample1`	The security entity named “sample1.”
`Server:Jaguar`	The server named Jaguar.
`Service:MyPack/MyComp`	The service component 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`	The servlet named MyServlet in Web application named MyWebApp. You must use this syntax for servlets that are installed in a Web application.
`WebApplication:WebTier`	The 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.

View this book as PDF