Managing Applications and Paths in the Web Console

In this section:

You begin all path management tasks by selecting either Metadata or Procedures on the Web Console menu bar. Both choices display the Application Directories folder 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 icons, shown in the following table, is enough to get you started.

Icon

Tool Tip

Function

and

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

Depending upon the selected context in the navigation pane, this icon opens the Filter Metadata Tree pane (where you can filter synonyms), or the Filter Procedures Tree pane (where you can filter procedures and HTML files).

Configure Path

This icon 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.

 

Using Context Menus to Initiate Path Configuration and Filter Options

As an alternative to using path management and filtering icons, you can initiate these tasks from right-click menus that appear at three levels of the Application Directories tree.

Note: If you prefer to use left-click behavior to access these menus, choose My Console, then select Preferences from the Web Console menu bar. On the Preferences pane, select the Left-click to show pop up menu check box, then click Update. The behavior change takes effect after you refresh your browser. (This is particularly useful for browsers that do not support right-click behavior.)



x
Working in the Application Configuration Pane

How to:

The applications available for inclusion in the search path are identified by name, type, and physical location. With the exception of the baseapp application, which is always part of the search path, (and the foccache directory, which is automatically added to the search path when you connect to the server), you must explicitly add applications to your search path.

On the Web Console menu bar, select Procedures or Metadata.

Click the Configure Path icon above the navigation pane. The Application Configuration pane opens.

All path configuration tasks are managed from a single pane that provides its own set of icons to facilitate your work.

On a Unified Server using PDS deployment, the physical location designations on the Application Management pane look a little different, but the icons are the same.

Click one of the following icons to initiate these tasks.

Icon

Tool Tip

Create Directory under APPROOT

Create New mapping

Above the Application directories list, the tip reads: Delete application directory or remove mapping

Above the APP PATH box, the tips reads: Delete from APP PATH

Up in APP PATH

Down in APP PATH

Copy APP PATH from server and group profiles

(Appears when configuring a new or existing user or group profile, but not the server profile.)

The procedures that follow will explain how to:



x
Procedure: How to Create a Profile in the Web Console

To create a profile:

  1. Select New Profile from the drop-down list.
  2. Enter a new profile name in the box provided. Continue to the configuration options as described in How to Configure the Application Path in the Web Console.


x
Procedure: How to Edit a Profile in the Web Console

To edit an existing profile:

  1. Select a profile from the drop-down list.
  2. Click the Edit button. The profile opens in a text editor with its current path displayed.
  3. Edit the path information and click the Save icon.

Tip: You can also edit the search path of the profile by selecting and saving configuration options, as described in How to Configure the Application Path in the Web Console.



x
Procedure: How to Create an Application in the Web Console
  1. If you are not already at the Application Configuration pane, do one of the following:
    • In the Web Console, select Procedures from the menu bar.
    • In the DMC, right-click the server name and choose Access Web Console, Procedures.

    The Procedures pane opens.

  2. Click the Configure Path icon above the navigation pane.

    The Application Configuration pane opens.

  3. Under Application directories, click the Create Directory under APPROOT icon.
  4. Enter the application name in the pop-up window. The name can not contain spaces. If the name contains spaces, each section is understood to be a separate application.
  5. Click OK.

    The new application is added to the Application directories list.

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



x
Procedure: How to Map an Application in the Web Console

You can assign an application name to a non-approot application anywhere in the file system. This application name becomes a virtual application under approot, which can be referenced in an APP PATH command and any other APP command that the takes an application name as a parameter. (Note that mapping does not automatically add an application to the path. It simply makes it available for addition to the search path.)

Application mappings can be added and deleted on a per profile basis.

  1. If you are not already at the Application Configuration pane, do one of the following:
    • In the Web Console, select Procedures from the menu bar.
    • In the DMC, right-click the server name and choose Access Web Console, Procedures.

    The Procedures pane opens.

  2. Click the Configure Path icon above the navigation pane.

    The Application Configuration pane opens.

  3. You can include the mapping in a server, group or user profile. The global profile, edasprof, is set by default.

    Choose a profile from the drop-down list. The selected profile will have the application mapping added to it.

  4. Under Application directories, click the Create New mapping icon.

    An input screen is displayed.

  5. In the Mapping name box, enter an application name of up to 64 characters.
  6. In the Physical location box:
    • For platforms other than USS, 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 HFS and PDS deployments, enter values using the following formats:

      HFS

      PDS

      ext=//DD:ddname

      or

      /dir/subdir
      ext=//DD:ddname

    If applicable, click the check box next to Create directory if none exists.

  7. Click OK.

    The application is marked Yes in the Mapped column of the Application directories list.

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



x
Procedure: How to Configure the Application Path in the Web Console

