background image

19

Preface

The iIS Process System Guide describes how to manage a process system, 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 management tasks.

This preface contains the following sections:

“Product Name Change” on page 19

“Audience for This Guide” on page 20

“Organization of This Guide” on page 20

“Text Conventions” on page 21

“Other Documentation Resources” on page 22

“iIS Example Programs” on page 24

“Viewing and Searching PDF Files” on page 24

Product Name Change

Forte Fusion has been renamed the iPlanet Integration Server. You will see full 
references to the new name, as well as the abbreviation iIS.

Summary of Contents for iPlanet Integration Server 3.0

Page 1: ...Process System Guide iPlanet Integration Server Version3 0 August 2001...

Page 2: ...oad Palo Alto California 94303 Etats Unis Tous droits r serv s Sun Microsystems Inc a les droits de propri t intellectuels relatants la technologie incorpor e dans le produit qui est d crit dans ce do...

Page 3: ...g PDF Files 24 Chapter 1 Introduction iIS Process Management 27 What Is an iIS Process Engine 27 Multiple Engine Systems 29 iIS Process Engine Components 31 Minimal Engine Configuration 31 Failover Co...

Page 4: ...m Software 47 Compiled and Interpreted Engine Components 50 iIS Process System Configuration 51 Setting Up an iIS Process System 55 iIS Process System Setup Procedure 55 The iIS Installation Program 5...

Page 5: ...nsole Main Window Command Summary 78 Environment Menu 78 View Menu 79 Engine Menu 79 Monitor Menu 80 Help Menu 81 Chapter 4 Managing Engines 83 Production Engines Versus Development Engines 83 Configu...

Page 6: ...atabase 125 Recovering Data 125 Dumping and Restoring Data 126 Dumping Database Tables 126 Restoring Database Tables 131 Dump Restore Environment Variables 136 Chapter 5 Managing Registrations 137 Abo...

Page 7: ...oadcasting Messages to Sessions 177 Monitoring and Managing Process Execution 179 Managing Process Instances 181 Checking the Status of a Process Instance 181 Aborting a Process Instance 184 Managing...

Page 8: ...ter Window 217 Engine Event Types 218 Using the iIS Console Engine Event Filter Window 218 Displaying All Engine Events 219 Displaying Process Instance Events 219 Filtering Engine Events 221 Performan...

Page 9: ...ging Process Instances 252 Managing Activity Instances 252 Managing Activity Queues 253 Managing Timers 254 Managing Process Attributes 254 Checking for Bottlenecks in Process Execution 255 Monitoring...

Page 10: ...FindParentEngine 285 FindPrimary 285 FindUnit 286 FlushLog 286 IIOPServer 287 ListActivities 287 ListActivityQueues 287 ListConductorDistributions 288 ListEngines 289 ListFilters 289 ListProcesses 28...

Page 11: ...wActivityQueue 305 ShowConfiguration 306 ShowEngine 306 ShowLogFlags 307 ShowProcess 307 ShowSession 308 ShowStatus 309 ShowTimer 313 Shutdown 314 StartActivity 314 StartDBService 315 StartEngine 315...

Page 12: ...de August 2001 Appendix B Engine Database Schema 327 Database Tables by Category 327 Alphabetical Listing of Tables 329 Database Schema Reference 331 Current State Tables 332 Registration Tables 346 H...

Page 13: ...ain Window 69 Figure 3 2 iIS Console Browser 77 Figure 4 1 Engine Configuration with both Failover and Load Balancing 86 Figure 4 2 Typical Engine Partitioning Scheme 88 Figure 5 1 Registration Steps...

Page 14: ...14 iPlanet Integration Server Process System Guide August 2001...

Page 15: ...or iIS Console 71 To turn automatic refresh off or on 72 To set the automatic refresh interval 73 To force an immediate refresh 73 To configure a new engine 96 To duplicate an engine configuration 104...

Page 16: ...st a message to all sessions 179 To check the current execution status of a process instance 181 To abort a process instance 184 To change the state of an activity 187 To view the contents of an activ...

Page 17: ...ange the state of an engine unit 242 To make an iIS library distribution 244 To register an iIS distribution with an engine 246 To unregister an iIS distribution from an engine 248 To obtain state inf...

Page 18: ...18 iPlanet Integration Server Process System Guide August 2001...

Page 19: ...m management tasks This preface contains the following sections Product Name Change on page 19 Audience for This Guide on page 20 Organization of This Guide on page 20 Text Conventions on page 21 Othe...

Page 20: ...e briefly describes the contents of each chapter Chapter Description Chapter 1 Introduction iIS Process Management Provides a brief introduction to the iIS process engine and process system management...

Page 21: ...ignate a document title for emphasis or for a word or phrase being introduced monospace Monospace text represents example code commands that you enter on the command line directory file or path names...

Page 22: ...tml The titles of the iIS documentation are listed in the following section Format Description parentheses Parentheses enclose a parameter list comma Commas separate items in a parameter list vertical...

Page 23: ...lp When you are using an iIS development application press the F1 key or use the Help menu to display online help The help files are also available at the following location in your iIS distribution F...

Page 24: ...e has its own sub directory which contains a README file that explains how to install and run the example Viewing and Searching PDF Files You can view and search iIS documentation PDF files directly f...

Page 25: ...Find Results Containing Text field of the Adobe Acrobat Search dialog box and click Search A Search Results window displays the documents that contain the desired text If more than one document from t...

Page 26: ...rough the search results as shown in the following table To return to the iisdoc pdf file click the Homepage bookmark at the top of the bookmarks list 6 To revisit the query results click the Results...

Page 27: ...elopment Guide The engine controls and manages business processes from beginning to end coordinating the work of the different resources that perform the activities defined in each process instance At...

Page 28: ...has been completed For information on client applications see the iIS Process Client Programming Guide For information about proxies see the iIS Backbone System Guide The relationship of the engine t...

Page 29: ...engine operates independently A single instance of a process definition executes on only one engine In most cases different process definitions would be executed on different engines For example one p...

Page 30: ...e 1 1 An iIS Process Management System Engine Database Central Development Repository Application Services Organization Database Process Engines Registration System Management Tools Process Develpment...

Page 31: ...ibility to handle increasing loads An iIS engine generally consists of the following application components two engine units an engine governor a number of database access services An iIS engine also...

Page 32: ...to the engine database described below Database Service The database service is an application that manages the engine unit s database access The database service is a single iPlanet UDS server parti...

Page 33: ...added to the iIS process engine configuration as illustrated in Figure 1 3 Figure 1 3 Engine Configuration with Failover Backup Engine Unit The backup engine unit a replicate of the engine unit parti...

Page 34: ...t remains open the governor assumes the primary engine unit is still online However if neither the governor nor backup engine unit can communicate with the primary engine unit the governor assumes the...

Page 35: ...service components which may be running on different nodes using a database service router in the primary engine unit Each service is assigned a unique name and allocated a priority depending perhaps...

Page 36: ...ionaries user profiles and a validation constitute the process logic components executed by the engine during process execution Registration lets you change these components dynamically as business pr...

Page 37: ...initions managing process execution Each of these categories is discussed briefly below and treated in detail in the corresponding chapter of this system management guide Setting up and Maintaining an...

Page 38: ...on execution in a production environment Before installing iIS process system software you must first determine which nodes in your iPlanet UDS environment are used for each of these purposes and to i...

Page 39: ...ionaries and a user profile These software components need to be registered with the engine so they can be dynamically loaded by the engine and used in process execution As a system manager you have t...

Page 40: ...s command line counterpart Conductor Script These tools provide an interface to system management agents in the iPlanet UDS runtime environment and in the iIS process engine for managing engines and p...

Page 41: ...ilized by the iIS Console and the Conductor Script utility These custom tools allow you to automate regular system management tasks or respond automatically to particular state conditions in an engine...

Page 42: ...iIS Process Management Tools 42 iPlanet Integration Server Process System Guide August 2001...

