SAS Companion for the OS/2 Environment

Customizing the Toolbar

SAS assigns several commonly used commands to the toolbar icons for your convenience. You might find that the commands that you use most often are different from those that are assigned to the toolbar by default. Or, you might want to create a toolbar to use with a specific application window or SAS/AF program. This section describes how to customize the toolbar settings.

You customize all toolbar settings using the Customize tools dialog box. To open the Customize Tools dialog box, select Customize from the Tools menu. You use the Toolbars page for general toolbar settings. You use the Customize page to define tools on the toolbar.

Setting General Toolbar Preferences

The Toolbars page lets you specify options that control the behavior and appearance of the toolbar. Tools options include

General

specifies toolbar icon appearance and Help options. These options include

Large icons: specifies whether to use the set of large tool icons on the toolbar. This is especially useful for high-resolution displays.
Show ScreenTips on toolbars: specifies whether to display a one- or two-word description of the toolbar icon when you place the cursor over the toolbar icon.

Toolbars

specifies whether to display the toolbar and command bar. These options include

Application Toolbar

specifies whether to display the toolbar for the active application. When this option is enabled, you can select Display as box for the toolbar to display in a separate window. Otherwise, the toolbar is integrated into the main SAS window.

Command Bar

specifies that the command bar is to be displayed and the options be enabled in order to use the command bar.

	When Display as box is enabled, the command bar displays as a separate window.
	When Use AutoComplete is enabled, SAS remembers previously entered commands and completes entering the command once you start typing the command.
	Select Sort commands by most recently used to display commands in the command bar drop-down list in the order of the most recently entered command.
	In the Number of commands saved box, type the number of commands to save to display in the command bar list box. Valid values range from 0 and 50. The default is 15.

When you have configured the Toolbars page, either click on Customize to complete your customization or click on [OK] to close the dialog box.

Customizing a Toolbar

The Customize page allows you to add, delete, and modify commands on the toolbar. Customize Page of the Customize Tools Dialog Box shows the Customize page of the Customize Tools dialog box.

Customize Page of the Customize Tools Dialog Box

[IMAGE]

You may recognize some icons as standard OS/2 icons, such as the OPEN and SAVE commands. The following section explains each of the icons (commands) and fields.

The three icons that act on the file that contains the toolbar definition are, from left to right:

the open icon opens a toolbar file.
the save icon saves a toolbar file.
the restore icon restores a toolbar to the default settings.

Title

displays the title of the toolbar, which displays as the window title when the toolbar is undocked.

Commands to define a toolbar are available as a series of eight icons that act upon the toolbar. From left to right:

Add a tool: adds a command or a separator space to the toolbar. To add a tool or a separator, click on the icon and select either Blank tool or Separator. Windows that already define an action set will have a selection for Action.
Remove tool: deletes a highlighted command in the toolbar list box from the toolbar.
Change icon: opens the Bitmap Browser to select a new icon for a command.
Move tool up: moves a command up one position in the toolbar list box.
Move tool down: moves a command down one position in the toolbar list box.
Cut: deletes the currently selected icon from the toolbar list box and places it on the clipboard.
Copy: places a copy of the selected icon on the clipboard.
Paste: copies an icon from the clipboard to the highlighted command in the toolbar list box.

Command

displays the command for the highlighted command in the toolbar list box. You can then either add or modify a SAS command.

Help Text

displays the Help text that appears in the status bar when the cursor is placed over the icon in the toolbar. You can add to or modify the Help text in the text box.

Tip Text

displays the tip text that appears under the icon when the cursor is placed over the icon in the toolbar. You can add to or modify the tip text in the text box.

Toolbar list box

lists the icons, commands, Help text and separators that are defined in the toolbar.

To close the dialog box, click on [OK].

Adding a Tool to the Toolbar

To add a tool to the toolbar, follow these steps:

Do one of the following:
Click on the Bitmap Browser icon. Select an icon in the Bitmap Browser dialog box and click on [OK].
Type text in the Help Text field that will appear on the status line when you select the tool from the toolbar.
Type text in the Tip Text field that appears under the icon when you place the cursor over the icon.
Position the tool in the tool list by clicking on the Move Up and Move Down icons.
When you are finished, click on the Save icon. In the Save Tools dialog box, type the library, catalog, and toolbox names. Then click on [OK].

Removing a Tool from the Toolbar

