Contents
Introduction
How WebZ Uses Location Configuration Files
Location and Names of Location Configuration Files
Relationship Between locations.ini and Location Configuration
Files
Composition of Location Configuration Files
Example Location Configuration Files
A location configuration file relates strings (names of libraries in a catalog database's Locations or Holdings field) to their institution symbols. These are normally three-character OCLC institution symbols. Beginning with SiteSearch 4.1.1, though, the symbols may be those used by another IPIG-compliant ILL system if you are using WebZ to send ILL requests to this system rather than to OCLC ILL Direct Request. An IPIG-compliant ILL system conforms to the ILL Protocol Implementors Group (IPIG) Profile.
For catalog databases configured to use OCLC ILL Direct Request with the Direct-to-Lender option (and possibly the Direct-to-Profile option). WebZ uses the information in the location configuration file to map an item's location (as found in the catalog database's Locations or Holdings field) to its OCLC institution symbol. WebZ can then use the OCLC institution symbol to specify a possible lender for an ILL request.
| Note: |
If you are using OCLC ILL Direct Request, you do not need to create location configuration files unless you are using the Direct-to-Lender option. If you are using OCLC ILL Direct Request with the Direct-to-Profile option, you may want to use location configuration files, depending on the way you set up your profiles with OCLC ILL Direct Request. If you are using another IPIG-compliant ILL service, this service's requirements determine whether you need to create location configuration files. |
How WebZ Uses Location Configuration Files
The figure below shows how WebZ finds OCLC symbols for potential lenders for ILL requests. (This process would also be similar for another IPIG-compliant ILL system.) In the database record shown, the Holdings field indicates that the Young Library has a copy of Principle-Centered Leadership. The database's location configuration file indicates that Young Library's OCLC symbol is ACQ. If a patron submits an ILL request for Principle-Centered Leadership, WebZ uses ACQ to identify Young Library as a possible lender for this book.
Mapping Location in Database Record to Location Configuration File
Location and Names of Location Configuration Files
In the WebZ Out-of-the-Box Interface (OBI), you can find location configuration files in the <WebZ_root>/ini/loc directory, where <WebZ_root> is the directory where you have installed SiteSearch.
OCLC recommends that you use a name for a database's location configuration file that makes it easy to associate it with the database itself and that you end the name with the characters "loc". For example, the OBI contains location configuration files for several catalog databases, such as Notis and Endeavor. The location configuration files for Notis and Endeavor are Notisloc.ini and Endeavor.loc, respectively.
Relationship Between locations.ini and Location Configuration Files
You must have a locations.ini file that contains references to each of your location configuration files. This file tells WebZ where to look for these files. At system startup or when a new JaSSI starts up, the Java class loads ORG.oclc.isoill.LocationsLoader information from the location configuration files and stores it in the JaSSI.
Composition of Location Configuration Files
A location configuration file has one section, [database_name], where database_name is the name of the database whose locations are described in this file, as it appears in the dbName variable of the [database] section in the database's configuration file.
Each line under this section contains the name of a location (as it appears in the database record's Locations or Holdings field) and the three-character OCLC symbol that identifies that location, in the format:
location name=nnn
where location name is the name of the location and nnn is its OCLC symbol. Use the spelling, punctuation, and capitalization for the location name as it appears in bibliographic records for the database.
Include a line for every location found in the database and its corresponding symbol. Multiple locations may use the same OCLC symbol. The location configuration file may also contain multiple OCLC symbols. See Example 2 to see how a location configuration file with multiple symbols and several institutions with the same symbol might look.
The default location for a database represents the OCLC symbol to use for all ILL requests from this database, or the OCLC symbol to use for all locations not specifically associated with an OCLC symbol. Specify the default location in the location configuration file as follows:
Default=nnn
where nnn is the OCLC symbol.
When WebZ tries to match a location name to a symbol, it looks first for a specific location symbol and then looks for the default location symbol.
| Note: |
In general, you should use the default location for the symbol that applies to most locations, and use individual lines for locations that are exceptions. |
NoInst Symbol
The NoInst symbol indicates that certain locations do not allow ILL requests. For example, an institution's Video Library may not allow patrons other than those affiliated with the institution to borrow its resources. In this case, you would add a line to the relevant location configuration file like this:
Video Library=NoInst
| Note: |
You may wish to share your institution's location configuration file with other libraries that are also using WebZ and OCLC ILL Direct Request. |
The IPIG profile requires a system identifier to precede lender symbols. WebZ automatically prefixes the identifier OCLC: to all lender symbols in a location configuration file unless you include the SystemId variable in the file and specify the system identifier as the value of the SystemId variable.
Example Location Configuration Files
This is a simple location configuration file with only one location.
[Uminn]
Default=MNU
This location configuration file includes a default location (MNU), a location that does not process ILL requests (the Music Listening Center), several locations that use the MNP symbol, and several locations that use the UMM symbol.
[Uminn]
Default=MNU
Music Listening Center=NoInst
ANDERSON HORTICULTURAL=MNP
ANDERSON HORTICULTURAL Closed Stacks=MNP
ANDERSON HORTICULTURAL Juvenile=MNP
ANDERSON HORTICULTURAL Reference=MNP
BIO-MED=UMM
BIO-MED Core Coll & Reserve=UMM
BIO-MED Drug Information=UMM
For this database, if a patron submits a ILL request for a resource located at Anderson Horticultural, WebZ would find its symbol, MNP, and use it in the ILL request it sends to OCLC ILL Direct Request. If a patron submits an ILL request for a resource held by Smith Business, WebZ wouldn't find a symbol that matches Smith Business and would use the default location for the database, MNU, as the lender symbol for this request.
See Also
ILL
Configuration Files
locations.ini File
Adding or Disabling Lender Locations
WebZ and Interlibrary Loan (ILL)
Configuring WebZ to Use OCLC ILL Direct Request