Job scheduler (jsh) Row Edit

Name

Select (...) and select the name of the jsh record from the Select dialog box.

Description

Enter a description of the record. The Description can be up to 47 characters in length. This field is for information purposes only and can be used to describe the record, its association with other points, or any other textual information. The Name and Description configured for a record appear in the summary tables in easy eXtended Operator Station (ezXOS).

Dataset

Select (...) and select the name of the dataset you want to associate with this record from the Dataset Select dialog box.

A dataset contains privileges assigned for each system and mode. Once a record is assigned to a data set value, the dataset can only be changed to a value for which the system has a privilege record. A record’s dataset can not be changed in such a way that the system can no longer access the record.

Configure Scheduled Time

Select to open the JSH Schedule dialog box. This dialog box is used to set the date and time a command will run or set the command to run periodically.

Refer to Configure the schedule of a task for more information.

Month

This field states which month the command will run. Select Configure Scheduled Time to edit this value.

Day

This field states which day the command will run. Select Configure Scheduled Time to edit this value.

Time

This field states the time when the command will run. Select Configure Scheduled Time to edit this value.

RSI

This field states the periodic interval at which the command will run. Select Configure Scheduled Time to edit this value.

Command Type

Select the command type. The choices are as follows:

• SCRIPT — This is the most common choice. This works for running either executables or scripts.

• C — This is used by the job scheduler to execute C code directly.

Command

Enter the command to be executed or select (...) and select a command from the Schedule Command Edit Form dialog box.

When typing a command, it is not necessary to provide the full name of the script or executable if the command is located in the RealTime bin or scripts folder. However, if the command is not located in either of those folders, you must specify the full path to the file.

Environment variable macros are also supported. For example, %DNAInstallRoot%\%DNASiloName%\bin and %DNAInstallRoot%\%DNASiloName%\scripts will evaluate to the installed RealTime bin and scripts folders, respectively.

Service Location

Select the RealTime service on which the command should be executed. The choices are:

• Hot. The command is executed on a Hot RealTime service.

• Standby. The command is executed on a standby RealTime service.

• Both. The command is executed on both services.

Command Argument

If the command is an executable program or script, enter the input parameters in the Command Argument field. Multiple parameters are permitted, exactly as if you were executing the command from Windows PowerShell.

If the command is a C function, enter only one parameter.

Important: The one C function parameter must be an integer.

Enable Execution

Select the checkbox to activate the command. This should be done after the scheduling is set up. When the specified time occurs, the command is sent to the process or script. The command executes the program and passes any configured parameters into the program’s variables. A value is obtained or a control functions is performed within the system. The transaction occurs every time the configured time has elapsed.