all repos — mgba @ 81a52403a3583039f4e571f1516cd0efe4872c4b

mGBA Game Boy Advance Emulator

src/third-party/zlib/as400/readme.txt (view raw)

  1        ZLIB version 1.2.8 for AS400 installation instructions
  2
  3I) From an AS400 *SAVF file:
  4
  51)      Unpacking archive to an AS400 save file
  6
  7On 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
 17On 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
 242)      Populating the ZLIB AS400 source library
 25
 26On the AS400:
 27
 28_       Extract the saved objects into the ZLIB AS400 library using:
 29
 30RSTOBJ OBJ(*ALL) SAVLIB(ZLIB) DEV(*SAVF) SAVF(ZLIB/ZLIBSAVF) RSTLIB(ZLIB)
 31
 32
 333)      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
 434)      Compile and generate the service program:
 44
 45_       This can now be done by executing:
 46
 47        CALL PGM(ZLIB/COMPILE)
 48
 49
 50
 51II) From the original source distribution:
 52
 531)      On the AS400, create the source library:
 54
 55        CRTLIB LIB(ZLIB) TYPE(*PROD) TEXT('ZLIB compression API library')
 56
 572)      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
 633)      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    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
101
1024)      Continue as in I)3).
103
104
105
106
107Notes:  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.
110
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.
114
115        Mainly for the reason above, always open zipped files in binary mode.