Searching for data

You can search for information in the BMC Atrium Discovery datastore from the drop-down Search box that is displayed at the top-right of each page. See Version Number and Search Bar.

You can run:

  • A basic search that enables you to search for keywords or text strings occurring in the BMC Atrium Discovery datastore.
  • An advanced search that includes additional options, including allowing you to define the set of objects to be searched and to search for destroyed objects.

You can also complete a quick search by entering a keyword in the search box directly and clicking the blue arrow to the right-hand-side.

Basic searching

A basic search enables you to search for keywords or text strings occurring anywhere in the BMC Atrium Discovery datastore.

To run a basic search

  1. In the top search box, enter the keyword or text string you want to search for.
  2. Under Section, choose the section of the datastore (Administration, Applications, Discovery, Infrastructure, or Change) that you want to search. The Any option searches all modules. See Notes on Searching for a list of the objects in each module.
  3. Under Match, choose the type of search you want to run.
    • Exact Match – Requires an exact match for an entire attribute. Note that this search is case-sensitive.
    • Word Match – Searches for entire words (separated by spaces or punctuation) and will not find partial words or substrings. For example if you search for "Windows", the system will return Windows XP, Windows 2000, and so on, but if you are searching for a person called Robertson, the search will not find details if you enter "Robert". This search is not case-sensitive.
  4. The Show DQ checkbox indicates whether or not the Data Quality indicator will be shown for each returned object. Select this checkbox if you need to view the data quality for all items. The default setting allows for faster searching when large numbers of objects are involved, as the system will not need to calculate data quality values.
  5. Click Search.
    • If objects of more than one kind are found, a page is displayed listing the number of objects of each kind found.
      Click an entry in this list to display the list of objects of this kind.
    • If objects of only one kind are found, the matching ones are listed immediately. Note that the list shows Summary attributes only, and it is possible that the text you searched for does not appear in these attributes.
  6. Click any entry to display details of the object.

Notes on searching

  • If your search returns too many matches, you can refine it by running a further search on the items.
  • You can export the results of a search in CSV format. See Exporting data.

Advanced searching

In an advanced search, you can search a defined set of objects for keywords or text strings, and you can opt to include destroyed objects as well as restrict your search to your own objects. You can also match against a regular expression.

If you are familiar with the Search Service and its query language you can use the Reports page to enter a search query. To access the Reports page, click the Search Query link. For a detailed description of the Search Service and query language, see the Search and Reporting Service. The following checkboxes are provided in each advanced search section:

Section

Checkbox

Applications

Application Instances

Groups

Infrastructure

Clusters
Coupling Facilities
Details
File Systems
Generic Elements
Hosts
Mainframes
Network Interfaces
Patches
Printers
Software Components
Storage
Subnets

Collections
Database Details
Fibre Channel HBAs
Files
Host Containers
MF Parts
Network Devices
Packages
Port Interfaces
Runtime Environments
Software Instances
Storage Collections

Discovery

Command Failures
Directory Listings
Discovered ATM Virtual Circuits
Discovered ATM Virtual Paths
Discovered Aggregated Ports Lists
Discovered Application Components
Discovered Bridges
Discovered Cards
Discovered Chassis Lists
Discovered Coupling Facilities
Discovered Database Detail Lists
Discovered Database Lists
Discovered Dependencies
Discovered Device Port Lists
Discovered Directory Entries
Discovered Disk Drives
Discovered File Systems
Discovered Frame Relay DLCI Lists
Discovered Frame Relay LMI Lists
Discovered HBAs
Discovered MFParts
Discovered MQ Details
Discovered Mainframes
Discovered Network Interfaces
Discovered Patches
Discovered Registry Entries
Discovered SNMP Table Rows
Discovered SNMP Values
Discovered Software
Discovered Storage Subsystem Lists
Discovered Sysplex Lists
Discovered Tape Drive Lists
Discovered Transaction Lists
Discovered VLAN Lists
Discovered Virtual Machines
Discovered WMI Query Results
Discovery Conditions
ECA Errors
FQDN Lists
HBA Info Lists
Host Infos
Integration Results
Listening Ports
Network Connections
Pattern Definitions Functions
Pattern Modules
Patterns
Provider Accesses
SQL Result Rows
Service Lists
Virtual Machine Lists

