Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

lsb_geteventrec()

Get an event record from a log file

DESCRIPTION

lsb_geteventrec() returns an eventRec from a log file.

The storage for the eventRec structure returned by lsb_geteventrec() will be reused by the next call.

SYNOPSIS

#include <lsf/lsbatch.h>  
struct eventRec *lsb_geteventrec(log_fp, lineNum) 
FILE *log_fp; 
int *lineNum; 
struct eventRec { 
    char  version[MAX_VERSION_LEN]; 
    int   type; 
    time_t eventTime; 
    union eventLog eventLog; 
}; 
union  eventLog { 
    struct jobNewLog jobNewLog; 
    struct jobStartLog jobStartLog; 
    struct jobStatusLog jobStatusLog; 
    struct sbdJobStatusLog sbdJobStatusLog; 
    struct jobSwitchLog jobSwitchLog; 
    struct jobMoveLog jobMoveLog; 
    struct queueCtrlLog queueCtrlLog; 
    struct newDebugLog  newDebugLog; 
    struct hostCtrlLog hostCtrlLog; 
    struct mbdStartLog mbdStartLog; 
    struct mbdDieLog mbdDieLog; 
    struct unfulfillLog unfulfillLog; 
    struct jobFinishLog jobFinishLog; 
    struct loadIndexLog loadIndexLog; 
    struct migLog migLog; 
    struct calendarLog calendarLog; 
    struct jobForwardLog jobForwardLog; 
    struct jobAcceptLog jobAcceptLog; 
    struct statusAckLog statusAckLog; 
    struct signalLog signalLog; 
    struct jobExecuteLog jobExecuteLog; 
    struct jobMsgLog jobMsgLog; 
    struct jobMsgAckLog jobMsgAckLog; 
    struct jobRequeueLog jobRequeueLog; 
    struct chkpntLog chkpntLog; 
    struct sigactLog sigactLog; 
    struct jobOccupyReqLog jobOccupyReqLog; 
    struct jobVacatedLog jobVacatedLog; 
    struct jobStartAcceptLog jobStartAcceptLog; 
    struct jobCleanLog jobCleanLog; 
    struct jobExceptionLog jobExceptionLog; 
    struct jgrpNewLog jgrpNewLog; 
    struct jgrpCtrlLog jgrpCtrlLog; 
    struct jobForceRequestLog jobForceRequestLog; 
    struct logSwitchLog logSwitchLog; 
    struct jobModLog jobModLog; 
    struct jgrpStatusLog jgrpStatusLog; 
    struct jobAttrSetLog jobAttrSetLog; 
    struct jobExternalMsgLog jobExternalMsgLog; 
    struct jobChunkLog jobChunkLog; 
    struct sbdUnreportedStatusLog sbdUnreportedStatusLog 
    struct rsvFinishLog rsvFinishLog; 
    struct hgCtrlLog hgCtrlLog; 
    struct cpuProfileLog cpuProfileLog; 
    struct dataLoggingLog dataLoggingLog; 
    struct jobRunRusageLog   jobRunRusageLog; 
    struct eventEOSLog eventEOSLog; 
    struct slaLog slaLog; 
    struct perfmonLog perfmonLog; 
    struct taskFinishLog taskFinishLog; 
}; 
struct xFile { 
    char *subFn; 
    char *execFn; 
    int options; 
}; 
struct jobAttrSetLog {   /* Structure for log_jobattrset() and other calls */ 
    int       jobId; 
    int       idx; 
    int       uid; 
    int       port; 
    char      *hostname; 
}; 
struct logSwitchLog { /* Records of logged events */ 
    int lastJobId; 
}; 
struct dataLoggingLog {         /* Records of job cpu data logged event */ 
    time_t loggingTime; 
}; 
struct jgrpNewLog { 
    int    userId; 
    time_t submitTime; 
    char   userName[MAX_LSB_NAME_LEN]; 
    char   *depCond; 
    char   *timeEvent; 
    char   *groupSpec; 
    char   *destSpec; 
    int    delOptions; 
    int    delOptions2; 
    int    fromPlatform; 
    char   *sla; 
    int  maxJLimit; 
    int options; 
}; 
struct jgrpCtrlLog { 
   int    userId; 
   char   userName[MAX_LSB_NAME_LEN]; 
    char   *groupSpec; 
    int    options; 
    int    ctrlOp; 
}; 
struct jgrpStatusLog { 
    char   *groupSpec; 
    int    status; 
    int    oldStatus; 
}; 
struct jobNewLog {        /* logged in lsb.events when a job is submitted */ 
    int    jobId; 
    int    userId; 
    char   userName[MAX_LSB_NAME_LEN]; 
    int    options; 
    int    options2; 
    int    numProcessors; 
    time_t submitTime; 
    time_t beginTime; 
    time_t termTime; 
    int    sigValue; 
    int    chkpntPeriod; 
    int    restartPid; 
    int    rLimits[LSF_RLIM_NLIMITS]; 
    char   hostSpec[MAXHOSTNAMELEN]; 
    float  hostFactor; 
    int    umask; 
    char   queue[MAX_LSB_NAME_LEN]; 
    char   *resReq; 
    char   fromHost[MAXHOSTNAMELEN]; 
    char   *cwd; 
    char   *chkpntDir; 
    char   *inFile; 
    char   *outFile; 
    char   *errFile; 
    char   *inFileSpool; 
    char   *commandSpool; 
    char   *jobSpoolDir; 
    char   *subHomeDir; 
    char   *jobFile; 
    int    numAskedHosts; 
    char   **askedHosts; 
    char   *dependCond; 
    char   *timeEvent; 
    char   *jobName; 
    char   *command; 
    int    nxf; 
    struct xFile *xf; 
    char   *preExecCmd; 
    char   *mailUser; 
    char   *projectName; 
    int    niosPort; 
    int    maxNumProcessors; 
    char   *schedHostType; 
    char   *loginShell; 
    char   *userGroup; 
    char   *exceptList; 
    int    idx; 
    int    userPriority; 
    char   *rsvId; 
    char   *jobGroup; 
    char   *extsched; 
    int    warningTimePeriod; 
    char   *warningAction; 
    char   *sla; 
    int    SLArunLimit; 
    char   *licenseProject; 
    int    options3; 
    char   *app; 
    char   *postExecCmd; 
    int     runtimeEstimation; 
    char    *requeueEValues; 
    int     initChkpntPeriod; 
    int     migThreshold; 
}; 
struct jobModLog { 
    char    *jobIdStr; 
    int     options; 
    int     options2; 
    int     delOptions; 
    int     delOptions2; 
    int     userId; 
    char    *userName; 
    int     submitTime; 
    int     umask; 
    int     numProcessors; 
    int     beginTime; 
    int     termTime; 
    int     sigValue; 
    int     restartPid; 
    char    *jobName; 
    char    *queue; 
    int     numAskedHosts; 
    char    **askedHosts; 
    char    *resReq; 
    int     rLimits[LSF_RLIM_NLIMITS]; 
    char    *hostSpec; 
    char    *dependCond; 
    char    *timeEvent; 
    char    *subHomeDir; 
    char    *inFile; 
    char    *outFile; 
    char    *errFile; 
    char    *command; 
    char    *inFileSpool; 
    char    *commandSpool; 
    int     chkpntPeriod; 
    char    *chkpntDir; 
    int     nxf; 
    struct  xFile *xf; 
    char    *jobFile; 
    char    *fromHost; 
    char    *cwd; 
    char    *preExecCmd; 
    char    *mailUser; 
    char    *projectName; 
    int     niosPort; 
    int     maxNumProcessors; 
    char    *loginShell; 
    char    *schedHostType; 
    char    *userGroup; 
    char    *exceptList; 
    int     userPriority; 
    char    *rsvId; 
    char    *extsched; 
    int     warningTimePeriod; 
    char    *warningAction; 
    char    *jobGroup; 
    char    *sla; 
    char    *licenseProject; 
    int     options3; 
    int     delOptions3; 
    char    *app; 
    char    *apsString; 
    char    *postExecCmd; 
    int     runtimeEstimation; 
    char    *requeueEValues; 
    int     initChkpntPeriod; 
    int     migThreshold; 
}; 
struct jobStartLog {      /* logged in lsb.events when a job is started */ 
    int    jobId; 
    int    jStatus; 
    int    jobPid; 
    int    jobPGid; 
    float  hostFactor; 
    int    numExHosts; 
    char   **execHosts; 
    char   *queuePreCmd; 
    char   *queuePostCmd; 
    int    jFlags; 
    char   *userGroup; 
    int    idx; 
    char   *additionalInfo; 
    int    duration4PreemptBackfill; 
}; 
struct jobStartAcceptLog {  /* logged in lsb.events when a job start request is accepted  
*/ 
    int    jobId; 
    int    jobPid; 
    int    jobPGid; 
    int    idx; 
}; 
struct jobExecuteLog {   /* logged in lsb.events when a job is executed */ 
    int    jobId; 
    int    execUid; 
    char   *execHome; 
    char   *execCwd; 
    int    jobPGid; 
    char   *execUsername; 
    int    jobPid; 
    int    idx; 
    char   *additionalInfo; 
    int    SLAscaledRunLimit; 
    int    position; 
    char   *execRusage; 
    int    duration4PreemptBackfill; 
}; 
struct jobStatusLog {     /* logged when a job's status is changed */ 
    int    jobId; 
    int    jStatus; 
    int    reason; 
    int    subreasons; 
    float  cpuTime; 
    time_t endTime; 
    int    ru; 
    struct lsfRusage lsfRusage; 
    int   jFlags; 
    int   exitStatus; 
    int    idx; 
    int    exitInfo; 
}; 
struct sbdJobStatusLog {     /* logged when a job's status is changed */ 
    int    jobId; 
    int    jStatus; 
    int    reasons; 
    int    subreasons; 
    int    actPid; 
    int    actValue; 
    time_t actPeriod; 
    int    actFlags; 
    int    actStatus; 
    int    actReasons; 
    int    actSubReasons; 
    int    idx; 
    int    sigValue; 
    int    exitInfo; 
}; 
struct sbdUnreportedStatusLog {   /* job status that we could send to MBD */ 
    int    jobId; 
    int    actPid; 
    int    jobPid; 
    int    jobPGid; 
    int    newStatus; 
    int    reason; 
    int    subreasons; 
    struct lsfRusage lsfRusage; 
    int    execUid; 
    int    exitStatus; 
    char   *execCwd; 
    char   *execHome; 
    char   *execUsername; 
    int    msgId; 
    struct jRusage runRusage; 
    int    sigValue; 
    int    actStatus; 
    int    seq; 
    int    idx; 
    int    exitInfo; 
}; 
struct jobSwitchLog {     /* logged when a job is switched to another queue */  
    int    userId;  
    int    jobId;  
    char   queue[MAX_LSB_NAME_LEN];  
    int    idx;  
    char   userName[MAX_LSB_NAME_LEN];  
};  
struct jobMoveLog {       /* logged when a job is moved to another position */  
    int    userId;  
    int    jobId;  
    int    position;  
    int    base;  
    int    idx;  
    char   userName[MAX_LSB_NAME_LEN];  
};  
struct chkpntLog { 
    int jobId; 
    time_t period; 
    int pid; 
    int ok; 
    int flags; 
    int    idx; 
}; 
struct jobRequeueLog { 
    int   jobId; 
    int   idx; 
}; 
struct jobCleanLog { 
    int   jobId; 
    int   idx; 
}; 
struct jobExceptionLog { 
    int jobId; 
    int    exceptMask; 
    int    actMask; 
    time_t timeEvent; 
    int    exceptInfo; 
    int    idx; 
}; 
struct sigactLog { 
    int      jobId; 
    time_t   period; 
    int      pid; 
    int      jStatus; 
    int      reasons; 
    int      flags; 
    char     *signalSymbol; 
    int      actStatus; 
    int      idx; 
}; 
struct migLog { 
    int    jobId; 
    int    numAskedHosts; 
    char   **askedHosts; 
    int    userId; 
    int    idx; 
    char   userName[MAX_LSB_NAME_LEN]; 
}; 
struct signalLog { 
    int    userId; 
    int    jobId; 
    char   *signalSymbol; 
    int    runCount; 
    int    idx; 
    char   userName[MAX_LSB_NAME_LEN]; 
}; 
struct queueCtrlLog { /* logged when bqc command is invoked */ 
    int  opCode; 
    char queue[MAX_LSB_NAME_LEN]; 
    int  userId; 
    char userName[MAX_LSB_NAME_LEN]; 
    char message[MAXLINELEN]; 
}; 
struct newDebugLog { 
    int opCode; 
    int level; 
    int logclass; 
    int turnOff; 
    char logFileName[MAXLSFNAMELEN]; 
    int userId; 
 }; 
