<!DOCTYPE html
  PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<!--
Copyright (c) 2006 UGS Corp.

All Rights Reserved.

This software and related documentation are proprietary to UGS Corp.
-->
<html>
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
      <title>update_fam_from_ptb &ndash; User's Guide</title>
      <script language="javaScript">
        abridged="false";
        displayConditions=new Array();
      </script>
      <link type="text/css" href="../css/main_styles.css" rel="stylesheet">
   </head>
   <body class="bodydocs" onload="top.pageLoader()" bgcolor="#FFFFFF">
      <div class="title_topic3" id="xps10_pagetitle">update_fam_from_ptb &ndash; User's Guide</div>
      <hr noshade="true">
      <table cellspacing="4" align="center">
         <tr valign="top">
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1">
               <p class="para_td"><a class="links" href="javascript:void(0)" onclick="top.openFile('routingadmin/en_level_overview.html');return(false);">Overview</a></p>
            </td>
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1">
               <p class="para_td"><a class="links" href="javascript:void(0)" onclick="top.openFile('routingadmin/en_level_principles.html');return(false);">How To</a></p>
            </td>
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1">
               <p class="para_td"><a class="links" href="javascript:void(0)" onclick="top.openFile('routingadmin/en_level_practices.html');return(false);">Options</a></p>
            </td>
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1">
               <p class="para_td"><a class="links" href="javascript:void(0)" onclick="top.openFile('routingadmin/en_level_partdir.html');return(false);">Related Topics</a></p>
            </td>
         </tr>
      </table><br><p class="para_topic">Routing uses two modes, <b class="uiTerm">Native</b> and <b class="uiTerm">PIM</b>. If you are using Teamcenter Integration, <b class="uiTerm">PIM</b> mode is used. While running with part files on the file system, native mode is used.
      </p>
      <p class="para_topic">The update_fam_from_ptb utility can have the following switches when run in native mode:</p>
      <p class="para_topic">&nbsp;&nbsp;&nbsp;&nbsp;&ndash;update</p>
      <p class="para_topic">&nbsp;&nbsp;&nbsp;&nbsp;&ndash;delete</p>
      <p class="para_topic">&nbsp;&nbsp;&nbsp;&nbsp;&ndash;pd &nbsp;{dir}</p>
      <p class="para_topic">&nbsp;&nbsp;&nbsp;&nbsp;&ndash;pe &nbsp;{environment variable name}</p>
      <p class="para_topic">&nbsp;&nbsp;&nbsp;&nbsp;&ndash;tree {dir}</p>
      <p class="para_topic">The &ndash;pim switch should only be used when running in Teamcenter Integration mode. If &ndash;pim is used, &ndash;u, &ndash;p, and &ndash;g can be supplied to specify the user name, password, and group.</p>
      <div class="title_division">Syntax:</div>
      <p class="para_division">update_fam_from_ptb [&ndash;c] [&ndash;update] [&ndash;h] [[&ndash;pd=(location of the part files)] [&ndash;pe=(environment variable pointing to the location of part files)]] [ [&ndash;pim=yes]</p>
      <p class="para_division">[&ndash;revise] [&ndash;u=user name] [&ndash;p=passwd] [&ndash;g=group] ] file(s)</p>
      <table bgcolor="#F0F0F0" cellpadding="4" cellspacing="2" width="95%" align="center">
         <colgroup span="1">
            <col span="1" width="42*">
            <col span="1" width="157*">
         </colgroup>
         <tr valign="top">
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">&ndash;c</p>
            </td>
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Cross check the NX part families based on all Part Table(s) specified.</p>
            </td>
         </tr>
         <tr valign="top">
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">&ndash;update</p>
            </td>
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Update the NX part families based on all Part Table(s) specified.</p>
            </td>
         </tr>
         <tr valign="top">
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">&ndash;delete</p>
            </td>
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Delete the NX part families based on all Part Table(s) specified.</p>
            </td>
         </tr>
         <tr valign="top">
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">&ndash;revise</p>
            </td>
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Teamcenter Integration mode only. Create a new revision of the updated part family template part.</p>
            </td>
         </tr>
         <tr valign="top">
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">&ndash;h</p>
            </td>
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Get help on usage.</p>
            </td>
         </tr>
         <tr valign="top">
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">&ndash;pd</p>
            </td>
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Path List points to the directories containing the .prt files to be updated. The directories must be separated by a ':' (Windows) or ';' (UNIX).</p>
            </td>
         </tr>
         <tr valign="top">
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">&ndash;pe</p>
            </td>
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Name of the environment variable containing the location of the .prt files to be updated.</p>
            </td>
         </tr>
         <tr valign="top">
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">&ndash;pim=yes</p>
            </td>
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Operate on part files present in Teamcenter Integration.</p>
            </td>
         </tr>
         <tr valign="top">
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">&ndash;u</p>
            </td>
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Username for Teamcenter Integration account.</p>
            </td>
         </tr>
         <tr valign="top">
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">&ndash;p</p>
            </td>
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Password for Teamcenter Integration account.</p>
            </td>
         </tr>
         <tr valign="top">
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">&ndash;g</p>
            </td>
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Name of the group for Teamcenter Integration account.</p>
            </td>
         </tr>
         <tr valign="top">
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">&ndash;tree</p>
            </td>
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Base Directory Location containing Part Table(s).</p>
            </td>
         </tr>
         <tr valign="top">
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">file(s)</p>
            </td>
            <td bgcolor="#f7f7f7" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Specify the Part Table name(s). Input files can be specified in two ways:</p>
               <p class="para_td">1. A starting directory with <b class="uiTerm">&ndash;tree</b> option. Part Tables in this directory and all its sub-directories will be processed.
               </p>
               <p class="para_td">2. Specify one or more Part Table names directly.</p>
            </td>
         </tr>
      </table><br><p class="para_division">One of the part file selection options (<b class="uiTerm">&ndash;pe</b> or <b class="uiTerm">&ndash;pd</b>) should be specified. The default option is <b class="uiTerm">&ndash;c</b> (crosscheck). The <b class="uiTerm">[&ndash;update]</b> option will over ride the default option will override the default option.
      </p>
      <p class="para_division">The <b class="uiTerm">[&ndash;update]</b> and <b class="uiTerm">[&ndash;delete]</b> option can be used together to delete the old Part Family and create a new one. The <b class="uiTerm">[&ndash;c]</b> and <b class="uiTerm">[&ndash;delete]</b> option cannot be used together.
      </p>
      <p class="para_division">It is necessary to specify either the <b class="uiTerm">[&ndash;tree]</b> option or list of Part Table(s) You can specify multiple <b class="uiTerm">[&ndash;tree]</b> options or a combination of <b class="uiTerm">[&ndash;tree]</b> options and list of part tables.
      </p>
      <p class="para_division">Refer to the update_err_log.txt file, which is created in the working directory for any error that occurs while processing. When building NX part families update_fam_from_ptb ignores expressions with automatically generated names (for example, p1). This permits update_fam_from_ptb to build part family tables using the minimum number of columns while providing useful error checking. Rename the basic expressions that drive the part geometry to convey the closest meaning of the dimension. Only the basic expressions, which drive the part and are required in the part family table need to be renamed.</p>
      <div class="title_division">Weight characteristic caveat with update_fam_from_ptb:</div>
      <p class="para_division">The WEIGHT characteristic (charx) in the ptb file controls the weight of the component or stock. See <a class="links" href="javascript:void(0)" onclick="top.popUpPage('routingtools/index.html?goto=routingtools/title_page.html&vars=-aux,-home','linkInter','menubar=yes,status=yes,resizable=yes,toolbar=yes,scrollbars=yes,location=no,directories=no');return(false);">Routing Tools</a>: Routing Aware Characteristics. If the weight characteristic is not to be asserted (for components added via <b class="uiTerm">Place Part</b>) or the solid density assigned for stock, then the WEIGHT characteristics and the associated column from the ptb should be removed. This particular modification does not require update_fam_from_ptb to be run because the WEIGHT characeristic will not correspond to an expression in the template part.
      </p>
      <p class="para_division">If the weight for each component needs to be set, then just edit the .ptb value. This will only work when adding new components or stock to an assembly.</p>
      <p class="para_division">If using placed parts, then use the standard <b class="uiTerm">Mass Properties</b> function to assign a new value. Otherwise, remove and replace the part after the weight is correctly assigned in the .ptb. For existing assigned stock, all stock of the specifically weight changed stock must be removed from the model, and then reassigned to recognize the new weight value.
      </p>
      <div class="title_division">Examples</div>
      <p class="para_division">update_fam_from_ptb rnd_stock.ptb:</p>
      <p class="para_division">Cross checks data in rnd_stock.ptb with respect to all NX part family references in the Part Table.</p>
      <p class="para_division">update_fam_from_ptb &ndash;update &ndash;tree /routing/tables/piping:</p>
      <p class="para_division">Updates all NX part families based on all part tables from /routing/tables/piping directory and any of its sub&ndash;directories.</p>
      <p class="para_division">update_fam_from_ptb &ndash;update /routing/tables/piping/ *.ptb:</p>
      <p class="para_division">Updates all NX part families based on all Part Tables in the directory /routing/tables/piping.</p>
      <p class="para_division">update_fam_from_ptb &ndash;pim=yes &ndash;u=&lt;username&gt; &ndash;p=&lt;password&gt; &ndash;g=&lt;group&gt; &ndash;update rnd_stock.ptb:</p>
      <p class="para_division">Updates all NX part families in Teamcenter Integration database based on the references in the part table rnd_stock.ptb.</p>
   </body>
</html>
