Functions and CALL Routines

DQSRVKILLJOB Function

Terminates a job that is running on a DataFlux Integration Server.

Valid in:

DATA step, PROC SQL, and SCL

Syntax
Arguments
Details
Example
See Also

Syntax

DQSRVKILLJOB (job-ID <,host> <,port>)

Arguments

job-ID: identifies the job submitted to a DataFlux Integration Server. The identifier is set by a function such as DQSRVARCHJOB or DQSRVPROFJOBFILE.
host: identifies the host of the DataFlux Integration Server. If this value is not specified, then localhost is used
port: identifies the port through which the local host communicates with the DataFlux Integration Server. If this value is not specified, or if the value is 0 or a negative number, then the default port number 21036 is used.

Details

The DQSRVKILLJOB function terminates a job. Use the DQSRVJOBSTATUS function to determine whether a job is still running. Return values are 0 (job terminated) or 1 (job failed to terminate).

Example

The following example terminates a job that is running on a DataFlux Integration Server. The job identifier is returned by the function that ran the job. Status information is returned in 20 seconds or less, depending on the termination of the job. Job status is checked every 5 seconds.

killrc= dqsrvKillJob(jobid,'archServer1',5001);