Abstract
NETWORK STATION 5250 KEYBOARD MAPPING


Error Description

** Last updated 97/11/25 **
Minor changes to text. G. Breland
...................................
** Last updated 97/10/01 **
Created this INFO APAR.  GBreland
...................................
 
>>> ABOUT THIS INFORMATIONAL APAR
 
This informational APAR includes information
about the 5250 Emulation Keyboard mapping
function for the IBM Network Station.
This INFO APAR is appropriate for OS/400
version/release levels: Version 3 Release 2 ,
(R320), Version 3 Release 7 (R370), and
Version 4 Release 1 (R410).
Information in this INFO APAR is limited to
the 5250 Emulation Keyboard Mapping
Function.  For more information about the
IBM Network Station product, see the
INDEX INFO APAR:  II10405 .
 
NOTE: This informational apar is continued
      in informational apar II10838 .
 
..............................................
 
>>> RELATED INFORMATIONAL APARS AVAILABLE
 
For additional information, we strongly suggest you also
order Info APAR II10405 (and its' continuation apars).
II10405 also contains an INDEX of the other
AS/400 INFO APARs relating to IBM Network Stations.
 
------------------------------------------------------
 
>>> GENERAL INFORMATION (5250 KEYBOARD REMAPPER)
 
The 5250 keyboard remapping function works in
conjunction with one or more 5250 emulation
sessions on an IBM Network Station.  This function
allows the user to set or change the function
provided by a single (or combination of) keystroke
on the keyboard while the 5250 session is the
active window.
 
To access the Keyboard Remapping function,
click on the OPTION menu item from the
menu bar of an active 5250 emulation
session, the click on the item "Keyboard
Remapping...".
 
The use of the Keyboard Remapping function
is documented in the on-line help text
(from the Keyboard Remapping window, click
on the HELP button).  Some documentation
is contained in the "Getting Started"
redbook SG24-2153.  Check the release
levels or see the section below concerning
the "New Keyboard Remapping Interface".
 
......................................................
 
>>> THE MENU ITEM IS MISSING
 
The menu item "Keyboard Remapping..." is
located under the OPTION menu item on the
menu bar of an active 5250 session.  If this
menu item is not functioning or is not present
then the Menu Bar, or the Keyboard Remapping
menu item has been hidden or use has been
limited by the Administrator via the NSM
(NetworkStation Manager).  To change the
settings for use of the Keyboard Remapping
menu item, see the section later in this apar
titled "Administrator Tasks-disable keyboard
remap function".
 
.......................................................
 
>>> GRAPHICS RESOLUTION NEEDS
 
The 5250 Keyboard Remapping window contains a graphic
representation of the physical keyboard.  This interface
requires a resolution setting of 800x600 or higher.
The 640x480 setting will not allow the use of the
keyboard remapping feature.
 
Changing the resolution setting is done from the
Setup Utility (typically accessed by escaping out
of the boot sequence).  Use of the Setup Utility
is described in Chapter 8 of the Network Station
Manager manual SC41-0632.
 
......................................................
 
>>> DEFAULT KEYBOARD LAYOUT FOR 5250 EMULATION
 
The default keyboard layout for 5250 emulation has
the following assignments:
 
  FUNCTION                KEY COMBINATIONS
  -----------------------------------------
  Enter                   ENTER KEY
  Enter                   SHIFT + ENTER KEYS
  New Line                RIGHT-CTRL KEY
  Field Exit(*)           KEYPAD PLUS (+) KEY
 
   * Field Plus is equivalent in function to
     Field Exit.
 
For a complete list of the 5250 emulator keys, see the
on-line help text.
 
...........................................................
 
>>> NEW KEYBOARD REMAPPING INTERFACE
 
There is now a new interface for the keyboard
remapping function.  The new interface is easier
to use; it is easier to manipulate the functions
for each key in the keyboard remapper window.
 
The old interface for keyboard remapping is described in
the on-line text and the Redbook: " AS/400 - IBM Network
Station - Getting Started  SG24-2153 ".  This interface
can be recognized by the keyboard layout showing at the
bottom portion of the Keyboard Remapping window.
The new interface for keyboard remapping is described in
the on-line help text and in-part, by this apar (future
iterations of the manuals will include the new interface).
The new interface is recognized by the keyboard layout
showing at the top portion of the Keyboard Remapping window.
 
To obtain the new keyboard remapping interface, apply a
ptf (as described below) or obtain the latest group
PTF for your release level.
* The group PTFs are described in the information apars
II10309 (for R370), II10406 (for R320), and II10566
(for R410)...or see the Index INFO APAR II10405 .
 
The specific APAR/PTFs for the New Keyboard Interface
are as follows:
 
   R320
   ============
    New Interface - APAR: SA66060  PTF:SF42299
                    (or latest supercede, like SF43237 )
    Help Text for new interface -
                    APAR: SA66149  PTF: SF42367
                    (or latest supercede PTF)
 
   R370 and R410
   ===============
    New Interface - APAR: SA66035  PTF: SF42285
                    (or latest supercede, like SF43217 )
 
    Help Text for new interface -
                    APAR: SA66142  PTF: SF42363
                    (or latest supercede PTF)
 
...........................................................
 
>>> MAP THE ENTER AND CTRL KEYS
 
There has been an enhancement to allow changes to map
of the ENTER key and CTRL key.  A section was added to
the "Miscellaneous Preferences..." menu item (found
under the "OPTION" menu item on the pull-down menu
from an active 5250 session).  From the Miscellaneous
Preferences window, click on the "Enter/Field Exit Key"
item found on the left frame.  This new feature allows
the user to set the function of the ENTER key and the
CTRL key, if the settings are set to DEFAULT then the
settings in the Keyboard Remapper program are utilized.
However, if changes are made to this Preferences screen,
then these settings will override the default settings
in the Keyboard Remapper function.  The PTF information
that allows this new function are as follows:
 
   R320
   ======
    Change to Misc.Pref. - APAR: SA66060  PTF:SF42299
                    (or latest supercede, like SF43237 )
 
   R370 and R410
   ===============
    Change to Misc.Pref. - APAR: SA64808  PTF:SF41290
                    (or latest supercede, like SF43217 )
 
NOTE: Setting up the Preferences settings for the ENTER
      and CTRL keys will only apply to the user making
      these settings and it will only apply to the session
      (and the system) wherein the change was applied.
      Transporting these setting to other sessions or
      other userprofiles is not currently an option.
 
........................................................
 
>>> CHANGE TO NUMLOCK KEY
 
Changes have been made to the use of the NUMLOCK key
(which impacts the Keypad).  Specifically, this allows
the use of the playback accelerator keys when the
NUMLOCK is set to ON .  As always, service recommends
obtaining the latest Group PTF described in the
INFO APARs listed in the index APAR (II10405).  The
PTF information for this change are as follows:
 
   R320
   ======
    Change to NUMLOCK - APAR: SA67361  PTF:SF43237
                        (or latest supercede PTF)
 
   R370 and R410
   ===============
    Change to NUMLOCK - APAR: SA67275  PTF:SF43217
                        (or latest supercede PTF)
 
...............................................................
 
>>> FILE SEARCH ORDER
 
When a 5250 session starts, it will search for the keyboard
map file to use for this session.  The search is based, in part,
on several variables: the userprofile, the system the 5250
session is connection to, and the number of the session
(1st session to this system, 2nd session to this system, etc...)
 
The 5250 session will utilize the keyboard remapping file
it finds first, in the following search order:
  1. A session-specific file (based on the user profile,
     the name of the system connecting to, and the number
     of the session).  This will be a file that this user
     saved for THIS session for THIS system.  For example:
         SYSTEM-#.###
     (where SYSTEM=the system name, #=the session number,
      and ###=type of keyboard (like 101 or 102))
  2. A user desginated "default" file. Just like above,
     but in this case, the user designated this file
     for all sessions on all systems that this userprofile
     will open a 5250 session on.  The format for this
     file is:   DEFAULT.### (where ###=type of keyboard)
  3. A default file set by the Administrator in the NSM
     (NetworkStation Manager tool) for THIS userprofile.
  4. A default file set by the Administrator in the NSM
     for ALL userprofiles.  Like above, but in this case,
     the file was designated not just for one userprofile,
     but for all userprofiles.
  5. IBM default settings.  If no other file is located,
     or designated, then the IBM defaults for a 5250
     session are utilized.
 
.................................................
 
 
 
**NOTE*************************************NOTE**
    This informational apar is continued in
    informational apar II10838 .
**NOTE*************************************NOTE**

Local Fix (internal use)

 

Problem Summary

 

Problem Conclusion

 

Temporary Fix

 

Comments

INFORMATIONAL APAR

Circumvention

REPINNED RP97/11/25
Minor changes to text.
         G. Breland

PTFs Available

 

Affected Modules

 

Affected Publications

 


Summary Information
Status................. CLOSED  CAN
Severity............... 4
HIPER.................. No
PIN.................... Yes
Reported Component..... INFOAS400
Fixed Component........  
Failing Module.........  
Reported Release....... R410
Reported Release PTF...  
Latest Release PTF.....  
FESN................... 5NFO000
Duplicate Of...........  
Security Integrity.....



IBM disclaims all warranties, whether express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. By furnishing this document, IBM grants no licenses to any related patents or copyrights. Copyright (c) 1994, 1995, 1996 IBM Corporation. Any trademarks and product or brand names referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information.