Managing Applications and Paths

In this section:

Path management tasks are available from the Applications page, which is accessed by clicking Applications on the Web Console menu bar. The Application Directories folder is on the navigation pane. Above this pane is a set of icons that provide the quickest way to initiate path management tasks.

A single click on one of the following icons is enough to get you started.

Icon

Tool Tip

Function

Hide and Show tree

Toggles the navigation pane on and off, allowing one or both panes to occupy the screen, as needed.

Note that these icons are displayed in any context in which you might wish to toggle the navigation pane on and off.

Filter

This icon opens the Filter Applications Tree page, where you can filter synonyms, procedures, DM flows, HTML files, and SQL files.

Configure Application Path

Opens the Application Configuration pane from which you can create applications, add applications to the search path, map and reorder applications, delete applications or mappings from the path.

The Application Configuration pane provides additional icons designed to facilitate each of these tasks.

Refresh

Depending upon the selected context in the navigation pane, this icon refreshes the synonyms or procedures and HTML files listed in the application tree.

Note that this icon is displayed in any context in which you might wish to refresh the display of objects on the navigation pane.

Note: You can also right-click the Application Directories folder in both the Web Console and the Data Management Console to access the Configure Application Path option.



x
Creating and Mapping Applications

How to:

Applications are designed to group related components.

Applications can be created and mapped in either the Web Console or the Data Management Console.

Note: Application directory names must comply with the following rules:



x
Procedure: How to Create an Application
  1. From the Web Console menu bar, click Applications

    or

    from the Data Management Console, expand the Server node folder.

    On the Web Console, the Applications page opens.

  2. Right-click the Application Directories folder, select New, and then Application Directory.

    The Create New Application page opens.

  3. Use the default Application Type, Directory under APPROOT.
  4. Enter a name in the Application Name field.
  5. Enter a description in the Description field.
  6. The Add directory to APPPATH option is the default. Optionally, you can decide not to add the directory.
  7. Select a position from the Position in APPPATH drop-down menu. The options are Last and First. The default is Last.
  8. Select a profile from the Profile drop-down menu. The default is edasprof.
  9. Click OK.

The application is added to the Application Directories folder.



x
Procedure: How to Map an Application

You can map an application name to a physical directory anywhere in the file system. This application name can be then used in APP commands.

Application mappings can be added and deleted on a per profile basis from either the Web Console or the DMC.

  1. From the Web Console menu bar, click Applications

    or

    from the Data Management Console, expand the Server node folder.

    On the Web Console, the Applications page opens.

  2. Right-click the Application Directories folder, select New, and then Application Directory.

    The Create New Application page opens.

  3. Select Application Mapping from the Application Type drop-down menu.

  4. Enter a name in the Application Name field.
  5. Accept the default Physical location, enter a different location, or click the selector button (...) and navigate to a directory on your file system.

    For platforms other than USS, in addition to using the selector button, you can enter the full path of the physical directory to be mapped, in the format required on your platform. (If there are spaces in the directory you are mapping, you must enclose the entire path in double quotation marks.)

    For USS and PDS servers, in addition to using the selector button, you can enter values using the following formats:

    ext=//DD:ddname[;ext2=//DD:ddname2][...][;extn=//DD:ddnamen]

    whereextn are file type extensions.

    /dir/subdir

    entered manually or using the selector button.

    For PDS servers, you can also inform the high-level qualifiers of the data set collection that comprise this application. Here is an example of the format:

    iADMIN.SRV77.MAPAPP

    where the user has the following datasets (not in approot):

    IADMIN.SRV77.MAPAPP.FOCEXEC.DATA
    IADMIN.SRV77.MAPAPP.MASTER.DATA
    IADMIN.SRV77.MAPAPP.ACCESS.DATA
  6. If applicable, select the Create directory if it does not exist check box.
  7. Enter a description in the Description field.
  8. Add directory to APPPATH is the default. Optionally, you can decide not to add the directory.
  9. Select a position from the Position in APPPATH drop-down menu. The options are Last and First. The default is Last.
  10. Select a profile from the Profile drop-down menu. The default is edasprof.
  11. Click OK.

