In this section: |
You can control many key aspects of DataMigrator Server operations directly from the DMC.
The DMC allows you to:
You can set up your DataMigrator Server to send an e-mail message that notifies recipients of the successful completion or failure of every flow execution.
In addition, from the DMC, you can enable the distribution of e-mail messages at any point in a process flow.
However, to enable either variation on the e-mail notifications process, you must first configure a SMTP service. (You need to set up your server for e-mail before it will work anywhere in the flow.)
Note: You must be logged on as a Server Administrator with the appropriate privileges to make these configurations.
The Scheduler Configuration window opens, as shown in the following image.
The DataMigrator Scheduler runs as a task under the iWay DataMigrator Server. The Scheduler must be running to submit flows and stored procedures, to execute scheduled data flows, and flows that run in parallel groups in a process flow. The following image shows the Scheduler Configuration window.
The Scheduler Configuration window contains the following fields/options:
Scans for flows to run under the ID listed. The Application Path specified in the user’s profile is utilized.
Is how often, in seconds, you want the Scheduler to check for execution of flows. The default value is 60 seconds.
Specifies whether the Scheduler should check for flows automatically. The options are:
yes automatically starts the Scheduler when the server starts. This is the default value.
no does not start the Scheduler when the server starts.
Note: The Scheduler must be running to execute not only scheduled data flows, but also restarted flows and flows run in parallel in a process flow.
Determines the user ID that is associated with a scheduled flow when it is run. sched_run_id affects the application directories available to the flow, as well as access to relational data sources and source servers in the profile used by the administrator.
Note: Flows submitted from the DMC, the Web Console, or CMRUN are run under the user ID that submitted the flow.
Valid values are:
Runs flows under the first ID that appears in the list of server administrators displayed on the Access Control page. If the ID does not have a password specified, a profile for that user ID must be created. server_admin_id is the default.
This setting enables access to all data sources and source servers in the path specified by that server administrator profile.
Runs flows under the user ID that was used to save the flow. The Application Path specified in the users profile is utilized.
If security is ON and you set sched_run_id to User, to run a scheduled flow for a certain user id:
If a DataMigrator user with an APPLICATION-level ID wants to run scheduler requests:
This is the agent service that the DataMigrator Scheduler will use when running DM flows. If this is not set, the DEFAULT service will be used.
Specifies the time interval between restart attempts for all restartable flows. The default value is 60.
Note: This value cannot be less than 0.
Specifies the number of times that failed agents will be restarted. If the value is 0, they will not be restarted. If it is -1, they will be restarted indefinitely. The default value is -1.
Specifies how often CMASAP agents are removed from the agents list (in seconds. When set to -1, this is never. The default value is -1.
Maximum number of lines that the DataMigrator Scheduler is to write to the log for each flow. When the maximum number of lines is reached, logging stops. When set to -1, the number of lines is unlimited. When set to 0, there is no logging.
Specifies the maximum time interval in seconds that can elapse before log data is committed to the DataMigrator log. The default value is 10.
Specifies the maximum number of log lines to collect before committing them to the DataMigrator log. The default value is 1000.
Select this option to set the output from a report to go to the log. Only text output is displayed to a maximum width of 80 characters. This is the prior behavior.
Note: To view report output, in the browser right-click on the flow name and select Logs. Then select Last Output to view the output from the last run, or select Log and Statistics, for Report Range select All, and then right-click the job id in the report and select Show Output.
The options are:
On Start sends an e-mail when the scheduler starts.
On Completion sends an e-mail when the schedule completes.
On Failure sends an e-mail if the schedule fails.
Indicates when to send e-mail for all flows that run. The options are:
off does not send e-mail for every flow, however, you can send e-mail per flow from the DMC. This value is the default.
Tip: If you wish to send e-mail notification on a per-flow basis, select the Notify check box in the Properties panel of your DMC.
completion sends e-mail when every flow has been completed.
failure sends e-mail when every flow fails.
Note: Before you can use e-mail notification, you must configure an email server. For more information, see How to Configure the Server for E-mail Notification.
If the scheduler is running, select Stop Scanning.
If the scheduler is not running, select Start Scanning.
APPLICATION-level administrators can change their configured passwords from the DMC.
The User Information dialog box opens, as shown in the following image.
Note: Changes to the password will take effect the next time the server or scheduler is restarted.
To enable e-mail notifications, you must first configure an SMTP service. (You need to set up your server for e-mail before it will work anywhere in the flow.)
The E-mail SMTP Server dialog box, as shown in the following image.
Note: If an antivirus program is running on this computer, please make sure that the processes edapgwy.exe and edaplog.exe are excluded
Never send e-mail.
Send e-mail when a flow finishes.
Send e-mail when a flow fails.
Note: This setting applies to every flow.
The Miscellaneous Settings dialog box opens, as shown in the following image.
For details on the server configuration, see the Server Administration for UNIX, Windows, OpenVMS, IBM i, and z/OS manual.
Application settings control some aspects of use of application directories. You must be a server administrator to change any of these settings, and they require a restart of the server to take effect.
To change server application settings:
The Applications Settings dialog box opens.
When you connect to the server a temporary directory called foccache is added as the first directory in the search path. When you want to be able to reuse data within the same session, you can store the data in the form of a HOLD, SAVE, or SAVEB file in the foccache directory. As long as the session remains active, the files stored in the foccache directory can be referenced in requests. Foccache is also used to store some system created temporary files.
The following options are available:
Defines the location of the foccache directory. The default location is edatemp/foccache/....
Defines the maximum number of minutes that a foccache directory will last. When the maximum foccache retention time is reached, the foccache directory is removed by the server and can no longer be referenced. The default is 180 minutes.
When set to y, nested applications are enabled. This is the default value. To disable, set to n.
A home application directory provides each user with a private application directory with full access privileges to store private focexecs and data for the test runs and ad hoc reports.
The operating system specific pathname. Defines the location of home application root directory. If defined, each connected user will see the My Home applications folder on the Application tree. User can create new applications (home applications) in this folder. These applications will be visible and available only to the connected user and the server administrators. The user will have full access to their home applications. For this setting to work nested_app should be set to y.
Global variables can be used by various users, regardless of the fact that each user has their own profile, by changing a listener configuration property.
Note: This is available for HTTP Listener only.
The Listener Configuration window opens.
The values of any global variables will now be kept active as long as you stay connected to the server.
iWay Software |