switchkey(X)                    19 June 1992                    switchkey(X)


 Name

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

 Syntax

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

 Description

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

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

    switchkey requires one of following conditions:  (1) you must be at the
    console; or (2) the DISPLAY environment variable must be 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 DOS Services. switchkey may be run before or after
    starting Xsco or DOS Services.

 Options

    switchkey accepts any combination of the following options:

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

    c       selects <Ktrl> as the screen-switch modifier key

    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 has no effect.

 Examples

    To set the Xsco server and DOS Services 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 DOS Services screen-switch modifier key to
    the system default (<Alt>i), execute either of the following command
    lines:

            switchkey -a
            switchkey -A

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

         switchkey -


 See also

    xswkey(X)