struct hostCtrlLog { /* logged when bhc command is invoked */ 
    int  opCode; 
    char host[MAXHOSTNAMELEN]; 
    int  userId; 
    char userName[MAX_LSB_NAME_LEN]; 
    char message[MAXLINELEN]; 
}; 
struct hgCtrlLog {       /* logged when dynamic hosts are added to group */ 
    int    opCode; 
    char   host[MAXHOSTNAMELEN]; 
    char   grpname[MAXHOSTNAMELEN]; 
    int    userId; 
    char   userName[MAX_LSB_NAME_LEN]; 
    char   message[MAXLINELEN]; 
}; 
struct mbdStartLog { 
    char master[MAXHOSTNAMELEN]; 
    char cluster[MAXLSFNAMELEN]; 
    int  numHosts; 
    int  numQueues; 
}; 
struct mbdDieLog { 
    char master[MAXHOSTNAMELEN]; 
    int  numRemoveJobs; 
    int  exitCode; 
    char   message[MAXLINELEN]; 
}; 
struct unfulfillLog { /* logged before mbatchd dies */ 
    int  jobId; 
    int  notSwitched; 
    int  sig; 
    int  sig1; 
    int  sig1Flags; 
    time_t chkPeriod; 
    int  notModified; 
    int  idx; 
    int  miscOpts4PendSig; 
}; 
struct jobFinishLog {          /* logged in lsb.acct when a job finished */ 
    int    jobId; 
    int    userId; 
    char   userName[MAX_LSB_NAME_LEN]; 
    int    options; 
    int    numProcessors; 
    int    jStatus; 
    time_t submitTime; 
    time_t beginTime; 
    time_t termTime; 
    time_t startTime; 
    time_t endTime; 
    char   queue[MAX_LSB_NAME_LEN]; 
    char   *resReq; 
    char   fromHost[MAXHOSTNAMELEN]; 
    char   *cwd; 
    char   *inFile; 
    char   *outFile; 
    char   *errFile; 
    char   *inFileSpool; 
    char   *commandSpool; 
    char   *jobFile; 
    int    numAskedHosts; 
    char   **askedHosts; 
    float  hostFactor; 
    int    numExHosts; 
    char   **execHosts; 
    float  cpuTime; 
    char   *jobName; 
    char   *command; 
    struct  lsfRusage lsfRusage; 
    char   *dependCond; 
    char   *timeEvent; 
    char   *preExecCmd; 
    char   *mailUser; 
    char   *projectName; 
    int    exitStatus; 
    int    maxNumProcessors; 
    char   *loginShell; 
    int    idx; 
    int    maxRMem;  
    int    maxRSwap; 
    char   *rsvId; 
    char   *sla; 
    int    exceptMask; 
    char   *additionalInfo; 
    int    exitInfo; 
    int    warningTimePeriod; 
    char   *warningAction; 
    char   *chargedSAAP; 
    char   *licenseProject; 
    char   *app; 
    char   *postExecCmd; 
    int    runtimeEstimation; 
    char   *jgroup; 
    char   *requeueEValues; 
}; 
struct loadIndexLog { 
   int  nIdx; 
    char **name; 
}; 
struct calendarLog { 
    int    options; 
    int    userId; 
    char   *name; 
    char   *desc; 
    char   *calExpr; 
}; 
struct jobForwardLog { 
    int    jobId; 
    char   *cluster; 
    int    numReserHosts; 
    char   **reserHosts; 
    int    idx; 
    int    jobRmtAttr; 
}; 
struct jobAcceptLog { 
    int         jobId; 
    LS_LONG_INT remoteJid; 
    char        *cluster; 
    int         idx; 
    int         jobRmtAttr; 
}; 
struct statusAckLog { 
    int jobId; 
    int statusNum; 
    int    idx; 
}; 
struct jobMsgLog { 
    int   usrId; 
    int   jobId; 
    int   msgId; 
    int   type; 
    char  *src; 
    char  *dest; 
    char  *msg; 
    int   idx; 
}; 
struct jobMsgAckLog { 
    int usrId; 
    int jobId; 
    int msgId; 
    int type; 
    char *src; 
    char *dest; 
    char *msg; 
    int    idx; 
}; 
struct jobOccupyReqLog {      
    int userId; 
    int jobId; 
    int numOccupyRequests; 
    void *occupyReqList; 
    int    idx; 
    char userName[MAX_LSB_NAME_LEN]; 
}; 
struct jobVacatedLog {         
    int userId; 
    int jobId; 
    int    idx; 
    char userName[MAX_LSB_NAME_LEN]; 
}; 
struct jobForceRequestLog { 
    int     userId; 
    int     numExecHosts; 
    char**  execHosts; 
    int     jobId; 
    int     idx; 
    int     options; 
    char    userName[MAX_LSB_NAME_LEN]; 
    char   *queue; 
}; 
struct jobChunkLog { 
    long         membSize; 
    LS_LONG_INT *membJobId; 
    long         numExHosts; 
    char       **execHosts; 
}; 
struct jobExternalMsgLog { 
    int      jobId; 
    int      idx; 
    int      msgIdx; 
    char     *desc; 
    int      userId; 
    long     dataSize; 
    time_t   postTime; 
    int      dataStatus; 
    char     *fileName; 
    char     userName[MAX_LSB_NAME_LEN]; 
}; 
struct rsvRes { 
    char     *resName;  
    int      count; 
    int      usedAmt; 
}; 
struct rsvFinishLog { /* for advanced reservation */ 
    time_t        rsvReqTime; 
    int           options; 
    int           uid; 
    char          *rsvId; 
    char          *name;  
    int           numReses;  
    struct rsvRes *alloc;  
    char          *timeWindow;  
    time_t        duration;  
    char          *creator; 
}; 
struct cpuProfileLog { 
    char    servicePartition[MAX_LSB_NAME_LEN]; 
    int     slotsRequired; 
    int     slotsAllocated; 
    int     slotsBorrowed; 
    int     slotsLent; 
}; 
struct jobRunRusageLog {         /* log the running rusage of a job in the lsb.stream  
file */ 
    int              jobid; 
    int              idx; 
    struct jRusage   jrusage; 
}; 
struct slaLog { /* SLA event */ 
    char   *name;  
    char   *consumer;  
    int    goaltype;  
    int    state;  
    int    optimum;  
    int    counters[NUM_JGRP_COUNTERS];  
}; 
struct perfmonLogInfo { /* a wrap of structure perfmonLog for perf. metrics project */ 
    int samplePeriod; 
    int * metrics; 
    time_t startTime; 
    time_t logTime; 
}; 
struct perfmonLog {              /* performance metrics log in lsb.stream */ 
    int    samplePeriod; 
    int    totalQueries; 
    int    jobQuries; 
    int    queueQuries; 
    int    hostQuries; 
    int    submissionRequest; 
    int    jobSubmitted; 
    int    dispatchedjobs; 
    int    jobcompleted; 
    int    jobMCSend; 
    int    jobMCReceive; 
    time_t startTime; 
}; 
struct taskFinishLog {     /* task accounting record in ssched.acct */ 
    struct jobFinishLog jobFinishLog; 
    int    taskId; 
    int    taskIdx; 
    char   *taskName; 
    int    taskOptions; 
    int    taskExitReason; 
}; 
struct eventEOSLog {     /* Event end of stream. */ 
    int   eos; 
}; 

