BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide Release 5.0 Documet Date: Jauary 2002
Copyright Copyright 2002 BEA Systems, Ic. All Rights Reserved. Restricted Rights Leged This software ad documetatio is subject to ad made available oly pursuat to the terms of the BEA Systems Licese Agreemet ad may be used or copied oly i accordace with the terms of that agreemet. It is agaist the law to copy the software except as specifically allowed i the agreemet. This documet may ot, i whole or i part, be copied photocopied, reproduced, traslated, or reduced to ay electroic medium or machie readable form without prior coset, i writig, from BEA Systems, Ic. Use, duplicatio or disclosure by the U.S. Govermet is subject to restrictios set forth i the BEA Systems Licese Agreemet ad i subparagraph (c)(1) of the Commercial Computer Software-Restricted Rights Clause at FAR 52.227-19; subparagraph (c)(1)(ii) of the Rights i Techical Data ad Computer Software clause at DFARS 252.227-7013, subparagraph (d) of the Commercial Computer Software--Licesig clause at NASA FAR supplemet 16-52.227-86; or their equivalet. Iformatio i this documet is subject to chage without otice ad does ot represet a commitmet o the part of BEA Systems. THE SOFTWARE AND DOCUMENTATION ARE PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. FURTHER, BEA Systems DOES NOT WARRANT, GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE, OR THE RESULTS OF THE USE, OF THE SOFTWARE OR WRITTEN MATERIAL IN TERMS OF CORRECTNESS, ACCURACY, RELIABILITY, OR OTHERWISE. Trademarks or Service Marks BEA, Jolt, Tuxedo, ad WebLogic are registered trademarks of BEA Systems, Ic. BEA Builder, BEA Campaig Maager for WebLogic, BEA elik, BEA Maager, BEA WebLogic Commerce Server, BEA WebLogic E-Busiess Platform, BEA WebLogic Eterprise, BEA WebLogic Express, BEA WebLogic Itegratio, BEA WebLogic Persoalizatio Server, BEA WebLogic Portal, BEA WebLogic Process Itegrator, BEA WebLogic Server ad How Busiess Becomes E-Busiess are trademarks of BEA Systems, Ic. All other trademarks are the property of their respective compaies. BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide Part Number Date Software Versio N/A Jauary 2002 5.0
Cotets 1. Workflow Processig with BEA WebLogic Java Adapter for Maiframe Itroductio to Busiess Process Maagemet with WebLogic Itegratio... 1-2 Uderstadig WebLogic Itegratio Iteractio with the Maiframe... 1-3 Accessig Maiframe Applicatios Usig WebLogic JAM... 1-5 Roadmap for Workflow Processig with WebLogic JAM... 1-5 2. Istallig the WebLogic JAM Plug-I Preparig to Istall WebLogic JAM Plug-i... 2-2 Verify Software Requiremets... 2-2 Determie the Appropriate Platform... 2-2 Dowload WebLogic JAM Plug-i from the Web... 2-2 Determie the Istallatio Method... 2-3 Istallig the WebLogic JAM Plug-i... 2-3 Usig Graphics Mode Istallatio... 2-3 Usig Cosole Mode Istallatio... 2-9 Istallig Over a Previous Versio... 2-10 Istallig Without WebLogic JAM... 2-11 Istallig Without WebLogic Server... 2-11 Istallig Without WebLogic Itegratio... 2-11 Verifyig Your Istallatio... 2-12 Uistallig BEA WebLogic Java Adapter for Maiframe Plug-i... 2-13 Uistallig i Graphics Mode... 2-13 Uistallig i Cosole Mode... 2-15 3. Usig Maiframe Applicatios with Workflows Before You Begi... 3-1 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide iii
Usig WebLogic JAM with Workflow Processig... 3-2 Step 1: Set Up the WebLogic JAM Plug-i Compoets... 3-2 Step 2: Set Up Data Traslatio... 3-4 Step 3: Set Up the Workflow to Iteract With the Maiframe... 3-8 Requestig Maiframe Services from a Workflow... 3-9 Cofigurig Maiframe Services... 3-9 Usig Maiframe Actios i Workflows... 3-10 Addig Maiframe Actios... 3-11 Updatig Maiframe Actios... 3-15 Deletig a Maiframe Actio... 3-15 Chagig the Sequece of Maiframe Actios... 3-16 Iitiatig Workflows from the Maiframe... 3-16 Example of Iitiatig a Workflow from the Maiframe... 3-16 Modify the WebLogic JAM Cofiguratio... 3-18 Edit the Workflow Start Node... 3-19 4. Ruig the WebLogic Itegratio Examples What is Icluded i the Sample... 4-1 Ruig the BEA WebLogic Itegratio/WebLogic JAM Example... 4-2 Step 1: Set up the Maiframe... 4-3 Step 2: Cofigure ad Ru WebLogic Itegratio usig WebLogic Server... 4-3 Step 3: Create the Templates ad Import the Template Defiitios... 4-3 Step 4: Ope ad Activate the Template... 4-4 Step 5: Execute the Workflow... 4-7 Execute the JAM create Workflow... 4-7 Execute the JAM read ad JAM readstrig Workflow... 4-9 iv BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
CHAPTER 1 Workflow Processig with BEA WebLogic Java Adapter for Maiframe May customers eed a advaced e-busiess ifrastructure that icorporates process rules, workflow, ad applicatio compoets. To meet this eed, BEA WebLogic Java Adapter for Maiframe (WebLogic JAM) seamlessly plugs i to BEA WebLogic Itegratio, a powerful process itegratio ad workflow egie. This software combiatio allows you to create busiess processes, process rules, ad workflows that access maiframe applicatios. WebLogic JAM ca be used with WebLogic Itegratio i the followig ways: WebLogic Itegratio workflows ca ivoke applicatios o the maiframe. Data from the workflow is passed to the ivoked applicatio ad ay resultig data is retured to the workflow. Maiframe applicatios iitiate a workflow i WebLogic Itegratio usig a XML evet iterface. BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 1-1
1 Workflow Processig with BEA WebLogic Java Adapter for Maiframe This sectio provides iformatio o the followig subjects: Itroductio to Busiess Process Maagemet with WebLogic Itegratio l Uderstadig WebLogic Itegratio Iteractio with the Maiframe l Accessig Maiframe Applicatios Usig WebLogic JAM Roadmap for Workflow Processig with WebLogic JAM Itroductio to Busiess Process Maagemet with WebLogic Itegratio WebLogic Itegratio provides a ituitive flowchart model for defiig busiess processes that work across the eterprise ad i support of busiess-to-busiess iteractios with miimal huma iteractio. The powerful workflow egie executes those processes, automatically ivokig the resources required at each step. Olie process moitorig provides real-time data about how the processes are workig ad ay ecessary chages ca be made dyamically. Fully J2EE compliat, WebLogic Itegratio provides a ituitive graphical user iterface that eables busiesses to desig, moitor, ad modify workflow ad e-busiess processes without scriptig or programmig. Its ru-time egie automates ad maages the activities of applicatios ad such techologies as fax, WAP-eabled telephoes, ad other devices, with exceptio-based huma itervetio. WebLogic Itegratio uses XML as its stadard data format. To access data from a legacy system i WebLogic Itegratio, the data must be coverted to XML first. WebLogic Itegratio provides data itegratio by allowig you to traslate data from biary to XML or from XML to biary. This sectio provides iformatio o the followig subjects: Uderstadig WebLogic Itegratio Iteractio with the Maiframe Accessig Maiframe Applicatios Usig WebLogic JAM 1-2 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Itroductio to Busiess Process Maagemet with WebLogic Itegratio Uderstadig WebLogic Itegratio Iteractio with the Maiframe Figure 1-1 illustrates the flow of data whe a WebLogic Itegratio workflow accesses maiframe applicatios through WebLogic JAM. Whe WebLogic Itegratio seds data to the maiframe applicatio, the WebLogic JAM Gateway coverts the XML data received from WebLogic Itegratio to the biary format expected by the maiframe applicatio. The WebLogic JAM Gateway ivokes the data itegratio compoet of WebLogic Itegratio to perform this coversio. It the ivokes the maiframe program ad receives a respose. This respose is set to WebLogic Itegratio to covert the data from biary format to XML. Figure 1-1 Workflows Accessig Maiframe Applicatios BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 1-3
1 Workflow Processig with BEA WebLogic Java Adapter for Maiframe WebLogic JAM also allows a workflow to be iitiated by a evet triggered by a maiframe applicatio. Whe WebLogic JAM receives a request from the maiframe, it looks withi its cofiguratio to fid the destiatio applicatio withi WebLogic Server. If the specified destiatio is WebLogic Itegratio, the WebLogic JAM puts the maiframe data o a WebLogic Itegratio queue. WebLogic Itegratio pulls the data off the WebLogic Server evet queue ad recogizes that traslatio is required. The traslatio is performed, ad the data is retured to the queue. WebLogic Itegratio workflow that uses this XML is the iitiated. This flow of data is illustrated i Figure 1-2. Figure 1-2 Maiframe Applicatio Iitiatig a Workflow 1-4 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Roadmap for Workflow Processig with WebLogic JAM Accessig Maiframe Applicatios Usig WebLogic JAM WebLogic JAM seamlessly plugs i to WebLogic Itegratio, allowig busiess aalysts to iclude maiframe applicatios i busiess processes. WebLogic JAM uses WebLogic Itegratio to traslate biary data to ad from XML. XML is quickly becomig the stadard for exchagig iformatio betwee applicatios ad is ivaluable i itegratig disparate applicatios. WebLogic Itegratio provides for a exchage of iformatio betwee applicatios by supportig data traslatios betwee biary formats from legacy systems ad XML. WebLogic JAM works with WebLogic Itegratio s data traslatio feature to covert data betwee maiframe copybook formats ad XML format that ca be used by the process egie. Roadmap for Workflow Processig with WebLogic JAM The steps outlied i Figure 1-3 provide you with a high-level guidelie to all of the tasks ad processes that you must perform to istall, cofigure, ad work with WebLogic JAM. Thik of these steps as a roadmap to guide you through the process ad to poit you to the resources available to help you. BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 1-5
1 Workflow Processig with BEA WebLogic Java Adapter for Maiframe Figure 1-3 Roadmap for Workflow Processig with WebLogic JAM 1. Istall WebLogic Itegratio (see Istallig BEA WebLogic Itegratio) ad WebLogic JAM (see the BEA WebLogic Java Adapter for Maiframe Istallatio Guide). 2. Add the jam.jar file to your CLASSPATH (see the BEA WebLogic Java Adapter for Maiframe Istallatio Guide). 1-6 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Roadmap for Workflow Processig with WebLogic JAM 3. Istall the WebLogic JAM Plug-i (see Istallig the WebLogic JAM Plug-I). 4. Edit the cofig.xml file to deploy the WebLogic JAM Plug-i EJBs (see Usig WebLogic JAM with Workflow Processig). 5. Cofigure WebLogic JAM usig the Admiistratio Cosole (see the BEA WebLogic Java Adapter for Maiframe Cofiguratio ad Admiistratio Guide). 6. Create a workflow to iteract with a maiframe applicatio (see Usig Maiframe Applicatios with Workflows). 7. Execute the workflow (see Usig Maiframe Applicatios with Workflows). BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 1-7
1 Workflow Processig with BEA WebLogic Java Adapter for Maiframe 1-8 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
CHAPTER 2 Istallig the WebLogic JAM Plug-I This sectio provides iformatio o the followig subjects: Preparig to Istall WebLogic JAM Plug-i l Verify Software Requiremets l Dowload WebLogic JAM Plug-i from the Web l Determie the Istallatio Method Istallig the WebLogic JAM Plug-i l Usig Graphics Mode Istallatio l Usig Cosole Mode Istallatio Verifyig Your Istallatio Uistallig BEA WebLogic Java Adapter for Maiframe Plug-i BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 2-1
2 Istallig the WebLogic JAM Plug-I Preparig to Istall WebLogic JAM Plug-i Before istallig the WebLogic JAM Plug-i, you must: Verify Software Requiremets Dowload WebLogic JAM Plug-i from the Web Determie the Istallatio Method Verify Software Requiremets The WebLogic JAM Plug-i is depedet o the followig software. Verify the istallatio ad cofiguratio of: WebLogic JAM WebLogic Itegratio Verify that these software products have bee properly cofigured by referrig to the appropriate product documetatio. Determie the Appropriate Platform The WebLogic JAM Plug-i may be istalled o a variety of platforms. Refer to the BEA WebLogic Java Adapter for Maiframe Release Notes for a complete list of supported platforms. You must decide the platform o which platform you will istall the WebLogic JAM Plug-i before proceedig. Dowload WebLogic JAM Plug-i from the Web A evaluatio copy of WebLogic JAM Plug-i is available for dowload from the BEA corporate Web site at: 2-2 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Istallig the WebLogic JAM Plug-i http://commerce.bea.com/dowloads/weblogic_server.jsp#jam. Because the WebLogic JAM Plug-i shares the WebLogic JAM licese, its licese will be updated whe you update the WebLogic JAM licese. Determie the Istallatio Method The WebLogic JAM Plug-i ca be istalled i the followig ways: I Graphics Mode o Widows or Uix Graphics mode istallatio is the graphics-based method of executig the BEA Istallatio program. It ca be ru o both Widows ad Uix systems. Note: To ru Graphics mode istallatio, the cosole attached to the machie o which you are istallig the software must support a Java-based GUI. I Cosole Mode o Uix Cosole-mode istallatio is the text-based method of executig the BEA Istallatio program It ca be ru oly o Uix systems ad is iteded for Uix systems with o-graphic cosoles. Istallig the WebLogic JAM Plug-i After performig the tasks described i Preparig to Istall WebLogic JAM Plug-i, you ca begi the istallatio procedure. There are two ways to istall the WebLogic JAM Plug-i: Usig Graphics Mode Istallatio Usig Cosole Mode Istallatio Usig Graphics Mode Istallatio To istall the WebLogic JAM software i graphics mode, perform the followig steps: BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 2-3
2 Istallig the WebLogic JAM Plug-I 1. For Widows platforms, ope the jampi_wi.exe file you dowloaded (see Dowload WebLogic JAM Plug-i from the Web). For Uix platforms, do the followig: a. Defie the DISPLAY eviromet variable as follows: /mt> export DISPLAY=xx.xx.xx.xx:0.0 (xx.xx.xx.xx is the IP address of the machie from which you are istallig) b. Execute the istallatio program. /mt> sh jampi_uix.bi 2. The IstallAywhere scree displays, preparig to istall. 3. The BEA WebLogic Java Adapter for Maiframe splash scree displays. 2-4 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Istallig the WebLogic JAM Plug-i 4. The, the Itroductio scree displays. 5. Click Next to cotiue the istallatio process. The Choose BEA Home Directory displays. 6. Select a BEA Home optio, the click Next. l If you select the default settig, Use Existig BEA Home, the default locatio is the BEA Home directory where other BEA WebLogic software is located. BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 2-5
2 Istallig the WebLogic JAM Plug-I l If you select Create New BEA Home, you ca eter the locatio for the ew directory or click Browse to select a ew locatio. 7. If a previous istallatio of the WebLogic JAM Plug-i is detected, the followig message displays: l l l Click Cotiue to istall over the previous versio. Click Exit to exit the istallatio process. Click Previous to retur to the previous scree to chage the locatio of the directory. 8. If WebLogic JAM is ot istalled, the followig warig displays: l l Click Exit to exit the istallatio process. Click Previous to retur to the previous scree to chage the locatio of the directory. 9. If WebLogic Server 6.1, Service Pack 2 is ot istalled, the followig warig displays: l Click Exit to exit the istallatio process. You ca restart the istallatio process after you istall WebLogic Server. 2-6 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Istallig the WebLogic JAM Plug-i 10. If WebLogic Itegratio is ot istalled, the followig warig displays: l Note: Click Exit to exit the istallatio process. You ca restart the istallatio process after you istall WebLogic Itegratio. You ca have several BEA Home directories, but products that are depedet o each other must be istalled i the same BEA Home directory. For example, WebLogic Server ad WebLogic JAM must be i the same BEA Home directory. 11. Whe you have selected the appropriate BEA Home directory, the Cofigurig scree displays. 12. Click Next to begi the istallatio process. A scree showig the status of the istallatio process displays. BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 2-7
2 Istallig the WebLogic JAM Plug-I 13. Whe the istallatio process is complete, the Istall Complete scree displays. 14. Click Doe to exit the istallatio program. The Widows istallatio process updates the Widows program group amed BEA WebLogic E-Busiess Platform with the WebLogic JAM Plug-i program item. 2-8 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Istallig the WebLogic JAM Plug-i Usig Cosole Mode Istallatio To istall the WebLogic JAM Plug-i o Uix systems usig the cosole-mode istallatio, ru the BEA stadard istallatio shell script as follows: jampi_uix.bi Perform the followig steps: 1. Set the JAVA_HOME ad PATH eviromet variables as follows: /mt> export JAVA_HOME=<BEA_HOME>/<JDK_DIR> /mt> export PATH=<BEA_HOME>/<JDK_DIR>/bi:$PATH Example: If your BEA Home directory is /usr/bea, the these eviromet variables should be set as follows: /mt> export JAVA_HOME=/usr/bea/jdk131 /mt> export PATH=/usr/bea/jdk131/bi:$PATH 2. Execute the istallatio program you dowloaded (see Dowload WebLogic JAM Plug-i from the Web). For example: mt> sh jampi_uix.bi -i cosole 3. The istallatio program rus ad prompts you for resposes. Listig 2-1 shows a sample of the cosole mode istallatio script. User iput is show i bold. Listig 2-1 Cosole Mode Istallatio Script Preparig to istall... Preparig CONSOLE Mode Istallatio... ================================================================= BEA WebLogic JAM Plug-i (created with IstallAywhere by Zero G) ----------------------------------------------------------------- ================================================================= Itroductio ------------- This istaller will guide you through the istallatio of BEA WebLogic JAM Plug-i. O each step, aswer the questios provided. Type "quit" at ay time to exit the istaller. BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 2-9
2 Istallig the WebLogic JAM Plug-I PRESS <ENTER> TO CONTINUE: ================================================================= Choose BEA Home Directory ------------------------- 1- Create a New BEA Home 2- Use Existig BEA Home Eter a umber: 2 1- /bea 2- /tmp/istall.dir.15582 Existig BEA Home: 1 Istallig... ------------- [--------------- --------------- --------------- ---------------] ================================================================= Istall Complete ---------------- Cogratulatios. BEA WebLogic JAM Plug-i has bee successfully istalled to: /bea/wlitegratio2.1 PRESS <ENTER> TO EXIT THE INSTALLER: Istallig Over a Previous Versio If you are istallig over a previous versio of the WebLogic JAM Plug-i, you will see the followig sectio of the istallatio script: >>>> THIS PART ONLY APPEARS WITH A PREVIOUS INSTALL <<< ------------------------------------------------------------ A previous istallatio of BEA WebLogic JAM Plug-i 5.0 has bee detected at /bea/wlitegratio2.1. The followig optios are available: 1- Cotiue to istall over /bea/wlitegratio2.1 2-10 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Istallig the WebLogic JAM Plug-i 2- Cacel to select aother BEA Home Directory 3- Exit the istallatio Choose a umber: 1 >>>> THIS PART ONLY APPEARS WITH A PREVIOUS INSTALL <<< ================================================================= Istallig Without WebLogic JAM If you attempt to istall the WebLogic JAM Plug-i without a valid istallatio of WebLogic JAM, you will see the followig sectio of the istallatio script: ================================================================= WebLogic JAM Plug-i requires a valid istallatio of the WebLogic JAM 5.0. Check your BEA Home directory to esure that product is istalled. Hit <ENTER> to quit a istallatio.: [machie_ame]:/home/tmp... Istallig Without WebLogic Server If you attempt to istall the WebLogic JAM Plug-i without a valid istallatio of WebLogic Server 6.1, SP2, you will see the followig sectio of the istallatio script: ================================================================= WebLogic Server 6.1 SP2 NOT FOUND! ---------------------------------- WebLogic Server 6.1 SP2 is ot istalled. It should be istalled ito the same BEA Home as WebLogic JAM 5.0. Hit <ENTER> to quit a istallatio.: [machie_ame]:/home/tmp... Istallig Without WebLogic Itegratio If you attempt to istall the WebLogic JAM Plug-i without a valid istallatio of WebLogic Itegratio 2.1, you will see the followig sectio of the istallatio script: BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 2-11
2 Istallig the WebLogic JAM Plug-I ================================================================= WebLogic Itegratio 2.1 NOT FOUND! ----------------------------------- WebLogic Itegratio 2.1 is ot istalled. It should be istalled ito the same BEA Home as WebLogic JAM 5.0. Hit <ENTER> to quit a istallatio.: [machie_ame]:/home/tmp [=============== =============== =============== ===============] Verifyig Your Istallatio You ca verify the istallatio of the WebLogic JAM Plug-i by verifyig the istallatio of the followig directories ad files for the supported platforms. The followig platforms are supported for the WebLogic JAM Plug-i. AIX 4.3.3 HP-UX 11.0 Microsoft Widows NT 4.0, Widows 2000, or Widows 2000 Advaced Server Solaris 7 Solaris 8 SuSE LINUX for OS/390 Directory <BEA_HOME>/ wlitegratio2.1/ lib Files jampi.jar jampi.war 2-12 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Uistallig BEA WebLogic Java Adapter for Maiframe Plug-i Uistallig BEA WebLogic Java Adapter for Maiframe Plug-i The WebLogic JAM Plug-i may be removed or uistalled i the followig ways: For Widows: Graphical mode For Uix: Either graphical or cosole mode. Note: You must use the same method to uistall the product that you used to istall it Uistallig i Graphics Mode To uistall WebLogic JAM Plug-i i graphics mode, perform the followig steps: 1. O Widows platforms, choose Start >Programs >BEA WebLogic E-Busiess Platform >BEA WebLogic JAM Plug-i 5.0 >Uistall WebLogic JAM Plug-i. O Uix platforms, do the followig: a. Chage directories to your uistaller directory i the WebLogic Itegratio root directory with the followig commad. The default is <BEA_HOME>/jampi/uistaller. >cd <BEA_HOME>/wlitegratio2.1/uistaller_JAMPI b. Start the uistallatio program with the followig commad: /usr/bea/wlitegratio2.1/uistaller_jampi> sh Uistall The followig scree displays. BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 2-13
2 Istallig the WebLogic JAM Plug-I 2. Click Uistall to begi the uistall process. The followig scree displays. 2-14 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Uistallig BEA WebLogic Java Adapter for Maiframe Plug-i 3. Whe the uistall process is complete, the followig scree displays. 4. Click Exit to close the uistallatio program Uistallig i Cosole Mode To uistall WebLogic JAM Plug-i i cosole mode, perform the followig steps: 1. Chage directories to the uistaller directory uder the root directory with the followig commad. The default is /usr/bea/jampi/uistaller. > cd <BEA_HOME>/wlitegratio2.1/uistaller_JAMPI 2. Start the uistallatio program with the followig commad: <BEA_HOME>/wlitegratio2.1/uistaller_JAMPI> sh Uistall -i cosole 3. At the prompt, press ENTER to begi the uistall. If you wat to exit the uistall program, type QUIT at the prompt. Note: The sigle-dash bar just beeath the double-dash bar i Listig 2-1 is a progress idicator. Whe the sigle-dash bar becomes the same legth as the double-dash bar, uistallatio is complete. 4. Whe the uistall is complete, press ENTER to exit the program. BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 2-15
2 Istallig the WebLogic JAM Plug-I 2-16 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
CHAPTER 3 Usig Maiframe Applicatios with Workflows This sectio provides iformatio o the followig subjects: Before You Begi Usig WebLogic JAM with Workflow Processig Before You Begi To be able to use maiframe applicatios with workflows, be sure that you have: Istalled ad cofigured WebLogic Server. Istalled ad cofigured WebLogic Itegratio. Istalled ad cofigured WebLogic JAM ad the WebLogic JAM Plug-i. Reviewed ad uderstad the steps for creatig ad editig workflows i WebLogic Itegratio. BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 3-1
3 Usig Maiframe Applicatios with Workflows Usig WebLogic JAM with Workflow Processig The WebLogic JAM Plug-i is a compoet that allows BEA WebLogic Itegratio to iteract with maiframe applicatios usig the WebLogic JAM Gateway. It rus with WebLogic Itegratio i the WebLogic Server eviromet. Use the followig steps for workflow processig with WebLogic JAM: Step 1: Set Up the WebLogic JAM Plug-i Compoets Step 2: Set Up Data Traslatio Step 3: Set Up the Workflow to Iteract With the Maiframe Step 1: Set Up the WebLogic JAM Plug-i Compoets To use WebLogic JAM to access maiframe applicatios durig workflow processig, you must set up the WebLogic JAM Plug-i compoets by completig the followig tasks. 1. Add the etries show below to the WLI applicatio defiitio i the WebLogic Server cofiguratio file (cofig.xml). See Listig 3-1 for a example of the WLI applicatio defiitio sectio. <EJBCompoet Name="jampi.jar" Targets="myserver" URI="jampi.jar"DeploymetOrder="21"/> <WebAppCompoet Name="com.bea.jam.JamPlugi" Targets="myserver" URI="jampi.war"DeploymetOrder="22"/> The WebLogic Server cofiguratio file (cofig.xml) is located at: <BEA_HOME>/<WLI_HOME>/cofig/<domai.ame> Where <WLI_HOME> is where WebLogic Itegratio is istalled (usually wlitegratio2.1) ad domai.ame is the domai from which WebLogic Itegratio is started. For example: C:/BEA/wlitegratio2.1/cofig/bpmdomai 3-2 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Usig WebLogic JAM with Workflow Processig Warig: Copy the cofig.xml file ad store it i a alterate locatio as a backup i case the cofig.xml file you are workig with is corrupted durig setup. 2. Review your server cofiguratio i the cofig.xml file. If the server ame is ot myserver, the Targets etry eeds to be modified with the ame of your server. Note: The cofig.xml file ca cotrol the order i which the.jar files are deployed. The EJBCompoet ad WebAppCompoet fields iclude a DeploymetOrder attribute, which idicates the order i which a.jar file is deployed with respect to the other.jar files. The WebLogic JAM Plug-i compoets should have the highest DeploymetOrder values so that they will be deployed last. Listig 3-1 shows a example of the WebLogic Itegratio sectio of the WebLogic Server cofiguratio file (cofig.xml). Listig 3-1 Example WebLogic Itegratio Cofiguratio Sectio of the WebLogic Server cofig.xml <Applicatio Name="WLI" Path="c:\bea\wlitegratio2.1\lib"> <EJBCompoet Name="repository-ejb.jar" Targets="myserver" URI="repository-ejb.jar" DeploymetOrder="0"/> <EJBCompoet Name="wlpi-ejb.jar" Targets="myserver" URI="wlpi-ejb.jar" DeploymetOrder="1"/> <EJBCompoet Name="wlpi-master-ejb.jar" Targets="myserver" URI="wlpi-master-ejb.jar" DeploymetOrder="2"/> <EJBCompoet Name="wlpi-mdb-ejb.jar" Targets="myserver" URI="wlpi-mbd-ejb.jar" DeploymetOrder="3"/> <EJBCompoet Name="pobea.jar" Targets+"myserver" URI="pobea.jar DeploymetOrder="4"/> <EJBCompoet Name="jampi.jar: Targets="myserver" URI="jampi.jar" DeploumetOrder="5"/> <WebAppCompoet Name="com.bea.jam.JamPlugi" Targets="myserver" URI="jampi.war" DeploymetOrder="6"/> </Applicatio> BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 3-3
3 Usig Maiframe Applicatios with Workflows Step 2: Set Up Data Traslatio To esure that workflows operate properly, you must set up your system to eable the differet software applicatios to iteract. I order for WebLogic Itegratio to covert XML data to the biary format expected by your maiframe program, a descriptio of the biary format must be created ad stored i your WebLogic Itegratio repository. The data itegratio desig-time compoet of WebLogic Itegratio (Format Builder) ca be used to create this descriptio. Format Builder imports the COBOL copybook for your maiframe applicatio, ad automatically creates a descriptio that details the layout of the COBOL copybook. Usig this descriptio, WebLogic Itegratio coverts istaces of this layout to ad from XML. To set up your system for the required data traslatio, complete the followig steps: 1. Obtai the COBOL copybook(s) or C header file(s) used by your maiframe applicatio. For more iformatio about obtaiig the COBOL copybook, refer to the BEA WebLogic Java Adapter for Maiframe Programmig Guide. 2. Import the copybooks(s) or C header file(s) ito the WebLogic Itegratio repository usig the followig steps: a. Choose Start Programs BEA WebLogic E-Busiess Platform WebLogic Itegratio 2.1 Format Builder to lauch the WebLogic Itegratio Format Builder. b. Choose Repository Logi. The WebLogic Itegratio Repository Logi dialog box displays (see Figure 3-1). 3-4 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Usig WebLogic JAM with Workflow Processig Figure 3-1 WebLogic Itegratio Repository Logi c. Eter your user ame ad password. If your server is differet tha the default, eter your server address. d. Choose Tools Import COBOL Copybook Importer (if you are workig with a copybook) or C Struct Importer (if you are workig with a C Struct). The appropriate dialog box displays (Figure 3-2 shows the COBOL Copybook Importer dialog box. Figure 3-3 shows the C Struct Importer dialog box.) Figure 3-2 WebLogic Itegratio COBOL Copybook Importer Dialog Box BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 3-5
3 Usig Maiframe Applicatios with Workflows Figure 3-3 WebLogic Itegratio C Struct Importer Dialog Box. e. Fill i the fields i the dialog box as appropriate for your eviromet. f. After your file has bee imported, choose Repository Store As. The Store Documet dialog box displays (see Figure 3-4). 3-6 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Usig WebLogic JAM with Workflow Processig Figure 3-4 WebLogic Itegratio Store Documet Dialog Box g. Eter your ame for this documet i the Name field. This ame is the SCHEMA ame you will use to modify the Gateway cofiguratio file. Eter appropriate iformatio i the Descriptio ad Notes fields, as eeded. h. Click Store to save the documet i the WebLogic Itegratio Repository. i. Choose Tools Test. The Format Tester opes ( see Figure 3-5). BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 3-7
3 Usig Maiframe Applicatios with Workflows Figure 3-5 Format Tester j. Choose Geerate XML to display a sample of the XML you will use durig the creatio of your workflow. Step 3: Set Up the Workflow to Iteract With the Maiframe Determie how your workflow will use maiframe services. You have the followig choices: Request maiframe services from WebLogic Itegratio. Iitiate WebLogic Itegratio workflows from the maiframe. 3-8 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Requestig Maiframe Services from a Workflow Requestig Maiframe Services from a Workflow To request maiframe services from a workflow i WebLogic Itegratio, you must: Cofigure maiframe services usig the Admiistratio Cosole (see Cofigurig Maiframe Services). Add appropriate maiframe actios to tasks cotaied i the WebLogic Itegratio workflow template defiitio (see Usig Maiframe Actios i Workflows). Cofigurig Maiframe Services To access maiframe applicatios from a WebLogic Itegratio workflow, remote services must be specified. Remote services are cofigured usig the WebLogic Admiistratio Cosole. BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 3-9
3 Usig Maiframe Applicatios with Workflows Figure 3-6 Cofigurig Remote Services The Iput Schema ad Output Schema fields should specify data traslatio schemas used by the service i the followig way: Iput Schema specifies the traslatio schema for the request set to the maiframe. Output Schema specifies the traslatio schema for the respose received from the maiframe. For specific iformatio about cofigurig the WebLogic JAM Gateway, refer to the BEA WebLogic Java Adapter for Maiframe Cofiguratio ad Admiistratio Guide. Usig Maiframe Actios i Workflows You ca desig ad edit Maiframe Actios used by WebLogic Itegratio workflows i the followig ways: Addig Maiframe Actios Updatig Maiframe Actios 3-10 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Requestig Maiframe Services from a Workflow Deletig a Maiframe Actio Chagig the Sequece of Maiframe Actios Addig Maiframe Actios Maiframe actios ca be added durig desig time from the WebLogic Itegratio Studio. The followig steps allow you to add a maiframe actio: 1. Ope a existig or ew workflow template defiitio to which you wat to add a maiframe actio. 2. From the workflow template defiitio, double-click the Task ode to which you wat to add a maiframe actio. The Task Properties dialog box displays as show i Figure 3-7. Figure 3-7 Task Properties 3. I the Task Properties dialog box show i Figure 3-7, select the appropriate Actios tab to desigate whe the maiframe actio will be executed. Determie whe the actio is executed by selectig the appropriate tab defied i Table 3-1. Table 3-1 Busiess Process Maagemet Actio Defiitios Tab Created Descriptio The workflow is started ad all tasks i the workflow are created. BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 3-11
3 Usig Maiframe Applicatios with Workflows Table 3-1 Busiess Process Maagemet Actio Defiitios Tab Activated Executed MarkedDoe Descriptio The workflow diagram idicates a task trasitio has occurred, usually as a result of aother task beig marked as doe or a decisio beig evaluated. The task is available to be performed. A evet has occurred that causes this task to be executed. This usually occurs whe a user selects a task i the worklist ad executes it, ofte by double-clickig the task, or whe a Execute Task actio is performed for that task. The task has bee completed. This evet usually occurs i respose to the executio of a Mark Task as Doe actio. See Usig the Studio i the WebLogic Itegratio 2.1 documetatio for more iformatio about the executio of workflows. 4. Click Add to display the Add Actio dialog box show i Figure 3-8. Figure 3-8 Addig Maiframe Actios 5. Double-click the Maiframe Actios folder to expad it. Select Sed a maiframe request, ad click OK to display the Maiframe Actio dialog box. 3-12 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Requestig Maiframe Services from a Workflow 6. Eter data i the fields as show i Figure 3-9. A descriptio of the iput fields for this dialog box is show i Table 3-2. Figure 3-9 Maiframe Actios Dialog Box Table 3-2 lists the fields used for addig ad updatig maiframe actios whe usig WebLogic JAM with a WebLogic Itegratio workflow. Table 3-2 Maiframe Actio Defiitios Field Descriptio Maiframe Actio Defiitio Service Name Select the ame of a remote service from the drop-dow list or eter the ame of a ew service. This drop-dow list displays all the remote services defied i the WebLogic JAM cofiguratio. If you eter the ame of a ew service, you must be sure to add the service to the WebLogic JAM cofiguratio before you ca ru the workflow. BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 3-13
3 Usig Maiframe Applicatios with Workflows Field Iput Schema Output Schema Iput Variable Output Variable Notes Descriptio Displays the iput schema ame that correspods to the Service Name you selected. The schema specified by this field must be created usig Format Builder prior to executig this workflow. You may also maually eter a ew schema ame, but you must defie the schema with Format Builder before you ca ru the workflow. Schemas must be i the repository. Displays the output schema ame that correspods to the Service Name you selected. The schema specified by this field must be created usig Format Builder prior to executig this workflow. You may also maually eter a ew schema ame, but you must defie the schema with Format Builder before you ca ru the workflow. Schemas must be i the repository. Select a iput variable from the drop-dow list or maually eter a ew variable. This variable cotais the XML documet that is coverted to biary format usig the Iput Schema ad the set to WebLogic JAM. The variable must be of type "Strig" or "XML." If you eter a variable ame that does ot curretly exist, you will be asked if you wat to create it. Select a output variable from the drop-dow list or maually eter a ew variable. This variable is the destiatio for respose data from the maiframe that has bee received by the WebLogic JAM Gateway ad traslated ito XML usig the output schema. The variable must be of type "Strig" or "XML." If you eter a variable ame that does ot curretly exist, you will be asked if you wat to create it. Eter your ow custom otes about the maiframe actio. Maiframe Actio Buttos OK Cacel Saves your maiframe actio defiitio iformatio ad closes the Maiframe Actio dialog. If ay fields are blak, a error message displays ad you will be retured to the Maiframe Actio dialog. If either variable ame specifies a variable that does ot exist, a message displays allowig you to add the variable. Closes the Maiframe Actio dialog without savig ay maiframe actio defiitio iformatio that you etered. 3-14 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Requestig Maiframe Services from a Workflow 7. Click OK. The actio is added to the Task Properties dialog box ad will be implemeted whe the workflow is executed. Updatig Maiframe Actios Maiframe actios ca be updated durig desig time or rutime from the WebLogic Itegratio Studio. The followig steps allow you to update a maiframe actio: 1. Ope a existig workflow template defiitio that you wat to update. 2. From the workflow template defiitio, double-click the Task ode you wat to update. The Task Properties dialog box displays. 3. I the Task Properties dialog box show i Figure 3-7, select the Actios tab that cotais the maiframe actio to be executed. The Actios are defied i Table 3-1. 4. Select the Maiframe Actio to be updated from the Actios tab. 5. Click Update to display the Update Actio dialog box. 6. Modify the fields i the dialog box as eeded. Refer to Table 3-1 for the defiitios of the Maiframe Actio Fields. 7. Click OK to save the chages. Deletig a Maiframe Actio To delete a maiframe actio: 1. Ope the existig WebLogic Itegratio workflow template defiitio. 2. From the workflow diagram, double-click the Task ode for which you wat to delete a maiframe actio. The Task Properties dialog box displays. 3. I the Task Properties dialog box show i Figure 3-7, select the Actios tab that cotais the maiframe actio to be executed. The Actios are defied i Table 3-1. 4. Select the desired actio i the Actios sectio of the Task Properties dialog box, ad click the Delete butto. 5. A cofirmatio dialog box displays to prevet accidetal deletios. Click Yes to cofirm the deletio or No to cacel the deletio. BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 3-15
3 Usig Maiframe Applicatios with Workflows Whe a actio is deleted, all refereces to the actio are removed. The actio is removed from all istaces of the workflow, icludig those curretly ruig. Chagig the Sequece of Maiframe Actios The sequece of maiframe actios ca be chaged durig desig time or ru time. To chage the sequece of actios: 1. From your workflow diagram, double-click the Task ode for which you wat to chage the sequece of a maiframe actio. The Task Properties dialog box displays. 2. I the Task Properties dialog box show i Figure 3-7, select the Actios tab that cotais the maiframe actio to be executed. The Actios are defied i Table 3-1. 3. Press the up or dow arrow butto to move the actio s positio up or dow i the list. 4. Click o OK to save the chage to the workflow template defiitio. Iitiatig Workflows from the Maiframe By workig with WebLogic JAM ad WebLogic Itegratio, workflows ca be iitiated from maiframe applicatios. To iitiate workflows from the maiframe, you must: Modify the WebLogic JAM Cofiguratio Edit the Workflow Start Node Example of Iitiatig a Workflow from the Maiframe I the followig example, a ew employee record is created o the maiframe. It is set to the workflow process to be added the employee database. 3-16 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
... Iitiatig Workflows from the Maiframe The scree data is validated ad moved ito the employee record copybook. This copybook correspods to the copybook used to geerate the MFL i Step 2 of the Usig WebLogic JAM with Workflow Processig sectio. The COBOL CICS program i Listig 3-2 illustrates how a workflow may be iitiated. The CICS lik seds the employee record to the workflow. The SYSID directs the LINK to the correct remote eviromet, ad the PROGRAM ame correspods to the service ame of a WebLogic Itegratio evet etry i the WebLogic JAM cofiguratio. Listig 3-2 Example of Iitiatig a Workflow From the Maiframe DATA DIVISION. WORKING-STORAGE SECTION. 01 WS-VARIABLES. COPY EMPREC. 01 WS-CONSTANTS. 05 EMP-REQUEST PIC X(8) VALUE DPL1SVR. 05 REMOTE-SYSID PIC X(4) VALUE BEA1.... PROCEDURE DIVISION. MAINLINE SECTION. PERFORM VALIDATE-SCREEN-RECORD MOVE SCREEN-SSN TO EMP-SSN MOVE SCREEN-LAST-NAME TO EMP-NAME-LAST MOVE SCREEN-FIRST-NAME TO EMP-NAME-FIRST MOVE SCREEN-MIDDLE-INIT TO EMP-NAME-MI MOVE SCREEN-STREET TO EMP-ADDR-STREET MOVE SCREEN-STATE TO EMP-ADDR-STATE MOVE SCREEN-ZIP TO EMP-ADDR-ZIP EXEC CICS LINK PROGRAM(EMP-REQUEST) SYSID(REMOTE-SYSID) COMMAREA(EMP-RECORD) LENGTH(LENGTH OF EMP-RECORD) RESP(RESP-CODE) END-EXEC PERFORM CHECK-RESPONSE PERFORM RETURN-TO-CICS MAINLINE-EXIT. EXIT. BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 3-17
3 Usig Maiframe Applicatios with Workflows Modify the WebLogic JAM Cofiguratio The WebLogic JAM cofiguratio file must have a WebLogic Itegratio evet for each service to be requested by the maiframe program. This defiitio must specify a schema that was created whe you set up data traslatio. Figure 3-10 Evet Cosole For specific iformatio about cofigurig the WebLogic JAM Gateway, refer to the BEA WebLogic Java Adapter for Maiframe Cofiguratio ad Admiistratio Guide. 3-18 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Iitiatig Workflows from the Maiframe Edit the Workflow Start Node For a maiframe evet or actio to iitiate a workflow, it must be icluded i the Start Node of a WebLogic Itegratio workflow. To edit the workflow Start Node to iitiate the workflow, complete the followig steps. 1. Double click o the Start Node you wat to edit. 2. I the Start Properties dialog box, show i Figure 3-11, select Evet as the start method for the workflow. Figure 3-11 Start Node 3. I the Documet/Type field, eter the root elemet ame of the XML documet. To obtai this ame, view the XML documet structure i the WebLogic Itegratio Format Builder. BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 3-19
3 Usig Maiframe Applicatios with Workflows 4. To defie the variable, select the variable tab ad click Add. 5. I the Workflow Variable Assigmet dialog box, show i Figure 3-12, eter the ame you wat to assig to the variable. You may wat to use a XPath fuctio to select fields from the XML. For more iformatio about XPath fuctios, refer to Usig the Studio i the WebLogic Itegratio 2.1 documetatio. Figure 3-12 Workflow Variable Assigmet Dialog Box The workflow will be started automatically whe data is received from the maiframe. 3-20 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
CHAPTER 4 Ruig the WebLogic Itegratio Examples The BEA WebLogic Java Adapter for Maiframe (WebLogic JAM) Plug-i software icludes sample workflows desiged to illustrate the way WebLogic JAM works with BEA WebLogic Itegratio. This sectio describes these workflow templates ad gives you step-by-step istructios for ruig the example. This sectio cotais iformatio o the followig subjects: What is Icluded i the Sample Ruig the BEA WebLogic Itegratio/WebLogic JAM Example l Step 1: Set up the Maiframe. l Step 2: Cofigure ad Ru WebLogic Itegratio usig WebLogic Server. l Step 3: Create the Templates ad Import the Template Defiitios. l Step 4: Ope ad Activate the Template. l Step 5: Execute the Workflow. What is Icluded i the Sample Table 4-1 describes the files used i the examples. These example workflow templates iitiate maiframe requests to read ad write from a maiframe database. The examples are located i the followig directory: <BEA_HOME>/<JAM_INSTALL_DIR>/samples/examples/wlitegratio BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 4-1
4 Ruig the WebLogic Itegratio Examples Table 4-1 List of WebLogic Itegratio/WebLogic JAM Sample Files Directory File Descriptio wlitegratio create.xml Workflow that creates a employee record. wlitegratio read.xml Workflow that reads a employee record. wlitegratio readstrig.xml Workflow that reads as employee record usig strig data type. wlitegratio emprec.cpy Copybook for the employee record. These examples use maiframe compoets from the Employee Record CICS outboud sample. Maiframe compoets for the Employee Record sample are located i the followig directory: <BEA_HOME>/>JAM_INSTALL_DIR>/samples/examples/CICS/outboud/ maiframe/source A sample WebLogic JAM cofiguratio file ca be foud i the followig directory: <BEA_HOME>/>JAM_INSTALL_DIR>/cofig/examples/jamcofig_CICS.xml For iformatio o settig up the Employee Record sample, refer to the BEA WebLogic Java Adapter for Maiframe Samples Guide. Ruig the BEA WebLogic Itegratio/WebLogic JAM Example This example simulates storage ad retrieval of employee records i a maiframe database iitiated by workflow processig. The data is etered from a worklist form ad traslated to XML. The data is the traslated to COBOL copybook format ad stored i the data base. The employee record ca the be retrieved from the database ito the workflow. 4-2 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Ruig the BEA WebLogic Itegratio/WebLogic JAM Example Follow the steps below to ru the BEA WebLogic Itegratio/JAM example. For specific istructios o performig the tasks i WebLogic Itegratio ad WebLogic Server, please refer to the documetatio that accompaies those applicatios. Step 1: Set up the Maiframe Set up the maiframe programs dpldemor.cbl, dpldemou.cbl, ad dpldemod.cbl. Refer to the BEA WebLogic Java Adapter for Maiframe Samples Guide for more iformatio. Step 2: Cofigure ad Ru WebLogic Itegratio usig WebLogic Server 1. Move the jamcofig_cics.xml file from the cofig/examples directory to: <BEA_HOME>/<WLI_HOME>/cofig/<domai.ame> where <domai.ame> is your WebLogic Itegratio domai. 2. Start the CRM (refer to the BEA WebLogic Java Adapter for Maiframe Cofiguratio ad Admiistratio Guide). 3. Start the WebLogic Itegratio Server. 4. Usig the WebLogic Admiistratio Cosole, update the WebLogic JAM cofiguratio to commuicate with the CRM (refer to the BEA WebLogic Java Adapter for Maiframe Cofiguratio ad Admiistratio Guide). 5. Import the emprec.cpy copybook usig WebLogic Itegratio ad store it i the repository as described i Usig Maiframe Applicatios with Workflows. Step 3: Create the Templates ad Import the Template Defiitios This example provides three workflow templates for you to work with. The templates are listed ad described i Table 4-2. BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 4-3
4 Ruig the WebLogic Itegratio Examples Table 4-2 Provided Workflow Templates Workflow Template File Name Descriptio JAM create create.xml Creates a employee record JAM read read.xml Reads a employee record JAM readstrig readstrig.xml Reads ad employee record usig strig data type To create the template ad import the template defiitio for JAM create: 1. Create a ew template called JAM create. 2. Select the template from the tree view i the left pae ad click the right mouse butto. 3. Choose Import Template Defiitio. 4. Select the correspodig defiitio file: create.xml. 5. Click OK to close the message box. 6. Repeat steps 1 through 5 for: l l JAM read from the defiitio file read.xml JAM readstrig from the defiitio file readstrig.xml Step 4: Ope ad Activate the Template To eable each workflow template, ope ad activate the template usig the followig steps: 1. Select the JAM create template defiitio imported i the previous step from the tree view ad click the right mouse butto. 4-4 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Ruig the BEA WebLogic Itegratio/WebLogic JAM Example 2. Choose Ope. The workflow created for this sample applicatio displays, as show i Figure 4-1. Figure 4-1 Workflow for JAM create 3. Select the JAM create template defiitio agai from the tree view ad click the right mouse butto. BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 4-5
4 Ruig the WebLogic Itegratio Examples 4. Choose Properties. The Template Defiitio properties dialog box displays, as show i Figure 4-2. Figure 4-2 Template Defiitio create 5. Click Active to activate the template ad click OK. 6. Select the JAM create template defiitio a third time from the tree view ad click the right mouse butto agai. 7. Choose Save to save the template defiitio with the chages you made. 8. Repeat Steps 1 through 7 for JAM read ad JAM readstrig. 4-6 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Ruig the BEA WebLogic Itegratio/WebLogic JAM Example Step 5: Execute the Workflow This sectio provides step-by-step istructios for executig workflows to create a employee record ad to read a employee record. Execute the JAM create Workflow The JAM create workflow creates a employee record. To start the workflow from the WebLogic Itegratio Worklist, complete the followig steps: 1. Start WebLogic Itegratio Worklist ad choose Workflow Start a Workflow. 2. Select JAM create. The template opes ad the first task is displayed, as show i Figure 4-3. Figure 4-3 JAM create Worklist 3. Select the Eter Customer Ifo task ad click the right mouse butto. BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 4-7
4 Ruig the WebLogic Itegratio Examples 4. Select Execute. The Eter Customer Ifo dialog displays, as show i Figure 4-4. Figure 4-4 Data Etry Form 5. Eter the employee iformatio ad click OK. The task is started ad the workflow rus. 4-8 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Ruig the BEA WebLogic Itegratio/WebLogic JAM Example 6. A ew task, Notify Creator will appear o the worklist, as show i Figure 4-5. Select the Notify Creator task. Figure 4-5 Notify Creator Task 7. Select Execute. Whe the Iformatio dialog appears, as show i Figure 4-6, click OK to close the dialog box. The workflow is ow complete. Figure 4-6 Iformatio Dialog widow Execute the JAM read ad JAM readstrig Workflow The JAM read ad JAM readstrig workflows read ad display a employee record for the maiframe database. The JAM readstrig workflow is fuctioally the same as the JAM read workflow. The differece is that the JAM readstrig workflow uses Strig variables iterally to cotai the XML used for data traslatio. BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 4-9
4 Ruig the WebLogic Itegratio Examples To execute these workflows from the WebLogic Itegratio Worklist, complete the followig steps: 1. Start WebLogic Itegratio Worklist ad choose Workflow Start a Workflow. 2. Select JAM read or JAM readstrig. The template opes, as show i Figure 4-7 ad the first task is displayed. Figure 4-7 JAM read or JAM readstrig Workflow 4-10 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide
Ruig the BEA WebLogic Itegratio/WebLogic JAM Example 3. Select the Eter Query task, as show i Figure 4-8, ad click the right mouse butto. Figure 4-8 JAM read or JAM readstrig Worklist 4. Select Execute. The Data etry form dialog box displays, as show i Figure 4-9. Figure 4-9 Data etry form 5. Eter the last ame of the employee to be read. For example, the last ame etered whe you created a employee record was Smith. Click OK. 6. A ew task, Display Customer Iformatio, will appear o the worklist. Select the Display Customer Iformatio task, as show i Figure 4-10. BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide 4-11
4 Ruig the WebLogic Itegratio Examples Figure 4-10 Display Customer Iformatio Task 7. Select Execute. Whe the Iformatio dialog box appears, as show i Figure 4-11, click OK to close the dialog box. The workflow is ow complete. Figure 4-11 Iformatio Dialog widow 4-12 BEA WebLogic Java Adapter for Maiframe Workflow Processig Guide