Chapter 3. Setting up QuickSTAF

Table of Contents

Pool
Adding a pool
Editing a pool
Changing the position of a pool
Deleting a pool
Machine
Adding a machine
Adding machines and services as batch processing
Editing a machine
Changing the position of a machine
Deleting a machine
Service
Adding services
Updating services
Updating services as batch processing
Editing service help before adding or updating services
Deleting services
Fixing a service
Command
Resetting options
Preference
Choosing view preferences
Choosing edit preferences

In order to submit a request, STAF GUI needs to know the machines, services and commands. This section explains how to set the required information before you use STAF GUI.

In the STAF environment there are many machines connected in network. In that environment, machines can be grouped for various purposes. For example, some machines can be grouped for a department and some for a project and the others for a demographic region. When you work on many machines, it is easier if you partition these machines into some groups. STAF GUI provides pools for this purpose.

Besides partitioning the machines, pools also provides environment-variable settings. When you send a request to a machine in a pool, STAF GUI uses these environment variables to initiate the request.

You can create as many pools as you want, and you can add as many machines to a pool as you want. Pool names, however, can't be identical. Similarly, within a pool, machine names can't be identical.

Pool

Adding a pool

To display the add pool dialog, choose SetupAdd Pool (Ctrl+L).

In the Pool dialog:

  1. Enter a name in the Pool Name text box.

  2. In the Request tabbed section:

    • To specify a static handle number, select the Use static handle radio button and enter a handle number in the textbox beside it. Otherwise, a new handle will be created for each request.

    • To specify an instance name, enter a name in the STAF Instance Name textbox. Otherwise, leave the default value.

    In the Response tabbed section:

    • Select any of the response formats you like.

    • To specify table lines per record, select the STAF default radio button and select the STAF table lines per record check box and enter a number in the textbox beside it.

    • To specify indent delta, select the STAF verbose radio button and select the STAF indent delta check box and enter a number in the textbox beside it.

    • To specify STAF replace nulls, select the STAF replace nulls check box and enter a number in the textbox beside it.

    • To set STAF ignore indirect objects, select the STAF ignore indirect objects check box.

    • To set quiet mode, select the STAF quiet mode check box.

  3. To test your settings and add:

    • To test your environment-variable settings, click the Ping LOCAL button. This will send a PING request to the LOCAL machine using these environment variables.

    • To add and display the Machine dialog, click the Proceed to add machine button.

    • To add, click the Add button.

Editing a pool

There are two ways to display the edit pool dialog:

  1. Choose SetupEdit Pool (Ctrl+E).

  2. Select the pool tab.

    1. Right-click on the tab.

    2. Choose Edit Pool.

Note

You can't edit a pool if the pool has any pending requests.

See the section called “Adding a pool” for instructions. Editing on the Pool dialog is the same when either adding or editing a pool, except for the appearance of the following when editing:

  • An Update button will display in place of the Add button.

  • The Proceed to add machine button will be disabled.

Changing the position of a pool

To move a pool left or right by one position:

  1. Select the pool tab.

  2. Right-click on the tab.

  3. To move the pool left choose Move left, or to move the pool right choose Move right.

Deleting a pool

Since a pool contains machines, deleting a pool will delete the hierarchy. You may not delete a pool if the pool has any pending requests. To delete a pool:

  1. Select the pool tab.

  2. Right-click on the tab.

  3. Choose Delete Pool.

  4. In the Delete Pool dialog, click the OK button to delete. You may need to wait a while for the pool to be deleted.

If you do not want to display the Delete Pool confirmation dialog, select Do not ask next time before you click OK. If you want to display this dialog again, see the section called “Choosing edit preferences”.