IBM Support

SI67748 - OSP-INCORROUT Collection Services expiration times

PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

OSP-INCORROUT Collection Services expiration times


Pre/Co-Requisite PTF / Fix List

REQ  LICENSED           PTF/FIX  LEVEL

TYPE PROGRAM  RELEASE   NUMBER   MIN/MAX  OPTION
---- -------- --------- -------  -------  ------
PRE  5770SS1  V7R2M0    SI64969   00/00    0000
PRE  5770999  V7R2M0    MF63607   00/00    0000
PRE  5770SS1  V7R2M0    SI62511   00/00    0000
PRE  5770SS1  V7R2M0    SI62050   00/00    0000



NOTICE:
-------
Application of this PTF may disable or render ineffective programs that
use system memory addresses not generated by the IBM translator,
including programs that circumvent control technology designed to limit
interactive capacity to purchased levels.  This PTF may be a prerequisite
for future PTFs.  By applying this PTF you authorize and agree to the
foregoing.

This PTF is subject to the terms of the license agreement which
accompanied, or was contained in, the Program for which you are obtaining
the PTF.  You are not authorized to install or use the PTF except as part
of a Program for which you have a valid Proof of Entitlement.

SUBJECT TO ANY WARRANTIES WHICH CAN NOT BE EXCLUDED OR EXCEPT AS EXPLICITLY
AGREED TO IN THE APPLICABLE LICENSE AGREEMENT OR AN APPLICABLE SUPPORT
AGREEMENT, IBM MAKES NO WARRANTIES OR CONDITIONS EITHER EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON INFRINGEMENT,
REGARDING THE PTF.

The applicable license agreement may have been provided to you in printed
form and/or may be viewed using the Work with Software Agreements (WRKSFWAGR)
CL command.


APAR Error Description / Circumvention

-------------------------------------------------
Expiration times for Collection Services file collections
(*CSFILE)  and management collection objects (*CSMGTCOL) may be
incorrect on systems with time zones that include year offsets.
This may cause collections to be deleted prematurely or not at
all.

CORRECTION FOR APAR 'SE69451' :
-------------------------------
Expiration times are now reported correctly on systems with time
zone year offsets.

Note #1: This PTF will only fix the expiration times of
collections that are created after this PTF is applied.
Expiration times of older collections may also be fixed but
this is dependent on several factors and is not guaranteed.

Note #2: Expiration times are stored in UTC time
and can be displayed with this SQL statement:

SELECT CCLIB, CCCNNAME, CCCLNFMT, CCEXP2 FROM QUSRSYS/QAPMCCCNTB
WHERE CCLIB = '<name of configured collection library>'
ORDER BY CCLIB, CCCNNAME

If the expiration time is all zeros, one of the following will
apply:
* The object is part of the active (current) collection; its
expiration time will be set after the collection has ended.

* The object is permanent and will not be deleted.

Note #3: Expired objects are deleted only from the configured
collection library.
This is displayed/changed with the LIB keyword of the CFGPFRCOL
command.

CIRCUMVENTION FOR APAR 'SE69451' :
----------------------------------
None.


Activation Instructions

None.




Special Instructions

After applying or removing this PTF, Collection Services and any
applications that use the performance collector APIs QPMWKCOL and
QPMLPFRD must be ended and then restarted for the change to take
effect.

1. End any applications using the performance collector APIs QPMWKCOL
and QPMLPFRD.
Note: Make sure that jobs QPMACLCT and QPMASERV are no longer
running.

2. End Collection Services by entering the following on the command
line:
ENDPFRCOL FRCCOLEND(*YES)

3. Rebuild the collection table:
CALL QPMCCRBD PARM('*ALL      ' x'00000000' '<Name of configured
collection library>')
The first parameter, *ALL, must have a length of 10 characters (pad the
end with blanks).
The third parameter, the name of the configured collection library,
must also have a length of 10 characters (pad the end with blanks).
The name of the configured collection library can be displayed by
running the command CFGPFRCOL and hitting F4.

4. Restart Collection Services by entering the following on the
command line:
STRPFRCOL

5. Restart any applications using the performance collector APIs
QPMWKCOL and QPMLPFRD.


********************************************************************
THE FOLLOWING ARE SUPERSEDED SPECIAL INSTRUCTIONS. IF THE SUPERSEDED
PTF HAS ALREADY BEEN APPLIED AND ITS SPECIAL INSTRUCTION FOLLOWED,
IT IS NOT NECESSARY TO FOLLOW THAT SPECIAL INSTRUCTION AGAIN.
********************************************************************

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI65163 :
=================================================

After applying or removing this PTF, Collection Services and any
applications that use the performance collector APIs QPMWKCOL and
QPMLPFRD must be ended and then restarted for the change to take
effect.

1. End any applications using the performance collector APIs QPMWKCOL
and QPMLPFRD.
Note: Make sure that jobs QPMACLCT and QPMASERV are no longer
running.

2. End Collection Services by entering the following on the command
line:
ENDPFRCOL FRCCOLEND(*YES)

3. Restart Collection Services by entering the following on the
command line:
STRPFRCOL

4. Restart any applications using the performance collector APIs
QPMWKCOL and QPMLPFRD.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI64738 :
=================================================

If you are not impacted by the function added, no action is required.

If you need this function, you must follow these instructions to enable
it.

To update the QAPMDISK file in libraries where an existing version of
the file already exists, follow these directions after applying or
removing this PTF:

For each existing library you wish to update:
1) If the collection library you are updating is your current
collection library, the CRTPFRDTA job must be ended.
ENDPFRCOL FRCCOLEND(*YES)

