NAME

     embed  - module to embed records in zero traces

SYNOPSIS

     embed [ -Nntap ] [ -Ootap ]  [  -nsnstr  ]  [  -nenetr  ]  [
     -rsnrst  ]  [  -renred  ]  [ -Llpad ] [ -Rrpad ] [ -isis ] [
     -ipipad ] [ -gigroup ] [ -B ] [ -D ] [ -C ] [ -V ] [ -? ]

DESCRIPTION

     embed takes a selected range of records from the input, then
     takes a selected range of traces from each record and puts a
     user specified number of zero traces on either side of  this
     record  writing  the  resultant  record to output.  There is
     also an option to embed zero traces anywhere within a record

     embed gets both its data and  its  parameters  from  command
     line  arguments.  These arguments specify the input, output,
     the start and end traces, left and right pads, internal  pad
     and verbose printout if desired

  Command line arguments
     -N ntap
          Enter the input data set name or file immediately after
          typing  -N.   If piping in this command line entry will
          be omitted.  This input file should  include  the  com-
          plete  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 output file is not required when
          piping the output to another process.  The output  data
          set also requires the full path name (see above).

     -ns nstr
          Enter the start trace number.  Trace numbers below this
          value will not be written to output.  The default is 1.

     -ne netr
          Enter the end trace number.  Trace numbers  above  this
          value  will  not  be written to output.  The default is
          the last trace number on the input data set.

     -rs nrst
          Enter start record number.  Default value is the  first
          record.

     -re nred
          Enter end record number.  Default value is last record.


     -L lpad
          Enter number of zero traces to pad left side of spread.
          Default is 0

     -R rpad
          Enter number of  zero  traces  to  pad  right  side  of
          spread.  Default is 0

     -is is
          Enter trace number inside spread after which  to  start
          entering  zero  traces for an internal pad.  Default is
          none

     -ip ipad
          Enter number of zero traces  to  pad  after  the  above
          trace number.  Default is 0

     -gi group
          Enter the group interval of the spread.  If this is not
          entered then the program will try to extract this value
          from the line header with the associated problems  this
          might  cause  (the value might not be there or it might
          be rounded).  If trace distances for the padded  traces
          are  important  it  is  best to enter this value on the
          command line.

     -B   If present, spread distances decreases from most  posi-
          tive to most negative (right to left), otherwise spread
          increases from most negative to most positive (left  to
          right)

     -D   Enter the command line argument '-D' to flag the embed-
          ded traces as dead

     -C   Enter the command line argument '-C' to copy either the
          first  or  last  (leftmost  or  rightmost) trace of the
          record into the pad zone rather than embed zeroes.

     -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.

COPYRIGHT

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