Sybase Business Intelligence Solutions - Database Management, Data Warehousing Software, Mobile Enterprise Applications and Messaging
Sybase Brand Color Bar
delete

Search for    in all of Sybase.com
view all search results right arrow
  blank
 
 
 
 
 
 
 
 
 
 

 
 
CLICK TO EXPAND NAVIGATION
CLICK TO EXPAND NAVIGATION
 
 
 
 
Support > Technical Documents > Document Types > Release Bulletin > Release Bulletin Mainframe Connect DirectConnect f...

Release Bulletin Mainframe Connect DirectConnect for z/OS Option 15.0 for Windows, Linux, and UNIX

Documents known problems and changes to installation, documentation and functionality for Mainframe Connect 15.0 with DirectConnect Option for z/OS. For a complete list of topics, please see "Topic".
 
RSS Feed
 
 
 

Release Bulletin Mainframe Connect™ DirectConnect™ for z/OS Option 15.0 for Windows, Linux, and UNIX

 

Document ID: DC72249-01-1500-03

Last revised: July 29, 2011

 


EBF downloads for security fixes

Due to possible security vulnerabilities, Sybase® strongly recommends that you use the appropriate EBF to fix these issues. For instructions, see the Urgent Customer Notification Web page.

Known issues described in this release bulletin may have been fixed in other EBFs released for this product. Get EBFs and maintenance reports describing latest fixes from the Sybase Web site.

 


Accessing current release bulletin information

A more recent version of this release bulletin may be available on the Web. To check for critical product or document information added after the product release, use the Sybase Product Documentation Web site.

Accessing release bulletins at the Sybase Product Documentation Web site

  1. Go to Product Documentation.

  2. Select a product and language and click Go.

  3. Select a product version from the Document Set list.

  4. Select the Release Bulletins link.

  5. From the list of individual documents, select the link to the release bulletin for your platform. You can either download the PDF version or browse the document online.

 


Product summary for version 15.0

DirectConnect™ for z/OS Option is available as part of Mainframe Connect™, which consists of products that provides access and integration to mainframe data. For more information, see the Mainframe Connect Overview Guide.


Version contents

DirectConnect for z/OS Option 15.0 includes program and documentation CDs. You can access online versions of the entire documentation set on the Sybase Product Documentation Web site

Table 1 shows the contents and product ID numbers for DirectConnect for z/OS Option 15.0:

Table 1: DirectConnect for z/OS Option 15.0 product set

Product/Documentation

Document ID

Mainframe Connect DirectConnect for z/OS Option for RISC/6000 AIX CD

CD68159-55-1500-01

Mainframe Connect DirectConnect for z/OS Option for Windows CD

CD68155-55-1500-01

Mainframe Connect DirectConnect for z/OS Option for Sun Solaris CD

CD68152-55-1500-01

Mainframe Connect DirectConnect for z/OS Option for Linux CD

CD68152-55-1500-01

Mainframe Connect DirectConnect for z/OS Option for HP-UX CD

CD68155-55-1500-01

Mainframe Connect DirectConnect for z/OS Option for HP Itanium DVD

DV60586-65-1500-01

ECDA Client DVD

DV68122-65-1500-01

Getting Started CD

CD00222-55-1500-02

Mainframe Connect DirectConnect for z/OS Option Installation Guide

DC34237-01-1500-02

Mainframe Connect New Features

DC00182-01-1500-01

Enterprise Connect™ Data Access and Mainframe Connect Server Administration Guide

DC35365-01-1500-01

Mainframe Connect DirectConnect for z/OS Option Users Guide for Access Services

DC36455-01-1500-01

Mainframe Connect DirectConnect for z/OS Option Users Guide for Transaction Router Services

DC38581-01-1500-01

Mainframe Connect DirectConnect for z/OS Option 15.0, for Microsoft Windows, Linux, and UNIX Release Bulletin

DC72249-01-1500-02


Hardware and software requirements

Following is a complete list of updated hardware and software requirements for DirectConnect for z/OS Option 15.0.


System requirements for DirectConnect for z/OS Option

Table 2 and Table 3 show the minimum system requirements for the DirectConnect for z/OS Option on UNIX and Windows platforms.

