Tivoli Endpoint Manager Windows Mobile Client Inspector Guide - BigFix
Note: Before using this information and the product it supports, read the information in Notices. Copyright IBM Corporation 2003, 2011.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADPSchedule Contract with IBM Corp.
. 1. 1Audience . 2Conventions Used in this manual . 2Examples . 2Versions . 3Forms . 4. 5. 5Primitive Objects . 5String . 5World Objects . 6World . 6Registry Objects . 9Registry . 9Registry Key . 11Registry Key Value. 14Registry Key Value Type . 17Filesystem Objects . 18Filesystem . 18Filesystem Object . 19File . 21Application . 26Folder . 29Drive . 33File Content . 36Version . 37File Version Block . 38File Line . 42Xml Dom Document . 44
System Objects . 44Operating System . 44Processor . 48Ram . 50Language . 51Primary Language . 52Operating System Product Type. 53Operating System Suite Mask . 53Site Objects . 54Site . 54Site Group . 56Site Version List . 57Fixlet Objects . 58Fixlet . 58Fixlet header . 59Client Objects. 60Client . 60Setting . 61Selected Server . 62Current Relay. 64Root Server. 64Application Usage Summary . 65License Objects. 66License . 66Windows Mobile Device Objects. 68Phone . 68Oma Csp . 71Wince Network Connection Detail . 90Wince web browser . 93Base battery. 94Battery . 95Backup battery . 97Gps. 98Authorization Objects . 100Client cryptography . 100X509 Certificate . 101
User Objects . 102Logged On User. 102Action Objects . 103Action . 103Networking Objects . 106Network . 106Network Interface . 107Network Ip Interface . 107Network Address List . 109Network Adapter . 110Ipv4 Address . 113Ipv6 Address . 115Ipv4or6 Address . 115Key Phrases (Inspectors) . 117Casting Operators . 167. 172. 172Processors . 172Folders on Windows Devices . 174. 175. 175. 178. 178
Tivoli Endpoint ManagerAudienceThe Tivoli Endpoint Manager Windows Mobile Client Inspector Guide is a guide to the ordinaryphrases (known as Inspectors) of the Relevance Language . As the name implies, these phrases areused to inspect the properties of those Tivoli Endpoint Manager Clients that run Windows Mobile (WM).Thousands of Inspectors have been created to expose the inner workings of Windows Mobile devices,including the hardware, file system and software.In addition to these client-specific Inspectors, there are several cross-platform Core Inspectors that arealways available to you. These have been included in the keyword section at the end of this guide toprovide you with a complete lexicon for Relevance scripting. For more information on the Core Inspectors,see the Tivoli Endpoint Manager Core Inspector Guide. Note that the name of the program haschanged from BigFix to Tivoli Endpoint Manager, however most Inspectors still use the BigFix name whenreferring to the program.This guide may look imposing, but it reflects a certain amount of redundancy designed to improveaccessibility. Each Inspector object has a creation method, listed by type. But objects are also propertiesof other objects (or the world), so they may be listed twice. In addition, the keyword section echoes theobjects yet again, while adding type information and the plural format.Inspectors can be thought of as object-oriented representations of the underlying computer system. Theylet you write Relevance expressions to query thousands of aspects of any Tivoli Endpoint Manager Client,instantly and with minimal overhead. Inspectors are keywords in the Relevance Language, so calledbecause it allows content to be targeted to just those computers where it is relevant and no others.Relevance statements non-invasively analyze the Client computer to see if proper conditions exist beforeattempting remediation. Relevance Expressions are embedded into Action Scripts in such a way as toguarantee that the issue you detect is the one you remediate. In addition, Inspectors can be used tocollect properties of any Tivoli Endpoint Manager Client for your own custom analysis in the TivoliEndpoint Manager Console or Web Reports program.Relevance and Action scripts are bundled with human-readable content into Fixlet Messages, which canbe further grouped into Fixlet Sites and Domains that specific subsets of your network can subscribe to asneeded.The bulk of these Inspectors are multi-platform, allowing one expression to address all the operatingsystems encountered in a typical network. So, although this guide is explicitly aimed at a single platform,most of these Inspectors have equivalents on other platforms as well. The list of Inspectors grows day byday, as need dictates. For each Inspector, this guide lists (by platform) the version of Tivoli EndpointManager where it first debuted.For more information on how to write Relevance expressions, see the Tivoli Endpoint ManagerConsole Operator’s Guide and the Tivoli Endpoint Manager Relevance Language Reference.
AudienceThis guide is for IT managers, product support groups and other people who want to use Inspectors towrite Fixlet messages and Tasks for Windows Mobile-based Tivoli Endpoint Manager Clients.IT managers use the Tivoli Endpoint Manager to keep their network of computers up to date andrunning smoothly without interruption. QA and other support teams can produce customized Fixletmessages to keep their users updated and their support calls to a minimum.To get the most out of this guide, it helps to have some experience with the Windows Registry.This document describes Inspectors for Windows Mobile devices. Contact your Tivoli Endpoint Managermarketing representative for information about Inspector Guides for other operating systems, includingWindows, Solaris, HPUX, Macintosh, and a variety of Linux operating systems.Conventions Used in this manualThis document makes use of the following conventions and nomenclature:ConventionUseMono-spaceA mono-spaced font is used to indicate expressions in the RelevanceLanguage.Braces are used to indicate the comparison { , ! } or arithmetic operators { , -}that are available for a binary operation.Angle brackets are used to indicate a type, such as string or integer, that is theobject of a key phrase. When this document says 'absolute value of integer 'it indicates that in practice, you will substitute an integer value, as in 'absolutevalue of 5'.Indicates an Inspector Form. Some Inspectors are simple keywords. Othersare a keyword in combination with another Inspector. Still other forms allowiteration through object lists. Each form is defined belowThe small print beneath the description of each Inspector notes the versionwhen it debuted on every relevant operating system (see the following sectionon Versions).{curly braces} angle bracket ItalicsSmall printExamplesSquare bullets and a mono-spaced font denote examples of Inspectors as used in a RelevanceExpression. If you have a color version of this file, these square bullets are also red:concatenation of "light" & "year"Returns "lightyear"
Tivoli Endpoint ManagerVersionsVersionsPrior to version 8.1, the program was known as BigFix or the BigFix Enterprise Suite (BES). Although thename is now Tivoli Enterprise Manager, you will still find many legacy Inspectors that refer to BigFix orBES.Most Inspectors have equivalent implementations on other operating systems, allowing you to write crossplatform relevance expressions. BigFix/Tivoli Endpoint Manager works across all major computer platforms,including the following:Win: the Windows version of the Tivoli Endpoint Manager Client and the Tivoli Endpoint ManagerSession evaluation context.Lin: the Red Hat and SUSE Linux version of the Tivoli Endpoint Manager Client.Sol: the SUN Solaris operating system version of the Tivoli Endpoint Manager Client.HPUX: the Hewlett-Packard UNIX version of the Tivoli Endpoint Manager Client.AIX: the AIX version of the Tivoli Endpoint Manager Client.Mac: the Macintosh version of the Tivoli Endpoint Manager Client.Ubu: the Ubuntu / Debian version of the Tivoli Endpoint Manager Client.WM: the Windows Mobile version of the Tivoli Endpoint Manager Client.There are exceptions due to platform variations and introduction dates. Some of the Inspectors wereintroduced in later versions of the program, and won't work on all versions of all platforms. To keep track ofthem, the debut version is listed at the end of the Inspector description, for example:Win:2.0, Lin:3.1, Sol:7.1, HPUX:5.0, AIX:8.0, WM:7.2This means that the Inspector of interest debuted in version 2.0 on Windows, but not until version 3.1 onLinux. In fact, version 3.1 of BigFix/Tivoli Endpoint Manager was the first version to include Linux Inspectors.Similarly, the first version for Windows Mobile was 7.2. The Inspector therefore exists on all versions of thosetwo platforms, so the version number is unnecessary and we can simplify the list:Win:2.0, Lin, Sol:7.1, HPUX:5.0, AIX:8.0, WMTo further streamline this information, the version number is eliminated if it is less than or equal to version6.0, which is a minimum requirement for most deployments. So the simplified version becomes:Win, Lin, Sol:7.1, HPUX, AIX:8.0, WM
FormsYou will notice that many of the keywords of the language are not unique; they get their meaning fromtheir context. Accordingly, their definitions often include a phrase to define the context of each Inspector.In the following pages, you will find tables defining the Inspectors of the relevance language. TheInspectors come in several forms depending upon their context:FormSyntaxExamplePlainPlain GlobalNamedNamed GlobalNumberedNumbered GlobalIndex (list) Index (list) GlobalBinary OperatorUnary OperatorCastkeyword of object keywordkeyword "name" of object keyword "name"keyword number of object keyword numberkeyword (list) of object keyword (list) object {op, cmp} object {op} object object as keywordaddress of ip interfacedrivesvariable "PATH" of environmentprimary internet connectionline 5 of file "/usr/lib/foobar"month 9substring (1,2) of "abcdefg"integers in (2,-1)December – current month-month"4.5" as floating pointThese differ from one another in their format and the syntax they require. Except for cast, binary, andunary operators, these forms can be used to access both single objects and lists of objects by using theplural form of the keyword. The plurals are all listed in the keyword section at the end of this document.In the following pages, each Inspector is described in terms of the methods that are used to create theInspector object, the properties of the object that are available for inspection, the mathematical (binaryand unary) operations that that can be performed on them, as well as casting options to convert thevarious types.
Tivoli Endpoint ManagerPrimitive ObjectsPrimitive ObjectsThe relevance language is based upon a comprehensive set of primitive objects. These primitives are thebasic building blocks of the more complex objects to follow. The Core Inspector Guide documents thebulk of the primitive object inspectors. Where a specialized platform-specific method exists to create,inspect, or manipulate primitive objects, they will be documented in the respective Inspector guide.StringString are typically core objects, but some string Inspectors may be client-specific. Note: A string literal is written within double quotes. Special characters must be inserted by using thepercent sign followed by 2 hex digits. Special characters include those characters with ASCII codes lessthan the 'space' character (hex 20) or greater than 'tilde' character (hex 7f) as well as the percentcharacter itself (25 hex). For example, to create a string containing a null character and a percentcharacter use "a null is %00, the percent itself is %25". Conversion to upper and lower case is alsoprovided. String works in combination with the string position and substring data types. A string position isa point within a string. It can be compared to an integer, but it also acts as a pointer within a string so thatthe preceding and following text can be extracted. A substring is a part of a larger string. All operationsallowed on a string can be performed on a substring. There are two substrings "be" in the string "To be ornot to be". The substrings only differ in their positions within the string.Creation MethodsThese string creation methods are in addition to the other properties that return the string type.Key PhraseFormDescriptionescape of string PlainReturns a string containing a \\ for every \ characterfound. Useful for setting registry key values to strings inregset action commands.Win, WMNOTE: Many Inspectors return string values from the operating system using a variety of APIs. For themost part, these strings are encoded as single-byte character sets (SBCSs) or multi-byte character sets(MBCSs) depending on the active code page. You can use the code page Inspectors to determine whichpage is currently active on the client.
World ObjectsThese are the plain, named, numbered or indexed global objects. This list is the subset of World objectsthat return primitive types, such as string, integer, boolean and time.WorldAll objects created without context are known as 'properties of the world' in the relevance language.Below is a list of the primitive global properties, sorted by key phrase.PropertiesKey PhraseFormReturnTypeDescriptionansi code pagePlainGlobal integer Returns an integer value of the Windows APIGetACP.Win, WMapparent registrationserver timePlainGlobal time Shorthand for 'now of registration server'. Whenthe client registers with the server, the serverpasses its current time back to the client. Theclient starts a stop watch at that time. Theapparent registration server time is the time theserver passed back to the client, plus the elapsedtime on the stop watch.Win, Lin, Sol, HPUX, AIX, Mac, WM, Ubucomputer idPlainGlobal integer This is a unique integer assigned to the computerby the BES system.Win, Lin, Sol, HPUX, AIX, Mac, WM, Ubucomputer namePlainGlobal string Returns a string corresponding to the name of thecomputer as it appears on the network.Win, Lin, Sol, HPUX, AIX, Mac, WM, Ubucustom site subscription NamedGlobal time effective date string Returns the date the custom site (specified by string ) was last subscribed or unsubscribed. It isused internally by BES to manage custom sitesubscriptions.Win, Lin, Sol, HPUX, AIX, Mac, WM, Ubudns namePlainGlobal string Returns the DNS name of the computer.Win, Lin, Sol, HPUX, AIX, Mac, WM, Ubu
Tivoli Endpoint ManagerWorld ObjectsKey PhraseFormReturnTypedownload path string NamedGlobal string DescriptionThis inspector is available in relevance subsitutionaction processing. It returns a string correspondingto the download path of the specified file. ThisInspector (along with download folder anddownload file) is designed to be used during theprefetch process of action execution. This isequivalent to '(pathname of download folder) &pathseparator & "myfile"'.Win:7.2, Lin:7.2, Sol:7.2, HPUX:7.2, AIX:7.2, Mac:7.2, WM, UbuhostnamePlainGlobal string Returns the standard host name, usually for thecomputer‟s network.Win, Lin, Sol, HPUX, AIX, Mac, WM, Ubuhyperthreading capablePlainGlobal boolean Returns a boolean TRUE if the agent is able todetect that the processor is capable of running withhyperthreading enabled.Win, WMhyperthreading enabled PlainGlobal boolean Returns TRUE if the machine is running withhyperthreading enabled, a method in which eachphysical processor on the machine presents itselfas multiple logical processors to the operatingsystem.Win, WMlogical processor countPlainGlobal integer Returns the number of logical processors availableper physical processor. This can be interpreted asthe number of hyperthreads that could be enabledon the machine. On a machine with 2 physicalprocessors, each with 2 possible hyperthreads perprocessor, the „physical processor count‟ and the„logical processor count‟ would both return 2, whilethe „number of processors‟ would return 4, sincethere are a total of 4 logical processors availablefor work. With hyperthreading turned off, the„number of processors‟, „logical processor count‟and „physical processor count‟ would all be 2.Disabling one of those processors will then give„number of processors‟ 1, „logical processorcount‟ 2, and „physical processor count‟ 1. If thenumber of processors / physical processor count! logical processor count, you can turn onhyperthreading.Win, WMoem code pagePlainGlobal integer Returns an integer value of the Windows APIGetOEMCP.Win, WM
Key PhraseFormReturnTypeparameter string NamedGlobal string DescriptionThis Inspector is a synonym for the parameter string of action . It looks up the value of theaction parameter specified by string . This isused in conjunction with the parameter setcommand.Win, Lin, Sol, HPUX, AIX, Mac:7.1, WM, Ubupending loginPlainGlobal boolean Installers may leave values in the registry that theoperating system will execute when the next userlogs in. Pending login can detect these registryentries.Win, Lin, Sol, HPUX, AIX, Mac, WM, Ubupending restartPlainGlobal boolean Returns TRUE if the operating system indicatesthat a restart needs to occur.Win, Lin, Sol, HPUX, AIX, Mac, WM, Ubupending restart string NamedGlobal boolean Immediately after issuing a command like 'Actionrequires restart "PatchGroupX"', the expression'Pending restart "PatchGroupX"' will be true untilthe next restart.Win, Lin, Sol, HPUX, AIX, Mac, WM, Ubuphysical processorcountPlainGlobal integer Returns the number of physical processors on themachine. Note that 'number of processors' returnsthe number of logical processors. To determine thenumber of logical processors per physicalprocessor, use 'number of processors / physicalprocessor count'.Win, WMsystem languagePlainGlobal string Returns the language of the system as a string. Itis identified using the GetSystemDefaultLangID()system call. See the language keyword of theapplication object for a list of possible languagevalue.Win, Lin, Sol, HPUX, AIX, WM, Ubutotal processor corecountPlainGlobal integer Returns an integer corresponding to the totalnumber of processor cores.Win, WMuser languagePlainGlobal string Returns the language of the system as a string. Itis identified by using the GetUserDefaultLangId()system call. See the language keyword of theapplication object for a list of possible languagevalue.Win, WM
Tivoli Endpoint ManagerKey PhraseRegistry ObjectsFormwake on lan subnet cidr PlainGlobalstringReturnTypeDescription string Returns the subnet the client is in for Wake on Lan(WoL) purposes. The client sends information tothe relay during registration that is used to decidewhich subnet the client is in. The relay returns thesubnet to the client, which is the value thisInspe
Tivoli Endpoint Manager Audience The Tivoli Endpoint Manager Windows Mobile Client Inspector Guide is a guide to the ordinary phrases (known as Inspectors) of the Relevance Language .As the name implies, these phrases are used to inspect the properties of those Tivoli Endpoint Manager Clients that run Windows Mobile (WM).
Tivoli Endpoint Manager The Tivoli Endpoint Manager Windows Client Inspector Library is a guide to the ordinary phrases (known as Inspectors) of the Relevance Language .As the name implies, these phrases are used to inspect the properties of those Tivoli Endpoint Manager Clients that run Windows.
Tivoli Security Operations Manager Products include: Tivoli Composite Application Manager Tivoli Config Mgr Tivoli Decision Support for z/OS 9Tivoli Monitoring 9IBM Director Tivoli Ent Console Tivoli NetView Tivoli OMEGAMON 9Tivoli Provisioning Manager Tivoli Remote Cnt
Tivoli Storage Manager for Windows Quick Start GC35-0409 Tivoli Storage Manager for Windows Administrator's Guide GC35-0410 Tivoli Storage Manager for Windows Administrator's Reference GC35-0411 Tivoli Storage Management Products License Information LC23-4470 Tivoli Storage Manager for HP-UX Quick Start GC35-0412
Tivoli Endpoint Manager The Tivoli Endpoint Manager Solaris Client Inspector Library is a guide to the ordinary phrases (known as Inspectors) of the Relevance Language . As the name implies, these phrases are used to inspect the properties of those Tivoli Endpoint Manager Clients that run the Solaris OS. Thousands of
IBM Tivoli Storage Manager for Windows Administrator's Reference GC32-0783 IBM Tivoli Storage Manager Messages GC32-0767 IBM Tivoli Storage Manager Using the Application Program Interface GC32-0793 Contacting customer support If you have a problem with any Tivoli product, you can contact Tivoli Customer
IBM Tivoli Composite Application Manager for SOA IBM Tivoli Usage and Accounting Manager Application Layer Management IBM Tivoli Application Dependency Discovery Manager IBM Tivoli OMEGAMON XE for Messaging IBM Tivoli Composite Application Manager for Response Time IBM Tivoli Composite Application Manager for Web Resources
Decision Support for z/OS IBM Tivoli System Automation & IBM Tivoli Workload Automation IBM Tivoli Netview for z/OS, OMEGAMON, IBM Tivoli Composite Application Manager, DFSMS IBM Tivoli Identify Manager, IBM Tivoli Access Manage
ASTM E 989-06 (2012), Classification for Determination of Impact Insulation Class (IIC) ASTM E 2235-04 (2012) Standard Test Method for Determination of Decay Rates for Use in Sound Insulation Test Methods Test Procedure All testing was conducted in the VT test chambers at Intertek-ATI located in York, Pennsylvania. The microphones were calibrated before conducting the tests. The airborne .
