PTBurn
SDK
Page
6
of
68
©
2011
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
400
where
0
is
most
important
and
400
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).
NOTE:
When
submitting
jobs
of
different
priorities
it
is
important
to
submit
jobs
with
higher
priority
before
jobs
with
lower
priority;
jobs
that
are
discovered
by
PTBurn
will
not
be
interrupted
once
they
actually
begin
,
even
if
a
job
with
a
higher
priority
is
discovered
later.
2.1.4
Data
This
is
a
string
that
specifies
the
either
the
filename
to
burn
or
the
folder
that
contains
all
the
data
to
be
burned.
All
files
and
subfolders
within
a
specified
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.