group

Sets and gets group properties

Format:

TV::group action [ object-id ] [ other-args ]

Arguments:

action

The action to perform, as follows:

commands

Lists the subcommands that you can use. The CLI responds by displaying the four subcommands shown here. Do not use additional arguments with this subcommand.

get

Gets the values of one or more group properties. The other-args argument can include one or more property names. The CLI returns these values for these properties in a list in the same order as you entered the property names.

If you use the -all option as an object-id, the CLI returns a list containing one (sublist) element for each group.

properties

Lists the properties that the CLI can access. Do not use additional arguments with this option.

set

Sets the values of one or more properties. The other-args subcommand is a sequence of property name and value pairs.

object-id

The group ID. If you use the -all option, the operation is carried out on all groups in the current focus.

other-args

Arguments required by the get and set subcommands.

Description:

The TV::group command lets you examine and set group properties and states. These states and properties are:

count

The number of members in a group.

id

The ID of the object.

member_type

The type of the group's members, either process or thread.

member_type_values

Returns a list of all possible values for the member_type property.

members

A list of a group's processes or threads.

type

The group's type. Possible values are control, lockstep, share, user, and workers.

type_values

Returns a list of all possible values for the type property.

Examples:

TV::group get 1 count

Returns the number of objects in group 1.