Procedure Information for wsLoadLeveler.tcl:

  1. createKeywordDb
  2. getClassInfo
  3. parseJobData
  4. getValidClass
  5. compClass
  6. getValidNumProc
  7. writeLine
  8. writeJobFile
  9. submitLLJob
  10. checkG94Proc
  11. submitG94Job
  12. buildPoeScript
  13. buildLLBoolean


    Procedure: createKeywordDb

    Procedure to parse and store database related to load leveler keyword information. Also creates variables that correspond to all Load Leveler keywords


    Procedure Data

    • Name: createKeywordDb
    • Parent Namespace: webSubmit::loadleveler
    • Arglist:
    • Return: Status


    Argument definitions:



    Procedure: getClassInfo

    Procedure to retrieve and parse Load Leveler admin file and retrieve data about class definitions on the system


    Procedure Data

    • Name: getClassInfo
    • Parent Namespace: webSubmit::loadleveler
    • Arglist: remHost
    • Return: None


    Argument definitions:

    • remHost : Remote Load Leveler Host


    Procedure: parseJobData

    Procedure to retrieve and parse a job control file on a remote system.


    Procedure Data

    • Name: parseJobData
    • Parent Namespace: webSubmit::loadleveler
    • Arglist: jobData
    • Return: Status


    Argument definitions:

    • jobData : Job data to be parsed


    Procedure: getValidClass

    Determine if the current class is consistent with the specified number of processors. If the class is not valid, then search for the lowest valid class and return it.


    Procedure Data

    • Name: getValidClass
    • Parent Namespace: webSubmit::loadleveler
    • Arglist: testClass numProc
    • Return: Valid class or error


    Argument definitions:

    • testClass : Class to test
    • numProc : Number of processors


    Procedure: compClass

    Procedure to sort classes based on max_processors


    Procedure Data

    • Name: compClass
    • Parent Namespace: webSubmit::loadleveler
    • Arglist: class1 class2
    • Return: Class with smaller number of max_processors


    Argument definitions:

    • class1 : Name of first class
    • class2 : Name of second class


    Procedure: getValidNumProc

    Procedure to sort classes based on max_processors


    Procedure Data

    • Name: getValidNumProc
    • Parent Namespace: webSubmit::loadleveler
    • Arglist: class
    • Return: Class with smaller number of max_processors


    Argument definitions:

    • class : UNDEFINED


    Procedure: writeLine

    Write formatted LoadLeveler command line


    Procedure Data

    • Name: writeLine
    • Parent Namespace: webSubmit::loadleveler
    • Arglist: fid arg1 {arg2 ""}
    • Return: None


    Argument definitions:

    • fid : File descriptor to write
    • arg1 : Load Leveler keyword
    • arg2 (Optional): Keyword value (Default = "")


    Procedure: writeJobFile

    Procedure to write out a Load Leveler job control script


    Procedure Data

    • Name: writeJobFile
    • Parent Namespace: webSubmit::loadleveler
    • Arglist: fid
    • Return: list of error messages (if any)


    Argument definitions:

    • fid : File descriptor to write


    Procedure: submitLLJob

    Procedure to submit a Load Leveler job


    Procedure Data

    • Name: submitLLJob
    • Parent Namespace: webSubmit::loadleveler
    • Arglist: remHost remHome remUser
    • Return: None


    Argument definitions:

    • remHost : Remote load leveler host system
    • remHome : Home directory on remote host
    • remUser : Remote user login name


    Procedure: checkG94Proc

    Procedure to construct a consistent number of processors for a Gaussian input file. Number of processors is checked against current class and redfined to max_processors if inconsistent. If the input file is specified as the location for the number of processors, but no specification is given, then the file is left untouched.


    Procedure Data

    • Name: checkG94Proc
    • Parent Namespace: webSubmit::loadleveler
    • Arglist: g94File
    • Return: None


    Argument definitions:

    • g94File : Gaussian 94 input file name


    Procedure: submitG94Job

    Procedure to write and submit a Gaussian 94 Load Leveler job


    Procedure Data

    • Name: submitG94Job
    • Parent Namespace: webSubmit::loadleveler
    • Arglist: remHost remUser clobberG94 tmpG94File remG94File
    • Return: None


    Argument definitions:

    • remHost : Load Leveler host
    • remUser : Remote user
    • clobberG94 : Overwrite flag for G94 file
    • tmpG94File : Name of local Gaussian 94 input file
    • remG94File : Name of remote G94 input file


    Procedure: buildPoeScript

    Procedure to build up a script for POE that copies input files to local nodes, executes program, and then returns output files to a specified host


    Procedure Data

    • Name: buildPoeScript
    • Parent Namespace: webSubmit::loadleveler
    • Arglist: remUser remHost userExec userArgs stdin cpOut returnDir
    • Return: None


    Argument definitions:

    • remUser : Remote user login name
    • remHost : Remote host
    • userExec : User Executable
    • userArgs : Arguments to user executable
    • stdin : Standard input
    • cpOut : Flag to determine whether output is copied to return host
    • returnDir : Directory in which output copied


    Procedure: buildLLBoolean

    Procedure to build up Load Leveler requirements and preferences Boolean strings


    Procedure Data

    • Name: buildLLBoolean
    • Parent Namespace: webSubmit::loadleveler
    • Arglist: arrName
    • Return: Boolean string expression used in Load Leveler


    Argument definitions:

    • arrName : Name of array containing Boolean data