<!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>DBUNLOAD</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">DBUNLOAD </div>
      <hr noshade="true">
      <h4 class="refClassification">Unload a Database to a FORTRAN File </h4>
      <p class="para_refTopic">Stores data blocks or parameters from the primary database onto a FORTRAN file in a binary or neutral format, for purposes of database compression or database transfer between different computers. </p>
      <div class="title_refCategory">Format: </div>
      <div class="refCategoryContent">
         <p align="center"><img align="bottom" src="graphics/fms-ufig12.gif"></p>
      </div>
      <div class="title_refCategory">Examples: </div>
      <div class="refCategoryContent">
         <ol type="1" start="1">
            <li>
               <p class="para_item">Unload the database in ASCII format onto FORTRAN unit 12. </p>
               <table width="100%" align="center">
                  <colgroup span="1">
                     <col span="1" width="17*">
                     <col span="1" width="79*">
                  </colgroup>
                  <tbody>
                     <tr>
                        <td align="left" colspan="1" rowspan="1" valign="top"><pre class="indent">DBUNLOAD</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">DBUNLOAD=&rsquo;physical file name of 
FORTRAN unit 12&rsquo;</pre><pre class="indent">UNIT=12 FORMATTED</pre></td>
                     </tr>
                  </tbody>
               </table><br></li>
            <li>
               <p class="para_item">Unload version 1 of KAA under project FRONT BUMPER. </p>
               <table width="100%" align="center">
                  <colgroup span="1">
                     <col span="1" width="19.54*">
                     <col span="1" width="80.46*">
                  </colgroup>
                  <tbody>
                     <tr>
                        <td align="left" colspan="1" rowspan="1" valign="top"><pre class="indent">DBUNLOAD</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)</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">DBUNLOAD=&rsquo;physical file name of 
FORTRAN unit 50&rsquo;</pre><p class="para_td"> </p>
                        </td>
                     </tr>
                  </tbody>
               </table><br></li>
         </ol>
      </div>
      <div class="title_refCategory">Describers:</div>
      <div class="refCategoryContent">
         <table cellpadding="10" cellspacing="" width="100%">
            <colgroup span="1">
               <col span="1" width="21.90*">
               <col span="1" width="78.10*">
            </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. </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. </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">Logical expression which specifies the desired values of qualifiers, PROJECT, VERSION, and DBSET.  For example, WHERE(VERSION=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 primary database. </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 to unload the database.  The unit must be specified on an ASSIGN statement, which references its physical filename.  The default is 50. </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 may be unloaded in BINARY or NEUTRAL format. BINARY indicates the database is to be unloaded in binary or FORTRAN unformatted.  NEUTRAL indicates the database is to be unloaded in ASCII format.  The default is BINARY. </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">NOREWIND REWIND</p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">By default, if DBUNLOAD is executed more than once for the same unit, then the unit is not rewound.  REWIND requests that the unit be rewound prior to unloading. </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 DBUNLOAD 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;</a> in the <em>NX Nastran User&rsquo;s Guide</em>. 
               </p>
            </li>
            <li>
               <p class="para_item">If the DATABLK keyword is specified and PARAM is not specified, then only data blocks may be unloaded.  If the PARAM keyword is specified and DATABLK is not specified, then only parameters may be unloaded.  If neither DATABLK nor PARAM is specified, then all data blocks and parameters may be unloaded. </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">If more than one DBUNLOAD statement is specified, then the statements will be processed in the order in which they appear. </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 NEUTRAL is specified, then only data blocks with an NDDL description are unloaded.  (See the <a class="links" href="javascript:void(0)" onclick="top.popUpPage('QRG/linkInter_target_not_resolved.html#dmap:ref86112:-aux,-home','linkInter','menubar=yes,status=yes,resizable=yes,toolbar=yes,scrollbars=yes,location=no,directories=no');return(false);"><em>NX Nastran DMAP Programmer&rsquo;s Guide</em></a> under the DATABLK statement.)  An NDDL description is required for TYPE=TABLE and none is required for TYPE=MATRIX.  The data block must be unloaded in BINARY if TYPE=UNSTRUCTURED, KDICT, or KELM. 
               </p>
            </li>
            <li>
               <p class="para_item">Data blocks that are equivalenced on the primary database remain equivalenced as long as they are unloaded in the same DBUNLOAD statement or in consecutive DBUNLOAD statements with the same unit number.  Otherwise, a separate copy for the secondary data block is produced. </p>
            </li>
         </ol>
      </div>
   </body>
</html>
