switchkey(X)                  06 January 1993                   switchkey(X)


 Name

    switchkey - establish modifier keys for screen-switching from console
    multiscreens running Xsco server or

 Syntax


    switchkey -[a|A][c|C][s|S]


 Description

    The Xsco server and  support screen-switching between 10 or 12 screens,
    depending on the number of function keys on the console keyboard. The
    default screen-switch key sequence for the Xsco server is is <Ctrl> <Alt>
    <Fn> and for
     it is <Alt> <Fn>, where <Fn> is function key 1 through 10 or 1 through
    12.

    If this key sequence conflicts with programs running under the Xsco
    server or , redefine the key sequence with switchkey.  switchkey allows
    the console user to select a different key sequence for switching from
    console multiscreens running either the Xsco server or .  switchkey does
    not affect screen-switching from any other console multiscreens.

    switchkey requires either of the following conditions:

    +  you must be at the console.

    +  the DISPLAY environment variable is set and at least one server must
       be running.

    _________________________________________________________________________
       NOTE  If you are running a client on one multiscreen and you switch
       to another screen, the client on the original screen stops writing
       to the server until you switch back to that screen.
    _________________________________________________________________________

    switchkey is a shell script that executes two programs:  xswkey(X) for
    console multiscreens running the Xsco server, and mrgswkey for console
    multiscreens running . switchkey may be run before or after starting Xsco
    or .

 Options

    switchkey accepts any combination of the following options:

    -a or -A  selects <Alt> as the screen-switch modifier key

    -c or -C  selects <Ctrl> as the screen-switch modifier key

    -s or -S  selects <Shift> as the screen-switch modifier key

    switchkey options are not case-sensitive.  If the switchkey command
    includes the hyphen, but no letter, you can switch screens with the func-
    tion keys alone.  If no options are specified, switchkey reports the
    current screen switch key sequence.

 Examples

    To set the Xsco server and  screen-switch modifier key to <Shift><Ctrl>,
    execute any of the following command lines:

       switchkey -cs
       switchkey -Cs
       switchkey -cS
       switchkey -CS

    To restore the Xsco server and  screen-switch modifier key to the system
    default (<Ctrl> <Alt> <Fn>), execute either of the following command
    lines:

       switchkey -ca
       switchkey -CA

    To screen-switch with function keys without <Ctrl>, <Alt>, or <Shift>,
    execute the following command:

       switchkey -


 See also

    xswkey(X)