Skip to content

DATAPUMP遭遇ORA-39029 ORA-04030

平台 P750*2
系统 AIX 6108
数据库 1120310 RAC

导出脚本:

expdp system/oracle DIRECTORY=DBPUMP dumpfile=js_jssi_jsrep_%U.dmp logfile=js_all_exp.log SCHEMAS=JSREP,JSSI,JYCHK,SJQY

导入脚本:

impdp system/oracle DIRECTORY=DBPUMP dumpfile=js_jssi_jsrep_%U.dmp logfile=js_all_imp.log SCHEMAS=JSREP,JSSI,JYCHK,SJQY cluster=N

遇错:

ORA-39014: One or more workers have prematurely exited.
ORA-39029: worker 3 with process name "DW00" prematurely terminated
ORA-31671: Worker process DW00 had an unhandled exception.
ORA-04030: out of process memory when trying to allocate 4194328 bytes (pga heap,buf_kgcbz2state)
ORA-06512: at "SYS.KUPW$WORKER", line 1838
ORA-06512: at line 2

Job "SYSTEM"."SYS_IMPORT_SCHEMA_04" stopped due to fatal error at 10:44:55

实际现场情况是主机资源空闲,不存在资源不够的情况,所以直接就怀疑到Oracle的用户资源分配限制设置上,使用smit user登录检查oracle用户发现在sofe方面都实施RAC的人未做修改,改之。问题消失。

该问题在11.2.0.2之前可能为bug。

Oracle Recommended Patches — Oracle Database

12.1.0.1 Current Recommended Patches

Patch Set Updates

Document Description Rolling RAC Patch Download
Note:18031528.8 12.1.0.1.3 (Apr 2014) Database Patch Set Update (PSU) Yes Patch:18031528

Grid Infrastructure

Document Description Rolling RAC Patch Download
Note:18413105.8 AIX/HP/zLinux: 12.1.0.1.3 (Apr 2014) Grid Infrastructure Patch Set Update (GI PSU) Yes Patch:18413105
Note:18139660.8 Linux/Solaris: 12.1.0.1.3 (Apr 2014) Grid Infrastructure Patch Set Update (GI PSU) Yes Patch:18139660

11.2.0.4 Current Recommended Patches

Patch Set Updates

Document Description Rolling RAC Patch Download
Note:18031668.8 11.2.0.4.2 (Apr 2014) Database Patch Set Update (PSU) Yes Patch:18031668

Grid Infrastructure

Document Description Rolling RAC Patch Download
Note:18139609.8 11.2.0.4.2 (Apr 2014) Grid Infrastructure Patch Set Update (GI PSU) Yes Patch:18139609

Also see:

  • Note:1645862.1 Things to Consider Before Upgrading to 11.2.0.4 to Avoid Poor Performance or Wrong Results

11.2.0.3 Current Recommended Patches

Patch Set Updates

Document Description Rolling RAC Patch Download
Note:18031683.8 11.2.0.3.10 (Apr 2014) Database Patch Set Update (PSU) Yes Patch:18031683

Grid Infrastructure

Document Description Rolling RAC Patch Download
Note:18139678.8 11.2.0.3.10 (Apr 2014) Grid Infrastructure Patch Set Update (GI PSU) Yes Patch:18139678

Exadata

Document Description Rolling RAC Patch Download
Note:888828.1 Recommended Patch Information for Database Machine and Exadata Storage Server 11g Release 2 (11.2)

EBusiness Suite R11i Certification

Document Description Rolling RAC Patch Download
Note:881505.1 Interoperability Notes for Oracle E-Business Suite Release 11i with Oracle Database 11.2.0.3

EBusiness Suite R12 Certification

Document Description Rolling RAC Patch Download
Note:1058763.1 Interoperability Notes for Oracle E-Business Suite Release 12 with Oracle Database 11.2.0.3

Miscellaneous Fixes

Document Description Rolling RAC Patch Download
Note:17403540.8 AIX: 11.2.0.3 N-apply patch for critcal AIX fixes – Bundle #2 Yes Patch:17403540

Also see:

  • Note:1392633.1 Common Performance/Wrong Results Bugs Reported on 11.2.0.3

11.2.0.2 Current Recommended Patches

Note: 11.2.0.2 is outside of patching policy. It is advisable to use a newer Patch Set or release.

