(iSeries)

Use Collection Services performance data

Collection Services, a component of WebSphere Application Server for IBM i, collects Performance Monitoring Infrastructure (PMI) data for stand-alone application servers. This PMI data is collected at specified intervals, providing a snapshot of activity during that time.

Perform the following steps enable Collection Services for WAS. When Collection Services is enabled, it writes the collected data into the following new database files:

• QAPMWASCFG

  Server configuration data. This data includes information about the different WAS jobs. This information is static and therefore does not change during life of the server. There is one record per server.

• Server data

  One record is created for each active server job per interval. Much of the data comes from WAS PMI data and transaction counters.

• Application data

  It contains one record for each application module per interval. WAS PMI counters are the source for many of the fields in this file. For the JSP section, the data in each field represents a sum over all JSPs running in a given application.

• QAPMWASEJB EJB data
  This data includes information about applications with EJB running on the WAS. Each record represents one type of enterprise beans per application module per interval. If there is no bean activity for a particular EJB type, then no record is written.
• QAPMWASRSC

  Pooled resource data. This data includes information about pooled resources associated with WAS. Each record represents one pooled resource per interval. The type of pooled resource might be a JDBC connection pool, a J2EE Connector (J2C) connection pool, or a thread pool. Not all fields are applicable to each pooled resource type. If a resource exists but is not being used (nothing is created, destroyed, allocated or returned), no record is written.

Tasks

1. Install and enable the Collection Services custom service:

   1. Type the following command on an IBM i command line to start the Qshell environment:

      STRQSH 
      

   2. Type the following command:

      cd app_server_root/bin
      

   3. Type the following command to install and enable the Collection Services custom service:

      manageWASCollectionServices -profileName pName -server.name sName -enable
      

      where pName is the name of the WAS profile to manage and sName is the name of the Application Server to manage.

2. Enable PMI and set the level using the administrative console.

3. Stop and restart the application server.

4. Perform the following steps to configure Collection Services:

   • On an IBM i command line, type CFGPFRCOL (Configure Performance Collection) and press the F4 key.

   • Make note of the collection library specified to create the management collection object (Collection library parameter, LIB keyword).

   • Make note of whether or not database files are automatically created (Create database files parameter, CRTDBF keyword).

5. Type the following command to start the performance collection:

   STRPFRCOL
   

6. If we configured Collection Services with CRTDBF(*YES), new records are written to all of the previously listed files at every collection interval. If CRTDBF(*NO) is specified, no database files are created automatically, we need to do it manually using the CRTPFRDTA command. Here are two examples:

   • To create all the Collection Services files, type the following command:

     CRTPFRDTA FROMMGTCOL(MYLIB/Q123456789)
     

   • To create the new WAS files only, type the following command:

     CRTPFRDTA FROMMGTCOL(MYLIB/Q123456789)
     

     CRTPFRDTA FROMMGTCOL(MYLIB/Q123456789) CGY(*WAS)

What to do next

For more information about Collection Services, see the IBM i and System i Information Center at: http://www.ibm.com/eserver/iseries/infocenter

Subtopics

• (iSeries) The manageWASCollectionServices script
  The manageWASCollectionServices script manages the WAS for IBM i Collection Services custom service, which collects select Performance Monitoring Infrastructure (PMI) data and other information for IBM i Collection Services.
• (iSeries) processStats script
  The processStats script collects and summarizes Performance Monitoring Infrastructure (PMI) data, saving the results to a text file. This file is imported into the IBM Systems Workload Estimator as the basis for a WAS estimate.

Enable PMI