PR55859.
[official-gcc.git] / zlib / as400 / readme.txt
blob23cd1b8a3c5914e4337e3c24c0946e566725a622
1         ZLIB version 1.2.7 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     gzclose.c           GZCLOSE  C     ZLIB - Close .gz files
74     gzlib.c             GZLIB    C     ZLIB - Miscellaneous .gz files IO support
75     gzread.c            GZREAD   C     ZLIB - Read .gz files
76     gzwrite.c           GZWRITE  C     ZLIB - Write .gz files
77     infback.c           INFBACK  C     ZLIB - Inflate using a callback interface
78     inffast.c           INFFAST  C     ZLIB - Fast proc. literals & length/distance pairs
79     inflate.c           INFLATE  C     ZLIB - Interface to inflate modules
80     inftrees.c          INFTREES C     ZLIB - Generate Huffman trees for efficient decode
81     trees.c             TREES    C     ZLIB - Output deflated data using Huffman coding
82     uncompr.c           UNCOMPR  C     ZLIB - Decompress a memory buffer
83     zutil.c             ZUTIL    C     ZLIB - Target dependent utility functions
84                 H                      Original ZLIB C and ILE/RPG include files
85     crc32.h             CRC32    C     ZLIB - CRC32 tables
86     deflate.h           DEFLATE  C     ZLIB - Internal compression state
87     gzguts.h            GZGUTS   C     ZLIB - Definitions for the gzclose module
88     inffast.h           INFFAST  C     ZLIB - Header to use inffast.c
89     inffixed.h          INFFIXED C     ZLIB - Table for decoding fixed codes
90     inflate.h           INFLATE  C     ZLIB - Internal inflate state definitions
91     inftrees.h          INFTREES C     ZLIB - Header to use inftrees.c
92     trees.h             TREES    C     ZLIB - Created automatically with -DGEN_TREES_H
93     zconf.h             ZCONF    C     ZLIB - Compression library configuration
94     zlib.h              ZLIB     C     ZLIB - Compression library C user interface
95     as400/zlib.inc      ZLIB.INC RPGLE ZLIB - Compression library ILE RPG user interface
96     zutil.h             ZUTIL    C     ZLIB - Internal interface and configuration
97                 TOOLS                  Building source software & AS/400 README
98     as400/bndsrc        BNDSRC         Entry point exportation list
99     as400/compile.clp   COMPILE  CLP   Compile sources & generate service program
100     as400/readme.txt    README   TXT   Installation instructions
102 4)      Continue as in I)3).
107 Notes:  For AS400 ILE RPG programmers, a /copy member defining the ZLIB
108                 API prototypes for ILE RPG can be found in ZLIB/H(ZLIB.INC).
109                 Please read comments in this member for more information.
111         Remember that most foreign textual data are ASCII coded: this
112                 implementation does not handle conversion from/to ASCII, so
113                 text data code conversions must be done explicitely.
115         Mainly for the reason above, always open zipped files in binary mode.