Sybase Technical Library - Product Manuals Home
[Search Forms] [Previous Section with Hits] [Next Section with Hits] [Clear Search] Expand Search

Installation and Administration Guide [Table of Contents] Chapter 1 Understanding MainframeConnect for DB2/MVS-CICS

Installation and Administration Guide for Mainframe Connect for DB2 MVS-CICS

[-] About This Book

About This Book

This book describes how to install and configure MainframeConnect for DB2/MVS-CICS version 12.0. It includes planning considerations, installation instructions, configuration instructions, and troubleshooting information.

This preface includes the following topics:

Who should use this book

These specific guidelines and step-by-step instructions are intended for those who install, configure, and maintain Sybase mainframe client/server components on an IBM System/390 mainframe. This guide is for anyone who performs tasks, such as a:

This guide assumes you have a working knowledge of system administration for your environment. For an OS/390-CICS environment, for example, you should be familiar with OS/390 and CICS system administrative procedures, such as defining CICS resources and SNA definitions.

How to use this book

This guide consists of five sections: planning, installing, configuring, troubleshooting, and appendix. The first four sections contain chapters that describe sets of tasks. The last section contains useful reference information.

MainframeConnect for DB2/MVS-CICS requires the Open ServerConnect for CICS/OS/390 base tape to be installed. Therefore, the Open ServerConnect for CICS/OS/390 base tape is shipped with MainframeConnect for DB2/MVS-CICS. You will find instructions for installing the Open ServerConnect for CICS/OS/390 base tape in the Installation and Administration Guide for Open ServerConnect for IBM CICS/MVS, which is also shipped with MainframeConnect for DB2/MVS-CICS.

The following table shows tasks you perform using this guide and the Installation and Administration Guide for Open ServerConnect for IBM CICS/MVS. The Installation and Administration Guide for Open ServerConnect for IBM CICS/MVS is abbreviated in the following table as "OSC guide."

To

See

Understand

MainframeConnect for DB2/MVS-CICS components

Chapter 1, "Understanding MainframeConnect for DB2/MVS-CICS"

Plan

Installation and configuration

Migration from ASE/CIS SQL Access Module Version 10.1 or MDI Access Server for MVS-CICS Version 2.3 or later

Chapter 3, "Planning Your Installation"

Chapter 2, "Migrating from Previous Installations"

Install

Libraries from the Open ServerConnect CICS/MVS base tape

Libraries from the MainframeConnect for DB2/MVS-CICS tape

CSP libraries for TRS from the MainframeConnect for DB2/MVS-CICS tape

Libraries from the Japanese Conversion Module tape

OSC Guide

Chapter 4, "Installing the MainframeConnect for DB2/MVS-CICS Tape"

Chapter 5, "Installing CSP'S for Transaction Router Service"

OSC Guide

Configure

MainframeConnect for DB2/MVS-CICS to communicate with DirectConnect

AMD2 messages for MainframeConnect for DB2/MVS-CICS

User exit routines

Chapter 6, "Configuring MainframeConnect for DB2/MVS-CICS"

Chapter 7, "Customizing MainframeConnect for DB2/MVS-CICS Messages"

Chapter 8, "User Exits"

Troubleshoot

Problems with client access to data on the mainframe

Chapter 9, "Troubleshooting"

Compile and Link

Sample programs

OSC Guide

Customize

Global and single byte character set (SBCS) options

DB2 database administrator-maintained tables

OSC Guide

Appendix B, "DB2 Database Administrator Information for TRS"

Reference

MainframeConnect for DB2/MVS-CICS-specific messages

Security information

Default translation tables to customize SBCSs

Unfamiliar terms and acronyms

Appendix A, "Error Messages"

OSC Guide

OSC Guide

Related documents

To install and administer MainframeConnect for DB2/MVS-CICS, in addition to this book, you will also need the Installation and Administration Guide for Open ServerConnect for IBM CICS/MVS, which ships with MainframeConnect for DB2/MVS-CICS.

