Exposing CICS Transactions to WLE

Transcription

1 Exposing CICS Transactions to WLE Lab Exercise Author: David J Brett, Version 1.0

2 IBM BPM 7.5 Lab Number 1 Copyright IBM Corporation, 2011 US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

3 IBM Software Contents 1.1 Lab Setup 1.2 Create a SCA Component that interfaces to CICS Catalog Transaction 1.3 Implement the Single_Item_Inquiry_BPD in Process Designer 1.4 Testing the component in the Process Center 1.5 Summary Contents Page 3

4 IBM BPM 7.5 IBM Software Lab 1 Exposing CICS Transactions to WLE The CICS Catalog application is a working COBOL application that is shipped with CICS that illustrates best practices when connecting client applications to CICS applications. In this lab we will use the CICS Catalog Application in conjunction with the CICS Transaction Gateway to demonstrate how to connect a WLE Process Application to the Catalog Application's single item Inquiry transaction using the WebSphere Process Server v7.5 environment. This lab assumes the user has some familiarity with both the IBM Integration Developer and Process Designer environments. 1.1 Lab Setup Please refer to the information located at the following link for the CICS Catalog Manager example application setup. %2Fcom.ibm.cics.ts.exampleapplication.doc%2Ftopics%2Fdfhxa_t100.html 1.2 Create a SCA Component to interface to CICS Catalog Transaction You will now work in WID to create a SCA component that will invoke the CICS Catalog Transaction. 1. Open WebSphere Integration Designer a. b. In the main menu click File New Module Fill in New Module Information and click Finish Lab 1 Page 7

5 IBM Software IBM BPM Configure CICS_Single_Item_Inquiry to invoke the CICS transaction a. b. In the Assembly Diagram drag the Outbound CICS Adapter onto the Assembly Diagram canvas. This will display New External Service Wizard. Select the ECIResourceAdapter ( ). Fill in the screens as follows using the parameters for your environment (JNDI Name). c. d. e. f. g. h. i. j. k. On the Add, Edit, or Remove Operations screen click the Add button. On the Add Operation screen enter SingleItemInquiry in the Operation name field. Click the New button next to the Input type field On the New Business Object From External Data screen click the Browse button next to the COBOL file field. This will bring up a selection dialog where you should select the InqSingle.cpy copybook on your file system Click the Next button In the Platform drop down list select z/os Click the Find button, highlight N01INQS, and click the Next button Click the Finish button This will bring you back to the Add Operation screen. On this screen check the Use the input type for the output check box Page 8 Exposing CICS Transactions to WLE

6 IBM BPM 7.5 IBM Software l. m. Click the Finish button. This will navigate you back to the New External Service screen. Enter DFH0XCMN in the Function name field. n. o. p. Click the Next button Enter SingleItemInquiry_Interface in the Name field. Uncheck the Join Transaction check box Lab 1 Page 9

7 IBM Software IBM BPM 7.5 q. r. s. t. u. Click the Finish button. This will place the SingleItemInquiry_Interface component on the Assembly Diagram canvas. Add a SCA Export to the Assembly Diagram with the named SingleItemInquiry_SCAExport and configure it to use the generated SingleItemInquiry_Interface. Right-click on the SingleItemInquiry_SCAExport and select the Generate Binding SCA Binding menu item. Wire the SingleItemInquiry_SCAExport to the SingleItemInquiry_Interface component v. Close and save the CICS_Single_Item_Inquiry Assembly Diagram Page 10 Exposing CICS Transactions to WLE

8 IBM BPM 7.5 IBM Software w. x. y. Create a new Library by selecting the File New Library menu item Fill in the Library Name field with the value Catalog_Library, accept the defaults and click the Finish button. Refactor (move) the generated artifacts N01INQS (Business Object), and Single_Item_Inquiry_Interface (Interface) into the Catalog_Library. 3. Create a BPD in Process Designer a. b. c. Open Process Designer In the Process Apps tab click Crate New Process App on the right hand side of the screen Fill in the Create New Process App as seen below and click Create d. Click the Open in Designer link next to the Single_Item_Inquiry_PA (SI_INQ) Process Application e. f. g. h. On the left hand side of the screen click the + symbol next to Processes. Then click on Business Process Definition on the Create New menu. Enter Single_Item_Inquiry_BPD in the Name field Click Finish. At this point Process Designer will display the diagram view of the Single_Item_Inquiry_BPD. Lab 1 Page 11

