Sets properties for an entity in the repository. Properties can be set by specifying either a names and values or a properties file.
set_props [ connect-args | local-args ] entity [ name value ] | [ file ]
Ant build file, specifying a property file to read:
<jag_set_props entity=”entity” file=”file” />
Ant build file, specifying properties directly:
<jag_set_props entity=”entity” /> <property name=”name” value=”value”> ... </jag_set_props>
| 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 | 
| entity | The entity identifier for the entity whose properties are being set. | Yes | 
| name | The property name. In an Ant build file,
you may specify multiple properties as  | When setting properties directly | 
| value | The property value. | When setting properties directly | 
| file | The name of a property file. Files must specify properties in the format of an EAServer properties file. | When setting properties using a properties file | 
| Return value | Indicates | 
|---|---|
| 0 | The command ran successfully; the result is true/success. | 
| 2 | The command did not run successfully; an exception was thrown. | 
This example sets the description for the entity Package:SVU.
Command line:
jagtool set_props Package:SVU com.sybase.jaguar.description “This is the SVU Package”
Ant build file:
<jag_set_props entity="Package:SVU"> <property name="com.sybase.jaguar.description" value="This is the SVU Package" /> </jag_set_props>
This example sets the properties for Package:SVU from the file SVU.props.
Command line:
jagtool set_props Package:SVU SVU.props
Ant build file:
<jag_set_props entity="Package:SVU" file="SVU.props" />
You can use the Ant build file to specify multiple properties. For example, this declaration sets the values for the com.sybase.jaguar.description and com.sybase.jaguar.package.roles properties for Package:SVU.
Ant build file:
<jag_set_props entity="Package:SVU" /> <property name="com.sybase.jaguar.description" value="This is the SVU Package" /> <property name="com.sybase.jaguar.package.roles" value="admin@system,role1" /> </jag_set_props>
This example sets the host, port, and network protocol values for “MyListener” in the “Jaguar” server:
Command line:
jagtool set_props Listener:Jaguar/MyListener com.sybase.jaguar.listener.host victor jagtool set_props Listener:Jaguar/MyListener com.sybase.jaguar.listener.port 9050 jagtool set_props Listener:Jaguar/MyListener com.sybase.jaguar.listener.protocol iiop
Ant build file:
<jag_set_props entity="Listener:Jaguar/MyListener" /> <property name=”com.sybase.jaguar.listener.host” value=”victor”> <property name=”com.sybase.jaguar.listener.port” value=”9050”> <property name=”com.sybase.jaguar.listener.protocol” value=”iiop”> </jag_set_props>
This jagtool example shows how special characters can be escaped when running commands in DOS or Windows. In this case, the = in the value set must be escaped by quoting:
jagtool set_props WebApplication:onepage com.sybase.jaguar.webapplication.session-config=(session-timeout"="30)
This syntax is equivalent:
jagtool set_props WebApplication:onepage com.sybase.jaguar.webapplication.session-config="(session-timeout=30)"
Appendix B, “Repository Properties Reference”