Okuma America Corporation

THINC-API
Release Notes for Lathe

Document No.: S5015-008-29

THINC-API Version: S5015-008-29
Release Notes For Lathe Date: 02/26/2019

Revision History
Date Version Description Author
5/21/2007 S5015-008-00 Public release for Lathe THINC-API LHuynh
version 1.0.0.0
6/04/2007 S5015-008-01 Public release for Lathe THINC-API Lhuynh
version 1.1.0.0
08/15/2007 S5015-008-02 Public release for Lathe THINC-API Lhuynh
version 1.2.0.0
2/22/2008 S5015-008-03 Public Release 1.6.0.0 for Lathe Lhuynh
THINC-API
4/11/2008 S5015-008-04 Public Release 1.6.0.0 for Lathe Lhuynh
THINC-API
06/27/2008 S5015-008-05 Public Release 1.6.3.0 for Lathe Lhuynh
THINC-API
07/25/2008 S5015-008-06 Public Release 1.6.4.0 for Lathe Lhuynh
THINC-API
10/27/2008 S5015-008-07 Public Release 1.7.0.0 for Lathe Lhuynh
THINC-API
12/18/2008 S5015-008-08 Public Release 1.8.0.0 for Lathe Lhuynh
THINC-API
04/30/2009 S5015-008-09 Public Release 1.9.1.0 for Lathe Lhuynh
THINC-API
10/12/2009 S5015-008-10 Public Release 1.10.0.0 for Lathe Lhuynh
THINC-API
04/28/2010 S5015-008-11 Public Release 1.11.0.0 for Lathe Lhuynh
THINC-API
09/14/2010 S5015-008-12 Public Release 1.11.1.0 for Lathe Lhuynh
THINC-API
01/04/2011 S5015-008-13 Public Release 1.12.0.0 for Lathe Lhuynh
THINC-API
02/02/2011 S5015-008-14 Public Release 1.12.1.0 for Lathe Lhuynh
THINC-API
11/14/2011 S5015-008-15 Beta Release 1.14.0.0 for Lathe Lhuynh
THINC-API
01/15/2012 S5015-008-16 Beta Release 1.14.1.0 for Lathe Lhuynh
THINC-API
09/21/2012 S5015-008-17 Beta Release 1.14.2.0 for Lathe Lhuynh
THINC-API
12/04/2012 S5015-008-18 Public Release 1.15.0.0 for Lathe Lhuynh
THINC-API

THINC-API Release notes Okuma America Corporation, Page 2 of 10

2019
THINC-API Version: S5015-008-29
Release Notes For Lathe Date: 02/26/2019

03/06/2013 S5015-008-19 Beta Release 1.15.1.0 for Lathe Lhuynh

THINC-API
03/18/2013 S5015-008-20 Beta Release 1.15.2.0 for Lathe Lhuynh
THINC-API
09/25/2013 S5015-008-21 Public Release 1.16.0.0 for Lathe Lhuynh
THINC-API
01/15/2014 S5015-008-22 Public Release 1.17.0.0 for Lathe Lhuynh
THINC-API
04/01/2014 S5015-008-23 Public Release 1.17.1.0 for Lathe Lhuynh
THINC-API
10/08/2014 S5015-008-24 Public Release 1.17.2.0 for Lathe Lhuynh
THINC-API
10/18/2015 S5015-008-25 Public Release 1.18.0.0 for Lathe Lhuynh
THINC-API
10/18/2016 S5015-008-26 Public Release 1.19.0.0 for Lathe Lhuynh
THINC-API
12/07/2017 S5015-008-27 Public Release 1.20.0.0 for Lathe Lhuynh
THINC-API
06/14/2018 S5015-008-28 Public Release 1.21.1.0 for Lathe Lhuynh
THINC-API
02/26/2019 S5015-008-29 Public release 1.22.0.0 for Lathe Lhuynh
THINC-API

THINC-API Release notes Okuma America Corporation, Page 3 of 10

2019
THINC-API Version: S5015-008-29
Release Notes For Lathe Date: 02/26/2019

Table of Contents
1. Introduction 5
1.1 Disclaimer of Warranty 5
1.2 Purpose 5
1.3 Scope 5
1.4 Definitions, Acronyms, and Abbreviations 5
1.5 References 5

2. About This Release 5

3. Features 8
3.1 Command API 8
3.2 DATA-API 8

4. Known Bugs and Limitations 9

4.1 Defect 9
4.1.1 General Defect 9
4.1.2 Firebird Database Log File 9
4.1.3 Data-API 9
4.2 Defects Fixed in this Release 10
4.2.1 DATA-API 10

