HP HP NonStop Data Transformation Engine FTP... User manual

HP NonStop Data Transformation Engine
FTP Adapter Reference Guide
Abstract
This manual provides information about using the HP NonStop™ Data Transformation
Engine (NonStop DTE) FTP adapter on the NonStop server.
Product Version
NonStop Data Transformation Engine 6.7.1
Version Updates (RVUs)
N/A
Part Number Published
528264-001 June 2004

FTP Adapter Reference Guide
2
Document History
Part
Number Product Version Published
528264-001 NonStop Data Transformation Engine
6.7.1 June 2004

FTP Adapter Reference Guide
3
Contents
About This Document
Related References........................................................................................... 5
Chapter 1 - FTP Adapter
Overview ....................................................................................................... 6
System Requirements........................................................................................ 6
About Sockets ............................................................................................ 7
Access to International VANs ............................................................................... 7
Chapter 2 - Command Alias
Chapter 3 - FTP Commands
List of Commands............................................................................................. 9
Account (-AC or -ACCT)................................................................................11
Audit (-A or -AUDIT)....................................................................................11
Certificate Authority (-CA)............................................................................12
Client Certificate (-CERT).............................................................................12
Client Certificate Password (-CPASS) ...............................................................12
Code Page Local (-CPL)................................................................................13
Code Page Remote (-CPR).............................................................................13
Firewall Connection Method URL (-FW or -FIREWALL) ...........................................14
Adapter Behavior when -FIREWALL Command Present ..........................................16
URL Syntax...............................................................................................17
FTP URL (-URL)..........................................................................................19
Ignore (-I or -IGNORE)..................................................................................21
Keep Server (-KS).......................................................................................21
List Option (-LS).........................................................................................22
Make Directory (-MKD).................................................................................23
Passive Mode (-PV or -PASV)..........................................................................23
Port Mode (-PT or -PORT) .............................................................................23
Private Key (-PKEY) ....................................................................................24
Private Key Password (-KPASS).......................................................................24
Quantity (-QTY).........................................................................................24
Site (-SITE)...............................................................................................25
SSL Encryption Strength (-STR).......................................................................26
SSL Protocol (-SPROTO)................................................................................26
Stage (-STG or -STAGE)................................................................................26
System (-SYS)............................................................................................27
Trace (-T or -TRACE)...................................................................................28
Chapter 4 - Syntax Summary
Data Sources..................................................................................................29
Data Targets..................................................................................................30
Using FTP Adapter Commands.............................................................................31
Examples.................................................................................................31
URL Syntax....................................................................................................31
URL Encoding.................................................................................................33

Contents
FTP Adapter Reference Guide
4
Chapter 5 - Troubleshooting
Adapter Audit Log ...........................................................................................34
Adapter Trace File...........................................................................................35
Appendix A - Return Codes and Error Messages
Messages.......................................................................................................37
Index

FTP Adapter Reference Guide
5
About This Document
This document contains detailed information about using the FTP Adapter. For
general information regarding using any of the Mercator Resource adapters, see
the Resource Adapters Reference Guide.
This document assumes that the reader knows the Windows environment, has
used the Mercator Design Studio, and understands words such as mapping, type
trees, and other basic Mercator terminology.
Related References
For more information about all products or about topics frequently discussed in
this document, refer to the Mercator Online Library or the SDK Online Library.
Related Reference Description
Resource Adapters Reference Guide Using resource adapters as map sources
and map targets in general. Specific
information for each adapter can be found
in their respective reference guide.

