Set Job Instance Status
Inputs: Parm1 = Job Instance UJP pathname
Parm3 = Status to set
Returns: Status Code or <0 for error
-1 = Cannot open/read JST file
-2 = Status not in range 10..99
This function sets the status for a job instance. Use this function with extreme caution and only if no other means of setting the status (for example, by performing a job action) is available. It is likely to make a job status incompatible with the actual state of the job, thereby causing the Job Admin processing to fail.
If an error -1 is returned, the status file will usually have been retried as specified by $lock_tries. Note that not all of the codes in the range 10..99 are valid codes.