Product Guide - Docs.attachmate

INFOConnect Enterprise Edition Product GuideComponentDescriptionUtilitiesExport/Import utility: exports data from an INFOConnectdatabase (IC32.cfg) into an .ini or .csv file, as well asimports data from an .ini or .csv file into an INFOConnectdatabase. For more information, open ExpImp32.hlp in theInfocnee\Enu folder.Copy ICS Database utility: creates a copy of anINFOConnect database that is identical to the originaldatabase except for the location name of the executablefiles. For more information, open Copics32.hlp in theInfocnee\Enu folder.Attachmate Version utility (Atmver.exe): creates a file thatdisplays the version numbers of all INFOConnect productsthat are installed.Getdid.exe: increases the number of sessions allowed bythe transports.Testgms.exe: for more information, contact TechnicalSupport.4

Attachmate INFOConnect OverviewProduct FeaturesThe feature groups that are available for the INFOConnect products during installationare described in the following sections. INFOConnect Enterprise Edition for Unisys INFOConnect Enterprise Edition for Airlines INFOConnect Stand-alone Print and Transaction Router (PTR)See the INFOConnect Airlines Gateway Product Guide for information on INFOConnectAirlines Gateway.INFOConnect Enterprise Edition for UnisysThe feature groups for INFOConnect Enterprise Edition for Unisys are described in thefollowing tables. Unisys Transports and Options INFOConnect Options Pack FTP ClientThe feature groups for INFOConnect Enterprise Edition for Unisys, IBM and OpenSystems are described in the following tables. Unisys Transports and Options INFOConnect Options Pack FTP Client EXTRA! for Accessory Manager5

INFOConnect Enterprise Edition Product GuideUnisys Transports and Options6FeatureDescriptionTCPAProvides access to hosts using the TCP/IP networkprotocol.HLCNProvides NET BIOS connectivity to Unisys A-Series hosts.INT1Provides access to Unisys 1100/1200 hosts using theTCP/IP network protocol.PEPGate32 LANWorkstationProvides access to Unisys 1100/1200 and System 80 hostsusing IPX via a separate communication server.MATIPProvides access to Unisys hosts using the MATIP networkprotocol.TCP PEPGate32 LANWorkstationProvides access to Unisys 1100/1200 and System 80 hostsusing TCP/IP via a separate communication server.FileXpress-XST ClientEnables PCs to connect directly through the XST port andtransfer files with a Unisys ClearPath NX/LX series or ASeries mainframe. Requires the host component.Response TimeMonitor UtilityDisplays information about communication between oneor more PCs running INFOConnect Accessory Managerand a host. You can use this information to identifyproblems with either your network performance or yourhost.CryptoConnect ClientETSManages FIPS-140-1 certified encryption between 32-bitINFOConnect UTS or T27 emulators and theCryptoConnect gateway. Resides on a separate PC fromthe gateway and encrypts and decrypts communicationbetween the client and the gateway.WinFTPTransfers files between your PC and any host such as aUnisys ClearPath IX, 2200 Series host, or a UNIX hostrunning FTP server software. The PC must communicatewith the host via a WinSock-compatible TCP/IP network.CCFProvides CCF protocol over WinSock for migratingNX/View products.

Attachmate INFOConnect OverviewINFOConnect Options PackFeatureDescriptionGraphX32Enables PCs using Microsoft Windows and INFOConnectConnectivity Services to emulate the graphics capability ofthe UTS60 terminal by interpreting the UTS60 graphicsprotocol commands as they are received across anINFOConnect path.INFOConnectAutomationDevelopment KitDevelop Windows applications that interact withAttacmate terminal emulators. For more information, seethe INFOConnect HLLAPI Programmer’s Reference.INFOConnectDataXpressEnables PCs to transfer files to and from Unisys ClearPathIX or 2200 Series mainframes.FileXpress–XST APIFor Unisys Libra systems only. Integrates FileXpress–XSTfunctions into custom applications. For more information,see the FileXpress–XST API Programmer’s Reference.INFOConnectConnectivity ServicesDevelopment Kit(IDK)Develop applications and components that use theINFOConnect Connectivity Service (ICS). For moreinformation, see the INFOConnect Development Kit BasicProgramming Reference Manual.INFOConnect OLECustom ControlDevelop Windows applications that use INFOConnectpaths. For more information, see the INFOConnect OCXProgrammer’s Reference.FTP ClientFeatureDescriptionUtilitiesReflection software utilities that provide reliable filetransfers with any file server and secure options for userswith those requirements.Kerberos ManagerManages and configures the Reflection Kerberos client.Key AgentHolds multiple private keys that can be used in a SecureShell (SSH) connection for public key authentication. Alsoenables agent forwarding for a SSH connection.7

