 | IBM Endpoint Manager Inspectors Reference |
| IBM Endpoint Manager Inspectors Reference |
Win: Windows
Lin: Red Hat and SUSE Linux
Sol: SUN Solaris
HPUX: Hewlett-Packard UNIX version
AIX: IBM AIX
Mac: Apple Macintosh
Ubu: Ubuntu/Debian
WM: Windows Mobile
The version (e.g. Lin:8.1) corresponds to the version of the IEM product (8.1) in which the inspector was introduced in the client on that platform.
The version number is not shown if it is less than 8.0.
These are the keywords available for querying various aspects of the system, including the name and version of the operating sytem. This chapter also covers the keywords used to describe the vendors and types of the various processors that coexist in a typical computer system. Some of these Inspectors are system-specific, but are included to provide cross-platform compatibility.
service pack with multiplicityCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
service packCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
technology level with multiplicityCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
technology levelCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
fileset version record with multiplicityCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
fileset version recordCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
fileset version requirementCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
grub block listCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
grub bootable imageCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
grub color pairCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
grub color schemeCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
grub colorCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
grub config fileCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
grub deviceCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
grub file locationCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
grub image choiceCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
grub kernelCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
grub moduleCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
smf fmriCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
smf instanceCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
smf property groupCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
smf propertyCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
smf serviceCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
smf snapshot partCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
smf snapshotCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
smf timeCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
smf valueCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
smfCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
aparCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
biosCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
operating systemCreation Methods| Declaration | Description | Platforms (?) |
| operating system | Returns the operating system object. See operating system. | Win, Lin, Sol, HPUX, AIX, Mac, WM, Ubu:8.1 |
Properties| Declaration | Return type | Description | Platforms (?) |
| <operating system> as string | <string> | Returns a string containing the name of the operating system concatenated with the release. | Win, Lin, Sol, HPUX, AIX, Mac, WM, Ubu:8.1 |
| build number high of <operating system> | <integer> Plural: build number highs | Numeric representation of the most significant 16 bits of the build number. | Win, WM |
| build number low of <operating system> | <integer> Plural: build number lows | Numeric representation of the least significant 16 bits of the build number. | Win, WM |
| csd version of <operating system> | <string> Plural: csd versions | Returns the Corrective Service Disk version of the operating system. The szCSDVersion as returned by the GetVersionEx system call. The format varies depending on the installed service packs. For WinNT it contains a string such as "Service Pack 3", for Win95 it can contain a string such as "B". | Win, WM |
| ia64 of <operating system> | <boolean> Plural: ia64s | Returns TRUE iff the BES Client is running on Itanium. | Win, WM |
| major version of <operating system> | <integer> Plural: major versions | Returns integer which is the dwMajorVersion returned by the GetVersionEx system call. Note that while the WinNT major version tracks the release (3 for 3.51, 4 for 4.0, and 5.0 for Windows 2000, 5.1 for Windows XP), the major version for Win95 and Win98 is always 4. | Win, WM |
| minor version of <operating system> | <integer> Plural: minor versions | Numeric representation of the minor version of the operating system. | Win, WM |
| name of <operating system> | <string> Plural: names | Returns the name of the operating system as a string. Names might include Win98, WinNT, etcetera. | Win, Lin, Sol, HPUX, AIX, Mac, WM, Ubu:8.1 |
| performance counter frequency of <operating system> | <hertz> Plural: performance counter frequencies | The rate at which the performance counter is being incremented (per second). | Win, WM |
| performance counter of <operating system> | <integer> Plural: performance counters | Retrieves a 64-bit performance counter value. | Win, WM |
| platform id of <operating system> | <integer> Plural: platform ids | Returns the dwPlatformId as returned by the GetVersionEx system call. Possible values are 1 (Win95/95) and 2 (WinNT). | Win, WM |
| product info numeric of <operating system> | <integer> Plural: product info numerics | This Windows-specific inspector returns the integer from the Windows GetProductInfo API. The inspector only provides meaningful results for Windows Vista and newer versions of the OS. The major/minor version of the OS must be 6.0 or greater for the result to be meaningful. For more information, refer to the Microsoft article at http://msdn2.microsoft.com/en-us/library/ms724358(VS.85).aspx. | Win, WM |
| product info string of <operating system> | <string> Plural: product info strings | On Windows versions 6.0 and newer (Vista minimum), this inspector returns a string derived from the GetProductInfo API. It will be one of the following values:UnlicensedBusinessCluster ServerServer DatacenterServer Datacenter CoreEnterpriseServer EnterpriseServer Enterprise CoreServer Enterprise ItaniumHome BasicHome ServerServer for Small BusinessSmall Business ServerSmall Business Server PremiumServer StandardServer Standard CoreStarterStorage Server EnterpriseStorage Server StandardStorage Server WorkgroupUltimateWeb ServerUnknown. | Win, Mac:8.2, WM |
| product type of <operating system> | <operating system product type> Plural: product types | Returns the product type of the operating system, which includes Workstations, Domain Controllers and Servers. | Win, WM |
| release of <operating system> | <string> Plural: releases | Information about the release of the operating system, formatted as a <version> on the Macintosh, but a <string> on UNIX and Windows. | Win, Lin, Sol, HPUX, AIX, Mac, WM, Ubu:8.1 |
| service pack major version of <operating system> | <integer> Plural: service pack major versions | Returns the major version number of the current service pack of the specified OS. | Win, WM |
| service pack minor version of <operating system> | <integer> Plural: service pack minor versions | Returns the minor version number of the current service pack of the specified OS. | Win, WM |
| suite mask of <operating system> | <operating system suite mask> Plural: suite masks | Returns the bit-mapped suite mask for the operating system, which contains further fine-grain information about the version. | Win, WM |
| x64 of <operating system> | <boolean> Plural: x64s | Returns TRUE if the current operating system is 64-bits. | Win, WM |
cpupackageCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
processorCreation Methods| Declaration | Description | Platforms (?) |
| main processor | Returns the processor object corresponding to the main processor. | Win, Lin, Sol, HPUX, AIX, Mac, WM, Ubu:8.1 |
| processor | Returns all the processor objects defined on the machine. See processor. Example: number of processors > 1 - Returns TRUE if the computer is a multi-processor system. | Win, Lin, Sol, HPUX, AIX, Mac, WM, Ubu:8.1 |
| processor <integer> | Returns a processor object for the numbered processor. Processors are numbered from 1. | Win, Lin, Sol, HPUX, AIX, Mac:8.2, WM, Ubu:8.1 |
Properties| Declaration | Return type | Description | Platforms (?) |
| brand id of <processor> | <integer> Plural: brand ids | This inspector returns the integer known as the brand id, returned from the assembly language cpuid extended instruction. | Win, Mac:8.2, WM |
| brand string of <processor> | <string> Plural: brand strings | Returns the vendor-defined brand names for newer processors. | Win, Lin:8.2, Sol:8.2, Mac:8.2, WM, Ubu:8.2 |
| extended family of <processor> | <integer> Plural: extended families | Integer representing the extended family of CPU. See the notes for the meaning of these numbers. | Win, Mac:8.2, WM |
| extended model of <processor> | <integer> Plural: extended models | Integer representing the extended model of CPU. See the notes for the meaning of these numbers. | Win, Mac:8.2, WM |
| family name of <processor> | <string> Plural: family names | Returns the family name of the CPU, dependent on the type of client computer, for instance Pentium, Sparc, PowerPC G4, etcetera. | Win, Lin, Sol, HPUX, AIX, Mac, WM, Ubu:8.1 |
| family of <processor> | <integer> Plural: families | Returns an integer representing the family of the CPU. See the notes for the meaning of these numbers. As of BES 6.0, this Inspector returns a string on Solaris and AIX computers. | Win, Lin, Sol, AIX, Mac:8.2, WM, Ubu:8.1 |
| feature mask of <processor> | <integer> Plural: feature masks | Returns the feature flags from the CPUID instruction. The feature mask contains bits that identify extra features the processor may provide such as MMX support or if the Processor ID is enabled on the processor. | Win, Mac:8.2, WM |
| model of <processor> | <integer> Plural: models | Returns the model number of the CPU.Note: On Solaris, HPUX and AIX computers, this Inspector returns a <string> as of BES 6.0. | Win, Lin, Mac:8.2, WM, Ubu:8.1 |
| speed of <processor> | <hertz> Plural: speeds | Returns the speed of the processor in Hertz. | Win, Lin, Sol, HPUX, AIX, Mac, WM, Ubu:8.1 |
| stepping of <processor> | <integer> Plural: steppings | Returns the stepping number of the processor. This item can be helpful in identifying very specific processor features or limitations. | Win, Lin, Mac:8.2, WM, Ubu:8.1 |
| type of <processor> | <integer> Plural: types | Numeric type of the CPU. Values include: 0 - standard1 - overdrive2 - dual CPU capable3 - reservedNote: this Inspector returns a <string> type as of BES version 6.0 on UNIX machines and version 5.1 on the Macintosh. | Win, WM |
| vendor name of <processor> | <string> Plural: vendor names | The manufacturer of the CPU. Names include: GenuineIntelAuthenticAMDCyrixInsteadCentaurHaulsAmbiguousCPU. | Win, Lin, Mac:8.2, WM, Ubu:8.1 |
ramCreation Methods| Declaration | Description | Platforms (?) |
| ram | Returns a ram object for inspecting the properties of Random Access Memory installed on the machine. See ram. | Win, Lin, Sol, HPUX, AIX, Mac, WM, Ubu:8.1 |
| random access memory | Same as above. | Win, Lin, Sol, HPUX, AIX, WM, Ubu:8.1 |
Properties| Declaration | Return type | Description | Platforms (?) |
| available of <ram> | <integer> Plural: availables | Returns the total amount of RAM (in bytes) currently available on the Windows Mobile device. This is the same as for for the Windows client. | WM |
| load of <ram> | <integer> Plural: loads | Returns the amount of memory being used on the Windows Mobile device as a percentage. 0 = no memory used, 100 = all memory used. This is the same as for the Windows client. | WM |
| size of <ram> | <integer> Plural: sizes | Returns the number of bytes of random access memory on the current machine. | Win, Lin, Sol, HPUX, AIX, Mac, WM, Ubu:8.1 |
active deviceCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
local mssql databaseCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
serviceCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
processCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
swapCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
languageCreation Methods| Declaration | Description | Platforms (?) |
| system locale | Determines which bitmap fonts, and OEM, ANSI, and MAC code pages are defaults for the system. This only affects applications that are not fully Unicode. | Win, Lin, Sol, HPUX, AIX, WM, Ubu:8.1 |
| system ui language | Determines the default language of menus and dialogs, messages and help files. | Win, Lin, Sol, HPUX, AIX, WM, Ubu:8.1 |
| user locale | Determines which settings are used for formatting dates, times, currency, and numbers as a default for each user. Also determines the sort order for sorting text. | Win, WM |
| user ui language | Non-MUI: Same as system UI Language.MUI: Determines the language of menus and dialogs, messages, and help files. | Win, WM |
Properties| Declaration | Return type | Description | Platforms (?) |
| <language> as string | <string> | Returns the language of the system locale. | Win, Lin, Sol, HPUX, AIX, WM, Ubu:8.1 |
| primary language of <language> | <primary language> Plural: primary languages | Extracts the primary language identifier from a language. | Win, Lin, Sol, HPUX, AIX, WM, Ubu:8.1 |
primary languageCreation Methods| Declaration | Description | Platforms (?) |
| primary language of <language> | Extracts the primary language identifier from a language. | Win, Lin, Sol, HPUX, AIX, WM, Ubu:8.1 |
Properties| Declaration | Return type | Description | Platforms (?) |
| <primary language> as string | <string> | Returns the primary language. | Win, Lin, Sol, HPUX, AIX, WM, Ubu:8.1 |
computerCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
registryrootCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
registrynodeCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
scsibusCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
scsideviceCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
sound volumeCreation Methods| Declaration | Description | Platforms (?) |
Operators| Declaration | Return Type | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
stereo volumeCreation Methods| Declaration | Description | Platforms (?) |
Operators| Declaration | Return Type | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
usbCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
runlevelCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
operating system product typeCreation Methods| Declaration | Description | Platforms (?) |
| operating system product type <integer> | Returns an object corresponding to the numbered OS product type. | Win, WM |
| product type of <operating system> | Returns the product type of the operating system, which includes Workstations, Domain Controllers and Servers. | Win, WM |
Operators| Declaration | Return Type | Description | Platforms (?) |
| <operating system product type> = <operating system product type> | <boolean> | Compare two operating system product types for equality. | Win, WM |
Properties| Declaration | Return type | Description | Platforms (?) |
event logCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
event log recordCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
event log event typeCreation Methods| Declaration | Description | Platforms (?) |
Operators| Declaration | Return Type | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
zoneCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
zone network interfaceCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
uuidCreation Methods| Declaration | Description | Platforms (?) |
Operators| Declaration | Return Type | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |
uuid with multiplicityCreation Methods| Declaration | Description | Platforms (?) |
Properties| Declaration | Return type | Description | Platforms (?) |