The mapping is added to the Application Directories folder.



x
Procedure: How to Delete an Application or the Application Mapping

Applications and application mappings can be deleted from either the Web Console or the DMC.

  1. From the Web Console menu bar, click Applications

    or

    from the Data Management Console, expand the Server node folder.

    On the Web Console, the Applications page opens.

  2. Right-click the application or application mappings and select Delete or Delete Mapping, respectively.

    A confirmation dialog box opens.

  3. Click OK to delete the application or application mapping.

Note: Deleting an application mapping will delete it from any APP PATH commands that reference it, if the APP PATH command is in the same profile as APP MAP.


Top of page

x
Nested Application Directories

How to:

A nested application directory is one created within a higher-level application. The server allows one level of nested application directories by default. The server must be configured for deeper or unlimited levels.

Nested application directories are implicitly added to the application path if the parent directory is on the application path.

For example, the following application tree has a directory named new1 that has a child directory named new2.

The APP PATH command explicitly places new1 on the application path:

APP MAP new1 "C:\ibi\apps\new"
APP PATH baseapp ibisamp new1

However, you can test the path to see all of the implicitly added directories by right-clicking the top level of Applications Directories tree and selecting Application Path. When the Application Configuration page opens, click Test:

The effective application path also includes new1/new2:



x
Procedure: How to Set the Level of Nested Application Directories
  1. From the Workspace menu, select Configuration/Monitor.
  2. Right-click the Application Settings folder and select Configure.

    Note: You can also right-click the Application Directories folder on the Application tree and select Application Path.

  3. Enter the level of nested applications in the nested_app field or select y from the drop-down menu. The default value is 1. Selecting y allows unlimited levels of nested applications.

    Note: For z/OS servers, this setting is only applicable to directory-style applications. It is not applicable to PDS-style applications nor to applications mapped as a collection of ddnames.

  4. Click the Save and Restart Server button.

    After the server restarts, you can create a new application subdirectory by right-clicking an application folder and selecting New and then Application Directory from the context menu.

Note: Nested applications must be in effect in order to create user home application directories.



x
Procedure: How to Create a Nested Application Directory
  1. From the Web Console menu bar, click Applications

    or

    from the Data Management Console, expand the Server node folder.

    On the Web Console, the Applications page opens.

  2. Right-click an application, select New, and then Application Directory.

    The Create New Application Directory page opens.

  3. Enter a name in the Application Name field.
  4. Optionally, enter a description in the Description field.
  5. Click OK.

The nested application is added to the application tree under its parent application folder.


Top of page

x
Home Application Directories for Users

How to:

You can configure the server to allow each user to have a home application directory. Providing a user home application directory gives each user a directory where he has full control to create, change, and run his applications.

Home application directories should be enabled only on secured servers. If the server runs with security OFF, all users have total control of files in all applications, and the home directories will not work as designed. Nested applications must be enabled in order to create user home application directories.

The Server Administrator can monitor and manage home application directories for all users and, therefore, all user home directories are visible and in the path on the Web Console application tree when the connected user has Server Administrator privileges.

When the server is enabled for home applications, user home application directories are not created automatically. Users can create them from the Web Console Application page, or ask their server admin to create them.

After a home application directory is created for a user:

Note: This feature is available only for customers that are licensed for Managed Reporting or DataMigrator.



x
Procedure: How to Enable Home Application Directories

In order to set up home directories for individual users, you must first enable nested applications. The home directory under which user application directories will be created is set during installation. The default is homeapps. The homeapps directory can be changed to a different physical location on the Application Setting page. All user home directories will be nested under the home directory.

  1. Under the Workspace menu, select Configuration/Monitor.
  2. Right-click the Application Settings folder and select Configure.

    Note: You can also right-click the Application Directories folder on the Application tree and select Configure Application Path.

  3. Check the location of the homeapps directory, and change it if a different physical location should be used.
  4. Choose y from the nested_app drop-down menu.
  5. Click the Save and Restart Server button to implement these changes.

    When the server restarts, go to the Applications menu. A Users Home folder will appear under the Application Directories tree.



