Sun Microsystems SUN SEEBEYOND eWAY User Manual
  1. Manuals
  2. Brands
  3. Sun Microsystems Manuals
  4. Adapter
  5. SUN SEEBEYOND eWAY
  6. User manual
Sun Microsystems SUN SEEBEYOND eWAY User Manual

Sun Microsystems SUN SEEBEYOND eWAY User Manual

Adapter for vsam 5.1.3
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
SUN SEEBEYOND
eWAY™ ADAPTER FOR VSAM
USER'S GUIDE
Release 5.1.3

Advertisement

Table of Contents
loading

Related Manuals for Sun Microsystems SUN SEEBEYOND eWAY

Summary of Contents for Sun Microsystems SUN SEEBEYOND eWAY

  • Page 1 SUN SEEBEYOND eWAY™ ADAPTER FOR VSAM USER’S GUIDE Release 5.1.3...
  • Page 2 Java, Sun Java Composite Application Platform Suite, Sun, SeeBeyond, eGate, eInsight, eVision, eTL, eXchange, eView, eIndex, eBAM et eWay sont des marques 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.

  • Page 3: Table Of Contents

    About This Document VSAM eWay Javadoc Scope Intended Audience Text Conventions Related Documents Sun Microsystems, Inc. Web Site Documentation Feedback Chapter 2 Installing the VSAM eWay Installing the VSAM eWay Installing the VSAM eWay on an eGate supported system Adding the eWay to an Existing Sun Java Composite Application Platform Suite Installation...
  • Page 4 Specify the OTD Name Review Selections Resulting OTD Steps to Edit an Existing VSAM OTD Chapter 5 Using VSAM OTDs Overview Using Tables Using the select Method Select Operations Insert Operations Update Operations VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 5 Configuring the bpPsSelect Modeling Elements Creating the Connectivity Map Populating the Connectivity Map Binding the eWay Components Creating an Environment Configuring the eWays Configuring the eWay Properties Configuring the Environment Explorer Properties VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 6 Configuring the eWays Configuring the eWay Properties Configuring the Environment Explorer Properties Configuring the Integration Server Creating the Deployment Profile Creating and Starting the Domain Building and Deploying the Project Running the Sample Index VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 7: Introducing The Vsam Eway

    Chapter 1 Introducing the VSAM eWay Welcome to the Sun SeeBeyond eWay™ Adapter for VSAM User’s Guide. This document includes information about installing, configuring, and using the Sun Java Composite Application Platform Suite VSAM eWay™ Adapter, referred to as the VSAM eWay throughout this guide.

  • Page 8: About The Vsam Eway

    For details on operating and using eGate and its user interface, the Enterprise Designer, see the Sun SeeBeyond eGate™ Integrator User’s Guide. What’s New in This Release The Sun SeeBeyond eWay Adapter for VSAM includes the following changes and new features: New for Version 5.1.3 This is a maintenance release.

  • Page 9: About This Document

    A VSAM eWay Javadoc is also provided that documents the Java methods available with the VSAM eWay. The Javadoc is uploaded with the eWay’s documentation file (VSAMeWayDocs.sar) and downloaded from the Documentation tab of the Sun Java VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 10: Scope

    Related Documents The following Sun documents provide additional information about the Sun Java Composite Application Platform Suite product: Sun SeeBeyond eGate™ Integrator User’s Guide Sun Java Composite Application Platform Suite Installation Guide VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 11: Sun Microsystems, Inc. Web Site

    Section 1.6 Introducing the VSAM eWay Sun Microsystems, Inc. Web Site 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 Documentation Feedback We appreciate your feedback.

  • Page 12: Installing The Vsam Eway

    Note: When the Repository is running on a UNIX operating system, the eWays are loaded from the Sun Java Composite Application Platform Suite Installer running on a Windows platform connected to the Repository server using Internet Explorer. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 13: Installing The Vsam Eway On An Egate Supported System

    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. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 14: Copying Jar Files To The Edesigner Library

    Click the VSAM eWay Adapter link. Documentation for the VSAM eWay appears in the right pane. Click the icon next to Javadoc and extract the ZIP file. Open the index.html file to view the Javadoc. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 15: Ican 5.0 Project Migration Procedures

    Start the Java CAPS 5.1.3 Enterprise Designer. Import the Project From the Java CAPS 5.1.3 Enterprise Designer’s Project Explorer tree, right-click the Repository and select Import Project from the shortcut menu. The Import Manager appears. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 16: Installing Enterprise Manager Eway Plug-Ins

    Sun Java Composite Application Platform Suite. Installing Enterprise Manager eWay Plug-Ins The Sun SeeBeyond Enterprise Manager is a Web-based interface you use to monitor and manage your Sun Java Composite Application Platform Suite applications. The VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 17: Viewing Alert Codes

    Click the Web Applications Manager tab and go to the Manage Alert Codes sub- tab. Your installed eWay alert codes display under the Results section. If your eWay alert codes are not displayed under Results, do the following: VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 18 DBCOMMON-XASTART- A connection error Check if the database is running, FAILED000001=Unable to has occurred which and there are no network issues. perform XAStart for the caused XASTART to connection. Reason: [{0}] fail. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 19 Refer to the log files for more information. For information on Managing and Monitoring alert codes and logs, see the Sun SeeBeyond eGate Integrator System Administration Guide. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 20: Setting Properties Of The Vsam Eway

    Each eWay is supplied with a list of eWay connections (transaction support levels) from which to choose. Transaction support levels provided by the VSAM eWay include: VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 21 Collaboration does not support transactions. This means that when a transaction aborts, there is no ability to roll back any changes to the previous update. The Properties window opens, displaying the default properties for the eWay. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 22: Transaction Support Levels Between Different Versions

    Fill in the NoTransaction property for the database external system under the Environment. Rebuild the Project. If you want 5.1.3 behavior for a LocalTransaction, then set your eWay connection to be Outbound VSAM non-Transactional eWay (NoTransaction). VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 23: Configuring The Eway Environment Properties

    Note: For more information on creating an Environment, see the “Sun SeeBeyond eGate Integrator Tutorial”. Right-click the External System created for the VSAM Project and select Properties from the list box. The Environment Configuration Properties window appears. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 24: Eway Connectivity Map Properties

    The eWay Connectivity Map consists of the following properties categories. Outbound eWay on page 25 Connectivity Map (Outbound) CP eWay Properties Outbound non-Transactional eWay Connectivity Map Outbound non-Transactional eWay Properties on page 25 VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 25: Connectivity Map (Outbound) Cp Eway Properties

    VSAM non-Transactional Connection Pool Datasource. ClassName Specifies the Java class in the JDBC driver A valid class name. The that is used to implement the non- default is Transactional ConnectionPoolDataSource com.cac.jdbc.ConnectionPool interface. DataSource VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 26: Eway Environment Properties

    Specifies the password used to access the Any valid string. database. (Outbound) VSAM CP eWay Properties 3.5.2 The (Outbound) VSAM CP eWay includes the following configuration sections: JDBC Connector Settings Connection Retry Settings VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 27: Jdbc Connector Settings

    Any valid string. instance. User Specifies the user name the eWay Any valid string. uses to connect to the database. Password Specifies the password used to Any valid string. access the database. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 28 Delimiter This is the delimiter character to be The default is #. See the used in the DriverProperties prompt. DriverProperties property above for more information on how the default value is used. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 29: Connection Retry Settings

    Table 7 VSAM CP eWay—Connection Retry Settings Name Description Required Value ConnectionRetries Specifies the number of retries to A valid numeric value. The establish a connection upon failure default is 0. to acquire one. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 30: Outbound Vsam Non-Transactional Eway Properties

    Any valid string. instance. User Specifies the user name the eWay Any valid string. uses to connect to the database. Password Specifies the password used to Any valid string. access the database. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 31 Delimiter This is the delimiter character to be The default is #. See the used in the DriverProperties prompt. DriverProperties property above for more information on how the default value is used. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 32: Connection Retry Settings

    Table 9 VSAM non-Transactional eWay—Connection Retry Settings Name Description Required Value ConnectionRetries Specifies the number of retries to A valid numeric value. The establish a connection upon failure default is 0. to acquire one. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 33 Database, the eWay will try to reconnect to the database 10 times in 5 seconds apart when the Connection Retries is 10 and the Connection Retry Interval is 5000. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 34: Using The Vsam Eway Database Wizard

    Integrator User’s Guide. Creating a New VSAM OTD The following steps are required to create a new OTD for the VSAM adapter. Select Wizard Type on page 35 Connect To Database on page 35 VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 35: Select Wizard Type

    From the New Object Type Definition Wizard window, select the VSAM Database and click Next. See Figure 5. Figure 5 OTD Wizard Selection Connect To Database 4.2.2 Enter the VSAM database connection information in the Connection Information frame. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 36: Select Database Objects

    When selecting Database Objects, you can select any combination of Tables, Views, or Prepared Statements you would like to include in the OTD file. Click Next to continue. See Figure 7. Note: Views are read-only and are for informational purposes only. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 37: Select Tables/Views/Aliases

    Select the types of tables or views required in the OTD. Note: Aliases are not supported in the current release of the VSAM eWay. Steps Required to Select Table and Views Include: In the Select Tables/Views/Aliases window, click Add. See Figure 8. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 38 In the Add Tables window, select if your selection criteria will include table data, view only data, both, and/or system tables. From the Table/View Name drop down list, select the location of your database table and click Search. See Figure 9. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 39 Creating a New VSAM OTD Figure 9 Database Wizard - All Schemes Select the table of choice and click OK. The table selected is added to the Selected Tables/Views/Aliases section. See Figure 10. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 40 The data type is usually listed as Other when the driver cannot detect the data type. In these situations we recommend changing the data type to one that is more appropriate for the type of column data. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 41: Add Prepared Statement

    OK. In general, you will not need to make any changes. See Figure 12. Figure 12 Table/View Columns — Advanced Add Prepared Statement 4.2.5 Add a Prepared Statement object to your OTD. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 42 Table schema name in the SQL Prepared Statement. When finished creating the statement, click Save As giving the statement a name. This name will appear as a node in the OTD. Click OK. See Figure 14. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 43 Remove to remove it. Click OK. Figure 15. Figure 15 Edit the Prepared Statement Parameters To edit Resultset Columns, click Edit Resultset Columns. The ResultSet Columns window appears. See Figure 16. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 44: Specify The Otd Name

    Specify the name that your OTD will display in the Enterprise Designer Project Explorer. Steps Required to Specify the OTD Name: Enter a name for the OTD. The OTD contains the selected tables and the package name of the generated classes. See Figure 17. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 45: Review Selections

    View the summary of the OTD. If you find you have made a mistake, click Back and correct the information. If you are satisfied with the OTD information, click Finish to begin generating the OTD. See Figure 18. The resulting OTD appears on the Enterprise Designer’s Project Explorer. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 46: Resulting Otd

    The resulting VSAM OTD appears on the Enterprise Designer’s canvas, in the OTD Editor window. See Figure 19. In the example, a node in the OTD has been expanded, allowing you to view some of its structure. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 47: Steps To Edit An Existing Vsam Otd

    From the Project Explorer, right-click the OTD again and select Edit from the menu. The VSAMDatabase Connection Information wizard appears. Enter the connection information as described in “Connect To Database” on page 35, and click Next. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 48 Note: You must verify during project activation or at runtime that no errors are generated after editing an OTD. Errors could occur if you delete a database object such as a table or column that is included in a Collaboration. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 49: Using Vsam Otds

    OTD. This setup allows you to perform select, update, insert, and delete SQL operations in a table. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 50: Using The Select Method

    A Method box appears in the center pane of the Business Rules Designer. This box represents the chosen method. Note: Using the commit method is optional for all update operations because the Collaboration automatically commits the current transaction when it is done. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 51: Select Operations

    To update more than one column, you can repeat the Copy rule, as desired. Delete Operations 5.2.5 To perform a delete operation on a table From the Collaboration Editor (Java), call the delete method with the where clause specified, if necessary. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 52: Using Views

    To view the result set after the query is finished, create a while rule. For the condition, create a next method from the result set node ($Statement1Results in the example). You can continue creating your business logic by adding more Business Rules, if desired. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 53: Using Vsam Operations

    Chapter 6 Using VSAM Operations The database operations used in the VSAM eWay are used to access the VSAM database. Database operations are either accessed through Activities in BPEL, or through methods called from a JCD Collaboration. What’s in This Chapter VSAM eWay Database Operations (BPEL) on page 53 VSAM eWay Database Operations (JCD)
  • Page 54 Chapter 6 Section 6.1 Using VSAM Operations VSAM eWay Database Operations (BPEL) Figure 20 Input and Output Between Activities The following table lists the expected Input and Output of each database operation Activity. Table 10 VSAM Operations eInsight Operation Activity Input Activity Output SelectAll where() clause (optional)

  • Page 55: Vsam Eway Database Operations (Jcd)

    Chapter 6 Section 6.2 Using VSAM Operations VSAM eWay Database Operations (JCD) Table 10 VSAM Operations (Continued) eInsight Operation Activity Input Activity Output SelectOne where() clause (optional) Returns the first row that fits the condition of the where() clause. Insert definition of new item to be Returns status.

  • Page 56: The Query (Select) Operation

    Chapter 6 Section 6.2 Using VSAM Operations VSAM eWay Database Operations (JCD) SetScrollTypetoScrollSensitive SetScrollTypetoInsensitive The Query (Select) Operation To perform a query operation on a table: Execute the select() method with the “where” clause specified if necessary. Loop through the ResultSet using the next() method. Process the return record within a while() loop.

  • Page 57: The Insert Operation

    Chapter 6 Section 6.2 Using VSAM Operations VSAM eWay Database Operations (JCD) The Insert Operation To perform an insert operation on a table: Execute the insert() method. Assign a field. Insert the row by calling insertRow() This example inserts an employee record: package prjVSAM_JCDjcdALL;...

  • Page 58: The Update Operation

    Chapter 6 Section 6.2 Using VSAM Operations VSAM eWay Database Operations (JCD) FileClient_1.setText( "Done Insert." ); FileClient_1.write(); The Update Operation To perform an update operation on a table: Execute the update() method. Using a while loop together with next(), move to the row that you want to update. Assign updating value(s) to the fields of the table OTD Update the row by calling updateRow().

  • Page 59: Prepared Statement

    Chapter 6 Section 6.2 Using VSAM Operations VSAM eWay Database Operations (JCD) public com.stc.codegen.logger.Logger logger; public com.stc.codegen.alerter.Alerter alerter; public com.stc.codegen.util.CollaborationContext collabContext; public com.stc.codegen.util.TypeConverter typeConverter; public void receive( com.stc.connector.appconn.file.FileTextMessage input, otdVSAM.OtdVSAMOTD otdVSAM_1, dtd.otdOutputDTD_1935483687.Emp otdOutputDTD_Emp_1, com.stc.connector.appconn.file.FileApplication FileClient_1 ) throws Throwable FileClient_1.setText( "Delete record .." ); FileClient_1.write();...
  • Page 60 Chapter 6 Section 6.2 Using VSAM Operations VSAM eWay Database Operations (JCD) getPrepStatement().getPreparedStatementTest().addBatch(); getPrepStatement().getPreparedStatementTest().executeBatch(); VSAM eWay Adapter User’s Guide Sun Microsytems, Inc.

  • Page 61: Implementing The Vsam Eway Sample Projects

    VSAM database using a BPEL business process. Both the prjVSAM_JCD and prjVSAM_BPEL sample Projects demonstrate how to: Select employee records from the database using a prepared statement. Select employee records from the CICSEMP table. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 62: Operations Used In The Vsam Sample Projects

    BPEL_Insert_output0.dat BPEL_PsSelect_output0.dat BPEL_TableSelect_output0.dat BPEL_Update_output0.dat Operations Used in the VSAM Sample Projects 7.1.1 The following database operations are used in both BPEL and JCD sample Projects: Insert Update Delete Select (BPEL “SelectAll” Activity) VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 63: Assigning Operations In Jcd

    Using the eGate Enterprise Designer and eInsight, you can add an Activity to a Business Process, then associate that Activity with an eGate component, for example, an eWay. When eInsight run the Business Process, it automatically invokes that component via its Web Services interface. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 64: Running The Sample Projects

    The sample Projects provided with the VSAM eWay use input files to pass predefined data or conditions into the Collaboration or BPEL business process, which then transforms the database contents, and delivers the result set. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 65: Importing A Sample Project

    86 Creating the Deployment Profile on page 89 Creating and Starting the Domain on page 90 Building and Deploying the Project on page 91 Running the Sample Project on page 91 VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 66: Creating A Project

    Search for or type in the name of the database. In this example we use the CICSEMP table. Click Select when the database appears in the Results selection frame. Click OK to close the Add Tables window Click Next the Add Prepared Statements Wizard appears. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 67: Creating The Business Process

    Right-click your new Project in the Enterprise Designer’s Project Explorer, and select New > Business Process from the shortcut menu. The eInsight Business Process Designer appears and BusinessProcess1 is added to the Project Explorer tree. Rename BusinessProcess1 to bpInsert. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 68: Configuring The Bpinsert Modeling Elements

    Once you have connected the modeling elements together, begin adding the business processes necessary to facilitate the Insert operation. See Figure 21 for an illustration of how all the modeling elements appear when connected. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 69 Configure the business rule between FileClient.receive and FileClient.write Activities, as seen in Figure 22. Figure 22 bpInsert Business Rule # 1 Configure the business rule between the FileClient.write Activity and otdInputDTD_Emp.unmarshal Activity, as seen in Figure 23. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 70 Insert (Scope element), as seen in Figure 24. Figure 24 bpInsert Business Rule # 3 Configure the business rule in the While statement that connects to the otdVSAM.CICSEMPInsert Activity, as seen in Figure 25. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 71 Building and Deploying the prjVSAM_BPEL Sample Project Figure 25 bpInsert Business Rule # 4 Configure the business rule in the While statement that connects from the otdVSAM.CICSEMPInsert Activity, as seen in Figure 26. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 72: Configuring The Bpupdate Modeling Elements

    Business Process Designer. Once you have connected the modeling elements together, begin adding the business processes necessary to facilitate the Update operation. Figure 28 illustrates how all the modeling elements appear when connected. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 73 Configure the business rule between FileClient.receive and FileCleint.write Activities, as seen in Figure 29. Figure 29 bpUpdate Business Rule # 1 Configure the business rule between the FileClient.write Activity and otdVSAM.CICSEMPUpdate Activity, as seen in Figure 30. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 74: Configuring The Bpdelete Modeling Elements

    Note: The where clause in the business rule reads the trigger value as a placeholder for input. This permits you to modify the query to select a specific record. Also note that all records are selected from the database when the TriggerDelete.in file is empty. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 75 Activities, as seen in Figure 33. Figure 33 bpDelete Business Rule # 1 Configure the business rule between the FileClient.write Activity and otdVSAM.CICSEMPDelete Activity, as seen in Figure 34. Figure 34 bpDelete Business Rule # 2 VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 76: Configuring The Bptableselect Modeling Elements

    Figure 36 bpTableSelect Business Process Steps required to configure the bpTableSelect business process: Configure the business rule between FileClient.receive and FileClient.write Activities, as seen in Figure 37. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 77 Configure the business rule between the FileClient.write Activity and otdVSAM.CICSEMPSelectAll Activity as seen in Figure 38. Figure 38 bpTableSelect Business Rule # 2 Configure the business rule between the otdVSAM.CICSEMPSelectAll Activity and the otdInputDTD_Emp.marshal Activity as seen in Figure 39. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 78 Building and Deploying the prjVSAM_BPEL Sample Project Figure 39 bpSelectTable Business Rule # 3 Configure the business rule between the otdInputDTD_Emp.marshal Activity and the FileClient.write Activity as seen in Figure 40. Figure 40 bpTableSelect Business Rule # 4 VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 79: Configuring The Bppsselect Modeling Elements

    Figure 42 bpPsSelect Business Process Steps required to configure the bpPsSelect business process: Configure the business rule between FileClient.receive and FileCleint.write Activities as seen in Figure 43. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 80 Scope element. Figure 45 Activities within Case 1 Scope Configure the business rule between the start of the Scope element in Case 1 and the otdInputDTD_Emp.marshal Activity, as seen in Figure 46. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 81 Figure 46 Case 1 Scope Business Rule # 3 Configure the business rule between otdInputDTD_Emp.marshal Activity and FileClient.write Activity in the Scope element, as seen in Figure 47. Figure 47 Case 1 Scope Business Rule # 4 VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 82 FileClient.Write Activity, as seen in Figure 49. Figure 49 Case 2 Scope Business Rule # 5 Configure the business rule between the Decision.end Element and the FileClient.write Activity, as seen in Figure 50. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 83: Creating The Connectivity Map

    The icons in the toolbar represent the available components used to populate the Connectivity Map canvas. Populat the Connectivity Map Add the Project components to the Connectivity Map by dragging the icons from the toolbar to the canvas. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 84: Binding The Eway Components

    From the bpDelete Binding dialog box, map VSAM_otdVSAM (under Invoked Services) to the eaVSAMOUT External Application. From the bpDelete Binding dialog box, map FileReceiver to the FileClientOUT External Application, as seen in Figure 51. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 85: Creating An Environment

    Environment Explorer tree. Rename the new Environment to envVSAMProj. Right-click envVSAMProj and select New > VSAM External System. Name the External System esVSAM. Click OK. esVSAM is added to the Environment Editor. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 86: Configuring The Eways

    Project use three eWays that are represented as a nodes between the External Applications and the Business Process, as seen in Figure 53. You must configure eWay properties in both the Connectivity Map and the Environment Explorer. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 87: Configuring The Eway Properties

    Table 13 FileClientOUT eWay Property Settings Connectivity Map Property Name Required Values cmDelete Output file name BPEL_Delete_output%d.dat cmInsert Output file name BPEL_Insert_output%d.dat cmPsSelect Output file name BPEL_PsSelect_output%d.dat cmTableSelect Output file name BPEL_TableSelect_output%d.d cmUpdate Output file name BPEL_Update_output%d.dat VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 88: Configuring The Environment Explorer Properties

    TriggerTableSelect.in.~in TriggerUpdate.in.~in Configuration > Directory Enter the directory where Outbound File eWay > output files are written. In this Parameter Settings sample Project, the output files include: BPEL_Delete_output0.dat BPEL_Insert_output0.dat BPEL_PsSelect_output0.dat BPEL_TableSelect_output0. BPEL_Update_output0.dat VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 89: Configuring The Integration Server

    Enter a name for the Deployment Profile (for this sample dpVSAM_BPEL). Select envVSAMProj as the Environment and click OK. From the Deployment Editor toolbar, click the Automap icon. The Project’s components are automatically mapped to their system windows, as seen in Figure VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 90: Creating And Starting The Domain

    If there are no existing domains, a dialog box indicates that you can create a domain now. Click Yes. The Create Domain dialog box appears. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 91: Building And Deploying The Project

    EMPID = 100, to determine the type of output data. You can modify the following input files to view different output. TriggerTableSelect.in TriggerDelete.in TriggerUpdate.in VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 92: Building And Deploying The Prjvsam_Jcd Sample Project

    Project (Project1) appears on the Project Explorer tree. Click twice on Project1 and rename the Project (for this sample, prjVSAM_JCD). Creating the OTDs 7.6.2 The sample Project requires three OTDs to interact with the VSAM eWay. These OTDs include: VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 93 Click the OK button to close the Prepared Statement window, and then click Next on the Prepared Statements Wizard window. Enter an OTD name. In this example, use otdVSAM. Click Next and review your settings, then click Finish to create the OTD. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 94: Creating A Connectivity Map

    Add the Project components to the Connectivity Map by dragging the icons from the toolbar to the canvas. Each Connectivity Map in the prjVSAM_JCD sample Project requires the following components: File External Application (2) VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 95: Creating The Collaboration Definitions (Java)

    Collaboration Definitions (Java), or JCDs. Once you create the Collaboration Definitions, you can write the Business Rules of the Collaborations using the Collaboration Editor. JCDs required for the prjVSAM_JCD sample include: jcdDelete jcdInsert jcdPsSelect jcdTableSelect jcdUpdate VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 96: Jcddelete Collaboration

    SeeBeyond > eWays > File > FileClient. The Selected OTDs field now lists the FileClient OTD. Click Finish. The Collaboration Editor with the new jcdInsert Collaboration appears in the right pane of the Enterprise Designer. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 97: Jcdpsselect Collaboration

    In the same window, double-click otdOutputDTD_CICSEMP. The otdOutputDTD_CICSEMP OTD is added to the Selected OTDs field. Note: The otdOutputDTD_CICSEMP OTD is created from the otdOutputDTD.dtd that is included in the Sample Project. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 98: Jcdupdate Collaboration

    This permits you to modify the query to select a specific record. Also note that all records are deleted from the database when the TriggerDelete.in file is empty. The jcdDelete Collaboration contains the Business Rules displayed in Figure 55. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 99: Creating The Jcdinsert Business Rules

    The jcdInsert Collaboration contains the Business Rules displayed in Figure 56. Figure 56 jcdInsert Business Rules Sample code from the jcdInsert Includes: package prjVSAM_JCDjcdALL; public class jcdInsert public com.stc.codegen.logger.Logger logger; public com.stc.codegen.alerter.Alerter alerter; public com.stc.codegen.util.CollaborationContext collabContext; VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 100: Creating The Jcdpsselect Business Rules

    FileClient_1.setText( "Done Insert." ); FileClient_1.write(); Creating the jcdPsSelect Business Rules The jcdPsSelect Collaboration implements the Input Web Service Operation to read the TriggerPsSelect.in file. It then copies the database resultset (as noted in the prepared VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 101 FileClient_1 ) throws Throwable \\ Writes out a message stating records are being selected VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 102: Creating The Jcdtableselect Business Rules

    The jcdTableSelect Collaboration implements the Input Web Service Operation to read the TriggerTableSelect.in file. It then copies the database resultset into the otdInputDTD_CICSEMP OTD and selects all available records from the database that VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 103 FileClient_1 ) throws Throwable \\ Writes out a message stating records are being selected. FileClient_1.setText( "Selecting record(s) from CICSEMP table via table select .." ); FileClient_1.write(); VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 104: Creating The Jcdupdate Business Rules

    This permits you to modify the query to select a specific record. Also note that all records are selected from the database when the TriggerUpdate.in file is empty. The jcdUpdate Collaboration contains the Business Rules displayed in Figure 59. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 105: Binding The Eway Components

    From the bpDelete Binding dialog box, map otdVSAM_1 (under Invoked Services) to the eaVSAMOUT External Application. From the jcdDelete Binding dialog box, map FileClient_1 to the FileClientOUT External Application, as seen in Figure 60. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 106: Creating An Environment

    Environment Explorer tree. Rename the new Environment to envVSAMProj. Right-click envVSAMProj and select New > VSAM External System. Name the External System esVSAM. Click OK. esVSAM is added to the Environment Editor. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 107: Configuring The Eways

    Project use three eWays that are represented as a nodes between the External Applications and the Business Process, as seen in Figure 62. You must configure eWay properties in both the Connectivity Map and the Environment Explorer. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 108: Configuring The Eway Properties

    Table 16 FileClientOUT eWay Property Settings Connectivity Map Property Name Required Values cmDelete Output file name JCD_Delete_output%d.dat cmInsert Output file name JCD_Insert_output%d.dat cmPsSelect Output file name JCD_PsSelect_output%d.dat cmTableSelect Output file name JCD_TableSelect_output%d.d cmUpdate Output file name JCD_Update_output%d.dat VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 109: Configuring The Environment Explorer Properties

    TriggerTableSelect.in.~in TriggerUpdate.in.~in Configuration > Directory Enter the directory where Outbound File eWay > output files are written. In this Parameter Settings sample Project, the output files include: BPEL_Delete_output0.dat BPEL_Insert_output0.dat BPEL_PsSelect_output0.dat BPEL_TableSelect_output0. BPEL_Update_output0.dat VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 110: Configuring The Integration Server

    Enter a name for the Deployment Profile (for this sample dpVSAM_JCD). Select envVSAMProj as the Environment and click OK. From the Deployment Editor toolbar, click the Automap icon. The Project’s components are automatically mapped to their system windows, as seen in Figure VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 111: Creating And Starting The Domain

    If there are no existing domains, a dialog box indicates that you can create a domain now. Click Yes. The Create Domain dialog box appears. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 112: Building And Deploying The Project

    You can modify the following input files to view different output. TriggerTableSelect.in TriggerDelete.in TriggerUpdate.in Having no content in these files causes the operation to read all records. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 113 61 for more details on the types of output files used in this sample Project. The output files may change depending on the number of times you execute the sample Project, the input file, and also the content of your database table. VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 114: Index

    55 Insert 53 update(String sWhere) 55 ReceiveOne 53 updateRow() 55 SelectAll 53 SelectMultiple 53 SelectOne 53 Update 53 migration procedures 15 database operations (JCD) 55 delete(String sWhere) 55 deleteRow() 55 insert() 55 VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 115 SQL 55 SQL operations, table 55 SQL operations, table Delete 58 SQL operations, table Insert 57 SQL operations, table Select 56 SQL operations, table Update 58 supporting documents 10 Table SQL operations 55 VSAM eWay Adapter User’s Guide Sun Microsystems, Inc.

This manual is also suitable for:

Sun seebeyond eway 5.1.3

Table of Contents