Oracle Tuxedo Mainframe Adapter for SNA 12c Release 2 (12.1.3) Release Notes

The following topics are discussed in this document.

•	About Oracle Tuxedo Mainframe Adapter for SNA 12c Release 2 (12.1.3)

•	Installation Notes

•	Fixed Problems

•	Limitations

About Oracle Tuxedo Mainframe Adapter for SNA 12c Release 2 (12.1.3)

Oracle Tuxedo Mainframe Adapter for SNA is a domain-based product that provides bi-directional connectivity between Oracle Tuxedo clients or servers, and mainframe applications. Mainframe applications may use Customer Information Control System/Extended System Architecture (CICS TS) and Information Management System (IMS) implicit LU6.2, or any IBM-supported Application Program-to-Program Communication (APPC) or CICS TS interface.

New Product Features

The following new features are available in version 12c Release 2 (12.1.3) of the Oracle Tuxedo Mainframe Adapter for SNA product:

•	Support for channel/container in DPL

The channel and container model provides an easy and flexible mechanism for exchanging large volumes of structured parameter data between CICS programs.

For more information, see "Channel/Container Support in DPL" in Oracle Tuxedo Mainframe Adapter for SNA Users Guide and "CICS/ESA DPL to ATMI Requests/Responses Server for Channel/Container" in Oracle Tuxedo Mainframe Adapter for SNA Reference Guide.

•	Support for multi-byte character set (MBCS)

Besides single-byte character set (SBCS) character set translation, Oracle Tuxedo Mainframe Adapter for SNA now supports multi-byte character set (MBCS) translation. This feature allows translation among more than 200 different SBCS and MBCS character sets.

For more information, see "Multi-byte Character Set (MBCS) Support" in Oracle Tuxedo Mainframe Adapter for SNA Users Guide.

•	Support for customized call ID

You can retrieve customized call ID from every Oracle Tuxedo Mainframe Adapter incoming call message. Many buffer types support this feature, including CHANNEL/CONTAINER, VIEW, and FML32. Call ID is composed of fields; you can choose to put one or more fields to each call ID in configuration file. Oracle Tuxedo Mainframe Adapter for SNA Gateway loads and parses the configuration file at initialization, and generates a call ID depending on it when decoding an inbound request and sets this call ID to message.

Note:

This feature requires TSAM Plus 12.1.3.0.

For more information, see "Configurations for Customized Call ID Support" in Oracle Tuxedo Mainframe Adapter for SNA Users Guide and "Call Path" in Oracle Tuxedo System and Applications Monitor Plus Console Users Guide.

•	Separated CRM configurations on mainframe

Oracle Tuxedo Mainframe Adapter for SNA provides the flexibility for you to store and manage CRM related configurations (CICSLINKS and SNASTACKS) on mainframe independent of Tuxedo side configuration.

For more information, see "Configuring the Oracle Tuxedo Mainframe Adapter for SNA Gateway" in Oracle Tuxedo Mainframe Adapter for SNA Users Guide and "Having Separate CRM Configurations on Mainframe" in Oracle Tuxedo Mainframe Adapter for SNA CRM Administration Guide.

•	Auto import of service definitions from Tuxedo Metadata Repository

SNA gateway uses DM_LOCAL_SERVICES and DM_REMOTE_SERVICES sections in the DMCONFIG file to store the import/export service attributes. This feature provides a unified and consistent service definition mechanism in Tuxedo Metadata Repository to define those services.

For more information, see "Using the Oracle Tuxedo Metadata Repository" in Oracle Tuxedo Mainframe Adapter for SNA Users Guide.

•	CRM trace retrieval

SNA gateway uses crmretrc on open systems to retrieve trace from CRM. You can use crmretrc from any machine located on the same TCP/IP network when it is running the CRM server.

For more information, see "crmretrc" and "CRM" in Oracle Tuxedo Mainframe Adapter for SNA CRM Administration Guide.

•	Inbound transaction routing

Oracle Tuxedo Mainframe Adapter for SNA supports inbound terminal initiated transaction routing. This feature allows terminals connected to a mainframe CICS system to run with transactions in a connected ART CICS system at run-time.

