The following are the supported keys and default values the agent uses at startup. Once the file is read the agent will remove the file. Under certain circumstances the property file is not deleted. If the agent is not being started for the first time, then the property file will only be read if the properties are specified for a new account. If no account name is specified in the properties file, the file is not read or deleted. To force the agent to read this property file again, the OSGiAgentTree.bin and its backup file must be deleted.

Before the agent starts for the first time, you can create a default account. When you first start the agent, it looks for the default account properties file, called osgiagent.properties, in the directory specified with a -D command line parameter in your invocation of the Virtual Machine (VM) that implements Java specifications. For example, if the account properties file is in the c:\propertyfile directory, you would use the following -D parameter in your VM invocation:

-Dcom.ibm.osg.service.osgiagent.PropertiesFileLoc=c:\\propertyfile

If the -D parameter is not used, the Java class path is searched for the osgiagent.properties file and that properties file is used. If no properties file is located in the Java class path, the current directory is searched.

When a properties file is found, the agent reads the parameters to create the initial account. When the OSGi agent starts for the first time, if no initial account exists, an initial account named AgentDefaultAccount is automatically created.

Use the following parameter descriptions and the sample file format as a guide if you create an osgiagent.properties file to create an initial account. The corresponding Agent Control Panel field is enclosed in parenthesis.

AccountID (SyncML DM account ID)

The SyncML DM account ID, which is often the same as the server ID. If no account name is specified, then AgentDefaultAccount is created the first time. However, if AgentDefaultAccount is already created, then the properties file will not be read if no AccountID is specified.

UserName (Device user name)

User name for the device.
The name is used when SyncML/DM authorization or HTTP basic authentication is implemented.

ClientPW (Device user password)

User password. The password text is displayed in clear text.
The password is used when SyncML/DM authorization is implemented.

ServerPW (Server password)

Server password.
The password is used when SyncML/DM authorization is implemented.

Note: Expeditor Client Management server does not implement SyncML/DM authorization and this password does not need to be set.

Addr (Server address)

Use the host name or IP address for the Client Management server, such as:

http://server_address/dmserver/OMADMServletAuthRequired

When authorization is required, use the following value:

dmserver/OMADMServletAuthRequired

If SyncML/DM authorization is not implemented, use the following value:

dmserver/OMADMServlet

PollingEnabled (Polling enabled)

Determines if polling is enabled. The values are true or false (case is ignored).
The Polling enabled check box is displayed in the Device Information window.

PollingInterval (Polling interval)

Specifies the polling interval in hours and minutes. The value is specified as HH:MM.
This field is displayed in the Device Information window.

PollingIntervalSeconds (Polling interval in seconds)

Specifies the minimum polling interval allowed between polling in seconds. Use to prevent polling too frequently.

PollingStart (Polling start time)

Specifies the polling start time in hours and minutes. The value is specified as HH:MM.
This field is displayed in the Device Information window.

PollingEnd (Polling end time)

Specifies the polling end time in hours and minutes. The value is specified as HH:MM.
This field is displayed in the Device Information window.

LogSize (log size)

Specifies the size of the message files. This field is displayed in the Device Information window.

LogThreshold (log threshold)

Specifies the minimum error type added to the message file. The choices and corresponding values are:

* 1 for Error

* 2 for Warning

* 3 for Info

* 4 for Debug

This field is displayed in the Device Information window.

TempFileLoc (Temp file location)

Identifies the path for temporary files. This field is displayed in the Device Information window.

EnableAdvProps (enable advanced Pproperties)

Shows the advanced section which contains the Server password setting in the Enterprise Management Agent preference page. The values are true or false (case is ignored).