If you are not already at the Application Configuration pane, do one of the following:

  1. Either
    • In the Web Console, select Procedures from the menu bar.
    • In the DMC, right-click the server name and choose Access Web Console, Procedures.

    The Procedures pane opens.

  2. Click the Configure Path icon above the navigation pane.

    The Application Configuration pane opens.

  3. To add an application to the APP PATH of the server, select the candidate application in the Application Directories list and click the arrow between the boxes. The application is added to the APP PATH box.
  4. To reorder applications in the APP PATH, use the Up and Down icons above the APP PATH box.
  5. To remove an application from the APP PATH box, select it and click the Delete icon.
  6. Click the Test button to test modifications to the search path. An APP PATH Test window like the following opens.

    • Executed profile shows which profiles have been executed. This depends on the level of profile you have selected.
    • Executed command shows the APP command that results from the options selected on the configuration pane. The command will be either APP PATH or APP PREPENDPATH.
    • Effective APP PATH shows the effective application tree that will result from all the executed profiles, including the selected profile level. If edasprof was selected, then only edasprof will be executed. If a group profile is selected, edasprof will be executed followed by the group profile. If a user profile is selected, then edasprof will be executed, followed by a group profile (if available) and then by the user profile.
  7. If you select a group or user profile from the drop-down list, three additional options for configuring the path become available:
    • Copy APP PATH From Server and Group Profiles icon above the APP PATH box enables you to quickly copy the effective APP path from the server profile (and/or from a group profile if available) into the APP PATH box, after which you can make additional adjustments to the path, as required.
    • Override server/group profile radio button below the APP PATH box. This button is selected by default. When you click Test, applications in the APP PATH box are executed in APP PATH format, overriding any previously executed paths (including those defined in the server profile and/or in a group profile, if one exists.)
    • Prepend to server/group profile radio button below the APP PATH box. When you click Test, applications in the APP PATH box are executed in APP PREPENDPATH format. This option adds applications listed in the APP PATH box to the beginning of the effective search path.
  8. When you are satisfied with your changes to the server profile, click the Save button. The navigation pane is updated.


x
Procedure: How to Delete an Application in the Web Console

Do one of the following:

  1. Either
    • In the Web Console, select Procedures from the menu bar.
    • In the DMC, right-click the server name and choose Access Web Console, Procedures.

    The Procedures pane opens.

  2. Click the Configure Path icon above the navigation pane.

    The Application Configuration pane opens.

  3. Select the application you want to delete from the Application directories list, and click the Delete icon.

    A confirmation dialog box opens.

  4. Click OK to delete the application.


x
Procedure: How to Delete Mapping in an Application in the Web Console

If not already open, open the Application Configuration pane, do one of the following:

  1. Either
    • In the Web Console, select Procedures from the menu bar.
    • In the DMC, right-click the server name and choose Access Web Console, Procedures.

    The Procedures pane opens.

  2. Click the Configure Path icon above the navigation pane.

    The Application Configuration pane opens.

  3. Select an application that is marked Yes in the Mapped column of the Application directories list.
  4. Click the Delete icon.
  5. You are prompted to confirm that you wish to delete the mapping from the designated profile. Click OK to proceed.

    The mapping is removed from the Application directories list.

Note: Any APP PATH commands that reference the deleted APP MAP will not be changed by this action. To remove the previously mapped application from the path, select it in the APP PATH box and click the Delete icon above the box.


Top of page

x
Filtering Synonyms and Procedures

How to:

You can limit the synonyms, procedures, and html files that appear in the application tree.



x
Procedure: How to Filter Synonyms in the Metadata Tree in the Web Console

You can limit the synonyms that appear in the application tree on the Web Console Metadata Page by applying a filter. Your filtering selections apply to all applications displayed in the navigation pane.

To filter synonyms in the metadata tree, do one of the following:

  1. Either
    • In the Web Console, select Metadata from the menu bar.
    • In the DMC, right-click the server name and choose Access Web Console, Manage Metadata.

    The Metadata pane opens.

  2. Click the Filter icon above the navigation pane.

    The Filter Metadata pane opens.

  3. Click the Filter by drop-down list and choose:
    • Name to filter on a synonym name.
    • Adapter to filter on the adapter (or data source) type that follows the synonym name in the listing on the Metadata navigation pane.
    • Remarks to filter on remarks in the Filename section of a synonym. For example:
      FILE=   , SUFFIX=     ,
      .
      .
      .
      REMARKS='Inventory'  ,$
  4. In the Containing input box, enter the string you wish to filter on. The procedure will be displayed if the letter combination appears anywhere in the item selected from the drop-down list.

    Note that these entries are case sensitive.

  5. Click Set Filter. The Filter Status page confirms that the filter was set.

    The Filter icon is superimposed on the folder icon in the navigation pane.

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



x
Procedure: How to Filter Procedures and HTML Files in the Procedures Tree in the Web Console

By default, only procedures are listed in the application tree on the Procedures pane, but, by applying a filter, you can show the procedures and/or html files in the application tree. Your filtering selections apply to all application displayed in the navigation pane.

