create new tag
, view all tags

Mainframe TWiki

This page covers installation on IBM mainframes using OS/390 or z/OS, using Unix System Services - if you have Linux running on VM, see TWikiOnLinux instead.

Related pages: TWikiOnUnix, TWikiOnLinux, TWikiOn

Believe it or not, TWiki works just fine running on an IBM 9672 R66 CMOS machine under OS/390 Unix System Services. The biggest problem was getting the file upload function to work (actually turned out to be modifications to CGI.pm) I like the fact that it can run under OS/390 and that it's self contained, nothing else required. I still have some tuning issues to be worked out but I consider the performance quite acceptable.


  • TWiki version: 01 SEP 2001
  • Web server: IBM HTTP Server V5R2M0
  • Server OS: IBM OS/390 2.9
  • Web browser: MSIE 5
  • Client OS: NT

-- DanaMitchell - 16 Nov 2001

copied from MainframeTWiki [ MattWilkie 18 Nov 2001 ]

Interesting to hear about this - I used to be a sysadmin for Unix on a mainframe (actually Amdahl's UTS), but have never used IBM's Unix APIs (Unix System Services) for OS/390 or VM Open Edition. Of course, you could just run Linux but that's a bit more work smile

-- RichardDonkin - 19 Nov 2001

OliverEichhorn also has TWiki working on OS/390, using TWikiRelease01Feb2003 with InternationalisationEnhancements enabled on IBM HTTP Server V5R3 (5.3). See RewritingUrlsWithEscapedCharsUnderOs390 for the details - there's a small code fix required due to some URL encoding problems. The current patch is tested with IE, OperaBrowser and Lynx, but MozillaBrowser will probably have issues when used with I18N in this environment. In fact, Oliver had this working already using the Sept 2001 release - a case of BeAwareOfQuietAdopters?

Users of Linux on IBM mainframes can just use TWikiOnLinux, which is ASCII based like other Linuxes.

-- RichardDonkin - 03 Sep 2003

If anybody would like to install TWikiRelease01Feb2003 on an IBM Mainframe, here is a little how-to-install:

I assume that Unix System Services and the IBM HTTPD server are installed and running.

You need to download the following Open Source Packages from the IBM FTP-Server

  • diffutils
  • grep
  • gzip
  • perl

and install them according the documentation that can be found at Tools and toys page for z/OS Unix System Services

Unzip the TWiki distribution in a directory of your choice e.g. /u/projects/twiki.

Convert the text sources from ISO-8859-1 to IBM-1047 using iconv.

Modify twiki/lib/TWiki.cfg to reflect your installation.

Add the PASS and EXEC statements to /etc/httpd.conf of your webserver.

In our intranet, I use an SAF-Logon to map RACF-USERID to WikiNames so i have a PROTECT entry for TWiki in /etc/httpd.conf.

Apply both patches listed on RewritingUrlsWithEscapedCharsUnderOs390 (ebcdic.patch and the Edit URL patch) - something like patch -i ebcdic.patch should work (you'll need to convert the patch files to IBM-1047 using iconv).

There's one known issue with attachment uploads - apparently DanaMitchell's fixes are not yet in the CGI.pm (CPAN:CGI) distribution.

Finished and ready to use .... wink

-- OliverEichhorn - 04 Sep 2003
-- RichardDonkin - 10 Sep 2003

To any TWikiOnMainframe users - there's a new TWikiBetaRelease that should let users of Mozilla-based browsers work with mainframe TWiki sites that use I18N (through EncodeURLsWithUTF8), and avoids the user having to reconfigure the browser (for IE and Opera). Also, it would be helpful to have some mainframe people test this release since I don't have access to mainframes.

-- RichardDonkin - 23 Feb 2004

According to the change log on CPAN:CGI version 3.02 at http://stein.cshl.org/WWW/software/CGI/, attachment uploads should now work on EBCDIC mainframes.

-- RichardDonkin - 03 Jan 2005

Edit | Attach | Watch | Print version | History: r10 < r9 < r8 < r7 < r6 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r10 - 2005-01-03 - RichardDonkin
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2015 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.