PARAMETERS

log_fp

Either an event log file or a job log file.

*lineNum

The number of the event record.

struct eventRec

The eventRec structure contains the following fields:

version

The mbatchd version number

type

The type of event-one of the following:

EVENT_JOB_NEW

New job submitted

EVENT_JOB_START

mbatchd is trying to start a job

EVENT_JOB_START_ACCEPT

Accept Job started

EVENT_JOB_STATUS

Job's status change event

EVENT_JOB_SWITCH

Job switched to another queue

EVENT_JOB_MOVE

Move a pending job's position within a queue

EVENT_QUEUE_CTRL

Queue's status changed by Platform LSF administrator (bhc operation)

EVENT_HOST_CTRL

Host status changed by Platform LSF administrator (bhc operation)

EVENT_MBD_START

New mbatchd start event

EVENT_MBD_DIE

Log parameters before mbatchd died

EVENT_MBD_UNFULFILL

Action that was not taken because the mbatchd was unable to contact the sbatchd on the job's execution host

EVENT_JOB_FINISH

Job finished (Logged in lsb.acct)

EVENT_LOAD_INDEX

The complete list of load indices, including external load indices

EVENT_CHKPNT

Job checkpointed.

EVENT_MIG

Job migrated

EVENT_PRE_EXEC_START