Patch Set Updates

Document Description Rolling RAC Patch Download
Note:17082367.8 11.2.0.2.12 (Oct 2013) Database Patch Set Update (PSU) Yes Patch:17082367

Grid Infrastructure

Document Description Rolling RAC Patch Download
Note:17272753.8 11.2.0.2.12 (Oct 2013) Grid Infrastructure Patch Set Update (GI PSU) Yes Patch:17272753

Exadata

Document Description Rolling RAC Patch Download
Note:888828.1 Recommended Patch Information for Database Machine and Exadata Storage Server 11g Release 2 (11.2)

EBusiness Suite R11i Certification

Document Description Rolling RAC Patch Download
Note:1367654.1 Interoperability Notes for Oracle E-Business Suite Release 11i with Oracle Database 11.2.0.2

EBusiness Suite R12 Certification

Document Description Rolling RAC Patch Download
Note:1367644.1 Interoperability Notes for Oracle E-Business Suite Release 12 with Oracle Database 11.2.0.2

Also see:

  • Note:1320966.1 Common Performance/Wrong Results Bugs Reported on 11.2.0.2

11.2.0.1 Current Recommended Patches

Note: 11.2.0.1 is outside of patching policy. It is advisable to use a newer Patch Set or release.

Patch Set Updates

Document Description Rolling RAC Patch Download
Note:12419378.8 11.2.0.1.6 (Jul 2011) Database Patch Set Update (PSU) Yes Patch:12419378

Grid Infrastructure

Document Description Rolling RAC Patch Download
Note:9655006.8 11.2.0.1.2 (Jul 2010) Grid Infrastructure Patch Set Update (GI PSU) Yes Patch:9655006

Exadata

Document Description Rolling RAC Patch Download
Note:888828.1 Recommended Patch Information for Database Machine and Exadata Storage Server 11g Release 2 (11.2)

EBusiness Suite R11i Certification

Document Description Rolling RAC Patch Download
Note:1265268.1 Interoperability Notes for Oracle E-Business Suite Release 11i with Oracle Database 11.2.0.1

EBusiness Suite R12 Certification

Document Description Rolling RAC Patch Download
Note:1265232.1 Interoperability Notes for Oracle E-Business Suite Release 12 with Oracle Database 11.2.0.1

11.1.0.7 Current Recommended Patches

Patch Set Updates

Document Description Rolling RAC Patch Download
Note:18031726.8 11.1.0.7.19 (Apr 2014) Database Patch Set Update (PSU) Yes Patch:18031726

CRS

Document Description Rolling RAC Patch Download
Note:11724953.8 11.1.0.7.7 CRS Patch Set Update (CRS PSU) Yes Patch:11724953

Data Guard

Document Description Rolling RAC Patch Download
Note:7628357.8 11.1.0.7 Data Guard Broker Recommended Patch Bundle #1 No Patch:7628357

Exadata

Document Description Rolling RAC Patch Download
Note:835032.1 Recommended Patch Information for Database Machine and Exadata Storage Server 11g Release 1 (11.1)

EBusiness Suite R11i Certification

Document Description Rolling RAC Patch Download
Note:452783.1 Interoperability Notes for Oracle E-Business Suite Release 11i with Oracle Database 11.1.0.7
Note:7295298.8 Poor Subquery filter order / Queries against ALL_OBJECTS can be slow Yes Patch:7295298
Note:7253531.8 A dump [ttci2u] passing LOB data over heterogeneous connection with multibyte Yes Patch:7253531
Note:6530141.8 False ORA-979 can occur on an UPDATE DML Yes Patch:6530141

EBusiness Suite R12 Certification

Document Description Rolling RAC Patch Download
Note:735276.1 Interoperability Notes for Oracle E-Business Suite Release 12 with Oracle Database 11.1.0.7
Note:7684818.8 11.1.0.7 EBusiness Suite R12 Certification Patch Bundle #1 Yes Patch:7684818
Note:7630760.8 HPUX: 11.1.0.7 patch install deletes libskgxp11.a No Patch:7630760
Note:7253531.8 A dump [ttci2u] passing LOB data over heterogeneous connection with multibyte Yes Patch:7253531

11.1.0.6 Current Recommended Patches