To filters procedures and html files in the procedures tree, do one of the following:

  1. Either
    • In the Web Console, select Procedures from the menu bar.
    • In the DMC, right-click the server name and choose Access Web Console, Procedures.

    The Procedures pane opens.

  2. Click the Filter icon above the navigation pane.

    The Filter Procedures Tree pane opens.

  3. Click the Filter by drop-down list and choose:
    • Name to filter on a procedure name.
    • Description to filter on the Description keyword (-*DM_REQ_DESC=) in Data Migrator flows.
  4. In the Containing input box, enter the string you wish to filter on. The procedure is displayed if the letter combination appears anywhere in the item selected from the drop-down list.

    Note that these entries are case sensitive.

  5. In the File format box, choose Procedure, HTML or Both Procedure and HTML. The list in the navigation pane displays files in the selected format(s).
  6. Click Set Filter. The Filter Status page confirms that the filter was set.

    The Filter icon is superimposed on the folder icon in the navigation pane.

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


Top of page

x
Managing Application Files on the Web Console

How to:

You can copy and move one or more synonyms or procedures between applications, delete one or more synonyms or procedures from applications, and refresh one or more synonyms in applications.



x
Procedure: How to Refresh Synonyms in an Application
  1. From the Metadata navigation pane, click an application and choose Manage Files from the menu. The Manage Synonyms pane for the selected application opens.
  2. From the list of synonyms at the bottom of the pane, click check boxes for the synonyms you wish to refresh.

    To refresh all listed synonyms in the selected application, click the check box at the top of the column.

  3. Click the Refresh Synonyms button.


x
Procedure: How to Copy Synonyms or Procedures From One Application to Another
  1. From the Metadata or Procedures navigation pane, click an application and choose Manage Files from the menu. The Manage Synonyms or Manage Procedures pane for the selected application opens.
  2. To copy files into another application on your path, select that application name from the Application for Copy/Move drop-down list.
  3. From the list of Synonyms or Procedures at the bottom of the pane, click check boxes for the file(s) you wish to copy.

    To copy all listed files from one application to another, click the check box at the top of the column.

  4. Click the Copy button. A confirmation page indicates that the file or files have been successfully copied.
  5. Click the Refresh icon above the navigation pane to update the affected applications.

Tip: Alternatively, expand the Application Directories folder, expand a specific application folder, click a synonym or procedure, and choose Copy synonym or Copy (procedure) from the menu. Then select the application to which you want to copy the designated component. To copy a group, left-click the icons of the components (check marks identify the group), then right-click any marked component and select Copy marked to>. Then select the application to which you want to copy the group.

From the Web Console you can only copy two file types: synonyms and procedures. If you need to copy other file types, see Designating File Types for APP Commands.



x
Procedure: How to Move Synonyms or Procedures From One Application to Another
  1. From the Metadata or Procedures navigation pane, click an application and choose Manage Files from the menu. The Manage Synonyms or Manage Procedures pane for the selected application opens.
  2. To move files into another application on your path, select that application name from the Application for Copy/Move drop-down list.
  3. From the list of Synonyms or Procedures at the bottom of the pane, click check boxes for the file(s) you wish to move.

    To move all listed files from one application to another, click the check box at the top of the column.

  4. Click the Move button. A confirmation page indicates that the file or files have been successfully moved.
  5. Click the Refresh icon above the navigation pane to update the affected applications.

Tip: Alternatively, expand the Application Directories folder, expand a specific application folder, click a synonym or procedure, and choose Move synonym or Move (procedure) from the menu. From a secondary menu, select the application to which you want to copy the designated component. To copy a group, left-click the icons of the components (check marks designate those that form the group), then right-click any marked component and select Copy marked to>. From a secondary menu select the application to which you want to copy the group.

From the Web Console you can only move two file types: synonyms and procedures. If you need to move other file types, see Designating File Types for APP Commands.



x
Procedure: How to Drop Synonyms or Delete Procedures From an Application
  1. From the Metadata or Procedures navigation pane, click an application and choose Manage Files from the menu. The Manage Synonyms or Manage Procedures pane for the selected application opens.
  2. From the list of Synonyms or Procedures at the bottom of the pane, click check boxes for the file(s) you wish to remove.
  3. To remove all listed files from the selected application, click the check box at the top of the column.
    • For synonyms, click the Drop button.
    • For procedures, click the Delete button.

  4. Click the Refresh icon above the navigation pane to update the affected applications.

Tip: Alternatively, expand the Application Directories folder, expand a specific application folder, click a synonym or procedure, and choose Drop synonym or Delete (procedure) from the menu. To delete a group, left-click the icons of the components (check marks designate those that form the group), then right-click any marked component and select Drop marked or Delete marked.

From the Web Console you can only copy two file types: synonyms and procedures. If you need to copy other file types, see Designating File Types for APP Commands.


WebFOCUS