Table 2: System requirements for UNIX platforms

Item

HP 9000/800

Linux

RISC/6000 AIX

Sun Solaris

HP Itanium

CPU

An HP 9000/800

Intel-compatible

IBM RISC System/6000

Sun Solaris (SPARC) system

Itanium Processor Family (IPF)

RAM

300MB minimum

300MB minimum

300MB minimum

300MB minimum

300MB minimum

Storage

Minimum of 450MB, plus 512KB for each locale you support

Minimum of 450MB, plus 512KB for each locale you support

Minimum of 450MB, plus 512KB for each locale you support

Minimum of 450MB, plus 512KB for each locale you support

Minimum of 450MB, plus 512KB for each locale you support

Software

  • HP 9000/800 and 900 HP-UX 11.23

  • HP-UX SNAplus2, R6.11.23.100 (SNA LU 6.2 connectivity only)

  • Linux Red Hat 3.0, 4.0, and 5.0

  • SuSE 9.0 and 10.0

  • AIX 5.3

  • SNA communications 6.1.0.0 (SNA LU 6.2 connectivity only)

  • Sun Solaris 9 and 10

  • SNAP-IX 7.0.2.1 (SNA LU 6.2 connectivity only)

HP-UX 11.31 hpia

Table 3: System requirements for Windows platforms

Item

Requirements

CPU

Sybase recommends an Intel-compatible processor with a minimum of 500 megahertz.

RAM

512MB of RAM to run Windows 2000 and Windows 2003 for DirectConnect for z/OS Option.

Storage

A minimum of 300MB, plus at least 500KB for each locale you plan to support.

Software

  • Microsoft Windows 2000 Service Pack 4

  • Microsoft Windows 2003

  • Microsoft Windows XP Service Pack 1


System requirements for DirectConnect Manager

Table 4 shows the minimum system requirements for DirectConnect Manager on UNIX and Linux platforms.

Table 4: DirectConnect Manager requirements for Linux and UNIX

Item

HP 9000/800

Linux

RISC/6000 AIX

Sun Solaris

HP Itanium

CPU

HP 9000/800

Intel-compatible

IBM RISC System/6000

Sun Solaris (SPARC) system

Itanium Processor Family (IPF)

RAM

256MB minimum

256MB minimum

256MB minimum

256MB minimum

256MB minimum

Storage

75-100MB minimum

75-100MB minimum

75-100MB minimum

75-100MB minimum

250MB minimum

Table 5 shows the minimum system requirements for Windows.

Table 5: DirectConnect Manager system requirements for Windows

Item

Requirements

CPU

  • Microsoft Windows 2000 Service Pack 4

  • Microsoft Windows 2003

  • Microsoft Windows XP Service Pack 1

RAM

Sybase recommends 256MB.

Storage

Minimum of 75 - 100MB.

Note:A Java Virtual Machine (JVM) is provided with the DirectConnect Manager installation program as a Java Runtime Environment (JRE) executable.

 


Changed functionality in this version

For a summary of the new features available for Mainframe Connect DirectConnect for z/OS Option, refer to the Mainframe Connect 15.0 New Features document.

 


Special installation and configuration instructions

The following special installation instructions replace existing documented instructions, or are new installation instructions that were created after the release of DirectConnect for z/OS 15.0:

WARNING! Do not install DirectConnect for z/OS Option version 15.0 into an existing directory that contains Sybase products from previous releases.


Support for the third-party ODBC drivers

Sybase will continue to support the DataDirect front-end ODBC driver with the DirectConnect for z/OS Option version 12.6 and Mainframe Connect version 12.6 until July 30, 2009. The driver is supported only for data connectivity through Mainframe Connect (either through DirectConnect for z/OS Option or gatewayless) and not for any other database targets.


Migrating to Mainframe Connect 15.0

Sybase recommends that you migrate to the version of the Sybase ASE ODBC driver that is supported for use with DirectConnect for z/OS Option and Mainframe Connect. This driver is shipped with DirectConnect for z/OS Option and Mainframe Connect 15.0.


System environment files

