Before developing or running a COM program, you should first establish communication between your PC and the analyzer. This process is referred to as gaining Access to the analyzer. You should then register the PNA type library on your PC.
DCOM (Distributed Component Object Model) refers to accessing the PNA from a remote PC.
COM refers to accessing the PNA application from the analyzer PC.
Note: After performing a Firmware Upgrade you must copy the new type library to your development PC to get access to new COM commands. See Register the analyzer on your PC.
Other Topics about COM Concepts
For detailed information on this subject, see http://na.support.keysight.com/pna/DCOMSecurity.html
Note: 64-bit compiler option is supported.
PNAs are shipped from the factory such that Everyone has permission to launch and access the PNA application via COM/DCOM. The term Everyone refers to a different range of users depending on whether the PNA is a member of a Domain or Workgroup (it must be one or the other; not both). By default, the PNA is configured as members of a workgroup. Therefore, Everyone includes only those users who have been given logon accounts on the PNA.
A workgroup is established by the PNA administrator declaring the workgroup name and declaring the PNA as a member of the workgroup. A workgroup does not require a network administrator to create it or control membership.
Everyone includes only those users who have been given logon accounts on the PNA.
By default, the PNA is configured as members of a workgroup named WORKGROUP.
Note: To setup
a logon account for a new user, see Additional
Users.
The easiest method of gaining DCOM access, is to make the user's account
name and password on the PNA to EXACTLY match their PC logon account name
and password.
A domain is typically a large organizational group of computers. Network administrators maintain the domain and control which machines have membership in it.
Everyone includes those people who have membership in the domain. In addition, those with logon accounts can also access the analyzer.
A Workgroup requires no maintenance, but allows DCOM access to only those users with a log-on account for the PNA.
A Domain requires an administrator, but all members of the domain and those with logons to the analyzer are allowed DCOM access to the PNA.
The following section "Access Procedures" provides a tighter level of security allowing only selected (not Everyone) domain and workgroup users DCOM Access and Launch capability of the PNA.
Perform this procedure for the following reasons:
To allow only selected users (not everyone) remote Access and remote Launch capability to the PNA. Launch capability is starting the PNA application if it is not already open.
To verify that you have DCOM access to the analyzer.
Note: Before doing this procedure, you must first have a logon account on the PNA. See PNA User Accounts
The following procedure grants specific users DCOM access and launch capability of the PNA application:
To perform this procedure, you must first minimize the PNA application.
How do I know which Operating System I have?
Windows 7 |
On the PNA, click the Windows Start button |
Click Run |
In the Open: box, type dcomcnfg |
Click OK |
Open the following folder sequence: Component Services Computers My Computer DCOM Config Right click Keysight PNA Series Click Properties |
Click the Security tab |
Under Access Permissions, click Customize, then click Edit |
Select Everyone, then click Remove |
Click Add |
Type a group name or user account name |
Click OK |
|
Under Launch Permissions, click Customize, then click Edit |
Select Everyone, then click Remove |
Click Add |
Type a group name or user account name |
Click OK |
Register the PNA Type Library on Your PC
The type library contains the PNA object model. On your PC, there is a Registry file that keeps track of where object models are located. Therefore, you must register the type library on the PC that will be used to develop code and run the program. It is much more efficient to have the type library registered at design time (BEFORE running your COM program).
Do the following two items before proceeding:
Connect your PC and the PNA to LAN.
Either map a drive to the analyzer or copy the type library files on a floppy disk or other media. See Drive Mapping.
Note: To register the type library on your PC, you must be logged on as an administrator of your PC. Learn about User Accounts.
This procedure will do the following:
Register the Network Analyzer application on your PC.
Copy and register the proxystub (835xps.DLL) onto the PC.
Copy and register the PNA type library (835x.tlb) onto the PC.
Copy and register the FCA type library (fca.tlb) onto the PC.
Using Windows Explorer on your PC, find the Analyzer's C: drive. The drive will not be named "C:" on your PC, but a letter you assigned when mapping the drive.
Navigate to Program Files / Keysight / Network Analyzer / Automation
Double-click pnaproxy.exe and follow the prompts to Install PNA Proxy. If the installation offers a choice of Modify, Repair, or Remove, then select Remove. Then double-click on pnaproxy.exe again.
When prompted, type the Computer name of the PNA (Learn how to find this).
After the install program runs, the PNA and FCA type library should be registered on your PC.
Your programming environment may require you to set a reference to the PNA type library now located on your PC. In Visual Basic, click Project, References. Then browse to C:/Program Files/Common Files/Keysight/PNA Select 835x.tlb
These procedures will fail if there are any programs using the PNA type library (for example: Visual basic, VEE, Visual Studio, or any other application program that may communicate with the PNA).
Perform the following procedure if the previous procedure did not return an error, but you cannot connect to the PNA.
If you received an error, check that both the account name and password used on both the PNA and PC match EXACTLY.
If you still get errors, see http://na.support.keysight.com/pna/DCOMSecurity.html.
Map a drive from
your remote PC to the PNA. Note the drive letter your PC assigns to
the PNA.
Substitute this drive letter for PNA
in the following procedure.
On your PC, go to a DOS prompt c:>
Type PNA: (for example o:)
Type cd program files/Keysight/network analyzer/automation
Type copy 835xps.dll c:/program files/common files/Keysight/pna
Type copy 835x.tlb c:/program files/common files/Keysight/pna
If you will NOT be using FCA commands, skip steps 7,.8, and 9.
Type cd..
Type cd extensions/fca
Type copy fca.tlb c:/program files/common files/Keysight/pna
If it is not already there, copy regtlib.exe from PNA:/WINNT to your C:/<windows>/system32 directory (<windows> is OS-dependent- it is either windows or WINNT)
Type regtlib C:/program files/common files/Keysight/pna/835x.tlb
Type regsvr32 C:/program files/common files/Keysight/pna/835xps.dll
Type regtlib C:/program files/common files/Keysight/pna/fca.tlb
Perform the Access Procedure after doing these steps.