Sun SeeBeyond eWay(TM) File Adapter User`s Guide
Contents
1. 819 7404 10 Version 20061004085437 File eWay User s Guide 2 Sun Microsystems Inc Contents Contents Chapter 1 Introducing the File eWay About the File eWay eWay Operation Setting Properties What s New in This Release About This Document What s in this Document File eWay Javadoc Scope Intended Audience Text Conventions Sun Microsystems Inc Web Site Documentation Feedback Chapter 2 Installing the File eWay File eWay System Requirements Installing the File eWay Installing the eWay on a JavaCAPS Supported System Adding the eWay to an Existing Suite Installation Installing eWay Enterprise Manager plug ins File eWay Alert Codes After Installation ICAN 5 0 Project Migration Procedures Chapter 3 Configuring the File eWay Configuring the File eWay Properties Selecting File as the External Application Accessing the eWay Properties Modifying the eWay Properties Modifying the eWay Connectivity Map Properties File eWay User s Guide 3 o NNNNND OD oua UI 10 10 11 11 13 13 15 15 15 16 16 16 Sun Microsystems Inc Contents Modifying the eWay Environment Properties Using the Properties Editor Inbound File eWay Connectivity Map Properties Parameter Settings Outbound File eWay Connectivity Map Properties Parameter Settings File eWay Environment Properties Inbound File eWay Parameter Settings Inbound File eWay MDB Settings Outbound File eWay Parameter Settings2. Chapter 2 Installing the File eWay Describes the system requirements and provides instructions for installing the File eWay Chapter 3 Configuring the File eWay Provides instructions for configuring the eWay to communicate with external file system Chapter 4 Using the File eWay in a Project Explains how to use the File eWay within a Project that uses elnsight Business Processes or File Java Collaboration Definitions 13 2 File eWay Javadoc The File eWay Javadoc defines the available Java methods provided with the File eWay The Javadoc is uploaded with the eWay s documentation file FileeWayDocs sar and is downloaded from the Documentation tab of the Sun Java Composite Application Platform Suite To access the full Javadoc extract the Javadoc to an easily accessible folder and double click index html 13 3 Scope This document describes the process of installing configuring and running the File eWay For information on the File eWay s Java methods download and view the File eWay Javadoc 134 Intended Audience This guide is intended for experienced computer users who have the responsibility of helping to set up and maintain a fully functioning Java Composite Application Platform Suite system This person must also understand any operating systems on which the Java Composite Application Platform Suite will be installed Windows and UNIX and must be thoroughly familiar with Windows style GUI operation
3. Chapter 4 Using the File eWay in a Project File eWay Components File OTD Operations Using the File eWay with elnsight Using the File eWay with Java based Collaborations Index File eWay User s Guide 4 16 17 18 18 20 20 22 22 23 24 25 25 25 26 26 27 Sun Microsystems Inc Chapter 1 Introducing the File eWay What s in This Chapter About the File eWay on page 5 What s New in This Release on page 6 About This Document on page 6 Sun Microsystems Inc Web Site on page 8 11 About the File eWay The File eWay Intelligent Adapter is a file based eWay provided with the Sun Java Composite Application Platform Suite to support sample Projects and to test your Sun Java Composite Application Platform Suite configuration For a more feature rich solution to processing flat file records we recommend that you use the Batch eWay Intelligent Adapter The Batch eWay provides a number of pre and post processing features that the File eWay does not offer including system rename copy and delete operations that you can configure before and after you run a Collaboration as well as other features such as regular expression matching for filenames The File eWay exchanges data between an external file system and the Sun Java Composite Application Platform Suite You can use this eWay for Reading information from an external file to the Sun Java Composite Application Platform Suite Wr
4. Composite Application Platform Suite Installer s Select Sun Java Composite Application Platform Suite Products to Install table Administration tab expand the eWay option Select the products for your Sun Java Composite Application Platform Suite and include the following FileeWay To upload the File eWay User s Guide Help file Javadoc and Readme select the following FileeWayDocs Once you have selected all of your products click Next in the top right or bottom right corner of the Select Sun Java Composite Application Platform Suite Products to Install box From the Selecting Files to Install box locate and select your first product s SAR file Once you have selected the SAR file click Next Your next selected product appears Follow this procedure for each of your selected products The Installation Status window appears and installation begins after the last SAR file has been selected Once your product s installation is finished continue installing the Sun Java Composite Application Platform Suite as instructed in the Sun Java Composite Application Platform Suite Installation Guide Adding the eWay to an Existing Suite Installation If you are adding the eWay to an existing Sun Java Composite Application Platform Suite installation do the following 1 2 Complete steps 1 through 4 above Once your product s installation is finished open the Enterprise Designer and select Update Cen
5. from the List of Components to Download under the Sun Java Composite Application Platform Suite Installer s DOWNLOADS tab There are two ways to add the eWay Enterprise Manager plug ins 1 From the Enterprise Manager A From the Enterprise Manager s Explorer toolbar click the Configuration icon B Click the Web Applications Manager tab go to the Auto Install from Repository tab and connect to your Repository C Select the application plug ins you require and click Install The application plug ins are installed and deployed 2 From the Sun Java Composite Application Platform Suite Installer A From the Sun Java Composite Application Platform Suite Installer s Download tab select the Plug Ins you require and save them to a temporary directory B Log onto the Sun SeeBeyond Enterprise Manager From the Enterprise Manager s Explorer toolbar click the Configuration icon C Click the Web Applications Manager tab and the Manage Applications tab D Browse for and select the EMR file for the application plug in that you downloaded and click Deploy The plug in is installed and deployed File eWay Alert Codes You can view and delete alerts using the Enterprise Manager An alert is triggered when a specified condition occurs in a Project component The purpose of the alert is to warn the administrator or user that a condition has occurred To View the eWay Alert Codes 1 Add the eWay Enterprise Manager plug in for thi
6. is an interval waits between poll attempts of the input integer from 2 to 99999 inclusive and directory the default is 5000 5000 milliseconds or 5 seconds It is not advised to enter a The polling interval and the MDB pool value less than 5 seconds size can be tuned based on the expected volume and frequency of Caution There is no error incoming messages See Max Pool message if you enter an incorrect Size on page 23 for more information value Input type Specifies the type of input file for A file type The default is Bytes the example bytes only valid value Remove EOL Specifies whether the eWay excludes the True or False terminating end of line EOL characters from records messages sent to a True enables the feature subscriber This property only applies if False disables the feature the Multiple records per file property is set to True The default is False File eWay User s Guide 18 Sun Microsystems Inc Chapter 3 Configuring the File eWay Section 3 2 Inbound File eWay Connectivity Map Properties Table 3 Inbound File eWay Connectivity Map Properties Parameter Settings Continued Name Description Required Value Multiple Specifies whether multiple records True or False records per messages are obtained per file If this file property is set to True multiple records True enables the feature messages are generated per line upto False disables the feat
7. the output file File eWay User s Guide 20 True or False True indicates that the system will add an EOL to each record False indicates otherwise The configured default is False Sun Microsystems Inc Chapter 3 Section 3 3 Configuring the File eWay Outbound File eWay Connectivity Map Properties Table 4 Outbound File eWay Connectivity Map Properties Parameter Settings Continued Name Description Required Value Multiple records Specifies whether multiple True or False per file records messages can be written to the output file New messages True indicates that the output file will are appended to the output file contain multiple records messages False indicates that each output file contains a single record message The configured default is True Encoding Specifies the valid encoding The encoding names names For all valid encodings please refer to the following site http java sun com j2se 1 3 docs api java lang package summary html File eWay User s Guide 21 Sun Microsystems Inc Chapter 3 Section 3 4 Configuring the File eWay File eWay Environment Properties 34 File eWay Environment Properties The File eWay configuration parameters accessed from the Environment Explorer are organized into the following sections Inbound File eWay Parameter Settings on page 22 Inbound File eWay MDB Settings on page 23 Outbound File eWay Parameter Settings
8. SUN SEEBEYOND eWAY FILE ADAPTER USER S GUIDE Release 5 1 2 sS Re SUN microsystems Copyright 2006 Sun Microsystems Inc 4150 Network Circle Santa Clara California 95054 U S A All rights reserved Sun Microsystems Inc has intellectual property rights relating to technology embodied in the product that is described in this document In particular and without limitation these intellectual property rights may include one or more of the U S patents listed at http www sun com patents and one or more additional patents or pending patent applications in the U S and in other countries U S Government Rights Commercial software Government users are subject to the Sun Microsystems Inc standard license agreement and applicable provisions of the FAR and its supplements Use is subject to license terms This distribution may include materials developed by third parties Sun Sun Microsystems the Sun logo Java Sun Java Composite Application Platform Suite SeeBeyond eGate elnsight eVision eTL eXchange eView elndex eBAM eWay and JMS are trademarks or registered trademarks of Sun Microsystems Inc in the U S and other countries All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International Inc in the U S and other countries Products bearing SPARC trademarks are based upon architecture developed by Sun Microsystems Inc UNIX is a registered trademark in the U S and oth
9. Select the File External Application from the menu see Figure 1 The selected File External Application icon appears on the Connectivity Map toolbar Figure 1 External Applications Selection Menu OTO Scheduler The new External System can now be dragged and dropped onto the Connectivity Map canvas and incorporated into a Project File eWay User s Guide 15 Sun Microsystems Inc Chapter 3 Section 3 1 Configuring the File eWay Configuring the File eWay Properties 312 Accessing the eWay Properties When you connect bind an External Application to a Service Collaboration Business Process the Enterprise Designer automatically assigns the appropriate eWay to the link see Figure 2 In the case of the File eWay the direction of the data to or from the service determines whether the eWay is inbound or outbound and the appropriate properties template is assigned to the eWay Each eWay retains a properties template containing its default configuration properties that are accessible from the Connectivity Map and Environment Explorer Figure 2 Connectivity Map File eWay fo botja op File In j Service f File Out File eWay File eWay inbound outbound 313 Modifying the eWay Properties The eWay properties can be modified after the eWays have been created in the Connectivity Map and the Project s Environment has been created The File eWay properties are modified from two locations the Connectivity Map and the Envi
10. d the Project s components are automatically checked in to Version Control to write protected each component These protected components appear in the Explorer tree with a red padlock in the bottom left corner of each icon Before you can deploy the imported Project the Project s components must first be checked out of Version Control from both the Project Explorer and the Environment Explorer To check out all of the Project s components do the following A From the Project Explorer right click the Project and select Version Control gt Check Out from the shortcut menu The Version Control Check Out dialog box appears B Select Recurse Project to specify all components and click OK C Select the Environment Explorer tab and from the Environment Explorer right click the Project s Environment and select Version Control gt Check Out from the shortcut menu D Select Recurse Environment to specify all components and click OK If your imported Project includes File eWays these must be reconfigured in your Environment prior to deploying the Project To reconfigure your File eWays do the following A The Environment File External System properties can now accommodate both inbound and outbound eWays If your previous Environment includes both inbound and outbound File External Systems delete one of these for example the outbound File External System B From the Environment Explorer tree right click you
11. de 19 Sun Microsystems Inc Chapter 3 Configuring the File eWay Section 3 3 Outbound File eWay Connectivity Map Properties 33 Outbound File eWay Connectivity Map Properties The inbound File eWay configuration parameters accessed from the Connectivity Map are organized into the following sections Parameter Settings on page 20 33 1 Parameter Settings The Parameter Settings section of the outbound File eWay Connectivity Map properties contains the top level parameters displayed in Table 4 Table 4 Outbound File eWay Connectivity Map Properties Parameter Settings Name Description Required Value Output file name Specifies the file mask for output data files An appropriate file name The default is output d dat The d in the file name is a counter and increments for each new file Instead of d you can use any other printf style that takes an integer or long value For example you can specify 1 d or 012d In cases where the Multiple records per file property is set to False If no output file exists at the time of the first execution a new output file is created for each record Ifan output file already exists at the time of the first execution messages are appended to it Note For more information regarding the printf feature see the appropriate C language documentation Add EOL Specifies whether the system adds an end of line character to each record the eWay sends to
12. des an area for recording notes and information about the currently selected parameter This is saved automatically for future referral 5 Click OK to close the Properties Editor and save the changes File eWay User s Guide 17 Sun Microsystems Inc Chapter 3 Configuring the File eWay Section 3 2 Inbound File eWay Connectivity Map Properties 32 Inbound File eWay Connectivity Map Properties The inbound File eWay configuration parameters accessed from the Connectivity Map are organized into the following sections Parameter Settings on page 18 321 Parameter Settings The Parameter Settings section of the inbound File eWay Connectivity Map properties contains the top level parameters displayed in Table 3 Table 3 Inbound File eWay Connectivity Map Properties Parameter Settings Name Description Required Value Input file Specifies the file mask for input data A file mask The default is input txt name files You can provide only an extension with an asterisk for example txt to allow all files with that extension An input file s extension is renamed to in after it is picked up Note If a file with the same name as the rename name exists for example input1 txt in picking up the input file fails You must ensure no files with the rename names exist before the files are processed by the inbound file poller Polling The number of milliseconds the eWay An integer the acceptable range
13. e an existing filename Verify that the directory name is not the same as an existing file name FILE ASRENAMEFAILED000001 Failed attempting to rename input file 0 Verify that the file permissions for your input file are not read only If this occurs when renaming a file to text the eWay make sure that a file with this name does not already exist For example if you are renaming the input1 txt file to input1 txt in and an in file already exists the rename will fail FILE CANTWRITEOUTPUTDIROO0005 Error writing to output directory 0 Verify that the output directory exists Verify that the output directory has write permissions Make sure that there is enough disk space to write to the disk FILE CANTWRITEOUTPUTFILE000006 Error writing to output file 0 Verify that the output directory exists Verify that the output directory has write permissions Make sure that there is enough disk space to write to the disk An alert code is a warning that an error has occurred It is not a diagnostic The user actions noted above are possible corrective measures you may take Refer to your log files for more information For information on Managing and Monitoring alert codes and logs see the Sun SeeBeyond eGate Integrator System Administration Guide File eWay User s Guide 12 Sun Microsystems Inc Chapter 2 Section 2 3 Installing the File eWay ICAN 5 0 Project Migration Pr
14. ed by the MDB pool size When the maximum MDB pool limit is reached incoming threads are blocked Increasing the MDB pool size allows more resource adapter threads to send data to the Collaboration In most cases the default MDB pool size of 1000 is sufficient An integer indicating the maximum MDB pool size The default configuration is 1000 File eWay User s Guide 23 Sun Microsystems Inc Chapter 3 Section 3 4 Configuring the File eWay File eWay Environment Properties 343 Outbound File eWay Parameter Settings The Outbound File eWay Parameter Settings section of the File eWay Environment properties contains the top level parameters displayed in Table 7 Table 7 File eWay Environment Properties Outbound File eWay Parameter Settings Name Description Required Value Directory Specifies the directory to which The absolute path and directory output files are written name File eWay User s Guide 24 Sun Microsystems Inc Chapter 4 Using the File eWay in a Project This chapter provides an introduction to the File eWay components and information on how these components are created and implemented in a Sun Java Composite Application Platform Suite Project Chapter Topics File eWay Components on page 25 Using the File eWay with elnsight on page 26 Using the File eWay with Java based Collaborations on page 26 41 File eWay Components The File eWay is used in most of the sample Pr
15. er countries exclusively licensed through X Open Company Ltd This product is covered and controlled by U S Export Control laws and may be subject to the export or import laws in other countries Nuclear missile chemical biological weapons or nuclear maritime end uses or end users whether direct or indirect are strictly prohibited Export or reexport to countries subject to U S embargo or to entities identified on U S export exclusion lists including but not limited to the denied persons and specially designated nationals lists is strictly prohibited Copyright 2006 Sun Microsystems Inc 4150 Network Circle Santa Clara California 95054 Etats Unis Tous droits r serv s Sun Microsystems Inc d tient les droits de propri t intellectuels relatifs a la technologie incorpor e dans le produit qui est d crit dans ce document En particulier et ce sans limitation ces droits de propri t intellectuels peuvent inclure un ou plus des brevets am ricains list s a l adresse http www sun com patents et un ou les brevets suppl mentaires ou les applications de brevet en attente aux Etats Unis et dans les autres pays L utilisation est soumise aux termes de la Licence Cette distribution peut comprendre des composants d velopp s par des tierces parties Sun Sun Microsystems le logo Sun Java Sun Java Composite Application Platform Suite Sun SeeBeyond eGate elnsight eVision eTL eXchange eView elndex eBAM et eWay sont des marqu
16. es de fabrique ou des marques d pos es de Sun Microsystems Inc aux Etats Unis et dans d autres pays Toutes les marques SPARC sont utilis es sous licence et sont des marques de fabrique ou des marques d pos es de SPARC International Inc aux Etats Unis et dans d autres pays Les produits portant les marques SPARC sont bas s sur une architecture d velopp e par Sun Microsystems Inc UNIX est une marque d pos e aux Etats Unis et dans d autres pays et licenci e exclusivement par X Open Company Ltd Ce produit est couvert la l gislation am ricaine en mati re de contr le des exportations et peut tre soumis la r glementation en vigueur dans d autres pays dans le domaine des exportations et importations Les utilisations ou utilisateurs finaux pour des armes nucl aires des missiles des armes biologiques et chimiques ou du nucl aire maritime directement ou indirectement sont strictement interdites Les exportations ou r exportations vers Les pays sous embargo am ricain ou vers des entit s figurant sur Les listes d exclusion d exportation am ricaines y compris mais de mani re non exhaustive la liste de personnes qui font objet d un ordre de ne pas participer d une fa on directe ou indirecte aux exportations des produits ou des services qui sont r gis par la l gislation am ricaine en mati re de contr le des exportations et la liste de ressortissants sp cifiquement d sign s sont rigoureusement interdites Part Number
17. he File eWay on page 9 ICAN 5 0 Project Migration Procedures on page 13 21 File eWay System Requirements The File eWay Readme contains the latest information on Supported Operating Systems System Requirements External System Requirements The File eWay Readme is uploaded with the eWay s documentation file FileeWayDocs sar and can be accessed from the Documentation tab of the Sun Java Integrator Suite Installer Refer to the File eWay Readme for the latest requirements before installing the File eWay 22 Installing the File eWay The Sun Java Composite Application Platform Suite Installer a web based application is used to select and upload eWays and add on files during the installation process The following section describes how to install the components required for this eWay Note When the Repository is running on a UNIX operating system the eWays are loaded from the Enterprise Manager running on a Windows platform connected to the Repository server using Internet Explorer File eWay User s Guide 9 Sun Microsystems Inc Chapter 2 Section 2 2 Installing the File eWay Installing the File eWay 221 Installing the eWay on a JavaCAPS Supported System Follow the directions for installing the Sun Java Composite Application Platform Suite in the Sun Java Composite Application Platform Suite Installation Guide After you have installed eGate or elnsight do the following 1 From the Sun Java
18. he ZIP file field 6 Click Export to create the Project ZIP file in the selected destination Install Sun Java Composite Application Platform Suite 7 Install the Sun Java Composite Application Platform Suite including all eWays libraries and other components used by your ICAN 5 0 Projects 8 Start the Sun SeeBeyond Enterprise Designer Import the Project 9 From the Enterprise Designer s Project Explorer tree right click the Repository and select Import Project from the shortcut menu The Import Manager appears 10 Browse to and select your exported Project file 11 Click Import A warning message Missing APIs from Target Repository may appear at this time This occurs because various product APIs were installed on the ICAN 5 0 Repository when the Project was created that are not installed on the Sun Java Composite Application Platform Suite Repository These APIs may or may not apply to your Projects You can ignore this message if you have already installed all File eWay User s Guide 13 Sun Microsystems Inc Chapter 2 Section 2 3 Installing the File eWay ICAN 5 0 Project Migration Procedures 12 of the components that correspond to your Projects Click Continue to resume the Project import Close the Import Manager after the Project is successfully imported Deploy the Project 13 14 15 Note A new Deployment Profile must be created for each of your imported Projects When a Project is exporte
19. iting information from the Sun Java Composite Application Platform Suite to an external file 111 eWay Operation The File eWay is provided as part of the Sun Java Composite Application Platform Suite and operates as follows As an inbound eWay the File eWay polls an input directory for files based on a file name matching a specified regular expression When the eWay detects a matching file it opens the file and publishes the data to a Collaboration or Business Process Service As an outbound eWay the eWay writes processed data to an output file File eWay User s Guide 5 Sun Microsystems Inc Chapter 1 Section 1 2 Introducing the File eWay What s New in This Release 112 Setting Properties You can set configuration properties for the eWay including names and locations of source and destination files in the eWay Properties dialog box which is part of the eGate Enterprise Designer See Chapter 3 for more information about using the eWay Properties dialog box For a description of a complete end to end scenario using the File eWay inbound and outbound see the Sun SeeBeyond eGate Integrator Tutorial 12 What s New in This Release The Sun SeeBeyond eWay File Adapter includes the following changes and new features New for Version 5 1 2 This is a maintenance release No new features New for Version 5 1 1 Supports automatic deployment of EAR files to WebLogic Application Server version 9 1 New f
20. ness Processes Once a component is associated with an Activity eInsight invokes it using a Web Services interface eGate components that can interface with eInsight in this way include the following Object Type Definitions OTDs eWays Collaborations Using the Enterprise Designer and elnsight you can add an Activity to a Business Process then associate that Activity with an eGate component for example an eWay Then when elnsight runs the Business Process it automatically invokes that component via its Web Services interface You can add File eWay objects to an eInsight Business Process during the system design phase To make this association select the desired receive or write operation from the Project Explorer under Sun SeeBeyond gt eWays gt File gt FileClient and drag it into the elnsight Business Process canvas GUI Once you have associated the desired component with a Business Process the elnsight engine can automatically invoke that component during run time using a Business Process Execution Language BPEL interface See the elnsight Business Process Manager User s Guide for details 43 Using the File eWay with Java based Collaborations Java based Collaboration Definitions contain a set of Business Rules that define the processing and transport of data messages through the Sun Java Composite Application Platform Suite Projects You create Java Collaboration Definitions using the Collaboration Defini
21. nvironment 16 Environment properties modifying 16 Properties Editor 17 modifying properties 17 R Remove EOL 18 S supported operating systems 9 T text conventions 7 Sun Microsystems Inc
22. ocedures 223 After Installation 2 3 Once the eWay is installed and configured it must then be incorporated into a Project before it can perform its intended functions See the eGate Integrator User s Guide for more information on incorporating the eWay into an eGate Project ICAN 5 0 Project Migration Procedures This section describes how to transfer your current ICAN 5 0 Projects to Sun Java Composite Application Platform Suite version 5 1 2 Only Projects developed on ICAN version 5 0 2 and above can be migrated successfully to the Sun Java Composite Application Platform Suite To migrate your ICAN 5 0 Projects do the following Export the Project 1 Before you export your Projects save your current ICAN 5 0 Projects to your Repository 2 From the Project Explorer right click your Project and select Export from the shortcut menu The Export Manager appears 3 Select the Project that you want to export in the left pane of the Export Manager and move it to the Selected Projects field by clicking the Add to Select Items arrow button or click All to include all of your Projects 4 Inthe same manner select the Environment that you want to export in the left pane of the Export Manager and move it to the Selected Environments field by clicking the Add to Select Items arrow button or click All to include all of your Environments 5 Browse to select a destination for your Project ZIP file and enter a name for your Project in t
23. ojects provided with the Sun Java Composite Application Platform Suite and the eWay Intelligent Adapters The File eWay includes the following components that are unique to this eWay File eWay Configuration Properties File The properties files for the File eWay defines how the eWay connects with external systems as well as how data messages are handled These properties are configured using the Properties Editor For more information about the Batch eWay properties files and the Properties Editor see Configuring the File eWay on page 15 FileClient OTD The File OTD provides functionality for receiving or sending files and triggering a Business Process or Collaboration Object Type Definitions OTDs map input and output message segments at the field level 411 File OTD Operations The following File eWay OTD attributes or operations are used in both BPEL and JCD Projects receive inbound File eWay write outbound File eWay The write output Business Process operation has an additional input function provided to receive and handle incoming error exception messages For more information on this feature see the Sun SeeBeyond elnsight Business Process Manager User s Guide File eWay User s Guide 25 Sun Microsystems Inc Chapter 4 Section 4 2 Using the File eWay in a Project Using the File eWay with elnsight 42 Using the File eWay with elnsight eGate components can be deployed as Activities in eInsight Busi
24. on page 24 341 Inbound File eWay Parameter Settings The Inbound File eWay Parameter Settings section of the File eWay Environment properties contains the top level parameters displayed in Table 5 Table 5 File eWay Environment Properties Inbound File eWay Parameter Settings Name Description Required Value Directory Specifies the folder or directory that A folder or directory name You the eWay polls for input files must use the absolute path specify paths using the forward slash mark The configured default is C temp File eWay User s Guide 22 Sun Microsystems Inc Chapter 3 Configuring the File eWay 342 Inbound File eWay MDB Settings The Inbound File eWay MDB Settings section of the File eWay Environment properties contains the top level parameters displayed in Table 6 Section 3 4 File eWay Environment Properties Table 6 File eWay Environment Properties Inbound File eWay MDB Settings Name Description Required Value Max Pool Size Specifies the maximum number of Message Driven Beans instantiated at any one point for message handling The polling interval and the MDB pool size Max Pool Size can be tuned based on the expected volume and frequency of incoming messages A more frequent polling interval due to a large number of new messages will trigger the creation of new threads The number of threads that can be processed however is limit
25. or Version 5 1 0 Version Control An enhanced version control system allows you to effectively manage changes to the eWay components Multiple Drag and Drop Component Mapping from the Deployment Editor The Deployment Editor now allows you to select multiple components from the Editor s component pane and drop them into your Environment component Support for Runtime LDAP Configuration eWay configuration properties now support LDAP URL values MDB Pool Size Support Provides greater flow control throttling by specifying the maximum and minimum MDB pool size Connectivity Map Generator Generates and links your Project s Connectivity Map components using a Collaboration or Business Process Many of these features are documented further in the Sun SeeBeyond eGate Integrator User s Guide or the Sun SeeBeyond eGate Integrator System Administrator Guide 13 About This Document This guide explains how to install configure and operate the Sun Java Composite Application Platform Suite File eWay Intelligent Adapter referred to as the File eWay throughout this guide File eWay User s Guide 6 Sun Microsystems Inc Chapter 1 Section 1 3 Introducing the File eWay About This Document 131 What s in this Document This document includes the following chapters Chapter 1 Introducing the File eWay Provides an overview description of the product as well as high level information about this document
26. r remaining File External System and select Properties from the shortcut menu The Properties Editor appears C The Directory property has been relocated from the Connectivity Map Properties to the Environment Properties Set the inbound and outbound Directory values and click OK Deploy your Projects Only projects developed on ICAN 5 0 2 and above can be imported and migrated successfully into the Java Integration Suite File eWay User s Guide 14 Sun Microsystems Inc Chapter 3 Configuring the File eWay This chapter explains how to set the properties for the File eWay Chapter Topics Configuring the File eWay Properties on page 15 Inbound File eWay Connectivity Map Properties on page 18 File eWay Environment Properties on page 22 31 Configuring the File eWay Properties The File eWay includes a unique set of configuration parameters After creating the eWays and the File External System in the Project s Environment the property parameters can be modified for your specific system 311 Selecting File as the External Application To create a File eWay you must first create a File External Application in your Connectivity Map File eWays are located between a File External Application and a Service Services are containers for Java Collaborations Business Processes eTL processes and so forth To create a File External Application 1 From the Connectivity Map toolbar click the External Applications icon 2
27. ronment Explorer Modifying the eWay Connectivity Map Properties The Connectivity Map properties most commonly apply to a specific component eWay and may vary from other eWays of the same type in the Project 1 From the Connectivity Map double click the eWay icon located in the link between the associated External Application and the Service 2 The eWay Properties Editor opens with the eWay s Connectivity Map properties either inbound or outbound Make any necessary modifications and click OK to save the settings Modifying the eWay Environment Properties These parameters are commonly global applying to all eWays of the same type in the Project The saved properties are shared by all eWays for the specified External System 1 From the Environment Explorer tree right click the File External System Select Properties from the shortcut menu The Properties Editor opens with the eWay Environment properties 2 Make any necessary modifications to the Environment properties and click OK to save the settings File eWay User s Guide 16 Sun Microsystems Inc Chapter 3 Section 3 1 Configuring the File eWay Configuring the File eWay Properties 314 Using the Properties Editor You can modify your eWay properties using the eWay Properties Editor Modifying the Default eWay Properties 1 From the upper left pane of the Properties Editor select a subdirectory of the Properties tree The parameters contained in that subdirecto
28. ry are now displayed in the right pane of the Properties Editor For example clicking on the Parameter Settings subdirectory displays the editable parameters in the right pane as shown in Figure 3 on page 17 Figure 3 Properties Editor File eWay PRET EE ET m Input file name input tet Polling interval 5000 Input type Bytes Remove EOL False Multiple records per file False Maximum bytes perrecord 4096 Encoding SerialMode True Resend On Error True Description Encoding Specifies a valid encoding name Refer to File eWay user guide for valid encodings Comments Encoding Properties Cancel 2 Click on any property field to make it editable For example click on the Encoding property to edit the properties settings For properties that have a value of true false or multiple choice the field reveals a submenu of property options Click on the ellipsis in the properties field displayed when you click on the field A separate configuration dialog box appears This is helpful for large values that cannot be fully displayed in the parameter s property field Enter the property value in the dialog box and click OK The value now appears in the property field 3 A description of each parameter is displayed in the Description pane when that parameter is selected providing an explanation of any required settings or options 4 The Comments pane provi
29. s 135 Text Conventions The following conventions are observed throughout this document Table 1 Text Conventions Text Convention Used For Examples Bold Names of buttons files icons Click OK parameters variables methods On the File menu click Exit menus and objects Select the eGate sar file File eWay User s Guide 7 Sun Microsystems Inc Chapter 1 Section 1 4 Introducing the File eWay Sun Microsystems Inc Web Site Table 1 Text Conventions Continued Text Convention Used For Examples Monospaced Command line arguments code java jar filename jar samples variables are shown in bold italic Blue bold Hypertext links within See Text Conventions on page 7 document Blue underlined Hypertext links for Web http www sun com addresses URLs or email addresses 14 Sun Microsystems Inc Web Site The Sun Microsystems web site is your best source for up to the minute product news and technical support information The site s URL is http www sun com 15 Documentation Feedback We appreciate your feedback Please send any comments or suggestions regarding this document to CAPS docsfeedback sun com File eWay User s Guide 8 Sun Microsystems Inc Chapter 2 Installing the File eWay This chapter contains installation information for the File eWay What s in This Chapter File eWay System Requirements on page 9 Installing t
30. s eWay 2 From the Enterprise Manager s Explorer toolbar click the Configuration icon 3 Click the Web Applications Manager tab and go to the Manage Alert Codes tab Your installed alert codes are displayed under the Results section If your eWay alert codes are not available displayed under Results do the following File eWay User s Guide 11 Sun Microsystems Inc Chapter 2 Installing the File eWay Section 2 2 Installing the File eWay A From the Install New Alert Codes section browse to and select the eWay alert properties file for the application plug in that you added The alert properties files are located in the alertcodes folder of your Sun Java Composite Application Platform Suite installation directory B Click Deploy The available alert codes for your application are displayed under Results A listing of available this eWay s alert codes is displayed in Table 2 Table 2 File eWay Alert Codes Alert Code Description User Action FILE Unable to create input Make sure that the user has ASCANTCREATEINPUTDIRO00004 directory 0 permissions to create the directory FILE Input directory 0 does Verify that the input directory is ASINPUTDIRNONEXISTENT000002 not exist Creating the directory This is a warning named correctly The directory may not have the expected name Check for spelling mistakes FILE ASINPUTDIRNOTDIROO0003 Input directory 0 is not a directory The directory name may b
31. ter from the Tools menu The Update Center Wizard appears For Step 1 of the wizard simply click Next For Step 2 of the wizard click the Add All button to move all installable files to the Include in Install field then click Next For Step 3 of the wizard wait for the modules to download then click Next The wizard s Step 4 window displays the installed modules Review the installed modules and click Finish When prompted restart the IDE Integrated Development Environment to complete the installation File eWay User s Guide 10 Sun Microsystems Inc Chapter 2 Section 2 2 Installing the File eWay Installing the File eWay 222 Installing eWay Enterprise Manager plug ins The Sun SeeBeyond Enterprise Manager is a Web based interface that allows you to monitor and manage your Java Integration Suite applications The Enterprise Manager requires an eWay specific plug in for each of your installed eWays These plug ins enable the Enterprise Manager to target specific alert codes for each eWay type as well as to start and stop the inbound eWays The Sun Java Composite Application Platform Suite Installation Guide describes how to install the Sun SeeBeyond Enterprise Manager The Sun SeeBeyond eGate Integrator System Administration Guide describes how to monitor servers Services logs and alerts using the Sun SeeBeyond Enterprise Manager and the command line client The eWay Enterprise Manager plug ins are available
32. tion Wizard Java to assign the appropriate Object Type Definitions OTDs and Web Service operations to your Collaboration Once you have created the Collaboration Definition you use the Collaboration Editor Java to create the business logic of the Collaboration assigning input and output data relationships using the Collaboration Editor s Business Rules Designer The File eWay Intelligent Adapter OTD provides a number of Java Methods that allow you to add file input output business logic to your Collaboration Business Rules For more information on the Java methods provided with the File OTD see the File eWay Javadoc see File eWay Javadoc on page 7 For more information on how to use the File eWay with Java based Collaboration Definitions see the Sun SeeBeyond eGate Integrator User s Guide File eWay User s Guide 26 Sun Microsystems Inc Index Index B Business Process Execution Language BPEL 26 C Connectivity Map properties 16 conventions text 7 E elnsight with File eWay overview 26 Environment properties 16 External Application creating 15 Input file name 18 20 Input type 18 J Javadoc 7 M Maximum bytes per record 19 Multiple records per file 19 O operating systems requirements 9 supported 9 P platforms requirements 9 supported 9 Polling interval 18 File eWay User s Guide 27 properties Connectivity Map 16 Connectivity Map properties modifying 16 E
33. ure the number specified in the Maximum bytes per record property Any data The default is False exceeding the maximum bytes per record size is sent in subsequent messages Maximum Specifies the maximum number of bytes An integer the acceptable range is an bytes per per record message sent to a integer from 2 to 99999 inclusive and record subscriber This property only applies if the default is 4096 the Multiple records per file property is set to True Caution There is no error message if you enter an incorrect value Encoding Specifies the valid encoding names For The encoding names more information on Java encoding refer to the following site http java sun com j2se 1 3 docs api java lang package summary html SerialMode Specifies whether messages will be True or False handled in serial mode one after the other or concurrently True indicates that messages are handled in serial mode False indicates that messages handled concurrently The configured default is True Resend On Specifies whether inbound messages True or False Error from the input file are resent if an exception is received after sending the True the input file is not renamed message to the Collaboration messages are resent to the Collaboration until the exception is resolved False exceptions are ignored the input file is renamed and messages are not resent to the Collaboration The configured default is True File eWay User s Gui
Download Pdf Manuals
Related Search