FMEServerJobSubmitter

From fmepedia

FMEServerJobSubmitter is a Workbench Transformer.

 (http://fmepedia.com/index.php/Category:FME_Server)

Submits FME Spatial ETL jobs to be run on an FME Server. A job consists of a workspace (housed within a repository on an FME Server) together with values for each of its published parameters. This transformer submits one job per feature which enters it. Any published parameters of the server workspace will be given values as specified in the transformer, or taken from attributes of the feature which enters it.

The server Host and Port number identify the server that will be used to execute the job.

The optional User Name and Password may be needed in order to gain access to the server.

Once connected to the server, you must choose a repository and select a workspace. This workspace defines the job that will be executed on the server. You can optionally specify the priority of job by entering an integer between 1 (highest priority) and 100 (lowest priority). If the priority of the job is not specified, it is default to the lowest priority.

Any published parameters of the server workspace must be given values. These values can be taken from attributes of the feature that triggered the job to be submitted, or can be keyed in (in which case they will be the same for each job that is sent via the transformer).

Note that if any of the parameters are filenames, those filenames must be valid paths on the server which will execute the job.

If the Wait for Server Job to Complete parameter is set to Yes, then the transformer will wait until the job is completely processed by the server before proceeding. In this case, the initiating feature is output via the SUCCEEDED port if the job successfully ran to completion, and will have these attributes added to it:

_job_id: the integer id the server assigned to this job
_NumFeaturesOutput: the number features that were output by the job
_timeFinished: the time the job finished 
_timeRequested: the time the server received the job request
_timeStarted: the time the server started processing the job

All times are in YYYYMMDDhhmmss format.

The feature will be output via the FAILED port if the job either did not run to completion, or the server could not be contacted, and will have these attributes added to it:

_job_failure_type: holds one of "Connection or Server Problem" or "Translation Failed". If the latter, then the following attributes also will have values; otherwise, they are empty
_job_id: the integer id the server assigned to this job
_StatusMessage: the error message returned from the server explaining why the request failed
_StatusNumber: an error number corresponding to the above message
_timeFinished: the time the job finished 
_timeRequested: the time the server received the job request
_timeStarted: the time the server started processing the job

If the Wait for Server Job to Complete parameter is set to No, the transformer will output the initiating feature as soon as the job is submitted to the server. In this case, the initiating feature is output via the SUCCEEDED port if the request was successfully submitted, and only the _job_id attribute will be added to it. If the server could not be contacted or the job submission otherwise failed, then the feature is output via the FAILED port, and the _job_failure_type attribute will hold the "Connection or Server Problem" value.