Release 10.1A: OpenEdge Development:
Progress Dynamics Web Development Guide

> ## Modifying the default ICFWS session

> To run your Progress Dynamics application as a Web application, the Progress Dynamics WebSpeed Broker/Agent must be able to access your application database and your application Repository. One method for enabling Broker/Agent access is to modify the default ICFWS session to include your application’s database and Repository as session services. For an alternative method, see the "Creating a new ICFWS session" section.

> This section describes how to modify the default ICFWS session, using the tutorial databases (described in OpenEdge Development: Progress Dynamics Getting Started ) as examples.

> The tutorial in OpenEdge Development: Progress Dynamics Getting Started uses DynSports, the Progress Dynamics sample database, as an application database. It is created in a work directory for the tutorial (`<`wrk>`\Tutorial\databases\dynsports\dynsports.db`).

> A Repository for the application is created in `<`wrk>`\Tutorial\databases\icfdb\icfdb.db`.

> In the tutorial, both databases are started in a script and run under servers in a network environment. For example:

>     call proserve "<wrk>\Tutorial\databases\icfdb\icfdb" -S icfdb
>     call proserve "<wrk>\Tutorial\databases\dynsports\dynsports" -S dynsports

> Also note that `icfdb` and `dynsports` have been defined as services with port numbers in the Windows `services` file.

> ##### Adding a database to ICFWS as a session service

> The general procedure for adding a database as a service in a session type is to define it as a logical service and as a physical service, and then add it to the session. You use the session tools found in the Administration tool to perform these tasks.

> This section uses the DynSports database (created in the tutorial in OpenEdge Development: Progress Dynamics Getting Started ) as an example of an application database. You can also use the procedure described in this section to add a Repository database to the ICFWS session.

> | To add a database as a session service:

> 1. Start a Progress Dynamics session that has administrative privileges.

> For the tutorial application, use the shortcut that you used to start a development session for the tutorial.

> 2. From the Progress Dynamics AppBuilder Tools menu, select Administration.

> 3. Choose Session Logical Service Control from the Administration tool. The Logical Service Control dialog box appears, as shown:

> 4. Choose Add Record from the File menu, or click on the toolbar at the bottom of the window, to add a new service. The Logical Service Maintenance dialog box appears.

> 5. Set the values for the new service.

> The following table shows typical values for DynSports:

> Field | Value
> --- | ---
> Logical service code | dynsportstut
> Logical service description | DynSports app db for tutorial
> Service type | Database Connection (Database)
> Can run locally | Selected
> System owned | Not selected
> Write to config | Selected

> Note: If you already created a `dynports` session service in the tutorial, you can use it instead of creating a new service called `dynsportstut`. However, if you have multiple instances of a sample database like DynSports or the ICFDB Repository database, it is useful to adopt a naming convention that identifies which database you are using. In this case, the name `dynsportstut` implies that the service uses the DynSports database that was created in the tutorial work directory.

> 6. Save the completed Logical Service Maintenance dialog box, as shown:

> 7. Exit from the maintenance and control dialog boxes.

> 8. Choose Session Physical Service Control from the Administration tool. The Physical Service Control dialog box appears, as shown:

> 9. Choose Add Record from the File menu, or click on the toolbar at the bottom of the window, to add a new physical service. The Physical Service Maintenance dialog box appears.

> 10. Type the values for the new service. Assuming you start DynSports in multi-user mode, the following are typical values:

> Field | Value
> --- | ---
> Physical service code | dynsportstut
> Physical service description | DynSports app db for tutorial
> Service type | Database Connection / Database
> Physical Database Name (-db) | dynsports
> Network Type (-N) | TCP
> Host (-H) | localhost
> Service (-S) | dynsports

> The Service (-S) value, `dynsports`, implies that `dynsports` has been defined with a port number in the Windows services file and that you start the database with a command similar to:

>     proserve <wrk>\Tutorial\databases\dynsports\dynsports -S dynsports

> 11. Save the completed Details tab, as shown:

> 12. Select the Service tab in the Physical Service Maintenance dialog box and choose Add record ( on the toolbar).

> 13. Enter the following values:

> Field | Value
> --- | ---
> Session type | ICFWS
> Logical service code | dynsportstut

> This adds the DynSports application database that you used in the tutorial as a service in the ICFWS session. It also creates the association between the logical and physical service code names.

> 14. Save the completed Service tab, as shown:

> 15. Exit from the maintenance and control dialog boxes.

> 16. Verify that the service has been added to the ICFWS session type.

> You can verify the settings in the ICWS session type by following the procedure described in the "Viewing the default ICFWS session settings" section.

> Basically, you run the Session Type Maintenance tool and check the Session Services node under ICFWS. After you complete the tasks described in this section, the Session Services list should include an entry for `dynsportstut`, as shown:

> To add a new Repository database, you would perform the same procedure described in this section. However, you would also remove the default Repository session service, which is described in the "Removing a session service from ICFWS" section.

> ##### Removing a session service from ICFWS

> The installation of Progress Dynamics creates an ICFWS session with a network connection to the default Repository (`ICFDBn`). If you create a separate Repository for your application (as you do in the OpenEdge Development: Progress Dynamics Getting Started tutorial), you should add the application Repository as a session service and remove the default Repository as a session service.

> Follow the procedure described in the "Adding a database to ICFWS as a session service" section to add the application Repository to ICFWS. Then perform the following procedure.

> | To remove the default Repository service:

> 1. Start a Progress Dynamics session that has administrative privileges.

> For the tutorial application, use the shortcut that you used to start a development session for the tutorial.

> 2. From the Progress Dynamics AppBuilder Tools menu, select Administration.

> 3. From the Administration Session menu, select Session Type Control.

> 4. In the Session type code lookup field at the top left of the window, enter DynDBBound and click Find to expand the session type tree.

> 5. Expand the DynDBBound node, and expand the Session Services node below it.

> 6. Select the session service that you want to remove. The following shows the ICFDBn service selected:

> 7. Choose Delete Record from the File menu, or click on the Session Service Maintenance toolbar in the right frame.

> A confirmation window appears. Click OK confirm the deletion.

> Note: This procedure does not completely remove ICFDBn. It removes it from ICFWS and any other session types that inherit from DynDBBound as a session service, but ICFWS remains available to add to other session types.

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095