MakeQuery Method

MakeQuery Method (McDataJournal)

Description

Performs a query and creates a query results child folder in the journal with the resultant nodes.

Return Type

A McDBNode object. The Journal search results child folder reference that contains the query results.

Syntax

object.MakeQuery ([pQueryDefinition], [eSearchContext], [vSearchContext], [eNodeRecurseMode], [sQueryName], [sSearchContext])

The MakeQuery Method syntax has these parts:

Part	Description
object	An expression evaluating to an object of type McDataJournal.
pQueryDefinition	Optional. An Object object.
eSearchContext	Optional. A mcDataMakeQueryContext enumeration, as described in settings. Specifies the source context of the query (Where to search).
vSearchContext	Optional. A Variant value. A string or for (mcdatmqc_SuppliedCollection or mcdatmqc_Database) a collection of DBNode specified by a McDataNodeRefs or McDBNodes reference or a McDatabase Reference.
eNodeRecurseMode	Optional. A mcDBQueryMode enumeration, as described in settings. (mcdatmqc_SuppliedCollection) How the query should recurse the children of pNodeCollectionOrDatabase
sQueryName	Optional. A String value. Name describing the query to be used in the query results folder (overrides McDbQuery.Description).
sSearchContext	Optional. A String value. May be used to describe the Search Context of the query. This value will be stored on the query results child folder.

Settings

The settings for eSearchContext are:

Constant		Value	Description
	mcdatmqc_UseQuery	0	Databases specified in the McDBQuery are searched.
	mcdatmqc_OpenMcDatabases	1	Performs search on the all the open databases in the McDBDatabases collection.
	mcdatmqc_AllMcDatabases	2	Same as mcdatmqc_ActiveOpenMcDatabases but first attempts to open all databases in the McDBDatabases collection.
	mcdatmqc_SuppliedCollection	4	Use the supplied McDataNodeRefs or McDbNodes collection and mcDBQueryMode option.
	mcdatmqc_Database	8	Use the supplied McDBDatabase

The settings for eNodeRecurseMode are:

Constant		Value	Description
	mcdbShallow	0	The McDBNode and its immediate Children
	mcdbRecursive	1	The McDBNode and all of its descendants
	mcdbNoForeign	2	Do not include foreign references [bit flag]
	mcdbShallowNoForeign	2	The McDBNode and all of its non-foreign children
	mcdbRecursiveNoForeign	3	The McDBNode and all of its non-foreign descendants
	mcdbNoLinks	4	Do not follow symbolic links [bit flag]
	mcdbShallowNoLinks	4	The McDBNode and its immediate children for which it is the primary parent
	mcdbRecursiveNoLinks	5	The McDBNode and all of its descendants that can be reached without following a symbolic link
	mcdbShallowNoForeignNoLinks	6	The McDBNode and its immeidate Children that are neither foreign nor symbolically linked
	mcdbRecursiveNoForeignNoLinks	7	The McDBNode and all of its descendants that are neither foreign nor symbolically linked
	mcdbLocal	8	The McDBNode only