NAME

     index  - does simple indexing of data

SYNOPSIS

     index [ -Nntap ] [ -Ootap ] [ -Hw1hdrwrd1 ] [ -Hw2hdrwrd2  ]
     [  -Hw3hdrwrd3  ]  [  -s1ist1  ]  [  -s2ist2 ] [ -s3ist3 ] [
     -i1idwrd1 ] [ -i2idwrd2 ] [ -nrnmod ] [ -pbpribias ] [ -R1 ]
     [ -R2 ] [ -twod ] [ -V ] [ -? ]

DESCRIPTION

     index (1) allows the user to specify 2  trace  header  words
     with  their starting values and increments and a trace cycle
     parameter. Based on the cycle parameter header word  2  will
     count  from the starting value, incrementing until the cycle
     count is reached and then will reset back  to  the  starting
     value. The first header word will simply increment each time
     the cycle count is reached.

     index (2) allows computing some simple 2D indeces: permanent
     record  number  (  PRI  = DI - GI ), permanent trace number,
     source location ( source index * 10).

  Command line arguments
     -N ntap
          Enter the input data set name or file immediately after
          typing -N unless the input is from a pipe in which case
          the -N entry must be omitted.  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 output file is not required when
          piping the output to another process.  The output  data
          set also requires the full path name (see above).

     -Hw1 hdrwrd1
          Enter the mnemonic for the optional  incremental  trace
          header  word.  This will start from an initial value at
          the start of the job and increment each  time  a  trace
          count cycle is completed. Default = not used.

     -Hw2 hdrwrd2
          Enter the mnemonic  for  the  optional  cyclical  trace
          header  word.  This will start from an initial value at
          the start of a trace count cycle  and  increment  until
          the  trace  cycle  count is reached. Then it will reset
          back to the starting value and the process will repeat.
          Default = not used.


     -Hw3 hdrwrd3
          Enter the mnemonic for  the  optional  constant  header
          word.  This  will  be  a  constant  value  (see  below)
          inserted in this word for every trace.  Default  =  not
          used.

     -s1 ist1
          Enter the starting value  for  the  incremental  header
          word. Default = 1

     -s2 ist2
          Enter the starting value for the cyclical header  word.
          Default = 1

     -s3 ist3
          Enter the constant to be inserted  in  optional  header
          word 3. Default = 0.

     -i1 idwrd1
          Enter the increment for the  incremental  header  word.
          Default = 1

     -i2 idwrd2
          Enter the increment value for the cyclical header word.
          Default = 1

     -nr nmod
          Enter the cycle count  (in  traces).  Default  =  input
          number of traces/record.

     -R1  Enter the command line argument '-R1' to renumber  Rec-
          Num  with  header word 1 and TrcNum with header word 2,
          otherwise original RecNum & TrcNum will be retained.

     -R2  Enter the command line argument '-R2' to renumber  Rec-
          Num  with  header word 2 and TrcNum with header word 1,
          otherwise original RecNum & TrcNum will be retained.

     -twod
          Enter the command line  argument  '-twod'  to  renumber
          PrRcNm,  the  permanent  record number ( PRI = DI - GI,
          where DI = depth index and GI =  group  index  must  be
          already  set  in the trace headers. The permanent trace
          number is set to TrcNum.

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

BUGS

     unknown

SEE ALSO

     hdrswap(1)

AUTHOR

     Paul Gutowski (socon 422-3146), zprg03@trc.amoco.com

COPYRIGHT

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