NAME

     padrec  - pad zero records into a data set

SYNOPSIS

     padrec [ -Nntap ] [ -Ootap ] [ -Ffile ] [ -D ] [ -B ] [ -I ]
     [ -rsstart ] [ -reend ] [ -riinc ] [ -V ] [ -? ]

DESCRIPTION

     padrec reads record numbers  (header  mnemonic  RecNum)  and
     number of records to pad from a flat file and uses this info
     to pad in zero records in a data set. The data  are  sequen-
     tially renumbered after the padding operation.

     padrec gets both its data and its  parameters  from  command
     line  arguments.  These arguments specify the input, output,
     the flat file name, and verbose printout, if desired.

     padrec will also perfom an automatic record padding  if  the
     user  supplies  the  -rs  -re -ri and then the -Ffile can be
     omitted.  This will then automatically fill  in  any  needed
     records and will apend records at the begining or end of the
     data file.

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

     -F file
          Enter the name of the flat file containing  the  record
          number  (RecNum) and number of records to pad. The for-
          mat of the file is two integers  per  line:  the  first
          number  is  the  actual record number of the input data
          set after which records are to be  padded;  the  second
          number  is  the  number  of zero records to pad at this
          point. All records are scanned including those that are
          dead (unless -I is flagged below) so it is assumed that
          even dead input records have valid rec & trc numbers.

     -D   Enter the command line argument '-D' to flat the padded
          records as dead.

     -B   Enter the command line argument '-B' if the first entry
          in  the  padrec file corresponds to the first RecNum in
          the data set and you wish to pad before the first  live
          record.

     -I   Enter the command line argument  '-I'  to  ignore  dead
          input  records  (marked  with  30000  in  StaCor). This
          option is in case dead input  records  do  not  contain
          valid  RecNum and TrcNum entries.  This option is valid
          only when used with  -F  above.

     -rs start
          Enter the RecNum value for the first record to  output.
          If  using  the automatic pad option [i.e. no pad record
          file attached] this is a manditory parameter.  There is
          no default.

     -re end
          Enter the RecNum value for the last record  to  output.
          If  using  the automatic pad option [i.e. no pad record
          file attached] this is a manditory parameter.  There is
          no default.

     -ri inc
          Enter the RecNum increment used in the  input  dataset.
          The  default  is [1].  This parameter is only used with
          automatic padding.  It is ignored if a pad record  file
          is attached.

     -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

AUTHOR

     Paul Gutowski

COPYRIGHT

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