For the latest product information, refer to the release bulletins for MainframeConnect for DB2/MVS-CICS and Open ServerConnect for IBM CICS/MVS.

You may also need to refer to the following related documentation:

Syntax and style conventions used in this book

This section describes the syntax and style conventions used in this book.

Syntax conventions

Syntax statements that display options for a command look like this:

COMMAND [object_name, [ {TRUE | FALSE} ] ]

The following table explains the syntax conventions used in this guide.

Syntax conventions

Symbol

( )

Parentheses indicate that they are included as part of the command.

{ }

Braces indicate that you must choose at least one of the enclosed options. Do not type the braces when you type the option.

[ ]

Brackets indicate that you can choose either one or more of the enclosed options, or none of the options. Do not type the brackets when you type the options.

|

The vertical bar indicates that you can select only one of the options shown. Do not type the bar in your command.

,

The comma indicates that you can choose one or more of the options shown. Separate each choice by using a comma as part of the command.

Style conventions

The following style conventions are used in this book:

Style Conventions

This type of information

Looks like this

Directories and files

econnect\ServerName\cfg

Programs, utilities, procedures, and commands

snrfck

Properties

Allocate

Options

connect

Code examples and text on screen

this font

Commands you should enter

this font

Variables you should replace with the appropriate value for your system when entering a command

this font

All other names and terms are in regular typeface.

How to get help using Sybase products

Each SybaseŽ installation that has purchased a support contract has one or more designated people who are authorized to contact Sybase Technical Support. If you have any questions about this installation or need assistance during the installation process, please have the designated person contact Sybase Technical Support or the Sybase subsidiary in your area.

If you need help using a Sybase product, the following resources are available:

Sybase Technical Support

Sybase Technical Support provides various forms of customer assistance, including the following services:

In addition, Sybase system engineers are available for technical assistance in various geographical territories.

The following subsections explain how to contact Sybase Technical Support and how to send log and trace files, if necessary.

Contacting Sybase Technical Support

You can contact Sybase Technical Support by calling (800) 8SYBASE. Before you contact Sybase Technical Support, complete these steps:

Outside the continental United States and Canada, obtain the correct telephone numbers from your sales representative and record them for future reference.

Sending log and trace files to Sybase Technical Support

You can send log and trace files or other documents to Sybase Technical Support using the Sybase file transfer protocol.

Using File Transfer Protocol (ftp)

Sybase Professional Services

Sybase Professional Services offers onsite consulting and training programs to help you maximize the benefits of our products. For more information, call (303) 486-7700.

Outside the continental United States and Canada, obtain the correct telephone numbers from your sales representative and record them for future reference.

Other sources of information

Use the Sybase Technical Library CD and the Technical Library Web site to learn more about your product:

Sybase certifications on the web

Technical documentation at the Sybase Web site is updated frequently.

For the latest information on product certifications and/or the EBF rollups:

If you are a registered SupportPlus user:

If you are not a registered SupportPlus user, and you want to become one:

You can register by following the instructions on the Web.

To use SupportPlus, you need:

Whether or not you are a registered SupportPlus user:

You may access Sybase Technical Documents or Certification Reports at this site:

If you have questions about this book

To order additional copies of DirectConnect documentation, see "Document Orders" on the disclaimer page following the title page.

If you have questions, comments, or suggestions about DirectConnect documentation, contact the Sybase documentation group directly by electronic mail at:

icd_doc@sybase.com

Feel free to forward any information, comments, or questions about:

We will respond as promptly as possible by electronic mail. Your feedback helps us provide more accurate, detailed, and easy-to-use documentation.

Please send comments about product features, functionality, or problems to your system engineer or Sybase Technical Support.


Installation and Administration Guide [Table of Contents] Chapter 1 Understanding MainframeConnect for DB2/MVS-CICS