Manuale d’uso / di manutenzione del prodotto 3 del fabbricante Sun Microsystems
Vai alla pagina of 368
Process System Guide iPlanet™ Integration Serve r V ers ion 3.0 August 2001.
Copyright (c) 2001 Sun Mic rosystems, Inc ., 901 San Anto nio Road, Palo A lto, Californ ia 94303, U.S .A. All rights rese rved. Sun Micros ystems, Inc . has intel lectual property ri ghts relat ing to tec hnology emb odied in the product t hat is des cribed in thi s document.
3 Contents List of Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 List of Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4 iPlanet Integratio n Server • Proces s System Gui de • August 2001 iIS Process Manage ment Tasks (continued) Managin g iIS Proces s Engin es . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5 The iIS Console Ma in Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 Main V iewing Pa nel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6 iPlanet Integratio n Server • Proces s System Guide • August 2001 Reconfigu ring an E ngine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 How to Reconfig ure an Engi ne .
7 Chapter 6 Mana ging Process Ex ecution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 Introduc tion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8 iPlanet Integratio n Server • Proces s System Guide • August 2001 Monitorin g and M anaging Two-P hase C ommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 99 Managin g Two-Phase C ommit Oper ations . . .
9 Managing iIS P rocess Eng ines with Conductor Script (continued) Monito ring Engin es and En gine Co mponents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 39 Monitorin g the Eng ine . . . . . . . . . . . . . .
10 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Conductor Script Commands (continu ed) CreateFilt er . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11 Conductor Script Commands (continued) RemoveWri teLock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 RollbackAct ivity . . . . . . . . . . . . . . . . . . . .
12 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Appendix B Engine Database Sch ema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 Databas e Tables by Category . . . . . . . . . . . . . .
13 List of Figures Figure 1-1 An iIS Process M anage ment Syst em . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 Figure 1-2 Minima l Engine C onfigura tion . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
14 iPlane t Integrati on Server • Process Syst em Guide • August 2001.
15 List of Procedures To copy t he documen tation to a cli ent or server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 To view and sea rch th e document ation . . . . . . . . . . . . . . . . . . . . . . . .
16 iPlane t Integrati on Server • Process Syst em Guide • August 2001 To use t he Dump/Rest ore appli cation to restore databa se table s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 To tran sfer iIS libra ry distri butions to a production environ ment .
List of Procedures 17 To view all eng ine eve nts for an existi ng proces s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219 To view all eng ine eve nts for t he next pro cess inst ance of a specific proc ess definit ion .
18 iPlane t Integrati on Server • Process Syst em Guide • August 2001.
19 Preface The iIS Pro cess Syst em Guide describes how to manage a process syst em, one of the two subsystems that comprise iIS. The guide provides the system management principles and concepts upon which a process system is based, and describes how to perform process system man agement tasks.
Audience for This Guide 20 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Audience for This Guide This book as sumes familiarity with the basic concepts underlying an iIS proces s system.
Text Con ventions Preface 21 Text Convent ions This section pro vides information a bout the conventions used in this document. Chapter 8, “ Using the Conductor Script Uti lity ” Explai ns how t o perfo rm iIS sy stem manage ment tasks using Conductor Script commands.
Other Documen tation Resou rces 22 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Syntax Stat ements Syntax s tatements that de scribe usag e of TOOL meth ods and script comman.
Other Documen tation Resources Preface 23 iPlane t Integr ation Server Documentat ion iIS Adapter Develop ment Guide iIS Backbone In tegration Guide iIS Backbone Sy stem Guide iIS Con ceptua l Overv i.
iIS Exam ple Prog rams 24 iPlane t Integrati on Server • Process Syst em Guide • August 2001 iIS Example Progr ams iIS example programs are shipped with the iIS product and installed in two locations, one for process development (us ing the process engine) and one for applicatio n integration (using the iIS backbon e).
View ing and S earching PD F Files Preface 25 2. Set up a directory structure that keeps th e iisdoc.pdf and the iis directory in the same relativ e location. The directory structure must be preserved to use the Acrobat search feature. ➤ To view and se arch the do cumentation 1.
Viewing and Search ing PDF F iles 26 iPlane t Integrati on Server • Process Syst em Guide • August 2001 5. Click the buttons on the Acrobat Reader toolbar or use shortcut keys to navigate throug h the search results, a s shown in the followi ng table: To return to the iisdoc.
27 Chapter 1 Introduction: iI S Process Management iIS process system ma nagement is largel y devoted to managing iIS process engines and the functions th ey perform. This chapter provides a high level description of what an iIS process eng ine is and what it does.
What Is an iIS Proc ess En gin e? 28 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Once a process definition has bee n registered with the engine, an iIS process client applicatio n (or an applicati on proxy — see Figure 1-1 on page 30 ) can open a se ssion with the engine and create an instance of the process.
What Is a n iIS Process E ngine? Chapt er 1 Introdu ction: iIS Pro cess Ma nagement 29 Multi ple E ngine Syste ms An iIS system does not need to be limited to a single engine. It can have a ny number of engines. For example, one engine migh t be used for testing and another used for production.
What Is an iIS Proc ess En gin e? 30 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Figur e 1-1 An iIS Process Manage ment System Engine Database Central Development Repository.
iIS Proce ss Engine Component s Chapt er 1 Introdu ction: iIS Pro cess Ma nagement 31 iIS Process En gine Compo nent s As mentioned earlier in this chapter, an iIS process engine is the h eart of an iIS system and has been designed to support mis sion-critical produ ction applicatio n systems.
iIS Pro cess Engine C omponents 32 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Figur e 1-2 Minima l Engine Conf iguration Engine Uni t The engine uni t is an application that perf orms all the basic iIS engine f unctions ( see “ What Does an i IS Process Engine Do? ” on page 36 ).
iIS Proce ss Engine Component s Chapt er 1 Introdu ction: iIS Pro cess Ma nagement 33 engine database is not supplied by the iIS product and must be set up independently; however, the engine unit can create all required data base tables at startup time.
iIS Pro cess Engine C omponents 34 iPlane t Integrati on Server • Process Syst em Guide • August 2001 opens a channel to the backup unit, which takes over by recovering all the persis tent state in formati on store d in the e ngine da tabase.
iIS Proce ss Engine Component s Chapt er 1 Introdu ction: iIS Pro cess Ma nagement 35 Full Confi guration: Fai lover and Load Balancing Combi ned To deal with hea vy loads on the engine and overcom e .
What Does an iI S Pr oces s Eng ine D o? 36 iPlane t Integrati on Server • Process Syst em Guide • August 2001 What Do es an iIS Pr ocess En gine Do? As suggested in “ W hat I s an iIS Proc ess E ngine ? ” on page 27 , an iIS pro cess engine performs a number of different functions in support of an iIS system.
iIS Proc ess Manageme nt Tasks Chapt er 1 Introdu ction: iIS Pro cess Ma nagement 37 Figur e 1-5 Engine Ma nager Ob jects iIS Process Man agement Ta sks iIS process managemen t tasks can be grouped in.
iIS P roce ss Manage men t Tas ks 38 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Settin g Up an iPlan et UD S Runt ime Enviro nment An iIS process management system runs in an iPlanet UDS software environment.
iIS Proc ess Manageme nt Tasks Chapt er 1 Introdu ction: iIS Pro cess Ma nagement 39 Managing iI S Process Engi nes Care must be taken to make sure that each iIS process engine is set up and performing properly.
iIS P roce ss Manage men t Too ls 40 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Managing process execution involves monitoring the activity of the engine and making a dministrati ve adjustme nts when necessa ry.
iIS Process M anageme nt Tools Chapt er 1 Introdu ction: iIS Pro cess Ma nagement 41 Conductor Script Utility The Conductor Script utility is the functional equ ivalent of the iIS Consol e applicatio n, but with a command- line interface.
iIS P roce ss Manage men t Too ls 42 iPlane t Integrati on Server • Process Syst em Guide • August 2001.
43 Chapter 2 Setting Up an iIS Process Management System Setting up an iIS process managemen t system — whether for development, testing, producti on, or a c ombinatio n of the three — is the f irst task you mus t perform as an iIS pr oce ss sy ste m man ager.
Prepar ation: Set ting up an iPlanet U DS Runtime Environmen t 44 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Prepara tion: Settin g up an iPl anet UDS Runtime Environment An iIS process syste m runs in an iPlanet UDS software environment.
iIS Process Syste m Components Chap ter 2 Setting Up an iIS P rocess Manage ment Sys tem 45 The iPlanet U DS installation program creates an iPlan et UDS directory st ructure and source files on your .
iIS Process System Compone nts 46 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Figur e 2-1 Components of an iIS Process Syst em The components of an iIS process system, shown in Figure 2-1 , are implemented through a n umber of software modu les running on vario us nodes in you r computing environment.
iIS Process System Sof tware Chap ter 2 Setting Up an iIS P rocess Manage ment Sys tem 47 To set up an iIS process syste m, install the iIS system soft ware module s that support development o n your development nodes. Then install the iIS runt ime modules on the nodes o n which you will be executing yo ur distributed enterprise applicat ions.
iIS Process Sy stem Software 48 iPlane t Integrati on Server • Process Syst em Guide • August 2001 WFLibra ry (compiled) Process devel opmen t A libra ry distr ibution that su pports t he process develo pment worksh ops. Needed in iIS process developmen t reposito ry an d on process develo pment nod es.
iIS Process System Sof tware Chap ter 2 Setting Up an iIS P rocess Manage ment Sys tem 49 WFClientAP I (compiled) C++ client application dev elopm ent A DLL requir ed to wri te process client application code in C++ . Needed on C++ clien t application developmen t nodes , and on runtime nodes run ning C++ client applicat ions.
iIS Process Sy stem Software 50 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Compiled and I nterp reted Engine Components There is a script for alternating between the use of compiled or interpreted engine components .
iIS Process System Sof tware Chap ter 2 Setting Up an iIS P rocess Manage ment Sys tem 51 ➤ Before you inv oke the se tccomp script, you must do the foll owing 1.
iIS Process Sy stem Software 52 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Repository ser ver A server node ( runs an iP lane t UDS N ode Manage r) th at hos ts the iIS central development repository and repository service.
iIS Process System Sof tware Chap ter 2 Setting Up an iIS P rocess Manage ment Sys tem 53 Figur e 2-2 iIS Process System Con figuration You do not ha ve to decide at iIS install ation time exact ly which engine compo nents to assign to each server node because all compo nent partitions are installed on each server node that supports an engine.
iIS Process Sy stem Software 54 iPlane t Integrati on Server • Process Syst em Guide • August 2001 For the purpose of system setup, the primary considerations are that the iIS process engine is th e workhorse of y our iIS process sy stem and that it accesses a p otentially very large database.
Setting Up an iIS Process Sy stem Chap ter 2 Setting Up an iIS P rocess Manage ment Sys tem 55 Setting Up an iIS Process System After you have decided how to configure your iIS process system (and filled out the table in the previous section), you are ready to set up your system.
Setting Up an iIS Process Sy stem 56 iPlane t Integrati on Server • Process Syst em Guide • August 2001 7. After process client appl ications have been developed, run the iIS installation program on all runtime client nodes (those nodes th at support an iIS process client applicat ion but do not support d evelopment).
Setting Up an iIS Process Sy stem Chap ter 2 Setting Up an iIS P rocess Manage ment Sys tem 57 Central Serve r Installation On a cent ral serve r node — th e first node to b e installed in an iIS sy.
Setting Up an iIS Process Sy stem 58 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Engin e Server Installa tion On an engine s erver node, which must be installed after the ce.
Setting Up an iIS Process Sy stem Chap ter 2 Setting Up an iIS P rocess Manage ment Sys tem 59 Developm ent Client Installation A development client node can be used for either process development or client applicatio n development.
Setting Up an iIS Process Sy stem 60 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Runtime Client Insta llation On a runtim e client node, which m ust be installed af ter the .
Maintaining an iIS Process Sy stem Chap ter 2 Setting Up an iIS P rocess Manage ment Sys tem 61 Maintaining an iIS Process Sys tem Once your iIS process system is set up and functional (inclu ding con.
Maintain ing an iIS P rocess System 62 iPlane t Integrati on Server • Process Syst em Guide • August 2001 3. Choos e default or c ustom ins tallation , depen ding on the compon ents you wan t to install on the node. Moving an i IS Eng ine Moving an iIS engine or engine component is straightforward.
Maintaining an iIS Process Sy stem Chap ter 2 Setting Up an iIS P rocess Manage ment Sys tem 63 3. Move the two iIS repos itory files ( reposn ame .btx and reposnam e .btd) fro m FORTE_ROOT/repos on the original Repository Server node to the same location on the target node.
Maintain ing an iIS P rocess System 64 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Uninstal ling an iIS System Because iIS server so ftware is installed usi ng iPlanet UDS sys tem management services, the iPlanet UDS environ ment repository has a record of al l engine components installed on servers in your environment.
65 Chapter 3 The iIS Console This chapter describes the iIS Conso le, the iIS product ’ s window -based to ol for performi ng iIS proce ss managem ent task s.
Overview 66 iPlane t Integrati on Server • Process Syst em Guide • August 2001 The iIS Console is us ed for the following four general k inds of iIS process managem ent tasks: • configure and ma.
Starting the iIS Co nsole Chapt er 3 The iIS C onsole 67 Starting t he iIS Console You can st art the iIS Console on any node in your iPlanet UDS environment w here it has been installed. ➤ To start th e iIS Console o n Windows or Wi ndows NT 1. Double-click the iIS Console icon.
The iIS Console M ain Windo w 68 iPlane t Integrati on Server • Process Syst em Guide • August 2001 The follow ing table descri bes the command line flags for the cconsole command. The iIS Consol e Main Win dow The iIS Console main window is a view of con figured iIS process engines in yo ur active environment.
The iIS Console M ain Windo w Chapt er 3 The iIS C onsole 69 Figur e 3-1 iIS Console M ain Window Main Viewin g Panel The main viewing pa nel displays all conf igured engines in an iP lanet UDS environment.
The iIS Console M ain Windo w 70 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Menu Bar The iIS Console menu bar provides all the commands you can execute from the main win dow. The menus are su mmarized below , and a full list of the co mmands is provided at the end of this ch apter.
The iIS Console M ain Windo w Chapt er 3 The iIS C onsole 71 Setting Pa ssword Protectio n for iIS Console You can restrict access to iIS Console by settin g password protection for your active iIS environment.
Using iIS Console Windows 72 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Using iIS Console Windows The iIS Console is a graphical system applicatio n developed in iPlanet U DS whose windows behave in accordance with your host window system.
Using iI S Console Windo ws Chapt er 3 The iIS C onsole 73 ➤ To set t he automatic refr esh inter val 1. Choose View > Set Refresh Interval. The Refresh Interval window displays with the default tim e interval setting: 2. Enter a new time int erval in milliseconds .
Using iIS Console Windows 74 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Operat ors You can buil d filter expressions that us e both comparison and lo gical operators. The compariso n operators are listed in th e following table: You can use a number of logical operators to join several filter expressions.
Using iI S Console Windo ws Chapt er 3 The iIS C onsole 75 Exampl e Filter Expre ssion In the session list example, suppose you enter the following expressio n in the Filter window : Activity RE ADY A.
Using iIS Console Windows 76 iPlane t Integrati on Server • Process Syst em Guide • August 2001 The resulting session list w ould then be the fo llowing: Sorting i IS Console L ists The iIS Conso .
Using iI S Console Windo ws Chapt er 3 The iIS C onsole 77 4. If you select a text field, you can also specify that case-sensitivity apply to the displayed text by checking Cas e Sensitive Text Comparison.
iIS Con sole Mai n Window Co mmand S ummary 78 iPlane t Integrati on Server • Process Syst em Guide • August 2001 iIS Console Main Window Command Summary The following tables summariz e the commands available f rom the iIS Console main win dow.
iIS Co nsole Main W indow C ommand Su mmary Chapt er 3 The iIS C onsole 79 View Menu Engine Menu Command Description See … Refresh N ow Forc es an im mediate refresh of t he engine list in the main viewing panel.
iIS Con sole Mai n Window Co mmand S ummary 80 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Monitor Menu Trace … Opens an engine trac e window in whic h you display messages, of the type you s pecify, gen erated by the various engine co mponents.
iIS Co nsole Main W indow C ommand Su mmary Chapt er 3 The iIS C onsole 81 Help Menu Activiti es Resident … Opens the engine acti vity insta nces window, which displays t he list of all ac tivity instanc es for the selec ted engin e. You can so rt this list by activ ity name, activity ID, acti vity stat e, and proces s name.
iIS Con sole Mai n Window Co mmand S ummary 82 iPlane t Integrati on Server • Process Syst em Guide • August 2001.
83 Chapter 4 Managing Engines This chapter describes how to manage iIS process engines. It covers the following topics: • configuring a n engine • starting an engine • monitori ng and chan ging .
Productio n Engines V ersus Develo pment E ngines 84 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Keep these issues in mind when configuring an engine. In most situations, you have to configu re and manage at least one development en gine and one producti on engin e.
Config uring an E ngine Chapte r 4 Managin g Engines 85 Configuring a n Engine An iIS process system can h ave any number of engines. For example, one engine might be used for testing and another used for production. In other cases, organizati onal consi derations or hea vy load cond itions might requ ire a number of production engines.
Configur ing an Engine 86 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Figur e 4-1 Engine Configu ration with bot h Failover and Load Balancin g During insta llation, you de cided which nod es in your iPlanet UDS environment (engine servers) would have engine components installed on them.
Config uring an E ngine Chapte r 4 Managin g Engines 87 Governor The governor does not do much processing and does not req uire a high performance server.
Configur ing an Engine 88 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Figur e 4-2 Typical Engine Pa rtitioni ng Scheme Engine Start up Properties Before you start an engine, yo u must specify a number of startup properties. These properties are stored in th e engine configuration file.
Config uring an E ngine Chapte r 4 Managin g Engines 89 Engine name An alpha-numeric name used to identify the engine in a given environment. Environment An alpha-numeric name th at specifies the iPla net UDS environment in which the engine resides. Database Config uration Properties Properties needed to access the engine database.
Configur ing an Engine 90 iPlane t Integrati on Server • Process Syst em Guide • August 2001 Engine Configu ration Fi le The engine component partitioning and engine startup properties are stored .
Config uring an E ngine Chapte r 4 Managin g Engines 91 The engine properties specified in the configuration file ar e described in the following ta ble: Ta b l e 4 - 1 Proces s Engine Con figuration Properties Propert y Type of value Description FILE _VER SION stri ng Inte rnal us e.
Configur ing an Engine 92 iPlane t Integrati on Server • Process Syst em Guide • August 2001 GOVERNOR_MEMORY_ FLAG string Specifies memory options. Uses the sa me syntax as th e -fm flag used on i Plan et UDS part ition s. Defau lt valu es are n:2048,x :16384 , … .
Config uring an E ngine Chapte r 4 Managin g Engines 93 Customizin g Engine Database Schema iIS provides a default databa se schema that it uses to create an en gine database. This default schem a can be used in a development environment wit hout modification.
Configur ing an Engine 94 iPlane t Integrati on Server • Process Syst em Guide • August 2001 When you configure a new engine, the default engine schema is specified by the following file on the central server node in your environment: FORTE_ROOT /sysdata/conductr/cl N / enviro nment / engine_name .
Config uring an E ngine Chapte r 4 Managin g Engines 95 The following example shows how to modify the create index statement fo r the WFHActivity tabl e to include a table space qualifier.
Configur ing an Engine 96 iPlane t Integrati on Server • Process Syst em Guide • August 2001 ➤ To configure a new engine 1. Choose Engin e > New. The Configure New Engi ne window displays : 2. Enter a name for the ne w engine in the Engine name field.
Config uring an E ngine Chapte r 4 Managin g Engines 97 4. Enter the database config uration properties. For information on the Database Connection fields, refer to the iIS online help. The Text Attribute Segment Size fields allows you to specify the segment length for process a ttributes and user profile informatio n for a session.
Configur ing an Engine 98 iPlane t Integrati on Server • Process Syst em Guide • August 2001 6. Spec ify th e en gine da taba se t abl es ( Curr en t sta te a nd/ or Hist ory log) fo r wh ich you want to log information. If you wri te to history log tables, specify the informatio n to log.
Config uring an E ngine Chapte r 4 Managin g Engines 99 7. Select the Compon ents tab. The Component Partitioning dialog is displayed. 8. Specify the engine component partitioning.
Configur ing an Engine 100 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 a higher nume ric value signifying a h igher priority. It is sug gested that you decide on a sensible set o f priorities. A default priority of “ 1 ” is used if you do not specify a priority.
Config uring an E ngine Chapter 4 Ma naging Engines 101 10. Specify memory options for the governor, database service, and engine unit memory flags if you want to override the default values. The settings yo u are most likely to cha nge are the minimum and maximu m memory allocation for engine units.
Configur ing an Engine 102 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 11. Speci fy how many monitor windows can be open at a ny time. The Monitor Di splay Limit o ption (default va lue of 10), indica tes how many iIS Console monito r windows can be open a t any time.
Config uring an E ngine Chapter 4 Ma naging Engines 103 The process execution options are the following: For information about how to use these config uration options , see “ How to Tune Process Ex ecution ” on page 1 16 . 14. S peci fy en gin e rec ove ry be hav ior .
Configur ing an Engine 104 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Duplicat ing an Engine Conf iguration If you have multiple engines that need to be configured similarly, or want to add an engine wi th a configurat ion similar to an exist ing engine, you can d uplicate an engine configuration.
Starti ng an Engine Chapter 4 Ma naging Engines 105 Startin g an Engine To start an engine, you start ea ch of its components — engine unit s, governor, and database services. These compone nts are applications, each consisting of a single serv er pa rt itio n that mus t es tabl ish c ommu nica tio n chan nels with oth er components.
Starting an En gine 106 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 The governor has four internal sta tes, depending on its connections with the engine units: As the gove.
Starti ng an Engine Chapter 4 Ma naging Engines 107 If an en gine unit s tarts before the governor, but after its partner has started, then it must negotia te with its partner to establish which unit is to become primary. If one unit has been marked as the preferre d primary, then that unit becomes primary.
Starting an En gine 108 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Primar y Engin e Unit Start up Phases The primary engine unit must perform a number of startup operations to come fully online.
Starti ng an Engine Chapter 4 Ma naging Engines 109 Database Servi ce When a database service starts, it attempts to conn ect to the primary engine unit. If the primary engine uni t is not online, the databa se service continues waiti ng for it indefinitely .
Starting an En gine 110 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 How to Start an Engine You can start engine components from a centralized location using the iIS Console (see Cha pt er 3, “ The iIS Console ” ).
Starti ng an Engine Chapter 4 Ma naging Engines 111 3. Select a startup optio n. A number of options are av ailable for creating new engine database tables when starting an en gine (see “ Managing a.
Starting an En gine 112 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 4. Disable the engine components you do not want to start. By default, all compo nents specified in your configu ration file are ena bled. 5. Click Start.
Reconfig uring a n Engine Chapter 4 Ma naging Engines 113 Reconf igurin g an Engine An engine ’ s component partitioning and startup properties are stored in its engine configuration f ile, which is read at engin e startup time. To reconfigure an engine you modify the configuration file and restart the engine.
Reconfig uring an Eng ine 114 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 2. Choose Engine > Reco nfigure. The Reconfigure Eng ine window displays: 3. Select the appropriate tab to m odify the property or properties you want to change.
Reconfig uring a n Engine Chapter 4 Ma naging Engines 115 How to Dynamically Modify Da tabase Log ging To chang e the logging configurati on of yo ur engine, norma lly to reduce or increase the amount of his torical state informatio n being logged to your eng ine database, you do not have to resta rt the engine.
Reconfig uring an Eng ine 116 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 How to Tune Process Exe cution The perform ance of a n engine depends on available system resources, such as memory. For example, if engine memory resources become overtaxed, engine perfor mance ca n degrad e, and an eng ine can e ven fail.
Monit oring and Changin g Engine States Chapter 4 Ma naging Engines 117 used process instances (and al l their associated activities, timers, and process attributes), un til it brings the number of mem ory-resident process instan ces back within th e limit.
Monito ring and Ch anging Engine Sta tes 118 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Monitorin g Engine s and Engine Component s You can get sta tus informa tion about the engin e as a whol e as well as about each of the individual engine component in the iIS Console (see Chapter 3, “ Th e iIS Console ” ).
Monit oring and Changin g Engine States Chapter 4 Ma naging Engines 119 The window provides information about the runtime state of the en gine and engine compon ent partitions. Part itions that are runnin g (even if not fully functional) are shown with a w arm-up state icon.
Monito ring and Ch anging Engine Sta tes 120 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 The right side of the window provides information about the status of the engine component. F or example, status i nformation con tained on a pri mary engine unit is shown be low.
Monit oring and Changin g Engine States Chapter 4 Ma naging Engines 121 Governor In th e case of a governor the followin g information is pro vided: Database ser vice In the case of a database servi c.
Monito ring and Ch anging Engine Sta tes 122 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Changing Eng ine States You can chan ge the state of an engine, which usually involves changing the state of one or both engine units or shutting down one or more engin e components.
Monit oring and Changin g Engine States Chapter 4 Ma naging Engines 123 3. Click the Set Primary button i n the Engin e Status w indow. The pri mary unit now becomes th e backup unit, and the backup becomes the online unit .
Managi ng an Engine Datab ase 124 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 For more details on recovery levels, see the iIS Process Dev elopment Gui de and the iIS Proces s Client Prog ramming Gui de .
Managi ng an Eng ine Database Chapter 4 Ma naging Engines 125 Growth of the Da tabase As with any of the enterprise data bases used by your workflow application, the engine database can grow in size.
Managi ng an Engine Datab ase 126 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Dumping and Restori ng Data The iIS Dump/Res tore facility makes it possibl e to dump the data in an engine database to an ASCII file, an d then, subsequently, to restore the data to the existing database or to a new engine database.
Managi ng an Eng ine Database Chapter 4 Ma naging Engines 127 Using the Dump/Restor e Application The following procedure shows how to use the Dump/Restore application. ➤ To use the Dump/Restore applicati on to dump database tables 1. Start the Dump/R estore application.
Managi ng an Engine Datab ase 128 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 2. Configure a data file in which to dump the data. a. Click the Configure Fil es tab. b. In the Directory na me field, specify the directory into w hich the data file will be written .
Managi ng an Eng ine Database Chapter 4 Ma naging Engines 129 3. Specify the engine database f rom which to dump th e data. a. Click the Configure Data base tab. b. In the Engine name field, enter the name of the engine whose data yo u want t o dump .
Managi ng an Engine Datab ase 130 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 4. Dump the data. a. Click the Dump Tables tab. b. Select the category of tables you want to dump. By default, all categories are selected. Disable any category you do not wan t t o du mp.
Managi ng an Eng ine Database Chapter 4 Ma naging Engines 131 As in all iPla net UDS command li ne specifications, if yo u use a name that includes a space, you should enclose the name in double quotation marks.
Managi ng an Engine Datab ase 132 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Preservin g Engine Databa se Schema Cust omizations If you are upgrading to a new release of iIS, the database s chema for the process engine may have changed.
Managi ng an Eng ine Database Chapter 4 Ma naging Engines 133 Using the Dump/Restor e Application The following procedure shows how to rest ore database tables that were previously writ ten to an ASCII file, as explained in “ Dumping Database Tables ” on page 126 .
Managi ng an Engine Datab ase 134 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 4. Restore the data. a. Click the Restore Tables tab. b. Select the categ ories of tables you want to restore. By default, all categories are selected.
Managi ng an Eng ine Database Chapter 4 Ma naging Engines 135 Using the Restore Command-l ine Utility The Dump/Restore facility ’ s DrRestore command retrieves data which has been dumped to an ASCII file and restor es it into an engine database.
Managi ng an Engine Datab ase 136 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Dump/R estore En vironm ent V ariable s iIS provides a s et of environment variables for use with the Dump/Restore f acility. You can set these variables to provide values for both the Dump/Restore applicatio n and the comm and-line utility .
137 Chapter 5 Managing Registra tions Registration is the procedure by which program matic information abou t processes, users, and so on, created in the process developm ent workshops , is made available to a running iIS process engine, so it can be dyna mically loaded and used in process execution.
About Re gistration 138 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Registration is the procedure by which process logic created in the iIS process development workshops is made available to a runn ing engine (see “ What Does Registra tion Do? ” below) .
About Reg istration Chapt er 5 Managi ng R egis trat ions 139 What Does Regist ration Do? The entity actually registered when you register a process defin ition, assignment rule, user profile, or user validati on is a library. (Alia ses are not libraries and this section does no t apply to them — see “ About Alia ses ” on pag e 143 .
About Re gistration 140 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Figur e 5-1 Registration Steps • Installin g library distribution files o n the nodes hosting th e target engine (more specifically, hos ting the target engine un its).
About Reg istration Chapt er 5 Managi ng R egis trat ions 141 If at so me point you ha ve to move an engin e unit to a new node, you d o not have to manually re-register (reinstall) all the libraries on the new node.
About Re gistration 142 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 4. Follow the in structions for registering iIS distribution s in “ Registering iIS Distribut ions ” on page 144 .
About Reg istration Chapt er 5 Managi ng R egis trat ions 143 About Alia ses An alias is a referen ce to a process definition registered w ith an engine. It is used by developers when defining a Subprocess activity in a process definition so they do not have to hard code the process name and host engine represented by the Subprocess activit y.
Registering iIS Distributions 144 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 If process1 and process2 ha rd-code the reference to process3 on engine3, then process3 could.
Regist ering iIS D istributi ons Chapt er 5 Managi ng R egis trat ions 145 Process Definit ion A process def inition must be registered with every engine that can execute that process def inition.
Registering iIS Distributions 146 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 ➤ To register one or more d istributions using the iIS Consol e 1. Choose Environment > Registrations> New. The Register Distributions window displays: 2.
Regist ering iIS D istributi ons Chapt er 5 Managi ng R egis trat ions 147 Upgrading Reg istration s Sometimes you must register a new version (upgrade a registration) o f one of these library distributions.
Registering Aliases 148 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 ➤ To unregister a process definitio n, assignment rule dictionary, or user profil e 1. Choose Environment > Registration > Unregister. The Unregister Distribution window displays: 2.
Registering Aliases Chapt er 5 Managi ng R egis trat ions 149 Unlike process definitions, assignment rule dictionaries, user profiles, and the validation , aliases do not inv olve library distributi ons. In registering a n alias, you are simply making an entry in an engine ’ s r egistration table.
Viewing Registration s for an E ngine 150 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Unregisterin g Alias es At times you might want to unregister an al ias from one or m ore engines, normal ly because thos e engines ar e no longer us ing it.
Viewin g Registratio ns for an E ngine Chapt er 5 Managi ng R egis trat ions 151 ➤ To vi ew t he reg ist ratio ns f or a give n en gine 1. Select a runnin g engine in the iIS Conso le main window. 2. Choo se Mon itor > Re gis trati ons, or ch oos e Regi str ation s fr om the pop up menu.
Viewing Registration s for an E ngine 152 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 3. Click a tab to open it to view a particular type of registered distribution. The menu bar changes depending on th e type of registration you are viewing.
Perfor ming App lication Up grades Chapt er 5 Managi ng R egis trat ions 153 4. Right-cl ick and choose Process D efinition > Open fro m the popup menu.
Perform ing Appli cation U pgrades 154 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 However, sometimes an upgrade involves a new or modified extended user profile.
Perfor ming App lication Up grades Chapt er 5 Managi ng R egis trat ions 155 Rolling Upgrade s Rolling upgrades must be used in production situations where work cannot be interrupted and client applicatio ns cannot be upgrad ed monolithica lly.
Perform ing Appli cation U pgrades 156 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1.
157 Chapter 6 Managing Process Execution The main function of an iIS process en gine is to coordinate the work done by a variety of users (or application components) in perfo rming the activities that comprise a busin ess process. The e ngine does this by executing iIS process definitions that have been registered with the engine.
Introducti on 158 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Engine Sessio ns An iIS process engine genera lly coordinates the work of a number of applications that perform various activities that com prise a business process.
Introdu ction Chapter 6 M anaging P rocess Execut ion 159 An ACTIVE or SUSPENDED session can be term inated by an application or user, or by a system manage r.
Introducti on 160 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 If the client session reconnects to the engine during the timeout period, th e sessions are restored depending on the value of the sess ion ’ s reconne ct action pro perty (set using the cont rol parameter to WFEngin e.
Introdu ction Chapter 6 M anaging P rocess Execut ion 161 If a connection is permanently lost, the client API code notifies the client applicatio n that its connection h as been permanently lost. The clien t application must explicitly reop en its session to restore it to ACTIVE st ate.
Introducti on 162 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Activity Stat es During process execution the engine manages a succession of activities through a number of states, from creation to deletion.
Introdu ction Chapter 6 M anaging P rocess Execut ion 163 ACTIVE When a clien t applicatio n accepts an offered a ctivity or t akes it off a queue, it is pla ced in ACTIVE st ate.
Introducti on 164 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Figur e 6-1 Activ ity St ate Tran sition s — from Creation to Ter mination PENDING READY ACTIVE ABORTED COM.
Process Execution Chapter 6 M anaging P rocess Execut ion 165 Activi ty T ypes A process definition ca n include a number of different activity types, each of which passes throug h the various activit y states in a diff erent fashion. The ta ble below summarizes the different types of activities.
Process Exe cution 166 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Process instance execution Process execution involves creation of any number of activities, including on.
Process Execution Chapter 6 M anaging P rocess Execut ion 167 Process Instance Execution Process execution consists of the s equential creation, execution, and termination of the activities specified in a process defi nition. When an activity is created, it remains in a PEND ING state until its trigger cond itions are fulfilled.
Process Exe cution 168 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Activity Executio n As a general rule, activity executio n consists of taking each a ctivity through the series of states descr ibed in “ Acti vity Sta tes ” on p age 162 .
Process Execution Chapter 6 M anaging P rocess Execut ion 169 Session a ssignment takes place in any of the f ollowing situ ations: • An offered activity is pla ced in a READY state fo r the first time.
Process Exe cution 170 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 READY State Handling When a Que ued activ ity i s pla ced i n a RE ADY s tate, the activity is placed in a queue n amed after the queued activity and containi ng activities with the same name from multiple process instances.
Process Execution Chapter 6 M anaging P rocess Execut ion 171 ACTIVE State H andling T he engine performs any work specif ied in the OnActive method (if one exists in the process definition). An acti ve su bproce ss act ivi ty is handled differ ently depe nding o n whe ther the subprocess activit y is synchron ous or asynch ronous.
Process Exe cution 172 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Comp lete d Acti vities When an engine places an activity in a COMPLETED state, the engine performs the .
Monitor ing and M anaging Eng ine Session s Chapter 6 M anaging P rocess Execut ion 173 Process Inst ance Termin ation Process termination occurs when the engine places a process instance in either a COMPLETED state or an ABORTED state.
Monito ring and M anaging E ngine Sessi ons 174 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Moni toring the Stat e of a Sessi on Often you want to know inf ormation a bout.
Monitor ing and M anaging Eng ine Session s Chapter 6 M anaging P rocess Execut ion 175 3. To get more informatio n about a ses sion, select it, and choose Sess ion > Open from the popup menu.
Monito ring and M anaging E ngine Sessi ons 176 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Managing Se ssions Session m anagement consists of suspending or terminating sess ions, or sending a message to one or mo re sessions (that is, the co rresponding client a pplications).
Monitor ing and M anaging Eng ine Session s Chapter 6 M anaging P rocess Execut ion 177 ➤ To terminat e a session 1. Choose Monito r > Sessions to displ ay the Sessions window with t he list of current se ssions fo r the engine. 2. Select the session to terminate.
Monito ring and M anaging E ngine Sessi ons 178 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 2. Open the session of interest. 3. Click Send Me ssage. The Se nd Message w indow displ ays: 4. Type the message in the Message field.
Moni tor ing an d Ma nagi ng P roces s Ex ecut ion Chapter 6 M anaging P rocess Execut ion 179 ➤ To broadcast a message to all sessi ons 1. Choo se Mon ito r > Ses si ons to ope n the list of cu rren t se ssi ons. 2. Right-cl ick and choose Sessi on > Broadcas t from the popup menu.
Monito ring and M anaging Pro cess Execut ion 180 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Figur e 6-2 Process Ex ecution Objec ts: Propert ies an d Relationships Using the iIS Con sole, you can display lis ts of these objects an d filter them according to specific criteria.
Moni tor ing an d Ma nagi ng P roces s Ex ecut ion Chapter 6 M anaging P rocess Execut ion 181 activity que ue Ch ecking the status of an activity queue and possibly reprioritizing an activi ty within the queue (fo r queued activities only). timer Checking the status of a timer insta nce and resetting it or changin g its state.
Monito ring and M anaging Pro cess Execut ion 182 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 3. Select the process name you want to view instances of and cho ose Processes > Open Inst ances of.
Moni tor ing an d Ma nagi ng P roces s Ex ecut ion Chapter 6 M anaging P rocess Execut ion 183 5. Select a proces s instance and choose Process > Open Instance.
Monito ring and M anaging Pro cess Execut ion 184 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Abortin g a Proce ss Instance If you want to stop execution of a process instance, you can abort that process instance. This abo rts all uncom pleted activities, stops all ti mers, and discard s all process attribute updates.
Moni tor ing an d Ma nagi ng P roces s Ex ecut ion Chapter 6 M anaging P rocess Execut ion 185 Managing Act ivit y Insta nces This section d escribes how to ch eck the status of an activity and change its state .
Monito ring and M anaging Pro cess Execut ion 186 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 2. Choose Activ ities > Open.
Moni tor ing an d Ma nagi ng P roces s Ex ecut ion Chapter 6 M anaging P rocess Execut ion 187 • from ACTIVE t o READY You might do this because the person wo rking on an activ ity cannot complete it and you want it to be reoffered to other users.
Monito ring and M anaging Pro cess Execut ion 188 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 3. From the New state drop list, select the new state of the activity.
Moni tor ing an d Ma nagi ng P roces s Ex ecut ion Chapter 6 M anaging P rocess Execut ion 189 3. Select a queue. 4. Choose Queue > Open. The Activity Queues window displays, showing the list of activities in the queue.
Monito ring and M anaging Pro cess Execut ion 190 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 3. Choose Activ ity > Set Priority. The Set Queued Activity Pri ority window displays: 4. In the New prioritizing value, change the value of the queue prioritizing process attribute.
Moni tor ing an d Ma nagi ng P roces s Ex ecut ion Chapter 6 M anaging P rocess Execut ion 191 Managing Ti mer Instances This section d escribes how to check the status of a timer, re set it, or change its state . Checking the Statu s of a Ti mer 1. Open the Timers tab of a Process Instance property inspector, shown below.
Monito ring and M anaging Pro cess Execut ion 192 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 3. Choose Timers > Open. The Timer property inspector displays, with the b.
Moni tor ing an d Ma nagi ng P roces s Ex ecut ion Chapter 6 M anaging P rocess Execut ion 193 3. To change the state of the timer, click one of the radio buttons in the On/Of f Control. 4. To change the expiration tim e, click one of the radio button s in the Options box.
Monito ring and M anaging Pro cess Execut ion 194 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 An example attribute list (the Process Attributes tab of a Process Instan ce property inspector) is shown below. For each process attribute the list displays the attribute name, data type, attribute value, and lock state.
Moni tor ing an d Ma nagi ng P roces s Ex ecut ion Chapter 6 M anaging P rocess Execut ion 195 ➤ To change the value of a process attri bute 1. Select the attribute in an y process attribute lis t window, as described in “ Checking th e Value and Lock State of a Process At tribute ” on page 193 .
Monito ring and M anaging Pro cess Execut ion 196 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Checking for Bottlenecks i n Process Execution Instance s of a given proce ss sometimes s tall at a parti cular activity, ca using a bottleneck in execution of that activity.
Analyzing P rocess Execu tion Chapter 6 M anaging P rocess Execut ion 197 To analyze the si tuation further you mi ght have to open particular activi ty instances, check sessions, or possibly check attributes of the corresponding process instances.
Analyzing P rocess Execu tion 198 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 • Worker productivi ty You can perform productivity analyses. For example, you can tabulate how many activities have been completed in a given time as a function of the session (user).
Monit oring and Managin g Two-Phas e Comm it Chapter 6 M anaging P rocess Execut ion 199 Monitor ing a nd Ma naging Two-Pha se Co mmit iIS provides a two-phase commit protocol that allows process client applications to easily synch ronize iIS process sta te changes with a pplication databa se updates.
Monito ring and M anaging T wo-Phase Commit 200 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Figur e 6-3 Client A pplications Cha nge Both iIS Process State a nd Applicat i.
Monit oring and Managin g Two-Phas e Comm it Chapter 6 M anaging P rocess Execut ion 201 Because of this two-phase commit capa bility, an iIS engine tran saction and an applicatio n transaction ca n be combined into a high er level distributed transa ction.
Monito ring and M anaging T wo-Phase Commit 202 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 The iIS two -phase commit protocol is i mplemented by placin g an engine s ession in two-phase commit mode. iIS engine transaction s for this session are automatically placed in a PREPARE phase.
203 Chapter 7 Troubleshooting This chapter d iscusses a numbe r of topics and approaches related to diagnos ing problems in your iIS proce ss manageme nt system.
Introducti on 204 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 The information d isplayed in these iIS tools falls into the follo wing categories: Alarms A number of error conditi ons in the functioning of an iIS proces s engine that might require your intervention are reported as alarms.
Process Engine Al arms Windo w Chap ter 7 Troublesh ooting 205 Process Engine Alarms Windo w A number of engine condit ions result in an alarm. An alarm is a message noti fying you of a cond ition in the functio ning of an iIS process engin e that might require intervention.
Process E ngine Al arms Window 206 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Moni toring Alarms Alarms for any numb er of engines can be displayed in the Process Engine Alarm s window , allowing you to mo nitor all you r iIS pro cess engi nes from on e centra l location.
Process Engine Al arms Windo w Chap ter 7 Troublesh ooting 207 3. The Process Engine Alarms window displays. In the following illustration, a registered engine, ceengine, was shut down, causing the Engin eUnitShutdown al arm to be displayed. ➤ To unr egist er an en gine from the Al arm ser vice 1.
Process E ngine Al arms Window 208 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 You can add additional expressions to build complex filters.
Process Engine Al arms Windo w Chap ter 7 Troublesh ooting 209 ➤ To get det ailed i nformatio n about an alarm 1. Select the alarm in the Process Engine Alarms window. 2. Right-click and choose Alarm > Open fro m the popup menu. The Alarm Details win dow displays: ➤ To remov e an alar m from the Alarm windo w 1.
Engine L og Files 210 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Engine L og Files Each iIS process engine compo nent, like other iPlanet UDS partitions, writes to a log file that records exceptio ns and message ou tput. The component log files are therefore an important source of troubleshooting information.
Engi ne Lo g Fi les Chap ter 7 Troublesh ooting 211 Instru ment Dat a Yo u can decid e to have instru ment data — suc h as app licat ion reso urc e usa ge or per forma nce s tati stic s — collected by the underlying system fo r an engine com ponent and written to the partition log f ile at time intervals you can specify.
iIS Con sole Tr ace Window 212 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 4. Click the View Partition Log button. iIS Console Trace Window iIS Console provid es a trace window tha t displays in formation written to iIS engine compon ent log files.
iIS Consol e Trace Window Chap ter 7 Troublesh ooting 213 This section discusses how to use the iIS Console Trace window to select an d display messages generated by iIS engine components. Specifyin g Message Filters The syntax for specifying log message filte rs is shown in Fi gure 7-1 .
iIS Con sole Tr ace Window 214 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 iIS Message F ilters iIS messag e filters follow the general guid elines above and have th e fol.
iIS Consol e Trace Window Chap ter 7 Troublesh ooting 215 For example, an iIS message filter for a prim ary engine unit might be as follo ws: FORTE_LOGGER_SETUP: "%stdout(trc:cr:2: 2)" This .
iIS Con sole Tr ace Window 216 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 ➤ To set message f ilters for a selected e ngine 1. Select a runnin g engine in the iIS Conso le main window. 2. Choose Engine > Trace. The iIS Console Tra ce window displays.
iIS C onsole En gine Even t Filter Window Chap ter 7 Troublesh ooting 217 All messages generated by the component that meet the specification are now written to the trace windo w, as well as to the components log file.
iIS Con sole Engin e Event Fi lter Wind ow 218 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Engine Event Types iIS Console engine event types consist of: • time r stat e .
iIS C onsole En gine Even t Filter Window Chap ter 7 Troublesh ooting 219 Displ ayin g All Engi ne Events You can view all engine events for a running engine. ➤ To vie w all engine event s for the selected eng ine 1. From the Engine Event Filter win dow, select the option Show all engine events.
iIS Con sole Engin e Event Fi lter Wind ow 220 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Events for the specified process instance display: ➤ To view all engine events for the next pr ocess instance of a specific p rocess definitio n 1.
Per for mance Cha rts Chap ter 7 Troublesh ooting 221 Filtering Engine Events A fourth way to view engin e events is by providing a custom filt er. You can filter on events in volving se ssions, process instances, activities, eng ine objects, ti mers and registrations.
Perform ance Ch arts 222 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 It is therefore a good idea to regularly monitor a number of performance indicators — i nstrumentat ion within an engin e that can be displayed over tim e in the iIS Console Performance Charts.
Per for mance Cha rts Chap ter 7 Troublesh ooting 223 ➤ To view performance indicato rs for an engine 1. Select a runnin g engine in the iIS Conso le main window.
Perform ance Ch arts 224 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 4. To set the vertical scale parameters for the char t and see the maximum and minimum values recorded by this chart, click somewhere in the chart, then right-click and cho ose Chart > Prop erties from the popup menu.
Per for mance Cha rts Chap ter 7 Troublesh ooting 225 Logging Pe rforman ce Informat ion You can save perfo rmance informatio n to a log file. ➤ To log pe rformance i nfor mation 1. At the Performance Charts window, choose File > Set Logging File.
Perform ance Ch arts 226 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1.
227 Chapter 8 Using the Conductor Script Utility This chapter describes the Conductor Script utility, the iIS command line system managem ent inter face. The Conductor Script utility is the command lin e equivalent of the iIS Co nsole. However, Condu ctor Script al so lets you inco rporate system man agement task s into scripts.
Starting C onductor Scri pt 228 iPlan et Integra tion Serv er • Process System Gu ide • August 2001 Unlike the iIS Console, however, you can use Conductor Script to perform system management by building and executin g predefined scripts of Conductor Script commands.
Star tin g Cond uct or Scr ipt Chapter 8 Using the Conductor Script Utility 229 ➤ To start Conducto r Script on U NIX, OpenVMS, or Windows N T 1. Use the cscript command (see “ Using the Cscript Com mand ” below for informatio n). 2. Enter a valid passwo rd if one is requested (see “ SetPassw ord ” on page 3 00 ).
Working with Condu ctor Scrip t 230 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Working wit h Conducto r Script Conductor Script is a command line utility built o n top of the iPlanet UDS Fscript command utility .
Wor king wit h Cond ucto r Scr ipt Chapter 8 Using the Conductor Script Utility 231 For full reference documen tation of the commands discussed below, consult the Fscript Refe rence Guide .
Working with Condu ctor Scrip t 232 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Writing and Executi ng Scripts This section describes Conduct or Script commands you use to write and execute scripts to automa te iIS process management tasks.
Wor king wit h Cond ucto r Scr ipt Chapter 8 Using the Conductor Script Utility 233 The follow ing tabl e lists Condu ctor Script commands m ost often u sed for wr iting and e xecut ing scrip ts: Oper.
Working with Condu ctor Scrip t 234 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 CopyFile file1_name file2_name [r] Copy a specifie d file in the lo cal file syst em. Cp file1_name file2_name [r] Copy a specifie d file in the lo cal file syst em.
Manag in g iIS P roce ss En gine s wi th Co nduct or Sc ript Chapter 8 Using the Conductor Script Utility 235 Managing iIS Process Engines with Conductor Scr ipt This section d escribes how to perfo r.
Managi ng iIS Proc ess Engine s with Con ductor Sc ript 236 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Starti ng Indi vidual En gine C ompone nts You can star t an individual en gine componen t on any node on which it i s installed.
Manag in g iIS P roce ss En gine s wi th Co nduct or Sc ript Chapter 8 Using the Conductor Script Utility 237 The Conductor Script commands used to start engines are documented in Appendix A, “ Cond.
Managi ng iIS Proc ess Engine s with Con ductor Sc ript 238 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 As indicated in the table, the engine unit partitio n has a startup argum ent which specifies that when the engine unit comes ONLINE, that it create the required tables in the engine database.
Manag in g iIS P roce ss En gine s wi th Co nduct or Sc ript Chapter 8 Using the Conductor Script Utility 239 The following Conductor Script commands start up the Enterprise engine in the preferred order.
Managi ng iIS Proc ess Engine s with Con ductor Sc ript 240 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 The Conductor Script commands used to monitor engines are documente.
Manag in g iIS P roce ss En gine s wi th Co nduct or Sc ript Chapter 8 Using the Conductor Script Utility 241 The Conductor Script commands used to monitor individual engine components are documented .
Managi ng iIS Proc ess Engine s with Con ductor Sc ript 242 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Changing Eng ine States You can change the state of an engine by changing th e state of an engine unit or by shutting down an engine component.
Manag ing Regis tra tion s wi th Co nduct or Sc ript Chapter 8 Using the Conductor Script Utility 243 Shut ting Down Eng ine Com ponen ts You can shut down an individual component or all engine components using the Shutdown command. This command shuts down the current component or engine.
Managi ng Regis trations w ith Conducto r Script 244 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 ➤ To make an iI S library di stributi on 1. Use the SetWorkspace command to make a particular workspace current. 2. Use the Open command to open the current workspace.
Manag ing Regis tra tion s wi th Co nduct or Sc ript Chapter 8 Using the Conductor Script Utility 245 AddSupplierPlan plan_name I nclud e a plan a s a supplier plan to the current plan. Commit —— Commit changes to current works pace. CompilePlan [force_flag] compile al l out-of-date componen ts in a plan.
Managi ng Regis trations w ith Conducto r Script 246 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Registerin g iIS Library Di stribut ions After iIS library distributions have been generated, they can be re gistered with iIS process engines.
Manag ing Regis tra tion s wi th Co nduct or Sc ript Chapter 8 Using the Conductor Script Utility 247 Unregisterin g iIS Li brary Distri butions Normally you un register an iIS distributio n from an engin e if it is no longer needed.
Managi ng Regis trations w ith Conducto r Script 248 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 ➤ To unregis ter an iI S distribution f rom an engine 1. Use the FindEngine command to make a particular engine current. 2.
Managi ng Process E xecution w ith Condu ctor Scrip t Chapter 8 Using the Conductor Script Utility 249 Managing Process Execution with Conductor Scr ipt This sec tion des cri bes how to per for m some ba sic m oni tori ng a nd man ageme nt of process execution using Conductor Script.
Managi ng Process E xecution w ith Conduc tor Script 250 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Monitorin g and Managin g Engine Sessions This section describes h ow .
Managi ng Process E xecution w ith Condu ctor Scrip t Chapter 8 Using the Conductor Script Utility 251 The commands needed to monitor and m anage iIS sessions are documented in Appendix A, “ Conduct.
Managi ng Process E xecution w ith Conduc tor Script 252 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Monitorin g and Managing Proces s Execution There are a number of situations where you are likely to want to monitor or intervene in pro cess execution to resolve problems .
Managi ng Process E xecution w ith Condu ctor Scrip t Chapter 8 Using the Conductor Script Utility 253 5. Use the ShowActivity command to display inform ation ab out a par ticula r act ivity . The output show s information ab out the activity, its a ttributes and its linked timers.
Managi ng Process E xecution w ith Conduc tor Script 254 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Managi ng T imers ➤ To check t he status of a t imer 1. Use the FindEngine command to make a particular engine current.
Managi ng Process E xecution w ith Condu ctor Scrip t Chapter 8 Using the Conductor Script Utility 255 ➤ To change the value of a process attri bute 1. Display a list o f attributes as described in Step 1 through Step 4 above. 2. Use the SetAttributeValue co mmand to set the value of any listed pro cess attrib ute.
Managi ng Process E xecution w ith Conduc tor Script 256 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 The commands needed to intervene in execution of an iIS process instan.
Managi ng Process E xecution w ith Condu ctor Scrip t Chapter 8 Using the Conductor Script Utility 257 ListFilters —— List a ll existin g event fi lters f or the curre nt e ngi ne.
Managi ng Process E xecution w ith Conduc tor Script 258 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Monitorin g and Managin g Two-Phase Co mmit Transac tions The iIS two-.
Managi ng Process E xecution w ith Condu ctor Scrip t Chapter 8 Using the Conductor Script Utility 259 Managi ng Two- Phase Commit Op eratio ns If a session should be su spended for any of a number of reasons, any iIS e ngine transaction in a PREPARE phase is retained on the sessio n, awaiting res olution (commit or rollback).
Managi ng Process E xecution w ith Conduc tor Script 260 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 ➤ To resolv e transact ions after a client or engine fa ilure 1. Start Conducto r Script from a command line an d invoke ListTransactions .
261 Appendix A Conducto r Script Commands This appendix is an alphabetically ordered referen ce of the Conductor Script commands. Conductor Script is a command line utility built on top of the iPlanet UDS Fscript command utility .
Conduct or Script Comma nd Summary 262 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Figur e A-1 Hierar chy of Conduc tor Sc ript L evels Each Conductor Script command is de fined on one of these levels.
Conduc tor Script Command Summar y Appen dix A Conducto r Script C ommands 263 Environment Mode Command s The Conductor Script environment mode commands work only in the active environment. They are used mostly to specify the current engine and current node, and also to make library distributions that can be registered with iIS process engines.
Conduct or Script Comma nd Summary 264 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Engine Mode Commands: Engine Mana gement The Conductor Script engine mode commands work only for the current engine. They are used mostly to start components and specify the current component.
Conduc tor Script Command Summar y Appen dix A Conducto r Script C ommands 265 FindNode node_name S et the spe cified n ode as the “ current ” nod e. Th e node must exist in the environme nt. page 285 FindPrimary —— Set th e primary engin e unit for t he curren t engine a s the cur rent component.
Conduct or Script Comma nd Summary 266 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Engine Mode Commands: Process Execution Mana gement There are a large number of Conducto.
Conduc tor Script Command Summar y Appen dix A Conducto r Script C ommands 267 Command Argument s Function See … AbortActivity process_id, activity_name Place the specified a ctivity in t he ABORTED stat e. page 273 AbortAllProcesses —— Abor t all process instance s in the current engine.
Conduct or Script Comma nd Summary 268 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 DelegateActivity process_id, activity_id state delegation_rule [user_name] [other_info] Delegate the specified offered activi ty (in th e specif ied st ate) to other users using the specified delegation a ssignment rule.
Conduc tor Script Command Summar y Appen dix A Conducto r Script C ommands 269 ReadyActivity process_id, activity_name Change the st ate of the s pecified activi ty from PEN DING to READY.
Conduct or Script Comma nd Summary 270 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 SetQueuedActivity Priority process_id, activity_id prioritizing_value Repr ioritize activiti es in an act ivity queue by setting t he prioritizing process attribute for a specified activity to a spec ified value.
Conduc tor Script Command Summar y Appen dix A Conducto r Script C ommands 271 Component Mode Command s The Conductor Script engine component mode commands work only for the current component. SuspendAllSessions —— Susp end all active ses sions in the current engine.
Conduct or Script Comma nd Summary 272 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Generi c componen t A few commands work for an y current component. Engin e Un it One command ap plies only if the current com ponent is an engi ne unit.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 273 Conductor Script Com mands The following is a listing of all Cond uctor Script commands. AbortActiv ity The AbortActivity command aborts the specifie d activity, placing it in the ABORTED s tate.
Conduct or Script Comma nds 274 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 AbortAllProcesses The AbortAllProcesses co mmand abort s all pr ocess ins tances f or the curren t engine. AbortAllProcesses The AbortAllProcesses com mand is only a vailable for the current en gine.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 275 BroadcastMessag e The BroadcastMessage command send s a message to all active se ssions on the current engine. BroadcastMessage message urgency The Broa dcastMessage command is only ava ilable when an engine is current.
Conduct or Script Comma nds 276 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 CompleteA ctivity The CompleteActivity command completes the specified activity, putting it in COMPLETED state. CompleteActivity process_id activity_n ame The Com pleteActivity command is only ava ilable when an engine is current.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 277 ConsultActivity process_id activity_id state consultation_rule return_rule [user_name1 [other_info1] [user_name2 [other_info2]]] The ConsultActivity command is only available when a n engine is current.
Conduct or Script Comma nds 278 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 The user_name1 a nd other_info1 argumen ts must be supplied if required by th e consultation assignment rule.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 279 CreateFil ter The CreateFilter command creates a filter for events posted on the curren t engine object. CreateFilter time_interval filter_expr ession The CreateFilter command is only a vailable when an engi ne is current.
Conduct or Script Comma nds 280 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Object Class Object Instance This element specifies a particular instance ide ntification, if desired — for example, a se ssi on name , ac tiv ity n ame, or pr ocess ID.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 281 Exam ples Some example filter expressions follow: When the CreateFilter command sets up the filter as specified, events that satisfy the filter expression are printed to the screen.
Conduct or Script Comma nds 282 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 The Del egateActivity command is only ava ilable when an engine is current.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 283 DeleteFilter The DeleteFilter command deletes the s pecified event filter in the current engine. DeleteFilter filter_id The DeleteFilter command is available only when an engine is current, so you must first use the FindEngine Script command to set the current engine.
Conduct or Script Comma nds 284 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 FindEng ine The FindEngine command sets th e specified engine as the current engin e. FindEngine engine_name The FindEngine command is always available.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 285 Find Node The FindNode command sets the specified node as the current node. FindNode node_name The FindNode command is avai lable only for the current engine.
Conduct or Script Comma nds 286 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 The FindPrimary command is normally used to check the status of the primary engine unit (using .
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 287 IIOPSe rver The IIOPServer command starts, stops, or displays info rmation about the IIOP service needed to support CORBA/IIOP iIS process client applications. IIOPServer [start|stop|show] The IIOPServer command is always availa ble.
Conduct or Script Comma nds 288 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 The ListActivityQueues command displays all a ctivity queues in a specif ied process definition. For each queue the ListActivityQueues comman d displays the process name and the queue name.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 289 ListEn gines The ListEngines command displays a list of all running an d configured engin es in the current environment. ListEngines The ListEngines command is always availa ble.
Conduct or Script Comma nds 290 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Options • If you use the short opti on, t he com mand dis plays a summa ry of proce ss instances by pro cess defini tion.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 291 ListSessio ns The ListSessions command displays all sessions ma intained by the current engine. ListSessions The ListSessions command is available only when an engine is current, so you must first use the FindEngine Script command to set the current engine.
Conduct or Script Comma nds 292 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 MakeConducto rDistribut ion The MakeConductorDistribution command generates a library distribution for the current plan. The plan must be crea ted in the iIS process development worksh ops.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 293 To start loggi ng, use the ’ + ’ followed by a set of message filte rs in parenthese s. To stop loggin g, use the ’ - ’ follo wed by a set of me ssage filt ers in parenthe ses.
Conduct or Script Comma nds 294 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 RegisterAl ias The RegisterAlias command register s the specified subpro cess alias in the current e ngine ’ s regist ration database. Fo r more informati on on aliases, see “ About Aliases ” on page 143 .
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 295 Use the ListConductorDistribution s Script command to dis play a list of distributions av ailable for registration (yo u can filter the list for as signment rule dictionaries).
Conduct or Script Comma nds 296 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 The RegisterUserProfile command is available only w hen an engine is current, so you must first use the FindEngine Script command to set the current engine.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 297 RemoveReadLock The RemoveReadLock command removes a read lock on the specif ied process attrib ute.
Conduct or Script Comma nds 298 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 RollbackActivi ty The RollbackActivity command changes the state of the specified a ctivity from ACTIVE to READY.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 299 RollbackTransaction { session_ID | tran saction_ID } To commit an in -progress iIS engine transaction , use the CommitTr ansaction command. To list all in -progress iIS engine transaction s for a given engine, use the ListTransactions comman d.
Conduct or Script Comma nds 300 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 SetAttributeValu e The SetAttribu teValue command sets a specified process attribu te in the current engine to a specified value.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 301 You can use the SetPassword Script comman d to se t a passwor d, change an existing password to a new password, or delete an existing password. SetPrimary The SetPrimary command sets th e specified engine unit for the current engin e as the primary uni t.
Conduct or Script Comma nds 302 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 The SetQueuedActivityPriority command is available on ly when an engine is current, so you must first use the FindEngine Script co mmand to set the current engine.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 303 The SetTimer command is ava ilable only when an engine is current, so you must first use the FindEngine Script command to set the current engin e.
Conduct or Script Comma nds 304 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 SetTimerElapse d The SetTimerElapsed command sets the specified elapsed timer to th e specified state (ON, O FF, or no cha nge) and sets a new el apsed time in terval until expira tion.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 305 The ShowActivity command displa ys the following in formation : • acti vity n ame • act ivity ID • process name • pro.
Conduct or Script Comma nds 306 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 The ShowActivityQueue comman d displays a list of activities in the queue, if any, or of sessions wa iting for a queued activity if no activities are in the queue.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 307 You can use the ListEngines Script comma nd to display a li st of engines in the environment before selecting the engine to display. ShowLogFlags The ShowLogFlags command displa ys the log messag e filters (log flags) f or the current component.
Conduct or Script Comma nds 308 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 • list of activities , displaying activity n ame, activity ID, process ID, activi ty state (a.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 309 • user • user ’ s role s • list of active attrib ute accessors You can use the ListSessions Script comm and to display a li st of sessions in the engine before selecting th e session to display.
Conduct or Script Comma nds 310 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 engine unit: (See also “ primary en gine unit : ” on pa ge 311 .
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 311 primary engi ne unit: • unit name • startup phase (if not ONLINE) • unit state: ONLINE or STANDBY • shell state: IDLE.
Conduct or Script Comma nds 312 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 ActiveActivities Number of current AC TIVE activities CurrentA ctivities Number of cu rrent a c.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 313 ShowTimer The ShowTimer command displays the properti es of the specified timer. ShowTimer process_id timer_name The ShowTimer command is available o nly when an eng ine is current, so you must first use the FindEngine Script command to set the current engin e.
Conduct or Script Comma nds 314 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Shutdown The Shutdown command shuts down the curre nt engine or one of its individual components. Shutdown The Shutdown command is availa ble only when the engin e is current or if an engine component is current.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 315 In the case of offered a nd queued activities, which are perfo rmed by client applicatio ns, the engine w ill assig n the ACTIVE act ivity to th e session specif ied by the session_id parameter.
Conduct or Script Comma nds 316 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 The StartEngine comm and incl udes a n umber o f start op tions th at creat e new engine databa.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 317 The StartGovernor command reads the memory flag setting for governor specified in the engine con figuration file (see “ Engine Co nfigurat ion File ” on page 90 and Step 10 under “ How to Confi gure a New Engine ” on page 95 ).
Conduct or Script Comma nds 318 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 The StartUnit command includes the f ollowing star t options that create new engine database ta.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 319 StopTimer The StopTimer command changes the state of th e specified timer from ON to OFF. StopTimer process_id timer_name The StopTimer command is available o nly when an eng ine is current, so you must first use the FindEngine Script command to set the current engin e.
Conduct or Script Comma nds 320 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 SuspendSession The SuspendSession command suspends the s pecified active session, or sessions, in the current engine.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 321 The engine posts a Ses sionTerminated event on each session before it is terminated, so that the respective client applications can take appro priate action. The effect of terminating a sessio n on any ACTIVE activiti es is to place the activities back in READ Y state.
Conduct or Script Comma nds 322 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 The Uninstall command is a lways available. The Uninstall command is normally performed to cle an up the environment repository after unregi stering an iIS distribut ion from all engines in a n environment.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 323 The UnRegisterAssignmentRules command is available on ly when an engine is current, so you must first use the FindEngine Script command to set the current engine.
Conduct or Script Comma nds 324 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 UnRegisterUserProf ile The UnRegisterUserProfile command deletes the specified user profile from the current engine ’ s registration da tabase.
Cond ucto r Scr ipt C omm ands Appen dix A Conducto r Script C ommands 325 The WaitForStartup command is avai lable only when an engine is current, so you must first use th e FindEngine S cript command to set the current engin e. In a script, the WaitForStartu p command is used after a Start Unit Script command.
Conduct or Script Comma nds 326 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1.
327 Appendix B Engine Database Schema This appendix documents the engine database schema. It lists the data base tables and the specificatio n of each, according to th e following categori es: • cur.
Dat abase Tabl es by Cate gory 328 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 WFHPro cParamet ers WFHTerminatedProcs WFHTermProcPa ras WFHA ctiv ity WF HActi vityL og* WF.
Alphab etical Listi ng of Tabl es Appen dix B Engin e Database Schema 329 Alphabet ical Listin g of Tables The following is an alphabetical list of all tables created in the engine data base, with a page reference to deta ils about each.
Alphabet ical Lis ting of Tab les 330 iPlan et Integra tion Serv er • Process System Gu ide • August 2001 WFHControl page 337 System maintain ed table o f sequence values for producing u nique ID s for proces s, sessi on, and timer in stances . WFHLocks page 337 The type of access h eld on all i nstances of process attr ibutes.
Database S chema Ref erence Appen dix B Engin e Database Schema 331 Database Schem a Refere nce This section provides an annotated description of all the ta bles created and maintained by a n iIS process engine.
Database S chema Ref erence 332 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Current Stat e Tables The following is an alphabetica l list of all current state ta bles in the engine database. Indexes to tables are indicated by a checkma rk ( ✔ ) in the Index column.
Database S chema Ref erence Appen dix B Engin e Database Schema 333 TYPE NUMBER(38) Type of activity: 1 – F irst acti vity 2 – Last act ivity 3 – O ffered activ ity 4 – Su bproc ess act ivity 5 – Automatic activi ty 6 – Queu ed ac tivi ty 7 – Junction ac tivity Note: The se consta nt values a re intern al to the en gine on ly.
Database S chema Ref erence 334 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 ACTN AME VAR CHA R2(6 4) The na me o f the act ivity in the p roce ss definition. ABORTRACTION NU MBER(38) A bort routing information. Internal use only.
Database S chema Ref erence Appen dix B Engin e Database Schema 335 Ta b l e B - 4 WFHActivityTokens Name Index Nu ll? Type Description PROCESSID ✔ NOT NULL NUMBER(38) Unique identif ier for the process insta nce in whic h this a ctivit y instan ce occur s.
Database S chema Ref erence 336 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Ta b l e B - 6 WFHAssign ment Name Index Nu ll? Type Description PROCESSID ✔ NOT NULL NUMBER(38) Unique identif ier for the process inst ance in whic h this a ctivit y instan ce occur s.
Database S chema Ref erence Appen dix B Engin e Database Schema 337 Ta b l e B - 8 WFHComplexRule Name Index Nu ll? Type Description PROCESSID ✔ NUMBER(3 8) Unique identifier for the process instance in whic h this a ctivit y instan ce occur s.
Database S chema Ref erence 338 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 LOCKTYPE NUMBER(38) Type of access to t he process attribute: 1 – WFAttributeAcces sor.READ 2 – WFAttributeAcces sor.READQ 3 – WFAttributeAccessor.
Database S chema Ref erence Appen dix B Engin e Database Schema 339 Ta b l e B - 1 2 WFHProcess Name Index Nu ll? Type Description ID ✔ NOT NULL NUMBER(38) Unique identif ier for the process insta nce in this engi ne.
Database S chema Ref erence 340 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 NEXTACTIVITYID NUMBER(38) S equence for t he next activity i nstance within t his pr ocess inst ance. INTERNALNAME VARCHAR2(138) Internal use only.
Database S chema Ref erence Appen dix B Engin e Database Schema 341 Ta b l e B - 1 3 WFHPro cParamet ers Name Index Nu ll? Type Description PROCESSID ✔ NOT NULL NUMBER(38) The P ROCESSID of a synchronous subproc ess that has an output parameter.
Database S chema Ref erence 342 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Ta b l e B - 1 6 WFHRetryInfo Name Index Nu ll? Type Description GROUPID ✔ NOT NULL NUMBER(38) Identifier for the s ession between the engine and clien t.
Database S chema Ref erence Appen dix B Engin e Database Schema 343 Ta b l e B - 1 8 WFHSessAttributes Name Index Nu ll? Type Description SESSIONID ✔ NOT NULL NUMBER(38) Identifier for the s ession between the engine and clien t application. ATTNAME NOT NULL VARCHA R2(6 4) Name of a pro cess attrib ute in the session.
Database S chema Ref erence 344 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Ta b l e B - 2 0 WFHSessionRol e Name Index Nu ll? Type Description SESSIONID NOT NULL NUMBER(38) Unique identifier for the client session . Joins to WF HSESSION.
Database S chema Ref erence Appen dix B Engin e Database Schema 345 Ta b l e B - 2 2 WFHTermProcPa ras Name Index Nu ll? Type Description COMBINEDID ✔ NOT NULL VARCHAR2(158) Internal u se only. ATTNAME VARCHAR2 (64) Th e name of the attribute that must be returned to the callin g process (an outpu t pa rame ter ).
Database S chema Ref erence 346 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Registrati on Tables This section contains an alphabetical list of all registration tables in the engine database. For a de scription of each of these tables, refer to Table B- 1 on page 329 .
Database S chema Ref erence Appen dix B Engin e Database Schema 347 History Log Tabl es The following is an alphabetica l list of all his tory log tables in the engin e database. “ State Values ” on page 35 7 lists the possible values for the State f ield present in many of the history log tables.
Database S chema Ref erence 348 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Ta b l e B - 2 6 WFH Activ ity Log Name Index Nu ll? Type Description ID NUMBER(38) Unique identifier for this activ ity instance w ithin the pr ocess inst ance in which i t occu rs.
Database S chema Ref erence Appen dix B Engin e Database Schema 349 SESSIO NID NUMBER( 38) ID of the sessio n that owns this a ctivit y (if the activity is ACTIVE). LOGTIME DATE Time of th is logg ing. Ta b l e B - 2 8 WFHAlarmLog Name Index Nu ll? Type Description ALARMTYPE VARCHAR2( 64) The type of the alarm.
Database S chema Ref erence 350 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Ta b l e B - 3 0 WFHAttribLockLog Name Index Nu ll? Type Description PROCESSID NUMBER(38) Unique identif ier for the process inst ance in whic h this pro cess attrib ute occur s.
Database S chema Ref erence Appen dix B Engin e Database Schema 351 Ta b l e B - 3 2 WFHPerformanceLog Name Index Nu ll? Type Description SAMPLETIME NOT NULL DATE Date time stamp for the sample. RESPONSETIME NOT NULL NUMBER(38) Average engine re sponse ti me to requests by a client application.
Database S chema Ref erence 352 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 ACTIVEPAGE NOT NULL NUMBER(38) The number of active memory pages for the engine. ALLOCATEPAGE NOT NULL NUMBER(38) The number of allocated memory pages for the engine.
Database S chema Ref erence Appen dix B Engin e Database Schema 353 Ta b l e B - 3 4 WFHProcessLog Name Index Nu ll? Type Description ID NUMBER(3 8) Unique identifier for the process instance in this engi ne. PROCNAME VARCHAR2(64) The name of the process definition of which t his proces s is a n instan ce.
Database S chema Ref erence 354 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Ta b l e B - 3 5 WFHP roce ssSta teLog Name Index Nu ll? Type Description ID NUMBER(3 8) Unique identifier for the process instance in this engi ne.
Database S chema Ref erence Appen dix B Engin e Database Schema 355 STATE NUMBER(38) Effect of this re gistration action: 1 – Registered -1 – Unregist ered LOGTIME DATE Time of th is logg ing. Ta b l e B - 3 7 WFHSessionL og Name Index Nu ll? Type Description ID NUMBER(38) Unique identifier for the cli ent session.
Database S chema Ref erence 356 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 Ta b l e B - 3 9 WFHTimerStateLog Name Index Nu ll? Type Description ID NUMBER(38) Unique identifier for the timer in stance within t his en gine.
Database S chema Ref erence Appen dix B Engin e Database Schema 357 State Values Many of the histor y log tables listed in this section have a field that represents the state of a given engine object: pro cess instance, activity, session, and timer.
Database S chema Ref erence 358 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1.
359 Index A AbortActivi ty command, Conductor Sc ript 273 AbortAl lProcesses com mand, Conduc tor Script 274 ABORTED activi ty stat e 163 , 199 , 357 process i nstanc e state 173 , 19 8 , 357 abort in.
Section B 360 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 B backup eng ine unit defined 33 partitionin g guidelines 86 BOTH govern or state 106 BroadcastMessage command, C.
Secti on D Index 361 Condu ctor Sc ript com mand (continued) ShowAc tivityQueu e 305 Sho wConf igurat ion 306 ShowE ngine 306 ShowLogFla gs 307 ShowProcess 307 ShowSess ion 308 ShowStat us 309 ShowTim.
Section E 362 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 engine (c ontinued) reconfig uration 113 recov ery 34 , 166 regi strati on ma nager 142 relation to iIS proc ess .
Section F Index 363 exception alarm 205 exception s, logged 210 execution options 103 Exit com mand, iIS Con sole 71 EXPIRED timer state 199 , 357 F failover, en gine unit 33 failure engine 34 , 159 e.
Section L 364 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 install ation central server 57 development client node 59 engine se rver n ode 58 runt ime cli ent nod e 60 inst.
Section Q Index 365 performance chart 221 , 22 4 performance indica tors 222 performance, engi ne 89 , 116 ping int erval, se ssion 15 9 PREPARE st ate (tw o-phase comm it) 201 primary en gine uni t, .
Section S 366 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 RegisterAlias command, Cond uctor Script 294 RegisterAssi gnmentRule s comman d, Conductor Script 29 4 regi steri.
Section T Index 367 ShowE ngine comm and, C onducto r Script 306 ShowLogFla gs command, Conductor Script 307 ShowProcess command, Conductor Script 30 7 ShowSess ion command, Conductor Scr ipt 308 Show.
Section U 368 iPlan et Integra tion Serv er • Process System Gu ide • August 200 1 U UDS runtime environment 44 Uninstall command, Conductor Script 32 1 uninst alling iI S 64 UnRegiste rAlias c om.
Un punto importante, dopo l’acquisto del dispositivo (o anche prima di acquisto) è quello di leggere il manuale. Dobbiamo farlo per diversi motivi semplici:
Se non hai ancora comprato il Sun Microsystems 3 è un buon momento per familiarizzare con i dati di base del prodotto. Prime consultare le pagine iniziali del manuale d’uso, che si trova al di sopra. Dovresti trovare lì i dati tecnici più importanti del Sun Microsystems 3 - in questo modo è possibile verificare se l’apparecchio soddisfa le tue esigenze. Esplorando le pagine segenti del manuali d’uso Sun Microsystems 3 imparerai tutte le caratteristiche del prodotto e le informazioni sul suo funzionamento. Le informazioni sul Sun Microsystems 3 ti aiuteranno sicuramente a prendere una decisione relativa all’acquisto.
In una situazione in cui hai già il Sun Microsystems 3, ma non hai ancora letto il manuale d’uso, dovresti farlo per le ragioni sopra descritte. Saprai quindi se hai correttamente usato le funzioni disponibili, e se hai commesso errori che possono ridurre la durata di vita del Sun Microsystems 3.
Tuttavia, uno dei ruoli più importanti per l’utente svolti dal manuale d’uso è quello di aiutare a risolvere i problemi con il Sun Microsystems 3. Quasi sempre, ci troverai Troubleshooting, cioè i guasti più frequenti e malfunzionamenti del dispositivo Sun Microsystems 3 insieme con le istruzioni su come risolverli. Anche se non si riesci a risolvere il problema, il manuale d’uso ti mostrerà il percorso di ulteriori procedimenti – il contatto con il centro servizio clienti o il servizio più vicino.