x
Procedure: How to Manage Your Home Directory Privileges

If you have home applications, you can give privileges to any set of your home directories to other users, as long as you have the HPRIV (Manage Own Home Directory) privilege. The Server Administrator can set this privilege for any user. The General Privileges tab is shown in the following image.

Once the HPRIV privilege has been granted:

  1. Right-click the file or directory to which you want to grant access and select Privileges from the context menu.

    The Manage Privileges page opens, as shown in the following image.

  2. Right-click the icon to the left of the group or user to be granted privileges, and select Edit Privileges from the context menu.

    The File/Directory Privileges page opens, as shown in the following image.

  3. Check the boxes in the Effective column next to the privileges you want to grant, and click Apply.

Top of page

x
Configuring the Application Path

How to:

The applications available for inclusion in the search path are identified by name, type, and physical location. If the Add directory to APPPATH check box was selected when the application was created, it was automatically added to the search path. If not, you must explicitly add it to your search path.

Note: You can also create profiles from the Application Configuration page. Profiles are the locations in which the search path is saved.



x
Procedure: How to Configure the Application Path

You can configure the Application Path to add or remove applications or mappings from either the Web Console or the DMC.

  1. From the Web Console menu bar, click Applications

    or

    from the Data Management Console, expand the Server node folder.

    On the Web Console, the Applications page opens.

  2. Right-click the Application Directories folder, and select Configure Application Path, or in the Web Console, click the Configure Application Path icon.

    The Application Configuration page opens.

  3. Select a profile from the Profile drop-down menu. The default is edaprof.
  4. Select the check box in the In Path column for the application or mapping.

  5. Optionally, you can reorder applications in the APP PATH, using the Up and Down icons at the right. The top and bottom buttons move the application to the start or end of the APP Path. The center buttons move the application up or down one position.

  6. To remove an application, deselect the check box in the In Path column.
  7. Optionally, click Test to test modifications to the search path. A Test Application Path pane opens.

    The Test Application Path pane shows:

    • Executed profiles. This depends on the level of the profile you selected.
    • Executed commands. These are the APP commands executed for the profile you selected. The commands can include APP PATH, APP MAP, APP APPENDPATH, or APP PREPENDPATH.
    • Effective APP PATH. This is the effective application tree that will result from all the executed profiles, including the selected profile level. The execution sequence is: server profile (edasprof.prf), service profile, role profile, group profile, and user profile.
  8. Click Save.

The navigation pane is updated.

Note: You can also create a new profile from the Application Configuration page.



x
Procedure: How to Create a Profile

Profiles can be created from either the Web Console or the DMC.

  1. From the Web Console menu bar, click Applications

    or

    from the Data Management Console, expand the Server node folder.

    On the Web Console, the Applications page opens.

  2. Right-click the Application Directories folder, and select Application Path, or in the Web Console, click the Configure Application Path icon.

    The Application Configuration page opens.

  3. From the Profile drop-down menu, select New Profile.

  4. Enter a name is the New Profile Name field.
  5. Select an option from the Application Path drop-down menu.

    The options are:

    • Inherit from previously executed profiles
    • Override previously executed profiles
    • Prepend previously executed profiles
    • Append to previously executed profiles
  6. Optionally, click Preview to see the profile.

  7. Click Save.


x
Procedure: How to Edit a Profile
  1. From the Workspace menu, select Configuration/Monitor.
  2. On the navigation pane, open the Configuration Files and User Profiles folders.
  3. Right-click the profile and select Edit.

    The profile opens in a text editor with its current path displayed.

  4. Edit the path information and click the Save icon.

Tip: You can also edit a profile search path by selecting and saving configuration options. Follow instructions for configuring the application path.


Top of page

x
Filtering the Application Tree

How to:

Filtering enables you to limit the synonyms, procedures, DM flows, HTML files, and SQL files that appear in the application tree.



x
Procedure: How to Filter Items in the Application Tree

