PTBurn SDK
Page 7 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.
2 JRQ File Command Structure
To create discs, the client application must create a Job Request File. This text file can be named
anything the client chooses but it MUST reside within the Job Request Folder AND must have
an extension of .JRQ (this can be changed in PTSETUP.INI). This .JRQ file created by the
client contains information that specifies the data to burn, number of copies, etc.
The Job Request File must be a text document with certain Key values defined (many of which
are optional). The format is:
2.1 Command Keys/Values
2.1.1
JobID
Any ASCII string message up to 32 characters describing the job. When the job is being
executed this JobID string will be shown in the PTBurn window. If this key is not provided then
the job request filename will be used.
2.1.2
ClientID
This ASCII string message up to 32 characters is a description for the Client who is submitting
the job. The client can decide what string he wants to use. If this key is not provided then the
ClientID will default to “Unknown.”
2.1.3
Importance
This tells PTBurn how important the job is. Possible values are
0
to
9
where
0
is most important
and
9
is least important. If this key is not provided then a default value of
4
will be used. Jobs
with lower values will be processed first unless the job has been waiting too long (this value can
be changed in PTSETUP.INI).
2.1.4
DiscType
This tells what type of disc is being targeted. DiscType possible values:
CDR
DVDR
Where the default value is CDR if this key is not given.
2.1.5
Data
This is a string that specifies the root folder that contains all the data to be burned. All files and
subfolders within this root path folder will be burned (the root folder itself will not be copied –
only its contents). Alternatively, individual files can be specified here (the full path for the
source file must be given, but the file will be copied to the root location on the disc). The format
is as follows:
Data = Filename, SessionX
Where SessionX is optional and is used only if requesting a multi-session disc (a maximum of 2
sessions is allowed at this time). The value X is an integer value (1 or 2) that tells PTBurn for
which session to burn this data.
If SessionX is not given then it will be burned into the first (and only) session.