9 IBM Software IBM BPM 7.5 i. Click the Save icon at the top of the screen 4. Import the WLE BPD into WebSphere Integration Designer a. Switch back into WID and click on the Open Perspective Icon b. c. Select the Process Center perspective Fill in the appropriate connection information for your environment on the Process Center Login screen Page 12 Exposing CICS Transactions to WLE

10 IBM BPM 7.5 IBM Software d. Click the Login button. This will bring the Process Center Screen up inside WID and will display all of the available applications on the screen e. Next to the Single_Item_Inquiry_PA click on the Open in workspace link. This will present the Open Process Applications or Toolkits in WID screen. Lab 1 Page 13

11 IBM Software IBM BPM 7.5 f. Click OK. This action will import and create the Single_Item_Inquiry_PA module inside of WID g. h. Highlight the CICS_Single_Item_Inquiry, Catalog_Library, and cicseci7011 modules. Right click the items and select the Associate with Process Center menu item Page 14 Exposing CICS Transactions to WLE

12 IBM BPM 7.5 IBM Software i. The Associate with Process Center dialog will be presented. Click Finish. j. Associating the three artifacts with the Process Center application will move them inside the imported Single_Item_Inquiry_PA module Lab 1 Page 15

13 IBM Software IBM BPM 7.5 k. l. m. Highlight the Catalog_Library and display the properties In the properties dialog select Business Integration Library Mirroring Check the Mirror the library as soon as it associated with Process Center check box n. o. p. q. Click the OK button Expand the Catalog_Library artifact tree Double-click on Dependencies In the Catalog_Library Dependencies click on the down arrow next to Sharing Across Runtime Environments Page 16 Exposing CICS Transactions to WLE

14 IBM BPM 7.5 IBM Software r. Select Module under Sharing Across Runtime Environments s. t. u. v. Close and save the Catalog_Library Dependencies Open the CICS_Single_Item_Inquiry Assembly Diagram Display the properties of the SingleItemInquiry_SCAExport On the Bindings tab check the Make operations visible to Process Designer check box w. x. y. Close and save the CICS_Single_Item_Inquiry Assembly Diagram Select Single_Item_Inquiry_PA and right-click to display the action menu. Select the Refresh and Publish menu item Lab 1 Page 17

15 IBM Software IBM BPM 7.5 z. Press OK on the Library Mirroring warning screen. This will generate and update all the relevant artifacts and publish them to the Process Center where they will be picked up by Process Designer 1.3 Implement the Single_Item_Inquiry_BPD in Process Designer 1. Create the Process variables a. b. In Process Designer select the Open in Designer link next to the Single_Item_Inquiry_PA Process Application. Click on Processes and open the Single_Item_Inquiry_BPD. Page 18 Exposing CICS Transactions to WLE

16 IBM BPM 7.5 IBM Software c. In the Single_Item_Inquiry_BPD Designer click on the Variables tab. d. e. f. Click the Add Private button. Name the new private variable item_id, take the default as a string. Click the Has Default check box. g. Assign the default value of 10. h. Add two more Private Variables named cics_input, and cics_output and make them both Variable Types N01INQS. i. Go back to the Diagram View by clicking the Diagram tab. 2. Add Activities to the Diagram a. From the pallet on the right add two activities to the System Swim Lane. The will be named Untitled, Untitled1. Lab 1 Page 19

17 IBM Software IBM BPM 7.5 b. c. From the pallet on the right add three activities to the Participant Swim Lane. They will be named Untitled2, Untitled3, and Untitled4. From the pallet on the right add one decision activity to the Participant Swim Lane. It will be named Untitled5. d. Select the Sequence Flow Tool and connect the six activities starting from the starting from the Start Node, ending with the Stop Node (see below). e. Rename the Activities by clicking on the activity and modifying the name in the Properties tab (see below). Page 20 Exposing CICS Transactions to WLE

18 IBM BPM 7.5 IBM Software 3. Configure Activities a. b. c. Right-click on the first activity (Gather Input) and select Activity Wizzard. Select Human Service. Select Create a New Service. d. Click Next. Lab 1 Page 21