THINC-API Release notes Okuma America Corporation, Page 4 of 10

2019
THINC-API Version: S5015-008-29
Release Notes For Lathe Date: 02/26/2019

Release Notes for Lathe

1. Introduction
1.1 Disclaimer of Warranty
Okuma America Corporation makes no representations or warranties, either expressed or implied, by or with respect to
anything in this document, and shall not be liable for any implied warranties of merchantability or fitness for a particular
purpose or for any indirect, special or consequential damages.

Copyright © 2019, Okuma America Corporation.

All rights reserved.

GOVERNMENT RIGHTS LEGEND: Use, duplication or disclosure by the U.S. Government is subject to restrictions set
forth in the applicable Okuma America Corporation license agreement and as provided in DFARS 227.7202-1(a) and
227.7202-3(a) (1995), DFARS 252.227-7013(c)(1)(ii) (Oct 1988), FAR 12.212(a) (1995), FAR 52.227-19, or FAR 52.227-
14, as applicable.

"Okuma America Corporation" and Okuma America Corporation’s products are trademarks of Okuma America
Corporation. References to other companies and their products use trademarks owned by the respective companies and
are for reference purpose only.

1.2 Purpose
The purpose of the Release Notes document is to communicate major new features and changes in this release of the
THINC-API for Lathe libraries. It also documents known problems and workarounds.

1.3 Scope
This document describes the Public release version 1.22.0.0 of THINC-API for Lathe.

1.4 Definitions, Acronyms, and Abbreviations

GAC – Global Assembly Cache Windows folder located in ‘C:\WINDOWS\assembly’

1.5 References
None.

2. About This Release

All applications compiled with Beta Release from version 1.15.X.X must be compiled with Public
Release version 1.17.0.0 or higher when it is available.

In current version of THINC-API, some of the existing functions related to ATC, Tool, TailStock, and Chuck Data
from DATA-API or Command API might not function correctly on OSP-P300S (SLP) and OSP-P300L control.

Please refer to the help file for detail usage and compatibility information of each function.
This version requires latest OSP system disk.

From this release and forward, THINC API libraries will check dependency libraries during installation. THINC API
will fail to install if version of dependency OCJ libraries cannot support current version of THINC API.

From this release and forward, API Notifier will delay the checking of API for an approximately of 1 minutes or so
after NC is running. API Notifier service does use Windows Performance Counters service. As a result, API Notifier will
not run correctly if Windows Performance Counters service is not enable. During the installation of THINC-API, Windows
Performance Counters will be reset to 0 in the Windows system registry as shown below:
THINC-API Release notes Okuma America Corporation, Page 5 of 10
2019
THINC-API Version: S5015-008-29
Release Notes For Lathe Date: 02/26/2019

Libraries included in this release for Lathe are compiled with .NET Framework 4.0:
Version of Okuma.CLDATAPI.dll in this release is 3.2.0.0
Version of Okuma.CLCMDAPI.dll in this release is 3.2.0.0
Version of APINotifierService.exe in this release is 1.22.0.0
Version of APINotifierStatus.exe in this release is 1.3.0.0
Version of Okuma.Flexnet.Net4.dll in this release is 1.0.0.0
Version of Okuma.Apilog2.dll in this release is 1.2.0.0

This release requires OCJ custom API version 003W on target machine. THINC-API will verify the existing of OCJ
custom API version before performing the installation.
The PLC system package listed in the table per control type is also required.

OSP PLCS package

P100II/P200 From 110A to 110C
P200A Type1 From 120A to 130A
P200A Type2/P300 From 201B to 201G, or 300A and over

Important: All applications designed with THINC-API libraries must use THINC-API version 1.21.1.0 or higher to
be able to run on Microsoft Windows 10.

The following functions of Okuma.CLDATAPI.dll library will not be available in OSP-P100II control machines:
Classes Interfaces
CMachine OnOffStateEnum GetNCStatus(NCStatusEnum enNCStatus)
CMachine CCurrentAlarm* GetCurrentAlarm()
CIO OnOffStateEnum GetUserTaskIOVariable(IOTypeEnum enIO, Int32 intIndex) ;

THINC-API Release notes Okuma America Corporation, Page 6 of 10

2019
THINC-API Version: S5015-008-29
Release Notes For Lathe Date: 02/26/2019

CIO void SetUserTaskOutputVariable(Int32 intIndex, OnOffStateEnum enValue) ;

CIO OnOffStateEnum GetProtectedUserTaskOutputVariable(Int32 intIndex) ;
CIO void SetProtectedUserTaskOutputVariable(Int32 intIndex, OnOffStateEnum enValue) ;

