IBM Support

SI44997 - OSP -INCORROUT CRTPFRDTA file QAPMBUSINT

PTF Cover Letter


PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

OSP -INCORROUT CRTPFRDTA file QAPMBUSINT


Pre/Co-Requisite PTF / Fix List

REQ  LICENSED      PTF/FIX  LEVEL

TYPE PROGRAM  REL  NUMBER   MIN/MAX  OPTION
---- -------- ---  -------  -------  ------
CO   5770SS1  710  SI39791   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

-------------------------------------------------
File QAPMBUSINT fields BUPKTSND (packets sent) or BUPKTRCV
(packets received) may occasionally report an enormous incorrect
value.

CORRECTION FOR APAR 'SE49762' :
-------------------------------
Problem results when one of the metrics reaches its maximum
value and wraps back to zero.   Code was changed to handle the
wrap condition based on the width of the hardware counter.

CRTPFRDTA can be run again to recreate the data properly.

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


Activation Instructions


None.




Special Instructions


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


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


1. If the Management Central server job (QYPSJSRV) is active, it
must be ended by executing the following command:
- ENDTCPSVR SERVER(*MGTC)

2. End any host remote command server jobs that might have been
used by Management Central:
- ENDHOSTSVR SERVER(*RMTCMD)

3. Check to see if the QPMASERV and QPMACLCT jobs ended. If they
did not end, then use the ENDJOB command to end them.

4. If host servers were ended in step 2,  restart them:
- STRHOSTSVR SERVER(*RMTCMD)

5. If the Management Central server job (QYPSJSRV) was ended in
step 1, restart it:
- STRTCPSVR SERVER(*MGTC)

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI42820:
================================================


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

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


After applying or removing this PTF, do the following:

Stop Collection Services.  Enter the following on the command line:
ENDPFRCOL FRCCOLEND(*YES)

Start Collection Services.  Enter the following on the command line:
STRPFRCOL

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI39804:
================================================


After applying or removing this PTF, do the following:

Stop Collection Services.  Enter the following on the command line:
ENDPFRCOL FRCCOLEND(*YES)

Start Collection Services.  Enter the following on the command line:
STRPFRCOL

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI37780:
================================================


None.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI38703:
================================================


The Collection Services collector job (QYPSPFRCOL) must be ended and
restarted for this change to take effect. To end Collection Services,
enter the following on the command line:
ENDPFRCOL FRCCOLEND(*YES)

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

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI37376:
================================================


The Collection Services collector job (QYPSPFRCOL) must be ended and
restarted for this change to take effect. To end Collection Services,
enter the following on the command line:
ENDPFRCOL FRCCOLEND(*YES)

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

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI36988:
================================================


The Collection Services collector job (QYPSPFRCOL) must be ended and
restarted for this change to take effect. To end Collection Services,
enter the following on the command line:
ENDPFRCOL FRCCOLEND(*YES)

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

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI44117:
================================================

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.

If the messages continue to be issued after the application of the PTF,
the existing members in the QAPMSYSPRC file need to be renamed, the
Q1PDR job submitted and then the members renamed back to the original
names so they will be cleaned up by the normal processing.  To do this,
do the following:

1) Determine the collection library name:
- CFGPFRCOL and press F4=Prompt
(Note the Collection Library name).

2a) If PDM is installed on the system, use the following instructions
to rename members:
- WRKMBRPDM FILE(LibraryName/QAPMSYSPRC)
(Note the name of each of the members as they will need to be
renamed back to the  original name)
- Select option 7=Rename next to each to rename

2b) If PDM is not installed on the system, use the following
instructions to rename members:
- DSPFD FILE(LibraryName/QAPMSYSPRC) TYPE(*MBRLIST) OUTPUT(*PRINT)
- WRKSPLF and press <ENTER>
- Locate the last spooled file named QPDSPFD and take option
5=Display
(Note the name of the members, then rename)
- RNMM FILE(LibraryName/QAPMSYSPRC) MBR(Q123456789)
NEWMBR(Q12345678X)

3) Once all members are renamed, manually submit the Q1PDR job:
- GO PM400
- Select option 2. Work with Automatically Scheduled Jobs
- Select option 2=Change next to the Q1PDR job
- Specify the Next run date as yesterday's date and press <ENTER>

4) Monitor the Q1PDR job for any errors.

5) If the Q1PDR job completes successfully, rename the members back to
the original names so they will be cleaned up with the clean up
process.  Use WRKMBRPDM or RNMM instructions above to do so.


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   SI44117      OSP-OTHER-T/Q1PDR2U-MSGMCH1210 Q1PDR job fails
   SI43661      OSP Collection Services support for future enhancements
   SI43505      OSP-T/QPMDJOBM-MSGMCH1210 CRTPFRDTA PRORJOBMI procedure
   SI42887      OSP-MSGMCH1210-T/QPMDJOBM CRTPFRDTA fails
   SI42881      OSP-MSGCPF7306-T/QPMBODBF CRTPFRDTA job fails
   SI42820      OSP-T/QPMDJSUM-MSGMCH1210 CRTPFRDTA procedure CALCBUCK
   SI42181      OSP-T/QPMDJOBM-MSGMCH1210 CRTPFRDTA PROCESS_DATA procedure
   SI42181      OSP-T/QPMDJOBM-MSGMCH1210 CRTPFRDTA PRROJOBM procedure
   SI41758      OSP Collection Services support for future enhancements
   SI41758      OSP-INCORROUT Memory amount in QAPMCONF file GKEY ' 4'
   SI40733      OSP-INCORROUT Base Function to Enable Future Extensions
   SI39804      OSP-INCORROUT Base Function to Enable Future Extensions
   SI38703      OSP-OTHER-T/QPMPLPAR -MSGMCH0601 job QYPSPFRCOL
   SI37376      OSP-F/QPMDBUS-MSGMCH0601 CRTPFRDTA more than 256 buses
   SI36988      OSP-INCORROUT QAPMLPARH ONLY CONTAINS DATA FOR 4 LPARS
   SI37780      OSP-MSGCPF5129-T/QPMDJVM CRTPFRDTA fails on file QAPMJVM
   SI37184      OSP-MSGMCH3601-T/QPMADISK in QZRCSRVS job with disk monitor

Summary Information

System..............................i
Models..............................
Release.............................V7R1M0
Licensed Program...............5770SS1
APAR Fixed..........................View details for APAR SE49762
Superseded by:......................View fix details for PTF SI63177
Recompile...........................N
Library.............................QSYS
MRI Feature ........................NONE
Cum Level...........................C2115710


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.

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1.0"},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG15V","label":"PTF Cover Letters - OS\/400 General"},"Component":"","ARM Category":[],"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"V7R1M0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
25 June 2012