EDIT OPTIONS

Edit options go into effect when the program is started with the 'Edit Session' option under the File|Run menu. In the documentation that follows, the term 'source file' refers to the MARC file that you are editing, and the term 'result file' refers to the source file after any record in it has been changed.

HOW THIS PROGRAM DIFFERS FROM OTHER MARC EDITORS

MARC Report is a MARC file editor, as opposed to a MARC record editor.

Other MARC editing programs typically open a new window for each MARC record that you want to view or edit. You will usually have to perform some sort of database search first to locate these records. There are certainly advantages to this approach.

MARC Report, on the other hand, works on a raw MARC file. This file can be an export of your complete database, or just a floppy disk with a few vendor records. The only requirement is that the file be in USMARC format. Apart from the creation of a simple index which the program uses for navigation, no loading, importing, or translating is done. The file is edited exactly as it appears on your disk or diskette. You can move from one record to another by using the arrow keys at the bottom of the screen.

When either of the following conditions are met, MARC Report starts an Edit Session by making a backup of the MARC source file: 1) the MARC source file is on a floppy disk, or 2) the name of the result file (as determined by the program options) will be the same as the MARC source file. Therefore, if you are editing floppy disks, you have the added peace of mind that, until you close the Edit session, all changes that you make are saved on your hard drive.

When editing a record, pressing the Save button saves the current record to a temporary workspace on your hard disk; your original MARC source file is not changed. When the Edit Session is closed, the program creates the result file by combining all of the records that were changed (from the temporary workspace) with all of the records that were not changed (from the original source file). The order of the records is not changed (unless, of course, you deleted or added records to the file). This unique approach makes it possible to completely recover any Edit Session that may be lost due to a system crash or other anomaly.

MARC Report never makes assumptions about the file you are editing. For example, if you are editing a file of 10,000 records, and close MARC Report to take a break, when you come back, and re-open the file in MARC Report, a new Edit Session is begun; the MARC source file may be backed up again to a new session folder that does not overwrite the backup of your previous session. Although this methodology uses more disk space, it guarantees the maximum safety for your data, and the greatest chance of data recovery in the event of a system problem or malfunction.

NOTE: See the 'Record Limit' option below for more information on editing large files of MARC records; and see the 'Clean Up Edit Work Files' option below for information on how to conserve disk space.

EDITING FLOPPIES

Some software programs that export MARC data to a floppy disk fill each diskette to capacity. If you edit a file on a floppy is that is nearly full, and you have selected the option 'Always Rename to Name of Source File', you could easily create edit results that are too big to fit back onto the floppy disk.

MARC Report protects you against this situation in two ways. First, when the edit session begins, MARC Report checks the amount of free space on the floppy, and if it is less than 10% of the disk's capacity, it will advise you of this problem and cancel the session. Second, the source file on the floppy disk is always copied to your hard disk at the start of the edit session–so you will always have a backup. And finally, if after a long Edit Session the edit results will not fit back onto the floppy, MARC Report will save the results to your hard drive, and advise you of the new name of the file.

Another issue is what would happen if you change the floppy disk in the middle of an edit session, since, as we said above, all changes are saved to the hard disk, not to the floppy. MARC Report creates an internal identifier whenever a floppy is loaded, and if it detects that the floppy is changed at the end of the Edit Session, it will prompt you to put in the correct diskette.

Despite these safeguards, we recommend that you not use the 'Always Rename to Name of Source File' or save your edit results 'To the Same Directory as the Source' options when editing floppy disks. Instead, always save your results to the hard drive, and if you need to copy them to a floppy disk, do that as a separate step in Windows.

HOW TO SAVE RECORDS

This section determines how the results of an Edit session will be saved. There are three options available.

SAVE CHANGED AN UNCHANGED TO SAME FILE

ALL records, whether changed or not, will be saved to the result file in the same order as they appear in the source file. This is the default.

SPLIT CHANGED AND UNCHANGED