Note: 11.1.0.6 is outside of patching policy. It is advisable to use a newer Patch Set or release.

EBusiness Suite R11i Certification

Document Description Rolling RAC Patch Download
Note:9196488.8 PLS-306 executing procedure on 11g from lower version PLSQL client No Patch:9196488
Note:7253531.8 A dump [ttci2u] passing LOB data over heterogeneous connection with multibyte Yes Patch:7253531
Note:6972189.8 Invalid package bodies when using _load_without_compile option Yes Patch:6972189
Note:6778860.8 11.1.0.6 EBusiness Suite R11 Certification Patch Bundle #1 No Patch:6778860
Note:6501565.8 Dump under JVM from JIT of Java class compiled with old Java compiler No Patch:6501565

EBusiness Suite R12 Certification

Document Description Rolling RAC Patch Download
Note:7377378.8 11.1.0.6 EBusiness Suite R12 Certification Patch Bundle #1 Yes Patch:7377378
Note:7253531.8 A dump [ttci2u] passing LOB data over heterogeneous connection with multibyte Yes Patch:7253531
Note:6991626.8 Datapump export fails with ORA-39126 / ORA-22813 Yes Patch:6991626
Note:6815733.8 OERI [qctcte1] from cost based transformation with subquery in ORDER BY clause Yes Patch:6815733
Note:6598432.8 ORA-1466 from read-only transaction when client / server in different timezones Yes Patch:6598432
Note:6266400.8 A dump can occur in kokbTabFuncRewrite Yes Patch:6266400

10.2.0.5 Current Recommended Patches

Patch Set Updates

Document Description Rolling RAC Patch Download
Note:16619894.8 10.2.0.5.12 (Jul 2013) Database Patch Set Update (PSU) Yes Patch:16619894

CRS

Document Description Rolling RAC Patch Download
Note:9952245.8 10.2.0.5.2 CRS Patch Set Update (CRS PSU) Yes Patch:9952245

10.2.0.4 Current Recommended Patches

Oracle introduced Patch Set Updates (PSU) for 10.2.0.4 which include recommended fixes for generic , RAC and DataGuard issues. 
The PSU should be treated as the recommended patch for these areas – additional recommendations may be listed below under relevant areas.
Please read Note:854428.1 for an introduction to Patch Set Updates.

Note: 10.2.0.4 is outside of patching policy. Database PSU 10.2.0.4.13 onwards are only available on limited platforms.

Patch Set Updates

Document Description Rolling RAC Patch Download
Note:16619897.8 10.2.0.4.17 (Jul 2013) Database Patch Set Update (PSU) Overlay [limited platforms] Yes Patch:16619897
Note:9352164.8 10.2.0.4.4 (Apr 2010) Database Patch Set Update (PSU) Yes Patch:9352164

Generic

Document Description Rolling RAC Patch Download
Note:9572766.8 Recommended merge fix for bug 6994194 and bug 8830147 Yes Patch:9572766

RAC

Document Description Rolling RAC Patch Download
Note:6367097.8 Recommended on HP Itanium: RAC diagnostics can abort the instance (LMS ORA-484) Yes Patch:6367097
Note:6079224.8 Recommended on Linux: RAC ORA-27506 / IPC Send timeout Yes Patch:6079224

CRS

Document Description Rolling RAC Patch Download
Note:9294403.8 10.2.0.4.4 CRS Patch Set Update (CRS PSU) Yes Patch:9294403

EBusiness Suite R12 Certification

Document Description Rolling RAC Patch Download
Note:7014646.8 OERI [kkocxj : pjpctx] from complex query Yes Patch:7014646

10.2.0.3 Current Recommended Patches

Note: 10.2.0.3 is outside of patching policy.

RAC

Document Description Rolling RAC Patch Download
Note:7145055.8 10.2.0.3 RAC Recommended Patch Bundle #2 Yes Patch:7145055

CRS

Document Description Rolling RAC Patch Download
Note:7117233.8 10.2.0.3 CRS Recommended Patch Bundle #3 Yes Patch:7117233

Data Guard

