NAME

     clean_green  - correct erroneous  "green"  words  in  a  USP
     dataset.

SYNOPSIS

     clean_green [ -Nntap ] [ -Ootap ] [ -use ] [ -V ] [  -h ]  [
     -? ]

DESCRIPTION

     Clean_green is designed to  try  and  correct  USP  datasets
     which have been corrupted with respect to the "green" words,
     which are bytes of information contained  at  the  start  of
     each  USP  line header and trace which tell the I/O routines
     how much information to read. Bad "green"  word  information
     can  usually  be  diagnosed by the sis_verify program, which
     will tell you the expected value based on the number of sam-
     ples per trace and any values found which fail to match that
     value. This information can then be used to determine  which
     mode  of  clean_green  should be selected for correcting the
     dataset so that it is readable by other  USP  programs.  The
     normal  mode  of  operation  is  to simply overwrite the bad
     values with the expected value.  However,  the  -use  option
     tells the program to use the existing values to traverse the
     dataset. This is used in situations where the length of each
     trace  in the dataset actually matches the bad "green" word.
     In the new dataset, the original  trace  in  such  instances
     will either be truncated or padded with zeroes, accordingly.

     Input consists of a USP dataset name. If the output  dataset
     name is the same as the input, the dataset will be corrected
     in place on disk. This feature is  invalid  when  using  the
     -use option.

OPTIONS

     -N input_dataset
          Location of IEEE format USP dataset to be processed.

     -O output_dataset
          Location of corrected IEEE  format  USP  dataset.  When
          -use  is  not  specified  and the input is on disk, the
          input dataset may be specified for in-place  correction
          of the dataset.

     -V   Print green word values for all records and  traces  in
          the  dataset.  By default, only those which don't match
          the expected value based on the line header values will
          be printed.

     -h or -?
          Enter either of these flags to get  online  help.   The
          program terminates after the help screen is printed.

EXAMPLE

     This will correct the dataset bad-green-data, which  has  an
     incorrect  "green"  word  value  on  the second trace of the
     first record.

     example> clean_green -N bad-green-data -O bad-green-data -V

     Details of the processing are found in  the  CLEAN_GREEN.pid
     printout file:

     input dataset = bad-green-data ( changing data in place )

     expected trace green word = 4256

     Traces found to have illegal green words:

     rec 1 trace 2 (2071)

     traces processed = 240

     count of illegal green words = 1

AUTHOR(S)

     joe m. wade

SEE ALSO

     sis_verify(1)

COPYRIGHT

     copyright 2001, Amoco Production Company
               All Rights Reserved
          an affiliate of BP America Inc.