<?xml version="1.0" encoding="Shift_JIS"?>
<?xml-stylesheet type="text/xsl" href="../Fmethod_xsl/fmethod_he_c.xsl"?>

<root>
  <func>


    <title>cnc_regmagazine</title>



    <declare>
      <vc>
        <include>#include "fwlib32.h"</include>
        <prottype>FWLIBAPI short WINAPI cnc_regmagazine(unsigned short FlibHndl,short *data_num, IODBTLMAG *mag); </prottype>
      </vc>
    </declare>



    <doc>
        <cmn>
            <p>Registers the Tool management data number to the Magazine management table.</p>
            <p>
                This function searches at the Magazine management table using the magazine number, pot number.
                And if it finds, it writes the Tool management data number to the matched entry.
            </p>
            <p class="xis">
                Note) This function is only for "Fast Ethernet board" and "Embedded Ethernet". 
                So, this function is not supported at "Ethernet board".
            </p>
        </cmn>
    </doc>



    <argument>
        <common>
            <vc>
                <item>
                    <name>FlibHndl</name>
                    <type>in</type>
                    <content>
                        <p>
                            Specify the library handle. See "<a href="handle.htm" target="_parent">Library handle</a>" for details.
                        </p>
                    </content>
                </item>
                <item>
                    <name>data_num</name>
                    <type>in/out</type>
                    <content>
                        <p>
                            Specify the pointer to the number of the registration data for the registration to the Magazine management table.
                            Set the number of the registration data(1...) to the pointed data before calling this function.
                        </p>
                        <p>
                            After the execution of this function, *data_num holds the real registered number of data.
                        </p>
                    </content>
                </item>
                <item>
                    <name>mag</name>
                    <type>in</type>
                    <content>
                        <p>
                            Specify the pointer to IODBTLMAG structure including the Tool management data number to be registered.
                            The IODBTLMAG structure is as follows.
