Previous Topic: Modify or Create a Collection DefinitionNext Topic: Class Coverage Section


Change Collection Definition Parameters

You can enter any of the following parameters:

Collection Definition List

The box in the upper left-hand corner contains the names of the current collection definitions. When you click an entry, the parameters for that collection definition appear.

Collection name

The Collection name is a text field that shows the name of the definition currently displayed. When creating a new definition, use this field to enter the name. Names can be up to 20 characters in length.

Default working set

Enter the working set quota. This value is a decimal number greater than 1024 that sets both the working set quota and the working set extent if the value is higher than the default values. By default, the working set quota is 2048 and the working set extent is 20K. You can override this default by specifying values for individual nodes.

Default minimum space

Enter the minimum number of blocks of free disk space needed on each database disk for each node in the definition. Data collection suspends recording if there are fewer blocks of free disk space available. You can override this default by specifying values for individual nodes.

Default database path

The default database path for all nodes in the collection definition. You can override this default by specifying values for individual nodes, as shown in the following example:

Node Definition Section

This displays the nodes in a collection definition. Default values are displayed. Changes that you make here take effect when you click Create or Modify buttons at the bottom of the window.

To add a node, enter the name and make any modifications you want to the default values shown to the right. Then press Return or click Enter.

To modify a node entry, double click it. The definition appears under the list. Make the changes you wish and then press Return or click Modify to the left of the box.

To delete one or more nodes, click the entries in the list, and then click Delete to the left of the box.

To change the order of the nodes in the list, click the node to be moved, and then the arrows in the right-hand corner. Only one node can be moved at a time.

The changes you make in the node definition section do not modify the collection definition until you click Create or Modify to update the entire collection definition.

Enter—Enter allows a new node to be added to the node list. When you type in a new node name, you can click Enter or press Return to add it to the list.

Modify—Modify takes changes you make to a node definition and puts the changes into the list. Modify is disabled until you select a node from the list by double clicking the node. Changes to the collection definition take effect when you click Modify at the bottom of the window.

Delete-Delete removes any selected, or highlighted, nodes from the list. The nodes are removed from the collection definition when you click Modify at the bottom of the window, as shown in the following example:

Hot file queue—To enable hot file collection in the CPD collection definition, the toggle button to the left must be on. This allows you to specify the queue length in the text entry box. This pertains only to the CPD collection definition because only the primary Performance Agent collects hot file data.

Enter the minimum average queue size that a disk must have to start collecting the hottest files for that disk. This value is a decimal number less than 100.00 and greater than or equal to 0.00. The default is 0.33.

If the toggle button is off, no hot file data is collected.

If the toggle button is on, you must specify a queue length or accept the default value.

Collection interval—The Collection interval specifies the number in seconds in a sampling interval. At the end of this time period, data is recorded into an interval record.

The CPD collection definition has an interval of 120 seconds which cannot be modified.

You can specify an interval from 1 to 3600 seconds for other definitions.

Delete files after—Enter the number of days that data is to be retained. The default is seven days for the primary Performance Agent. Data files are automatically deleted from the database when they are older than the specified number of days.

For alternate Performance Agents, the default is 99,999 days which enables you to control how many data files you retain.

This value should be coordinated with any data archiving and the amount of free space required for the database area. See Chapter 4 for information on archiving.

Start Date—The date and time on which the collection definition goes into effect. A data collection process hibernates until this date and time.

The format is DD-MMM-YYYY HH:MM

End Date—The date and time on which a data collection process Is to terminate.

The format is DD-MMM-YYYY HH:MM

Changing the Collection Schedule—A 24-hour clock is displayed. A bar on the right side of the clock allows you to scroll to each day of the week. By default, data collection is set ON for each hour of the day, every day of the week.

To set the clock

  1. Set or reset the square toggle button above the clock to turn data collection on or off for an entire day.

    To turn off data collection for a specific hour, point to the hour on the clock and click MB1. Holding MB1 down and dragging the pointer around the clock sets data collection to the value of the initial hour setting for a series of hours.

  2. Drag the slider on the scroll bar to display the collection schedule for each day of the week or click the up or down stepping arrows.

To duplicate a day's schedule

  1. Press and hold MB3 inside the clock. A pop-up menu is displayed. Release on the Cut menu item.
  2. Scroll to another day and press MB3 inside the clock. Release on the Paste menu item. The clock displays the copied schedule.