For 15.0 and later versions, to allow multiple Mainframe Connect installations on the same machine, Sybase provides these environment files:

  • For UNIX:

    • <install_dir>/DC-15_0/DC_SYBASE.csh

    • <install_dir>/DC-15_0/DC_SYBASE.sh

  • For Windows:

    • <install_dir>\DC-15_0\DC_SYBASE.bat

Note:The following environment files are no longer used:For UNIX:

  • <install_dir>/SYBASE.csh and <install_dir>/SYBASE.sh

  • For Windows: <install_dir>\SYBASE.bat


Migration utilities

Due to directory structure changes, you cannot use utilities to migrate from a previous installation, for example, ECDA 12.x to ECDA 15.x.


Editing the interfaces file on UNIX

If you edit the interfaces file directly without using dsedit, you can edit the global interfaces file (located in <install_dir>/interfaces) or the local interfaces file (located in <install_dir>/DC-15_0/connectivity/interfaces), because the local version is a soft link to the global version.


Editing the sql.ini file on Windows

If you edit the interfaces file directly without using dsedit, you can edit the global interfaces file (located in <install_dir>\ini\sql.ini) or the local interfaces file (located in <install_dir>\DC-15_0\connectivity\ini\sqlini), because the local version is a soft link to the global version.


Configuration requirements for TRS

Transaction Router Service (TRS) requires a separate TRS Service Library installation for each unique TRS configuration set. For detailed configuration instructions, see the Mainframe Connect DirectConnect Users Guide for Transaction Router Services and the trscopy program.


Installing multiple products on the same machine

Perform the following tasks before you install any Sybase software into a directory in which Sybase software is already installed.

Create a backup

Create a backup of the existing installation directory and, if possible on Windows, the environment variable settings and registry.

Overwrite older existing files

On all platforms, when you install Sybase products into a directory that contains other Sybase products, the installation procedure overwrites existing files with the same name. However, if the files on the system are newer than the ones being installed, the installation procedure prompts you to specify whether or not to overwrite the existing files. In most instances, you want the newer version of the files and should choose not to overwrite newer files.?

Reset system variables

On Windows, if Sybase products are installed and you install another Sybase product into a different directory on the same machine, the system variables are reset to the directory where the last Sybase product was installed. Thus, any Sybase products that were on the system before and were configured to run as Windows services may no longer run automatically and as such, may not be manageable through the Control Panel service controls.?

To correct this problem, run the previously installed products from within a DOS command shell, or create scripts that set the environment and run the product. When using a DOS command shell, run the environment scripts (such as SYBASE.bat) to set the variables correctly for that product before running the product.?


Uninstalling from an environment with multiple Sybase products

Uninstalling Sybase products from environments that contain multiple Sybase products may affect the operation of the remaining Sybase products. This occurs because Sybase products frequently share modules or files, such as connectivity files (in the Sybase OCS-15_0 directory), JVM files (in the shared or shared-1_0 directories), language modules, and SySAM files. ?

Shared files between products

When uninstalling Sybase products from a directory that contains multiple Sybase products, be aware that you may remove files that other products require. As a result, if you uninstall one of the products that share files, you must use care in removing files that the remaining products require and cause the products to fail.

Change to variable settings

On Windows, removing Sybase products may result in changes to the system variable settings, which may also impact the operation of the remaining products or services. ?


Uninstalling from an environment with ECDA Options and DirectConnect for z/OS Option

To uninstall when an ECDA Option for ODBC and a DirectConnect for z/OS Option are installed, you must uninstall the products in reverse order of how they were installed. This is due to a problem with the uninstall procedure.

Note:Following an uninstall, you may need to manually delete files that may not have been removed.


ESD installation process warning

When installing an DirectConnect for z/OS Option Electronic Software Distribution (ESD), only the standard-named service libraries are upgraded; therefore, you must check for any custom-named service libraries in the <install_dir>/DC-15_0/svclib directory. If there are, you must do the following:

  • Run trscopy again,

    or

  • Copy the standard library file to the custom library files.

 


Software fixes in version 15.0

Table 6 lists the known problems that were fixed for DirectConnect for z/OS Option version 15.0. Each issue has a description, resolution, and the associated Quality Tracking System (QTS) number.

Table 6: Description of software fixes

Description

Resolution

QTS #

On Solaris, excessive memory usage occurred when using the RSP MESSAGE command.

