Merge branch 'origtgz'
[alioth/cvs.git] / zlib / as400 / readme.txt
1         ZLIB version 1.2.3 for AS400 installation instructions
2
3 I) From an AS400 *SAVF file:
4
5 1)      Unpacking archive to an AS400 save file
6
7 On the AS400:
8
9 _       Create the ZLIB AS400 library:
10
11         CRTLIB LIB(ZLIB) TYPE(PROD) TEXT('ZLIB compression API library')
12
13 _       Create a work save file, for example:
14
15                 CRTSAVF FILE(ZLIB/ZLIBSAVF)
16
17 On a PC connected to the target AS400:
18
19 _       Unpack the save file image to a PC file "ZLIBSAVF"
20 _       Upload this file into the save file on the AS400, for example
21                 using ftp in BINARY mode.
22
23
24 2)      Populating the ZLIB AS400 source library
25
26 On the AS400:
27
28 _       Extract the saved objects into the ZLIB AS400 library using:
29
30 RSTOBJ OBJ(*ALL) SAVLIB(ZLIB) DEV(*SAVF) SAVF(ZLIB/ZLIBSAVF) RSTLIB(ZLIB)
31
32
33 3)      Customize installation:
34
35 _       Edit CL member ZLIB/TOOLS(COMPILE) and change parameters if needed,
36                 according to the comments.
37
38 _       Compile this member with:
39
40         CRTCLPGM PGM(ZLIB/COMPILE) SRCFILE(ZLIB/TOOLS) SRCMBR(COMPILE)
41
42
43 4)      Compile and generate the service program:
44
45 _       This can now be done by executing:
46
47         CALL PGM(ZLIB/COMPILE)
48
49
50
51 II) From the original source distribution:
52
53 1)      On the AS400, create the source library:
54
55         CRTLIB LIB(ZLIB) TYPE(PROD) TEXT('ZLIB compression API library')
56
57 2)      Create the source files:
58
59         CRTSRCPF FILE(ZLIB/SOURCES) RCDLEN(112) TEXT('ZLIB library modules')
60         CRTSRCPF FILE(ZLIB/H)       RCDLEN(112) TEXT('ZLIB library includes')
61         CRTSRCPF FILE(ZLIB/TOOLS)   RCDLEN(112) TEXT('ZLIB library control utilities')
62
63 3)      From the machine hosting the distribution files, upload them (with
64                 FTP in text mode, for example) according to the following table:
65
66     Original    AS400   AS400    AS400 AS400
67     file        file    member   type  description
68                 SOURCES                Original ZLIB C subprogram sources
69     adler32.c           ADLER32  C     ZLIB - Compute the Adler-32 checksum of a dta strm
70     compress.c          COMPRESS C     ZLIB - Compress a memory buffer
71     crc32.c             CRC32    C     ZLIB - Compute the CRC-32 of a data stream
72     deflate.c           DEFLATE  C     ZLIB - Compress data using the deflation algorithm
73     gzio.c              GZIO     C     ZLIB - IO on .gz files
74     infback.c           INFBACK  C     ZLIB - Inflate using a callback interface
75     inffast.c           INFFAST  C     ZLIB - Fast proc. literals & length/distance pairs
76     inflate.c           INFLATE  C     ZLIB - Interface to inflate modules
77     inftrees.c          INFTREES C     ZLIB - Generate Huffman trees for efficient decode
78     trees.c             TREES    C     ZLIB - Output deflated data using Huffman coding
79     uncompr.c           UNCOMPR  C     ZLIB - Decompress a memory buffer
80     zutil.c             ZUTIL    C     ZLIB - Target dependent utility functions
81                 H                      Original ZLIB C and ILE/RPG include files
82     crc32.h             CRC32    C     ZLIB - CRC32 tables
83     deflate.h           DEFLATE  C     ZLIB - Internal compression state
84     inffast.h           INFFAST  C     ZLIB - Header to use inffast.c
85     inffixed.h          INFFIXED C     ZLIB - Table for decoding fixed codes
86     inflate.h           INFLATE  C     ZLIB - Internal inflate state definitions
87     inftrees.h          INFTREES C     ZLIB - Header to use inftrees.c
88     trees.h             TREES    C     ZLIB - Created automatically with -DGEN_TREES_H
89     zconf.h             ZCONF    C     ZLIB - Compression library configuration
90     zlib.h              ZLIB     C     ZLIB - Compression library C user interface
91     as400/zlib.inc      ZLIB.INC RPGLE ZLIB - Compression library ILE RPG user interface
92     zutil.h             ZUTIL    C     ZLIB - Internal interface and configuration
93                 TOOLS                  Building source software & AS/400 README
94     as400/bndsrc        BNDSRC         Entry point exportation list
95     as400/compile.clp   COMPILE  CLP   Compile sources & generate service program
96     as400/readme.txt    README   TXT   Installation instructions
97
98 4)      Continue as in I)3).
99
100
101
102
103 Notes:  For AS400 ILE RPG programmers, a /copy member defining the ZLIB
104                 API prototypes for ILE RPG can be found in ZLIB/H(ZLIB.INC).
105                 Please read comments in this member for more information.
106
107         Remember that most foreign textual data are ASCII coded: this
108                 implementation does not handle conversion from/to ASCII, so
109                 text data code conversions must be done explicitely.
110
111         Always open zipped files in binary mode.