Managing Application Directories and Configuring the Application Path

How to:

Reference:

Procedures and the synonyms they use reside in application directories. The Application Path is a list of viewable application directories. It determines their order of appearance in the navigation pane.

The Application Path is the default search criteria for the server. The server searches each of the directories listed in the Application Path sequentially to find the requested procedure/synonym.

By default, the server profile (EDASPROF.PRF) is run for all users when they connect to the DataMigrator Server to provide access to all application directories in the server search path.

However, you can control a users access to application directories by creating individual user profiles. Each user can then:

Grouping procedures and synonyms into application directories provides better control. For your convenience, three directories are included in the server search path during installation:

You can, of course, set up additional application directories in the server search path.

The following operations are available from the Application Directories folder by right-clicking in the DMC or Web Console.

You can also use the Configure Application Path window to set the viewable directories for DataMigrator, as well as add new directories and mappings. To use DM procedures that reside in a directory other than ibi\apps\baseapp, the directory must be added to the list of viewable directories.

Note: You can also manage application directories and configure the Application Path from the Procedures page of the Web Console. For information, see the Server Administration for UNIX, Windows, OpenVMS, IBM i, and z/OS manual or the Web Console online help.


Top of page

x
Procedure: How to Create an Application Directory
  1. Right-click Application Directories in the navigation pane. Select New and then Application Directory, as shown in the following image.

    New Application Directory

    The Create New Application Directory dialog box opens, as shown in the following image.

    Create New Application Directory Dialog Box

  2. Enter the name of the new application directory, and optionally a description. Leave the Append directory to APPPATH checkbox selected. Click OK.

    Caution: The directory name may not contain spaces, special characters, or capital letters. Capital letters are converted to lowercase. If the name contains spaces, each section is understood to be a separate directory. If an application directory is created outside of the DMC or Web Console, the same rules apply.

    If a directory was created outside of the DataMigrator environment and the recommended guidelines were not followed, the directory should be managed under the user responsibility, as an unexpected error might occur.


Top of page

x
Procedure: How to Remove an Application Directory From the Application Path
  1. Right-click Application Directories in the navigation pane and select Application Path, as shown in the following image.

    Configure Application Path Option

    The Application Configuration dialog box opens, as shown in the following image.

    Application Configuration

  2. Find the application directory you wish to delete. Under the “In Path” column, remove the check from the checkbox.
  3. Click Save.

Top of page

x
Procedure: How to Delete an Application Directory

Note: You must be connected to a server from a Server Administration ID.

  1. If the application directory is still located in the application path, remove it. See How to Configure the Application Path.
  2. Right-click Application Directories.
    • Click on Show Applications not in Path, if available.
    • Skip this step if Hide Application Directories not in Path is the available option.
    • If neither option appears, make sure you are connected to the server from a Server Administration ID.
  3. Expand Inactive Directories.
  4. Underneath Inactive Directories, right-click on the directory you want to delete and select Delete.
  5. In the Confirm dialog box, click OK.

Top of page

x
Procedure: How to Add Application Directory Mappings

You can create a new mapping to a directory anywhere in the file system and include it in the server path. Application directory mappings can be added and deleted on a per profile basis.

  1. Right-click Application Directories in the navigation pane and select Application Path.

    The Application Configuration dialog box opens, as shown in the following image.

    Application Configuration dialog box

  2. From the drop-down menu, select a user profile. This profile will have the directory mapping added to it.
  3. Click the New button.

    The Create New Application dialog box opens.

  4. In the Create New drop-down menu select Mapping, as shown in the following image.

    Create New Application

  5. In the Mapping Name box, enter an application name of up to 64 characters.
  6. In the Physical location box, enter the full path of the physical directory to be mapped, in the format required by your platform.

    Optionally, in the Description box enter a description. If needed, check the Create directory if none exists checkbox.

  7. Click the OK button.

    The new mapping appears in the Application Configuration dialog box, as shown in the following image.

    Application Configuration dialog box

  8. Click Cancel.

