GetDormantDIMClassObjects - Teradata Meta Data Services

Teradata Meta Data Services Programmer Guide

Product
Teradata Meta Data Services
Release Number
15.00
ft:locale
en-US
ft:lastEdition
2018-09-28
Product Category
Teradata Tools and Utilities

GetDormantDIMClassObjects

Purpose

GetDormantDIMClassObjects returns in objectList the list of dormant objects in the specified class that match selection criteria.

Description

The property id, property value and comparison operator on which to perform the search can all be specified. If multiple properties are specified in the search, the logical operator between the property searches must also be specified. The name of the property upon which to sort the returned list can also be specified.

Requirements

You must be initialized as an MDS Administrator (superuser) to use this function.

The class ID (internal or globally unique) must be set.

The propFilter list may contain zero or more CMetaFilterInfo objects.

The PropertyID (SetPropertyID()) or PropertyName (SetName()) of the value attribute in each CMetaFilterInfo object must contain a valid Relative Property Id or name of a property description in the class.

The value attribute in each CMetaFilterInfo object must also be set to the value on which the search will be made. This value must be of the same type as the property description. For example, if the search is to be made on Relative Property ID = 1 and Relative Property ID 1 is defined as an integer, Value must be set to an integer (SetInt()). If relative Property ID 1 is a string, Value must be set to a string (SetString()).

The default ComparisonOperator in each CMetaFilterInfo object is EQUAL and the default LogicalOperator is META_AND.

If the propFilter list contains zero objects, the function will perform a search by strObjName only. If strObjName is also NULL, the API will return all the objects in the collection.

If the propFilter list contains objects and strObjName is set, the logical operator between the properties and the name will the “AND”. To perform a search of a name “OR” a property, set strObjName to NULL and add a CMetaFilterInfo object to the propFilter list for a name search.

Syntax

HRESULT GetDormantDIMClassObjects(
vector<CMetaObject>& objectList,
const MetaFilterInfoVector& propFilter,
const MetaObjectKeyVector& sortlist,
const GUID& gClassID,
const OBJECTID_t lClassID = NULLLOID,
LPCTSTR strObjName = NULL,
const bool WithLock = false);
 

Argument

In/Out

Description

objList

In/Out

Reference to the list of CMetaObjects that will hold the collection returned. The list is cleared before adding the return collection.

propFilter

In

List of FilterInfo objects containing the property id and value to use to perform the search

sortList

In

List of property identifiers (relative property id or name) to sort the collection by. The return list will be returned in ascending order and the sort will not be case specific.

gClassID

In

Class GUID.

IClassID

In

Class internal ID

StrObjName

In
(Optional)

Search string for names of objects in the class to be returned.

WithLock

In

WithLock=true keeps the class table locked for WRITE. Use within an explicit transaction. Set WithLock to true when one of the class objects will subsequently be updated within the transaction. Prevents deadlocks caused by Teradata promotional locks.