Related product I-Share

Automatic Holdings Updates Via OCLC Data Sync Collections

Last updated, December 23, 2025.

Background

I-Share libraries have been synchronizing their holdings between I-Share’s library management system and OCLC WorldCat since 2003. This service is covered by OCLC Group Services Pricing in Illinois which is managed by the Illinois State Library. All I-Share libraries are profiled for this service. In practical terms, the synchronization process begins when an I-Share library adds or removes inventory from its collection via bibliographic records containing OCLC numbers, then Alma will publish details on that action to OCLC, and OCLC processes will add or remove the library's holding symbol on the matching WorldCat record. This service is sometimes referred to as "backloading" as it is especially beneficial in copy cataloging workflows. I-Share libraries strive to maintain accurate holdings representation in WorldCat, and this services assists in this ongoing maintenance.

Configuration

OCLC Configuration

Every I-Share member is configured to use a Data Sync Collection to automate the setting and deletion of holdings. These data sync collections are managed in each institution's instance of WorldShare, as part of the Collection Manager service. Existing I-Share members have already been configured since migration. When libraries join I-Share, CARLI staff will work with OCLC support and library staff to implement the data sync settings. CARLI staff typically obtain an account to an institution's WorldShare environment for this work.

Configuration of the Data Sync Collection includes a few standard practices.

  • CARLI recommends I-Share libraries have two current contacts for their Data Sync Collection. Email CARLI Support for assistance with adding new contacts.
  • Collections are configured to automatically match WorldCat records via an OCLC number present in each record sent from Alma. Published records must include an OCLC number in the 035 $a in order for holding symbols to be added or removed in WorldCat via this process. The data sync process will match the first 035 $a that contains an OCLC number.
  • Published records that lack OCLC numbers in MARC 035 $a will be reported as unresolved in the processing reports, and records will be placed in a "WorldCat staging" area for review.
  • Collections are configured to use the MARC record status value (Leader/05) to determine whether a holding symbol should be added or removed.
  • Collections are configured to copy the Alma institution zone MMS ID from the MARC 001 field, and add that to a local bibliographic data (LBD) record.

Additional configuration options are available, but are generally not applied. Please consult with CARLI if there is a need for different processing.

Alma Institution Zone Configuration

Every I-Share member institution zone is configured with two OCLC publishing profiles during implementation. 

  • The Publish bibliographic record (DataSync) to OCLC profile exports records for an institution's physical inventory based on the presence of holding records and the publishing management tag of the bibliographic record. This profile is not customizable.
  • The Publish electronic holdings to OCLC profile exports records for an institution's electronic inventory based on a logical set definition.

For both profiles, records are exported in files to the CARLI files server. This creates a temporary archive of files in case an institution needs to troubleshoot any data sync activity. The CARLI files server uses a script to copy these files to OCLC's WorldShare file server.

Considerations for Complex Institutions

Institutions that have multiple active OCLC holding symbols require additional configuration work in both OCLC and Alma. In OCLC, a new WorldShare instance and account will be created using a group symbol. This group symbol account receives the aggregated data for all libraries in the institution, then holdings are set or removed for individual symbols according to data mapped into the published bibliographic records.

In Alma, CARLI staff will configure mapping tables that associate Alma libraries with each OCLC holding symbol. The holding symbol will be added to a MARC 929 field in the published bib for each library that has holdings.

Publishing

