2010-01-19 Paul Thomas <pault@gcc.gnu.org>
[official-gcc.git] / zlib / as400 / readme.txt
blobbeae13f565bda4eab2966bbd059394dc7a4f23e5
1         ZLIB version 1.2.3 for AS400 installation instructions
3 I) From an AS400 *SAVF file:
5 1)      Unpacking archive to an AS400 save file
7 On the AS400:
9 _       Create the ZLIB AS400 library:
11         CRTLIB LIB(ZLIB) TYPE(PROD) TEXT('ZLIB compression API library')
13 _       Create a work save file, for example:
15                 CRTSAVF FILE(ZLIB/ZLIBSAVF)
17 On a PC connected to the target AS400:
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.
24 2)      Populating the ZLIB AS400 source library
26 On the AS400:
28 _       Extract the saved objects into the ZLIB AS400 library using:
30 RSTOBJ OBJ(*ALL) SAVLIB(ZLIB) DEV(*SAVF) SAVF(ZLIB/ZLIBSAVF) RSTLIB(ZLIB)
33 3)      Customize installation:
35 _       Edit CL member ZLIB/TOOLS(COMPILE) and change parameters if needed,
36                 according to the comments.
38 _       Compile this member with:
40         CRTCLPGM PGM(ZLIB/COMPILE) SRCFILE(ZLIB/TOOLS) SRCMBR(COMPILE)
43 4)      Compile and generate the service program:
45 _       This can now be done by executing:
47         CALL PGM(ZLIB/COMPILE)
51 II) From the original source distribution:
53 1)      On the AS400, create the source library:
55         CRTLIB LIB(ZLIB) TYPE(PROD) TEXT('ZLIB compression API library')
57 2)      Create the source files:
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')
63 3)      From the machine hosting the distribution files, upload them (with
64                 FTP in text mode, for example) according to the following table:
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
98 4)      Continue as in I)3).
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.
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.
111         Always open zipped files in binary mode.