Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 1 Using TIBCO Object Service Broker Utilities : hrncr (TIBCO Object Service Broker Data Object Broker)

hrncr (TIBCO Object Service Broker Data Object Broker)
Syntax
hrncr [arguments] [subcommand]
Platforms
Windows, Solaris
Description
This command is used to start, maintain, and stop the Data Object Broker. By default it starts the Data Object Broker, and further subcommands can be used to operate and shut down the Data Object Broker.
See Also
TIBCO Object Service Broker for Open Systems Installing and Operating for more information on subcommands used with the hrncr utility.
Arguments
 
-c hurondir
Overrides the path to the TIBCO Object Service Broker huron.dir file. By default, this file is in the directory pointed to by the HURONDIR environment variable, if it exists, or in the TIBCO Object Service Broker database directory.
-d databasedir
Overrides the TIBCO Object Service Broker database directory. By default this is under the TIBCO Object Service Broker installation directory (%OS_ROOT%\database in Windows or ${OS_ROOT}/database in Solaris).
Allows forking so that a new window appears for the Data Object Broker supervisor. This window remains open for as long as the Data Object Broker is running.
-h huronpathdir
Overrides the TIBCO Object Service Broker installation directory. By default this is extracted from the OS_ROOT environment variable. If the OS_ROOT variable is not set, this argument must be specified.
-l logdir
Overrides the TIBCO Object Service Broker log directory. By default this is the log directory under the TIBCO Object Service Broker installation directory (%OS_ROOT%\log in Windows or ${OS_ROOT}/log in Solaris). This argument is ignored if the Data Object Broker is active.
-o parmoverrides
Overrides one or more Data Object Broker parameters. Data Object Broker parameters are normally set in the crparm file (%OS_ROOT%\database\crparm in Windows, ${OS_ROOT}/database/crparm in Solaris). Parameters set with this argument override those in the crparm file. The syntax is:
-p parmfile
Overrides the location of the Data Object Broker parameter file. By default this is under the TIBCO Object Service Broker database directory (%OS_ROOT%\database\crparm in Windows or ${OS_ROOT}/database/crparm in Solaris).
Subcommands
The following subcommands are available:
canceluser=userid
canceluser= userid;terminalid
canceluser= userid;commnum
Disconnects a user ID from the Data Object Broker specified by dob_jobname. An optional terminal ID may be supplied if the same user is logged in more than once.
If DUPUSERID is set to Y, and you enter just a user ID, you are prompted to add a unique connection identifier (commnum) to the command.
dboffline=segname or segnumber
dbonline=segname or segnumber
Stop the Data Object Broker without the normal shutdown procedure. This subcommand should be used only if the Data Object Broker is not responding to a shutdown command or if there is an urgent need to bring it down quickly.
Solaris: The last several lines of the Data Object Broker log are copied to stdout as well as all subsequent log entries. This subcommand must be terminated by the Break key.
parm=parmname=value
shutdown or stop
Shut down the Data Object Broker in an orderly fashion. The request is sent to the active Data Object Broker. The shutdown procedure can take anywhere from half a minute to a couple of minutes, depending on what activity had been going on shortly before shutdown.
Submit a journal spin job, either immediately (i) or deferred until the next checkpoint (d).
The state of the Data Object Broker is written to the screen (Windows) or stdout (Solaris). If the Data Object Broker is running, the exit code from this subcommand is 0; otherwise it is 1.
stopserver=alldbms | allhuron | allservertype | allremote | svrid serverid | serveruserid
Specify a connection ID, a serverid, or use the all argument. Its syntax is:
alldbms  Stop all external database servers
allhuron  Stop all inbound connections
allservertype  Stop all servers of type servertype, for example, allprs stops all peer servers
allremote  Combines alldbms and allprs
svrid serverid  Stop all external servers with ID serverid
serveruserid  Stop all servers with user ID of serveruserid
The connection ID and serverid arguments can use the wildcard asterisk (*) as a suffix. For example, serverid=srv* means include all IDs that have the prefix “srv”.
traceid=userid
Traces all Data Object Broker service activity for the given user ID. You can specify a full system service trace using the value sstrace.
Environment Variables
OS_ROOT
Set this to indicate the directory where TIBCO Object Service Broker is installed.
HURONDIR
Set this if the TIBCO Object Service Broker directory is not located in the default location (%OS_ROOT%\database\huron.dir in Windows or ${OS_ROOT}/database/huron.dir in Solaris).
Files
For a full description of these files, refer to Appendix A, TIBCO Object Service Broker Files.
Related Utilities

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved