Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › Data Management Methods › IncludeDependencies Method—Sets or Retrieves the Object Dependencies Flag

IncludeDependencies Method—Sets or Retrieves the Object Dependencies Flag

The IncludeDependencies method sets or retrieves the object dependencies flag. This flag determines whether dependencies (objects that the current object depends on) should be included when the current object is imported or exported.

Syntax

The IncludeDependencies method has the following format:

Netegrity::PolicyMgtDataMgr‑>IncludeDependencies([dependFlag])

Parameters

The IncludeDependencies method accepts the following parameter:

dependFlag (int)

(Optional) Specifies whether to include dependencies in import and export operations:

• 1 specifies that dependencies are included
• 0 specifies that dependencies are excluded

Return Value

The IncludeDependencies method returns one of the following values:

• The existing dependencies flag value (0 or 1) if no argument is specified
• The new dependencies flag value if an argument is passed to the method

Remarks

The current object's descendants (for example, the realms under a realm) are always imported or exported, regardless of the setting of the IncludeDependencies flag.

For example, if the dependFlag parameter is 0 when a realm is exported, any child objects, such as realms under the realm, are also exported. But any of the realm's dependencies, such as an agent object, are not exported.

When you create a data manager object with the PolicyMgtSession‑>CreateDataManager method, this flag is initialized to 1 (include dependencies in import and export operations).

To set the dependencies flag, call this method before calling the PolicyMgtDataMgr‑>Export method or the PolicyMgtDataMgr‑>Import method for the object. For a given instance of the data manager, a flag maintains its setting unless you reset it.