To remove a tool from the toolbar, select the tool that you want to remove in the toolbar list box. Click on the Remove Tool icon. When you are finished, save the toolbar by clicking on the Save icon.

Customizing and Saving a Toolbar for Use with a Particular Application or Window

To customize and save a toolbar for use with a particular application or window, follow these steps.

Customize the toolbar by adding and removing tool icons as described.
When you have finished customizing the toolbar, click on the Save icon. The Save Tools dialog box appears.
In the Save Tools dialog box, complete the information in the LIBREF, CATALOG, and ENTRY fields, indicating where you want to store the toolbar information. If you want to associate this toolbar with a particular application or window, use the same library, catalog, and entry name as the PMENU entry for the window or application. For example, to store a customized toolbar for the graphics editor, you would save the tool settings in SASHELP.GI.GEDIT.

CAUTION:
If you save tool settings to the SASHELP library, you might overwrite the Institute-supplied tool settings; therefore, you would not be able to restore the Institute-supplied default settings.
You can also store tool settings in the SASUSER.PROFILE catalog using the same entry name as the PMENU entry for the window or application. SAS first looks for toolbox entries in SASUSER.PROFILE before searching the application catalog.
You can automatically assign the toolbar to the active window by clicking on the Save tools for window check box. When you are finished, click on [OK].

If you save the toolbar so that it is associated with a particular application, SAS will automatically load the tools when that application's window is active.

You can use the TOOLLOAD command to load your custom toolbar manually. For more information, see TOOLLOAD.

Resetting the Tools to the Default Settings

To reset the tools to the default settings, click on the Restore Defaults icon. SAS asks you to confirm that you want to reset the tool settings. When you click on Yes, the tools are reset to their original settings (the settings that are in place when the SAS System was installed).

If a SAS application defines a default toolbar for its application window, clicking on the Restore Defaults icon restores the settings for that toolbar.

Examples of Useful Tools You Can Create

To create a tool that opens the SAS online documentation (SAS OnlineDoc) follow these steps:

In the Tool Editor dialog box, click on the Add tool icon. This creates a template for a new tool in the tool list.
In the Command field, type sasdoc onlinedoc, which invokes the SAS OnlineDoc product. For more information about SAS commands that are specific to OS/2 and their options, see SAS Commands under OS/2. For information about portable SAS commands, refer to the SAS online Hhelp.
In the Help Text field, type Open the SAS OnlineDoc. In the Tip Text field, type SAS OnlineDoc.
Click on the Bitmap Browser icon. From the Bitmap Browser dialog box, select a bitmap that is appropriate for the Help action (such as the Help bitmap) and click on [OK].
Use the Move Up and Move Down icons to move the tool to the location that you want on the toolbar or toolbox.
Click on the Save icon to save the tool with your default tool configuration.

The following are some other tools that you might find useful to create.

PGM; CLEAR; INCLUDE C:\SAS\MYPROGRAM.SAS

includes a program that you use often into the Program Editor window for editing.

PGM; FILE C:\SAS\MYPROGRAM.SAS; CLEAR

saves a SAS program after you finish editing it and clears the Program Editor window.

PGM; CLEAR; INCLUDE C:\SAS\MYPROGRAM.SAS; SUBMIT

includes and submits a SAS program that you use often.

PGM; CLEAR; INCLUDE C:\SAS\SIGNON.SAS; SUBMIT

includes and submits a SAS program to sign on to a remote system. For example, to sign on to a remote MVS session, the SIGNON.SAS program might contain the folowing statements:

options comamid=ehllapi remote=mytso;
libname remtdata 'mylib.mydata.monthly';
signon;

For more information about signing on to remote sessions, see SAS/CONNECT User's Guide.

PGM; CLEAR; INCLUDE C:\SAS\DOWNLOAD.SAS; SUBMIT

includes and submits a SAS program to download a data set from a remote session. Assuming that you have already signed on to the remote session, DOWNLOAD.SAS might contain the following statements:

proc download data=remtdata.june;
   /* where libname 'remtdata' is */
   /* already defined             */
run;

For more information about signing on to remote sessions, see SAS/CONNECT User's Guide.

TOOLLOAD BAR SASUSER.PROFILE.MORTOOLS

loads a different toolbar (that you created) that contains another collection of tools.

Chapter Contents
Previous
Next
Top of Page