Page History

...

• The return code is a variable holding an object that can be converted to a number if provided from a shell job. For such jobs the operating system exit code is handed over as the return code.

• The return code is provided from the most recently executed job.

• The return code is a built-in variable that can be used in a predicate like this: $returnCode

• Hint; the returnCodeMeaning attribute can be set using the JS7 - Job Instruction. This states the return codes (exit codes) that are considered signaling success or error of a job run. If the return code is not included with the list of successful return codes or is included in the list of return codes signaling an error then the order fails. If you want to handle such job execution results with an If Instruction then the rerelevant return code has to be added to the list of successful return codes or has to be exempted from the list of return codes signaling errors.

Functions

timedOut

• The timedOut function returns a Boolean value true that indicates if the previous job was terminated due to a timeout constraint. If the job did terminate for other reasons then the function returns the false value.
  • Example for checking job termination due to timeout constraints in an If Instruction:

  • $returnCode != 0 && timedOut

• Use of the timedout function for a failed job requires use of the If Instruction inside the catch block of a Try/Catch Instruction.

Data Types

String

• Strings can be represented by the value of a variable or by an expression like "this is a string" or 'this is a string'.
• Note that a string that is not the value of a variable requires to be quoted: either single quotes or double quotes can be used.
• If a single quoted string contains a single quote than this has to be escaped with a backslash, e.g. 'De Morgan\'s law'.
• If a double quoted string contains a double quote than this has to be escaped with a backslash too.
•  An empty string has to be specified with double quotes like this: "".

...