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.