IRIS Documentation: IRIS Extractor Module

Documentation / Extractor Module

Download - Source Code | Report

Name
Iris Extractor Module

Synopsis
The Iris Extractor Module serves to extract the relevant information from the qacct output that is generated by the Sun Grid Engine. Other modules of Iris use this extracted information.

Description
The Iris Extractor Module is implemented using the Perl programming language.

Invocation Syntax:
Iris_Extractor.cgi Source_File_Name Destination_File_Name
where:
Iris_Extractor.cgi is the name and the path to executable of the Iris Extractor script
Source_File_Name is the name with the path to the input file to be parsed
Destination_File_Name is the path to the location where the parser output is desired

Error Handling:
The Extractor does not parse jobs that have a non-zero “qacct failed_status”. An occurrence of such an event causes an appropriate message to appear in the parser output file. Iris discards such results. Operation malfunctions are reported to the Iris Error Directory. The relative path to the Extractor Error Log is /IRIS/Error/Iris_Parser.err. The input file to the Extractor is deleted upon completion.

Usage:
The Iris Extractor Module was primarily designed to work with the Iris Tool. It has been developed on a Redhat Linux 9.0 and has been extensively tested. The source code for the Extractor module is available for download on this site.

Output
The format of the output of the Iris Extractor Module is shown below. The field labels are designed to be self-explanatory. Please consult the legend for further clarification.

Output Field Legend:

Queue_Name:	Resource queue on which job ran
Job_Owner:	Owner of the job
Job_Name:	Name given to the job executable file
Execution_Time:	Total execution time (seconds)
Job_Submission:	Date/Time job was submitted
Queue_Wait:	Time the job waited on the queue
Job_Nodes:	Number of CPU units job ran on
Job_CPU_Time:	Total CPU time of the job (sec)
Job_Memory_Usage:	Total memory used (MB)
Current_Time:	Date/Time IRIS extracted the job

Output Sample:
Queue_Name=v880-7.cre
Job_Owner=archit
Job_Name=sample
Job_ID=10101
Execution_Time=250
Job_Submission_Day_Of_Week=Thu
Job_Submission_Month_Of_Year=Jan
Job_Submission_Day_Of_Month=16
Job_Submission_Year=2003
Job_Submission_Hour_Of_Day=16
Job_Submission_Minute_Of_Hour=06
Job_Submission_Second_Of_Minute=04
Queue_Wait_Hours=1
Queue_Wait_Minutes=5
Queue_Wait_Seconds=5
Job_Nodes=12
Job_CPU_Time=950
Job_Memory_Usage=33.058
Current_Day_Of_Week=Thu
Current_Month_Of_Year=Jul
Current_Day_Of_Month=10
Current_Year=2003
Current_Hour_Of_Day=19
Current_Minute_Of_Hour=15
Current_Second_Of_Minute=02

Author
Archit Shivaprakash
Department of Computer Science
University of Houston, Houston, TX – 77204.
Email: archit@cs.uh.edu
July 2003.

Back to IRIS Documentation