streamtool getdomainhoststatus
The streamtool getdomainhoststatus command returns the status of the IBM® Streams domain controller service on the host.
Usage
getdomainhoststatus >>-+-----------------------+--+---------+-----------------------> '-+- -d----------+--did-' +- -h-----+ '- --domain-id-' '- --help-' >--+-----------------+--+-----------------------+-------------->< '- --trace--level-' '-+- -v--------+--level-' '- --verbose-'
Authority
If the domain controller service is running as a Linux system service, you must have root authority and you must run this command on the host for which you want the status.
If no system service is registered, the command assumes that the service is unregistered, and root authority is not required.
Description
If the domain controller service is running as a registered system service, the command returns status of the system service. To configure the domain controller service to run as a system service, run the streamtool registerdomainhost command.
If no system service is registered, the command assumes that the service is unregistered. The command displays information about whether the unregistered service is running or not running.
Options and arguments
- -d, --domain-id did
Specifies the domain identifier.
If you do not specify this option, IBM Streams uses the domain name that is set in the STREAMS_DOMAIN_ID environment variable. By default, that domain name is StreamsDomain. If you are using the interactive streamtool interface, it uses the name of the active domain for the current streamtool session or else it prompts you for the domain name.
The active domain for the current streamtool session is set every time that you successfully run a streamtool command with a -d or --domain-id option. Alternatively, you can run the streamtool domain command in the interactive interface.
- -h, --help
Specifies to show the command syntax.
- --trace level
Specifies the trace setting. The following valid levels are listed in order of increasing verbosity, which is to say that the first level in the list generates the least amount of information:
- off
- error
- warn
- info
- debug
- trace
- -v,--verbose level
Specifies to provide more detailed command output. The verbosity level can be 0-3, where 0 disables detailed reporting and each increment provides more detailed output.