Manuals / Sun Microsystems / Computer Equipment / Network Router

Sun Microsystems 3 manual Place the specified activity

Models: 3

1 368

Download 368 pages 47.9 Kb

Page 256

Managing Process Execution with Conductor Script

The commands needed to intervene in execution of an iIS process instance are documented in Appendix A, “Conductor Script Commands” and summarized in the table below:

Command	Arguments	Function	See…

AbortActivity	process_id	Place the specified activity in the	page 273
	activity_name	ABORTED state.
AbortAllProcesses	——	Abort all process instances in the current	page 274
		engine.
AbortProcess	process_id	Abort the specified process instance.	page 274
CompleteActivity	process_id	Change the state of the specified activity	page 276
	activity_name	from ACTIVE to COMPLETED.
ConsultActivity	process_id,	Delegate the specified activity (in the	page 276
	activity_id	specified state) to consultant users using
	state	the specified consultation assignment
	consultation_rule	rule. A consultant session returns the
	return_rule	activity using the return_rule
	[user_name1]	assignment rule. The user name and
	[other_info1]	other info strings are supplied if
	[user_name2]	required by the consultation and return
	[other_info2]	assignment rules.
CreateActivity	process_id,	Create an activity of the specified name	page 278
	activity_name	in the specified process instance and
		place it in the PENDING state.
CreateFilter	time_interval	Create a filter for events posted on the	page 279
	filter_expression	current engine object which conform to
		the specified filter expression.
DelegateActivity	process_id,	Delegate the specified offered activity	page 281
	activity_id	(in the specified state) to other users
	state	using the specified delegation
	delegation_rule	assignment rule. The user name and
	[user_name]	other info string are supplied if required
	[other_info]	by the delegation rule.
DeleteFilter	filter_id	Delete the specified filter.	page 283
ListActivities	——	List all activities in the current engine.	page 287
ListActivityQueues	[process_name]	Display activity queues for the specified	page 287
		process (or all activity queues) in the
		current engine.

256 iPlanet Integration Server • Process System Guide • August 2001

Image 256

Sun Microsystems 3 manual Place the specified activity

Contents