This option will create TWO result files for each Edit Session. One file (named 'Changed.mrc' by default) will include only those records which were changed, and the other file (named Unchanged.mrc' by default) will include all the records that were not changed during the Edit Session.

SAVE CHANGED RECORDS ONLY

This option saves only those records that were changed during the Edit Session. This option is the most efficient way to edit large files, such as MARC databases that have been exported or copied to a CDROM. Since only the records that you edit will be saved, the program does not backup every record in the file, and thus certain operations run much faster.

NOTE: If you do not use the default option 'Save changed and unchanged to same file', please be aware that the results of your Edit session will not contain the same records as the source file that you started with. This may seem obvious to some, but it is worth emphasising for those users who may not be familiar with working with files of MARC records outside of their local system.

HOW TO NAME THE EDIT RESULTS

This section determines how the result files of an Edit session will be named. There are three options available.

PROMPT ME EACH TIME

If this option is selected, MARC Report will prompt you for a filename for your results each time an Edit Session is concluded.

ALWAYS RENAME TO NAME OF SOURCE

This option means that the result file will, in effect, be copied over the source file. If this option is checked, MARC Report will make a copy of your source file at the beginning of each Edit Session. Then, at the end of the Edit Session, MARC Report will copy the results to the source file. For example, if this option is checked and you are editing a file called 'A:\MICROLIF.001', then the results of your Edit Session will also be copied to 'A:\MICROLIF.001'.

NOTE: The 'Always rename to name of source file' option is only available if 'Save changed and unchanged records to same file' is also selected.

USE DEFAULT FILENAMES

This option means that result file names will be taken from the boxes that appear in the 'Default Filenames for Edit Results' section below. This is the default.

WHERE TO SAVE EDIT RESULTS

This section defines where (i.e. in which directory) the results are saved on your system. There are two options available:

SAME DIRECTORY AS SOURCE

This option will save the results to the same directory as the file you are editing is in. This is the default option and is recommended for the average user.

ALWAYS SAVE TO THIS DIRECTORY

This option will save your edit results into the directory that you set in the accompanying edit box. The default directory is 'C:\PROGRAM FILES\TMQ\MARC REPORT\EDIT', but you can set this directory to any directory on your system (except the 'Work' directory used by MARC Report).

NOTE: This option is not consulted if you have selected the 'Always Rename To Name of Source File' option.

DEFAULT FILENAMES

In these edit boxes you can enter filenames that the program will always use to name your edit results files. Note that these options are not consulted unless you have also selected the option 'Use the Default Filenames for Edit Results'.

CHANGED RECORDS

Changed records are saved by default to a file name 'Changed.mrc'. You may change this to any valid filename.

UNCHANGED RECORDS

Unchanged records are saved by default to a file name 'Unchanged.mrc'. You may change this to any valid filename. NOTE: This option only applies if the 'Split changed and unchanged records (two files)' option is selected.

DELETED RECORDS

If the 'Save deleted records' option is checked, deleted records will be saved to a file named 'Deletes.mrc'. You may change this to any valid filename.

ADD SESSION ID TO DEFAULT

Select this option to have the program generate a unique string, using the Session ID, that it will append to each of the three default filenames above. This will guarantee that the results of every Edit Session are saved to a unique filename. This option is not selected by default.

MISCELLANEOUS EDIT OPTIONS

SAVE DELETED RECORDS

If checked, and you delete a record in an Edit Session, a copy of the deleted record will be written to a file named 'Deletes.Mrc' (or whatever filename you enter in the Default Filename for Deleted Records box). This option is selected by default.

You could use this option to manually split one file into two files: any record deleted will be saved to one file, and all of the remaining (undeleted) records will be saved to another file.

CONTROL NUMBER OPTIONS

These options allow you to define a control number prefix and a starting control number. These options are only applied if and when you add a record to an Edit Session using a template.

If these options are defined, the program will automatically generate an 001 tag for you when you add a template to an Edit Session. Leave either of these options blank if you do not want this to happen.

WARNING! If you use these options, please take care! Managing control numbers outside of your system software is a tricky business, and depending on how your system works, you could end up deleting records with the same control number when you load the records from your Edit Session.

Always use an unique prefix. A prefix will keep the numbers that you assign from running into numbers assigned by other agencies. Every library should have a unique prefix, either assigned by OCLC or LC. If you do not have one, go to LC and request one (http://www.loc.gov/marc/organizations); its free and you can do it online. Also, make sure the starting control number that you use cannot conflict with any number used on your system.

You can enter up to 8 alphanumeric characters (the maximum currently allowed by the MARC Codelist for Organizations) in the control number Prefix box. A prefix of at least three characters is required for this feature to work–if you do not enter a prefix, this feature will be disabled. (We do this to protect you from yourself!)

In the control number 'Start At' box, enter the starting control number for your template records. You can only enter numeric characters in this box, up to a maximum of 10. The starting number must be formatted exactly as you want it to appear. Therefore, if your starting control number is 1234, and you want your number to be 8 digits long, you must enter '00001234'.

The program will internally track which control numbers have been used, beginning with the number AFTER the starting control number. So, if you enter '1' in the Start At box, the first time you add a Template to a session, the control number will be set to '2'.

When the control number is added to the record, the program will add 1 to the last number used, format the number to match the format of your starting control number, and add the prefix. For example, if your prefix is 'tmq', and your Start At number is '00000001', and the last number used was 101, the next control number assigned will be: 'tmq00000102'. On the other hand, if your Start At number was '1', and the last number used was 101, the next control number assigned would be: 'tmq102'.

Also, once a number is used, whether the record is saved or not, that number cannot be used again. So, if you add a Template to a session, and it is assigned a Control number of '1004', and you change your mind and do not save the record to the Session, the next control number that will be assigned will be '1005'.

Finally, if at some point you decide to change your 'Start At' number, a warning will appear. The purpose of this warning is to make you think twice about what you are doing. We recommend that you keep a written log of the control numbers that you have used and the dates that they were assigned.

AUTOMATICALLY ADD 005 TO TEMPLATES

The 005 field is mandatory in all MARC records and in all MARC formats. This date-time field is used by systems to determine different versions of the same record. The default behavior of MARC Report is to add a newly-created 005 field to template records whenever they are added to a file during an Edit Session. This behavior will occur even if you previously had manually deleted the 005 from the template using the 'Edit Templates' option. If for some reason you do not want an 005 to be added in these circumstances, uncheck this option.

ADD/UPDATE 005 in CHANGED RECORDS

If selected, the 005 will be updated in every record that is changed in the edit session. If a changed record lacks an 005, a new one will be created.

The 005 date/time stamp is not constant throughout the session; a new date/time stamp is recalculated for each changed record.

IMPORTANT: Selecting this option also selects the option to sort tags in a record. If you do not want your tags sorted, do not use this option.

EDIT SESSION RECORD LIMIT

This options specifies the maximum number of records that can be edited by an Edit Session, and it defaults to 10,000. If you need to edit a file that is larger than this, you must first increase this limit.

NOTE: Every file that you edit (large or small) is backed up at some point by MARC Report. This backup occurs whenever an edit session is initiated. Therefore, if you run MARC Report ten different times on the same file, it will create ten separate backups. Normally, this is not a problem (please see the option below for how MARC Report cleans up old work files). But if you are editing very large files frequently, you need to take note of this behavior, since it may impact the amount of disk space available on your machine.

ENABLE EDIT HISTORY

Check this option if you want the program to maintain a brief log for every Edit Session that occurs. The Edit History is a tab-delimited text file called 'EditHist.txt' which can be imported into other programs.

The following information is saved in the Edit History log: the date of the Edit Session, the time that the Edit Session began, the name of the MARC source file, the MARC Report Session ID, the number of records in the source file, the name of the Edit Results file, the number of records changed, the number of records deleted, the number of records imported, and the (sequential) number of the last record changed.

VIEW EDIT HISTORY

Click on this button to view your Edit Session History. The program will load the Edit History into a temporary database for viewing. Note that as the Edit History grows larger, it will take longer for the database to load. This is normal. If you want to speed this up, then rename the file to a different filename (eg. EditHistory.April.txt)

CLEAR EDIT HISTORY

Click on this button to clear all the entries from your Edit History. The program will first save your Edit history to a text file called EditHistOld.txt, and then it will clear (delete) the current Edit History file.