IBM manual Using FTP Adapter Commands, URL Syntax, Examples

Page 31

Chapter 4 - Syntax Summary

Using FTP Adapter Commands

Using FTP Adapter Commands

Use the adapter commands from the Map Designer or Integration Flow Designer as the data source of an input map card and as the data target for an output map card. You can also use the adapter on the command line or in a map rule using the functions GET, PUT, or RUN.

The FTP adapter requires the -URLadapter command for the

GET > Source > Command and PUT > Target > Command settings.

See Chapter 3 - FTP Commands for more information on FTP adapter commands and their syntax. For general information about commands, refer to the Resource Adapters Reference Guide.

Examples

To retrieve the file mine.txt, located on the host computer (no port specified) under c:\forms with no user name or password specified, enter the following command:

-URL FTP://host/c:/forms/mine.txt

The command example would retrieve the entire contents of the forms directory (because the file name is omitted) from the host computer:

-URL FTP://host/c:/forms/

URL Syntax

The syntax for the rest of the URL varies depending on the scheme selected. URL schemes that involve the direct use of an IP-based protocol for a specified host on the Internet use the following common syntax for scheme-specific data:

//user:password@host:port/url_path

Some or all parts of user:password@, :password, :port, and /url_path may

be excluded. The scheme-specific data start with a double slash (//) to indicate that it complies with the common Internet scheme syntax. The user:password component conforms to the following rules:

user An optional user name. Some schemes allow the specification of a user name.

password An optional password. When present, it follows the user name and is separated by a colon. The user name and password are followed by

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 1

Page 30 Page 32
Image 31
Page 30 Page 32
Contents FTP Adapter Reference Guide Document History Part Product Version Published Number Contents Troubleshooting Related References About This DocumentOverview FTP AdapterSystem Requirements About Sockets Access to International VANsIAaliascardnum OAaliascardnum Command AliasList of Commands FTP CommandsLSsorttype Audit -A or -AUDIT Account -AC or -ACCTCertificate Authority -CA Client Certificate Password -CPASSClient Certificate -CERT Code Page Remote -CPR Code Page Local -CPLOpen Site Transparent User Userfw Userfwpass Firewall Connection Method URL -FW or -FIREWALLFtpuser, Pass ftppass Adapter Behavior when -FIREWALL Command PresentOpen Userlogon or User URL SyntaxTokens Replaced with FTP URL -URL Ftpext-m1st-02.txt Keep Server -KS Ignore -I or -IGNOREList Option -LS Port Mode -PT or -PORT Passive Mode -PV or -PASVMake Directory -MKD Private Key -PKEY Private Key Password -KPASSQuantity -QTY Number of files to be retrieved by the adapter Site -SITESSL Protocol -SPROTO SSL Encryption Strength -STRStage -STG or -STAGE WIN32 System -SYSTrace -T or -TRACE Data Sources Syntax SummaryData Targets URL Syntax Using FTP Adapter CommandsExamples Syntax Summary URL Syntax URL Encoding Adapter Audit Log TroubleshootingSample FTP Adapter Trace File Adapter Trace FileTroubleshooting Adapter Trace File Messages Appendix a Return Codes and Error MessagesAppendix a Return Codes and Error Messages Index Index
Top Page Image Contents