Properties for the Web DataWindow server component

There are two tables in this section: general properties and database connection properties.

General properties

You can set properties of the Web DataWindow server component in EAServer manager. To customize the component, you add as many of the following properties as needed. Some of the properties can also be changed at runtime via server component methods.

For boolean properties, values can be true or false, or yes or no.

**Table 7-3: General properties of the Web DataWindow server component**
General property	Description
com.sybase.datawindow.sourceFileName	Specifies the PBL or PBD that contains the DataWindow object for the component, or the SRD (source definition saved from the Library painter) or PSR (Powersoft Report saved from the DataWindow painter) that is the DataWindow object. See also the SetDWObject method.
com.sybase.datawindow.dwObjectName	The name of the DataWindow object in the PBL or PBD specified for sourceFileName. See also the SetDWObject method.
com.sybase.datawindow.fixed	Whether component properties can be modified from the server-side script that instantiates the component. Values are: Yes – Properties are fixed and cannot be changed. Calling the SetDWObject, Create, Modify, and SetTrans methods have no effect. No – Properties can be changed via the SetDWObject, Create, Modify, and SetTrans methods.
com.sybase.datawindow.serverServiceClasses	A list of PowerBuilder user objects that are in the PBL or PBD specified in sourceFileName. The class names should be separated by semicolons (;). The user objects implement custom events for data validation For information on custom events, see the SetServerServiceClasses method.
com.sybase.datawindow.serverSideState	Specifies whether the server will attempt to maintain its state between method calls. Values are: Yes – The server component will keep the result set and keep the transaction open if possible. No – (Default) The result set is not saved and the server component uses information passed back from the client to retrieve the result set again and remember any uncommitted changes.
com.sybase.datawindow.trace	Whether calls to component methods are included in the Jaguar server log. Values are: Yes – Calls to component methods are listed in the log. No – Calls to component methods are not logged.
com.sybase.datawindow.HTMLObjectName	The name used for the Web DataWindow client control in the generated code. The name is used to implement client side events and to allow client side scripting. Set this property when there will be more than one Web DataWindow on a Web page so they will not conflict. See also the SetHTMLObjectName method.
com.sybase.datawindow.modifyString	A string that will be used as an argument to the Modify method for setting properties of the DataWindow object. The component calls the Modify method when it is initialized. For information on syntax, see the Modify method.

Database connection properties

To use database connection properties, you must add com.sybase.datawindow.trans.dbms. This property must be set before other trans properties can be recognized. When trans.dbms is set, unspecified connection properties default to an empty string.

**Table 7-4: Database connection properties of the Web DataWindow server component**
Database connection property	Description
com.sybase.datawindow.trans.dbms	A database vendor identifier, as displayed in the PowerBuilder. You must add trans.dbms to enable the rest of the database connection properties. When it is set, any unspecified connection properties default to an empty string. See also the SetTrans method.
com.sybase.datawindow.trans.dbparm	DBMS-specific connection parameters. See also the SetTrans method.
com.sybase.datawindow.trans.lock	The isolation level. See also the SetTrans method.
com.sybase.datawindow.trans.logid	The name or ID of the account the component will use when it logs onto the database server. See also the SetTrans method.
com.sybase.datawindow.trans.logpass	The password used to log onto the database server See also the SetTrans method.
com.sybase.datawindow.trans.database	The name of the database to which the component is connecting. Ignored for ODBC. See also the SetTrans method.
com.sybase.datawindow.trans.servername	The name of the server on which the database resides See also the SetTrans method.