Sun Microsystems iPlanet Integration Server 3.0 Скачать руководство пользователя страница 294

Страница: 294 / 368

Conductor Script Commands

294

iPlanet Integration Server • Process System Guide • August 2001

RegisterAlias

The

RegisterAlias

command registers the specified subprocess alias in the

current engine’s registration database. For more information on aliases, see

“About

Aliases” on page 143

RegisterAlias alias_name process_name engine_name environment

The

RegisterAlias

command is available only when an engine is current, so you

must first use the

FindEngine

Script command to set the current engine.

The

RegisterAlias

command registers an alias only if an alias of the same name is

not already registered.

RegisterAssignmentRules

The

RegisterAssignmentRules

command registers the specified assignment rule

dictionary (or all available assignment rule dictionaries) in the current engine’s
registration database.

RegisterAssignmentRules [dictionary_name]

The

RegisterAssignmentRules

command is available only when an engine is

current, so you must first use the

FindEngine

Script command to set the current

engine.

Argument

Description

alias_name

The name of the alias (same as the process name).

process_name

The name of the process referenced by the specified alias.

engine_name

The name of the engine on which the specified process is executed.

environment

The name of the environment in which the specified engine is located.

Argument

Description

dictionary_name

The name of the assignment rule dictionary to be registered. If not
specified, then all available assignment rule dictionaries are
registered.

Содержание iPlanet Integration Server 3.0

Страница 1: ...Process System Guide iPlanet Integration Server Version3 0 August 2001...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 10: ...FindParentEngine 285 FindPrimary 285 FindUnit 286 FlushLog 286 IIOPServer 287 ListActivities 287 ListActivityQueues 287 ListConductorDistributions 288 ListEngines 289 ListFilters 289 ListProcesses 28...

Страница 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...

Страница 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...

Страница 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...

Страница 14: ...14 iPlanet Integration Server Process System Guide August 2001...

Страница 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...

Страница 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...

Страница 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...

Страница 18: ...18 iPlanet Integration Server Process System Guide August 2001...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 42: ...iIS Process Management Tools 42 iPlanet Integration Server Process System Guide August 2001...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 58: ...poscpy Installs engine components WFEngineUnit WFGovernor WFDatabaseSvc userapp Installs process development libraries WFLibrary WFModel WFAccessServiceObj userapp Installs iIS TOOL client development...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 82: ...iIS Console Main Window Command Summary 82 iPlanet Integration Server Process System Guide August 2001...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 156: ...Performing Application Upgrades 156 iPlanet Integration Server Process System Guide August 2001...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 226: ...Performance Charts 226 iPlanet Integration Server Process System Guide August 2001...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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_...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 311: ...ent suspended sessions CurrentSessions Number of current sessions ActiveSessions SuspendedSessions TotalSessions Number of sessions since engine startup CurrentSessions Number of terminated sessions A...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 326: ...Conductor Script Commands 326 iPlanet Integration Server Process System Guide August 2001...

Страница 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...

Страница 328: ...ActivityTokens WFHActivityUsers WFHAssignment WFHSession WFHSessionLog WFHSessionRole WFHSessAttributes WFHRetryInfo WFHTimer WFHTimerLog WFHTimerStateLog WFHActiveTimer WFHComplexRule WFHControl WFHR...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 358: ...Database Schema Reference 358 iPlanet Integration Server Process System Guide August 2001...

Страница 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...

Страница 360: ...66 starting 228 Conductor Script command AbortActivity 273 AbortAllProcesses 274 AbortProcess 274 BroadcastMessage 275 CommitTransaction 275 CompleteActivity 276 ConsultActivity 276 CreateActivity 278...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 368: ...isterProcessDefinition command Conductor Script 323 UnRegisterUserProfile command Conductor Script 324 unregistration about 142 aliases 150 Conductor distributions 147 iIS distributions 142 implicit 1...

Результаты поиска

Содержание iPlanet Integration Server 3.0

Отзывы:

Похожие инструкции для iPlanet Integration Server 3.0

Бренды по названию

Популярные бренды

Sun Microsystems iPlanet Integration Server 3.0, Руководство по системе управления

Результаты поиска

Содержание iPlanet Integration Server 3.0

Отзывы:

Похожие инструкции для iPlanet Integration Server 3.0

Бренды по названию

Популярные бренды