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.