|
Start the Listener
The following directives are provided to start ODXNET from
the command line.
odxnet [<cnfgfile>]
 [-port=n]
[-maxsons=n]
[-bufsize=n]
[-nopools]
[-nohostaddresslookup]
[-NoPrintfs]
[-idletimeout=numminutes]
[-nontservice]
[-debug=ALL
| PROCESS | APPS | CONNECTIONS]
[-DFILE=<filename>]
cnfgfile
Configuration filespec. See Configuration
File for more details.
odxnet /usr/omnidex/demo/odxnet_7444.cfg
 Options
defined in the configuration file can be over-ridden by passing
the same option with a different value. For example, assume
preconnected processes are defined in the configuration file,
odxnet_7444.cfg. The following will cause the listener to
be started without starting any preconnected processes.
odxnet /usr/omnidex/demo/odxnet_7444.cfg -noprecon
-port=n
This option sets or specifies the listener port-id number
for the ODXNET process. If a configuration file is used, this
option is not necessary. This number is specified in the client
data source file.
odxnet -port=1232
-maxsons=n
Maximum number of son processes to allow for this listener.
odxnet -port=1232 -maxsons=120
-bufsize=n
Buffer size to use for send/receive and compression exercises.
odxnet -port=1232 -bufsize=512
-nopools
Starts ODXNET without starting any default pooled processes
or configured pooled processes.
odxnet -port=1232 -nopools
-nohostaddresslookup
Skip dsn lookup for incoming client to translate its IP address
to a network name.
odxnet -port=1232 -nohostaddresslookup
-NoPrintfs
Skip displaying information to the console when ODXNET is
running.
odxnet -port=1232 -NoPrintfs
-idletimeout=numminutes
The server side connection is closed after client connection
has been idle numminutes.
odxnet -port=1232 -idletimeout=20
-nontservice
This is a Windows only option.
This option allows a listener to be run interactively when
odxnet has already been installed as a service. See also:
Windows Service.
odxnet -port=1232 -nontservice
top
Shut Down the Listener
The following directives have been provided to shutdown a
running ODXNET process. These directives do not apply to an
ODXNET process that is running as a Windows
Service.
odxnet [-shutdown]
[-delay=n]
[<cnfgfile>]
[-port=n]
The
listener port id must be passed with the -shutdown directive.
This can be passed with the -port=n option, where n is the
listener port id, or in the configuration file.
-shutdown
Use this option to halt a running ODXNET process.
odxnet -port=1232 -shutdown
If the process is running interactively, you can terminate
the listener from a separate server session with the -shutdown
command. Or, within the same server session, CTRL
+ c will also terminate the listener process.
-delay=n
Shuts down the listener after n seconds, to allow active
queries to complete.
odxnet -port=1232 -shutdown -delay=90
-port=n
The listener port id number to shutdown. If omitted, the
configuration filespec containing the listener port id, must
be passed.
odxnet -port=1232 -shutdown
cnfgfile
The configuration file containing the listener port id number
that will be shut down. If omiited, the -port=n option must
be passed.
odxnet /usr/omnidex/demo/odxnet_7444.cfg -shutdown
top
Install ODXNET as a Windows
Service
 The
following directives have been provided to install and maintain
ODXNET as a Windows service.
odxnet [<cnfgfile>]
[-ntservice=<unique
service name>]
[-ntsrvaction=
[INSTALL
| INSTALL_AUTO | DELETE |
START | PAUSE | CONTINUE | STOP]]
cnfgfile
The configuration file is required to install ODXNET as a
Windows service. cnfgfile is the fully qualified filespec
of the ODXNET configuration file.
odxnet c:\omnidex\demo\odxnet_7444.cfg -ntsrvaction=INSTALL
-ntservice=unique_service_name
Defines a name for the Windows service, allowing multiple
ODXNET processes to be installed as a service.
odxnet c:\omnidex\demo\odxnet_7444.cfg -ntsrvaction=INSTALL
-ntservice=ODXNET_7444
odxnet c:\omnidex\demo\odxnet_1232.cfg -ntsrvaction=INSTALL
-ntservice=ODXNET_1232
-ntsrvaction=option
[-ntsrvaction=
[INSTALL
| INSTALL_AUTO | DELETE |
START | PAUSE | CONTINUE | STOP]]
INSTALL - Installs
ODXNET as a service. Startup type is set to Manual.
INSTALL_AUTO
- Installs ODXNET as a service. Startup type is set to Automatic.
DELETE - Delete
ODXNET as a service.
START - Starts
the ODXNET service.
PAUSE - Pausing
the running ODXNET service.
CONTINUE - Restarts
the paused ODXNET service.
STOP - Stops
the running ODXNET service.
The
last four actions (START, PAUSE, CONTINUE, and STOP) can all
be performed using the Windows Service Manager. These options
are provided for convenience.
top
Display Child Process Information
The following directive has been provided to display information
about child processes connected to the current listener.
odxnet [-admin=[GENERAL | SONLIST | ALL]]
[<cnfgfile>]
[-port=n]
-admin=[GENERAL | SONLIST | ALL]
This option displays information about all the child processes
currently connected to the specified, running listener. This
option is used after the listener has been started.
GENERAL
- displays statistics concerning the number of clients
connected.
SONLIST - displays
a list of the child processes running through the listener.
ALL - displays
both the GENERAL and SONLIST information.
odxnet -port=1232 -admin=ALL
cnfgfile
The ODXNET configuration file containing the listener port
ID. If omitted, the -port=n option must be passed, where n
is the listener port ID.
odxnet /usr/omnidex/demo/odxnet_7444.cfg -admin=ALL
-port=n
The listener port ID. If omitted, the ODXNET configuration
file containing the listener port ID must be passed.
odxnet -port=7444 -admin=GENERAL
top
Get Help
-help | -?
This option displays helpful information about running odxnet.
odxnet -help
odxnet -?
top
Get Version Information
-version
This option displays the following version information:
odxnet -version
top
|
Start
the Listener