Configuring Ensemble Productions
Defining Reusable Items for Use in Settings
[Back] [Next]
   
Server:docs1
Instance:LATEST
User:UnknownUser
 
-
Go to:
Search:    

This chapter describes how to define certain reusable items for use as values of settings. It contains the following topics:

You might also need to define SSL/TLS configurations. For information, see Using SSL/TLS with Caché in the Caché Security Administration Guide.
Also see Defining System Default Settings in the next chapter.
Defining Business Partners
Ensemble provides a way to add additional information to an Ensemble production to help with the management of a production. A business partner profile is information about an organization or application connected to your Ensemble system. For each business partner, you can provide information such as the partner name, notes, primary and alternative contacts, and contact details. Defining a profile has no effect on the behavior or running of the production. It simply gives you a means to store more information.
For example, suppose your production talks to ABC Hospital and XYZ Hospital. You can enter profiles for both of these along with contact information. When you configure items that talk to these organizations, you can specify the defined Partner Name for each business host.
The [Ensemble] > [Configure] > [Business Partners] page allows you to view and edit profiles to store information about your business partners for use in your productions.
The page lists any Business Partner Profiles you have already defined and allows you to enter a new profile or edit an existing one in the right pane of the page.
Enter the required unique Partner Name and optional Description and then the following information for a Primary Contact and Alternate Contact:
Click Save to store this information in the current namespace. When you are configuring productions, this names appears in the Business Partner configuration setting list, which you can choose to use in your production enabling you to categorize business host items in your production by business partner.
To delete a specific business partner profile, select it from the list so it appears in the right pane and then click Remove.
Defining Credentials
Some remote systems require a username and password to log into that system. A username-password pair is a login credential. Ensemble permits you to store login credentials in a centralized, secure table; only users with appropriate access to the Management Portal can view and edit this table.
The [Ensemble] > [Configure] > [Credentials] page displays the Credentials table for the current namespace.
Each entry in the Credentials table has an ID which you use as the value of the Credentials setting when configuring business services or business operations for the production. Adding an entry to the Credentials table for a production consists of assigning an ID to a username-password pair. You can also store an informational business partner name with the credential.
The Credentials page displays a list of defined credentials associated with the current namespace. Each row in the table has the following columns:
When you select a Credential row, the right pane displays the current settings. If you do not select a row, the right pane shows empty fields for you to create a new credential. Enter values in the fields as outlined in the table description. You have the choice of two actions to perform in the Credentials Viewer:
Caution:
You cannot undo the Remove operation.
Defining Schedule Specifications
The default scheduling for business hosts is for them to run whenever the production is running. However, a finer control is possible. Not only can you enable and disable business hosts, but the [Ensemble] > [Configure] > [Production] page also provides a Schedule setting for each business host. This is an optional command string that schedules the item to be stopped and started at specific times and on specific days of the week, month, or year. When it is time to start, if the item is enabled, the scheduler starts it; when it is time to stop, if the item is running, the scheduler stops it.
The [Ensemble] > [Configure] > [Schedule Specs] page aids you in creating a string to use in this configuration setting. Once you create a schedule string and give it a name, you can use this string as a value for the Schedule configuration setting.
Schedule Specifications
The Schedule string is a comma-separated list of event specifications. Each event specification has the following format:
action:YYYY-MM-DDThh:mm:ss
Where each item in the event specification, from left to right, has the described values:
Item Possible Values
action START or STOP indicates the desired action
: Required separator
YYYY-MM-DD Either:
  • YYYY is the year as 4 numerals
  • MM is the month as 2 numerals
  • DD is the day of the month as 2 numerals
  • Any of these fields may be the single character * (asterisk) indicating all years, all months, or all days
Or:
  • YYYY is the word WEEK
  • MM is the specific occurrence of the day of the week (indicated by DD) in the month (01 = first occurrence of the specific day of the week in the month, 02 = second occurrence in the month, etc.)
  • DD is a specific day of the week (00 = Sunday, 01 = Monday, etc.)
  • MM may be * for all occurrences and DD may be * for all days
Once a field is specified as *, all fields to the left of it are also assumed to be *. Thus, if the DD value is *, the MM value is treated as * even if it has a specific numeric value. Similarly, if MM is *, YYYY is treated as *.
T Required separator
hh:mm:ss Hour, minute, and second
, Use the comma separator only if there is another event specification after the current one. Do not use it at the end of the Schedule string.
If you set a schedule specification to be deployable, then the specification can be included when you export the production. When you are exporting the production, select Deployable Settings and select the Ens.Util.Schedule setting.
See the Ens.ScheduleHandler entry in the Class Reference for more information.
The following sections provide examples, details on Daylight Saving Time considerations, and the intended use and limitations of the setting.
Examples
If your schedule contains recurring events, the Schedule setting requires both START and STOP actions. If your schedule setting is an absolute one time event, then you need only use the appropriate single START or STOP action. In most cases, Schedule strings should contain both a START and a STOP action.
Some examples of Schedule strings follow:
Scheduling and Daylight Saving Time
When daylight saving time (DST) begins, clocks skip an hour that day, usually from 2:00 a.m. to 3:00 a.m. Any item you have scheduled that falls into that nonexisting hour takes place at the beginning (which is also the end) of that hour. For example, on the day DST begins, an event scheduled to take place at 2:15 a.m. takes place at 2:00 a.m. (which is also 3:00 a.m.).
When DST ends, an hour of the day repeats, usually from 1:00 a.m. to 2:00 a.m. Any item you have scheduled that falls in that repeated hour takes place only once. Whether the event takes place on the first occurrence of the scheduled time or the second occurrence in the repeated hour depends on the operating system, but it only takes place once. For example, on a Windows system on the day DST ends, an event scheduled to take place at 1:15 a.m. takes place at the second occurrence of 1:15 a.m.
Intended Use and Limitations
The Schedule setting starts and stops production business hosts according to a schedule; it is not a task scheduler. The schedule string defines a square wave in time declaring during what time intervals the item should be running, in between which it should be not be running. Ensemble cannot prevent scheduled transitions from being interrupted or superseded by other production events.
The scheduler wakes up periodically (it sets its own alarm clock for when any scheduled item next expects a transition) and attempts to start or stop any items that are not currently in the expected state according to their schedule strings. It runs the UpdateProduction() method of the Ens.ScheduleHandler class and checks what event it needs to schedule next.
There are two general classes of things that can prevent transitions from taking place as the schedule string indicates:
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 provides better alternatives: