Recedit v. 1.7 (09-19-01)

Introduction

Recedit is a program which can be used to view and edit record files. A record file which is to be viewed or edited must have a CPDMS format file which describes its record layout. For most record files, the format file will need to be specified, with the exception being NAACCR record files. The format file required for NAACCR record files can be automatically determined. The NAACCR formats supported are incidence, confidential, and abstracted record types for NAACCR record versions 4.0, 5.0, 6.0, 7.0, 8.0 and 9.0. The program is available for DOS, Solaris, and Solaris x86 operating systems.

Download and Technical Support

Recedit is provided by the Kentucky Cancer Registry for free use and free of charge. The Kentucky Cancer Registry does not warrant the quality or performance of this program. By downloading this program you agree to hold the Kentucky Cancer Registry harmless in the event of any damages that it may cause.

Download RECEDIT 1.7

Please contact Kentucky Cancer Registry for comments, suggestions, or bug reports.

Overview

Recedit is invoked as follows:

Recedit recordFile [-e filename] [-f filename] [-m filename]

The parameters shown enclosed in [] are optional. If recedit is invoked without any parameters, a message will be displayed, describing the parameters, as follows:

   Usage: Recedit recordFile [-e filename] [-f filename] [-m filename]

      recordFile  - file containing the records to edit

      -e filename - file created for editing to prevent alteration
                    of the record file
      -f filename - file describing the format of the record file,
                    the record file will be assumed to have a NAACCR
                    format if this parameter is not specified
      -m filename - file created to store only records which have
                    been modified

The recordFile parameter is required. It supplies the name of the record file which will be examined or modified.

If the -e parameter is used an edit file will be created. The filename following the -e parameter specifies the name of the edit file. The edit file is used to prevent the original record file from being changed. When an edit file is used, the program reads the original record file, copies the records to the edit file, and then performs all editing on the edit file leaving the original file unaltered.

If the -f parameter is used a format file will be read to determine the format of the record file. The filename following the -f parameter specifies the name of the format file. The format file is required for any record file which is not in a NAACCR format.

If the -m parameter is used a modified record file will be created. The filename following the -m parameter specifies the name of the modified record file. The modified record file is used to store only the records which have been modified. Using a modified record file does not prevent the original record file, or edit file if specified, from being altered. The modified record file is created when the program exits, by determining which records have been changed and writing these records to the file. Records can be marked for saving to the modified record file, without making changes to the record, by using the save option when the record is being viewed. This is useful for creating a file which stores a subset of the records from the original record file. The modified record file is also useful for cases where the original file was merged into a database and some of the records were rejected. The user can edit the rejected records to correct the problems and then merge the modified record file, thereby avoiding re-merging the records which have already been accepted.

User Interface

The program has a simple user interface. A form is used to display one record at a time. The fields are displayed on the form in sequential order with each field occupying one line of the form. At the top right corner of the form the current record number and the total number of records is displayed. A menu of user options is displayed at the bottom of the screen.

Navigating Within a Record

The user may move between the fields on the form by using the up arrow to go to the previous field and the down arrow to go to the next field. For faster navigation the user may move up twenty fields by using the Pg Up key or down twenty fields by using the Pg Dn key.

Editing a Record

To edit a field the user must first place the cursor in the field. When the user types into the field the current contents of the field at the position of the cursor will be overwritten. The cursor may be moved to the left or right with the arrow keys. The delete and backspace keys may be used to remove unwanted characters in the field.

When the a format field is specified all of the fields can be edited. If no format file is specified and the file is detected to be a NAACCR record file, all fields can be edited except the NAACCR version field and the NAACCR record type field. These fields are protected because altering them could make the file format invalid with regard to the NAACCR specifications.

Recedit does not check any value entered during editing to determine if the value is valid for the field into which it is being entered. For this reason, the user should have knowledge of the fields being edited and enter values with care.

For fields which allow more than forty characters, only forty characters of the field will be displayed on the screen at a time. The user may view the complete contents of the field by moving the cursor to the end of the field display area. If there are undisplayed characters past the end of the display, the field contents will be scrolled to bring these characters into view.

Navigating Between Records

There are three ways to navigate between records. The user can move sequentially through the records by pressing F7 to go to the previous record or F8 to go to the next record.

The user may go directly to a record by pressing F6. When F6 is pressed, a box is displayed prompting the user to enter a record number. When the user enters a record number, the program will display the proper record. The user may cancel the operation by pressing ESC instead of entering a record number.

The user may search for a record by pressing F2. When F2 is pressed, a box is displayed prompting the user to enter a search string. The user can enter a search string or press ESC to cancel the search operation. If the user enters a search string, the program will search for an identical match starting at the next field. It will search every field in every record until a match is found or the search fails. Searching always wraps around to the beginning of the file when the end of the file is reached. A message will be displayed when this occurs.

Saving a Record

Anytime the user changes a record, the changes must be saved or abandoned before another record can be displayed. When the user attempts to leave a record the program will display a box containing a menu. This menu will allow the user to choose between saving the edits, abandoning the edits, or canceling the operation which caused the menu to appear. The user may also choose to save changes without leaving the record. In this case the user should press F10 to display the save menu.

Exiting the Program

The user may exit the program by pressing ESC. If there are any unsaved changes to the current record the user will be prompted to save or abandon the changes.

Change History

    * Changes from RECEDIT 1.6 (Released March 22, 2001)
          o Delete records fixed.

Navigation