Adding or Disabling ILL Lender Locations
Contents
Introduction Creating New Location Configuration Files Disabling a Location Configuration File
Introduction
Lender locations apply only to institutions using the Direct-to-Lender option, and possibly the Direct-to-Profile option, of the OCLC ILL Direct Request Service to route patron-generated Interlibrary Loan (ILL) requests from one or more of your SiteSearch databases to OCLC's ILL Service.
Lender location information resides in location configuration files. You generally have one location configuration file for each database configured to interact with OCLC ILL Direct Request. Each line in a location configuration file relates the name of a location (as it appears in a database record's Locations or Holdings field as a character string) and the three-character OCLC symbol that identifies that location.
WebZ uses the information in location configuration files to specify potential lenders in an ILL request by their OCLC ILL symbols.
The locations.ini configuration file contains the name and path of each location configuration file in your WebZ system.
You must set up these files if you are using the Direct-to-Lender option. Depending on how you set up your profiles at OCLC ILL Direct Request, you may wish to set up location configuration files if you are using the Direct-to-Profile option.
Creating New Location Configuration Files
Before you create a new location configuration file, you must determine:
- The lender locations that exist in the database for which you are creating the location configuration file
- The three-character OCLC symbols used to identify each location to OCLC ILL
- Any lender locations in the database that do not honor ILL requests, such as a reserve collection or a video library.
Follow these steps to create one or more location configuration files:
1. Create a new text file in the <WebZ_root>/ini/loc directory (where <WebZ_root> is the directory where you installed SiteSearch) with the text editor of your choice. If you must name the file when you create it, use a name that associates it with the database to which it applies and make "loc" the last three characters of the file name, such as UMinnloc.ini.
|
2. Place the name of the database to which the location configuration file applies in the first line of the file in brackets, like this:
[UMinn]
Enter the database name exactly as it appears in the dbName variable of the [database] section in the database's configuration file.
|
3. Do all locations in the database use the same OCLC symbol or is there a default symbol that applies to all locations not covered by other symbols? (In general, you should assign the default to the symbol that applies to most locations, and use individual lines for locations that are exceptions, as described in step 4.)
- Yes. Create a new line in the file using the following syntax:
Default=nnn
where nnn is the OCLC symbol.
If this is the only symbol associated with the database, go to step 5. Otherwise, go to step 4.
No. Go to step 4.
|
4. Add a new line in the file for each location and its OCLC symbol, using the following syntax:
location name=nnn
where location name is the way the location is represented in the database's Locations or Holdings field and nnn is location's OCLC symbol.
|
5. Are there any locations that do not allow resources to be borrowed via ILL?
- Yes. Add a new line in the file for each of these locations, using the following syntax:
location name=NoInst
No. Go directly to step 6.
|
6. Save the location configuration file. If you have not already named the file, use a name that associates it with the database to which it applies and make "loc" the last three characters of the file name, such as UMinnloc.ini.
|
7. Repeat steps 1-6 to create additional location configuration files as needed.
|
8. Open <WebZ_root>/ini/locations.ini with a text editor.
|
9. Add a line to locations.ini for every location configuration file you created, like this:
- If you
are using SiteSearch 4.0.2 or higher, use this format:
loc* = loc/UMinnloc.ini
If you are using an earlier version of SiteSearch, use this format:
locn = loc/UMinnloc.ini
where n is a unique integer. The first location line will be loc1=, the second loc2=, and so on.
|
10. Save and close locations.ini.
|
Disabling a Location Configuration File
You would only disable a location configuration file if you no longer use the database to which it applies or you wish to stop associating lender locations with the database. Follow these steps to disable a location configuration file.
1. Remove the reference to the location configuration file <WebZ_root>/ini/locations.ini.
|
2. Retain the location configuration file in the <WebZ_root>/ini/loc directory in case you need to subsequently need to enable or refer to it.
|
See Also
Location Configuration Files locations.ini Configuration File WebZ and OCLC ILL Direct Request
Configuring WebZ to Use OCLC ILL Direct
Request
|