OBJECTSET specification for MIGRATE

The OBJECTSET option is available in MIGRATE statement syntax to migrate groups that are defined using BMC AMI Recovery Manager. For the OBJECTSET specification, see MIGRATE syntax.

OBJECTSET creator.name

The following rules apply to creator.name:

  • creator specifies the name of the creator of the group and can have up to 128 characters in length.

  • name species the group name and can have up to 128 characters in length.

  • You can delimit both creator and name with single or double quotation marks.

  • Both creator and name can contain the special characters $, #, and @ in any position.

BMC AMI Recover uses dynamic grouping to determine the group contents at the time that you run the BMC AMI Recover job containing the OBJECTSET option. Because BMC AMI Recover reads the objects in the group each time the job is executed, objects may be added or removed from the group.

Following are restrictions that apply when you use OBJECTSET in any of its forms on the RECOVER statement:

  • You cannot specify DSNUM with OBJECTSET. BMC AMI Recover uses the group definition for the object.

  • BMC AMI Recover allows only one OBJECTSET clause, and the statement cannot contain additional TABLESPACE clauses.

When you use OBJECTSET, if BMC AMI Recover tries to migrate a group of objects and more than 10 of the objects are unrecoverable, BMC AMI Recover issues an error for each object that is unrecoverable and discontinues further processing of the group. This behavior is based on the ERRCONT option that has a default value of 10. To avoid this behavior, set the ON ERROR CONTINUE option with a value that will exceed the possible number of errors in the group, and the migration will complete.

If a table space is found in the OBJECTSET but it is not found in the migration file, the table space is considered unrecoverable. You can use the EXCLUDE specification to eliminate this object from the OBJECTSET.

OptionDescription
EXCLUDE (dbname.ts or qualifier.ix)

Use the EXCLUDE option after an OBJECTSET specification to exclude one or more objects from the migration. You can use wildcards or specific names to specify the exclusions. The following wildcards are valid:

  • % and * match one or more characters in the object name.

  • _ and ? match a single character in the object name.

List the excluded objects following the EXCLUDE keyword. Each item in the list must be in the form dbname.ts or qualifier.ix and you must separate the individual items with commas. Enclose the list in parentheses.


Related topic

Was this page helpful? Yes No Submitting... Thank you

Comments