You can customize the items that display on the application tree by filtering. Your filtering selections apply to all applications displayed in the navigation pane.

  1. From the Web Console menu bar, click Applications.
  2. Click the Filter icon above the navigation pane.

    The Filter Applications Tree page opens.

  3. To filter on the names of items, enter a string in the Name field, followed by a percent sign (%). For example, entering dm% will only show items whose name begins with "dm". Note: This entry is case-sensitive.

  4. To filter on the descriptions of items, enter a string in the Description field, followed by a percent sign (%). For example, entering Sample% will only show items whose description begin with "Sample". Note: This entry is case-sensitive.

  5. Select the type(s) of file to be included from the File format check boxes.
  6. Optionally, select an adapter from the Synonyms Adapter drop-down menu. Only synonyms created with that adapter that match the filtering criteria will appear in the tree.
  7. Click Set Filter. The Filter Status page confirms that the filter was set.

When a application folder is opened, the Filter icon is superimposed on it in the navigation pane.

Note: You can remove the filter by clicking the Clear Filter button.


Top of page

x
Sorting the Application Tree

How to:

Sorting enables you to change the order in which items are listed on the application tree.



x
Procedure: How to Sort the Application Tree
  1. From the Web Console menu bar, click Applications.

    The Applications page opens.

  2. In the navigation pane, right-click Application Directories, select Display Preferences, then Sort by, and then a sort method.

    You can sort by Name, Size, Type, or Modified date. Type is the default.


Top of page

x
Managing Application Files

How to:

You can copy and move files between applications, delete them from applications, and refresh synonyms in applications.



x
Procedure: How to Manage Application Files
  1. From the Web Console menu bar, click Applications.
  2. Right-click an application folder and select Manage Files.

    The Manage Files page opens.

  3. Select the check box next to one or more files. To select all files, click Select All.
  4. Select an application from the Application for Copy/Move drop-down menu.

    Note: In nested applications are enabled, a selector (...) button will be available instead of a drop-down menu, as show in the following image.

    The selector button opens the Select Application dialog box which allows you to navigate to the application.

  5. Click Copy or Move.

    The file(s) are copied or moved to the selected application.

  6. To delete files, select their check boxes and click Delete.


x
Procedure: How to Refresh Synonyms in an Application
  1. From the Web Console menu bar, click Applications.
  2. Right-click an application folder and select Manage Files.

    The Manage Files page opens.

  3. Select the check box next to one or more synonyms.

    To refresh all listed synonyms in the selected application, click Select All.

  4. Click Refresh Synonym.

Top of page

x
Using the File Search Tool

Reference:

The File Search tool provides a search function on the Web Console Application tree. It can search for files in all application directories in the active Application path, in all mapped directories, or in all applications under APPROOT.

All of the selections you make will be added to the search conditions. For example, if you choose mas from the File Extension drop-down menu, and select the Search in Active Application Path and Search in All Mapped Applications check boxes, it will search all mapped application in the active application path for files with a .mas extension.



x
Reference: File Search Tool

The File Search tool, as shown in the following image, is available by right-clicking an Application Directory in the navigation pane.

The File Search tool has the following options:

File Name and Location

All or Part of File Name

Enter a full name or a partial name with a wildcard symbol (%).

File Extension

Select an extension from the drop-down list or type one into the field. The drop-down options are fex, mas, acx, sql, htm, dat, and foc, but you can search for other extensions by entering them in the File Extension field.

Search in Active Application Path

Select to limit the search to the active Application Path.

Search in All Mapped Applications

Select to search all mapped applications.

Search in All Applications under APPROOT

Select to search all applications under APPROOT.

Look in Application

Enter an application or click the browse button (...) to select one.

Procedure Properties

Scheduled

Select to search for scheduled procedures.

A Word or Phrase in the Description

Enter a string to search for in the description of the procedure.

Stored Procedures

Select to search for stored procedures.

DM Flows

Select to search for DataMigrator flows.

Synonym Properties

A Word or Phrase in the Remarks

Enter a string to search for in the remarks in the synonym.

Adapter

Select an adapter from the drop-down list.

File Statistics

File Size More Than

Enter a file size to limit the search.

File Size Less Than

Enter a file size to limit the search.

File Modified After

Enter a date to limit the search.

File Modified Before

Enter a date to limit the search.


iWay Software