Installation instructions for TETlib on AS/400
==============================================

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


TETlib is delivered as a SRVPGM for the AS/400 which works with
any ILE language. The respective INCLUDE/COPY sources for
ILE/RPG and ILE/C are included in the package.

Note: PASE is not required for using TETlib on the AS/400.

This document describes the installation steps for TETlib on the AS/400.
TETlib can be installed by using the installation package which is
available from http://www.pdflib.com.


Step 1: Download and unzip the TETLIB.ZIP file
===============================================

Download the file TETLIB_<version>.ZIP for AS/400 and save it to your local
hard disk. Unzip this file to your local hard disk.

Make sure that you have FTP access to your AS/400 and that your user
profile has QSECOFR authority to perform the installation steps.


Step 2: Transfer the TETlib save file to the AS/400
===================================================

Start a DOS session on your PC, and initiate an FTP session against your
AS/400 executing the following command from your DOS prompt:

      FTP myAS400

Enter your AS/400 user profile and password for the logon.

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

Create a SAVF on your AS/400 by running the FTP command:
	Quote rcmd crtsavf file(qgpl/tetlib)

Transfer the file TETLIB.SAV to your AS/400 by running the FTP command:
	Put c:\yourlocalpath\tetlib.sav qgpl/tetlib

Exit the FTP session with the FTP command 
	Quit


Step 3: Restoring the TETlib library
====================================

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

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


Step 4: Creating 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 TETFLIB including all resource
files needed to run TETlib.

	CALL PGM(TETLIB/TETCRTRSC)


Step 6: Verifying the installation
================================== 

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

Object      Type      Attribute
                              
TETCRTRSC   *PGM        CLE         TETlib <version> - Install Resource Fil 
TET         *PGM        CLE         TETlib <version> - Command line Interface
TETLIB      *SRVPGM     CLE         TETlib <version> - TETlib Service Progr 
H           *FILE       PF-SRC      TETlib <version> - H includes           
QCSRC       *FILE       PF-SRC      TETlib <version> - C Samples            
QRPGLESRC   *FILE       PF-SRC      TETlib <version> - RPGLE Samples        
TETLIBRSC   *FILE       SAVF        TETlib <version> - Resource SAVF        
TETLIB      *BNDDIR                 TETlib <version> - Binding Directory    


In the IFS you should find the following directory:

/pdflib/TET/<version>/<longversion>/bind/c
/pdflib/TET/<version>/<longversion>/bind/cpp
/pdflib/TET/<version>/<longversion>/bind/java
/pdflib/TET/<version>/<longversion>/bind/rpg
/pdflib/TET/<version>/<longversion>/doc
/pdflib/TET/<version>/<longversion>/resource
/pdflib/TET/<version>/resource

In this directory TETlib stores the resource files needed to use TETlib.


Additional steps for Java
=========================

Make sure that the TETLIB  SRVPGM can be found in the library
list of the jobs running your Java apps. The easiest way to achieve this
is to copy these SRVPGMs to the QGPL library. In most cases this library
is found in every LIBL.

Make sure that you have execution permission on the Java objects and
directories to run the Java samples.


TETlib applications and Teraspace
=================================

TETlib uses teraspace for static and dynamic memory.


TETlib application and large file support
=========================================

TETlib supports large files >2GB.