Description
The BATCH_JOB_INFO_1 structure contains the most common job attributes needed for a quick status check.
Structure
struct _batchjobinfo1 |
||
{ |
||
LPTSTR jobid; |
/* full unique job identifier */ |
|
LPTSTR owner; |
/* who owns this job */ |
|
LPTSTR name; |
/* user description of job */ |
|
long priority; |
/* assigned job priority */ |
|
DWORD size; |
/* size of job data files */ |
|
DWORD state; |
/* state of the job */ |
|
LPBYTE reserved; |
/* reserved for future features */ |
|
} BATCH_JOB_INFO_1, *PBATCH_JOB_INFO_1; |
Parameters
LPTSTR jobid |
A string containing the unique job identifier. No two jobs may have the same jobid. The jobid string is in the format idnum.orighost, where orighost is the name of the computer to which the job was originally submitted, and idnum is the nth job submitted to that host. The id numbers do not exceed 5 digits, and are reset to zero after 99,999 jobs have been submitted. |
LPTSTR owner |
The account name of the owner of this batch job. |
LPTSTR name |
The user-supplied name of the job. The default job name is the name of the script file. |
long priority |
The job priority used for scheduling execution of the job. Higher priority jobs are placed first in the queue, and run before lower priority jobs. The range of priorities is -1024 to 1023. |
DWORD size |
The sum of the size of all files associated with this job. |
DWORD state |
The state of the job. The following states are possible: |
BATCH_JOB_STATE_QUEUED |
The job has been queued. |
BATCH_JOB_STATE_RUNNING |
The job is currently running. |
BATCH_JOB_STATE_HELD |
The job is in a hold state. |
BATCH_JOB_STATE_WAITING |
The job is waiting for execution. |
BATCH_JOB_STATE_EXITING |
The job has completed, and is exiting the batch subsystem. |
BATCH_JOB_STATE_TRANSITING |
The job is being transferred. |
BATCH_JOB_STATE_RECURRING |
The job is a recurring job. |
BATCH_JOB_STATE_ARRIVING |
The job is arriving in the batch subsystem. |
LPBYTE reserved |
NULL pointer. In future versions, this pointer may reference added job attributes. |