SI68772 - OSP-INCORROUT Collection Services expiration times

TYPE PROGRAM  RELEASE   NUMBER   MIN/MAX  OPTION
---- -------- --------- -------  -------  ------
PRE  5770SS1  V7R3M0    SI64970   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.

********************************************************************
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 SI65164 :
=================================================

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 SI64293 :
=================================================

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.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI60031 :
=================================================

After applying or removing this PTF the Management Central server job
(QYPSJSVR) must be ended and restarted for the change to take effect.

1. To end the Management Central server job, enter the following on
the command line:
ENDTCPSVR SERVER(*MGTC)

2. To start the Management Central server job, enter the following
on the command line:
STRTCPSVR SERVER(*MGTC)


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   SI65164      OSP-OTHER Support for Alerts for IBM i System Limits
   SI64293      OSP-INCORROUT Manage Collections missing *CSFILE collections
   SI62948      OSP-MSGCPF5009, CPF5034, SQL0803 IN JOB QYPSPFRHST
   SI62948      OSP-INCORROUT Historical data failing for expired objects
   SI60031      OSP-INCORROUT Management Central Graph History data missing
   SI59994      OSP-INCORROUT Historical data for *ACTIVE collection
   SI59885      OSP-INCORROUT Historical Performance Data
   SI59023      OSP THE SYSTEM MONITOR DATA SHOULD BE DELETED BY QYPSPFRCOL

Summary Information

IBM i Support