HELPLIB.HLB  —  LBXPROXY
    Starts a Low-Bandwidth X (LBX) proxy server.

    LBX is an X server extension that performs compression of the X
    protocol. LBX was developed for those configurations where the
    display server is separated from the client by a slow speed line
    such as a 56K dial-in modem or a wide-area network (WAN).

    The LBX proxy server appears to the client as any other X server.
    The proxy server accepts a connection request from a client
    program and acts as an intermediary between the client and the
    X server. Communication between the proxy server and the client
    uses the standard X protocol. Communication between the proxy
    server and the X server uses an LBX-enhanced X protocol.

    Format:

    LBXPROXY [qualifiers]

1    /ATOMS

    /ATOMS=file-specification

    Specifies the file that the proxy server should use for atoms
    control. The file SYS$MANAGER:DECW$ATOMCONTROL.TEMPLATE contains
    an example of an atom control file. This qualifier cannot be
    specified if the NOATOMS or NOLBX option is specified for the
    /OPTIONS qualifier.

    The default is /ATOMS=SYS$MANAGER:DECW$ATOMCONTROL.DAT.
    However, effectively the default is not to use atom
    control, because the installation process does not convert
    the SYS$MANAGER:DECW$ATOMCONTROL.TEMPLATE file to the
    SYS$MANAGER:DECW$ATOMCONTROL.DAT file.

    At startup, the LBX proxy server "pre-interns" the atoms
    specified in the atom control file. The atom control file also
    controls when the proxy server should delay sending data to the X
    server. This is done by specifying the following:

    o  Minimum data length required before the server delays any
       data.

    o  Which atoms should be delayed only when a window manager is
       running on the same connection.

    The format of the atom control file is documented in the
    SYS$MANAGER:DECW$ATOMCONTROL.TEMPLATE file.

2    /CHEAT

    /CHEAT={ERRORS | EVENTS | NONE}

    Specifies the level of cheating allowed on the X protocol for
    the sake of improved performance. The X protocol guarantees to
    the requesting party that all corresponding replies, events, or
    errors are returned to the requester in the same order as the
    original requests. The ERRORS option allows the proxy server to
    violate the X protocol with respect to errors. The EVENTS option
    allows the proxy server to violate the X protocol with respect
    to errors and events. The NONE option specifies that no protocol
    cheating is allowed.

    The default is /CHEAT=NONE.

                                 WARNING

       Some X applications may rely upon the correct ordering
       of events and errors. Enabling cheating may cause these
       applications to fail. Use this option at your own risk.

3    /DISPLAY

    /DISPLAY={"network-address" | logical-name | device-name}

    Specifies a network address, logical name, or device name that
    references the X server to which the proxy server should connect.
    A network address must be in the following form:

    "[transport/][node][:]:display[.screen]"

    This option is ignored for managed proxy servers.

    The default is /DISPLAY=DECW$DISPLAY.

4    /FIXED_SERVER

    /FIXED_SERVER
    /NOFIXED_SERVER

    Specifies that the proxy server should fail to start if the
    server number specified by the /SERVER qualifier is not
    available. See /SERVER qualifier for more information about
    server numbers. This option is useful for starting standalone
    servers as detached processes. In this case, the proxy server has
    no method to return the selected server number. This option is
    ignored for managed proxy servers.

    The default is /NOFIXED_SERVER.

5    /MAXSERVER

    /MAXSERVER=value

    Specifies the maximum number of X servers to which this proxy
    server can connect. This option is ignored for standalone
    servers. Specify a value from 1 to 63.

    The default is /MAXSERVER=20.

6    /MOTION

    /MOTION=value

    Specifies the maximum number of pointer motion events that are
    allowed to remain unanswered between the proxy server and the X
    server. Specify a value from 1 to 32767.

    The default is /MOTION=8.

7    /ONERROR

    /ONERROR={RECONNECT | TERMINATE}

    Specifies the action taken when the proxy server encounters an
    internal error. This usually occurs when the proxy server looses
    its connection to the X server.

    RECONNECT   Specifies that the proxy server should clean up
                its internal state information and await further
                requests. If the proxy server is a standalone server,
                this option also specifies that the proxy server
                should reconnect to the X server. For managed proxy
                servers with multiple connected X servers, the proxy
                server will try to reconnect each server connection
                when it fails.
    TERMINATE   Specifies that the proxy server should exit. For
                managed proxy servers with multiple connected X
                servers, the proxy server will terminate only if
                all X server connections fail.

    The default is /ONERROR=TERMINATE.

8    /ONEXIT

    /ONEXIT={NOACTION | RESET | TERMINATE}

    Specifies the action taken by this proxy server when the last
    client exits.

    NOACTION    Specifies that the proxy server should continue
                running.
    RESET       Specifies that the proxy server should clean up
                its internal state information and await further
                requests. If the proxy server is a standalone server,
                this option also specifies that the proxy server
                should reconnect to the X server.
    TERMINATE   Specifies that the proxy server should exit.

    The default is /ONEXIT=NOACTION.

