NAME

       TAU_MAPPING_CREATE - Creates a mapping

SYNOPSIS

       C/C++:

       TAU_MAPPING_CREATE(char *name, char *type, char *groupname, unsigned long key, int tid);

DESCRIPTION

       TAU_MAPPING_CREATE creates a mapping and associates it with the key that is specified. Later, this key
       may be used to retrieve the FunctionInfo object associated with this key for timing purposes. The thread
       identifier is specified in the tid parameter.

EXAMPLE

       C/C++ :

       class MyClass {
         public:
           MyClass() {
             TAU_MAPPING_LINK(runtimer, TAU_USER);
           }
           ~MyClass() {}

           void Run(void) {
             TAU_MAPPING_PROFILE(runtimer); // For one object
             TAU_PROFILE("MyClass::Run()", " void (void)", TAU_USER1);

             cout <<"Sleeping for 2 secs..."<<endl;
             sleep(2);
           }
         private:
           TAU_MAPPING_OBJECT(runtimer)  // EMBEDDED ASSOCIATION
       };

       int main(int argc, char **argv) {
         TAU_PROFILE_INIT(argc, argv);
         TAU_PROFILE("main()", "int (int, char **)", TAU_DEFAULT);
         MyClass x, y, z;
         TAU_MAPPING_CREATE("MyClass::Run() for object a", " " , TAU_USER,
                            "TAU_USER", 0);
         MyClass a;
         TAU_PROFILE_SET_NODE(0);
         cout <<"Inside main"<<endl;

         a.Run();
         x.Run();
         y.Run();
       }

SEE ALSO

       TAU_MAPPING_LINK(3), TAU_MAPPING_OBJECT(3), TAU_MAPPING_PROFILE(3)

                                                   08/31/2005                              TAU_MAPPING_CREATE(3)