The pre-execution command started

EVENT_JOB_MODIFY

Job modification request

EVENT_JOB_MODIFY2

Job modification request

EVENT_JOB_ATTR_SET

Job attributes have been set

EVENT_CAL_NEW: deprecated

Add new calendar to the system

EVENT_CAL_MODIFY: deprecated

Calendar modified

EVENT_CAL_DELETE: deprecated

Calendar deleted

EVENT_CAL_UNDELETE: deprecated

Undo delete of Calendar

EVENT_JOB_FORWARD

Job forwarded to another cluster

EVENT_JOB_ACCEPT

Job from a remote cluster dispatched

EVENT_STATUS_ACK

Job status successfully sent to submission cluster

EVENT_JOB_SIGNAL

Signal/delete a job

EVENT_JOB_EXECUTE

Job started successfully on the execution host

EVENT_JOB_MSG

Send a message to a job

EVENT_JOB_MSG_ACK

The message has been delivered

EVENT_JOB_REQUEUE

Job is requeued

EVENT_JOB_CLEAN

Job is cleaned out of the core

EVENT_JOB_SIGACT

A signal action on a job has been initiated or finished

EVENT_JOB_EXCEPTION

Job exception was detected

EVENT_JGRP_ADD

Adding a new job group

EVENT_JGRP_MOD

Modifying a job group

EVENT_JGRP_CTRL

Controlling a job group

EVENT_JGRP_STATUS

Log job group status

EVENT_JOB_OCCUPY_REQ

Submission mbatchd logs this after sending an occupy request to execution mbatchd

EVENT_JOB_VACATED

Submission mbatchd logs this event after all execution mbatchds have vacated the occupied hosts for the job

EVENT_SBD_JOB_STATUS

sbatchd's new job status

EVENT_JOB_FORCE

Forcing a job to start on specified hosts (brun operation)

EVENT_LOG_SWITCH

Switching the event file lsb.events

EVENT_JOB_CHUNK

Insert one job to a chunk

EVENT_SBD_UNREPORTED_STATUS

Save unreported sbatchd status

EVENT_JOB_EXT_MSG

Send an external message to a job

EVENT_JOB_ATTA_DATA

Update data status of a message for a job

EVENT_ADRSV_FINISH

Reservation finished

EVENT_CPUPROFILE_STATUS

Saved current CPU allocation on service partition

EVENT_DATA_LOGGING

Write out data logging file

EVENT_CPUPROFILE_STATUS

Write CPU profile status

EVENT_DATA_LOGGING

Log data

EVENT_JOB_RUN_RUSAGE

Write job rusage in lsb.stream

EVENT_SLA_RECOMPUTE

SLA goal is reavaluated

EVENT_JOB_ROUTE

The job has been routed to NQS

EVENT_TASK_FINISH

Write task finish log to ssched.acct

JOB_RUN_RUSAGE

Writes job rusage in lsb.stream.

END_OF_STREAM

Stream closed and new stream opened.

SLA_RECOMPUTE

SLA goal is reavaluated.

eventTime

The time the event occurred

eventLog

The information for this type of event, contained in a structure corresponding to type

struct jobNewLog

The jobNewLog structure contains the following fields:

jobId

The job ID that the LSF assigned to the job

userId

The user ID of the submitter

userName

The name of the submitter

options

Job submission options. See lsb_submit().

options2

Job submission options. See lsb_submit().

numProcessors

The number of processors requested for execution

submitTime

The job submission time

beginTime

The job should be started on or after this time

termTime

If the job has not finished by this time, it will be killed

sigValue

The signal value sent to the job 10 minutes before its run window closes

chkpntPeriod

The checkpointing period

restartPid

The process ID assigned to the job when it was restarted

rLimits

The user's resource limits

hostSpec

The model, host name or host type for scaling CPULIMIT and RUNLIMIT

hostFactor

The CPU factor for the above model, host name or host type

umask

The file creation mask for this job

queue

The name of the queue to which this job was submitted

resReq

The resource requirements of the job

fromHost

The submission host name

cwd

The current working directory

chkpntDir

The checkpoint directory

inFile

The input file name

outFile

The output file name

errFile

The error output file name

inFileSpool

Job spool input file

commandSpool

Job spool command file

jobSpoolDir

job spool directory

subHomeDir

The home directory of the submitter

jobFile

The job file name

numAskedHosts

The number of hosts considered for dispatching this job

askedHosts

The array of names of hosts considered for dispatching this job

dependCond

The job dependency condition

timeEvent

Time event string

jobName

The job name

command

The job command

nxf

The number of files to transfer

xf

The array of file transfer specifications. (The xFile structure is defined in <lsf/lsbatch.h>)

preExecCmd

The pre-execution command

mailUser

User option mail string

projectName

Project name for the job; used for accounting purposes

niosPort

NIOS callback port to be used for interactive jobs

maxNumProcessors

Maximum number of processors

schedHostType

Execution host type

loginShell

The login shell specified by user

userGroup

The user group name for this job

exceptList

List of job exception conditions

idx

Job array index; must be 0 in JOB_NEW

userPriority

User priority

rsvId

Advance reservation ID

jobGroup

The job group under which the job runs

extsched

External scheduling options

warningTimePeriod

Job warning time period in seconds; -1 if unspecified

warningAction

Job warning action: SIGNAL | CHKPNT | command; NULL if unspecified

sla

SLA service class name under which the job runs

SLArunLimit

Absolute run time limit of the job for SLA service classes

licenseProject

LSF License Scheduler project name

options3

Extended bitwise inclusive OR of options flags. See lsb_submit().

app

Application profile under which the job runs.

postExecCmd

Post-execution commands.

runtimeEstimation

Runtime estimate specified.

requeueEValues

Job-level requeue exit values.

initChkpntPeriod

Initial checkpoint period.

migThreshold

Job migration threshold.

struct jobStartLog

The jobStartLog structure contains the following fields:

jobId

The unique ID for the job

jStatus

The status of the job (See lsb_readjobinfo())

jobPid

The job process ID

jobPGid

The job process group ID

hostFactor

The CPU factor of the first execution host

numExHosts

The number of processors used for execution

execHosts

The array of execution host names

queuePreCmd

Pre-execution command defined in the queue

queuePostCmd

Post-execution command defined in the queue

jFlags

Job processing flags

userGroup

The user group name for this job

idx

Job array index; must be 0 in JOB_NEW

additionalInfo

Placement information of LSF HPC jobs

duration4PreemptBackfill

How long a backfilled job can run; used for preemption backfill jobs

struct jobForceRequestLog

The jobForceRequestLog structure contains the following fields:

userId
numExecHosts
execHosts
jobId
idx
options
userName
queue
struct logSwitchLog

The logSwitchLog structure contains the following fields:

lastJobId

the last jobId so far

struct jobModLog

The jobModLog structure contains the following fields:

jobIdStr

jobId or jobName in char

options

Job submission options (See lsb_submit())

options2

Job submission options (See lsb_submit())

