Manipulates trace event groups.
List event groups
trcevgrp -l [ event-group [ ... ] ]
Remove event groups
trcevgrp -r [ event-group [ ... ] ]
Add an event group
trcevgrp -a -d "group-description" -h "hook-list" event-group
Update an event group
trcevgrp -u [ -d "group-description" ] [ -h "hook-list" ] event-group ]
The trcevgrp command is used to maintain the trace event groups. You must be in the system group to add, delete, or change trace event groups. You cannot modify or delete event groups whose type is reserved.
In AIX® version older than AIX 6.1, you can specify only three-digit hook IDs. In AIX 6.1 or later, you can specify four-digit hook IDs.
Item | Description |
---|---|
-a [ -d group-description | -h hook-list ] | Creates a new event group. Only one event group name can be specified. Both -d description and -h hook-list must be specified when using the -a flag. If either -d or -h is not specified, an error is produced. |
-d group-description | Designates the hook description. A description is required for all new groups. |
-h hook-list | The hook list consists of trace hook IDs. The -h flag is required when using the -a flag. When updating an event group (-u flag), the hook-list, if specified, must contain all hook IDs for the group. List parameter items can be separated by commas or enclosed in double quotation marks and separated by commas or blanks. |
-l event-group | The specified groups are listed to standard output. If no event group is specified, all are listed. The format of the listing is as follows: group name - group-description (type) "hook list" The
following examples shows the listing of the group:
|
-r event-group | Removes the specified event-groups. |
-u [ -d "group-description" | -h "hook-list" ] event-group | Used to update the information for an event-group. Either -d description or -h hook-list must be specified. |
trcevgrp -l
trcevgrp -a -d "my group description" -h "500,501,502" mygrp
This will add the group called mygrp, give it the description my group description, and will have hooks of 500, 501, and 502.
trcevgrp -u -d "my group description" -h "500,501,502,503" mygrp
Files the event groups are currently kept in the SWserveAt ODM database.