Knowledge Center Contents Previous Next |
ls_readrexlog()
Reads the next record from the opened log file created by RES.
DESCRIPTION
ls_readrexlog() reads the next record from the opened log file created by RES (see lsf.acct). It returns a pointer to the lsfAcctRec structure.
Memory for the lsfAcctRec structure is statically allocated and will be overwritten by the next ls_readrexlog() call.
The meaning of the fields in the lsfAcctRec structure is:
pid
The process ID of the task. If a task contains a tree of processes, the root process ID is logged.
username
The login name of the user who issued the task.
exitStatus
The exit status of the task (see wait() for details).
dispTime
The start time of the task.
termTime
The termination time of the task.
fromHost
The name of the host from which the task was submitted.
execHost
The name of the host on which the task was executed.
cwd
The current working directory of the task.
cmdln
The task command line.
lsfRu
Resource usage statistics. The lsfRusage structure is defined in <lsf/lsf.h>. Note that the availability of certain fields depends on the platform on which the RES runs. The fields that do not make sense on the platform will be logged as -1.0.
SYNOPSIS
#include <stdio.h> #include <lsf/lsf.h> struct lsfAcctRec *ls_readrexlog(FILE *fp) struct lsfAcctRec { int pid; char *username; int exitStatus; time_t dispTime; time_t termTime; char *fromHost; char *execHost; char *cwd; char *cmdln; struct lsfRusage lsfRu; }PARAMETERS
*fp
RETURN VALUES
FILE:1
Function was successful.
integer:0
Function failed.
ERRORS
Systems that conform to the Single UNIX specification are not required to detect error conditions for this function. - Error handling
SEE ALSO
Related APIs
none
Equivalent line command
none
Files
none
Platform Computing Inc.
www.platform.com |
Knowledge Center Contents Previous Next |