Tivoli Data Exchange Version 1.2.0 User’s Guide Copyright 2001, Tivoli, Inc. All rights reserved. Tivoli Data Exchange, Tivoli, and the Tivoli logo are registered trademarks or trademarks of Tivoli, Inc. AS/400, AIX, MQSeries, and OS/390 are registered trademarks of IBM Corp. InstallShield is a registered trademark of InstallShield Software Corporation. Windows NT is a registered trademark of Microsoft Corp. UNIX is a registered trademark of The Open Group. Solaris and Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. All other trademarks are property of their respective owners. Contents chapter 1 About This Guide. 11 AboutTivoliDataExchange ...................................11 WhoShouldReadThisGuide..................................13 HowThisGuideIsOrganized..................................14 ContactingCustomerSupport ..................................15 WheretoLookforMoreInformation ............................15 Conventions................................................16 chapter 2 Tivoli Data Exchange Concepts. .17 TivoliDataExchangeIntroduction ..............................17 WhyTivoliDataExchange? ...................................17 TivoliDataExchangeArchitecturalOverview .....................19 Tivoli Data Exchange Interfaces . 20 TivoliDataExchangeManager .............................21 TivoliDataExchangeSender...............................22 Tivoli Data Exchange Receiver . 22 TivoliDataExchangeStatus................................22 chapter 3 Tivoli Data Exchange Use and Customization ..25 25 TivoliDataExchangeComponents..............................26 TheTivoliDataExchangeManager..........................26 TheTivoliDataExchangeSender ...........................29 The Tivoli Data Exchange Receiver . 29 StartingTivoliDataExchange..................................30 StartingTivoliDataExchangeonOS/390Systems..............31 StartingTivoliDataExchangeonWindowsNT.................32 StartingTivoliDataExchangeonAS/400 .....................34 StartingTivoliDataExchangeinUNIXandOS/2...............37 StartingComponentsIndividually ...........................37 Getting Status Information from Tivoli Data Exchange Components . 41 The Tivoli Data Exchange Manager and the Status Subsystem . 41 Tivoli Data Exchange Sender and the Status Subsystem . 43 Tivoli Data Exchange Receiver and the Status Subsystem . 44 ShuttingDownTivoliDataExchangeComponents .................45 UsingtheFTFENDCommand..............................45 UsingFTFSTARTAddressSpaceCommands..................47 Security....................................................49 Tivoli Data Exchange User’s Guide iii UsingtheOptionsFile........................................ 49 TypicalData-TransferScenarios................................ 51 chapter 4 Tivoli Data Exchange Status Offload Daemon . ..5555 Overview.................................................. 56 StartingtheStatusOffloadComponent........................... 58 Starting the FTFStatD Component from the NT Service . 58 Configuration File and Command Line Definitions . 58 Defining the Configuration File for Status Offload . 59 DefiningtheCommandLineforStatusOffload ................ 60 Defining the Command Line for Retrieval from the Sample Relational Database............................................. 62 RecommendedDatabaseSchema............................... 62 chapter 5 Tivoli Data Exchange User Exits . 65 Exploiting User Exit Facilities in Tivoli Data Exchange . 66 TivoliDataExchangeUserExitOverview........................ 68 ManagerPre-ProcessExit ................................. 69 ManagerPost-ProcessExit................................. 71 SenderPre-ProcessExit................................... 74 SenderPost-ProcessExit.................................. 76 Receiver Pre-Process Exit . 78 Receiver Post-Process Exit . 80 ReportingStatusInformationfromExitModules................... 82 Customizing and Implementing Tivoli Data Exchange Exits . 83 SampleExits............................................ 84 CompilingandGeneratingDLLs............................ 85 MakingExitsAvailable ................................... 88 chapter 6Security Authorization Exits . ..9191 CustomizingtheAuthorizationModule .......................... 92 UsingAuthorizationModuleDataStructures .................. 92 AuthorizationModuleReturnCodes......................... 93 Installing the Security Authorization Exit . 94 UsingFTFSTARTonOS/390 .............................. 95 RestartingtheTivoliDataExchangeService................... 96 RestartingComponentsIndividually......................... 97 InterfaceforCustomization.................................... 98 SecurityAuthorizationExitReference.......................... 100 iv Tivoli Data Exchange User’s Guide chapter 7Working with AS/400 Files . 103 Overview .................................................104 Modifying the Tivoli Data Exchange Configuration File . 105 UsingtheFTFCommand.....................................106 SendingAS/400PhysicalorLogicalFileData ................107 Examples .................................................109 SendingtoaFixed-LengthTextFile.........................110 SendingtoaDelimitedTextFile ...........................111 SendingfromaFixed-LengthTextFile ......................112 SendingfromaDelimitedTextFile.........................114 SendingAS/400PhysicalFiles.............................115 SendingAS/400LogicalFiles .............................117 Determining the Transfer’s Success . 118 AS/400SenderStatusErrors...............................119 AS/400 Receiver Status Errors . 121 chapter 8Using the ISPF User Interface . 125 ISPFPanelStructure ........................................126 Accessing the ISPF Panels . 127 RequestingaDataTransfer ...................................128 EnteringTransferOptions.................................131 EnteringApplicationIntegrationOptions.....................137 SettingStageOptions ....................................140 SettingReply/NotifyOptions..............................142 SettingMVS/ESA(OS/390)AllocationOptions...............144 SettingAS/400FileOptions...............................147 SettingConnectorSoftwareOptions.........................149 StagingData-TransferRequests................................152 ViewingStatusInformation...................................154 LogInformationDisplay..................................158 SummaryInformationDisplays ............................158 Cancelling a Data-Transfer Request . 159 PingingTivoliDataExchangeComponents ......................161 ShuttingDownTivoliDataExchangeComponents ................164 ExitingtheISPFPanels......................................165 chapter 9Using the 5250 User Interface . 167 Accessing the 5250 Interface Commands . 168 TivoliDataExchangeRequest.................................172 TivoliDataExchangeRequestParameters–Group1 ...........173 TivoliDataExchangeRequestParameters–Group2 ...........175 Tivoli Data Exchange User’s Guide v Tivoli Data Exchange Request Parameters – Group 3 . 177 Tivoli Data Exchange Request Parameters – Group 4 . 180 Tivoli Data Exchange Request Parameters – Group 5 . 185 Tivoli Data Exchange Request Parameters – Group 6 . 187 Tivoli Data Exchange Request Parameters – Group 7 . 189 Tivoli Data Exchange Request Parameters – Group 8 . 190 Tivoli Data Exchange Request Parameters – Group 9 . 191 Tivoli Data Exchange Request Parameters – Group 10 . 192 Tivoli Data Exchange Request Parameters – Group 11 . 193 Tivoli Data Exchange Request Parameters – Group 12 . 194 TivoliDataExchangePing ................................... 195 TivoliDataExchangePingParameters–Group2.............. 197 TivoliDataExchangeCancel ................................. 198 CancelTivoliDataExchangeRequest–Group1 .............. 198 TivoliDataExchangeCancelParameters–Group2............ 200 TivoliDataExchangeStatus.................................. 201 TivoliDataExchangeStatusParameters–Group1 ............ 201 TivoliDataExchangeStatus–Group2...................... 203 TivoliDataExchangeStatusParameters–Group3 ............ 205 TivoliDataExchangeEnd.................................... 206 TivoliDataExchangeStage .................................. 209 Tivoli Data Exchange Stage Parameters – Group 1 . 209 TivoliDataExchangeStage–Group2 .......................211 TivoliDataExchangeConfiguration............................ 212 TivoliDataExchangeConfig–Group1 ..................... 212 TivoliDataExchangeConfig–Group2 ..................... 213 StartingaTivoliDataExchangeManager........................ 214 StartTivoliDataExchangeManager–Group2 ............... 216 StartingaTivoliDataExchangeSender......................... 217 StartTivoliDataExchangeSender–Group2 ................. 219 StartTivoliDataExchangeSender–Group3 ................. 220 Starting a Tivoli Data Exchange Receiver . 221 Start Tivoli Data Exchange Receiver – Group 2 . 223 Start Tivoli Data Exchange Receiver – Group 3 . 224 StartingtheTivoliDataExchangeLogger ....................... 225 TivoliDataExchangeLogger–Group1 ..................... 225 TivoliDataExchangeLogger–Group2 ..................... 226 LoggingoffTivoliDataExchange ............................. 227 chapter 10Using the Tivoli Data Exchange GUI . ..229229 StartingtheTivoliDataExchangeGUI.......................... 230 ViewingData-TransferStatusInformation....................... 231 FilteringStatusInformation............................... 231 vi Tivoli Data Exchange User’s Guide ViewingStatusInformation ...............................235