delOptions

Delete options in options field .

delOptions2

Extended delete options in options2 field .

userId

The user ID of the submitter

userName

The name of the submitter

submitTime

The job submission time

umask

The file creation mask for this job

numProcessors

The number of processors requested for execution

beginTime

The job should be started on or after this time

termTime

If the job has not finished by this time, it will be killed

sigValue

The signal value sent to the job 10 minutes before its run window closes

restartPid

The process ID assigned to the job when it was restarted

jobName

The job name

queue

The name of the queue to which this job was submitted

numAskedHosts

The number of hosts considered for dispatching this job

askedHosts

List of asked hosts

resReq

The resource requirements of the job

rLimits

The user's resource limits

hostSpec

The model, host name or host type for scaling CPULIMIT and RUNLIMIT

dependCond

The job dependency condition

timeEvent

Time event string.

subHomeDir

The home directory of the submitter

inFile

The input file name

outFile

The output file name

errFile

The error output file name

command

The job command

inFileSpool

Job spool input file

commandSpool

Job spool command file

chkpntPeriod

The checkpointing period

chkpntDir

The checkpoint directory

nxf

The number of files to transfer

xf

The array of file transfer specifications. (The xFile structure is defined in <lsf/lsbatch.h>)

jobFile

The job file name

fromHost

The submission host name

cwd

The current working directory

preExecCmd

The pre-execution command

mailUser

User option mail string

projectName

Project name for the job; used for accounting purposes

niosPort

NIOS callback port to be used for interactive jobs

maxNumProcessors

Maximum number of processors

loginShell

The login shell specified by user

schedHostType

Execution host type

userGroup

The user group name for this job

exceptList

List of job exception conditions

userPriority

User priority

rsvId

Advance reservation ID

extsched

External scheduling options

warningTimePeriod

Job warning time period in seconds; -1 if unspecified

warningAction

Job warning action: SIGNAL | CHKPNT | command; NULL if unspecified

jobGroup

The job group under which the job runs

sla

SLA service class name under which the job runs

licenseProject

LSF License Scheduler project name

options3

Extended bitwise inclusive OR of options flags. See lsb_submit().

delOptions3

Extended delete options in options3 field.

app

Application profile under which the job runs.

apsString

Absolute priority scheduling string set by administrators to denote static system APS value or ADMIN factor APS value.

postExecCmd

Post-execution commands.

runtimeEstimation

Runtime estimate.

requeueEValues

Job-level requeue exit values.

initChkpntPeriod

Initial checkpoint period.

migThreshold

Job migration threshold.

struct jobStatusLog

The jobStatusLog structure contains the following fields:

jobId

The unique ID for the job

jStatus

The job status (See lsb_readjobinfo())

reason

The reason the job is pending or suspended (See lsb_pendreason() and lsb_suspreason())

subreasons

The load indices that have overloaded the host (See lsb_pendreason() and lsb_suspreason())

cpuTime

The CPU time consumed before this event occurred

endTime

The job completion time

ru

Boolean indicating lsfRusage is logged

lsfRusage

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 sbatchd runs. The fields that do not make sense on the platform will be logged as -1.0.

exitStatus

Job exit status

idx

Job array index; must be 0 in JOB_NEW

exitInfo

Job termination reason, see <lsf/lsbatch.h>

struct migLog

The migLog structure contains the following fields:

jobId

The job to be migrated

numAskedHosts

The number of candidate hosts for migration

askedHosts

The array of candidate host names

userId

The user ID of the submitter

idx

Job array index; must be 0 in JOB_NEW

userName

The user name of the submitter

struct sigactLog

The sigactLog structure contains the following fields:

jobId

The unique ID of the job

period

action period

pid

action process ID

jStatus

job status

reasons

Pending reasons

flags

Action flag

signalSymbol

signal symbol from the set: DELETEJOB | KILL | KILLREQUEUE | REQUEUE_DONE | REQUEUE_EXIT | REQUEUE_PEND | REQUEUE_PSUSP_ADMIN | REQUEUE_PSUSP_USER | SIG_CHKPNT | SIG_CHKPNT_COPY

actStatus

action logging status (ACT_NO | ACT_START | ACT_PREEMPT | ACT_DONE | ACT_FAIL)

idx

Job array index; must be 0 in JOB_NEW

struct jobOccupyReqLog

The jobOccupyReqLog structure contains the following fields:

userId

The user ID of the submitter

jobId

The unique ID for the job

numOccupyRequests

Number of Jobs Slots desired

occupyReqList

List of slots occupied

idx

Job array index; must be 0 in JOB_NEW

userName

The name of the submitter

struct jobVacatedLog

The jobVacatedLog structure contains the following fields:

userId

The user ID of the submitter

jobId

The unique ID for the job

idx

Job array index; must be 0 in JOB_NEW

userName

The name of the submitter

struct jobCleanLog

The jobCleanLog structure contains the following fields:

jobId

The unique ID for the job

idx

Job array index; must be 0 in JOB_NEW

struct jobStartAcceptLog

The jobStartAcceptLog structure contains the following fields:

jobId

The unique ID for the job

jobPid

The job process ID

jobPGid

The job process group ID

idx

Job array index; must be 0 in JOB_NEW

struct jobExceptionLog

The jobExceptionLog structure contains the following fields:

jobId

The unique ID for the job

exceptMask

Job exception handling mask

ActMask

Action Id (kill | alarm | rerun | setexcept)

timeEvent

Time event string

ExceptInfo

Except Info, pending reason for missched or cantrun exception, the exit code of the job for the abend exception, otherwise 0.

idx

Job array index; must be 0 in JOB_NEW

struct jobForceRequestLog

The jobForceRequestLog structure contains the following fields:

userId

The user ID of the submitter

numExecHosts

The number of execution hosts

ExecHosts

The array of execution host names

jobId

The unique ID for the job

idx

Job array index; must be 0 in JOB_NEW

options

Job run options (RUNJOB_OPT_NOSTOP | JFLAG_URGENT_NOSTOP | JFLAG_URGENT)

userName

The name of the submitter

queue

The name of the queue to which this job was submitted

struct logSwitchLog

The logSwitchLog structure contains the following fields:

lastJobId

the last jobId so far

struct jobModLog

The jobModLog structure contains the following fields:

jobIdStr

Job id

options

Job submission options

options2

Job submission options - more

delOptions

Delete options in options field

delOptions2

Delete options in options2 field

userId

The user ID of the submitter

userName

The name of the submitter

submitTime

time of job submission

umask

The file creation mask for this job

numProcessors

min num of proc for the job

beginTime

mustn't start before this

termTime

kill if not done after this

sigValue

signal value

restartPid

pid of original job

jobName

Job name

queue

Queue name

numAskedHosts

number of user specified hosts

askedHosts

user specified execution hosts

resReq

resource request

rLimits

user's resource limits (soft)

hostSpec

host/model name for CPU scale

dependCond

depend_cond expression string

timeEvent

Time event string

subHomeDir

job's homedir at submission host

inFile

input file

outFile

output file

errFile

error file

command

command description - this is really a job description field

inFileSpool

spool input file

commandSpool

