|
|
Open source tools written in Java. Sponsored by Acelet corporation |
| |Home | Products | Documents | Downloads | Partners | Contact | |
Set Job Tour
This is a side tour of the SuperScheduler tutorial. If you have not taken the SuperScheduler tour, please do so first.
Job is the process for Task. It is the action object of Task. The job objects are the same for both SuperScheduler and SuperWatchdog. Task contains other information as well. For tasks of SuperScheduler, tasks contain timing information; for tasks of SuperWatchdog, tasks contain trigger information.
When you set the job for a task, you need to choose a job type and define the job parameters for the task. Each job type has its own parameters.
First, we need to open Set Job Panel by going to the main menu and click Module > SuperScheduler > Scheduler Doer > Add. The Task Panel appears.
Then click the Set Job button. The Set Job Panel appears.
 |
There are a list of job types shown on the panel. Each job type has its own parameters, so the related GUIs are different. To set a job, highlight the Job type and click on the Define button. Then set parameters if needed. |
When a job is defined, you go back to the Task panel. You will see a brief information about the job.
Some jobs are imported. In that case, when the job is created, it reads the original data file and save a private copy of the data with the task. From that time on, the two copies of data are independent. When the job runs, it gets data from the private copy in task database. The original data file is not needed for execution. Any change on the original data will not be seen by the task. If you want to modify the job for SuperScheduler or SuperWatchdog, you need to modify it from clicking on the Define button of Set Job Panel. Of course, anything changed here will not affect the original data file.
A composite job consists of one or more member tasks. The member tasks are executed according to the order listed. If any member task generates errors during the execution, the rest of the member tasks will not be executed. But this composite job will still be eligible to run at the next scheduled time as usual.
A member task must be an atomic job: composite jobs and retry jobs are not eligible to be members of another composite or retry jobs.When the Define button of Set Job Panel is clicked, the Member Task List Panel appears,
Click the Add button, the Task Name List Panel appears.
Click Ok, we come back to the Member Task List Panel. The jobs we chose are shown on the panel.
Click Ok button to finish and go back to the Set Job Panel.
Deployment job is to deploy J2EE applications. When the Define button of Set Job Panel is clicked, a Deployment Parameter Panel will appear. This panel is J2EE vender dependent. The behavior of deployment is vender dependent too. The parameters (attributes) on the panel specified by your J2EE server. Please consult the document of your server for description. SuperScheduler and SuperWatchdog will bring the right version or the Deployment Parameter Panel for the server you use.
Click Ok button to finish and go back to the Set Job Panel.
EJB (Poke) job is used to run EJB (Enterprise Java Bean) applications. EasyEJB is used as the tool to generate a .ejbPoke data file, which is a XML formatted ASCII file. Because EasyEJB can lists all available JNDI names and all available methods for you to choose, you can visually set EJB jobs without programming. It make setting EJB jobs very easy. See EasyEJB tutorial for related information.
The Define button of Set Job Panel will bring:
Import EJB Poke File window
The Import EJB Poke File window appears. Select a pre-saved .ejbPoke file to import. In the EasyEJB tutorial, we have saved a poke job setWinningNumber.ejbPoke.We take that as an example now.
After the file is imported, there will be no relationship between the original file and the job in this task. See Note for imported data for related information.
Highlight that file and click on the Import button.
EJB Poke Panel
The EJB Poke Panel appears.
It is similar with Edit Data Panel in EasyEJB tutorial. The main difference is that Shown name is not editable, because we do not need to change it. We can change the input value if you want.
Click Ok button to finish and go back to the Set Job Panel.
To run Email jobs, first you need to set your email server. Go to the main menu. Click on System > Mail Server. The Mail Server Panel appears. Define the Mail host. If the Email server requires authentication is checked, define the Mail host users name and password. If you don't know the parameters, ask your system administrator for help.
Now, let's see how to set an email job.
When the Define button of Set Job Panel is clicked, the Email Parameter Panel appears (if you haven't set up the mail server at this point, the Mail Server Panel will appear for you to set up your mail server).
Fill in all the email information to the text fields. Then click Ok back to the Set Job Panel.
Ftp job is a tool to copy files cross computers.
When the Define button of Set Job Panel is clicked, Ftp Parameter Panel will appear:
Fill in all the parameters. Then click Ok back to the Set Job Panel.
Java job is an Operating System job. The main difference is you do not have to provide "java" as the first parameter for your command name.
See Operating System job for more information.
JMS message job is used to send message for JMS (Java Message Service). EasyJms is used as the tool to generate a data file, which is a XML formatted ASCII file. Because EasyJms can lists all available destinations and all available factory for you to choose, you can visually set JMS message jobs without programming. It make setting JMS message jobs very easy. See EasyJms tutorial for related information.
See JMS message job for related information.
The Define button of Set Job Panel will bring:
Import JMS message File window
A JFileChooser window appears. Select a pre-saved file to import. In the EasyJms tutorial, we have saved a message file jmsExampleTopic.message. We take that as an example now.
After the file is imported, there will be no relationship between the original file and the job in this task. See Note for imported data for related information.
Highlight that file and click on the Import button.
JMS message Parameter Panel
The JMS Message Parameter Panel appears. The panel is inherited from Message Panel. The main differences are: the Send and Export buttons are removed.
Click Ok button to finish and go back to the Set Job Panel.
Both JMS Queue and Topic jobs are supported. You need to configure your J2EE server to provide a message factory before defining JMS jobs:
See JMS Queue and Topics for more information.
When the Define button of Set Job Panel is clicked, one of the following panels will appear:
Click Ok button to finish and go back to the Set Job Panel.
MBean job is used to run MBean or JMX (Java Management eXtension) applications. EasyJMX is used as the tool to generate a data file, which is a XML formatted ASCII file. Because EasyJMX can lists all available MBeans and all available methods for you to choose, you can visually set MBean jobs without programming. It make setting MBean jobs very easy. See EasyJMX tutorial for related information.
The Define button of Set Job Panel will bring:
An MBean panel can be Mbean Set Attribute Panel, Mbean Operation Panel or other panel, depending on the job. SuperScheduler and SuperWatchdog will bring the right panel.
Import MBean File window
The Import MBean File window appears. Select a pre-saved file to import. In the EasyJMX tutorial, we have saved a poke job setWinningNumber.mbeanSetAttribute. We take that as an example now.
After the file is imported, there will be no relationship between the original file and the job in this task. See Note for imported data for related information.
Highlight that file and click on the Import button.
MBean Panel
The MBean panel appears.
It is similar with related panel in EasyJMX tutorial. The main difference is that Item name is not editable, because we do not need to change it. We can change the input value if you want.
Click Ok button to finish and go back to the Set Job Panel.
Operation system job may be machine dependent jobs. When use those jobs, you may need to specify a desired host or hosts for the job.
When the Define button of Set Job Panel is clicked, the Command Parameter Panel appears, fill in a command to the Command field and fill in other information to other fields if need.
Command:
Windows: date /T
Linux: ls -l
Windows: d:\marketing\bin\myscript.bat
Unix: /usr/local/bin/compScript.sh
>cat myscript.bat pwd > d:\tmp\outputFile
-classpath super.jar com.acelet.s.scheduler.TestJava
java -classpath super.jar com.acelet.s.scheduler.TestJava
Environment: The environment variable-value pairs, delimited by comma (",") for both Unix and Windows. If you leave this field empty, the job inherits the environment settings of Super. The environment variables are for sub-process only. You can not expect the system to use the PATH specified here for finding your executive file. It is recommended that the command must be a full name with absolute path. For example:
Unix: CLASSPATH=/home/me/abc.jar, PATH=/home/abc:/home/xyz
Windows: CLASSPATH=c:\mydir\abc.jar, PATH=c:\abc;d:\xyz
Working directory:: The directory to start the job. It must be a valid operating system file directory. If this field is empty, the job inherits the current working directory.
Here we set an operation system job:
click Ok back to the Set Job Panel.
Retry job is similar to Composite job. The only difference is: when a member task executes successfully, the Composite job will continue to run the next member task, but the Retry job will stop. See Composite job for detailed information.
Scp job is Secure CoPy job. When the Define button of Set Job Panel is clicked, the Scp Parameter Panel appears:
Fill in all the parameters. Then click Ok back to the Set Job Panel.
Server Shutdown job is to shutdown J2EE servers. When the Define button of Set Job Panel is clicked, a Server Shutdown Parameter Panel will appear. This panel is J2EE vender dependent. The behavior of shutdown is vender dependent too. The parameters (attributes) on the panel specified by your J2EE server. Please consult the document of your server for description. SuperScheduler and SuperWatchdog will bring the right version or the Server Shutdown Parameter Panel for the server you use.
Click Ok button to finish and go back to the Set Job Panel.
Servlet or JSP jobs are supported for using the POST method, with or without BASIC <auth-method> setting.
When the Define button of Set Job Panel is clicked, the URL Parameter Panel appears, fill in the URL and other fields as need.
URL: It must be a full name of URL, including protocol, for example, http://www.mydomain.com/test.jsp.
User name and Password: If the the URL requires user authentication, you must fill in the User name and Password.
Send data to host class name and Data: Please read the SendDataToHost for detailed information.
Click Ok button to finish and go back to the Set Job Panel.
Shutdown Super job is to shutdown Super (GUI client) or SuperScheduler daemon or SuperWatchdog daemon.
It does not require any parameter. The Define button is invisible.
Click Ok button to finish and go back to the Set Job Panel.
Ssh job is Secure SHell job. When the Define button of Set Job Panel is clicked, the Ssh Parameter Panel appears:
Fill in all the parameters. Then click Ok back to the Set Job Panel.
Test job is for testing only. It simply print testing information.
It does not require any parameter. The Define button is invisible.
Click Ok button to finish and go back to the Set Job Panel.