Document Description Rolling RAC Patch Download
Note:6909784.8 Recommended Merge Fix for bug 6128197 with Data Guard Logical No Patch:6909784
Note:6081556.8 10.2.0.3 Data Guard RMAN Recommended Patch Bundle #1 Yes Patch:6081556
Note:6081550.8 10.2.0.3 Data Guard Logical Recommended Patch Bundle #1 No Patch:6081550
Note:6081547.8 10.2.0.3 Data Guard Physical Recommended Patch Bundle #1 Yes Patch:6081547
Note:6048286.8 10.2.0.3 Data Guard Broker Recommended Patch #1 No Patch:6048286

EBusiness Suite R11i Certification

Document Description Rolling RAC Patch Download
Note:6166683.8 Z-Linux: ctxhx missing from 10.2.0.3 Yes Patch:6166683
Note:412271.1 Upgrade to 10.2.0.3 can fail with ORA-600 [22635] Yes Patch:5892355
Note:5871314.8 Pickler fix needed to allow some DB upgrade / downgrade to work Yes Patch:5871314
Note:5257698.8 9idata NLS files missing leading to file handle leak No Patch:5257698

EBusiness Suite R12 Certification

Document Description Rolling RAC Patch Download
Note:6319846.8 EBusiness Suite R12 Certification Recommended Patch Bundle Yes Patch:6319846
Note:5240469.8 Linux-X86 64bit: genoccish generates lots of errors No Patch:5240469

Miscellaneous Fixes

Document Description Rolling RAC Patch Download
Note:6875865.8 Database instrumentation for OCM Yes Patch:6875865
Note:6869828.8 Recommended Merge Fix of 6122097 and 5903829 Yes Patch:6869828
Note:471479.1 IOT corruption after upgrade from <= 9.2 to >= 10g Yes Patch:6646613
Note:6455161.8 Higher CPU / Higher “cache buffer chains” latch gets / Higher “consistent gets” after truncate/Rebuild No Patch:6455161
Note:453259.1 OERI[kcrfr_resize2] / cannot recover database No Patch:6128197
Note:453309.1 OERI[kcbo_link_q_1] / crash with fix for bug 5454831 installed Yes Patch:6017420
Note:5949701.8 Recommended Merge Fix of 5648872 and 5863277 Yes Patch:5949701
Note:455832.1 Client <= 9.2.0.7 / 10.1.0.4 can dump when running against higher level database No Patch:5933477
Note:5907779.8 Self deadlock hang on “cursor: pin S wait on X” (typically from DBMS_STATS) No Patch:5907779
Note:5896963.8 High LGWR CPU and longer “log file sync” with fix for bug 5065930 Yes Patch:5896963
Note:5765958.8 OERI[qcscpqbTxt] / OERI[qcsfbdnp:1] from ANSI query in PLSQL No Patch:5765958
Note:5728380.8 DML may spin under ktspffc searching for space in ASSM segment No Patch:5728380
Note:454464.1 Various dumps / instance crash possible Yes Patch:5605370
Note:5577046.8 ADD or DROP attribute causes UNION query to fail with ORA-1790 Yes Patch:5577046
Note:5514109.8 OERI [kql-hash-collision] / false ORA-955 No Patch:5514109
Note:5364143.8 Bind Peeking is not done upon query reload, Execution Plan changes Yes Patch:5364143
Note:5363584.8 Array insert into table can corrupt redo Yes Patch:5363584
Note:4899479.8 Undo/redo corruption if distributed transactions used No Patch:4899479

Oracle 数据库补丁发布时间表

当前数据库发布时间表

除非特别声明这里都是服务器版本。服务器版本总是包含一个原生相同字长的客户端(比如 64 位)。如果平台支持,那么它还会包含一个 32 位或 64 位的客户端。

点击标题上的版本号即可跳转到补丁集下载页面。

 

