xref: /vim-8.2.3635/runtime/doc/os_390.txt (revision 98056533)
1*os_390.txt*    For Vim version 8.2.  Last change: 2019 Dec 07
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 that
87  we use on our mainframe.  We have a copy of version 15.0b12, and it causes
88  Vim to hang when using the "cscope add" command.  I'm guessing that the
89  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    - TCL interface		(|tcl|)
112    ...
113
114==============================================================================
1156. Open source on z/OS UNIX		*OS390-open-source* *zOS-open-source*
116
117If you are interested in other Open Source Software on z/OS UNIX, have a
118look at the following Redbook:
119
120    Mike MacIsaac et al
121    "Open Source Software for z/OS and OS/390 UNIX"
122    IBM Form Number: SG24-5944-01
123    ISBN: 0738424633
124    http://www-03.ibm.com/systems/resources/servers_eserver_zseries_zos_unix_redbook_sg245944.pdf
125
126Also look at:
127    http://www.redbooks.ibm.com
128    http://www-03.ibm.com/systems/z/os/zos/features/unix/
129    http://www-03.ibm.com/systems/z/os/zos/features/unix/library/IBM+Redbooks/index.html
130
131
132
133------------------------------------------------------------------------------
134 vim:tw=78:ts=8:noet:ft=help:norl:
135