IBM FTP Adapter manual Troubleshooting, Adapter Audit Log

Page 34

Chapter 5 - Troubleshooting

For information about error codes and messages returned by the adapters, see Appendix A - Return Codes and Error Messages.

Various troubleshooting tools are available in case of problems using the FTP adapter for data sources or targets for a map. For example, if you attempt to run a map that uses the FTP adapter and encounter problems or do not receive the expected results, use the following adapter troubleshooting tools:

adapter audit log (.log)

adapter trace file (.mtr)

Adapter Audit Log

The adapter audit log is a text file created during the adapter execution that records information about the events that occurred during the adapter activity. To produce an adapter audit log, use the adapter command (–AUDIT). The default log

name is m4ftp.log and is located in the map directory. See the Trace(-T) adapter command for more information.

The adapter audit log contains information including the:

host identifier

files sent or received

size of each file

elapsed time

retry count for each file

Sample FTP Adapter Audit Log

BEGIN MERCATOR FTP AUDIT

 

 

 

Receiving from Host: localhost

 

 

 

Filename

Filesize

Time

Retry

--------------------------------

----------

----

-----

rollback.gif

183 KBytes

000s

0

END MERCATOR FTP AUDIT

 

 

 

F T P A d a p t e r R e f e r e n c e G u i d e

3 4

Image 34
Contents FTP Adapter Reference Guide Document History Part Product Version Published Number Contents Troubleshooting About This Document Related ReferencesOverview FTP AdapterSystem Requirements Access to International VANs About SocketsCommand Alias IAaliascardnum OAaliascardnumFTP Commands List of CommandsLSsorttype Account -AC or -ACCT Audit -A or -AUDITCertificate Authority -CA Client Certificate Password -CPASSClient Certificate -CERT Code Page Local -CPL Code Page Remote -CPRFirewall Connection Method URL -FW or -FIREWALL Open Site Transparent User Userfw UserfwpassAdapter Behavior when -FIREWALL Command Present Ftpuser, Pass ftppassOpen URL Syntax Userlogon or UserTokens Replaced with FTP URL -URL Ftpext-m1st-02.txt Ignore -I or -IGNORE Keep Server -KSList Option -LS Port Mode -PT or -PORT Passive Mode -PV or -PASVMake Directory -MKD Private Key -PKEY Private Key Password -KPASSQuantity -QTY Site -SITE Number of files to be retrieved by the adapterSSL Protocol -SPROTO SSL Encryption Strength -STRStage -STG or -STAGE System -SYS WIN32Trace -T or -TRACE Syntax Summary Data SourcesData Targets URL Syntax Using FTP Adapter CommandsExamples Syntax Summary URL Syntax URL Encoding Troubleshooting Adapter Audit LogAdapter Trace File Sample FTP Adapter Trace FileTroubleshooting Adapter Trace File Appendix a Return Codes and Error Messages MessagesAppendix a Return Codes and Error Messages Index Index