IBM
Personal Communications Scripts Version 1.23
For
JAWS for Windows 3.5
These
scripts are intended to aid JAWS users of IBM Personal Communications versions
4.2 and 4.3. The following topics are covered in this file:
Configuring
Personal Communications to Work with JFW
Important
Notes About JFW Keyboard Configuration
Setting
Up Your Personal Communications Key Map
Personal
Communications Key Functions that Speak
Support
and Feedback to the Author
To
install these scripts, simply copy all the files in this package into your JFW
3.5 settings directory – this is normally C:\JFW35\SETTINGS\ENU. When you start
Personal Communications, the scripts will be loaded. You can check the version
number by pressing insert+q. If it says that version 1.24 of the scripts dated 5/23/00
is running, the scripts are installed properly.
In
order for JFW to be able to properly track the cursor in Personal
Communications emulation sessions, there are two important things you must do.
First, you need to make sure that you run with the Personal Communications
window maximized. Second, you must make sure that the cursor is a blinking
underline.
To
maximize the Personal Communications window, do the following:
1. Press alt+space to open the system
menu.
2. Press X to activate the maximize
option.
To set the underline blinking cursor option, do the following:
1. From the Personal Communications
menu bar, choose the “Appearance” menu.
2. From the Appearance menu, choose
the “Display Setup” option.
3. You will be in a list box on the
cursor option, press tab to move to the cursor shape radio button group.
4. Press up or down arrow until you
hear that the shape is set to underline (the option you do not want is block).
5. Press tab to move to the blinking
radio button group.
6. Press up or down arrow until you
hear that blink is set to yes.
7. Press the tab key to move to the
“change shape on insert” radio button group.
8. Press up or down arrow until you
hear that “no” is checked.
9. Tab to the “OK” button and press
enter.
10.To
save these changes in settings, from the menu bar, shoos file.
11.From
the file menu, choose save.
When you
are executing JFW keystrokes that use the insert key, you need to use the
insert key that is on the numeric keypad. While you are in Personal Communications,
the extended insert key (the one in the top left of the group of six keys
between the main keyboard and numeric keypad on standard desktop keyboards) is
used to toggle between overwrite and insert modes in terminal emulation
sessions. When you enter insert mode, JFW will say “insert mode”. When you
toggle to replace mode, JFW will not say anything. (Note that if you have
keyboard echo turned on, JFW will say “insert” every time you press the insert
key. So, when you enter insert mode, JFW will say “insert insert mode”.)
Also, if
you are using the standard JFW keyboard map, the extended arrow keys will
always move the PC cursor. To move the JAWS cursor, you need to use the arrow
keys on the numeric keypad.
Some of
the script key assignments in this package will only work as intended if your
Personal Communications key map matches the key map assumed by these scripts.
These key assignments are listed in the section Personal Communications Key Functions that
Speak.
Included
in this package is a Personal Communications key map that includes these key
assignments. This file is named pcs4jfw.kmp. If you would like to use this key
map, move it from your JFW settings folder to the folder called “private” in
your Personal Communications program folder. Then, start Personal
Communications and do the following:
1. Choose Assist from the menu bar.
2. Choose Keyboard setup from the pull
down menu.
3. Tab to the group of two radio
buttons where you can choose between IBM default or user-defined.
4. Select the user-defined radio
button.
5. Tab to the browse button.
6. Tab to the files list.
7. Select pcs4jfw.kmp and press enter.
8. Tab to the OK button in the
keyboard setup dialogue and press enter.
The key
map is now installed and the keys described in the following section will speak
properly.
ProcessTabKey
= Tab
Description:
If the PC cursor is in the emulation window, pressing tab will read the current
word after the cursor moves to its new position. If the cursor moves to a
position on a different line, the whole line is read.
ProcessBackTabKey
= Shift+Tab
Description:
If the PC cursor is in the emulation window, pressing tab will read the current
word after the cursor moves to its new position. If the cursor moves to a
position on a different line, the whole line is read.
ProcessShiftEnterKey
= Shift+Enter
Description:
Usually shift+enter is assigned to vertical tab in personal communications.
This script will pass shift+enter to the application and read the line the
cursor lands on.
ProcessHomeKey
= Home
Description:
Usually the home key is assigned to the first field function in Personal
Communications. This script will check to see if the PC cursor is in the
emulation window and if so, will pass a home key to the application and read
the line to which the cursor moves.
ProcessControlHomeKey
= Control+Home
Description:
Usually the control+home key is assigned to the beginning of field function in
Personal Communications. If the PC cursor is in the emulation window, the
script will pass a control+home to the application and read the line the cursor
is on.
ProcessControlEndKey
= Control+End
Description:
Usually the control+end key is assigned to the erase to end of field function
in Personal Communications. If the PC cursor is in the emulation window, this
script will pass a control+end to the application and read the line the cursor
is on.
ProcessExtendedAltDeleteKey
= alt+ExtendedDelete
Description:
In Personal Communications, the delete word function is often assigned to the
alt+delete key combination. If the PC cursor is in the terminal emulation
window, this script will pass alt+delete to the application and then read the
word that the cursor lands on.
ScreenSensitiveHelp
= insert+F1
Description:
provides screen sensative help for using JFW in menus and dialogues. Pressing
this key twice quickly will load this help file into your browser.
SayActiveCursor
= alt+delete
Description:
If the PC cursor is active in the emulation window, announces the row and
column numbers of the cursor. Otherwise gives coordinates in pixels.
ReadPreviousNonBlankLine
= Control+Y
Description:
Reads the last non-blank line before the line that the PC cursor is on. This is
often very helpful in emulated systems where the prompt is on a line several
lines above the PC Cursor. This is often the case in VM and MVS systems. It can
also provide a quick way to read the last line of command output in Unix like
systems.
SayPreviousNonBlankLineWithJAWSCursor
= Control+Shift+Y
Description:
Moves the JAWS cursor to and Reads the last non-blank line before the line that
the PC cursor is on. This is often very helpful in emulated systems where the
prompt is on a line several lines above the PC Cursor. This is often the case
in VM and MVS systems. It can also provide a quick way to read the last line of
command output in Unix like systems.
SayBottomLineOfEmulationWindow
= Control+1
Description:
Reads the bottom line of the emulated window. This line is used for status or
prompts on some emulated systems. This is not the same line as the Personal
Communications status line that can be read with the JAWS bottom line hot key,
which is by default assigned to insert+page down.
SayBottomTwoLinesOfEmulationWindow
= Control+2
Description:
Reads the bottom two lines of the emulated terminal window. In many main frame
applications, the bottom lines of the window are used to list function key
assignments or for status information. Tip: to read the top lines, use the read
emulation window hotkey which by default is assigned to control plus w.
SayBottomThreeLinesOfEmulationWindow
= Control+3
Description:
Reads the bottom three lines of the emulated terminal window. In many main
frame applications, the bottom lines of the window are used to list function
key assignments or for status information. Tip: to read the top lines, use the
read emulation window hotkey which by default is assigned to control plus w.
ReadEmulationWindow
= Control+W
Description:
Activates the JAWS cursor, moves to the top left of the emulation window, and
starts reading. The JAWS cursor will remain active when reading stops. You may
stop reading with the control key and the JAWS cursor will be on the last line
read.
ReadFromSubjectLine
= Control+S
Description:
Activates the JAWS cursor, searches for the first subject line in the current
emulation window, and starts reading. The JAWS cursor will remain active when
reading stops. You may stop reading with the control key and the JAWS cursor
will be on the last line read.
SetEmulationWindowEcho
= Control+E
Description:
When set to on, all new text that is written to the emulation window is
automatically read. Otherwise, it is not. The default is on. You may want to
turn this off if your emulated application is continuously writing a lot of
text to the screen that you do not wish to hear.
SetStatusLineEcho
= control+l
Description:
Controls the echoing of the system status portion of the Personal
Communications status line. The default is on. The entire status line can be
read at any time with insert+PageDown.
SetMarginAlert
= Control+M
Description:
When the Margin alert is on, the PC will beep or ring a bell when the cursor
reaches and moves beyond the right margin bell setting. The right margin bell
position can be moved with the increment and decrement margin bell scripts. By
default, these are assigned to control + period and control + comma.
IncrementMarginAlertColumn
= Control+.
Description:
This will move the margin bell setting to the right, increase it. If the margin
bell is turned on, the pc will beep or ring a bell when the cursor reaches or
moves beyond the margin bell column. The margin bell setting is controlled by
the set margin alert script, which, by default, is set to control plus m.
DecrementMarginAlertColumn
= Control+,
Description:
This will move the margin bell setting to the left, decrease it. If the margin
bell is turned on, the pc will beep or ring a bell when the cursor reaches or
moves beyond the margin bell column. The margin bell setting is controlled by
the set margin alert script, which, by default, is set to control plus m.
ScriptFileName
= insert+q
Description:
announces the version number and date of the Personal Communications scripts
that are installed.
These
scripts are supported by the author, Matt King, on a time-available basis. I
cannot guarantee any level of support but will do the best I can to aid with
any problems or incorporate any suggestions you may have. You may contact me at:
-
(719)
520-3006