Page 43: ...nd then installing the appropriate iIS software on each of these nodes Since iIS runs on top of a functioning iPlanet UDS environment you may have to set up an iPlanet UDS environment before setting u...

Page 44: ...an iPlanet UDS environment is to make sure that the physical environment hardware and software meets iPlanet UDS system requirements For more information on these requirements see the iPlanet UDS Syst...

Page 45: ...system includes one or more iIS process engines which are accessed by a number of iIS process client applications An engine controls and manages the flow of business processes coordinating the work o...

Page 46: ...development workshops and system management tools Some must be developed on site and require iIS system software process definitions and iIS process client applications Others must be developed on sit...

Page 47: ...Figure 2 1 on page 46 These modules organized by functional category are described in the following table The table also indicates which system software modules are marked for use as compiled partitio...

Page 48: ...ary distribution that provides the API for process client applications written in the iPlanet UDS TOOL language Needed in client application development repository on TOOL client application developme...

Page 49: ...ails see Chapter 8 Using the Conductor Script Utility WFDrWind Engine Database Dump Restore application A graphical user interface application used for dumping engine database tables to a file and for...

Page 50: ...accessing iIS process engines and performing registration of process definitions Needed on all nodes WFEnvAgent compiled System An application that supports generation and deployment of library distri...

Page 51: ...ure 2 1 on page 46 In particular you must decide which node or nodes in your environment support the following functions running iIS process engine components developing process definitions developing...

Page 52: ...ger to manage an iIS process system Runtime client A node that runs an iIS process client application but which cannot be used for development While conceptually it is easier to think of each of these...

Page 53: ...that supports an engine You select which components to start on any node when you configure each engine see Configuring an Engine on page 85 Enterprise Database Client Application Development System...

Page 54: ...evelopment repository You might want iIS developers to use an existing iPlanet UDS repository or you might prefer to create one or more central development repositories for exclusive use by iIS develo...

Page 55: ...ou do not already have one at your site See Preparation Setting up an iPlanet UDS Runtime Environment on page 44 iIS Process System Setup Procedure The following general procedure should be followed i...

Page 56: ...The setup procedure described in the previous section makes extensive use of the iIS installation program The iIS installation program has four main installation options central server node engine se...

Page 57: ...ansfers iIS repository files to node WFSeed btx WFSeed btd install respos cpy Creates iIS repository server repos Installs engine components WFEngineUnit WFGovernor WFDatabaseSvc userapp Installs proc...

Page 58: ...poscpy Installs engine components WFEngineUnit WFGovernor WFDatabaseSvc userapp Installs process development libraries WFLibrary WFModel WFAccessServiceObj userapp Installs iIS TOOL client development...

Page 59: ...ble Operation Software Module FORTE_ROOT directory Transfers iIS repository files to node WFSeed btx WFSeed btd install resposcpy Installs process development libraries WFLibrary WFModel WFAccessServi...

Page 60: ...ating process definitions and client application developers can begin writing iIS client applications However before long it will be necessary to have a test engine running in your environment Configu...

Page 61: ...t it from time to time see the iPlanet UDS System Management Guide for more information Also the engine database must be monitored to make sure you do not run out of disk space Other maintenance tasks...

Page 62: ...r 1 Decide which node is to host the new repository server 2 Run the iIS installation program and choose the Engine Server option 3 Choose Custom Installation 4 Check Create iIS Repository and clear a...

Page 63: ...ndalone system icons that start iIS Set the fr flag in the icon s command line to reference the new private repository For more information refer to instructions about starting the process development...

Page 64: ...s removing the various iIS system software components from the various nodes on which they have been installed The components application partitions and libraries are installed in a standard iPlanet U...

Page 65: ...ollowing topics overview of the iIS Console starting the iIS Console using the iIS Console window navigating to other iIS Console windows summary of menu commands Overview The iIS Console is the main...

Page 66: ...when necessary You can monitor engine sessions and send messages to client applications and you can monitor the engine s execution of individual processes monitor alarms and diagnostic messages You ca...

Page 67: ...information 2 Enter a valid password if one is requested see Setting Password Protection for iIS Console on page 71 When the iIS Console starts it opens the iIS Console main window shown in Figure 3 1...

Page 68: ...ord protected access to iIS Console The iIS Console main window consists of two areas the main viewing panel and the menu bar Flag Description fl log_flags LOGGER log_flags Specifies the log flags to...

Page 69: ...ou perform using the iIS Console are initiated by first selecting an engine from the main viewing panel and then selecting the desired operation from the appropriate menu Off Engine is configured but...

Page 70: ...tions and shutting down an iIS engine Monitor menu Provides commands for monitoring and managing processes being executed by an iIS engine verifying registrations and charting performance Help menu Pr...

Page 71: ...nment Console in your active environment without using the password To set a password for iIS Console 1 Choose Environment Set Password The Enter Password window displays 2 Enter a password and then e...

Page 72: ...onfigured specifically for left handed use the right most button The iIS Console also uses the right most button to present popup menu commands as an alternative to using the menu bar The popup menu c...

Page 73: ...ovide lists you can filter using commands available on the View menu and in the right mouse button popup menu This section describes techniques used to perform these filtering operations For example s...

Page 74: ...he logical operators are listed in the following table Specifying Values In a filter expression you specify the value of an object s state or status These are expressed as case sensitive string values...

Page 75: ...S Console 75 Example Filter Expression In the session list example suppose you enter the following expression in the Filter window Activity READY Activity ACTIVE Activity COMPLETED Activity ABORTED Ti...

Page 76: ...instances by name version primary attribute value primary attribute name ID or creation time 1 From the Monitor menu select the type of information you want to sort For example if you want to sort pro...

Page 77: ...information successively indented from left to right To select an element in a list view you click it To open an element to get a list of sub elements you double click the element then either press E...

Page 78: ...validations and user profiles with one or more engines page 144 Aliases Provides submenus for registering and unregistering aliases with one or more engines Aliases are used in specifying subprocess...

Page 79: ...econfigure Opens an engine configuration window for the selected engine in which you can modify the component partitioning and startup properties as specified in the engine configuration file page 113...

Page 80: ...ected engine You can monitor and manage sessions from this window page 173 Processes Summary Opens the processes summary window which displays the list of all process definitions for the selected engi...

Page 81: ...s assignment rules user profiles user validation and aliases currently registered with the selected engine This window can be the launch point for monitoring and managing execution of processes regist...

Page 82: ...iIS Console Main Window Command Summary 82 iPlanet Integration Server Process System Guide August 2001...

Page 83: ...onments can differ significantly for use in development environments In a development environment the engine is used principally for testing and debugging purposes while in a production environment th...

Page 84: ...service is normally adequate Historical process execution information is needed to analyze and improve system performance logging of historical state information is normally turned on Current process...

Page 85: ...nts engine units governor and database services see Chapter 1 Introduction iIS Process Management For each engine to function independently its components must each be identified with the engine and h...

Page 86: ...e these factors vary from site to site only some very general guidelines are discussed here Primary Engine Unit It is recommended that you assign the primary engine unit to a fast reliable server node...

Page 87: ...s illustration the database services on Server4 are used in a round robin fashion unless the load on the engine is too heavy for them to carry it In that case the database service on Server1 is used T...

Page 88: ...start an engine you must specify a number of startup properties These properties are stored in the engine configuration file The startup properties are the following Clients Server 3 Backup Engine Un...

Page 89: ...atabase services and engine units Included here is also a setting to limit the number of console monitor windows that can be open at any time Stack Size These settings specify the memory size of each...

Page 90: ...r4 UNITS Server1 Primero P Server3 Secundo B DBSERVICES Server2 DBService1 10 Server4 DBService2 9 DATABASE_TYPE ORACLE DATABASE_NAME oracle_Server2 DATABASE_USER_NAME wftester DATABASE_USER_PASSWORD...

