Information
Limited support BMC provides limited support for this version of the product. As a result, BMC no longer accepts comments in this space. If you encounter problems with the product version or the space, contact BMC Support.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see BMC AMI Recovery Manager for Db2 13.1.

Specifying objects for a new object set


You can specify objects for a new object set in a number of ways, depending on your situation or application, as follows:

Method

Description

Table space and/or Owner

Specify a table space name (databaseName.tableSpaceName) or pattern to create the object set. This method is usually the fastest way to produce an object set of table spaces and associated indexes. Optionally, you can specify the owner in the pattern. The default value is an * (asterisk).

You can manipulate the list to exclude or add additional spaces. You can also include one or more partitions when working with partitioned table spaces.

Warning

Important

You cannot include a specific partition of a given table space in the same list as the complete table space (the DSNUM 0 version).

You can optionally include objects associated with the objects included in the object set, as follows:

  • Associated indexes
  • Objects associated by referential integrity
  • Objects associated by LOB relationship
  • Objects associated by XML relationship
  • Objects associated by a history (versioning) relationship

Table name

Specify a table name (creator.tableName) or pattern to create the object set. You can manipulate the list to exclude or add additional tables.

Warning

Important

You can not list partitions with the list of tables.

You can optionally include objects associated with the objects included in the object set, as follows:

  • Associated indexes
  • Objects associated by referential integrity
  • Objects associated by LOB relationship
  • Objects associated by XML relationship
  • Objects associated by a history (versioning) relationship

Index

Specify an index name (authID.indexName) or pattern to create the object set. When you specify the indexes, you can also optionally list one or all partitions of the index.

Volume

Specify up to eight volumes concurrently by using the operating system volume names. You cannot use wildcards to specify a object set of volumes. For more information, see Creating-volume-based-object-sets.

STOGROUP

Specify objects by storage object set name or pattern to create the object set.

Plan

Specify objects by plan name or pattern to create the object set.

Warning

Important

Object sets built by plan are obsolete in Db2 Version 10 due to an empty SYSIBM.SYSPLANDEP table. BMC AMI Recovery Manager handles this situation with the following restrictions:

When running on Db2 Version 10 or later, BMC AMI Recovery Manager will include objects with package dependencies for object sets built by plan name.

These restrictions do not apply to Repository plan object sets.

Package

Specify objects by package (collectionID.package) to create the object set.

Exception status

Specify objects by exception status to create the object set. You can also choose to include all objects in one or more status types, all objects that are related by referential integrity, and all indexes on those objects.

The status types that you can choose from are:

  • Check pending (CHKP)
  • Advisory reorg pending
  • Copy pending (COPY)
  • Advisory rebuild pending
  • Informational copy pending
  • Auxiliary check pending
  • Logical page list (LPL)—the object has entries in the logical page list
  • Auxiliary warning
  • Recover pending (RECP)
  • Error range detected
  • Group recover pending (GRECP)
  • Stopped error range (STOPE)—stopped by Db2 due to log RBA error
  • Rebuild pending
  • Reorg pending
  • Persistent read only
  • Read or replication only
Warning

Important

Recover pending is the default status when you choose to create an object set by exception status.

Dynamic SQL

Specify objects by using a user-defined SQL SELECT statement. The SQL statements must be exactly as shown in the examples in the following table and cannot deviate except in the WHERE clause.

Object type

SQL statement

TS


SELECT 'TS', DBNAME, NAME FROM SYSIBM.SYSTABLESPACE WHERE DBNAME LIKE ‘QZU%’

SELECT 'TS', DBNAME, TSNAME, PARTITION FROM SYSIBM.SYSTABLEPART WHERE DBNAME='QZUDPT22' AND TSNAME='QZUS0122' AND PARTITION IN (4090, 4092, 4094, 4096)

IX


SELECT 'IX', CREATOR, NAME, CREATOR, NAME FROM SYSIBM.SYSINDEXES WHERE DBNAME = 'R92DB59'

SELECT 'IX', IXCREATOR, IXNAME, IXCREATOR, IXNAME, PARTITION FROM SYSIBM.SYSINDEXPART WHERE IXCREATOR='QZU' AND PARTITION > 100 AND PARTITION <= 200

SG

SELECT 'SG', CREATOR, NAME, CREATOR, NAME FROM SYSIBM.SYSSTOGROUPWHERE NAME LIKE 'JTR%'

Specify TS, IX, or SG as the first variable. BMC AMI Recovery Manager checks to make sure that 'TS', 'IX', or 'SG' follows the SELECT statement. Only one SQL statement is accepted. The statement is limited to 16,000 characters. Semicolons are not allowed.

If not specified, the partition number is set to 0.

The IX name length and number of partitions follow the rules of the Db2 Version that you are using.

Letters are used to represent related objects in the online Recovery Definition display and ARMBGRP Definition report. The following table provides the letters used and their definitions. While BMC’s Recovery Management products can resolve all of these letters designations, BMC AMI Recovery Manager can create only Y (Yes) and N (No). Only DASD MANAGER PLUS version 11.1.00 and later can create B (Bases only) and O (Only this type), in addition to creating Y (Yes) and N (No).

Letter designation

Definition

Y

Return all related objects as API currently functions.

N

Do not return related objects as API currently functions

B

Return only base objects of a relationship and any other objects that do NOT have that relationship.

O

Return only objects of the type included.

For examples, see Sample-ARMBGRP-JCL-and-output.

Recovery object sets

For ARMBGPS size balancing for a subset of the Db2 subsystem, specify the include and exclude patterns with the table space name or pattern to create the object set. These object sets are referred to as ARMBGPS application object sets and simplify the method for generating multiple jobs for an application. (These object sets are TYPE BA in the OBJSETS table.)

Warning

Important

ARMBGPS object sets LOB, XML and History objects with their related base table space, not by using the explicit name of the LOB, XML, or History object.

Repository plan

Specify an object set of plan names corresponding to the repository plan names for BMC AMI Recovery Manager, BMC AMI Recover, and Log Master.

Object set combination

Specify objects that are contained in other existing object sets to create a new object set. Object sets created via this method simply copy the definitions of the specified existing object sets and do not pull information directly from the catalog and directory. This method provides a way of create a new object set using mixed criteria (for example, storage group name and table space pattern).

Subsystem

Automatically create a set of balanced object sets for an entire Db2 subsystem. For more information, see Full-subsystem-recovery.

Indexspace

Specify an index space name (databaseName.indexSpaceName) or pattern to create the object set. When creating an object set by index space, you can include any number of index space names or wildcard patterns.

Object Sets

Specify a table space name and indexes by object set pattern to create a new object set. When creating an object set you can include wildcard patterns.

Set specification expansion

Wildcard processing uses the following characters and results in the use of a SQL LIKE operator for expansion:

  • * (asterisk) and % (percent sign): matches 0 to any number of characters in an object name string
  • ? (question mark) : matches any single character in an object name string

    If the qualifier does not contain any of the characters, BMC AMI Recovery Manager uses an equal operator (=) to locate a match. The qualifier terminates when the first blank encountered.

    When the patterns are expanded, all exclude patterns are processed first to build an exclusion list that is then applied to the include patterns, which are processed in order of inclusion.

    For more information, see Using-wildcards-when-building-object-sets.

SQL specification

If the pattern type is SQ, you enter a SQL statement. Whenever you enter or update the SQL statement, BMC AMI Recovery Manager performs a SQL PREPARE INTO to verify that the statement is valid. 


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Recovery Manager for Db2 12.1