Collations; Guidelines; Example - HP BACKCOPY Reference Manual

Guidelines

To register SQL objects in a different catalog than they were originally registered in, use
CATALOGS. If the objects are being restored on a different system, use a fileset that describes
the destination fileset, not the original.
If you use the MAP NAMES option to move SQL objects, make sure to define the MAP NAMES
and CATALOGS parameters correctly for the dependent tables, indexes, views, and programs.
An incorrect mapping scheme can leave objects invalid or cause the RESTORE process to fail.
For more information, see
(page 166).
CAUTION:
when recovering an individual partition:
If the CATALOGS option is specified, every associated catalog must be mapped.
If the MAP NAMES option is specified, every partition must be mapped.
If the maps are incomplete or incorrect, severe catalog inconsistencies for the object will result.
These inconsistencies are quite difficult to repair, so make sure to avoid them.
If you specify CATALOGS, you cannot specify the PARTONLY ON or PARTONLY PARTIAL
option unless you also specify the KEEP option. You might use these options together with
MAP NAMES to move SQL partitions between production and development systems when
data volume exceeds practical tape set limitations, or for migration operations. This does not
necessitate any purges on the target system.
If you omit the CATALOGS option, or if there are some SQL objects to restore for which you
do not specify a catalog, RESTORE first tries to use the catalog in which the object was
described during the BACKUP process. If this catalog no longer exists or is unavailable and
the AUTOCREATECATALOG ON option is not specified, the SQL object is not restored, and
an error is reported.
For complete instructions on moving or renaming a catalog, see the SQL/MP Installation and
Management Guide.

Example

To assign $NEW.CAT as the catalog for SQL objects that are restored during this RESTORE process:
1> RESTORE $TAPE, *.*.*, CATALOGS ($NEW.CAT FOR *.*.*),&
1> &AUDITED

COLLATIONS

The COLLATIONS option specifies collation maps to use when restoring files.
COLLATION[S] { ( mapping-rule [, mapping rule ..... )
mapping-rule
is an ordered set of rules (collation map) that determines how to map a file name:
(collation-name, collation-name) FOR simple-fileset-list
collation-name
is a mapped collation name.
simple-fileset-list
is a general file-set list that includes the names of any objects to restore using the collation.
Restoring Using Name Mapping (page 171)
It is critical that the CATALOGS and MAP NAMES mapping lists are complete even
and Restoring SQL Files
}
RESTORE Options 131