This chapter describes general ITK routines like
ITK_Init which is used to
provide ITK its licence number so that it will not
run in demo mode.

ITK_TCPInfos
provides general information about the TCP/IP layer
available on the machine where ITK is used.

Two new routines have been added in ITKv2 to
provide global information about the currently used
streams ( ITK_TCPGetStrm
) and the TCP/IP layers ( ITK_TCPGlobInfo
).

ITK_Init

Syntax:

result := ITK_Init (licence1;licence2)

Description:

Initialises ITK by giving ITK it's license number.
If the license number is incorrect, ITK will run
automatically in demo
mode .

Warning:

If both license numbers are empty or invalid, ITK will
run in demo mode and beep three times.

Just call this routine once in your application prior
to any other call to ITK , otherwise the "demo dialog"
will show up (the best place to do this is the "Startup"
procedure or the "On Startup" method of 4Dv6).

If you are using ITK in 4D Server's stored procedures,
you will have to call ITK_Init at the beginning of
those procedures (one call to ITK_Init is enough, you don't
need to call it il all stored procedures), otherwise the
"demo dialog" will show up on 4D Server.

Note:

In ITKv1.1 ot ITKv2.0, the secondary license number can
be used in multiplatform applications. In that case, you can
pass both Mac and Windows license numbers in one ITK_Init
call.

In ITKv2.5, the secondary license number is used to pass
the SSL server license number. For SSL servers, you must
pass both license numbers: the ITK Pro license
number as the first parameter, and the SSL server license
number in the second parameter.

Here is the format of ITK license numbers since ITKv1.0:

v1.x = 4 letters + numbers

v2.0 = 5 letters + numbers

v2.5 & 2.6 = 4 letters + numbers + 1 letter

Params:

In/Out

Parameter

Type

Example or note

->

licence1

String

First licence number

For ITKv2.5, pass your ITK "Light" or ITK
"Pro" license number (starting by ITKL or ITKP).

Under OpenTransport, returns OpenTransport's
version code. OpenTransport version codes are
values returned by Gestalt selector 'otvr' with
Apple's standard version format.
$MMmrssbb (in hexadecimal) where:

MM = major version number

m = minor version number

r = release version number

ss = stage code ($20 = dev, $40 = alpha, $60
= beta, $80 = Final)

bb = build number

For example, OpenTransport 1.1 returns 17858560
decimal, which is $01108000 in hexadecimal so this
is version 1.1F.