Set up the File Service

Note: This step assumes you have already verified your security credentials for the SYSAD user of Enterprise Server. If you have not, see the Before you begin section at the start of this tutorial.

Start Enterprise Server Common Web Administration (ESCWA)

  1. In a web browser, type the URL http://localhost:10086 to open ESCWA.
  2. Click Native.
  3. In the navigation pane, expand Directory Servers > Default to see the enterprise server region BANKDEMO.

If you do not see the BANKDEMO region listed, refer to the steps of the tutorial Getting started with Enterprise Developer to create the BANKDEMO repository with its default configuration.

Add a Remote File Access (RFA) Listener

To set up a new listener that communicates with the end-point client:

  1. In the navigation pane, expand Directory Servers > Default > BANKDEMO. Ensure that BANKDEMO is stopped.
  2. Click General > Listeners.
  3. Expand Communications Process 1 in the left-hand pane to view all listeners.
  4. Select New Listener in the Listener Properties page.
  5. In the Name field, type RFA.
    Note: The listener name cannot be the same as the name of the region.
  6. For the Port field, type 9092.
  7. Select RFA in the Conversation Type section.
  8. Click Save.

    The new RFA listener is displayed under Communications Process 1.

Enable Security for the BANKDEMO Region

First, you must add a new user that has the correct permissions to access and edit data sets using either through the file service or the editor.

  1. In ESCWA, click Security.
  2. In the navigation pane, click ESCWA Configuration > VSAM ESM > Users.
  3. Click New.
  4. In the Account Id field, type RFADATA.
  5. In the Password field, type RFADATA, and confirm the password.
  6. Expand Group Membership in the Properties window.
  7. Under Groups, check #AllUsrs.
  8. Click Save.

Now you must configure that user to have access to all datasets in the BANKDEMO repository.

  1. Click ESCWA Configuration > VSAM ESM > Resources.
  2. Expand DATASET in the navigation pane, and select **.

    This opens the Resource Options page which enables you to set access rules for all datasets in the BANKDEMO region.

  3. In the ACL field, add ;allow:RFADATA:alter after any pre-existing options, then click Apply.
  4. Click the DATASET page in the navigation pane.
  5. Click New Resource.
  6. In the Name field, type BANKDEMO.RFADATA.
  7. In the ACL field, type allow:RFADATA:alter, and click Save.

    The class is added to the list of resources and you can view the permissions in the Description column. The BANKDEMO region is ready for access via the file service API.

  8. To start the region, click Directory Servers > Default > BANKDEMO, and click (Start).
Parent topic: Tutorial: Data Tools
Next topic: Start the Editor