Transaction Router Service User's Guide
|Chapter 1 Introduction|
This chapter which provides an overview of DirectConnect for MVS, includes the following topics:
DirectConnect TRS is a component of the Mainframe Connect IPS, which consists of components that provide access and integration of mainframe data. For more information about the Mainframe Connect IPS, see the Overview Guide for the Mainframe Connect IPS.
This section describes DirectConnect for MVS and other Sybase products. it interacts with. This section includes the following subsections:
DirectConnect is Open Server-based software that supports DB-Library, CT-Library, and Open Database Connectivity (ODBC) application programming interfaces (APIs).
DirectConnect serves as a fundamental building block for highly-scalable database middleware applications. DirectConnect products are local area network (LAN)-based middleware gateways and servers that provide access to non-Sybase data and applications.
In addition, DirectConnect provides access to non-Sybase data and can be used with other Sybase products, such as CIS functionality in ASE (formerly OmniConnect), Sybase Adaptive Server, and Replication Server.
DirectConnect provides the following components for decision support and online transaction processing (OLTP) applications.DirectConnect components
This section explains the components of DirectConnect: Access Services, Transaction Router Service, and Mainframe Client Connect.
An access service is a logical server application, used with an access service library, to which clients connect. Each DirectConnect server can have multiple access services.
This guide contains information about access services and access service libraries.
TRS, a component of DirectConnect, is used when the mainframe acts as a server. It routes requests from remote clients to Open ServerConnect transactions. Optionally, it can also route requests to MainframeConnect for DB2 (or OmniSQL Access Module for DB2), and return results to the clients.
MCC, a component of DirectConnect, is used when the mainframe acts as a client. It is a LAN-based program that lets mainframe Open ClientConnect applications connect to LAN servers. It performs data and protocol translation between SNA/LU 6.2 (APPC) and TCP/IP with the LAN network protocols. When accessing through SNA networks, MCC is required. When accessing the LAN using TCP/IP, MCC is not available and is not needed, since you go directly to your target database.
DirectConnect Manager is an Open Client-based graphical user interface (GUI) systems management tool for administering data accessible through DirectConnect. DirectConnect Manager runs only on Windows NT, Windows 95 or Windows 98, and provides the following capabilities:
Remote start, stop, and configuration of DirectConnect services
Dynamic configuration of services
Drag-and-drop service creation and copying
Remote log filtering and downloading
DirectConnect Manager is not currently available for use with Mainframe Client Connect.
MainframeConnect for DB2/MVS-CICS is mainframe software that works with DirectConnect or Net-Gateway 3.0.1 to provide access to mainframe data. It performs the following functions:
Supports full read-write, dynamic SQL access to data
Allows applications to use cursors for flexible and efficient result set processing
Permits the use of long-running transactions against mainframe databases
Allows applications to use dynamic events to map SQL to a static plan
Client applications access MainframeConnect for DB2/MVS-CICS directly through an Access Service or TRS.
Client applications access MainframeConnect indirectly through the CIS functionality in ASE (formerly OmniConnect) or a Sybase SQL Server remote procedure call (RPC).
MainframeConnect for DB2/MVS-CICS is available only for MVS-CICS environments. For IMS TM and native MVS environments, use ASE/CIS Access Module for DB2-CICS for IMS and MVS. Access to InfoHub is available only in a CICS environment, using the ASE/CIS Access Module for InfoHub-CICS.
Open ServerConnect is a programming environment that lets you create mainframe transactions that are accessible to Sybase client applications. To provide this access, Open ServerConnect uses the following basic interfaces:
Traditional Open Server programming environment (for new customers and Sybase-heritage customers using new applications)
Remote Stored Procedure (RSP) programming environment (only for MDI-heritage customers using their old applications)
These transactions provide access to virtually any MVS data source and are used for a variety of functions, including:
Accessing existing mainframe applications
Initiating mainframe batch jobs
Providing source data for data transfer operations
Providing data mapped to a table within the CIS functionality in ASE/CIS (formerly OmniConnect), thus allowing results to be accessed or joined with data from other targets
LAN-side client applications access Open ServerConnect transactions directly through DirectConnect or indirectly through the CIS functionality in ASE/CIS (formerly OmniConnect), or a Sybase Adaptive Server remote procedure call (RPC).
Open ClientConnect is a programming environment that lets you create mainframe applications that access:
LAN data residing on a Sybase Adaptive Server or other supported data sources
Other CICS regions
It allows you to treat the mainframe as just another node on a LAN.
Open ClientConnect uses the following APIs:
Traditional Open Client programming environment (for new customers and Sybase-heritage customers using new applications)
Client Services Application (CSA) programming environment (only for MDI-heritage customers using their old applications)
If you wrote client applications for Net Gateway or MDI Database Gateways, you can still use those applications with DirectConnect.
DirectConnect for MVS is a LAN-based software product that gives client applications access to MVS mainframe transactions and DB2 data.
DirectConnect consists of the following:
One or more service libraries
One or more access services per service library
The server provides the framework within which the service libraries operate. A service library provides a framework within which its access services operate. An access service is the logical point of connection for DirectConnect clients.
The DirectConnect server component (referred to as the server) provides management and support functions for DirectConnect service libraries, such as:
Routing client connections to the appropriate access service based on user ID, requesting application, and access service name.
Providing a single log file and a trace file for access services. TRS has its own Tabular Data Stream [TDS] trace file, LU 6.2 protocol trace file and TCP/IP protocol trace file.
Logging server, access service, and client messages
Tracing server, access service, and client events
Providing configuration management of all installed services
For detailed information about configuring and starting the server, see the DirectConnect Server Administration Guide.
A DirectConnect server consists of service libraries. A service library is a set of configuration properties that describes how all of its access services will function. Examples of service libraries include the following:
Transaction Router Service Library (TRSLIB)
Access Service Library (ACSLIB)
Administrative Service Library (ADMLIB)
The following figure shows the relationship of the Access Service Library and TRS Library with components of the client workstation, LAN, and mainframe environments.Figure 1-1: DirectConnect for MVS environmentDirectConnect for MVS Access Service Library (ACSLIB)
The DirectConnect access service library works with MainframeConnect to allow clients to access data.
The access service library consists of one or more access services. Each access service is a specific set of configuration properties that:
Transfers data between DB2 and other servers accessible through Open Client
Supports Catalog Stored Procedures (CSPs) and system stored procedures
Supports RSPs and host-resident requests
For information about DirectConnect for MVS Access Service Library, see the DirectConnect for MVS Access Service User's Guide.Transaction Router Service (TRS) Library
Each TRS provides access to DB2 data and supports Open ServerConnect mainframe applications, called Remote Procedure Calls (RPCs).
A DirectConnect server can support multiple instances of a TRS Library, which results in different physical copies of the dynamic link library or shared library files in the TRS Library directory. There are two different types of TRS Libraries:
TRSLU62 dynamic link library, which uses the LU 6.2 communications protocol to talk to Mainframe Connect or any Open ServerConnect application running in CICS.
TRSTCP dynamic link library, which uses the Transmission Control Protocol/Internet Protocol (TCP/IP) communications protocol to talk to MainframeConnect or any Open ServerConnect application running in CICS.
An access service is the client connection point for a DirectConnect server. You can think of it as the pairing of a service library with a set of specific values for the configuration properties. You must define at least one access service for every service library.
As a service library component of DirectConnect for MVS, TRS allows users to execute remote programs that interact with virtually any mainframe data source on CICS, IMS TM and MVS (OS/390). The primary purpose of this guide is to describe configuration and management tasks for TRS.
TRS performs protocol translation and routes client requests and server results. It also provides optional security checking.
Use TRS if:
Your applications invoke Open ServerConnect-based mainframe transactions including RSPs and CSAs.
You use client applications written for the TRS predecessor, Net-Gateway.
Each TRS Library instance has a set of configuration properties defined at the TRS Library level. Service-specific configuration properties do not affect the functioning of TRS. Therefore, instead of creating multiple service entries for each TRS library, create multiple TRS libraries.
For more information on how to create multiple TRS libraries, see "Creating additional TRS configurations " .
Installing and configuring DirectConnect and TRS includes the major steps listed below.
Coordinate with mainframe systems programmers to plan, install, and configure your network.
Install DirectConnect with TRS Library software. (See the DirectConnect for MVS Installation Guide.)
For TCP/IP, test the connection between the workstation and CICS using the Sybase cicsping utility.
For LU 6.2, configure your vendor SNA package. Then, run the snaping utility to test the connection between the workstation and the mainframe.
Create a TRS. (See Chapter 2 of this guide.)
Start up DirectConnect.
Configure TRS for connectivity and test samples (See Chapter 3 and Appendix B of this guide.)
Run test samples located in the $SYBASE/$SYBASE_ECON/sample/trs directory for UNIX, and %SYBASE%\%SYBASE_ECON%\sample\trs for NT.(See Appendix B of this guide.)
Configure TRS for general use. (See Chapter 3 of this guide.)
Set up security. (See Chapter 4 of this guide.)