![]() | ![]() |
Home |
|
|
Installation and Administration Guide for Mainframe Connect for DB2 MVS-CICS |
|
| 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:
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:
CICS system programmer
DB2 database administrator
DirectConnect administrator
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.
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 | |
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" |
Troubleshoot | Problems with client access to data on the mainframe | |
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 | OSC Guide OSC Guide |
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:
DirectConnect Installation Guide for Enterprise Connect IPS
Access Service User's Guide for DirectConnect for MVS
Transaction Router Service User's Guide for DirectConnect
Server Administration Guide for DirectConnect
Error Message Guide for DirectConnect
Programmer's Reference for Remote Stored Procedures for Open ServerConnect
Programmer's Reference for Client Services Applications for Open ClientConnect
Messages and Codes Guide for Open ServerConnect and Open ClientConnect
This section describes the syntax and style conventions used in this book.
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.
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. |
The following style conventions are used in this book:
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.
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 Professional Services
Sybase Technical Support provides various forms of customer assistance, including the following services:
Identifying problems.
Offering a fix, if available.
Documenting software problems and enhancement suggestions in our customer support database.
Communicating status information on open problems.
Sharing information on new products or releases of existing products.
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 SupportYou can contact Sybase Technical Support by calling (800) 8SYBASE. Before you contact Sybase Technical Support, complete these steps:
Thoroughly review the documentation, especially all troubleshooting sections.
Be prepared to generate a trace, if requested to do so by Technical Support.
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 SupportYou can send log and trace files or other documents to Sybase Technical Support using the Sybase file transfer protocol.
Save your trace output as an ASCII file.
In the directory in which the file resides, type the following at the command line:
ftp
When prompted, provide the following information:
Sybase server = ftp.sybase.com
ID = anonymous
Password = your e-mail address
Type the following:
cd /pub/incoming/wcss
To change to binary mode, type the following:
bin
Place one or more files into the directory as follows.
To place one file in the directory, type the following:
put filename
To place multiple files in the directory, type the following:
mput filename filename filename
When prompted, enter Y to transfer each file.
Notify Sybase Technical Support of the exact name of the file(s) you sent to the server. (Remember that the UNIX system is case-sensitive.
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.
Use the Sybase Technical Library CD and the Technical Library Web site to learn more about your product:
The Technical Library CD contains product manuals and technical documents and is included with your software. The DynaText browser (included on the Technical Library CD) allows you to access technical information about your product in an easy-to-use format.
Refer to the Technical Library Installation Guide in your documentation package for instructions on installing and starting the Technical Library.
The Technical Library Web site includes the Product Manuals site, which is an HTML version of the Technical Library CD that you can access using a standard Web browser. In addition, you'll find links to the Technical Documents Web site (formerly known as Tech Info Library), the Solved Cases page, and Sybase/Powersoft newsgroups.
To access the Technical Library Web site, go to support.sybase.com, click the Electronic Support Services tab, and select a link under the Technical Library heading.
Technical documentation at the Sybase Web site is updated frequently.
For the latest information on product certifications and/or the EBF rollups:Point your Web browser to Technical Documents at the following Web site:
techinfo.sybase.com
In the Browse section, click on the What's Hot entry.
Explore your area of interest: Hot Docs covering various topics, or Hot Links to Technical News, Certification Reports, Partner Certifications, and so on.
Point your Web browser to Technical Documents at the following Web site:
techinfo.sybase.com
In the Browse section, click on the What's Hot entry.
Click on the EBF Rollups entry.
You can research EBFs using Technical Documents, and you can download EBFs using Electronic Software Distribution (ESD).
Follow the instructions associated with the SupportPlusSMOnline Services entries.
You can register by following the instructions on the Web.
To use SupportPlus, you need:
A Web browser that supports the Secure Sockets Layer (SSL), such as Netscape Navigator 1.2 or later
An active support license
A named technical support contact
Your user ID and password
You may access Sybase Technical Documents or Certification Reports at this site:
Point your Web browser to Technical Documents at the following Web site:
techinfo.sybase.com
In the Browse section, click on the What's Hot entry.
Click on the topic that interests you.
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:
Missing, incorrect, or unclear information
Information you found particularly useful
Organization or style
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.
|
|