OnWeb 7.5.0 Developer©s Guide Micro Focus (IP) Ltd. The Lawn 22-30 Old Bath Road Newbury, Berkshire RG14 1QN UK http://www.microfocus.com Copyright 2010 Micro Focus (IP) Limited. All Rights Reserved. MICRO FOCUS, the Micro Focus logo and RUMBA are trademarks or registered trademarks of Micro Focus (IP) Limited or its subsidiaries or affiliated companies in the United States, United Kingdom and other countries. All other marks are the property of their respective owners. ii Table of Contents Chapter 1: Overview OnWeb components • 7 OnWeb Server • 7 OnWeb Designer • 7 OnWeb Source Server • 8 OnWeb Administrator • 8 OnWeb Application Manager • 9 OnWeb Object Builder • 9 About this guide • 10 Learning more about OnWeb • 11 Chapter 2: Creating Host Publishing Applications Creating a simple Host Publishing application • 13 Customizing a Host Publishing application • 14 Customizing default templates • 14 Customizing individual screens presentation • 16 Chapter 3: Host Publishing Advanced Features Using template groups • 22 Template groups ‐ example • 23 Creating template groups • 25 Using screen groups • 25 Customizing final HTML pages • 26 Using Pre‐Display and Submit procedures • 27 Using lookup tables • 29 Using headers and footers • 31 Customizing launch page • 32 Optimizing application performance • 32 Pooling connections • 32 Limiting connections • 34 Adding a Logon/Logoff script to the application • 34 OnWeb Developer’s Guide iii Table of Contents Using Host Publishing HTML tags • 34 Adding User Preferences dialog to the application • 38 Using OnWeb Macro Editor • 40 Using session variables in the scripts • 41 Session variables • 41 CGI variables • 42 Using Host Publishing with OnWeb ActiveX control • 44 Advanced features ‐ example • 44 Chapter 4: Using LiveConnect Functionality JavaScript to Java communication • 47 Using Packages object • 48 Using JavaArray object • 49 Passing arguments of type char • 49 Initializing static initializer blocks • 49 Data type conversions • 50 StringValue JavaScript Extension • 50 JavaScript to Java Conversions • 51 Catching exceptions • 53 Catching JavaScript exceptions • 53 Catching Java exceptions in JavaScript • 54 Chapter 5: Creating OnWeb Mobile Applications Creating an OnWeb Mobile application in Designer • 55 Designate application for mobile devices • 55 Capture and customize screens • 56 Creating mobile application components in OnWeb Object Builder • 58 Chapter 6: Deploying Applications Step 1: Create Installable OnWeb Application • 59 Step 2: Deploy IOA • 60 Chapter 7: Using OnWeb Assembly Programming interface • 61 tOnWebServer object • 62 OnWeb Assembly ‐ sample program • 65 iv OnWeb Developer’s Guide Table of Contents Chapter 8: Using OnWeb UJB Setting up development environment • 69 Accessing OnWeb Server using OnWeb UJB • 70 Using OnWeb UJB • 71 Specifying properties • 71 Making OnWeb UJB work • 73 Putting it all together • 76 Using the IObject • 77 Chapter 9: Using OWJ2MEClient Component Programing interface • 79 OnWebServer class • 80 IObject class • 84 Error class • 85 Table class • 85 Table.Schema class • 86 Table.Schema.Column class • 86 Table.Schema.Column.Type class • 87 Parameters class • 87 Parameter class • 88 OWJ2MEClient ‐ sample code • 89 Chapter 10: Integrating Your Business Systems with OnWeb Using OnWeb Connectors • 95 Using OnWeb BizTalk Adapter • 97 Preparing OnWeb components for integration • 97 Incorporating OnWeb components into BizTalk Server project • 98 Appendix A: Supported Codepages Appendix B: Reserved Words Appendix C: Using MQSeries with OnWeb Environment requirements • 108 OnWeb Developer’s Guide v Table of Contents Configuration with OnWeb • 108 MQAX interfaces • 110 Sample programming and test environment • 111 Control commands • 112 Index • 113 vi OnWeb Developer’s Guide Overview 1 OnWeb® gives you the power to build Web applications that take advantage of the existing data and business logic in your enterprise. OnWeb also provides the tools to create new, reusable logic for your organization’s Web applications. An application that works with OnWeb can be a Web page in a browser or a stand‐alone executable. You can also create applications that will be run on a mobile device. OnWeb applications are stored on OnWeb Server that can be installed either on the Microsoft Windows®, Solaris™, Linux®, orAIX® platforms, or the iSeries™ systems. OnWeb components OnWeb consists of several core components: OnWeb Server, OnWeb Designer, OnWeb Source Server, OnWeb Administrator, OnWeb Application Manager, and OnWeb Object Builder. Each component is briefly described below. For more information about installing OnWeb components, see OnWeb Administrator Guide. OnWeb Server OnWeb Server is a high performance, scalable, multi‐user run time environment that accesses and integrates multiple data sources in real time, executes business logic, and delivers the application to the desktop. It runs on either the Microsoft Windows, Solaris, Linux, AIX, or iSeries systems and fully utilizes their performance capabilities. OnWeb Designer OnWeb Designer is a development environment for creating OnWeb applications. An OnWeb application has a single mainframe application as its OnWeb Developer’s Guide 7 Chapter 1 ‐ Overview primary source and brings the legacy host content into the customized HTML pages. It can be developed for both the Windows and the UNIX® platform. When building an application, you use Designer’s white‐board to organize objects into a hierarchical structure, as shown below. To write the objects’ code, you can use JavaScript™, HTML, or XML. To use OnWeb Designer, you must log on to OnWeb Server and must be connected to the OnWeb Source Server. See OnWeb Designer Help for detailed information on how to use Designer. OnWeb Source Server OnWeb Source Server is a database server used by Designer to store components of OnWeb applications. OnWeb Administrator OnWeb Administrator is a tool for administering OnWeb Server. It requires Microsoft Internet Explorer 5.5 or higher to run. Use the Administrator to configure basic and advanced server settings, view server logs, view session information, and manage users and user groups. 8OnWeb Developer’s Guide Chapter 1 ‐ Overview See OnWeb Administrator Help for detailed information on how to use this tool. OnWeb Application Manager OnWeb Application Manager is a tool to be used for deploying and managing OnWeb applications on a production server. See OnWeb Application Manager Help for details on how to use the tool. OnWeb Object Builder OnWeb Object Builder is used to extend the 3rd party development environment to access host information. It allows to create a variety of reusable components that encapsulate captured host transactions. The supported components are: Web services, .NET assemblies, JavaBeans™, EJBs™, portlets, BizTalk® schemas, and Web‐To‐Host pages. OnWeb Object Builder can be run as a stand‐alone tool or as an add‐in in Microsoft Visual Studio® .NET and Borland® JBuilder™. See OnWeb Object Builder Help and OnWeb Object Builder Tutorial for details on how to use the tool. OnWeb Developer’s Guide 9 Chapter 1 ‐ Overview About this guide This guide describes the process and various issues related to creating OnWeb applications. It is divided into the following chapters and appendices: Chapter/Appendix Description Chapter 2, “Creating Host Describes the process of creating a Host Publishing Applications” Publishing application. Chapter 3, “Host Publishing Describes several advanced features used in Advanced Features” creating Host Publishing applications. Chapter 4, “Using Describes how to use LiveConnect™ LiveConnect Functionality” functionality to facilitate communication between Java™ and JavaScript. Chapter 5, “Creating OnWeb Describes how to create an OnWeb Mobile Applications” application that can be accessed from a mobile device. Chapter 6, “Deploying Describes the process of deploying your Applications” finished application into a production server. Chapter 7, “Using OnWeb Describes OnWeb Assembly API. Assembly” Chapter 8, “Using OnWeb Describes how to use OnWeb UJB in Java UJB” code. Chapter 9, “Using Describes how to use the OWj2meClient OWJ2MEClient Component” component to access OnWeb Server from a mobile device. Chapter 10, “Integrating Your Describes how to use OnWeb Connectors Business Systems with and OnWeb BizTalk Adapter to integrate OnWeb” other application solutions with OnWeb. Appendix A, “Supported Lists codepages supported by Designer and Codepages” Navigator. Appendix B, “Reserved Lists reserved words that should not be used Words” as parameter names. Appendix C, “Using Describes how to use MQSeries® MQSeries with OnWeb” Automation Classes for ActiveX® with OnWeb applications. 10 OnWeb Developer’s Guide Chapter 1 ‐ Overview Learning more about OnWeb OnWeb user documentation is available in two formats: online help and online guides. OnWeb Online Help When exists, the componentʹs online help is accessible from its user interface. It contains a brief overview of the component’s features and detailed procedures on how to use the component. OnWeb also installs two stand‐alone help files that are accessible from the Windows Start menu (Start > Programs > NetManage OnWeb > Documentation): OnWeb Scripting Help This help contains reference information for the OnWeb scripting environment. Host Publishing HTML Tags Help This help contains reference information for the custom HTML tags developed by Micro Focus® to use with the Host Publishing applications. OnWeb Online Guides The following