The following functions of Okuma.CLCMDAPI.dll library will not be available in OSP-P100II control machines:
Classes Interfaces
Sub RegisterToolPot(ByVal intPotNo As Integer, ByVal intToolNo As Integer, ByVal
CATC enSettingToolKind As SettingToolKindEnum, ByVal enSettingToolSize As
SettingToolSizeEnum, ByVal enReturnMagazine As ReturnMagazineEnum)
Sub SetNextTool(ByVal intToolNo As Integer, ByVal enSettingToolKind As
CATC SettingToolKindEnum, ByVal enSettingToolSize As SettingToolSizeEnum, ByVal
enReturnMagazine As ReturnMagazineEnum)
Sub SetToolInStation(ByVal intToolNo As Integer, ByVal enSettingToolKind As
SettingToolKindEnum, ByVal enSettingToolSize As SettingToolSizeEnum, ByVal
CATC
enReturnMagazine As ReturnMagazineEnum, ByVal enTurretStation As
TurretStationEnum)
CATC Sub UnRegisterToolPot(ByVal intPotNo As Integer)
CProgram CancelMainProgram()
SelectMainProgramRSide(ByVal strMainProgramFileName As String, Optional ByVal
strSubProgramFileName As String = "", Optional ByVal
CProgram
strSystemSubtituteProgramFileName As String = "", Optional ByVal strProgramName As
String = "")
SelectMainProgramLSide(ByVal strMainProgramFileName As String, Optional ByVal
strSubProgramFileName As String = "", Optional ByVal
CProgram
strSystemSubtituteProgramFileName As String = "", Optional ByVal strProgramName As
String = "")
CalcualteToolOffset(ByVal intToolNo As Integer, ByVal enAxisIndex As
CTools OffsetAxisIndexEnum, ByVal enSubSystem As SubSystemEnum, ByVal dblValue As
Double)
AddConstantToolOffset(ByVal intOffsetNo As Integer, ByVal enAxisIndex As
CTools OffsetAxisIndexEnum, ByVal enSubSystem As SubSystemEnum, ByVal enCuttingPosition
As CuttingPositionEnum)
AddConstantNoseRadiusCompensation(ByVal intOffsetNo As Integer, ByVal enAxisIndex
CTools As OffsetAxisIndex2Enum, ByVal enSubSystem As SubSystemEnum, ByVal
enCuttingPosition As CuttingPositionEnum)
AddConstantToolWear(ByVal intOffsetNo As Integer, ByVal enAxisIndex As
CTools OffsetAxisIndex2Enum, ByVal enSubSystem As SubSystemEnum, ByVal enCuttingPosition
As CuttingPositionEnum)
SubtractConstantToolOffset(ByVal intOffsetNo As Integer, ByVal enAxisIndex As
CTools OffsetAxisIndexEnum, ByVal enSubSystem As SubSystemEnum, ByVal enCuttingPosition
As CuttingPositionEnum)
SubtractConstantNoseRadiusCompensation(ByVal intOffsetNo As Integer, ByVal
CTools enAxisIndex As OffsetAxisIndex2Enum, ByVal enSubSystem As SubSystemEnum, ByVal
enCuttingPosition As CuttingPositionEnum)
SubtractConstantToolWear(ByVal intOffsetNo As Integer, ByVal enAxisIndex As
CTools OffsetAxisIndex2Enum, ByVal enSubSystem As SubSystemEnum, ByVal enCuttingPosition
As CuttingPositionEnum)
CProgram SelectScheduleProgramLSide(ByVal strScheduleProgramFileName As String)
CProgram SelectScheduleProgramRSide(ByVal strScheduleProgramFileName As String)
CMachine Public Sub SetUserAlarm(ByVal enAlarm As UserAlarmEnum, Optional ByVal
THINC-API Release notes Okuma America Corporation, Page 7 of 10
2019
THINC-API Version: S5015-008-29
Release Notes For Lathe Date: 02/26/2019

strAlarmMessage As String = "", Optional ByVal enUserAlarmSubSystem As

UserAlarmSubSystemEnum = 0)
Public Sub ClearUserAlarmD(ByVal enUserAlarmSubSystem As
CMachine
UserAlarmSubSystemEnum)

Note: User Alarm will require OKUMA.Lathe.UserAlarm license feature in order to function on OSP-P200 or newer
controls if machine can support.

3. Features
Please refer to the help file for detail information of each function.

3.1 Command API

States Controls Classes Interfaces

P300L Public Sub ToolDataInput (intToolNo As Integer,

NEW CATC
P300S strFolderPath As String, blnOverwrite As Boolean)

P300L Public Sub ToolDataOutput (intToolNo As Integer,

NEW CATC
P300S strFolderPath As String, blnOverwrite As Boolean)

