<!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>INIT</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">INIT </div>
      <hr noshade="true">
      <h4 class="refClassification">Create a DBset </h4>
      <p class="para_refTopic">Creates a temporary or permanent DBset.  For the SCRATCH and MASTER DBsets, all or some of their space may be allocated to real memory. </p>
      <div class="title_refCategory">Format 1:</div>
      <div class="refCategoryContent">
         <p class="para_refCategory">Initialize any DBset except MASTER and SCRATCH:</p>
         <p class="para_refCategory">INIT     DBset-name     [ LOGICAL=(log-namei(max-sizei),...)</p>
         <p class="para_refCategory">BUFFSIZE=b     CLUSTER=c ]</p>
      </div>
      <div class="title_refCategory">Format 2:</div>
      <div class="refCategoryContent">
         <p class="para_refCategory">Initialize the MASTER DBset:</p>
         <p align="left"><img align="bottom" src="graphics/fms-ufig13.gif"></p>
         <p class="para_refCategory">BUFFSIZE = b   CLUSTER = c </p>
      </div>
      <div class="title_refCategory">Format 3:</div>
      <div class="refCategoryContent">
         <p class="para_refCategory">Initialize the SCRATCH DBset:</p>
         <p align="left"><img align="bottom" src="graphics/fms-ufig14.gif"></p>
         <p class="para_refCategory">SCR300 = (log-namei(max-sizei),...)   BUFFSIZE = b   CLUSTER=c  ] </p>
      </div>
      <div class="title_refCategory">Examples: </div>
      <div class="refCategoryContent">
         <ol type="1" start="1">
            <li>
               <p class="para_item">Modify the default allocation of the DBALL DBset to 50000 blocks. </p><pre class="indent">INIT DBALL LOGI=(DBALL(50000))</pre></li>
            <li>
               <p class="para_item">Do not allocate any real memory for the MASTER and SCRATCH DBsets. </p>
               <table width="100%" align="center">
                  <colgroup span="1">
                     <col span="1" width="28.25*">
                     <col span="1" width="71.75*">
                  </colgroup>
                  <tbody>
                     <tr>
                        <td align="left" colspan="1" rowspan="1" valign="top"><pre class="indent">INIT</pre></td>
                        <td align="left" colspan="1" rowspan="1" valign="top"><pre class="indent">MASTER(NORAM)</pre></td>
                     </tr>
                     <tr>
                        <td align="left" colspan="1" rowspan="1" valign="top"><pre class="indent">INIT</pre></td>
                        <td align="left" colspan="1" rowspan="1" valign="top"><pre class="indent">SCRATCH(NOMEM)</pre></td>
                     </tr>
                  </tbody>
               </table><br></li>
            <li>
               <p class="para_item">Create a new DBset called DBUP with two members DBUP1 and DBUP2. </p>
               <table width="100%" align="center">
                  <colgroup span="1">
                     <col span="1" width="25.95*">
                     <col span="1" width="74.05*">
                  </colgroup>
                  <tbody>
                     <tr>
                        <td align="left" colspan="1" rowspan="1" valign="top"><pre class="indent">INIT</pre></td>
                        <td align="left" colspan="1" rowspan="1" valign="top"><pre class="indent">DBUP LOGI=(DBUP1, DBUP2)</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">DBUP1 =&rsquo;physical filename 1&rsquo;</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">DBUP2=&rsquo;physical filename 2&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="27*">
               <col span="1" width="71*">
            </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">dbset-name <br>MASTER <br>SCRATCH 
                     </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">The name of a temporary or permanent DBset. </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">log-namei </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">Specifies the logical name of a DBset member.  log-namei may also be referenced on an ASSIGN statement, which refers to the physical file name of the DBset member.  If no log-namei is specified, then the DBset will have one member and the log-name will be the same as the DBset-name.  A maximum of twenty log-names may be specified.  For the SCRATCH DBset see also Remark <a class="links" href="javascript:void(0)" onclick="top.openFile('QRG/03ref33329_24.html#ref26433');return(false);">36-8. </a> SCR300 is a special keyword that indicates that the log-names are members reserved for DMAP module internal scratch files. 
                     </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">max-sizei </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">Specifies the maximum size, in blocks, words, or bytes, of a DBset member.  For storage units specified in words or bytes, the size must be followed by one of the unit keywords below. </p>
                     <table border="1" width="100%" align="center">
                        <colgroup span="1">
                           <col span="1" width="42.69*">
                           <col span="1" width="57.31*">
                        </colgroup>
                        <thead>
                           <tr>
                              <th colspan="1" rowspan="1">
                                 <p class="para_th"><b class="uiTerm">Unit Keyword </b></p>
                              </th>
                              <th colspan="1" rowspan="1">
                                 <p class="para_th"><b class="uiTerm">Storage Unit </b></p>
                              </th>
                           </tr>
                        </thead>
                        <tbody>
                           <tr>
                              <td align="left" colspan="1" rowspan="1" valign="top">
                                 <p class="para_td">KW </p>
                              </td>
                              <td align="left" colspan="1" rowspan="1" valign="top">
                                 <p class="para_td">Kilowords (1024) </p>
                              </td>
                           </tr>
                           <tr>
                              <td align="left" colspan="1" rowspan="1" valign="top">
                                 <p class="para_td">KB </p>
                              </td>
                              <td align="left" colspan="1" rowspan="1" valign="top">
                                 <p class="para_td">Kilobytes (1024) </p>
                              </td>
                           </tr>
                           <tr>
                              <td align="left" colspan="1" rowspan="1" valign="top">
                                 <p class="para_td">MW </p>
                              </td>
                              <td align="left" colspan="1" rowspan="1" valign="top">
                                 <p class="para_td">Megawords (1048576) </p>
                              </td>
                           </tr>
                           <tr>
                              <td align="left" colspan="1" rowspan="1" valign="top">
                                 <p class="para_td">MB </p>
                              </td>
                              <td align="left" colspan="1" rowspan="1" valign="top">
                                 <p class="para_td">Megabytes (1048576) </p>
                              </td>
                           </tr>
                           <tr>
                              <td align="left" colspan="1" rowspan="1" valign="top">
                                 <p class="para_td">GB </p>
                              </td>
                              <td align="left" colspan="1" rowspan="1" valign="top">
                                 <p class="para_td">Gigabytes (1073741824) </p>
                              </td>
                           </tr>
                           <tr>
                              <td align="left" colspan="1" rowspan="1" valign="top">
                                 <p class="para_td">GW </p>
                              </td>
                              <td align="left" colspan="1" rowspan="1" valign="top">
                                 <p class="para_td">Gigawords (1073741824) </p>
                              </td>
                           </tr>
                        </tbody>
                     </table><br><p class="para_td">For example, 100MB is 100 megabytes.  The size of a block in words is defined by BUFFSlZE. The default for DBALL and SCRATCH is 250,000 blocks. </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">RAM<br>NORAM 
                     </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">RAM=r requests that r words of real memory are to be allocated for the MASTER DBset. The default is RAM or RAM=30000.  NORAM or RAM=0 specifies no real memory is to be allocated. </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">S </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">If the primary database is being created in the run, this option requests that all DBsets in the primary database will be automatically deleted at the end of the run.  INIT MASTER(S) is equivalent to specifying scr = yes on the &ldquo;nastran&rdquo; command.  See the <a class="links" href="javascript:void(0)" onclick="top.openFile('QRG/02ref95657_1.html');return(false);">&ldquo;nastran Command and NASTRAN Statement&rdquo; </a>. If the run is a restart, then this option is ignored. 
                     </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">MEM<br>NOMEM 
                     </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">MEM=m specifies that m blocks of real memory are to be allocated for the SCRATCH DBset. The default m is machine dependent and may be found in the <em>NX Nastran Installation and Operations Guide.</em>  NOMEM or MEM = 0 requests that no real memory is to be allocated. 
                     </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">BUFFSlZE </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">BUFFSlZE = b specifies the number of words per block in the DBset and will override the value specified by the BUFFSlZE keyword on the NASTRAN statement.  The default for b is obtained from the NASTRAN BUFFSIZE statement.  See the <em>NX Nastran Installation and Operations Guide</em>. 
                     </p>
                  </td>
               </tr>
               <tr>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">CLUSTER </p>
                  </td>
                  <td align="left" colspan="1" rowspan="1" valign="top">
                     <p class="para_td">CLUSTER = c specifies the number of blocks per cluster in the DBset.  The default is 1, and any other value is not recommended. </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 INIT statement and its applications are discussed further in <a class="links" href="javascript:void(0)" onclick="top.popUpPage('User/index.html?goto=User/18ref15962_2.html&vars=-aux,-home','linkInter','menubar=yes,status=yes,resizable=yes,toolbar=yes,scrollbars=yes,location=no,directories=no');return(false);">&ldquo;Introduction to Database Concepts&rdquo; </a>in the <em>NX Nastran User&rsquo;s Guide</em>. 
               </p>
            </li>
            <li>
               <p class="para_item">There are four DBsets that are predefined and automatically allocated by the program.  Their DBset-names are MASTER, DBALL, SCRATCH, and OBJSCR, and they are described in <a class="links" href="javascript:void(0)" onclick="top.popUpPage('User/index.html?goto=User/18ref15962_2.html&vars=-aux,-home','linkInter','menubar=yes,status=yes,resizable=yes,toolbar=yes,scrollbars=yes,location=no,directories=no');return(false);">&ldquo;Introduction to Database Concepts&rdquo; </a>in the <em>NX Nastran User&rsquo;s Guide</em>. 
               </p>
            </li>
            <li>
               <p class="para_item">On all computers with dynamic file allocation, the physical filename of a DBset member may specified on an ASSIGN statement: </p><pre class="indent">ASSIGN log-name=&rsquo;physical filename&rsquo;</pre><p class="para_item">If an ASSIGN statement is not specified for the member, then a name is automatically assigned. </p>
            </li>
            <li>
               <p class="para_item">It is recommended that there be sufficient physical space to hold a DBset member should it reach its maximum size (max-sizei).  The max-sizei may be converted to words by multiplying by b.  A summary of space usage and allocation is printed at the end of the Execution Summary Table. </p>
            </li>
            <li>
               <p class="para_item">In restart runs, the INIT statement is ignored for preexisting permanent DBsets.  The INIT statement is intended to be specified only in the run in which the DBset is being created.  If more DBset members need to be added to the DBset, then the EXPAND statement is used. </p>
            </li>
            <li>
               <p class="para_item">If RAM or RAM = r is specified and the run terminates because the computer operating system detects insufficient space or time or the computer halts due to a power outage or operator interruption, then it may not be possible to restart from the database.  See the DBUPDATE FMS statement. </p>
            </li>
            <li>
               <p class="para_item">BUFFSIZE = b and CLUSTER = c must satisfy the following inequality: </p>
               <p align="center"><img align="bottom" src="graphics/fms-equ01.gif"></p>
            </li>
            <li><a name="ref26433"></a><p class="para_item">By default, the SCRATCH DBset is divided into two partitions: LOGICAL and SCR300.  The LOGICAL partition, log-names after the LOGICAL keyword, are reserved for DMAP scratch data blocks and the SCR300 partition for DMAP module internal scratch files. </p>
               <ul>
                  <li>
                     <p class="para_item">The maximum total number of log-names for LOGICAL and SCR300 is 20.  For example, if LOGICAL has 8 log-names, then SCR300 can have no more than 12 log-names. </p>
                  </li>
                  <li>
                     <p class="para_item">If NASTRAN SYSTEM(142) = 1 is specified, then the SCR300 partition is not created and  internal scratch files, along with DMAP scratch data blocks, will reside on the LOGICAL partition.  The default is SYSTEM(142) = 2. </p>
                  </li>
                  <li>
                     <p class="para_item">If NASTRAN SYSTEM(151)=1 is specified and the LOGICAL partition has reached its maximum size, then the SCR300 partition will be used.  The default is SYSTEM(151) = 0. </p>
                  </li>
                  <li>
                     <p class="para_item">By default, the space specified for the SCR300 partition is released to the operating system  after each DMAP module is executed as long as the module used more than 100 blocks for  internal scratch files.  If 100 blocks is not a desirable threshold, then it may be changed by specifying NASTRAN SYSTEM(150) = t, where t is the number of blocks for the threshold. </p>
                  </li>
               </ul>
            </li>
            <li>
               <p class="para_item">BUFFSlZE = b is predefined for DBset-names MSCOBJ, OBJSCR, and USROBJ and may not be changed by BUFFSIZE on this statement or the NASTRAN BUFFSlZE bmax statement. The default for b is recommended for all except very large problems.  bmax must reflect the maximum of b specified for all DBsets attached to the run, including the delivery database.  See <em>NX Nastran Installation and Operations Guide</em> for the defaults of b and bmax. 
               </p>
            </li>
            <li>
               <p class="para_item">If INIT MASTER(RAM = r) and INIT SCRATCH(MEM = m) are specified, then BUFFSIZE for these DBsets must be the same.  If not, a warning message is issued, and the BUFFSlZE for the SCRATCH DBset is reset to that of the MASTER DBset. </p>
            </li>
            <li>
               <p class="para_item">Only one INIT statement per dbset-name may be specified in the File Management Section. </p>
            </li>
         </ol>
      </div>
   </body>
</html>