<pre>
typedef struct  iodbtlmag {
    short magazine;     /* magazine number */
    short pot;          /* pot number */
    short tool_index;   /* tool management data number */
} IODBTLMAG;
</pre>
                        <dl>
                            <dt>magazine</dt>
                            <dd>specifies magazine number.</dd>
                            <dd>(Setting range : 1,..,4, 11,..,14, 21,..,24)</dd>
                            <dt>pot</dt>
                            <dd>specifies pot number.</dd>
                            <dd>(Setting range: According to CNC option and CNC parameter)</dd>
                            <dt>tool_index</dt>
                            <dd>specifies tool management data number</dd>
                            <dd>(Setting range: 0,..,65535)</dd>
                        </dl>
                        </p>
                    </content>
                </item>
           </vc>
        </common>
    </argument>



    <errcode>
        <item>
            <name>EW_BUSY</name>
            <content>
                Other users(such as PMC) have accessed the same data window.
                Try this function again.
            </content>
        </item>
        <item>
            <name>EW_DATA</name>
            <content>
                The member in the IODBTLMAG structure is invalid.<br/>
                In order to get more information for this err_no return value,
                execute <a href="Misc/cnc_getdtailerr.htm" target="_parent">cnc_getdtailerr</a > function.
                The following detail status will be set onto the member, err_no of OBDERR structure.
                <table border="0">
                    <tr><td>0</td><td>:</td><td>error except EW_DATA</td></tr>
                    <tr><td>21</td><td>:</td><td>error of magazine number</td></tr>
                    <tr><td>22</td><td>:</td><td>error of pot number</td></tr>
                    <tr><td>23</td><td>:</td><td>error of tool management data number</td></tr>
                </table>
            </content>
        </item>
        <item>
            <name>EW_NOOPT</name>
            <content>
                No option<br/>
                The Tool management function 64 pairs, or the Tool management function 240 pairs, or the Tool management function 1000 pairs.
            </content>
        </item>
        <item>
            <name>EW_PROT</name>
            <content>
                Write protection<br/>
                The Magazine management data table is write protected.
            </content>
        </item>
        <item>
            <name>EW_REJECT</name>
            <content>
                CNC execution rejected<br/>
                This function tries to register the data against the Magazine management data table
                entry which has already existed or interfere with other tool.
            </content>
        </item>
        <item>
            <name>EW_OVRFLOW</name>
            <content>
                Data of multi edge tool has a part of inconsistency on tool management funcion. (only 300i/310i/320i)
            </content>
        </item>
    </errcode>



    <option>
        <hssb>
            <p>The extended driver/library function are necessary.</p>
        </hssb>

        <ethr>
            <p>The Ethernet function and the extended driver/library function are necessary.</p>
            <p>However, in case of Series 160i/180i/210i/0i MODEL B and 300i/310i/320i, the required CNC option is as follows.</p>
            <p>When Embedded Ethernet is used,</p>
            <p><ul>above two optional functions are not required.</ul></p>
            <p>When Ethernet board is used,</p>
            <p><ul>only Ethernet function is required.</ul></p>
        </ethr>
        <need>
            The Tool management function 64 pairs, or the Tool management function 240 pairs, or the Tool management function 1000 pairs.
        </need>

        <is>
            <hssb>
                <p>The extended driver/library function are necessary.</p>
            </hssb>
            <need>
                The Tool management function 64 pairs, or the Tool management function 240 pairs, or the Tool management function 1000 pairs.
            </need>
        </is>
    </option>



    <parameter>
        <type>
            <ul type="disc">
                <table>
                    <tr><td>13220</td><td>(valid number of Tool management data)    </td></tr>
                    <tr><td>13222</td><td>(number of data for the 1st magazine) </td></tr>
                    <tr><td>13223</td><td>(starting pot number for the 1st magazine)    </td></tr>
                    <tr><td>13227</td><td>(number of data for the 2nd magazine) </td></tr>
                    <tr><td>13228</td><td>(starting pot number for the 2nd magazine)    </td></tr>
                    <tr><td>13232</td><td>(number of data for the 3rd magazine) </td></tr>
                    <tr><td>13233</td><td>(starting pot number for the 3rd magazine)    </td></tr>
                    <tr><td>13237</td><td>(number of data for the 4th magazine) </td></tr>
                    <tr><td>13238</td><td>(starting pot number for the 4th magazine)    </td></tr>
                </table><br/>
                13201#3 (It is necessary to use multi edge tool on tool management function.) (only 300i/310i/320i)
            </ul>
        </type>
    </parameter>

    <is_parameter>
        <type>
            <ul>
                <table>
                    <tr><td>13220</td><td>(valid number of Tool management data)    </td></tr>
                    <tr><td>13222</td><td>(number of data for the 1st magazine) </td></tr>
                    <tr><td>13223</td><td>(starting pot number for the 1st magazine)    </td></tr>
                    <tr><td>13227</td><td>(number of data for the 2nd magazine) </td></tr>
                    <tr><td>13228</td><td>(starting pot number for the 2nd magazine)    </td></tr>
                    <tr><td>13232</td><td>(number of data for the 3rd magazine) </td></tr>
                    <tr><td>13233</td><td>(starting pot number for the 3rd magazine)    </td></tr>
                    <tr><td>13237</td><td>(number of data for the 4th magazine) </td></tr>
                    <tr><td>13238</td><td>(starting pot number for the 4th magazine)    </td></tr>
                </table><br/>
                13201#3 (It is necessary to use multi edge tool on tool management function.)
            </ul>
        </type>
    </is_parameter>



    <mode>
    </mode>



    <support>
        <m>
            <fs0ia>X</fs0ia>
            <fs0ib>X</fs0ib>
            <fs15>X</fs15>
            <fs15i>X</fs15i>
            <fs16>X</fs16>
            <fs18>X</fs18>
            <fs21>X</fs21>
            <fs16ia>O</fs16ia>
            <fs18ia>O</fs18ia>
            <fs21ia>O</fs21ia>
            <fs16ib>O</fs16ib>
            <fs18ib>O</fs18ib>
            <fs21ib>O</fs21ib>
            <fs30i>O</fs30i>
        </m>
        <t>
            <fs0ia>X</fs0ia>
            <fs0ib>X</fs0ib>
            <fs15>X</fs15>
            <fs15i>X</fs15i>
            <fs16>X</fs16>
            <fs18>X</fs18>
            <fs21>X</fs21>
            <fs16ia>X</fs16ia>
            <fs18ia>X</fs18ia>
            <fs21ia>X</fs21ia>
            <fs16ib>O</fs16ib>
            <fs18ib>O</fs18ib>
            <fs21ib>O</fs21ib>
            <fs30i>O</fs30i>
        </t>
        <lc>
            <fs0ia>X</fs0ia>
            <fs0ib>X</fs0ib>
            <fs15>X</fs15>
            <fs15i>X</fs15i>
            <fs16>X</fs16>
            <fs18>X</fs18>
            <fs21>X</fs21>
            <fs16ia>X</fs16ia>
            <fs18ia>X</fs18ia>
            <fs21ia>X</fs21ia>
            <fs16ib>X</fs16ib>
            <fs18ib>X</fs18ib>
            <fs21ib>X</fs21ib>
            <fs30i>X</fs30i>
        </lc>
        <p>
            <fs16i>X</fs16i>
            <fs18i>X</fs18i>
        </p>
        <l>
            <fs16i>X</fs16i>
            <fs18i>X</fs18i>
        </l>
        <w>
            <fs16i>X</fs16i>
            <fs18i>X</fs18i>
        </w>
        <pw>
            <d>X</d>
            <h>X</h>
        </pw>
        <is>
            <m>
                <fs30is>O</fs30is>
            </m>
            <t>
                <fs30is>O</fs30is>
            </t>
        </is>
    </support>



    <reference>
        <item>
            <name>cnc_delmagazine</name>
            <file>ToolMng/cnc_delmagazine.htm</file>
        </item>
        <item>
            <name>cnc_rdmagazine</name>
            <file>ToolMng/cnc_rdmagazine.htm</file>
        </item>
        <item>
            <name>cnc_wrmagazine</name>
            <file>ToolMng/cnc_wrmagazine.htm</file>
        </item>
    </reference>



    <example>
    </example>



  </func>
</root>
