Sun WorkShop 6 Installation Guide

Chapter 5

Understanding Fortran Licenses

This chapter describes Fortran licenses and how to use them.

About Fortran Licenses

Sun WorkShop^TM 6 has a new type of license available for Fortran. The new license is a limited license and is available only with the Forte^TM Fortran Desktop Edition 6. You request and install the license in the same manner as other Sun WorkShop licenses. See Chapter 2 and Chapter 4 for license request and license installation instructions.

The limited license disallows the ability to parallelize code, and it limits the scalability of executables to one CPU (Central Processing Unit). The limited license is ideal for creating personal or internal applications that do not require multiple CPUs to function.

Fortran is also available with an unlimited license, which is shipped in Forte^TM Developer University Edition and Forte^TM for High Performance Computing 6 (referred to as HPC in Sun WorkShop Fortran documentation). The unlimited license allows you to parallelize code and does not limit the scalability of the executables.

The Fortran limited license is a node-locked license, and the floating license is an unlimited license. A node-locked license functions with the node-locked workstation that is specified in the license file, and the floating license can function with any workstation. See Chapter for more detail on node-locked and floating licenses.

TABLE 5-1 is a list of the licenses available with the three Fortran products.

TABLE 5-1   Sun WorkShop Fortran Products and License Tokens

Sun WorkShop Fortran Product	License Tokens Available
	Unlimited	Limited
ForteTM Fortran Desktop Edition 6		workshop.f90l.sparc workshop.f77l.sparc
ForteTM Developer University Edition	workshop.f90.sparc workshop.f77.sparc
ForteTM for High Performance Computing 6	workshop.f90.sparc workshop.f77.sparc

Using Fortran Licenses

The license tokens available in the Forte Fortran Desktop Edition 6 compiler are workshop.f90l.sparc and workshop.f77l.sparc, which are both limited. The Fortran limited license will not allow you to use any parallelization when you compile. The three parallelization flags that will not function with the limited license are:

• -parallel
• -explicitpar
• -autopar

Your ability to parallelize depends on the availability of the Fortran licenses. If you have access to an unlimited license, you can use the parallelization flags. If you have access to the limited license only, then you cannot use the parallelization flags. However, if you have access to both a limited and unlimited license, then you can use the parallelization options.

Using Fortran Limited Licenses or Unlimited Licenses

TABLE 5-2 lists the various scenarios and the compile results that occur when parallelization flags are used and not used with the limited license and unlimited license. The scenarios in this table show how the licenses function when you have access to either a limited license or unlimited license, but not both.

TABLE 5-2   Limited or Unlimited License Function With and Without Parallelization Flags

Scenario	Compile Results
	Limited License Token	Unlimited License Token
Parallelization Flag Node-locked Workstation	Error no a.out	parallelized a.out
Parallelization Flag Other Workstation	Error no a.out	parallelized a.out
No Parallelization Flag Node-locked Workstation	non-parallelized a.out	non-parallelized a.out
No Parallelization Flag Other Workstation	Error no a.out	non-parallelized a.out

---

Note – In the Scenarios column of TABLE 5-2, Node-locked Workstation is the workstation that is indicated in the limited (node-locked) license file. Other Workstation is a workstation that is not node-locked to the limited license.

---

Scenario 1

Scenario 1 (TABLE 5-2) shows the results you receive if you use a parallelization flag with a limited license from the node-locked workstation. You cannot compile with the limited license, and you will receive an error message (FIGURE 5-1).

riscjr{impact}11 f90 -parallel -loopinfo f90.f f90: Warning: Optimizer level changed from 0 to 3 to support parallelized code License Error : Licensing product (Sun WorkShop Compiler FORTRAN 90 SPARC). License File: 7588@riscjr License server does not support this feature Feature:workshop.f90.sparc Server name FLEXlm error:-18,147.

FIGURE 5-1   License Error Message

The license_log entry will show an UNSUPPORTED message (FIGURE 5-2).

7:56:36 (sunwlicd) UNSUPPORTED: "workshop.f90.sparc" (PORT_AT_HOST_PLUS ) impact@anyhost (License server does not support this feature (- 18,327))

FIGURE 5-2   UNSUPPORTED Entry in license_log

