Parts of the main window

The main window contains the menubar, toolbar, pool tabs and tabbed sections, pool navigation buttons, and statusbar.

Menubar

  • The File menu contains tasks that are commonly associated with files, such as backup, restore, save, and print.

  • The Edit menu contains tasks that are associated with text editing, such as cut, copy, paste, delete, find, and select.

  • The Setup menu contains the tasks that add and update pools, machines and services.

  • The History menu contains tasks that are associated with history, such as navigating and enabling history. It also has a link to the History window where you can manage the history.

  • The Tools menu contains the find machine tool and preference settings.

  • The Help menu contains links to this user's guide and about dialog.

Toolbar

The toolbar contains frequently used tasks, such as navigating history, clearing session history and interrupting response load.

You are able to navigate the history, backword and forward, by using .

You can also view history by randomly accessing by using this drop-down button .

When history is not enabled, the requests that you have sent and the response you have received are stored in the session cache. The cache will be cleared by closing the application. But, you are able to clear this cache by using . This will clear all session history across the pool.

When a response is very large, it may take a longer to load into the Response pane. You can interrupt the loading by using .

Pool tab and tabbed section

In STAF, the machine provides services and the services provide functionalities through the command names. In STAF GUI, this hierarchy of information is represented as a tree in the Command pane. Since the pool has machines, the pool becomes the root of this hierarchy and is represented as a tab. The following icons are used to represent these hierarchical items.

Pool

Machine

Service

Service (to be fixed)

Command

The tabbed section for a pool contains the Command pane, the Option pane, the Submit drop-down combination box, the Submit button, and the Response pane.

In STAF GUI, you have to select a command in order to submit a request. Whenever you select a command, if there are any options, they are displayed in the Option pane. When you specify these options, STAF GUI composes the current request automatically and displays in the Submit drop-down combination box. If the command has any required options, then you have to specify them all in order to submit a request. Otherwise, the Submit button will be disabled. You submit a request by clicking on the Submit button.

Quotes are required around the values in the textboxes if they contain spaces.

The online service help is available in the Service Help tabbed section of the Response pane. You are able to view this when you select a command in the Command pane.

After submiting a request, you can view the response in the Response tabbed section of the Response pane.

Pool navigation buttons

You can select a pool using the Pool navigation buttons. These buttons will only display when a pool tab goes out of view. You can also use the List all pools button to select a pool randomly.

Statusbar

In STAF GUI, the statusbar always displays the current status of the request and response. The information that displays in the statusbar is listed in Figure 2.1, “Statusbar info”.

Figure 2.1. Statusbar info


Every request that you send will be displayed in the message area of the statusbar until a response comes. For a larger response, it may take a while to load into the Response pane. This will be displayed in the progressmeter area of the statusbar. Once the response has fully loaded, the statusbar will display its details.

The following statusbar sequence diagrams show the life-cycle of a request.

  1. A request has just been sent.

  2. The response is converting into an HTML table.

  3. The response is loading into the Response pane.

  4. The response has been received.

History

You can manage history in the History window. The History menu provides access to this window. In order to store the request and response as history, you must enable it.

The History window contains the Backup and Restore menu, the Command pane, and the History pane. The Backup and Restore menu provides the tasks that backup and restore the history data. The Command pane contains pool, machine, service, and command in a hierarchal tree form. The History pane lists the request and date in a table form. The list in the table is ordered by the date. However, you can't view responses in the History window.

You can narrow down history by pool, machine, service, or command by selecting the respective item in the Command pane. You can delete the history from the History pane by selecting the rows in the table and pressing the Delete key.