Method response messages

Methods return information to HCL Workload Automation in messages written to stdout. Each line starting with a percent sign (%) and ending with a new line is interpreted as a message. The messages have the following format:

%CJ state [mjstring | jobid]

%JS [cputime]

%RC rc

%UT [errormessage]

where:

CJ

Changes the job state.

state

The state to which the job is changed. All HCL Workload Automation job states are valid except HOLD and READY. For the GS task, the following states are also valid:

ERROR

An error occurred.

EXTRN

Status is unknown.

mjstring

A string of up to 255 characters that HCL Workload Automation will include in any MJ task associated with the job.

jobid

A string of up to 64 characters that HCL Workload Automation will include in any GS task associated with the job.

JS [cputime]

Indicates successful completion of a job and provides its elapsed run time in seconds.

RC rc

rc is a number that is interpreted by HCL Workload Automation as the return code of the extended agent job. The return code is taken into account only if a return code condition was specified in the definition of the extended agent job. Otherwise, it is ignored and the successful completion of the extended agent job is indicated by the presence of message %JS [cputime]. Likewise, if the method does not send the %RC message, then the successful completion of the extended agent job is indicated by the presence of message %JS [cputime].

UT [errormessage]

Indicates that the requested task is not supported by the method. Displays a string of up to 255 characters that HCL Workload Automation will include in its error message.