Configuring an Instance

Instances can be configured and then run. Configuration details for an instance are available under Config tab, and Log tab as discussed below in this section. If the log configuration details are updated when the instance is running, these changes are reflected only when the instance is run for the next time. All the individual log configuration preferences are read-only when the instance is started.

To configure an instance:

Enter instance details in Config tab to schedule the process to run.
Enter details for nodes configuration in Config tab.
View the log information and save log configuration in Log tab.
Click Apply to save the properties.

Select an instance on the left pane. Two tabs, namely, Config and Log are displayed on the right pane as shown below:

Generate Code & Running a Modeled Process_ Figure 11:

Config Tab

The Config tab consists of the following:

Instance
Operations Available
Nodes Configuration

Instance

The instance frame consists of Name, Status, Wait For and Run Once. Here, a process can be configured to run once or wait for a certain period of time.

Name of the instance is displayed in the Name field.
The status of the instance is displayed in Status field.
The Wait For field consists of a drop-down as shown below. Select a unit of measure from the drop-down. Time can be selected in Milliseconds, Seconds or Minutes.

Generate Code & Running a Modeled Process_ Figure 12:
Select the time period in Wait For field to run the process at regular intervals.
Select the Run Once checkbox to schedule the process to run only once. Also, when this checkbox is selected, the instance will be reloaded automatically after the process is completed and thus the instance will be ready for executing with out any manual reload.
At Invoked From field, the name of the application from which the instance is invoked recently will be displayed.
- Instance Runner: When an Instance is invoked from 'Instance Runner'.
- Scheduler: When an Instance is invoked from 'Scheduler'.
- Service API: When an Instance is invoked as 'Service API'.
- ETK Model: When an Instance is invoked from any other 'ETK Model'.i.e when a model is given as a destination.
- Command Prompt: When an Instance is invoked from 'Command Prompt'.

Operations Available

The operations available to schedule the process are:

Start- Click this button to start the process. The instance in the left pane turns green when the process starts running.
Stop-Click this button to stop a process. The instance in the left pane turns red when the process is stopped.
Download- Click this button to download the process.

Nodes Configuration

The fields displayed in the Nodes Configuration frame depend on the node types in the process. For an instance involving R2O, the Nodes Configuration frame would be as shown below:

Generate Code & Running a Modeled Process_ Figure 13:

R2O Node Configuration

The following are the fields available in the R2O node tab:

Fields	Description
Type	The type of node used in the process to transfer data.
Date Format	Select the format available in the list or test the new date format created
Connections	Connections � Name of the database connection
Connections	Display Names � The display name of the database

O2R Node Configuration

The following are the fields available in the O2R node tab:

Fields	Description
Type	The type of node used in the process to transfer data
Commit After	The number of rows for which the data should commit
Date Format	Select the format available in the list or test the new date format created
Connections	Connections � Name of the database connection
Connections	Display Names � The display name of the database

F2ORA Node Configuration

For an instance involving F2ORA node, the Nodes Configuration frame would be as shown below:

Generate Code & Running a Modeled Process_ Figure 14:

The following are the fields available in the F2ORA node tab:

Fields	Description
Type	The type of node used in the process to transfer data
In Bound Directory	The directory from which files can be extracted
Process Directory	Files extracted from In Bound Directory are moved to Process Directory when no error occurs while extracting
Error Directory	Files extracted from In Bound Directory are moved to Error Directory when an error occurs while extracting
File Extension	Extension of the file
Connection Name	Select the connection name of database from the list of values

Lock on Empty File: Select this checkbox to lock the instance when an empty file exists.
Lock on Data Errors: Select this checkbox to lock the instance when a file contains data error.
Lock If Database is Down: Select this checkbox to lock the instance when a database is down.
Lock on Missing File: Select this checkbox to lock the instance when a file is missing in a sequence and/or when a file is repeated.
Instance Locked: The checkbox for this option will be automatically selected when one of the above three cases is true when an instance in run, indicating that the instance is locked. Uncheck this option to unlock the instance.
Ignore Empty File and Update the File Sequence: Select this checkbox when a file with no data should be ignored for processing the file with out any error and for updating the file sequence.
Convert File: select this checkbox to enable the following fields:
- From Format: select the type of format for source file from dropdown list.
- To Format: select the type of format for destination file from dropdown list.
- Delete After Conversion: click on this radio button to delete the source file.
- Move To: click on this radio button to choose the directory for saving the converted file.

R2F Node Configuration

For an instance involving R2F node, the Nodes Configuration frame would be as shown below:

Generate Code & Running a Modeled Process_ Figure 15:

The following are the fields available in the R2F node tab:

Fields	Description
Type	The type of node used in the process to transfer data
Connection	Name of the database connection
Process Directory	Files extracted are moved to Process Directory when no error occurs while extracting
Error Directory	Files extracted are moved to Error Directory when an error occurs while extracting
File Name	Name of the file
File Name Prefix	Select the prefix for the file name. User can also select the tim stamp format by clicking on LOV button as shown in the figure.
File Name Suffix	Select the suffix for the file name. User can also select the tim stamp format by clicking on LOV button as shown in the figure.
File Extension	Enter the extension of the file

Sequencer Node Configuration

For an instance involving Sequencer node, the Nodes Configuration frame would be as shown below:

ETK_Figure 6_16_seq

Generate Code & Running a Modeled Process_ Figure 16:

Click on the '+ button' and select the instance for which Sequencer node configuration is to be done. Select the Ignore On Error checkbox corresponding to the instances for which the error should be ignored, if occurs while running a Sequencer, in order to continue the process of running the successive instances in a sequencer.

Sequencer Locked: The checkbox at this option will be selected automatically when an error occurs while running the selected instance. Unselect this checkbox for running an instance after correcting the error.
Lock if an Instance Errored: Select the checkbox at this option to lock the running of an instance automatically when an error occurs.

Note: When a sequencer instance is run and any of the instances in the sequence is failed to run then the successive instances in a sequence cannot run further and the sequencer instance will show an error and will also stop running.

When a scheduled sequencer instance is run and any of the instances in the sequence is failed to run then the successive instances in a sequence cannot run further and the sequencer instance will not only stop running in the current time interval but also in the successive time periods.

Log Tab

The Log tab is used to display the log configuration when a process is run as shown below. When an instance is run, the log details are displayed under tab, namely, defaultLog0.

Generate Code & Running a Modeled Process_ Figure 17:

When an instance is run in Service API cases, log details are displayed under the tab, namely, servicemessages0.

Generate Code & Running a Modeled Process_ Figure 18

Generate Code & Running a Modeled Process_ Figure 18:

The Log tab consists of a set of icons as explained below:

Click on Levels Log Config icon to configure and save the File Log and Email Log information. The Log Configuration Levels screen is displayed as shown below:

Generate Code & Running a Modeled Process_ Figure 19:

Enter the following details under File Log tab:

Enable- Check Enable to view File Log information
Log level- Select the Log Level from the list box. The options are:
Severe- message level that indicates a serious failure

Trace- message level that indicates highly detailed tracing message

Info- message level that provides informational messages

Debugging- message level that provides tracing information

Warning- message level indicating a potential problem
Name- Enter the name of the file to which the log information is to be saved.
File Size- Select the size of the file in kilo-bytes.
Rotations- Specify a number to display the specified number of tabs in the Log tab. By default, a single tab exists in the Log tab, namely defaultlog0. When the process is run, the log information is displayed in the tabs. If the information exceeds the numbers of tabs, the log information in the first tab is overwritten.
File Type- Select a file type to save the log information. It can be either Text File or HTML File.
Click Save to save the file log configuration.

Enter the following fields under Email Log tab:

InstanceRunner-EmailLog

Generate Code & Running a Modeled Process_ Figure 20:

Enable- Check Enable to view Email Log information.
Log Level- Select the Log Level from the drop down. These levels are same as in the File Log tab
Host- Enter the host name of mail server
Include Attachment-Select this checkbox when the log file is to be attached to the mail when any exception occurs.
Port- The port number of the mail server is displayed
Mail Authentication- If any client have mail authentication then select this checkbox.
From-specify the mail ID of a team/person from whom the mail is to be sent.
Password-When Mail Authentication checkbox is selected, the Password field will be enabled.
Enter email IDs in To and Cc fields. Enter subject of the mail in the Subject field.
Click Save to save the email log configuration.

Click the Find In Log icon to find certain text in the log information. The following screen is displayed:

Generate Code & Running a Modeled Process_ Figure 21:
- Enter the search criteria and click Find Next.
Click the Refresh Log icon to refresh the log information.
Click the Clear Log icon to delete the log information from the log tab.
Check Auto checkbox as shown below to configure the log information automatically. The log information would be refreshed automatically depending on the polling time specified.

Generate Code & Running a Modeled Process_ Figure 22:
- Enter time period in milliseconds in the Polling Time field.
- Click to apply the polling time configuration.