~ubuntu-branches/ubuntu/natty/ibm-3270/natty

« back to all changes in this revision

Viewing changes to wc3270/NO-INSTALL.txt

  • Committer: Bazaar Package Importer
  • Author(s): Bastian Blank
  • Date: 2009-12-14 11:48:53 UTC
  • mfrom: (1.1.4 upstream) (2.1.2 sid)
  • Revision ID: james.westby@ubuntu.com-20091214114853-mywixml32hct9jr1
Tags: 3.3.10ga4-2
* Fix section to match override.
* Use debhelper compat level 7.
* Use 3.0 (quilt) source format.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
Running wc3270 Without Installing It
 
2
------------------------------------
 
3
 
 
4
It is possible to run wc3270 without installing it.  This allows it to be run
 
5
from a USB flash drive or CD without modifying the system it is run on, or to
 
6
be bundled with another application without needing to include the full wc3270
 
7
installation.
 
8
 
 
9
When wc3270.exe or wc3270wiz.exe are run without doing a full software
 
10
installation, they will not use the wc3270 Application Data directory.
 
11
Instead, keymaps will be searched for in the working directory first, then in
 
12
the directory where the executable file is.  wc3270wiz.exe will write new
 
13
keymaps to the working directory.  wc3270 trace files will be written to the
 
14
working directory as well.
 
15
 
 
16
A new feature, auto-shortcut mode, also facilitates installation-free
 
17
execution.
 
18
 
 
19
Auto-shortcut mode is controlled by the wc3270.autoShortcut resource.  If this
 
20
resource is set to True in a session file or via the -S command-line option,
 
21
then wc3270.exe will automatically create a temporary shortcut file (.LNK file)
 
22
that matches the parameters in a session file (model number, character set,
 
23
font, etc.) and re-run itself from the shortcut.  (Without auto-shortcut mode,
 
24
wc3270.exe will generally run as a Model 2 in a 25x80 console window, using the
 
25
system default ANSI code page, and the system default font, which is usually
 
26
not a Unicode font and thus cannot display all of the EBCDIC characters.)
 
27
 
 
28
Note that auto-shortcut mode is set in all session files created by the
 
29
Session Wizard, starting with version 3.3.10.  Also note that all shortcuts
 
30
created by the Session Wizard and by wc3270 itself as part of auto-shortcut
 
31
mode include the +S command-line switch, to turn auto-shortcut mode off and
 
32
avoid infinite looping.
 
33
 
 
34
Thus, the easiest way to create a 'standalone' copy of wc3270 is to simply
 
35
create a session file with the Session Wizard.  Then you can run wc3270 via a
 
36
1-line .BAT file (substituting your session name for the session file):
 
37
     wc3270.exe xxx.wc3270
 
38
This command can also be passed to the 'system' library call from an
 
39
application.  Only wc3270.exe and the session file need to be present on the
 
40
flash drive or copied to the target system.
 
41
 
 
42
Note that custom keymaps can still be used in no-install mode.  Keymap files
 
43
can either be placed in the same directory as wc3270.exe, or the definitions
 
44
can be included in the session file via a Session Wizard option ('Embed
 
45
Keymaps').
 
46
 
 
47
Note also that it is possible to create a session file that does not specify
 
48
a hostname.  This allows the creation of session files that define things like
 
49
the model number and character set, but allow the hostname to be entered
 
50
interactively.