This documentation supports the 20.08 version of BMC Discovery.

To view an earlier version of the product, select the version from the Product version menu.


The tw_reasoningstatus utility enables you to view the status of the Reasoning service. Typically this utility is used by Customer Support as a troubleshooting tool for investigating possible problems.

Automatic use of tw_reasoningstatus

Reasoning runs the same status check automatically every 15 minutes and outputs the results in the tw_svc_reasoning.log file.

To use the utility, type the following command at the $TIDEWAY/bin/ directory:

tw_reasoningstatus [options] 

where options are any of the options described in the following table and the common command line options described in Using command line utilities.


Command Line Option


--consolidation-statusShow only the consolidation status.

Show only the BMC Discovery Outpost status.

--discovery-statusShow only the discovery status

--waiting, -w

Lists information for all endpoints which are on hold waiting for information from the discovery of a different endpoint.


Expands the information provided by --waiting to include information about all endpoints being held waiting for discovery. This option is ignored if --waiting is not specified.

-u, --username=NAME

Specifies the name of the BMC Discovery user. If no name is specified, BMC Discovery uses the default, system.


User example

In the following examples, you can view the reasoning status and that of BMC Discovery Outposts:

To view the status of the Reasoning service

Type the following command:

[tideway@appliance01 ~]$ tw_reasoningstatus --username=system
Password for BMC Discovery UI user system:
Discovery appliances:
  Discovery_Appliance []

                               |   ECA Engine
                               |       0 |       1
                  Event engine |         |
                       Status: | running | running
                Queued events: |       0 |       0
  Events processing (maximum): |   0 (1) |   0 (1)
               Actions loaded: |     222 |     222
                 Rules loaded: |   24337 |   24337
                               |         |
              Discovery engine |         |
                       Status: | running | running
              Queued requests: |       0 |       0
               Endpoint count: |       0 |       0
          Endpoint throttling: |   False |   False

Generator status:
  Range schedule A
    192.168.92-95.* (1024 endpoints)
Every week on Wednesday, starting at 10:45 until midnight six days later
[tideway@appliance01 ~]$

If you do not provide a password, you are prompted for one.

To view the BMC Discovery Outpost status

[tideway@appliance01 ~]$ tw_reasoningstatus --discovery-outposts
  Name:           Local discovery
  Id:             e10da13871621dcc2abc7f00000105ca
  Scan Ranges:    Allow all IPs
  Exclude Ranges: None
  Version:        Internal
  Last contact:
    Discovery_Appliance: 2020-05-06 14:13:16 BST

  Name:           outpost01
  Id:             6fa1b63871646f6a1e800a3123e30b38
  Scan Ranges:    Allow all IPs
  Exclude Ranges: None
  Version: (release 807173)
  Last contact:
    Discovery_Appliance: 2020-05-06 14:13:17 BST

[tideway@appliance01 ~]$
Was this page helpful? Yes No Submitting... Thank you