IBM VisualAge TeamConnection 3.0.7 FixPak - 
trace.txt (13-MAR-2001)
------------------------------------------


Documents
---------

backup_db.txt, fix302.ddl, fixdb.ddl, readme.txt, relnotes.txt, 
restore_db.txt, systeminfo.txt, trace.txt, upgrading_to_v303HF1.txt    


Main Index
----------

- Where to get the most recent version of this file
- Objective:  (setting up a local or remote trace for TeamC)
- Step 1A) Set up a local trace of the family server (teamcd) 
- Step 1B) Set up a remote trace of the family server (teamcd)
- Step 2)  Provide an exact description of the steps
- Step 3)  Zip the log files and trace
- Step 4)  Send the trace to Customer Support

 


  Where to get the most recent version of this file
  -------------------------------------------------

  The most recent version of this file can be found at:
  ftp://ftp.software.ibm.com/ps/products/teamconnection/fixes/

  
  

  

Objective:  (Setting up a local or remote trace for TeamC)
--------------------------------------------------------

Follow these steps to set up a trace and contact TeamConnection
Customer Support. You may choose to set up either a local trace
or a remote trace.  For your ease, we suggest you view
the HTML version of this document in a web browser.
                          
    
               
Step 1A) Set up a local trace of the family server (teamcd)
----------------------------------------------------------
    You may set up a local trace (this step) or remote trace (step 1B).
    Set up a local trace on the server if you are not too 
    concerned about the performance impact of doing the 
    trace and you have sufficient disk space available.
    The following example sets up a 10 MEG trace.

    1.  Log in as the family administrator and then set up the
        environment:

	UNIX:     
   	export TC_TRACE=*                                      
      	export TC_TRACESIZE=10000000 
      
	WINDOWS:
        set TC_TRACE=*
        set TC_TRACESIZE=10000000
 
        NOTE: you may also set TC_TRACEFILE to the absolute
              path of the trace output file if you wish to
              control its location.  Otherwise, the output
              file will be called tctrace and wll be located
	      in the directory where you started the family
	      daemon.

    2.  Recycle the family

	tcstop [familyName]                                    
      	teamcd [familyName] [numberOfDaemons] & 
               
    3.  After you reproduce the problem, save the trace

	UNIX
	mv tctrace tctrace.1 

	WINDOWS
	move tctrace tctrace.1
                                
    4.  Stop the family and unset TC_TRACE             
      
                                      
  
                 
Step 1B) Set up a remote trace of the family server (teamcd)
-----------------------------------------------------------
    Set up a remote trace of the family server if the performance impact
    of doing a trace is a concern.  A remote trace will be sent from the
    family server (teamcd) to the remote machine running the tcrtrc
    utility.  (A TeamC client needs to be installed on the remote
    machine.)
                       
    1.  On the TeamC family server do 
                     
   	tcstop [familyName]  
                           
    2.  On the remote TeamC client machine run the         
     	tcrtrc executable like this:
                       
    	  tcrtrc -p[portNumber] [traceFileName]                  
       
	For example, you would type,    
                          
   	  tcrtrc -p1234 trace.out   
                   
        (WARNING:  you must issue the tcrtrc command while the TeamC 
                   family is down!) 

	Issue the command "tail -f [traceFileName]" to view the
	end of the trace output.  Once you start the family server
	you will see additions being made to the trace output file.
	In this way you will know the family server is communicating
	correctly with the tcrtrc utility.
                                       	
    3.  On the TeamC family server, set up the remote trace: 
                                   
	UNIX:          		
	export TC_TRACE=*                                  
        export TC_TRACEOPTS=-h[remoteMachine]@[portNumber] 

	WINDOWS:
        set TC_TRACE=*                                  
        set TC_TRACEOPTS=-h[remoteMachine]@[portNumber] 
		
        eg. assuming that jupiter is the client machine,    
        you would type:
                                  
          export TC_TRACEOPTS=-hjupiter@1234

                            
      (WARNING:  Do not stop the tcrtrc utility on the client machine 
                 or you will break the communication between the
                 remote client and the family server, meaning you
                 will need to stop both the family server
                 and the tcrtrc utility in order to reestablish
                 communication.) 

    4.  Start the family and then reproduce the problem.
            
   		teamcd [familyName] [numberOfDaemons] &

    5.  After you reproduce the problem, save the trace

	UNIX
		mv tctrace tctrace.1 
	WINDOWS
		move tctrace tctrace.1

	(WARNING: This step may also break communication betweeen
                  the family server and the tcrtrc utility.) 


  
                 
Step 2)  Provide an exact description of the steps 
--------------------------------------------------
         Provide an exact description of the steps you took to         
         reproduce the problem, including teamc commands.  Collect
	 the syslog.log, the audit.log, and the db2diag.log

	 INTEL:
	   syslog.log 
	   %TC_FAMILY%\audit.log 
	   c:\sqllib\db2\db2diag.log
	 UNIX:   
           see /etc/syslog.conf for the location of the syslog
           $TC_FAMILY/audit.log         
	   $DB2INSTANCE_HOME/sqllib/db2dump/db2diag.log.



 
                  
Step 3)  Zip the log files and trace
------------------------------------
         Zip the log files and trace using the info-zip utilities
         "zip" and "unzip" which you can download for each platform at:

	 ftp://ftp.uu.net:/pub/archiving/zip/

          
   
                 
Step 4)  Send the trace to Customer Support 
         If 3 MEG or less, send the data and the steps to
         reproduce the problem to TeamConnection Support via email.  
         If greater than 3 Meg, ftp the data to "testcase.boulder.ibm.com" 
         using login "anonymous".

	 ftp testcase.boulder.ibm.com

         NOTE:  cd into the directory /ps/toibm/teamconnection 
                and make a directory with the name of the pmr number
                to hold your files.  Don't forget to use "bin" mode
                to "put" the files.  You will not be able to view files
                you place in the "teamconnection" directory.