|
Start the Listener
The following directives are provided to start ODXSRVR from
the command line.
odxsrvr [<cnfgfile>]
 [-lport=n]
[-cport=n]
[-predescribe]
[-prefetchrows=n]
[-noprecon]
[-tracksql]
[-nohostaddresslookup]
[-NoPrintfs]
[-usememmap]
[-usesockets]
[-nontservice]
cnfgfile
Configuration filespec. See Configuration
File for more details.
odxsrvr /usr/omnidex/demo/odxsrvr_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,
odxsrvr_7444.cfg. The following will cause the listener to
be started without starting any preconnected processes.
odxsrvr /usr/omnidex/demo/odxsrvr_7444.cfg -noprecon
-lport=n
This option sets or specifies the listener port-id number
for the ODXSRVR process. If a configuration file is used,
this option is not necessary.
MPE
run odxsrvr.cs;info="-lport=1232"
Unix
odxsrvr -lport=1232
Windows
odxsrvr -lport=1232
-cport=n
-predescribe
-prefetchrows=n
-noprecon
This option over-rides any preconnected processes settings
defined in the configuration file, preventing preconnected
processes from being established when the listener is started.
MPE
run odxsrvr.cs;info="SRVR.FFL.DATA -noprecon"
Unix
odxsrvr /users/data/flatfile/oa/odxs1232.cfg -noprecon
Windows
odxsrvr c:\omnidex\bin\odxs1232.cfg -noprecon
-tracksql
-nohostaddresslookup
Skip dsn lookup for incoming client to translate its IP address
to a network name.
odxsrvr -lport=1232 -nohostaddresslookup
-NoPrintfs
Skip displaying information to the console when ODXSRVR is
running.
odxsrvr -lport=1232 -NoPrintfs
-usememmap
This is a Windows , single-tier environment only option.
This option tells ODXSRVR to use the Mapped
Memory Transport feature when the UseMappedMemory flag
is not set in the configuration file or when the configuration
file is not used.
odxsrvr -lport=1232 -usememmap
odxsrvr c:\omnidex\bin\odxs1232.cfg -usememmap
-usesockets
This is a Windows , single- tier environment only option.
This option over-rides the UseMappedMemory settings in the
configuration file. The default is to use sockets. See also:
Mapped Memory Transport.
odxsrvr c:\omnidex\bin\odxs1232.cfg -usesockets
-nontservice
This is a Windows only option.
This option allows a listener to be run interactively when
odxsrvr has already been installed as a service. See also:
Windows Service.
odxsrvr -lport=1263 -nontservice
top
Shut Down the Listener
The following directives have been provided to shutdown a
running ODXSRVR process. These directives do not apply to
an ODXSRVR process that is running as a Windows Service.
odxsrvr [-shutdown]
[-delay=n]
[<cnfgfile>]
[-lport=n]
The
listener port id must be passed with the -shutdown directive.
This can be passed with the -lport=n option, where n is the
listener port id, or in the configuration file.
-shutdown
Use this option to halt a running ODXSRVR process.
MPE
run odxsrvr.cs;info="-lport=1232 -shutdown"
Unix
odxsrvr -lport=1232 -shutdown
Windows
odxsrvr -lport=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 in UNIX and Windows or BREAK/ABORT
in MPE, will also terminate the listener process.
-delay=n
Shuts down the listener after n seconds, to allow active
queries to complete.
odxsrvr -lport=1232 -shutdown -delay=90
-lport=n
The listener port id number to shutdown. If omitted, the
configuration filespec containing the listener port id, must
be passed.
odxsrvr -lport=1232 -shutdown
cnfgfile
The configuration file containing the listener port id number
that will be shut down. If omiited, the -lport=n option must
be passed.
odxsrvr /usr/omnidex/demo/odxsrvr_7444.cfg -shutdown
top
Install ODXSRVR as a
Windows Service
 The
following directives have been provided to install and maintain
ODXSRVR as a Windows service.
odxsrvr [<cnfgfile>]
[-ntservice=<unique
service name>]
[-ntsrvaction=
[INSTALL
| INSTALL_AUTO | DELETE |
START | PAUSE | CONTINUE | STOP]]
cnfgfile
The configuration file is required to install ODXSRVR as
a Windows service. cnfgfile is the fully qualified filespec
of the ODXSRVR configuration file.
odxsrvr c:\omnidex\demo\odxsrvr_7444.cfg -ntsrvaction=INSTALL
-ntservice=unique_service_name
Defines a name for the Windows service, allowing multiple
ODXSRVR processes to be installed as a service.
odxsrvr c:\omnidex\demo\odxsrvr_7444.cfg -ntsrvaction=INSTALL
-ntservice=ODXSRVR_SALES
odxsrvr c:\omnidex\demo\odxsrvr_1232.cfg -ntsrvaction=INSTALL
-ntservice=ODXSRVR_ACCOUNTING
-ntsrvaction=option
[-ntsrvaction=
[INSTALL
| INSTALL_AUTO | DELETE |
START | PAUSE | CONTINUE | STOP]]
INSTALL - Installs
ODXSRVR as a service. Startup type is set to Manual.
INSTALL_AUTO
- Installs ODXSRVR as a service. Startup type is set to Automatic.
DELETE - Delete
ODXSRVR as a service.
START - Starts
the ODXSRVR service.
PAUSE - Pausing
the running ODXSRVR service.
CONTINUE - Restarts
the paused ODXSRVR service.
STOP - Stops
the running ODXSRVR 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.
odxsrvr [-admin=[GENERAL | SONLIST | ALL]]
[<cnfgfile>]
[-lport=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.
MPE
run odxsrvr.cs;info="-lport=1232 -admin=GENERAL"
Unix
odxsrvr -lport=1232 -admin=SONLIST
Windows
odxsrvr -lport=1232 -admin=ALL
cnfgfile
The ODXSRVR configuration file containing the listener port
ID. If omitted, the -lport=n option must be passed, where
n is the listener port ID.
odxsrvr /usr/omnidex/demo/odxsrvr_7444.cfg -admin=ALL
-lport=n
The listener port ID. If omitted, the ODXSRVR configuration
file containing the listener port ID must be passed.
odxsrvr -lport=7444 -admin=GENERAL
top
Set Security
-setsecurity
Turns on security.
top
Get Help
-help | -?
This option displays helpful information about running odxsrvr.
MPE
run odxsrvr.cs;info="-help"
run odxsrvr.cs;info="-?"
Unix
odxsrvr -help
odxsrvr -?
Windows
odxsrvr -help
odxsrvr -?
top
Get Version Information
-version
This option displays the following version information:
MPE
run odxsrvr.cs;info="-version"
Unix
odxsrvr -version
Windows
odxsrvr -version
top
|
Start
the Listener