Setting PBS/TORQUE Grid Plug-in Options

You can control options such as the job name, resources, and queue. It is recommended that you review the PBS/TORQUE grid plug-in limitations before using the PBS/TORQUE grid plug-in.

Before you begin:

Before you begin working with the PBS/TORQUEgrid plug-in, there are some general requirements that are helpful to know.

  • Direct and unrestricted access to run the PBS/TORQUE commands is required.
  • Only command-line codes are supported.
  • Jobs can be submitted only under the security credentials of the job submitter in Isight.
  • A shared filesystem is required between the working directory and the compute node. The PBS/TORQUE plug-in does not have file copy capability.

  1. Double-click the OS Command component icon .
    The OS Command Component Editor appears.
  2. From the OS Command Component Editor, click the Grid tab.
  3. From the Grid system list, select PBS/TORQUE.

    Note: The PBS/TORQUE Command Preview text box shows the command as it will execute at runtime for the options currently configured. It represents what you would type if you wanted to submit this job manually.

  4. Enter the following information, as desired.

    You can edit one or all of the values. You can also accept the default values.

    OptionDescription
    Job Name Specifies the job name. The name must begin with a letter and can be up to 15 characters long. Refer to the qsub -N option on the man page for more information.
    Resources Specifies the job resources and sets a limit to the amount of consumable resources. If this value is not set for a general resource, such as CPU time, the limit is infinite. The resource_list argument form is as follows: 
    resource_name[=[value]][,resource_name[=[value]],...]

    Refer to the qsub -l option for more information.

    Queue Specifies the job destination. The destination is a queue, a server, or a queue at a server. If specified, the -q option uses one of the following forms: queue, @server, or queue@server. Refer to the qsub -q option for more information.
    Exported Variables Specifies the list of exported job environment variables. Refer to the qsub -v option for more information.
    Export All Variables Specifies that all environment variables in the qsub command environment are exported to the batch job. Refer to the qsub -V option for more information.
  5. To use any qsub options that are not provided in the component editor, click Advanced to access the Additional Grid Options dialog box.
    1. Type the commands in the large text area using standard qsub command-line option syntax (see the qsub man page). Line breaks are ignored, so the commands can be space-separated and/or on separate lines.

      Typically, these options are those that are used less frequently. However, there may be a need for them in specific scenarios. For example, you could use -M to control which users will receive e-mail about the job.

    2. Click OK to return to the OS Command Component Editor.
  6. Click OK to save your changes and to close the OS Command Component Editor.