ahmilb@houu64$bhprestore

  BHPRESTORE extracts a BHPIO dataset from a tar archive.        

  Usage: bhprestore archive= filename= [optional parameters]     

  Required Parameters:                                           

    archive=name            Name of tar archive containing the   

                            dataset to be restored.              

    filename=name           Name of BHPIO dataset to restore.    

                            Filename must match the filename that

                            was archived.                        

  Optional Parameters:                                           

    pathlist=name.dat       BHPIO pathlist - contains list of    

                            directories where dataset partitions 

                            are to be restored. A dataset does not

                            have to be restored to the same      

                            directories from which it was archived.

    toc=no                  If toc=yes is specified, then the    

                            Table of Contents is retrieved from the

                            archive and printed. No data is restored.

    offline=yes             Archive device will be taken offline 

                            after restore unless offline=no is   

                            specified. If offline=no is specified,

                            the device will be rewound, and      

                            remain online for another restore operation.

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

  See BHPARCHIVE to create a tar archive of BHPIO data.          

  When restoring data from an archive, bhprestore checks the available

  space on all the pathlist directories and uses the one with the

  most space to load each partition.                             

  Error Conditions:                                              

    Not enough disk space to load next partition.                

    Unable to read archive file or volume.                        

    Multiple filename or pathlist entries specified. Only one    

    dataset can be restored per job.                              

    Specified filename cannot be found on archive.               

    archive or filename unspecified.                             

  Examples:                                                      

    bhprestore filename=stack archive=/dev/rmt0                  

      stack.dat is assumed to exist in current directory.        

    bhprestore toc=yes archive=/dev/rmt1                         

      Table of contents is retrieved and listed.