Device Infos
Discovered ATM Virtual Circuit Lists
Discovered ATM Virtual Path Lists
Discovered Aggregated Ports
Discovered Application Component Lists
Discovered Bridge Lists
Discovered Card Lists
Discovered Chassis
Discovered Command Results
Discovered Coupling Facility Lists
Discovered Database Details
Discovered Databases
Discovered Dependency Lists
Discovered Device Ports
Discovered Disk Drive Lists
Discovered FQDNs
Discovered Files
Discovered Frame Relay DLCIs
Discovered Frame Relay LMIs
Discovered MFPart Lists
Discovered MQ Detail Lists
Discovered Mainframe Lists
Discovered Neighbours
Discovered Packages
Discovered Processes
Discovered Registry Values
Discovered SNMP Tables
Discovered Services
Discovered Software Lists
Discovered Storage Subsystems
Discovered Sysplexes
Discovered Tape Drives
Discovered Transactions
Discovered VLANs
Discovered WMI Queries
Discovery Accesses
Discovery Runs
Exclude Ranges
File System Lists
Hardware Reference Data
Integration Points
Interface Lists
Network Connection Lists
Pattern Definitions
Pattern Executions
Pattern Packages
Process Lists
Registry Listings
Script Failures
Session Results

Administration

Attachment Categories
Charts
Lifecycle Status
Organizational Units
Recovery Times

Attachments
Families
Locations
People
Reports

To run an advanced search

  1. In the drop-down Search box, click Advanced Search. The Advanced Search box is displayed in the main frame.
  2. If you are familiar with the Search Service and its query language you can use the Reports page to enter a search query. To access the Reports page, click the Generic Search Query link.
    For a detailed description of the Search Service and query language, see the Search and Reporting Service.
  3. Under Keywords, enter the keyword or text string you want to search for. (To run a Regular expression search you must enter a valid regular expression.)
  4. In the Select match type option, choose the type of matching to be performed:
    • Exact Match - Requires an exact match for an entire attribute. Note that this search is case-sensitive.
    • Word Match - Searches for entire words (separated by spaces or punctuation) and will not find partial words or substrings. For example if you search for "Windows", the system will return Windows XP, Windows 2000, etc., but if you are searching for a person called Robertson, the search will not find details if you enter "Robert". This search is not case-sensitive.
    • Partial Match - Finds all occurrences of the string anywhere in the object's attributes. This search is not case-sensitive.
    • Regular Expression Match - Interprets the input keyword as a regular expression and matches against it. (See Regular expression searching.)
  5. Select the Include Destroyed checkbox if you want the search to include objects that have been destroyed. These will otherwise not be included in the search.
  6. Select the Show DQ checkbox if you need to view the Data Quality for all items. The default setting allows for faster searching when large numbers of objects are involved, as the system will not need to calculate data quality values.
  7. Select checkboxes to indicate the kinds of object in each module (Applications, Infrastructure, Discovery, and Administration) that you want to search. You can select any number. In each module section you can click All to choose all kinds in the module or None to deselect all kinds of objects in the module.
  8. Click Search.
    • If objects of one kind are found, the matching ones are listed. Note that the list shows Summary attributes only, and it is possible that the text you searched for does not appear in these attributes.
    • If objects of more than one kind are found, a page is displayed listing the number of objects of each kind found. Click an entry in this list to display the list of objects of this kind.
    • If the object that you were searching for was not found, click the Search Again button to return to the Advanced Search screen.
  9. To display the View Object page of the objects found, click the object name.

Notes on searching

  • The returned list displays summary attributes of each object only. Click an item in the list to access the View Object page which displays all of an object's relationships and attributes.
  • If your search returns too many matches, you can refine it by running a further search on the items. If the matches include destroyed items, an Include destroyed items checkbox is shown. Enter an additional keyword and a matching type and click Refine Search.
  • You can export the results of a search in CSV format. See Exporting data.

Regular expression searching

The advanced search option in BMC Atrium Discovery enables you to search by matching against a regular expression. A regular expression, or regex, is a pattern that can match various text strings. For example, A[0-9]+ matches any string that consists of the letter A followed by one or more digits.

Regular expressions have a defined syntax which enables you to define complex matching patterns. BMC Atrium Discovery uses the Python implementation; for full syntax and details of use, consult the Python documentation, see http://docs.python.org/lib/re-syntax.html for more information.
Below are just a few of the matching characters that you can use when constructing regular expressions.

An ordinary character, or a sequence of characters, matches that character or string.

Character

Details

.

A dot matches any single character.

^

A caret matches characters at the start of the string.

$

A dollar sign matches characters at the end of the string.

*

An asterisk matches 0 or more repetitions of the preceding regex. For example, ab* will match "a", "ab", or "a" followed by any number of "b"s.

+

A plus sign matches one or more repetitions of the preceding regex. For example, ab+ will match "a" followed by any non-zero number of "b"s; it will not match just "a".

?

A question mark matches 0 or 1 repetitions of the preceding regex. For example, ab? will match either "a" or "ab".

[ ]

Square brackets are used to indicate a set of characters that can be matched. For example, asdf will match any of the characters "a", "s", "d", or "f".

|

The vertical bar is used to separate regular expressions, any or which can be matched. For example A|B will match either A or B.

\

The backslash followed by any special character matches the special character itself.

Was this page helpful? Yes No Submitting... Thank you

Comments