Running the Keyboard Configuration Program

Customizing Special CA Automation Point Files › Customizing Keyboard Parameter Files › Running the Keyboard Configuration Program

Running the Keyboard Configuration Program

The CA Automation Point keyboard configuration program can help you customize the keyboard parameter file. If the standard files do not exactly meet your needs, use the utility to redefine the appropriate keys.

To run the CA Automation Point keyboard configuration program

Start Configuration Manager.
Choose Expert Interface, Automation, Automation Point Desktop Settings.
Click Customize Keyboard. The Keyboard dialog displays.
In the Input Key File field, enter an existing keyboard file name or use the default. In the Output Key File, type the new file name (with the extension .key) where your new definitions will be stored.
Click OK. The keyboard configuration program starts.

When prompted, press the key that you want to define. Do not press the Alt or Shift key.

The program determines the value associated with the location of the key and displays that number on the first line. Both the current and default definitions for the key appear. For example, if you press the A key, the following output is produced:

Scan: 30
Current key definitions:
   KEY=SOH,SCAN=30(ctrl),map=(automate)
   KEY=A,scan=30(upper),map=(terminal,automate)
   KEY=a,SCAN=30(lower),map=(terminal,automate)
   KEY=ALT_A,SCAN=30(alt),map=(automate)
Default key definitions:
   KEY=SOH,SCAN=30(ctrl),map=(automate)
   KEY=A,SCAN=30(upper),map=(terminal,automate)
   KEY=a,SCAN=30(lower),map=(terminal,automate)
   KEY=ALT_A,SCAN=30(alt),map=(automate)

Current definitions are listed. Press key:
K to keep, A to add, D to delete, M to modify,
R to use defaults, Q to write file:

Select any of the options that the program presents next, such as:

Option	Explanation
K	Keep the current definition (if any).
A	Add a definition.
D	Delete all current definitions. The program asks you to confirm your selection. Answer Y to delete all current definitions.
M	Delete one or more definitions. The program displays the definitions one at a time and lets you keep or delete each definition. To change an incorrect definition, delete it and replace it with a correct one.
R	Replace the current definitions with the default definitions. Answer Y to replace the current definitions.
Q	Exit the program.

After you select an option, answer any additional questions that the program asks.

When you have defined all appropriate keys, exit the program by pressing a key and selecting Q for quit.

Example 1:

The following example shows how to create a key definition.

Suppose you want to associate an IRPT instruction for your mainframe session with keystrokes CTRL+ALT+2. According to the previous key map table, the operation for an IRPT instruction is 3270_IRPT.

To create a key definition

Run the keyboard configuration program.
Press the key to which you want to assign the IRPT instruction (in this example, 2).
Type A to add a definition.
Type the operation for the instruction (in this example, the operation is 3270_IRPT).
Type the first keystroke (In this example, CTRL is the first shift operation).
Type the remaining keystrokes (In this example, ALT is the next shift operation).
Press Enter to indicate there are no more shift operations.
Enter your map request. See the Command and Keyword Reference Guide for details on the MAP parameter.
When you are finished with the map prompt, press Enter.
To save your definition, type Y.

Example 2:

The following table displays more sample key definitions and how they work:

Key Definition	How it works
KEY=a,SCAN=30(LOWER)	Define key 30 as a lowercase a.
KEY=A,SCAN=30(UPPER)	Define key 30, shifted, as an uppercase a.
KEY=SINGLE_QUOTE,SCAN=40(SHIFT)	Define key 40, shifted, as a single quotation mark.
KEY=PF1,SCAN=2(ALT), MAP=TERMINAL	Define Alt+2 as PF1 on terminal emulator windows.
KEY=QUIT,SCAN=61	Define key 61 as the Quit key.
KEY=3270_IRPT,SCAN=2(CTRL,ALT), MAP=TERMINAL	Define Ctrl+Alt+2 as a 3270_IRPT operation.