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.