|SAS Companion for the OpenVMS Operating Environment|
For all of the operating environments that the SAS System runs under, you can enter commands from many SAS windows. For information about commands that are available under OpenVMS, see Commands and the SAS commands section in the SAS online Help. On many hosts, including OpenVMS, you can use the SAS ToolBox command window to enter commands.
The SAS ToolBox has two parts, as illustrated in SAS ToolBox:
Under OpenVMS, the default ToolBox automatically appears at the bottom of the SAS windows by default. To control its configuration, you use the Preferences dialog box. (See Modifying the Toolbox and Command Window Settings.)
The name of the active window is displayed in the title bar of the toolbox. For example, if the Log window were active, the title bar would say ToolBox: Log instead of ToolBox: Program Editor.
If the toolbox is not displayed automatically when the SAS System initializes, it is due to one of the following reasons:
SAS.defaultToolBoxresource is set to
False. The default value is True. For more information about the resources that control the toolbox, see Specifying Toolbox X Resources.
Display tools windowin the Preferences dialog box. (See Using the Preferences Dialog Box to Modify X Resource Settings.)
If you invoke an application that does not have a toolbox that is supplied by the SAS System, then 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.<entry>.TOOLBOX, where <entry> is the same entry name as the PMENU entry for the application window.
|Customizing Toolboxes and Toolsets|
You can customize toolboxes
The Tool Editor also allows you to create custom toolsets for your SAS applications. A toolset is a set of predefined tools that is associated with an application. Toolsets make it easier for individual users to customize their application toolboxes. If you create a toolset for an application, users can simply choose the tools they want to appear in their toolboxes and do not have to define the icons, commands, tip text, and IDs for those tools. For example, you can define a default toolbox for your application that includes tools for opening files, cutting, copying, and pasting text, and saving files. You can define a toolset that includes those tools and tools for opening the Preferences dialog box, opening the Replace dialog box, and entering the RECALL command. These additional tools will not appear in the users' toolbox unless a user adds them to their toolbox with the Tool Editor. You can view the TOOLSET contents by opening the Tool Editor dialog box and clicking on [Actions...], provided that the TOOLSET name has the same name as the TOOLBOX you are editing. For more information, see Changing an Existing Tool and Creating or Customizing an Application- or Window-Specific Toolset.
|Specifying Toolbox X Resources|
You can control the behavior of toolboxes with the following resources:
SAS.defaultToolBox: [True | False]
SAS.isToolBoxPersistent: [True | False]
SAS.toolBoxAlwaysOnTop: [True | False]
SAS.useCommandToolBoxCombo: [True | False]
SAS.defaultCommandWindowresources control whether the toolbox and command window are displayed. If both are displayed, this resource controls whether they are joined or separated. The default is True.
SAS.useLargeToolBox: [True | False]
SAS.useShowHideDecorations: [True | False]
SAS.useToolBoxTips: [True | False]
tvtwm, may place the toolbox tip behind the toolbox. If this happens in your environment, set this resource to False. The default is True.
|Using the Tool Editor|
The Tool Editor dialog box enables you to modify the contents and appearance of your toolboxes, as shown in Tool Editor Dialog Box. To invoke the Tool Editor dialog box, do one of the following:
Options, and then select
Edit Toolbox.... The
Edit Toolbox...item is displayed when you use the Motif window manager. Contact your system administrator for more information about the Motif window manager.
Tool Editor Dialog Box
By default, the Tool Editor dialog box edits the current toolbox. To edit a different toolbox, invoke the Tool Editor dialog box and click on [Open...]. Then specify the libref, catalog, and entry name for the toolbox that you want to edit. Click on [OK].
After you invoke the Tool Editor dialog box, the toolbox
goes into "preview mode." In preview mode, clicking on a tool
icon makes that icon the current icon and displays its associated commands
Command: field. The current icon always appears selected.
The items in the
ToolBox area of the Tool
Editor dialog box affect the entire toolbox:
Max tools per row:
you open the Tool Editor dialog box, the first icon in the toolbox is the
current icon (the icon appears selected), and its information appears in the
Button: area of the dialog box.
To change an existing tool, you can select a tool from the toolset displayed
by clicking on [Actions...] or you can modify the fields individually.
Note: Clicking on [Actions...] will display
a toolset only if a toolset is associated with (has the same entry name as)
the toolbox that you are editing. For more information, see Saving Changes to the Toolbox or Toolset.
To use [Actions...], select the tool that you want to change, and then select [Actions...]. The Tool Editor displays the toolset associated with the toolbox. If you select a tool from this toolset, the Tool Editor enters the appropriate information into the button fields for you.
To modify the fields individually, perform the following steps:
Button:area fields as appropriate:
Separate commands with a semicolon (;).
Icon Categoryfield and select a new category.
To add an icon to the toolbox, perform the following steps:
Button:area fields. These fields are described in Changing an Existing Tool.
change the position of a tool in the toolbox, select the icon, and then click
on the left or right arrows in the
Button: area to move the icon.
To delete a tool icon from the toolbox:
return all tools in the current toolbox to their default settings, click on [Defaults...] at the bottom of the Tool Editor dialog box. When you
make this selection, any customizations that you have made are lost. It also
deletes any icons that you have added to the toolbox. The Tool Editor dialog
box asks you to verify your request. Click on [Yes] to restore
the default settings, [No] to keep your customizations, or [Cancel] to do neither.
can save the changes to the catalog entry that is displayed in the
field of the Tool Editor dialog box, or you can create a new toolbox with
a different name.
Note: If you are customizing a window-specific or application-specific
toolbox for your personal use, save the customized toolbox in your SASUSER.PROFILE catalog
by using the same entry name as the PMENU entry for the window or application.
The SAS System searches for toolboxes first in SASUSER.PROFILE and
then in the application catalog.
Click on [Save] or [Save as ...] to perform the following tasks:
You can also choose to save the toolbox as a toolset. If you save the toolbox as a toolset, the entry type will be TOOLSET; otherwise, the entry type is always TOOLBOX. Saving a set of tools as a TOOLSET does not change your TOOLBOX entry. For more information about toolsets, see Customizing Toolboxes and Toolsets and Creating or Customizing an Application- or Window-Specific Toolset.
If you click on [Close] or [Open...] without first saving your changes, the Tool Editor dialog box prompts you to save the changes to the current toolbox before continuing. Click on [Yes] to save your changes; click on [No] to ignore any changes you made; or click on [Cancel] to do neither.
After you save the toolbox or toolset, the Tool Editor
remains open for additional editing, and the
Name: field changes to the name of the new entry (if you entered a
Note: To SAS/AF application
developers or site administrators: If you are editing a window-specific
or application-specific toolbox that you want to be accessible to all users,
you must save the TOOLBOX entry with the same library, catalog, and entry
name as the PMENU entry for the window or application. You need WRITE access
to the appropriate location. For example, to store a customized toolbox for
the graphics editor, the site administrator would store the toolbox in SASHELP.GI.GEDIT.TOOLBOX.
|Creating a New ToolBox|
To create a new toolbox, you do one of the following:
Options, and then select
Edit Toolbox...) and making your changes. Then save the edited toolbox, as described in Saving Changes to the Toolbox or Toolset.
catalog sasuser.profile copyitem dms.toolbox newtools.toolbox
Next, edit the new toolbox by using the Tool Editor
dialog box (from the Tools menu in the active window,
Options, and then
Click on [Open...]. Then specify the libref, catalog, and entry
name of the new toolbox. Click on [OK] to create the new toolbox.
|Loading a Different ToolBox|
To load a toolbox, issue the TOOLLOAD command in the command window:
|Creating or Customizing an Application- or Window-Specific ToolBox|
If you are an application developer and want to create or edit an application TOOLBOX, follow these steps:
|Creating or Customizing an Application- or Window-Specific Toolset|
You define application- or window-specific toolsets in the same way that you create an application- or window-specific toolbox. There are only two differences:
Note: If you are an application developer, make sure
that you delete an existing TOOLSET entry for your application as described
in Creating or Customizing an Application- or Window-Specific ToolBox
before you modify your application's toolset.
Top of Page
Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.