Chapter 12: Using jagtool and jagant

ejbref

Description

Sets the value of an EJB reference.

Syntax

Local mode support: Yes.

Command line:

ejbref 
[ connect-args | local-args ] 
entity 
[-localref true|false] 
-refname name 
-value value

Ant build file:

<jag_ejbref [ localref=”true|false” ] entity=”entity” refname=”name” value=”value” />

Option	Description	Default	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
entity	The entity identifier in the form EntityType:EntityName.	-	Yes
`localref`	Whether setting a local-interface reference or a remote-interface reference. `true` indicates a local-interface reference.	`false`	No
`refname`	The name of an EJB reference for the given entity.	-	Yes
`value`	The value for the EJB reference.	-	Yes

Returns

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

Examples

Example 1

This example sets the value of an EJB reference in the component TheCustomer in the package Customer_Component. The EJB reference ejb/account/Account is set to the value of “Customer_Component/TheAccount”.

Command line (all on one line):

jagtool ejbref Component:Customer_Component/TheCustomer 
-refname ejb/account/Account 
-value Customer_Component/TheAccount

Ant build file:

<jag_ejbref entity="Component:Customer_Component/TheCustomer" refname="ejb/account/Account" value="Customer_Component/TheAccount" />

View this book as PDF