/**********************************************************************/
/*    (c)  Copyright  1990 through 2023 Inglenet Business Solutions   */
/*                 All Rights Reserved                                */
/*                                                                    */
/*  THIS IS PROPRIETARY SOURCE CODE OF  Inglenet Business Solutions   */
/*                                         www.inglenet.com           */
/**********************************************************************/

In 2016 Inglenet let all customers know that TIP/ix support
would be ending December 2021.
Inglenet has recently agreed to extend support until the end of 2022.
(Inglenet is not likely to extend TIP/ix support beyond 2022.)

In order to manage a situation where Inglenet may not provide 
support the source code is being made available to allow
customers to support themselves.

Customers may download the TIP/ix source code if their active 
license key for TIP/ix expires after October 2022.
Customers will continue to require a 'license to use' TIP/ix. 

To obtain the TIP/ix source code you must be running on a 
version of TIP/ix built on or after 2021/05/20.

If your current TIP/ix license is valid to the end of 2022 
then to download the source code run the following command:
    tipctl getsource

This will download and decrypt two compressed tar files:
 tipixsrc.tar.Z    - current TIP/ix source code
 tipixcvs.tar.Z    - CVS repository for TIP/ix source code
This will also download these compressed tar files:
 visam-2.2.tar.Z   - V-ISAM source code 
                     (supports both C-ISAM and VB-ISAM files)
 gnu-cobol.tar.Z   - Source for the GnuCOBOL compiler

*************
*************
       ------ WHAT YOU NEED TO KNOW --------
The TIP/ix source code is about 1.5 million lines of code,
mostly C, some COBOL and a bit of C++.
In order to maintain this software you will need the following knowledge:
  Expert programmer in C, COBOL & C++
  Deep knowledge of Unix/Linux as a systems programmer
  Experience with semaphores, message queues, shared memory, FIFOs, etc..
  Experience with multi-process applications
  Understanding of compiler construction
  Understanding of OLTP including 'two-phase commit'
If you also use TIP/ic then you need experience with 
  HTML, XML, Apache and FastCGI
If you also use TIP/dbi then you need experience with 
  DBA knowledge, Oracle OCI, MySQL, MSSQL, ODBC, EXEC SQL
*************
*************

This remains proprietary source code and the sole property of
Inglenet Business Solutions.

There is NO SUPPORT provided or implied by allowing our customers
access to the source code.

To build the software you will need to set an environment variable
TARGET_OS =
Set this to the system type being used to build on
The various make.XXXX files define options for each such system

D-ISAM
======
In addition customers may need to acquire a source code license for 
D-ISAM from www.isamcentral.com. D-ISAM works with C-ISAM format files.
This is the ISAM handler used by TIP/ix and is the format of the various
TIP/ix control files and is also the format used by Micro Focus COBOL.
However, this is proprietary source code and not released as part of
the TIP/ix source code.

V-ISAM 2.2
===========
An alternative to purchasing D-ISAM is to build V-ISAM with 
  --enable-cisamcompat and use that. 
V-ISAM can handle both C-ISAM and VB-ISAM format files and
automatically recognizes the file format at runtime.
 (See scripts/buildisam for hints on building this.)

Then to build TIP/ix to use that instead of D-ISAM 
add to the correct make.<system> (eg. make.CENTOS8) the following:
 The key thing to add is  -DTIP_ISAM=22
# Using V-ISAM in C-ISAM mode
DEFS    = -D$(TARGET_OS) -DLINUX $(REDHAT) -DTIP_ISAM=22
LIBISAM = visam
TIPLIBISAM=$(TIPLIB)/lib$(LIBISAM).a
LTIPLIBISAM=$(LTIPLIB)/lib$(LIBISAM).a
PTIPLIBISAM=-l$(LIBISAM) $(TIPLIB)/lib$(LIBISAM).a