The SAS ToolBox in UNIX Environments | SAS 9.1 Companion For Unix Enivronments

Introduction to the SAS ToolBox

The SAS ToolBox has two parts as illustrated in the following display:

A command window that enables you to quickly enter any command in the active SAS window. For information about commands that are available under UNIX, see Chapter 9, "Commands under UNIX," on page 201 and the SAS commands section in the Base SAS Software section in SAS Help and Documentation.
A toolbar that contains several tool icons. When you select a tool icon, SAS immediately executes the command that is associated with that icon. The toolbar and the tool icons are completely customizable. For more information, see "Using the Tool Editor" on page 68.

Display 2.4: SAS ToolBox

The name of the active window is displayed in the title bar of the SAS ToolBox. For example, if the Log window were active, the title bar would say SAS ToolBox: Log instead of SAS ToolBox: Program Editor.

Under UNIX, the default SAS ToolBox automatically appears at the bottom of the SAS windows stack by default. To control its configuration, you use the Preferences dialog box. (See "Modifying the ToolBox Settings" on page 60.)

Customizing the Default Toolbox

The default toolbox is automatically copied to your SASUSER.PROFILE.DMS.TOOLBOX regardless of whether you customize the toolbox. If you invoke an application that does not have an associated PMENU entry, the default toolbox is displayed for that application. If you then customize the toolbox for that application, the customized toolbox is stored in SASUSER.PROFILE.DEFAULT.TOOLBOX, where DEFAULT is the same entry name as the PMENU entry for the window or application.

You can customize the default toolbox, create multiple toolboxes and switch between them, and create application-specific toolboxes (such as with SAS/AF applications) that are automatically loaded when the application is loaded. Only one toolbox is displayed at a time, and the tools in the toolbox change as you move between applications. For more information about customizing your toolboxes, see "Customizing Toolboxes and Toolsets in UNIX Environments" on page 67.

Default Configuration for the Command Window and the Toolbar

By default, the toolbar and the command window are joined and are automatically displayed when SAS initializes unless

you executed your SAS job in a nonwindowing environment mode.
the SAS.defaultToolBox or SAS.defaultCommandWindow resource is set to False . The default value is True . For more information about the resources that control the toolbox, see "X Resources That Control Toolbox Behavior" on page 67.
you deselect Display tools window , Display command window , or Combine windows from the Toolbox tab in the Preferences dialog box.

The following display shows the command window and the toolbar in their default configuration.

Display 2.5: Default Configuration for Command Window and Toolbar

Opening and Closing the Command Window and the Toolbar

The following table lists the steps that you can use to open and close the command window and toolbar.

Table 2.1: Steps for Opening and Closing the Command Window and the Toolbar
Window	How to Open	How to close
Command Window and Toolbar	To open both windows, complete any of the following steps: Issue the COMMAND WINDOW command. Issue the TOOLLOAD command. See "TOOLLOAD Command" on page 217 for more information. Select Tools – Options – Toolbox	To Close these windows, complete any following steps: Select Close from the ToolBox window menu. Enter the TOOLCLOSE command as described in "TOOLCLOSE Command" on page 216. Select Tools – Options – Toolbox so that ToolBox is deselected.
Command Window	To open only the command window: Deselect Combine windows in the ToolBox tab of the Preferences dialog box. Complete any of the following steps: Select Display command window in the ToolBox tab of the Preferences dialog box. Issue the COMMAND WINDOW command.	To close only the command window: Deselect Display command window in the ToolBox tab of the Preferences dialog box. Select Close from the window menu.
Toolbar	To open only the toolbar: Deselect Combine windows in the ToolBox tab of the Preferences dialog box. Complete any of the following steps: Select Display tools window in the ToolBox tab of the Preferences dialog box. Issue the TOOLLOAD command. See "TOOLLOAD Command" on page 217 for more information. Select Tools – Options – Toolbox	To close only the toolbar: Deselect Combine windows in the ToolBox tab of the Preferences dialog box. Complete any of the following steps: Deselect Display tools window in the ToolBox tab of the Preferences dialog box. Issue the TOOLCLOSE command as described in "TOOLCLOSE Command" on page 216. Select Tools – Options – Toolbox so that ToolBox is deselected.

Executing Commands

You can execute commands from either the command window or the toolbar. The following table gives more details on how to execute commands.

Table 2.2: Executing Commands in the Command Window and the Toolbar
Window	Executing a Command
Command Window	To execute a command, complete the following steps: Click in the command window. Type in the command. Press ENTER or click the check mark. The command is executed in the active SAS window. You can use the up and down arrow keys to scroll through previously entered commands, or you can select a previous command from the drop-down list. Use the left mouse button to select a command from the drop-down list. Use MB2 to select and execute a command from the list.
Toolbar	Clicking a tool icon in the toolbar executes the command or commands associated with that icon. If you place the cursor over an icon for the amount of time specified by the SAS.toolBoxTipDelay resource, a pop-up window displays text that describes the command for that icon.