Added freehostent calls to eliminate leak.

456106

Stopping the Windows service left an orphaned directc.exe process in Task Manager.

Modified stop service handling to correctly clean up the server.

455831

Catalog stored procedures incorrectly used the SYSMDI owner.

Catalog stored procedures now use SYBASEI for owner.

429303

CSP scripts were out of date, used old regions, and missed new CSPs.

CSP scripts updated.

428294

Service libraries created with trscopy were not visible in DirectConnect Manager.

Service libraries created with trscopy are now visible in DirectConnect Manager.

426685

The trscopy utility failed on Windows 2003.

The trscopy utility was rewritten to support Windows 2003.

422693

Request to add tracing where the hex data stream from CICS to TRS was written out to a trace file with a timestamp showing milliseconds.

Tracing was enhanced to display milliseconds.

405792

The LU62 service crashed when an attention missed the end of a result set.

This problem has been fixed.

405787

 


Known issues

This section contains known issues for this release:

Note:For the most current information regarding the status of the known issues, refer to the latest ESD README file.


DirectConnect for z/OS Option issues

This section describes known issues for DirectConnect for z/OS Option.


Messages displayed to screen at start-up

(CR 472988) The SySAM 2 library issues erroneous messages at start-up. These can be ignored.


During CSP processing no warning message is returned

(CR 165710) When SendWarningMessages is enabled and a warning is encountered during CSP processing, no warning message is returned.

Workaround: Turn off SendWarningMessages.


Stored procedures not executed as dynamic events

(CR142708) Stored procedures cannot be executed as dynamic events.

Workaround: Execute stored procedures as language events.


Service information added to a local sql.ini file

If you add DirectConnect for z/OS Option service information to a local sql.ini file, these error messages appear during start-up:

CT-LIBRARY error:
ct_connect(): directory service layer: internal directory control layer error: Requested server name not found.

You must add DirectConnect for z/OS Option service information to the global sql.ini file instead of the local sql.ini file:

  • For Windows: The global sql.ini file is located in <install_dir>\ini\sql.ini. The local sql.ini file is located in <install_dir>\DC-15_0\connectivity}\ini\sql.ini.

  • For UNIX:

    The global sql.ini file is located in <install_dir>/ini/sql.ini. The local sql.ini file is located in <install_dir>/DC-15_0/connectivity}/ini/sql.ini.


Extended Encrypted Passwords

CT-Lib-based clients enabling extended password encryption (CS_SEC_EXTENDED_ENCRYPTION=CS_TRUE) must set CS_SEC_NON_ENCRYPTION_RETRY = CS_TRUE to connect to DirectConnect for z/OS Option. The initial connection attempt using the encrypted password fails, but after you set CS_SEC_NON_ENCRYPTION_RETRY = CS_TRUE, CT-Lib automatically resends the password as plain text.


Large bulk data transfers fail

(CR 471636) Bulk data transfers greater than 512 bytes fail when issued from versions of client applications 15.0 and later. Client applications version 15.0 and later use an increased packet size of 2048, which is currently not supported by the Sybase SNA network software. The transfer fails with this error:

VENDORLIB] Vendor Library Error: DB2 Access Module GWLib error (TDYNAMIC returned -80) <DB2>.

Workaround: Use client versions earlier than 15.0 to issue the bulk transfer command, or use a TCP/IP connection to Mainframe Connect.


DirectConnect for z/OS Option not visible in Windows Task Manager

(CR 473018) You can start and use DirectConnect for z/OS Option as a service, but it is not visible in the Windows Task Manager.

Workaround: Use other Windows utilities to monitor service processes.


Editing sql.ini with a word processing program (Windows only)

If you edit the sql.ini file with a word processing program such as Microsoft Word, extra non-printable characters can be added to the end of text in the sql.ini file. As a result, Sybase Open Server™-based applications might not recognize server names as defined in the sql.ini file.

To modify the sql.ini file, use dsedit, which Sybase provides with your Open Client™ and Open Server installation.


Service name redirection default value required

The default server.cfg file does not give snrf.tbl as the default value.

Workaround: If you are using the default snrf.tbl, enter the following in the server.cfg file under the section called Client Interaction:

ServiceRedirectionFile=snrf.tbl


