annotate src/zlib-1.2.8/as400/readme.txt @ 81:7029a4916348

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