home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 29 Fixes_o
/
29-Fixes_o.zip
/
tcpcsd2.zip
/
BASECSD2.EXE
/
BIN
/
TN3270.DOC
< prev
next >
Wrap
Text File
|
1993-04-15
|
8KB
|
226 lines
-----------------------------------------------------------
Changes to TN3270 parameters:
The -tx parameter is in the latest draft but without any explanation. Here's
the detail taken from the documentation that comes with the base CSD:
Support for specifying external ASCII/EBCIDC translation table has been
added to TN3270 and PMANT. This is supported by the following files:
\tcpip\bin\tn3270.exe
\tcpip\bin\pmant.exe
\tcpip\etc\3278xlt.sam (sample translate table)
Both TN3270 and PMANT have the following syntax for specifying a
translate table.
-tx translate_table_file_name
If the translate_table_file_name does not contain the full path then
the application will search the ETC directory.
If the -tx option is not specified, the application will use the file
3278XLT.TBL in ETC directory. Thus if you want to use a particular
translate table most of the time, you should copy your translate table
file to 3278XLT.TBL in your ETC directory. If the file 3278XLT.TBL does
not exist, the application will use the default US translate table
internal to the application.
3278XLT.SMP is shipped as an example and contains the US ASCII/EBCDIC
translations. The format of the translation table is the same as that
of IBM TCP/IP for VM. Thus TN3270 and PMANT can use a translation table
downloaded form IBM TCP/IP for VM.
The -t parameter provides debug terminal negotiation information in a
TN3270.LOG file.
The -d parameter provides debug information about all data sent in a
TN3270.LOG file.
The -t -d options together provide both of the debug information above
in a TN3270.LOG file.
-----------------------------------------------------------------------------
The menu item "Keyboard..." in the Configuration menu has changed to
"Refresh key mapping".
The menu item "Attributes" has changed to "Change Color" and "Save Color".
The keyboard mapping has completely changed. Keyboard mapping is now done
using a text file rather than a dialog box. The Keyboard dialog box has been
removed. Here's the technical details on the new keyboard mapping:
-----------------------------------------------------------------------------
New Keyboard Binding for TN3270
-------------------------------
A new scheme for binding keys has been implemented in TN3270, allowing
for a greater flexibility. TN3270 now allows you to bind a 3270
function to the following keys:
function keys
cursor keys
editing keys (Insert, Home, Page Up, etc)
escape
tab
backspace
print screen
scroll lock
left control key
right control key
and control, alt, and shift combinations of these keys. TN3270 also
allows you to bind 3270 functions to control-letter combinations and
alt-letter combinations as well as the individual control and alt
keys.
The key bindings are stored in a flat ASCII file named TN3270.KEY.
When loading the key bindings, TN3270 first tries to open TN3270.KEY in
the current directory. If this fails, TN3270 tries to open TN3270.KEY
in the directory defined in the ETC environment variable.
If the TN3270.KEY file is opened successfully, TN3270 reads the file
line-by-line, parsing the bindings, and binding a 3270 datastream
function to an OS/2 key. Keys may be rebound on the fly by editting
TN3270.KEY and using the "Refresh key mapping" menu option in the
TN3270 main menu. To access the TN3270 main menu, press ALT-M.
Since TN3270 is initialized with default key bindings, the TN3270.KEY
file need only contain bindings to override the default or provide for
bindings that are not defaults.
The TN3270.KEY file is line-oriented. Each line is either blank,
contains a comment, or contains 1 binding. The semicolon is used to
delimit comments which may appear anywhere on the line. A comment
begins with a semicolon and ends at the end of the line.
A line containing a binding follows the syntax:
<OS/2 Key> <whitespace> <3270 Function> <optional comment>
Where <OS/2 Key> is of the form:
<function key>
control-<function key>
alt-<function key>
shift-<function key>
control-'<unshifted keypress>'
alt-'<unshifted keypress>'
<unshifted keypress> is one of the keyboard's white keys identifying
letters, punctuation, numbers, and foreign language accented keys.
This key should be the *unshifted* letter. For example, to bind a
function to control-2, the <unshifted keypress> would be:
control-'2'
It is not possible to bind to control-'@' since '@' is the shifted
state of '2'. There are some control combinations which can not be
bound. See "Limitations."
TN3270 does not allow binding to the quote key (see "Limitations".)
However, PM-ANT does. Therefore, the syntax of the TN3270.KEY file
must allow this binding. To bind to the quote character, the
backslash is used as an "escape" to temporarily break the syntax that
an unshifted keypress is surrounded by quotes. Since the backslash is
interpreted as an escape, there must be 2 backslashes when binding to
the backslash. For example,
control-'\'' ; escape the quote so it can be bound to,
; ''' would be illegal syntax
control-'\\' ; escape the backslash so it can be bound to
; '\' would be illegal syntax
control-'\a' ; '\a' is exactly the same as 'a'
<function key> is a keyword identifying an OS/2 function key.
Possible values are BACKSPACE, TAB, NEWLINE, ESCAPE, PAGEUP, PAGEDOWN,
END, HOME, LEFT, UP, RIGHT, DOWN, INSERT, DELETE, ENTER, F1, F2, F3,
F4, F5, F6, F7, F8, F9, F10, F11, F12, LEFT-CONTROL, RIGHT-CONTROL,
LEFT-ALT, RIGHT-ALT. Note that shift-tab is the same as backtab. The
keyword ENTER refers to the enter key on the numeric keypad whereas
NEWLINE is the enter key with the alphabet.
The <3270 Function> specifies a 3270 function to bind the OS/2
keypress to. Possible values are UP, DOWN, LEFT, RIGHT, NEWLINE,
HOME, TAB, BACKTAB, END, FORWARD-WORD, BACKWARD-WORD, INSERT, DELETE,
BACKSPACE, KILL-WORD, BACKWARD-KILL-WORD, ERASE-EOF, ERASE-INPUT, PF1,
PF2, PF3, PF4, PF5, PF6, PF7, PF8, PF9, PF10, PF11, PF12, PF13, PF14,
PF15, PF16, PF17, PF18, PF19, PF20, PF21, PF22, PF23, PF24, CLEAR,
ENTER, PA1, PA2, PA3, SYSREQ, RESET, ATTN, MENU.
A sample TN3270.KEY file looks like:
; this is a sample TN3270.KEY file. It should be in either
; the current directory or in the directory pointed by the environment
; variable TMP.
escape clear ; bind escape to clear (the default anyway)
control-'a' home
newline newline; make the keyboard enter just do a newline
right-control enter ; make the right control key execute commands
enter enter ; make the numeric keypad enter key execute cmds
shift-backspace pf3 ; shift backspace invokes the pf3 function key
shift-tab tab ; make shift-tab go to the next field
Limitations
-----------
There are some control combinations which are processed by OS/2 and
not passed to the application program. Since TN3270 is never informed
when they are pressed, it is not possible to bind to these keys.
These keys are:
control-'1'
control-'2'
control-'3'
control-'4'
control-'5'
control-'6'
control-'7'
control-'8'
control-'9'
control-'0'
control-'-'
control-'='
control-';'
control-'\''
control-'/'
control-'.'
control-','
control-'`'
alt-f4
alt-f5
alt-f7
alt-f8
alt-f9
alt-f10
alt-tab
alt-escape
shift-escape
control-escape
-------------------------------------
Default key bindings
--------------------
NEWLINE ENTER
ENTER ENTER
ESCAPE CLEAR
PAGEUP PF7
PAGEDOWN PF8
CONTROL-END ERASE-EOF
CONTROL-LEFT BACKWARD-WORD
CONTROL-RIGHT FORWARD-WORD
CONTROL-F1 PA1
CONTROL-F2 PA2
CONTROL-F3 PA3
SHIFT-F1 - SHIFT F13 PF13 - PF24
ALT-'1' PA1
ALT-'2' PA2
ALT-'3' PA3
ALT-'M' MENU
CONTROL-']' MENU