Remote VSAM support using DFM

You can use DFM to access remote VSAM files in the following cases: when you run the EGL debugger on a Windows platform, or when EGL-generated Java™ code is running on a 32-bit Windows platform or on AIX®.

To use DFM to access remote VSAM files, do as follows:

Satisfy the access prerequisites
Provide resource association information and reference the resource association part from the build descriptor that you use for debugging your program

Access prerequisites

To access VSAM files, you first define the VSAM file on the system where you want the file to reside.

Remote VSAM access requires that you install the Distributed File Manager (DFM) on the workstation. Additional capabilities are also available in the JAR file that contains the DFM installation code.

Do as follows:

Find the following subdirectory:
```
  installDir\eclipse\plugins
```
where installDir is the installation directory for your product.
In that directory, find the following JAR file:
```
  com.ibm.etools.egl.java.binaries_<version>.jar
```
where <version> is a version number, such as 7.1.101.v20090718_0331.

To gain remote VSAM access for use in debug sessions on the development platform or for use on a runtime platform, do as follows:

Find the file EGLRuntimes\win\bin\Vsamwin.zip within the JAR file
Extract Vsamwin.zip into a new directory (whether on the development or runtime platform)
Follow the directions in the extracted INSTALL.README file

Resource Association

When you create the resource association part to use when you debug your EGL program on Windows, specify the file type and systemName as follows:

File type

Set the file type to ibmcobol.

systemName

Specify the system name in the following way:

  \\machineName\qualifier.fileName

machineName: The SNA LU alias name as specified in the SNA configuration
qualifier.fileName: The VSAM data set name, including a qualifier

The naming convention is similar to the Universal Naming Convention (UNC) format. For details on UNC format, refer to the Distributed FileManager User's Guide, which is included in the vsamwin.zip file.