Unmapped error messages

When unmapped error messages from the host have no corresponding message text in DirectConnect for z/OS Option, this client message is displayed:

Msg 31261, Internal error: Unable to map message description for [<msg_id>]


Admin Service user.pwd file

The Admin Service of DirectConnect for z/OS Option changed from previous versions to read and write encrypted passwords to the user.pwd file. Previous user.pwd files are not supported with DirectConnect for z/OS Option 15.0 and later, and using them results in administrator login failures.

Workaround: Reenter the Administrator IDs and passwords from previous installations to the new Admin Service.


InstallShield issues

This section contains issues that relate to InstallShield.


Selecting Custom installation

(For z/OS AIX only) If you select the Custom installation and not the SNA option during installation, the installation utility displays this warning:

WARNING:   The TRS Access Service for SNA Option while shown as a selection item on the next screen WILL NOT BE INSTALLED because you do not have SNA on your system.

You are not allowed to choose options, and the installation utility performs a Full installation.


InstallShield errors (HP-UX and HP Itanium only)

On HP-UX and HP Itanium, two types of error messages that occur during installation can be ignored and have no impact on the InstallShield installation:

  • When in GUI mode, the installation procedure displays “gif file not found” messages on the console before the GUI interface is displayed.

  • When you create a response file for silent installations the installation procedure displays “Illegal character ‘8’ in encoding name” messages. These error messages have no effect on the functionality of the response file created and on a successful silent installation. Additionally, some of the comments inserted into the response file are not formatted correctly and can also can be ignored.


Uninstall function not removing all DirectConnect for z/OS Option files

On Windows, when you use InstallShield’s uninstall function from the Start menu, it does not remove all DirectConnect server files. Be sure to verify the files and manually remove any that remain.


Installation program may core dump (Linux only)

On Linux, if the LD_LIBRARY_PATH variable includes the ECDA lib directory path of a previous ECDA installation, the new installation session will core dump.

Workaround: Un-set the LD_LIBRARY_PATH environment variable prior to the new installation.


ASE/CIS and DB2 datatypes

This section describes issues that relate to DB2 UDB datatypes and ASE datatypes.


DB2 timestamp datatype

When you create a DB2 table using Adaptive Server® Enterprise/Component Integration Services (ASE/CIS), do not specify the timestamp datatype; this creates a column that cannot be written to. Instead, specify the ASE/CIS datetime datatype, which creates a DB2 timestamp column on the host.


ASE/CIS nchar and nvarchar datatypes

An error results when you use ASE/CIS to create an nchar or nvarchar column in DB2.

Workaround: To use either of these datatypes, do the following:

  • Create the tables manually on DB2 UDB with columns of type graphic in place of ASE/CIS nchar columns, and columns of type vargraphic in place of ASE/CIS nvarchar columns.

  • Use ASE/CIS with the nchar and nvarchar columns in the corresponding locations to issue the create existing table command to create a table on ASE/CIS that will correspond to the DB2 table.


Quoted_identifier failure

An error occurs if a column name is quoted within a SQL statement, such as:

create table dwmdbas.user.mytab (“order” int)

In sybase mode, this behavior prevents the use of Transact-SQL® reserved keywords as column names.


DirectConnect Manager

This section describes issues that are related to DirectConnect Manager.


Cannot create an RPC pointer in a TRS-SNA service

You cannot create an RPC pointer in a TRS-SNA service using DirectConnect Manager.

Workaround: Use the sgw_addrpc command. This command is described in the Mainframe Connect DirectConnect for z/OS Option Users Guide for Transaction Router Services, Chapter 3, “Configuring a TRS,” in the section titled, “Configuring RPCs.”

 


Product compatibilities

DirectConnect for z/OS Option version 15.0 is compatible with:

  • Sybase Open Client 15.0 and later

  • Adaptive Server Enterprise 15.0 and later

  • Sybase Replication Server® 15.0 and later

  • jConnect™ for JDBC™ for 6.0 and later

  • DirectConnect Manager 12.6.1 and later

 


Documentation updates and clarifications

