Performance Inspector ™ for AIX


  1. Download the Performance Inspector for AIX package.

  2. Uncompress the file that you downloaded (gunzip pi_aix.tar.gz).

  3. Create a directory and untar (tar -xvf pi_aix.tar) the tools package into that directory.

  4. From the directory you created, execute ". ./tinstall" to complete the installation. It is strongly recommended that this step be executed as the root user, since that will ensure that you have the correct permissions for all of the functions. However, if you do not have root access, you will be notified which functions could not be performed.

  5. From the directory you created, you must execute ". ./setrunenv" to set the required environment variables for any new command shell. This is done automatically by ". ./tinstall".

You may run ". ./tinstall" and ". ./setrunenv" as many times as you like, since they will detect what has already been done and do only what is required.

NOTE:  The ". " must precede "./setrunenv" to make the environment changes permanent for this shell instance.

You may also use ". ./setrunenv x" to add x to your path, if it is not already present.

The tinstall script will copy libjprof32.a or libjprof64.a to libjprof.a, depending upon what JVM is detected. If necessary, you can replace libjprof.a yourself to force the use of the 32 or 64-bit JPROF as needed. Alternatively, you can specify "jprof32" or "jprof64" instead of "jprof" in any command scripts.

If the pm_initialize function is supported by the AIX Performance Monitor API, which is true for all versions of bos.pmapi.lib beginning with AIX (5.2F), PTT can be supported on any processor type. However, if an older version of bos.pmapi.lib is in use, only the following processor types have been tested: Power3, Power3-II, Power4, Power4-II, Power5, Power5-II, RS64-II, RS64-III, PowerPC604, PowerPC604e, PowerPC970, and MPC7450.

NOTE: Installation of the Per Thread Time (PTT) functions on versions of AIX before 5.2F ( require that /usr/pmapi/etc/pmsvcs, a kernel extension, and a matching /usr/pmapi/lib/libpmapi.a be replaced. Backups of both old files are made with .bak.asptools added to the original names. Backups of the new files have only .asptools added to the names. Both sets of files are saved to allow a clean uninstall of Performance Inspector.

If you are using a version of AIX before 5.2F (, the system must be rebooted so that pmsvcs can be reloaded. You will need to manually reboot the system using "shutdown -r" before you can use PTT.


The Performance Inspector package can be removed by executing ". ./tinstall REMOVE". This script will restore any system files replaced by ". ./tinstall", then it will delete the backup files. If the tinstall script detects that an older version of Performance Inspector was installed, it will remove the old version before installing the new one.

NOTE: Even though installation may have required a reboot to be performed, there is no need to reboot after uninstalling this package, because the changes that were made to the kernel extension are transparent to older applications. and are included in AIX versions and later. However, the old file will be restored and you can guarantee compatibility by rebooting, if you desire.

Time Profiling using AIX tprof

Performance Inspector provides support for address-to-name translation for the system tprof command. By using the JPROF jpa option, libjprof.a will produce the same JavaXXXX.syms file as libjpa.a, eliminating the need to execute two Java agents at the same time. Thus, the following command:

is equivalent to: Both will produce .syms files with symbols and instruction data that can be used by the system tprof command.