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:

 

Getting Started

Script Installation

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

JAWS Specific Keys

Support and Feedback to the Author

 

 

Getting Started

 

Script Installation

 

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.

 

Configuring Personal Communications to Work with JFW

 

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.

 

Important Notes About JFW Keyboard Configuration

 

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.

 

Setting Up Your Personal Communications Key Map

 

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.

 

 

Personal Communications Key Functions that Speak

 

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.

 

 

JAWS Specific Keys

 

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.

 

 

Support and Feedback to the Author

 

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:

 

-         MattKing@US.IBM.com

-         (719) 520-3006