QACCT(1) General Commands Manual QACCT(1) NAME qacct - report and account for Univa Grid Engine usage SYNOPSIS qacct [ -ar [ar_id] ] [ -A account_string ] [ -b begin_time ] [ -d days ] [ -e end_time ] [ -g [group_id|group_name] ] [ -h [hostname] ] [ -help ] [ -j [job_id|job_name|pattern] ] [ -l attr=val,... ] [ -o [owner] ] [ -pe [pe_name] ] [ -q [wc_queue] ] [ -si session_id ] [ -slots [slot_number] ] [ -t task_id_range_list ] [ -P [project_name] ] [ -D [department_name] ] [ -f accounting_file ] DESCRIPTION The qacct utility scans the accounting data file (see accounting(5)) and produces a summary of information for wall-clock time, cpu-time, and system time for the categories of hostname, queue-name, group-name, owner-name, job-name, job-ID and for the queues meeting the resource requirements as specified with the -l switch. Combinations of each category are permitted. Alternatively, all or specific jobs can be listed with the -j switch. For example the search criteria could include summarizing for a queue and an owner, but not for two queues in the same request. OPTIONS -ar [ar_id] The ID of the advance reservation for which usage is summarized. If ar_id is not given, accounting data is listed for each advance reservation separately. -A account_string The account for jobs to be summarized. -b begin_time The earliest start time for jobs to be summarized, in the format [[CC]YY]MMDDhhmm[.SS]. See also -d option. If CC is not speci- fied, a YY of < 70 means 20YY. -d days The number of days to summarize and print accounting information on. If used together with the -b begin_time option (see above), jobs started within begin_time to begin_time + days are counted. If used together with the -e end_time (see below) option, count starts at end_time - days. -e end_time The latest start time for jobs to be summarized, in the format [[CC]YY]MMDDhhmm[.SS]. See also -d option. If CC is not speci- fied, a YY of < 70 means 20YY. [-f accounting_file] The accounting file to be used. If omitted, the system default accounting file is processed. -g [group_id|group_name] The numeric system group id or the group alphanumeric name of the job owners to be included in the accounting. If group_id/group_name is omitted, all groups are accounted. -h [hostname] The case-insensitive name of the host upon which accounting information is requested. If the name is omitted, totals for each host are listed separately. -help Display help information for the qacct command. -j [job_id|job_name|pattern] The name, a expression for matching names, or ID of the job dur- ing execution for which accounting information is printed. If neither a name nor an ID is given all jobs are enlisted. This option changes the output format of qacct. If activated, CPU times are no longer accumulated but the "raw" accounting information is printed in a formatted form instead. See accounting(5) for an explanation of the displayed information. -l attr=val,... A resource requirement specification which must be met by the queues in which the jobs being accounted were executing. The resource request is very similar to the one described in qsub(1). -o [owner] The name of the owner of the jobs for which accounting statis- tics are assembled. If the optional owner argument is omitted, a listing of the accounting statistics of all job owners being present in the accounting file is produced. -pe [pe_name] The name of the parallel environment for which usage is summa- rized. If pe_name is not given, accounting data is listed for each parallel environment separately. -q [wc_queue_name] A expression for queues for which usage is summarized. All queue instances matching the expression will be listed. If no expres- sion is specified, a cluster queue summary will be given. -si session_id Requests sent by this client to the sge_qmaster(1) daemon will be done as part of the specified session. If the switch is omit- ted or if NONE is specified as session_id then such requests will be executed outside the control of a session. Find more information concerning sessions in session_conf(5). -slots [slot_number] The number of queue slots for which usage is summarized. If slot_number is not given, accounting data is listed for each number of queue slots separately. -t task_id_range_list Only available together with the -j option described above. The -t switch specifies the array job task range, for which accounting information should be printed. Syntax and semantics of task_id_range_list are identical to that one described under the -t option to qsub(1). Please see there also for further information on array jobs. -P [project_name] The name of the project for which usage is summarized. If project_name is not given, accounting data is listed for each owning project separately. -D [department_name] The name of the department for which usage is summarized. If department_name is not given, accounting data is listed for each owning department separately. ENVIRONMENTAL VARIABLES SGE_ROOT Specifies the location of the Univa Grid Engine standard configuration files. SGE_CELL If set, specifies the default Univa Grid Engine cell. To address a Univa Grid Engine cell qacct uses (in the order of precedence): The name of the cell specified in the environment variable SGE_CELL, if it is set. The name of the default cell, i.e. default. SGE_DEBUG_LEVEL If set, specifies that debug information should be writ- ten to stderr. In addition the level of detail in which debug information is generated is defined. SGE_QMASTER_PORT If set, specifies the tcp port on which sge_qmaster(8) is expected to listen for communication requests. Most installations will use a services map entry for the ser- vice "sge_qmaster" instead to define that port. SGE_EXECD_PORT If set, specifies the tcp port on which sge_execd(8) is expected to listen for communication requests. Most installations will use a services map entry for the ser- vice "sge_execd" instead to define that port. FILES //common/accounting Univa Grid Engine default accounting file //common/act_qmaster Univa Grid Engine master host file SEE ALSO sge_intro(1), qsub(1), accounting(5), session_conf(5), sge_qmaster(8), COPYRIGHT See sge_intro(1) for a full statement of rights and permissions. Univa Grid Engine User Commands UGE 8.5.4 QACCT(1)