Home
Sun SeeBeyond eWay(TM) IMS Adapter User`s Guide
Contents
1. Blue bold Hypertext links within See Text Conventions on page 9 document Blue underlined Hypertext links for Web http www sun com addresses URLs or email addresses 145 Screenshots Depending on what products you have installed and how they are configured the screenshots in this document may differ from what you see on your system Sun SeeBeyond eWay Adapter for IMS User s Guide 9 Sun Microsystems Inc Chapter 1 Section 1 5 Introducing the IMS eWay Related Documents 15 Related Documents The following Sun documents provide additional information about the Sun Java Composite Application Platform Suite eGate Integrator User s Guide Sun Java Composite Application Platform Suite Installation Guide 16 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 17 Documentation Feedback We appreciate your feedback Please send any comments or suggestions regarding this document to CAPS docsfeedback sun com Sun SeeBeyond eWay Adapter for IMS User s Guide 10 Sun Microsystems Inc Chapter 2 Installing the IMS eWay This chapter explains the procedures for installing the IMS eWay What s in This Chapter Before You Install on page 10 Installing the IMS eWay on page 10 After Installation on page 12 Extracting the Sample Projects and Java
2. HE FileClient input pa FileClient FileClie _ Minimize the Service1 Binding dialog box and save your current changes to the Repository 55 7 Creating an Environment Environments include the external systems Logical Hosts integration servers and message servers used by a project and contain the configuration information for these components 1 From the Enterprise Designer s Enterprise Explorer click the Environment Explorer tab Right click the Repository and select New Environment A new Environment is added to the Environment Explorer tree Rename the new Environment to MFS_IMS_Sample_Env Right click MFS_IMS_Sample_Env and select New File External System Name the External System FileExtSysInOut and Click OK FileExtSysInOut is added to the Environment Editor Modify both the Inbound and Outbound properties of the File eWay and click OK Right click MFS_IMS_Sample_Env and select New Logical Host The LogicalHost1 box is added to the Environment and LogicalHost1 is added to the Environment Editor tree Right click LogicalHost1 and select Sun SeeBeyond Integration Server from the shortcut menu A new Integration Server IntegrationSvr1 is added to the Environment Explorer tree under LogicalHost see Figure 38 Sun SeeBeyond eWay Adapter for IMS User s Guide 66 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing an IMS eWay Project The prjMFS_IMS_JCD_Sample Project Figure 38 Envir
3. IRM_F1 MFS MOD Names Specifies whether the MFS Message Output Descriptor MOD is returned as part of the output MFS The user requests that MFS MOD name be returned NO_MEFS The user requests that no MFS MOD name be returned When MEFS is specified a Request Mod Message RMM is returned as the first structure of the output message This structure contains an ID of REQMOD followed by the MFS MOD name For details see IBM s IMS Connect Guide and Reference SC27 0946 00 page 59 MFS or NO_ MES The default is NO_MEFS Sun SeeBeyond eWay Adapter for IMS User s Guide 24 Sun Microsystems Inc Chapter 3 Configuring the IMS eWay Section 3 3 IMS eWay Environment Explorer Properties Table 6 Environment IRM Header Settings Name Description Required Value IRM_F2 COMMIT MODE Specifies the Commit Mode COMMIT_MODE_0 Also known as commit then send COMMIT_MODE_1 Also known as send then commit For a full description of the IRM header see IBM s IMS Connect Guide and Reference SC27 0946 00 COMMIT_MODE_0 or COMMIT_MODE_1 The default is COMMIT_MODE_1 Note The default for this property was changed from the previous version IRM_F3 Sync Level Specifies whether the message is to be confirmed with an ACK for Commit Mode 1 processing For Commit Mode 0 IRM_F3 must be set to SYNC_LEVEL_CONFIRM SYNC_LEVEL_CONFIRM Must be used when the IRM_
4. Boolean String Nodes Number curt im ef Business Process Attributes Business Process Attributes WE FileClient receive Output IMS IMSRequest Input BTE text input server pot amp message bands tranCode tranCodeSre datastorelD ItermName racfUserlD racf roupName C gt pason e ms Br 4 To configure the second Business Rule click on the Business Rule in the link between the IMS_eWay IMSRequest and FileClient write Activities This Business Rule is now displayed in the Business Rules Designer 5 Map reply under IMS_eWay IMSRequest Output gt output in the Output pane of the Business Rules Designer to text under FileClient write Input in the Input pane as displayed in Figure 11 Figure 11 elnsight Business Rules Designer Business Rule Designer Conversion Datetime Operator Boolean String Nodes Number E it tue Business Process Attributes Business Process Attributes 08 IMS IMSRequest Output FileClientavrite Input 8 GB output text L reply ims_ep 6 When the Business Process is complete from the elnsight Business Process Designer toolbar click the Synchronize Graphical Model and Business Process Code icon to synchronize the graphical interface to the Business Process code 7 Save your changes to the Repository 45 3 Creating a Connecti
5. Sun SeeBeyond eWay Adapter for IMS User s Guide 39 Sun Microsystems Inc Chapter 4 Section 4 5 Using the IMS eWay With elnsight The prjIMS_BP_Sample Project terprise Exp RepositoryName HEAD prilMS_BP_Sample gt B BP1 H 2o B cmIMS_BP E eaFilein E ge eaFileout L ge ealms Sun SeeBeyond fe b eaFileln pl G b 2 eaFileOut 3 Double click cmIMS_BP The BP_IMS_Service Binding dialog box appears using the IMS_BP Rule 4 From the BP_IMS_ Service Binding dialog box drag FileSender under Implemented Services to the eaFileIn File External Application 5 From the BP_IMS_Service Binding dialog box drag IMS_Receiver under Invoked Services to the IMS External Application 6 From the BP_IMS_Service Binding dialog box drag FileReceiver to the eaFileOut External Application see Figure 15 Minimize the BP_IMS_ Service Binding dialog box by clicking the chevrons in the upper right corner Figure 15 Connectivity Map Associating Binding the Project s Components o amp 8 OC ef gt a IMS IMS_BPEL_Service fo Rule IMS_BP gt Filel FileOut mn Implemented Services Invoked Services L i FileSender FileSender LE FileRec FileRec 7 Save your current changes to the Repository 455 Creating an Environment Environments include the external systems Logical Hosts integration servers and JMS IQ Managers used by a project and contain the
6. Chapter 4 Using the IMS eWay With elnsight elnsight Engine and Components The IMS eWay With elnsight Steps Required to Run the Sample Projects Importing a Sample Project The prjIMS_BP_Sample Project Creating a Project Creating a Business Process Creating the Business Process Flow Configuring the Modeling Elements Creating a Connectivity Map Selecting the External Applications Populating the Connectivity Map Binding the eWay Components Creating an Environment Configuring the eWays Configuring the IMS eWay Creating the Deployment Profile Creating and Starting the Domain Building and Deploying the Project Running the Sample Project Chapter 5 Implementing an IMS eWay Project IMS eWay Components IMS eWay Sample Projects Importing a Sample Project Sun SeeBeyond eWay Adapter for IMS User s Guide 4 32 32 33 33 33 34 34 34 35 36 37 38 38 39 40 41 42 43 43 44 44 45 45 46 46 Sun Microsystems Inc Contents The prjIMS_JCD_Sample Project Create a Project Create a Connectivity Map Select the External Applications Populate the Connectivity Map Creating the Collaboration Definitions The IMS_Collab Collaboration Java Using the Collaboration Editor Java Creating the IMS_Java_Collab Collaboration Creating Collaboration Bindings Creating an Environment Configure the eWays Configuring the IMS eWay Configuring the Integration Server Creating the Deployment Profile Creating and Sta
7. Chapter 5 Section 5 4 Implementing an IMS eWay Project The prjIMS_JCD_Sample Project Figure 21 Connectivity Map with Components o aoee So Service 2 Rename the objects by right clicking the object selecting Rename from the shortcut menu and typing in the new name Change the names as follows Filel to eaFileIn Servicel to jcolIMS File2 to eaFileOut IMS1 to eaIMS 3 Save your current changes to the Repository 543 Creating the Collaboration Definitions The next step in the sample is to create one Collaboration using the Collaboration Definition Wizard Java Once a Collaboration Definition has been created the Business Rules of the Collaboration can be written using the Collaboration Editor Java The IMS_ Collab Collaboration Java The jcdIMS Collaboration defines transactions from the inbound File eWay to the IMS eWay and from the IMS application to the outbound File eWay 1 From the Project Explorer right click the prjIMS_JCD_Sample project and select New gt Collaboration Definition Java from the shortcut menu The Collaboration Definition Wizard Java appears 2 Enter a Collaboration Definition name for this project j dIMS and click Next 3 For Step 2 of the wizard Select a Web Services Operation Double click Sun SeeBeyond gt eWays gt File gt FileClient gt receive The File Name field now displays receive Click Next 4 For Step 3 of the wizard from the Select OTDs to be used in t
8. Composite Application Platform Suite 5 1 2 Repository These APIs may or may not apply to your Projects You can ignore this message if you have already installed all of the components that correspond to your Projects Click Continue to resume the Project import 4 Close the Import Manager after the Project is successfully imported Deploy the Project 1 Anew Deployment Profile must be created for each of your imported Projects When a Project is exported the Project s components are automatically checked in to Version Control to write protected each component These protected components Sun SeeBeyond eWay Adapter for IMS User s Guide 13 Sun Microsystems Inc Chapter Section 2 6 pter 2 Installing the IMS eWay Installing Enterprise Manager eWay Plug Ins 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 D 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 Select Recurse Project to specify all components and click OK Select the Environment Explorer tab and from the Environment Explorer right click the Pro
9. IRM_TRNCOD_SRC 27 Sun Microsystems Inc Index J Java Collaboration using the editor 49 Collaboration Definitions 49 Collaboration Editor 50 Javadocs installing 12 L Logical Host Environment 41 M MFS sample project 59 wizard 61 overview 45 O organization of information 7 Outbound Connectivity Map Properties 20 P parameters Connector 20 Port 22 Plug Ins Installing 14 Project importing 33 project creating 34 47 Properties WebLogic eWay 17 properties 56 74 Class 20 configuring 41 Connectivity Map 20 Connectivity Map properties modifying 18 Connector 20 Environment properties modifying 18 IRM Header 22 IRM_CLIENTID 24 IRM_DESTID 27 IRM_F1 24 IRM_F2 25 IRM_F3 25 Sun SeeBeyond eWay Adapter for IMS User s Guide IRM_F4 26 IRM_F5 27 IRM_HEADER_ENCODING 28 IRM_ID 23 IRM_LEN 23 IRM_LTERM 27 IRM_RACF_GRNAME 27 IRM_RACF_PW 28 IRM_RACF_USERID 28 IRM_SOCT 24 IRM_TIMER 23 IRM_TRNCOD 27 IRM_TRNCOD_SRC 27 modifying Connectivity Map properties 18 Port 22 REPLY_DATA_ENCODING 28 SEND_DATA_ENCODING 28 Server 22 TCPIP Configuration 22 Type 20 Properties Editor 19 R REPLY_DATA_ENCODING 28 S sample projects installing 12 samples importing 45 Java Collaboration samples 45 screenshots 9 SEND_DATA_ENCODING 28 Server 22 T TCPIP Configuration 22 text conventions 8 Type 20 W WebLogic eWay Setting Properties 17 Wizard IMS MFS 61 71 Sun Microsystems I
10. About Information Management System IMS on page 6 About the IMS eWay on page 6 About This Document on page 8 Related Documents on page 10 Sun Microsystems Inc Web Site on page 10 Documentation Feedback on page 10 11 About Information Management System IMS IBM s IMS is a database and transaction management system that provides an interface for users to access information in various databases via on line transactions The IMS TM Transaction Manager is a message based transaction processor that handles the execution of specific business application programs The IMS DB Database is an entirely separate component providing access to the IMS hierarchical database for applications running under the IMS TM as well as IMS transaction monitor and OS 390 batch jobs 12 About the IMS eWay The IMS eWay enables eGate to connect with IBM s IMS TM mainframe applications through IBM s IMS Connect See Figure 1 on page 7 Sun SeeBeyond eWay Adapter for IMS User s Guide 6 Sun Microsystems Inc Chapter 1 Section 1 3 Introducing the IMS eWay What s New in This Release Figure 1 IMS eWay and the IMS Environment z OS amp OS 390 IMS eGate Cross TCP IP IMS Coupling Open N Connect Facility Transaction IMS XCF Manager Application Access Program OTMA The eWay provides access to the Input and Output Descriptors MID MOD of the IMS applicat
11. Designer canvas 6 To create the Copy IMS_1 Reply to FileClient_1 Text rule do the following A From the Business Rules toolbar click the rule button to add a new rule B Right click the IMS_1 node in the left pane of the Business Rules Designer and select Select a method to call from the shortcut menu The method selection box appears C Select IMSReply from the method selection box The IMSReply method box appears in the Business Rules Designer canvas D Map the Result String output node of the IMSReply method box to Text under FileClient_1 in the right pane of the Designer see Figure 26 Sun SeeBeyond eWay Adapter for IMS User s Guide 52 Sun Microsystems Inc Chapter 5 Section 5 4 Implementing an IMS eWay Project The prjIMS_JCD_Sample Project Figure 26 Copy IMS_1 Reply to FileClient_1 Text Business Rule Business Rules Designer go ma THBoolean gt Comparison Math gt 4 Objecty AStringy i Array 8 Operators Copy IMS_1 Reply to FileClient_1 Text O ye IMS_Java_Collab A IMS_Java_Collab 3 IE FileClient_1 sil FileClient_1 2 QE IMS 1 IMS Client ETD Ar L E RacfUserlD IMS 1 PE O LE RactGroupName result String E Password input E OE myContigs MII input om ByteArray L Text es O IMS_Java_Collab 7 To create the IMS__1 disconnect rule do the following A From the Business Rules toolbar click the rule button to add a new rule B Rig
12. Environment Explorer For more information on the IMS eWay configuration properties and the Properties Window see Creating and Configuring the IMS eWay on page 17 or refer to the eGate Integrator User s Guide Modifying the IMS eWay Connectivity Map Properties 1 From the cmIMS_JCD Connectivity Map double click the IMS eWay The Properties Window opens to the IMS eWay Project Explorer configuration properties Sun SeeBeyond eWay Adapter for IMS User s Guide 56 Sun Microsystems Inc Chapter 5 Section 5 4 Implementing an IMS eWay Project The prjIMS_JCD_Sample Project 2 Modify the IMS eWay Project Explorer properties for your system and click OK For more information on these properties refer to IMS eWay Connectivity Map Properties on page 20 3 Double click the IMS eWay located between the jcolIMS service and the eaIMS External Application Modify the IMS eWay configuration for your system and click OK Modifying the IMS eWay Environment Explorer Properties 1 From the Environment Explorer tree right click the IMS External System IMSExtSys in this sample and select Properties The Properties Window opens to the IMS eWay environment configuration properties 2 Modify the IMS eWay environment configuration for your system and click OK For more information on these properties refer to IMS eWay Environment Explorer Properties on page 21 548 Configuring the Integration Server You must set your SeeBeyond Integration Ser
13. MFS Wizard Select MSF file eps Select your MFS Files 1 Select Vizard Type Browse Files Look in id 9 BE 2 Select Input Files _ MFSSAMP nfs File Name dfsivfl fs Files oftype MFS File Type z _ select _ Cancel Selected Files NAMS _evvay_UGIS les MS tdfsivf1 _eWay_l amples siv E meee Back Next gt Finish Cancel Help 4 Click Finish and save your changes to the Repository The OTD Editor now displays the successfully created dfsivf OTD and the OTD is added to the Project Explorer tree 55 4 Create the Collaboration Definitions The next step in the sample is to create a Collaboration using the Collaboration Definition Wizard Java and Business Rules using the Collaboration Editor The JavaCollaborationMFS Collaboration The JavaCollaborationMFS Collaboration defines transactions from the inbound File application converts the MFS data and sends the data to the outbound File application 1 From the Project Explorer right click the current project and select New gt Collaboration Definition Java from the shortcut menu The Collaboration Definition Wizard appears 2 Enter a Collaboration Definition name for this project j dMFS_IMS and click Next Sun SeeBeyond eWay Adapter for IMS User s Guide 63 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing an IMS eWay Project The prjMFS_IMS_JCD_Sample Project 3 For Step 2 of the wizard Select a Web Services Op
14. Microsystems Inc Chapter 5 Section 5 4 Implementing an IMS eWay Project The prjIMS_JCD_Sample Project Figure 32 Deployment Profile Auto Map Environment IMS_JCD_Sample_Env B dhMapVariables f Build f Deploy Z Automap gicalho db jcollMs Sk B Integrations jcollMS gt ealms E jcollms gt eaFileOut L E eaFilein gt jcollms 5410 Creating and Starting the Domain To build and deploy your Project you must first create a domain A domain is an instance of a Logical Host After the domain is created the Project is built and then deployed Note You are only required to create a domain once when you install the Composite Application Platform Suite Steps required to create and start the domain 1 Navigate to your lt caps51 gt logicalhost directory where lt caps51 gt is the location of your Sun Java Composite Application Platform Suite installation 2 Double click the domainmgr bat file The Domain Manager appears 3 If you have already created a domain select your domain in the Domain Manager and click the Start an Existing Domain button Once your domain is started a green check mark indicates that the domain is running 4 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 5 Make any necessary changes to the Create Domain dialog box and click Create The new domain is added to the Domain Ma
15. 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 the ZIP file field 6 Click Export to create the Project ZIP file in the selected destination Install Sun Java Composite Application Platform Suite 5 1 2 1 Install the Sun Java Composite Application Platform Suite including all eWays libraries and other components used by your ICAN 5 0 Projects 2 Start the Composite Application Platform Suite 5 1 2 Enterprise Designer Import the Project 1 From the Composite Application Platform Suite 5 1 2 Enterprise Designer s Project Explorer tree right click the Repository and select Import Project from the shortcut menu The Import Manager appears 2 Browse to and select your exported Project file 3 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
16. The prjMFS_IMS_JCD_Sample project uses the MFS OTD to compose IVTNO transaction messages 1 An inbound File eWay supplies last names with which to create IVTNO DISPLAY transactions 2 The MFS OTD is used to compose a transaction message for each supplied name populating the OTD with the data and the transaction command DISPLAY 3 The OTD formats the message which is passed through the IMS eWay to the IMS application 4 The response is sent back to the MFS OTD allowing field by field access to its content 5 An outbound File eWay spools select portions of each transaction response to a flat file IMS Application Response Error Messages The Java Collaboration in the prj MFS_IMS_JCD_Sample project includes a rule that causes each IMS application response to be logged as an error message in the Integration Server s log This it is not an actual error but is logged as such to display the response content as part of the demonstration without the need for the user to enable debug logging and contend with more extraneous messages Sun SeeBeyond eWay Adapter for IMS User s Guide 59 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing an IMS eWay Project The prjMFS_IMS_JCD_Sample Project 55 1 Create a project The first step is to create and name a new project in eGate Enterprise Designer 1 From the Enterprise Explorer pane of the Enterprise Designer right click the Repository and select New Project A new project appea
17. Using the IMS MFS Wizard The IMS MFS Wizard creates an OTD from an MFS data file Sample MFS files are provided with the IMS eWay sample on the Installation CD ROM For this sample copy the dfsivf mfs file to a temporary directory 1 From the Project Explorer tree right click the prj MFS_IMS_JCD_Sample project and select New gt Object Type Definition from the shortcut menu The Object Type Definition Wizard appears 2 From the Select Wizard Type box select IMS MFS Wizard and click Next see Figure 34 Sun SeeBeyond eWay Adapter for IMS User s Guide 61 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing an IMS eWay Project The prjMFS_IMS_JCD_Sample Project Figure 34 IMS MFS Wizard Select Wizard Type Steps Select Wizard Type 1 Select Wizard Type OTD Wizard Description DTD Uses a DTD to create an OTD IMS MFS Wizard Uses an IMS MFS to create an OTD User Defined Allows the user to create a custom OTD a UD OTD from Uses a text file to create a custom OTD XSD Uses an XSD to create an OTD Back Next Finish _ cancel Hem 3 For step two of the wizard Select Input Files browse to the sample MFS file dfsivf mfs Click Select to add the file to the Selected Files box see Figure 35 Sun SeeBeyond eWay Adapter for IMS User s Guide 62 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing an IMS eWay Project The prjMFS_IMS_JCD_Sample Project Figure 35 IMS
18. the Connectivity Map cmIMS_JCD Select the External Applications The icons on the Connectivity Map toolbar represent the available components used to populate the Connectivity Map canvas When creating a Connectivity Map the eWays are associated with external systems For example to establish a connection to IMS you must first select IMS as an External Application to use in your Connectivity Map see Figure 20 The IMS External Application icon is then added to the Connectivity Map toolbar Figure 20 Connectivity Map External Applications Oo E File External Application o Scheduler To add the External Applications used with the IMS_JCD_Sample project do the following 1 Click the External Application icon on the Connectivity Map toolbar 2 Select the external systems that are necessary for your project for this sample IMS and File Icons representing the selected external systems are added to the Connectivity Map toolbar Populate the Connectivity Map Add the project components to the Connectivity Map by dragging the icons from the toolbar to the canvas 1 For this sample drag the following components onto the Connectivity Map canvas as displayed in Figure 21 File External System 2 Service A Service is a container for Java Collaborations Business Processes eTL processes and so forth IMS External System Sun SeeBeyond eWay Adapter for IMS User s Guide 48 Sun Microsystems Inc
19. toolbar to the canvas 1 For this sample drag the following components onto the Connectivity Map canvas as displayed in Figure 13 File External System 2 Service A service is a container for Java Collaborations Business Processes eTL processes and so forth This can also be created by dragging the Business Process over from the Project Explorer tree IMS External System Sun SeeBeyond eWay Adapter for IMS User s Guide 38 Sun Microsystems Inc Chapter 4 Section 4 5 Using the IMS eWay With elnsight The prjIMS_BP_Sample Project Figure 13 Connectivity Map with Components G amp amp e amp GebB Sh Service 2 Rename the Connectivity Map objects by right clicking the object s name selecting Rename from the shortcut menu and typing the new name Rename the objects as follows Filel to eaFileIn Servicel to BP_IMS IMS1 to eaIMS File2 to eaFileOut 3 Save your changes to the Repository 454 Binding the eWay Components After the Business Processes have been written the components are associated and bindings are created in the Connectivity Map 1 From the Project Explorer double click the Connectivity Map cmIMS_BP The Enterprise Designer canvas now displays the Connectivity Map 2 Drag and drop the BP1 Business Process from the Project Explorer onto the Service BP_IMS If the Business Process was successfully associated the Service s icon changes to a Business Process icon see Figure 14
20. Domain dialog box appears 5 Make any necessary changes to the Create Domain dialog box and click Create The new domain is added to the Domain Manager Select the domain and click the Start Sun SeeBeyond eWay Adapter for IMS User s Guide 43 Sun Microsystems Inc Chapter 4 Section 4 5 Using the IMS eWay With elnsight The prjIMS_BP_Sample Project an Existing Domain button Once your domain is started a green check mark indicates that the domain is running Note For more information about creating and managing domains see the eGate Integrator System Administration Guide 45 9 Building and Deploying the Project The Build process compiles and validates the Project s Java files and creates the Project EAR file Build the Project 1 From the Deployment Editor toolbar click the Build icon 2 If there are any validation errors a Validation Errors pane will appear at the bottom of the Deployment Editor and displays information regarding the errors Make any necessary corrections and click Build again 3 After the Build has succeeded you are ready to deploy your Project Deploy the Project 1 From the Deployment Editor toolbar click the Deploy icon Click Yes when the Deploy prompt appears 2 A message appears when the project is successfully deployed You can now test your sample 45 10 Running the Sample Project To run your deployed sample Project do the following 1 From your configured input directory paste or rena
21. F2 parameter commit mode is set to COMMIT_MODE_O SYNC_LEVEL_NONE No Sync level SYNC_LEVEL_CONFIRM or SYNC_LEVEL_NONE If the IRM_F2 property is set to COMMIT_MODE _0 the Sync level must be set to SYNC_LEVEL_CONFIRM The default is SYNC_LEVEL_NONE Note The default for this property was changed from the previous version Sun SeeBeyond eWay Adapter for IMS User s Guide 25 Sun Microsystems Inc Chapter 3 Configuring the IMS eWay Section 3 3 IMS eWay Environment Explorer Properties Table 6 Environment IRM Header Settings Name Description Required Value IRM_F4 ACK NAK Response Specifies the ACK NAK positive negative acknowledgement response expression sent to IMS Connect and forwarded to IMS The ACK NAK DEALLOCATE RESUME A N D R values must be sent to IMS Connect with no data element NO_ACK No request for acknowledgment or deallocation When a response mode transaction or conversational transaction is being sent to IMS Connect IRM_F4 must be set to NO_ACK ACK Positive acknowledgment used in response to a message sent to the client where the SYNC level is set to CONFIRM SYNC _LEVEL_CONFIRM DEALLOCATE Deallocate connection Used to terminate a conversation before the conversation is complete NACK Negative acknowledgment Used in response to a message sent to the client where the SYNC level is set to CONFIRM SYNC _LEVEL_CONFIRM RESUME Resume TPIPE
22. Inc Chapter 2 Section 2 6 Installing the IMS eWay Installing Enterprise Manager eWay Plug Ins For information on Managing and Monitoring alert codes and logs see the Sun SeeBeyond eGate Integrator System Administration Guide Sun SeeBeyond eWay Adapter for IMS User s Guide 16 Sun Microsystems Inc Chapter 3 Configuring the IMS eWay This chapter describes how to configure the IMS eWay properties and provides a list of the eWay properties and their required values What s in This Chapter Creating and Configuring the IMS eWay on page 17 IMS eWay Connectivity Map Properties on page 20 IMS eWay Environment Explorer Properties on page 21 31 Creating and Configuring the IMS eWay All eWays contain a set of parameters with properties that are unique to that eWay type The IMS eWay properties are modified from these locations Connectivity Map These parameters most commonly apply to a specific component eWay and may vary from other eWays of the same type in the Project Environment Explorer These parameters are commonly global applying to all eWays of the same type in the Project The saved properties are shared by all eWays in the IMS External System window Collaboration or Business Process IMS eWay properties may also be set from your Collaboration or Business process in which case the settings will override the corresponding properties in the eWay s configuration file Any properties that are not overri
23. SUN SEEBEYOND eWAY ADAPTER FOR IMS 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
24. The IMSClientETD OTD is provided with the eWay and contains methods and attributes that are used to create the Business Rules that invoke the IMS program The nodes of the OTD take their initial value from the eWay Connection configuration parameters but can be changed in the Collaboration IMS MFS Wizard The IMS MFS Wizard builds an Object Type Definition from an IMS message format service MFS file The wizard generates Object Type Definitions OTDs that map input Sun SeeBeyond eWay Adapter for IMS User s Guide 45 Sun Microsystems Inc Chapter 5 Section 5 2 Implementing an IMS eWay Project IMS eWay Sample Projects and output message segments at the field level The two sample projects that employ the IMS MFS Wizard are described in the following sections The MFS IMS JCD Project on page 61 The MFS JCD Project on page 71 52 IMS eWay Sample Projects Three sample projects are described in this chapter to demonstrate how eWay components are created and implemented in a production environment These sample eWay projects are included as part of the installation CD ROM package The prjIMS_JCD_Sample Project on page 47 demonstrates connectivity with an IMS system The prjMFS_IMS_JCD_Sample Project on page 59 demonstrates the IMS MFS Builder The prjMFS_JCD_Sample Project on page 69 demonstrates the use of the MFS OTD to compose IVTNO transaction messages 53 Importing a Sample Project To import a sample eWay p
25. Used to request Asynchronous output data from IMS Resume must execute ona transaction socket as COMMIT_MODE_0 SENDONLY Send only used for a non response transaction and for sending data to IMS SENDONLY must execute as COMMIT MODE 0 Select one of the six options The configured default is NO_ACK Sun SeeBeyond eWay Adapter for IMS User s Guide 26 Sun Microsystems Inc Chapter 3 Configuring the IMS eWay Section 3 3 IMS eWay Environment Explorer Properties Table 6 Environment IRM Header Settings Name Description Required Value IRM_F5 Flow Control Specifies Flow Control properties Sun recommends using the default value No_Auto_Flow Note Contact Sun Support before using any value other than No_Auto_Flow Client_Translation Translation is done by the client Single_Message Returns only one message on receive following the resume TPIPE No_Auto_Flow No message auto flow see meaning for No_Auto_Flow_Out Auto_Flow_Out Auto message flow Returns all current messages one at a time and waits on the last receive for the next message for IRM_TIMER value Set the IRM_TIMER high Use this only for a dedicated output client No_Auto_Flow_Out No message auto flow Returns all current messages one at a time and waits on the last receive for the next message for IRM_TIMER value Set the IRM_TIMER low Use this only for a dedicated output client This value is similar to Auto_Flow
26. Way while Javadocs provide a list of classes and methods exposed in the eWay Steps to extract the Sample Projects and Javadocs include 1 From the Documentation tab of the Enterprise Manager click IMS to view the list of files available for this product 2 Click Download Sample to open the IMS_eWay_Sample zip file 3 Use WinZip to extract the sample files to a desired location Note that the IMS_eWay_Sample zip file contains two additional ZIP files for each sample Project 4 Click Download Javadocs to open the IMS_eWay_Javadoc zip file 5 Use WinZip to extract the Javadocs files to a desired location Refer to Importing a Sample Project on page 46 for instructions on importing the sample Project into your repository via the Enterprise Designer Sun SeeBeyond eWay Adapter for IMS User s Guide 12 Sun Microsystems Inc Chapter 2 Section 2 5 Installing the IMS eWay ICAN 5 0 Project Migration Procedures 25 ICAN 5 0 Project Migration Procedures This section describes how to transfer your current ICAN 5 0 Projects to the Sun Java Composite Application Platform Suite 5 1 2 To migrate your ICAN 5 0 Projects to the Sun Java Composite Application Platform Suite 5 1 2 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
27. _Out as described above except that the IRM_TIMER causes the last receive to terminate The recommended setting is No_Auto_Flow default IRM_TRNCOD Specifies the default IMS transaction code A valid transaction code IRM_TRNCOD_SRC Specifies where the transaction code is taken CFG The transaction code is to be taken from the configuration file MESSAGE the transaction code is the first 8 bytes of the message Select one of the two options The configured default is CFG IRM_DESTID Specifies the Datastore name IMS String set A Datastore name destination ID This field is required IMS destination ID character string IRM_LTERM Specifies the IMS LTERM override name The appropriate LTERM name This field can be set to a name or blank or blank IRM_RACF_GRNAM E Specifies the RACF Group Name The client must provide the RACF group name if RACF is to be used Sun SeeBeyond eWay Adapter for IMS User s Guide 27 The appropriate RACF group name Sun Microsystems Inc Chapter 3 Configuring the IMS eWay Section 3 3 IMS eWay Environment Explorer Properties Table 6 Environment IRM Header Settings Name Description Required Value IRM_RACF_USERID Specifies the RACF User ID The client must provide the RACF user ID if RACF is used A valid RACF user ID IRM_RACF_PW Specifies the RACF PASSTICKET The client must provide the RACF PASSTICKET
28. ain is added to the Domain Manager Select the domain and click the Start an Existing Domain button Once your domain is started a green check mark indicates that the domain is running Note For more information about creating and managing domains see the eGate Integrator System Administration Guide 569 Building and Deploying the Project The Build process compiles and validates the Project s Java files and creates the Project EAR file Build the Project 1 From the Deployment Editor toolbar click the Build icon 2 If there are any validation errors a Validation Errors pane will appear at the bottom of the Deployment Editor and displays information regarding the errors Make any necessary corrections and click Build again 3 After the Build has succeeded you are ready to deploy your Project Deploy the Project 1 From the Deployment Editor toolbar click the Deploy icon Click Yes when the Deploy prompt appears Sun SeeBeyond eWay Adapter for IMS User s Guide 75 Sun Microsystems Inc Chapter 5 Section 5 6 Implementing an IMS eWay Project The prjMFS_JCD_Sample Project 2 A message appears when the project is successfully deployed You can now test your sample 5 6 10 Running the Sample Project To run your deployed sample Project do the following 1 From your configured input directory paste or rename the sample input file to trigger the eWay 2 From your output directory verify the output data Sun SeeBeyond
29. al Application see Figure 29 Sun SeeBeyond eWay Adapter for IMS User s Guide 54 Sun Microsystems Inc Chapter 5 Section 5 4 Implementing an IMS eWay Project The prjIMS_JCD_Sample Project 7 Figure 29 Connectivity Map Connecting the Project s Components o amp QG e e B GT RE gl Heb IMS_ Service Fileln Rule IMS_Java_Collab Implemented Services Invoked Services Minimize the IMS_Service dialog box and save your current changes 546 Creating an Environment Environments include the external systems Logical Hosts integration servers and message servers used by a project as well as containing the configuration information for these components Environments are created using the Enterprise Designer s Environment Explorer and Environment Editor 1 From the Enterprise Designer s Enterprise Explorer click the Environment Explorer tab Right click the Repository and select New Environment A new Environment is added to the Environment Explorer tree Rename the new Environment to IMS_JCD_Sample_Env Right click IMS_JCD_Sample_Env and select New IMS External System Name the External System IMSExtSys IMSExtSys is added to the Environment Editor Right click IMS_JCD_Sample_Env and select New File External System Name the External System FileExtSysInOut and Click OK FileExtSysInOut is added to the Environment Editor Modify both the Inbound and Outbound properties of the File eWa
30. as business rules Dynamic Generation of IMS Client ID This parallel mode allows the IMS eWay to be configured to handle multiple requests simultaneously Sun SeeBeyond eWay Adapter for IMS User s Guide 7 Sun Microsystems Inc Chapter 1 Section 1 4 Introducing the IMS eWay About This Document Support for Runtime LDAP Configuration Configuration properties now support LDAP key values Connection Pooling Connections can be reused to reduce the overhead of creating a physical connection Connection Retry Support Allows you to specify the number of attempts to reconnect and the interval between retry attempts in the event of a connection failure Wait Timeout A new Serial Mode parameter part of the Environment Explorer properties controls how long in milliseconds a request thread will wait for a request lock Relaunchable OTD Support An OTD can be rebuilt and saved under the same name then relaunched back to the same Java Collaboration or BPEL This allows you to change the metadata in an OTD without having to completely recreate the business logic from scratch Connectivity Map Generator Generates and links your Project s Connectivity Map components using a Collaboration or Business Process IRM_TIMER Parameter Enhanced to provide additional flexibility allowing the user to specify values ranging from 01 secs to 70 minutes Support for IMS Connect 9 1 Many of these features are documented
31. as with the following activities from the Project Explorer tree as displayed in Figure 7 receive under Sun SeeBeyond gt eWays gt File gt FileClient IMSRequest under Sun SeeBeyond gt eWays gt IMSeWay gt IMS_eWay write under Sun SeeBeyond gt eWays SeeBeyond gt File gt FileClient Figure 7 elnsight Business Process Designer Populate the Canvas No amp Wag 2oeaG40ea8ao 0 00 a xt bp 3p FileClient receive IMS IMSRequest FileClient write End 4 Link the modeling elements by clicking on the element s connector and dragging the cursor to the next element s connector making the following links as displayed in Figure 8 Start gt FileClient receive FileClient receive gt IMS_eWay IMSRequest IMS_eWay IMSRequest gt FileClient write FileClient write gt End Sun SeeBeyond eWay Adapter for IMS User s Guide 35 Sun Microsystems Inc Chapter 4 Section 4 5 Using the IMS eWay With elnsight The prjIMS_BP_Sample Project Figure 8 elnsight Business Process Designer Link the Modeling Elements xo BOS lux BAoBbHSBS gt OC 00 4 Or Start Fp E gt FileClient receive IMS eWay IMSRequest FileClient Configuring the Modeling Elements Business Rules created between the Business Process Activities allow you to configure the relationships between the input and output attributes of the Activities using the Business Process Editor s Busine
32. ated alphanumeric characters The length of the Client ID is 8 If you use a static Client ID it must be unique across deployments if the IMS external systems which are being used are configured to connect to the same IMS Connect 2 Set the IRM _SOCT in the IRM_Header section to Persistent This allows the eway to retain the physical connection so that it can leverage the use of connection pooling as a resource adapter If this is not set to Persistent and the Client ID is configured to use dynamic generation i e with an then a protocol error will occur No other IRM_SOCT type can be used in parallel mode as noted a protocol error will result if Persistent is not used For the acknowledgement response expression IRM_F4 ACK NAK Response the following additonal parameters must be set in addition to the above 1 Set the IRM_F2 commit mode to COMMIT_MODE_0 2 Set the IRM_F3 sync level to SYNC_LEVEL_CONFIRM Static IMS Client ID In this mode the IMS eWay is configured to handle one single request at a time Multiple requests are serialized by the IMS eWay through an internal locking mechanism To configure the IMS eway for serialized processing do the following 1 Set the Client ID in the IRM_Header section to a string which does NOT contain an asterisk for example SUNIMS The eWay will generate the rest of the Client ID string filling it with randomly generated alphanumeric characters The length of the Cl
33. be fully displayed in the parameter s property field Enter the property value in the dialog box and click OK The value is now displayed in the property field Sun SeeBeyond eWay Adapter for IMS User s Guide 19 Sun Microsystems Inc Chapter 3 Configuring the IMS eWay Section 3 2 IMS eWay Connectivity Map Properties 32 IMS eWay Connectivity Map Properties The IMS eWay configuration parameters accessed from the Connectivity Map are organized into the following sections Outbound Connectivity Map Properties on page 20 32 1 Outbound Connectivity Map Properties The Outbound configuration parameters accessed from the Connectivity Map are organized into the following sections Connector on page 20 Connection Mode on page 20 Connector The Connector section contains the top level parameters contained in Table 3 Table 3 IMS eWay connector Parameter Settings Name Description Required Value Type Specifies the connector type IMSClientETD by default for IMSClientETD connections Class Specifies the class name of the ETD A valid package name The connector object default is com stc eways ims IMSClient ETDConnector Connection Mode The Connection Mode section contains the top level parameters contained in Table 4 Sun SeeBeyond eWay Adapter for IMS User s Guide 20 Sun Microsystems Inc Chapter 3 Configuring the IMS eWay Section 3 3 IMS eWay Environment Explorer P
34. ber 819 7375 10 Version 20061006120122 Sun SeeBeyond eWay Adapter for IMS User s Guide 2 Sun Microsystems Inc Contents Contents Chapter 1 Introducing the IMS eWay 6 About Information Management System IMS 6 About the IMS eWay 6 What s New in This Release 7 About This Document 7 What s in This Document 7 Scope 8 Intended Audience 8 Text Conventions 8 Screenshots 9 Related Documents 9 Sun Microsystems Inc Web Site 9 Documentation Feedback 9 Chapter 2 Installing the IMS eWay 10 Before You Install 10 Installing the IMS eWay 10 Installing the IMS eWay on an eGate Supported System 11 Adding the eWay to an Existing Sun Java Composite Application Platform Suite Installation 11 After Installation 12 Extracting the Sample Projects and Javadocs 12 ICAN 5 0 Project Migration Procedures 13 Installing Enterprise Manager eWay Plug Ins 14 Viewing Alert Codes 15 Chapter 3 Configuring the IMS eWay 17 Creating and Configuring the IMS eWay 17 Sun SeeBeyond eWay Adapter for IMS User s Guide 3 Sun Microsystems Inc Contents Selecting IMS as the External Application Configuring the IMS eWay Properties Using the Properties Editor IMS eWay Connectivity Map Properties Outbound Connectivity Map Properties Connector Connection Mode IMS eWay Environment Explorer Properties TCPIP Configuration IRM Header Configuring the Client ID for the IMS eWay Serial Mode Settings Connection Retry Settings Connection Pool Settings
35. compiles and validates the Project s Java files and creates the Project EAR file Build the Project 1 From the Deployment Editor toolbar click the Build icon 2 If there are any validation errors a Validation Errors pane will appear at the bottom of the Deployment Editor and displays information regarding the errors Make any necessary corrections and click Build again 3 After the Build has succeeded you are ready to deploy your Project Deploy the Project 1 From the Deployment Editor toolbar click the Deploy icon Click Yes when the Deploy prompt appears 2 A message appears when the project is successfully deployed You can now test your sample 55 12 Running the Sample Project To run your deployed sample Project do the following 1 From your configured input directory paste or rename the sample input file to trigger the eWay 2 From your output directory verify the output data s6 The prjMFS_JCD_Sample Project The prjMFS_JCD_Sample project demonstrates the use of the IMS MFS builder to create an OTD from an MFS file and use it in a simple project 1 Input data formatted as content to an MFS message output control block is subscribed to by the inbound File eWay from an external directory 2 This data message is deserialized into an OTD generated from an MFS message specification Sun SeeBeyond eWay Adapter for IMS User s Guide 69 Sun Microsystems Inc Chapter 5 Section 5 6 Implementing an IMS eWay P
36. configuration information for these Sun SeeBeyond eWay Adapter for IMS User s Guide 40 Sun Microsystems Inc Chapter 4 Section 4 5 Using the IMS eWay With elnsight The prjIMS_BP_Sample Project components Environments are created using the Enterprise Designer s Environment Explorer and Environment Editor 1 From the Enterprise Designer s Enterprise Explorer click the Environment Explorer tab Right click the Repository and select New Environment A new Environment is added to the Environment Explorer tree Rename the new Environment to IMS_BP_Sample_ENV Right click IMS_BP_Sample_ENV and select New IMS External System Name the External System IMSExtSys Click OK IMSExtSys is added to the Environment Editor Right click IMS_BP_Sample_ENV and select New File External System Name the External System FileExtSysInOut and Click OK FileExtSysInOut is added to the Environment Editor Modify both the Inbound and Outbound properties of the File eWay and click OK Right click IMS_BP_Sample_ENV and select New Logical Host The LogicalHost1 box is added to the Environment and LogicalHost1 is added to the Environment Editor tree From the Environment Explorer tree right click LogicalHost1 and select Sun SeeBeyond Integration Server A new Integration Server IntegrationSvr1 is added to the Environment Explorer tree under LogicalHost1 Save changes to the repository The Environment Explorer and Environment Editor no
37. cord notes and information regarding the currently selected property These comments are saved when you close the editor After modifying the configuration properties click OK to close the Properties Editor and save your changes Modifying the Default eWay Properties 1 From the Connectivity Map or the Environment Explorer open the Properties Editor to the IMS eWay default properties 2 From the upper right pane of the Properties Editor select a subdirectory of the configuration directory The parameters contained in that subdirectory are now displayed in the Properties pane of the Properties Editor For example if you click on the connector subdirectory the editable connector parameters are displayed in the right pane see Figure 4 Figure 4 Properties Editor IMS eWay Properties lt coniguaton lae e m e Connection Mode type IMSClientETD class com stc eways ims IMSClientETDConnecto Property Tag Description connector Connector This section contains a set of top level parameters 5 Comments connector Properties 3 Click on any property field to make it editable For example click on the class property to edit the class value If a property value is true false or multiple choice the field displays a submenu of property options 4 Click on the ellipsis in the properties field to open a separate configuration dialog box This is helpful for large values that cannot
38. correct connectivity map is selected and click OK 3 From the Deployment Editor toolbar click the Automap icon The Project s components are automatically mapped to their system windows as seen in Figure 18 Figure 18 Deployment Profile Auto Map Environment IMS_BP_Sample_ENV J Bi Map variables Gf Build M f Deploy Za Automap M e ysin 4 LogicalHost1 deb BP_IMS Sh G Integrations 5 8P_IMS gt eaFileOut H BP_IMS gt ealMs L E eaFilein gt BP_IMS 458 Creating and Starting the Domain To build and deploy your Project you must first create a domain A domain is an instance of a Logical Host After the domain is created the Project is built and then deployed Note You are only required to create a domain once when you install the Composite Application Platform Suite Steps required to create and start the domain 1 Navigate to your lt caps51 gt logicalhost directory where lt caps51 gt is the location of your Sun Java Composite Application Platform Suite installation 2 Double click the domainmgr bat file The Domain Manager appears 3 If you have already created a domain select your domain in the Domain Manager and click the Start an Existing Domain button Once your domain is started a green check mark indicates that the domain is running 4 If there are no existing domains a dialog box indicates that you can create a domain now Click Yes The Create
39. dden retain their configured default settings 311 Selecting IMS as the External Application To create an IMS eWay you must first create an IMS External Application in your Connectivity Map IMS eWays are located between an IMS External Application and a Service Services are containers for Java Collaborations Business Processes eTL processes and so forth To create the IMS External Application 1 From the Connectivity Map toolbar click the External Applications icon 2 Select the IMS External Application from the menu see Figure 2 on page 18 The selected IMS External Application icon appears on the Connectivity Map toolbar Sun SeeBeyond eWay Adapter for IMS User s Guide 17 Sun Microsystems Inc Chapter 3 Section 3 1 Configuring the IMS eWay Creating and Configuring the IMS eWay Figure 2 External Applications Selection Menu oO Scheduler 3 Drag the new IMS External Application from the toolbar onto the Connectivity Map canvas This icon now represents an external IMS system From the Connectivity Map you can associate bind the External Application to the Service to establish an eWay see Figure 3 Figure 3 eWay Location Service gt gt _ gt ima gt IMS eWay When IMS is selected as the External Application it automatically applies the default IMS eWay properties provided by the OTD to the eWay that connects it with the Service These properties can then be or modified for your s
40. docs on page 12 ICAN 5 0 Project Migration Procedures on page 12 Installing Enterprise Manager eWay Plug Ins on page 14 21 Before You Install Open and review the Readme txt file for the Oracle eWay for any additional information or requirements prior to installation The Readme txt file is located on the installation CD ROM 22 Installing the IMS eWay The Enterprise Manager 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 Refer to the readme for the latest information on Supported Operating Systems System Requirements External System Requirements 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 Sun SeeBeyond eWay Adapter for IMS User s Guide 10 Sun Microsystems Inc Chapter 2 Section 2 2 Installing the IMS eWay Installing the IMS eWay 221 Installing the IMS eWay on an eGate Supported System After you have installed Core Products do the following 1 From the Sun Java Composite Application Platform Suite Installer click on the Click to install additional products link on the Administration tab 2 Expand the eWay option 3 From Select Sun Java Composite Application Platform Suite Products to Install selec
41. eGate Integrator System Administration Guide describes how to monitor servers Services logs and alerts using the Enterprise Manager and the command line client The eWay Enterprise Manager plug ins are available 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 Sun SeeBeyond eWay Adapter for IMS User s Guide 14 Sun Microsystems Inc natale the IMS eWay Installing Enterprise Manager Pare From the Sun SeeBeyond Enterprise Manager From the Sun Java Composite Application Platform Suite Installer To add plug ins from the Enterprise Manager 1 From the Enterprise Manager s Explorer toolbar click configuration 2 Click the Web Applications Manager tab go to the Auto Install from Repository tab and connect to your Repository 3 Select the application plug ins you require and click Install The application plug ins are installed and deployed To add plug ins from the Sun Java Composite Application Platform Suite Installer 1 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 2 From the Enterprise Manager s Explorer toolbar click configuration 3 Click the Web Applications Manager tab and go to the Manage Applications sub tab 4 Browse for and select the WAR file for the applicatio
42. eWay Adapter for IMS User s Guide 76 Sun Microsystems Inc Index Index A Automap 43 57 68 75 B binding dialog box 40 the eWay components 39 bindings 54 Business Process creating 34 Business Rule 50 comments creating 51 C Class 20 Collaboration Editor Java 49 Collaboration Editor creating Business Rules 50 comments creating 51 Connectivity Map 48 creating 37 External Applications creating 38 Outbound properties 20 populating 38 48 conventions text 8 Creating an OTD using the IMS MFS Wizard 61 71 D Deployment Profile Automap 43 57 68 75 E elnsight 32 Business Process creating 34 Sun SeeBeyond eWay Adapter for IMS User s Guide Business Process Designer 36 Business Rules Designer 36 Business Process Manager 32 IMSRequest 33 overview 32 e Mail eWay modifying properties 19 Environment 55 66 creating 40 Environment Editor 41 eWays creating 18 Plug Ins 14 External Applications 48 implementation 45 IMS overview 6 IMS Connect 6 7 IMS eWay overview 6 IMS MES Wizard 61 71 IMSClientETD 45 Installation Plug Ins 14 Installing Repository on UNIX 10 sample Projects and Javadocs 12 installing IMS eWay 10 sar files 11 IRM Header 22 IRM_CLIENTID 24 IRM_DESTID 27 IRM_F1 24 IRM_F2 25 IRM_F3 25 IRM_F4 26 IRM_F5 27 IRM_HEADER_ENCODING 28 IRM_ID 23 IRM_LEN 23 IRM_LTERM 27 IRM_RACF_GRNAME 27 IRM_RACF_PW 28 IRM_RACF_USERID 28 IRM_SOCT 24 IRM_TIMER 23 IRM_TRNCOD 27
43. ection Pool Settings Description TCPIP Configuration This section contains information for connecting to IMS Comments TCPIP Configuration Properties OK Cancel 331 TCPIP Configuration The TCPIP Configuration section contains information for connecting to the Portal Infranet This section contains the top level parameters as displayed in Table 5 Table 5 Environment TCPIP Configuration Settings Name Description Required Value Server Specifies the name ofthe server host This The server host name parameter is mandatory Port Specifies the port that IMS Connect is A number indicating the port listening on This parameter is mandatory on which IMS Connect is listening The default is 7777 332 IRM Header The IRM IMS Request Message Header section contains the top level parameters displayed in Table 6 Note For a full description of the IRM header see IBM s IMS Connect Guide and Reference SC27 0946 00 Sun SeeBeyond eWay Adapter for IMS User s Guide 22 Sun Microsystems Inc Chapter 3 Configuring the IMS eWay Section 3 3 IMS eWay Environment Explorer Properties Table 6 Environment IRM Header Settings Name Description Required Value IRM_LEN Specifies the length of the IRM structure An integer indicating valid The user written exits minimum size is 36 IRM structure length The HWSIMSO0 and HWSSMPL1 have a configured default is 80 minimu
44. eration double click Sun SeeBeyond gt eWays gt File gt FileClient gt receive The File Name field now displays receive Click Next 4 For Step 3 of the wizard from the Select OTDs selection window double click IMS_MFS_Sample gt dfsivf1 The dfsivf1 OTD is added to the Selected OTDs field 5 Click the Up One Level button to return to the Repository From the Select OTDs selection window double click Sun SeeBeyond gt eWays gt File gt FileClient The FileClient OTD is added to the Selected OTDs field see Figure 36 Figure 36 Collaboration Definition Wizard Java Select OTDs Steps Select OTDs to be used in this Collaboration 1 Enter Name and Type SSS 2 Select Web Service Look in File a e w ESES Operation to implement Select OTDs Name FileClient Type Object Type Definition x Add Selected OTDs Instance Name priMFS_IMS_JCD_Sample otdd otddfsivfl_1 SeeBeyond evWays File FileClient FileClient_1 lt Back Next Finish Cancel Help 6 Click Finish The Collaboration Editor Java appears in the left pane of the Enterprise Designer and the jcdMFS_IMS Collaboration Java is added to the Project Explorer tree 55 5 The MFS IMS Collab Business Rules The the prjIMS_MFS_Sample project uses one Collaboration created in the previous section jcdMFS_IMS jcdMFS_IMS Business Rules The jcdMFS_IMS Collaboration contains the Business R
45. ess Process it automatically invokes that component via its Web Services interface See the elnsight Business Process Manager User s Guide for details Sun SeeBeyond eWay Adapter for IMS User s Guide 32 Sun Microsystems Inc Chapter 4 Section 4 2 Using the IMS eWay With elnsight The IMS eWay With elnsight 42 The IMS eWay With elnsight An elnsight Business Process Activity can be associated with the IMS eWay during the system design phase To make this association select the desired operators under the eWay in the Enterprise Explore and drag it onto the elnsight Business Process Designer canvas Currently the IMS eWay has only the IMSRequest operator available The operation is automatically changed to an Activity with an icon identifying the component that is the basis for the Activity At run time eInsight invokes each step in the order defined in the Business Process Using eInsight s Web Services interface the Activity in turn invokes the IMS eWay 43 Steps Required to Run the Sample Projects The following steps are required to run the sample projects that are contained in the IMSeWayDocs sar file 1 Import the sample Projects 2 Build deploy and run the sample Projects You must do the following before you can run an imported sample Project Create an Environment Configure the eWays Create a Deployment Profile Create and start a domain Deploy the Project 3 Check the output 44 Importing a Sample Pro
46. functionality of the IMS eWay using the eGate Integrator and the Collaboration Editor Java It also provides directions for importing and running the JCS and MES sample projects and step by step directions for creating the sample projects manually 142 Scope This user s guide provides a description of the IMS eWay Intelligent Adapter It includes directions for installing the eWay configuring the eWay properties and implementing the eWay s sample projects This document is also intended as a reference guide listing available properties functions and considerations For a reference of available IMS eWay Java methods see the associated Javadoc 143 Intended Audience This guide is intended for experienced computer users who have the responsibility of helping to set up and maintain a fully functioning ICAN Suite system This person must also understand any operating systems on which the ICAN Suite will be installed Windows or UNIX and must be thoroughly familiar with Windows style GUI operations 144 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 Monospaced Command line arguments code java jar filename jar samples variables are shown in bold italic
47. further in the Sun SeeBeyond eGate Integrator User s Guide or the Sun SeeBeyond eGate Integrator System Administrator Guide 14 About This Document This section provides a brief outline of the IMS eWay User s Guide 141 What s in This Document This book includes the following chapters Chapter 1 Introducing the IMS eWay provides an overview of the IMS eWay Intelligent Adapter including a brief description of the IMS In addition this chapter provides a brief outline of the eWay user s guide Chapter 2 Installing the IMS eWay lists both the supported operating systems and system requirements for the IMS eWay It also includes directions for installing the IMS eWay as well as the IMS eWay documentation and sample projects Chapter 3 Configuring the IMS eWay describes the process of configuring the IMS eWay to run in your environment Chapter 4 Using the IMS eWay With elnsight describes how to use the IMS eWay with the Sun Java Composite Application Platform Suite s eInsight Business Process Manager and the Web Services interface Provides directions for importing Sun SeeBeyond eWay Adapter for IMS User s Guide 8 Sun Microsystems Inc Chapter 1 Section 1 4 Introducing the IMS eWay About This Document and running the elnsight sample project and step by step directions for creating the sample project manually Chapter 5 Implementing an IMS eWay Project describes the features and
48. his collaboration window double click Sun SeeBeyond gt eWays gt IMSeWay gt IMS The IMS OTD is added to the Selected OTDs field Sun SeeBeyond eWay Adapter for IMS User s Guide 49 Sun Microsystems Inc Chapter 5 Implementing an IMS eWay Project Section 5 4 The prjIMS_JCD_Sample Project 5 Click the Up One Level button to return to the Repository Double click Sun SeeBeyond gt eWays gt File gt FileClient The FileClient OTD is added to the Selected OTDs field see Figure 22 Figure 22 Collaboration Definition Wizard Java Select OTDs Steps Select OTDs to be used in this Collaboration 1 Enter Name and Type 2 Select Web Service Web S Look In File a BE Operation to implement Select OTDs Name FileClient Type Object Type Definition Add Selected OTDs OTD Instance Name SeeBeyond eWays IMSeWay IMS IMS_1 SeeBeyond eWays File FileClient FileClient_1 Remove lt Back Next gt CFinisn_ Cancel Help 6 Click Finish The Collaboration Editor Java appears in the left pane of the Enterprise Designer and the jcdIMS Collaboration is added to the Project Explorer tree 544 Using the Collaboration Editor Java The next step in the sample is to create the Business Rules of the Collaborations using the Collaboration Editor Creating the IMS_Java_Collab Collaboration Be mindful to open all nodes specified in the directions
49. ht click IMS_1 in the left pane of the Business Rules Designer and select Select a method to call from the shortcut menu The method selection box appears C Select disconnect from the method selection box The disconnect method box appears in the Business Rules Designer canvas 8 To create the FileClient_1 write Business Rule do the following A From the Business Rules toolbar click the rule button to add a new rule B Right click the FileClient_1 node in the left pane of the Business Rules Designer and select Select a method to call from the shortcut menu The method selection box appears C Select write from the method selection menu The write method box appears in the Business Rules Designer canvas see Figure 27 Figure 27 FileClient_1 write Business Rule Business Rules Designer 80 ME pooean Comparison Math Object A String ilarray Operators FileClient_1 write oe IMS_Java_Collab IMS_Java_Collab pes Fe write A FileClient_1 5 ByteArray ByteArray es x Gd length File Application Text Ar IMS_1 ME Text a input La IS IMS_1 be 8 input om ByteArray L Text i IMS_Java_Collab 9 From the Collaboration Editor toolbar click Validate to check the Collaboration for errors 10 Save your current changes to the Repository Sun SeeBeyond eWay Adapter for IMS User s Guide 53 Sun Microsystems Inc Chapter 5 Section 5 4 I
50. ient ID is 8 If you use a static Client ID it must be unique across deployments if the IMS external systems which are being used are configured to connect to the same IMS Connect For the acknowledgement response expression IRM_F4 ACK NAK Response the following additional parameters must be set in addition to the above 1 Set the IRM_SOCT to Transaction 2 Set the IRM_F2 commit mode to COMMIT_MODE_0 3 Set the IRM_F3 sync level to SYNC_LEVEL_CONFIRM Duplicate Client IDs When sending an IMS Connect interaction on a given port an error will occur when using a ClientID which is already in use on that port This can happen when you are Sun SeeBeyond eWay Adapter for IMS User s Guide 29 Sun Microsystems Inc Chapter 3 Configuring the IMS eWay Section 3 3 IMS eWay Environment Explorer Properties executing an interaction with a ClientID which is the same as that used by another interaction that ended as a result of a socket timeout If this new interaction is received by IMS Connect while IMS Connect is still waiting for a response from IMS for the original interaction that received the socket timeout a duplicate ClientID error could occur This can also occur if the socket timeout being used for the original interaction is set to a value which is less than the timeout set by the IRM_TIMER or the IMS Connect default timeout set in the HWSCFGxx member IMS Connect is not aware that the original socket has been disco
51. if RACF is to be used The appropriate RACF PASSTICKET IRM_HEADER_ENCO DING Specifies the encoding of the IRM Header properties sent to IMS Connect Set the value to ISO 8859 1 if the message body is ASCII text The IMS Connect SAMPL1 user exit converts the data to EBCDIC Set the value to an EBCDIC code set such as cp500 if the message is EBCDIC text or binary data No data translation occurs ISO 8859 1 for ASCII transaction content or an EBCDIC code such as cp500 for EBCDIC transaction content SEND_DATA_ENCO DING Specifies the encoding translation if any to apply to the message body sent to IMS Connect Set to NO TRANSLATION to send the message body to IMS Connect without translation or when using the SAMPL1 user exit when the IRM Headers and message body are in ASCII Set to an EBCDIC code such as cp500 to translate the message body from ASCII to EBCDIC before sending to IMS Connect If the content is a double byte character set such as Japanese set to the EBCDIC code page for that language for example cp930 for Japanese Enter NO TRANSLATION or the appropriate code page as follows Enter NO TRANSLATION when using the SAMPL1 user exit and IRM Headers and message content is in ASCII Enter an EBCDIC code such as cp500 to translate ASCII message content to EBCDIC before sending it to IMS Connect For double byte character sets enter the appropriate code page for
52. ile back from the external IMS application and publishes the file to the outbound File eWay 4 The outbound File eWay publishes the file to an external directory 5 4 1 Create a Project The first step is to create a new project in the eGate Enterprise Designer 1 Start the Enterprise Designer 2 From the Enterprise Explorer s Project Explorer tab select your Repository on the Project Explorer tree right click the Repository and select New Project see Figure 19 A new project Project1 appears on the Project Explorer tree Figure 19 Enterprise Explorer New Project New Project Sort by Type Sort by Name Sort by Date Import Project Export Project Change Branch Create Branch Refresh All fram Repository User Management Paste Properties 3 Click twice not a double click on Project1 and rename the project for this sample prjIMS_JCD_Sample Sun SeeBeyond eWay Adapter for IMS User s Guide 47 Sun Microsystems Inc Chapter 5 Section 5 4 Implementing an IMS eWay Project The prjIMS_JCD_Sample Project 5 4 2 Create a Connectivity Map The Connectivity Map provides a canvas for assembling and configuring a project s components 1 In Enterprise Explorer s Project Explorer right click the new project and select New gt New Connectivity Map from the shortcut menu 2 The New Connectivity Map appears and a node for the Connectivity Map is added to the Project Explorer tree labeled CMap1 Rename
53. ions without requiring changes to the application By capturing the field contents before screen formatting the eWay is not affected by cosmetic changes to the application s screen design The eWay includes the IMS Message Format Service MFS Wizard conversion utility to facilitate the creation of input and output Object Type Definitions OTDs from IMS MEFS files The implementation of the IMS eWay is in accordance with IBM s IMS Connect Guide and Reference These documents describe the OTMA protocol and contain important prerequisite information for the configuration IMS Connect on the mainframe A sample project for the IMS eWay is included on the installation CD ROM which demonstrates how a non conversational scenario simple send response is managed 13 What s New in This Release This 5 1 2 version release provides general maintenance fixes for the IMS eWay Intelligent Adapter The IMS eWay also includes the following changes and new features New for 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 Manual setting for IMS Connection Mode Allows you to explicitly call the connect and disconnect methods in their collaboration
54. is added to the Connectivity Map toolbar Populate the Connectivity Map Add the project components to the Connectivity Map by dragging and dropping the icons from the toolbar to the Connectivity Map canvas 1 For this project add the following components to the Connectivity Map canvas as displayed in Figure 33 File External System 2 Service Sun SeeBeyond eWay Adapter for IMS User s Guide 70 Sun Microsystems Inc Chapter 5 Section 5 6 Implementing an IMS eWay Project The prjMFS_JCD_Sample Project Figure 40 Connectivity Map with Components 8 e amp B0e Ce Pl G b F Pha b gt oi CMapi_Servicel a gt 2 Save your current changes to the Repository 564 Creating an OTD Using the IMS MFS Wizard The IMS MFS Wizard creates an OTD from an MFS data file A sample MFS file MFSSAMP mfs is provided on the Installation CD ROM with the IMS eWay sample at samples ewims Copy this file to a temporary directory 1 From the Project Explorer tree right click the prj MFS_JCD_Sample project and select New gt Object Type Definition from the shortcut menu The Object Type Definition Wizard appears 2 From the Select Wizard Type box select IMS MFS Wizard and click Next Sun SeeBeyond eWay Adapter for IMS User s Guide 71 Sun Microsystems Inc Chapter 5 Section 5 6 Implementing an IMS eWay Project The prjMFS_JCD_ Sample Project Figure 41 IMS MFS Wizard Select Wizard Type Steps Select Wizard Type 1 Se
55. ject s Environment and select Version Control gt Check Out from the shortcut menu Select Recurse Environment to specify all components and click OK 2 If your imported Project includes File eWay External Systems in the Environment the Project s Environment must be reconfigured prior to deploying the Project To reconfigure your Environment do the following A C The properties file for the File External System now includes both inbound and outbound properties If your Environment includes both inbound and outbound File External Systems these can now be combined Delete all but one of the File External Systems From the Environment Explorer tree right click your remaining File External System and select Properties from the shortcut menu The Properties Editor appears Set the inbound and outbound directory values and click OK 3 Deploy your Projects 26 Installing Enterprise Manager eWay Plug Ins The Sun SeeBeyond Enterprise Manager is a Web based interface that allows you to monitor and manage your Composite Application Platform Suite applications The Enterprise Manager requires an eWay specific plug in for each different eWay you install 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 Enterprise Manager The Sun SeeBeyond
56. ject Sample eWay Projects are included as part of the installation CD ROM package To import a sample eWay Project to the Enterprise Designer do the following 1 Extract the samples from the Enterprise Manager to a local file Sample files are uploaded with the eWay s documentation SAR file and then downloaded from the Enterprise Manager s Documentation tab The IMS_eWay_Sample zip file contains the various sample Project ZIP files Note Make sure you save all unsaved work before importing a Project Sun SeeBeyond eWay Adapter for IMS User s Guide 33 Sun Microsystems Inc Chapter 4 Section 4 5 Using the IMS eWay With elnsight The prjIMS_BP_Sample Project 2 From the Enterprise Designer s Project Explorer pane right click the Repository and select Import Project from the shortcut menu The Import Manager appears 3 Browse to the directory that contains the sample Project ZIP file Select the sample file and click Import Click Close after successfully importing the sample Project 45 The prjIMS_BP_Sample Project The prjIMS_BP_Sample project demonstrates connectivity with an external IMS system Sample Project Overview 1 The inbound File eWay receives a file from an external directory 2 This file is published by the IMS eWay to an external IMS application 3 The IMS eWay receives the file back from the external IMS application and publishes the file to the outbound File eWay The outbound File eWay publishes the file t
57. le by mapping the Text node to the Message node To do this click on Text under Input in the left pane of the Business Rules Designer and drag the cursor to the Message node under IMS_1 in the right pane See Figure 24 Figure 24 Copy input Text to IMS_1 Message Business Rule Business Rules Designer 20 828 S X hBoolean comparison Math lt aoObject A String i Array amp Operators Assignment Copy input Text to IMS_1 Message D GAB jodims jedims i gt IS FileClient_1 FileClient 1 IE Dee IMS_1 IMS_1 IS IS input Bands S Ge ByteArray DatastorelD Encoding LtermName Text Message Password Pot RactGroupName RacfUserlD RezssonErrmMsg Reply ReplyBytes Bed RetumEntsg SegmentCount Server TranCode TranCodeSre input MIE ByteArray Gb Encoding amp Text a D icdims 4 To create the IMS_1 connect rule do the following A From the Business Rules toolbar click the Rule button to add a new rule B Right click the IMS_1 node in the left pane of the Business Rules Designer and select Select method to call from the shortcut menu The method selection box appears Sun SeeBeyond eWay Adapter for IMS User s Guide 51 Sun Microsystems Inc Chapter 5 Section 5 4 Implementing an IMS eWay Project The prjIMS_JCD_Sample Project C Select connec
58. lect Wizard Type _OTD Wizard Description DTD Uses a DTD to create an OTD IMS MFS Wizard Uses an IMS MFS to create an OTD User Defined Allows the user to create a custom OTD a UD OTD from Uses a text file to create a custom OTD ma XSD Uses an XSD to create an OTD Back Next Finish _ cancel Hem 3 For step two of the wizard Select Input Files browse to the sample MFS file MFSSAMP mfs Click Select to add the file to the Selected Files box see Figure 42 Sun SeeBeyond eWay Adapter for IMS User s Guide 72 Sun Microsystems Inc Chapter 5 Section 5 6 Implementing an IMS eWay Project The prjMFS_JCD_Sample Project Figure 42 IMS MFS Wizard Select MSF file eps Select your MFS Files 1 Select Wizard Type Browse Files 2 Select Input Files Look in a ka W ESES L MFSSAMP mfs File Name MFSSAMP mfs Files oftype MFS File Type z _ select _ Cancel Selected Files Remove B Next gt Finish Cancel Help 4 Click Finish and save your changes to the Repository The OTD Editor now displays the successfully created MFSSAMP OTD and the OTD is added to the Project Explorer tree 565 Creating the Environment Environments include the external systems Logical Hosts integration servers and message servers used by a project as well as containing the configuration information for these components 1 From the Enterprise Designer s E
59. lected and click OK Sun SeeBeyond eWay Adapter for IMS User s Guide 74 Sun Microsystems Inc Chapter 5 Section 5 6 Implementing an IMS eWay Project The prjMFS_JCD_Sample Project 3 From the Deployment Editor toolbar click the Automap icon The Project s components are automatically mapped to their system windows 4 Click Activate When activation succeeds save the changes to the Repository 568 Creating and Starting the Domain To build and deploy your Project you must first create a domain A domain is an instance of a Logical Host After the domain is created the Project is built and then deployed Note You are only required to create a domain once when you install the Composite Application Platform Suite Steps required to create and start the domain 1 Navigate to your lt caps51 gt logicalhost directory where lt caps51 gt is the location of your Sun Java Composite Application Platform Suite installation 2 Double click the domainmgr bat file The Domain Manager appears 3 If you have already created a domain select your domain in the Domain Manager and click the Start an Existing Domain button Once your domain is started a green check mark indicates that the domain is running 4 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 5 Make any necessary changes to the Create Domain dialog box and click Create The new dom
60. m IRM length of 80 IRM_ID Specifies the identifier character string The appropriate identifier of the user exit that is driven after the character string The complete message is received configured default is In a program an exit is used to move from SAMPL1 the called routine back to the calling routine A routine can have more than one exit point thus allowing termination based on various conditions The following IDs are used by the IMS Connect supplied user message exits IRMREQ for HWSIMSOO SAMPL1 for HWSSMPL1 IRM_TIMER Specifies the time delay for the receive to Select one of the three the Datastore after an ACK or RESUME predefined options or enter a TPIPE One of following three predefined valid hex value The timer options can be selected configured default is 25 SEC 25 SEC 25 seconds No_Wait Timer is not set and no delay Note The following hex occurs values correspond to the Block The receive waits indefinitely three predefined choices in This setting is used to support the Auto the drop down menu option of the asynchronous output X00 Default 25 secs function XE9 No_Wait does not set the timer OR XFF Block One of the following hex values can be entered as a timer value X01 X19 Range from 0 01 to 0 25 second 0 01 second increments X19 X28 Range from 0 25 to 1 second 0 05 second increments X28 X63 Range from 1 to 60 second 1 second incre
61. me the sample input file to trigger the eWay 2 From your output directory verify the output data Sun SeeBeyond eWay Adapter for IMS User s Guide 44 Sun Microsystems Inc Chapter 5 Implementing an IMS eWay Project 5 1 This chapter provides an introduction to the IMS eWay components and information on how these components are created and implemented in an eGate project It is assumed that the reader understands the basics of creating a project using the Sun Enterprise Designer For more information on creating an eGate project see the eGate Tutorial and the eGate Integrator User s Guide What s in This Chapter IMS eWay Components on page 45 Importing a Sample Project on page 46 The prjIMS_JCD_Sample Project on page 47 The prjMFS_IMS_JCD_Sample Project on page 59 The prjMFS_JCD_Sample Project on page 69 IMS eWay Components This chapter presents a sample IMS eWay project created using the same procedures as the sample end to end project provided in the eGate Integrator Tutorial The eWay components that are unique to the IMS eWay include the following IMS eWay Configuration File The properties file for the IMS eWay contains the parameters that are used to connect with a specific external system These parameters are set using the Properties Window For more information about the IMS eWay properties File and the Properties Window see Creating and Configuring the IMS eWay on page 15 IMSClientETD OTD
62. ments X63 X9E Range from 1 to 70 minutes 1 minute increments Sun SeeBeyond eWay Adapter for IMS User s Guide 23 Sun Microsystems Inc Chapter 3 Configuring the IMS eWay Section 3 3 IMS eWay Environment Explorer Properties Table 6 Environment IRM Header Settings Name Description Required Value IRM_SOCT Specifies the socket connection type Select one of the three Transaction Transaction socket The options The configured socket connection lasts across a single default is Persistent transaction Persistent Persistent socket The socket Note The default for connection lasts across multiple this property was transactions changed from the Non_Persistent Non persistent socket previous version The socket connection lasts for a single exchange consisting of one input and one output Do not use Non_Persistent when implementing conversational transactions because this type causes multiple connects and disconnects IRM_CLIENTID Specifies the name of the client ID The client ID to be used by character string to be used by IMS Connect For more information on configuring Client IDs refer to Configuring the Client ID for the IMS eWay on page 29 IMS eWay supports both Serial and Parallel mode Serial mode is supported by specifying a ClientID while Parallel mode is supported by specifying a ClientID with an Important In each deployment the ClientID must be unique IMS Connect
63. minimum number of connections to be maintained The configured default is 2 MaxPoolSize The maximum number of physical connections the pool keeps available at all times 0 zero indicates that there is no maximum A valid numeric value The default is 10 Sun SeeBeyond eWay Adapter for IMS User s Guide 31 Sun Microsystems Inc Chapter 4 Using the IMS eWay With elnsight This chapter describes how to use the IMS eWay with Sun Java Composite Application Platform Suite s eInsight Business Process Manager and its engine s Web Services interface Note You must have the eInsight sar file installed to use the Web Services interface What s in This Chapter eInsight Engine and Components on page 32 The IMS eWay With elnsight on page 33 Steps Required to Run the Sample Projects on page 33 Importing a Sample Project on page 33 The prjIMS_BP_Sample Project on page 34 41 elnsight Engine and Components eGate components can be deployed as Activities in eInsight business 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 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 Once elnsight runs the Busin
64. mplementing an IMS eWay Project The prjIMS_JCD_Sample Project 545 Creating Collaboration Bindings After the Collaboration has been written the components are associated and Bindings are created in the Connectivity Map 1 From the Project Explorer tree double click cmIMS_JCD to display the Connectivity Map 2 Drag and drop the IMS Java Collaboration jcdIMS from the Project Explorer tree to the IMS Service jcolIMS If the Collaboration is successfully associated the Jo Service icon s gears change from red to green see Figure 28 Figure 28 Connectivity Map Binding the Collaborations amp RepositoryName HEAD prilmS_BP_Sample o gt E e BPI 2 cmiMS_BP fo amp eaFileln 5 eaFileout m E ealMs o prilMS_JCD_Sample 8 E cmIMS_JCD E eaFileln E earileout ns ge eams RE p Oo G jcams eaFileln eE priMFS_IMS_JCD_Sample e priMFS_JCD_Sample em Sun SeeBeyond jcolMS eaFileOut 3 Double click jcolIMS in the Connectivity Map The jcolIMS Binding dialog box appears 4 From the jcolIMS Binding dialog box map FileClient input under Implemented Services to the FileIn External Application by clicking on input and dragging the cursor to the FileIn application 5 From the jcolIMS Binding dialog box map IMS IMS_1 under Invoked Services to the IMS External Application 6 From the jcolIMS Binding dialog box map FileClient FileClient_1 to the File2 Extern
65. n Java Composite Application Platform Suite installation Steps required to add an eWay to an Existing CAPS installation include 1 Complete steps 1 through 6 on Installing the IMS eWay on an eGate Supported System on page 11 2 Open the Enterprise Designer and select Update Center from the Tools menu The Update Center Wizard appears Sun SeeBeyond eWay Adapter for IMS User s Guide 11 Sun Microsystems Inc Chapter 2 Section 2 3 Installing the IMS eWay After Installation 3 For Step 1 of the wizard simply click Next 4 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 5 For Step 3 of the wizard wait for the modules to download then click Next 6 The wizard s Step 4 window displays the installed modules Review the installed modules and click Finish 7 When prompted restart the IDE Integrated Development Environment to complete the installation 23 After Installation 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 24 Extracting the Sample Projects and Javadocs The IMS eWay includes sample Projects and Javadocs The sample Projects are designed to provide you with a basic understanding of how certain database operations are performed using the e
66. n for your system and click OK For more information on these properties refer to IMS eWay Environment Explorer Properties on page 21 Sun SeeBeyond eWay Adapter for IMS User s Guide 67 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing an IMS eWay Project The prjMFS_IMS_JCD_Sample Project 55 9 Creating the Deployment Profile A Deployment Profile is used to assign services and message destinations to the integration server and message server Deployment profiles are created using the Deployment Editor 1 From the Enterprise Explorer s Project Explorer right click the prjMFS_IMS_JCD_Sample Project and select New gt Deployment Profile 2 Enter a name for the Deployment Profile for this sample dpMFS_IMS_JCD Select MFS_IMS_JCD_Sample_ENV as the Environment insure the correct connectivity map is selected and click OK 3 From the Deployment Editor toolbar click the Automap icon The Project s components are automatically mapped to their system windows as seen in Figure 39 Figure 39 Deployment Profile X Enterprise Explorer Environment Explor x Repository HEAD F mFs_ims_Sample_Env te FileExtSysinOut E LogicalHostt Shy IntegrationSvr1 L he IntegrationSvrt 4 Click Activate When activation succeeds save the changes to the Repository 55 10 Creating and Starting the Domain To build and deploy your Project you must first create a domain A domain is an ins
67. n plug in that you downloaded and click Deploy The plug in is installed and deployed Viewing 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 this eWay 2 From the Enterprise Manager s Explorer toolbar click configuration 3 Click the Web Applications Manager tab and go to the Manage Alert Codes tab 4 Browse for and select the 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 5 Click Deploy The available alert codes for your application are displayed under Results A listing of available alert codes is displayed in Table 2 Table 2 IMS eWay Alert Codes Alert Code Description User Action IMSCLIENTEWAY CONNECT Failed to connect to IMS IMS is down Verify that the system FAILED000002 you are connecting to is running Properties are incorrect Verify that your parameters are correct host name port and so forth CTG configuration is incorrect Verify CTG installation and configuration is correct Sun SeeBeyond eWay Adapter for IMS User s Guide 15 Sun Microsystems
68. nager Select the domain and click the Start an Existing Domain button Once your domain is started a green check mark indicates that the domain is running Note For more information about creating and managing domains see the eGate Integrator System Administration Guide 5 4 11 Building and Deploying the Project The Build process compiles and validates the Project s Java files and creates the Project EAR file Build the Project 1 From the Deployment Editor toolbar click the Build icon Sun SeeBeyond eWay Adapter for IMS User s Guide 58 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing an IMS eWay Project The prjMFS_IMS_JCD_Sample Project 2 Ifthere are any validation errors a Validation Errors pane will appear at the bottom of the Deployment Editor and displays information regarding the errors Make any necessary corrections and click Build again 3 After the Build has succeeded you are ready to deploy your Project Deploy the Project 1 From the Deployment Editor toolbar click the Deploy icon Click Yes when the Deploy prompt appears 2 A message appears when the project is successfully deployed You can now test your sample 5412 Running the Sample Project To run your deployed sample Project do the following 1 From your configured input directory paste or rename the sample input file to trigger the eWay 2 From your output directory verify the output data 55 The prjMFS_IMS_JCD_Sample Project
69. nc Index Sun SeeBeyond eWay Adapter for IMS User s Guide 79 Sun Microsystems Inc
70. nnected as a result of the socket timeout until it does a subsequent read on that socket This means it would consider the original socket still active even though that socket has already been disconnected from the client end Once you get to this situation you will receive DUPECLNT errors until the IRM_TIMER expires on the IMS Connect side Note For a full discussion of Client ID and timer issues refer to IMS Connectivity in the On Demand Environment A Practical Guide to IMS Connectivity IBM Publication SG24 6794 00 333 Serial Mode Settings The Serial Mode Settings section of the Outbound IMS Environment contains the top level parameters displayed in Table 8 Table 7 Outbound IMS eWay Environment Serial Mode Settings Name Description Required Value Wait Timeout When IRM_CLIENTID is static which results in requests being serialized multiple threads using the same Client ID will contend for a request lock Threads contending for a request lock being held by another thread will wait until the pending request thread releases the lock This parameter controls how long in milliseconds a request thread will wait for the lock An integer indicating the configured length of the time a thread will wait for the lock The default is 6000 milliseconds 33 4 Connection Retry Settings The Connection Retry Settings section of the Outbound IMS Environment contains the top level parameters displa
71. nterprise Explorer click the Environment Explorer tab 2 Right click the Repository and select New Environment A new Environment is added to the Environment Explorer tree Rename the new Environment to MFS_JCD_Sample_Env 4 Right click MFS_JCD_Sample_Env and select New IMS External System Name the External System IMSExtSys IMSExtSys is added to the Environment Editor 5 Right click MFS_JCD_Sample_Env and select New File External System Name the External System FileExtSysInOut and Click OK FileExtSysInOut is added to Sun SeeBeyond eWay Adapter for IMS User s Guide 73 Sun Microsystems Inc Chapter 5 Section 5 6 Implementing an IMS eWay Project The prjMFS_JCD_Sample Project the Environment Editor Modify both the Inbound and Outbound properties of the File eWay and click OK 6 Right click MFS_JCD_Sample_Env and select New Logical Host The LogicalHost1 box is added to the Environment and LogicalHost1 is added to the Environment Editor tree 7 Right click LogicalHost1 and select Sun SeeBeyond Integration Server from the shortcut menu A new Integration Server IntegrationSvr1 is added to the Environment Explorer tree under LogicalHost 566 Configure the eWays The prjMFS_JCD_Sample project uses three eWays each represented in the Connectivity Map as a node between an External Application and the Collaboration eWays facilitate communication and movement of data between the External Applications and the eGate system No
72. o an external directory 45 1 Creating a Project The first step is to create a new project in the Sun Enterprise Designer 1 Start the Enterprise Designer 2 From the Enterprise Explorer s Project Explorer tab right click the Repository and select New Project see Figure 6 on page 34 A new project Project1 appears on the Project Explorer tree Figure 6 Enterprise Explorer New Project EF pr New Project 0 pr Sort by Type SU Sort by Name Sort by Date Import Project Export Project Change Branch 3 Click twice not a double click on Project1 and rename the project for this sample prjIMS_BP_Sample 45 2 Creating a Business Process To create the IMS elnsight Business Process do the following Sun SeeBeyond eWay Adapter for IMS User s Guide 34 Sun Microsystems Inc Chapter 4 Section 4 5 Using the IMS eWay With elnsight The prjIMS_BP_Sample Project Creating the Business Process Flow 1 Right click the existing project for this sample prjIMS_BP_Sample in the Project Explorer tree and select New gt Business Process from the shortcut menu The elnsight Business Process Designer appears Rename the new Business Process BusinessProcess1 to BP1 BP1 will be added to the tree 2 From the Project Explorer tree expand both of the following eWays nodes as displayed in Figure 7 IMSeWay gt IMS_eWay File gt FileClient 3 Populate the eInsight Business Process Designer s modeling canv
73. onment Editor Repositoryi HEAD E mFS_IMS_Sample_Env E E FileExtSysInOut El LogicalHostt 2 Be IntegrationSvr1 EX ge IntegrationSvrt 7 Save changes to the Repository 5 58 Configure the eWays The IMS eWay properties must be set in both the Project Explorer and Environment Explorer For more information on the IMS eWay configuration properties and the Properties Window see Creating and Configuring the IMS eWay on page 15 or refer to the eGate Integrator User s Guide Note For information on configuring the File eWay nodes refer to the eWay File Adapter User s Guide Modifying the IMS eWay Connectivity Map Properties 1 From the cmMFS_IMS_JCD Connectivity Map double click the IMS eWay The Properties Window opens to the IMS eWay Project Explorer configuration properties 2 Modify the IMS eWay Project Explorer properties for your system and click OK For more information on these properties refer to IMS eWay Connectivity Map Properties on page 20 3 Double click the IMS eWay located between IMS_Service and the IMS1 External Application Modify the IMS eWay configuration for your system and click OK Modifying the IMS eWay Environment Explorer Properties 1 From the Environment Explorer tree right click the IMS External System IMSExtSys in this sample and select Properties The Properties Window opens to the IMS eWay environment configuration properties 2 Modify the IMS eWay environment configuratio
74. onnectivity Map Properties 1 From the Connectivity Map double click the IMS eWay The Properties Window opens to the IMS eWay project configuration properties 2 Modify the IMS eWay Project Explorer configuration for your system and click OK For more information on these properties refer to IMS eWay Connectivity Map Properties on page 20 Modifying the IMS eWay Environment Explorer Properties 1 From the Environment Explorer tree right click the IMS External System IMSExtSys in this sample and select Properties from the shortcut menu The Properties Window opens to the IMS eWay Environment Explorer properties 2 Modify the IMS eWay Environment Explorer properties for your system and click OK For more information on these properties refer to IMS eWay Environment Explorer Properties on page 21 Sun SeeBeyond eWay Adapter for IMS User s Guide 42 Sun Microsystems Inc Chapter 4 Section 4 5 Using the IMS eWay With elnsight The prjIMS_BP_Sample Project 457 Creating the Deployment Profile A Deployment Profile is used to assign services and message destinations to the integration server and message server Deployment profiles are created using the Deployment Editor 1 From the Enterprise Explorer s Project Explorer right click the prjIMS_BP_Sample Project and select New gt Deployment Profile 2 Enter a name for the Deployment Profile for this sample dpIMS_BPEL Select IMS_BP_Sample_ENV as the Environment insure the
75. other 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 ma
76. pecific system using the Properties Editor 312 Configuring the IMS eWay Properties A Project s eWay properties can be modified after the eWay has been established in the Connectivity Map and the Environment has been created Configuring the IMS eWay Connectivity Map Properties 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 appears with a template containing the IMS eWay Connectivity Map properties Make any necessary changes to the property values and click OK to save the settings Configuring the IMS eWay Environment Explorer Properties 1 From the Environment Explorer tree right click the IMS External System Select Properties from the shortcut menu The Properties Editor opens with the IMS eWay Environment properties 2 Make any necessary changes to the Environment property values and click OK to save the settings Sun SeeBeyond eWay Adapter for IMS User s Guide 18 Sun Microsystems Inc Chapter 3 Section 3 1 Configuring the IMS eWay Creating and Configuring the IMS eWay 313 Using the Properties Editor Modifications to the eWay properties are made using the IMS eWay Properties Editor A description of each property is displayed in the Description pane when that property is selected This provides a brief explanation of the required settings or options The Comments pane provides an area to re
77. roject The prjMFS_JCD_Sample Project 3 The Collaboration demonstrates field level data access to the message concatenates and spools specific field values The output produced by the Collaboration is the concatenation of all 8 message fields in the output control block producing content identical to the input data 4 The outbound receives the input data and publishes the message to an external directory 561 Importing the prjMFS_JCD_ Sample Project To import the prjMFS_JCD_Sample project follow the directions from Importing a Sample Project on page 46 using the prjMFS_JCD_Sample zip file 5 6 2 Create a project The first step is to create and name a new project in eGate Enterprise Designer 1 From the Enterprise Explorer pane of the Enterprise Designer right click the Repository and select New Project A new project appears on the Project Explorer tree 2 Rename the project for this sample prj MFS_JCD_Sample 5 6 3 Create a Connectivity Map 1 In Enterprise Explorer right click the new project and select New gt Connectivity Map from the shortcut menu 2 The new Connectivity Map appears From the Project Explorer rename the new Connectivity Map cmMFS_JCD Select the External Applications For this sample project only the File External Application is required 1 Click the External Application icon on the Connectivity Map toolbar 2 Select the File External Application from the selection menu The File External System
78. roject to the Enterprise Designer do the following 1 The sample files are uploaded with the eWay s documentation sar file and downloaded from the Enterprise Manager s Documentation tab Extract the samples from the Enterprise Manager to a local file 2 Save all unsaved work in Enterprise Designer before importing a sample project 3 From the Enterprise Designer s Project Explorer pane right click the Repository and select Import from the shortcut menu The Import Manager appears 4 Browse to the directory that contains the sample project zip file Select the sample file and click Import After the sample project is successfully imported click Close 5 Before an imported sample project can be run you must do the following Create an Environment see Creating an Environment on page 55 Configure the eWays for your specific system see Configure the eWays on page 56 Create a Deployment Profile see Creating the Deployment Profile on page 57 Sun SeeBeyond eWay Adapter for IMS User s Guide 46 Sun Microsystems Inc Chapter 5 Section 5 4 Implementing an IMS eWay Project The prjIMS_JCD_Sample Project s4 The prjIMS_JCD_Sample Project The prjIMS_JCD_Sample project demonstrates connectivity with an external IMS system Sample Project Overview 1 The inbound File eWay receives a file from an external directory 2 This file is the published by the IMS eWay to an external IMS application 3 The IMS eWay receives the f
79. roperties Table 4 IMS eWay Connection Mode Parameter Settings Name Description Required Value IMS Connection Mode Specifies how a connection with the external system is established and closed Automatic indicates that the connection is automatically established when the collaboration is started and it keeps the connection alive as needed OnDemand indicates that the connection will be established on demand as business rules requiring a connection to the external system are performed The connection will be closed after the methods are completed Manual indicates that the user will explicitly call the connect and disconnect connection methods in their collaboration as business rules Default is Automatic Either a Manual or Automatic setting Default setting is Manual 33 IMS eWay Environment Explorer Properties The IMS eWay configuration parameters accessed from the Environment Explorer tree are organized into the following sections TCPIP Configuration on page 22 IRM Header on page 22 Connection Retry Settings on page 30 Connection Pool Settings on page 31 Sun SeeBeyond eWay Adapter for IMS User s Guide 21 Sun Microsystems Inc Chapter 3 Section 3 3 Configuring the IMS eWay IMS eWay Environment Explorer Properties Figure 5 IMS eWay Environment Properties Editor START SEEN uA EJ TCPIP Configuration E O IRM Header O Connection Retry Settings Conn
80. rques 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 Num
81. rs on the Project Explorer tree 2 Rename the project for this sample prj MFS_IMS_JCD_Sample 55 2 Create a Connectivity Map 1 In Enterprise Explorer right click the new project and select New gt Connectivity Map from the shortcut menu 2 The new Connectivity Map appears From the Project Explorer rename the new Connectivity Map cmMFS_IMS_JCD Select the External Applications To add the External Applications used with the MFS_IMS_JCD_Sample project do the following 1 Click the External Application icon on the Connectivity Map toolbar 2 Select the File External Application from the selection menu The File External System is added to the Connectivity Map toolbar Populate the Connectivity Map Add the project components to the Connectivity Map by dragging and dropping the icons from the toolbar to the Connectivity Map canvas 1 For this project add the following components to the Connectivity Map canvas as displayed in Figure 33 File External System 2 Service A Service is a container for Java Collaborations Business Processes eTL processes and so forth IMS External System Sun SeeBeyond eWay Adapter for IMS User s Guide 60 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing an IMS eWay Project The prjMFS_IMS_JCD_Sample Project Figure 33 Connectivity Map with Components 8 Be Cee Pla b gt CMapi_Servicel 2 Save your current changes to the Repository 553 Create an OTD
82. rting the Domain Building and Deploying the Project Running the Sample Project The prjMFS_IMS_JCD_Sample Project Create a project Create a Connectivity Map Select the External Applications Populate the Connectivity Map Create an OTD Using the IMS MFS Wizard Create the Collaboration Definitions The JavaCollaborationMFS Collaboration The MFS_IMS_Collab Business Rules Creating Collaboration Bindings Creating an Environment Configure the eWays Creating the Deployment Profile Creating and Starting the Domain Building and Deploying the Project Running the Sample Project The prjMFS_JCD_Sample Project Importing the prjMFS_JCD_Sample Project Create a project Create a Connectivity Map Select the External Applications Populate the Connectivity Map Creating an OTD Using the IMS MFS Wizard Creating the Environment Configure the eWays Creating the Deployment Profile Creating and Starting the Domain Building and Deploying the Project Running the Sample Project Index Sun SeeBeyond eWay Adapter for IMS User s Guide Sun Microsystems Inc Chapter 1 Introducing the IMS eWay This document describes how to install and configure the IMS eWay Intelligent Adapter called the IMS eWay throughout this document as well as how to implement the eWay in a typical eGate environment This chapter provides a brief overview of operations and components general features and system requirements of the IMS eWay What s in This Chapter
83. so all connections are made to the correct items The jedIMS Collaboration contains the Business Rule displayed in Figure 23 Sun SeeBeyond eWay Adapter for IMS User s Guide 50 Sun Microsystems Inc Chapter 5 Section 5 4 Implementing an IMS eWay Project The prjIMS_JCD_Sample Project Figure 23 IMS_Java_Collab Collaboration Business Rules Copy Textto Message lt gt Copy input Text to IMS_1 Message IMS_1 connect lt gt IMS_1 connect A IMS_1 1MSRequest lt gt IMS_1 IMSRequest S Copy Reply to Text lt gt Copy IMS_1 Reply to FileClient_1 Text F IMS_1 disconnect lt gt IMS_1 disconnect L FileClient_4 wwite L lt gt FileClient_1 write E logger ET alerter E collabContext E typeConverter To create the jcdIMS Collaboration Collaboration Business Rules do the following 1 From the Project Explorer tree double click the jcdIMS Collaboration to open the Collaboration Editor to the IMS_Java_Collab Collaboration 2 To create comments for the Business Rules from the Business Rules toolbar click the Comment icon The Create Comment dialog box appears Enter the comment and click OK The comment is placed on the Business Rules tree under the last selected item Once the comment is created it can be moved by clicking the comment and dragging it up or down the Business Rules tree to a new location 3 Create the Copy input Text to IMS_1 Message ru
84. ss Rules Designer Adding Business Rules 1 Right click the link between the FileClient receive and IMS_eWay request Activities and select Add Business Rule from the shortcut menu 2 Repeat step 1 for the link between IMS_eWay request and FileClient write see Figure 9 Figure 9 elnsight Business Process Designer Adding Business Rules xo BAE ov ob o O 08 Or Start FileClient receive IMS eWay IMSRequest FileClient NN End Using the Business Rules Designer 1 From the elnsight Business Process Designer toolbar click the Display Business Rules Designer button The Business Rules Designer appears at the bottom of the elnsight Business Process Designer 2 Click on the Business Rule icon in the link between FileClient receive and IMS_eWay IMSRequest to display the Business Rule Input and Output Attributes in the Business Rules Designer These attributes can now be modified Sun SeeBeyond eWay Adapter for IMS User s Guide 36 Sun Microsystems Inc Chapter 4 Section 4 5 Using the IMS eWay With elnsight The prjIMS_BP_Sample Project 3 Map text under FileClient receive Output in the Output pane to message under IMS eWay IMSRequest Input gt input in the Input pane This is done by clicking on text and dragging the cursor to message see Figure 10 Figure 10 elnsight Business Rules Designer Business Rule Designer Conversion Datetime Operator
85. t from the method selection box The connect method box appears in the Business Rules Designer canvas see Figure 25 on page 52 Figure 25 IMS_1 connect Business Rule Business Rules Designer eo amp 8 2X Bpooleany Comparisons Elmath Object AString H larray fOperators Assignment IMS_1 connect D Gd jodIMS jedims Gap IS FileClient_1 FileClient_1 IS IS ims_1 IMS_1 IS H amp Bands Bands DatastorelD DatastorelD LtermName connect LtermName amp Message IMSClientETD Message k Password Password amp Port Port RactGroupName RactGroupName amp RactUserlD RacfUserlD ReasonEnhisg ReasonEntsg Reply Reply amp gt BR ReplyBytes ReplyBytes Bab lt amp RetumEnrtsg RetumEnmMsg amp SegmentCount SegmentCount Server Server TranCode TranCode L amp TranCodeSre TranCodeSre amp LO MS innut 4 PR S innut ME 5 To create the IMS_1 IMSRequest Business Rule do the following A From the Business Rules toolbar click the rule button to add a new rule B Right click the IMS_1 node in the left pane of the Business Rules Designer and select Select a method to call from the shortcut menu The method selection box appears C Select IMSRequest from the method selection box The IMSRequest method box appears in the Business Rules
86. t the products for your Sun Java Composite Application Platform Suite and include the following IMSeWay sar to install the IMS eWay MFS sar to install the MFS Wizard FileeWay sar to install the File eWay used with the sample project 4 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 5 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 Follow this procedure for each of your products The Installing Files window appears after the last SAR file has been selected 6 From the Installing Files window review the product list If it is correct Click Install Products The Enterprise Manager starts the installation 7 When your product s installation is completed click on the prompt When installation completes click here to continue To upload the Sun SeeBeyond eWay Adapter for IMS User s Guide Help file Javadoc Readme and sample Projects do the following A Expand the Documentation option B Select IMSeWayDocs C Click Next in the top right or bottom right corner of the Select Sun Java Composite Application Platform Suite Products to Install box 222 Adding the eWay to an Existing Sun Java Composite Application Platform Suite Installation It is possible to add the eWay to an existing Su
87. tance of a Logical Host After the domain is created the Project is built and then deployed Note You are only required to create a domain once when you install the Composite Application Platform Suite Steps required to create and start the domain 1 Navigate to your lt caps51 gt logicalhost directory where lt caps51 gt is the location of your Sun Java Composite Application Platform Suite installation 2 Double click the domainmgr bat file The Domain Manager appears 3 If you have already created a domain select your domain in the Domain Manager and click the Start an Existing Domain button Once your domain is started a green check mark indicates that the domain is running Sun SeeBeyond eWay Adapter for IMS User s Guide 68 Sun Microsystems Inc Chapter 5 Section 5 6 Implementing an IMS eWay Project The prjMFS_JCD_Sample Project 4 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 5 Make any necessary changes to the Create Domain dialog box and click Create The new domain is added to the Domain Manager Select the domain and click the Start an Existing Domain button Once your domain is started a green check mark indicates that the domain is running Note For more information about creating and managing domains see the eGate Integrator System Administration Guide 55 11 Building and Deploying the Project The Build process
88. te For information on configuring the File eWay nodes refer to the eWay File Adapter User s Guide Modifying the IMS eWay Connectivity Map Properties 1 From the Connectivity Map double click the IMS eWay The Properties Window opens to the IMS eWay project configuration properties 2 Modify the IMS eWay Project Explorer configuration for your system and click OK For more information on these properties refer to IMS eWay Connectivity Map Properties on page 20 Modifying the IMS eWay Environment Explorer Properties 1 From the Environment Explorer tree right click the IMS External System IMSExtSys in this sample and select Properties from the shortcut menu The Properties Window opens to the IMS eWay Environment Explorer properties 2 Modify the IMS eWay Environment Explorer properties for your system and click OK For more information on these properties refer to IMS eWay Environment Explorer Properties on page 21 567 Creating the Deployment Profile A Deployment Profile is used to assign services and message destinations to the integration server and message server Deployment profiles are created using the Deployment Editor 1 From the Enterprise Explorer s Project Explorer right click the prjMFS_JCD_Sample Project and select New gt Deployment Profile 2 Enter a name for the Deployment Profile for this sample dpMFS_JCD_Sample Select MFS_JCD_Sample_Env as the Environment insure the correct connectivity map is se
89. that language for example cp390 for Japanese REPLY_DATA_ENCO DING Specifies the encoding of the message body received back from IMS Connect Set to ISO 8859 1 if the message text is ASCII Set to an EBCDIC code such as cp500 if the return message is EBCDIC and or no content translation is needed If the content set is a double byte character such as Japanese set the appropriate EBCDIC code page for that language for example cp930 for Japanese Sun SeeBeyond eWay Adapter for IMS User s Guide 28 The appropriate code page For ASCII transactions enter ISO 8859 1 For EBCDIC transactions enter an EBCDIC code such as cp500 For double byte character sets enter the appropriate code page for that language for example cp390 for Japanese Sun Microsystems Inc Chapter 3 Section 3 3 Configuring the IMS eWay IMS eWay Environment Explorer Properties Configuring the Client ID for the IMS eWay The following sections describe the configuration of Client IDs for the IMS eWay Dynamic Generation of IMS Client ID In this mode the IMS eWay is configured to handle multiple requests simultaneously parallel mode To configure the IMS eway for parallel processing do the following 1 Set the Client ID in the IRM_Header section to a string which contains one or more trailing asterisks for example SUN The eWay will generate the rest of the Client ID string filling it with randomly gener
90. uffer outputBuffer append ZIP append dfsivf1_1 getIVTNO getIVTNO_SEG1 getIVTNO_SEG1_MFLD6_DEV_ZIP FileClient_1 setText outputBuffer toString IMS_1 disconnect FileClient_1 write For more information on how to create Business Rules using the Collaboration Editor see Using the Collaboration Editor Java on page 50 or refer to the eGate Integrator User s Guide 55 6 Creating Collaboration Bindings After the Collaboration has been written the components are associated and Bindings are created in the Connectivity Map 1 From the Project Explorer tree double click cmMFS_IMS_JCD to display the Connectivity Map 2 Drag and drop the jcdMFS_IMS Collaboration from the Project Explorer onto the Service Service1 3 Double click Service1 in the Connectivity Map The Service1 Binding dialog box appears 4 From the Service1 Binding dialog box drag FileClient input under Implemented Services to the FileIn External Application 5 From the Service1 Binding dialog box drag FileClient_1 under Invoked Services to the FileOut External Application see Figure 37 on page 66 Sun SeeBeyond eWay Adapter for IMS User s Guide 65 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing an IMS eWay Project The prjMFS_IMS_JCD_Sample Project 6 Figure 37 Connectivity Map Connecting the Project s Components Sesae BOF Rule IMS_MFS_Collab oe me gt Implemented Services FEON
91. ules created using the Collaboration Editor String auditTransactStr String auditoTransactReply Sun SeeBeyond eWay Adapter for IMS User s Guide 64 Sun Microsystems Inc Chapter 5 Section 5 5 Implementing an IMS eWay Project The prjMFS_IMS_JCD_Sample Project StringBuffer outputBuffer new StringBuffer dfsivf1_1 getIVTNOM getIVTNOMI1_SEG1 setIVTNOMI1_SEG1_MFLD2_DEV _CMD DISPLAY dfsivf1_1 getIVTNOM getIVTNOMI1_SEG1 setIVTNOMI1_SEG1_MFLD3_DEV _NAME1 input getText auditTransactStr dfsivf1l_1 marshalToString IMS_1 setMessage auditTransactStr IMS_1 connect IMS_1 IMSRequest auditoTransactReply IMS_1 getReply substring 1 IMS_1 getReply length 11 dfsivf1_1 unmarshalFromString auditoTransactReply outputBuffer outputBuffer append FIRST NAME append dfsivf1_1 getIVTNO getIVTNO_SEG1 getIVTNO_SEG1_MFLD4_DEV_NAME2 E outputBuffer outputBuffer append LAST NAME append dfsivf1_1 getIVTNO getIVTNO_SEG1 getIVTNO_SEG1_MFLD3_DEV_NAME1 outputBuffer outputBuffer append EXT append dfsivf1_1 getIVTNO getIVTNO_SEG1 getIVTNO_SEG1_MFLD5_DEV_EXT_ outputB
92. ver Password property before deploying your Project 1 From the Environment Explorer right click IntegrationSvr1 under your Logical Host and select Properties from the shortcut menu The Integration Server Properties Editor appears 2 Click the Password property field under SeeBeyond Integration Server Configuration An ellipsis appears in the property field 3 Click the ellipsis The Password Settings dialog box appears Enter STC as the Specific Value and as the Confirm Password and click OK 4 Click OK to accept the new property and close the Properties Editor For more information on deploying a Project see the Sun SeeBeyond Java Composite Application Platform Suite Deployment Guide 549 Creating the Deployment Profile A Deployment Profile is used to assign services and message destinations to the integration server and message server Deployment profiles are created using the Deployment Editor 1 From the Enterprise Explorer s Project Explorer right click the prjIMS_JCD_Sample Project and select New gt Deployment Profile 2 Enter a name for the Deployment Profile for this sample dpIMS_JCD Select IMS_JCD_Sample_ENV as the Environment insure the correct connectivity map is selected and click OK 3 From the Deployment Editor toolbar click the Automap icon The Project s components are automatically mapped to their system windows as seen in Figure 32 Sun SeeBeyond eWay Adapter for IMS User s Guide 57 Sun
93. vity Map The Connectivity Map provides a canvas for assembling and configuring a project s components 1 From the Project Explorer tree right click the new prjIMS_BP_Sample project and select New gt Connectivity Map from the shortcut menu Sun SeeBeyond eWay Adapter for IMS User s Guide 37 Sun Microsystems Inc Chapter 4 Section 4 5 Using the IMS eWay With elnsight The prjIMS_BP_Sample Project 2 The New Connectivity Map appears and a node for the Connectivity Map is added under the project on the Project Explorer tree labeled CMap1 Rename the Connectivity Map cmIMS_BP The icons in the toolbar represent the available components used to populate the Connectivity Map canvas Selecting the External Applications In the Connectivity Map the eWays are associated with External Systems For example to establish a connection to IMS you must first select IMS as an External System to use in your Connectivity Map see Figure 12 Figure 12 Connectivity Map External Applications 2e opw E File External Application Scheduler 1 Click the External Application icon on the Connectivity Map toolbar 2 Select the external systems needed for your project for this sample IMS and File Icons representing the selected external systems are added to the Connectivity Map toolbar Populating the Connectivity Map Add the project components to the Connectivity Map by dragging the icons from the
94. w appear as displayed in Figure 16 Figure 16 Environment Editor Enterprise Explorer Repository HEAD IMSExtsys LogicalHost1 LR Integrationsvrt E B FileExtSysInOut h Be IntegrationSvr1 leExtSysinOu 456 Configuring the eWays The prjIMS_BP_Sample project uses three eWays each represented in the Connectivity Map as a node between an External Application and a Business Process see Figure 17 eWays facilitate communication and movement of data between the external applications and the eGate system Sun SeeBeyond eWay Adapter for IMS User s Guide 41 Sun Microsystems Inc Chapter 4 Section 4 5 Using the IMS eWay With elnsight The prjIMS_BP_Sample Project Figure 17 eWays IMS eWay CR a ff Outbound File eWay eaFileln Inbound File eWay CG a eaFileOut The File eWay properties are configured from the Connectivity Map The IMS eWay properties are set from both the Project Explorer s Connectivity Map and the Environment Explorer Note For information on configuring the File eWay nodes refer to the eWay File Adapter User s Guide Configuring the IMS eWay The IMS eWay properties must be set in both the Project Explorer and Environment Explorer For more information on the IMS eWay properties and the Properties Window see Configuring the eWay Properties on page 15 or see the eGate Integrator User s Guide For the prjIMS_BP_Sample project do the following Modifying the IMS eWay C
95. y and click OK Right click IMS_JCD_Sample_Env and select New Logical Host The LogicalHost1 box is added to the Environment and LogicalHost1 is added to the Environment Editor tree From the Environment Explorere tree right click LogicalHost1 and select New gt Sun SeeBeyond Integration Server from the shortcut menu A new Integration Server IntegrationSvr1 is added to the Environment Explorer tree under LogicalHost1 see Figure 30 Sun SeeBeyond eWay Adapter for IMS User s Guide 55 Sun Microsystems Inc Chapter 5 Section 5 4 Implementing an IMS eWay Project The prjIMS_JCD_Sample Project Figure 30 Environment Editor Repository1 HEAD ER B IMSExSys E E FileExtSysinout E LogicalHosti L DN E IntegrationSwr1 g IntegrationSvrt 8 Save your current changes to the Repository 547 Configure the eWays The prjIMS_JCD_Sample project uses three eWays each represented in the Connectivity Map as a node between an External Application and the Collaboration see Figure 31 eWays facilitate communication and movement of data between the External Applications and the eGate system Note For information on configuring the File eWay nodes refer to the eWay File Adapter User s Guide Figure 31 eWays Nodes IMS eWsy Inbound Fie eWay ealMS E 2 al eaFileln jcollMs eaFileOut Outbound File eWay Configuring the IMS eWay The IMS eWay properties must be set in both the Project Explorer and
96. yed in Table 8 Table 8 Outbound IMS eWay Environment Connection Retry Settings Name Description Required Value Maximum Retries Specifies the number of retries to establish a connection with the IMS database upon a failure to acquire one an integer indicationg the number of attempts allowed to establish a connection The configured default is 5 Sun SeeBeyond eWay Adapter for IMS User s Guide 30 Sun Microsystems Inc Chapter 3 Configuring the IMS eWay Section 3 3 IMS eWay Environment Explorer Properties Table 8 Outbound IMS eWay Environment Connection Retry Settings Name Description Required Value Retry Interval ms Specifies the configured length of the pause before each reattempt to access the destination file This property is used in conjunction with the property Maximum Retries An integer indicating the configured length of the time in milliseconds before each reattempt to access the destination file The configured default is 5000 1 second 33 5 Connection Pool Settings The Connection Retry Settings section of the Outbound IMS Environment contains the top level parameters displayed in Table 8 Table 9 Outbound IMS eWay Environment Connection Pool Settings Name Description Required Value Steady Pool Size Specifies the initial and minimum number of connections to be maintained A number indicating the initial and
Download Pdf Manuals
Related Search
Related Contents
Manuel d`installation 3 対策にともなう注意点 麻雀格闘倶楽部 ultimate version A Newstar FPMA-W830 flat panel wall mount Philips MCM138D Micro Hi-Fi System MANUAL Registre mondial Additif 12: Règlement technique mondial n 12 Anleitung - Tramsoft quatix™ - Garmin Copyright © All rights reserved.
Failed to retrieve file