NAME

     sis_verify  - print vital signs for a USP dataset (including
     "green" words).

SYNOPSIS

     sis_verify [ -Nntap ] [ -rs[start_record] [  -re[end_record]
     [  -ns[start_trace]  [ -ne[end_trace] [ -V ] [ -H ] [ -h ] [
     -? ]

DESCRIPTION

     sis_verify was written to provide a vehicle  of  looking  at
     the characteristics of a USP data set. What it provides over
     the scan program is the capability of examining the  "green"
     words  used by the i/o routines of USP processes. A mismatch
     between the number of bytes that "should" be  in  a  dataset
     based  on the number of samples shown by the line header and
     the actual number of bytes in the  dataset  for  each  trace
     will  be  shown  by  this program. Missing traces or corrupt
     data will also show up in the output.  A  sample  output  is
     shown below.

     Input consists  of  a  dataset  name,  starting  and  ending
     records, and starting and ending traces for each record. The
     format is detailed in the OPTIONS section below.

OPTIONS

     -N input_dataset
          Name of IEEE format USP dataset  to  print  information
          for.

     -rs start_record
          Output  concerning  traces  will  commence  with   this
          sequential record.

     -re end_record
          Output concerning traces will end with this  sequential
          record.

     -re start_trace
          Output  concerning  traces  will  commence  with   this
          sequential trace of each selectd record.

     -ne end_trace
          Output concerning traces will end with this  sequential
          trace of each selectd record.

     -V   Print green word values for all records and  traces  in
          the  dataset.  By default, only those which don't match
          the expected value based on the line header values will
          be printed.


     -H   Print a detailed listing of the entries in the histori-
          cal line header.

     -h or -?
          Enter either of these flags to get  online  help.   The
          program terminates after the help screen is printed.

EXAMPLE

     This will print the header information and  information  for
     traces  2-5  of  the second sequential record of the dataset
     testdata.

     example> sis_verify -Ntestdata -rs2 -re2 -ns2 -ne5 -V

     dataset = testdata

     line header green word = 2075
     number of traces/record = 240
     number of records = 5
     sample interval = 4
     number of samples/trace = 499
     format = 3
     no. of hlh entries = 46
     hlh byte total = 1075

     starting record 2
     ending record 2
     starting trace 2
     ending trace 5
     expected trace green word =  2252 bytes

     green word = 2252; skipping 241 traces ( 543692 bytes)
     green word = 2252; rec 2 trace 2
     green word = 2252; rec 2 trace 3
     green word = 2252; rec 2 trace 4
     green word = 2252; rec 2 trace 5
     traces processed = 245

AUTHOR(S)

     joe m. wade

SEE ALSO

     scan(1)

COPYRIGHT

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