Get Software Tools

You need the following tools to try tutorial steps yourself using the nqueens_fortran sample application:

• Intel Inspector installation package and license

• .zip file extraction utility

• Supported compiler (see Release Notes for more information)

Acquire the Intel Inspector

If you do not already have access to the Intel Inspector, you can download it for free as follows:

• standalone version
• part of the Intel® oneAPI HPC Toolkit

Install and Set Up the Intel Inspector Sample Applications

1. Copy the nqueens_fortran.zip file from the <install-dir>\samples\<locale>\Fortran\ directory to a writable directory or share on your system. The default <install-dir> is below C:\Program Files\Intel (x86)\ (on certain systems, instead of Program Files (x86), the directory name is Program Files).

2. Extract the sample from the .zip file to create the nqueens_fortran directory.

Understand Optimal Compiler/Linker Settings

You can use the Intel® Inspector to analyze memory and threading errors in both debug and release modes of C++ and Fortran binaries; however, applications compiled/linked in debug mode using the following settings produce the most accurate and complete analysis results.

Build the Application

1. Find Visual Studio Tools for your Visual Studio* and OS version, and select one of the command prompt shortcuts. For example, from the Microsoft Windows* 10 All Apps screen, select Visual Studio 2013 > Visual Studio Tools > VS2013 x64 Native Tools Command Prompt.

2. In the command prompt window, change directory to the nqueens_fortran\ directory in its unzipped location.

3. Type devenv nqueens_fortran.sln /Build to build all projects in the solution.

Verify the Application Runs Outside the Intel Inspector

1. Change directory to threading_issues\Debug\.

2. Type threading_issues.exe to execute the application.

3. Check for non-deterministic application output (that also varies by number of cores) similar to the following:

   Usage: threading_issues.exe boardSize
   Using default size of 10
   Starting nqueens solver for size 10 with 2 thread(s)
   Number of solutions: 1333
   Incorrect result!
   Calculations took 31 ms.

Set up the Intel Inspector Environment

For the Intel Inspector in the Intel Parallel Studio XE, do one of the following to set up your environment:

• Run the <inspector-install-dir>\inspxe-vars.bat command.

  The default installation path, <inspector-install-dir>, is below C:\Program Files (x86)\IntelSWTools\ (on certain systems, instead of Program Files (x86), the directory name is Program Files ).

• Run the <studio-install-dir>\psxevars.bat command.

  The default installation path, <studio-install-dir>, is below C:\Program Files (x86)\IntelSWTools\.

For the Intel Inspector in the Intel System Studio, run the <inspector-install-dir>\inspxe-vars.bat command to set up your environment. The default installation path, <inspector-install-dir>, is below C:\Program Files (x86)\IntelSWTools\ (on certain systems, instead of Program Files (x86), the directory name is Program Files ).

For the application as part of an Intel® HPC Toolkit or Intel® IoT Toolkit installation, run the <oneapi-install-dir>\env\vars.bat command. The default installation path, <oneapi-install-dir>, is inside C:\Program Files (x86)\Intel\oneAPI .

Open the Intel Inspector Standalone GUI

For the Intel Inspector standalone GUI in the Intel Parallel Studio XE, do one of the following:

• Run the inspxe-gui command.

• From the Microsoft Windows* 7 Start menu, select Intel Parallel Studio XE [version] > Analyzers > Intel Inspector [version].

• From the Microsoft Windows* 8/8.1/10 All Apps screen, select Intel Parallel Studio XE [version] > Intel Inspector [version].

For the Intel Inspector standalone GUI in the Intel System Studio, do one of the following:

• Run the inspxe-gui command.

• From the Microsoft Windows* 7 Start menu, select Intel System Studio [version] for Windows target > Analyzers > Intel Inspector [version] for Systems.

• From the Microsoft Windows* 8/8.1/10 All Apps screen, select Intel System Studio [version] for Windows target > Intel Inspector [version] for Systems.

Create a New Project

1. Choose File > New > Project... to display a dialog box similar to the following:

   

2. In the Project name field, type threading_issues. Then click the Create project button to create a config.inspxeproj file in the \Inspector\Projects\threading_issues\ directory (default location) and display a dialog box similar to the following:

   

3. Click the Browse button next to the Application field and select the nqueens_fortran\threading_issues\Debug\threading_issues.exe application. Notice the Intel Inspector autofills the project Working directory field for you. Then click the OK button to return to the Welcome page, where the name of the opened project displays in the title bar and in the Project Navigator pane. (If necessary, choose View > Project Navigator to display the Project Navigator.)