NAME 

yaz-marcdump - MARC record dump utility

SYNOPSIS 

yaz-marcdump [-x] [-X] [-e] [-I] [-f from] [-t to] [-l spec] [-v] [-c cfile] [file...]

DESCRIPTION 

yaz-marcdump

reads MARC records from one or more files. It parses each record and supports output in line-format, ISO2709, MARCXML, MarcXchange as well as Hex output.

This utility parses records ISO2709(raw MARC) as well as XML if that is structured as MARCXML/MarcXchange.

Note

As of YAZ 2.1.18, OAI-MARC is no longer supported. OAI-MARC is deprecated. Use MARCXML instead.

By default, each record is written to standard output in a line format with newline for each field, $x for each subfield x. The output format may be changed with options -X, -e, -I.

yaz-marcdump can also be requested to perform character set conversion of each record.

OPTIONS 

-x

Reads MARC records in MARCXML/MarcXchange format. Without this option, yaz-marcdump reads records in ISO2709 format.

-X

Writes MARC records in MARCXML. This format is equivalent to YAZ_MARC_MARCXML in yaz/marcdisp.h.

-e

Writes MARC records in MarcXchange format. This format is equivalent to YAZ_MARC_XCHANGE in yaz/marcdisp.h.

-I

Writes MARC records in ISO2709 format. This format is equivalent to YAZ_MARC_ISO2709 in yaz/marcdisp.h.

-f from

Specify the character set from of the input MARC record. Should be used in conjunction with option -t.

-t to

Specify the character set of of the output. Should be used in conjunction with option -f.

-l leaderspec

Specify a simple modification string for MARC leader. The leaderspec is a list of pos=value pairs, where pos is an integer offset (0 - 23) for leader. Value is either a quoted string or an integer (character value in decimal). Pairs are comma separated. For example, to set leader at offset 9 to a, use 9=a.

-v

Writes more information about the parsing process. Useful if you have ill-formatted ISO2709 records as input.

EXAMPLES 

The following command converts MARC21/USMARC in MARC-8 encoding to MARC21/USMARC in UTF-8 encoding. Leader offset 9 is set to 'a'. Both input and output records are ISO2709 encoded.

    yaz-marcdump -f MARC-8 -t UTF-8 -I -l 9=97 marc21.raw >marc21.utf8.raw

The same records may be converted to MARCXML instead in UTF-8:

    yaz-marcdump -f MARC-8 -t UTF-8 -X marc21.raw >marcxml.xml

FILES 

prefix/bin/yaz-marcdump

prefix/include/yaz/marcdisp.h

SEE ALSO 

yaz(7)