News CNCnetPDM About us Support  
       
  

HANDLE | GENERAL

TOP

Library handle

Top Page


Library handle

At the library for HSSB, to establish the communication with the HSSB Board on CNC side, it is necessary to get the library handle number by cnc_allclibhndl or cnc_allclibhndl2 function.

At the library for Ethernet, to establish the communication with the Ethernet Board on CNC side, it is necessary to get the library handle number and create the TCP/IP connection by passing a CNC's IP address parameter to the cnc_allclibhndl3 function.

Once the library handle number is acquired, it must be held until the application program terminates, because it is necessary to pass the number as an argument to each CNC/PMC Data window library function.

The library handle is owned by the thread that got it. Even if the thread-A which has already got a library handle shows the library handle to another thread-B, the thread-B cannot use that library handle.

It is possible that one thread gets multiple library handles by calling the function for getting the library handle repeatedly. For example, on the 2 path control system, it is possible that the thread on an application gets two library handles for the same CNC (in other words, the same Node or the same IP address) and allocates the individual path to each handle.

If you create some handles for the same IP address, the library creates only one TCP/IP connection per process. This is for saving the resource of the Ethernet Board on the CNC side. So when the connection of one library handle is destroyed by the communication error and TCP/IP connection closes, the connection in other handle is destroyed, too.

When an application program terminates, the library handles must be released by using the cnc_freelibhndl function.



If an application program terminates without releasing the library handle number, the memory area assigned for the management of the handle remains allocated and accumulates. If it is repeated, the library handle number will become unable to be acquired at last.

The outline of processing sequence of an application program is as follows.

Cautions which have to be considered when the power supply on the NC which is connected with PC via HSSB is turned off, are shown below.

  1. Validity of the library handle when power supply on the NC side is turned off

    When the power supply of NC side is turned off after the library handle is acquired, the acquired library handles become invalid. (When multiple NCs are connected via HSSB interface, only the library handle of the NC whose power supply is turned off becomes invalid.)

    If the library function is executed with the invalid library handle, the completion status of EW_HSSB is returned.

    Moreover, when the library function is executed with the invalid library handle after starting up the NC again, the completion status of EW_HANDLE is returned. The library handle which became invalid must be released by the function cnc_freelibhndl().

  2. When the power supply on the NC side is turned off while the library function is being executed

    In this case, the result of the operation under execution is unpredictable. Therefore, the power supply should be turned off after confirming that no library functions are being executed.

    When the power supply on the NC side is turned off while the library is not being executed, the library function becomes executable by acquiring the library handle again after NC is started up.

  3. Specification of cnc_allclibhndl and cnc_allclibhndl2

    If cnc_allclibhndl or cnc_allclibhndl2 is executed while the power supply on the NC side is off, EW_HSSB is returned as the completion status.

    And, if cnc_allclibhndl or cnc_allclibhndl2 is executed immediately after the NC starting up, the completion status EW_BUSY may be returned.

    This means that the initialization of the interface between NC and MMC function is not finished. Retry calling the function until the initialization completes when the completion status is EW_BUSY.

