Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry AtHoc
  3. Desktop App 6.2.x.278
  4. Desktop App Installation and Administration Guide
  5. Desktop app settings
  6. Operating settings
  7. Registry settings

Registry settings

The AtHoc[edition] registry key in 
HKLM/Software/Wow6432Node
 (known as the “machine key”) is created during installation and contains the default connection settings and the configuration settings sent on the command line to the MSI.
The AtHoc[edition] registry key in 
HKCU/Software
 (known as the “user key”) is created by the desktop app when it starts and copies the default settings from the machine key to the user key. Values in the user key are updated when the desktop app connects to the server.
The registry key location in HKCU should be under Wow6432Node because the desktop app is a 32-bit application.
The installer creates HKLM with the values specified in the installation script (SCCM or BAT file). If you run the MSI manually, it uses the values that the user chooses in the MSI dialogs. When the client starts, it always looks for HKCU first and use those values. If it does not find a key under HKCU, it looks for the key under HKLM and writes a copy from those values into HKCU. It does not matter if the values in HKLM do not match the values in HKCU.
Values in HKLM key are created during installation. Those values are the default values that are written to HKCU when the client starts. Once a user has signed on, all subsequent sign-ons by that user only read the HKCU values. If you have a machine that is fresh, you can change the values in HKLM only. If you have a machine that users have logged on to already, then you need to either delete their HKCU key or update it.
User key
The following are the keys found in the HKCU/Software user key:
  • AtHoc[edition]
    • alternateBaseUrl1—See "Failover" in Management system desktop app settings.
    • Audio
    • BASEURL—Copied from 
      HKLM/Software/Wow6432Node/AtHoc[edition]/BASEURL
      . This value is updated when redirected to a different system. 
    • Extension
    • Installdate—Time stamp from when the installation happened. The format is: 20170811170307, which is 2017-08-11 17:03:07
    • ProgramsFolder—The user’s Start Menu folder for the AtHoc[edition] desktop app.
    • LastBaseUrlIndex
    • LdapAttributeValue—This value appears only when the desktop app attempts to save the value. The   “LDAP attribute” is selected in 
      Settings
       > 
      User Authentication
       in the BlackBerry AtHoc management system. This value can be created manually in environments that do not use Active Directory. This value is compared with the user’s Mapping Id.
    • PROVIDER ID—Copied from 
      HKLM/Software/Wow6432Node/AtHoc[edition]/PROVIDER ID.
    • RegisterInIE—Not used.
    • SendLogLink—Start Menu shortcut to send the desktop app log to. Contains the "C: \Program Files (x86)\AtHoc[edition]\AtHoc[edition].exe" log.
    • serverType—ASP.
    • TOKEN—Created and returned by the server at first SO.
    • ToolbarLink—Legacy toolbar value. Not used by the desktop app.
    • UID—Created and returned by the server at first SO.
    • UninstallLink—Start Menu shortcut to uninstall the desktop app. Contains “C:\Windows\system32\msiexec.exe  /x {product_guid}”.
    • UserPath—Path to the AtHoc[edition] folder in the user’s AppData folder. 
  • ACTIONS—Not used.
  • CLIENT—“Client version information." This key is not used by the desktop app.
    The value for Version is always the same in the GU response returned by the server.
  • Version—5.6.4.0.
  • ENGINE—This key is not used by the desktop app.
  • Internet Settings—This key does not appear unless changes are made on the Connection Settings tab of the desktop app's About dialog.
    • AuthPass—(REG_BINARY), hashed password.
    • AuthUser—(REG_SZ), username.
    • AutoDetectAddress—(REG_SZ), location of the automatic configuration script used when "Use automatic configuration script" is checked.
    • IsAuthEnable—(REG_DWORD), 1 = "I'm behind authentication proxy" is checked.
    • IsAuthPassSaved—(REG_DWORD), 1 = "Save authentication password" is checked.
    • IsAutoConfg—(REG_DWORD), 1 = "Use automatic configuration script" is checked.
    • IsAutoDetect—(REG_DWORD), 1 = "Automatically detect settings" is checked.
    • IsProxyEnable—(REG_DWORD),1 = "Use a proxy server" is checked.
    • ProxyServer—(REG_SZ), the proxy server URL and port. 
  • metaStore
    • data—Stores XML that indicates the user’s status.
  • PROVIDER
    • Application
    • AtHocAndLCSConnected
    • blockRequestIfLocked—See the "Stop checking for updates when Desktop is locked" section in Management system desktop app settings.
    • clientLog—See the "Email Address To Send Client Logs"  section in Management system desktop app settings.
    • Connected—System tray icon to use when the desktop app is connected. Located in 
      C:\ProgramData\AtHoc[edition]\Ico
    • Connecting—System tray icon to use when the desktop app is connecting. Located in 
      C:\ProgramData\AtHoc[edition]\Ico
    • deskbar—Stores the value that was passed to the MSI for DESKBAR (the value for DESKBAR in 
      run.bat
      ).
    • Disconnected—System tray icon to use when the desktop app is not connected. Located in 
      C:\ProgramData\AtHoc[edition]\Ico
    • enableNotifierAutoFocus—Supported by the client but not used. When set to "Y" this entry causes the pop-up to have focus. This entry enables compliance with Section 508 standards.
    • enableRClick—Not used.
    • ENABLERCLICKCLEARPOPUP—See the "Right-click to dismiss Desktop pop-up" section in Management system desktop app settings.
    • FORCEDEXPOSETIME
    • FORCEDEXPOSETYPE
    • IEColor—Icon for use with unknown feature.
    • IEGray—Icon for use with unknown feature.
    • LOGO—Company logo to show in pop-up alerts. Located in 
      C:\ProgramData\AtHoc[edition]\Bmp
      .
    • NAVINDIRECT
    • networkStatusBubbles
    • NoUninstall—Y = uninstall is not allowed. N = uninstall is allowed. See the “Show uninstall option in control panel and Start menu” section in Management system desktop app settings.
    • PROGRAMNAME
    • PROVIDERLOGO
    • PROVIDERURL
    • PROVIDERNAME
    • SendLog—Icon
    • silent—Icon
    • SUPPORT
    • SYSTRAY_TOOLTIP
    • toolbar
    • TOOLBARNAME
    • UnInstall—Icon for use during uninstallation.
    • uninstallMessage
    • UNINSTALLNAME
    • Version 
  • SKIN—“Change IE toolbar skin.” This key is not used by the desktop app.
    The values in this key are always the same in the GU response by the server.
  • STYLESHEET—Service and button styles to use in Toolbar and menu visual configurations. this key is not used by the desktop app.
    The value for Version is always the same in the GU response by the server.
    • Version=1
  • SYSTEM
    • CONNECT-INTERVAL—See the "Reconnect Interval" section in Management system desktop app settings.
    • CONNECT-INTERVAL-WINDOW—Created when the client connects to an organization. Used when the client is unable to connect after first SO . This key adds a randomized wait interval to CONNECT-INTERVAL (the “Reconnect interval”) that the client uses before attempting to connect after the connection is lost. “Additional max delay time” is displayed in the client log when this key is in use.
      The CONNECT-INTERVAL-WINDOW is calculated from the database value DSW_RECONNECT_WINDOW in PRV_EXTENDED_PARAMS_TAB. DSW_RECONNECT_WINDOW must be between 2 and 100. The calculated value for CONNECT-INTERVAL-WINDOW will be:
      valueInSeconds = (DSW_RECONNECT_WINDOW x Check Update interval) / 100
      The BlackBerry AtHoc server performs session maintenance and clears out stale desktop sessions. A session is considered stale if the desktop app has not performed a successful CU for a time that is equal to 1.5xCU + 30 seconds. For example, a CU of 1 minute means the session is stale if a CU has not occurred in the last 120 seconds. However, the session maintenance job runs every half hour, so the desktop app can have several failed CUs and then a successful one just before the session maintenance job runs and the session is not considered to be stale.
       
  • GB-INTERVAL—Not used.
  • KEEPER-INTERVAL—See the "Check Update Interval" section in Management system desktop app settings.
  • KEEPER-START—See the "Start-up Delay" section in Management system desktop app settings.
  • RECOVERY-INTERVAL—See the "Recovery Interval" section in Management system desktop app settings.
  • systray-visibility—See the "Display System tray icon" section in Management system desktop app settings.
  • Version
  • SYSTRAY-MENU
    • Version
  • TREE—This key is not used by the desktop app.