ow_nav");if(navDiv) {navDiv.style.display="none";set_prefs(1,1);}} if(navToggleInline) {navToggleInline.onclick=showNav;navToggleInline.innerHTML=navToggleInline.innerHTML.replace(/Hide Navigation/,"Show Navigation");navToggleInline.innerHTML=navToggleInline.innerHTML.replace(/hide_nav/,"show_nav");if(navDiv) {navDiv.style.display="none";set_prefs(1,1);}} document.navState="hidden";return false;});var converterLevel=(function() {var allmeta=$$("meta");var theLevel;for(i=0;iwidest.scrollWidth) {widest=el;}} alert("Widest element = ["+widest.innerHTML.substr(0,32)+"] with a scrollWidth of "+widest.scrollWidth);} function massage_table_widths() {return;function getStyle(el,prop) {var val;if(el.currentStyle) {val=el.currentStyle[prop];} else if(window.getComputedStyle) {val=document.defaultView.getComputedStyle(el,null).getPropertyValue(prop);} return val;} var e=document.getElementsByTagName("table"),counter=0,widths="",w;alert("Massaging table widths for "+e.length+" tables...");for(var i=0,limit=e.length;i0) {alert("Removed 100% width from "+counter+" tables.");alert("Untouched tables had widths:\n"+widths);} e=document.getElementsByTagName("col");alert("Massaging column widths for "+e.length+" columns...");for(var i=0,limit=e.length;i=0)) {return"";} var prefs;if((prefs=document.tahiti_prefs)==null) {prefs=document.cookie;prefs=prefs.replace(/.*; *(ORA_TAHITI_PREFS=.*?)(;|$).*/,"$1");if(prefs.length==0) {return"";} if(!prefs.match(/^ORA_TAHITI_PREFS=/)) {return"";} prefs=prefs.replace(/^ORA_TAHITI_PREFS=(.*)/,"$1");document.tahiti_prefs=prefs;} else {} return prefs.charAt(which);} function cookie_exists() {var prefs;if((prefs=document.tahiti_prefs)==null) {prefs=document.cookie;prefs=prefs.replace(/.*; *(ORA_TAHITI_PREFS=.*?)(;|$).*/,"$1");if(prefs.length==0) {return false;} if(!prefs.match(/^ORA_TAHITI_PREFS=/)) {return false;}} else {return true;}} function set_prefs(which,value) {if(!(which>=0)) {return;} if(value!=0&&value!=1) {return;} var prefs;if((prefs=document.tahiti_prefs)==null) {if(!cookie_exists()) {set_cookie("----------------");} prefs=document.cookie;prefs=prefs.replace(/.*; *(ORA_TAHITI_PREFS=.*?)(;|$).*/,"$1");if(prefs.length==0) {return;} if(!prefs.match(/^ORA_TAHITI_PREFS=/)) {return;} prefs=prefs.replace(/^ORA_TAHITI_PREFS=(.*)/,"$1");document.tahiti_prefs=prefs;} else {} var new_prefs=prefs.substring(0,which)+value+prefs.substring(which+1,16);set_cookie(new_prefs);} var arrow_width=18;var arrow_height=18;var arrow_style='margin: 0px 0px 0px 0px; padding: 0px; /* position: relative; top: 2px; */';var arrow_side_name='blue_med_dark_side.gif';var arrow_down_name='blue_med_dark_down.gif';var sidearrow='Expand this chapter';var downarrow='Collapse this chapter';var sidearrow_regexp=new RegExp("","i");var downarrow_regexp=new RegExp("","i");var flipOne=(function(evt) {var id=this.id.replace(/^[a-z]*/,"");var subheads=$("list"+id);if(subheads==null) {print("Can't find list of subheadings, id list"+id);return false;} var discloseControl=$("disclose"+id);if(discloseControl==null) {print("Can't find list of subheadings, id disclose"+id);return false;} if(!evt) {evt=window.event;} var shiftPressed;if(evt) {shiftPressed=evt.shiftKey;} if(subheads.style.display=="none") {if(shiftPressed) {expand();return false;} subheads.style.display="block";discloseControl.innerHTML=discloseControl.innerHTML.replace(sidearrow_regexp,downarrow);} else {if(shiftPressed) {collapse();return false;} subheads.style.display="none";discloseControl.innerHTML=discloseControl.innerHTML.replace(downarrow_regexp,sidearrow);} return false;});addOnload(function() {var findSubheadTag=(function() {var potential="ul";var subheads=$$(potential);if(subheads!=null&&subheads.length>0) {return potential;} potential="dl";subheads=$$(potential);if(subheads!=null&&subheads.length>0) {return potential;} return null;});var eligibleToc=(function() {var myAddress=window.location.href;if(!myAddress.match(/\/[a-z]+\.[0-9]+\//)) {return false;} if(myAddress.match(/\/mix.[0-9]{3}\//)) {return false;} var head1s=$$("h1");if(head1s==null||head1s.length==0) {return false;} var conflict=$("expandlink");if(conflict) {return false;} conflict=$("collapselink");if(conflict) {return false;} var firstHead1=head1s[0];if(!firstHead1.innerHTML.match(/\bContents\b/)) {return false;} if(converterLevel()==null) {return false;} if(findSubheadTag()==null) {return false;} return true;});if(eligibleToc()==false) {return;} var head1s=$$("h1");var firstHead1=head1s[0];var head2s=$$("h2");var subheadTag=findSubheadTag();var subheads=$$(subheadTag);var listCounter=0;var firstLevel={};var print=(function(what) {alert(what);return;var msgArea=$("message");var msgBackup=$("footer");if(msgArea!=null) {msgArea.innerHTML+=what+"
";} else if(msgBackup!=null) {msgBackup.innerHTML+=what+"
";}});var analyze=(function() {var subheadTag=findSubheadTag();var subheads=$$(subheadTag);var head2s=$$("h2");var counter=0;for(i=0;i'+sidearrow+' ';firstLevel[counter]=previousHead;previousHead.id="head"+counter;previousHead.innerHTML=disclosureControl+previousHead.innerHTML;var justCreated=$("disclose"+counter);if(justCreated!=null) {justCreated.numericID=counter;justCreated.title="Expand or Collapse";justCreated.onclick=flipOne;} else {} currentList.id="list"+counter;currentList.style.marginLeft='32px';counter++;}} for(i=0;iPart (I|V|X)/)) {currentHead.style.textAlign="center";currentHead.style.borderTop="medium solid #039";currentHead.style.marginTop="10px";currentHead.style.paddingTop="10px";} else if(!currentHead.innerHTML.match(/id="disclose/)) {currentHead.innerHTML="      "+currentHead.innerHTML;} else {}}});var expand=(function() {var subheads=$$(findSubheadTag());var head2s=$$("h2");for(i=0;iPart (I|V|X)/)) {theHead.style.marginTop="5px";} if(currentHead.innerHTML.match(/>Part (I|V|X)/)) {theHead.style.marginBottom="1px";} var discloseControl=$("disclose"+i);if(discloseControl!=null) {discloseControl.innerHTML=discloseControl.innerHTML.replace(sidearrow_regexp,downarrow);}} return false;});var collapse=(function() {var subheads=$$(findSubheadTag());var head2s=$$("h2");for(i=0;iPart (I|V|X)/)) {theHead.style.marginTop="5px";} theHead.style.marginBottom="1px";theHead.style.marginLeft="0px";theHead.style.paddingLeft="0px";var discloseControl=$("disclose"+i);if(discloseControl!=null) {discloseControl.innerHTML=discloseControl.innerHTML.replace(downarrow_regexp,sidearrow);discloseControl.style.padding="0px 6px";if(discloseControl.addEventListener==null) {discloseControl.onclick=flipOne;}}} return false;});analyze();collapse();var toolbar=document.createElement('div');var toolbarContent=document.createTextNode('');var fontsize="120%";var button_style='/* position: relative; top: 4px; */';var expand_all='Expand All';var collapse_all='Collapse All';toolbar.appendChild(toolbarContent);toolbar.innerHTML=''+expand_all+' | '+collapse_all+' (Or click any '+sidearrow+' icon to expand that chapter.) Sign in or register for a free Oracle Web account, to enable personalized documentation features';firstHead1.parentNode.insertBefore(toolbar,firstHead1.nextSibling);var expandLink=$('expandlink');var collapseLink=$('collapselink');expandLink.onclick=expand;collapseLink.onclick=collapse;var always_link=$("collapse_preference_expanded");var always_expand;var always_collapse;var bumpDown=(function(id) {var theItem=$(id);if(theItem) {try {theItem.style.position="inherit";theItem.style.position="relative";theItem.style.top="4px";} catch(err){}}});bumpDown("expand_all_button");bumpDown("collapse_all_button");bumpDown("expand_collapse_icon");always_expand=(function() {expand();var me=$("collapse_preference_expanded");if(me) {me.innerHTML="Always collapse all";me.id="collapse_preference_collapsed";if(me.href) {me.href=me.href.replace(/_collapsed/,"_expanded");} me.onclick=always_collapse;} else {} return true;});always_collapse=(function() {collapse();var me=$("collapse_preference_collapsed");if(me) {me.innerHTML="Always expand all";me.id="collapse_preference_expanded";if(me.href) {me.href=me.href.replace(/_expanded/,"_collapsed");} me.onclick=always_expand;} else {} return true;});if(always_link) {always_link.onclick=always_expand;} else {always_link=$("collapse_preference_collapsed");if(always_link) {always_link.onclick=always_collapse;}}}); function showPlatform(what) {var platform_name=new RegExp(what,"i");var head1s=document.getElementsByTagName("h1");for(i=0;iMain Categories'+ '';} function shortcutLinks() {return'

