Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

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