Chapter Contents

Previous

Next
SAS Companion for the OS/2 Environment

Overview of the SAS System Interface

The main SAS window contains all other SAS application windows. The main SAS window is completely configurable, enabling you to use its features in a way that is productive for you. The Main SAS Window shows the main SAS window as it appears when you first start the SAS System. This section briefly describes the features of the window.

The Main SAS Window

[IMAGE]

Here are the primary components of the main SAS window:

menu bar
presents the menus that are available for the active SAS application window. As you switch between application windows, the menu bar changes. Similarly, the pop-up menus that appear when you click on the right mouse button inside a window are customized for that window.

command bar
provides a way to quickly enter any SAS command. The command bar retains a list of the commands that you enter. To repeat a command that you entered previously, either type until the command appears in the command bar or select the command from the drop-down list and click on the checkmark icon or press ENTER. To switch the keyboard focus to the command bar, press F11 (the key that is defined as COMMAND BAR).

toolbar
provides quick access to the commands that you issue most often. The toolbar is completely configurable and can contain up to 30 tools. You can associate different sets of tools with different SAS application windows. When you create a tool, you specify the tool icon, the commands that are associated with the tool, the Help text that is displayed on the status line, and the ScreenTip. The tool browser provides hundreds of images that you can use to represent your commands on the toolbar.

windowing environment
contains a workspace to open windows within the main SAS window. Certain windows can dock to left side of the main SAS window when Docking View is enabled from the Preferences dialog box. Windows that cannot dock to the main SAS window open to the right of the docking area. For more information about using dockable windows, see Using the Docking View.

status line
contains a message area and the current folder for the SAS System. The message area displays Help text for menus and tools, as well as messages that are specific to SAS application windows. The current folder area displays the name of the current working folder. To change the current folder, double-click anywhere on the current folder area. For more information about changing the current folder, see Changing the SAS Working Folder.

The status line can be enabled and disabled from the Preferences dialog box.


Accessing SAS Commands, Tools, and Options from Menus

You can access SAS commands, tools, and options by selecting them from the menus at the top of the main SAS window or by using pop-up menus within application windows. The menus display options that are available in the active window. To access a pop-up menu for a particular window, click the right mouse button anywhere within a window. The pop-up menu that appears contains the menu items that are available in that particular window.

Some SAS windows (such as the Explorer window) can contain objects that have their own pop-up menus when you click on an object by using the right mouse button. In these windows, the pop-up menu that appears is specific to the selected object.


Using the Docking View

Version 7 of the SAS System for OS/2 makes it easier for you to access files using Docking View. When Docking View is enabled, certain windows are docked to the left side of the main SAS window. When you double click on an object in a docked window, a window containing the object opens in the right side of the main SAS window.

Each docked window has a tab at the bottom of the window for easy access to the window. When the number of dockable windows is large enough, the SAS System displays a left and right arrow for you to navigate through the docked windows.

Docked windows cannot be individually moved or resized. To enlarge or contract the amount of space in the main SAS window that is used for docked windows, place the cursor over the split bar between the docked windows area and the remaining portion of the main SAS window. Then click and hold down the left mouse button. Move the mouse to the left or right to resize the docked window area.

If you prefer to work with undocked windows, you can disable the Docking View in the Preferences dialog box or undock windows individually from the pop-up menu.

To undock windows individually

  1. click the right mouse button on the tab of the docked window

  2. select Docked from the pop-up menu.

Alternately, you can click on the tab of the window you want to undock and select Docked from the Window menu.

To dock an individual window, click in the window to make it the active window and then select Docked from the Window menu. For more information about docking or undocking all windows, see View Preferences.


Using the Status Area to Learn about the Main SAS Window

The status line at the bottom of the main SAS window can be of great help as you learn the SAS System interface. This area displays a short description for various parts of the main SAS window, including the currently selected pull-down menu, menu item, toolbar icon, command bar, and status bar.

For example, when you select the File pull-down menu, the status line displays Perform file-related operations. As you drag the mouse to highlight the items under the File menu, the status line displays a short description of each item.

To learn about other areas of the main SAS window, position the mouse pointer over an area. If Help is available and enabled, a ScreenTip appears near the cursor. You enable a ScreenTip using the Preferences dialog box and the Customize Tools dialog box. Use the Customize Tools dialog box to enable or disable a toolbar and command bar ScreenTip. For more information about the Preferences dialog box, see Setting Session Preferences. For more information about the Customize Tools dialog box, see Customizing the Toolbar.

If you customize the commands that are available from the toolbar, you can also specify the descriptions (Tip Text and Help Text) that appear in the ScreenTip and in the status bar. To learn more about changing the toolbar, see Customizing the Toolbar.