Quick Lookup

'+ '';} function flipNavContainer() {return'
';} function bug() {return' ';} function searchForm() {return'
'+ '
'+ '
'+ ''+ ''+ ''+ ''+ ''+ ''+ ''+ '
'+ ' '+ ''+ '
'+ '
'+ '
'+ '
';} function historyPlaceholder() {return'
';} function keyboardControls() {return'';} function rssFeeds() {return'
'+ '

New and changed books:

'+ ' HTML documents '+ ' PDF files'+ '
';} function chapterDetails() {var output='

This Page

'+ '
';var divCounter=0;var allHead1s=$$("h1");if(allHead1s) {var theHead1=allHead1s[0];if(theHead1.id==null||theHead1.id.length==0) {theHead1.id="insertedID"+divCounter++;} else {} var innerText=theHead1.innerHTML.replace(/<.*?>/g,"");output+='';if(theHead1.className!=null&&theHead1.className=="glossary") {var allParas=$$("p");if(allParas) {for(i=0;i/g,"");output+='';}}}} else if((theHead1.className!=null&&theHead1.className=="toc")||theHead1.innerHTML=="Contents") {} else {var allHead2s=$$("h2");for(i=0;i/g,"");innerText=innerText.replace(/ /g,"");output+='';}}} output+='
';return output;} var bookTitle=(function() {var allmeta=$$("meta");for(i=0;iThis Book'+ ''+ '';}} return'';});rememberLayout();var head1s=$$("div");if(head1s) {var firstHead1=head1s[0];var myAddress=window.location.href;var partno=myAddress.replace(/.*\/([a-z][0-9]{5})\/.*/,"$1");var navDiv=document.createElement('div');var navContent=document.createTextNode('');navDiv.appendChild(navContent);navDiv.innerHTML=flipNavContainer()+ bug()+ searchForm()+ shortcutLinks()+ '
'+ categories()+ chapterDetails()+ '
'+ bookTitle()+ historyPlaceholder()+ keyboardControls()+ rssFeeds();firstHead1.parentNode.insertBefore(navDiv,firstHead1.nextSibling);navDiv.id="nav";style_navbar(navDiv.style);} var toolbar=$('flipNav_container');if(toolbar!=null) {toolbar.innerHTML='Show Navigation
';} else {alert("flipNav_container does not exist");} var navToggle=$("flipNav");if(navToggle) {navToggle.onclick=showNav;} else {alert("Can't find flipNav element");} var navToggleInline=$("flipNavInline");if(navToggleInline) {navToggleInline.onclick=showNav;} else {alert("Can't find flipNavInline element");}});var head1s=$$("h1");var firstHead1=head1s[0];var toolbar=document.createElement('div');var toolbarContent=document.createTextNode('');toolbar.appendChild(toolbarContent);toolbar.innerHTML='Show Navigation
';firstHead1.parentNode.insertBefore(toolbar,firstHead1);makeNav();var should_hide_nav=get_prefs(1);if(should_hide_nav!="1") {showNav();} else {document.navState="hidden";}}); addOnload(function() {var addCommentForm=(function() {var myAddress=window.location.href;var myPath=myAddress.replace(/.*\/([a-z]+\.[0-9]+\/[a-z][0-9]{5}\/.*.htm).*/,"$1");var comment_form=''+ '
'+ '

User Comments

'+ '
'+ ''+ ' '+ ''+ '
'+ ' '+ ' '+ '
'+ ''+ ''+ '
'+ '

'+ 'By submitting a comment, you confirm that you have read and agreed to '+ 'the terms and conditions.'+ '

'+ '

'+ 'This feedback form is for documentation corrections and suggestions. '+ 'Because of the volume of suggestions, we cannot reply to every comment. '+ 'In particular:'+ '

'+ ''+ ''+ '(Comments are moderated and will not appear immediately.)'+ '
'+ '
'+ '
';var allDivs=$$("div");for(i=allDivs.length-1;i>=0;i--) {if(allDivs[i].className=="footer") {var footer=allDivs[i];footer.id="comment_block";footer.innerHTML=comment_form+footer.innerHTML;}}});var comment_counter=0;var addComment=(function(theComment) {var allDivs=$$("div");for(i=allDivs.length-1;i>=0;i--) {if(allDivs[i].className=="footer") {var footer=allDivs[i];footer.innerHTML='
From: '+theComment.name+'
'+'
Title: '+theComment.title+'
'+'
Date: '+theComment.submitted+'
'+'
'+theComment.text+'
'+'
'+footer.innerHTML;}}});var converterLevel=(function() {var allmeta=$$("meta");var theLevel;for(i=0;i";} else if(msgBackup!=null) {msgBackup.innerHTML+=what+"
";}});var this_page=$("nav_this_page");if(this_page) {this_page.innerHTML+=' [0 comments, Leave a comment]

';} var comment=new Object(); var showTerms=(function() {var newwindow=window.open('http://www.oracle.com/pls/db111/comment_disclaimer','TermsWindow','scrollbars=yes,width=500,height=400,screenx=50,screeny=50,location=no,toolbar=no,directories=no');return false;});addCommentForm();var terms_link=$("comment_ts_and_cs");if(terms_link) {terms_link.onclick=showTerms;}}); addOnload(function() { make_me_as_wide_as("search_this_book","comment_announcement"); }); addOnload(function() {var myAddress=window.location.href;var anchor;var tab;if(myAddress.match(/#/)) {anchor=myAddress.replace(/.*#(.*)/,"$1");} if(myAddress.match(/\bselected=[0-9]+\b/)) {tab=myAddress.replace(/.*\bselected=([0-9]+)\b.*/,"$1") } if(tab==99) {return;} var anchors=$$("a");var theAnchor;var progress="";var portal_id=new RegExp("\\bselected="+tab+"\\b");var anchor_id=new RegExp("#"+anchor+"$");for(i=0;i'+searchterm+'
',"g");} else {}});} else {} function $(param) {return document.getElementById(param);} function $$(param) {return document.getElementsByTagName(param);} function $b() {return document.body;} function $h() {return $$("head")[0];} function $html() {return $$("html")[0];} function $l() {return window.location.href;} function $i() {return document.body.innerHTML;} function $m() {return $$("meta");} function findPosX(obj) {var curleft=0;if(obj.offsetParent) while(1) {curleft+=obj.offsetLeft;if(!obj.offsetParent) break;obj=obj.offsetParent;} else if(obj.x) curleft+=obj.x;return curleft;} function findPosY(obj) {var curtop=0;if(obj.offsetParent) while(1) {curtop+=obj.offsetTop;if(!obj.offsetParent) break;obj=obj.offsetParent;} else if(obj.y) curtop+=obj.y;return curtop;} function firstHead() {var heads=$$("h1");if(heads&&heads.length>0) {for(var i=0;i0)) {for(var i=0;i0)&&(theNumber[0].className=="secnum")) {chapter=theNumber[0].innerHTML.replace(/^ *(.*?) *$/,"$1");} else {alert("Couldn't determine which chapter this is: "+theNumber[0]);try {alert(els[0].innerHTML);} catch(err) {} return false;}} else {}} if(chapter==null) {chapter='x.y';}} else {try {} catch(err) {} return false;} els=$$("h2");h3s=$$("h3");var cur_ypos,next_ypos,h3_counter,h3_ypos,h3,next_h3_to_consider=0;if(els!=null&&els.length>0) {for(var i=0;i0)&&(theNumber[0].className=="secnum")) {return false;} else {el.innerHTML=''+chapter+'.'+(++counter)+' '+el.innerHTML;if(h3s!=null&&h3s.length>0) {cur_ypos=findPosY(el);h3_counter=0;if(i+1cur_ypos&&h3_ypos '+h3.innerHTML;next_h3_to_consider++;}}}}} return true;} setStatus('Turning section numbers on');set_prefs(3,1);return false;} function jump(chapter) {if(window.location.href.match(/\/toc.htm/)) {if(chapter==null) {chapter=prompt("Jump to chapter:","");} if((chapter!=null)&&chapter.match(/^([0-9.]+|[A-Za-z][0-9.]*)$/)) {var toc_chapters=$$("h2");for(var i=0;i0)&&(theNumber[0].className=="secnum")&&(theNumber[0].innerHTML==chapter.toUpperCase())) {var anchors=theChapter.getElementsByTagName("a");if(anchors&&(anchors.length>0)) {for(var j=anchors.length-1;j>=0;--j) {if((anchors[j].id==null||!anchors[j].id.match(/^disclose/))&&anchors[j].href.match(/\.htm(#.+){0,1}/)) {window.location.href=anchors[j].href;return false;}}}}} if(chapter.match(/\./)) {var subheads=$$("li");if(subheads&&subheads.length>0) {var el,secnum;for(var i=0;i0&&secnum[0].className=="secnum") {if(secnum[0].innerHTML==chapter.toUpperCase()) {var anchors=el.getElementsByTagName("a");if(anchors&&anchors.length>0) {window.location.href=anchors[0].href;return false;}}} else {}} return false;} else {}} alert("Didn't find requested chapter in this book");return false;} return false;} else {var chapter=prompt("Jump to chapter:","");if((chapter!=null)&&chapter.match(/^[0-9]+$/)) {if(typeof(chapters)!='undefined') {for(var i=0;i0) {return potential;} potential="dl";subheads=$$(potential);if(subheads!=null&&subheads.length>0) {return potential;} return null;});function inside_toc() {if($l().match(/toc.htm(l){0,1}(#.*){0,1}$/)) {return true;} return false;} var flip_numbers_inside=(function(tag) {var containers=$$(tag),spans,el,new_setting;if(containers&&containers.length>0) {for(var j=0;j0) {for(var i=0;iwidest.scrollWidth) {widest=el;}} alert("Widest element = ["+widest.innerHTML.substr(0,32)+"] with a scrollWidth of "+widest.scrollWidth);} function massage_table_widths() {return;function getStyle(el,prop) {var val;if(el.currentStyle) {val=el.currentStyle[prop];} else if(window.getComputedStyle) {val=document.defaultView.getComputedStyle(el,null).getPropertyValue(prop);} return val;} var e=document.getElementsByTagName("table"),counter=0,widths="",w;alert("Massaging table widths for "+e.length+" tables...");for(var i=0,limit=e.length;i0) {alert("Removed 100% width from "+counter+" tables.");alert("Untouched tables had widths:\n"+widths);} e=document.getElementsByTagName("col");alert("Massaging column widths for "+e.length+" columns...");for(var i=0,limit=e.length;i=0)) {return"";} var prefs;if((prefs=document.tahiti_prefs)==null) {prefs=document.cookie;prefs=prefs.replace(/.*; *(ORA_TAHITI_PREFS=.*?)(;|$).*/,"$1");if(prefs.length==0) {return"";} if(!prefs.match(/^ORA_TAHITI_PREFS=/)) {return"";} prefs=prefs.replace(/^ORA_TAHITI_PREFS=(.*)/,"$1");document.tahiti_prefs=prefs;} else {} return prefs.charAt(which);} function cookie_exists() {var prefs;if((prefs=document.tahiti_prefs)==null) {prefs=document.cookie;prefs=prefs.replace(/.*; *(ORA_TAHITI_PREFS=.*?)(;|$).*/,"$1");if(prefs.length==0) {return false;} if(!prefs.match(/^ORA_TAHITI_PREFS=/)) {return false;}} else {return true;}} function set_prefs(which,value) {if(!(which>=0)) {return;} if(value!=0&&value!=1) {return;} var prefs;if((prefs=document.tahiti_prefs)==null) {if(!cookie_exists()) {set_cookie("----------------");} prefs=document.cookie;prefs=prefs.replace(/.*; *(ORA_TAHITI_PREFS=.*?)(;|$).*/,"$1");if(prefs.length==0) {return;} if(!prefs.match(/^ORA_TAHITI_PREFS=/)) {return;} prefs=prefs.replace(/^ORA_TAHITI_PREFS=(.*)/,"$1");document.tahiti_prefs=prefs;} else {} var new_prefs=prefs.substring(0,which)+value+prefs.substring(which+1,16);set_cookie(new_prefs);} var arrow_width=18;var arrow_height=18;var arrow_style='margin: 0px 0px 0px 0px; padding: 0px; /* position: relative; top: 2px; */';var arrow_side_name='blue_med_dark_side.gif';var arrow_down_name='blue_med_dark_down.gif';var sidearrow='Expand this chapter';var downarrow='Collapse this chapter';var sidearrow_regexp=new RegExp("","i");var downarrow_regexp=new RegExp("","i");var flipOne=(function(evt) {var id=this.id.replace(/^[a-z]*/,"");var subheads=$("list"+id);if(subheads==null) {print("Can't find list of subheadings, id list"+id);return false;} var discloseControl=$("disclose"+id);if(discloseControl==null) {print("Can't find list of subheadings, id disclose"+id);return false;} if(!evt) {evt=window.event;} var shiftPressed;if(evt) {shiftPressed=evt.shiftKey;} if(subheads.style.display=="none") {if(shiftPressed) {expand();return false;} subheads.style.display="block";discloseControl.innerHTML=discloseControl.innerHTML.replace(sidearrow_regexp,downarrow);} else {if(shiftPressed) {collapse();return false;} subheads.style.display="none";discloseControl.innerHTML=discloseControl.innerHTML.replace(downarrow_regexp,sidearrow);} return false;});addOnload(function() {var findSubheadTag=(function() {var potential="ul";var subheads=$$(potential);if(subheads!=null&&subheads.length>0) {return potential;} potential="dl";subheads=$$(potential);if(subheads!=null&&subheads.length>0) {return potential;} return null;});var eligibleToc=(function() {var myAddress=window.location.href;if(!myAddress.match(/\/[a-z]+\.[0-9]+\//)) {return false;} if(myAddress.match(/\/mix.[0-9]{3}\//)) {return false;} var head1s=$$("h1");if(head1s==null||head1s.length==0) {return false;} var conflict=$("expandlink");if(conflict) {return false;} conflict=$("collapselink");if(conflict) {return false;} var firstHead1=head1s[0];if(!firstHead1.innerHTML.match(/\bContents\b/)) {return false;} if(converterLevel()==null) {return false;} if(findSubheadTag()==null) {return false;} return true;});if(eligibleToc()==false) {return;} var head1s=$$("h1");var firstHead1=head1s[0];var head2s=$$("h2");var subheadTag=findSubheadTag();var subheads=$$(subheadTag);var listCounter=0;var firstLevel={};var print=(function(what) {alert(what);return;var msgArea=$("message");var msgBackup=$("footer");if(msgArea!=null) {msgArea.innerHTML+=what+"
";} else if(msgBackup!=null) {msgBackup.innerHTML+=what+"
";}});var analyze=(function() {var subheadTag=findSubheadTag();var subheads=$$(subheadTag);var head2s=$$("h2");var counter=0;for(i=0;i'+sidearrow+' ';firstLevel[counter]=previousHead;previousHead.id="head"+counter;previousHead.innerHTML=disclosureControl+previousHead.innerHTML;var justCreated=$("disclose"+counter);if(justCreated!=null) {justCreated.numericID=counter;justCreated.title="Expand or Collapse";justCreated.onclick=flipOne;} else {} currentList.id="list"+counter;currentList.style.marginLeft='32px';counter++;}} for(i=0;iPart (I|V|X)/)) {currentHead.style.textAlign="center";currentHead.style.borderTop="medium solid #039";currentHead.style.marginTop="10px";currentHead.style.paddingTop="10px";} else if(!currentHead.innerHTML.match(/id="disclose/)) {currentHead.innerHTML="      "+currentHead.innerHTML;} else {}}});var expand=(function() {var subheads=$$(findSubheadTag());var head2s=$$("h2");for(i=0;iPart (I|V|X)/)) {theHead.style.marginTop="5px";} if(currentHead.innerHTML.match(/>Part (I|V|X)/)) {theHead.style.marginBottom="1px";} var discloseControl=$("disclose"+i);if(discloseControl!=null) {discloseControl.innerHTML=discloseControl.innerHTML.replace(sidearrow_regexp,downarrow);}} return false;});var collapse=(function() {var subheads=$$(findSubheadTag());var head2s=$$("h2");for(i=0;iPart (I|V|X)/)) {theHead.style.marginTop="5px";} theHead.style.marginBottom="1px";theHead.style.marginLeft="0px";theHead.style.paddingLeft="0px";var discloseControl=$("disclose"+i);if(discloseControl!=null) {discloseControl.innerHTML=discloseControl.innerHTML.replace(downarrow_regexp,sidearrow);discloseControl.style.padding="0px 6px";if(discloseControl.addEventListener==null) {discloseControl.onclick=flipOne;}}} return false;});analyze();collapse();var toolbar=document.createElement('div');var toolbarContent=document.createTextNode('');var fontsize="120%";var button_style='/* position: relative; top: 4px; */';var expand_all='Expand All';var collapse_all='Collapse All';toolbar.appendChild(toolbarContent);toolbar.innerHTML=''+expand_all+' | '+collapse_all+' (Or click any '+sidearrow+' icon to expand that chapter.) Sign in or register for a free Oracle Web account, to enable personalized documentation features';firstHead1.parentNode.insertBefore(toolbar,firstHead1.nextSibling);var expandLink=$('expandlink');var collapseLink=$('collapselink');expandLink.onclick=expand;collapseLink.onclick=collapse;var always_link=$("collapse_preference_expanded");var always_expand;var always_collapse;var bumpDown=(function(id) {var theItem=$(id);if(theItem) {try {theItem.style.position="inherit";theItem.style.position="relative";theItem.style.top="4px";} catch(err){}}});bumpDown("expand_all_button");bumpDown("collapse_all_button");bumpDown("expand_collapse_icon");always_expand=(function() {expand();var me=$("collapse_preference_expanded");if(me) {me.innerHTML="Always collapse all";me.id="collapse_preference_collapsed";if(me.href) {me.href=me.href.replace(/_collapsed/,"_expanded");} me.onclick=always_collapse;} else {} return true;});always_collapse=(function() {collapse();var me=$("collapse_preference_collapsed");if(me) {me.innerHTML="Always expand all";me.id="collapse_preference_expanded";if(me.href) {me.href=me.href.replace(/_expanded/,"_collapsed");} me.onclick=always_expand;} else {} return true;});if(always_link) {always_link.onclick=always_expand;} else {always_link=$("collapse_preference_collapsed");if(always_link) {always_link.onclick=always_collapse;}}}); function showPlatform(what) {var platform_name=new RegExp(what,"i");var head1s=document.getElementsByTagName("h1");for(i=0;iMain Categories'+ '';} function shortcutLinks() {return'

Quick Lookup

'+ '';} function flipNavContainer() {return'
';} function bug() {return' ';} function searchForm() {return'
'+ '
'+ '
'+ ''+ ''+ ''+ ''+ ''+ ''+ ''+ '
'+ ' '+ ''+ '
'+ '
'+ '
'+ '
';} function historyPlaceholder() {return'
';} function keyboardControls() {return'';} function rssFeeds() {return'
'+ '

New and changed books:

'+ ' HTML documents '+ ' PDF files'+ '
';} function chapterDetails() {var output='

This Page

'+ '
';var divCounter=0;var allHead1s=$$("h1");if(allHead1s) {var theHead1=allHead1s[0];if(theHead1.id==null||theHead1.id.length==0) {theHead1.id="insertedID"+divCounter++;} else {} var innerText=theHead1.innerHTML.replace(/<.*?>/g,"");output+='';if(theHead1.className!=null&&theHead1.className=="glossary") {var allParas=$$("p");if(allParas) {for(i=0;i/g,"");output+='';}}}} else if((theHead1.className!=null&&theHead1.className=="toc")||theHead1.innerHTML=="Contents") {} else {var allHead2s=$$("h2");for(i=0;i/g,"");innerText=innerText.replace(/ /g,"");output+='';}}} output+='
';return output;} var bookTitle=(function() {var allmeta=$$("meta");for(i=0;iThis Book'+ ''+ '';}} return'';});rememberLayout();var head1s=$$("div");if(head1s) {var firstHead1=head1s[0];var myAddress=window.location.href;var partno=myAddress.replace(/.*\/([a-z][0-9]{5})\/.*/,"$1");var navDiv=document.createElement('div');var navContent=document.createTextNode('');navDiv.appendChild(navContent);navDiv.innerHTML=flipNavContainer()+ bug()+ searchForm()+ shortcutLinks()+ '
'+ categories()+ chapterDetails()+ '
'+ bookTitle()+ historyPlaceholder()+ keyboardControls()+ rssFeeds();firstHead1.parentNode.insertBefore(navDiv,firstHead1.nextSibling);navDiv.id="nav";style_navbar(navDiv.style);} var toolbar=$('flipNav_container');if(toolbar!=null) {toolbar.innerHTML='Show Navigation
';} else {alert("flipNav_container does not exist");} var navToggle=$("flipNav");if(navToggle) {navToggle.onclick=showNav;} else {alert("Can't find flipNav element");} var navToggleInline=$("flipNavInline");if(navToggleInline) {navToggleInline.onclick=showNav;} else {alert("Can't find flipNavInline element");}});var head1s=$$("h1");var firstHead1=head1s[0];var toolbar=document.createElement('div');var toolbarContent=document.createTextNode('');toolbar.appendChild(toolbarContent);toolbar.innerHTML='Show Navigation
';firstHead1.parentNode.insertBefore(toolbar,firstHead1);makeNav();var should_hide_nav=get_prefs(1);if(should_hide_nav!="1") {showNav();} else {document.navState="hidden";}}); addOnload(function() {var addCommentForm=(function() {var myAddress=window.location.href;var myPath=myAddress.replace(/.*\/([a-z]+\.[0-9]+\/[a-z][0-9]{5}\/.*.htm).*/,"$1");var comment_form=''+ '
'+ '

User Comments

'+ '
'+ ''+ ' '+ ''+ '
'+ ' '+ ' '+ '
'+ ''+ ''+ '
'+ '

'+ 'By submitting a comment, you confirm that you have read and agreed to '+ 'the terms and conditions.'+ '

'+ '

'+ 'This feedback form is for documentation corrections and suggestions. '+ 'Because of the volume of suggestions, we cannot reply to every comment. '+ 'In particular:'+ '

'+ ''+ ''+ '(Comments are moderated and will not appear immediately.)'+ '
'+ '
'+ '
';var allDivs=$$("div");for(i=allDivs.length-1;i>=0;i--) {if(allDivs[i].className=="footer") {var footer=allDivs[i];footer.id="comment_block";footer.innerHTML=comment_form+footer.innerHTML;}}});var comment_counter=0;var addComment=(function(theComment) {var allDivs=$$("div");for(i=allDivs.length-1;i>=0;i--) {if(allDivs[i].className=="footer") {var footer=allDivs[i];footer.innerHTML='
From: '+theComment.name+'
'+'
Title: '+theComment.title+'
'+'
Date: '+theComment.submitted+'
'+'
'+theComment.text+'
'+'
'+footer.innerHTML;}}});var converterLevel=(function() {var allmeta=$$("meta");var theLevel;for(i=0;i";} else if(msgBackup!=null) {msgBackup.innerHTML+=what+"
";}});var this_page=$("nav_this_page");if(this_page) {this_page.innerHTML+=' [0 comments, Leave a comment]

';} var comment=new Object(); var showTerms=(function() {var newwindow=window.open('http://www.oracle.com/pls/db111/comment_disclaimer','TermsWindow','scrollbars=yes,width=500,height=400,screenx=50,screeny=50,location=no,toolbar=no,directories=no');return false;});addCommentForm();var terms_link=$("comment_ts_and_cs");if(terms_link) {terms_link.onclick=showTerms;}}); addOnload(function() { make_me_as_wide_as("search_this_book","comment_announcement"); }); addOnload(function() {var myAddress=window.location.href;var anchor;var tab;if(myAddress.match(/#/)) {anchor=myAddress.replace(/.*#(.*)/,"$1");} if(myAddress.match(/\bselected=[0-9]+\b/)) {tab=myAddress.replace(/.*\bselected=([0-9]+)\b.*/,"$1") } if(tab==99) {return;} var anchors=$$("a");var theAnchor;var progress="";var portal_id=new RegExp("\\bselected="+tab+"\\b");var anchor_id=new RegExp("#"+anchor+"$");for(i=0;i