Page 91: ...base service specifies the node on which the service runs service name and priority integer positive or negative String contains entries separated by commas in the form NODE_NAME SERVICE_NAME PRIORITY...

Page 92: ...URSOR_SIZE string Specifies number of process instances to be recovered at one time in the event of engine unit failure DATABASE_PROC_SEGMENT_SIZE integer Specifies segment size for storing text based...

Page 93: ...are open affects the performance of the engine UNIT_SESSION_RECONNECT_LIMIT integer During engine recovery specifies the time in milliseconds that an engine waits for clients to reconnect to a sessio...

Page 94: ...ne database If you want to modify the default schema before performing a cold start on an engine edit this file according to your needs Path Element Description environment Name of the iPlanet UDS env...

Page 95: ...place it in the proper directory location on your central server node You can also create a new configuration file by directly entering the information in Engine Configuration File on page 90 into the...

Page 96: ...1 To configure a new engine 1 Choose Engine New The Configure New Engine window displays 2 Enter a name for the new engine in the Engine name field The name can be case sensitive and of any length but...

Page 97: ...length for process attributes and user profile information for a session 5 Click the Logging tab to display the logging properties dialog Property Description Process attribute segment size Specifies...

Page 98: ...he Current state option History log This setting determines which information if any the engine logs about each state change in sessions processes and process components to the history log tables see...

Page 99: ...es not accept a name or priority indicated by N A in the table Engine Unit You can specify one or two engine units in your configuration to provide failover you need two units a primary and a backup F...

Page 100: ...must be placed on the node where your database manager resides unless your database system provides network access to the database such as ORACLE s SQL Net If your database system provides network acc...

Page 101: ...n number memory_option number Do not include any spaces For example n 4096 x 16384 specifies both maximum and minimum sizes of the iPlanet UDS memory heap The n and x memory options are described in t...

Page 102: ...rows are accessed from the engine database Lowering the number of instances by lowering the cursor size reduces the amount of memory needed for recovery the trade off is a slower recovery If your res...

Page 103: ...guration file The engine configuration file is saved to a standard location on the central server see Engine Configuration File on page 90 Process Execution Option Description Maximum number of sessio...

Page 104: ...Engine Duplicate 3 Enter a new name for the duplicate engine The name can be case sensitive and of any length but have no spaces The duplicate engine shows up in the engine list in the iIS Console mai...

Page 105: ...aracteristics are discussed in more detail below This background information is followed by instructions on how to start the engine using the iIS Console For information on starting engines using Cond...

Page 106: ...it starts it attempts to connect to both the governor and its partner engine It waits for a timeout period and exits if no connection is forthcoming If the engine configuration file specifies no engin...

Page 107: ...whether it is designated as the primary or backup engine unit The STANDBY state is assumed immediately upon startup however the ONLINE state is achieved only after the engine unit has passed through...

Page 108: ...CREATE_ENGINE Instantiates an engine object 52 ATTACH_HISTORY_MANAGER Beginning of the database logon phase 53 INIT_HISTORY_DB Database logon phase in which a router is created and registered with the...

Page 109: ...ty It is suggested that you decide on a sensible set of priorities A default priority of 1 is used if you do not specify a priority When a database service starts it may or may not establish a communi...

Page 110: ...ocation using the iIS Console see Chapter 3 The iIS Console The iIS Console uses iPlanet UDS system management agents to start the partitions corresponding to each of the engine components as specifie...

Page 111: ...e cold option will cause deletion of the existing engine database before creation of a new one all current state information registration and history log data will be lost newLog New history log datab...

Page 112: ...which you are running iIS Console Once an engine component has come online you can access the log file directly from within iIS Console as described in Engine Log Files on page 210 To start individual...

Page 113: ...accommodate changing load on an engine or component failure For example if the load on your engine increases you might have to start up additional database services or if a primary engine unit fails s...

Page 114: ...e Reconfigure Engine window displays 3 Select the appropriate tab to modify the property or properties you want to change 4 When you have finished reconfiguring your engine click Save The modified inf...

Page 115: ...e to restart the engine To modify database logging for an engine 1 Select an engine in the iIS Console main window 2 Choose Engine Logging The Logging window displays 3 Enable or disable the database...

Page 116: ...s that the engine supports While this can keep process execution within resource limits it also limits the load that an engine can support A more sophisticated approach is to use the engine s advanced...

Page 117: ...cordance with the memory required by executing process instances which depends on their complexity the available memory resources and the value of the Swap out Interval Despite the difficulty of deter...

Page 118: ...ent in the iIS Console see Chapter 3 The iIS Console iIS Console uses iPlanet UDS system management agents to gather data from engine components Each agent has a set of instruments that report relevan...

Page 119: ...individual engine components in the Engine Status window Selecting an engine component in this window provides more information about the functional status of a component than is displayed in the Engi...

Page 120: ...ernor is open or closed partner channel state whether the communication channel to the partner engine unit is open or closed engine unit state whether the engine is in ONLINE or STANDBY state or offli...

Page 121: ...t memory heap currently used by the engine unit partition allocated memory the amount of active memory currently allocated to objects created by the engine unit partition peak allocated memory the amo...

Page 122: ...so you can make its partner primary When an engine goes back to ONLINE from STANDBY it recovers state information from the database To change the state of an engine unit 1 Select a running engine in...

Page 123: ...fies how much state information about a process instance is stored persistently in the engine database The less state information stored in the database the higher the level of engine performance in e...

Page 124: ...information on all sessions process instances activities process attributes timers and so on Registration These tables maintain state information about all library distributions and aliases see About...

Page 125: ...ive history log database When rows in your history log tables are sufficiently aged you can delete them from the engine database and transfer them to an archive database For example if your system doe...

Page 126: ...m to another To dump or restore data for a particular engine database the following conditions must be met The iPlanet UDS Environment Manager must be running The engine and database must have been co...

Page 127: ...he Dump Restore application To use the Dump Restore application to dump database tables 1 Start the Dump Restore application on Windows or Windows NT double click the Dump Restore icon on UNIX OpenVMS...

Page 128: ...mp the data a Click the Configure Files tab b In the Directory name field specify the directory into which the data file will be written The directory must already exist the Dump Restore application w...

Page 129: ...n the Engine name field enter the name of the engine whose data you want to dump When you exit the field the Database type Database name User name and User password fields will automatically be filled...

Page 130: ...tton d Click OK in the Information dialog that is displayed While the dump is in progress the status bar at the bottom of the window displays a Dumping Tables message When the dump is complete the sta...

Page 131: ...correspond to the engine database schema You can use either the Dump Restore application or its command line equivalent Flag Description e engine_name The name of the iIS engine in the current environ...

Page 132: ...ollows a Navigate to FORTE_ROOT sysdata conductr cln envname engine dbs envname is the name of your environment engine is the name of your process engine b Rename engine dbs to engine old 2 Start CCon...

Page 133: ...k on the Configure Files tab b In the Directory Name field specify the directory in which the data file is to be found c In the Data File Name field enter the name of the data file d Click the Set Con...

Page 134: ...ab b Select the categories of tables you want to restore By default all categories are selected Disable any category you do not want to restore c Click the Restore Tables button d Click OK in the Info...

Page 135: ...t the environment variables described in Dump Restore Environment Variables on page 136 then you do not need to supply values for the command line flags Flag Description e engine_name The name of the...

Page 136: ...utility Variable Description WFDR_ENGINE The name of the iIS engine WFDR_DIRECTORY The directory in which to place the dump files The default value is the directory in which the application resides W...

Page 137: ...cepts how to register iIS library distributions how to register an alias how to perform application upgrades About Registration The iIS process engine s principal function is to execute process defini...

Page 138: ...ne assignment rule dictionaries Developed in the Assignment Rule Workshop an assignment rule dictionary is a set of rules used by the engine to assign activities to users or other resources process de...

Page 139: ...library distribution files which are then placed in a standard location on the central server node A special registration service WFEnvAgent running on the central server node keeps track of the iIS...

