Testing xfNetLink Java

The xfNLJTest program, distributed with xfNetLink Java, can help you determine if your system is set up and working properly.

XfNLJTest runs several tests, which call functions and send different types of data back and forth between the Java client and the Synergy server. This program makes calls to a test ELB or shared image named xfpl_tst, which is distributed with xfServerPlus. There are entries in the SMC for use by the test program. (These are the methods in the xfTest interface in the distributed SMC.) If the ELB or any of the methods are missing, the tests will fail.

Note

If the methods in the xfTest interface are not present in your SMC, you can import them from the defaultsmc.xml file. See Importing and exporting methods.

To run the xfNLJTest program

1. Make sure xfServerPlus has been started on the server machine.
2. On the client machine, go to the directory in which you installed xfNetLink Java and type the following at the command line:
java xfNLJTest xfServerMachineName xfServerPort

For example:

java xfNLJTest elmo 2356

As the tests run, information is printed to the screen and saved to the xfNLJtst.txt file. This file is created in the directory from which you ran the test. You will see a line describing each test and a message stating whether the test completed successfully. The output also includes the versions of xfNetLink and xfServerPlus, which may be helpful in troubleshooting.

Note

(Windows) If you see the message “xfNLJTest.txt (Access is denied)”, it means that the user account under which you are logged on does not have write permission for the \Program Files directory, and so the log file cannot be written. Just copy the xfNLJTest.class file to a writable location and run the test from there.

You may receive errors in the form of Java exceptions, which are also written to xfNLJtst.txt. The error message text should help you determine what needs to be done to correct the problem. Check the xfNetLink Java Exceptions table.

You may want to also run the xfServerPlus test program, xfspltst. It can help you determine whether the problem is on the xfNetLink side or the xfServerPlus side. See Testing xfServerPlus for more information.

If you cannot solve the problem, call the Synergy/DE Developer Support department. Be sure to save the xfNLJtst.txt file; your Developer Support engineer needs the information in this file to help you.