1*os_390.txt*    For Vim version 7.3.  Last change: 2010 May 30
2
3
4		  VIM REFERENCE MANUAL	  by Ralf Schandl
5
6					*zOS* *z/OS* *OS390* *os390* *MVS*
7This file contains the particulars for the z/OS UNIX version of Vim.
8
91. ASCII/EBCDIC dependent scripts	|zOS-has-ebcdic|
102. Putty and Colors                     |zOS-PuTTY|
113. Motif Problems			|zOS-Motif|
124. Bugs					|zOS-Bugs|
135. Limitations     			|zOS-limitations|
146. Open source on z/OS UNIX		|zOS-open-source|
15
16Contributors: ~
17The port to z/OS UNIX was done by Ralf Schandl for the Redbook mentioned
18below.
19
20Changes, bug-reports, or both by:
21
22	David Moore
23	Anthony Giorgio
24	and others
25
26==============================================================================
271. ASCII/EBCDIC dependent scripts	*OS390-has-ebcdic* *zOS-has-ebcdic*
28
29For the internal script language the feature "ebcdic" was added.  With this
30you can fix ASCII dependent scripts like this:
31>
32    if has("ebcdic")
33	let space = 64
34    else
35	let space = 32
36    endif
37<
38
39==============================================================================
402. PuTTY and Colors			*OS390-PuTTY* *zOS-PuTTY*
41
42If you see problems with syntax highlighting or screen corruptions when you
43connect to z/OS using Putty, try the following:
44
45- Configure Putty as "vt220" terminal (Connection->Data)
46- Add the following 3 lines to your vimrc:
47
48>
49    set t_AB=[4%p1%dm
50    set t_AF=[3%p1%dm
51    set t_CO=8
52<
53
54Note:  is one character use <C-V><Esc> to enter it.
55
56==============================================================================
573. Motif Problems			*OS390-Motif* *zOS-Motif*
58
59Note: Seen with Vim 6.*, never tested since.
60
61It seems that in porting the Motif library to z/OS, a translation from EBCDIC
62to ASCII for the accelerator characters of the pull-down menus was forgotten.
63Even after I tried to hand convert the menus, the accelerator keys continued
64to only work for the opening of menus (like <Alt-F> to open the file menu).
65They still do not work for the menu items themselves (like <Alt-F>O to open
66the file browser).
67
68There is no solution for this yet.
69
70==============================================================================
714. Bugs					*OS390-bugs* *zOS-Bugs*
72
73- Vim will consistently hang when a large amount of text is selected in
74  visual block mode.  This may be due to a memory corruption issue.  Note that
75  this occurs in both the terminal and gui versions.
76
77==============================================================================
785. Limitations     			*OS390-limitations* *zOS-limitations*
79
80- No binary search in tag files.
81  The program /bin/sort sorts by ASCII value by default.  This program is
82  normally used by ctags to sort the tags.  There might be a version of
83  ctags out there, that does it right, but we can't be sure.  So this seems to
84  be a permanent restriction.
85
86- The cscope interface (|cscope|) doesn't work for the version of cscope
87  that we use on our mainframe.  We have a copy of version 15.0b12, and it
88  causes Vim to hang when using the "cscope add" command.  I'm guessing that
89  the binary format of the cscope database isn't quite what Vim is expecting.
90  I've tried to port the current version of cscope (15.3) to z/OS, without
91  much success.  If anyone is interested in trying, drop me a line if you
92  make any progress.
93
94- No glib/gtk support.  I have not been able to successfully compile glib on
95  z/OS UNIX.  This means you'll have to live without the pretty gtk toolbar.
96 
97Disabled at compile time:
98    - Multibyte support         (|multibyte|)
99    - Right-to-left mode        (|rileft|)
100    - Farsi key map             (|Farsi|)
101    - Arabic language support   (|Arabic|)
102    - Spell checking            (|spell|)
103
104Never tested:
105    - Perl interface		(|perl|)
106    - Hangul input		(|hangul|)
107    - Encryption support	(|encryption|)
108    - Langmap			(|'langmap'|)
109    - Python support		(|Python|)
110    - Right-to-left mode	(|'rightleft'|)
111    - SNiFF+ interface		(|sniff|)
112    - TCL interface		(|tcl|)
113    ...
114
115==============================================================================
1166. Open source on z/OS UNIX		*OS390-open-source* *zOS-open-source*
117
118If you are interested in other Open Source Software on z/OS UNIX, have a
119look at the following Redbook:
120
121    Mike MacIsaac et al
122    "Open Source Software for z/OS and OS/390 UNIX"
123    IBM Form Number: SG24-5944-01
124    ISBN: 0738424633
125    http://www-03.ibm.com/systems/resources/servers_eserver_zseries_zos_unix_redbook_sg245944.pdf
126
127Also look at:
128    http://www.redbooks.ibm.com
129    http://www-03.ibm.com/systems/z/os/zos/features/unix/
130    http://www-03.ibm.com/systems/z/os/zos/features/unix/library/IBM+Redbooks/index.html
131
132
133
134------------------------------------------------------------------------------
135 vim:tw=78:fo=tcq2:ts=8:ft=help:norl:
136