Client .exe Logging

  • Published on Mar 5, 2026
  • 4 minute(s) read
  • Austin Rominger
 Prev Next

Most XA Client .exe files will generate their own respective logs based on the settings contained in their corresponding .ini files. Refer to each section for the type of logs you need, follow the instructions to enable them (if they aren't already), and see where they're located.

Some executables will recognize the change to their .ini file and immediately start logging, while others will need to be restarted for them to recognize the change.

General XA Troubleshooting

One of the core XA Client components is the XA User Context Manager (xaucm.exe). This component manages the communication between the XA Client and Server. When its logging is enabled, along with other information, it will show:

  • When a user logs in and out of XA
  • The XA client startup steps
  • The list of applications a user has access to

Enable xaucm.exe Logging

  1. Open Notepad (or another text editor) as an administrator.

  2. Browse to C:\Program Files (x86)\HealthCast\eXactACCESS.

    1. Locate and open the xaucm.exe.ini file.

  3. In the [debug] section, set: information=1.

  4. Save the changes.


Log Directory: C:\ProgramData\HealthCast\logs

File Name: xaucm.txt.debuglog

Badge Troubleshooting

HCI ProxCard Client Service is the primary executable that connects to badge reader hardware and processes badge events on the end-user workstation is hchidscan.exe. This executable runs as a service, "HCI ProxCard Client Service", and should start automatically when a user logs into Windows.

Enable hchidscan.exe Logging

  1. Open Notepad (or another text editor) as an administrator.

  2. Browse to C:\Program Files (x86)\HealthCast\eXactACCESS.

    1. Locate and open the hchidscan.exe.ini file.

  3. In the [debug] section, update the following two settings:

    • LogFileSizeInMeg=50
    • information=1

    While changing LogFileSizeInMeg isn't strictly necessary, the hchidscan.exe executable writes to the log file several times per second, so the log file grows large quickly. Increasing the LogFileSizeInMeg setting to 50 gives you a better chance of capturing a badge tap event.

  4. Save the changes to the hchidscan.exe.ini file.

  5. Restart the HCI ProxCard Client Service service.


Log Directory: C:\ProgramData\HealthCast\logs

File Name: hcidscan.txt.debuglog

XA Lock and Logoff Troubleshooting

xaLock.exe is the executable that runs when XA locks, either in Kiosk or Standard User Mode, usually due to a lock timeout.

Enable xalock.exe Logging

  1. Open Notepad (or another text editor) as an administrator.

  2. Browse to C:\Program Files (x86)\HealthCast\eXactACCESS.

    1. Locate and open the xaLock.exe.ini file.

  3. In the [debug] section, set: information=1.

  4. Save the changes.


Log Directory: C:\ProgramData\HealthCast\logs

File Name: xalock.txt.debuglog

Enable xalock.exe Logging

  1. Open Notepad (or another text editor) as an administrator.

  2. Browse to C:\Program Files (x86)\HealthCast\eXactACCESS.

    1. Locate and open the xaLoggoff.exe.ini file.

  3. In the [debug] section, set: information=1.

  4. Save the changes.


Log Directory: C:\ProgramData\HealthCast\logs

File Name: xaLoggoff.txt.debuglog

Credential Provider Troubleshooting (SUM only)

Credential manager logging can be useful for troubleshooting issues with the login process. XA uses a credential provider on SUM systems to capture the user's password for passthrough to applications that need the user's AD password.

There are two ways to enable Credential Provider logging, but both should be enabled when troubleshooting the Credential Provider:

Registry

  1. Open the XA client's Registry Editor.

  2. Navigate to HKLM\SOFTWARE\HealthCast\eXactACCESS\QAW\Settings.

  3. Create the following value:

    Value Name Type Value Data
    DebugEnabled STRING 1

Log Directory: C:\ProgramData\HealthCast\logs

File Name: QAW.ProxCardCredProv.log

Edit QAW.ProxCardCredProv.ini File

  1. Open Notepad (or another text editor) as an administrator.
  2. Browse to C:\ProgramData\HealthCast.
    1. Locate and open the QAW.ProxCardCredProv.ini file.
      • Note: This may also be called the QAW.ini file, depending on the version of XA installed.
  3. In the [debug] section, set: information=1.
  4. Save the changes.

Log Directory: C:\ProgramData\HealthCast\logs

File Name: QAW.ProxCardCredProv.log

Kiosk Mode (KM) Troubleshooting

Enable xahid_kiosk.exe logging when troubleshooting issues with XA running in Kiosk Mode. xahid_kiosk.exe logging provides details about the login process, including badge information.

Enable xahid_kiosk.exe Logging

  1. Open Notepad (or another text editor) as an administrator.
  2. Browse to C:\Program Files (x86)\HealthCast\eXactACCESS.
    1. Locate and open the xahid_kiosk.exe.ini file.
      • Note: The file name may vary slightly depending on the version of XA installed.
  3. In the [debug] section, set: information=1.
  4. Save the changes.

Log Directory: C:\ProgramData\HealthCast\logs

File Name: XAHID_kiosk.txt.debuglog

Other Client Service Troubleshooting

Logging can be enabled for the following XA Client services for troubleshooting particularly difficult-to-resolve issues. Generally, logging for these components is not necessary, and will be requested by Engineering on a case-by-case basis when additional diagnostic detail is required.

Enable HCLFOMessaging.exe Logging

  1. Open Notepad (or another text editor) as an administrator.

  2. Browse to C:\Program Files (x86)\Common Files\HealthCast\bin.

    1. Locate and open the HCLFOMessaging.exe.ini file.

  3. In the [debug] section, set: information=1.

  4. Save the changes.


Log Directory: C:\ProgramData\HealthCast\logs

File Name: HCLFOMessaging.txt.debuglog


Enable HCLFOSysServices.exe Logging

  1. Open Notepad (or another text editor) as an administrator.

  2. Browse to C:\Program Files (x86)\Common Files\HealthCast\bin.

    1. Locate and open the HCLFOMessaging.exe.ini file.

  3. In the [debug] section, set: information=1.

  4. Save the changes.


Log Directory: C:\ProgramData\HealthCast\logs

File Name: HCLFOSysServices.txt.debuglog


Enable HealthCastWLLSvc.exe Logging

  1. Open Notepad (or another text editor) as an administrator.

  2. Browse to C:\Program Files (x86)\Common Files\HealthCast\bin.

    1. Locate and open the HealthCastWLLSvc.exe.ini file.

  3. In the [debug] section, set: information=1.

  4. Save the changes.


Log Directory: C:\ProgramData\HealthCast\logs

File Name: HealthCastWLLSvc.txt.debuglog