Using a Node Locked License

A node locked license allows unimited use on a single machine. It does not require a license manager daemon.

1. Send the Licensed System's IP Address

Execute the commands:

cd install/license (Unix)
java -jar hostid.jar > hostid.txt

cd install\license (Windows)
java -jar hostid.jar > hostid.txt

where install is the directory in which the JMSL Numerical Library has been installed.

The output of these commands is a file hostid.txt. Please return this form to the Visual Numerics office neares t you, Attn: License Manager Administrator

Completed forms can also be mailed to:

Visual Numerics, Inc.
Attn: License Manager Administrator
2500 Wilcrest Drive, Suite 200
Houston, Texas, 77042
U.S.A.

2. Create the License File

Cut and paste the contents of the e-main from the Visual Numerics License Administrator to the file

install/license/license.dat (Unix)

install\license\license.dat (Windows)

where install is the directory in which the JMSL Numerical Library has been installed.

3. Run the licensed client

JMSL Numerical Library applications need to be able to find the license file. This is done by setting a system property as an argument to the Java program, as follows:

java -Dcom.imsl.license.path= install/license/license.dat MyMainClass (Unix)

java -Dcom.imsl.license.path= install\license\license.dat MyMainClass (Windows)

where install is the directory in which the JMSL Numerical Library has been installed.

If the com.imsl.license.path system property is not specified then the client first looks for a license file called license.dat in its current directory and then tries to contact a license server running on the local machine. If no license can be found, the application throws an exception and terminates.

Advanced System Properties

The license manager in JMSL Numerical Library applications is controlled by the system properties.

Java system properties can be set on the command line using the -D option, as follows:

java -Dcom.imsl.license.path=mylicense.dat MyMainClass

System properties can be set within an application by using the System.setProperty(key, value) method.

Property Value Meaning

com.imsl.license.path License file path A location in your installation hierarchy which indicates the expected license file location. This is a combination of one or more license file paths and [port]@host specifications. Multiple components of the list are separated by a semicolon (;) on Windows or colon (:) on UNIX. Redundant servers are not supported in Java. Default is license.dat:@localhost (Windows) or license.dat:@localhost (Unix).

com.imsl.license.queue true or false If true, automatically wait in the queue for a license without asking. Default is to ask the user.

com.imsl.license.popup true or false If true, use a dialog box to show any license manager errors or to ask the user about waiting for a license. If false, errors only result in this exception being thrown. The user is asked on the console about waiting for a license. Default is to use a popup.

Back

Property	Value	Meaning
`com.imsl.license.path`	License file path	A location in your installation hierarchy which indicates the expected license file location. This is a combination of one or more license file paths and `[port]@host` specifications. Multiple components of the list are separated by a semicolon (`;`) on Windows or colon (`:`) on UNIX. Redundant servers are not supported in Java. Default is `license.dat:@localhost` (Windows) or `license.dat:@localhost` (Unix).
`com.imsl.license.queue`	`true` or `false`	If `true`, automatically wait in the queue for a license without asking. Default is to ask the user.
`com.imsl.license.popup`	`true` or `false`	If `true`, use a dialog box to show any license manager errors or to ask the user about waiting for a license. If `false`, errors only result in this exception being thrown. The user is asked on the console about waiting for a license. Default is to use a popup.