INFOConnect Enterprise Edition Product GuideEXTRA! for Accessory ManagerFeatureDescriptionEXTRA! for AccessoryManagerA suite of terminal emulators (3270, 5250, and VT) andconnection tools that enables PCs communicate with IBMmainframes, AS/400s, and UNIX\Open VMS hosts.EXTRA! for Accessory Manager is a stand-aloneapplication that you can run by itself; or you can createand open EXTRA! sessions within Accessory Manager. Touse EXTRA! sessions within Accessory Manager, you mustkeep both applications installed.INFOConnect Enterprise Edition for AirlinesThe feature groups for INFOConnect Enterprise Edition for Airlines are described in thefollowing tables. Airline Transports and Options INFOConnect Options Pack FTP ClientThe feature groups for INFOConnect Enterprise Edition for Airlines, IBM and OpenSystems are described in the following tables. Airline Transports and Options INFOConnect Options Pack FTP Client EXTRA! for Accessory ManagerAirline Transports and Options8FeatureDescriptionINT1Provides access to Unisys 1100/1200 hosts using theTCP/IP network protocol.PEPGate32 LANWorkstationProvides access to Unisys 1100/1200 and System 80 hostsusing IPX via a separate communication server.MATIP for ALCProvides access to airline hosts using the MATIP networkprotocol.MATIP for UTSProvides access to Unisys hosts using the MATIP networkprotocol.ATSTCPProvides access to the Galileo Apollo GDS.UPDFRADEnables PCs to communicate with a SHARES host viaUDP.

Attachmate INFOConnect OverviewFeatureDescriptionSabreProvides hi-speed access to the Sabre GDS.TCP PEPGate32 LANWorkstationProvides access to Unisys 1100/1200 and System 80 hostsusing TCP/IP via a separate communication server.CryptoConnect ClientETSManages FIPS-140-1 certified encryption betweenINFOConnect UTS or T27 emulators and theCryptoConnect gateway. Resides on a separate PC fromthe gateway and encrypts and decrypts communicationbetween the client and the gateway.Airlines GatewayProvides access to the INFOConnect Airlines Gatewaytransport.INFOConnect Options PackFeatureDescriptionGraphX32Enables PCs using Microsoft Windows and INFOConnectConnectivity Services to emulate the graphics capability ofthe UTS60 terminal by interpreting the UTS60 graphicsprotocol commands as they are received across anINFOConnect path.INFOConnectAutomationDevelopment KitDevelop Windows applications that interact withAttacmate terminal emulators. For more information, seethe INFOConnect HLLAPI Programmer’s Reference.INFOConnectDataXpressEnables PCs to transfer files to and from a UnisysClearPath IX or 2200 Series mainframe.INFOConnectConnectivity ServicesDevelopment Kit(IDK)Develop applications and components that use theINFOConnect Connectivity Service (ICS). For moreinformation, see the INFOConnect Development Kit BasicProgramming Reference Manual.INFOConnect OLECustom ControlDevelop Windows applications that use INFOConnectpaths. For more information, see the INFOConnect OCXProgrammer’s Reference.9

INFOConnect Enterprise Edition Product GuideFTP ClientFeatureDescriptionUtilitiesReflection software utilities that provide reliable filetransfers with any file server and secure options for userswith those requirements.Kerberos ManagerManages and configures the Reflection Kerberos client.Key AgentHolds multiple private keys that can be used in a SecureShell (SSH) connection for public key authentication. Alsoenables agent forwarding for a SSH connection.EXTRA! for Accessory Manager10FeatureDescriptionEXTRA! for AccessoryManagerA suite of terminal emulators (3270, 5250, and VT) andconnection tools that let your PCs communicate with IBMmainframes, AS/400s, and UNIX\Open VMS hosts.EXTRA! for Accessory Manager is a stand-aloneapplication that you can run by itself; or you can createand open EXTRA! sessions within Accessory Manager. Touse EXTRA! sessions within Accessory Manager, you mustkeep both applications installed.

