Functions and CALL Routines

DQSRVARCHJOB Function

Runs a DataFlux dfPower Architect job on a DataFlux Integration Server and returns a job identifier.

Requirement:	If specified, the locale must be loaded into memory as part of the locale list.
Requirement:	The character variable that receives the return value must have a minimum length of 52.
Valid in:	DATA step, PROC SQL, and SCL

Syntax
Arguments
Details
Example
See Also

Syntax

DQSRVARCHJOB (job-name<host,>,<port>,<macro-name1>,<macro-value1>,<macro-name2><,macro-value2...>

Arguments

job-name: is the DataFlux dfPower Architect job as it exists on the specified DataFlux Integration Server.
host: (optional) is the host of the DataFlux Integration Server. If this value is not specified, then localhost is used.
macro-name1: is the DataFlux dfPower Architect macro that exists on the DataFlux Integration Server. The value of macro-name1 can be specified as text, or as the name of a character variable. The value of the character variable is used as the macro name.
macro-value1: is the character value that is used by the associated DataFlux dfPower Architect macro. Macro-value1 is used by macro-name1. The value of macro-value1 can be specified as text, or as the name of a character variable.
port: is 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 DQSRVARCHJOB function returns a job-identifier. The return value is either a job identifier of up to 52 characters, or the value MISSING. Use the job identifier in subsequent function calls to manage the job, using DQSRVJOBSTATUS , DQSRVCOPYLOG, DQSRVDELETELOG, and DQSRVKILLJOB.

You can specify any number of macro value pairs.
For information about how to run a DataFluxDataFlux dfPower Architect service on a DataFlux Integration Server, see The DQSRVSVC Procedure.

Example

The following example runs a DataFlux dfPower Architect job on a DataFlux Integration Server. The job standardizes a character value that represents the name of an operating environment. The server returns a job identifier that can be used to manage the job's log file.

jobid= dqsrvArchJob('opsysCleanse','archServer1', 5001,'osMacro','Unicks');