.\" ** You probably do not want to edit this file directly **
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
.\" Instead of manually editing it, you probably should edit the DocBook XML
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
.TH "TAU_DISABLE_GROUP_NA" "3" "08/31/2005" "" "TAU Instrumentation API"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.SH "NAME"
TAU_DISABLE_GROUP_NAME \- Disables a group based on name
.SH "SYNOPSIS"
.PP
\fBC/C++:\fR
.HP 23
\fB\fBTAU_DISABLE_GROUP_NAME\fR\fR\fB(\fR\fBchar\ *\fR\fB\fIgroupname\fR\fR\fB);\fR
.PP
\fBFortran:\fR
.HP 23
\fB\fBTAU_DISABLE_GROUP_NAME\fR\fR\fB(\fR\fBcharacter\ \fR\fB\fIgroupname\fR\fR\fB(size)\fR\fB);\fR
.SH "DESCRIPTION"
.PP
Similar to
TAU_ENABLE_GROUP_NAME
, this macro turns off the instrumentation in all routines associated with the dynamic group created using the tau_instrumentor \-g <group_name> argument.
.SH "EXAMPLE"
.PP
\fBC/C++ :\fR
.sp
.nf
/* tau_instrumentor was invoked with \-g DTM for a set of files */
TAU_DISABLE_GROUP_NAME("DTM"); 
dtm_routines();
/* disable and then re\-enable the group with the name DTM */
TAU_ENABLE_GROUP_NAME("DTM");
    
.fi
.PP
\fBFortran :\fR
.sp
.nf
! tau_instrumentor was invoked with \-g DTM for this file 
    call TAU_PROFILE_TIMER(profiler, "ITERATE>DTM")

    call TAU_DISABLE_GROUP_NAME("DTM")
! Disable, then re\-enable DTM group
    call TAU_ENABLE_GROUP_NAME("DTM")
    
.fi
.SH "SEE ALSO"
.PP
TAU_GET_PROFILE_GROUP(3),
TAU_ENABLE_GROUP_NAME(3),
TAU_ENABLE_ALL_GROUPS(3),
TAU_DISABLE_ALL_GROUPS(3)