Attachmate INFOConnect OverviewINFOConnect Stand-alone Print and Transaction RouterThe transports for INFOConnect Stand-alone Print and Transaction Routerare described in the following table.FeatureDescriptionINT1Provides access to Unisys 1100/1200 hosts using theTCP/IP network protocol.MATIP for ALCProvides access to airline hosts using the MATIP networkprotocol.MATIP for UTSProvides access to Unisys hosts using the MATIP networkprotocol.ATSTCPProvides access to the Galileo Apollo GDS.PEPGate ClientProvides access to Unisys 1100/1200 and System 80 hostsvia a PEPGate gateway.UPDFRADEnables PCs to communicate with a SHARES host viaUDP.Sabre IPProvides hi-speed access to the Sabre GDS.Airlines GatewayProvides access to the INFOConnect Airlines Gatewaytransport.System RequirementsFor production environments, many users install the various INFOConnect componentson separate computers. Specific requirements will vary based on which components areinstalled, and on other hardware and software components present.Note: Attachmate cannot confirm the accuracy of performance, or any other claimsrelated to non-Attachmate products. For questions or concerns regarding the capabilitiesof non-Attachmate products, please contact the suppliers of those products.INFOConnect meets the requirements for Windows Vista certification. Follow theMicrosoft guidelines for Windows Vista platform requirements.11

INFOConnect Enterprise Edition Product GuideThe minimum system requirements are covered in the following table.System ComponentDescriptionOperating SystemWindows Vista SP1 or greaterWindows XP Professional SP2 or greaterWindows 2000 Professional with SP4Windows NT Workstation 4.0 with SP6aTerminal Server with Windows 2000 Server, WindowsServer 2003, or Windows NT Server 4.0 (SP6a)Citrix MetaFrame with Windows 2000 Server or WindowsServer 2003ProcessorIntel single processor (or equivalent)Intel multiple processor (or equivalent)RAM256 MBUsing INFOConnect for multiple users may require: Windows 2000 Server (latest SP) Windows Terminal Services Windows Server 2003 Windows Terminal Services Citrix MetaFrame XP Presentation Server, Feature Release 2 or laterAPIs and Development KitsThe APIs and development kits that are available for purchase with INFOConnect aredocumented in the online manuals that can be found in the Pdf docs infoconnectdirectory.Online Manuals and Guides12TitleFilename/DescriptionINFOConnect CASLScript Language GuideCasl lang ref.pdfDocuments the Common Accessory Script Language(CASL), which is used to create macros that interact withhosts, users, and other macros.INFOConnectDevelopment Kit BasicProgramming ReferenceManualIdk basic prog ref.pdfProvides detailed information about the INFOConnectConnectivity Services (ICS) programming interface,messages, and data types available for ICS Accessorydevelopment and for the development of additional datafilters (Service Libraries) and connection types (ExternalInterface Libraries).INFOConnectDevelopment Kit BasicDeveloper’s GuideIdk basic dev gd.pdfExplains how to install and use the INFOConnectDevelopment Kit.

Attachmate INFOConnect OverviewTitleFilename/DescriptionINFOConnect HLLAPIProgrammer’s ReferenceIhllapi prog ref.pdfExplains how to use HLLAPI to write Windowsapplications that interact with Attachmate terminalemulators and therefore with host applications.INFOConnect OCXProgrammer’s ReferenceOcx prog ref.pdfExplains how to use the OLE Custom Control to writeWindows applications that use INFOConnect paths.FileXpress XST–APIProgrammer’s ReferenceFilexpress api prog ref.pdfExplains how to integrate FileXpress–XST functions intocustom applications.PTR User APIProgrammer’s ReferencePtr uapi prog ref.pdfProvides details on creating applications to print vouchersand other specialized tickets from PCs by sending datadirectly to a printer.PTR OLE APIProgrammer’s ReferencePtr oleapi prog ref.pdfProvides details about creating an application thatmonitors PTR routes.PTR API Programmer’sReferencePtr api prog ref.pdfProvides details about using the PTR Development Kit todesign a custom host filter.About This Product Guide and Online HelpInformation about INFOConnect is available through this product guide and thecomponent Help systems.INFOConnect EnterpriseEdition Product GuideThis guide provides an overall description of INFOConnect,its components, and the solutions you can create with it.Component HelpSystemsGeneral help and context sensitive help is available. TheHelp systems use WinHlp32.exe, which is not included withWindows Vista. To open INFOConnect help on Vista, seeAttachmate Technical Note tml).Technical Note 2294 also contains information on resolvingthe following error message that may appear whenaccessing Help on Vista Windows: There was a problemrunning the macro.(1037).13

