Entering content frame

This graphic is explained in the accompanying text The ConnTrans Startup File Locate the document in its SAP Library structure

Definition

An XML file ( ConnTrans_Startup.xml ) that captures information pertaining to the default settings to be used for logging and UI related options when ConnTrans is invoked. When you invoke ConnTrans, the default settings for logging and UI related options are read from this file and accordingly the data synchronization is performed.

Use

If the system administrator wants to deploy the same default settings for logging and UI related options to a large number of mobile clients, he/she can set the options in the ConnTrans_Startup.xml file of one mobile client and replicate this file to the required number of mobile clients.

This graphic is explained in the accompanying text

This file is available under ....SAP\Mobile\ConnTrans\StartUp.

Structure

The ConnTrans_Startup.xml file is classified into the following sections:

·        Logging options

The system administrator only can set these options while setting up the mobile clients. These settings are read from this file and applied to ConnTrans the next time ConnTrans is invoked.

The system administrator can set the following logging options in this file:

¡        Logging for ConnTrans (<LOG_TO_FILE>)

By default, the logging of runtime information associated with ConnTrans is enabled. However, the system administrator can completely disable logging for ConnTrans. To do this, the system administrator can set the value of <LOG_TO_FILE> to 0 or deselect the ConnTrans Trace option under Central Tracing in Client Console. For more information, see Enabling Traces.

¡        Overwrite or Append to the log file

The administrator can specify whether to append the logging information across sessions of ConnTrans to the same file or create a new ConnTrans_Log.xml file for each initialization of ConnTrans.

By default, the Overwrite option is enabled to limit the size of the ConnTrans_Log.xml file. However, for troubleshooting purposes, the system administrator can enable the logging in the append mode. To do this, the system administrator must add the following XML tag to the ConnTrans_Startup.xml file:

<STARTUP_OPTIONS>

                <LOGGING_OPTIONS>

                                  <LOG_APPEND>1</LOG_APPEND>

                <LOGGING_OPTIONS>

<STARTUP_OPTIONS>

After the system administrator rectifies the error(s), we recommend to disable the logging in the append mode as it affects the runtime performance of ConnTrans. To do this, the system administrator can perform any of the following:

§         Remove the tag from the XML file

§         Set the value of <LOG_APPEND > to 0

This graphic is explained in the accompanying text

To prevent inadvertent enabling of the append mode, the <LOGGING_OPTIONS> tag is not created by default.

¡        Audit level (<LOG_AUDIT_LEVEL>)

The administrator can set the Audit level for logging. The default Audit Level is 2.

¡        Maximum size of the log file (<LOG_MAX_SIZE>)

By default, the maximum size of the ConnTrans_Log.xml file is set to 3MB. However, if the logging is set to the append mode and the size of the log file exceeds the specified maximum limit, the ConnTrans_Log.xml file is renamed to ConnTrans_Log.xml.bak file and a new ConnTrans_Log.xml file is created with the default settings the next time ConnTrans is invoked.

This graphic is explained in the accompanying text

If the ConnTrans_Log.xml.bak file already exists, the same is deleted before the ConnTrans_Log.xml file is renamed to ConnTrans_Log.xml.bak .

¡        Path of the log file (<LOG_ FILE_PATH>)

By default, the ConnTrans_Log.xml file is created in the ConnTrans folder under the default windows temporary folder. However, both the administrator and sales representative can change the path of the log file.

¡        Transfer statistics logging

By default, the logging of transfer statistics into the StatisticsLog.xml file is enabled. However, the system administrator can disable the logging of transfer statistics. To do this, the system administrator can set the value of <LOG_STATISTICS> to 0 or deselect the ConnTrans Statistics Trace option under Central Tracing in Client Console. For more information, see Enabling Traces.

¡        Path of the transfer statistics log file

By default, the StatisticsLog.xml file is created in the default windows temporary folder. However, both the administrator and sales representative can change the path of the log file.

·        UI options

The system administrator can initially set these options in the startup file to replicate the settings to the required mobile clients. These settings are read from this file and applied to ConnTrans the next time ConnTrans is invoked.

Subsequently, the sales representative can set these options through the ConnTrans UI to personalize the settings. However, the settings are personalized only if the sales representative synchronizes data using the new settings. In such a case, this file is accordingly updated to persist the changes specified by the sales representative. Therefore, the next time ConnTrans is invoked, ConnTrans reflects the changes specified by the sales representative.

The system administrator and sales representative can set the following UI options in this file:

¡        Send/Receive selection of all Transfer Services

The default option is read from the user (IDES) database.

¡        Close on finish

By default, this option is disabled.

¡        Connection Options under the Advance Settings tab

The default option is read from the user database.

¡        Auto-Sync enable or disable

By default, this option is enabled.

Example

A sample of the ConnTrans_Startup.xmlfile is displayed below:

– <STARTUP_OPTIONS>

– <LOGGING_OPTIONS>

  <LOG_TO_FILE>1</LOG_TO_FILE>

  <LOG_FILE_PATH>C:\temp</LOG_FILE_PATH>

  <LOG_APPEND>0</LOG_APPEND>

  <LOG_AUDIT_LEVEL>7</LOG_AUDIT_LEVEL>

  <LOG_MAX_SIZE>50</LOG_MAX_SIZE>

  <LOG_STATISTICS>1</LOG_STATISTICS>

  <LOG_STATS_FILE_PATH>C:\temp</LOG_STATS_FILE_PATH>

  </LOGGING_OPTIONS>

– <UI_OPTIONS>

<AUTO_SYNC>-1</AUTO_SYNC>

<BACKWEB_TRANSFER_SERVICE_RECV>0</BACKWEB_TRANSFER_SERVICE_RECV>

<BACKWEB_TRANSFER_SERVICE_SEND>0</BACKWEB_TRANSFER_SERVICE_SEND>

<CLOSE_ON_FINISH>0</CLOSE_ON_FINISH>

<CONNECT_OPTION_KEY>0</CONNECT_OPTION_KEY>

<MAPI_TRANSFERSERVICE_RECV>0</MAPI_TRANSFERSERVICE_RECV>

<MAPI_TRANSFERSERVICE_SEND>0</MAPI_TRANSFERSERVICE_SEND>

<MESSAGE_TRANSFER_SERVICE_RECV>-1</MESSAGE_TRANSFER_SERVICE_RECV>

<MESSAGE_TRANSFER_SERVICE_SEND>0</MESSAGE_TRANSFER_SERVICE_SEND>

<BackWeb_RECV>0</BackWeb_RECV>

<BackWeb_SEND>0</BackWeb_SEND>

<MSA_RECV>-1</MSA_RECV>

<MSA_SEND>0</MSA_SEND>

<e-Mail_RECV>0</e-Mail_RECV>

<e-Mail_SEND>0</e-Mail_SEND>

<KBase_RECV>0</KBase_RECV>

<KBase_SEND>0</KBase_SEND>

<LAST_EXEC_START>4/29/2003 10:09:50 AM</LAST_EXEC_START>

<LAST_EXEC_STOP>4/29/2003 10:10:51 AM</LAST_EXEC_STOP>

</UI_OPTIONS>

</STARTUP_OPTIONS>

See also:

The ConnTrans Log File

Leaving content frame