NAME

     utop  - change line and/or trace headers

SYNOPSIS

     utop [ -Nntap ] [ -Ootap ] [ -Snsamp ] [ -dtnso ] [ -Rnrr  ]
     [  -Lntrcc  ]  [  -Ggrp  ]  [ -D0d0 ] [ -h0,9codel=[val] ] [
     -k0,9codet=[val] ] [ -sscale ] [ -pnp ] [ -rnum ] [ -d  ]  [
     -V ] [ -H ] [ -T message ] [ -? ]

DESCRIPTION

     utop allows selected header values to be modified  globally.
     If  either  input or output is a pipe the entire data set is
     streamed through even though  maybe  only  one  line  header
     value  is  changed.   This is fine for pipelines because the
     extra overhead of inserting a utop in the stream is negligi-
     ble.

     If the output data set name is the same as  the  input  data
     set  name  then  an  in-place  change  is made to only those
     header entries listed on the command  line.   Keep  in  mind
     when  doing  an  in-place  change the historical line header
     will not be changed (cannot alter the size of the input data
     set  when  doing  in-place changes).  Changing the length of
     the traces is also prohibited and will cause the run to fail
     with an error message.

     utop gets both its data and its parameters from command line
     arguments.   These  arguments specify the input, output, the
     start and end traces,  and  verbose  printout,  if  desired.
     Note  that  changes that vary from trace to trace cannot yet
     be made - at present they are all global.

  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 'vsp' stored on the 'b' disk.

     -O otap
          Enter the output data  set  name  or  file  immediately
          after typing -O.  For
           in-place changes, this can be the  same  name  as  the
          input data set (named files only - no pipes). This out-
          put file is not required  when  piping  the  output  to
          another process.  The output data set also requires the
          full path name (see above).

     -S nsamp
          Enter the new number samples/trace

     -dt nso
          Enter the new sample interval in ms

     -R nrr
          Enter the new number of records in the output data set

     -L ntrcc
          Enter the new number of traces per record in the output
          data set

     -G grp
          Enter the new group interval.

     -D0 d0
          Enter a new near offset.  If this value is nonzero  new
          trace distances will be written into all trace headers

     -h0,1,...,9 code=[value]
          To change a line header value first enter on  the  com-
          mand  line  the  sequenced key followed immediately (no
          space) by the appropriate code (see section  for  scan)
          followed  by  an equal sign, then the value you wish to
          put in the header.  e.g. suppose we wish to change  the
          mute  velocity  entry,  the command line entry would be
          -h0MutVel=5000 Note that this is the first line  header
          change (-h0).  Up to 10 such changes are permitted.

     -k0,1,...,9 code =[value]
          To change a trace header value  the  procedure  is  the
          same as above except that the key is now -kj, j=0,..,9.
          Consult the attached section on scan for the  appropri-
          ate trace header codes.

     -s scale
          Scale trace distances by this factor

     -p np
          Enter the number of trace values to be printed

     -rnum
          Enter the command line  argument  '-rnum'  to  renumber
          records and traces

     -d   Enter the command  line  argument  '-d'  to  force  the
          unsigned  trace distance header word to be equal to the
          absolute value of the signed trace distance word.

     -H   Enter the command line argument '-H' to strip  off  the
          historical line header.

     -T message
          Enter the message to be written to the historical  line
          header  immediately  after typing -T.  Note: the clever
          user will realize that quotes around the  message  will
          allow  for  white  spaces  (e.g.  -T 'Unix Rules!' will
          result in: Unix Rules!  Without the  quotes,  you  will
          get: Unix).

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