ahmilb@houu64$bhparchive

  BHPARCHIVE creates a tar archive of one or more BHPIO datasets.

  Usage: bhparchive filename= archive= [optional parameters]     

  Required Parameters:                                           

    filename=name           Name of one or more existing BHPIO   

                            datasets, separated by commas.       

    archive=                File or device on which to write     

                            archived data.                       

  Optional Parameters:                                           

    pathlist=name.dat       BHPIO pathlist - contains list of    

                            directories where dataset partitions 

                            are written. If unspecified, pathlist

                            names are constructed as 'filename.dat',

                            and are assumed to be in the current 

                            working directory.                   

    size=                   Number of Gigabytes (1024*1024*1024) 

                            at which to switch output volumes.   

                            Individual files will NOT span archive

                            volumes. Therefore, size, if specified,

                            must be larger than the largest file 

                            to be archived. If unspecified, all  

                            data is archived to a single file or 

                            volume.                              

    stacker=no              Automatic stacker option. Default is to

                            issue and end-of-tape message and wait

                            for user to respond when next tape is

                            loaded. If stacker=yes is specified, 

                            a 'rewoffl' command is issued to go to

                            the next tape automatically.         

    verbose=0               Use verbose=1 to see extra printout. 

  BHPARCHIVE creates the archive using the UNIX tar command.     

  The first file written to each archive is named 'Table_of_Contents'

  and contains a list of all files written to that archive volume.

  The filesytem names in the pathlist file are not written to the

  archive, so that data can be restored to a set of directories  

  that are different from where it was archived.                  

  See BHPRESTORE for restoring archived BHPIO datasets.          

  Error Conditions:                                              

    The following conditions will cause bhparchive to abort.     

  Filename unspecified.                                          

  Number of pathlist entries does not match number of filename entries.

  Pathlist file does not exist.                                  

  Failure to find all of the .HDR files or data partitions for any

   filename.                                                     

  Failure to create archive file or failure to access archive device.

  Examples:                                                      

    bhparchive filename=stack archive=/dev/rmt0                  

      stack.dat is assumed to exist in the directory from which  

      bhparchive was run. All HDR files and data partitions will be

      written to a single tape. If not all data will fit, then   

      one or more files could be split across tapes.             

    bhparchive filename=stack,model pathlist=/data/x.dat,/data/y.dat \

     archive=/scratch/x.tar size=2                               

      Two BHPIO datasets will be archived. If not all data will  

      fit in 2GB, additional archive files will be created as    

      /scratch/x.tar.1, /scratch/x.tar.2, etc.