Page 140: ...led on the nodes hosting both the primary and backup engine units For details of how iPlanet UDS deploys library distributions see the iPlanet UDS System Management Guide Placing an entry in the regis...

Page 141: ...to the production environment Use the following steps To transfer iIS library distributions to a production environment 1 Make sure that developers have generated all relevant iIS library distributio...

Page 142: ...a library are to the most current registered version of the library For example if you register a new version of a process definition with an engine all subsequent instances of that process definitio...

Page 143: ...erences a particular process definition executed by a particular engine An alias must be registered with every engine executing a process definition containing the alias that is containing a Subproces...

Page 144: ...mining who has permission to perform activities You can register more than one user profile with each engine but this is normally done only for upgrade purposes Each user profile registered with an en...

Page 145: ...fore process definitions are registered However in the course of development assignment rules can change or new ones may be developed and these assignment rules can be registered at any time if their...

Page 146: ...registration select Process Definitions Assignment Rule Dictionaries User Profiles or Validation from the Distributions drop list 3 In the Distribution selection list select the distribution or distr...

Page 147: ...cribed in this section Distribution Type Registration Characteristics User profile Cannot register upgraded versions of the same name unless you first unregister the older version cold start the engin...

Page 148: ...engines from which you want to unregister the specified process definition assignment rule dictionary or user profile All running engines are displayed 5 Click OK to perform the unregister operation...

Page 149: ...or engines must be online and the primary engine unit of each target engine must be in the ONLINE state To register an alias using the iIS Console 1 Choose Environment Aliases New The Register Alias w...

Page 150: ...ster the specified alias 4 Click OK Viewing Registrations for an Engine The registration procedures described in the previous sections let you perform registration and unregistration of iIS distributi...

Page 151: ...distribution 4 Check that the window s refresh options are appropriately set Unregistering a Distribution From the Registrations window you can unregister any distribution currently registered with an...

Page 152: ...or instances of a registered process definition 1 Select a running engine whose process instances you want to monitor in the iIS Console main window 2 Choose Monitor Registrations The Registrations wi...

Page 153: ...ionaries user profiles and validations and even client applications or application proxies depending on the type of change involved While properly specifying the upgrade of an iIS enterprise applicati...

Page 154: ...and upgraded client applications that are not compatible with the earlier versions You must shut down your business process application to perform the upgrade To perform a monolithic upgrade 1 All cli...

Page 155: ...e To support differing versions of a user profile designers create upgraded versions of the validation and the assignment rules that can accommodate both the new and old user profiles Client applicati...

Page 156: ...Performing Application Upgrades 156 iPlanet Integration Server Process System Guide August 2001...

Page 157: ...covered include monitoring and managing engine sessions monitoring and managing process execution providing historical analysis of process execution activity monitoring and managing two phase commit...

Page 158: ...is the mechanism for all communication between a client application and the engine It is used by the engine to offer activities in a process to different applications or users and to notify them abou...

Page 159: ...ts to restore the connection If the client session object is unsuccessful in restoring the connection within a specified auto reconnect timeout period it notifies the client application that the conne...

Page 160: ...ession disconnect and reconnect parameters are summarized in the table below When the client API auto reconnect mechanism attempts to restore a suspended session to an ACTIVE state it passes the user...

Page 161: ...new sessions depending on the values of the reconnectAction property set when each session was originally opened The effect of suspending a session on any activities a client application is performin...

Page 162: ...tivity The activity remains in the pending state until all trigger conditions are met at which time the engine performs any work specified by a Ready method in the process definition and then places t...

Page 163: ...vity list and places the activity in an ABORTED state COMPLETED The COMPLETED state signifies successful completion of an activity The engine performs any additional work specified by the OnComplete m...

Page 164: ...ity Engine activates timer controls if any Engine executes Trigger method If Trigger method returns TRUE Engine executes Ready method if any Engine activates timer controls if any Engine executes OnAc...

Page 165: ...Process creation involves the creation of a First activity Activity type Description First Specialized activity the first activity in a process definition Automatically placed in COMPLETED state bypas...

Page 166: ...process The request must provide the name of a process definition registered with the engine The engine invokes the assignment rules for process creation to determine if the user making the request is...

Page 167: ...s A new process is created the engine creates a First activity passes it through PENDING READY and ACTIVE states and places it directly into a COMPLETED state A completed activity s router points to a...

Page 168: ...ivity being executed The four types of activities that require work to be performed Offered Queued Subprocess and Automatic are all executed somewhat differently by an iIS process engine Execution of...

Page 169: ...d except the one which accepts the corresponding work item The engine provides the client application with the associated application dictionary item a reference to the application or service needed t...

Page 170: ...or service needed to perform the activity a description of the work to be performed and any required process attribute data The engine ensures that any required process attributes are locked so that n...

Page 171: ...rocess activity is placed in an ABORTED state Automatic Activities Transition to READY State When the trigger conditions are met the engine performs any work specified in the Ready method if one exist...

Page 172: ...however instead of performing the above actions the engine places the process directly in a COMPLETED state Aborted Activities When an engine places an activity in an ABORTED state the engine perform...

Page 173: ...state and has no OnAbort router method specified a system manager requests that a process be aborted an exception is thrown on an activity method When a process instance is aborted any uncompleted act...

Page 174: ...ed to the session or information about any such assigned activities that are in ACTIVE state To obtain state information about a session 1 Open the iIS Console and select the engine to monitor 2 Choos...

Page 175: ...d For each activity in the list the dialog displays the activity ID the process name and process instance ID in which it was created and its current state NOTE To get more information about a given ac...

Page 176: ...allow the client application to handle the state change gracefully For the impact of suspending a session see Explicitly Suspended Sessions on page 161 For the impact of terminating a session see Expl...

Page 177: ...e from the popup menu You will be asked to confirm the termination Sending and Broadcasting Messages to Sessions You can send an informational message to any active session or broadcast the same messa...

Page 178: ...iPlanet Integration Server Process System Guide August 2001 2 Open the session of interest 3 Click Send Message The Send Message window displays 4 Type the message in the Message field 5 Select the ur...

Page 179: ...ion As described in Process Execution on page 165 an iIS process engine executes process instances by creating a succession of activities moving them through a number of states checking timers and loc...

Page 180: ...ess execution to resolve problems This section describes a number of common process execution monitoring and management tasks you might perform process instance Checking the execution status of a proc...

Page 181: ...possibly abort it Checking the Status of a Process Instance Suppose you want to find out the current execution status of a given process instance which of its activities are in PENDING READY or ACTIVE...

Page 182: ...e value of the primary process attribute the primary process attribute name the process instance ID and the process instance creation time 4 Search for a process instance by process attribute value cr...

Page 183: ...ng the appropriate tab you can get the process instance s activity list timer list process attribute list and other information From these lists in turn you can get information about the state of any...

Page 184: ...scards all process attribute updates To abort a process instance 1 Open the property sheet of the process instance you want to abort See Step 1 through Step 5 under Checking the Status of a Process In...

Page 185: ...tus of an activity and change its state Checking the Status of an Activity 1 Select the activity in any window that contains an activity list Process Instance property inspector Session property inspe...

Page 186: ...s and information about timers linked to the activity For example if you click the Process Attributes tab you get information about the current values of the process attributes for the process instanc...

Page 187: ...locked process attributes are unlocked from ACTIVE to ABORTED You might do this because some condition has arisen that precludes the completion of the activity and you want the OnAbort routing if any...

Page 188: ...rk on them You can display a list of activity queues and open a queue to display the contents of the queue Doing so might tell you for example that a particular activity is not being performed because...

Page 189: ...page 185 If you want to change the position of an activity in the queue see Reprioritizing a Queued Activity below Reprioritizing a Queued Activity If a queued activity is not making it to the top of...

Page 190: ...Choose Activity Set Priority The Set Queued Activity Priority window displays 4 In the New prioritizing value change the value of the queue prioritizing process attribute 5 Click OK The activity will...

