The dsom utility is a command-line utility program used to manage server processes. At present, server processes that can be managed are limited to those present in the Implementation Repository. The choice of Implementation Repository is determined by the environment variable SOMDDIR. The dsom utility can be used to start, restart, stop, list, enable, or disable server processes. Note: The dsom command requires somdd to be running on the machine in which the server process is (or will be) located.
The syntax of the dsom command is as follows:
dsom <cmd> { impl_alias1 [impl_alias2 ...] |-a}
where <cmd> can be any one of the terms: start, restart, stop, list, disable, or enable. Each impl_alias is the server-alias name for a server process All forms of the command take one or more server-alias names, or a wild card option -a. The -a will be replaced with all of the server-alias names present in the Implementation Repository.
For example, to start one or more server processes, the command takes the form:
dsom start { impl_alias1 [impl_alias2 ...] | -a }
To restart one or more server processes:
dsom restart { impl_alias1 [impl_alias2 ...] | -a }
Note: A server registered (using regimpl) as "nonstoppable" cannot be terminated using the "dsom stop" command or its programmatic equivalent, SOMDServerMgr::somdShutdownServer.
To stop one or more server processes:
dsom stop { impl_alias1 [impl_alias2 ...] | -a }
Note: A server registered (using regimpl) as "nonstoppable" cannot be terminated using the "dsom stop" command or its programmatic equivalent, SOMDServerMgr::somdShutdownServer.
To list the status of one or more server processes:
dsom list { impl_alias1 [impl_alias2 ...] | -a }
To prevent the server processes from starting, use the disable command. To disable one or more server processes:
dsom disable { impl_alias1 [impl_alias2 ...] | -a }
A previously disabled server process can be enabled by the enable command. To enable one or more server processes:
dsom enable { impl_alias1 [impl_alias2 ...] | -a }