19 IBM Software IBM BPM 7.5 e. Notice the input fields are set to true for both input and output. Click on both input and output of cics_input and cics_ouput to change the input and output to false. f. g. h. Click Finish. Right-click on the next activity ( Map Data ) and select Activity Wizard. Make it a System Service. i. Click Finish. Page 22 Exposing CICS Transactions to WLE

20 IBM BPM 7.5 IBM Software j. k. l. m. n. Right-click on the third activity ( Invoke CICS Service ) and select Activity Wizard. Make it an Advanced Integration Service. Choose Attach to Existing Service. Click Select... Choose SingleItemInquiry_Interface under Advanced Integration Service. o. p. q. r. Click Finish. Right-click on the fourth activity ( Display Response) and select Activity Wizard. Select Human Service. Select Create a New Service. Lab 1 Page 23

21 IBM Software IBM BPM 7.5 s. t. u. v. w. Click Finish. Right-click on the fourth activity ( Display Response) and select Activity Wizard. Select Human Service. Select Create a New Service. Click Finish. Page 24 Exposing CICS Transactions to WLE

22 IBM BPM 7.5 IBM Software 4. Implement Services a. b. Double-click on the Gather Input activity. Double-click on the Coach or click on the Coaches tab. The default coach with one input field is displayed. c. d. e. f. g. Click the X next to Gather Input to close the Coach screen. Double-click on the Map Data Activity. Click on the Script Activity. In the bottom half of the screen click on the Implementation tab. In the Script window enter the following lines of code Lab 1 Page 25

23 IBM Software IBM BPM 7.5 h. i. j. k. l. m. n. o. Close the Map Data Activity by clicking on the X next to Map Data on the top of the screen. Save the changes Click on the Invoke CICS Service Acitivity Click on the Data Mapping tab on the bottom of the screen. Click on the mapping button on the right side of the Input Mapping field. From the pop-up box double-click on cics_input Click on the mapping button on the right side of the Output Mapping field. From the pop-up box double-click on cics_output Page 26 Exposing CICS Transactions to WLE

24 IBM BPM 7.5 IBM Software p. q. r. Click on the Check for CICS Exception. Click on the Implementation tab in the properties Configure the to Display Response Decision as follows s. Double-click on the Display Response Activity. Lab 1 Page 27

25 IBM Software IBM BPM 7.5 t. u. Double-click on the Coach Configure the Coach screen as follows by right-clicking on the unwanted fields and selecting Delete. v. w. x. y. Close and Save the Display Response Activity. Double-click on the CICS Error Response Activity. Double-click on the Coach. Configure the Coach screen as follows by right-clicking on the unwanted fields and selecting Delete. z. Close and save the Coach 1.4 Testing the component in the Process Center In order to test you must first have the CICS Resource Adapter installed and configured on the Process Center with the JNDI name used when you created the CICS SCA component inside WID. 1. While in the Single_Item_Inquiry_BPD click on the Run Process button on the right hand side of the screen above the artifacts pane. This will automatically change into the Inspector perspective, initiate the process and pause it at the Gather Input activity. Page 28 Exposing CICS Transactions to WLE

26 IBM BPM 7.5 IBM Software 2. In the Inspector perspective highlight the Received entry on the top right hand side of the screen and then click on the Run selected task button. 3. Select bpmauthor from the Pick User From Role dialog screen and click the OK button. This will bring up a browser window and display the Gather Input screen. 4. Enter a valid item id (it will default to the valid item id of 10) and press the OK button. This will close the browser window. 5. Back in the inspector click on the Refresh button. 6. Highlight the Display Response item in the activity list and again click on the Run Selected Task button. 7. Select bpmauthor from the Pick User From Role dialog screen and click the OK button. This will bring up a browser window and display the Display Response screen. Lab 1 Page 29

27 IBM Software IBM BPM Click OK to dismiss the Display Response screen. Back in the inspector click on the Refresh button. You should see the flow as completed. 1.5 Summary In this lab you discovered how to integrate a CICS based transaction into a WLE Process Application. You saw how to wrap the CICS transaction as an SCA component in IBM Integration Developer and how to import the SCA component into IBM Process Designer. In the Process Designer you saw how to interface to the SCA component and how to work with the input and outputs from the interaction. This lab can be used as an example of how to integrate more complex transactions into more complex Process Applications for your application environment. Page 30 Exposing CICS Transactions to WLE