Automatic Partition Resource
	Manager logo

APRM® Technical Alert
# 001

OS/400 Collection Services cycles frequently and generates many Management Collection objects.

 Product:APRM - V5R1M0 through V5R3M1
 OS Level:OS/400 - V5R1M0 and later
 Date:November 21st, 2003, Modified April 15, 2005

Problem Summary

OS/400 V5R1M0 and V5R2M0
Collection Services cycles frequently and generates many management collection objects.  Jobs may also be submitted to convert the data in these management collection objects into database files further consuming disk and processing resources.

OS/400 (i5/OS) V5R3M0
Collection Services has been modified to be able to smoothly handle a dynamic change to processing resources;  this is no longer an issue nor a problem.

Background

Collection Services is the component of OS/400 that collects data regarding the workloads being placed on the iSeries™ or AS/400™ system.  This data is stored in a Management Collection object, (*MGTCOL) and can be used by various performance analysis tools to provide information on the performance of the system.  Collection Services can be started, stopped and the management collection objects generated can be viewed and managed by using 'Collection Services' under the Configuration and Service section of iSeries Navigator.  Database files can also be generated from the Management Collection objects for use in performance analysis software such as PM400.

Issue

The data that Collection Services collects is based on a certain system configuration, i.e., the amount of memory and processing resources that is available to that system.  If the system configuration is changed, then Collection Services needs to cycle, i.e., stop the collection of data into the current management collection object and start collecting data based on the new configuration into a new management collection object.

Before V5R1 of OS/400, the only way the processing configuration could change required an IPL to occur.  Either hardware service was required to add new processing capacity, (upgrading the processor, memory or interactive capacity), or, if the system was partitioned, changes to the LPAR configuration that resulted in different processor or memory assignments in a partition required an IPL to become effective.

With V5R1, the processor and/or memory assignment in a partition can change dynamically.  When this occurs, Collection Services sees a new system configuration and cycles to start collecting data on the new configuration.  Regardless of how the LPAR configuration is changed, whether it is via APRM, System Service Tools, iSeries Navigator or other third party products, the result is that because the processor and memory resources have changed, Collection Services will cycle.  Furthermore, when a request to move memory between partitions occurs, the actual movement typically occurs in relatively small blocks until the complete amount of memory requested has been moved.  This is because the pages of memory need to be moved through the machine pool of the partition to clear them before they can be removed from the partition.  The memory is added to the receiving partition as and when the memory becomes available.  As an example, if a single request is made to move 100MB between partitions, the actual move may be performed with five actual moves of 20MB each, over a period of several minutes.  Because of this, collection services may cycle several times in both the giving and receiving partitions during the course of a single request to change the memory configuration.

APRM is constantly looking at the performance of the various partitions within the iSeries system as a whole and adjusting processor, interactive and memory resources to where they are needed.  As a result, whenever APRM adjusts the LPAR configuration of the system, collection services cycles in the partitions affected.  This typically results in numerous cycles of collection services, (maybe several hundred on a particularly dynamic system), and the resulting generation of management collection objects.

If Collection Services were defined to generate database files from the management collection objects, an additional job would be submitted to perform this task for each management collection object created.

Solution

IBM® is aware of the issue and is taking steps to correct it, but this problem arises from an underlying construct of Collection Services, that of collecting data based on the resources of the system.  If those resources change, then Collection Services will cycle.

Steps can be taken to stop Collection Services from running thus preventing the generation of management collection objects.  Steps also may need to be taken to prevent other jobs and tasks from restarting Collection Services.  For example, PM400 has a job that will verify that Collection Services is running and start it if it finds that it is not.  PM400 is a component of OS400 that takes the data from the database files generated from management collection objects, summarizes it and then transmits the information to IBM for producing performance reports.  The customer can then view these reports over the web.  There may be other jobs from third-party vendors that will also verify and/or start Collection Services.

There is also an issue of Collection Services cycling unexpectedly when no configuration change has occurred.  PTF's have been issued to correct this particular problem, as follows:

 V5R1SI08234, MF31476
 V5R2SI08927, MF31447

Note:  APRM does not use Collection Services, management collection objects or database files generated from these objects.  APRM determines the workload on individual partitions using IBM supported MI instructions and analyzes the information using a patent-pending algorithm.  This is because APRM needs to react to the workloads occurring on the system at the current moment in time, rather than the workload that was occurring on the system when collection services recorded the information.  Stopping collection services will not affect the execution or functionality of APRM.

Additional Information

How to turn off Collection Services:

Collection Services can be stopped either via the green screen interface, via iSeries Navigator or by calling an API.

Green Screen:

Enter GO PERFORM, followed by Option 2 - Collect Performance Data, followed by Option 2 - Stop collection.

ISeries Navigator:

Within iSeries Navigator, navigate to Collection Services under Configuration and Services.  Right click on Collection Services and select Stop Collecting.

iSeries Navigator picture

API:

   CALL QYPSENDC PARM( '*PFR      '  '          ' )
Note: Each parameter is 10 characters long.

How to find who started Collection Services:

If Collection Services starts up again, even though it was previously stopped, perform the following:

Enter WRKACTJOB and page down to find the QYPSPFRCOL job in the QSYSWRK subsystem.  Enter a 5 to work with the job and then option 2 from the WRKJOB menu.

On the display job details screen, page down one screen.  The name of the job that submitted the Collection Services will be displayed.

How to turn off PM400 from starting collection services:

If the name of the job that started Collection Services is Q1PPMSUB, then it is the PM400 job that Verifies Collection Services that is starting up Collection Services.  To turn off PM400:

Enter GO PM400

Take option 2 - Work with automatically scheduled jobs.

Put option 2 = Change next to BOTH the Q1PPMSUB and Q1PPMCHK entries.

Change the status to I for Inactive for both of these jobs.

How to turn off database file generation:

If you require Collection Services to be running, then the automatic generation of database files for each management collection object can be disabled.  Collection Services will still cycle and a management collection object will be generated for each cycle period, but the job that generates the database files will not be submitted.

Enter GO PERFORM, then option 2 - Collect Performance data.  If Collection Services is active, the current details of the collection will be shown at the top of the screen, including whether database files are to be generated.  If Generate database files is *YES, then stop Collection Services and start it again specifying *NO for generate database files.  The database files can always be generated at a later time for a particular management collection object if required.

© Copyright 2003-2005 Barsa Consulting Group, LLC. All rights reserved.