Skip to main content
ExLibris
  • Subscribe by RSS
  • Ex Libris Knowledge Center

    Overview of editing MARC tag tables for Voyager

    • Product: Voyager
    • Relevant for Installation Type: Multi-Tenant Direct, Dedicated-Direct, Local, TotalCare

     

    Question

    Provide an overview of editing MARC tag tables for Voyager.

    Answer

    MARC tag tables for the Voyager Cataloging Client are usually stored in a separate directory, subordinate to the Catalog folder on a workstation local hard drive. A typical folder hierarchy would look like this:

    C:\Voyager
           \Catalog
                  \TagTable
                        \MARC21
                        \OCLC
                        \RLIN

    You choose which folder you want to use for validation in the Options → Preferences→ Validation tab in the Voyager cataloging client. 

    Best Practices for Editing and Saving Files

    All tag tables are ASCII (plain text) files and must be edited in a text editor such as Windows Notepad or WordPad, or third party text editors such as Notepad++. Do not use Microsoft Word or other word processing applications, as the resulting document format may make the file unusable. Save tag tables as text files with the .cfg extension. Do not save in a proprietary document file format.

    Keep a separate backup of files you edit manually. When Voyager clients are reinstalled, any files in the C:\Voyager\Catalog\TagTable folders will be overwritten. By creating a backup folder, such as on a network drive or on portable media (e.g., a usb drive), you will preserve your work and be able to apply your files to the workstation again.

    If the Cataloging client is open while you edit tag tables, you will need to close and restart the client in order for the saved changes to take effect.

    Basic Tag Table Structure (Example: \OCLC Folder)

    The OCLC folder contains three (3) groups of tag tables -- one each for:

    • authority records (file names starting with A)
    • bibliographic records (file names starting with B)
    • MFHDs or holdings records (file names starting with H).

    All tag table files end in the extension: .cfg

    Each group of tables consists of one file for each range of MARC tags (e.g., 1XX, 2XX, etc.), along with one tag table for the fixed fields in that group. 

    Examples:

    • Amarc1xx.cfg is the tag table for authority fields that begin with "1."
    • Bmarcfix.cfg is the tag table for bibliographic fixed fields.
    • Hmarc8xx.cfg is the tag table for MFHD fields that begin with "8."

    In the variable field tag tables, each field has three stanzas (or sections) that follow a unique stanza name in square brackets:

    • the stanza name [tag number] precedes the subfield stanza
    • the stanza name [tag number Ind1] defines the first indicator values
    • the stanza name [tag number Ind2] defines the second indicator values

    Each stanza in the variable field tag tables follows a similar pattern:

    • A sequence number (starting with 0) is paired with a valid MARC subfield by an equals sign (=).
    • On the same line as the subfield-sequence pair is a numeric code for whether the subfield is repeatable (0 = non-repeatable; 1 = repeatable).
    • Also on the same line is a one-letter code for whether the subfield is applicable (A), mandatory (M), or optional (O).
    • After the subfield sequence list is a list of the subfields and their definitions.

    Example:

    [245]           stanza name
    0=a 0M          subfield a is non-repeatable and mandatory
    1=b 0A
    2=c 0A
    3=f 0A
    4=g 0A
    5=h 0O          subfield h is non-repeatable and optional
    6=k 1A
    7=n 1A
    8=p 1A          subfield p is repeatable and applicable
    9=s 0A
    10=6 0A
    Subfa=Title
    Subfb=Remainder of title
    Subfc=Statement of responsibility, etc.
    Subff=Inclusive dates
    Subfg=Bulk dates
    Subfh=Medium
    Subfk=Form
    Subfn=Number of part/section of a work
    Subfp=Name of part/section of a work
    Subfs=Version
    Subf6=Linkage
    
    [245Ind1]       stanza for indicator 1
    0=0
    1=1
    Value0=No added entry
    Value1=Added entry
    
    [245Ind2]       stanza for indicator 2
    0=0
    1=1
    2=2
    3=3
    4=4
    5=5
    6=6
    7=7
    8=8
    9=9
    Value0=No nonfiling characters
    Value1=Number of nonfiling characters present
    Value2=Number of nonfiling characters present
    Value3=Number of nonfiling characters present
    Value4=Number of nonfiling characters present
    Value5=Number of nonfiling characters present
    Value6=Number of nonfiling characters present
    Value7=Number of nonfiling characters present
    Value8=Number of nonfiling characters present
    Value9=Number of nonfiling characters present

    Fixed field tag tables use a different set of stanzas in a hierarchical fashion:

    • Code type or tab stanzas
    • Grid template stanzas
    • Drop-down menu selection stanzas

    Before you edit fixed field tag tables, Support strongly recommends that you thoroughly read and understand the information in Appendix A of the Voyager Cataloging User’s Guide.

    Master.cfg

    The OCLC folder contains one additional tag table file that Voyager consults to validate records: Master.cfg. If you add a new variable field to an Amarc#xx, a Bmarc#xx, or an Hmarc#xx tag table file, you must also add and define the new field to the Master.cfg file in the appropriate stanza (Authority, Bibliographic, or Holdings). You must add the field number to the numerical list in the first half of the stanza; then you will define the field name in the second half of the stanza.

    Each stanza in the Master.cfg tag tables follows a similar pattern:

    • The first half of each stanza is an ordered list of valid MARC fields.
    • A sequence number (starting with 0) is paired with a valid MARC field by an equals sign (=).
    • On the same line as the subfield-sequence pair is a numeric code for whether the subfield is repeatable (0 = non-repeatable; 1 = repeatable).
    • After the field sequence list is a list of the fields and their definitions.

    Example:

    [Bibliographic Fields]
    0=000 0     the final zero indicates that field 000 is not repeatable
    1=001 0
    2=003 0
    3=005 0
    …
    121=383 1   the final one indicates that field 383 is repeatable
    122=384 1
    …
    Field000=Leader
    Field001=Control Number
    Field003=Control Number Identifier
    Field005=Date And Time Of Latest Transaction
    …
    Field383=Numeric Designation of Musical Work
    Field384=Key
    Document Your Changes

    At the top of the file, you will find several comment lines, which are preceded by the # symbol. This # symbol indicates that the Cataloging client should ignore these lines of text. The comment lines serve as a useful reference and documentation of the changes made for future editors. Support recommends that you include a short description of the change you made, the date of the change, and your initials.

    Example:

     # added 035 subf9 6/10/20 CJM

    Additional Information

    Don't forget that when your client is updated that your tag tables are overwritten.  See: Which files should I preserve when installing new clients?

    See also this article: How do I update tag tables?

    This handy PDF covers the above instructions and more: Editing Voyager MARC Tag Tables.pdf


    • Article last edited: 05-Nov-2020