Summary of the content on the page No. 1
™
Novell exteNd Composer
5250 Connect
www.novell.com
5.0
USER’S GUIDE
Summary of the content on the page No. 2
Legal Notices Copyright © 2000, 2001, 2002, 2003, 2004 SilverStream Software, LLC. All rights reserved. Title to the Software and its documentation, and patents, copyrights and all other property rights applicable thereto, shall at all times remain solely and exclusively with SilverStream and its licensors, and you shall not take any action inconsistent with such title. The Software is protected by copyright laws and international treaty provisions. You shall not remove any copyright notices
Summary of the content on the page No. 3
Online Documentation: To access the online documentation for this and other Novell products, and to get updates, see www.novell.com/documentation. Novell Trademarks eDirectory is a trademark of Novell, Inc. exteNd is a trademark of Novell, Inc. exteNd Composer is a trademark of Novell, Inc. exteNd Director is a trademark of Novell, Inc. jBroker is a trademark of Novell, Inc. NetWare is a registered trademark of Novell, Inc. Novell is a registered trademark of Novell, Inc. SilverStream Trademar
Summary of the content on the page No. 4
not be called "JDOM", nor may "JDOM" appear in their name, without prior written permission from the JDOM Project Management (pm@jdom.org). THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTI
Summary of the content on the page No. 5
Contents About This Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7 1 1 1 1 Welcome to exteNd Composer and 5250 User Interface 11 Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 About exteNd Composer Connects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12 What is the 5250
Summary of the content on the page No. 6
Connection Pool Management and Deployed Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 6 6 Advanced Features 107 6 6 The 5250 Multi Row Wizard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Handling System Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 A A Java Code Pages 133 A A About Encodings . . . . . . . . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 7
About This Guide Purpose The guide describes how to use exteNd Composer 5250 Connect, referred to as the 5250 Component Editor. The 5250 Component Editor is a separately-installed component editor in exteNd Composer. Audience The audience for the guide is developers and system integrators using exteNd Composer to create services and components which integrate 5250 applications. Prerequisites The guide assumes the reader is familiar with and has used exteNd Composer’s development environmen
Summary of the content on the page No. 8
Chapter 3, Creating a 5250 Component, describes the parts of the component editor. Chapter 4, Performing 5250 Actions, describes how to use the basic 5250 actions, as well as the 5250 Multi Row Wizard. Chapter 5, Logon Components, Connections and Connection Pools, describes how to create logon components, connections and connection pools. Chapter 6, Advanced Features, describes dealing with multi-row and multi-screen data, and gives some tips on handling systems messages. Appendix A,Java Cod
Summary of the content on the page No. 9
System input Operating system objects 9 9 9 9
Summary of the content on the page No. 10
10 10 5250 Connect User’s Guide 10 10
Summary of the content on the page No. 11
1 Welcome to exteNd Composer and 5250 User Interface Chapter 1 Before You Begin Welcome to the 5250 Connect Guide. This Guide is a companion to the exteNd Composer User’s Guide, which details how to use all the features of Composer, except the Connect Component Editors. If you haven’t looked at the Composer User's Guide yet, please familiarize yourself with it before using this Guide. exteNd Composer provides separate Component Editors for each Connect, like 5250. The special features of ea
Summary of the content on the page No. 12
About exteNd Composer Connects exteNd Composer is built upon a simple hub and spoke architecture (Fig.1-1). The hub is a robust XML transformation engine that accepts requests via XML documents, performs transformation processes on those documents and interfaces with XML-enabled applications, and returns an XML response document. The spokes, or Connects, are plug-in modules that "XML- enable" sources of data that are not XML-aware, bringing their data into the hub for processing as XML. Th
Summary of the content on the page No. 13
exteNd Composer Connects can be categorized by the integration strategy each one employs to XML-enable an information source. The integration strategies are a reflection of the major divisions used in modern systems designs for Internet- based computing architectures. Depending on your B2B needs and the architecture of your legacy applications, exteNd Composer can integrate your business systems at the User Interface, Program Logic, or Data levels. Figure 1-2 Welcome to exteNd Composer and
Summary of the content on the page No. 14
What is the 5250 (TDS) Connect? The 5250 Connect XML-enables IBM AS/400-legacy system data using the User Interface integration strategy by hooking into the Terminal Data Stream (TDS). The term 5250 is commonly used to refer to the generic "dumb terminal" types used to connect to IBM AS/400 mid-range systems. When connecting to an IBM AS/400, the 5250 TDS uses IBM’s EBCDIC character-encoding scheme. The 5250 TDS, which was developed in the 1960s, emerged as that generation’s standard, and p
Summary of the content on the page No. 15
About exteNd Composer’s 5250 Component Much like the XML Map component, the 5250 component is designed to map, transform, and transfer data between two different XML templates (i.e., request and response XML documents). However, it is specialized to make a TN5250 connection to an AS/400 application, process the data using elements from a DOM to a terminal session, and then map the results of the terminal session to an output DOM. You can then act upon the output DOM in any way that makes se
Summary of the content on the page No. 16
What Applications Can You Build Using the 5250 User Interface Component Editor? exteNd Composer, and consequently the 5250 Connect, can be applied to the the following types of applications: 1 Business to Business Web Service interactions such as supply chain applications. 2 Consumer to Business interactions such as self-service applications from Web Browsers. 3 Enterprise Application Integrations where information from heterogeneous systems is combined or chained together. Fundamentally,
Summary of the content on the page No. 17
2 Getting Started with the 5250 Component Editor Chapter 2 The Sample Transactions For demonstration purposes, three transactions are used throughout this document in the samples presented: PART, GORD, and MENU. These transactions represent typical transactions used by operators. The PART transaction represents a scenario in which an operator uses a SKU number to drive an inquiry to a database. The GORD transaction represents a scenario in which an order for an item or several items is pla
Summary of the content on the page No. 18
Creating a 5250 Connection Resource Once you have the XML templates in place, your next step will be to create a Connection Resource to access the AS/400 transaction. If you try to create a 5250 Component in the absence of any available Connection Resources, a dialog will appear, asking if you wish to create a Connection Resource. By answering Yes to this dialog, you will be taken to the appropriate wizard. About Connection Resources When you create a Connection Resource for the 5250 Compone
Summary of the content on the page No. 19
4 Click Next. The second page of the wizard appears. 5 Select the TN5250 Connection type from the pull-down menu. The dialog changes appearance to show just the fields necessary for creating the 5250 connection. 6 In the Host or IP Address field, enter the physical address or alias for the machine to which you are connecting. Your system administrator will provide you with this information, which is defined in a separate host file. 7 In the Telnet Port field, enter the number of the port. Th
Summary of the content on the page No. 20
11 The Terminal Type field lists the various types of terminals supported by 5250 components, including different screen sizes (i.e. 24x80 and 27x32). Select from the drop down list box the type of terminal you are using. 12 In the DBSC Support field, select from the drop down list box your choice of your Default, Double Encoding or SO/SI Using Ox1F. 13 In the DBCS Code Page field, select from the drop down list box the appropriate code page. 14 Click the checkbox to enable Version 2.7 Compa
