NAME

     sisort  - module to output sorted traces

SYNOPSIS

     sisort [ -Nntap ] [ -Ootap ] [ -ntable ] [ -eiend ] [  -lnst
     ]  [ -mnend ] [ -G ] [ -S ] [ -D ] [ -R ] [ -X ] [ -orig ] [
     -V ] [ -? ]

DESCRIPTION

     sisort generates sorted traces from the input data  set  and
     the  appropriate  entry  from  the  sort table.  Performance
     improvements may be gained on  the  Cray  by  using  memsrt,
     which  has  exactly the same fuctionality as sisort but out-
     puts the sorted traces from memory rather  than  from  disk.
     Note:  you cannot pipe into sisort.  The data must reside on
     disk.

     sisort gets both its data and its  parameters  from  command
     line  arguments.  These arguments specify the input, output,
     end time, sort table, sort type, renumber option,  and  ver-
     bose printout, if desired.

  Command line arguments
     -N ntap
          Enter the input data set name or file immediately after
          typing  -N   You  cannot pipe data into sisort since it
          requires data on disk within which to move a pointer (a
          pointer cannot exist in a sequential pipe).  This input
          file should include the complete path name if the  file
          resides in a different directory.  Example -N/vsp/dummy
          tells the program to look for file 'dummy' in directory
          '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).

     -n table
          Enter the name of the sort table generated by presort.

     -e iend
          Enter the end time of the output traces in ms  (default
          = last sample)

     -l nst
          Enter the start index to be output, i.e. if  -D  option
          (cdp sort) was specified then nst will be the first cdp
          output  (default = first index)


     -m nend
          Enter the last index to be output  (default =  last  on
          input)

     -G -S -D -R -X
           -G causes common receiver sorted traces to be  output;
          the output record numbers are set to the GI index.
           -S causes common source sorted traces  to  be  output;
          the output record numbers are set to the source index.
           -D causes common depth sorted traces to be output; the
          output record numbers are set to the CDP index.
           -R causes common offset sorted traces  to  be  output;
          the  output records are padded with zero traces to com-
          mon receiver sort size
           -X causes common offset sorted traces  to  be  output;
          the output record are not padded

           NOTE: use only one of the above flags
           NOTE: in the case of arbitrary sort words  in  presort
          the  three  sort  indices are accessed in the order -G,
          -S, -D

     -orig
          Include on command line if out traces and  records  are
          to  retain  their original numbers in positions 107 and
          106 of the trace header.

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

     -?   Enter this (or '-?' if you are running in  c-shell)  to
          get  online  help.   The  program  will terminate after
          printing this.

SEE ALSO

     memsrt, disort, presort, presortc, compsort, postsort

COPYRIGHT

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