Note: The mapping must still be added to the Application Path.


Top of page

x
Procedure: How to Delete Application Directory Mappings
  1. Right-click Application Directories in the navigation pane and select Application Path.

    The Application Configuration dialog box opens, as shown in the following image.

    Application Configuration dialog box

  2. Right-click the mapping you want to delete and select Delete Mapping.

    A confirmation dialog box opens, as shown in the following image.

    Confirmation dialog box

  3. Click OK.

Top of page

x
Procedure: How to Configure the Application Path

You must add an application directory or mapping to the Application Path for it to be accessible.

  1. Right-click Application Directories in the navigation pane and select Application Path, as shown in the following image.

    Configure Application Path

    The Application Configuration dialog box opens, as shown in the following image.

    Application Configuration dialog box

  2. Select the profile of the user whose Application Path you wish to set.
  3. Select the In Path check box for the directory or mapping you want to add to the application path.
  4. Optionally, deselect the In Path check box for any directory or mapping you want to remove from the application path. This allows you to remove the directory or mapping from the path without deleting it completely.
  5. Set the directory search order by selecting a directory or mapping and using the up and down arrows.

    You may want to consider moving the ibisamp directory to the bottom of the list to avoid confusion. If you do not plan to use the sample data, you can remove ibisamp from your Application Path completely.

  6. When you have added and arranged all necessary directories and mappings, click Save.
  7. Right-click Application Directories in the navigation pane and select Refresh to see the directory or mapping in the tree.

    Note: If there is a long list of application directories, you can click the FInd button on the top right or use Ctrl + F to find a text string in the name, physical location, or description.


Top of page

x
Reference: Application Directories Options

If you right-click Application Directories in the DMC navigation pane, the options shown in the following image are available:

Application Directories Options

Refresh

Refreshes the application directories tree.

Explorer

Opens a windows explorer style window on the right side of the Data Management Console that shows detailed information about the currently selected server object.

New

Allows you to add procedures and synonyms on the server.

Display Preferences

Allows you to set preferences to how objects in an application directory are viewed. This option contains a Sort by sub-menu that allows you to select the order in which server objects appear under each application directory. The choices are name, size, type, and modified.

Application Settings

Opens an Applications Settings dialog box that allows you to set settings for the foccache and home application root directories.

Application path

Allows you to add and delete application directories and mappings from the application path.

Create Samples

Creates sample procedures and data for DataMigrator. For more information, see How to Create Sample Procedures and Data.

Schedule/E-mail

Has the following options:

  • Manage. Allows the schedule and email notification settings for a flow or stored procedure to be changed without opening the flow, as seen in the following image.

    For more information about scheduler options, see Schedule Attribute Pane. For more information on e-mail notifications, see Flow Properties Pane - E-Mail Notification Attribute.

  • Scheduler Agents. This report runs for the user whose ID value is stored in the sched_scan_id of a Scheduler. The Scheduler must be active to run the Scheduler Agents report.
  • Scheduled Events. Opens a window that shows all jobs scheduled to run during a specified time range, as seen in the following image.

    Scheduled Events window

    The Scheduler must be active to run the Scheduler Events report.

Log and Statistics

Opens the Log and Statistics dialog box that enables you to view a log or statistics report.

The following options are available:

Report Type

Allows you to select either a log or statistics report.

Report Range

Allows you to select to view the last report, all the reports, or a report specified within a select time range.

Completion Status

Allows you to view all reports, all completed reports, all completed successfully reports, or all completed reports that contained errors.

Run by

Allows you to view reports for all flows, and those initiated by the scheduler or submit. This includes flows initiated from the DMC, WC, and CMRUN.

Flow Name

Allows you to select a specific flow name for the report.

Impact Analysis

Opens a sub-menu that allows you to view impact analysis reports. For more information, see Impact Analysis Reports on Synonyms, Procedures and Columns.

File SearchView

Allows you to search for a specific file using paramters such as name, file extension, procedure properties, or synonym properties.


iWay Software