Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Name: A job name is required. No spaces are allowed and a number of characters are not allowed. 
  • Label: A label assigns a name to the workflow node that is assigned the job.
    • A job can be re-used in a workflow, however, the job label must be unique.
  • Agent: Assignment to an Agent is required.
  • Return Code: The meaning of the job's return code has to be specified. 
    • Return Codes
      • For shell jobs the OS exit code determines the return code. By default an exit code 0 signals success, any other exit codes signal failure.
      • For JVM jobs the return code is specified by the job implementation.
      • If a number of return codes are used to indicate success or failure then
        • they can be specified from a list of comma separated values, for example 1,2,4,8.
        • they can be specified from a range of return codes using two dots between return codes, for example, 1,2..4,8.
      • Negative return codes can be indicated
        • by specifying negative numbers, for example 1,2,4,-1,-2,-4.
        • by specifying a range of negative numbers, for example 1,-1,-2..-4.
      • Some operating systems use 32-bit unsigned integers as exit codes. Therefore positive numbers in the range between 0x80000000 to 0xffffffff are considered negative return codes, for example the values -1 and 4294967295 are considered the same.
      • Jira
        serverSOS JIRA
        columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
        columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
        serverId6dc67751-9d67-34cd-985b-194a8cdc9602
        keyJS-2035

        Jira
        serverSOS JIRA
        columnIdsissuekey,summary,issuetype,created,updated,duedate,assignee,reporter,priority,status,resolution
        columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
        serverId6dc67751-9d67-34cd-985b-194a8cdc9602
        keyJOC-1463
    • On Success / On Error
      • Either successful return codes can be specified or return codes signaling failure.
      • If a job terminates with a return code that is not indicated with the successful return codes or that is stated with return codes signaling failure then the job is considered to have failed. For further details see the section below on Error Handling.
      • JS7 - Notification is created for failed jobs.
    • On Warning
      • For return codes that signal warnings the job execution is considered successful and no error handling applies.
      • JS7 - Notification is created for jobs raising warnings.
  • Executable Type: Allows the job implementation to be selected as a shell job or a JVM job.
    • For shell Shell jobs the Job Property Editor displays the Script subtab and Environment Variables sub-tab.
    • For JavaScript jobs the Job Property Editor displays the Script sub-tab.
    • For JVM Java jobs and JITL jobs the Job Property Editor displays the Java subtab sub-tab.
  • Script Sub-tab
    • This tab holds the input field for the job script. 



    • The right upper corner of this tab offers a pencil icon to invoke the script editor. Any number of commands can be added to a job script:



    • The script editor offers resizing, syntax highlighting, capabilities for search & replace, undo & redo etc. Closing the script editor with the Submit button will add the script content to the script sub-tab.

...