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 with referential integrity
  • Objects associated with LOB relationship
  • Objects associated by XML relationship
  • Objects associated with 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 with referential integrity
  • Objects associated with LOB relationship
  • Objects associated by XML relationship
  • Objects associated with 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 an 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.

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 the 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
  • (BMC.DB2.SPE2504)Rebuild Pending Empty
  • 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 the 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 letter designations, BMC AMI Recovery Manager can create only Y (Yes) and N (No). Only DASD MANAGER PLUS 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 ARMBGRP-sample-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 BMC AMI 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 creating 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 an 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 is 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 13.1