Page 191: ...nstances This section describes how to check the status of a timer reset it or change its state Checking the Status of a Timer 1 Open the Timers tab of a Process Instance property inspector shown belo...

Page 192: ...perty inspector displays with the basic properties of the selected timer Changing the Timer State and Expiration Time To change the state and expiration time of a timer 1 Open the timer s property ins...

Page 193: ...a deadline timer screen not shown Reset sets the deadline expiration time to its original value and Set Deadline lets you enter a new expiration time in DateTimeData format dd nnn yyyy hh mm ss for ex...

Page 194: ...ance property inspector is shown below For each process attribute the list displays the attribute name data type attribute value and lock state Changing a Process Attribute Value You might change the...

Page 195: ...ck the Set button Removing a Process Attribute Lock You might remove a process attribute lock because you want to force a change in the value of an attribute or because a lock was inadvertently not re...

Page 196: ...me and process ID 3 Filter the activity list by the process name registered process definition of the process you are checking see Filtering iIS Console Lists on page 73 This filter should list activi...

Page 197: ...n process execution There are several approaches to finding bottlenecks One is to determine how many process instances are currently in a given stage of completion For example you could create a graph...

Page 198: ...ser to another History Log Schema The full engine database schema is documented in the Appendix B Engine Database Schema History Log Tables on page 347 of this Appendix lists the schema of all the his...

Page 199: ...tions typically perform iIS operations that change process state maintained by the engine while also making application database updates Activity PENDING 10 READY 20 PREPARE_ACTIVE 25 ACTIVE 30 PREPAR...

Page 200: ...ication data should not succeed The iIS two phase commit protocol facilitates the synchronization of iIS engine operations with application transactions by letting you place iIS operations in a transa...

Page 201: ...he same process instance The iIS two phase commit protocol makes it possible to include the following iIS engine operations in a transactional context creating a process aborting a process starting an...

Page 202: ...solution commit or rollback The client application is normally responsible for resolving these transactions however in the case of failure these transactions may be left permanently in the PREPARE pha...

Page 203: ...erformance indicators Introduction iIS provides a number of tools to help you diagnose engine problems or problems in process execution with your iIS enterprise applications the Process Engine Alarms...

Page 204: ...g to start an unregistered subprocess the engine records a process exception activity exception session exception or timer exception in the primary engine unit s log file see Engine Log Files on page...

Page 205: ...and is now capable of accepting client connections EngineUnitShutdown An engine unit has shut down and is no longer running as a partition due either to operator intervention or to a failure in the so...

Page 206: ...e database of any engine for which history logging is turned on To view alarms for a specific engine you must first register the engine with the alarm service An engine can be registered with the alar...

Page 207: ...ine Alarms window and also search for alarms in the window To filter alarms in the Process Engine Alarms window 1 Choose Alarms Filter The Filter Expression window opens This window allows you to buil...

Page 208: ...window opens 2 In the Filter Expression window build an expression for the alarms you are trying to find Use the steps outlined in the previous procedure to build the expression 3 Click OK 4 To search...

Page 209: ...an alarm 1 Select the alarm in the Process Engine Alarms window 2 Right click and choose Alarm Open from the popup menu The Alarm Details window displays To remove an alarm from the Alarm window 1 Sel...

Page 210: ...Planet UDS runtime system while other information is specific to the execution of iIS processes In general the information falls into four categories engine exceptions requested message output instrum...

Page 211: ...em management tools such as the iPlanet UDS Environment Console Audit Traces Audit traces for important system events such as starting and stopping partitions and so forth are automatically written to...

Page 212: ...messages are then written to the corresponding component log files and to the iIS Console Trace window You can specify message filters in a number of ways You can set an environment variable FORTE_LO...

Page 213: ...n general for each log file you can specify four levels of filter as follows Message type mandatory You can include more than one message type separated by spaces the message types available are shown...

Page 214: ...type trc debug Service type cr iIS runtime Group number iIS uses the following group designations Level number iIS uses the following level designations Group Description 1 Engine 2 Session 3 Process...

Page 215: ...are set by default Using the iIS Console Trace Window You can use the iIS Console trace window to select and display messages generated by iIS process engine components and to view exception output U...

Page 216: ...sole Trace window displays 3 Choose File Modify Log Flags This opens the Select Component window 4 Select an engine component and click OK to open the Modify Log Flags window 5 Add modify or delete a...

Page 217: ...e Engine Trace The iIS Console Trace window displays 3 Choose File Modify Log Flags 4 In the Modify Log Flags window enter the following filter Debug CR 13 4 This filter causes all messages generated...

Page 218: ...registration deregistration security events access denial for invalid logon engine state changes start standby shutdown Using the iIS Console Engine Event Filter Window You can use the iIS Console eng...

Page 219: ...fied by event type class ID description and time of occurrence The information starts displaying after the next engine event occurs Displaying Process Instance Events You can display all engine events...

Page 220: ...instance of a specific process definition 1 From the Engine Event Filter window select the option Next process instance of and select a process definition from the drop down list All engine events fo...

Page 221: ...ations For details on valid filter expressions see CreateFilter on page 279 To specify a custom filter 1 Select the option Custom filter and enter a valid filter expression Events which satisfy the fi...

Page 222: ...to speed throughput to the engine database In many situations these factors have complicated interactions and you have to monitor these indicators carefully under varying conditions analyzing the sou...

Page 223: ...formance Charts window is displayed You can choose View Observed Values to expand the Charts window to display maximum last observed and minimum values for the charts 3 You can change the interval bet...

Page 224: ...here in the chart then right click and choose Chart Properties from the popup menu The Timeline Properties window displays You can choose to display observed values or the differences between succeedi...

Page 225: ...a log file To log performance information 1 At the Performance Charts window choose File Set Logging File 2 Define a name and location for the performance log data file 3 Click OK 4 Choose File Start...

Page 226: ...Performance Charts 226 iPlanet Integration Server Process System Guide August 2001...

Page 227: ...uctor Script using Conductor Script to perform system management tasks For a complete reference listing of all Conductor Script commands see Appendix A Conductor Script Commands Overview With the exce...

Page 228: ...Script commands refer to Appendix A Conductor Script Commands Conductor Script Help Conductor Script provides an online help utility which provides help for all Conductor Script commands At a Cscript...

Page 229: ...input_file o output_file fns name_service_address The syntax of the cscript command for OpenVMS VFORTE CSCRIPT LOGGER message_filters MEMORY memory_options INPUT input_file OUTPUT output_file NAMESER...

Page 230: ...e memory flags to use for the Conductor Script session See the iPlanet UDS System Management Guide for syntax information Overrides defaults appropriate for the operating system On UNIX you must speci...

Page 231: ...rectories to the current search path see SetPath Exit Exit Conductor Script Help comand_name match_string List help for general Conductor Script commands and currently available FNscript commands Use...

Page 232: ...Conductor Script operations into a script file and then run that file at a later time You can run a script either by starting Conductor Script with the i flag and supplying the script file name or by...

Page 233: ...the next command for the specified number of milliseconds Include filename Execute the commands in a specified script file Repeat repeat_count Repeat execution of the next command the specified numbe...

Page 234: ...ecute the specified operating system command for path names in opsys_cmd that use portable format ListFile ListFile Lists the contents of the specified file onto standard output ListFiles directory_na...

Page 235: ...ons using iIS Console see Chapter 4 Managing Engines Starting an Engine You can start engine components from a centralized location using the Conductor Script utility see Appendix A Conductor Script C...

Page 236: ...ication channels are established the primary engine unit can log on to its database and perform other operations needed to come fully online The engine startup protocol is designed to allow components...

Page 237: ...nning page 284 StartEngine newLog newState newRegistration cold Start all components of the engine as specified in the engine configuration file Includes various start options that create new engine d...

