<!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>DBLOAD</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">
      <hr noshade="true">
      <div class="title_refTopic" id="xps10_pagetitle">DBLOAD </div>
      <hr noshade="true">
      <h4 class="refClassification">Load a Database from a FORTRAN File </h4>
      <p class="para_refTopic">Recovers data blocks or parameters from a database created by the DBUNLOAD statement. </p>
      <div class="title_refCategory">Format: </div>
      <div class="refCategoryContent">
         <p align="center"><img align="bottom" src="graphics/fms-ufig10.gif"></p>
      </div>
      <div class="title_refCategory">Examples: </div>
      <div class="refCategoryContent">
         <ol type="1" start="1">
            <li>
               <p class="para_item">Load the database stored in ASCII format on FORTRAN unit 12. </p>
               <table width="100%" align="center">
                  <colgroup span="1">
                     <col span="1" width="19.32*">
                     <col span="1" width="80.68*">
                  </colgroup>
                  <tbody>
                     <tr>
                        <td align="left" colspan="1" rowspan="1" valign="top"><pre class="indent">DBLOAD</pre></td>
                        <td align="left" colspan="1" rowspan="1" valign="top"><pre class="indent">UNIT=12 FORMAT=NEUTRAL</pre></td>
                     </tr>
                     <tr>
                        <td align="left" colspan="1" rowspan="1" valign="top"><pre class="indent">ASSIGN</pre></td>
                        <td align="left" colspan="1" rowspan="1" valign="top"><pre class="indent">DBLOAD=&rsquo;physical file name of unloaded database&rsquo;UNIT=12</pre><pre class="indent">FORMATTED</pre></td>
                     </tr>
                  </tbody>
               </table><br></li>
            <li>
               <p class="para_item">Load version 1 of KAA under project FRONT BUMPER and store it on the primary database under version 5 and project BUMPER.  Overwrite duplicates found on the primary database. </p>
               <table width="100%" align="center">
                  <colgroup span="1">
                     <col span="1" width="20*">
                     <col span="1" width="80*">
                  </colgroup>
                  <tbody>
                     <tr>
                        <td align="left" colspan="1" rowspan="1" valign="top"><pre class="indent">DBLOAD</pre></td>
                        <td align="left" colspan="1" rowspan="1" valign="top"><pre class="indent">DATABLK=(KAA) WHERE(PROJECT=&rsquo;FRONT 
BUMPER&rsquo; AND ,SEID=10 AND VERSION=1) CONVERT(VERSION=5;  , PROJECT=&rsquo;BUMPER&rsquo;) OVRWRT</pre></td>
                     </tr>
                     <tr>
                        <td align="left" colspan="1" rowspan="1" valign="top"><pre class="indent">ASSIGN</pre></td>
                        <td align="left" colspan="1" rowspan="1" valign="top"><pre class="indent">DBLOAD=&rsquo;physical file name of unloaded 