9    /OPTIONS

    /OPTIONS=(option-list)

    Specifies the optimizations to use for this proxy server. With
    the exception of the ALL and NONE options, each option has
    a NOoption form that disables the option. To enable a small
    number of options, use a combination of the NONE and the desired
    options. For example, /OPTIONS=(NONE,IMAGE) suppresses all
    optimization with the exception of image compression. To disable
    a small number of options, use a combination of the ALL and the
    undesired options. For example, /OPTIONS=(ALL,NOIMAGE,NOGRAPHICS)
    suppresses image and graphics optimization.

    ALL           Enables all optimizations. The ALL and NONE options
                  are mutually exclusive.
    NONE          Disables all optimizations. The ALL and NONE
                  options are mutually exclusive.
    [NO]ATOMS     Enables [disables] reading of the atoms control
                  file. The NOATOMS option is mutually exclusive with
                  the /ATOMS qualifier.
    [NO]GRABCMAP  Enables [disables] color map grabbing.
    [NO]COMP      Enables [disables] stream compression.
    [NO]DELTA     Enables [disables] delta request substitutions.
    [NO]GRAPHICS  Enables [disables] reencoding of graphics requests
                  (other than image-related requests).
    [NO]IMAGE     Enables [disables] image compression.
    [NO]INTERNSC  Enables [disables] short circuiting of InternAtom
                  requests.
    [NO]LBX       Enables [disables] all LBX optimizations
                  (equivalent to [NO]ATOMS, [NO]GRABCMAP,
                  [NO]GRAPHICS, [NO]IMAGE, [NO]INTERNSC, and
                  [NO]WINATTR). The [NO]LBX option is mutually
                  exclusive with any of the options controlled by
                  [NO]LBX. The NOLBX option is mutually exclusive
                  with the /ATOMS qualifier.
    [NO]RGB       Enables [disables] color name to RGB mapping in the
                  server. The NORGB option is mutually exclusive with
                  the /RGB qualifier.
    [NO]SQUISH    Enables [disables] squishing of X events.
    [NO]TAGS      Enables [disables] use of tags.
    [NO]WINATTR   Enables [disables] GetWindowAttributes/GetGeometry
                  grouping into one round trip.
    [NO]ZEROPAD   Enables [disables] zeroing out unused pad bytes in
                  X requests, replies, and events.

    The default is /OPTIONS=ALL.

10    /PARTIAL

    /PARTIAL
    /NOPARTIAL

    Specifies that this proxy server is allowed to initialize even
    when it cannot open all transport sockets specified by the
    /TRANSPORT qualifier. These transport sockets are used to receive
    client requests. Note that if the proxy server detects that one
    of the sockets is in use by another task, the server fails to
    initialize with the server number in use, and the next server
    number is tried (as discussed in the description of the /SERVER
    qualifier).

    The default is /NOPARTIAL.

11    /RGB

    /RGB=file-specification

    Specifies the file describing the color name to RGB resolution
    in this proxy server. This qualifier cannot be specified if the
    NORGB option is specified for the /OPTIONS qualifier.

    The default is /RGB=SYS$MANAGER:DECW$RGB.DAT.

12    /SERVER

    /SERVER=server-number

    Specifies the server number to assign to this proxy server.
    Specify an integer from 0 to 63.

    The proxy server first attempts to initialize using the specified
    server number. If an active server is already using the specified
    number, the proxy server tries the next lower number. This
    process is repeated until an unused server number is found or
    until the proxy server tries the number 0 and fails. If the
    number 0 fails and the number specified was not 63, the server
    number wraps and attempts are tried starting with the number
    63. The process continues until all numbers have been tried. If
    all numbers are in use the proxy server fails to initialize and
    terminates.

    For managed proxy servers, the search for a free server number
    always starts at 63; any number specified by this qualifier is
    ignored.

    A standalone server started as a subprocess always prints out
    the server number finally used on SYS$ERROR. For standalone
    proxy servers that are detached processes, use the /FIXED_SERVER
    qualifier to force the server to use the specified server number
    or fail. Otherwise, there is no method to determine the server
    number actually used by the server.

    The default is /SERVER=63.

13    /TAGCACHE

    /TAGCACHE=cache-size

    Specifies the size of this proxy server's tag cache (in bytes).
    Specify the value 0 to disable tag caching.

    The default is /TAGCACHE=1048576 (2^20).

14    /TRANSPORTS

    /TRANSPORTS="transport-string"

    Specifies the transports that this proxy server monitors for
    incoming client requests. If the /PARTIAL qualifier is not
    used, all transports specified by this qualifier must initialize
    successfully; or the proxy server fails to initialize with the
    server number in use, and the next server number is tried (as
    discussed in the description of the /SERVER qualifier).

    The default is /TRANSPORTS="LOCAL,DECNET,TCPIP".

15    /ZLEVEL

    /ZLEVEL=compression-level

    Specifies the Zlib compression level used for stream compression.
    Specify an integer from 1 (least compression) to 9 (most
    compression).

    The default is /ZLEVEL=6.
Close Help