Page 238: ...s an example take the engine partitioning scheme illustrated in Figure 4 2 on page 88 Assume the iPlanet UDS environment is named Galaxy and the engine is named Enterprise The partitioning scheme is s...

Page 239: ...engine agents to gather engine component data Each agent has a set of instruments that report relevant information Monitoring the Engine Typically you want to know which engine components are up and...

Page 240: ...2 Use the FindEngine command to make a particular engine current 3 Use the appropriate FindComponent command to make a component current 4 Use the ShowStatus command to display information about the c...

Page 241: ...service must be running page 283 FindGovernor Set the governor for the current engine as the current component The governor must be running page 284 FindPrimary Set the primary engine unit for the cu...

Page 242: ...make the engine of interest current 2 Use the FindUnit or FindPrimary command to make the component of interest current 3 Use the SetState command to set the engine unit state If you want to place th...

Page 243: ...ary distributions and registration including how to perform registration using iIS Console see Chapter 5 Managing Registrations Making iIS Library Distributions You can use Conductor Script to perform...

Page 244: ...system The commands needed to make iIS library distributions except for MakeConductorDistribution are documented in the iPlanet UDS Fscript Reference Guide and summarized in the table below Command A...

Page 245: ...from the specified file IntegrateWorkspace comment logfile_name baseline_password Integrate the changes in this workspace into the shared repository ListPlans match_string List the plans in the curren...

Page 246: ...ine current 2 Use the ListConductorDistributions command to display a list of iIS library distributions that are available for registration 3 Use the appropriate Register command to register an availa...

Page 247: ...write a script that performs all the unregistrations that you want RegisterAlias alias_name process_name engine_name environment Register the alias representing a specified process running on a speci...

Page 248: ...are documented in Appendix A Conductor Script Commands and summarized in the table below Command Arguments Function See FindEngine engine_name Set specified engine as the current engine The engine no...

Page 249: ...aging sessions monitoring and managing executing processes For background information on iIS process execution including how to perform process management using iIS Console see Chapter 6 Managing Proc...

Page 250: ...to filter the list of sessions if desired 4 Use the ListSessions command to display a list of filtered sessions 5 Use the ShowSession command to display state information about a particular session T...

Page 251: ...s not have to be running page 284 ListEngines Display a list of all running and configured iIS process engines in the environment page 289 ListSessions List all sessions in the current engine page 291...

Page 252: ...rocess instances 5 Use the ShowProcess command to display information about a particular process instance The output shows information about the activities timers and process attributes of the process...

Page 253: ...to READY Managing Activity Queues To list the contents of an activity queue 1 Use the FindEngine command to make a particular engine current 2 Use the ListActivityQueues command to display a list of...

Page 254: ...cribed in Step 1 through Step 4 above 2 Use the ShowTimer command to display information about a particular timer 3 Use the SetTimer SetTimerDeadline or SetTimerElapsed command to turn a timer on or o...

Page 255: ...Use the FindEngine command to make a particular engine current 2 Use the ListActivities command to display a list of activity instances in the current engine 3 Use the CreateFilter command to filter...

Page 256: ...ssignment rule A consultant session returns the activity using the return_rule assignment rule The user name and other info strings are supplied if required by the consultation and return assignment r...

Page 257: ...om ACTIVE to READY page 298 SetAttributeValue process_id attribute_name attribute_type value Set the value of the specified attribute for a specified process instance page 300 SetQueuedActivity Priori...

Page 258: ...commands print out the transaction ID of any iIS operations that are in a PREPARE phase ShowActivityQueue process_name queue_name Display the contents of the specified queue or all queues for the spe...

Page 259: ...ult in inconsistency of state information between the client application and engine To properly resolve iIS engine transactions in a PREPARE phase however you must investigate whether related applicat...

Page 260: ...would see output such as the following 2 Commit or roll back the prepared transaction cscript CommitTransaction 200 3 Verify the commit or rollback of the transaction cscript ShowSession 200 The outp...

Page 261: ...s This appendix documents only the iIS specific Conductor Script commands For documentation of Fscript Commands accessible through Conductor Script see the Fscript Reference Guide An introduction summ...

Page 262: ...unDistrib and RunFile commands Fscript is an iPlanet UDS command line interface that lets you create new plans and projects examine components define and modify classes partition test and run distribu...

Page 263: ...IIOPServer start stop show Starts stops or displays information about the IIOP service needed to support CORBA IIOP iIS process client applications page 287 ListConductor Distributions type Display a...

Page 264: ...or Escript in that environment without using the password page 300 ShowEngine engine_name Display status of the specified engine page 306 Uninstall name compatibility_level Deletes an iIS distributio...

Page 265: ...gine unit for the current engine as the primary unit This will change the states of the engine units to make the specified unit ONLINE page 301 ShowConfiguration Display contents of the configuration...

Page 266: ...tartEngine newLog newState newRegistration cold Start all components of the engine as specified in the engine configuration file Includes various start options that create new engine database tables p...

Page 267: ...teActivity process_id activity_name Change the state of the specified activity from ACTIVE to COMPLETED page 276 ConsultActivity process_id activity_id state consultation_rule return_rule user_name1 o...

Page 268: ...specified process or all processes in the current engine page 287 ListFilters List all existing event filters for the current engine page 289 ListProcesses short name process_name List process instan...

Page 269: ...ser profile with the current engine page 295 RegisterValidation validation_name Register the specified validation with the current engine page 296 RemoveReadLock process_id attribute_name Remove a sha...

Page 270: ...r no change and set a new elapsed time interval until expiration page 304 ShowActivity process_id activity_name Show details of the specified activity page 302 ShowActivityQueue process_name queue_nam...

Page 271: ...ateSession session_id Terminate the specified session page 321 UnRegisterAlias alias_name Unregister the specified alias from the current engine page 322 UnRegister AssignmentRules dictionary_ name ru...

Page 272: ...shows the full instrumentation implemented for all the engine s internal manager objects page 309 ShowLogFlags Display the logger message filters logger flags set for the current component partition l...

Page 273: ...ss attribute updates rolls back changes that were made in performing the activity and frees locks on process attributes associated with the activity evaluates the activity s OnAbort method if one is s...

Page 274: ...mand the engine posts an alarm for each process instance to be aborted AbortProcess The AbortProcess command aborts a specified process instance for the current engine AbortProcess process_id process_...

Page 275: ...that is one in a PREPARE phase For details on two phase commit operations see Monitoring and Managing Two Phase Commit on page 199 CommitTransaction session_ID transaction_ID To roll back an in progr...

Page 276: ...s attributes associated with the activity evaluates the activity s OnComplete method if one is specified evaluates the activity s OnComplete router methods checks for a process stall condition when al...

Page 277: ...gument Description process_id The process instance in which the activity was created activity_id The activity instance to be delegated state The state of the activity instance to be delegated READY or...

Page 278: ...the activity to a consultant then that original user s name would be passed to the return_rule assignment rule Once the user to whom the activity is returned has completed or aborted the activity pro...

Page 279: ...ivities as well as changes in process attributes The filter expression uses a number of comparison operators to specify three filter expression elements The three elements type object class and object...

Page 280: ...than the binary operators that follow which have higher priority than the logical operators at the bottom of the table Class Value Description Session 1 Events involving sessions Process instance 2 E...

Page 281: ...ateActivity process_id activity_id state delegation_rule user_name other_info greater than less than or equal to greater than or equal to and logical and or logical or not logical not Filter Expressio...

Page 282: ...f looks for the manager of the delegator then the delegator s user name and other info in this case the manager s name would be passed to the ManagerOf assignment rule This behavior is similar in func...

Page 283: ...dDBService The FindDBService command sets the specified database service for the current engine as the current component FindDBService service_name The FindDBService command is available only when an...

Page 284: ...d to perform any engine management database management or process execution management tasks FindGovernor The FindGovernor command sets the governor for the current engine as the current component Fin...

Page 285: ...only when an engine component is current The FindParentEngine command is used to navigate to the current engine when one of its components is current and you want to make another of its components cu...