2) Move each of the following files, if it exists, to a backup library.
Note: migrating logical file members will not work if you just rename.
MOVOBJ OBJ(col-lib/QAPMDISK) OBJTYPE(*FILE) TOLIB(your-backup)
MOVOBJ OBJ(col-lib/QAPMDKIX1) OBJTYPE(*FILE) TOLIB(your-backup)
MOVOBJ OBJ(col-lib/QAPMDKIX2) OBJTYPE(*FILE) TOLIB(your-backup)
MOVOBJ OBJ(col-lib/QAPMDKIX3) OBJTYPE(*FILE) TOLIB(your-backup)
MOVOBJ OBJ(col-lib/QAPMDKIX4) OBJTYPE(*FILE) TOLIB(your-backup)
MOVOBJ OBJ(col-lib/QAPMDKIX5) OBJTYPE(*FILE) TOLIB(your-backup)
MOVOBJ OBJ(col-lib/QAPMDKIX6) OBJTYPE(*FILE) TOLIB(your-backup)

3) Create a copy of the new QAPMDISK file from QSYS into your
collection library.
CRTDUPOBJ OBJ(QAPMDISK) FROMLIB(QSYS) OBJTYPE(*FILE) +
TOLIB(col-lib)

4) Copy all existing members from the original QAPMDISK file in your
backup library to the new file in the collection library.
CPYF FROMFILE(your-backup/QAPMDISK) TOFILE(col-lib/QAPMDISK) +
FROMMBR(*ALL) TOMBR(*FROMMBR) MBROPT(*REPLACE) FMTOPT(*MAP *DROP)

5) Create a copy of each of the following QAPMDKIX1, QAPMDKIX2,
QAPMDKIX3, QAPMDKIX4, QAPMDKIX5, and QAPMDKIX6 logical files that you
moved in step 2 in your collection library. This will remap the
based-on physical file to QAPMDISK in the collection library and copy
all the logical file members.
CRTDUPOBJ OBJ(QAPMDKIX1) FROMLIB(your-backup) OBJTYPE(*FILE) +
TOLIB(col-lib) DATA(*YES)
CRTDUPOBJ OBJ(QAPMDKIX2) FROMLIB(your-backup) OBJTYPE(*FILE) +
TOLIB(col-lib) DATA(*YES)
CRTDUPOBJ OBJ(QAPMDKIX3) FROMLIB(your-backup) OBJTYPE(*FILE) +
TOLIB(col-lib) DATA(*YES)
CRTDUPOBJ OBJ(QAPMDKIX4) FROMLIB(your-backup) OBJTYPE(*FILE) +
TOLIB(col-lib) DATA(*YES)
CRTDUPOBJ OBJ(QAPMDKIX5) FROMLIB(your-backup) OBJTYPE(*FILE) +
TOLIB(col-lib) DATA(*YES)
CRTDUPOBJ OBJ(QAPMDKIX6) FROMLIB(your-backup) OBJTYPE(*FILE) +
TOLIB(col-lib) DATA(*YES)

Note: you should delete your saved logical files in the backup library.
These logical files are still based on the QAPMDISK file in your
collection library and will prevent normal deletion of existing
collections.

6) Restart performance data collection if you ended it in step 1 above.
STRPFRCOL

The instructions above are based on only those files and file
relationships shipped with the operating system. It is your
responsibility to handle any additional files, tables, and access paths
that are dependent on files replaced by this PTF. You can determine if
any additional dependencies exist by examining the output of the
following command:
DSPDBR FILE(your-lib/QAPMDISK)

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI63092 :
=================================================

After applying or removing this PTF the Collection Services must be
cycled for the change to take effect.

1. To cycle Collection Services enter the following on the command
line:
STRPFRCOL CYCCOL(*YES)

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI55653 :
=================================================

