Chapter 11: Use the DECwindows Motif Interface › Customize › Workload Definitions › Create a Workload Definition

Create a Workload Definition

You use the following options to create workload definitions:

Workload name

Enter the name of the workload definition. The workload definition's name is limited to 20 characters.

Workload is unique by

Enables you to specify a category for workload summarization. A workload are defined for each unique element of the category you choose.

Click the Workload is unique by toggle button and then click MB1 on the box beneath this which displays Account name when first accessed. The option menu appears displaying the following items:

• Account name
• Process name
• Image name
• UIC group
• User name
• PID

Click MB1 on the category you want.

Include these processes

Set the toggle buttons to specify the processing modes to be included by the workload definition.

• Interactive
• Batch
• Network
• Detached

Process base priority

Enter the minimum and maximum values for the process Base Priority to be included in the definition. Values can range from 0 to 31 and the minimum value must be less than or equal to the maximum.

Workload is defined by sets of items

Selects the alternative to “unique” by criteria. Allows you to enter lists of user criteria, or images, or both for defining a workload.

Matching requirement

This is an option menu with two entries. Press MB1 on the current setting to view the choices.

Either images or users

Indicates that the Performance Agent matches either the image names or the user criteria of a process record to include the process data in the workload.

Both images and users

Indicates that the Performance Agent must match both the image names and the user criteria of a process record to include the process data in the workload.

Transaction units

This is an option menu with two entries. Press MB1 on the current setting to view the choices. Click either image termination or terminal responses to indicate how response time should be evaluated. This affects the workload frequency when building a model. See the ADD/WORKLOAD command for information about transaction units.

Images

Click the text entry field to activate the text insertion cursor.

To add an Image name

1. Type a name and then press Return or click the Enter button.

   The name appears in the list box and be cleared from the text entry field.

2. If you wish to preserve lowercase characters, enclose image names in double quotes when you enter them.

To delete an Image name

1. Click the name in the image name list box and then click the Delete button.

   The name is removed from the list box.

2. To remove multiple names, click all their names and then click the Delete button.

A list of image names can be provided through a file. Use the at sign (@) as the first character to indicate that the text is to be interpreted as a file name. The default directory is assumed if not supplied, as is a file type of .DAT. The format of the file must be a series of image names separated by white space or commas. Supply only the filename field; do not include the file type.

Image names can contain wildcard characters. Image names can contain up to 39 characters. If you wish to preserve lowercase characters, enclose image names in double quotes when you enter them.

Users

Press MB1 on the Users option menu to view the categories available. Release MB1 on the entry indicating the type of user you want to create. You cannot create a list until you make this selection.

To add a user field

• Type the appropriate string and then press the Return key or click the Enter button.

  The field appears in the list box and is cleared from the text entry field.

To delete a user field

1. Click the entry in the user list box and then click the Delete button.

   The entry is removed from the list box.

2. To remove multiple entries, click all entries to be deleted the fields and then click the Delete button.

A list of user entries can be provided through a file. Use the at sign (@) as the first character to indicate that the text is to be interpreted as a file name. The default directory is assumed if not supplied, as is a file type of .DAT. The format of the file must be a series of user fields separated by white space or commas.

User names can contain wildcard characters. User names longer than 12 characters are truncated to 12 characters to ensure a match because the Performance Agent collects up to 12 user name characters only. Account names can be up to 8 characters in length, and process names up to 15. If you wish to preserve lowercase characters, enclose your entries in double quotes.

User criteria can be specified in terms of UICs, account names, process names, or user names.

A UIC group can be indicated by using an asterisk for the user number, ([200,*]).

Control Buttons

The Clear button removes all dialog box entries.

The Create button adds the workload name to the list and clears the entries.