IBM Support

MF52128 - OSP Alter Table Move Index Fix

PTF Cover Letter


PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

OSP Alter Table Move Index Fix


Pre/Co-Requisite PTF / Fix List

REQ  LICENSED      PTF/FIX  LEVEL

TYPE PROGRAM  REL  NUMBER   MIN/MAX  OPTION
---- -------- ---  -------  -------  ------
CO   5770999  710  MF49756   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 'IBM License Agreement for Machine
Code', the terms of which were provided in a printed document that was
delivered with the machine.

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.


APAR Error Description / Circumvention

-------------------------------------------------
During access path processing, during an Alter Table, some
explicitly journaled access paths have an internal journaling
status which is invalid.  This applies to access paths which are
not affected by the changes to their underlying physical file,
those who have special processing performed on the access path.

CORRECTION FOR APAR 'MA40422' :
-------------------------------
This PTF corrects the Alter Table processing.

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


Activation Instructions


None.




Special Instructions

APAR MA40422's PTF corrects an internal database index processing
problem during an Alter Table.  Without the PTF, a system crash after
the Alter Table exposes certain indexes to possible damage or
incomplete recovery.

Only a very small subset of indexes have the potential exposure to this
damage.
An index could become damaged during the system crash if:
- Main storage was not preserved at the time of the system crash
- The index's physical file was in use for update, insert, or delete at
the time of the system crash
- The index was explicitly journaled at the time of the crash (via the
STRJRNAP CL command)
- The index's physical file was altered at some point subsequent to
starting explicit access path journaling.
The alter of the physical file was performed in one of the following
three ways:
1) The SQL ALTER TABLE statement was performed
2) The CHGPF CL command with a SRCFILE keyword, or
3) An SQL DELETE statement without a WHERE clause (where all rows were
deleted) under commitment control)
- The index has not been rebuilt since the system crash

If you suspect you may have indexes that meet this criteria, you should
consider rebuilding these indexes or checking to ensure that the
indexes are not damaged.

To determine which indexes are currently explicitly journaled, you can
issue the following command:
DSPFD FILE(*ALL/*ALL) TYPE(*ACCPTH) OUTPUT(*OUTFILE) OUTFILE(QTEMP/A)

Then query the resulting table. For example, via the following SQL
statement:
SELECT * FROM qtemp.a WHERE APACPJ = 'Y'

To check indexes and ensure that the indexes are not damaged, the check
index tool can be used.  It is documented at
http://www-912.ibm.com/s_dir/slkbase.NSF/DocNumber/585335019.


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   MF51569      LIC-DB-OTHER-PERFM QUSRMBRD API CONSUMES EXCESSIVE RESOURCE
   MF50997      LIC-DB Additional materialization data
   MF50734      LIC-DB-UNPRED Alter table on partitioned index
   MF50082      LIC-DB-OTHER-UNPRED TEMP STORAGE INCREASING ON SYSTEM WITH A
   MF49880      LIC-DB-MSGMCH5601 Alter Table/Alter Column to Set Fieldproc
   MF49528      LIC-DB-OTHER MCH1864 on Create Table with field procedures a
   MF49755      LIC-DB-OTHER-F/QQQSVRTN -T/QQQSVRTN-MSGMCH3601 Fieldproc and
   MF49647      LIC-DB-SRCB6001215 #dbcdsrt referencing too far into a DSR s
   MF49469      LIC-DB-OTHER SRCB6000302 on DSPFD with fieldprocs
   MF49423      OSP-CL-RUN Support In Memory option for database objects
   MF47894      OSP-Database synchronously move physical file member to new

Summary Information

System..............................i
Models..............................
Release.............................V7R1M0
Licensed Program...............5770999
APAR Fixed..........................View details for APAR MA40422
Superseded by:......................View fix details for PTF MF68054
Recompile...........................N
Library.............................QSYS
MRI Feature ........................NONE
Cum Level...........................C1116710


IBM 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, 2020 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"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1","Product":{"code":"SG15V","label":"PTF Cover Letters - IBM i General"},"Component":"5770999","Edition":""},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1","Product":{"code":"SG16D","label":"PTF Cover Letters - IBM i 7.1"},"Component":"5770999","Edition":""}]

Document Information

Modified date:
01 December 2020