Installation instructions for TET on IBM System i
=================================================

This document describes the installation steps for TET on IBM System i
TET can be used with different programming languages as detailed below.

Please observe the notes in the TET manual regarding expected
file formats (EBCDIC text vs. ASCII text vs. binary) for several
items related to TET usage. These rules must strictly be observed
in order to successfully use TET on EBCDIC-based platforms.


Using TET with Java
===================
In order to use TET with Java on IBM System i you need the IT4J Java VM
(32-bit or 64-bit) which is based on PASE for i. PASE is a no-charge option
of IBM i. The TET shared library for Java is not included in the System i
package, but must be taken from the corresponding AIX package.
The binaries for AIX accept IBM System i license keys when running with PASE
on System i.

Depending on your Java VM you need the 32-bit or 64-bit package of PDFlib
for Java, i.e.

TET-x.y-AIX-java.tar.gz
or
TET-x.y-AIX64-java.tar.gz

See http://www.ibm.com/support/docview.wss?uid=nas8N1019917
for determining available Java VMs and switching between versions.

See TET manual for additional Java configuration steps regarding the
TET shared library and .jar file.



Using TET with ILE C/C++ or ILE RPG
====================================

TET for ILE C/C++ and ILE RPG is delivered as a SRVPGM. The respective
INCLUDE/COPY sources are included in the package. PASE is not required.


Step 1: Download and uncompress the package
-------------------------------------------

Download the file TET-x.y-i5-C-C++-RPG.zip. Uncompress this file to your
local hard disk.

Make sure that you have FTP access to your IBM System i and that your user
profile has QSECOFR authority to perform the installation steps.


Step 2: Transfer the TET save file to the IBM System i
------------------------------------------------------

Start a DOS session on your PC, and initiate an FTP session against your
IBM System i executing the following command from your DOS prompt:

      FTP mySystemi

Enter your IBM System i user profile and password for the logon.

Switch over to binary mode by running the FTP command:
        bin

Create a SAVF on your IBM System i by running the FTP command:
        Quote rcmd crtsavf file(qgpl/tet)

Use on your IBM System i a file naming format like on a PC:
   quote site namefmt 1

Adjust the current library:
   cd /qsys.lib/qgpl.lib

Transfer the file TET.SAV to your IBM System i by running the FTP command:
        Put C:\yourlocalpath\tet.sav tet.savf

Exit the FTP session with the FTP command
        Quit


Step 3: Restore the TET library
-------------------------------

You can now restore the TET objects by running the following CL commands:

        CRTLIB LIB(TETLIB)
        RSTOBJ OBJ(*ALL) SAVLIB(TETLIB) DEV(*SAVF) SAVF(QGPL/TET) ALWOBJDIF(*OWNER)


Step 4: Create the IFS directories and resource files
-----------------------------------------------------

After restoring all objects to the TETLIB library, execute the following
CL command to create the IFS directories for TET including all resource files.

        CALL PGM(TETLIB/TETCRTRSC)


Step 5: Verify the installation
-------------------------------

After running all installation steps you should have the following objects
in your TETLIB library:

Object      Type                  Attribute

TET         *PGM      TETLIB      CLE         TET <version> - Command Line Tool
TETCRTRSC   *PGM      TETLIB      CLE         TET <version> - Install IFS Resource
TETLIB      *SRVPGM   TETLIB                  TET <version> - Service Program  
H           *FILE     TETLIB      PF          TET <version> - h include files       
QCSRC       *FILE     TETLIB      PF          TET <version> - c Samples        
QRPGLESRC   *FILE     TETLIB      PF          TET <version> - RPG Samples      
TETLIBRSC   *FILE     TETLIB      SAVF        TET <version> - Resource SAVF    
TETLIB      *BNDDIR   TETLIB                  TET <version> - Binding Directory

In the IFS you should find the following directories:

/PDFlib/TET/x.y/x.y/bind/c
/PDFlib/TET/x.y/x.y/bind/cpp
/PDFlib/TET/x.y/x.y/bind/data
/PDFlib/TET/x.y/x.y/bind/rpg
/PDFlib/TET/x.y/x.y/bind/xslt
/PDFlib/TET/x.y/x.y/connectors
/PDFlib/TET/x.y/x.y/doc
/PDFlib/TET/x.y/x.y/resource
/PDFlib/TET/x.y/resource

PDFlib applications and Teraspace
=================================
TET is Teraspace-enabled, but delivered as SNGLVL. A Teraspace variant can
be made available upon request.