Process System Guide Page Contents Setting Up an iIS Process Management System Managing Engines Managing Registrations 137 Managing Process Execution 157 Troubleshooting 203 Appendix a Conductor Script Commands 261 Conductor Script Commands Conductor Script Commands Index List of Figures IPlanet Integration Server Process System Guide August List of Procedures IPlanet Integration Server Process System Guide August List of Procedures IPlanet Integration Server Process System Guide August Preface Product Name ChangeAudience for This Guide Organization of This GuideText Conventions ALL CapsOther Documentation Resources Syntax StatementsOnline Help IPlanet Integration Server DocumentationDocumentation Roadmap IIS Example Programs To copy the documentation to a client or serverTo view and search the documentation Toolbar Button Keyboard Command What Is an iIS Process Engine? Introduction iIS Process ManagementWhat Is an iIS Process Engine? Multiple Engine Systems Workshops Minimal Engine Configuration IIS Process Engine Components2Minimal Engine Configuration Failover Configuration 3Engine Configuration with FailoverIIS Process Engine Components IIS Process Full Configuration Failover and Load Balancing CombinedEngine What Does an iIS Process Engine Do? Setting up and Maintaining an iIS System IIS Process Management TasksInstalling iIS Process Management Software Setting Up an iPlanet UDS Runtime EnvironmentSetting Up and Maintaining Central Development Repositories Managing Registration Managing iIS Process EnginesManaging Process Execution IIS Process Management Tools IIS ConsoleDump/Restore Facilities Conductor Script UtilityCustom System Management Tools Repository Management ToolsPage Setting Up an iIS Process Management System Preparation Setting up an iPlanet UDS Runtime Environment IIS Process System Components IIS Process Engines IIS Process System Software IIS BackboneProcess System Software Modules Details, see , Using the Conductor Compiled and Interpreted Engine Components Setccomp.sh True FalseIIS Process System Configuration IIS Process System Software 2iIS Process System Configuration IIS Function Node type Server/Client Node Names IIS Process System Setup Procedure Setting Up an iIS Process SystemTo set up an iIS process system IIS Installation Program Central Server Installation Engine Server Installation DLLDevelopment Client Installation Configuring and Starting Your iIS Engines Runtime Client InstallationAdding New Nodes to an iIS System Maintaining an iIS Process SystemTo add a new node to an iIS system Moving an iIS Engine Creating a New iIS Repository ServerMoving an iIS Repository Server To create a new iIS Repository ServerUpgrading an iIS System Creating a Private iIS RepositoryTo create a private iIS Repository on a development node Uninstalling an iIS System IIS Console OverviewOverview Using the cconsole Command Starting the iIS ConsoleTo start the iIS Console on Windows or Windows NT To start the iIS Console on UNIX, OpenVMS, or Windows NTIIS Console Main Window IPlanet UDS System Management Guide for information aboutMain Viewing Panel Off Engine is configured but has not been startedOnline Engine has fully started and is online Menu Bar Mouse Popup MenuTo set a password for iIS Console Setting Password Protection for iIS ConsoleExiting iIS Console Using iIS Console Windows Using the MouseWindow Refresh Behavior To turn automatic refresh off or onTo set the automatic refresh interval Filtering iIS Console ListsTo force an immediate refresh Operators Specifying ValuesExample Filter Expression Sorting iIS Console Lists Using List Views 2iIS Console BrowserIIS Console Main Window Command Summary Environment MenuView Menu Engine MenuMonitor Menu Help Menu Page Managing Engines Production Engines Versus Development EnginesProduction Engines Versus Development Engines Configuring an Engine Engine Component Partitioning1Engine Configuration with both Failover and Load Balancing Configuring an Engine Engine Startup Properties 2Typical Engine Partitioning SchemeConfiguring an Engine Engine Configuration File Sample configuration file is reproduced belowDbservices NodenameservicenamepriorityDatabaseuserpassword LogtimersDbservicememoryflag DbservicestacksizeUnitrecovercursorsize GovernormemoryflagCustomizing Engine Database Schema MonitordisplaylimitUnitsessionreconnectlimit UnitsessionreconnectactionFORTEROOT/sysdata/conductr/clN/environment/enginename.dbs How to Configure a New Engine Code ExampleTo configure a new engine Property Description Configuring an Engine Configuring an Engine Configuring an Engine Minimum number of pages managed by the memory manager Configuring an Engine Process execution options are the following Duplicating an Engine Configuration Deleting an Engine ConfigurationTo duplicate an engine configuration To delete an engine configurationStarting an Engine GovernorIdle Engine UnitBoth Online EmbryonicStandby Primary Engine Unit Startup Phases Informpartner Database ServiceStartupcomplete How to Start an Engine To start an engineData on To start individual engine components How to Reconfigure an Engine Reconfiguring an EngineTo reconfigure an engine Reconfiguring an Engine How to Dynamically Modify Database Logging To modify database logging for an engineHow to Tune Process Execution Monitoring and Changing Engine States Monitoring Engines and Engine Components To check the engine runtime configurationMonitoring the Engine Monitoring Engine Components To monitor individual engine componentsUnit Startup Phases on Property Description Changing Engine Unit States Changing Engine StatesTo change the state of an engine unit About Recovering State Information Managing an Engine Database Database Management IssuesShutting Down Engine Components Growth of the Database Recovering DataFailure of the Database Dumping and Restoring Data Dumping Database TablesUsing the Dump/Restore Application To use the Dump/Restore application to dump database tablesManaging an Engine Database Managing an Engine Database Using the Dump Command-line Utility Restoring Database Tables Preserving Engine Database Schema Customizations Follow the instructions under Dumping Database Tables on Managing an Engine Database Using the Restore Command-line Utility Dump/Restore Environment Variables WfdrengineWfdrdirectory WfdrdatafileManaging Registrations About RegistrationAbout Registration What Does Registration Do? Install distribution on engine nodes Registration in Production Environments What Does Unregistration Do? Engine Registration ManagerAbout Aliases 2Subprocess Activity ReferencesRegistering iIS Distributions Registration Order Performing RegistrationsTo register one or more distributions using the iIS Console Upgrading Registrations Unregistering iIS DistributionsRegistering Aliases To register an alias using the iIS Console Unregistering Aliases Viewing Registrations for an EngineTo unregister an alias To view the registrations for a given engine Unregistering a DistributionTo unregister a registered distribution Monitoring Instances of a Registered Process Definition To monitor instances of a registered process definitionPerforming Application Upgrades Monolithic Upgrades To perform a monolithic upgradeRolling Upgrades To perform a rolling upgradePage Managing Process Execution IntroductionActive Engine SessionsSuspended Disrupted Sessions ReconnectioninprogressSuspend TerminateReconnectallowed ReconnectprohibitedExplicitly Suspended Sessions Explicitly Terminated SessionsPending Activity StatesReady Completed AbortedActivity State Process Execution Activity TypesProcess Instance Creation Process Instance Execution Activity CreationActivity Execution Offered ActivitiesQueued Activities Subprocess Activities Activity Termination Automatic ActivitiesCompleted Activities Monitoring and Managing Engine Sessions Process Instance TerminationCompleted Process Instances Aborted Process InstancesMonitoring the State of a Session To obtain state information about a sessionMonitoring and Managing Engine Sessions Suspending or Terminating Sessions Managing SessionsTo suspend a session To terminate a session Sending and Broadcasting Messages to SessionsTo send a message to an active session Monitoring and Managing Engine Sessions Monitoring and Managing Process Execution To broadcast a message to all sessionsSession Checking the Status of a Process Instance Managing Process InstancesTo check the current execution status of a process instance Monitoring and Managing Process Execution Monitoring and Managing Process Execution Aborting a Process Instance To abort a process instanceManaging Activity Instances Checking the Status of an ActivityChanging the State of an Activity To change the state of an activity Managing Activity Queues To view the contents of an activity queueChecking the Status of an Activity Queue Reprioritizing a Queued Activity To reprioritize a queued activityMonitoring and Managing Process Execution Managing Timer Instances Checking the Status of a TimerChanging the Timer State and Expiration Time To change the state and expiration time of a timerManaging Process Attributes Checking the Value and Lock State of a Process AttributeChanging a Process Attribute Value To change the value of a process attribute Removing a Process Attribute LockTo remove a process attribute lock Checking for Bottlenecks in Process Execution To find a process bottleneckAnalyzing Process Execution History Log Schema State ValuesPreparecreate CreatedMonitoring and Managing Two-Phase Commit OFFExpired TerminatedIIS Process Engine Operations Monitoring and Managing Two-Phase Commit Managing Two-Phase Commit Operations Troubleshooting Introduction Process Engine Alarms Window Monitoring Alarms To register an engine with the alarm serviceTo unregister an engine from the Alarm service To filter alarms in the Process Engine Alarms windowViewing Alarms To search for an alarm in the Process Engine Alarms windowTo get detailed information about an alarm To remove an alarm from the Alarm windowEngine Log Files To view an engine component log file IIS Console Trace Window Messages and Message FiltersSpecifying Message Filters 1Specifying iPlanet UDS Message Output FiltersIIS Message Filters Message type trc debugSetting Message Filters Using the iIS Console Trace WindowTo open the iIS Console Trace window To set message filters for a selected engine Special Example Write Client Messages to Trace Window IIS Console Engine Event Filter WindowTo set the engine tracing Engine Event Types Using the iIS Console Engine Event Filter WindowTo open the Engine Event Filter window Displaying All Engine Events Displaying Process Instance EventsTo view all engine events for the selected engine To view all engine events for an existing processEvents for the specified process instance display Filtering Engine Events Performance ChartsTo specify a custom filter Viewing Performance Indicators To view performance indicators for an engine Performance Charts To log performance information Logging Performance InformationTo stop logging performance information Page Using the Conductor Script Utility Conductor Script Help Starting Conductor ScriptTo start Conductor Script on Windows or Windows NT Using the Cscript Command To start Conductor Script on UNIX, OpenVMS, or Windows NTWorking with Conductor Script General Conductor Script Operations See SetPathWriting and Executing Scripts CommentsOperating System and File Management Commands FileCopy a specified file in the local file system Managing iIS Process Engines with Conductor Script Starting an EngineTo start an engine where delays might be involved Starting Individual Engine ComponentsStart all components Example Manual Startup Scenario Monitoring Engines and Engine Components Monitoring Individual Engine Components FindDBService State Managing Registrations with Conductor Script Making iIS Library DistributionsTo make an iIS library distribution Include a plan as a Registering iIS Library Distributions To register an iIS distribution with an engineUnregistering iIS Library Distributions To unregister an iIS distribution from an engine Unregister the specified Alias from the current EngineManaging Process Execution with Conductor Script To suspend or terminate a session Monitoring and Managing Engine SessionsTo send a message to one or more sessions Send a message with Monitoring and Managing Process Execution Managing Process InstancesManaging Activity Instances To check the status of a process instanceManaging Activity Queues To list the contents of an activity queueTo reprioritize an activity in a queue Managing Timers To check the status of a timerManaging Process Attributes To check the value or lock state of a process attributeChecking for Bottlenecks in Process Execution To remove an attribute lockPlace the specified activity List all existing event filters for Current engine Monitoring and Managing Two-Phase Commit Transactions Monitoring Two-Phase Commit OperationsManaging Two-Phase Commit Operations Commits the in-progressTo resolve transactions after a client or engine failure Conductor Script Commands Conductor Script Command SummaryEnvironment Mode Engine Component Mode Environment Mode Commands Engine Mode Commands Engine Management Start the specified Engine Mode Commands Process Execution Management Abort all process instances Current engine Delegate the specified offered Activity from Pending to Set the specified timer to Component Mode Commands Generic component Engine UnitConductor Script Commands AbortActivityAbortAllProcesses AbortProcessBroadcastMessage CommitTransactionCompleteActivity ConsultActivityActivity instance to be delegated CreateActivity CreateFilter Event TypeObject Class Object InstanceDelegateActivity ExamplesActive FindDBService DeleteFilterFindEngine FindGovernorFindParentEngine FindNodeFindPrimary FindUnit FlushLogListActivities IIOPServerListActivityQueues ListConductorDistributions ListFilters ListEnginesListProcesses ListRegistrations OptionsListSessions ListTimersListTransactions MakeConductorDistribution ModLogFlagsReadyActivity RegisterAlias RegisterAssignmentRulesRegisterProcessDefinition RegisterUserProfileRegisterValidation RemoveReadLock RemoveWriteLockRollbackActivity RollbackTransactionSendMessage CriticalSetPassword SetAttributeValueSetPrimary SetQueuedActivityPrioritySetTimer SetStateSetTimerDeadline SetTimerElapsed ShowActivityShowActivityQueue ShowConfiguration ShowEngineShowLogFlags ShowProcessShowSession ShowStatus EngineEngine unit Primary engine unit Instrument Description ShowTimer Shutdown StartActivityStartDBService StartEngineStartGovernor StartTimer StartUnitTable A-2StartUnit Command Options StopTimer SuspendAllSessionsSuspendSession TerminateAllSessionsUninstall TerminateSessionUnRegisterAlias UnRegisterAssignmentRulesUnRegisterProcessDefinition UnRegisterUserProfile WaitForStartupConductor Script Commands Page Engine Database Schema Database Tables by CategoryDatabase Tables by Category Alphabetical Listing of Tables WFHActivityUsersDatabase Table See… Description Database Schema Reference WFHSessionRoleCurrent State Tables Table B-2Table B-3 Actname VARCHAR264 Abortraction NUMBER38Wuser VARCHAR264 NolinkeduserActivityname VARCHAR264 Tokcounter NUMBER38Wuser Not NUMBER38 Not VARCHAR264Table B-7 Table B-9 WFHControl Table B-10 WFHLocksLocktype NUMBER38 Atttype NUMBER38Attseglength NUMBER38 Attvalue VARCHAR2255Table B-12 Table B-12 WFHProcess Table B-13 Table B-15Seqnumber Not NUMBER38 Null Processid NUMBER38Reqstatus NUMBER38 Actionflag NUMBER38Table B-19 WFHSession Table B-20 Not VARCHAR2158Environment VARCHAR264 Engine VARCHAR264Table B-23 WFHTimer Timername State Relativetime Not NUMBER38Null Attname VARCHAR264 Attsegmentid NUMBER38Registration Tables Table B-23Currelativetime VARCHAR232 Table B-24History Log Tables Libraryname Not VARCHAR232Loadoptions Projectname Wusage CreatetimeTable B-26 Processid NUMBER38Logtime Date Table B-27Table B-28 WFHAlarmLog Alarmtype VARCHAR264Details VARCHAR2255 Table B-29 WFHAliasLogTable B-30 Table B-31Table B-32 Allocatepage Not NUMBER38 Activepage Not NUMBER38Table B-33 Parentprocid NUMBER38 Table B-34Parentprocid Table B-35 Table B-36Table B-38 WFHTimerLog Timername VARCHAR264Table B-37 Sessname VARCHAR264Table B-39 Relativetime VARCHAR232State Values Page Index Section B Section D Section E 284 Section L Section Q See also recovery 309 Section U