Commands › GROUP Command—Combine Resources

GROUP Command—Combine Resources

The GROUP command lets you combine resources into performance groups. You can use GROUP with the TAB command, the GRAF command, or any of the plot commands.

This command has the following syntax:

GROUP idoption group-name(identifiers) [INCLUDE] [RANGE(rangeid)]

idoption

Defines an ID option identifying the type of resources to include in the group being defined. For example, specify the ID option TRANID if the group is to consist of transactions defined by transaction IDs.

group-name(identifiers)

Defines any 1- to 44-character name. If you use blanks in the group name, enclose the group name in single quotes. Replace identifiers with the identifiers to include in the group (for example, transaction IDs), separated by commas.

You can use generic characters in the identifiers. Once you define a group, you can use the group name as you would any predefined Report Writer ID option. That is, you can use a group name together with commands or variables to do the following:

• Organize the data in a tabular or graph report by group.

  For example, You are asked to produce a report with a set of specific transactions. Define the desired transactions with the group name MYTRANS and then specify MYTRANS as an ID option with the TAB or GRAF commands.

• Limit the value of a variable to the activity of one or more members in the group. For example, limit the variable value to the transactions in the group PAYROLLTRANS beginning with AC or to all transactions in the group.

INCLUDE

Includes this group in the report even if it is not included with the identifiers specified with the TAB command. The value for this group is not included in the average or total value.

RANGE(rangeid)

Tells the Report Writer to include in the group only those resources that fall within the range of the range ID. Replace rangeid with the ID assigned with the RANGE command that assigns the range criteria that you want members of the defined group to meet.

Examples: Group Command

• The following commands define groups by terminal ID and produce a report showing the average response time of each group:

  GROUP TERMID DIVISION.WESTERN(L1*)
  GROUP TERMID DIVISION.EASTERN(L2*)
  GROUP TERMID DIVISION.NORTHERN(L3*)
  GROUP TERMID DIVISION.SOUTHERN(L4*)
  
  TAB TERMID(DIVISION*) TERM RESP
  END
  RUN
  

• The following commands define groups by ranges of transaction lifetime and produce a report showing the average use and lifetime of each group:

  GROUP TRANID RANGE:00.000-10.000(*)  RANGE(TLIFE1)
   GROUP TRANID RANGE:10.001+(*)        RANGE(TLIFE2)
   
  RANGE TRAN LIFE 0-10     ID TLIFE1
  RANGE TRAN LIFE 10-99999 ID TLIFE2
  
  TAB TRANID(RANGE*) TRAN USE AND TRAN LIFE
  END
  RUN