Page 286: ...ed engine unit must also be running The FindUnit command is normally used to check the status of a specific engine unit using the ShowStatus Script command or to change its state using the SetState an...

Page 287: ...ies The ListActivities command is available only when an engine is current so you must first use the FindEngine Script command to set the current engine The ListActivities command displays activities...

Page 288: ...ped by type The ListConductorDistributions command is used to display a list of library distributions of the appropriate type that you might want to register using the Register Script command For each...

Page 289: ...available only when an engine is current so you must first use the FindEngine Script command to set the current engine For each filter the ListFilters command displays the filter ID the time interval...

Page 290: ...bute name the process instance ID and the process creation time ListRegistrations The ListRegistrations command displays distributions of the specified type or all types registered with the current en...

Page 291: ...stTimers command displays all timers in the current engine ListTimers The ListTimers command is available only when an engine is current so you must first use the FindEngine Script command to set the...

Page 292: ...ipt command to confirm that the library distribution has been generated ModLogFlags The ModLogFlags command modifies the log message filters set for the current component ModLogFlags message_filters m...

Page 293: ...node on which the primary engine unit is running For information on iIS message filters see Messages and Message Filters on page 212 ReadyActivity The ReadyActivity command changes the state of the s...

Page 294: ...Rules command registers the specified assignment rule dictionary or all available assignment rule dictionaries in the current engine s registration database RegisterAssignmentRules dictionary_name The...

Page 295: ...n engine is current so you must first use the FindEngine Script command to set the current engine Use the ListConductorDistributions Script command to display a list of distributions available for reg...

Page 296: ...user profile of the same name is not already registered RegisterValidation The RegisterValidation command registers a validation in the current engine s registration database RegisterValidation valida...

Page 297: ...k The RemoveWriteLock command removes a write lock on the specified process attribute RemoveWriteLock process_id attribute_name The RemoveWriteLock command is available only when an engine is current...

Page 298: ...the activity and frees locks on process attributes Changes the activity state from ACTIVE to READY Posts an ActivityListUpdate event to all sessions associated with the activity If the activity is an...

Page 299: ...e FindEngine Script command to set the current engine The SendMessage command is used to notify a session about a pending administrative action such as a request for consultation pending suspension of...

Page 300: ...word command sets password protection for opening Conductor Script in your active environment After you set a password other users cannot open Conductor Script or iIS Console or iPlanet UDS Environmen...

Page 301: ...unit is the backup unit the primary unit will be placed in a STANDBY state and the backup unit will then be placed ONLINE If the specified engine unit is the primary unit nothing will be done The SetP...

Page 302: ...lable if the current component is an engine unit Use the FindEngine Script command to set the current engine and the FindUnit Script command to make the desired engine unit current The SetState comman...

Page 303: ...etTimerDeadline The SetTimerDeadline command sets the specified deadline timer to the specified state ON OFF or no change and sets a new expiration time SetTimerDeadline process_id timer_name state ex...

Page 304: ...interval until expiration ShowActivity The ShowActivity command displays the properties of the specified activity in the current engine ShowActivity process_id activity_name The ShowActivity command...

Page 305: ...display a list of activities in the engine before selecting the activity to display ShowActivityQueue The ShowActivityQueue command displays the contents either of the specified queue or of all queues...

Page 306: ...engine ShowConfiguration The ShowConfiguration command is available only when an engine is current so you must first use the FindEngine Script command to set the current engine No engine components n...

Page 307: ...lters see Messages and Message Filters on page 212 ShowProcess The ShowProcess command displays the properties of the specified process instance in the current engine ShowProcess process_id The ShowPr...

Page 308: ...and to display a list of process instances in the engine before selecting the process instance to display ShowSession The ShowSession command displays the properties of the specified session in the cu...

Page 309: ...and to set the current engine and in addition the FindGovernor FindDBService FindUnit or FindPrimary Script command to make the corresponding engine component current The properties displayed by the S...

Page 310: ...N_REQUESTED negotiating with partner or CONNECTED governor channel OPEN or CLOSED partner channel OPEN or CLOSED ping interval start time host node database service database service name database conn...

Page 311: ...ent suspended sessions CurrentSessions Number of current sessions ActiveSessions SuspendedSessions TotalSessions Number of sessions since engine startup CurrentSessions Number of terminated sessions A...

Page 312: ...timers ReadLocks Number of current read shared locks WriteLocks Number of current write exclusive locks CurrentLocks Number of current locks ReadLocks WriteLocks TotalLocks Number of locks since engin...

Page 313: ...command to display a list of timers in a specified process instance before selecting the timer to display LoginUserName The database user login name LoggingState The database logging settings the tabl...

Page 314: ...he current component If the Shutdown command results in a primary engine unit being shut down then all state information in the engine is lost and must be recovered from the engine database when a pri...

Page 315: ...ified in the engine configuration file see Engine Configuration File on page 90 and Step 10 under How to Configure a New Engine on page 95 The ShowStatus Script command or the FindDBService command fo...

Page 316: ...d during the primary engine unit startup process All history log information stored in an existing database is lost newState New current state database tables are created during the primary engine uni...

Page 317: ...ss_id timer_name The StartTimer command is available only when an engine is current so you must first use the FindEngine Script command to set the current engine The StartTimer command lets you start...

Page 318: ...tables are created during the primary engine unit startup process All history log information stored in an existing database is lost newState New current state database tables are created during the...

Page 319: ...spendAllSessions command places all ACTIVE sessions in SUSPENDED state making them dormant the engine cannot assign new activities to suspended sessions or post events to them Automatic reconnect by t...

Page 320: ...can restore it to ACTIVE state or create a new session depending on the value of the reconnectAction property set when the session was first opened The engine posts a SessionSuspended event on the se...

Page 321: ...eSession command ends the session and deletes it from the engine and the engine s state database table The engine posts a SessionTerminated event on the session before it is terminated so that the cli...

Page 322: ...command to set the current engine Use the ListRegistrations Script command to display a list of components registered with the current engine you can filter the list for aliases The UnRegisterAlias co...

Page 323: ...efinition from the current engine s registration database UnRegisterProcessDefinition process_name The UnRegisterProcessDefinition command is available only when an engine is current so you must first...

Page 324: ...t of components registered with the current engine You can filter the list for user profiles The UnRegisterUserProfile command removes the specified user profile from the registration table WaitForSta...

Page 325: ...mand to set the current engine In a script the WaitForStartup command is used after a StartUnit Script command The WaitForStartup command causes the script to pause until the specified engine unit suc...

Page 326: ...Conductor Script Commands 326 iPlanet Integration Server Process System Guide August 2001...

Page 327: ...ables see Alphabetical Listing of Tables on page 329 Database Tables by Category The tables comprising the engine database are listed in the following table They are grouped into the following categor...

Page 328: ...ActivityTokens WFHActivityUsers WFHAssignment WFHSession WFHSessionLog WFHSessionRole WFHSessAttributes WFHRetryInfo WFHTimer WFHTimerLog WFHTimerStateLog WFHActiveTimer WFHComplexRule WFHControl WFHR...

Page 329: ...ther activity WFHActStateLog page 348 Log of state changes in activity instances in the engine WFHAlarmLog page 349 A log of all alarms generated on this engine recorded whenever history logging is tu...

Page 330: ...54 Log of state changes to process instances in this engine WFHProcParameters page 341 For a synchronous subprocess the list of output parameters it must supply to its parent WFHQueuedActivity page 34...

Page 331: ...n for each entry in a table is based on the representation used in Oracle databases The actual data type may differ depending on the database vendor you are using WFHSessionRole page 344 Current clien...

Page 332: ...ocess instance designated by PROCESSID PROCESSID NOT NULL NUMBER 38 Unique identifier for the process instance in which this active timer occurs TIMETOALARM DATE Date time stamp indicating when the ti...

