What Is an Application?

In this section:

x x

An application is a platform-independent repository for a group of related components, such as procedures, Master and Access Files, data files, HTML files, PDF files, and image files. It provides an area on the server that both confers a unique identity on the application components and facilitates the sharing of components across applications in an organized manner. This construct also simplifies the process of moving a user application from one platform to another and of deploying PC-developed applications.

These components are physically grouped together on an application-by-application basis for run-time execution. This physical grouping can be within an application under a common root or a mapping to an application anywhere in the file system. The physical application or mapped name is referred to as the application name in this document. A comprehensive set of application (APP) commands are provided to control/manipulate the application components, as well as to facilitate applications that can be written and deployed to any platform.

The physical location of an application and its components is determined by a configuration parameter called approot. This parameter is set at installation time and stored in the server configuration file, edaserve.cfg. The default value is dependent on the platform, relative to the install ID home directory, where applicable, as indicated in the following chart.

Application directories can be nested. A nested application directory is an application created within a higher-level application. For more information. see Nested Application Directories.

You can also create a home application directory for each user. Providing a user home application gives each user a place where he has full control to create, change, and run his applications. For more information, see Home Application Directories for Users.

Note: Where directories are referenced in the chart, lowercase application directories are created below the approot value. The application names must be lowercase and must not contain spaces. For a PDS deployment on the Unified Server, data sets are created for each component type using the approot value as the high-level qualifier.

Platform

Default Value for approot

Unified Server HFS Deployment

Unified Server PDS Deployment

.../ibi/apps

approotvalue.appname.component_type

UNIX

.../ibi/apps

Linux

.../ibi/apps

Windows

...\ibi\apps

IBM i (formerly known as i5/OS)

.../ibi/apps

OpenVMS

[.IBI.APPS]

Two applications are provided during installation: a default application called baseapp and an application in which you can generate legacy sample files called ibisamp. In addition, when you connect to the server, a temporary directory called foccache is added as the first directory in the search path. When you want to be able to reuse data within the same browser session, you can store the data in the form of a HOLD, SAVE, or SAVB file in the foccache directory. As long as the browser session remains active, the files stored in the foccache directory can be referenced in requests.

Access to a particular application component can be explicit or implicit. Implicit access is dependent upon the search path in effect at the time of execution. The search path always includes the default application, baseapp. There is no need to explicitly declare this application.

You can change the search path from the Web Console, from the Data Management Console, or from within your application code. You can also change the search path temporarily to add application names to the beginning or end of an existing search path. APP commands are described briefly in Application Commands Overview and in detail later in this chapter.

In addition to explicit APP names under APPROOT or an APP MAP command, which might look like myapp/myproc, there are also special reference names for internal locations that may be useful. They are:

Reference Name

Description

_edatemp

Current directory location. For server use this is the EDACONF edatemp agent directory (that is, ts000001, where 000001 is tscomid of the agent). For PDS Deployment, this is a temporary HFS location. For edastart -t, -x and -f uses, this is the current user directory.

_edahome

EDAHOME installation location.

_edaconf

EDACONF configuration location.

While the EDAHOME and EDACONF catalog locations are internally already on a server search path, special handles such as these allow you to explicitly reference names of the form _edahome/catalog/sysapps, which is one of a number of internal catalog tables.

Note: For platforms that support the Universal Naming Convention (UNC), you can specify a network drive for approot. The UNC must be:



x
Generating Samples and Tutorials

You can generate several types of sample files and save them in an application in order to run sample procedures and test features and configurations.

The Web Console Applications page has a button named Tutorials, which you can click to open the Create Tutorial Framework page. You can also right-click an application folder and select New, then Tutorials, from the context menu.

Following is the list of available tutorials.

In the past, a static application directory named IBISAMP was created and populated with a number of files. Additionally, there were Web Console and Data Management Console (DMC) folder options for selecting and creating items to be used with those products.

The IBISAMP folder is still created as part of the installation process, but it is not populated. You can create those legacy sample files by choosing Create Legacy Sample Tables and Files from the Tutorial drop-down list.

Because the change is implemented at the folder level, you can choose to continue using IBISAMP as the location for creating the legacy files, or you can select any other folder. The drop-down option for Legacy samples creates most, but not all, of the sample files that used to be in IBISAMP. Some of the prior files were actually DataMigrator-related, and those have been moved to their own tutorials.

Under z/OS PDS Deployment there are some additional restrictions. The z/OS PDS JSCOM Listener option must have been selected at installation time. The PDS JSCOM option also co-installs some HFS source files that are used by the various create options. If the HFS files for a z/OS PDS Deployment are not present, request to create a tutorial will produce a specific HFS files not found message. Note that not all tutorials are implemented for z/OS, and those will produce a not implemented message, if selected.


iWay Software