Using and Administering

llsubmit Subroutine

llsubmit is both the name of a LoadLeveler command used to submit jobs as well as the subroutine described here.

Purpose

The llsubmit subroutine submits jobs to LoadLeveler for scheduling.

Syntax

  int llsubmit (char *job_cmd_file, char *monitor_program,
  char *monitor_arg, LL_job *job_info, int job_version);

Parameters

job_cmd_file

Is a pointer to a string containing the name of the job command file.

monitor_program

Is a pointer to a string containing the name of the monitor program to be invoked when the state of the job is changed. It is set to NULL if a monitoring program is not provided.

monitor_arg

Is a pointer to a string which is stored in the job object and is passed to the monitor program. The maximum length of the string is 1023 bytes. If the length exceeds this value, it is truncated to 1023 bytes. The string is set to NULL if an argument is not provided.

job_info

Is a pointer to a structure defined in the llapi.h header file. No fields are required to be filled in. Upon return, the structure will contain the number of job steps in the job command file and a pointer to an array of pointers to information about each job step. Space for the array and the job step information is allocated by llsubmit. The caller should free this space using the llfree_job_info subroutine.

job_version

Is an integer indicating the version of llsubmit being used. This argument should be set to LL_JOB_VERSION which is defined in the llapi.h include file.

Description

LoadLeveler must be installed and configured correctly on the machine on which the submit application is run.

The uid and gid in effect when llsubmit is invoked is the uid and gid used when the job is run.

Return Values

0

The job was submitted.

Error Values

-1

The job was not submitted. Error messages are written to stderr.