Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › Session Methods › CreateDataManager Method—Creates Data Manager Object

CreateDataManager Method—Creates Data Manager Object

The CreateDataManager method creates a data manager object. The data manager is responsible for exporting and importing all policy store objects. The data manager object specifies the temporary files used in the import and export operations.

If objects are exported to one set of temporary files and imported from another set of temporary files, then two instances of the data manager are required. However, if objects are exported to and imported from the same set of temporary files, only one instance of the data manager is required. For more information, see the methods PolicyMgtDataMgr‑>Export and PolicyMgtDataMgr‑>Import.

Note: To migrate policy store objects from one version of SiteMinder to another, you must use the SiteMinder tools smobjexport and smobjimport. For more information, see the Policy Server Installation Guide.

Syntax

The CreateDataManager method has the following format:

Netegrity::PolicyMgtSession‑>CreateDataManager([difFileName][, cfgFileName][, fileOverwriteFlag])

Parameters

The CreateDataManager method accepts the following parameters:

difFileName (string)

(Optional) Specifies the filename and optional path of the temporary file that stores the policy store data.

Default: migration.smdif

Note: The data is stored in the SiteMinder Data Interchange Format (DIF), the standard for sharing data between policy stores.

cfgFileName (string)

(Optional) Specifies the filename and optional path of the configuration file.

Default: migration.cfg.

Note: The configuration file is a text file that stores information needed for the export and import operations, such as the IP address, redirection URLs, shared secrets, and logging settings. This information is separated by tabs and can be copied to a Microsoft Excel spreadsheet.

fileOverwriteFlag (int)

(Optional) Specifies whether to overwrite existing objects in the temporary file in an export operation:

• value = 1

  Specifies that the export objects overwrite all existing objects in the temporary file.

• value = 0

  Specifies that the existing objects in the temporary file are not overwritten and that any new export objects are added to the temporary file.

Return Value

The CreateDataManager method returns one of the following values:

• PolicyMgtDataMgr (object)
• undef if the call is unsuccessful