triggering publishing

  • Manual exports: In the Alma Metadata Editor > Record Actions menu > Set Management Tags > Export to WorldCat menu, selecting the flag “Publish Bib” indicates a record should be published to add holdings in WorldCat; selecting the flag “Don’t Publish” indicates a record should be published to remove holdings in WorldCat. 
    Set Management Tags > Export to WorldCat menu is open with a purple box pointing out the menu options: Don't publish; Publish Holdings Only, and Publish Bib. Publish Bib is selected
    • The setting "Publish Holdings only" should only be selected by libraries with active LHR projects.
    • Anytime the bibliographic record is modified, it will be republished with the current Export to WorldCat setting.
  • Batch imports: The Set Management Tags tab of an Import Profile > Synchronize with OCLC menu contains the options to "Publish Bibliographic Records" indicating the batch of records should be published to add holdings in WorldCat; "Don't Publish" indicates the records should be published to remove holdings.
    Batch imports Set Management Tags tab open with a purple box identifying the Synchronize with OCLC menu options Publish Bibliographic records, Publish holdings only, and Don't publish.<br />
The Publish Bibliographic records option is included in the box.
  • The setting "Publish Holdings only" should only be selected by libraries with active LHR projects.
  • An additional batch condition allows your preference to be applied "Unconditionally" or "Only for new records" for all records processed by the import profile.

Steps for Physical Inventory Processing

  1. Alma's publishing job for physical inventory runs each day at 5:00 a.m.
  2. CARLI processing to add library OCLC symbols runs each day at 7:00 a.m. Records are then sent to OCLC.
  3. OCLC's Data Sync Collection processing completes and reports are added to WorldShare.

Steps for Electronic Inventory Processing

  1. Alma's publishing job for electronic inventory runs every Saturday at 6:00 a.m.
  2. CARLI processing to add library OCLC symbols runs every Saturday at 7:00 a.m. Records are then sent to OCLC.
  3. OCLC's Data Sync Collection processing completes and reports are added to WorldShare.

Reviewing OCLC Reports

OCLC reports will be available daily once processing of the OCLC Data Sync Collection concludes. I-Share staff should review reports to verify the outcomes of Alma's publishing to WorldCat were successful. Errors may indicate further action is necessary in WorldCat and/or in Alma.

Find reports in OCLC WorldShare > Metadata tab > My Files > Downloads.

WorldShare > Metadata tab > My Files > Downloads area. Downloads is identified with a purple square box and arrow, and the Records and Reports tab is filtered by Reports, also in a purple square box with arrow.

Review detailed descriptions of the reports such as the Bibliographic Processing Report and Bibliographic Cross Reference Report on OCLC’s Data Sync Reports document. Below each report, select “Report details” to see the column names and a thorough description of each. Example reports are also provided.

When to report a problem to CARLI Support? 

  • If you are not receiving bibliographic data sync reports via WorldShare.
  • If you see “create” in your Bibliographic Summary Report or Bibliographic Processing Report. Our projects do not add new bibliographic records to WorldCat.

Bib Summary Report indicating 34 creates, with the word create on the left side of the report indicated with a purple circle; a Bib Processing Report containing the word create on the right side of the report indicated with a purple circle.

  • It is expected that records which lack OCLC numbers will be marked as “unresolved”. However, if upon your review, you find that “unresolved” records contain OCLC numbers in the version of the record in your Alma instance, please report this. 
    • Bib Cross Reference Report example depicting the Alma MMS ID  in the left column and the WorldCat Staging OCLC numbers in the right column.
      1. In a Cross Reference Report, Alma MMS IDs are displayed in the left column and WorldCat Staging OCLC numbers are in the right column.
      2. Search your Alma instance by MMS ID to identify if an OCLC number was missing from the record sent to OCLC. 

If you see any of these issues or experience other unexpected results, please report them to CARLI Support.

Additional Documentation

CARLI Alma Primo VE Open Office Hours

April 27, 2020. "Keeping WorldCat Holdings in Sync; Utilizing Our Continuing Data Sync Collections with Alma Publishing."

Link to video for "Keeping WorldCat Holdings in Sync"
Slides with 5/11 addition: Slide 4 suppress options also need "Don't publish" set to trigger a delete. 
Sample Testing Chart

eX lIBRIS kNOWLEDGE cENTER

Publishing to OCLC

OCLC Documentation

Data Sync Reports