For more information, see "Inbound Transaction Routing" in Oracle Tuxedo Mainframe Adapter for SNA Users Guide.

Installation Notes

Oracle Tuxedo Mainframe Adapter for SNA 12c Release 2 (12.1.3) is supported for the following Oracle Tuxedo releases:

•	Oracle Tuxedo 12c Release 2 (12.1.3) (Rolling Patch 003 or above is required on certain platforms)

For more information, see "Oracle Tuxedo Mainframe Adapter for SNA Supported Platforms" in Installing the Oracle Tuxedo Mainframe Adapter for SNA.

Fixed Problems

This section describes problems from the prior release of the Oracle Tuxedo Mainframe Adapter for SNA that have been fixed in the current release. Table 1 lists a bug number for each problem.

 

Table 1 Fixed Problems

Bug Number	Description
Bug 17893861	GWSNAX REPORTS TRANS EVENT ERROR WHEN CRM GETTING RESOURCEFAILURENORETRY
Bug 17848955	GWSNAX REPORTS TRANS EVENT ERROR WHEN TUXEDO TRANSACTION TIMEOUT
Bug 17702845	CRM CRASHES: SEGMENTATION FAULT
Bug 17670053	ENH: VIEW INPUT BUFFER GIVEN TO CICS SHOULD HAS LENGTH = USER DATA LENGT
Bug 17626554	CONNECTION NOT RELEASED AFTER TIME OUT IN TUXEDO
Bug 17235230	GWSNAX REPORTED TRANS EVENT ERROR
Bug 17235208	GP_CAT:1569: ERROR: UNABLE TO LOCK NETWORK MUTEX 0 AT 97
Bug 16994359	CRM FAILED TO RECONNECT GENERIC RESOURCE CICSS WITH SENSE 08050000
Bug 16778620	GWSNAX MEMORY LEAK WHEN TA_API=CICS
Bug 16729040	ENH: ERROR MESSAGE MORE FRIENDLY FOR SOCKET DISCONNECTED
Bug 16686056	GWSNAX GPE:56:56 INVALID ENCRYPTION LEVEL RANGE
Bug 16460458	NEW SNA REMOTE SERVICE (ADDED DYNAMICALLY) STAYS ADVERTIZED IN SUSP STATUS
Bug 16414298	GWSNAX DOES NOT RECONNECT TO CRM AFTER CRM REBOOT
Bug 16302195	SNACRM AUTHENTICATION SETUP FAILED
Bug 16288402	CRM CRASHES BY AN ASSERT PROBABLY
Bug 16229695	USING TELNET WITH CRM ADDRESS AND PORT WILL KILL THE CRM TASK ON MAINFRAME
Bug 16097102	TMA SAMPLES MUST BE INCLUDED ON INSTALLATION PROCESS/SOFTWARE
Bug 15990084	LIBGWS_CAT 3157 SHOULD LOG THE NAME OF CRM THAT IS CONNECTED TO
Bug 15920829	NEED MORE TRACES ON GWSNAX ABOUT ERRORS IN CONVERSION AND BUFFER CONTENTS
Bug 15895537	ER: NEEDS CRM COMMANDS (CRMLKON / CRMLKOFF / CRMDOWN) IN SNAGW'S PATCH
Bug 15854327	ER: ALLOW 8 BYTES LONG TO S9(9) COMP MAPPING
Bug 14551116	ALLOW FLAT TYPE OF FML32 RETURNED BY TMA AS OPTION
Bug 14534791	CRM DISCONNECTED. SHUTTING DOWN TMA SNA GATEWAY
Bug 14482846	CRM REJECT INCOMING LUNAME BY ERROR
Bug 14102011	GWSNAX WITH SNA STACK ON HPUX CRASHES WITH BIG BUFFER
Bug 12363659	GWSNAX STARTING FAILED WHEN A CICS IS NOT AVAIL

Limitations

•	For inbound transaction routing feature, pseudo-conversational transaction is supported, and conversational transaction is not supported.