Xcentrisity BIS User's Guide for RM/COBOL
Total Page:16
File Type:pdf, Size:1020Kb
Micro Focus RM/COBOL Xcentrisity™ Business Information Server User’s Guide Version 12 Micro Focus The Lawn 22-30 Old Bath Road Newbury, Berkshire RG14 1QN UK http://www.microfocus.com Copyright © Micro Focus 2008-2018. All rights reserved. MICRO FOCUS, the Micro Focus logo, and Micro Focus product names are trademarks or registered trademarks of Micro Focus Development 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. Revised 2018-05-09 for version 12.15 Table of Contents Table of Contents Chapter 1. Introducing the Business Information Server ............................................................ 1 Overview .................................................................................................................................................. 1 Installation on Windows ......................................................................................................................... 3 BIS 32-bit and 64-bit Versions ........................................................................................................................ 3 Prerequisites .................................................................................................................................................... 3 Internet Information Server (IIS) ..................................................................................................................... 4 Electronic Product Delivery ............................................................................................................................ 6 Installing BIS on Windows ............................................................................................................................. 7 Custom Installation Details ............................................................................................................................. 9 Installation on UNIX ............................................................................................................................. 11 Prerequisites .................................................................................................................................................. 11 Electronic Product Delivery .......................................................................................................................... 12 Installing BIS on UNIX ................................................................................................................................. 14 Configuring Apache ...................................................................................................................................... 19 Starting Apache and BIS ............................................................................................................................... 20 Testing the Installation ......................................................................................................................... 20 Uninstalling BIS for IIS ........................................................................................................................ 21 Removing Only the Web Application Samples ............................................................................................. 21 Uninstalling BIS for UNIX ................................................................................................................... 22 Chapter 2. Using the Business Information Server .................................................................... 23 Web Protocols: Requests and Responses ............................................................................................ 23 Sessions .................................................................................................................................................. 24 Tracking Sessions .................................................................................................................................. 25 Cookies ................................................................................................................................................... 25 The Session Root Path and Session Scope .......................................................................................... 25 Timeouts ................................................................................................................................................ 26 Session Inactivity Timeout ............................................................................................................................ 26 Service Timeouts ................................................................................................................................... 27 Chapter 3. Server Response Files ................................................................................................ 29 Overview ................................................................................................................................................ 29 Rendering Tags ..................................................................................................................................... 29 The Rendering Process ......................................................................................................................... 30 Processing Control Tags ................................................................................................................................ 30 Substitution Tags ........................................................................................................................................... 31 Tag Options and Parameters ............................................................................................................... 31 Pathnames ..................................................................................................................................................... 31 Referencing Files in System Locations ......................................................................................................... 31 Predefined BIS Environment Variables ........................................................................................................ 32 The RUNPATH Environment Variable ........................................................................................................ 32 Troubleshooting Tags .................................................................................................................................... 33 Chapter 4. Replacement Tag Reference ...................................................................................... 35 The {{Handler}} Tag ............................................................................................................................. 35 Xcentrisity Business Information Server User’s Guide III RM/COBOL Version 12 Table of Contents Notes ............................................................................................................................................................. 36 The {{ContentType}} Tag..................................................................................................................... 36 Examples ....................................................................................................................................................... 36 Notes ............................................................................................................................................................. 36 The {{SessionParms}} Tag ................................................................................................................... 36 Notes ............................................................................................................................................................. 39 The {{StartService}} Tag ...................................................................................................................... 39 Accessing the REQUEST from the Service Program .................................................................................... 41 Notes ............................................................................................................................................................. 41 The {{RunPath}} Tag ............................................................................................................................ 41 Notes ............................................................................................................................................................. 41 The {{SetEnv}} Tag ............................................................................................................................... 42 Examples ....................................................................................................................................................... 42 Notes ............................................................................................................................................................. 42 The {{XMLExchange}} Tag ................................................................................................................. 42 Notes ............................................................................................................................................................. 43 Recursive Tag Processing in {{XmlExchange}} .........................................................................................