Attaching and Detaching Windows

Each workspace has a set of MDI windows attached (logically connected) to it. The set of windows attached to a workspace always contains a program window and may also contain an error log window, data view windows, and output windows. Whereas there is always a one-to-one correspondence between a program window and a workspace and between an error log window and a workspace, data view and LISTING output document windows are different for the following reasons:

• Multiple data view windows can be attached to a workspace.
• The creation of a data view window may, or may not, cause IML Studio to create a new workspace.
• A LISTING output document window can be attached to multiple workspaces or to no workspace.

Note: There is always a one-to-one correspondence between an HTML output window and a workspace.

Data View Windows

The following table shows the circumstances under which IML Studio attaches a new data view window to the active workspace:

Notes

• If no workspace is active, IML Studio creates a new workspace to contain the data view window.
• If a workspace's program window has never been saved, the name of the workspace is the name of the first data set attached to the workspace.

LISTING Output Document Windows

The following table shows the circumstances under which IML Studio attaches a new LISTING output document window to the active workspace:

Notes

• If no workspace is active, the LISTING output document window is not attached to any workspace.
• The first LISTING output document window to be attached to a workspace becomes the default LISTING output document window. A workspace's default LISTING output document window is the window to which ODS LISTING output from the IMLPlus program is directed.

If you want to use a particular LISTING output document window in more than one workspace, you can attach the window to additional workspaces.

To attach LISTING output document windows to a workspace

1. Activate the workspace to which you want to attach the windows.
2. On the Program menu, click Configure.

   IML Studio will display the Configure Program dialog box.

3. Click the Windows tab.
4. Click Attach.

   IML Studio will display the Attach LISTING Output Documents dialog box.

5. In the LISTING Output Documents list, select the documents you want to attach to the workspace.

   You can select multiple items either by holding down the CTRL key while you click the left mouse button or by holding down the SHIFT key while you press the UP or DOWN arrow keys.

6. Click OK to close the Attach LISTING Output Documents dialog box.
7. Click OK to close the Configure Program dialog box.

You can also detach LISTING output document windows from a workspace.

To detach a LISTING output document window from a workspace

1. Activate the workspace from which you want to detach the window.
2. On the Program menu, click Configure.

   IML Studio will display the Configure Program dialog box.

3. Click the Windows tab.
4. In the Attached LISTING Output Documents list, select the document you want to detach.
5. Click Detach.
6. Click OK.

   If the workspace from which you just detached the window is the last workspace to which the window was attached and the window's Auto Close property is turned on, IML Studio will attempt to close the window. If the window's content changed since the last time it was saved, IML Studio will ask you whether you want to save those changes. If you click Cancel, IML Studio will not close the window and will turn off the window's Auto Close property. The window will, however, be detached from all workspaces.