Page 333: ...in which it occurs STATE NUMBER 38 Activity state 10 WFActivity PENDING 20 WFActivity READY 25 WFActivity PREPARE_ACTIVE 30 WFActivity ACTIVE 35 WFActivity PREPARE_COMPLETE 40 WFActivity COMPLETED 45...

Page 334: ...ack dynamic assignment rules during a ConsultActivity or DelegateActivity method call from a client application NEXTASSIGNID NUMBER 38 This column is used internally by the engine to track dynamic ass...

Page 335: ...ecessor of the activity instance identified by the ACTIVITYID in this row TOKCOUNTER NUMBER 38 Value of the attribute _COUNT ActivityName where ActivityName is the same as ACTIVITYNAME in this row Tab...

Page 336: ...is activity by its activity link If there is no activity link value is NO_LINKED_USER OTHERINFO VARCHAR2 64 The OtherInfo information passed into this activity by its activity link If there is no acti...

Page 337: ...XTPROCESSID NUMBER 38 System maintained sequence for process ID values NEXTTIMERID NUMBER 38 System maintained sequence for timer ID values HISTORYDETAIL NUMBER 38 Internal use only Table B 10 WFHLock...

Page 338: ...e Table B 11 WFHProcAttributes Name Index Null Type Description PROCESSID NOT NULL NUMBER 38 Unique identifier for the process instance in which this process attribute occurs ATTNAME VARCHAR2 64 Name...

Page 339: ...38 For a subprocess the activity ID of the subprocess activity instance in the parent process that invoked this process PARENTPROCESSID NUMBER 38 For a subprocess the process ID for the process insta...

Page 340: ...recovery level designated for this process 0 WFProcess RCVR_NORMAL 501 WFProcess RCVR_ONLY 502 WFProcess RCVR_NONE 503 WFProcess RCVR_FULL 504 WFProcess RCVR_PARENT PARENTACTNAME VARCHAR2 64 For a su...

Page 341: ...ivity being queued PROCESSID NOT NULL NUMBER 38 Unique identifier for the process instance containing the queued activity FIFOORDER NOT NULL NUMBER 38 The placement of the activity in the queue based...

Page 342: ...stance in the engine ACTIVITYID NUMBER 38 Identifier for an activity instance in the process instance designated by PROCESSID REQSTATUS NUMBER 38 Internal use only ACTIONFLAG NUMBER 38 Internal use on...

Page 343: ...VARCHAR2 255 The value of the attribute in text format SETNUMBER NOT NULL NUMBER 38 Internal use only Table B 19 WFHSession Name Index Null Type Description ID NOT NULL NUMBER 38 Unique identifier for...

Page 344: ...se only PROCESSID NUMBER 38 Unique identifier for a process instance in the engine ACTIVITYID NUMBER 38 Identifier for an activity instance within the process instance designated by PROCESSID ENVIRONM...

Page 345: ...value of the attribute in text format Table B 23 WFHTimer Name Index Null Type Description ID NOT NULL NUMBER 38 Unique identifier for the timer instance within this engine PROCESSID NOT NULL NUMBER 3...

Page 346: ...xpiration time should the timer be turned on again without reset expressed in character form TIMETOALARM DATE For a running timer the time when it will expire TYPE NUMBER 38 Type of timer 1 WFTimer EL...

Page 347: ...pplication for this iIS plan COMPATIBILITYLEVEL NOT NULL NUMBER 38 Compatibility level of the installed library of this iIS plan LIBRARYNAME VARCHAR2 64 Name of the installed library for this iIS plan...

Page 348: ...his activity instance occurs LOGTIME DATE Time of this logging Table B 27 WFHActStateLog Name Index Null Type Description ID NUMBER 38 Unique identifier for this activity instance within the process i...

Page 349: ...9 WFHAliasLog Name Index Null Type Description ALIAS VARCHAR2 64 Name of an alias registered or now unregistered on this engine PROCESS VARCHAR2 64 Name of the process definition which the alias repre...

Page 350: ...or this session ACCESSORID NUMBER 38 Unique identifier for this attribute accessor instance within this process instance ATTNAME VARCHAR2 64 Name of the process attribute LOCKTYPE NUMBER 38 Type of ac...

Page 351: ...DB service acquire time APPCPUTIME NOT NUL NUMBER 38 Engine CPU time GCCPUTIME NOT NUL NUMBER 38 Engine garbage collection time ACTIVESESSION NOT NULL NUMBER 38 The number of active sessions SUSPENDSE...

Page 352: ...ce in which this process attribute occurs ATTNAME VARCHAR2 64 Name of the process attribute ATTTYPE NUMBER 38 Type of the attribute 1 IntegerData 2 TextData 3 BooleanData 4 DateTimeData 5 DoubleData 6...

Page 353: ...is not a subprocess PARENTPROCID NUMBER 38 For a subprocess the process ID for the process instance that started this process instance The value is 0 if this is not a subprocess ROOTPROCID NUMBER 38 F...

Page 354: ...rocess ABORTED LOGTIME DATE Time of this logging Table B 36 WFHRegistrationLog Name Index Null Type Description APPLICATIONID VARCHAR2 32 Name of the installed application for this iIS plan COMPATIBIL...

Page 355: ...on termination PROFILENAME VARCHAR2 64 The profile name of the user on the session STATE NUMBER 38 Logged new state for the session 210 WFSession ACTIVE 220 WFSession SUSPENDED 230 WFSession TERMINATE...

Page 356: ...850 WFTimer DELETED RELATIVETIME VARCHAR2 32 For an elapsed timer the defined duration of time set for the timer expressed in character form For a deadline timer the defined expiration time set for th...

Page 357: ...following table shows the values corresponding to the various states of these objects Object State Value Process Instance PREPARE_CREATE 405 CREATED 410 ACTIVE 420 COMPLETED 430 PREPARE_ABORT 435 ABO...

Page 358: ...Database Schema Reference 358 iPlanet Integration Server Process System Guide August 2001...

Page 359: ...n automatic activities 171 offered activities 168 queued activities 169 subprocess activities 170 activity queues reprioritizing 189 status checking 188 activity states ABORTED 163 199 357 ACTIVE 163...

Page 360: ...66 starting 228 Conductor Script command AbortActivity 273 AbortAllProcesses 274 AbortProcess 274 BroadcastMessage 275 CommitTransaction 275 CompleteActivity 276 ConsultActivity 276 CreateActivity 278...

Page 361: ...tore facility 128 database See also engine database Dump Restore facilities 126 engine 32 enterprise 45 organization 46 database service configuring 98 99 defined 32 monitoring 121 partitioning guidel...

Page 362: ...alancing 35 minimal no failover 31 multiple 29 properties 88 91 recover cursor size 102 engine database See also current state tables history log tables registration log tables configuration file 90 c...

Page 363: ...Script 292 governor configuring 99 defined 34 monitoring 121 partitioning guidelines 87 startup 105 states 106 GovernorDisconnect alarm 205 H history log schema graphical representation 198 history lo...

Page 364: ...91 ListTransactions command Conductor Script 291 load balancing 35 log file about 210 engine component 212 registration 145 logging settings engine database 98 M Maximum number of processes option 103...

Page 365: ...asks 180 objects in engine diagram 179 process creation 166 process termination 173 recovering state 34 123 recovery levels 123 reports 197 tuning 116 process history 197 process instance states ABORT...

Page 366: ...ver managing 62 requested message output logged 210 restoring See also recovery engine database tables 41 session connections 159 RollbackActivity command Conductor Script 298 RollbackTransaction comm...

Page 367: ...Timer command Conductor Script 319 subprocess activities aliases and 143 described 165 execution of 170 SuspendAllSessions command Conductor Script 319 SUSPENDED session state 158 199 357 suspending s...

Page 368: ...isterProcessDefinition command Conductor Script 323 UnRegisterUserProfile command Conductor Script 324 unregistration about 142 aliases 150 Conductor distributions 147 iIS distributions 142 implicit 1...

Reviews: