Replacement for the DUMPLOAD command
Kent Fiala  <sasklf@vm.sas.com>
SAS Institute Inc.
http://www.sas.com/
 
 
 
DUMPEDIT can be used as a replacement for the DUMPLOAD command.  It also
allows you to specify ranges of pages to be omitted from the dump,
either at the time you load it, or later.  This can be useful to save
disk space when you need a dump that includes certain DCSS data, but you
don't want to keep the data for every DCSS.  Dumpedit also includes a
couple of other small features such as the ability to change the text
of the dumpid.
 
 
 >>--DUMPEDIT-.-inputfile--.-output file--(-.------------.--><
              '-| reader |-'                |--pagelist--|
                                            '--PAGElist--'
 
  reader:
      |--,--READER--.--.-----------.--|
         '--RDR-----'  '--spoolid--'
 
 where:
 
 inputfile is the CMS fileid of the dumploaded dump to be read.
   Filename is required.  Filename can not be READER or RDR.
   Filetype, if specified, must be DUMP0001
     if omitted, or specified as '.', defaults to DUMP0001
   Filemode defaults to '*'
 
 READER and RDR are reserved keywords indicating that the dump
   should be read from a reader file.  spoolid can be specified;
   if omitted it defaults to the first non-held dump in the
   reader.  After the dump is read, the reader file is held, so
   successive invocations will read successive reader dumps.
   Spoolid can be specified to read a held file.
   If spoolid is omitted, the filename of the output file
   can not have the form of a spoolid (integer from 1-9999).
 
 outputfile is the name of the new dump to be written
   Must be different from inputfile
   Filename:
     - If the input is a disk file, if the output filename is
       omitted or specified as '=', the input filename is used.
     - If the input is a reader file, if the output filename is
       omitted or specified as '.', the default filename is
       PRBnnnnn where nnnnn is a number.  If the output filename is
       specified as '=', the originid is used as the filename.
   Filetype, if specified, must be DUMP0001
     if omitted, or specified as '.' or '=', defaults to DUMP0001
   Filemode, if omitted or specified as '=', defaults to actual
     filemode of inputfile if the input is a disk file.  If the
     input is a reader file, output filemode defaults to A.
 
 pagelist is a list of paired page numbers.  Each pair
   represents the starting and ending page numbers (in hex)
   of a block of pages to be removed from the dump.
   The pairs do not need to be sorted.
 
   If pagelist is null, or if none of the specified pages are
   actually in the original dump, then:
   If the input is a reader file, the entire dump is loaded.
   If the input is a disk file, no new dump is written.
 
   If the keyword PAGELIST is specified, no output dump is
   produced, but a list of the megabyte ranges in which pages
   are present in the dump is written to the console.  This
   information can be helpful in identifying the location of
   DCSS data.
 
 Kent Fiala    sasklf@vm.sas.com    26 Sept 1996