In the Mainframe Connect DirectConnect for z/OS Option 15.0 Installation Guide for Microsoft Windows, Linux, and UNIX, all references to the “Client CD” should be changed to “Client DVD.” In addition, all references to the “Mainframe Connect DirectConnect for z/OS Option for HP Itanium CD” should be changed to the “Mainframe Connect DirectConnect for z/OS Option for HP Itanium DVD.”

This change occurs due to the increased size required for the client software in this release.

 


Technical support

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 if you need assistance during the installation process, ask the designated person to contact Sybase Technical Support or the Sybase subsidiary in your area.

 


Other sources of information

Use the Sybase Getting Started CD and the Sybase Product Documentation Web site to learn more about your product:

  • The Getting Started CD contains release bulletins and installation guides in PDF format. It is included with your software. To read or print documents on the Getting Started CD, you need Adobe Acrobat Reader, which you can download at no charge from the Adobe Web site using a link provided on the CD.

  • The Sybase Product Documentation Web site is accessible using a standard Web browser. In addition to product documentation, you will find links to EBFs/Maintenance, Technical Documents, Case Management, Solved Cases, newsgroups, and the Sybase Developer Network.

    To access the Sybase Product Documentation Web site, go to Product Documentation.


Sybase certifications on the Web

Technical documentation at the Sybase Web site is updated frequently.

Finding the latest information on product certifications

  1. Point your Web browser to Technical Documents.

  2. Click Partner Certification Report.

  3. In the Partner Certification Report filter select a product, platform, and timeframe and then click Go.

  4. Click a Partner Certification Report title to display the report.

Finding the latest information on component certifications

  1. Point your Web browser to Availability and Certification Reports.

  2. Either select the product family and product under Search by Base Product; or select the platform and product under Search by Platform.

  3. Select Search to display the availability and certification report for the selection.

Creating a personalized view of the Sybase Web site (including support pages)

Set up a MySybase profile. MySybase is a free service that allows you to create a personalized view of Sybase Web pages.

  1. Point your Web browser to Technical Documents.

  2. Click MySybase and create a MySybase profile.


Sybase EBFs and software maintenance

Finding the latest information on EBFs and software maintenance

  1. Point your Web browser to the Sybase Support Page.

  2. Select EBFs/Maintenance. If prompted, enter your MySybase user name and password.

  3. Select a product.

  4. Specify a time frame and click Go. A list of EBF/Maintenance releases is displayed.

    Padlock icons indicate that you do not have download authorization for certain EBF/Maintenance releases because you are not registered as a Technical Support Contact. If you have not registered, but have valid information provided by your Sybase representative or through your support contract, click Edit Roles to add the “Technical Support Contact” role to your MySybase profile.

  5. Click the Info icon to display the EBF/Maintenance report, or click the product description to download the software.

 


Accessibility features

This document is available in an HTML version that is specialized for accessibility. You can navigate the HTML with an adaptive technology such as a screen reader, or view it with a screen enlarger.

ECDA version 15.0 and the HTML documentation have been tested for compliance with U.S. government Section 508 Accessibility requirements. Documents that comply with Section 508 generally also meet non-U.S. accessibility guidelines, such as the World Wide Web Consortium (W3C) guidelines for Web sites.

Note:You might need to configure your accessibility tool for optimal use. Some screen readers pronounce text based on its case; for example, they pronounce ALL UPPERCASE TEXT as initials, and MixedCase Text as words. You might find it helpful to configure your tool to announce syntax conventions. Consult the documentation for your tool.

For information about how Sybase supports accessibility, see Sybase Accessibility. The Sybase Accessibility site includes links to information on Section 508 and W3C standards.

See Section 508 compliance statement for DirectConnect Manager at Voluntary Product Assessment Templates.


 

DOCUMENT ATTRIBUTES
Last Revised: Aug 10, 2011
Part Number: DC72249-01-1500-03
Product: DirectConnect, Mainframe Connect
Technical Topics: Migration, Middleware, Connectivity, Localization, Error Message, Data Management, Install/Upgrade, Transaction Processing, Application Development, Client/Server Development
  
Business or Technical: Technical
Content Id: 1094433
Infotype: Release Bulletin
 
 
 

 
© Copyright 2014, Sybase Inc. - v 7.6 Home / Contact Us / Help / Jobs / Legal / Privacy / Code of Ethics