Mercurial > vim
annotate runtime/doc/os_390.txt @ 2092:98cc757f7e3d v7.2.376
updated for version 7.2.376
Problem: ml_get error when using SiSU syntax. (Nathan Thomas)
Solution: If the match ends below the last line move it to the end of the
last line.
| author | Bram Moolenaar <bram@zimbu.org> |
|---|---|
| date | Wed, 24 Feb 2010 17:22:20 +0100 |
| parents | de5a43c5eedc |
| children | 7c8c7c95a865 |
| rev | line source |
|---|---|
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
1 *os_390.txt* For Vim version 7.2. Last change: 2008 Dec 17 |
| 7 | 2 |
| 3 | |
| 4 VIM REFERENCE MANUAL by Ralf Schandl | |
| 5 | |
| 6 *zOS* *z/OS* *OS390* *os390* *MVS* | |
| 7 This file contains the particulars for the z/OS UNIX version of Vim. | |
| 8 | |
| 9 1. Open source on z/OS UNIX |zOS-open-source| | |
| 10 2. Your feedback is needed |zOS-feedback| | |
| 11 3. Building VIM for z/OS UNIX |zOS-building| | |
| 12 4. ASCII/EBCDIC dependent scripts |zOS-has-ebcdic| | |
| 13 5. XTerm Problems |zOS-xterm| | |
| 14 6. Motif Problems |zOS-Motif| | |
| 236 | 15 7. Bugs |zOS-Bugs| |
| 7 | 16 8. Known weaknesses |zOS-weaknesses| |
| 17 9. Changes |zOS-changes| | |
| 18 | |
| 19 DISCLAIMER: ~ | |
| 236 | 20 We are IBM employees, but IBM is not responsible for this port. This is our |
| 7 | 21 private fun, and is provided in the hopes that it may be useful to others. |
| 22 | |
| 23 Please note that this software has NOT been submitted to any formal IBM | |
| 236 | 24 testing and is published AS IS. Please do not contact IBM for support for this |
| 25 software, as it is not an official component of any IBM product. IT IS NOT | |
| 7 | 26 SUPPORTED, GUARANTEED, OR RELATED WHATSOEVER TO IBM. |
| 27 | |
| 28 Contributors: ~ | |
| 29 The port to z/OS UNIX was done by Ralf Schandl for the Redbook mentioned | |
| 30 below. | |
| 31 | |
| 32 Changes, bug-reports, or both by: | |
| 33 | |
| 34 David Moore | |
| 35 Anthony Giorgio <agiorgio@fastmail.fm> | |
| 36 and others | |
| 37 | |
| 38 This document was written by Ralf Schandl and revised by Anthony Giorgio. | |
| 39 | |
| 40 ============================================================================== | |
| 41 1. Open source on z/OS UNIX *OS390-open-source* *zOS-open-source* | |
| 42 | |
| 43 If you are interested in other Open Source Software on z/OS UNIX, have a | |
| 44 look at the following Redbook: | |
| 45 | |
| 46 Mike MacIsaac et al | |
| 47 "Open Source Software for z/OS and OS/390 UNIX" | |
| 48 IBM Form Number: SG24-5944-01 | |
| 49 ISBN: 0738424633 | |
| 50 | |
| 51 You can find out more information, order a hard copy, or download a PDF | |
| 52 version of these Redbooks at: | |
| 53 | |
| 54 http://www.redbooks.ibm.com | |
| 55 | |
| 56 ============================================================================== | |
| 57 2. Your feedback is needed *OS390-feedback* *zOS-feedback* | |
| 58 | |
| 59 Vim should compile, link, and run right out of the box on a standard IBM z/OS | |
| 60 UNIX mainframe. I've personally run it on z/OS V1R2 and V1R3 machines without | |
| 61 problems. | |
| 62 | |
| 236 | 63 Many changes had to be done to the code to port Vim to z/OS UNIX. As like |
| 64 most UNIX programs, Vim contained heavy ASCII dependencies. I might have | |
| 7 | 65 missed an ASCII dependency, or it is possible that a new one has been added |
| 236 | 66 with a feature or bug fix. Most programmers are simply not aware of possible |
| 67 ASCII/EBCDIC conversion issues. If you hit a problem that seems related to | |
| 7 | 68 this, feel free to contact us at the email addresses above. |
| 69 | |
| 70 One indication of ASCII/EBCDIC conversion problems is screen corruption with | |
| 71 "unprintable" characters. For example, at one point the errorbell was broken | |
| 236 | 72 in Vim. Any time Vim tried to ring the terminal bell an ASCII character 0x07 |
| 73 would be printed. This works fine on most terminals, but is broken on an | |
| 74 EBCDIC one. The correct solution was to define a different value for the bell | |
| 7 | 75 character on EBCDIC systems. |
| 76 | |
| 77 Remember, it's only possible to fix a bug if the community knows about it. | |
| 236 | 78 Don't rely on someone else to report it! See the section |bug-reports|. |
| 7 | 79 |
| 80 ============================================================================== | |
| 81 3. Building VIM for z/OS UNIX *OS390-building* *zOS-building* | |
| 82 | |
| 83 A word on debugging code first: ~ | |
| 84 | |
| 85 The normal run of configure adds the flag '-g' to the compiler options, | |
| 236 | 86 to include debugging information into the executable. This information |
| 7 | 87 are normally removed from the executable with the strip command during |
| 236 | 88 installation. On z/OS UNIX, it is not possible to remove this from |
| 89 the executable. The strip command exists on z/OS UNIX and is called | |
| 7 | 90 during the installation, but it does nothing. It is equivalent to the |
| 236 | 91 'touch' command. This is due to the way debug symbols are stored in the |
| 7 | 92 objects generated by the compiler. |
| 93 | |
| 94 If you want to build Vim without debugging code, export the environment | |
| 95 variable CFLAGS set to an empty string before you call the configure script. | |
| 96 > | |
| 97 export CFLAGS="" | |
| 98 | |
| 99 | |
| 100 Building without X11: ~ | |
| 101 | |
| 236 | 102 Note: Use cc to build Vim. The c89 compiler has stricter syntax checking |
| 7 | 103 and will not compile Vim cleanly. |
| 104 | |
| 105 If you build VIM without X11 support, compiling and building is | |
| 236 | 106 straightforward. Don't forget to export _CC_CCMODE=1 before calling |
| 7 | 107 configure and make. |
| 108 > | |
| 109 $ export _CC_CCMODE=1 | |
| 110 $./configure --with-features=big --without-x --enable-gui=no | |
| 111 $ make | |
| 112 $ make test | |
| 113 < | |
| 114 Test notes: | |
| 115 Test 11 will fail if you do not have gzip installed. | |
| 116 Test 42 will fail, as VIM on z/OS UNIX doesn't support the multibyte | |
| 236 | 117 feature. (David Moore: "Doesn't work _yet_! :-) I'll see what I |
| 7 | 118 can do.") |
| 119 > | |
| 120 | |
| 121 $ make install | |
| 122 | |
| 123 | |
| 124 Building with X11: ~ | |
| 125 | |
| 236 | 126 There are two ways for building Vim with X11 support. You can link it |
| 127 statically with the X11 libraries or can bind it with the X11 DLLs. The | |
| 7 | 128 statically linked version results in a huge executable (~13MB), while the |
| 129 dynamically linked executable is much smaller (~4.5MB). | |
| 130 | |
| 131 Here is what you do, if you want Motif: | |
| 132 | |
| 133 a) Static link > | |
| 134 $ configure --with-features=big --enable-gui=motif | |
| 135 $ make | |
| 136 < | |
| 137 VIM is now linked statically with the X11 libraries. | |
| 138 | |
| 139 b) Dynamic link: | |
| 236 | 140 Make VIM as described for the static link. Then change the contents of |
| 7 | 141 the 'auto/link.sed' file by appending: > |
| 142 s%-lXm *%/usr/lib/Xm.x %g | |
| 143 s%-lX11 *%/usr/lib/X11.x %g | |
| 144 s%-lSM *%/usr/lib/SM.x %g | |
| 145 s%-lICE *%/usr/lib/ICE.x %g | |
| 146 < | |
| 147 Then do: > | |
| 148 $ rm vim | |
| 149 $ make | |
| 150 < | |
| 151 Now Vim is linked with the X11-DLLs. | |
| 152 | |
| 153 See the Makefile and the file link.sh on how link.sed is used. | |
| 154 | |
| 155 ============================================================================== | |
| 156 4. ASCII/EBCDIC dependent scripts *OS390-has-ebcdic* *zOS-has-ebcdic* | |
| 157 | |
| 236 | 158 For the internal script language the feature "ebcdic" was added. With this |
| 7 | 159 you can fix ASCII dependent scripts like this: |
| 160 > | |
| 161 if has("ebcdic") | |
| 162 let space = 64 | |
| 163 else | |
| 164 let space = 32 | |
| 165 endif | |
| 166 < | |
| 167 ============================================================================== | |
| 168 5. XTerm problems *OS390-xterm* *zOS-xterm* | |
| 169 | |
| 170 Note: This problem was resolved in version 6.1b. ~ | |
| 171 | |
| 172 I saw one problem with XTerm on z/OS UNIX. The terminal code for moving the | |
| 173 cursor to the left is wrong in the termlib database. Perhaps not wrong, but | |
| 174 it didn't work with VIM syntax highlighting and command line cursor movement. | |
| 175 | |
| 176 If the highlighting is messed up while you type, but is okay after you refreshed | |
| 177 the screen with <C-L> or if you can't move to the left with the cursor key on | |
| 178 the command line, try adding > | |
| 179 :set t_le=^H | |
| 180 < | |
| 236 | 181 to your .vimrc. Note: '^H' is one character, hit <C-V><C-H> to get it. |
| 7 | 182 |
| 183 ============================================================================== | |
| 184 6. Motif Problems *OS390-Motif* *zOS-Motif* | |
| 185 | |
| 186 It seems that in porting the Motif library to z/OS, a translation from EBCDIC | |
| 187 to ASCII for the accelerator characters of the pull-down menus was forgotten. | |
| 188 Even after I tried to hand convert the menus, the accelerator keys continued | |
| 189 to only work for the opening of menus (like <Alt-F> to open the file menu). | |
| 190 They still do not work for the menu items themselves (like <Alt-F>O to open | |
| 191 the file browser). | |
| 192 | |
| 193 There is no solution for this as of yet. | |
| 194 | |
| 195 ============================================================================== | |
| 196 7. Bugs *OS390-bugs* *zOS-Bugs* | |
| 197 | |
| 198 - Vim will consistently hang when a large amount of text is selected in | |
| 199 visual block mode. This may be due to a memory corruption issue. Note that | |
| 200 this occurs in both the terminal and gui versions. | |
| 201 | |
| 202 ============================================================================== | |
| 203 8. Known weaknesses *OS390-weaknesses* *zOS-weaknesses* | |
| 204 | |
| 205 - No binary search in tag files. | |
| 236 | 206 The program /bin/sort sorts by ASCII value by default. This program is |
| 207 normally used by ctags to sort the tags. There might be a version of | |
| 208 ctags out there, that does it right, but we can't be sure. So this seems to | |
| 7 | 209 be a permanent restriction. |
| 210 | |
| 211 - Multibyte support (utf-8) doesn't work, it's disabled at compile time. | |
| 212 (|multibyte|) | |
| 213 | |
| 214 - The cscope interface (|cscope|) doesn't work for the version of cscope | |
| 215 that we use on our mainframe. We have a copy of version 15.0b12, and it | |
| 216 causes Vim to hang when using the "cscope add" command. I'm guessing that | |
| 217 the binary format of the cscope database isn't quite what Vim is expecting. | |
| 218 I've tried to port the current version of cscope (15.3) to z/OS, without | |
| 219 much success. If anyone is interested in trying, drop me a line if you | |
| 220 make any progress. | |
| 221 | |
| 222 - No glib/gtk support. I have not been able to successfully compile glib on | |
| 223 z/OS UNIX. This means you'll have to live without the pretty gtk toolbar. | |
| 224 | |
| 225 Never tested: | |
| 226 - Perl interface (|perl|) | |
| 227 - Hangul input (|hangul|) | |
| 228 - Encryption support (|encryption|) | |
| 229 - Langmap (|'langmap'|) | |
| 230 - Python support (|Python|) | |
| 231 - Right-to-left mode (|'rightleft'|) | |
| 232 - SNiFF+ interface (|sniff|) | |
| 233 - TCL interface (|tcl|) | |
| 234 ... | |
| 235 | |
| 236 If you try any of these features and they work, drop us a note! | |
| 237 | |
| 238 ============================================================================== | |
| 239 9. Changes *OS390-changes* *zOS-changes* | |
| 240 | |
| 241 This is a small reference of the changes made to the z/OS port of Vim. It is | |
| 242 not an exhaustive summary of all the modifications made to the code base. | |
| 243 | |
| 244 6.1b (beta): | |
| 245 Changed KS_LE in term.c to be "\b" instead of "\010" This fixed the | |
| 246 screen corruption problems in gVim reported by Anthony Giorgio. | |
| 247 | |
| 248 Anthony Giorgio updated this document: | |
| 236 | 249 - Changed OS/390 to z/OS where appropriate. IBM decided to rename |
| 7 | 250 all of its servers and operating systems. z/OS and OS/390 |
| 251 are the same product, but the version numbering system was | |
| 236 | 252 reset for the name change (e.g. OS/390 V2R11 == z/OS V1R1). |
| 7 | 253 - Added information about second edition of the Open Source Redbook. |
| 254 - Moved Redbook information to a separate section. | |
| 255 - Various tweaks and changes. | |
| 256 - Updated testing section. | |
| 257 | |
| 258 6.0au: | |
| 259 Changed configure.in | |
| 260 Changed documentation. | |
| 261 Anthony Giorgio fixed the errorbell. | |
| 262 | |
| 263 David Moore found some problems, which were fixed by Bram and/or David for | |
| 264 6.0au. | |
| 265 | |
| 266 6.0q (alpha): | |
| 267 Minor changes for nrformats=alpha (see |'nrformats'|). | |
| 236 | 268 Problem with hard-coded keycode for the English pound sign. Added a define in |
| 7 | 269 ascii.h |
| 270 Disabled multibyte for EBCDIC in feature.h | |
| 271 | |
| 272 6.0f (alpha): | |
| 236 | 273 First compile of Vim 6 on z/OS UNIX. Some minor changes were needed. |
| 7 | 274 |
| 275 Finally found the reason why make from the top level didn't work (I must have | |
| 236 | 276 been blind before!). The Makefile contained a list of targets in one target |
| 277 line. On all other UNIX's the macro $@ evaluates to the first target in this | |
| 7 | 278 list, only on z/OS UNIX it evaluates to the last one :-(. |
| 279 | |
| 280 5.6-390d: | |
| 281 Cleaned up some hacks. | |
| 282 | |
| 283 5.6-390c: | |
| 284 I grepped through the source and examined every spot with a character | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
285 involved in an operation (+-). I hope I now found all EBCDIC/ASCII |
| 7 | 286 stuff, but .... |
| 287 | |
| 288 Fixed: | |
| 289 - fixed warning message in do_fixdel() | |
| 290 - fixed translation from Ctrl-Char to symbolic name (like ^h to CTRL-H) | |
| 291 for :help | |
| 292 - fixed yank/delete/... into register | |
| 293 - fixed :register command | |
| 294 - fixed viminfo register storing | |
| 295 - fixed quick-access table in findoptions() | |
| 296 - fixed 'g^H' select mode | |
| 297 - fixed tgetstr() 'get terminal capability string', ESC and | |
| 236 | 298 Ctrl chars where wrong. (Not used on OS/390 UNIX) |
| 7 | 299 |
| 300 | |
| 301 ctags: | |
| 302 - added trigraphs support (used in prolog of system header files) | |
| 303 (get.c) | |
| 304 - fixed sorting order with LC_COLLATE=S390 to force EBCDIC sorting. | |
| 305 (sort.c) | |
| 306 | |
| 307 5.6-390b: | |
| 308 Changed: | |
| 309 - configure.in: | |
| 310 - added test for OS/390 UNIX | |
| 311 - added special compiler and linker options if building with X11 | |
| 312 - configure: | |
| 313 - after created via autoconf hand-edited it to make the test for | |
|
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
314 ICEConnectionNumber work. This is an autoconf problem. OS/390 UNIX |
| 7 | 315 needs -lX11 for this. |
| 316 - Makefile | |
| 317 - Don't include the lib directories ('-L...') into the variable | |
| 236 | 318 ALL_LIBS. Use own variable ALL_LIB_DIRS instead. A fully POSIX |
| 7 | 319 compliant compiler must not accept objects/libraries and options |
| 236 | 320 mixed. Now we can call the linker like this: |
| 7 | 321 |
| 322 $(CC) $(LDFLAGS) $(ALL_LIB_DIRS) $(OBJ) $(ALL_LIBS) | |
| 323 | |
| 324 Fixed: | |
| 325 - Double quote couldn't be entered | |
| 326 Missed ASCII dependencies while setting up terminal | |
| 327 In ASCII 127 is the delete char, in EBCDIC codepage 1047 the value 127 | |
| 328 is the double quote. | |
| 329 - fixed ':fixdel' | |
| 330 | |
| 331 5.6-390a: | |
| 332 first alpha release for OS/390 UNIX. | |
| 333 | |
| 334 Addition: | |
| 335 - For the internal script language I added the feature "ebcdic". | |
| 336 This can be queried with the has()-function of the internal | |
| 337 script language. | |
| 338 | |
| 339 ------------------------------------------------------------------------------ | |
| 340 vim:tw=78:fo=tcq2:ts=8:ft=help:norl: |