spool command file

chkpntPeriod

The checkpointing period

chkpntDir

The checkpointing directory

nxf

Number of files to be copied

xf

Files to be copied

jobFile

The job file name. `\0' indicate let mbatchd make up name, otherwise, mbatchd will use given name. It is '\0' if it is a regular job, non-nil means it is a restart job.

fromHost

The submission host name

cwd

The current working directory

preExecCmd

Command string to be pre_executed

mailUser

Specified user results mailed to

projectName

project name for acct purposes

niosPort

nios port for interactive job

maxNumProcessors

max num of proc for the job

loginShell

login shell specified by user

schedHostType

restart job's submission host type

userGroup

user group

exceptList

exceptions to be detected

userPriority

user priority

rsvId

reservation ID

extsched

extsched option

warningTimePeriod

warning time period in seconds, -1 if unspecified

warningAction

warning action, SIGNAL | CHKPNT | command, NULL if unspecified

jobGroup

job group

sla

service class

licenseProject

License Project

options3

Job submission options - more and more

delOptions3

Delete options in options3 field

app

Application

apsString

aps value set by admin

postExecCmd

Post-execution commands specified by -Ep option of bsub and bmod

runtimeEstimation

Runtime estimate specified by -We option of bsub and bmod

struct sigactLog

The sigactLog structure contains the following fields:

jobId

The unique ID for the job

period

action period

pid

action process ID

jStatus

job status

reasons

pending reasons

flags

action flag

signalSymbol

signal symbol from the set: DELETEJOB | KILL | KILLREQUEUE | REQUEUE_DONE | REQUEUE_EXIT | REQUEUE_PEND | REQUEUE_PSUSP_ADMIN | REQUEUE_PSUSP_USER | SIG_CHKPNT | SIG_CHKPNT_COPY

actStatus

action logging status (ACT_NO | ACT_START | ACT_PREEMPT | ACT_DONE | ACT_FAIL)

idx

Job array index; must be 0 in JOB_NEW

struct jobOccupyReqLog

The jobOccupyReqLog structure contains the following fields:

userId

The user ID of the submitter

jobId

The unique ID for the job

numOccupyRequests

Number of Jobs Slots desired

occupyReqList

list of slots occupied

idx

Job array index; must be 0 in JOB_NEW

userName

The name of the submitter

struct jobVacatedLog

The jobVacatedLog structure contains the following fields:

userId

The user ID of the submitter

jobId

The unique ID for the job

idx

Job array index; must be 0 in JOB_NEW

userName

The name of the submitter

struct jobStartAcceptLog

The jobStartAcceptLog structure contains the following fields:

jobId

The unique ID for the job

jobPid

The job process ID

jobPGid

The job process group ID

idx

Job array index; must be 0 in JOB_NEW

struct jobCleanLog

The jobCleanLog structure contains the following fields:

jobId

The unique ID for the job

idx

Job array index; must be 0 in JOB_NEW

struct jobExceptionLog

The jobExceptionLog structure contains the following fields:

jobId

The unique ID for the job

exceptMask

Job exception handling mask

ActMask

Action Id (kill | alarm | rerun | setexcept)

timeEvent

Time event string

ExceptInfo

Except Info, pending reason for missched or cantrun exception, the exit code of the job for the abend exception, otherwise 0.

idx

Job array index; must be 0 in JOB_NEW

struct jgrpStatusLog

The jgrpStatusLog structure contains the following fields:

groupSpec

The full group path name for the job group

status

Job group status

oldStatus

Prior status

struct jgrpNewLog

The jgrpNewLog structure contains the following fields:

userId

The user ID of the submitter

submitTime

The job submission time

userName

The name of the submitter

dependCond

The job dependency condition

timeEvent

Time event string

groupSpec

Job group name

destSpec

New job group name

delOptions

Delete options in options field .

delOptions2

Extended delete options in options2 field .

fromPlatform

Platform type e.g. Unix, Windows

sla

SLA service class name under which the job runs

maxJLimit

Job group slot limit

options

Job group creation method: implicit or explicit

struct jgrpCtrlLog

The jgrpCtrlLog structure contains the following fields:

userId

The user ID of the submitter

userName

The name of the submitter

groupSpec

Job group name

options

Options

ctrlOp

Job control JGRP_RELEASE, JGRP_HOLD, JGRP_DEL

struct jobAttrSetLog

The jobAttrSetLog structure contains the following fields:

jobId

The unique ID for the job

idx

Job array index; must be 0 in JOB_NEW

uid

The user who requested the action

port

job attributes

hostname

Name of the host

struct jobExternalMsgLog

The jobExternalMsgLog structure contains the following fields:

jobId

The unique ID for the job

idx

Job array index; must be 0 in JOB_NEW

msgIdx

The message index

desc

Message description

userId

The user ID of the submitter

dataSize

Size of the message

postTime

The time the author posted the message.

dataStatus

The status of the message

fileName

Name of attached data file. If no file is attached, use NULL.

userName

The author of the message

struct perfmonLog

The perfmonLog structure contains the following fields:

samplePeriod

sample rate

totalQueries

Number of Queries

jobQueries

Number of Job Query

queueQuries

Number of Queue Query

hostQuries

Number of Host Query

SubmissionRequest

Number of Submission Requests

jobSubmitted

Number of Jobs Submitted

dispatchedjobs

Number of Dispatched Jobs

jobcompleted

Number of Job Completed

jobMCSend

Number of MultiCluster Jobs Sent

jobMCReceive

Number of MultiCluster Jobs Received

startTime

Start Time

structure jobChunkLog

The jobChunkLog structure contains the following fields:

membSize

Size of array membJobId

membJobId

Job IDs of jobs in the chunk

numExHosts

The number of processors used for execution

execHosts

The array of names of execution hosts

struct sbdJobStatusLog

The sbdJobStatusLog structure contains the following fields:

jobId

The unique ID for the job

jStatus

The status of the job (See lsb_readjobinfo())

reason

The reason the job is pending or suspended (See lsb_pendreason() and lsb_suspreason())

subreasons

The load indices that have overloaded the host (See lsb_pendreason() and lsb_suspreason())

actPid

Action process ID

actValue

Action Value SIG_CHKPNT | SIG_CHKPNT_COPY | SIG_WARNING

actPeriod

Action period

actFlags

Action flag

actStatus

Action logging status

actReasons

Action Reason SUSP_MBD_LOCK | SUSP_USER_STOP | SUSP_USER_RESUME | SUSP_SBD_STARTUP

ActSubReasons

Sub Reason SUB_REASON_RUNLIMIT | SUB_REASON_DEADLINE | SUB_REASON_PROCESSLIMIT | SUB_REASON_MEMLIMIT | SUB_REASON_CPULIMIT

idx

Job array index; must be 0 in JOB_NEW

sigValue

The signal value

exitInfo

The termination reason of a job

struct jobSwitchLog

The jobSwitchLog structure contains the following fields:

userId

The user ID of the submitter

jobId

The unique ID of the job

queue

The name of the queue the job has been switched to

idx

Job array index; must be 0 in JOB_NEW

userName

The name of the submitter

struct jobMoveLog

The jobMoveLog structure contains the following fields:

userId

The user ID of the submitter

jobId

The unique ID of the job

position

The new position of the job

base

The operation code for the move (See lsb_movejob())

idx

Job array index; must be 0 in JOB_NEW

userName

The name of the submitter

struct queueCtrlLog

The queueCtrlLog structure contains the following fields:

opCode

The queue control operation (See lsb_queuecontrol())

queue

The name of the queue

userId

The user ID of the submitter

userName

The name of the submitter

message

Queue control message

struct newDebugLog

The newDebugLog structure contains the following fields:

opCode

The queue control operation (See lsb_queuecontrol())

level

Debug level

logclass

Class of log

turnOff

Log enabled, disabled

logFileName

Name of log file

userId

The user ID of the submitter

struct hostCtrlLog

The hostCtrlLog structure contains the following fields:

opCode

The host control operation (See lsb_hostcontrol())

host

The name of the host

userId

The user ID of the submitter

userName

The name of the submitter

message

Host control message

struct hgCtrlLog

The hgCtrlLog structure contains the following fields:

opCode

The host control operation (See lsb_hostcontrol())

host

The name of the host

grpname

The name of the host group

userId

The user ID of the submitter

userName

The name of the submitter

message

Host group control message

struct mbdStartLog

The mbdStartLog structure contains the following fields:

master

The master host name

cluster

The cluster name

numHosts

The number of hosts in the cluster

numQueues

The number of queues in the cluster

struct mbdDieLog

The mbdDieLog structure contains the following fields:

master

The master host name

numRemoveJobs

The number of finished jobs that have been removed from the system and logged in the current event file

exitCode

The exit code from the master batch daemon

message

mbatchd administrator control message

struct unfulfillLog

The unfulfillLog structure contains the following fields:

jobId

The job ID.

notSwitched

The mbatchd has switched the job to a new queue but the sbatchd has not been informed of the switch

sig

This signal was not sent to the job

sig1

The job was not signaled to checkpoint itself

sig1Flags

Checkpoint flags. See the chkpntLog structure below.

chkPeriod

The new checkpoint period for the job

notModified

Flag for modifying job parameters of a running job

idx

Job array index

miscOpts4PendSig

Option flags for pending job signals

struct jobFinishLog

The jobFinishLog structure contains the following fields:

jobId

The unique ID for the job

userId

The user ID of the submitter

userName

The user name of the submitter

options

Job submission options (See lsb_submit())

numProcessors

The number of processors requested for execution

jStatus

The status of the job (See lsb_readjobinfo())

submitTime

Job submission time

beginTime

The job started at or after this time

termTime

If the job was not finished by this time, it was killed

startTime

Job dispatch time

endTime

The time the job finished

queue

The name of the queue to which this job was submitted

resReq

Resource requirements

fromHost

Submission host name

cwd

Current working directory

inFile

Input file name

outFile

Output file name

errFile

Error output file name

inFileSpool

Job spool input file

commandSpool

Job spool command file

jobFile

Job file name

numAskedHosts

The number of hosts considered for dispatching this job

askedHosts

The array of names of hosts considered for dispatching this job

hostFactor

The CPU factor of the first execution host

numExHosts

The number of processors used for execution

execHosts

The array of names of execution hosts

cpuTime

The total CPU time consumed by the job

jobName

Job name

command

Job command

lsfRusage

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 sbatchd runs. The fields that do not make sense on this platform will be logged as -1.0.

dependCond

The job dependency condition

timeEvent

Time event string

preExecCmd

The pre-execution command

mailUser

Name of the user to whom job related mail was sent

projectName

The project name, used for accounting purposes

exitStatus

Job exit status

maxNumProcessors

Maximum number of processors specified for the job

loginShell

The login shell specified by user

idx

Job array index

maxRMem

Maximum memory used by job

maxRSwap

Maximum swap used by job

rsvId

Advanced reservation ID

sla

SLA service class name for the job

exceptMask

Job exception handling mask

additionalInfo

Placement information of LSF HPC jobs

exitInfo

Job termination reason, see <lsf/lsbatch.h>

warningTimePeriod

Job warning time period in seconds; -1 if unspecified

warningAction

Job warning action, SIGNAL | CHKPNT | command; NULL if unspecified

chargedSAAP

SAAP charged for job

licenseProject

LSF License Scheduler project name

app

Application profile under which the job runs.

postExecCmd

Post-execution commands.

runtimeEstimation

Runtime estimate specified.

jgroup

Job group name

requeueEValues

Job-level requeue exit values

struct loadIndexLog

The loadIndexLog structure contains the following fields:

nIdx

The number of load indices

name

The array of load index names

struct calendarLog

The calendarLog structure contains the following fields

options

Reserved for future use

userId

The user ID of the submitter

name

The name of the calendar

desc

Description

calExpr

calendar expression

struct jobForwardLog

The jobForwardLog structure contains the following fields:

jobId

The unique ID of the job

cluster

The cluster name

numReserHosts

Number of Reserved Hosts

reserHosts

Reserved Host Names

idx

Job array index; must be 0 in JOB_NEW

jobRmtAttr

Remote job attributes from:

JOB_FORWARD Remote batch job on submit side

JOB_LEASE Lease job on submit side

JOB_REMOTE_BATCH Remote batch job on exec. side

JOB_REMOTE_LEASE Lease job on exec. side

JOB_LEASE_RESYNC Lease job resync during restart

JOB_REMOTE_RERUNNABLE Remote batch job rerunnable on execution cluster

struct jobAcceptLog

The jobAcceptLog structure contains the following fields:

jobId

The unique ID of the job

remoteJid

The unique ID of the remote job

cluster

The cluster name

idx

Job array index; must be 0 in JOB_NEW

jobRmtAttr

Remote job attributes from:

JOB_FORWARD Remote batch job on submit side

JOB_LEASE Lease job on submit side

JOB_REMOTE_BATCH Remote batch job on exec. side

JOB_REMOTE_LEASE Lease job on exec. side

JOB_LEASE_RESYNC Lease job resync during restart

JOB_REMOTE_RERUNNABLE Remote batch job rerunnable on execution cluster

statusAckLog

The statusAckLog structure contains the following fields:

jobId

The unique ID of the job

statusNum

Line number of Status

idx

Job array index; must be 0 in JOB_NEW

struct signalLog

The signalLog structure contains the following fields:

userId

The user ID of the submitter

jobId

The unique ID of the job

signalSymbol

signal symbol from the set: DELETEJOB | KILL | KILLREQUEUE | REQUEUE_DONE | REQUEUE_EXIT | REQUEUE_PEND | REQUEUE_PSUSP_ADMIN | REQUEUE_PSUSP_USER | SIG_CHKPNT | SIG_CHKPNT_COPY

runCount

the number of running times

idx

Job array index; must be 0 in JOB_NEW

userName

The name of the submitter

struct jobExecuteLog

The jobExecuteLog structure contains the following fields:

jobId

The unique ID of the job

execUid

User ID under which the job is running

execHome

Home directory of the user denoted by execUid

execCwd

Current working directory where job is running

jobPGid

The job process group ID

execUsername

User name under which the job is running

jobPid

The job process ID

idx

Job array index; must be 0 in JOB_NEW

additionalInfo

Placement information of LSF HPC jobs

SLAscaledRunLimit

Run time limit for the job scaled by the execution host

position

The position of the job

execRusage

The rusage satisfied at job runtime

duration4PreemptBackfill

The duration for preemptive backfill class in seconds

struct jobMsgLog

The jobMsgLog structure contains the following fields:

userId

The user ID of the submitter

jobId

The unique ID of the job

msgId

message index

type

message type

src

message source

dest

message destination

msg

message

idx

Job array index; must be 0 in JOB_NEW

struct jobMsgAckLog

The jobMsgAckLog structure contains the following fields:

userId

The user ID of the submitter

jobId

The unique ID of the job

msgId

message index

type

message type

src

message source

dest

message destination

msg

message

idx

Job array index; must be 0 in JOB_NEW

struct jobRequeueLog

The jobRequeueLog structure contains the following fields:

jobId

The unique ID of the job

idx

Job array index; must be 0 in JOB_NEW

struct chkpntLog

The chkpntLog structure contains the following fields:

jobId

The unique ID of the job

period

The new checkpointing period

pid

The process ID of the checkpointing process (a child sbatchd)

ok

0: checkpoint started; 1: checkpoint succeeded

flags

One of the following:

LSB_CHKPNT_KILL

Kill process if checkpoint successful

LSB_CHKPNT_FORCE

Force checkpoint even if non-checkpointable conditions exist

LSB_CHKPNT_MIG

Checkpoint for the purpose of migration

idx

Job array index; must be 0 in JOB_NEW

struct rsvRes

The rsvRes structure contains the following fields:

resName

Name of the resource (currently: host)

count

Reserved counter (currently: cpu number)

usedAmt

Amount of reserved counter used (currently: not used)

struct sbdUnreportedStatusLog

The sbdUnreportedStatusLog structure contains the following fields:

jobId

The unique ID for the job

jobPid

The job process ID

jobPGid

The job process group ID

newStatus

New status of the job

reason

Pending or suspending reason code

subreasons

Pending or suspending subreason code

lsfRusage

Resource usage information for the job (see jobFinishLog)

execUid

User ID under which the job is running

exitStatus

Job exit status

execCwd

Current working directory where job is running

execHome

Home directory of the user denoted by execUid

execUsername

User name under which the job is running

msgId

Message index

runRusage

Job's resource usage

sigValue

Signal value

actStatus

Action logging status

seq

Sequence status of the job

idx

Job array index

exitInfo

Job termination reason

struct rsvFinishLog

The rsvFinishLog structure contains the following fields:

rsvReqTime

Time when the reservation is required

options

Same as the options field in the struct addRsvRequest in <lsbatch.h>

uid

The user who created the reservation

rsvId

Reservation ID

name

User the reservation is for

numReses

Number of resources reserved

alloc

Allocation vector

timeWindow

Time window within which the advance reservation is active:

duration

Duration in seconds. (1) duration = to - from : when the reservation expired

creator

Creator of the reservation

struct cpuProfileLog

The cpuProfileLog structure contains the following fields:

servicePartition

Queue name

slotsRequired

The number of CPUs required

slotsAllocated

The number of CPUs actually allocated

slotsBorrowed

The number of CPUs borrowed

slotsLent

The number of CPUs lent

struct dataLoggingLog

The dataLoggingLog structure contains the following field:

loggingTime

The time of last job cpu data logging

struct jobRunRusageLog

The jobRunRusageLog structure contains the following fields:

jobId

The unique ID of the job

idx

Job array index; must be 0 in JOB_NEW

struct jRusage

The jRusage structure contains the following fields:

mem

Total resident memory usage in kilobytes of all currently running processes in given process groups

swap

Total virtual memory usage in kilobytes of all currently running processes in given proces groups.

utime

Cumulative total user time in seconds

stime

Cumulative total system time in seconds

npids

Number of currently active processesin given process groups

pidInfo

Structure containing information about an active process

struct eventEOSLog

The eventEOSLog structure contains the following field:

eos

Event end of stream

struct slaLog

The slaLog structure contains the following fields:

name

Service class name

consumer

Consumer name associated with the service class

goaltype

Objectives

state

The service class state (ontine, delayed)

optimum

Optimum number of job slots (or concurrently running jobs) needed for the service class to meet its service-level goals

counters

Job counters for the service class

struct taskFinishLog

The taskFinishLog structure contains the following fields:

taskId

Task ID

taskIdx

Task index

taskName

Name of task

TaskOptions

Bit mask of task options:

TASK_IN_FILE (0x01)-specify input file

TASK_OUT_FILE (0x02)-specify output file

TASK_ERR_FILE (0x04)-specify error file

TASK_PRE_EXEC (0x08)-specify pre-exec command

TASK_POST_EXEC (0x10)-specify post-exec command

TASK_NAME (0x20)-specify task name

taskExitReason

Task Exit Reason

TASK_EXIT_NORMAL = 0- normal exit

TASK_EXIT_INIT = 1-generic task initialization failure

TASK_EXIT_PATH = 2-failed to initialize path

TASK_EXIT_NO_FILE = 3-failed to create task file

TASK_EXIT_PRE_EXEC = 4- task pre-exec failed

TASK_EXIT_NO_PROCESS = 5-fork failed

TASK_EXIT_XDR = 6-xdr communication error

TASK_EXIT_NOMEM = 7- no memory

TASK_EXIT_SYS = 8-system call failed

TASK_EXIT_TSCHILD_EXEC = 9-failed to run sschild

TASK_EXIT_RUNLIMIT = 10-task reaches run limit

TASK_EXIT_IO = 11-I/O failure

TASK_EXIT_RSRC_LIMIT = 12-set task resource limit failed

Struct jobFinishLog

See jobFinishLog structure above

RETURN VALUES

character:Pointer

Points to an eventRec which contains information on a job event and updates *lineNum to point to the next line of the log file.

character:NULL

Function failed.

ERRORS

On failure, lsberrno is set to indicate the error.

If there are no more records, returns NULL and sets lsberrno to LSBE_EOF.

SEE ALSO

Related APIs

lsb_hostcontrol() - Opens or closes a host, or restarts or shuts down its slave batch daemon

lsb_movejob() - Changes the position of a pending job in a queue

lsb_pendreason() - Explains why a job is pending

lsb_puteventrec() - Puts information of an eventRec structure pointed to by logPtr into a log file

lsb_queuecontrol()- Changes the status of a queue

lsb_readjobinfo()- Returns the next job information record in mbatchd

lsb_submit() - Submits or restarts a job in the batch system

lsb_suspreason()- Explains why a job was suspended

Equivalent line command

none

FILES

$LSB_SHAREDIR/cluster/logdir/lsb.acct

$LSB_SHAREDIR/cluster/logdir/lsb.events

$LSB_SHAREDIR/cluster/logdir/lsb.rsv.ids

$LSB_SHAREDIR/cluster/logdir/lsb.rsv.state


Platform Computing Inc.
www.platform.com
Knowledge Center         Contents    Previous  Next