If you are using an unlimited license, the license server will check out that license, and you can use parallelization options.

Scenario 2

Scenario 2 (TABLE 5-2) shows the results you receive if you use the parallelization flag from a workstation other than the node-locked workstation. If you try to use a limited license, you will receive an error message (FIGURE 5-1) and will not compile. You also will receive an UNSUPPORTED message (FIGURE 5-2) in the license_log. If you are using the unlimited license token, you can parallelize when you compile.

Scenario 3

Scenario 3 (TABLE 5-2) shows the results you receive if you do not use the parallelization flag from a node-locked workstation. If you are using a limited license token, you will not receive an error message, and your compile will complete. If you are using an unlimited license token, you will not receive an error message, and your compile will complete. You will receive an UNSUPPORTED message (FIGURE 5-2) in the license_log.

Scenario 4

Scenario 4 (TABLE 5-2) shows the results you receive if you do not use the parallelization flag from a workstation other than a node-locked workstation. If you are using a limited license, you receive an error message (FIGURE 5-1) and your compilation will not complete. You will receive an UNSUPPORTED message (FIGURE 5-2) in the license_log because the license server searches for the limited license first when no parallelization option is used. However, if you are using an unlimited license, your compilation will complete. You will receive an UNSUPPORTED message (FIGURE 5-2) in the license_log.

Using Fortran Limited Licenses With Unlimited Licenses

If you have access to both Fortran limited and unlimited licenses, you can use parallelization options when you compile. When you have access to both licenses, there is chance that the license will be unavailable. As a standard operation of licensing software, you are placed in a queue and must wait until a license is available. Once a license is available, your compilation will proceed. TABLE 5-3 shows the license function during various scenarios.

---

Note – In the Scenarios column of TABLE 5-3, Node-locked Workstation is the workstation that is indicated in the limited (node-locked) license file. Other Workstation is a workstation that is not node-locked to the limited license.

---

TABLE 5-3   Limited and Unlimited License Function With and Without Parallelization Flags

Scenarios	Compile Results If You Have Both License Tokens
	Both License Tokens Available	Limited License Token Unavailable	Unlimited License Token Unavailable	Both License Tokens Unavailable
Parallelization Flag Node-locked Workstation	parallelized a.out	parallelized a.out	queue parallelized a.out	queue parallelized a.out
Parallelization Flag Other Workstation	parallelized a.out	parallelized a.out	queue parallelized a.out	queue parallelized a.out
No Parallelization Flag Node-locked Workstation	non-parallelized a.out	queue non-parallelized a.out	non-parallelized a.out	queue non-parallelized a.out
No Parallelization Flag Other Workstation	non-parallelized a.out	non-parallelized a.out	queue non-parallelized a.out	queue non-parallelized a.out

Scenario 1

Scenario 1 (TABLE 5-3) shows the license function if you use a parallelization flag from a node-locked workstation. If the unlimited license is available, you can use parallelization flags when you compile. If the unlimited license is not available, you receive a queue message. Once the unlimited license is available, your compilation will proceed. Because you are using parallelization flags, the limited license will not be invoked in this scenario.

Scenario 2

Scenario 2 (TABLE 5-3) shows the license function if a parallelization flag is used from a workstation other than the node-locked. If the unlimited license is available, you can parallelize when you compile. If the unlimited license is not available, you receive a queue message. Once the unlimited license is available, your compilation will proceed. Because you are using parallelization flags, the limited license will not be invoked in this scenario.

Scenario 3

Scenario 3 (TABLE 5-3) shows how the licenses function when you use no parallelization flags from a node-locked workstation. You will receive a queue message if the node-locked license is unavailable, because the license server looks only for the limited license when the parallelization flag is not used. If both licenses are unavailable, you receive a queue message. Once the limited license is available, your compilation will proceed.

Scenario 4

Scenario 4 (TABLE 5-3) shows how the licenses function when you use no parallelization flags from a workstation other than a node-locked workstation. You will receive a queue message when the unlimited license is not available or when neither license is available. Once the unlimited license is available, your compilation will proceed. In all instances, you will receive the following message:

5:58:02 (sunwlicd) DENIED: "workshop.f90l.sparc" avitar@anyhost (Invalid host (-9,333))