IBM AIX Java Diagnostic Tools
---------------------------------------------------------


  TABLE OF CONTENTS
  -----------------
       I.   INTRODUCTION

      II.   HOW TO OBTAIN AND INSTALL THE TOOLS ON AN IBM RISC SYSTEM/6000.

     III.   HOW TO COLLECT DATA

      IV.   HOW TO SEND DATA TO IBM



 I.   INTRODUCTION

      This directory contains a set of tools and instructions for
      collecting the data needed to analyze an AIX Java problem.  
      This tools use AIX utilities or commands to for collecting
      and post processing of data.


 II.  HOW TO OBTAIN AND INSTALL THE TOOLS ON AN IBM RISC SYSTEM/6000.


      A. OBTAINING THE TOOLS

	   The tools are available as text files from the
	   internet using the URL :

            From the internet:
            ==================
            'ftp://ftp.software.ibm.com/aix/tools/javatools/diagnostics'


 

      B. INSTALLING THE PACKAGE

	   Each tool is merely a Korn shell script. Download
 	   and transfer the desired tool to the your AIX system,
	   then run the command :

		chmod 755 file

	   where 'file' is the downloaded file.




 III. HOW TO COLLECT DATA 

	libsGrabber.sh:

		Collects libraries and executable for a core file.
	
		# mv core core.001
		# libsGrabber.sh core.001
		( creates core-libs.tar.Z )
		# compress core.001
		( creates core.001.Z )

	pdump.sh

		Collects kdb (kernel debugger) information for a
		process.

		# pdump.sh process_pid

		where process_pid is id of process to get information.
		Creates a file :
		
		pdump.process_name.process_id.date_stamp

	dbxtrace.sh or dbxpth.sh

		Runs dbx on a core file or active process

		# dbxtrace -a process_pid
		# dbxtrace executable corefile

		# dbxpth process_pid

	javaenv

		Sets up the environment for using a specific
		java directory

		# . javaenv /usr/java131
		# . javaenv /usr/java14

 

 IV. HOW TO SEND THE DATA TO IBM.

      A. Combine all the collected data into a single binary 'tar' file
          and compress it:

           # tar -cvf javadata.tar file [ file [ file ... ] ] 
           # compress javadata.tar
           The resulting file will be named 'javadata.tar.Z'.


      B. Submission of testcase to IBM:

           Internet 'ftp' access:
           ----------------------
             The quickest method to get the data analyzed is
             for the customer to ftp the data directly to IBM.
             Data placed on the server listed below cannot be
             accessed by unauthorized personnel.
             Please contact your IBM representative for the
             PMR# and BRANCH#.  IBM uses both PMR# and
             BRANCH# to associate your data with your
             problem tracking record.

               'ftp testcase.software.ibm.com'
                Userid:  anonymous
                password:  your_internet_email_address
                           (ie. smith@austin.ibm.com)
               'cd aix/toibm'
               'bin'
               'put javadata.tar.Z PMR#.BRANCH#.tar.Z'
                  (ie. 'put javadata.tar.Z 1234x.060.tarbin.Z'
               'quit'

             Notify your IBM customer representative you have
             submitted the data.  They will then update the
             defect report to indicate the data is available
             for analysis.