Data Transformation Engine Services Guide

Chapter 6 – Service Usage Scenarios

Client Requests to Execute a Map and Receive Output

Data

In this scenario, the CORBA Client makes a request to the CORBA Server. The CORBA Server

executes a map, transforms the input data according to the map input settings, and returns the

transformed data back to the client as a response.

The CORBA request contains the name of the compiled map file. The CORBA Transformation Server

invokes the RunMap function of the Platform API and executes the specified map. The DTE reads the

input data according to the map input settings, transforms the data, and sends back the transformed data

as a response message.

The following line shows the command at the prompt to run the CORBA Client (dteorbclnt):

The first argument ContactToLabel.nsk is the name of the compiled map to be executed. The second

argument must be an empty string (“”). The last argument

1 indicates that the output card #1 shall be

overridden and the transformed data shall be sent back to the client.

In the NonStop DTE sample client C++ code, the CORBA Transformation Client makes the CORBA

transform() API call similarly to the following statements:

The first parameter argv[1] contains the name of the map (ContactToLabel.nsk) from the command

line. The third parameter atoi(argv[3])

is the output card number. The return value outData contains

the transformed data.

The command string that dteorbserv forms and assigns to the lpszDataToApp field of the

EXITPARM structure is ContactToLabel.nsk -OE1

CORBA

Client

CORBA Server

Map

DTEORBServ_var lp_DTEORBServ_obj; …

char *outData = lp_DTEORBServ_obj ->transform(argv[1], “”,

atoi(argv[3]));

: dteorbclnt ContactToLabel.nsk “” 1