Chapter 10: Parameter Editor Commands › MODIFY/WORKLOAD

MODIFY/WORKLOAD

This command changes a workload definition in the parameters file.

Format

MODIFY/WORKLOAD name

Parameter

Name

A workload name is a 1 to 20-character alphanumeric string that represents a workload, or grouping of your system's activity.

Description

The MODIFY/WORKLOAD command changes a workload definition in the parameters file. A workload definition is a list of image names or users that govern how Performance Agent groups process data into workloads.

Some qualifiers are mutually exclusive. For example, you cannot use /USERNAMES with /ADDUSERNAMES or /IMAGENAMES with /ADDIMAGENAMES.

Qualifiers

/ACCOUNTNAMES=(accountname[,. . .])

Replaces the existing list of account names for this workload definition.

/NOACCOUNTNAMES=(accountname[,. . .])

Removes the specified account names for this workload definition.

/ADDACCOUNTNAMES=(accountname[,. . .])

Adds account names to the existing workload definition.

/ADDIMAGENAMES=(imagename[,. . .])

Adds image names to the existing workload definition.

/ADDPIDS=(nnnnnnnn[,. . .])

Adds the list of PIDs to the existing list of PIDs in the workload definition. The /PIDS and /ADDPIDS qualifiers are mutually exclusive.

/ADDPROCESSNAMES=(processname[,. . .])

Adds process names to the existing workload definition.

/ADDUSERNAMES=(username[,. . .])

Adds user names to the existing workload definition.

/ADD_UICS=(uic[,. . .])

Adds UICs to the UIC list for the workload definition.

/IMAGENAMES=(imagename[,. . .])

Replaces the existing list of image names for this workload definition.

/NOIMAGENAMES[=(imagename[,. . .])]

Removes the specified image names or all if none are specified.

/INCLUDE=(process_type=[NO] INTERACTIVE, [NO] BATCH, [NO] NETWORK [NO] DETACHED), BASE_PRIORITY=([NO] MINIMUM=M, [NO] MAXIMUM=N)

Allows you to select process activity based on the process status (batch, interactive, network, or detached) or on the process Base Priority, or both.

/MATCH={EITHER | BOTH}

Indicates that a process record must match the user name or the image name or both to be considered in the workload.

/PIDS=(nnnnnnnn[,. . .])

Replaces the existing list of PIDs in the workload definition. The /PIDS and /ADDPIDS qualifiers are mutually exclusive.

/NOPIDS=(nnnnnnnn[,. . .])

Removes the specified PIDs from the existing list of PIDs in the workload definition. If specified without any PIDs, all PIDs are removed from the list.

/PROCESSNAMES=(processname[,. . .])

Replaces the existing list of process names for this workload definition.

/NOPROCESSNAMES=(processname[,. . .])

Removes the specified process names for this workload definitions.

/TRANSACTION_UNITS={IMAGE_TERMINATIONS |TERMINAL_RESPONSES}

Replaces the way you count the number of transactions for the workload definition.

/UNIQUE_BY={USERNAME |IMAGENAME |PROCESSNAME |UIC_GROUP|ACCOUNTNAME}

Generates a new workload for the occurrence of each unique image, unique user, or unique image/user combination. This qualifier cannot be used with the /MATCH, /IMAGENAMES, and /USERNAMES qualifiers.

/USERNAMES=(username[,. . .])

Replaces the existing list of user names for this workload definition.

/NOUSERNAMES[=(username[,. . .])]

Removes the specified users, or all if none are specified.

Examples

PSDC-EDIT> MODIFY/WORKLOAD DEPT_1/USERNAMES=(LEWIS,PAGE,FRANKS,HODGES)

The previous command modifies the workload definition DEPT_1 to have a new list of user names, superseding the old list. This workload definition can be used in a workload family to describe a portion of the system's workload, namely the activity in Department 1, including the activity of all processes with the usernames matching any of those listed: LEWIS, PAGE, FRANKS, HODGES.

PSDC-EDIT> MODIFY/WORKLOAD APP_X/NOIMAGENAMES=(X$PROG2A)

The previous command modifies the workload definition APP_X, removing the image name X$PROG2A from the list of image names. This workload definition can be used in a workload family to describe a portion of the system's workload, namely the activity of application X, which includes the activity of all processes with the image names matching any of those identified in the workload definition.