NAME

     killtr  - kill (or reverse polarity) traces

SYNOPSIS

     killtr [ -Nntap ] [ -Ootap ] [ -Kkfile ] [ -nsns ] [ -nene ]
     [  -rsnrs ] [ -renre ] [ -dldismin ] [ -dhdismax ] [ -pick ]
     [ -T ] [ -R ] [ -D ] [ -I ] [ -hw1Wrd1 ] [ -hw2Wrd2 ] [ -V ]
     [ -? ]

DESCRIPTION

     killtr kills a user specified trace (or traces) (puts  zeros
     in)  and  optionally  flags  it  as  a dead trace.  Either a
     specific record or a range of records can  be  processed  in
     this manner.

     killtr gets both its data and its  parameters  from  command
     line  arguments.  These arguments specify the input, output,
     the record and trace to kill, dead trace flag,  and  verbose
     flag

  Command line arguments
     -N ntap
          Enter the input data set name or file immediately after
          typing -N.  This input file should include the complete
          path name if the file resides in a different directory.
          Example  -N/b/vsp/dummy  tells  the program to look for
          file 'dummy' in directory '/b/vsp'

     -O otap
          Enter the output data  set  name  or  file  immediately
          after  typing -O.  This ouput file is not required when
          piping the output to another process.  The output  data
          set also requires the full path name (see above).

     -K kfile
          Enter the optional killtr control file.   This  may  be
          either   a   flat   file   (the   default)   with   one
          (record,trace) pair per line, or an xsd pick file.  All
          entries in the file used will be killed.  If only trace
          numbers are in this file  (single  column  of  numbers)
          then  the  same  traces are killed in every record (see
          the -T option below). If only  record  numbers  are  in
          this file (single column of numbers) then these records
          are completely killed (see -R option  below).   Usually
          this  file  contains  record and trace numbers based on
          sequential indexing.  If you wish to base your kills on
          specific  header indexing be sure to include the record
          and trace Mnemonic references using  -hw1  and/or  -hw2
          below.

     -ns ns
          If no kfile is  given  enter  the  starting  sequential
          trace  number  to  kill (no default).  If ns=0 and ne=0
          then the entire sequential record(s)  identified  below
          will be killed.

     -ne ne
          If no kfile is given enter the ending sequential  trace
          number to kill (no default).  If ns=0 and ne=0 then the
          entire sequential record(s) identified  below  will  be
          killed.

     -rs nrs
          Enter the sequential record number in which above trace
          occurs.   The  default is to process all records of the
          data set, killing the trace identified by ns above.

     -re nre
          To kill a range of records, enter the ending sequential
          record  to  kill.   Records between nrs and nre will be
          killed.  For this option to work both nrs and nre  must
          not be zero.

     -dl dismin
          Enter the minimum  distance  to  kill.   Traces  having
          signed trace distances greater than this value and less
          than the dismax value below will  be  killed.   If  the
          defaults  are used here and below then no distance kil-
          ling action is taken.

     -dh dismax
          Enter the maximum  distance  to  kill.   Traces  having
          signed  trace distances between this value and the dis-
          min value above will be killed.

     -pick
          This flag must be set on the command  line  if  an  xsd
          pick  file  is  used  (see above).  If this flag is not
          present and the -K option is used  the  input  file  is
          expected in flat file format.

     -T   Enter the command line argument '-T' to kill sequential
          traces  listed  in  file  kfile above in each and every
          record.  The format of the trace numbers  will  be  one
          (1)  sequential  trace  number per line (like the kfile
          format above but without the record number).  The  same
          traces will be killed in every record.

     -R   Enter the command line argument '-R' to kill all traces
          in  selected  selected  sequential records specified in
          the kill file.  Entries are one record number per line.

     -D   Enter the command line argument  '-D'  to  flag  zeroed
          trace as dead

     -I   Enter the command line argument '-I'  to  flag  reverse
          polarity of selected traces.

     -hw1 Wrd1
          If you wish to base your  kills  on  a  specific  trace
          header  entry for record indexing enter the appropriate
          mnemonic here.  If not present sequential record index-
          ing will be used.

     -hw2 Wrd2
          If you wish to base your  kills  on  a  specific  trace
          header  entry  for trace indexing enter the appropriate
          mnemonic here.  If not present sequential trace  index-
          ing will be used.

     -V   Enter the command line argument '-V' to get  additional
          printout.

     -?   Enter the command line  argument  '-?'  to  get  online
          help.   The program terminates after the help screen is
          printed.

DISCUSSION

     When using the pick option any duplicate picks or  instances
     of  reverse  order picks will be ignored during execution so
     that it is not necessary to quality control the pickfile for
     these  occurances.   Use of the -V flag is recommended for a
     complete printout of traces killed.

BUGS

     All known bugs exterminated .... if you see more .... please
     call ....... Thanks

AUTHOR

      Paul R. Gutowski APR:3146 zprg03@trc.amoco.com
      [Mods by Paul G.A. Garossino APR:3932 zpgg07@trc.amoco.com]

COPYRIGHT

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