Notice: This website is an unofficial Microsoft Knowledge Base (hereinafter KB) archive and is intended to provide a reliable access to deleted content from Microsoft KB. All KB articles are owned by Microsoft Corporation. Read full disclaimer for more details.

Description of the Offline Address Book Integrity (OABInteg) tool


View products that this article applies to.

Introduction

This article describes the Offline Address Book Integrity (OABInteg) tool. The OABInteg tool was developed as a Lightweight Directory Access Protocol (LDAP) client and a MAPI client. Additionally, the OABInteg tool can simulate the logon process of a Microsoft Outlook client to download offline address book (.oab) files.

The OABInteg tool can connect to the public folder store and read the contents and properties of .oab files and folders. Additionally, the OABInteg tool can scan for Active Directory-related problems that cause the .oab file generation process to fail on a server that is running Microsoft Exchange 2000 Server or Microsoft Exchange Server 2003.

The OABInteg tool simulates the following:
  • The .oab file generation process that a Microsoft Outlook client uses to connect to the public folder store to download .oab files
  • The .oab file generation process that connects to the public folder store to rebuild .oab files

↑ Back to the top


More information

The Microsoft Exchange System Attendant is responsible for invoking OABGen.dll so that address lists can be built or rebuilt. OABGen.dll is a MAPI application that reads from Active Directory through Name Service Provider Interface (NSPI) calls.

A healthy and correctly configured Active Directory is required for successful offline address book generation.

Active Directory-related issues, such as replication problems, latency, and stale information, can frequently cause the .oab file generation process to fail. The OABInteg tool can scan Active Directory for these types of issues.

The following is the description of the usage and optional commands of the Offline Address Book Integrity (OABInteg) tool.

Usage: OABInteg.exe [/s:servername] [/t:testname] [/l] (enable file logging) [/v: 1,2 or 3] (1 = minimum | 2 = maximum logging | 3 = ErrorsOnlyLogging
Optional Commands [/d:OUSearchDN] [/p:# - Page Size] [/U:UserName] [/P:Password] [/r:Alias]

[/l] Logging output will go to c:\OABInteg.txt
[/v] Logging output will go to the screen. - Default logging is general - /v:1 for minimum | /v:2 for maximum logging. | /v:3 for ErrorsOnlyLogging (Proxytest only)
[/p:] Active Directory search page size. Default size is 64 and maximum is 512.
[/dn:] LDAP test only!! <Example: OU=Managers,DC=OrgName,DC=local>

Note If you do not specify a search /dn: a base query of DC=OrgName,DC=local is used.

[/U:] Username. If you will connect, use different credentials or connect to a different domain.
[/P:] Password. If you will connect, use different credentials or connect to a different domain.
[/r:] Alias. If you want to return one object from the global address list (GAL) for any MAPI test, use this command.

Active Directory Tests
Test nameDescription
[storealtest]Validate if the information stores point to an Address list.
[altest]Finds all address lists in the organization.
[oaltest]Finds all offline address lists in the organization.
[abrtest]Finds the addressBookroots properties.
[rdntest]Scan for all legacyExchangeDNs that have a final RDN that is greater than 64 characters.
[templatetest]Scans Active Directory for any orphaned display templates.
[alltests]Runs all the LDAP tests | [-storealtest][-altest][-oaltest][-abrtest][-rdntest][-t emplatetest].
MAPI Tests
Test nameDescription
[proxytest] - Scan for users who will be skipped during the oabgen process. <Checks for invalid legacy Dn's also>
[oabfldcheck] Log on to the public information store and check the OAB system folders, messages, and attachments.
[getabinfo_v2] Open the default address book for a selected profile and dump all entries using OAB V2 props.
[getabinfo_v3] Open the default address book for a selected profile and dump all entries using OAB V3a props.
[getabinfo_v4] Open the default address book for a selected profile and dump all entries using OAB V4 props.
[hierarchylist] Log on to the public information store and get the OAB Hierarchy list information. [dumpPDNtable] - Uses a MAPI profile to connect to the Active Directory and creates a PDN table.
[oabsizer_v3] Calculates the size for GAL objects using the oab_v3a properties.
[oabsizer_v4]- Calculates the size for GAL objects using the oab_v4 properties.
Registry Tests
Test nameDescription
[getoabseqnum] - Check all user profiles and find the last downloaded OAB sequence number.
Mapi File Tests
Test nameDescription
[scanmapisvc] - Scan the mapisvc.inf file for invalid values.
NOTES
Test nameDescription
[proxytest] Run using an Online profile from the exchange server or client.
[oabfldcheck] Can be run (1. on the exchange server or 2. from a client.)
[hierarchylist] MUST be run against an exchange server from (1. on the exchange server or 2. From a client.)
[getabinfo_v2] Can be run (1. on the exchange server or 2. from a client.)
[getabinfo_v3] Can be run (1. on the exchange server or 2. from a client.)
[getabinfo_v4] Can be run (1. on the exchange server or 2. from a client.)
[oabsizer_v3] Can be run (1. on the exchange server or 2. from a client.)
[oabsizer_v4] Can be run (1. on the exchange server or 2. from a client.)
[getoabseqnum] MUST be run on the outlook client. This test reads from the registry.
[scanmapisvc] MUST be run on the outlook client. This test reads from the registry and profile.
[dumpPDNtable] Used a profile to connect to the active directory and creates a PDN table.
[storealtest][altest][oaltest][abrtest][rdntest][templatetest] & [alltests] - MUST be ran against a global catalog server.
For more information about the OABInteg tool, see the Web version of the OABInteg User's Guide (OABInteg-UserGuide.doc). To do this, visit the following Web site: To download OABInteg, visit the following Web site:

↑ Back to the top


Keywords: KB907792, kbhowto

↑ Back to the top

Article Info
Article ID : 907792
Revision : 2
Created on : 4/4/2008
Published on : 4/4/2008
Exists online : False
Views : 312