Skip to main content

Servers   >   Mainframe servers   >   Operating systems   >  

Solutions

InteroperabilityOperationsCase studies
General
Access VSAM data from remote
Access to DL/I from remote
Java access to VSE resources
Multiplatform Development and VSE
Access remote data via VSAM Redirector
Access to CICS via Browser
Call CICS applications from remote
Web Services with VSE

Access remote data via VSAM Redirector

The VSAM Redirector is a new VSE function in the category VSE as client. It enables a VSE/VSAM application to access data on a remote system. The VSE program doesn't need any change. Working with a remote relational database (i.e. IBM DB2 UDB), a real time synchronization between VSAM data and the database can be done. The same function can be used on VSE locally, as exit for data collection (e.g. incremental FTP), or as an exit for Journaling. The function is transparent for batch or CICS programs


 Overview
 Benefits
 Software requirements
 How to get started
 Additional information


Overview

WebSphere Application Server TCP/IP for VSE DB2 Universal Database VSAM Redirector Handler VSAM Redirector Server VSAM Redirector Client VSAM VSAM Request CICS

The VSAM Redirector function is based on the VDA Exit (VSAM Data Access Exit) in VSAM. The VSAM Redirector function intercepts VSAM requests and forwards them for further processing. On VSE, a configuration table needs to be set up in order to define which VSAM files are being redirected.

VSAM requests can be redirected to:

  • a local exit in VSE (EXIT=EXITNAME) for further additional processing of a request. This function can be used for example to collect all changes of a file in a separate VSAM cluster for incremental work.
  • a remote system (EXIT=IESREDIR). On the remote system the VSAM request is then translated into i.e. database commands.

The VSAM Redirector function consists of two components:

  • The VSAM Redirector Server: it is a Java component running on a Java enabled platform. This component is responsible for connection and session handling with the Redirector client. The VSAM Redirector Server has an open handler interface. The handler is responsible for executing the VSAM request on the remote system, e.g. translating it into database commands.
    Multiple handlers can be active for parallel requests and different handlers can be active at the same time for access to different kind of data.With the VSAM Redirector function you get a simple handler which can generate a HTML site for insert requests in a VSAM file, and you get an handler for relational databases (i.e. DB2 UDB) that is able to intercept VSAM requests and route them to a database
  • The Redirector Client: it is a VSE component which is part of VSE. It is a program in the SVA and is called concurrently from multiple CICS and/or batch programs. For this client a configuration phase must be processed with the definitions and parameters which VSAM cluster should be redirected where and with what kind of file access on the remote site.

With the option called OWNER, the decision can be made whether:

  • OWNER=VSAM: VSAM data should be synchronized with the database. That means every write request will be executed for VSAM and the database with two phase commit. Read requests are done from VSAM only.
  • OWNER=REDIRECTOR: The program should work with the remote database only. That means no VSAM data is processed anymore - it is a transparent work of a VSAM program with a remote database. 

Back to top


Benefits

This functionality opens new dimensions of integration of VSE/VSAM programs with remote data especially with remote relational databases.

  • VSE programs can work without any change with remote data.
  • Real time synchronization between VSAM and a relational database with two phase commit.
  • For FTP modernization, the cumulative changes during a certain period can be collected and transferred instead of transferring whole files.

Once the data resides in a database, the data can be accessed by many kinds of applications:

  • Web applications
  • Data warehousing
  • Reporting tools

Back to top


Software requirements

The following software requirements must be meet in order to implement this solution:

Back to top


How to get started

To redirect VSAM requests (from batch or CICS applications) the following steps must be done:

For the VSE side:

  • Decide upon the VSAM files to be redirected and the remote system where they should be redirected to.
  • Decide upon the record structure (i.e. COBOL or PL/I copy book ) that defines the destination structure of the data in the database.
  • Corresponding entries in the configuration phase (skeleton SKRDCFG in ICCF Lib 59) must be defined. The configuration can be changed multiple times, it becomes active at OPEN time of a VSAM file. Changing the configuration for an OPENED VSAM file, requires a CLOSE/OPEN to that file to activate the new configuration. 

On the remote platform:

  • Define the database that will host the VSAM data.
  • The information about the mapping structure of VSAM records to a relational table will be stored in a second table separate from the data.
  • Use the create tool delivered in VSAM Redirector server to create the tables for the data and the mapping definitions of the VSAM file.

To migrate an entire VSAM file to the database, an additional VSAM file has to be defined with the same structure as the original one (clone). The second file will be set up to be redirected in the configuration phase. Now a simple IDCAMS REPRO can copy the original file to the redirected one. That means all data will be copied to the destination database table. Once that's done, the original file will be set up to be redirected and up to that time all requests will be redirected to the database - for synchronization or redirected access.


Back to top


Additional information

Additional information for this solution scenario can be found:

 

Back to top
We're here to help

Easy ways to get the answers you need.

  E-mail us E-mail us