Product Knowledge Base

Space shortcuts

Page tree

This Job has been deprecated

The JobSchedulerFTPReceive Job has been deprecated with the release of JobScheduler version 1.10.

We strongly recommend that users of the JobScheduler version 1.10 and newer use the JADE and JADE4DMZ JITL Jobs for their file transfer requirements. FEATURE AVAILABILITY STARTING FROM RELEASE 1.10

If you use the JobSchedulerFTPReceive job in a job chain, then you have often the situation that the successor job wants to know which files have been transferred successfully.
The documentation of the JobSchedulerFTPReceive.xml job describes that the job generates the parameter ftp_result_filenames and ftp_result_filepaths where the successfully transferred files are listed.

Unfortunately, this feature is buggy. Both parameters are always empty.

Workaround:
You can insert the JobSchedulerExistsFile job as first successor job into the job chain.

Job Chain: ftpReceive.job_chain.xml

 <?xml version="1.0" encoding="ISO-8859-1"?>
 <job_chain  orders_recoverable = "yes">
    <job_chain_node state       = "receive"
                      job         = "ftpReceive"
                      next_state  = "check"
                      error_state = "error"/>
 
    <job_chain_node   state       = "check"
                      job         = "checkSuccessFiles"
                      next_state  = "process"
                      error_state = "error"/>
 
    <job_chain_node   state       = "process"
                      job         = "processSuccessFiles"
                      next_state  = "success"
                      error_state = "error"/>
 
    <job_chain_node   state       = "success"/>
    <job_chain_node   state       = "error"/>
 </job_chain>

Job: ftpReceive.job.xml

 <?xml version="1.0" encoding="ISO-8859-1"?>
 <job order="yes" stop_on_error="no">
    <description>
       <include file="jobs/[http://www.sos-berlin.com/download/scheduler/jobs/JobSchedulerFTPReceive.xml JobSchedulerFTPReceive.xml]"/>
    </description>
    <script language="java" java_class="sos.scheduler.ftp.JobSchedulerFTPReceive"/>
 </job>

Job: checkSuccessFiles.job.xml

 <?xml version="1.0" encoding="ISO-8859-1"?>
 <job order="yes" stop_on_error="no">
    <description>
       <include file="jobs/[http://www.sos-berlin.com/download/scheduler/jobs/JobSchedulerExistsFile.xml JobSchedulerExistsFile.xml]"/>
    </description>
    <script language="java" java_class="sos.scheduler.file.JobSchedulerExistsFile"/>
 </job>

Job: processSuccessFiles.job.xml

 <?xml version="1.0" encoding="ISO-8859-1"?>
 <job order="yes" stop_on_error="no">
    <script language="shell">
        <![CDATA[
 # here you can do somethimg with the result set
 echo "FTP RESULT FILES = $SCHEDULER_PARAM_SCHEDULER_SOSFILEOPERATIONS_RESULTSET"
        ]]>
    </script>
 </job>

Order: ftpReceive,test.order.xml

 <?xml version="1.0" encoding="ISO-8859-1"?>
 <order>
    <params>
 
       <!-- Parameter of the ftpReceive job -->
       <param   name="ftp_host"          value="ServerA"/>
       <param   name="ftp_port"          value="22"/>
       <param   name="ftp_protocol"      value="sftp"/>
       <param   name="ftp_user"          value="my_user"/>
       <param   name="ftp_password"      value="my_pass"/>
       <param   name="ssh_auth_method"   value="password"/>
       <param   name="ftp_remote_dir"    value="/ftp_out"/>
       <param   name="ftp_local_dir"     value="/home/my_user/ftp_in"/>
       <param   name="ftp_file_spec"     value=".*"/>
       <param   name="ftp_atomic_suffix" value="~"/>
 
       <!-- Parameter of the fileExists job -->
       <param   name="file"              value="/home/my_user/ftp_in"/>
       <param   name="file_spec"         value="[^~]$"/>
 
    </params>
    <run_time/>
 </order>

NOTICE:

The parameter ftp_atomic_suffix is set with "~".

Only successfully transferred files are renamed at the target to its original filename without the "~" at the end.

The file_spec parameter of the check looks for all files without a "~" at the end.