Workspaces: Overview

IML Studio manages each program in a workspace. Prior to the 13.1 release of IML Studio, there was only one type of workspace, which ran IMLPlus programs. Beginning with the 13.1 release of IML Studio, there are two types of workspaces: an IMLPlus workspace for running IMLPlus programs, and a SAS workspace for running conventional SAS programs.

A workspace consists of the following:

• The program window containing the source statements for the program
• The symbol table for the program (IMLPlus workspaces only)
• The server used to run the program
• The Auxiliary Input window for the program (IMLPlus workspaces only)
• The error log window for the program
• The HTML output window for the program
• Any LISTING output document windows attached to the program
• Any data view windows attached to the program

There is always a one-to-one correspondence between a program window and a workspace. It is not possible to have two program windows share a workspace, nor is it possible to have a single program window connected to more than one workspace.

Whenever you create a new program or open an existing program, IML Studio automatically creates a workspace for that program. When you open a program from a file, IML Studio determines the type of workspace to create based on the filename extension. If the filename extension is .sx or .sxs, IML Studio creates an IMLPlus workspace. If the filename extension is .sas, IML Studio creates a SAS workspace.

Initially, the workspace consists only of the program window. The first time you run the program, IML Studio creates a symbol table for the program and establishes a connection to the server on which the program will run. As the program runs, it may create an output window and multiple data view windows. If an error occurs during the program's execution, IML Studio creates an error log window.

The Workspace bar, which is located above the Status bar at the bottom of the IML Studio window, contains a button for each workspace. Each button is labeled with the root filename of the program associated with the workspace. If a program has not yet been saved, its button is labeled "Workspace N", where N is a number. The button corresponding to the active workspace is displayed in a pressed state.

To activate a different workspace

On the Workspace bar, click the program's button.

–or–

Press CTRL+F5 to activate the next program.

–or–

Press CTRL+SHIFT+F5 to activate the previous program.

You can also activate different workspaces using the Activate Program dialog box.

To activate a workspace using the Activate Program dialog box

1. On the Program menu, click Activate.

   IML Studio will display the Activate Program dialog box.

2. In the Programs list, select the program you want to activate.
3. Press ENTER.
   –or–
   Click Activate.
   –or–
   Double-click the program's name in the Programs list.

Only one workspace can be active at a time. By default, IML Studio displays only the windows associated with the active workspace. The windows associated with all other workspaces are hidden. (You can alter this behavior to suit your personal preferences. For further information, see Window Properties.) If a program is running, it continues to run regardless of whether or not it is the active program.

There are several icons that can appear in the Workspace bar buttons. Each icon indicates a particular program state.

	Indicates that the program is running.
	Indicates that the program stopped running because an error occurred.
	Indicates that the program is in the paused state either because a PAUSE statement was executed or because the Pause command was used. (IMLPlus workspaces only)

If no icon is displayed in a button, it means either that the program has not yet been run or that the program finished running without experiencing any errors.