Status Management Rules

Default values can be set for the Information and Severity fields that are displayed in the Job Runs document during Uproc execution. The Information and Severity fields are updated in the Uproc script by the uxset info command (refer to The Dollar Universe Commands Guide for more details).

• Information

  Free text of 50 characters maximum. Default value for the Information field displayed in the Job Runs document when the Uproc executes. The field is optional and empty by default.

• Severity

  The value for the Severity field (an integer from 0 to 9999) displayed in the Job Runs document when the Uproc executes. This field is optional and empty by default.

• Enable enhanced status management

  (not available on OS400) By default, this box is not checked and standard rules will apply to the way the Launcher manages the job’s completion status (RESEXE=0 on Windows, return code = 0 on UNIX, return code = 1 on OpenVMS). Check the box to use the alternative completion status management functions described below.

  Job status is … if

  Execution completion status attributed if the rule below is verified. Select Completed (default) or Aborted. The types of rules for determining the status are exclusive:

  • Return code is

    (Default) Test the Uproc return code value (UNIX and OpenVMS) or the value of the variable RESEXE (Windows):

    Operator choice between: "equal to" (default), "greater than", "less than" or "different".

    Numerical value: 0 (default), positive or negative integer.

  • The string

    A free character string with a maximum length of 128 characters. This entry is mandatory. If the string includes spaces, it must be enclosed in quotation marks.

    Use a regular expression: check this box to indicate that a regular expression must be analyzed in the "The string" field (Tcl/Tk library version 8.1 with option "ERE" meaning that only the syntax of 8.0 is supported; follow the URL https://tcl.tk/doc/howto/regexp81.html#part1_2 for more details).
    The following characters are supported for regular expressions:

    • A wildcard: any character “.”
    • Repeat: zero or more occurrences of previous character or class “*”
    • Line positions: beginning of line “^”
    • Line position: end of line “$”
    • Character class: any one character in set. Example: [clas]
    • Inverse class: any one character not in set. Example: [^clas]
    • Range: any characters within the specified range. Example: [0-9]
    • Escape: literal use of meta-character “x”. Example: \x
    • Word position: beginning of word. Example: \<xyz
    • Word position: end of word. Example: xyz\>

    Is found in: The string can be found by searching either the Job Run log or the specified file:

    • Job Run log: Job Run log file (default, max length 128 characters)
    • File: Enter the full name and location of the file to be searched for (maximum length 256 characters). If the string includes spaces it must be enclosed in quotation marks.

  • Extended return code

    The completion status is set to Completed or Aborted if the return code matches one of the values provided. The minimum and maximum values for any part of the extended return code definition are between -32767 and 32768. The value range can be composed of:

    	Format	Example
    A simple value	“*” or a positive or negative integer	-2
    A range of positive or negative integers	[min,max]	[-10,10]: between -10 to 10 inclusive
    A range of positive or negative integers with a wildcard *	[min, *] or [*, max]	[2, *] between 2 and 32768 inclusive [*, -2] between -32767 and -2 inclusive
    Values calculated from a multiple	N/m	*/3 all multiples of 3 (including negatives)
    Values calculated within a range using the multiple provided (m)	[min max]/m	[1,10]/4 : 4 and 8

    Each value or range of values should be separated by a semi-colon. The list cannot exceed 64 characters.

    Example: -2;[-10,10];*/3;[1,10]/4

• Enable auto-retry mode

  Box cleared by default. If the completion status determined by the Launcher (Status Management above) is Aborted and the box is checked, the Launcher will re-launch the Uproc until it completes the run successfully.

  • If the run completes normally, the auto-retry feature is turned off and final status is completed.
  • If, after the maximum number of retries the Uproc continues to fail, the final status will be aborted.

  Max retries

  Maximum number of re-launches to be attempted is 999.

  Retry interval

  Interval (in minutes) between the end of one launch and the start of the retry. A “0” (zero) value means an immediate retry; maximum is 59 minutes.