Cautions which have to be considered when the power supply on the NC which is connected with PC via Ethernet is turned off, are shown below.

  1. Validity of the library handle when power supply on the NC side is turned off

    When the power supply of CNC is turned off after the library handle is acquired, the connection is not disabled soon. If the power is turned off, the library cannot detect the disconnection of TCP/IP because TCP/IP reset is not noticed from the Ethernet Board on the CNC side. (This status is called 'half-open' as TCP/IP technical term.)

    After executing the library in the half-open state, the timeout error is occurred at the time which is specified in cnc_allclibhndl3, and then all library handles of the CNC whose power supply has been turned off become invalid.

    If the library function is executed with the invalid library handle while the power supply of the CNC is off, EW_SOCKET is returned as the completion status. The library handle, which became invalid, must be released by the function cnc_freelibhndl. And after CNC is started, the library function becomes available by getting the library handle again.

  2. When the power supply on the CNC side is turned off while the library function is running

    When the power supply on the CNC side is turned off while the library function is running, the result of the operation under execution is not guaranteed.

  3. Specification of cnc_allclibhndl3

    If cnc_allclibhndl3 is executed while the power supply on the NC side is off, EW_SOCKET is returned as the completion status.

    However, the completion status of cnc_allclibhndl3 will be EW_OK for the new library handle, once other library handle has been got by cnc_allclibhndl3 and then the Ethernet connection failed to half-open state by the power off of the CNC.

    If the connection is already created, cnc_allclibhndl3 tries to reuse it. In case of above condition, the connection is created by first cnc_allclibhndl3 calling and 2nd calling tries to attach it to new handle number. Then, the library will create a new connection if the library can detect that connection is reset. But in this case the connection status is half-open and the library cannot detect the close of TCP/IP. So the library will attach the half-open state connection to a new handle and the second handle getting will be succeeded.

    After executing the library in this state, the timeout error will be occurred and the half-open state connection will be closed.


Top Page

Privacy notice

This website uses cookies. By continuing to use it you agree to our privacy policy. 

https://www.inventcom.net/fanuc-focas-library/general/handle

Fanuc Focas Library | General | Fwlib32

FOCAS 1/2 FANUC Open CNC FOCAS1 / FOCAS2 CNC/PMC Data window library FOCAS1/2 :... [read more]
Fanuc Focas Library | General | Fwlib32

Fanuc Focas Library | General | General

General Top Page General Library files... [read more]
Fanuc Focas Library | General | General

Fanuc Focas Library | General | HSSB

Coexistence with... [read more]
Fanuc Focas Library | General | HSSB

Fanuc Focas Library | General | Log

Communication Log Function... [read more]
Fanuc Focas Library | General | Log

Fanuc Focas Library | General | Overview

Outline Top Page Outline CNC/PMC Data Window Library is used for exchanging data and information between a personal computer and the CNC/PMC... [read more]
Fanuc Focas Library | General | Overview

Fanuc Focas Library | General | Protect

FOCAS1/Ethernet NC data protection Top Page NC data protection (160i/180i/210i/0i-B/0i-C/Power Mate i Only) A past... [read more]
Fanuc Focas Library | General | Protect

Fanuc Focas Library | General | Unsol_res

When you use the PMC address for the control parameter(Response method) Top Page When you use the PMC address for the control... [read more]
Fanuc Focas Library | General | Unsol_res

Fanuc Focas Library | General | Unsol_sim1

When you use the PMC address for the control parameter(Simple method)(30i/31i/32i only) Top Page When you use the PMC address for... [read more]
Fanuc Focas Library | General | Unsol_sim1

Fanuc Focas Library | General | Unsol_sim2

When you use the Macro variable for the control parameter(Simple method)(30i/31i/32i only) Top Page When you use the Macro... [read more]
Fanuc Focas Library | General | Unsol_sim2

Fanuc Focas Library | General | Unsolic

FOCAS1/Ethernet Fast Ethernet Unsolicited Messaging Function Top Page Fast Ethernet Unsolicited Messaging Function... [read more]
Fanuc Focas Library | General | Unsolic

Fanuc Focas Library | General | Update

FOCAS1/2 Ethernet HSSB Update History Top Page Update History of FOCAS1/2 Library... [read more]
Fanuc Focas Library | General | Update

Fanuc Focas Library | General | flist_All

CNC: Function Reference related to library handle, node... [read more]
Fanuc Focas Library | General | flist_All

Fanuc Focas Library | General | Dnc1

Communication with Ethernet Board Ethernet version is realized by the socket communication (TCP/IP communication) with FANUC Ethernet Board, or FANUC Fast Ethernet Board. And in... [read more]
Fanuc Focas Library | General | Dnc1

Fanuc Focas Library | General | Errcode

Return Status of Data Window... [read more]
Fanuc Focas Library | General | Errcode
Modified: 2023-12-05