Specifies the name of the group to create within the TDMS file for data from this task. If you append data to an existing file and the specified group already exists, NI-DAQmx appends a number symbol and a number to the group name, incrementing that number until finding a group name that does not exist. For example, if you specify a group name of Voltage Task, and that group already exists, NI-DAQmx assigns the group name Voltage Task #1, then Voltage Task #2.

For digital input tasks, NI-DAQmx creates a group for each virtual channel in the task. For each created group, NI-DAQmx appends a hyphen and the virtual channel name to the group name.

If you query this property, NI-DAQmx returns the original value specified without any suffixes appended by NI-DAQmx for digital input tasks or for existing groups.

Remarks

The following table lists the characteristics of this property.

Short Name Logging.TDMS.GroupName
Data type cstr.png
Permissions Read/Write
Resettable True
Settable While Task Is Running device-specific
Available in Run-Time Engine True