Global Technical Support Wintegrate Troubleshooting Guide Version 1.0
Total Page:16
File Type:pdf, Size:1020Kb
Global Technical Support wIntegrate Troubleshooting Guide Version 1.0 September 24, 2013 Table of Contents Introduction .................................................................................................................................................. 1 Communications ........................................................................................................................................... 1 Connection closed by host/Connection aborted ...................................................................................... 1 Host programs ............................................................................................................................................... 1 File transfer and case inversion on UniVerse............................................................................................ 2 Debug recordings .......................................................................................................................................... 2 Record ....................................................................................................................................................... 2 Documentation ............................................................................................................................................. 4 How do you install the documentation? .................................................................................................. 4 File Transfers ................................................................................................................................................. 5 Missing file transfer options ..................................................................................................................... 5 Problems using Reformat mode ............................................................................................................... 7 Unable to import more than 10mb of data .............................................................................................. 8 Checksum errors ....................................................................................................................................... 9 General Features ........................................................................................................................................... 9 Double quotes ' " ' are converted to “?” when pasted into a wIntegrate session from Microsoft Word 9 Remapping characters that paste as “?” ................................................................................................ 10 Special character <tab> Substitute character ......................................................................................... 10 Installation and Startup .............................................................................................................................. 12 Unable to find the wIntegrate Editor ...................................................................................................... 12 Disabling the startup splash screen ........................................................................................................ 12 Changing the license information ........................................................................................................... 12 Replacing the License information .......................................................................................................... 13 Legal number of users exceeded ............................................................................................................ 14 Keyboard configuration .............................................................................................................................. 14 Changing the break key ........................................................................................................................... 14 VTxxx numeric keys don’t retain new settings ....................................................................................... 15 Query Builder .............................................................................................................................................. 16 Query Builder Hangs ............................................................................................................................... 16 wIntegrate Troubleshooting Guide i September 24, 2013 'Invalid fields' error when using BEFORE or AFTER boxes in Query Builder ........................................... 17 wIntegrate Troubleshooting Guide ii September 24, 2013 Introduction wIntegrate is a connectivity tool which integrates host-based applications with the Windows desktop. The graphical user interface lets you emulate a terminal and customize your workspace environment. wIntegrate lets you share data with other Windows applications including Microsoft Word and Excel. Additionally, it imports and exports data between the PC and server, and from server to server. This Troubleshooting Guide describes problems that have been reported when using wIntegrate and the solutions to those problems. Our intention is that this Guide provides a one-stop reference that you can use to resolve most of the problems you may encounter using wIntegrate. Communications Connection closed by host/Connection aborted wIntegrate uses Windows Sockets to communicate to a server using the Telnet protocol. Windows Sockets manages the connection and notifies wIntegrate when the connection has been closed, but not why or whether the server or the network closed the connection. When the connection to a UNIX server has been closed, wIntegrate displays “Connection closed by host”. When the connection to a Windows server has been closed, wIntegrate displays “Connection aborted”. If you are receiving one of these errors, use the Windows Telnet tool to confirm the problem is not within wIntegrate. Open a Command Prompt window then enter “telnet <your server name> <telnet port>”. If this returns the error, “Could not open connection to the host”, the problem is not within wIntegrate. You can check the server is reachable by entering “ping <your server name>”. Host programs When you install an updated version of wIntegrate it’s always a good idea to install the new host programs that came with it. These will support any new features, and occasionally have performance improvements. We take great care to ensure new versions of the host programs are fully backward compatible with previous versions of the client program. So if you have multiple versions of wIntegrate installed at your site, always install the latest version of the host programs. wIntegrate Troubleshooting Guide 1 September 24, 2013 To install the host programs, select Run | Script from the wIntegrate main menu, then select \Program Files (x86)\wIntegrate\Host\inst_pgm.wis. Complete instructions can be found in the Using wIntegrate manual. File transfer and case inversion on UniVerse By default, a new install of UniVerse inverts the case, so when you think you’re typing “A” the letter “a” appears, and vice versa. This case inversion can corrupt the file transfer and other host-to-PC operations. This can affect the host routine installation. To prevent the case inversion and revert to expected behavior, at the TCL prompt, enter PTERM –CASE NOINVERT. You might consider adding this line to your LOGIN paragraph in the VOC. Debug recordings wIntegrate has powerful debug recording features that are used to capture the two-way conversation between wIntegrate and the server it’s connected to. Generally, you’d send any recordings to your Support personnel or U2 Support for review. Record The basic recording is enabled using the Edit | Record option from the main menu. There are three options that are useful to Support when diagnosing a problem - Raw data, Control codes, and Two-Way. wIntegrate Troubleshooting Guide 2 September 24, 2013 Raw data Records characters sent by the host to the PC, including terminal command sequences. This is essentially an illegible format. It can be replayed (in Edit | Play with the Local option turned on) to reproduce any terminal emulation issues. Control codes Records characters sent by the host to the PC. Data is shown in a legible format analyzing how wIntegrate has interpreted the host characters in relation to the current terminal emulation. Use this option to document a sequence of actions that result in a failure or problem. You can use the recorded file to analyze and resolve problems. For example, if you see obvious escape sequences jumbled together, and/or described as “Text” it probably means that that a sequence has not been recognized as a terminal escape sequence. So some adjustment is needed to the emulation definitions, which are user-definable. Two-Way Records characters sent by the host to the PC and received from the server. Data is shown in a legible format analyzing how wIntegrate has interpreted the host characters in relation to the current terminal emulation. wIntegrate Troubleshooting Guide 3 September 24, 2013 Documentation How do you install the documentation? The wIntegrate Autorun program starts when you insert the wIntegrate CD in the drive. Select Manuals Menu. You can view or install the manuals. Select Install Manual(s). The “Using wIntegrate” manual is the only manual installed with the Default option. Select Custom to install all of the manuals. The Custom Setup dialog is displayed. Select “This feature will be installed on local drive” for each manual you wish to install. wIntegrate