|
|
<html xmlns:v="urn:schemas-microsoft-com:vml"xmlns:o="urn:schemas-microsoft-com:office:office"xmlns:w="urn:schemas-microsoft-com:office:word"xmlns="http://www.w3.org/TR/REC-html40">
<head><meta http-equiv=Content-Type content="text/html; charset=us-ascii"><meta name=ProgId content=Word.Document><meta name=Generator content="Microsoft Word 9"><meta name=Originator content="Microsoft Word 9"><link rel=File-List href="./using%20urt%20config_files/filelist.xml"><link rel=Edit-Time-Data href="./using%20urt%20config_files/editdata.mso"><!--[if !mso]>
<style>v\:* {behavior:url(#default#VML);}o\:* {behavior:url(#default#VML);}w\:* {behavior:url(#default#VML);}.shape {behavior:url(#default#VML);}</style><![endif]--><title>Using the URT Configuration System</title><!--[if gte mso 9]><xml>
<o:DocumentProperties> <o:Author>Markus Horstmann</o:Author> <o:LastAuthor>Markus Horstmann</o:LastAuthor> <o:Revision>24</o:Revision> <o:TotalTime>148</o:TotalTime> <o:Created>1999-10-14T00:43:00Z</o:Created> <o:LastSaved>1999-12-07T20:18:00Z</o:LastSaved> <o:Pages>11</o:Pages> <o:Words>3011</o:Words> <o:Characters>17163</o:Characters> <o:Company>Microsoft Internal</o:Company> <o:Lines>143</o:Lines> <o:Paragraphs>34</o:Paragraphs> <o:CharactersWithSpaces>21077</o:CharactersWithSpaces> <o:Version>9.2720</o:Version> </o:DocumentProperties></xml><![endif]--><!--[if gte mso 9]><xml>
<w:WordDocument> <w:View>Normal</w:View> <w:Zoom>BestFit</w:Zoom> </w:WordDocument></xml><![endif]--><style><!--
/* Font Definitions */@font-face {font-family:Wingdings; panose-1:5 0 0 0 0 0 0 0 0 0; mso-font-charset:2; mso-generic-font-family:auto; mso-font-pitch:variable; mso-font-signature:0 268435456 0 0 -2147483648 0;}@font-face {font-family:Verdana; panose-1:2 11 6 4 3 5 4 4 2 4; mso-font-charset:0; mso-generic-font-family:swiss; mso-font-pitch:variable; mso-font-signature:536871559 0 0 0 415 0;} /* Style Definitions */p.MsoNormal, li.MsoNormal, div.MsoNormal {mso-style-parent:""; margin:0in; margin-bottom:.0001pt; mso-pagination:widow-orphan; font-size:12.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";}h1 {margin-right:0in; mso-margin-top-alt:auto; mso-margin-bottom-alt:auto; margin-left:0in; mso-pagination:widow-orphan; mso-outline-level:1; font-size:24.0pt; font-family:"Times New Roman"; mso-font-kerning:18.0pt; font-weight:bold;}h2 {margin-right:0in; mso-margin-top-alt:auto; mso-margin-bottom-alt:auto; margin-left:0in; mso-pagination:widow-orphan; mso-outline-level:2; font-size:18.0pt; font-family:"Times New Roman"; font-weight:bold;}h3 {margin-right:0in; mso-margin-top-alt:auto; mso-margin-bottom-alt:auto; margin-left:0in; mso-pagination:widow-orphan; mso-outline-level:3; font-size:13.5pt; font-family:"Times New Roman"; font-weight:bold;}p.MsoToc1, li.MsoToc1, div.MsoToc1 {mso-style-update:auto; mso-style-next:Normal; margin:0in; margin-bottom:.0001pt; mso-pagination:widow-orphan; font-size:12.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";}p.MsoToc2, li.MsoToc2, div.MsoToc2 {mso-style-update:auto; mso-style-next:Normal; margin-top:0in; margin-right:0in; margin-bottom:0in; margin-left:12.0pt; margin-bottom:.0001pt; mso-pagination:widow-orphan; font-size:12.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";}p.MsoToc3, li.MsoToc3, div.MsoToc3 {mso-style-update:auto; mso-style-next:Normal; margin-top:0in; margin-right:0in; margin-bottom:0in; margin-left:24.0pt; margin-bottom:.0001pt; mso-pagination:widow-orphan; font-size:12.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";}p.MsoToc4, li.MsoToc4, div.MsoToc4 {mso-style-update:auto; mso-style-next:Normal; margin-top:0in; margin-right:0in; margin-bottom:0in; margin-left:.5in; margin-bottom:.0001pt; mso-pagination:widow-orphan; font-size:12.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";}p.MsoToc5, li.MsoToc5, div.MsoToc5 {mso-style-update:auto; mso-style-next:Normal; margin-top:0in; margin-right:0in; margin-bottom:0in; margin-left:48.0pt; margin-bottom:.0001pt; mso-pagination:widow-orphan; font-size:12.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";}p.MsoToc6, li.MsoToc6, div.MsoToc6 {mso-style-update:auto; mso-style-next:Normal; margin-top:0in; margin-right:0in; margin-bottom:0in; margin-left:60.0pt; margin-bottom:.0001pt; mso-pagination:widow-orphan; font-size:12.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";}p.MsoToc7, li.MsoToc7, div.MsoToc7 {mso-style-update:auto; mso-style-next:Normal; margin-top:0in; margin-right:0in; margin-bottom:0in; margin-left:1.0in; margin-bottom:.0001pt; mso-pagination:widow-orphan; font-size:12.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";}p.MsoToc8, li.MsoToc8, div.MsoToc8 {mso-style-update:auto; mso-style-next:Normal; margin-top:0in; margin-right:0in; margin-bottom:0in; margin-left:84.0pt; margin-bottom:.0001pt; mso-pagination:widow-orphan; font-size:12.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";}p.MsoToc9, li.MsoToc9, div.MsoToc9 {mso-style-update:auto; mso-style-next:Normal; margin-top:0in; margin-right:0in; margin-bottom:0in; margin-left:96.0pt; margin-bottom:.0001pt; mso-pagination:widow-orphan; font-size:12.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";}p.MsoFootnoteText, li.MsoFootnoteText, div.MsoFootnoteText {margin:0in; margin-bottom:.0001pt; mso-pagination:widow-orphan; font-size:10.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";}span.MsoFootnoteReference {vertical-align:super;}p.MsoBodyText, li.MsoBodyText, div.MsoBodyText {margin:0in; margin-bottom:.0001pt; mso-pagination:widow-orphan; font-size:12.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";}p.MsoBodyTextIndent, li.MsoBodyTextIndent, div.MsoBodyTextIndent {margin:0in; margin-bottom:.0001pt; text-indent:.5in; mso-pagination:widow-orphan; font-size:12.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman"; color:red; font-weight:bold;}p.MsoBodyText2, li.MsoBodyText2, div.MsoBodyText2 {margin:0in; margin-bottom:.0001pt; mso-pagination:widow-orphan; font-size:12.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman"; color:red; font-weight:bold;}p.MsoBodyTextIndent2, li.MsoBodyTextIndent2, div.MsoBodyTextIndent2 {margin:0in; margin-bottom:.0001pt; text-indent:.5in; mso-pagination:widow-orphan; font-size:12.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman"; color:red; font-weight:bold;}p.MsoBlockText, li.MsoBlockText, div.MsoBlockText {margin-right:.5in; mso-margin-top-alt:auto; mso-margin-bottom-alt:auto; margin-left:.5in; mso-pagination:widow-orphan; font-size:12.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";}a:link, span.MsoHyperlink {color:blue; text-decoration:underline; text-underline:single;}a:visited, span.MsoHyperlinkFollowed {color:maroon; text-decoration:underline; text-underline:single;}p {margin-right:0in; mso-margin-top-alt:auto; mso-margin-bottom-alt:auto; margin-left:0in; mso-pagination:widow-orphan; font-size:12.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";}tt {mso-ascii-font-family:"Courier New"; mso-fareast-font-family:"Courier New"; mso-hansi-font-family:"Courier New"; mso-bidi-font-family:"Courier New";}@page Section1 {size:8.5in 11.0in; margin:1.0in 1.25in 1.0in 1.25in; mso-header-margin:.5in; mso-footer-margin:.5in; mso-paper-source:0;}div.Section1 {page:Section1;} /* List Definitions */@list l0 {mso-list-id:-2; mso-list-type:simple; mso-list-template-ids:761423964;}@list l0:level1 {mso-level-start-at:0; mso-level-text:*; mso-level-tab-stop:none; mso-level-number-position:left; margin-left:0in; text-indent:0in;}@list l1 {mso-list-id:575893656; mso-list-type:hybrid; mso-list-template-ids:-1800122242 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}@list l1:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; font-family:Symbol;}@list l2 {mso-list-id:678964059; mso-list-type:hybrid; mso-list-template-ids:453913416 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}@list l3 {mso-list-id:766121386; mso-list-type:hybrid; mso-list-template-ids:-1299278360 -1942432512 -395118558 -1081728496 377515852 739288804 641093926 -1532712600 -1832496466 1877909766;}@list l4 {mso-list-id:807557148; mso-list-type:hybrid; mso-list-template-ids:176478654 -696213490 -1597622048 832891508 -48056522 797738254 -515843724 -217183430 380829274 1539872580;}@list l4:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;}@list l5 {mso-list-id:855659197; mso-list-type:hybrid; mso-list-template-ids:-367899078 2116566740 -1163910998 -2071161390 422087384 117109154 -1993991954 -1087600168 -1347773808 534788264;}@list l5:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;}@list l6 {mso-list-id:1284774935; mso-list-type:hybrid; mso-list-template-ids:-901499130 761423964 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}@list l6:level1 {mso-level-start-at:0; mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:none; mso-level-number-position:left; mso-level-legacy:yes; mso-level-legacy-indent:0in; mso-level-legacy-space:0in; margin-left:0in; text-indent:0in; font-family:Symbol;}@list l7 {mso-list-id:1510172926; mso-list-type:hybrid; mso-list-template-ids:988300944 1679612518 373985284 1399643390 -2110639446 -54371850 -976974442 529461230 133994354 1720716384;}@list l7:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;}@list l8 {mso-list-id:1829176701; mso-list-type:hybrid; mso-list-template-ids:-1784788726 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}@list l9 {mso-list-id:1833376249; mso-list-type:hybrid; mso-list-template-ids:1396476904 -1118663700 1126598294 -1813075500 -1353794174 -1308452448 69389066 -1106875208 682947314 -982748962;}@list l9:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;}@list l10 {mso-list-id:1867207660; mso-list-type:hybrid; mso-list-template-ids:-1278074742 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}@list l10:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; font-family:Symbol;}@list l11 {mso-list-id:2086225176; mso-list-type:hybrid; mso-list-template-ids:-483758760 773366188 -713261512 -1861328652 -592530718 -117523022 -207717946 179875860 1749948876 214173590;}@list l11:level1 {mso-level-number-format:bullet; mso-level-text:\F0B7; mso-level-tab-stop:.5in; mso-level-number-position:left; text-indent:-.25in; mso-ansi-font-size:10.0pt; font-family:Symbol;}@list l0:level1 lfo8 {mso-level-number-format:bullet; mso-level-numbering:continue; mso-level-text:\F0B7; mso-level-tab-stop:none; mso-level-number-position:left; mso-level-legacy:yes; mso-level-legacy-indent:0in; mso-level-legacy-space:0in; margin-left:0in; text-indent:0in; font-family:Symbol;}ol {margin-bottom:0in;}ul {margin-bottom:0in;}--></style></head>
<body lang=EN-US link=blue vlink=maroon style='tab-interval:.5in'>
<div class=Section1>
<h1><a name="_Toc467340649"></a><a name=top></a><span style='mso-bookmark:_Toc467340649'>Usingthe URT Configuration System</span></h1>
<p class=MsoNormal><em><b>Getting Started Guide</b></em><i><br><em>Application Server/Universal Runtime</em><br><em><span style='color:red'>Microsoft Confidential</span> </em></i></p>
<table border=0 cellspacing=0 cellpadding=0 width="100%" style='width:100.0%; mso-cellspacing:0in;mso-padding-alt:0in 0in 0in 0in'> <tr> <td style='padding:0in 0in 0in 0in'> <p class=MsoNormal>Author</p> </td> <td style='padding:0in 0in 0in 0in'> <p class=MsoNormal><a href="mailto:vanvan">Van Van</a></p> </td> </tr> <tr> <td style='padding:0in 0in 0in 0in'> <p class=MsoNormal>Area</p> </td> <td style='padding:0in 0in 0in 0in'> <p class=MsoNormal>Configuration System</p> </td> </tr> <tr> <td style='padding:0in 0in 0in 0in'> <p class=MsoNormal>SubArea</p> </td> <td style='padding:0in 0in 0in 0in'> <p class=MsoNormal>Getting Started Guide</p> </td> </tr> <tr> <td style='padding:0in 0in 0in 0in'> <p class=MsoNormal>Program Management</p> </td> <td style='padding:0in 0in 0in 0in'> <p class=MsoNormal><a href="mailto:markush">Markus Horstmann</a></p> </td> </tr> <tr> <td style='padding:0in 0in 0in 0in'> <p class=MsoNormal>Development</p> </td> <td style='padding:0in 0in 0in 0in'> <p class=MsoNormal><a href="mailto:rcraig">Robert Craig</a></p> </td> </tr> <tr> <td style='padding:0in 0in 0in 0in'> <p class=MsoNormal>Test</p> </td> <td style='padding:0in 0in 0in 0in'> <p class=MsoNormal><a href="mailto:mikefan">Michael Fanning</a></p> </td> </tr> <tr> <td style='padding:0in 0in 0in 0in'> <p class=MsoNormal>Reviewers</p> </td> <td style='padding:0in 0in 0in 0in'> <p class=MsoNormal><a href="mailto:rcraig">Robert Craig</a> </p> </td> </tr> <tr> <td style='padding:0in 0in 0in 0in'> <p class=MsoNormal>Current Version</p> </td> <td style='padding:0in 0in 0in 0in'> <p class=MsoNormal>0.9</p> </td> </tr> <tr> <td style='padding:0in 0in 0in 0in'> <p class=MsoNormal>Version History</p> </td> <td style='padding:0in 0in 0in 0in'> <p class=MsoNormal>0.9: 12/07/99 : Updated installation instruction for managed config.</p> <p class=MsoNormal>0.8: 11/15/99 : Added instruction to <a href="#_Installing_the_managed">install drops of managed configuration system</a>.</p> <p class=MsoNormal>0.7: 11/09/99 : Added reg keys required by system event logging</p> <p class=MsoNormal>0.6: 10/18/99 : Changed setup contact to URTSetup. Clarified internal vs. external files. Cosmetic edits - MarkusH</p> <p class=MsoNormal>0.5: 10/15/99 : Added check-in procedure - MarkusH</p> <p class=MsoNormal>0.4: 10/13/99 : Added examples on how to extend collections - MarkusH</p> <p class=MsoNormal>0.3 : 10/5/99 : Updated BVT instruction - MarkusH<br> 0.2 : 9/13/99 : incorporated RCraig's comments - VanVan<br> 0.1 : 8/23/99 : file created - VanVan</p> </td> </tr> <tr> <td style='padding:0in 0in 0in 0in'> <p class=MsoNormal>Status</p> </td> <td style='padding:0in 0in 0in 0in'> <p class=MsoNormal><b>Initial Draft</b></p> </td> </tr></table>
<div class=MsoNormal align=center style='text-align:center'>
<hr size=2 width="100%" align=center>
</div>
<p class=MsoToc1 style='tab-stops:right dotted 431.5pt'><!--[if supportFields]><span
style='mso-element:field-begin'></span><span style="mso-spacerun:yes"> </span>TOC \o "1-3" \h \z <span style='mso-element:field-separator'></span><![endif]--><spanclass=MsoHyperlink><a href="#_Toc467340649">Using the URT Configuration System<spanstyle='color:windowtext;display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'>.. </span><spanstyle='mso-field-code:"PAGEREF _Toc467340649 \\h"'>1<!--[if gte mso 9]><xml>
<w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003400360037003300340030003600340039000000</w:data></xml><![endif]--></span></span></a></span></p>
<p class=MsoToc2 style='tab-stops:right dotted 431.5pt'><spanclass=MsoHyperlink><a href="#_Toc467340650">Overview<span style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;text-underline:none'><spanstyle='mso-tab-count:1 dotted'>.. </span><span style='mso-field-code:"PAGEREF _Toc467340650 \\h"'>2<!--[if gte mso 9]><xml>
<w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003400360037003300340030003600350030000000</w:data></xml><![endif]--></span></span></a></span></p>
<p class=MsoToc2 style='tab-stops:right dotted 431.5pt'><spanclass=MsoHyperlink><a href="#_Toc467340651">Manual Setup<span style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'>. </span><span style='mso-field-code:"PAGEREF _Toc467340651 \\h"'>2<!--[if gte mso 9]><xml>
<w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003400360037003300340030003600350031000000</w:data></xml><![endif]--></span></span></a></span></p>
<p class=MsoToc2 style='tab-stops:right dotted 431.5pt'><spanclass=MsoHyperlink><a href="#_Toc467340652">Testing the Install<spanstyle='color:windowtext;display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'> </span><spanstyle='mso-field-code:"PAGEREF _Toc467340652 \\h"'>3<!--[if gte mso 9]><xml>
<w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003400360037003300340030003600350032000000</w:data></xml><![endif]--></span></span></a></span></p>
<p class=MsoToc2 style='tab-stops:right dotted 431.5pt'><spanclass=MsoHyperlink><a href="#_Toc467340653">Installing the managedconfiguration system<span style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'>.. </span><spanstyle='mso-field-code:"PAGEREF _Toc467340653 \\h"'>3<!--[if gte mso 9]><xml>
<w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003400360037003300340030003600350033000000</w:data></xml><![endif]--></span></span></a></span></p>
<p class=MsoToc2 style='tab-stops:right dotted 431.5pt'><spanclass=MsoHyperlink><a href="#_Toc467340654">Reading Configuration Data<spanstyle='color:windowtext;display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'>. </span><spanstyle='mso-field-code:"PAGEREF _Toc467340654 \\h"'>4<!--[if gte mso 9]><xml>
<w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003400360037003300340030003600350034000000</w:data></xml><![endif]--></span></span></a></span></p>
<p class=MsoToc2 style='tab-stops:right dotted 431.5pt'><spanclass=MsoHyperlink><a href="#_Toc467340655">Extending the Schema<spanstyle='color:windowtext;display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'>. </span><spanstyle='mso-field-code:"PAGEREF _Toc467340655 \\h"'>4<!--[if gte mso 9]><xml>
<w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003400360037003300340030003600350035000000</w:data></xml><![endif]--></span></span></a></span></p>
<p class=MsoToc3 style='tab-stops:right dotted 431.5pt'><spanclass=MsoHyperlink><a href="#_Toc467340656">Example 1: Adding a column to theFusion “BindingPolicy” table<span style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;text-underline:none'><spanstyle='mso-tab-count:1 dotted'>. </span><span style='mso-field-code:"PAGEREF _Toc467340656 \\h"'>5<!--[if gte mso 9]><xml>
<w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003400360037003300340030003600350036000000</w:data></xml><![endif]--></span></span></a></span></p>
<p class=MsoToc3 style='tab-stops:right dotted 431.5pt'><spanclass=MsoHyperlink><a href="#_Toc467340657">Example 2: Adding a column to theDucttape “Application” table<span style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;text-underline:none'><spanstyle='mso-tab-count:1 dotted'>. </span><span style='mso-field-code:"PAGEREF _Toc467340657 \\h"'>6<!--[if gte mso 9]><xml>
<w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003400360037003300340030003600350037000000</w:data></xml><![endif]--></span></span></a></span></p>
<p class=MsoToc3 style='tab-stops:right dotted 431.5pt'><spanclass=MsoHyperlink><a href="#_Toc467340658">Example 3: Adding a new collection<spanstyle='color:windowtext;display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'>. </span><spanstyle='mso-field-code:"PAGEREF _Toc467340658 \\h"'>7<!--[if gte mso 9]><xml>
<w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003400360037003300340030003600350038000000</w:data></xml><![endif]--></span></span></a></span></p>
<p class=MsoToc3 style='tab-stops:right dotted 431.5pt'><spanclass=MsoHyperlink><a href="#_Toc467340659">Making the schema part of theshipping product<span style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'> </span><spanstyle='mso-field-code:"PAGEREF _Toc467340659 \\h"'>7<!--[if gte mso 9]><xml>
<w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003400360037003300340030003600350039000000</w:data></xml><![endif]--></span></span></a></span></p>
<p class=MsoToc2 style='tab-stops:right dotted 431.5pt'><spanclass=MsoHyperlink><a href="#_Toc467340660">Writing Plugins<spanstyle='color:windowtext;display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'>. </span><spanstyle='mso-field-code:"PAGEREF _Toc467340660 \\h"'>8<!--[if gte mso 9]><xml>
<w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003400360037003300340030003600360030000000</w:data></xml><![endif]--></span></span></a></span></p>
<p class=MsoToc2 style='tab-stops:right dotted 431.5pt'><spanclass=MsoHyperlink><a href="#_Toc467340661">Running BVTs<span style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'>. </span><span style='mso-field-code:"PAGEREF _Toc467340661 \\h"'>8<!--[if gte mso 9]><xml>
<w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003400360037003300340030003600360031000000</w:data></xml><![endif]--></span></span></a></span></p>
<p class=MsoToc2 style='tab-stops:right dotted 431.5pt'><spanclass=MsoHyperlink><a href="#_Toc467340662">Check-in procedure<spanstyle='color:windowtext;display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'>. </span><spanstyle='mso-field-code:"PAGEREF _Toc467340662 \\h"'>8<!--[if gte mso 9]><xml>
<w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003400360037003300340030003600360032000000</w:data></xml><![endif]--></span></span></a></span></p>
<p class=MsoToc2 style='tab-stops:right dotted 431.5pt'><spanclass=MsoHyperlink><a href="#_Toc467340663">File list for Setup<spanstyle='color:windowtext;display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'>. </span><spanstyle='mso-field-code:"PAGEREF _Toc467340663 \\h"'>9<!--[if gte mso 9]><xml>
<w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003400360037003300340030003600360033000000</w:data></xml><![endif]--></span></span></a></span></p>
<p class=MsoToc3 style='tab-stops:right dotted 431.5pt'><spanclass=MsoHyperlink><a href="#_Toc467340664">Files<span style='color:windowtext;display:none;mso-hide:screen;text-decoration:none;text-underline:none'><spanstyle='mso-tab-count:1 dotted'>. </span><span style='mso-field-code:"PAGEREF _Toc467340664 \\h"'>9<!--[if gte mso 9]><xml>
<w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003400360037003300340030003600360034000000</w:data></xml><![endif]--></span></span></a></span></p>
<p class=MsoToc3 style='tab-stops:right dotted 431.5pt'><spanclass=MsoHyperlink><a href="#_Toc467340665">Registry Keys<spanstyle='color:windowtext;display:none;mso-hide:screen;text-decoration:none;text-underline:none'><span style='mso-tab-count:1 dotted'>. </span><spanstyle='mso-field-code:"PAGEREF _Toc467340665 \\h"'>10<!--[if gte mso 9]><xml>
<w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003400360037003300340030003600360035000000</w:data></xml><![endif]--></span></span></a></span></p>
<p class=MsoNormal><!--[if supportFields]><span style='mso-element:field-end'></span><![endif]--><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
<div class=MsoNormal align=center style='text-align:center'>
<hr size=2 width="100%" align=center>
</div>
<h2><a name="_Toc467340650"></a><a name=Overview></a><a name="_Overview"></a><spanstyle='mso-bookmark:_Toc467340650'><span style='mso-bookmark:Overview'>Overview</span></span></h2>
<p class=MsoNormal>As more and more groups begin using the URT ConfigurationSystem (URTConfig for short), there needs to be a definitive guide which takessomeone who has little to no knowledge about the URTConfig from installing itto actually using it. This document does NOT touch on the in depth technicalaspects of the URTConfig. You will need to read the technical specification forthat. Instead, this document solely focuses on the user perspective of actuallyusing the URTConfig either in their code or testing. </p>
<div class=MsoNormal align=center style='text-align:center'>
<hr size=2 width="100%" align=center>
</div>
<h2><a name="_Toc467340651"></a><a name=Setup></a><a name="_Setup"></a><spanstyle='mso-bookmark:_Toc467340651'><span style='mso-bookmark:Setup'>ManualSetup</span></span></h2>
<p class=MsoNormal>Currently, we do not have a setup program which doeseverything for the user. This may or may not appear depending on our deliveryvehicle. In the meantime, you can follow these simple steps to setup the URTConfig system either for testing or coding against. </p>
<ol start=1 type=1> <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l3 level1 lfo3;tab-stops:list .5in'>Go to the drop location: <tt><span style='font-size:10.0pt;font-family:"Courier New"'><a href="file:\\urtdist\builds">\\urtdist\builds</a></span></tt> and pick up the latest build of the Config. The full path is </li></ol>
<p class=MsoNormal style='margin-right:.5in;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;margin-left:1.0in'><tt><b><span style='font-size:10.0pt;font-family:"Courier New"'>\\urtdist\builds\{</span></b></tt><em><b><spanstyle='font-size:10.0pt;font-family:"Courier New";mso-fareast-font-family:"Courier New"'>buildnum</span></b></em><tt><b><spanstyle='font-size:10.0pt;font-family:"Courier New"'>}\{</span></b></tt><em><b><spanstyle='font-size:10.0pt;font-family:"Courier New";mso-fareast-font-family:"Courier New"'>platform</span></b></em><tt><b><spanstyle='font-size:10.0pt;font-family:"Courier New"'>}{</span></b></tt><em><b><spanstyle='font-size:10.0pt;font-family:"Courier New";mso-fareast-font-family:"Courier New"'>buildtype</span></b></em><tt><b><spanstyle='font-size:10.0pt;font-family:"Courier New"'>}\Config </span></b></tt></p>
<p style='margin-left:.5in'>For example,</p>
<p class=MsoNormal style='margin-right:.5in;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;margin-left:1.0in'><tt><b><span style='font-size:10.0pt;font-family:"Courier New"'>\\urtdist\builds\0823\x86fre\Config</span></b></tt></p>
<p style='margin-left:.5in'>Copy everything at this location into a directoryof your choice that is <b>NOT</b> on your path. For example, do not copy itinto your <tt><span style='font-size:10.0pt;font-family:"Courier New"'>%windir%\system32</span></tt>directory. Instead, create a directory (or use an existing one) like <tt><spanstyle='font-size:10.0pt;font-family:"Courier New"'>C:\Config</span></tt>. </p>
<p style='margin-left:.5in'>NOTE: If you plan on running our current <ahref="#BVTs">BVTs</a> on this install, you will need to install in the <tt><spanstyle='font-size:10.0pt;font-family:"Courier New"'>%windir%\XSPDT</span></tt>directory. This will change in the future, but for now, it is hard coded in ourBVT TEST ONLY. </p>
<p style='margin-left:.5in;text-indent:-.25in;mso-list:l3 level1 lfo3;tab-stops:list .5in'><![if !supportLists]>2.<span style='font:7.0pt "Times New Roman"'> </span><![endif]>Go to the test drop location: <tt><span style='font-size:10.0pt;font-family:"Courier New"'><a href="file:\\urtdist\testdrop">\\urtdist\testdrop</a></span></tt>and pick up the latest build of the test tools that you will also need. Thefull path is </p>
<p class=MsoNormal style='margin-right:.5in;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;margin-left:1.0in'><tt><b><span style='font-size:10.0pt;font-family:"Courier New"'>\\urtdist\testdrop\{</span></b></tt><em><b><spanstyle='font-size:10.0pt;font-family:"Courier New";mso-fareast-font-family:"Courier New"'>buildnum</span></b></em><tt><b><spanstyle='font-size:10.0pt;font-family:"Courier New"'>}\{</span></b></tt><em><b><spanstyle='font-size:10.0pt;font-family:"Courier New";mso-fareast-font-family:"Courier New"'>platform</span></b></em><tt><b><spanstyle='font-size:10.0pt;font-family:"Courier New"'>}{</span></b></tt><em><b><spanstyle='font-size:10.0pt;font-family:"Courier New";mso-fareast-font-family:"Courier New"'>buildtype</span></b></em><tt><b><spanstyle='font-size:10.0pt;font-family:"Courier New"'>}\Config </span></b></tt></p>
<p style='margin-left:.5in'>For example,</p>
<p class=MsoNormal style='margin-right:.5in;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;margin-left:1.0in'><tt><b><span style='font-size:10.0pt;font-family:"Courier New"'>\\urtdist\testdrop\0823\x86fre\Config</span></b></tt></p>
<p style='margin-left:.5in'>Copy everything at this location into the exactsame directory as the one you used/created in the previous step. Although thesefiles are not necessary, they are really helpful in any debugging and testingscenarios. </p>
<p style='margin-left:.5in;text-indent:-.25in;mso-list:l3 level1 lfo3;tab-stops:list .5in'><![if !supportLists]>3.<span style='font:7.0pt "Times New Roman"'> </span><![endif]>Open up a command prompt and go into the directory you copiedall the files into (e.g. <tt><span style='font-size:10.0pt;font-family:"Courier New"'>C:\Config</span></tt>).Run the following command: </p>
<p class=MsoNormal style='margin-right:.5in;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;margin-left:1.0in'><b>catutil /product=urt /dll=C:\Config\Catalog.dll</b> </p>
<p style='margin-left:.5in'>A few things to note here. Although the productname can be anything, you will need to be consistent with the name. If youchoose something, you will need to specify the exact same name when calling theAPIs to retrieve config info. The value of /dll needs to be the full path toCatalog.dll (wherever you copied it). In this example, we are using <tt><spanstyle='font-size:10.0pt;font-family:"Courier New"'>C:\Config\Catalog.dll</span></tt>.</p>
<p style='margin-left:.5in'>NOTE: All this does is creates the registry keysdescribed <a href="#_Registry_Keys">below</a>.</p>
<p>Once you've done all this, the Config system is installed and ready to go. </p>
<div class=MsoNormal align=center style='text-align:center'>
<hr size=2 width="100%" align=center>
</div>
<h2><a name="_Toc467340652"></a><a name="Testing_the_Install"></a><aname="_Testing_the_Install"></a><span style='mso-bookmark:_Toc467340652'><spanstyle='mso-bookmark:Testing_the_Install'>Testing the Install</span></span></h2>
<p class=MsoNormal>To test and make sure you have everything installedcorrectly and running, you can do a few things (you don't need to do all of thefollowing, just one is fine): </p>
<ul type=disc> <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l9 level1 lfo6;tab-stops:list .5in'><b>Run the current <a href="#BVTs">BVT tests</a></b>. </li> <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l9 level1 lfo6;tab-stops:list .5in'><b>Use </b><tt><b><span style='font-size:10.0pt;font-family:"Courier New"'>STest</span></b></tt><b> to check your install.</b> Use the command prompt and navigate to the directory where you installed all the files. Run the following command: </li></ul>
<p class=MsoNormal style='margin-right:.5in;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;margin-left:1.0in'><tt><b><span style='font-size:10.0pt;font-family:"Courier New"'>stest/view /d:meta /t:tablemeta</span></b></tt> </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;margin-left:.5in'>You should see 30 some table entries. This is an indicationthat things are working. All this does is displays the table meta informationthat is in the Config system. </p>
<p class=MsoNormal>You can also use <tt><span style='font-size:10.0pt;font-family:"Courier New"'>stest</span></tt> to view any information known tothe configuration system. Please refer to <tt><span style='font-size:10.0pt;font-family:"Courier New"'>stest</span></tt> itself for the syntax andparameters. </p>
<div class=MsoNormal align=center style='text-align:center'>
<hr size=2 width="100%" align=center>
</div>
<h2><a name="_Toc467340653"></a><a name="Using_the_URT_Config"></a><aname="_Using_the_URT"></a><a name="_Reading_Configuration_Data"></a><aname="_Installing_the_managed"></a><span style='mso-bookmark:_Toc467340653'><spanstyle='mso-bookmark:Using_the_URT_Config'>Installing the managed configurationsystem</span></span><span style='mso-bookmark:Using_the_URT_Config'></span></h2>
<p class=MsoNormal><span style='mso-bookmark:Using_the_URT_Config'>To install(sorry no integrated setup yet):</span></p>
<p class=MsoNormal style='margin-left:19.0pt;text-indent:-19.0pt;mso-list:l0 level1 lfo8'><spanstyle='mso-bookmark:Using_the_URT_Config'><![if !supportLists]><spanstyle='font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><![endif]>Install the latest COM+ 2.0 build from </span><ahref="file://urtdist/builds"><span style='mso-bookmark:Using_the_URT_Config'><spanstyle='font-size:10.0pt;font-family:Verdana'>file:\\urtdist\builds</span></span><spanstyle='mso-bookmark:Using_the_URT_Config'></span></a><span style='mso-bookmark:Using_the_URT_Config'>. M10 builds have build # < 1206, i.e. </span><spanstyle='mso-bookmark:Using_the_URT_Config'></span><ahref="file://urtdist/builds/1204/x86FRE/Setup.exe"><span style='mso-bookmark:Using_the_URT_Config'><span style='font-size:10.0pt;font-family:Verdana'>file:\\urtdist\builds\1204\x86fre\setup.exe</span></span><spanstyle='mso-bookmark:Using_the_URT_Config'></span></a><span style='mso-bookmark:Using_the_URT_Config'>.</span></p>
<p class=MsoNormal style='margin-left:19.0pt;text-indent:-19.0pt;mso-list:l0 level1 lfo8'><spanstyle='mso-bookmark:Using_the_URT_Config'><![if !supportLists]><spanstyle='font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><![endif]>Copy the latest M11 config build from </span><ahref="file://urtdist/builds"><span style='mso-bookmark:Using_the_URT_Config'>\\urtdist\builds</span><spanstyle='mso-bookmark:Using_the_URT_Config'></span></a><span style='mso-bookmark:Using_the_URT_Config'> to your config directory, typically %windir%\xspdt. M11builds have build# >=1206, i.e. </span><ahref="file://urtdist/builds/1206.5/x86FRE/Config"><span style='mso-bookmark:Using_the_URT_Config'>\\urtdist\builds\1206.5\x86fre\config</span><spanstyle='mso-bookmark:Using_the_URT_Config'></span></a><span style='mso-bookmark:Using_the_URT_Config'>. </span></p>
<p class=MsoNormal style='margin-left:19.0pt;text-indent:-19.0pt;mso-list:l0 level1 lfo8'><spanstyle='mso-bookmark:Using_the_URT_Config'><![if !supportLists]><spanstyle='font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><![endif]>copy mngdIST.DLL to configuration.DLL (in your configdirectory).</span></p>
<p class=MsoNormal style='margin-left:19.0pt;text-indent:-19.0pt;mso-list:l0 level1 lfo8'><spanstyle='mso-bookmark:Using_the_URT_Config'><![if !supportLists]><spanstyle='font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><![endif]>Re-Register the configuration system:</span></p>
<p class=MsoToc4><span style='mso-bookmark:Using_the_URT_Config'>cd%windir%\xspdt</span></p>
<p class=MsoToc4><span style='mso-bookmark:Using_the_URT_Config'>catutil/product=URT /dll=%windir%\xspdt\catalog.dll</span></p>
<p class=MsoNormal style='margin-left:19.0pt;mso-layout-grid-align:none;text-autospace:none'><span style='mso-bookmark:Using_the_URT_Config'><spanstyle='font-size:10.0pt;font-family:Verdana;color:teal'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></span></p>
<p class=MsoNormal><span style='mso-bookmark:Using_the_URT_Config'>To try itout:</span></p>
<p class=MsoNormal style='margin-left:19.0pt;text-indent:-19.0pt;mso-list:l0 level1 lfo8'><spanstyle='mso-bookmark:Using_the_URT_Config'><![if !supportLists]><spanstyle='font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><![endif]>copy \\urtdist\TestDrop\<M11 build#>\x86FRE\Config\machine.cfgto your config directory.<b><span style='color:red'> Make sure to save yourmachine.cfg file if you modified and care about it!</span></b></span></p>
<p class=MsoNormal style='margin-left:19.0pt;text-indent:-19.0pt;mso-list:l0 level1 lfo8'><spanstyle='mso-bookmark:Using_the_URT_Config'><![if !supportLists]><spanstyle='font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><![endif]>In machine.cfg: Make sure the HomeDirectory for Site"312" (the site last in the file) points to the config directoryusing an actual path, e.g. c:\winnt\xspdt, NOT %systemroot%\xspdt. </span></p>
<p class=MsoNormal style='margin-left:19.0pt;text-indent:-19.0pt;mso-list:l0 level1 lfo8'><spanstyle='mso-bookmark:Using_the_URT_Config'><![if !supportLists]><spanstyle='font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><![endif]>Download test binaries fromhttp://appcenter/config/testfiles: mwiring.xml, config.cfg, testmerger.exe,system.handler.dll. (right-click "Save Target As...") to your configdirectory, e.g. %windir%\xspdt. Make sure config.cfg gets downloaded correctly(Select "All Files" to avoid the .xml file extension beingautomatically appended to config.cfg by IE).</span></p>
<p class=MsoNormal style='margin-left:19.0pt;text-indent:-19.0pt;mso-list:l0 level1 lfo8'><spanstyle='mso-bookmark:Using_the_URT_Config'><![if !supportLists]><spanstyle='font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><![endif]>Create sub directories foo and foo\bar under%windir%\xspdt</span></p>
<p class=MsoNormal style='margin-left:19.0pt;text-indent:-19.0pt;mso-list:l0 level1 lfo8'><spanstyle='mso-bookmark:Using_the_URT_Config'><![if !supportLists]><spanstyle='font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><![endif]>copy config.cfg and catalog.xms into both foo\ andfoo\bar.</span></p>
<p class=MsoNormal style='margin-left:19.0pt;text-indent:-19.0pt;mso-list:l0 level1 lfo8'><spanstyle='mso-bookmark:Using_the_URT_Config'><![if !supportLists]><spanstyle='font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><![endif]>Run "testmerger.exe URLPermissions" or"testmerger.exe UserDatabase" or "testmerger.exeScriptMaps2" (sources in $/catalog42/src/urt/handlers/testmerger.cool).</span></p>
<h2><span style='mso-bookmark:Using_the_URT_Config'><a name="_Toc467340654">ReadingConfig</a></span><span style='mso-bookmark:_Toc467340654'>uration Data</span></h2>
<p class=MsoNormal>Once everything is in working order and has passed yourtests, either BVT or otherwise, you can start using it within your code. Inorder to code to it, you will need to: </p>
<ul type=disc> <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l4 level1 lfo11;tab-stops:list .5in'>Include <tt><b><span style='font-size:10.0pt;font-family:"Courier New"'>catalog.h</span></b></tt> </li> <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l4 level1 lfo11;tab-stops:list .5in'>Include <tt><b><span style='font-size:10.0pt;font-family:"Courier New"'>catmeta.h</span></b></tt> </li> <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l4 level1 lfo11;tab-stops:list .5in'>Link with the static lib <tt><b><span style='font-size:10.0pt;font-family:"Courier New"'>cat.lib</span></b></tt> </li></ul>
<p class=MsoNormal>You can look at <a href="stest.cpp">stest.cpp</a> for somesample code. </p>
<p><span style='color:red'>TODO: We really need a small simple sample thatshows how to easily read/write config information here.</span> </p>
<div class=MsoNormal align=center style='text-align:center'>
<hr size=2 width="100%" align=center>
</div>
<h2><a name="_Toc467340655"></a><a name="Extending_the_Schema"></a><aname="_Extending_the_Schema"></a><span style='mso-bookmark:_Toc467340655'><spanstyle='mso-bookmark:Extending_the_Schema'>Extending the Schema</span></span></h2>
<p class=MsoNormal>Schema information is stored in <tt><span style='font-size:10.0pt;font-family:"Courier New"'>catmeta.xml</span></tt> (see <tt><spanstyle='font-size:10.0pt;font-family:"Courier New"'>catmeta.xms</span></tt> for respectiveschema). Wiring information is expressed in <tt><span style='font-size:10.0pt;font-family:"Courier New"'>catwire.xml</span></tt> (see <tt><spanstyle='font-size:10.0pt;font-family:"Courier New"'>catwire.xms</span></tt> forrespective schema). </p>
<p>If you wish to change the schema (add your own property) and/or wiringinformation, you should modify <tt><span style='font-size:10.0pt;font-family:"Courier New"'>catmeta.xml</span></tt> and/or <tt><span style='font-size:10.0pt;font-family:"Courier New"'>catwire.xml</span></tt> appropriately. When you aredone, run </p>
<p class=MsoNormal style='margin-right:.5in;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;margin-left:.5in'><b>catutil /validate <em>filename</em></b> </p>
<p class=MsoNormal>where <em><b>filename</b></em> is the .xml file you justmodified. This will validate and make sure you didn't make any mistakes whenyou modified the file. Once it's been validated, then run </p>
<p class=MsoNormal style='margin-right:.5in;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;margin-left:.5in'><b>catutil /compile /dll=C:\Config\Catalog.dll</b> </p>
<p class=MsoNormal>to "compile" your changes. No source codecompilation actually occurs. This command: </p>
<ul type=disc> <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l7 level1 lfo14;tab-stops:list .5in'>generates an XML schema: <tt><span style='font-size:10.0pt;font-family:"Courier New"'>catalog.xms</span></tt></li> <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l7 level1 lfo14;tab-stops:list .5in'>generates a C style header of constants: <tt><span style='font-size:10.0pt;font-family:"Courier New"'>catmeta.h</span></tt></li> <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l7 level1 lfo14;tab-stops:list .5in'>modifies <tt><span style='font-size:10.0pt;font-family:"Courier New"'>catalog.dll</span></tt> with the new schema information</li></ul>
<h3><a name="_Toc467340656">Example 1: Adding a column to the Fusion“BindingPolicy” table</a></h3>
<ol style='margin-top:0in' start=1 type=1> <li class=MsoNormal style='mso-list:l8 level1 lfo17;tab-stops:list .5in'>Open catmeta.xml, find the “BindingPolicy” table:</li></ol>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></tt></p>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><TableMeta <span style='mso-tab-count:1'> </span>InternalName="BINDINGREDIRTABLE"PublicRowName="BindingRedir" <o:p></o:p></span></tt></p>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><span style="mso-spacerun: yes"> </span><spanstyle='mso-tab-count:2'> </span>SchemaGeneratorFlags="EMITXMLSCHEMA"PublicName="BindingPolicy"></span></tt><span style='font-size:10.0pt;font-family:"Courier New";mso-fareast-font-family:"Courier New"'><br><tt><span style='mso-tab-count:1'> </span><ColumnMetaInternalName = "Name"<span style="mso-spacerun:yes"> </span><span style='mso-tab-count:3'> </span>Type="WSTR"MetaFlags="PRIMARYKEY"/></tt><br><tt><span style='mso-tab-count:1'> </span><ColumnMetaInternalName = "PK"<span style="mso-spacerun:yes"> </span><span style='mso-tab-count:3'> </span>Type="WSTR"MetaFlags="PRIMARYKEY"/></tt><br><tt><span style='mso-tab-count:1'> </span><ColumnMetaInternalName = "Version"<span style="mso-spacerun:yes"> </span><span style='mso-tab-count:2'> </span>Type="WSTR"MetaFlags="PRIMARYKEY"/></tt><br><tt><span style='mso-tab-count:1'> </span><ColumnMetaInternalName = "VersionNew"<span style="mso-spacerun:yes"> </span><span style='mso-tab-count:2'> </span>Type="WSTR"/></tt><br><tt><span style='mso-tab-count:1'> </span><ColumnMetaInternalName = "NoPublisherPolicy"<span style="mso-spacerun:yes"> </span>Type="WSTR"<span style="mso-spacerun: yes"> </span>/></tt><br><tt></TableMeta></tt><br style='mso-special-character:line-break'><![if !supportLineBreakNewLine]><br style='mso-special-character:line-break'><![endif]><tt><o:p></o:p></tt></span></p>
<ol style='margin-top:0in' start=2 type=1> <li class=MsoNormal style='mso-list:l8 level1 lfo17;tab-stops:list .5in'>Add the definition for the new column and save catmeta.xml:</li></ol>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></tt></p>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><TableMeta <span style='mso-tab-count:1'> </span>InternalName="BINDINGREDIRTABLE"PublicRowName="BindingRedir" <o:p></o:p></span></tt></p>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><span style="mso-spacerun: yes"> </span><spanstyle='mso-tab-count:2'> </span>SchemaGeneratorFlags="EMITXMLSCHEMA"PublicName="BindingPolicy"></span></tt><span style='font-size:10.0pt;font-family:"Courier New";mso-fareast-font-family:"Courier New"'><br><tt><span style='mso-tab-count:1'> </span><ColumnMetaInternalName = "Name"<span style="mso-spacerun:yes"> </span><span style='mso-tab-count:3'> </span>Type="WSTR"MetaFlags="PRIMARYKEY"/></tt><br><tt><span style='mso-tab-count:1'> </span><ColumnMetaInternalName = "PK"<span style="mso-spacerun:yes"> </span><span style='mso-tab-count:3'> </span>Type="WSTR"MetaFlags="PRIMARYKEY"/></tt><br><tt><span style='mso-tab-count:1'> </span><ColumnMetaInternalName = "Version"<span style="mso-spacerun:yes"> </span><span style='mso-tab-count:2'> </span>Type="WSTR"MetaFlags="PRIMARYKEY"/></tt><br><tt><span style='mso-tab-count:1'> </span><ColumnMetaInternalName = "VersionNew"<span style="mso-spacerun:yes"> </span><span style='mso-tab-count:2'> </span>Type="WSTR"/></tt><br><tt><span style='mso-tab-count:1'> </span><ColumnMetaInternalName = "NoPublisherPolicy"<span style="mso-spacerun:yes"> </span><span style='mso-tab-count:1'> </span>Type="WSTR"<spanstyle="mso-spacerun: yes"> </span>/></tt><br><tt><b><span style='color:red'><span style='mso-tab-count:1'> </span><ColumnMetaInternalName = "NewColumn"<span style="mso-spacerun: yes"> </span><span style='mso-tab-count:3'> </span>Type="UI4"/></span></b></tt><b><span style='color:red'><br></span></b><tt></TableMeta></tt><br style='mso-special-character:line-break'><![if !supportLineBreakNewLine]><br style='mso-special-character:line-break'><![endif]></span></p>
<p class=MsoBodyText style='margin-left:.5in;text-indent:-.25in;mso-list:l8 level1 lfo17;tab-stops:list .5in'><![if !supportLists]>3.<span style='font:7.0pt "Times New Roman"'> </span><![endif]>In the catalog directory (i.e. c:\config), run “catutil/validate catmeta.xml”. Fix any errors reported.</p>
<p class=MsoBodyText style='margin-left:.5in;text-indent:-.25in;mso-list:l8 level1 lfo17;tab-stops:list .5in'><![if !supportLists]>4.<span style='font:7.0pt "Times New Roman"'> </span><![endif]>In the catalog directory, run “catutil /compile/dll=c:\config\catalog.dll.</p>
<h3><a name="_Toc467340657">Example 2: Adding a column to the Ducttape“Application” table</a></h3>
<p class=MsoNormal>Ducttape uses persistent caching. For this reason, there aretwo table definitions for each table: one for the “raw” data as stored in theconfiguration file, and another one for the persisted data as consumed byDucttape:</p>
<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><!—- Configuration file definition --><o:p></o:p></span></tt></p>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><TableMeta<span style="mso-spacerun:yes"> </span>InternalName="APPS_CFG"SchemaGeneratorFlags="EMITCLBBLOB"><o:p></o:p></span></tt></p>
<p class=MsoNormal style='text-indent:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><span style='mso-tab-count:1'> </span><ColumnMeta<spanstyle="mso-spacerun: yes"> </span>InternalName="AppEnabled"<span style="mso-spacerun:yes"> </span>Type="UI4"<span style="mso-spacerun:yes"> </span>/><o:p></o:p></span></tt></p>
<p class=MsoNormal style='text-indent:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><span style="mso-spacerun: yes"> </span><spanstyle='mso-tab-count:1'> </span><QueryMeta<spanstyle="mso-spacerun: yes"> </span>InternalName="All"<span style="mso-spacerun:yes"> </span>MetaFlags="ALL" /><o:p></o:p></span></tt></p>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'></TableMeta><o:p></o:p></span></tt></p>
<p class=MsoNormal style='margin-left:.5in'><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><!—- Persisted table definition: the additionalcolumns are computed by the cookdown logic --><o:p></o:p></span></tt></p>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><TableMeta<span style="mso-spacerun:yes"> </span>InternalName="APPS"SchemaGeneratorFlags="EMITCLBBLOB"><o:p></o:p></span></tt></p>
<p class=MsoNormal style='text-indent:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><span style="mso-spacerun: yes"> </span><spanstyle='mso-tab-count:1'> </span><ColumnMeta<spanstyle="mso-spacerun: yes"> </span>InternalName="SrcCFGFile"<span style="mso-spacerun:yes"> </span>Type="WSTR"<span style="mso-spacerun:yes"> </span>/><o:p></o:p></span></tt></p>
<p class=MsoNormal style='text-indent:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><span style="mso-spacerun: yes"> </span><spanstyle='mso-tab-count:1'> </span><ColumnMeta<spanstyle="mso-spacerun: yes"> </span>InternalName="AppURL"<span style="mso-spacerun:yes"> </span>Type="WSTR"<span style="mso-spacerun:yes"> </span>MetaFlags="PRIMARYKEY" /><o:p></o:p></span></tt></p>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><span style="mso-spacerun:yes"> </span><ColumnMeta<spanstyle="mso-spacerun: yes"> </span>InternalName="SiteID"<span style="mso-spacerun:yes"> </span>Type="UI4"<span style="mso-spacerun:yes"> </span>MetaFlags="PRIMARYKEY"/><o:p></o:p></span></tt></p>
<p class=MsoNormal style='text-indent:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><span style="mso-spacerun: yes"> </span><spanstyle='mso-tab-count:1'> </span><ColumnMeta<spanstyle="mso-spacerun: yes"> </span>InternalName="AppPoolID"<spanstyle="mso-spacerun:yes"> </span>Type="WSTR"<span style="mso-spacerun:yes"> </span>/><o:p></o:p></span></tt></p>
<p class=MsoNormal style='text-indent:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><span style="mso-spacerun: yes"> </span><spanstyle='mso-tab-count:1'> </span><ColumnMeta<spanstyle="mso-spacerun: yes"> </span>InternalName="AppEnabled"<span style="mso-spacerun:yes"> </span>Type="UI4"<span style="mso-spacerun:yes"> </span>/><o:p></o:p></span></tt></p>
<p class=MsoNormal style='text-indent:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><span style="mso-spacerun: yes"> </span><spanstyle='mso-tab-count:1'> </span><QueryMeta<spanstyle="mso-spacerun: yes"> </span>InternalName="All"<span style="mso-spacerun:yes"> </span>MetaFlags="ALL" /><o:p></o:p></span></tt></p>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'></TableMeta></span></tt></p>
<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
<p class=MsoNormal>The table for the configuration file usually has the name ofthe persisted table plus a “_CFG”, i.e. “APPS” and “APPS_CFG”.</p>
<p class=MsoNormal>In order to add a column, a new ColumnMeta entry withmatching types has to be added to both table definitions (as illustrated inExample 1). If the new column requires no processing, but merely needs to becopied through to the persisted table, no further coding is needed.</p>
<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
<ol style='margin-top:0in' start=1 type=1> <li class=MsoNormal style='mso-list:l2 level1 lfo21;tab-stops:list .5in'>Edit catmeta.xml:</li></ol>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></tt></p>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><!—- Configuration file definition --><o:p></o:p></span></tt></p>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><TableMeta<span style="mso-spacerun:yes"> </span>InternalName="APPS_CFG" SchemaGeneratorFlags="EMITCLBBLOB"><o:p></o:p></span></tt></p>
<p class=MsoNormal style='text-indent:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><span style='mso-tab-count:1'> </span><ColumnMeta<spanstyle="mso-spacerun: yes"> </span>InternalName="AppEnabled"<span style="mso-spacerun:yes"> </span>Type="UI4"<span style="mso-spacerun:yes"> </span>/><o:p></o:p></span></tt></p>
<p class=MsoBodyTextIndent><tt><span style='font-size:10.0pt;font-family:"Courier New"'><spanstyle='mso-tab-count:1'> </span><ColumnMeta<spanstyle="mso-spacerun: yes"> </span>InternalName="MyNewColumn"<span style="mso-spacerun:yes"> </span>Type="WSTR"<span style="mso-spacerun:yes"> </span>/><o:p></o:p></span></tt></p>
<p class=MsoNormal style='text-indent:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><span style="mso-spacerun: yes"> </span><spanstyle='mso-tab-count:1'> </span><QueryMeta<spanstyle="mso-spacerun: yes"> </span>InternalName="All"<span style="mso-spacerun:yes"> </span>MetaFlags="ALL" /><o:p></o:p></span></tt></p>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'></TableMeta><o:p></o:p></span></tt></p>
<p class=MsoNormal style='margin-left:.5in'><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><!—- Persisted table definition: the additionalcolumns are computed by the cookdown logic --><o:p></o:p></span></tt></p>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><TableMeta<span style="mso-spacerun:yes"> </span>InternalName="APPS"SchemaGeneratorFlags="EMITCLBBLOB"><o:p></o:p></span></tt></p>
<p class=MsoNormal style='text-indent:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><span style="mso-spacerun: yes"> </span><spanstyle='mso-tab-count:1'> </span><ColumnMeta<spanstyle="mso-spacerun: yes"> </span>InternalName="SrcCFGFile"<span style="mso-spacerun:yes"> </span><spanstyle="mso-spacerun:yes"> </span>Type="WSTR"<spanstyle="mso-spacerun: yes"> </span>/><o:p></o:p></span></tt></p>
<p class=MsoNormal style='text-indent:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><span style="mso-spacerun: yes"> </span><spanstyle='mso-tab-count:1'> </span><ColumnMeta<spanstyle="mso-spacerun: yes"> </span>InternalName="AppURL"<span style="mso-spacerun:yes"> </span>Type="WSTR"<span style="mso-spacerun:yes"> </span>MetaFlags="PRIMARYKEY" /><o:p></o:p></span></tt></p>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><span style="mso-spacerun:yes"> </span><ColumnMeta<spanstyle="mso-spacerun: yes"> </span>InternalName="SiteID"<span style="mso-spacerun:yes"> </span>Type="UI4"<span style="mso-spacerun:yes"> </span>MetaFlags="PRIMARYKEY"/><o:p></o:p></span></tt></p>
<p class=MsoNormal style='text-indent:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><span style="mso-spacerun: yes"> </span><spanstyle='mso-tab-count:1'> </span><ColumnMeta<spanstyle="mso-spacerun: yes"> </span>InternalName="AppPoolID"<span style="mso-spacerun:yes"> </span>Type="WSTR"<span style="mso-spacerun:yes"> </span>/><o:p></o:p></span></tt></p>
<p class=MsoNormal style='text-indent:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><span style="mso-spacerun: yes"> </span><spanstyle='mso-tab-count:1'> </span><ColumnMeta<spanstyle="mso-spacerun: yes"> </span>InternalName="AppEnabled"<span style="mso-spacerun:yes"> </span>Type="UI4"<span style="mso-spacerun:yes"> </span>/><o:p></o:p></span></tt></p>
<p class=MsoBodyTextIndent2><tt><span style='font-size:10.0pt;font-family:"Courier New"'><spanstyle='mso-tab-count:1'> </span><ColumnMeta<spanstyle="mso-spacerun: yes"> </span>InternalName="MyNewColumn"<span style="mso-spacerun:yes"> </span>Type="WSTR"<span style="mso-spacerun:yes"> </span>/><o:p></o:p></span></tt></p>
<p class=MsoNormal style='text-indent:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'><span style="mso-spacerun: yes"> </span><spanstyle='mso-tab-count:1'> </span><QueryMeta<spanstyle="mso-spacerun: yes"> </span>InternalName="All"<span style="mso-spacerun:yes"> </span>MetaFlags="ALL" /><o:p></o:p></span></tt></p>
<p class=MsoNormal style='margin-left:.5in'><tt><span style='font-size:10.0pt;font-family:"Courier New"'></TableMeta></span></tt></p>
<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
<ol style='margin-top:0in' start=2 type=1> <li class=MsoNormal style='mso-list:l2 level1 lfo21;tab-stops:list .5in'>Run “catutil /validate catmeta.xml”</li> <li class=MsoNormal style='mso-list:l2 level1 lfo21;tab-stops:list .5in'>Run “catutil /compile /dll=c:\config\catalog.dll”</li></ol>
<h3><a name="_Toc467340658">Example 3: Adding a new collection</a></h3>
<p class=MsoNormal>Simply add a new <TableMeta> elements to theappropriate <DatabaseMeta> section in catmeta.xml (copying and existingone and modifying it is usually the easiest). </p>
<p class=MsoNormal>Note: The DatabaseMeta determines which interceptors (i.e.read from XML, CompLib etc.) will be used to handle the new collection, so picka Database that contains collections with similar semantics as the one you areadding<a style='mso-footnote-id:ftn1' href="#_ftn1" name="_ftnref1" title=""><spanclass=MsoFootnoteReference><span style='mso-special-character:footnote'><![if !supportFootnotes]>[1]<![endif]></span></span></a>.</p>
<p class=MsoNormal>Note: To add a collection to the persisted cache (cookdown),code changes are required in current drops!</p>
<h3><a name="_Toc467340659">Making the schema part of the shipping product</a></h3>
<p class=MsoNormal>For the December release, schema changes need to be checkedinto the Config source tree (<a href="file://urtsrc/config">\\urtsrc\config</a>$/catalog42/src/bin/core/catinproc/catmeta.xml).</p>
<p class=MsoNormal>Please follow the <a href="#_Check-in_procedures">Configteam check-in procedures</a>! </p>
<p class=MsoNormal>Request access to the config sources via <ahref="file://lab7/groupease">\\lab7\groupease</a>. E-mail <ahref="mailto:MarkusH">MarkusH</a> for VSS write access.</p>
<div class=MsoNormal align=center style='text-align:center'>
<hr size=2 width="100%" align=center>
</div>
<h2><a name="_Toc467340660"></a><a name="Writing_Plugins"></a><aname="_Check-in_procedures"></a><a name="_Writing_Plugins"></a><spanstyle='mso-bookmark:_Toc467340660'><span style='mso-bookmark:Writing_Plugins'>WritingPlugins</span></span></h2>
<p class=MsoNormal><span style='color:red'>TODO: Need to include info here on howto write plugins and perhaps even sample code.</span> </p>
<p class=MsoNormal>Refer to the <a href="simpletablesV2.doc">Native-codeconfiguration system spec</a> for details on interceptors, wiring etc.</p>
<div class=MsoNormal align=center style='text-align:center'>
<hr size=2 width="100%" align=center>
</div>
<h2><a name="_Toc467340661"></a><a name=BVTs></a><a name=Breakdown></a><aname="_Running_BVTs"></a><span style='mso-bookmark:_Toc467340661'><spanstyle='mso-bookmark:BVTs'><span style='mso-bookmark:Breakdown'>Running BVTs</span></span></span><spanstyle='mso-bookmark:Breakdown'></span></h2>
<p class=MsoNormal><span style='mso-bookmark:Breakdown'>To run the current BVTtests, you need to </span></p>
<ul type=disc> <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l5 level1 lfo25;tab-stops:list .5in'><span style='mso-bookmark: Breakdown'>Install the Config system as indicated in the </span><a href="#Setup"><span style='mso-bookmark:Breakdown'>Setup</span><span style='mso-bookmark:Breakdown'></span></a><span style='mso-bookmark:Breakdown'> section of this document, BUT you must install everything in the </span><span style='mso-bookmark:Breakdown'><tt><span style='font-size:10.0pt; font-family:"Courier New"'>%windir%\XSPDT</span></tt> directory. Basically, you will need to follow the directions carefully and wherever appropriate, use </span><span style='mso-bookmark:Breakdown'><tt><span style='font-size:10.0pt;font-family:"Courier New"'>%windir%\XSPDT</span></tt> as opposed to any arbitrary directory.</span></li></ul>
<ul type=disc> <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l11 level1 lfo28;tab-stops:list .5in'><span style='mso-bookmark: Breakdown'>Create a local directory (i.e. </span><a href="file:///c:/mybvt"><span style='mso-bookmark:Breakdown'>c:\mybvt</span><span style='mso-bookmark: Breakdown'></span></a><span style='mso-bookmark:Breakdown'>) to hold the BVT files</span></li> <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; mso-list:l11 level1 lfo28;tab-stops:list .5in'><span style='mso-bookmark: Breakdown'>Start the BVT from the current directory, i.e.<br> cd </span><a href="file:///c:/mybvtdir"><span style='mso-bookmark:Breakdown'>c:\mybvtdir</span><span style='mso-bookmark: Breakdown'></span></a><span style='mso-bookmark:Breakdown'> /d<br> </span><a href="file://astdrop/drop/x86/catalog/caturtbvt"><span style='mso-bookmark: Breakdown'>\\astdrop\drop\x86\catalog\caturtbvt</span><span style='mso-bookmark:Breakdown'></span></a><span style='mso-bookmark:Breakdown'> build_number [checked/free, default is checked]<br> Example: caturtbvt 0927</span></li></ul>
<p><span style='mso-bookmark:Breakdown'>WARNING!!! The BVT will copy all thenecessary configuration files into both the current directory and thewinnt\xspdt directory. So your files in the current directory and windows\xspdtwill be replaced!!</span></p>
<p><span style='mso-bookmark:Breakdown'>NOTE FOR CHECKED BUILDS: You will need </span><ahref="msvcrtd.dll"><span style='mso-bookmark:Breakdown'><tt><spanstyle='font-size:10.0pt;font-family:"Courier New"'>msvcrtd.dll</span></tt></span><spanstyle='mso-bookmark:Breakdown'></span></a><span style='mso-bookmark:Breakdown'>in order to run the checked version of Testcookdown.exe. Make sure you copythis into the same directory as Testcookdown.exe (that is, </span><spanstyle='mso-bookmark:Breakdown'><tt><span style='font-size:10.0pt;font-family:"Courier New"'>%windir%\XSPDT</span></tt>). This dependency will be removed infuture builds. </span></p>
<div class=MsoNormal align=center style='text-align:center'><spanstyle='mso-bookmark:Breakdown'>
<hr size=2 width="100%" align=center>
</span></div>
<h2><span style='mso-bookmark:Breakdown'><a name="_Toc467340662"></a><aname="_Check-in_procedure"></a><span style='mso-bookmark:_Toc467340662'>Check-inprocedure</span></span></h2>
<ul style='margin-top:0in' type=disc> <li class=MsoNormal style='mso-list:l1 level1 lfo31;tab-stops:list .5in'><span style='mso-bookmark:Breakdown'>Get a code/schema read from a </span><a href="mailto:catcore"><span style='mso-bookmark:Breakdown'>CatCore</span><span style='mso-bookmark:Breakdown'></span></a><span style='mso-bookmark:Breakdown'> developer.</span></li> <li class=MsoNormal style='mso-list:l1 level1 lfo31;tab-stops:list .5in'><span style='mso-bookmark:Breakdown'>Perform a full “get” on the catalog42 source tree.</span></li> <li class=MsoNormal style='mso-list:l1 level1 lfo31;tab-stops:list .5in'><span style='mso-bookmark:Breakdown'>Apply your changes and build at least “checked”. Building “free” is optional but highly recommended if you make any code changes.</span></li> <li class=MsoNormal style='mso-list:l1 level1 lfo31;tab-stops:list .5in'><span style='mso-bookmark:Breakdown'>Run </span><a href="#BVTs"><span style='mso-bookmark:Breakdown'>BVTs</span><span style='mso-bookmark:Breakdown'></span></a><span style='mso-bookmark:Breakdown'> on at least the checked build.</span></li> <li class=MsoNormal style='mso-list:l1 level1 lfo31;tab-stops:list .5in'><span style='mso-bookmark:Breakdown'>Check in.</span></li> <li class=MsoNormal style='mso-list:l1 level1 lfo31;tab-stops:list .5in'><span style='mso-bookmark:Breakdown'>Send check-in mail to </span><a href="mailto:catchk"><span style='mso-bookmark:Breakdown'>CatChk</span><span style='mso-bookmark:Breakdown'></span></a><span style='mso-bookmark:Breakdown'> </span></li> <li class=MsoNormal style='mso-list:l1 level1 lfo31;tab-stops:list .5in'><span style='mso-bookmark:Breakdown'>Get a buddy build (optional).</span></li></ul>
<p class=MsoNormal><span style='mso-bookmark:Breakdown'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<p class=MsoNormal><span style='mso-bookmark:Breakdown'>Do not check in duringthe config build time (currently 7AM Mo-Fr), up-to-date build schedules on </span><ahref="http://urt/build.asp"><span style='mso-bookmark:Breakdown'>http://urt/build.asp</span><spanstyle='mso-bookmark:Breakdown'></span></a><span style='mso-bookmark:Breakdown'>.</span></p>
<p class=MsoNormal><span style='mso-bookmark:Breakdown'>Contact </span><ahref="mailto:MarkusH"><span style='mso-bookmark:Breakdown'>MarkusH</span><spanstyle='mso-bookmark:Breakdown'></span></a><span style='mso-bookmark:Breakdown'>/ </span><a href="mailto:RCraig"><span style='mso-bookmark:Breakdown'>RCraig</span><spanstyle='mso-bookmark:Breakdown'></span></a><span style='mso-bookmark:Breakdown'>to obtain permission for check-in during lock down.</span></p>
<span style='mso-bookmark:Breakdown'></span>
<h2><a name="_Toc467340663"></a><a name="_File_list_for"></a><spanstyle='mso-bookmark:_Toc467340663'>File list for Setup</span></h2>
<p class=MsoNormal>This section details all the files/reg keys and otherinformation about the Config system. </p>
<h3><a name="_Toc467340664">Files</a></h3>
<table border=1 cellspacing=0 cellpadding=0 width="100%" style='width:100.0%; mso-cellspacing:0in;mso-padding-alt:3.75pt 3.75pt 3.75pt 3.75pt'> <tr> <td colspan=2 style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal><b>Internal Core</b> </p> </td> </tr> <tr> <td style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal><tt><span style='font-size:10.0pt;font-family:"Courier New"'>Catalog.dll</span></tt><span style='font-size:10.0pt;font-family:"Courier New";mso-fareast-font-family: "Courier New"'><br> <tt>catalog.xms</tt></span></p> </td> <td style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal>This is the primary .dll which is built. The other file is the XML schema file needed by the catalog as well. </p> </td> </tr> <tr> <td colspan=2 style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal><b>External Core</b> </p> </td> </tr> <tr> <td style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal><tt><span style='font-size:10.0pt;font-family:"Courier New"'>MSXML.DLL</span></tt><span style='font-size:10.0pt;font-family:"Courier New";mso-fareast-font-family: "Courier New"'><br> <tt>SHLWAPI.DLL</tt><br> <tt>URLMON.DLL</tt></span></p> </td> <td style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal>These files are external and built by the IE5 team. We are currently dependent on these file and are negotiating a redistribution .dll that we can ship with the product. This is still on-going and whether we will ultimately ship these or just be dependent on IE5 is still in debate and negotiations. For now, you must also copy these files in order for the Config system to work. </p> </td> </tr> <tr> <td colspan=2 style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal><b>External Dependencies (that we don't ship)</b> </p> </td> </tr> <tr> <td style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal><tt><span style='font-size:10.0pt;font-family:"Courier New"'>MSVCRT.DLL</span></tt><span style='font-size:10.0pt;font-family:"Courier New";mso-fareast-font-family: "Courier New"'><br> <tt>MSVCRTD.DLL</tt></span></p> </td> <td style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal>We require MSVCRT.DLL in order to run the catalog, however, we don't ship this because it comes standard with all the OS' such as Win9x, WinNT4, and Win2K. The counterpart is a dependency we have in Checked builds only (MSVCRTD.DLL). This is not an issue as we will not be shipping Checked builds. </p> </td> </tr> <tr> <td colspan=2 style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal><b>Managed Code</b> </p> </td> </tr> <tr> <td style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal><tt><span style='font-size:10.0pt;font-family:"Courier New"'>MngdIST.dll </span></tt></p> </td> <td style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal>If you are writing managed code and need managed code access, you will need this as well. </p> </td> </tr> <tr> <td colspan=2 style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal><b>Debug Files</b> </p> </td> </tr> <tr> <td style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal><tt><span style='font-size:10.0pt;font-family:"Courier New"'>Catalog.pdb</span></tt></p> </td> <td style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal>For debugging purposes only</p> </td> </tr> <tr> <td colspan=2 style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal><b>Schema Extension (internal only)<o:p></o:p></b></p> </td> </tr> <tr> <td style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal><tt><span style='font-size:10.0pt;font-family:"Courier New"'>catmeta.xml</span></tt><span style='font-size:10.0pt;font-family:"Courier New";mso-fareast-font-family: "Courier New"'><br> <tt>catmeta.xms</tt><br> <tt>catutil.exe</tt><br> <tt>catwire.xml</tt></span></p> </td> <td style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal>These files are not necessary for the running of the Config system. However, if you ever need to change the schema information (like adding a property) or chaning the wiring information, you will need these XML files and the tool to recompile them. </p> </td> </tr> <tr> <td colspan=2 style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal><b>Config SDK (Internal only)</b></p> </td> </tr> <tr> <td style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal><tt><span style='font-size:10.0pt;font-family:"Courier New"'>cat.lib</span></tt><span style='font-size:10.0pt;font-family:"Courier New";mso-fareast-font-family: "Courier New"'><br> <tt>catalog.h</tt><br> <tt>catmeta.h</tt></span></p> </td> <td style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal>If you are writing code that uses the Config system, you will need to include the header files and link with the .libs. </p> </td> </tr> <tr> <td colspan=2 style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal><b>Test Tools and Files (Internal only)<o:p></o:p></b></p> </td> </tr> <tr> <td style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal><tt><span style='font-size:10.0pt;font-family:"Courier New"'>App.XML</span></tt><span style='font-size:10.0pt;font-family:"Courier New";mso-fareast-font-family: "Courier New"'><br> <tt>AppPool.XML</tt><br> <tt>Global.XML</tt><br> <tt>stest.exe</tt><br> <tt>stest.pdb</tt><br> <tt>TestCookDown.exe</tt><br> <tt>TestCookDown.pdb</tt><br> <tt>VirtualSite.XML</tt></span></p> </td> <td style='padding:3.75pt 3.75pt 3.75pt 3.75pt'> <p class=MsoNormal>These are the test tools and their respective debugging files and sample test files used by the test tool only. </p> </td> </tr></table>
<h3><a name="_Toc467340665"></a><a name="_Registry_Keys"></a><spanstyle='mso-bookmark:_Toc467340665'>Registry Keys</span></h3>
<p class=MsoNormal><b><span style='color:red'>Notice: this registry key may changewithout notice!<o:p></o:p></span></b></p>
<p class=MsoNormal>Use the GetMachineConfigDirectory APIs (mangaged &unmanaged) to obtain the config directory location. Link to cat.lib to accesscatalog.dll.</p>
<p class=MsoNormal>If you need to manually install catalog drops, use “catutil/product=URT” as described above.</p>
<p class=MsoNormal><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
<p class=MsoNormal><b>With build 1019 the registry key/value structure haschanged!<o:p></o:p></b></p>
<p class=MsoNormal style='margin-right:.5in;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'><span style='mso-tab-count:1'> </span>HKLM\Software\Microsoft\Catalog42</p>
<p class=MsoNormal style='margin-right:.5in;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>Within this key a sub key is defined for each “product” (as passed to theGetSimpleTableDispenser API in cat.lib). </p>
<p class=MsoNormal style='margin-right:.5in;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;text-indent:.5in'>Example: HKLM\Software\Microsoft\Catalog42\<b>URT</b></p>
<p class=MsoNormal style='margin-right:.5in;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>Within this product key, two named values are defined:</p>
<p class=MsoNormal style='margin-right:.5in;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'><span style='mso-tab-count:1'> </span>Name:“<b>Dll</b>”. Value: full path to (including) catalog.dll. Example:“c:\config\catalog.dll”, in the future likely “%windir%\COMPlus\Bin”.</p>
<p class=MsoBlockText>Name: “<b>MachineConfigDirectory</b>”. Value: full pathto the directory that contains the machine configuration file (machine.cfg).Example: c:\config, in the future likely “%windir%\COMPlus\Config”.</p>
<p class=MsoBodyText2>With build 1108 the following additional registrykeys/values are required:</p>
<p class=MsoBlockText style='margin-left:0in'>HKLM\SYSTEM\CurrentControlSet\Services\EventLog\<b>Application</b>\COM+Config</p>
<p class=MsoBlockText style='margin-left:0in'>Within this key, add two values:</p>
<p class=MsoBlockText>Name: “<b>EventMessageFile</b>”. Value: fully qualifiedpath to catalog.dll</p>
<p class=MsoBlockText>Name: “<b>TypesSupported</b>”. Value: 0x07 (DWORD)</p>
<p class=MsoBlockText style='margin-left:0in'>HKLM\SYSTEM\CurrentControlSet\Services\EventLog\<b>System</b>\COM+Config</p>
<p class=MsoBlockText style='margin-left:0in'>Within this key, add two values:</p>
<p class=MsoBlockText>Name: “<b>EventMessageFile</b>”. Value: fully qualifiedpath to catalog.dll</p>
<p class=MsoBlockText>Name: “<b>TypesSupported</b>”. Value: 0x07 (DWORD)</p>
<p class=MsoBlockText style='margin-left:0in'>The following people (and onlythose) will be notified of changes to this registry key/structure (e-mail <ahref="mailto:markush">MarkusH</a> to be added to this list):</p>
<p class=MsoBlockText style='text-indent:-.25in;mso-list:l10 level1 lfo33;tab-stops:list .5in'><![if !supportLists]><span style='font-family:Symbol'>·<spanstyle='font:7.0pt "Times New Roman"'> </span></span><![endif]><a href="mailto:URTSETUP">URT Setup</a> </p>
<p class=MsoNormal><span style='font-size:8.0pt;mso-bidi-font-size:12.0pt'>Previousregistry structure (before build 1019):<o:p></o:p></span></p>
<p class=MsoNormal style='margin-right:.5in;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;margin-left:.5in'><tt><b><span style='font-size:8.0pt;mso-bidi-font-size:10.0pt;font-family:"Courier New"'>HKLM\Software\Microsoft\Catalog42</span></b></tt><spanstyle='font-size:8.0pt;mso-bidi-font-size:12.0pt'> <o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:8.0pt;mso-bidi-font-size:12.0pt'>Withinthis key, a new <b>String</b> value is necessary.<o:p></o:p></span></p>
<p class=MsoNormal style='margin-right:.5in;mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;margin-left:.5in'><b><span style='font-size:8.0pt;mso-bidi-font-size:12.0pt'>Name:</span></b><spanstyle='font-size:8.0pt;mso-bidi-font-size:12.0pt'> URT<br><b>Value:</b> <em>full path to (including) Catalog.dll (e.g. </em></span><tt><spanstyle='font-size:8.0pt;mso-bidi-font-size:10.0pt;font-family:"Courier New"'>C:\Config\Catalog.dll</span></tt><em><spanstyle='font-size:8.0pt;mso-bidi-font-size:12.0pt'>)</span></em><spanstyle='font-size:8.0pt;mso-bidi-font-size:12.0pt'> <o:p></o:p></span></p>
<div class=MsoNormal align=center style='text-align:center'>
<hr size=2 width="100%" align=center>
</div>
</div>
<div style='mso-element:footnote-list'><![if !supportFootnotes]><br clear=all>
<hr align=left size=1 width="33%">
<![endif]>
<div style='mso-element:footnote' id=ftn1>
<p class=MsoFootnoteText><a style='mso-footnote-id:ftn1' href="#_ftnref1"name="_ftn1" title=""><span class=MsoFootnoteReference><span style='mso-special-character:footnote'><![if !supportFootnotes]>[1]<![endif]></span></span></a> Interceptorwiring happens via the default database wiring in catwire.xml; refer to the <ahref="simpletablesV2.doc">Native-code configuration system spec</a> for detailson interceptor wiring, including per-collection wiring.</p>
</div>
</div>
</body>
</html>
|
