Managing Ensemble Productions - InterSystems Documentation

What to Manage
For example, an item could be in a Read timeout or some other busy state that lasts longer than the Update timeout.
Another example is a configuration item the scheduler starts cannot be stopped by the scheduler if the item is in the
middle of a synchronous call. The configuration item must wait for a response to the call before the scheduler stops
it. See the “Working with Messages” section.
• The other is if the scheduler itself is prevented from waking up at the intended time. Examples of conditions that could
cause this: the CPU is busy, a queue builds up of the alarm clock messages for the scheduler, the scheduler is itself
disabled or crashed, the production is down, etc. The scheduler is not guaranteed to wake up during any particular
interval, and when it does wake up it only looks at the intended state for the current moment, not at any history of when
it should have woken up.
Use of the schedule setting is not intended or designed as an event signaling device. It is intended to accommodate planned
outages and scheduled intervals of activity or inactivity. If you have events that you must trigger at a particular time or as
soon as possible thereafter, Ensemble offers better alternatives:
• You can configure your business service to use an inbound adapter with the implemented OnTask() method where
you call the business service. Ensemble provides classes for many types of inbound adapters. See the Ens.InboundAdapter
entry in the Class Reference and the books in the Ensemble Adapter Guides set for details.
• If you do not want to use an adapter, you can call the business service programmatically and schedule it to run using
the [Home] > [Task Manager] page (/csp/sys/op/UtilSysTaskHome.csp) in the Management Portal. This gives you finer
control in situations such as the system being down at 1:00 a.m.
The recommended approach is to configure the business service with Pool Size = 0 and then use the Task Manager to
launch a task that calls CreateBusinessService on it and invokes ProcessInput() on the resulting service instance
object. The advantage of calling a business service this way is that you call it at the time you want and it runs only
once. If Ensemble happens to be down at that time, your task can register an error. See the following sections for
details:
– “Using the Task Manager” section of the “Managing Caché” chapter of the Caché System Administration Guide
– “Invoking a Business Service Directly” section of the “Business Services” chapter of Developing Ensemble
Productions
3.3.5 Assigning Configuration Items to Categories
The [Ensemble] > [Productions] > [Configuration] page offers a Category field for each configuration item. This is an optional
text label that you can use to visually group configuration items within the production diagram.
Once you have provided Category values for configuration items, when you are viewing the production configuration diagram
you can right-click on the background of the diagram. Choose Show Category and a category name from the context menu.
The diagram changes to reveal only those configuration items that match the Category name you have just selected. The
diagram displays the Category name at the top left of the diagram, below the production name.
Alternatively, when you choose Show Category, select All (the first option) to reveal all configuration items, regardless of
category.
Each category name is case-sensitive, and it may contain spaces. You may assign a configuration item to more than one
category by providing a comma-separated list of category values in the Category field. Do not use leading or trailing spaces
around these commas, as these are interpreted as characters within the label and can prevent what would otherwise be a
proper match. Use:
TEST,My Test Category,MINE
Not:
TEST, My Test Category , MINE
28 Managing Ensemble Productions