Opening and Saving Files

You can open and save to external files from any text editor window, such as the Program Editor window. Some SAS windows, such as Log and Output, do not allow file input; you cannot open files from these windows, but you can save the window contents to external files.

Opening Files

To open a file from the Program Editor:

  1. With the Program Editor window active, either click on the Open toolbar icon (the opened file folder) and type dlgopen in the command bar, or select the File menu and click on Open. SAS displays the Open dialog box.

  2. Use the Open dialog box to select the file that you want to include. By default, SAS looks for files with the .SAS file extension (which contain SAS code, by convention). However, you can change this by adjusting the Files of type field. (If you change the selected file type, SAS will remember that selection and present it as the default the next time that you open a file for that window during the SAS session.)

  3. If the file that you are including contains SAS code that you want to submit, check the Submit box before clicking on [OK].

    Note:    If you select Submit, it remains selected each time you use the Open dialog box to open a file. You must deselect it if you do not want to submit the contents of the file that you want to open.  [cautend]

Note:    The Program Editor window can hold up to 256 characters on a single line. If you open a file with lines longer than 256 characters in the Program Editor window, the lines are truncated unless you issue the INCLUDE command with an LRECL= value equal to the number of characters in the longest line, and you set either the AUTOWRAP or AUTOFLOW command to ON. If you want to use the Open dialog box to open a file with lines longer than 256 characters, use the FILENAME statement to set up a fileref with the appropriate options and then include the fileref, enclosed in double quotes, in the File Name field in the Open dialog box.  [cautend]

Saving Window Contents to a File

To save the contents of the active window to a file:

  1. Either click on the Save toolbar icon (the diskette) or select Save from the File menu. If you have previously saved the contents of this window to a file (and the filename is part of the window title), SAS simply saves the window to the file you specified previously. If you have not saved the document during this session (and the window title bar displays the name "Untitled"), then SAS displays the Save As dialog box.

    If you have previously saved the editor contents but now want to save it to a different file, click on Save As instead of Save on the File menu.

    CAUTION:
    Always use Save As when you want to save the contents of the editor to a new file. If you open a text file in the editor window, whether you use the Open dialog box or the INCLUDE command, the editor title bar displays the name of the file that you opened. When you select

    File
    [arrow]
    Save
    SAS overwrites or appends the file of that name with the current contents of the editor.  [cautend]

  2. Select Save As from the File menu and select or name the file where you want to store the window contents. Optionally, you can select a file type from the Save as type list. SAS saves most file types as plain text and assigns different file extensions based on the type you select; the exception is the RTF file type, which SAS saves in rich text format (RTF).

    If you select a file type from the list, SAS remembers that selection and presents it as the default type the next time that you save a new file in that window.


Clearing the Window and Filename

To clear a SAS window of its contents and its saved filename (if it has one), do one of the following:

If the contents of the window have not been saved, SAS prompts you to save them before it clears the window.


Defining Keys

To display the key definitions that are active for the SAS session (that is, the DMKEYS entry in your SASUSER.PROFILE catalog), either type keys in the command bar or select

Tools
[arrow]
Options
[arrow]
Keys
These key definitions apply to the basic SAS windows, such as the Program Editor, Output, and Log windows. Default Key Definitions under OS/2 contains a list of the default key definitions.

Other SAS products have their own key definitions. Use the menus in the specific product window to access key definitions for specific products.

Although the SAS System lets you define any key listed in the KEYS window, OS/2 reserves some keys for itself to maintain conformity among OS/2 applications. These reserved keys are not shown in the KEYS window.

To define or redefine a key within the SAS System, place the cursor in the Definition column across from the key or mouse button that you want to define and type the command or commands that you want to associate with that key or button. The definition must be a valid SAS command or sequence of commands. When you specify a sequence of commands, separate the commands with a semi-colon ( ; ). For example, if you want to define the CTRL+H key sequence to maximize a window and recall the last submitted program, specify the following commands in the Definitions column next to CTL H:


zoom; recall

The SAS System does not check the syntax of a command until it is used (that is, when the key is pressed). If you misspell a command or type an incorrect command, you do not discover your error until you use the key and receive an error message that indicates that the command was unrecognized.

Your key definitions are stored in your SAS user profile catalog. SAS creates a new profile catalog each time you invoke the SAS System with a different value for the SASUSER option. Changes that you make to one profile catalog are not reflected in any other. However, you can use the COPY command from the KEYS window or the CATALOG procedure to copy key definition members to other profile catalogs. (For more information, see the CATALOG procedure in SAS Procedures Guide.)


Chapter Contents

Previous

Next

Top of Page

Copyright © 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.