Searching the Help
To search for information in the Help, type a word or phrase in the Search box. When you enter a group of words, OR is inferred. You can use Boolean operators to refine your search.
Results returned are case insensitive. However, results ranking takes case into account and assigns higher scores to case matches. Therefore, a search for "cats" followed by a search for "Cats" would return the same number of Help topics, but the order in which the topics are listed would be different.
Search for | Example | Results |
---|---|---|
A single word | cat
|
Topics that contain the word "cat". You will also find its grammatical variations, such as "cats". |
A phrase. You can specify that the search results contain a specific phrase. |
"cat food" (quotation marks) |
Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase. |
Search for | Operator | Example |
---|---|---|
Two or more words in the same topic |
|
|
Either word in a topic |
|
|
Topics that do not contain a specific word or phrase |
|
|
Topics that contain one string and do not contain another | ^ (caret) |
cat ^ mouse
|
A combination of search types | ( ) parentheses |
|
Synchronized configuration items (CIs)
Service Management supports synchronization of the CIs detailed in the following table.
Service Management CI | Matching UCMDB CIs | TQL Queries |
---|---|---|
Device | node | SACM Node Push |
ActualService | Service | SACM Service Push |
ServiceComponent | BusinessApplication | SACM Service Component Push |
SystemElement | ApplicationSystem, RunningSoftware and CICollection |
SACM CI Collection to System Element Push SACM System Element Push |
The following tables display the CI attribute mappings for the CIs returned by these TQL queries. For each CI type, Root represents the root CI type in the TQL query (Device, System Element, Service Component, or Actual Service). The CI attribute name appears in brackets. For example, Root[global_id], refers to the global ID attribute of the root CI.
For Device CIs, the TQL query also includes related CI types (CPU, IP Address, File System, Disk Device, Network Cards, and Running Software). In this case, Root.Cpu[0][global_id] refers to the global ID attribute of the first CPU CI related to the root CI.
Device attribute mapping
UCMDB property |
SACM property |
---|---|
Root[name] | HostName |
Root[description] | Description |
Root[global_id] | GlobalId |
Root.Asset[0][asset_tag] | AssetTag |
Root[serial_number] | SerialNumber |
First non-empty value of the following fields:
|
Model |
First non-empty value of the following fields:
|
Vendor |
Root[os_family] If the field is null, the value is from Root[root_class] If both fields are null, the value is Unknown |
OsType |
First non-empty value of the following fields:
|
OsName |
Root[os_description] | OsDescription |
First non-empty value of the following fields:
|
OsVendor |
Root[discovered_os_version] | OsVersion |
Root[memory_size] | MemorySize |
Root[bios_asset_tag] | BiosAssetTag |
Root[bios_version] | BiosVersion |
Root[bios_serial_number] | BiosSerialNumber |
Root[bios_uuid] | BiosUUID |
Root[primary_dns_name] | PrimaryDNSName |
Root[domain_name] | DomainName |
Root[net_bios_name] | NetBiosName |
Root[default_gateway_ip_address] | DefaultGatewayIPAddress |
Root[host_isvirtual] If the field is null then the value is false. |
VirtualDevice |
The following tables display CI attribute mappings for specific device CI types:
-
CPU
UCMDB property
SACM property
Root.Cpu[i][cpu_id] CpuId Root.Cpu[i][cpu_type]
If the field is null, the value is CPU Model Unknown.
CpuType
Root.Cpu[i][cpu_clock_speed] CpuClockSpeed Root.Cpu[i][cpu_vendor] CpuVendor Root.Cpu[i][core_number] CpuCoreNumber Root.Cpu[i][global_id] GlobalId -
IP Address
UCMDB property
SACM property
Root.IpAddress[i][name] IpValue Root.IpAddress[i][routing_domain] RoutingDomain Root.IpAddress[i][authoritative_dns_name] AuthoritativeDNSName Root.IpAddress[i][ip_address_type] IpType Root.IpAddress[i][global_id] GlobalId -
File System
UCMDB property
SACM property
Root.FileSystem[i][mount_point] FsMountPoint Root.FileSystem[i][disk_size]
Value is converted to GB.
FsSize
Root.FileSystem[i][filesystem_type] FsType Root.FileSystem[i][global_id] GlobalId Root.FileSystem[i][cmdb_id] Id -
Disk Device
UCMDB property
SACM property
Root.DiskDevice[i][name] DiskName Root.DiskDevice[i][model_name] DiskModelName Root.DiskDevice[i][vendor] DiskVendor Root.DiskDevice[i][disk_size]
Value is converted to GB.
DiskSize
Root.DiskDevice[i][disk_type] DiskType Root.DiskDevice[i][global_id] GlobalId -
Network Cards
UCMDB property
SACM property
Root.Interface[i][name] NetworkCardName Root.Interface[i][mac_address]
The value does not include the hyphens ('-')
MacAddress
Root.Interface[i][interface_type] NetworkCardType Root.Interface[i][interface_speed]
Value is converted to MB.
NetworkCardSpeed
Root.Interface[i][interface_role] NetworkCardRole Root.Interface[i][global_id] GlobalId -
Running Software
UCMDB property
SACM property
Root.RunningSoftware[i][product_name] ProductName Root.RunningSoftware[i][discovered_product_name] DiscoveredProductName Root.RunningSoftware[i][vendor] RunningSWVendor Root.RunningSoftware[i][version] RunningSWVersion - If the CI type of the root CI is running_software, the value is Root.RunningSoftware[i][classification].
- If the CI type of the root CI is something else (the CI type inherits from Running Software), the value is the CI type name.
RunningSWCategory
Combined list of ports from the following:
- Root.RunningSoftware[i][application_port]
- Root.RunningSoftware[i].IpServiceEndpoint*.getAt('network_port_number')
RunningSWPorts
Root.RunningSoftware[i][global_id] GlobalId
-
SACM System Element Push
UCMDB property
SACM property
First non-empty value of the following fields:
- Root[product_name]
- Root[discovered_product_name]
- Root[name]
DisplayLabel
Root[global_id] GlobalId RunningSoftware SubType Created from UCMDB Running SW <DisplayLabel> with Global Id <GlobalId> Description Root[version] Version -
SACM CI Collection to System Element Push
UCMDB property
SACM property
Root[name] DisplayLabel CICollection SubType Root[global_id] GlobalId Root[description] Description
UCMDB property |
SACM property |
---|---|
Root[name] | DisplayLabel |
Root[global_id] | GlobalId |
Root[description] | Description |
Actual Service attribute mapping
UCMDB property |
SACM property |
---|---|
Root[name] | DisplayLabel |
The value is determined based on the CI type of the root CI to be one of the following:
|
SubType |
Root[global_id] | GlobalId |
Root[description] | Description |
|
BusinessCriticality |
Note
If any of the following relationships exist In UCMDB:
-
Between ActualService and Device
-
Between ActualService and SystemElement
Service Management creates a generic ServiceComponent CI to match the requirements of the Service Management data model.