Apache 2.0.40 binary distribution
================================
 
This binary distribution is usable on a "s390-ibm-os390"
system and was built by Greg Ames.

The distribution contains all standard Apache modules as shared
objects. This allows you to enable or disable particular modules
with the LoadModule/AddModule directives in the configuration file
without the need to re-compile Apache.

To install,

* download the httpd-2.0*tar.Z or *tar.gz file
* uncompress or gunzip, as appropriate, and untar
  tar -xzvf httpd-2.0.*-s390-ibm-os390.tar.Z

  The resulting httpd-2.0.40 directory contains the complete source code
  as well as the executable code.

  Note: the text files are encoded in US EBCDIC (IBM-1047), so it is
  not necessary to use pax to convert from ASCII.

* execute the installation shell script.  The parameter is the target directory
    (the default is /usr/local/apache2) .
  cd httpd-2.0.40
  ./install-bindist.sh /u/glames/apache-test
  
* edit the Apache configuration file
  cd /u/glames/apache-test/
  vi conf/httpd.conf

  You will probably need to change:
  - "User nobody" and "Group #-1" to a valid userid/group with few privileges.
    This is the user that the Apache child processes run as when its main 
    process is started as root.
  - "Listen 80" to specify another TCP port number if there is a production
    web server on this machine already using TCP port 80.
  - the <Directory /> container to add the following:

    CharsetDefault   ISO8859-1
    CharsetSourceEnc IBM-1047

    This causes all text files to be translated from US EBCDIC to Western
    ASCII before being sent to the browser.  Many other combinations are
    possible, including no translation for directories that contain ASCII
    files.

* start Apache
  bin/apachectl start

To stop Apache:
  bin/apachectl stop
  
For further infomation, see
  - http://httpd.apache.org/docs-2.0/ for general Apache usage information.  
    Most of this information is also contained in the htdocs/manual/ directory
    supplied by this distribution.
  - http://www.apache.org/~trawick/apache-2-on-os390.html for OS/390 specific
    information about Apache.

This distribution has a patch applied to the base httpd-2.0.40 source
tarball:

http://cvs.apache.org/viewcvs.cgi/apr/strings/apr_strings.c.diff?r1=1.37&r2=1.38

The patch corrects a compile failure which only affects EBCDIC platforms.

The configure invocation in binbuild.sh was changed to:
  - add --enable-dav=static (to bypass a DSO build issue), and
  - add --with-mpm=worker (to enable the multi-threaded server support).
 
NOTE: Please do not send support-related mails to the address mentioned
      above or to any member of the Apache Group! Support questions
      should be directed to the "comp.infosystems.www.servers.unix"
      or "comp.infosystems.www.servers.ms-windows" newsgroup
      (as appropriate for the platform you use), where some of the
      Apache team lurk, in the company of many other Apache gurus
      who should be able to help.
      If you think you found a bug in Apache or have a suggestion please
      visit the bug report page at http://www.apache.org/bug_report.html
 
----------------------------------------------------------------------
Server version: Apache/2.0.40
Server built:   Aug 13 2002 16:28:47
Server's Module Magic Number: 20020628:0
Architecture:   32-bit
Server compiled with....
 -D APACHE_MPM_DIR="server/mpm/worker"
 -D APR_HAS_SENDFILE
 -D APR_HAS_MMAP
 -D APR_USE_SYSVSEM_SERIALIZE
 -D APR_USE_PTHREAD_SERIALIZE
 -D APR_HAS_OTHER_CHILD
 -D AP_HAVE_RELIABLE_PIPED_LOGS
 -D APR_CHARSET_EBCDIC
 -D APACHE_XLATE
 -D HTTPD_ROOT="/u/glames/code/httpd-2.0.40/bindist"
 -D SUEXEC_BIN="/u/glames/code/httpd-2.0.40/bindist/bin/suexec"
 -D DEFAULT_SCOREBOARD="logs/apache_runtime_status"
 -D DEFAULT_ERRORLOG="logs/error_log"
 -D AP_TYPES_CONFIG_FILE="conf/mime.types"
 -D SERVER_CONFIG_FILE="conf/httpd.conf"
----------------------------------------------------------------------