HP HP NonStop Data Transformation Engine FTP... Bedienungsanleitung

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

Document History

Part

Number Product Version Published

528264-001 NonStop Data Transformation Engine

6.7.1 June 2004

FTP Adapter Reference Guide

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

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

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

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

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

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

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

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] √√

Dieses Handbuch passt für folgende Modelle

Inhaltsverzeichnis

Andere HP Software Handbücher

HP BL680c - ProLiant - G5 Bedienungsanleitung

HP BL680c - ProLiant - G5 Referenzhandbuch

HP Compaq dc7900 Business PC Bedienungsanleitung

HP 407484-B21 - ProLiant Essentials Accelerated... Referenzhandbuch

HP ProLiant SL160s Bedienungsanleitung

HP Color LaserJet CP3505 Series Gebrauchs- und Pflegehandbuch

HP HP Integrated Lights-Out Bedienungsanleitung

HP Neoview Messages Bedienungsanleitung

HP BB118BV - StorageWorks Data Protector Express... Betriebsanleitung

HP C7791C - DesignJet 130 Color Inkjet Printer Konfigurationshandbuch

HP BB118BV - StorageWorks Data Protector Express... Bedienungsanleitung

HP Neoview SQL Bedienungsanleitung

HP CN088A - Serif PosterDesigner Pro Bedienungsanleitung

HP StorageWorks 1000 - Modular Smart Array Bedienungsanleitung

HP CN088A - Serif PosterDesigner Pro Betriebsanleitung

HP NAS 1200s Bedienungsanleitung

HP 455031-L22 - Intel Quad-Core Xeon 2.13 GHz Processor... Bedienungsanleitung

HP StorageWorks 2/32 - SAN Switch Bedienungsanleitung

HP NetServer AA 6200 Service-Handbuch

HP Designjet T1300 Bedienungsanleitung

HP INSIGHT DYNAMICS T8671-91017 Bedienungsanleitung

HP NonStop TMF Betriebsanleitung

HP Brocade BladeSystem 4/12 Bedienungsanleitung

HP Integrity Superdome 2 Bedienungsanleitung

Beliebte Software Handbücher anderer Marken

COMPRO

COMPRO COMPROFM Bedienungsanleitung

Muratec

Muratec OFFICEBRIDGE ONLINE Bedienungsanleitung

Oracle

Oracle Contact Center Anywhere 8.1 Bedienungsanleitung

Adobe

Adobe 65007312 - Photoshop Lightroom Handbuch

Avaya

Avaya NULL One-X for RIM Blackberry Bedienungsanleitung

PS Audio

PS Audio PowerPlay Betriebsanleitung

Brady

Brady LOCKOUT PRO 3.0 Service-Handbuch

Avaya

Avaya Interaction Center Bedienungsanleitung

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Handbuch

Novell

Novell GROUPWISE 8 - INTERNET AGENT Bedienungsanleitung

Oracle

Oracle Application 9i Bedienungsanleitung

Acer

Acer RDM Bedienungsanleitung

Canon

Canon Vixia HF21 Bedienungsanleitung

Canon

Canon ZR950 Bedienungsanleitung

Samsung

Samsung Auto Backup Bedienungsanleitung

Polycom

Polycom Vortex EF2201 Montage- und Bedienungsanleitung

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c Bedienungsanleitung

Novell

Novell SP2 - S Bedienungsanleitung