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

<root>
  <func>


    <title>cnc_rdmagazine</title>



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



    <doc>
        <cmn>
            <p>
                Reads the registered Tool management data number from 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 reads the Tool management data number from 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 reading data for reading from the Magazine management table.
                            Set the number of the reading data(1...) to the pointed data before calling this function.
                        </p>
                        <p>
                            After the execution of this function, *data_num holds the real read number of data.
                        </p>
                    </content>
                </item>
                <item>
                    <name>mag</name>
                    <type>in/out</type>
                    <content>
                        <p>
                            Specify the pointer to IODBTLMAG structure including the Tool management data number to be read.
                            The IODBTLMAG structure is as follows.
<pre>
typedef struct  iodbtlmag {
    short magazine;     /* magazine number */
    short pot;          /* pot number */
    sshort 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>when this function terminates normally, tool management data number is returned.
                                    management data number is returned.<br/>
                                </dd>
                                <dd>(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>
                </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>
    </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">
                <dl>
                    13220 (valid number of Tool management data)<br/>
                    13222 (number of data for the 1st magazine)<br/>
                    13223 (starting pot number for the 1st magazine)<br/>
                    13227 (number of data for the 2nd magazine)<br/>
                    13228 (starting pot number for the 2nd magazine)<br/>
                    13232 (number of data for the 3rd magazine)<br/>
                    13233 (starting pot number for the 3rd magazine)<br/>
                    13237 (number of data for the 4th magazine)<br/>
                    13238 (starting pot number for the 4th magazine)<br/>
                </dl>
            </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>
            </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_regmagazine</name>
            <file>ToolMng/cnc_regmagazine.htm</file>
        </item>
        <item>
            <name>cnc_delmagazine</name>
            <file>ToolMng/cnc_delmagazine.htm</file>
        </item>
        <item>
            <name>cnc_wrmagazine</name>
            <file>ToolMng/cnc_wrmagazine.htm</file>
        </item>
    </reference>



    <example>
    </example>



  </func>
</root>
