IBM Support

SI43581 - OSP-OTHER-F/IXMACHINEINDEXEXTEND-T/QMRSP1-MSGMCH2804 MSGMCH2

PTF Cover Letter


PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

OSP-OTHER-F/IXMACHINEINDEXEXTEND-T/QMRSP1-MSGMCH2804 MSGMCH2


Pre/Co-Requisite PTF / Fix List

REQ  LICENSED      PTF/FIX  LEVEL

TYPE PROGRAM  REL  NUMBER   MIN/MAX  OPTION
---- -------- ---  -------  -------  ------
PRE  5761SS1  610  SI43690   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

-----------------------------------------------
When adding monitored resource entries (MREs) into Cluster
Administrative Domain (Admin Domain), there is an internal size
limit that could be hit if a large number of MREs are being
added, or progressively added. MSGMCH2804 gets logged into the
QPRFSYNCH joblog, indicating: "Tried to go larger than storage
limit for object QFPATATR." There is no work around, it is a
limitation that is affected by the number of MRE's being added
and the number of attributes being monitored, which populate to
the internal index. Code will be modified to lift this
restriction of the internal object size from 4GB and increase to
1TB. MSGMCH2804 F/IxMachineIndexExtend T/QMRSP1

CORRECTION FOR APAR SE47998 :
-----------------------------
Cluster Administrative Domain (Admin Domain) process corrected
to raise the internal storage limit from 4 GB to 1 TB.

CIRCUMVENTION FOR APAR SE47998 :
--------------------------------
None.


Activation Instructions


None.




Special Instructions


In order to fix the problems described by this PTF, the PTF must be
applied on every node in the cluster. You do not have to end the
cluster to do this. However, you should end the CRG jobs associated
with the cluster administrative domain on every cluster node before you
apply the PTF. You can do this one node at a time.

Note, you must end the cluster administrative domain CRG jobs on each
cluster node, apply the PTF, and restart the CRG job before the fix is
available.

The cluster administrative domain CRG jobs will be ended if you end
Cluster Resource Services for each node in your cluster. Cluster
Resource Services can be ended using the End Cluster Node API or CL
command. Optionally, you can end just the cluster administrative domain
jobs without ending your cluster nodes by calling the Change Cluster
Recovery CL command.

To determine if any cluster administrative domain jobs are active on
your system, use the WRKACTJOB command from the command line of your
system. Look for any system jobs which have the same name as any
cluster administrative domains which you have created in your cluster.
If there are any cluster administrative domain jobs on your system,
they must be ended. You can end just the cluster administrative domain
jobs on every node with this command:

CHGCLURCY CLUSTER(<cluster>) CRG(<admin_domain>) NODE(*ALL)
ACTION(*END)

where <cluster> is the name of your cluster and <admin_domain> is
the
name of a cluster administrative domain. You should call this
command
once for each cluster administrative domain in your cluster.

You must sign off all sessions where any cluster administrative domain
commands or APIs were used before the PTF can be applied.

After the PTF has been applied on a system, you can restart the cluster
jobs that were ended before the PTF was applied. If Cluster Resource
Services was ended, you can use the Start Cluster Node API or CL
command to start Cluster Resource Services for each cluster node. If
you used the Change Cluster Recovery CL command to end just the cluster
administrative domain jobs, they can be restarted on each cluster node
using the Change Cluster Recovery command as follows:

CHGCLURCY CLUSTER(<cluster>) CRG(<admin_domain>) NODE(<node>)
ACTION(*STRCRGJOB)

where <cluster> is the name of your cluster, <admin_domain> is the
name
of the cluster administrative domain, and <node> is the cluster node
name for the system. You should call this command once for each
cluster
administrative domain in your cluster.

After the PTF has been applied, you should also restart the QPRFSYNCH
job on every node in your cluster.  You can restart the QPRFSYNCH job
with the following commands:

CALL PGM(QSYS/QFPAPRFJ) PARM(END)
CALL PGM(QSYS/QFPAPRFJ) PARM(START)

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

You must end any jobs that caused the QfpadRtvMonitoredResourceInfo API
to be called before this fix will be activated.  This includes any jobs
that display information about Monitored Resource Entries (MREs) in a
Cluster Administrative Domain.  Specifically, any jobs running the
WRKCLU command, the Cluster Resource Services GUI or the HASM GUI must
be ended.

If the HTTP server ADMIN instance is active, it should be restarted.
End the HTTP server ADMIN instance jobs with the following command:

ENDTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)

Once all of the HTTP server ADMIN instance jobs have ended, use the
following command to restart the ADMIN instance jobs.

STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI43216 :
=================================================

You must follow the Special Instructions for the superseded PTF
SI39264.

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI39264 :
=================================================

You must follow the Special Instructions for the superseded PTF
SI31138.


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   SI33277      OSP-INCORROUT MRE's are not being displayed correctly
   SI43216      OSP Cluster Admin Domain Changes.
   SI39264      OSP Cluster Admin Domain Changes.
   SI31138      OSP-INCORROUT Admin domain incorrectly shows *NWSD is Consis
   SI31138      OSP-MSGCPD0019-T/QWCSVALOH CHGSYSVAL QCURSYM to %
   SI29033      OSP-INCORROUT Add MRE fails in mixed release admin domain
   SI29033      OSP INCORROUT Failed to add *USRPRF MRE when QRETSVRSEC set

Summary Information

System..............................i
Models..............................
Release.............................V6R1M0
Licensed Program...............5761SS1
APAR Fixed..........................SE47998
Superseded by:......................View fix details for PTF SI56943
Recompile...........................N
Library.............................QSYS
MRI Feature ........................NONE
Cum Level...........................C1256610


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, 2019 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.

[{"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":"V6R1M0","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG16A","label":"PTF Cover Letters - i5\/OS V6R1 environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"V6R1M0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
06 July 2011