1 README_zOS.txt for version 7.3 of Vim: Vi IMproved.
3 This readme explains how to build Vim on z/OS. Formerly called OS/390.
4 See "README.txt" for general information about Vim.
6 Most likely there are not many users out there using Vim on z/OS. So chances
7 are good, that some bugs are still undiscovered.
9 Getting the source to z/OS:
10 ==========================
12 First get the source code in one big tar file and ftp it a binary to z/OS. If
13 the tar file is initially compressed with gzip (tar.gz) or bzip2 (tar.bz2)
14 uncompress it on your PC, as this tools are (most likely) not available on the
17 To reduce the size of the tar file you might compress it into a zip file. On
18 z/OS Unix you might have the command "jar" from java to uncompress a zip. Use:
19 jar xvf <zip file name>
21 Unpack the tar file on z/OS with
22 pax -o from=ISO8859-1,to=IBM-1047 -rf vim.tar
24 Note: The Vim source contains a few bitmaps etc which will be destroyed by
25 this command, but these files are not needed on zOS (at least not for the
32 Vim can be compiled with or without GUI support. For 7.3 only the compilation
33 without GUI was tested. Below is a section about compiling with X11 but this
34 is from an earlier version of Vim.
39 If you build VIM without X11 support, compiling and building is nearly
42 Change to the vim directory and do:
45 # Allow intermixing of compiler options and files.
49 $./configure --with-features=big --without-x --enable-gui=no
53 There may be warnings:
54 - include files not found (libc, sys/param.h, ...)
55 - Redeclaration of ... differs from ...
60 This will produce lots of garbage on your screen (including error
61 messages). Don't worry.
63 If the test stops at one point in vim (might happen in test 11), just
66 Expected test failures:
67 11: If you don't have gzip installed
68 24: test of backslash sequences in regexp are ASCII dependent
69 42: Multibyte is not supported on z/OS
70 55: ASCII<->EBCDIC sorting
71 57: ASCII<->EBCDIC sorting
72 58: Spell checking is not supported with EBCDIC
73 71: Blowfish encryption doesn't work
81 WARNING: This instruction was not tested with Vim 7.3.
83 There are two ways for building VIM with X11 support. The first way is simple
84 and results in a big executable (~13 Mb), the second needs a few additional
85 steps and results in a much smaller executable (~4.5 Mb). This examples assume
91 $ ./configure --enable-max-features --enable-gui=motif
95 With this VIM is linked statically with the X11 libraries.
98 Make VIM as described above. Then create a file named 'link.sed' with the
99 following content (see src/link.390):
103 s/-lXm */\/usr\/lib\/Xm.x /g
104 s/-lX11 */\/usr\/lib\/X11.x /g
106 s/-lSM */\/usr\/lib\/SM.x /g
107 s/-lICE */\/usr\/lib\/ICE.x /g
113 Now Vim is linked with the X11-DLLs.
115 See the Makefile and the file link.sh on how link.sed is used.