Page History

...

1. Start JobScheduler
2. Open the JobScheduler Object Editor (JOE)
3. Open the JobScheduler Live Folder:
   1. A sub-folder "tutorials-5-jade-jitl-job" of the live folder is used in this tutorial for all the objects.  
      A copy of this sub-folder can be downloaded from ????
4. In the left hand pane of JOE mark the Jobs icon - opening the JobScheduler icon if necessary.
5. Start the wizard function by clicking on the button of the same name as shown in the screenshot below.
   
   
   
   
6. Select Order controlled job in the small window that opens and then Next, which will open the Import Jobs window as shown in the next screenshot.
   
   1. Enter a Jobname such as jitl_job_1.
   2. In the Jobs pane, scroll down until the two JADE Jobs are visible and select the job with the jadeJob.xml file name.
      This will cause the Title field to be filled with "API Job for JobScheduler ...."

   3. Click on the Finish button to create the new job and close the wizard.

      Info
      title Deprecated Parameters
      Note that use of the wizard to configure the job parameters as described in Tutorial 4 - Configuring and Running a JITL Job  - i.e. proceeding by clicking on Next instead of Finish - is not recommended for this job. This is because in releases up to and including 1.9 the wizard uses deprecated parameters which considerably restricts the configurations possible for the JITL Job. For more information see Jira server SOS JIRA columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution serverId 6dc67751-9d67-34cd-985b-194a8cdc9602 key JITL-201 .

      
      
      
      

7. You will now be returned to JOE's Jobs tab.
   • Open the jitl_job_1 element you have just created In the editor's left hand Scheduler Elements pane and select the Parameter element as shown in the next screenshot.
     
     
     
     
8. Now enter the JITL job parameter name/value pairs.
   
   • There are a number of approaches that can be taken to specifying the parameter name/value pairs:
     • Use the job Parameter form shown to enter parameter pairs and store the information in the job configuration. This is the simplest approach and will be described first in this tutorial.
     • Specify a settings.ini file and Profile in job Parameter form and then enter the necessary parameters in this file using a text editor. This procedure is described in the Use of a Profile and settings.ini file section of this tutorial.
     • It is also possible to create a custom JITL job by duplicating the JADE JITL jjob job in the JobScheduler data jobs folder and directly editing this file. This procedure is outside the scope of this tutorial.

   • The values of the necessary parameter name/value pairs can be taken from the list below:

     Code Block
     language text title JADE Parameter Settings
     [ftp_server_2_local] operation = copy source_host = test.sos-berlin.com source_protocol = ftp source_port = 21 source_user = demo source_password = demo source_dir = / target_host = localhost target_protocol = local target_dir = ${USERPROFILE}\jade_demo\a

   • The use of the job Parameter form is very similar to the use of the JITL job parameter wizard already mentioned. The use of the wizard was described in the Configuring and Running a JITL Job tutorial and the use of the Parameter form should therefore not require any further explanation.
9. The Job Parameter form will appear as shown below once the parameter pairs have been entered:
   
   
   
   
   • Note that the value of the target_dir parameter shown in the screenshot has been changed from the parametrized value used in JADE (${USERPROFILE}\jade_demo\a) to an absolute value.
     This is because the JobScheduler on the system used to develop this tutorial does not run under the normal Windows user account and therefore the ${USERPROFILE} variable would return the wrong path.
   • Information about finding exact JADE parameter definitions is given in the JobScheduler - Tutorial 5 - The JADE JITL Job - Configuring and running a simple file transfer job section in this tutorial.
10. Create a new job chain for the job:
    
    
    
    
11. Add the job to the job chain along with two end nodes as shown:
    
    
    
    
12. Create and configure an order for the job chain:
    
    
    
    
13. Don't forget to save the configuration as shown:
    
    
    
    

14. Start the Order in JOC, the JobScheduler Operations Center using the Order menu button as shown
    
    

    
    
    
15. Open the log file after the order has run using the Show Log link as shown in the next screenshot:
    
    
    
    The screenshot below shows an extract from the log file for this order and the detailed log information that is available for JADE file transfer operations:
    
    
    
    As can be seen from the log file, six files have been copied to the ...\jade_demo\a folder. These were all the files in the remote folder as a filter was not specified to select particular files.

...