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.
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:
' ' |
space character | |
* |
star character | |
? |
question mark | |
< |
less than sign | |
> |
greater than sign | |
& |
ampersand | |
\ |
backslash | |
, |
comma | |
. |
dot | |
: |
colon | |
" |
double quote mark | |
' |
single quote mark | |
\t |
tab | |
\0 |
null terminator character |
or
from the Data Management Console, expand the Server node folder.
On the Web Console, the Applications page opens.
The Create New Application page opens.
The application is added to the Application Directories folder.
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.
or
from the Data Management Console, expand the Server node folder.
On the Web Console, the Applications page opens.
The Create New Application page opens.
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
The mapping is added to the Application Directories folder.
Applications and application mappings can be deleted from either the Web Console or the DMC.
or
from the Data Management Console, expand the Server node folder.
On the Web Console, the Applications page opens.
A confirmation dialog box opens.
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.
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:
Note: You can also right-click the Application Directories folder on the Application tree and select Application Path.
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.
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.
or
from the Data Management Console, expand the Server node folder.
On the Web Console, the Applications page opens.
The Create New Application Directory page opens.
The nested application is added to the application tree under its parent application folder.
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.
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.
Note: You can also right-click the Application Directories folder on the Application tree and select Configure Application Path.
When the server restarts, go to the Applications menu. A Users Home folder will appear under the Application Directories tree.
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:
The Manage Privileges page opens, as shown in the following image.
The File/Directory Privileges page opens, as shown in the following image.
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.
You can configure the Application Path to add or remove applications or mappings from either the Web Console or the DMC.
or
from the Data Management Console, expand the Server node folder.
On the Web Console, the Applications page opens.
The Application Configuration page opens.
The Test Application Path pane shows:
The navigation pane is updated.
Note: You can also create a new profile from the Application Configuration page.
Profiles can be created from either the Web Console or the DMC.
or
from the Data Management Console, expand the Server node folder.
On the Web Console, the Applications page opens.
The Application Configuration page opens.
The options are:
The profile opens in a text editor with its current path displayed.
Tip: You can also edit a profile search path by selecting and saving configuration options. Follow instructions for configuring the application path.
How to: |
Filtering enables you to limit the synonyms, procedures, DM flows, HTML files, and SQL files that appear 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.
The Filter Applications Tree page opens.
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.
How to: |
Sorting enables you to change the order in which items are listed on the application tree.
The Applications page opens.
You can sort by Name, Size, Type, or Modified date. Type is the default.
How to: |
You can copy and move files between applications, delete them from applications, and refresh synonyms in applications.
The Manage Files page opens.
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.
The file(s) are copied or moved to the selected application.
The Manage Files page opens.
To refresh all listed synonyms in the selected application, click Select All.
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.
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
Enter a full name or a partial name with a wildcard symbol (%).
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.
Select to limit the search to the active Application Path.
Select to search all mapped applications.
Select to search all applications under APPROOT.
Enter an application or click the browse button (...) to select one.
Procedure Properties
Select to search for scheduled procedures.
Enter a string to search for in the description of the procedure.
Select to search for stored procedures.
Select to search for DataMigrator flows.
Synonym Properties
Enter a string to search for in the remarks in the synonym.
Select an adapter from the drop-down list.
File Statistics
Enter a file size to limit the search.
Enter a file size to limit the search.
Enter a date to limit the search.
Enter a date to limit the search.
iWay Software |