6.4.1 Setting user-defined records for collecting workgroup information

To specify user-defined records for collecting workgroup information:

From the Windows Start menu, start the collection data addition utility.
From the tree area, select the Agent Store for the currently logged-in host, and in the list area, right-click the Agent Collector icon, and then choose PI_WGRP Records Add/Confirm/Delete.

The PI_WGRP Record List dialog box is displayed.
In the PI_WGRP Record List dialog box, click the Add button.

The PI_WGRP Record Addition dialog box is displayed.

Enter the parameters.

Enter values in Work group Name, Program Name, User Name, and Group Name.

Input rules common to all parameters

The parameters are not case-sensitive. Spaces are treated as characters.
A character string containing any of the following characters cannot be specified for any of the parameters:

\, /, :, *, ?, ", <, >, |
A wildcard character (* or ?) can be specified for the Program Name, User Name, and Group Name parameters.
When specifying multiple values in the Program Name, User Name, or Group Name parameter, use | to delimit the names.

The table below shows the details of the parameters.

Table 6‒1: Parameter setting details
Parameter	Information to be specified	Field in which information is saved	Input rules
Work group Name	Specifies the name of the workgroup from which information is to be collected.	Workgroup (`WORKGROUP_NAME`)	The only characters that can be used are alphanumeric characters, hyphens (`-`), and underscores (`_`). A maximum of 35 bytes can be used. An existing workgroup name cannot be specified. `Other` cannot be specified.
Program Name	Specifies the name of the program to be executed.	Programs (`PROGRAMS`)^#1	A maximum of 1,023 bytes can be used. Specify the value stored in the Program (`INSTANCE`) field of the Process Detail (`PD`) record.^#2 If no value is input, no search using this item is performed.
User Name	Specifies the name of the user who executes the program specified in Program Name.	Users (`USERS`)^#1	A maximum of 1,023 bytes can be used. Specify the value stored in the User (`USER_NAME`) field of the Process Detail (`PD`) record.^#3 If no value is input, no search using this item is performed.
Group Name	Specifies the name of the group to which the user who executes the program specified in Program Name belongs.	Groups (`GROUPS`)^#1	A maximum of 1,023 bytes can be used. Specify the value stored in the Group (`GROUP_NAME`) field of the Process Detail (`PD`) record.^#4

#1: The maximum size of information that is saved in each field of the Process Detail (PD) record is 35 bytes. When the information size exceeds 35 bytes, the last character saved becomes >.
#2: Records that have _Total for the Program (INSTANCE) field and 0 for the PID (ID_PROCESS) field of the Process Detail (PD) record indicate data expressing the total or average, and thus are not collected.
#3: If no user name is found that corresponds to the process security ID, NONE_MAPPED is stored; if the executing user name cannot be acquired from the process ID, Unknown is stored.
#4: A group name is a name that is pre-defined by the domain name or local system. If no group name is found that corresponds to the process security ID, NONE_MAPPED is stored; if the executing group name cannot be acquired from the process ID, Unknown is stored.

Click the OK button to register the workgroup information.

If there is a parameter input error, an error message is displayed. Refer to the error details displayed and correct the input.
To add more workgroup information to the user-defined record, repeat steps 3 through 5.
For each item, select Match all conditions for the Program name, User name, and Group name (AND) or Match any of the conditions for the Program name, User name, or Group name (OR).

Note:

The contents set for Match all conditions for the Program name, User name, and Group name (AND) or Match any of the conditions for the Program name, User name, or Group name (OR) are applied to all workgroups displayed in Work group information. You cannot specify different settings for individual workgroups.
Click the Exit button.

The user-defined record settings are saved and the PI_WGRP Record List dialog box closes.

Important

For details about the Process Detail (PD) record and Workgroup Summary (PI_WGRP) record, see 8. Records.
For details about Windows user names and group names, see Help in Windows.