《为InfoSphereDataStage创建定制操作符.docxVIP

为WebSphereDataStage创建定制操作符简介：创建一个简单的DataStage操作符，然后学习如何将该操作符载入DataStage Designer。操作符就是DataStage作业的基本构件块。操作符可从输入流中读取记录，修改或使用来自输入流的数据，然后将结果写入输入流。开始之前关于本教程本教程介绍了一个基本DataStage操作符的创建。首先了解如何编写一个基本的操作符，然后逐步介绍了将此操作符载入DataStage Designer 的过程。目标在本教程中，您将学习：如何编写一个简单的DataStage操作符如何设置开发环境以编译并运行一个DataStage操作符用于DataStage作业的 Orchestrate Shell（OSH）脚本语言基础如何将您的操作符载入DataStage Designer，以便在您所创建的任何作业中使用它先决条件本教程的目标读者是技能和经验处于中级水平的 Windows 程序员。您应对 IBM WebSphereDataStage有着扎实的理解，还具备 C++ 语言的实践经验。系统需求要运行本教程中的示例，您需要一台 Windows 计算机，并安装以下软件：Microsoft Visual Studio .NET 2003IBM WebSphereDataStage 8.0MKS Toolkit准备工作开始学习本教程之前，请参阅下载部分，下载本教程的源代码。将这些示例解压到一个简单的位置，因为我们将频繁地访问它。在本教程中，使用的是 e:/osh/ 这一目录，因此请将代码中此位置的所有引用更改为您的源代码目录。在下载代码的 .zip 归档文件中，有 7 个文件：/setup.bat ——批处理脚本，用于设置环境/myhelloworld.osh—— OSH 脚本，用于运行操作符/make.bat ——批处理脚本，用于编译和连接操作符/operator.apt——操作符配置文件/src/myhelloworld.c——操作符的源代码/input/mhw.txt ——用于运行操作符的输入文件/output/mhw.txt ——用于运行操作符的输出文件创建您的第一个操作符MyHelloWorld第一个操作符接受一个输入流和一个输出流。MyHelloWorld接受一列作为输入，一个整数，这个整数确定在输出流的一列中打印多少次 Hello World!。输出流包含两列，一列是计数器，显示打印了多少次 Hello World!；另一列是打印出的结果。要处理输入和输出流，有一个选项 “uppercase”。该选项确定文本 “Hello World!” 是否以大写形式打印。描述输入和输出输入和输出模式可描述如下：输入流列：inCount - int32?—— “Hello World!” 应打印的次数输出流列：outCount - int32?—— “Hello World!” 的打印次数outHello - String?—— “Hello World!” 打印的outCount次数参数uppercase - boolean?—— “Hello World!” 是否应以大写形式打印（可选）操作符内有一些代码片段描述了这些内容。参数描述通常会首先被定义。这告诉操作符准备接受哪些参数。其中包括输入流和输出流的数量，以及可传入该操作符的所有参数。下面展示了一段参数描述，它告诉操作符存在一个可选参数 “uppercase”，然后继续告诉操作符只有一个输入流和一个输出流。#define HELLO_ARGS_DESC \{ uppercase={optional, \ description=capitalize or not \ }, \ otherInfo={ \ inputs={ \ input={ \ description=source data for helloworld, \ once \ } \ }, \ outputs={ \ output={ \ description=output data for helloworld, \ minOccurrences=1, maxOccurrences=1 \ } \ }, \