Skip Headers
Oracle® Application Server Adapter for VSAM User's Guide
10g Release 2 (10.1.2)
B15804-01
  Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
Next
Next
 

1 Introduction

Oracle Application Server connects to a Virtual Sequential Access Method (VSAM) system through the Oracle Application Server Adapter for VSAM (OracleAS Adapter for VSAM). The OracleAS Adapter for VSAM provides connectivity and runs interactions on a VSAM system. This chapter provides an overview of the feature and architecture of OracleAS Adapter for VSAM.

This chapter contains the following sections:

OracleAS Adapter for VSAM Overview

The OracleAS Adapter for VSAM models VSAM as a simple database with an SQL front end. The adapter is native to the data source and IBM OS/390 or z/OS system, providing direct access that results in improved performance.

OracleAS Adapter for VSAM includes the following features:

VSAM Data

VSAM is an IBM disk file storage scheme first used in S/370 and VS (Virtual Storage). VSAM comprises the following three access methods:

  • Keyed Sequential Data Set (KSDS)-indexed file

  • Relative Record Data Set (RRDS)-relative file

  • Entry Sequenced Data Set (ESDS)-sequential file

These VSAM access methods are supported by the adapter

VSAM has no built-in metadata schema although a VSAM file does include information about its type (KSDS, RRDS, or ESDS) and index definition (KSDS only). Typically, VSAM is used by COBOL programs, either standalone (also known as batch programs) or CICS transactions. The VSAM record definitions are typically maintained within the COBOL code as COBOL copybooks.

Accessing VSAM Data Under CICS

When VSAM records are defined under CICS, all access to the data is managed by CICS. OracleAS Adapter for VSAM includes an option to access the VSAM data under CICS.

Accessing VSAM Data Directly

When VSAM records are not defined under CICS, OracleAS Adapter for VSAM includes an option to access the VSAM data directly. This option can also be used to improve performance when the VSAM records are managed by CICS but access to them is for read only, and there is no risk that there are changes buffered by CICS while the read is performed.

OracleAS Adapter for VSAM Architecture

OracleAS Adapter for VSAM includes the following components:

The following figure illustrates the components of OracleAS Adapter for VSAM.

Oracle Application Server Adapter architecture for CICS.
Description of the illustration xipvs002.gif

Integration Flow from Oracle Application Server to the Legacy Application

The J2CA 1.0 VSAM adapter converts the J2CA interaction invocation received from Oracle Application Server to the XML format and passes the XML format to Oracle Connect on the legacy server. The daemon listens for the request coming from the J2CA 1.0 VSAM adapter client and assigns a server process to handle the request. The properties of the server process, such as connection pooling requirements, are defined by a workspace definition within the daemon. The server process includes an instance of the application engine, which converts the XML format into native structures understandable by VSAM and passes the converted XML to the back-end adapter. The back-end adapter builds an interaction based on the metadata for the back-end adapter stored in the repository and the incoming converted XML, and passes it to the legacy application. The results of this execution are passed back to the application engine, using the back-end adapter, where these results are converted to XML and passed back to the client.