After applying or removing this PTF the Collection Services collector
job (QYPSPFRCOL) must be cycled for the change to take effect.

1. To cycle Collection Services enter the following on the command
line:
STRPFRCOL CYCCOL(*YES)

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI56821 :
=================================================

After applying or removing this PTF the Collection Services collector
job (QYPSPFRCOL) must be ended and restarted for the change to take
effect.

1. To end Collection Services enter the following on the command
line:
ENDPFRCOL FRCCOLEND(*YES)

2. To start Collection Services enter the following on the command
line:
STRPFRCOL

Before restarting Collection Services, you should consider other
functions that may be using data provided by Collection Services. Such
functions may be impacted when Collection Services is ended. Error
messages may be produced and the affected functions may need to be
restarted.

Examples of functions that are dependent on Collection Services include
Management Central monitors and applications that use the performance
collector APIs QPMWKCOL and QPMLPFRD. If applications are using the
performance collector APIs, you will find server jobs QPMASERV and
QPMACLCT active on your system.


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   SI67080      OSP-INCORROUT QPMLPFRD Qpm_Pool_Format_t data incorrect
   SI65163      OSP-OTHER Support for Alerts for IBM i System Limits
   SI64738      OSP-DISK New Collection Services free space map data
   SI63092      OSP-INCORROUT System Monitor Disk Read and Write Counts
   SI62515      OSP-INCORROUT Collect Pool Name in Collection Services
   SI62051      OSP-INCORROUT QAPMLPARH fields HPCYCL and HPINST incorrect
   SI56821      OSP-F/QYPSUTIL-MSGCPD0A17 COLLECTION SERVICES *JAVA CATEGORY
   SI56408      OSP-INCORROUT Collection Services short lifespan thresholds
   SI55321      OSP-T/QPMPROBE-MSGMCH0601 QYPSPFRCOL job ends abnormally
   SI52027      OSP-MSGMCH5601-T/QPMCTMPSPC SQL probe fails
   SI51476      OSP-T/QPMSYSINT-MSGC2M1212-MSGMCH6902 QYPSPFRCOL
   SI57393      OSP-OTHER Enable HTTP system monitor metrics
   SI59022      OSP THE SYSTEM MONITOR DATA SHOULD BE DELETED BY QYPSPFRCOL
   SI58755      OSP-INCORROUT Batch Model start and end times are incorrect
   SI58043      OSP-INCORROUT QypsChgColSrvAttributes format SCAI0300
   SI57616      OSP-INCORROUT *MGTCOL OBJECT CHANGE DATE/TIME VALUE
   SI56544      OSP-INCORROUT End QPMASERV and QPMACLCT when QYPSPFRCOL ends
   SI56353      OSP-INCORROUT Collection Services data missing interval 1
   SI55655      OSP-MSGMCH6903 QYPSPFRCOL activation group heap space usage
   SI51817      OSP-MSGSQ99999-T/QPMCSQLCNN Deleting expired *MGTCOL objects
   SI55653      OSP-INCORROUT QAPMHDWR data for active Collection Services
   SI60092      OSP-INCORROUT Duplicate records in QAPMJOBOS
   SI57812      OSP-INCORROUT Connected job data missing in QAPMJOBOS
   SI57812      OSP-MSGCPF3219 CRTPFRDTA fails
   SI56826      OSP-INCORROUT High CPU usage by QYMEPFRCVT & QYMEARCPMA
   SI56406      OSP-INCORROUT Large values in QAPMJOBOS file
   SI52785      OSP-INCORROUT CRTPFRDTA CRTPFRSUM(*ALL or *SYSMON) for *DISK
   SI52486       OSP-T/QPMAJBX-MSGMCH1210 QZRCSRVS & QPMACLCT jobs
   SI51472      OSP-T/QPMDSYST-MSGMCH1210 CRTPFRDTA PMORSMSYS
   SI52163      OSP-T/QPMAJBX-MSGMCH0601 QZRCSRVS & QPMACLCT jobs

Summary Information

System.............................. i
Models..............................
Release............................. V7R2M0
Licensed Program............... 5770SS1
APAR Fixed.......................... View details for APAR SE69451
Superseded by:......................
Recompile........................... N
Library............................. QSYS
MRI Feature ........................ NONE
Cum Level........................... C8249720


System i Support

IBM disclaims all warranties, whether express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. By furnishing this document, IBM grants no licenses to any related patents or copyrights. Copyright © 1996,1997,1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018 IBM Corporation. Any trademarks and product or brand names referenced in this document are the property of their respective owners. Consult the Terms of use link for trademark information.

Document information

More support for: i family

Software version: V7R2M0

Operating system(s): OS/400

Reference #: SI67748

Modified date: 03 July 2018