Using Remote VISA Resource Strings With NI Session Manager

Updated Oct 9, 2026

Reported In

Software

  • LabVIEW
  • TestStand

Driver

  • NI-VISA

Operating System

  • Windows

Issue Details

I am trying to use the SM.IInstrSessionMgr instance to get a handle to a remote GPIB device. I am able to use raw VISA read and write operations to make the connection, so the link to the remote PC is working correctly. However, the error returned through the session manager is:

 

'visa://<hostname>/<resource>' is not a driver session name

 

If I run the VI on the local computer directly connected to the GPIB device using only a local resource string (such as GPIB0::22::INSTR), the connection works as expected. The failure occurs when passing a remote VISA resource string directly into the session manager node without the expected prefix or mapping.

Solution

The IInstrSessionMgr node requires either the explicit session type prefix (VISA::) prepended to the remote resource string or a logical name configured in NISessionMgr.ini.

 

  1. Prepend the VISA:: prefix to the full remote VISA resource string:
    VISA::visa://<hostname_or_IP>/<resource>

    Example:
    VISA::visa://remotehostname/GPIB0::22::INSTR
  2. Pass the resulting string directly to the Session Name input terminal of the GetInstrSession method.

 

Method 2: Configure a Logical Name in NISessionMgr.ini

  1. Locate or create NISessionMgr.ini at C:\Program Files\IVI Foundation\VISA\Win64, and open it in a text editor. 
  2. Locate or create the [VISA Logical Names] section header.
  3. Add an entry mapping your desired logical name to the remote VISA resource string:
    [VISA Logical Names]
    <LogicalName> = "visa://<Host_or_IP>/<Resource>"

    Example:

    [VISA Logical Names]
    DMM1 = "visa://remotehostname/GPIB0::22::INSTR"
  4. Save and close NISessionMgr.ini.
  5. Pass the logical name formatted as VISA::<LogicalName> (for example, VISA::DMM1) to the Session Name input terminal of the GetInstrSession method.