Platform 12.1.0.2 12.1.0.12 11.2.0.410 11.2.0.3 11.2.0.2 11.2.0.12 11.1.0.71 10.2.0.53 10.2.0.44 10.1.0.5
Linux x86 无计划 无计划 2013年8月28日 2011年9月23日 2010年9月13日 2009年9月1日 2008年9月18日 2010年4月30日 2008年2月22日 2006年1月30日
Linux x86-64 2014年2季度 2013年6月25日 2013年8月27日 2011年9月23日 2010年9月13日 2009年9月1日 2008年9月18日 2010年4月30日 2008年3月17日 2006年2月24日
Oracle Solaris SPARC (64-bit) 2014年2季度 2013年6月25日 2013年8月29日 2011年10月1日 2010年9月24日 2009年11月6日 2008年10月6日 2010年5月19日 2008年4月30日 2006年2月5日
Oracle Solaris x86-64 (64-bit) 2014年2季度 2013年6月25日 2013年8月29日 2011年10月1日 2010年9月24日 2009年11月25日 无计划 2010年5月19日 2008年11月13日 无计划
Microsoft Windows x64 (64-bit) 2014年2季度 2013年7月9日 2013年10月25日 2011年11月11日 2010年12月15日 2010年4月2日 2008年11月13日 2013年7月27日 2008年5月16日 无计划
HP-UX Itanium9 2014年2季度 2014年1月9日 2013年10月10日 2011年10月29日 2010年10月19日 2009年12月22日 2008年10月6日 2010年6月3日 2008年4月30日 2006年6月7日
HP-UX PA-RISC (64-bit)
See footnote 8 below
平台不再支持 8 平台不再支持 8 2014年1月2日 2012年2月16日 2011年3月15日 2010年5月20日 2008年11月11日 2010年12月15日 2008年6月2日 2006年2月5日
IBM AIX on POWER Systems 2014年2季度 2014年1月9日 2013年10月10日 2011年10月29日 2010年10月19日 2009年12月12日 2008年10月6日 2010年6月3日 2008年5月15日 2006年2月5日
IBM Linux on System z 2014年2季度 2014年1月9日 2014年1月9日 2011年12月1日 2011年3月30日 无计划 无计划 2011年1月3日 2008年12月16日 2006年8月26日
Microsoft Windows (32-bit) 无计划 无计划 2013年10月25日 2011年11月11日 2010年12月15日 2010年4月5日 2008年10月10日 2010年7月19日 2008年3月17日 2006年2月13日
Instant Client Releases
Apple Mac OS X (Intel)  已计划  无计划 2014年4月20日
只提供 Instant Client下载>
2013年1月31日
只提供 Instant Client
无计划 无计划 无计划 日期未定 2010年4月10日
只提供 Single Instance
无计划
IBM Linux on POWER 已计划
Older Releases

Apple Mac OS X (PowerPC)
平台不再支持
2007年1月8日
HP OpenVMS Alpha
平台不再支持
2012年10月31日 2008年12月15日 2008年2月15日
HP OpenVMS Itanium
平台不再支持 (详见 Doc ID 1307745.1)
2012年10月31日 2008年12月15日 无计划
HP Tru64 UNIX
平台不再支持
2011年4月21日 2008年2月20日 2006年10月18日
IBM Linux on POWER
平台不再支持 (详见 Doc ID 1310584.1)
2011年3月17日 2009年1月9日 无计划
IBM z/OS on System z
平台不再支持 (详见 Doc ID 461234.1)
2012年10月26日 无计划 2006年3月6日
Linux Itanium9
平台不再支持(详见 Doc ID 1130325.1)
2011年3月17日 2008年9月24日 2006年4月30日
Microsoft Windows Itanium (64-bit) 9
平台不再支持 (详见 Doc ID 1307745.1)
2011年5月12日 2009年2月2日 2006年1月30日
Oracle Solaris x86 (32-bit)
平台不再支持
2008年11月14日
这个平台的最终版
2006年6月18日
Platform 12.1.0.12 11.2.0.410 11.2.0.3 11.2.0.2 11.2.0.12 11.1.0.71 10.2.0.53 10.2.0.44 10.1.0.5

Legend:

Sched TBA = 日期未定

DD-MMM-YYYY: 在 My Oracle Support/MetaLink 上显示的补丁集可以下载的日期。

1H or 2H CYyyyy: 日历年上半年(6个月)或下半年中的某个日期。比如 1H CY2009 的意思是日历年2009上半年的某个时间。

Qn CYyyyy: 日历年第 n 个季度(3个月)中的某个日期. 比如 Q2 CY 2009 的意思是日历年2009年第2季度,也就是4月到6月间的某个时间。

Unsupported platform – 以后不会再对这个平台发布新的数据库版本。

Patching for previous release ends: 看下面的解释.

生活以及Oracle

