PTBurn SDK
Page 18 of 53
© 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks
are the property of their respective companies.
3 Status
Information
PTBurn will provide status for each submitted job in several different ways.
First of all, the filename extension for the submitted Job Request File will have four different
values: the “new job request” extension, the “job discovered” extension, the
“in process” extension, and the “job completed” extension. All four of these extensions can be
specified in PTSETUP.INI. Using the default values here is an example description of the four
filename extensions:
MyJob.JRQ
Æ
The client has submitted the job request
MyJob.QRJ
Æ
PTBurn has discovered and put the job in its list of jobs.
MyJob.INP
Æ
PTBurn is currently processing this job.
MyJob.DON
Æ
The job has been completed.
An additional filename extension is possible when a job has an error or has been aborted.
MyJob.ERR
Æ
The job has finished with errors or has been aborted.
Secondly, there will be a Master Status Text File
PTSTATUS.TXT
and it will reside in a
subfolder called
Status
within the Job Request Folder location (defined in PTSETUP.INI). The
structure of this status file will be similar to an .INI file with three fixed Sections of [JobList],
[CompletedJobs], and [System]. Also, each job will have its own Section (section name is the
name of the Job Request File without an extension) with detailed information of the job.
Note: When processing PTSTATUS.TXT from a client application, the client application should
NOT
access PTSTATUS.TXT with exclusive access.
3.1 JobList Section
The first fixed section in PTSTATUS.TXT is [JobList]
Within this section are keys that can provide a client the list of the current jobs being processed
by PTBurn. The Key value of the current job is always Job0, the next job is Job1, etc.
So, an example might be:
[JobList]
Job0=MyJob1
Job1=YourJob1
Job2=MyJob2
The client can display the list of jobs by sequentially trying to get the string values for Keys:
Job0, Job1, Job2,… The end of the list of jobs can be determined by the client when the string
value for the next key is not found.
3.2 CompletedJobs Section
The second fixed section in PTSTATUS.TXT is [CompletedJobs]
Within this section are keys that can provide a client the list of the recently completed jobs
(including successful jobs, jobs with errors, and jobs that have been aborted). The Key value of
the current job is always Job0, the next job is Job1, etc.
So, an example might be:
