Error: F_JD0A57 Failed to Retrieve Database Server Process Handle
Issue
While activating capture for a SQL Server source, the capture process fails with the following error:
F_JD0A57: Failed to retrieve database server process handle: The parameter is incorrect.
Environment
- HVR 6
- RDBMS: SQL Server Cluster Source
- OS: Windows
Resolution
To resolve this issue, choose the solution that matches your architecture requirements:
Option 1: Re-align the HVR Agent host
If you use the direct capture method (Capture_Method=DIRECT), configure the HVR Agent to connect directly to the read-only replica instead of the primary host:
- In the HVR UI, go to Capture Location Properties.
- In the Agent Host or Server field, enter the hostname or IP address of the read-only replica machine.
Option 2: Switch the capture method to SQL
Use this solution if the HVR Agent must remain on the primary host while the database connection uses a read-only replica:
- In the HVR UI, open the Capture Action or Location Properties for the source location.
- Change the Capture Method from Direct to SQL.
Cause
This issue occurs during direct capture when the HVR Agent host and database connection resolve to different SQL Server instances, typically in a SQL Server Always On or other high-availability environment.
Both the HVR Agent connection and the database connection use the same TNS/Server alias, which by default resolves to the primary SQL Server instance. However, the database connection is subsequently routed to a read-only secondary instance. As a result, direct capture runs on the primary node while the database connection runs on the secondary node.
When this happens:
- HVR capture runs on the primary machine.
- The database query returns a process ID (PID) belonging to the read-only machine.
- HVR can't find that PID in the primary machine's local OS process table, resulting in the above error.
For more information about this capture method, see Capture From SQL Server Using Direct Transaction Log Access.