Include a job submission script in the flow

Edit online

Add a previously created job submission script to the flow by selecting the Insert Job Script work item in the Flow Editor.

About this task

You can define and submit customized job submission scripts to control and monitor jobs.

Procedure

  1. Within a flow in Flow Editor, click the Insert Job Script icon.
  2. Click the workspace in the location where you want to insert the script.

    The Job Script icon is inserted in your flow definition.

  3. Right-click the Job Script icon and select Open Definition.

    The definition is displayed.

  4. Specify the job submission script details.

    The following fields are mandatory:

    • In the Name field, specify a name for the job submission script. You can use alphanumeric characters, period (.), dash (-), and underscore (_) in the job submission script name.
    • In the File field, specify the absolute path of the job submission script that you created. Ensure that this path is accessed and executed by the jfd daemon.
    • In the User name field, specify the user name under which the command is run. If you are not one of the IBM Spectrum LSF Application Center administrators, you must specify your own user name. The default is your own user name.

    The following fields are optional.

    • In the Working directory field, specify the directory in which the script is run. The default is the home directory of the user under which the command is run.
    • In the Environment Variables field, specify a list of extra key-value pairs to be set up in the environment for use by the command. This field cannot be edited manually, you must click Modify and use the dialogs to specify the key-value pair. The default is undefined.
    • In the Non-zero success exit codes field, specify a list of space-separated numbers 1 - 255. Use this field to indicate which numbers in addition to 0 represent success for the job.
    • In the Exception Handling field, click Add and specify details of the exception and whether you want LSF Process Manager to kill the job or send an alarm notification in response to the exception.
    • In the Description field, add any descriptive text that might be used for managing this script within the flow. The default is undefined.
  5. Click OK to save your changes.
  6. Draw the lines to describe any dependencies the job submission script has on other work items in the flow.