Using the set_config command with HCL Traveler for Microsoft Outlook

The HTMO protocol set_config command changes configuration properties related to logging and mail syncing for logged-in users.

Parameters for set_config are configuration setting names followed by new values. Multiple settings can be specified. The following settings are supported:
Table 1. HTMO protocol set_config settings
Setting Setting values
TraceLevel
  • 0 or 1: Includes severe lines only. Least verbose logging.
  • 2: Includes warning lines.
  • 3: Includes information lines.
  • 4: Includes all lines. Most verbose logging.
AllowConfidential
  • 0: Do not log confidential fields.
  • 1: Log confidential fields.
Note: When 1 is specified, when starting Outlook, the user is notified that information that is considered confidential may be logged.
SummaryFilterWindow <integer>: The number of days after messages are received to automatically sync the full message content. Messages older than the specified number of days show summary information, unless opened.

For example, if set to 7, messages received within seven days are synced in full; messages older than seven days show summary information.
UnlimitedMail
  • 0: Disable syncing of unlimited mail and calendar data to a delegated account and, by default, sync only the last 30 days.
  • 1: Enable syncing of unlimited mail and calendar to a delegated account (default).
CalendarFilterWindow <integer>: If UnlimitedMail=0 is used, specify the number of days of calendar data to sync to a delegated account, overriding the default of 30 days.
MailFilterWindow <integer>: If UnlimitedMail=0 is used, specify the number of days of mail data to sync to a delegated account, overriding the default of 30 days.
BusySignalTimeout <integer>: The number of seconds to wait before a sync request times out. The default is 60 seconds. For initial sync when setting up a new mailfile, you might need to increase this value, depending on how large the mail file is. If mail sync is timing out, recommend starting at 240 and increasing in 60 second increments if initial sync fails.

For example, if set to 60, if a sync request takes longer than 60 seconds, the client will time out and exit syncing.

The following example shows a command that is useful for generating additional logging that is needed for Support. The example sets the TraceLevel to its highest sensitivity and starts logging data that may be considered confidential.

htmo:set_config?TraceLevel=4&AllowConfidential=1