IBM FTP Adapter manual Syntax Summary URL Syntax

Page 32

Chapter 4 - Syntax Summary

URL Syntax

an at sign (@). Within the user and password field, any :, @, or / characters must be encoded. See URL Encoding.

The url_path of an FTP URL has the following syntax:

cwd1/cwd2/.../cwdN/name;type= xfer_type

where cwd1 through cwdN and name are (possibly encoded) strings and

xfer_type is one of the characters a, i, or d. The part ;type= xfer_type may be omitted. The cwdx and name parts may be empty. The whole url_path may be omitted, including the /, delimiting it from the prefix containing user, password, host, and port.

The url_path is interpreted as a series of FTP commands as follows:

Each cwd element is to be sequentially supplied as the argument to a CWD (change working directory) command.

If the typecode is “d”, perform a NLST (name list) command with name as the argument and interpret the results as a file directory listing.

Otherwise, perform a TYPE command with xfer_type as the argument and then access the file named name (for example, using the RETR command).

Note The xfer_type argument has been extended beyond what is supported by the RFC, specifically the D1, D2, D3, and D4 sections. Also, host:port may be excluded, although it is rarely useful to do so; host defaults to localhost.

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 2

Image 32
Contents FTP Adapter Reference Guide Document History Part Product Version Published Number Contents Troubleshooting About This Document Related ReferencesSystem Requirements FTP AdapterOverview Access to International VANs About SocketsCommand Alias IAaliascardnum OAaliascardnumFTP Commands List of CommandsLSsorttype Account -AC or -ACCT Audit -A or -AUDITClient Certificate -CERT Client Certificate Password -CPASSCertificate Authority -CA 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 Make Directory -MKD Passive Mode -PV or -PASVPort Mode -PT or -PORT Quantity -QTY Private Key Password -KPASSPrivate Key -PKEY Site -SITE Number of files to be retrieved by the adapterStage -STG or -STAGE SSL Encryption Strength -STRSSL Protocol -SPROTO System -SYS WIN32Trace -T or -TRACE Syntax Summary Data SourcesData Targets Examples Using FTP Adapter CommandsURL Syntax 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