FTP Adapter Reference Guide
6
Chapter 1 - FTP Adapter
This chapter introduces the File Transfer Protocol (FTP) adapter. You can use this
adapter with a Command Server, Event Server, Platform API, or map in a map
rule.
Overview
Use the FTP adapter to transport data. When source data arrives at its target, it
often must be transformed into a different format in order for a receiving
application to use it successfully.
If you have the Command Server, Event Server, or Platform API on one platform,
you can use the FTP adapter to retrieve or send data to another platform.
Note The adapter can connect to any FTP server that complies with RFC 959. To take
full advantage of the adapter’s capabilities, the server should conform to RFC
1123. Those servers that are noncompliant may generate errors in the adapter.
System Requirements
The minimum system requirements and operating system requirements for the
FTP adapter are detailed in the release notes. It is assumed that a Command
Server has already been installed on the computer where the adapter is to be
installed for run-time purposes.
See the Getting Started book for details about the installation program.
In addition, the following are additional requirements for installing and running the
FTP adapter:
♦The FTP adapter must be installed in the same directory as the Command
Server for your specific platform.
♦TCP/IP must be installed on the machine where the adapter is installed.
♦The machine where the FTP adapter is installed must be able to access the
desired FTP servers over a TCP/IP network.

Chapter 1 - FTP Adapter Access to International VANs
FTP Adapter Reference Guide
7
About Sockets
Windows (NT) or BSD (UNIX) Sockets must be installed on the client computer.
♦The Sockets installation must support TCP/IP.
♦The client computer must be able to access an appropriate server. Test this as
follows:
!telnet target-ip 25 (to test a SMTP e-mail target)
!telnet target-ip 110 (to test a POP3 e-mail source)
where target-ip is the server IP address. If the test is successful, you receive a
welcome message from the server. Shut down the session by typing QUIT and
pressing Enter.
Note You might not be able to see what you are typing on the screen.
Access to International VANs
Access to international VANs is available when using the FTP adapter. The FTP
adapter can be used rather than the VAN adapter when communicating with a
Commerce Manager post office. For detailed configuration information, see the
Partner Manager Reference Guide.

FTP Adapter Reference Guide
8
Chapter 2 - Command Alias
Specify adapter commands by using a command string on the command line or by
creating a command file that contains adapter commands. The command syntax
is:
-IA[alias]card_num
-OA[alias]card_num
In the command syntax, -IA is the Input Source Override execution command
and -OA is the Output Target Override execution command, alias is the adapter
alias, and card_num is the number of the map card. The FTP adapter alias and
corresponding execution commands are listed below.
Adapter Alias As Input As Output
FTP FTP -IAFTPcard_num -OAFTPcard_num

FTP Adapter Reference Guide
9
Chapter 3 - FTP Commands
This chapter describes the functions and use of the FTP commands and their
options.
List of Commands
The following table lists valid commands for the FTP adapter, the command
syntax, and whether the command is supported (√) for use with data sources,
targets, or both.
Name Syntax Source Target
Account -ACCT account_id √√
Audit -AUDIT[+][S][full_path]√√
Certificate Authority -CA filename
Note Only available if Security Option is
installed.
√√
Client Certificate -CERT filename
Note Only available if Security Option is
installed.
√√
Client Certificate
Password -CPASS password
Note Only available if Security Option is
installed.
√√
Code Page Local
(OS/390, z/OS only)-CPL code_page_name √√
Code Page Remote
(OS/390, z/OS only)-CPR code_page_name √√
Firewall Connection
Method URL -FIREWALL FTP://firewall_URL √√
FTP URL -URL FTP://ftp_URL √√
Ignore -IGNORE error_code[:error_code…] √√

Chapter 3 - FTP Commands List of Commands
FTP Adapter Reference Guide
10
Name Syntax Source Target
Keep Server -KS √√
List Option -LS sort_type √√
Make Directory -MKD √√
Passive Mode -PASV √√
Port Mode -PORT √√
Private Key -PKEY filename
Note Only available if Security Option is
installed.
√√
Private Key Password -KPASS password
Note Only available if Security Option is
installed.
√√
Quantity -QTY number √
Site -SITE command_text √√
SSL Encryption
Strength -STR {WEAK|STRONG|ANY}
Note Only available if Security Option is
installed.
√ √
SSL Protocol -SPROTO
{SSLv2|SSLv3|SSLv23|TLSv1}
Note Only available if Security Option is
installed.
√√
Stage -STAGE [file_name] √
System -SYS {WIN32|UNIX|UNKNOWN} √√
Trace -TRACE[+][S|V] [full_path] √√