A fix is available
APAR status
Closed as unreproducible in next release.
Error description
This APAR updates the CM Analyze options "Unload Altered Tables" and "Recreate for Nulls Change", including a rename of the latter option to "Preserve all data."
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: Users of the Db2 Administration Tool * * for z/OS and Db2 Object Comparison * * Tool for z/OS who use Change * * Management (CM) to recover a change. * **************************************************************** * PROBLEM DESCRIPTION: This APAR updates the functionality of * * the CM analyze options "Unload Altered * * Tables" and "Recreate for NULLS * * Change," and the corresponding CM batch * * options unload_altered_tables and * * recreate_for_nulls_change. * **************************************************************** 1. Previously, when using Change Management and analyzing changes, the recover option "Unload Altered Tables"= Y did not determine whether UNLOAD statements were generated. This setting forced an ALTER operation instead of DROP and CREATE operations if possible. This APAR changes the "Unload Altered Tables" option, so that it now controls whether UNLOAD statements are generated for altered tables. Additionally, the choice of whether to use ALTER instead of DROP and CREATE is now made independently of the value of the "Unload Altered Tables" option. 2. In situations where a table column is dropped, compare results in a non-destructive ALTER statement now and requires a REORG operation. It is recommended for the user to either specify "Run REORG/REBUILD" = A or M option on panels GOC5 (Compare) or ADB2C11A (Analyze), OR the run_reorg_rebuild = A or M CM Batch parameter, along with SHRLEVEL = CHANGE or REFERENCE, in order to materialize the change. In the absence of a REORG, subsequent ALTERs on the same objects will fail with SQLCODE -20385. 3. Previously, the "Unload Altered Tables" option was forced to "YES" when recovering to either original or existing data. This APAR changes this behavior so that this option is forced to "YES" only when recovering to original data. 4. With this APAR, the CM analyze option "Recreate for NULLS Change" is renamed "Preserve all data," and the corresponding CM batch option recreate_for_nulls_change is renamed preserve_all_data. "Preserve all data" = NO allows a NULL column change as an ALTER operation instead of DROP and CREATE operations. Previously, the "Recreate for NULLS Change" option was applicable only if "Unload Altered Tables" was set to Y. With this APAR, the renamed option "Preserve all data" is independent of the "Unload Altered Tables" option. 5. Previously, unnecessary UNLOAD statements were generated when recovering to original data during the RECOVER step. With this APAR, UNLOAD statements are generated for the Run step only. 6. This APAR changes the default value of CM Batch LOAD utility option util_load_enforce from YES (ENFORCE CONSTRAINTS) to NO (ENFORCE NO), because, if both child and parent tables are unloaded, dropped, recreated, and loaded, the tables may not be loaded in the correct sequence (parent tables first). If the child table gets loaded first, running with ENFORCE CONSTRAINTS will result in an empty child table because there are no corresponding parent rows. Recommendation: only use ENFORCE CONSTRAINTS if the change does not require a recreate of both the parent and child tables.
Problem conclusion
Temporary fix
Comments
APAR Information
APAR number
PH36418
Reported component name
DB2 ADMIN TOOL
Reported component ID
568851500
Reported release
C10
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2021-04-19
Closed date
2021-07-21
Last modified date
2021-08-09
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI76402
Modules/Macros
ADB2000 ADB2C11A ADB2CM1 ADB2CM2 ADB2CM3 ADB2CME ADB2CMF ADB2CMO ADB2CMP ADB2CMR ADB2CMS ADB2CMT ADB2CMU ADB2PCO ADB2UCUU ADB7000 ADBCCM ADBCMBIV ADBEALT ADBEMTAR ADBGAJOB ADBHPCO ADBSALT ADBSPCO ADBTEP2 ADBTIMC
Fix information
Fixed component name
DB2 ADMIN TOOL
Fixed component ID
568851500
Applicable component levels
RC10 PSY UI76402
UP21/07/23 P F107
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Line of Business":{"code":"LOB10","label":"Data and AI"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSZJXP","label":"DB2 Tools for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"12.1.0"}]
Document Information
Modified date:
10 August 2021