总的来讲,我不善于写这种技术和生活交涉的文字。
工作这些年,以技术融入社会,在oracle 数据库这条路越走越远,经常会迷惑自己会想要什么?经常有人在身边说某某在某行发了,在最初的几年确实是怦然心动。技术在最初的几年是无法很明显的改善生活的,这个我已经深有体会,我也想过做其它方面的事情,但是并没有鼓足勇气去放弃自己喜欢的工作。
从实际上讲我并不是一个好工程师,因为我不喜欢钻牛角尖,我喜欢一种感觉,推动以及完成一个项目的成就感,把技术实际的应用施展开来,这种感觉很棒!你会发现没有什么能比把自己的专业知识给予用户解决方案解客户燃眉之急的那种感觉,这可能正是你在这个行业苦苦追寻的,当然我现在发现这是我在追求的。今年早些时候老姚和我聊到这个话题,他的定义就是类销售方向,我的理解就是技术型专家走上了工程师与销售的角色混合之路。

我很想把我的所学每天按部就班整理出来放到blog,人的精力是有限的可是。
我很想把事情做好,却没有足够做完美一件事情的时间,最近理解得很深刻,做事的人不是简单的4个字。且行且稳,路还要远,就想勒夫当年还是一个德乙的球员,如今却是德国国家队教练一样,任重道远,看得远那是应该的,做好眼前事一步步走出踏实的印子那更是必须的。

Fatal NI connect error 12170.

11g中的12170事件.
其实遭遇这个错误不是第一回,我因为应用在半夜的批处理数据交互中出现某个环节进程连接丢失的情况在复查日志时候发现这个错误,因为是半夜2点,当时备份在执行,而且监听日志已经1g了,所以进程估计在io和cpu压力下响应时间超过了阀值就断开了,这个时候也报了12170.具体的12170解释参考了下官方的说法,下面描述一翻:

报错信息如下:

VERSION INFORMATION:
TNS for Linux: Version 11.2.0.1.0 - Production
Oracle Bequeath NT Protocol Adapter for Linux: Version 11.2.0.1.0 - Production
TCP/IP NT Protocol Adapter for Linux: Version 11.2.0.1.0 - Production
Time: 11-MAY-2011 22:23:40
Tracing not turned on.
Tns error struct:
Tns main err code: 12535

TNS-12535: TNS:operation timed out
ns secondary err code: 12560
nt main err code: 505

TNS-00505: Operation timed out
nt secondary err code: 110
nt OS err code: 0
Client address: (ADDRESS=(PROTOCOL=tcp)(HOST=10.131.29.167)(PORT=1827))

官方解释以及处理办法如下:

1.version
Oracle Net Services - Version: 11.1.0.6 to 11.2.0.2 - Release: 11.1 to 11.2
Oracle Server - Enterprise Edition - Version: 11.1.0.6 to 11.2.0.2   [Release: 11.1 to 11.2]
Information in this document applies to any platform.

2.cause
These time out related messages are mostly informational in nature.  The messages indicate the specified client connection (identified by the 'Client address:' details) has experienced a time out.  The 'nt secondary err code' identifies the underlying network transport, such as (TCP/IP) timeout limits after a client has abnormally terminated the database connection.
 The 'nt secondary err code' translates to underlying network transport timeouts for the following Operating Systems:
 For the Solaris system: nt secondary err code: 145:

 #define ETIMEDOUT 145 /* Connection timed out */

 For the Linux operating system: nt secondary err code: 110
ETIMEDOUT 110 Connection timed out

For the HP-UX system: nt secondary err code: 238:

ETIMEDOUT 238 /* Connection timed out */

For Windows based platforms: nt secondary err code: 60 (which translates to Winsock Error: 10060)
Description:  A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond.

The reason the messages are written to the alert log is related to the use of the new 11g Automatic Diagnostic Repository (ADR) feature being enabled by default.

3、Solution
To revert to Oracle Net Server tracing/logging, set following parameter in the server's sqlnet.ora :

DIAG_ADR_ENABLED = OFF

Also, to back out the ADR diag for the Listener component, set following parameter in the server's listener.ora:

DIAG_ADR_ENABLED_ = OFF

   - Where the  would be replaced with the actual name of the configured listener(s) in the listener.ora configuration file.  For example, if the listener name is 'LISTENER', the parameter would read:

DIAG_ADR_ENABLED_LISTENER = OFF

-Reload or restart the TNS Listener for the parameter change to take effect.