BATCH_JOB_INFO_1 - Intergraph Batch Services - Help

Intergraph Batch Services Help

Language
English
Product
Intergraph Batch Services
Search by Category
Help

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.