database&rsquo;</pre></td>
                     </tr>
                  </tbody>
               </table><br></li>
         </ol>
      </div>
      <div class="title_refCategory">Describers:</div>
      <div class="refCategoryContent">
         <table cellpadding="10" cellspacing="" width="100%" align="center">
            <colgroup span="1">
               <col span="1" width="24*">
               <col span="1" width="75*">
            </colgroup>
            <thead>
               <tr>
                  <th align="left" colspan="1" rowspan="1">
                     <p class="para_th"><b class="uiTerm">Describer </b></p>
                  </th>
                  <th align="left" colspan="1" rowspan="1">
                     <p class="para_th"><b class="uiTerm">Meaning </b></p>
                  </th>
               </tr>
            </thead>
            <tbody>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">datablk-list </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">Specifies a list of data blocks separated by commas.  The default is  *  which selects all data blocks.  The loaded data block may be renamed in the primary database by specifying a slash after the old name followed by the new name.  For example, if KLL is to be renamed to KLL1, then DATABLK=(KLL/KLL1) is specified. </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">param-list </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">Specifies a list of parameters separated by commas.  The default is  *, which selects all parameters.  The loaded parameter may be renamed in the primary database by specifying a slash after the old name followed by the new name.  For example, if LUSETS is to be renamed to LUSET, then PARAM=(LUSETS/LUSET) is specified. </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">where-expr </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">A logical expression that specifies the desired values of qualifiers, PROJECT, VERSION, and DBSET.  For example, WHERE(VERSlON=4 AND SEID&lt;&gt;2 AND SEID&gt;0) selects all items under version 4 for all values of SEID greater than 0 except 2.  See the beginning of this section on WHERE and CONVERT clauses. </p>
                     <p class="para_td">The default for VERSION is  *  for all versions; PROJECT is  *  for all projects; and DBSET is *  for all DBsets.  The default for qual is  *, which is all qualifier values found on the loaded database.  See also Remark <a class="links" href="javascript:void(0)" onclick="top.openFile('QRG/03ref33329_15.html#refQAvi22fjuli');return(false);">21-8. </a></p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" height="378" rowspan="1" valign="top">
                     <p class="para_td">convert-expr </p>
                  </td>
                  <td align="left" colspan="1" height="378" rowspan="1" valign="top">
                     <p class="para_td">Modifies the values for PROJECT, VERSION, DBSET, and qualifiers selected by the where-expr.  The format of convert-expr is: </p>
                     <p class="para_td">PROJECT=project-expr; VERSION=version-expr; </p>
                     <p class="para_td">DBSET=DBset-name; quali=qual-expri[;..] </p>
                     <p class="para_td">For example, CONVERT (SEID=100 + SElD; SPC=102).  See the beginning of this section on WHERE and CONVERT clauses. </p>
                     <p class="para_td">The default action for VERSION and PROJECT is to use the same version IDs and project IDs; i.e., CONVERT(PROJECT=PROJECT; VERSION=VERSION).  But if either PROJECT or VERSION is specified in the convert-expr, then both must be specified. The default action for qualifiers and DBSET is to use the same values as long as they are defined in both databases.  If not, see Remark <a class="links" href="javascript:void(0)" onclick="top.openFile('QRG/03ref33329_15.html#refQAvi22fjuli');return(false);">21-8. </a></p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">unit </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">Specifies the FORTRAN unit number of the database to be loaded.  The unit must be specified on an ASSIGN statement that references the physical filename of the loaded database.  The default is 51. </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">OVRWRT NOOVRWRT</p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">By default, if duplicate data blocks or parameters exist on the loaded and primary databases, then a fatal message is issued.  A duplicate means that a data block or parameter has not only the same name but also the same qualifier values, PROJECT, VERSION, and DBSET as a data block or parameter on the primary database. </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">NEUTRAL, BINARY</p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">The database to be loaded may be in BINARY or NEUTRAL format. BINARY indicates the database to be loaded is in binary or FORTRAN unformatted format.  NEUTRAL indicates the database to be loaded is in ASCII format.  The default is BINARY. </p>
                  </td>
               </tr>
            </tbody>
         </table><br></div>
      <div class="title_refCategory">Remarks: </div>
      <div class="refCategoryContent">
         <ol type="1" start="1">
            <li>
               <p class="para_item">The DBLOAD statement and its applications are discussed further in <a class="links" href="javascript:void(0)" onclick="top.popUpPage('User/index.html?goto=User/18ref15962_10.html&vars=-aux,-home','linkInter','menubar=yes,status=yes,resizable=yes,toolbar=yes,scrollbars=yes,location=no,directories=no');return(false);">&ldquo;Database Archival and Retrieval&rdquo; in the <em>NX Nastran User&rsquo;s Guide</em></a>. 
               </p>
            </li>
            <li>
               <p class="para_item">If the DATABLK keyword is specified and PARAM is not specified, then only data blocks may be loaded.  If the PARAM keyword is specified and DATABLK is not specified, then only parameters may be loaded.  If neither DATABLK nor PARAM is specified, then all data blocks and parameters may be loaded. </p>
            </li>
            <li>
               <p class="para_item">The DB keyword is equivalent to DATABLK, and the PARM keyword is equivalent to PARAM. </p>
            </li>
            <li>
               <p class="para_item">The database to be loaded is attached as read-only.  In other words, items can only be fetched and not stored on this database. </p>
            </li>
            <li>
               <p class="para_item">If more than one DBLOAD statement is specified, then the statements will be processed in the order in which they appear.  If a duplicate data block or parameter is found on two or more different DBLOAD statements, then the last duplicate will be used. </p>
            </li>
            <li>
               <p class="para_item">If NEUTRAL is specified, then the FORMATTED keyword must be specified on the corresponding ASSIGN statement. </p>
            </li>
            <li>
               <p class="para_item">If a data block or parameter is being renamed, then the new name must be defined in the NDDL of the primary database. </p>
            </li>
            <li><a name="refQAvi22fjuli"></a><p class="para_item">If the database to be loaded and the primary database have different NDDL schemes and CONVERT is not used, then the following is performed: </p>
               <ul>
                  <li>
                     <p class="para_item">If a qualifier in the NDDL of the database to be loaded is not in the NDDL of the primary database, then all of its values are converted to the null value corresponding to its type.  For example, if the qualifier is integer, real, double-precision, complex or character, then the value is converted to 0, 0., 0.D0, (0.,0.), or blank, respectively.  If this conversion results in a duplicate data block(s) or parameter(s), then a User Warning Message is printed and the duplicates are not loaded. </p>
                  </li>
                  <li>
                     <p class="para_item">If a DBset-name in the NDDL of the database to be loaded is not in the NDDL of the primary database, then its values will be converted to the PARAM default value in the NDDL of the database to be loaded. </p>
                  </li>
               </ul>
            </li>
            <li>
               <p class="para_item">Data blocks that are equivalenced on the database to be loaded remain equivalenced as long as they are loaded in the same DBLOAD statement or in consecutive DBLOAD statements with the same unit number.  Otherwise, a separate copy is produced for the secondary data block. </p>
            </li>
            <li>
               <p class="para_item">It is not possible to restart from a database created by DBLOAD in the same run. </p>
            </li>
            <li>
               <p class="para_item">SOL 190 (or DBTRANS) is also required with DBLOAD if: </p>
               <ul>
                  <li>
                     <p class="para_item">The database to be loaded has a different BUFFSIZE. </p>
                  </li>
                  <li>
                     <p class="para_item">The database to be loaded is in neutral format or is being transferred between different machine types. </p>
                     <p class="para_item">See also <a class="links" href="javascript:void(0)" onclick="top.popUpPage('User/index.html?goto=User/18ref15962_8.html&vars=-aux,-home','linkInter','menubar=yes,status=yes,resizable=yes,toolbar=yes,scrollbars=yes,location=no,directories=no');return(false);">&ldquo;Migrating Databases&rdquo; </a>in the <em>NX Nastran User&rsquo;s Guide</em>. 
                     </p>
                  </li>
               </ul>
            </li>
         </ol>
      </div>
   </body>
</html>
