Sun Microsystems 3 manual Appendix a Conductor Script Commands 261

Page 9

Managing iIS Process Engines with Conductor Script (continued)

Monitoring Engines and Engine Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239

Monitoring the Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239

Monitoring Individual Engine Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

Changing Engine States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242

Changing Engine Unit States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242

Shutting Down Engine Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

Managing Registrations with Conductor Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

Making iIS Library Distributions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

Registering iIS Library Distributions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246

Unregistering iIS Library Distributions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

Managing Process Execution with Conductor Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

Monitoring and Managing Engine Sessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250 Monitoring and Managing Process Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252 Managing 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 and Managing Two-Phase Commit Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258 Monitoring Two-Phase Commit Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258 Managing Two-Phase Commit Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259

Appendix A Conductor Script Commands

261

Conductor Script Command Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261

Environment Mode Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

Engine Mode Commands: Engine Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264

Engine Mode Commands: Process Execution Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266

Component Mode Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271

Generic component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

Engine Unit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

Conductor Script Commands

273

AbortActivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273

AbortAllProcesses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274

AbortProcess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274

BroadcastMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275

CommitTransaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275

CompleteActivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276

ConsultActivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276

CreateActivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278

9

Image 9
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 Product Name Change PrefaceOrganization of This Guide Audience for This GuideALL Caps Text ConventionsSyntax Statements Other Documentation ResourcesIPlanet Integration Server Documentation Online HelpDocumentation Roadmap To copy the documentation to a client or server IIS Example ProgramsTo view and search the documentation Toolbar Button Keyboard Command Introduction iIS Process Management What Is an iIS Process Engine?What Is an iIS Process Engine? Multiple Engine Systems Workshops IIS Process Engine Components Minimal Engine Configuration2Minimal Engine Configuration 3Engine Configuration with Failover Failover ConfigurationIIS Process Engine Components Full Configuration Failover and Load Balancing Combined IIS ProcessEngine What Does an iIS Process Engine Do? IIS Process Management Tasks Setting up and Maintaining an iIS SystemSetting Up an iPlanet UDS Runtime Environment Installing iIS Process Management SoftwareSetting Up and Maintaining Central Development Repositories Managing iIS Process Engines Managing RegistrationManaging Process Execution IIS Console IIS Process Management ToolsConductor Script Utility Dump/Restore FacilitiesCustom 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 Backbone IIS Process System SoftwareProcess System Software Modules Details, see , Using the Conductor Setccomp.sh True False Compiled and Interpreted Engine ComponentsIIS Process System Configuration IIS Process System Software 2iIS Process System Configuration IIS Function Node type Server/Client Node Names Setting Up an iIS Process System IIS Process System Setup ProcedureTo set up an iIS process system IIS Installation Program Central Server Installation DLL Engine Server InstallationDevelopment Client Installation Runtime Client Installation Configuring and Starting Your iIS EnginesMaintaining an iIS Process System Adding New Nodes to an iIS SystemTo add a new node to an iIS system Creating a New iIS Repository Server Moving an iIS EngineMoving an iIS Repository Server To create a new iIS Repository ServerCreating a Private iIS Repository Upgrading an iIS SystemTo create a private iIS Repository on a development node Uninstalling an iIS System Overview IIS ConsoleOverview Starting the iIS Console Using the cconsole CommandTo start the iIS Console on Windows or Windows NT To start the iIS Console on UNIX, OpenVMS, or Windows NTIPlanet UDS System Management Guide for information about IIS Console Main WindowOff Engine is configured but has not been started Main Viewing PanelOnline Engine has fully started and is online Mouse Popup Menu Menu BarSetting Password Protection for iIS Console To set a password for iIS ConsoleExiting iIS Console Using the Mouse Using iIS Console WindowsWindow Refresh Behavior To turn automatic refresh off or onFiltering iIS Console Lists To set the automatic refresh intervalTo force an immediate refresh Specifying Values OperatorsExample Filter Expression Sorting iIS Console Lists 2iIS Console Browser Using List ViewsEnvironment Menu IIS Console Main Window Command SummaryEngine Menu View MenuMonitor Menu Help Menu Page Production Engines Versus Development Engines Managing EnginesProduction Engines Versus Development Engines Engine Component Partitioning Configuring an Engine1Engine Configuration with both Failover and Load Balancing Configuring an Engine 2Typical Engine Partitioning Scheme Engine Startup PropertiesConfiguring an Engine Sample configuration file is reproduced below Engine Configuration FileNodenameservicenamepriority DbservicesDatabaseuserpassword LogtimersDbservicestacksize DbservicememoryflagUnitrecovercursorsize GovernormemoryflagMonitordisplaylimit Customizing Engine Database SchemaUnitsessionreconnectlimit UnitsessionreconnectactionFORTEROOT/sysdata/conductr/clN/environment/enginename.dbs Code Example How to Configure a New EngineTo 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 Deleting an Engine Configuration Duplicating an Engine ConfigurationTo duplicate an engine configuration To delete an engine configurationGovernor Starting an EngineEngine Unit IdleBoth Embryonic OnlineStandby Primary Engine Unit Startup Phases Database Service InformpartnerStartupcomplete To start an engine How to Start an EngineData on To start individual engine components Reconfiguring an Engine How to Reconfigure an EngineTo reconfigure an engine Reconfiguring an Engine To modify database logging for an engine How to Dynamically Modify Database LoggingHow to Tune Process Execution Monitoring and Changing Engine States To check the engine runtime configuration Monitoring Engines and Engine ComponentsMonitoring the Engine To monitor individual engine components Monitoring Engine ComponentsUnit Startup Phases on Property Description Changing Engine States Changing Engine Unit StatesTo change the state of an engine unit About Recovering State Information Database Management Issues Managing an Engine DatabaseShutting Down Engine Components Recovering Data Growth of the DatabaseFailure of the Database Dumping Database Tables Dumping and Restoring DataTo use the Dump/Restore application to dump database tables Using the Dump/Restore ApplicationManaging 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 Wfdrengine Dump/Restore Environment VariablesWfdrdirectory WfdrdatafileAbout Registration Managing RegistrationsAbout Registration What Does Registration Do? Install distribution on engine nodes Registration in Production Environments Engine Registration Manager What Does Unregistration Do?2Subprocess Activity References About AliasesRegistering iIS Distributions Performing Registrations Registration OrderTo register one or more distributions using the iIS Console Unregistering iIS Distributions Upgrading RegistrationsRegistering Aliases To register an alias using the iIS Console Viewing Registrations for an Engine Unregistering AliasesTo unregister an alias Unregistering a Distribution To view the registrations for a given engineTo unregister a registered distribution To monitor instances of a registered process definition Monitoring Instances of a Registered Process DefinitionPerforming Application Upgrades To perform a monolithic upgrade Monolithic UpgradesTo perform a rolling upgrade Rolling UpgradesPage Introduction Managing Process ExecutionEngine Sessions ActiveSuspended Reconnectioninprogress Disrupted SessionsTerminate SuspendReconnectallowed ReconnectprohibitedExplicitly Terminated Sessions Explicitly Suspended SessionsActivity States PendingReady Aborted CompletedActivity State Activity Types Process ExecutionProcess Instance Creation Activity Creation Process Instance ExecutionOffered Activities Activity ExecutionQueued Activities Subprocess Activities Automatic Activities Activity TerminationCompleted Activities Process Instance Termination Monitoring and Managing Engine SessionsCompleted Process Instances Aborted Process InstancesTo obtain state information about a session Monitoring the State of a SessionMonitoring and Managing Engine Sessions Managing Sessions Suspending or Terminating SessionsTo suspend a session Sending and Broadcasting Messages to Sessions To terminate a sessionTo send a message to an active session Monitoring and Managing Engine Sessions To broadcast a message to all sessions Monitoring and Managing Process ExecutionSession Managing Process Instances Checking the Status of a Process InstanceTo check the current execution status of a process instance Monitoring and Managing Process Execution Monitoring and Managing Process Execution To abort a process instance Aborting a Process InstanceChecking the Status of an Activity Managing Activity InstancesChanging the State of an Activity To change the state of an activity To view the contents of an activity queue Managing Activity QueuesChecking the Status of an Activity Queue To reprioritize a queued activity Reprioritizing a Queued ActivityMonitoring and Managing Process Execution Checking the Status of a Timer Managing Timer InstancesTo change the state and expiration time of a timer Changing the Timer State and Expiration TimeChecking the Value and Lock State of a Process Attribute Managing Process AttributesChanging a Process Attribute Value Removing a Process Attribute Lock To change the value of a process attributeTo remove a process attribute lock To find a process bottleneck Checking for Bottlenecks in Process ExecutionAnalyzing Process Execution State Values History Log SchemaPreparecreate CreatedOFF Monitoring and Managing Two-Phase CommitExpired TerminatedIIS Process Engine Operations Monitoring and Managing Two-Phase Commit Managing Two-Phase Commit Operations Troubleshooting Introduction Process Engine Alarms Window To register an engine with the alarm service Monitoring AlarmsTo filter alarms in the Process Engine Alarms window To unregister an engine from the Alarm serviceTo search for an alarm in the Process Engine Alarms window Viewing AlarmsTo remove an alarm from the Alarm window To get detailed information about an alarmEngine Log Files To view an engine component log file Messages and Message Filters IIS Console Trace Window1Specifying iPlanet UDS Message Output Filters Specifying Message FiltersMessage type trc debug IIS Message FiltersUsing the iIS Console Trace Window Setting Message FiltersTo open the iIS Console Trace window To set message filters for a selected engine IIS Console Engine Event Filter Window Special Example Write Client Messages to Trace WindowTo set the engine tracing Using the iIS Console Engine Event Filter Window Engine Event TypesTo open the Engine Event Filter window Displaying Process Instance Events Displaying All Engine EventsTo view all engine events for the selected engine To view all engine events for an existing processEvents for the specified process instance display Performance Charts Filtering Engine EventsTo specify a custom filter Viewing Performance Indicators To view performance indicators for an engine Performance Charts Logging Performance Information To log performance informationTo stop logging performance information Page Using the Conductor Script Utility Starting Conductor Script Conductor Script HelpTo start Conductor Script on Windows or Windows NT To start Conductor Script on UNIX, OpenVMS, or Windows NT Using the Cscript CommandWorking with Conductor Script See SetPath General Conductor Script OperationsComments Writing and Executing ScriptsFile Operating System and File Management CommandsCopy a specified file in the local file system Starting an Engine Managing iIS Process Engines with Conductor ScriptStarting Individual Engine Components To start an engine where delays might be involvedStart all components Example Manual Startup Scenario Monitoring Engines and Engine Components Monitoring Individual Engine Components FindDBService State Making iIS Library Distributions Managing Registrations with Conductor ScriptTo make an iIS library distribution Include a plan as a To register an iIS distribution with an engine Registering iIS Library DistributionsUnregistering iIS Library Distributions Unregister the specified Alias from the current Engine To unregister an iIS distribution from an engineManaging Process Execution with Conductor Script Monitoring and Managing Engine Sessions To suspend or terminate a sessionTo send a message to one or more sessions Send a message with Managing Process Instances Monitoring and Managing Process ExecutionManaging Activity Instances To check the status of a process instanceTo list the contents of an activity queue Managing Activity QueuesTo reprioritize an activity in a queue To check the status of a timer Managing TimersManaging Process Attributes To check the value or lock state of a process attributeTo remove an attribute lock Checking for Bottlenecks in Process ExecutionPlace the specified activity List all existing event filters for Current engine Monitoring Two-Phase Commit Operations Monitoring and Managing Two-Phase Commit TransactionsCommits the in-progress Managing Two-Phase Commit OperationsTo resolve transactions after a client or engine failure Conductor Script Command Summary Conductor Script CommandsEnvironment 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 Engine Unit Generic componentAbortActivity Conductor Script CommandsAbortProcess AbortAllProcessesCommitTransaction BroadcastMessageConsultActivity CompleteActivityActivity instance to be delegated CreateActivity Event Type CreateFilterObject Instance Object ClassExamples DelegateActivityActive DeleteFilter FindDBServiceFindGovernor FindEngineFindNode FindParentEngineFindPrimary FlushLog FindUnitIIOPServer ListActivitiesListActivityQueues ListConductorDistributions ListEngines ListFiltersListProcesses Options ListRegistrationsListTimers ListSessionsListTransactions ModLogFlags MakeConductorDistributionReadyActivity RegisterAssignmentRules RegisterAliasRegisterUserProfile RegisterProcessDefinitionRegisterValidation RemoveWriteLock RemoveReadLockRollbackTransaction RollbackActivityCritical SendMessageSetAttributeValue SetPasswordSetQueuedActivityPriority SetPrimarySetState SetTimerSetTimerDeadline ShowActivity SetTimerElapsedShowActivityQueue ShowEngine ShowConfigurationShowProcess ShowLogFlagsShowSession Engine ShowStatusEngine unit Primary engine unit Instrument Description ShowTimer StartActivity ShutdownStartEngine StartDBServiceStartGovernor StartUnit StartTimerTable A-2StartUnit Command Options SuspendAllSessions StopTimerTerminateAllSessions SuspendSessionTerminateSession UninstallUnRegisterAssignmentRules UnRegisterAliasUnRegisterProcessDefinition WaitForStartup UnRegisterUserProfileConductor Script Commands Page Database Tables by Category Engine Database SchemaDatabase Tables by Category WFHActivityUsers Alphabetical Listing of TablesDatabase Table See… Description WFHSessionRole Database Schema ReferenceTable B-2 Current State TablesTable B-3 Abortraction NUMBER38 Actname VARCHAR264Wuser VARCHAR264 NolinkeduserTokcounter NUMBER38 Activityname VARCHAR264Wuser Not NUMBER38 Not VARCHAR264Table B-7 Table B-10 WFHLocks Table B-9 WFHControlAtttype NUMBER38 Locktype NUMBER38Attseglength NUMBER38 Attvalue VARCHAR2255Table B-12 Table B-12 WFHProcess Table B-15 Table B-13Null Processid NUMBER38 Seqnumber Not NUMBER38Reqstatus NUMBER38 Actionflag NUMBER38Table B-19 WFHSession Not VARCHAR2158 Table B-20Environment VARCHAR264 Engine VARCHAR264Timername State Relativetime Not NUMBER38 Table B-23 WFHTimerNull Attname VARCHAR264 Attsegmentid NUMBER38Table B-23 Registration TablesCurrelativetime VARCHAR232 Table B-24Libraryname Not VARCHAR232 History Log TablesLoadoptions Projectname Wusage CreatetimeProcessid NUMBER38 Table B-26Logtime Date Table B-27Alarmtype VARCHAR264 Table B-28 WFHAlarmLogDetails VARCHAR2255 Table B-29 WFHAliasLogTable B-31 Table B-30Table B-32 Activepage Not NUMBER38 Allocatepage Not NUMBER38Table B-33 Table B-34 Parentprocid NUMBER38Parentprocid Table B-36 Table B-35Timername VARCHAR264 Table B-38 WFHTimerLogTable B-37 Sessname VARCHAR264Relativetime VARCHAR232 Table B-39State Values Page Index Section B Section D Section E 284 Section L Section Q See also recovery 309 Section U
Related manuals
Manual 30 pages 14.51 Kb