Xcentrisity® BIS AddPack for Visual COBOL User's Guide Micro Focus The Lawn 22-30 Old Bath Road Newbury, Berkshire RG14 1QN UK http://www.microfocus.com © Copyright 2009-2020 Micro Focus or one of its affiliates. MICRO FOCUS, the Micro Focus logo and Visual COBOL are trademarks or registered trademarks of Micro Focus or one of its affiliates. All other marks are the property of their respective owners. 2020-06-17 ii Contents Xcentrisity Business Information Server for Visual COBOL User's Guide ............................................................................................................................. 5 Copyright and Trademarks .................................................................................................. 5 Introducing the Business Information Server ...................................................................... 5 Overview .................................................................................................................. 6 Installation on Windows ............................................................................................7 Installation on UNIX ..................................................................................................9 Testing the Installation ............................................................................................11 Uninstalling BIS for IIS ........................................................................................... 11 Uninstalling BIS for Apache ....................................................................................12 Using BIS .......................................................................................................................... 12 Web Protocols: Requests/Responses ....................................................................13 Sessions .................................................................................................................14 Tracking Sessions ...................................................................................................14 Cookies .................................................................................................................. 15 The Session Root Path and Session Scope ...........................................................15 Timeouts .................................................................................................................16 Server Response Files ......................................................................................................17 Overview ................................................................................................................ 17 Rendering Tags ...................................................................................................... 18 The Rendering Process ..........................................................................................18 Tag Options and Parameters ..................................................................................19 Replacement Tag Reference .............................................................................................22 The {{Handler}} Tag ................................................................................................ 22 The {{ContentType}} Tag ........................................................................................ 23 The {{SessionParms}} Tag ..................................................................................... 23 The {{ServiceOpts}} Tag .........................................................................................25 The {{ServiceArgs}} Tag ......................................................................................... 26 The {{ServiceLibs}} Tag ..........................................................................................26 The {{StartService}} Tag .........................................................................................27 The {{RunPath}} Tag ...............................................................................................28 The {{SetEnv}} Tag ................................................................................................. 28 The {{XMLExchange}} Tag ..................................................................................... 29 The {{StopService}} Tag ......................................................................................... 30 The {{SessionComplete}} Tag ................................................................................ 30 The {{Value}} Tag ....................................................................................................30 The {{Trace}} Tag ....................................................................................................34 The {{TraceDump}} Tag .......................................................................................... 37 The {{Debug}} Tag .................................................................................................. 37 Control Flow Tags ............................................................................................................. 40 The {{If}} / {{Else}} / {{EndIf}} Tags ..........................................................................40 The {{While}} / {{EndWhile}} Tags ...........................................................................40 The {{ Include }} Tag ............................................................................................... 41 {{//}} Comment Tags ............................................................................................... 41 Service Programs ..............................................................................................................42 Introduction .............................................................................................................42 Service Program Lifetime ....................................................................................... 44 The XML Exchange File ......................................................................................... 44 BIS Return Codes .................................................................................................. 45 Service Program Functions ....................................................................................47 Server Variables Reference .............................................................................................. 66 Contents | 3 XML Exchange Request File Format ................................................................................ 75 Windows/UNIX Portability Considerations ........................................................................ 78 Regular Expression Syntax ...............................................................................................78 Metacharacters .......................................................................................................78 Abbreviations ..........................................................................................................80 BIS Troubleshooting Tips .................................................................................................. 80 Configuring BIS/IIS after Installation ................................................................................. 81 Command Line Configuration .................................................................................81 Configuring the Run As Logon ID ...........................................................................82 Retrieving or Changing the Configured Identity ..................................................... 84 Manual Configuration ............................................................................................. 85 Setting Environment Variables ............................................................................... 87 Setting the Maximum Thread Count .......................................................................87 Notes ...................................................................................................................... 88 Configuration after Installation (UNIX/Apache) ................................................................. 88 Configuring Apache ................................................................................................88 Service Engine Configuration .................................................................................90 xbisctl Utility ............................................................................................................93 Creating a BIS/IIS Virtual Directory ...................................................................................94 Running the BISMkDir Program ............................................................................. 94 Creating the Directory ............................................................................................ 97 Testing the New Directory ...................................................................................... 97 64-Bit Windows Considerations ............................................................................. 97 Building and Running BIS Samples .................................................................................. 98 Migrating from RM/COBOL to Visual COBOL ...................................................................98 Using GOBACK ......................................................................................................98 Compiling and Starting Service Programs ............................................................