Specifies
job parameter values before running a job. Any parameter not set will be defaulted.
Syntax
ErrCode = DSSetParam (JobHandle, ParamName, ParamValue)
JobHandle is the handle for
the job as derived from DSAttachJob.
ParamName is
a string giving the name of the parameter.
ParamValue is
a string giving the value for the parameter.
ErrCode is
0 if DSSetParam is successful, otherwise it is one of the following negative
integers:
- DSJE.BADHANDLE Invalid JobHandle.
- DSJE.BADSTATE Job is not in the right state (compiled,
not running).
- DSJE.BADPARAM ParamName is not a known
parameter of the job.
- DSJE.BADVALUE ParamValue is not appropriate
for that parameter type.
Example
The following
commands set the quarter parameter to 1 and the startdate parameter to 1/1/97
for the qsales job:
paramerr = DSSetParam (qsales_handle, "quarter", "1")
paramerr = DSSetParam (qsales_handle, "startdate",
→ "1997-01-01")