3.2 DATA-API

States Controls Classes Interfaces

P200L Public Function GetUserTaskIOVariable (enIO
CHANGE P300L CIO As IOTypeEnum, intIndex As Integer) As
P300S OnOffStateEnum
P200L Public Function
CHANGE P300L CIO GetProtectedUserTaskOutputVariable (intIndex
P300S As Integer) As OnOffStateEnum

P200L Public Sub

CHANGE P300L CIO GetProtectedUserTaskOutputVariable (intIndex
P300S As Integer, enValue As OnOffStateEnum)

P200L Public Sub SetUserTaskOutputVariable (

CHANGE P300L CIO intIndex As Integer, enValue As
P300S OnOffStateEnum)

THINC-API Release notes Okuma America Corporation, Page 8 of 10

2019
THINC-API Version: S5015-008-29
Release Notes For Lathe Date: 02/26/2019

Public Function GetToolPositionComment (

intToolNo As Integer, enEdgeNo As
NEW P300S CTOOLS
ToolEdgeEnum, enToolCuttingPosition As
ToolCuttingPositionEnum) As String

4. Known Bugs and Limitations

This section identifies known problems in this release and describes any work-arounds.

4.1 Defect

4.1.1 General Defect

DATA-API library, Okuma.CLDATAPI.dll, cannot create directly under ASP.NET web application.
Solution/Work-arounds: Create and initialize DATA-API in a separate thread. All function calls must be called from
objects created inside separated thread mentioned above.
DATA-API library can only support applications designed with single-threaded apartment of COM threading model. The
underlying library, LDATAPI.dll, cannot be loaded during call to CMachine.Init function when an MTAThread attribute is
applied to the application.
Solution/Work-arounds: None

4.1.2 Firebird Database Log File

THINC-API libraries compiled with .NET Framework 1.1 use Firebird Database engine. The log file created by Firebird
database engine can be corrupted, unexpectedly.

Solution/Work-arounds: A bat file is created during the installation of THINC-API and will be executed every time
Windows is first started to replace the existing log.fdb located in “D:\Program files\Okuma\LoggingService” to prevent file
corruption.

New THINC-API libraries that compiled with .NET Framework 4.0 will use SQLite database for its logging service. All
applications should use new version THINC-API if possible to prevent using Firebird database and to be compatible with
Windows 10.

4.1.3 Data-API

4.1.3.1 MacMan.COperationHistory class

Function:
Int32 COperation* GetOperationHistory(Int32 intIndex) ;
ArrayList* GetOperationHistory(Int32 intFromIndex, Int32 intToIndex);
Int32 GetMaxCount() ;
Int32 GetCount() ;

Symptom: Failed to get correct data for Subsystem L and R side if MacMan screen is different than
current setting of subsystem. It always gets the data from current MacMan screen.

THINC-API Release notes Okuma America Corporation, Page 9 of 10

2019
THINC-API Version: S5015-008-29
Release Notes For Lathe Date: 02/26/2019

Solution/Work around: None

4.1.3.2 CAxis class

Function:
Double GetActualPositionProgramCoord( AxisIndex1Enum enAxisIndex);
Double GetTargetPosition (AxisIndex1Enum enAxisIndex);

Symptom: The Z-axis position for sub system NC-AL and NC-AR does not return data correctly. It is based on the current
selection of spindle in NC panel or command program G140/G141.
Solution/Work around: None

4.2 Defects Fixed in this Release

4.2.1 DATA-API
Symptom: All functions that can support data unit in metric or inch will not add decimal value correctly when the decimal
value is 0.0001or 0.00001 inches.

4.2.1.1 CATC class

Symptom: Cannot support ATC having more than 200 pots.
The following functions are fixed to support ATC magazine having more than 200 pots or Extended ATC magazine spec
PLC3(72,7) ON:

Public Function GetToolNo(intPotNo As Integer) As Integer

Public Function GetToolKind (intPotNo As Integer) As ToolKindEnum
Public Function IsReservedPot (intPotNo As Integer) As Boolean
Public Function GetNextTool As ToolProperty
Public Function GetToolInStation (enTurretStation As TurretStationEnum) As ToolProperty
Public Function GetToolSize (intPotNo As Integer) As ToolSizeEnum

4.2.1.2 CTool class

Public Sub SetToolNumberInGroup3 (
intGroupNo As Integer,
intToolNo As Integer,
enEdgeNo As ToolEdgeEnum
)

Symptom: The function will not set the select group correctly when multi-edges tool spec is 12 or 4.

THINC-API Release notes Okuma America Corporation, Page 10 of 10

2019