Installation Overview and ConsiderationsThe INFOConnect installers are certified on Windows Vista and use standard MSI-baseddeployment technologies. An MSI installation either happens in its entirety or nothing isinstalled. MSI packages and files also provide a standard way for users to customize theinstaller.The INFOConnect installers were built using the Windows Installer XML (WIX) opensource toolkit. The WIX toolkit stores the installer source as XML and allows for standardtools to be used for editing and deployment.About the Attachmate Installer ProgramThe user interface for the INFOConnect installers is the standard Attachmate InstallerProgram — setup.exe.The Attachmate Installer Program provides a standard interface and includes theAttachmate Customization Tool that can be used to customize the installation packageusing transform (.mst) files. The Attachmate Customization Tool is a completereplacement for the Custom Installation wizard, which was used in previousINFOConnect releases to create customized installation images.The installer and INFOConnect are digitally signed and the deliverables are stored asexternal CAB files. The installer provides for the ability to advertise, publish, and installon demand. INFOConnect also supports the Add/Remove program, including supportfor a complete uninstall.The use of patch (.msp) files, using standard MSI mechanisms, is supported with theability to install a patch with a basic or no user interface along with the ability to uninstallpatches.INFOConnect evaluation software can be converted to a full working version byinstalling the purchased product, which will upgrade the evaluation software.NT4.0 InstallationsThe Attachmate Customization Tool cannot be used on Windows NT4 since the installerrequires a later version of the MSI service than is available on NT4. It is recommendedthat you perform an Administrative install on a Windows 2000 or later machine andcustomize the product there. There is a minimal UI defined in the .msi files for NT4products that can be accessed when you open them. INFOConnect Airlines Gateway 3.0and INFOConnect Stand-alone PTR 9.0 do not install on NT4. However, PTR withAccessory Manager is available on NT4.15

INFOConnect Enterprise Edition Product GuideUser and Application Data LocationsUser data includes files such as macros, schemes, and sessions. Application data includestrace logs and global configuration files such as IC32.cfg and InsMgr32.cfg. With theAttachmate Installation Program you can customize the locations for the user data andthe application data. Because of Microsoft logo certification requirements, applicationdata should not be stored under the Program Files directory.Under Windows Vista, the Users\Username\Documents directory is equivalent to theMy Documents directory and the Users\Public\Documents directory is equivalent tothe All Users\Documents directory.User Data LocationsSelect this directoryTo install products so thatMy DocumentsEach user has separate user data, including sessions,color schemes, layouts, and the like, and each user maychange, create, and delete them without restriction.All Users\DocumentsAll users share a single set of sessions and other userdata, and all users can add, modify, and delete sessions.All Users\Documents is not available under WindowsNT.User Defined DirectoryUsers can to choose where to install the user data files.The user data files location are changed to install toC:\Documents and Settings\ userid\MyUserFiles.When the installation is complete, a registry keyHKLM\SOFTWARE\Attachmate\ AccessoryManager\CustomUserDocumentsPath USERDATALOC CUSTOM PATH contains this path. When theproduct is run for the first time, it replaces userid in thisstring with the current logged in user’s ID, creates theuser data location, and copies files to that location.Application Data Locations16Select this directoryTo install products so thatMy DocumentsEach user has a separate database with separatelyconfigurable paths, and each user may change, create,and delete them without restriction. Sometransports/options don’t support using the MyDocuments directory location.All Users\DocumentsAll users share a single database with all sessions andpaths, and all users can add, modify, and delete paths. Ifthe end users are “restricted users” under Windows, theywill be unable to edit, add, or delete anything from thedatabase. If they are administrators, they can modify,add, and delete without restrictions. All Users\Documents is not available under Windows NT.

Installation Overview and ConsiderationsIf two or more users share the same PC, the administrator can allow users to create ormodify their own INFOConnect paths or restrict users by creating or modifying the pathsfor them.Single Users and Multiple UsersThe installer correctly handles multiple users per machine and roaming profiles. It alsofollows Vista user account control (UAC) requirements when storing settings files.Typically, the My Documents directory option is selected for user data duringcustomization and each us

Delivers access to Unisys A-Series mainframes (T27 emulators) and Unisys 2200 mainframes (UTS emulators). † INFOConnect Enterprise Edition for Unisys, IBM, and Open Systems 9.0 Delivers access to Unisys A-Series mainframes (T27 emulators), Unisys 2200 mainframes (UTS emulators), IBM mainframes (3270 emulators), IBM AS/400s (5250